Pacchetto codice concatenato struttura token fungibile

Il framework token fungibile utilizza lo standard Token Taxonomy Framework esteso 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 in package per la distribuzione.
DepositToken.yaml, un file di specifica che è possibile utilizzare con Blockchain App Builder per eseguire lo scaffold del 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 dei token fungibili, nella console 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 di eventi nei codici concatenati generati per abilitare 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 Input Specification File for Fungible Token in Blockchain App Builder for Oracle Blockchain Platform.

Il codice concatenato del token di deposito si basa sullo standard del Token Taxonomy Framework esteso, con personalizzazioni per supportare lo scenario dell'applicazione. Per abilitare queste personalizzazioni è richiesta la sezione sul comportamento seguente 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) 2026, 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 catena

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 di sponsor
`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`