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 di token di deposito illustra l'uso del framework generico di token fungibile, basato sullo standard esteso Token Taxonomy Framework supportato da Blockchain App Builder. Il campione rappresenta un sistema in cui i token di deposito rappresentano la valuta fiat detenuta presso istituti finanziari e sono emessi e gestiti da istituti finanziari regolamentati. Il file di specifica di esempio genera metodi per l'inizializzazione di un token di deposito, la gestione dei conti, l'assegnazione di ruoli e il completamento di operazioni quali la generazione, il trasferimento e la masterizzazione di token. Fornisce inoltre conti notarili per l'approvazione del conio e dei trasferimenti, applica la conformità ai limiti giornalieri a livello di account 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 dettagli sull'uso delle raccolte Postman, vedere i seguenti argomenti in Blockchain App Builder for Oracle Blockchain Platform.

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) 2025, 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

Oracle Blockchain Platform Digital Assets Edition 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 è true, le dichiarazioni a sostegno delle transazioni devono provenire dalla stessa organizzazione del richiedente. Il parametro endorsers specifica un elenco di peer che devono approvare la transazione. Per ulteriori informazioni, vedere Supporto dell'approvazione nelle raccolte postman in Blockchain App Builder for Oracle Blockchain Platform. La tabella seguente mostra 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`