NFTs

Iroha NFT - бер хужаһы булған уникаль иҫәп-хисап объекты. Файҙаланырға кәрәк саҡта NFTs ҡулланығыҙ, әгәр яҙма үҙ идентификацияһына, метамәғлүмәттәренә, йәшәү циклы ваҡиғаларына һәм милек хоҡуғын тапшырыу семантикаһына мохтаж булһа, әммә һан балансы кәрәкмәй.

](/ba/blockchain/assets.md) һанлы [ активтан айырмалы рәүештә, NFT -ҙың иҫәбе буйынса аныҡлығы, өлгөрөүсәнлеге һәм күләмдәре юҡ. NFT бер теркәлгән объект булараҡ бар, һәм милекселек был объектта туранан-тура күҙәтелә.

Структураһы

Теркәлгән Nft составында:

• id: бер NftId
• content: NFT миҡдары тураһында метамәғлүмәттәр.
• owned_by: NFT иҫәбенә эйә булған иҫәп

content яланы - Metadata картаһы. Уны компактлы һаҡлағыҙ: унда тасуирлау майҙансыҡтарын, тотороҡло белешмәләрҙе, хештарҙы, URIs йәки SoraFS юлдарын һаҡлау. Ҙур документтар, медиа йә юғары килемле ҡушымталар дәүләтен ситтә һаҡлағыҙ һәм бары тик тикшереү мөмкин булған белешмәне генә һаҡлағыҙ NFT.

Taira менән һынап ҡарағыҙ.

Йәмәғәт Taira тест селтәрендә әлеге ваҡытта NFT яҙмалары бармы-юҡмы икәнен тикшерегеҙ:

curl -fsS 'https://taira.sora.org/v1/nfts?limit=5' \
  | jq '{total, nft_ids: [.items[].id]}'

NFT маршруттары өсөн тере OpenAPI документын тикшереп ҡарағыҙ:

curl -fsS https://taira.sora.org/openapi.json \
  | jq -r '.paths | keys[] | select(startswith("/v1/nfts") or startswith("/v1/explorer/nfts"))'

Буш items массивы - асыҡ тест селтәрендә ғәмәлдә булған яуап. Был ағымдағы биттә NFTs юҡ тигәнде аңлатмай, ә NFT күрһәтмәләре юҡ.

NFT IDs

NftId был текст формаһын ҡуллана:

name$domain
name$domain.dataspace

Мәҫәлән, badge$docs.universal билдәләй badge NFT ҡаҙнаһында docs.universal Әгәр мәғлүмәттәр арауығы ситтә ҡалһа, ағымдағы анализлаусы universal мәғлүмәт киңлеге, шуға күрә badge$docs хәл итә badge$docs.universal.

NFT IDs өсөн даими исемдәр ҡулланығыҙ. ID - инструкциялар, һорауҙар, рөхсәттәр, ваҡиға фильтрҙары һәм ҡушымта һылтанмалары менән ҡулланылған объект идентификацияһы.

Ғүмер циклы

NFT ғүмере циклы операциялары ҡулланыу Iroha Махсус инструкциялар:

• Register башланғыс content менән NFT барлыҡҡа килтерә.
• Unregister NFT файлын алып ташлай.
• Transfer үҙгәрештәр owned_by.
• SetKeyValue һәм RemoveKeyValue яңыртыу NFT метамәғлүмәттәре.

Урындағы ерҙәрҙә эшләп ҡарағыҙ

Был миҫалдар һеҙ урындағы селтәрҙе башҡарғанһығыҙ тип һанай һәм CLI күрһәтмәһенән клиент конфигурацияһы барлыҡҡа килгән:

export IROHA_CONFIG=./localnet/client.toml
export NFT_DOMAIN=wonderland.universal
export NFT_ID='badge_intro$wonderland.universal'

Булдырылған локаль селтәр инде ҡуйыла wonderland.universal һәм уның SNS аренда. башҡа доменды ҡулланыу өсөн, тәүҙә уны декларатив менән app alias setup plan һәм app alias setup apply эш процесы Домендар.

NFT теркәлеү стандарт кертеүҙән башланғыс йөкмәтке JSON уҡый:

printf '{"kind":"badge","level":"intro","issuer":"docs"}\n' |
  cargo run --bin iroha -- --config "$IROHA_CONFIG" \
  ledger nft register --id "$NFT_ID"

NFT туранан-тура тикшерегеҙ, һуңынан бөтә NFTs исемлеген тулы баҫмалар менән яҙығыҙ:

cargo run --bin iroha -- --config "$IROHA_CONFIG" \
  ledger nft get --id "$NFT_ID"

cargo run --bin iroha -- --config "$IROHA_CONFIG" \
  ledger nft list all --verbose

Метамәғлүмәт асҡысын өҫтәп, NFT ҡабаттан уҡығыҙ:

printf '{"color":"blue","rarity":"tutorial"}\n' |
  cargo run --bin iroha -- --config "$IROHA_CONFIG" \
  ledger nft meta set --id "$NFT_ID" --key traits

cargo run --bin iroha -- --config "$IROHA_CONFIG" \
  ledger nft get --id "$NFT_ID"

Метамәғлүмәттәр асҡысын алып ташлау:

cargo run --bin iroha -- --config "$IROHA_CONFIG" \
  ledger nft meta remove --id "$NFT_ID" --key traits

NFT вариантын күсереү. ledger nft get ҡулланып, ағымдағы хужаны owned_byнан уҡырға һәм ledger account list all менән тәғәйенләнештәге иҫәпте ID табырға.

cargo run --bin iroha -- --config "$IROHA_CONFIG" \
  ledger account list all

export CURRENT_OWNER='<account-id-from-owned_by>'
export NEW_OWNER='<destination-account-id>'

cargo run --bin iroha -- --config "$IROHA_CONFIG" \
  ledger nft transfer --id "$NFT_ID" --from "$CURRENT_OWNER" --to "$NEW_OWNER"

NFT өлгөһөн күсереүҙән һуң алып ҡалдырығыҙ. Әгәр күсергән булһағыҙ, уны кире күсерегеҙ йәки әлеге хужаның иҫәп яҙмаһы конфигурацияһы менән теркәүҙән баш тартыу командаһын тапшырығыҙ.

cargo run --bin iroha -- --config "$IROHA_CONFIG" \
  ledger nft unregister --id "$NFT_ID"

Һорауҙар һәм ваҡиғалар

FindNfts иҫәбенә NFTs һәм FindNftsByAccountId иҫәбенә иҫәпкә эйә булған NFTs иҫәбенә ҡулланығыҙ.

NFT теркәлеү, юҡҡа сығарыу, күсереү һәм метамәғлүмәт яңыртыуҙары NFT мәғлүмәт ваҡиғаларын сығара. Nft мәғлүмәт ваҡиғалары фильтрын ҡулланып, иҫәп яҙмаһына үҙгәрештәр индергәндә йәки NFT тормош циклы ваҡиғаларына реакция яһаусы ҡуҙғытыусыларҙы төҙөгәндә.

Разрешениелар

NFT-ҡа хас билдәләр булған рөхсәт өҫкө йөҙө:

• CanRegisterNft
• CanUnregisterNft
• CanTransferNft
• CanModifyNftMetadata

Рөхсәт тикшереүҙәре актив үтәү ваҡыты менән раҫлаусы тарафынан үтәлә, шуға күрә селтәрендә үтәүсене яңыртып, рөхсәт итеүҙе көйләй ала. Рөхсәт биреү билдәләре ғәмәлдәге билдәләр исемлеге өсөн.

NFTs һайлау

Үҙенсәлек һәм милек әһәмиәтенә эйә булған яҙмалар өсөн NFT ҡулланығыҙ:

• сертификаттар, билдәләр, лицензиялар һәм танытмалар
• ағзалыҡ йәки инеү яҙмалары
• Идентификация менән бәйләнгән йәки иҫәпкә алынған ғаризалар тураһында яҙмалар
• Сылтанмалар, документтар йәки манифестар

Функциональ баланстар өсөн һанлы активты ҡулланығыҙ, һәм мәғлүмәттәр бары тик ғәмәлдәге иҫәп-хисап объектының компакт атрибуты булған осраҡта ябай метамәғлүмәт ҡулланығыҙ.

Шулай уҡ ҡарағыҙ:

• Активтар
• Метамәғлүмәттәре
• Инструкциялар
• Һорауҙар