Skip to content

Ativos

Um ativo Iroha é um saldo numérico detido por uma conta. Cada saldo concreto aponta para um AssetDefinition, e a definição descreve como esse ativo pode ser nomeado, cunhado, exibido e dividido.

Definição de ativos

Um AssetDefinition contém:

  • id: endereço de definição do ativo canônico
  • name: um nome de exibição legível ao ser humano
  • description: descrição facultativa legível ao ser humano.
  • alias: alias opcionais no formulário <name>#<domain>.<dataspace> ou <name>#<dataspace>
  • spec: precisão numérica e restrições para os saldos
  • mintable: a política de mintabilidade
  • logo: opcional SoraFS URI
  • metadata: metadados arbitrários de valor-chave
  • balance_scope_policy: se os saldos são globais ou limitados ao espaço de dados;
  • owned_by: conta que registrou ou detém a definição
  • total_quantity: quantidade total emitida
  • confidential_policy: Política de operações em activos protegidos

Definição de ativos IDs são endereços opacos canônicos. Quando uma definição é construída a partir de um domínio e um nome, Iroha pode manter essa projeção de domínio / nome para UX e consultas, mas o formulário de texto canônico é o endereço gerado.

Equilíbrio de activos

Um Asset contém:

  • id: um AssetId, que combina a definição de ativo, a conta do detentor e o escopo de saldo opcional
  • value: um saldo de Numeric

A conta do titular é canônica e sem domínio. A definição de ativo pode ser projetada sob um domínio qualificado para o espaço de dados, por exemplo payments.universal.

Capacidade de conservação

As definições de ativos suportam estes modos de mintabilidade:

Modo .Que significa ?
InfinitelyO activo pode ser montado e queimado repetidamente.
OnceUm símbolo de oferta fixa, pode ser cunhado uma vez e depois queimado.
NotToken de fornecimento fixo que pode ser queimado mas não coitado novamente.
Limited(n)A política permite a emissão de novas unidades de activos num número limitado de operações adicionais.

Utilize Infinitely para ativos elásticos normais e Once ou Limited(n) para activos de oferta fixa ou limitada. Não utilize Not como política inicial, a menos que o fornecimento de activos já seja estabelecido.

O escopo do balanço

O balance_scope_policy controla a forma como os saldos são colocados em cubos:

  • Global: um balde de saldo por conta e definição do ativo
  • DataspaceRestricted: Os saldos são divididos por contexto do espaço de dados

Os saldos restritos ao espaço de dados são úteis quando a mesma definição de ativo é utilizada em múltiplos bancos de dados Nexus, mas os saldos devem permanecer isolados.

Tente em Taira

Estas chamadas de somente leitura mostram definições reais de ativos na rede de teste pública 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'

Encontrar a definição atual do ativo de taxa 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}'

Procure definições que contenham metadados:

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

Todos os três exemplos são leituras. Para coletar, queimar ou transferir ativos em Taira, use uma conta financiada por torneiras e o fluxo guardado em Conectar-se aos bancos de dados SORA Nexus .

Para um exemplo de ativo Taira pago por taxa, salve o auxiliar da torneira a partir de Obter Testnet XOR em Taira como taira_faucet_claim.py, em seguida, reivindique primeiro o ativo da torneira e use-o como ativo do gás de transação:

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

Em seguida, inclua --metadata ./taira.tx-metadata.json nos comandos ledger asset mint, ledger asset burn e ledger asset transfer.

Instruções

Os ativos podem ser registados, montados, queimados e transferidos com Iroha Instruções especiais:

Veja também: