Package codice concatenato framework token fungibile

Il framework di token fungible utilizza lo standard esteso Token Taxonomy Framework supportato da Blockchain App Builder.

L'esempio del token di deposito illustra l'uso del framework generico del token fungibile, che si basa sullo standard esteso Token Taxonomy Framework supportato da Blockchain App Builder. Il campione rappresenta un sistema in cui i token di deposito rappresentano valuta fiat detenuta presso istituti finanziari e sono emessi e gestiti da istituti finanziari regolamentati. Il file di specifica di esempio genera metodi per inizializzare un token di deposito, gestire i conti, assegnare ruoli ed eseguire operazioni quali conio, trasferimento e masterizzazione di token. Fornisce inoltre conti notai per l'approvazione di conio e trasferimenti, applica la conformità ai limiti giornalieri a livello di conto e abilita le procedure di audit.

Il package codice concatenato del framework token fungibile può essere scaricato dalla console di Oracle Blockchain Platform e include i componenti riportati di seguito.

DepositToken.zip, un file di archivio che contiene il codice concatenato per la distribuzione.
DepositToken.yaml, un file di specifica che è possibile utilizzare con Blockchain App Builder per impiantare il codice concatenato DepositToken.
DepositToken_postman_collection.json, una raccolta Postman che consente di eseguire il test delle API nel codice concatenato.
README.md, una guida dettagliata per l'utilizzo del codice concatenato.

Per ottenere il framework di token fungibile, nella console degli asset digitali di Oracle Blockchain Platform fare clic sulla scheda Asset digitali, quindi selezionare Fungible Token Framework.

Per ulteriori informazioni sull'utilizzo delle raccolte Postman, vedere gli argomenti riportati di seguito.

File specifica

Il file di specifica utilizzato per generare il codice concatenato del token di deposito include l'attributo events. La funzione eventi codice concatenato supporta i callback degli eventi nei codici concatenati generati per abilitare le notifiche in tempo reale e attivare i flussi di lavoro. Per ulteriori informazioni sui file di specifica e sui parametri utilizzati nei file di specifica, vedere File di specifica di input per i token fungibili in Utilizzo di Oracle Blockchain Platform.

Il codice concatenato del token di deposito si basa sullo standard esteso di Token Taxonomy Framework, con personalizzazioni per supportare lo scenario dell'applicazione. Per abilitare queste personalizzazioni è necessaria la seguente sezione sul comportamento del file di specifica.

behavior: # Token behaviors
    - divisible:
          decimal: 2
    - mintable:
          mint_approval_required: true
    - transferable
    - burnable
    - holdable
    - roles:
          minter_role_name: minter
          notary_role_name: notary
          mint_approver_role_name: notary

Il codice seguente è il file di specifica per l'esempio di token di deposito.

#
# Copyright (c) 2024, Oracle and/or its affiliates. All rights reserved.
#
 
assets:
 
# This specification file is an example how to build any fungible token application.
# For a fungible token application, deposit token system has been used as an example.
# Deposit token is a digital representation of deposits held at commercial banks, enabling transactions on blockchain networks while maintaining the value and stability of traditional bank deposits.
 
 
    - name: Deposit # Asset name
      type: token  # Asset type
      standard: ttf+   # Token standard
      events: true # Supports event code generation for non-GET methods
 
      anatomy:
          type: fungible # Token type
          unit: fractional # Token unit
 
      behavior: # Token behaviors
          - divisible:
                decimal: 2 
          - mintable:
                mint_approval_required: true
          - transferable 
          - holdable
          - burnable
          - roles:
                minter_role_name: minter
                notary_role_name: notary
                mint_approver_role_name: notary
 
 
      properties:
          - name: Token_Name # Custom attribute to represent the deposit token name.
            type: string
 
          - name: Token_to_Currency_Ratio # Custom attribute to specify the token to currency ratio. This attribute is helpful for exchanging the tokens with fiat currency.
            type: number
 
customMethods:

Dettagli autore dichiarazione a sostegno in metodi codice concatenato

Digital Assets Edition di Oracle Blockchain Platform aggiunge un parametro di approvazione al payload della richiesta per tutti i metodi setter. Il valore del parametro è endorsers o sameOrgEndorser. Se il parametro sameOrgEndorser è vero, le dichiarazioni a sostegno della transazione devono provenire dalla stessa organizzazione del richiedente. Il parametro endorsers specifica una lista di pari livello che devono approvare la transazione. Per ulteriori informazioni, vedere Supporto delle dichiarazioni a sostegno in Postman Collections. Nella tabella seguente viene visualizzato il tipo di girante per ciascun metodo.

Metodo	Tipo autore dichiarazione a sostegno
`activateAccount`	`endorsers`
`addTokenAdmin`	`sameOrgEndorser`
`addTokenAuditor`	`sameOrgEndorser`
`addOrgAdmin`	`sameOrgEndorser`
`addOrgAuditor`	`sameOrgEndorser`
`addRole`	`endorsers`
`approveMint`	`sameOrgEndorser`
`executeHoldTokens`	`endorsers`
`associateTokenToAccount`	`endorsers`
`createAccount`	`endorsers`
`getAccount`	`endorsers`
`getAccountBalance`	`endorsers`
`getAccountsByUser`	`endorsers`
`getAccountTransactionHistory`	`endorsers`
`getAccountTransactionHistoryWithFiltersFromRichHistDB`	`endorsers`
`getNetTokens`	`endorsers`
`getOnHoldIds`	`endorsers`
`getTotalMintedTokens`	`endorsers`
`getUserByAccountId`	`endorsers`
`getUsersByRole`	`endorsers`
`holdTokens`	`endorsers`
`init`	`endorsers`
`initializeDepositToken`	`sameOrgEndorser`
`issueTokens`	`sameOrgEndorser`
`rejectMint`	`sameOrgEndorser`
`releaseHoldTokens`	`endorsers`
`removeTokenAdmin`	`sameOrgEndorser`
`removeTokenAuditor`	`sameOrgEndorser`
`removeOrgAdmin`	`sameOrgEndorser`
`removeOrgAuditor`	`sameOrgEndorser`
`removeRole`	`endorsers`
`requestMint`	`sameOrgEndorser`
`burnTokens`	`sameOrgEndorser`
`setMaxDailyAmount`	`endorsers`
`setMaxDailyTransactionCount`	`endorsers`
`suspendAccount`	`endorsers`
`transferTokens`	`endorsers`
`initializeExchangePoolUser`	`sameOrgEndorser`
`createExchangePoolAccounts`	`sameOrgEndorser`
`addConversionRate`	`sameOrgEndorser`
`updateConversionRate`	`sameOrgEndorser`
`mintWithFundingExchangePool`	`sameOrgEndorser`
`tokenConversion`	`endorsers`
`getConversionRate`	`endorsers`
`getConversionHistory`	`endorsers`
`getConversionRateHistory`	`endorsers`
`getExchangePoolUser`	`endorsers`
`getAccountOnHoldBalance`	`endorsers`
`getAccountStatus`	`endorsers`
`getAccountsByRole`	`endorsers`