Skip to content

Активтар

Iroha актив - иҫәптә тотолған һанлы баланс. Һәр конкрет баланс AssetDefinition иҫәбенә йүнәлтелә, һәм билдәләмә был активтың нисек аталыуы, һуғылыуы, күрһәтелеүе һәм бүленеүе мөмкинлеген һүрәтләй.

Активтар билдәләмәһе

AssetDefinition түбәндәгеләрҙе үҙ эсенә ала:

  • id: конфиденциаль активтарҙы билдәләү адресы
  • name: кеше уҡый торған дисплей исеме
  • description: кеше уҡырға мөмкин булған факультатив һүрәтләмә
  • alias: <name>#<domain>.<dataspace> йәки <name>#<dataspace> формаһындағы факультатив исемдәр.
  • spec: баланстар өсөн һанлы аныҡлыҡ һәм сикләүҙәр
  • mintable: минтабильлек сәйәсәте
  • logo: факультатив SoraFS URI
  • metadata: үҙаллы төп мәғәнәле метамәғлүмәт
  • balance_scope_policy: баланстар глобаль йәки мәғлүмәт киңлеге менән сикләнгәнме?
  • owned_by: билдәләмәне теркәгән йәки уға эйә булған иҫәп
  • total_quantity: дөйөм сығарылған күләм
  • confidential_policy: һаҡланған активтар операциялары өсөн сәйәсәт

Ассит билдәләмәһе IDs - каноник үтә күренмәле адрестар. Ҡасан билдәләмә домендан һәм исемдән төҙөлә, Iroha шул домен/исем проекцияһын UX һәм һорауҙар өсөн һаҡлай ала, әммә каноник текст формаһы барлыҡҡа килгән адрес булып тора.

Активтар балансы

Asset түбәндәгеләрҙе үҙ эсенә ала:

  • id: AssetId, ул активтарҙы билдәләүҙе, хужаның иҫәбен һәм факультатив баланс күләмен берләштерә.
  • value: Numeric балансы

Хәүеф тотоусы иҫәбенең каноник һәм доменһыҙ булыуы мөмкин. Аҡса билдәләмәһе, мәҫәлән, payments.universal мәғлүмәт киңлеге буйынса квалификациялы домен аҫтында күҙаллана ала.

Ҡулланырлыҡ

Активтар билдәләмәләре был mintability режимдарын хуплай:

РежимМәғәнәһе
InfinitelyЭластик тәьминәт. Активты ҡат-ҡат һуғып яндырырға мөмкин.
OnceУны бер тапҡыр һуғып, һуңынан яндырырға мөмкин.
NotТөп тәьминәт символы яндырылырға мөмкин, әммә ҡабаттан һуғылмай.
Limited(n)Был сәйәсәт яңы активтар берәмектәрен сикләнгән һанда өҫтәмә операцияларҙа сығарырға мөмкинлек бирә.

Ҡулланыу Infinitely ғәҙәти һығылмалы активтар өсөн һәм Once йәки Limited(n) даими йәки сикләнгән тәьминәт активтары өсөн. Not башланғыс сәйәсәт булараҡ, әгәр активтар менән тәьмин итеү инде билдәләнмәгән булһа.

Баланс күләме

balance_scope_policy баланстарҙың нисек һалыныуын контролдә тота:

  • Global: бер иҫәп һәм активтар билдәләмәһе буйынса баланс һауыты
  • DataspaceRestricted: баланстар мәғлүмәт майҙансығы контексты буйынса бүленә

Мәғлүмәт киңлеге менән сикләнгән баланстар бер үк актив билдәләмәһе Nexus мәғлүмәт киңлектәрендә ҡулланылған осраҡта файҙалы була, әммә баланстар айырым һаҡланырға тейеш.

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

Был уҡырға ғына саҡырыуҙар асыҡ Taira тест селтәрендә реаль активтар билдәләмәләрен күрһәтә:

bash
TAIRA_ROOT=https://taira.sora.org

curl -fsS "$TAIRA_ROOT/v1/assets/definitions?limit=10" \
  | jq -r '.items[] | [.id, .name, .mintable, .total_quantity] | @tsv'

Хәҙерге Taira XOR түләү активтары билдәләмәһен табығыҙ:

bash
curl -fsS "$TAIRA_ROOT/v1/assets/definitions?limit=100" \
  | jq '.items[]
    | select(.name == "XOR")
    | {id, name, total_quantity, mintable, confidential_policy: .confidential_policy.mode}'

Метамәғлүмәттәрҙе йөрөткән билдәләмәләрҙе эҙләгеҙ:

bash
curl -fsS "$TAIRA_ROOT/v1/assets/definitions?limit=100" \
  | jq '.items[]
    | select((.metadata | length) > 0)
    | {id, name, metadata}'

Өс миҫал да уҡыла. Taira буйынса активтарҙы яғыу, яндырыу йәки күсереү өсөн кран менән тәьмин ителгән иҫәп һәм һаҡланған ағымды ҡулланығыҙ SORA Nexus Мәғлүмәт биттәренә тоташтырыу .

Түләүле Taira актив миҫалы өсөн, кран ярҙамсыһын һаҡлағыҙ Get Testnet XOR on Taira as taira_faucet_claim.py, һуңынан башта кран активын талап итегеҙ һәм уны транзакция газ активы итеп ҡулланығыҙ:

bash
export TAIRA_ACCOUNT_ID='<TAIRA_I105_ACCOUNT_ID>'
export TAIRA_FEE_ASSET=6TEAJqbb8oEPmLncoNiMRbLEK6tw

python3 taira_faucet_claim.py "$TAIRA_ACCOUNT_ID"
printf '{"gas_asset_id":"%s"}\n' "$TAIRA_FEE_ASSET" > taira.tx-metadata.json

Һуңынан ledger asset mint, ledger asset burn һәм ledger asset transfer командаларында --metadata ./taira.tx-metadata.json индерергә.

Инструкциялар

Активтарҙы Iroha махсус күрһәтмәләре буйынса теркәп була, һуғырға, яндырырға һәм күсерергә мөмкин:

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