Méthodes de code de chaîne Stablecoin

Le code de chaîne stablecoin inclut toutes les méthodes TypeScript disponibles dans le code de chaîne générique Token Taxonomy Framework et des méthodes TypeScript supplémentaires propres au scénario stablecoin.

Méthodes d'actifs Stablecoin

L'actif stablecoin est basé sur la norme étendue Token Taxonomy Framework et prend en charge toutes les méthodes génériques pour cette norme. Pour plus d'informations sur les méthodes génériques Token Taxonomy Framework, voir Projet TypeScript réparti pour Token Taxonomy Framework dans Blockchain App Builder for Oracle Blockchain Platform.

Note :

Dans le code de chaîne stablecoin, la méthode executeHoldTokens se comporte différemment de la version générique. La version stablecoin de la méthode complète toujours le montant total de retenue, et ne prend pas en charge les transferts partiels.

Méthodes de vérification de politique de compte

createAccountPolicyCheck
Cette méthode crée une politique pour un compte spécifié. Cette méthode ne peut être appelée que par Token Admin ou Org Admin de l'organisation spécifiée. 
createAccountPolicyCheck(asset: AccountPolicyCheck)
Paramètres :
  • asset: AccountPolicyCheck class – Classe qui définit les paramètres de politique de compte, qui inclut les champs suivants :
    • accountPolicyId – Le système génère cet ID à partir des champs orgId et userId spécifiés. Vous ne fournissez pas ce champ manuellement.
    • orgId - ID fournisseur de services d'adhésion (MSP) de l'utilisateur pour lequel créer la politique.
    • userId – Nom d'utilisateur ou ID courriel de l'utilisateur pour lequel créer la politique.
    • kycCompliance – Valeur booléenne qui indique si le compte satisfait aux exigences de connaissance du client.
    • amlCompliance – Valeur booléenne indiquant si le compte répond aux exigences de lutte contre le blanchiment d'argent.
    • riskScore – Note de risque associée au compte, qui est utilisée pour l'évaluation de la conformité.
    • restrictionFlag – Valeur booléenne indiquant si le compte fait l'objet de transferts restreints. Si la valeur est réglée à true, seuls les transferts au seuil d'approbation-politique le plus bas sont autorisés.
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "02875ca9c6a7408da3f81156214228b91b09c4bb2b8026d7a5733b53598c6635",
        "payload": {
            "assetType": "AccountPolicyCheck",
            "accountPolicyId": "APID~CentralBank~cb__creator_demo",
            "orgId": "CentralBank",
            "userId": "cb__creator_demo",
            "kycCompliance": "true",
            "amlCompliance": "true",
            "riskScore": 1000,
            "restrictionFlag": "false"
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 272
    }
}
getAccountPolicyCheckById
Cette méthode obtient les détails de la politique de compte pour un ID politique spécifié. Cette méthode ne peut être appelée que par Token Admin ou Token Auditor, ou par Org Admin ou Org Auditor de l'organisation spécifiée. 
getAccountPolicyCheckById(id: string)
Paramètres :
  • id: string – ID politique de compte unique.
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "02875ca9c6a7408da3f81156214228b91b09c4bb2b8026d7a5733b53598c6635",
        "payload": {
            "assetType": "AccountPolicyCheck",
            "accountPolicyId": "APID~CentralBank~cb__creator_demo",
            "orgId": "CentralBank",
            "userId": "cb__creator_demo",
            "kycCompliance": "true",
            "amlCompliance": "true",
            "riskScore": 1000,
            "restrictionFlag": "false"
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 272
    }
}
updateAccountPolicyCheck
Cette méthode met à jour la politique pour un compte spécifié. Cette méthode ne peut être appelée que par Token Admin ou Org Admin de l'organisation spécifiée. 
updateAccountPolicyCheck(asset: AccountPolicyCheck)
Paramètres :
  • asset: AccountPolicyCheck class – Classe qui définit les paramètres de politique de compte, qui inclut les champs suivants :
    • accountPolicyId – ID politique de compte unique.
    • orgId - ID fournisseur de services d'adhésion (MSP) de l'utilisateur pour lequel créer la politique.
    • userId – Nom d'utilisateur ou ID courriel de l'utilisateur pour lequel créer la politique.
    • kycCompliance – Valeur booléenne qui indique si le compte satisfait aux exigences de connaissance du client.
    • amlCompliance – Valeur booléenne indiquant si le compte répond aux exigences de lutte contre le blanchiment d'argent.
    • riskScore – Note de risque associée au compte, qui est utilisée pour l'évaluation de la conformité.
    • restrictionFlag – Valeur booléenne indiquant si le compte fait l'objet de transferts restreints. Si la valeur est réglée à true, seuls les transferts au seuil d'approbation-politique le plus bas sont autorisés.
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "02875ca9c6a7408da3f81156214228b91b09c4bb2b8026d7a5733b53598c6635",
        "payload": {
            "assetType": "AccountPolicyCheck",
            "accountPolicyId": "APID~CentralBank~cb__creator_demo",
            "orgId": "CentralBank",
            "userId": "cb__creator_demo",
            "kycCompliance": "true",
            "amlCompliance": "true",
            "riskScore": 1000,
            "restrictionFlag": "true"
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 272
    }
}
deleteAccountPolicyCheck
Cette méthode supprime la politique pour un ID politique spécifié. Cette méthode ne peut être appelée que par Token Admin ou Org Admin de l'organisation spécifiée. 
deleteAccountPolicyCheck(id: string)
Paramètres :
  • id: string – ID politique de compte unique.
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "5499f49ae8595facbcbf56835bed9e6606875c0f54fd3cacb31a4104b56d3579",
        "payload": {
            "isValid": true,
            "message": "Successfully deleted asset with ID [APID~CentralBank~cb__creator_demo] from ledger"
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 273
    }
}
getAccountPolicyCheckHistoryById
Cette méthode obtient l'historique complet de la politique de compte pour un ID politique spécifié. Cette méthode ne peut être appelée que par Token Admin ou Token Auditor, ou par Org Admin ou Org Auditor de l'organisation spécifiée. 
getAccountPolicyCheckHistoryById(id: string)
Paramètres :
  • id: string – ID politique de compte unique.
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": [
            {
                "trxId": "dbfd34199bc5ea7224ca6c9976e30166dc859923ab044e595d0d42ad842eb471",
                "timeStamp": "2025-11-20T21:36:29.000Z",
                "value": {
                    "assetType": "AccountPolicyCheck",
                    "accountPolicyId": "APID~CentralBank~cb__creator_demo",
                    "orgId": "CentralBank",
                    "userId": "cb__creator_demo",
                    "kycCompliance": "true",
                    "amlCompliance": "true",
                    "riskScore": 1000,
                    "restrictionFlag": "true"
                }
            },
            {
                "trxId": "8b6951a4093f3bb79a489397878f9025ce4384c8973a0c4d0ec9c618667e8935",
                "timeStamp": "2025-11-20T21:35:34.000Z",
                "value": {
                    "assetType": "AccountPolicyCheck",
                    "accountPolicyId": "APID~CentralBank~cb__creator_demo",
                    "orgId": "CentralBank",
                    "userId": "cb__creator_demo",
                    "kycCompliance": "true",
                    "amlCompliance": "true",
                    "riskScore": 1000,
                    "restrictionFlag": "false"
                }
            },
            {
                "trxId": "5499f49ae8595facbcbf56835bed9e6606875c0f54fd3cacb31a4104b56d3579",
                "timeStamp": "2025-11-20T21:34:03.000Z",
                "value": "KEY DELETED"
            },
            {
                "trxId": "02875ca9c6a7408da3f81156214228b91b09c4bb2b8026d7a5733b53598c6635",
                "timeStamp": "2025-11-20T21:33:24.000Z",
                "value": {
                    "assetType": "AccountPolicyCheck",
                    "accountPolicyId": "APID~CentralBank~cb__creator_demo",
                    "orgId": "CentralBank",
                    "userId": "cb__creator_demo",
                    "kycCompliance": "true",
                    "amlCompliance": "true",
                    "riskScore": 1000,
                    "restrictionFlag": "false"
                }
            }
        ],
        "encode": "JSON"
    }
}
getAccountPolicyCheckByRange
Cette méthode obtient tout l'historique des politiques pour un intervalle d'ID politiques spécifié. Cette méthode ne peut être appelée que par Token Admin ou Org Admin de l'organisation spécifiée. 
getAccountPolicyCheckByRange(startId: string, endId: string)
Paramètres :
  • startId: string – ID politique de compte de départ de l'intervalle (inclus).
  • endId: string – ID politique de compte de fin de l'intervalle (exclusif).
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": [
            {
                "assetType": "AccountPolicyCheck",
                "accountPolicyId": "APID~CentralBank~cb__creator_demo",
                "orgId": "CentralBank",
                "userId": "cb__creator_demo",
                "kycCompliance": "true",
                "amlCompliance": "true",
                "riskScore": 1000,
                "restrictionFlag": "true"
            },
            {
                "assetType": "AccountPolicyCheck",
                "accountPolicyId": "APID~CentralBank~cb_issuer_demo",
                "orgId": "CentralBank",
                "userId": "cb_issuer_demo",
                "kycCompliance": "true",
                "amlCompliance": "true",
                "riskScore": 1000,
                "restrictionFlag": "false"
            }
        ],
        "encode": "JSON"
    }
}

