Package de code chaîne Stablecoin
Oracle Blockchain Platform Digital Assets Edition inclut un exemple de code chaîne pour un scénario de cycle de vie stablecoin.
Le code 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. Les méthodes de code chaîne permettent d'extraire, de transférer, de bloquer et de brûler des jetons à l'aide d'approbations basées sur les rôles.
Le package de code chaîne stablecoin peut être téléchargé à partir de la console Oracle Blockchain Platform et comprend les composants suivants.
Stablecoin.zip, fichier d'archive contenant le code chaîne packagé pour le déploiement.Stablecoin.yaml, un fichier de spécification que vous pouvez utiliser avec Blockchain App Builder pour échafauder le code chaîneStablecoin.Stablecoin_postman_collection.json, une collection Postman qui vous permet de tester les API dans le code chaîne.README.md, guide détaillé sur l'utilisation du code chaîne.
Pour obtenir le package de code chaîne stablecoin, dans la console numérique Oracle Blockchain Platform, cliquez sur l'onglet Ressources numériques, puis sélectionnez Application Stablecoin.
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 TransferRestriction.#
# Copyright (c) 2026, 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
# AccountPolicyCheck — Defines policies for an account to decide whether an account is eligible to transact
- name: AccountPolicyCheck # Asset name
properties: # Asset attributes
- name: accountPolicyId #Unique derived ID for the account policy, ensuring one policy per account.
type: string
mandatory: true
id: true
derived:
strategy: concat
format: ["APID~%1~%2","orgId","userId"]
- name: orgId # Organization owning the account.
type: string
mandatory: true
validate: required()
- name: userId # Account holder identifier linked to this policy.
type: string
mandatory: true
validate: required()
- name: kycCompliance # Indicates whether KYC verification is complete. Required for transaction eligibility. If true, the account can transfer stablecoins.
type: string
validate: /^\s*(true|false)\s*$/
mandatory: true
- name: amlCompliance # Indicates AML screening status. Prevents suspicious accounts from transacting. If true, the account can transfer stablecoins.
type: string
validate: /^\s*(true|false)\s*$/
mandatory: true
- name: riskScore # Quantitative risk indicator.
type: float
validate: min(0)
- name: restrictionFlag #Transaction blocking flag. If true, hold operations are limited to the lowest bucket range defined in the approval policy, and any amount above that range is rejected;
#for transfer operations, the account can transfer only within the bucket limits specified in the TransferRestriction asset.
type: string
validate: /^\s*(true|false)\s*$/
mandatory: true
methods:
crud: [create, update, getById, delete]
others: [getHistoryById, getByRange]
# ApprovalPolicyCheck — Maps transaction amount slabs to approval rules
- name: ApprovalPolicyCheck # Asset name
properties: # Asset attributes
- name: approvalPolicyId # Unique derived identifier for each approval slab based on amount range.
type: string
mandatory: true
id: true
derived:
strategy: concat
format: ["GPID~%1~%2","transactionLowerLimit","transactionUpperLimit"]
- name: transactionLowerLimit # Minimum transaction amount where this rule applies.
type: float
validate: min(0)
mandatory: true
- name: transactionUpperLimit # Maximum transaction amount covered by this rule.
type: float
validate: min(0)
mandatory: true
- name: numberOfApprovalsRequired # Total approvals needed for transactions in this range.
type: number
mandatory: true
validate: min(0)
- name: approverDetails # List of authorized approvers and their sequence for this slab.
type: approverDetails[]
methods:
crud: [create, update, getById, delete]
others: [getHistoryById, getByRange]
# ApproverDetails (Embedded) — Defines the list of approvers along with the approval sequences
- name: approverDetails # Asset name
type: embedded
properties: # Asset attributes
- name: approverOrgId # Organization to which the approver belongs.
type: string
mandatory: true
validate: required()
- name: approverUserId # Specific user authorized to approve.
type: string
mandatory: true
validate: required()
- name: approvalSequence # Order of approval when sequential approvals are enforced.
type: number
mandatory: true
validate: positive()
# ApprovalTransactions — Tracks approval progress for a specific operation
- name: ApprovalTransactions # Asset name
properties: # Asset attributes
- name: approvalTransactionId # Unique ID for each approval action tied to operation and approver.
type: string
mandatory: true
id: true
derived:
strategy: concat
format: ["%1~%2~%3","approvalOperationId","approverOrgId", "approverUserId"]
- name: approvalOperationId # Identifier of the original transaction requiring approval.
type: string
mandatory: true
- name: fromAccountId # Source account involved in the operation.
type: string
mandatory: true
- name: toAccountId # Destination account for the operation.
type: string
mandatory: true
- name: approverOrgId # Organization of the approver performing the action.
type: string
mandatory: true
- name: approverUserId # User who approved the operation.
type: string
mandatory: true
- name: receivedApprovalsCount # Number of approvals completed so far.
type: number
mandatory: true
validate: min(0)
- name: requiredApprovalsCount # Total approvals needed before execution.
type: number
mandatory: true
validate: min(0)
- name: timestamp # Time when the approval was recorded for audit traceability.
type: string
mandatory: true
methods:
crud: [getById ]
others: []
# TransferRestriction — Defines global transaction boundaries
- name: TransferRestriction # Asset name
properties: # Asset attributes
- name: id # Unique identifier for the restriction rule.
type: string
mandatory: true
id: true
- name: transactionLowerLimit # Smallest allowable transfer amount in the system.
type: number
mandatory: true
default: 0
validate: min(0)
- name: transactionUpperLimit # Largest allowable transfer amount without special governance.
type: number
mandatory: true
default: 1000000
validate: min(0)
methods:
crud: [ ]
others: []
customMethods:
- "getApproverDetailsByTransferAmount(Amount: number)" # Customized method for fetching approver details