Paquet de code de chaîne Stablecoin

Oracle Blockchain Platform Digital Assets Edition comprend un exemple de code de chaîne pour un scénario de cycle de vie stablecoin.

Le code de chaîne stablecoin prend en charge le cycle de vie complet d'un stablecoin, représenté par un jeton fongible basé sur la norme étendue Token Taxonomy Framework. Vous pouvez utiliser des méthodes de code de chaîne pour extraire, transférer, bloquer et graver des jetons avec des approbations basées sur le rôle.

L'ensemble de code de chaîne stablecoin est téléchargeable à partir de la console Oracle Blockchain Platform et comprend les composants suivants.

• Stablecoin.zip, un fichier d'archive qui contient le code de chaîne prédéfini pour le déploiement.
• Stablecoin.yaml, fichier de spécification que vous pouvez utiliser avec Blockchain App Builder pour échafauder le code de chaîne Stablecoin.
• Stablecoin_postman_collection.json, une collection Postman qui vous permet de tester les API dans le code de chaîne.
• README.md, un guide étape par étape pour l'utilisation du code de chaîne.

Pour obtenir l'ensemble de code de chaîne stablecoin, dans la console Oracle Blockchain Platform Digital Assets, cliquez sur l'onglet Digital Assets (Ressources numériques), puis sélectionnez Stablecoin Application.

Fichier de spécification

Le fichier de spécification stablecoin (Stablecoin.yml) est basé sur le fichier de spécification étendu Token Taxonomy Framework. En plus de la ressource stablecoin, le fichier de spécification définit les ressources AccountPolicyCheck, ApprovalPolicyCheck et ApprovalTransactions.

#
# Copyright (c) 2025, Oracle and/or its affiliates. All rights reserved. 
#

assets:

# Token asset to manage the complete lifecycle of stablecoin

    - name: stablecoin # Asset name
      type: token # Asset type
      standard: ttf+   # Token standard

      anatomy:
          type: fungible # Token type 
          unit: fractional # Token unit

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

      properties: # Custom asset attributes for stablecoin

          - name: currencyName # The currency name that the stablecoin is pegged with
            type: string
            mandatory: true

          - name: conversionRate # The currency to stablecoin conversion rate
            type: float
            mandatory: true

# Generic asset to maintain the account policy and approval policy details

    - name: AccountPolicyCheck # Asset name

      properties: # Asset attributes 

          - name: accountPolicyId
            type: string
            mandatory: true
            id: true
            derived:
              strategy: concat
              format: ["APID~%1~%2","orgId","userId"]

          - name: orgId
            type: string
            mandatory: true
            validate: required()

          - name: userId
            type: string
            mandatory: true
            validate: required()

          - name: kycCompliance  
            type: string
            validate: /^\s*(true|false)\s*$/
            mandatory: true            

          - name: amlCompliance 
            type: string
            validate: /^\s*(true|false)\s*$/
            mandatory: true

          - name: riskScore 
            type: float
            validate: min(0)

          - name: restrictionFlag 
            type: string
            validate: /^\s*(true|false)\s*$/ 
            mandatory: true

      methods:
          crud: [create, update, getById, delete]
          others: [getHistoryById, getByRange]  

    - name: ApprovalPolicyCheck # Asset name
      
      properties: # Asset attributes 

          - name: approvalPolicyId
            type: string
            mandatory: true
            id: true
            derived:
              strategy: concat
              format: ["GPID~%1~%2","transactionLowerLimit","transactionUpperLimit"]

          - name: transactionLowerLimit
            type: string
            validate: required()

          - name: transactionUpperLimit
            type: string
            validate: required()

          - name: numberOfApprovalsRequired
            type: number
            mandatory: true
            validate: min(0)

          - name: approverDetails
            type: approverDetails[]
 

      methods:
          crud: [create, update, getById, delete]
          others: [getHistoryById, getByRange]    

    - name: approverDetails # Asset name
      type: embedded
      properties: # Asset attributes 

          - name: approverOrgId  
            type: string
            mandatory: true
            validate: required()

          - name: approverUserId  
            type: string
            mandatory: true
            validate: required()

          - name: approvalSequence  
            type: number
            mandatory: true
            validate: positive()

    - name: ApprovalTransactions # Asset name
      
      properties: # Asset attributes 

          - name: approvalTransactionId
            type: string
            mandatory: true
            id: true
            derived:
              strategy: concat
              format: ["%1~%2","approvalOperationId","approverAccountId"]

          - name: approvalOperationId
            type: string
            mandatory: true

          - name: fromAccountId
            type: string  
            mandatory: true

          - name: toAccountId
            type: string
            mandatory: true

          - name: approverAccountId
            type: string
            mandatory: true   

          - name: totalApprovals
            type: number 
            mandatory: true 
            validate: min(0)

          - name: timestamp
            type: string 
            mandatory: true             

      methods:
          crud: [getById ]
          others: []
          
customMethods:

  - "getApproverDetailsByTransferAmount(Amount: number)" # Customized method for fetching approver details