Méthodes de vérification de la politique d'approbation

createApprovalPolicyCheck
Cette méthode crée une politique d'approbation. Cette méthode ne peut être appelée que par Token Admin. 
createApprovalPolicyCheck(asset: ApprovalPolicyCheck)
Paramètres :
  • asset: ApprovalPolicyCheck class – Classe qui définit les règles d'approbation pour une transaction, qui inclut les champs suivants :
    • approvalPolicyId – Le système génère cet ID. Vous ne fournissez pas ce champ manuellement.
    • transactionLowerLimit – Montant minimal de transaction auquel s'applique la politique d'approbation.
    • transactionUpperLimit – Montant de transaction maximal auquel s'applique la politique d'approbation.
    • numberOfApprovalsRequired – Nombre total d'approbations nécessaires avant que la transaction puisse être terminée.
    • approverDetails – Liste des approbateurs ainsi que la séquence d'approbation qui leur est affectée, qui définit l'ordre obligatoire pour les approbations.
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "3a5701ca90ffb98832421c7d5377eb9c0df9fdab30a0a3ce06216808bdea098e",
        "payload": {
            "status": "active",
            "assetType": "ApprovalPolicyCheck",
            "approvalPolicyId": "GPID~500~1000",
            "transactionLowerLimit": "500",
            "transactionUpperLimit": "1000",
            "numberOfApprovalsRequired": 2,
            "approverDetails": [
                {
                    "approverOrgId": "CentralBank",
                    "approverUserId": "manager",
                    "approvalSequence": 1
                },
                {
                    "approverOrgId": "CentralBank",
                    "approverUserId": "creator",
                    "approvalSequence": 2
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 284
    }
}
getApprovalPolicyCheckById
Cette méthode obtient les détails de la politique d'approbation pour un ID politique spécifié. Cette méthode ne peut être appelée que par Token Admin ou Org Admin de l'organisation spécifiée. 
getApprovalPolicyCheckById(id: string)
Paramètres :
  • id: string – ID politique d'approbation unique.
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "assetType": "ApprovalPolicyCheck",
            "approvalPolicyId": "GPID~0~100",
            "transactionLowerLimit": "0",
            "transactionUpperLimit": "100",
            "numberOfApprovalsRequired": 0,
            "approverDetails": []
        },
        "encode": "JSON"
    }
}
updateApprovalPolicyCheck
Cette méthode met à jour la politique d'approbation. Cette méthode ne peut être appelée que par Token Admin. 
updateApprovalPolicyCheck(asset: ApprovalPolicyCheck)
Paramètres :
  • asset: ApprovalPolicyCheck class – Classe qui définit les règles d'approbation pour une transaction, qui inclut les champs suivants :
    • approvalPolicyId – ID politique d'approbation unique.
    • transactionLowerLimit – Montant minimal de transaction auquel s'applique la politique d'approbation.
    • transactionUpperLimit – Montant de transaction maximal auquel s'applique la politique d'approbation.
    • numberOfApprovalsRequired – Nombre total d'approbations nécessaires avant que la transaction puisse être terminée.
    • approverDetails – Liste des approbateurs ainsi que la séquence d'approbation qui leur est affectée, qui définit l'ordre obligatoire pour les approbations.
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "ed1e1950fe02dbab74fa3aa7630b8dc6096e30aae5c81bab0dd22d5232c44fc9",
        "payload": {
            "status": "active",
            "assetType": "ApprovalPolicyCheck",
            "approvalPolicyId": "GPID~500~1000",
            "transactionLowerLimit": "500",
            "transactionUpperLimit": "1000",
            "numberOfApprovalsRequired": 1,
            "approverDetails": [
                {
                    "approverOrgId": "CentralBank",
                    "approverUserId": "manager",
                    "approvalSequence": 1
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20009",
        "blockNumber": 285
    }
}
deleteApprovalPolicyCheck
Cette méthode supprime la politique d'approbation pour un ID politique spécifié. Cette méthode ne peut être appelée que par Token Admin. 
deleteApprovalPolicyCheck(id: string)
Paramètres :
  • id: string – ID politique d'approbation unique.
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "5ac54d3279a183022a00495aee3c25c2893388ff9aaaecd5c3b594edfa49ad8f",
        "payload": {
            "isValid": true,
            "message": "Successfully deleted asset with ID [GPID~500~1000] from ledger"
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20009",
        "blockNumber": 286
    }
}
getApprovalPolicyCheckHistoryById
Cette méthode obtient l'historique complet de la politique d'approbation pour un ID politique spécifié. Cette méthode ne peut être appelée que par Token Admin ou Org Admin de l'organisation spécifiée. 
getApprovalPolicyCheckHistoryById(id: string)
Paramètres :
  • id: string – ID politique d'approbation unique.
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": [
            {
                "trxId": "48f196c18869e871dc92ab880933ccc1c4dc402b9753ae6270e223646c177090",
                "timeStamp": "2025-11-21T09:30:04.000Z",
                "value": {
                    "assetType": "ApprovalPolicyCheck",
                    "approvalPolicyId": "GPID~0~100",
                    "transactionLowerLimit": "0",
                    "transactionUpperLimit": "100",
                    "numberOfApprovalsRequired": 0,
                    "approverDetails": []
                }
            }
        ],
        "encode": "JSON"
    }
}
getApprovalPolicyCheckByRange
Cette méthode obtient tout l'historique de la politique d'approbation pour un intervalle d'ID politiques spécifié. Cette méthode ne peut être appelée que par Token Admin ou Org Admin de l'organisation spécifiée. 
getApprovalPolicyCheckByRange(startId: string, endId: string)
Paramètres :
  • startId: string – ID politique d'approbation de début de l'intervalle (inclus).
  • endId: string – ID politique d'approbation finale de l'intervalle (exclusif).
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": [
            {
                "assetType": "ApprovalPolicyCheck",
                "approvalPolicyId": "GPID~0~100",
                "transactionLowerLimit": "0",
                "transactionUpperLimit": "100",
                "numberOfApprovalsRequired": 0,
                "approverDetails": []
            },
            {
                "status": "active",
                "assetType": "ApprovalPolicyCheck",
                "approvalPolicyId": "GPID~500~1000",
                "transactionLowerLimit": "500",
                "transactionUpperLimit": "1000",
                "numberOfApprovalsRequired": 2,
                "approverDetails": [
                    {
                        "approverOrgId": "CentralBank",
                        "approverUserId": "manager",
                        "approvalSequence": 1
                    },
                    {
                        "approverOrgId": "CentralBank",
                        "approverUserId": "creator",
                        "approvalSequence": 2
                    }
                ]
            }
        ],
        "encode": "JSON"
    }
}

Méthodes de transactions d'approbation

getApprovalTransactionById
Cette méthode permet d'obtenir la transaction d'approbation pour un code de transaction précisé. Cette méthode ne peut être appelée que par Token Admin ou Org Admin de l'organisation spécifiée. 
getApprovalTransactionsById(id: string)
Paramètres :
  • id: string – ID généré par le système de la transaction d'approbation.
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "assetType": "ApprovalTransactions",
            "approvalTransactionId": "hold1~oaccount~1cf5d40c7ea7b9dceedfc66292ab843c1583564c3ecaf9f5ceb11f834018b02f",
            "approvalOperationId": "hold1",
            "fromAccountId": "oaccount~374e4e762940fc185c7cd5b6528c7f94985b6c56acf46abb746de6381589edd2",
            "toAccountId": "oaccount~79c427e614530eacad6fb07cff6048f6b96283e65019301320c9684932846f64",
            "approverAccountId": "oaccount~1cf5d40c7ea7b9dceedfc66292ab843c1583564c3ecaf9f5ceb11f834018b02f",
            "totalApprovals": 1,
            "timestamp": "2025-11-21T12:32:43.000Z"
        },
        "encode": "JSON"
    }
}

Méthodes personnalisées

getApproverDetailsByTransferAmount
Cette méthode permet d'obtenir les détails de l'approbateur requis pour un montant de transfert donné. Cette méthode ne peut être appelée que par Token Admin ou Token Auditor. 
getApproverDetailsByTransferAmount(Amount: number)
Paramètres :
  • amount: number – Montant du transfert.
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "5874105c14abd67e68cb4dacf82f2a2dca6cc9da4f5b27fcc91c83a60b7249e1",
        "payload": {
            "approverDetails": [
                {
                    "approverOrgId": "CentralBank",
                    "approverUserId": "manager",
                    "approvalSequence": 1
                },
                {
                    "approverOrgId": "CentralBank",
                    "approverUserId": "creator",
                    "approvalSequence": 2
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 292
    }
}
approveTransaction
Un approbateur peut utiliser cette méthode pour approuver une transaction bloquée.
approveTransaction(token_id: string, operation_id: string, quantity: number)
Paramètres :
  • token_id: string – ID du jeton.
  • operation_id: string – ID unique permettant d'identifier l'opération de blocage. En général, cet ID est transmis par l'application client.
  • quantity: number – Nombre de jetons bloqués à approuver pour le transfert.
Exemple de valeur renvoyée :
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "44685b0ff1b0ee72d57cb62900aae30638d65c82f264d5de7b28375732171702",
        "payload": {
            "assetType": "ApprovalTransactions",
            "approvalTransactionId": "hold1~oaccount~1cf5d40c7ea7b9dceedfc66292ab843c1583564c3ecaf9f5ceb11f834018b02f",
            "approvalOperationId": "hold1",
            "fromAccountId": "oaccount~374e4e762940fc185c7cd5b6528c7f94985b6c56acf46abb746de6381589edd2",
            "toAccountId": "oaccount~79c427e614530eacad6fb07cff6048f6b96283e65019301320c9684932846f64",
            "approverAccountId": "oaccount~1cf5d40c7ea7b9dceedfc66292ab843c1583564c3ecaf9f5ceb11f834018b02f",
            "totalApprovals": 1,
            "timestamp": "2025-11-21T12:32:43.000Z"
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 289
    }
}