Ensemble d'API d'emballage CBDC en gros confidentiel
Oracle Blockchain Platform Digital Assets Edition comprend un ensemble d'API wrapper qui étend l'API REST pour prendre en charge les opérations spécifiques à la version en mode confidentiel du scénario CBDC de gros.
WholesaleCBDCWithConfidentialPaymentWrapperAPI.zip
, un fichier d'archive qui contient l'ensemble d'API d'encapsulation, y compris les scripts Terraform requis pour le déploiement. Vous déployez ce fichier dans une pile du gestionnaire de ressources sur OCI pour créer les ressources Oracle nécessaires pour les API d'encapsuleur.WholesaleCBDCWithConfidentialPayment_WrapperAPI.postman_collection
, une collection Postman qui vous permet de tester les API d'encapsuleur déployées. La collection comprend des demandes préconfigurées avec des points d'extrémité et des données utiles qui correspondent aux API définies dans l'ensemble d'API wrapper.
API d'encapsuleur
-
activateCBDCAccount
- Nom de la méthode initiale :
activateAccount
- Cette méthode POST active un compte de jeton. Cette méthode ne peut être appelée que par
Token Admin
ouOrg Admin
de l'organisation spécifiée. Les comptes supprimés ne peuvent pas être activés. - Données utiles :
{ "accountId": "account_id value", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
accountId: string
– ID du compte.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Retourne :
- En cas de succès, une représentation JSON de l'objet de statut de compte pour le compte de jeton spécifié.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "864cdbc5b4ee1a6f2238301e75ee2ddff0ecfa490ddf490da33365cae92cb4ad", "payload": { "assetType": "oaccountStatus", "status_id": "oaccountStatus~4c900b07f6136f36854064c0c0ba97aa09c9734cbe11966cc83865f156ced2c6", "account_id": "oaccount~214ad54a30703412b195f36429607b08627dea893303870bf3372f944fe0c088", "status": "active" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010", "blockNumber": 58 } }
-
addCBAdmin
- Nom de la méthode initiale :
addTokenAdmin
- Cette méthode POST ajoute un utilisateur en tant que
Token Admin
du code de chaîne de jeton. La méthode ne peut être appelée que parToken Admin
du code de chaîne de jeton. Le premier appel provient de l'administrateur qui instancie le code de chaîne. - Données utiles :
{ "orgId": "{{bc-org-id}}", "userId": "{{bc-user-id}}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
orgId: string
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation courante.userId: string
– Nom d'utilisateur ou ID courriel de l'utilisateur.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "a988dc3e9aab162508fd0555fec254f248e27fd0c5440d94e1f49fc65643cafa", "payload": { "msg": "Successfully added Token Admin (Org_Id: CentralBank, User_Id: user1)" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010", "blockNumber": 69 } }
-
addCBAuditor
- Nom de la méthode initiale :
addTokenAuditor
- Cette méthode POST ajoute des auditeurs de jeton au code de chaîne de jeton. Cette méthode ne peut être appelée que par
Token Admin
du code de chaîne. - Données utiles :
{ "orgId": "{{bc-org-id}}", "userId": "{{bc-user-id}}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
orgId: string
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation courante.userId: string
– Nom d'utilisateur ou ID courriel de l'utilisateur.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "864cdbc5b4ee1a6f2238301e75ee2ddff0ecfa490ddf490da33365cae92cb4ad", "payload": { "assetType": "oaccountStatus", "status_id": "oaccountStatus~4c900b07f6136f36854064c0c0ba97aa09c9734cbe11966cc83865f156ced2c6", "account_id": "oaccount~214ad54a30703412b195f36429607b08627dea893303870bf3372f944fe0c088", "status": "active" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010", "blockNumber": 58 } }
-
addFIAdmin
- Nom de la méthode initiale :
addOrgAdmin
- Cette méthode ajoute des administrateurs d'organisation au code de chaîne de jeton. Cette méthode ne peut être appelée que par
Token Admin
ouOrg Admin
de l'organisation spécifiée. - Données utiles :
{ "orgId": "{{bc-org-id}}", "userId": "{{bc-user-id}}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
orgId: string
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation courante.userId: string
– Nom d'utilisateur ou ID courriel de l'utilisateur.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "ab1544c0d23d930253e6e6020c7c9584f03d324fb1123cc96fe7e0573b232792", "payload": { "msg": "Successfully added Org Admin (Org_Id: CentralBank, User_Id: cb_admin_demo)" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010", "blockNumber": 61 } }
-
addFIAuditor
- Nom de la méthode initiale :
addOrgAuditor
- Cette méthode ajoute des auditeurs d'organisation au code de chaîne de jeton. Cette méthode ne peut être appelée que par
Token Admin
ouOrg Admin
de l'organisation spécifiée. - Données utiles :
{ "orgId": "{{bc-org-id}}", "userId": "{{bc-user-id}}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
orgId: string
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation courante.userId: string
– Nom d'utilisateur ou ID courriel de l'utilisateur.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "c0acbadfa461963a5d085bb12335dcf6d8ec566acf72a88a1f168b3a0435db89", "payload": { "msg": "Successfully added Org Auditor (Org_Id: CentralBank, User_Id: cb_admin_demo)" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010", "blockNumber": 62 } }
-
addRole
- Nom de la méthode initiale :
addRole
- Cette méthode ajoute le rôle à l'utilisateur et au jeton spécifiés. Les ID compte sont formés en créant un code de hachage SHA-256 de l'ID jeton concaténé, de l'ID organisation et de l'ID utilisateur. Cette méthode ne peut être appelée que par
Token Admin
ouOrg Admin
de l'organisation spécifiée. - Données utiles :
{ "accountId": "account_id value", "role": "role value (for example minter / burner / notary)", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
accountId: string
– ID du compte.role: string
– Nom du rôle à ajouter à l'utilisateur spécifié.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "c44931d2227305914db21564301775f8a4edc2aa7fef434d063be7e207b4fd20", "payload": { "msg": "Successfully added role 'minter' to Account Id: oaccount~214ad54a30703412b195f36429607b08627dea893303870bf3372f944fe0c088" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20009", "blockNumber": 63 } }
-
approveCBDCCreation
- Nom de la méthode initiale :
approveMint
- Les notaires peuvent appeler cette méthode POST pour approuver une demande de mint.
- Données utiles :
{ "tokenId": "{{bc-token-id}}", "operationId": "operation_id value", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
tokenId: string
– ID du jeton.operationId: string
– ID opération unique de la demande de menthe à approuver.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "4514aa229ebcc4d2fedcaa47c4301615e30c4a9bae45cf0256a5b80d75b3697a", "payload": { "msg": "Successfully minted 1000 tokens to Account Id: oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20011", "blockNumber": 337 } }
-
approveCBDCRetirement
- Nom de la méthode initiale :
approveBurn
- Les notaires peuvent appeler cette méthode POST pour approuver une demande de gravure.
- Données utiles :
{ "tokenId": "{{bc-token-id}}", "operationId": "operation_id value", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
tokenId: string
– ID du jeton.operationId: string
– ID opération unique de la demande de menthe à approuver.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "8c7b013765917ebade60c6e6e122ec9b94282349e630fa1f2a446c79cb9ef29c", "payload": { "msg": "Successfully burned 200 tokens from account id: oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98 (Org-Id: CentralBank, User-Id: cb_retirer_demo)" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20011", "blockNumber": 338 } }
-
approveHoldCBDCTokens
- Nom de la méthode initiale :
executeHoldTokens
- Les notaires appellent cette méthode pour approuver un blocage des jetons, ce qui déclenche le transfert des jetons du payeur au bénéficiaire dans ce scénario d'affaires. La quantité de jetons précédemment bloqués par le propriétaire du jeton est maintenant transférée au destinataire. Si la valeur
quantity
est inférieure à la valeur de blocage réelle, le montant restant est de nouveau disponible pour le responsable du jeton. Si le comportementroles
est spécifié dans la sectionbehaviors
du modèle de jeton et que la valeurnotary_role_name
est définie, le compte de l'appelant doit avoir un rôle de notaire. Sinon, tout appelant avec un compte peut fonctionner comme un notaire. - Données utiles :
{ "tokenId": "{{bc-token-id}}", "operationId": "operation_id value", "quantity": 1, "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
tokenId: string
– ID du jeton.operationId: string
– ID opération unique de la demande de menthe à approuver.quantity: number
– Le nombre de jetons détenus à transférer.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "5177f7560d32838242a26ac74f2a90c6ff9b47aae0d0988f28d9b4cf7e27c097", "payload": { "msg": "Account Id: oaccount~1e31495a0c149b08cb9d02bdcac5e83d88c0f1557d954dda12bb807d7f6fc111 (Org-Id: Org1, User-Id: fi1_org_user1_demo) is successfully executed '10' tokens from Operation Id '454f4bf6'." }, "encode": "JSON", "sourceURL": "org1-oabcs1-nrt.blockchain.ocp.example.com:20009", "blockNumber": 339 } }
-
consolidateRunningBalanceInTransactions
- Nom de la méthode initiale :
consolidateRunningBalanceInTransactions
- Cette méthode consolide les soldes d'exécution des comptes dans l'organisation de l'appelant. Cette méthode ne peut être appelée que par
Token Admin
ouOrg Admin
. - Données utiles :
{ "endorsers": {{endorsers}} }
- Paramètres :
endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "f3c019974cd93eaa8f3171a36ec25009fa6925b5880cae8c9a49a141944039c0", "payload": { "msg": "Successfully updated account running balance for pending transactions." }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20009", "blockNumber": 340 } }
-
associateTokenToAccount
- Nom de la méthode initiale :
associateTokenToAccount
- Cette méthode POST associe un ID compte spécifié à un jeton spécifié. Cette méthode ne peut être appelée que par
Token Admin
ouOrg Admin
de l'organisation spécifiée. - Données utiles :
{ "accountId": "account_id value", "tokenId": "{{bc-token-id}}", "customAccountId": "custom_account_id value", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
accountId: string
– ID du compte.tokenId: string
– ID du jeton.customAccountId: string
- ID aléatoire unique des comptes en mode confidentiel.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "fc7e9297d1d7beef5567fbef873955f5a9759d031811198e24f67f064e0e80b0", "payload": { "bapAccountVersion": 0, "assetType": "oaccount", "account_id": "oaccount~b53cb2c19c92d1d5c8cb9f6e988e7761c34e03e014e6c4b889565fc0abf46c8a", "org_id": "CentralBank", "token_type": "fungible", "token_id": "USD", "token_name": "cbdc", "balance": "028b72742c8aa9a0395c828fe4f0e46226a3e40d4e731d0b994c8028c8b7bd4df6", "onhold_balance": "028b72742c8aa9a0395c828fe4f0e46226a3e40d4e731d0b994c8028c8b7bd4df6", "onhold_burn_balance": "028b72742c8aa9a0395c828fe4f0e46226a3e40d4e731d0b994c8028c8b7bd4df6", "application_groups": [ "CENTRAL_BANK_USERS" ] }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20009", "blockNumber": 71 } }
-
createAccount
- Nom de la méthode initiale :
createAccount
- Cette méthode crée un compte pour un utilisateur et un jeton spécifiés. Un compte doit être créé pour tout utilisateur qui aura des jetons à tout moment. Les comptes assurent le suivi des soldes, des soldes bloqués et de l'historique des transactions. Un ID compte est un jeu alphanumérique de caractères, précédé de
oaccount~<token asset name>~
et suivi d'un hachage du nom d'utilisateur ou de l'ID courriel (userId
) du responsable de l'instance ou de l'utilisateur connecté à l'instance, de l'ID fournisseur de services d'adhésion (orgId
) de l'utilisateur dans l'organisation de réseau courante. Cette méthode ne peut être appelée que par unToken Admin
du code de chaîne ou par unOrg Admin
de l'organisation spécifiée. - Données utiles :
{ "orgId": "{{bc-org-id}}", "userId": "{{bc-user-id}}", "tokenType": "fungible", "applicationGroups": "[\"application_groups value\"]", "dailyLimits": "{\"max_daily_amount\":10000,\"max_daily_transactions\":100}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
orgId
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur pour lequel créer le compte. L'ID doit commencer par un caractère alphanumérique et peut inclure des lettres, des chiffres et des caractères spéciaux tels que des traits de soulignement (_), des points (.), des signes at (@) et des tirets (-).userId
– Nom d'utilisateur ou ID courriel de l'utilisateur. L'ID doit commencer par un caractère alphanumérique et peut inclure des lettres, des chiffres et des caractères spéciaux tels que des traits de soulignement (_), des points (.), des signes at (@) et des tirets (-).tokenType: TokenType
– Type de jeton, qui doit êtrefungible
.applicationGroups: string[]
– Liste des groupes d'applications auxquels appartient l'ID utilisateur, qui définissent les associations de l'utilisateur dans l'application CBDC.dailyLimits: JSON object
– Objet JSON du type suivant.
Dans l'exemple, la valeur{ "max_daily_amount": 100000 "max_daily_transactions": 10000 }
max_daily_amount
est le nombre maximal de jetons pouvant être traités quotidiennement et la valeurmax_daily_transactions
est le nombre maximal de transactions pouvant être effectuées quotidiennement.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "dc167f95bdcc246c9ecb20e56126c705f522cff30c94798f21a82de111367ab8", "payload": { "bapAccountVersion": 0, "assetType": "oaccount", "account_id": "oaccount~b53cb2c19c92d1d5c8cb9f6e988e7761c34e03e014e6c4b889565fc0abf46c8a", "org_id": "CentralBank", "token_type": "fungible", "token_id": "", "token_name": "", "balance": "028b72742c8aa9a0395c828fe4f0e46226a3e40d4e731d0b994c8028c8b7bd4df6", "onhold_balance": "028b72742c8aa9a0395c828fe4f0e46226a3e40d4e731d0b994c8028c8b7bd4df6", "onhold_burn_balance": "028b72742c8aa9a0395c828fe4f0e46226a3e40d4e731d0b994c8028c8b7bd4df6", "application_groups": [ "CENTRAL_BANK_USERS" ] }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010", "blockNumber": 70 } }
-
getAccountDetailsByCustomAccountId
- Nom de la méthode initiale :
getAccountDetailsByCustomAccountId
- Cette méthode GET retourne les détails du compte pour un ID compte personnalisé spécifié. Cette méthode peut être appelée par
Token Admin
ouToken Auditor
, ou parOrg Admin
ouOrg Auditor
de l'organisation spécifiée. - Interrogation :
getAccountDetailsByCustomAccountId?customAccountId=customAccountId value&orgId={{bc-org-id}}&peer={{peer}}
- Paramètres :
customAccountId: string
- ID aléatoire unique des comptes en mode confidentiel.orgId: string
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation courante.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "cf46211c670f7d21feb000a0161baaced91be314ea53981e26dc1482924055c9", "payload": [ { "bapAccountVersion": 0, "assetType": "oaccount", "account_id": "oaccount~c44ffac4c46718e9744cb0aae2016d26a87a5bef5e2d1c0d1abc7d8782f0ba61", "org_id": "CentralBank", "token_type": "fungible", "token_id": "USD", "token_name": "cbdc", "balance": "0", "onhold_balance": "0", "onhold_burn_balance": "0", "application_groups": [ "SYSTEM_ADMINS" ], "user_id": "cb_admin_demo", "custom_account_id": "10101234000123" } ], "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20012", "blockNumber": 341 } }
-
getAllActiveCBDCAccounts
- Nom de la méthode initiale :
getAllActiveAccounts
- Cette méthode GET retourne tous les comptes actifs associés à l'ID jeton spécifié.
- Interrogation :
getAllActiveCBDCAccounts?orgId={{bc-org-id}}&tokenId={{bc-token-id}}&peer={{peer}}
- Paramètres :
tokenId: string
– ID du jeton.orgId: string
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation courante.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Retourne :
- En cas de succès, un message qui inclut les détails de l'utilisateur. La sortie varie en fonction du rôle de l'utilisateur, comme illustré dans les exemples suivants.
- Exemple de valeur de retour (Administrateur de jetons, Vérificateur de jetons, Administrateur d'organisations, Vérificateur d'organisations) :
{ "returnCode": "Success", "error": "", "result": { "payload": [ { "key": "oaccount~c44ffac4c46718e9744cb0aae2016d26a87a5bef5e2d1c0d1abc7d8782f0ba61", "role_name": null, "valueJson": { "account_id": "oaccount~c44ffac4c46718e9744cb0aae2016d26a87a5bef5e2d1c0d1abc7d8782f0ba61", "org_id": "CentralBank", "token_id": "USD", "application_groups": [ "SYSTEM_ADMINS" ], "max_daily_amount": "10000", "max_daily_transactions": "1000" }, "non_account_role_name": [ "token_admin" ] }, { "key": "oaccount~1a6ea9aaa59c9ae8385bfdc870bf02616995c881ffeb111f526c8b31dbbdd43c", "role_name": null, "valueJson": { "account_id": "oaccount~1a6ea9aaa59c9ae8385bfdc870bf02616995c881ffeb111f526c8b31dbbdd43c", "org_id": "CentralBank", "token_id": "USD", "application_groups": [ "SYSTEM_AUDITORS" ], "max_daily_amount": "10000", "max_daily_transactions": "1000" }, "non_account_role_name": [ "token_auditor" ] }, { "key": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "role_name": "minter", "valueJson": { "account_id": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "org_id": "CentralBank", "token_id": "USD", "application_groups": [ "SYSTEM_CREATORS" ], "max_daily_amount": "1000000", "max_daily_transactions": "100000" }, "non_account_role_name": [] }, { "key": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "role_name": "notary", "valueJson": { "account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "org_id": "CentralBank", "token_id": "USD", "application_groups": [ "SYSTEM_MANAGERS" ], "max_daily_amount": "10000", "max_daily_transactions": "1000" }, "non_account_role_name": [] }, { "key": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "role_name": null, "valueJson": { "account_id": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "org_id": "CentralBank", "token_id": "USD", "application_groups": [ "SYSTEM_ISSUERS" ], "max_daily_amount": "100000", "max_daily_transactions": "10000" }, "non_account_role_name": [] }, { "key": "oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98", "role_name": "burner", "valueJson": { "account_id": "oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98", "org_id": "CentralBank", "token_id": "USD", "application_groups": [ "SYSTEM_RETIRERS" ], "max_daily_amount": "10000", "max_daily_transactions": "1000" }, "non_account_role_name": [] } ], "encode": "JSON" } }
- Exemple de valeur de retour (tous les autres utilisateurs) :
{ "returnCode": "Success", "error": "", "result": { "payload": [ { "key": "oaccount~c44ffac4c46718e9744cb0aae2016d26a87a5bef5e2d1c0d1abc7d8782f0ba61", "role_name": null, "valueJson": { "account_id": "oaccount~c44ffac4c46718e9744cb0aae2016d26a87a5bef5e2d1c0d1abc7d8782f0ba61", "org_id": "CentralBank", "token_id": "USD", "application_groups": [ "SYSTEM_ADMINS" ] } }, { "key": "oaccount~1a6ea9aaa59c9ae8385bfdc870bf02616995c881ffeb111f526c8b31dbbdd43c", "role_name": null, "valueJson": { "account_id": "oaccount~1a6ea9aaa59c9ae8385bfdc870bf02616995c881ffeb111f526c8b31dbbdd43c", "org_id": "CentralBank", "token_id": "USD", "application_groups": [ "SYSTEM_AUDITORS" ] } }, { "key": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "role_name": "minter", "valueJson": { "account_id": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "org_id": "CentralBank", "token_id": "USD", "application_groups": [ "SYSTEM_CREATORS" ] } }, { "key": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "role_name": "notary", "valueJson": { "account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "org_id": "CentralBank", "token_id": "USD", "application_groups": [ "SYSTEM_MANAGERS" ] } }, { "key": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "role_name": null, "valueJson": { "account_id": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "org_id": "CentralBank", "token_id": "USD", "application_groups": [ "SYSTEM_ISSUERS" ] } }, { "key": "oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98", "role_name": "burner", "valueJson": { "account_id": "oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98", "org_id": "CentralBank", "token_id": "USD", "application_groups": [ "SYSTEM_RETIRERS" ] } } ], "encode": "JSON" } }
-
getAllSuspendedCBDCAccounts
- Nom de la méthode initiale :
getAllSuspendedAccounts
- Cette méthode GET retourne tous les comptes suspendus associés à l'ID jeton spécifié.
- Interrogation :
/getAllSuspendedCBDCAccounts?orgId={{bc-org-id}}&tokenId={{bc-token-id}}&peer={{peer}}
- Paramètres :
tokenId: string
– ID du jeton.orgId: string
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation courante.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Retourne :
- En cas de succès, un message qui inclut les détails de l'utilisateur. La sortie varie en fonction du rôle de l'utilisateur, comme illustré dans les exemples suivants.
- Exemple de valeur de retour (Administrateur de jetons, Vérificateur de jetons, Administrateur d'organisations, Vérificateur d'organisations) :
{ "returnCode": "Success", "error": "", "result": { "payload": [ { "key": "oaccount~c44ffac4c46718e9744cb0aae2016d26a87a5bef5e2d1c0d1abc7d8782f0ba61", "role_name": null, "valueJson": { "account_id": "oaccount~c44ffac4c46718e9744cb0aae2016d26a87a5bef5e2d1c0d1abc7d8782f0ba61", "org_id": "CentralBank", "token_id": "USD", "application_groups": [ "SYSTEM_ADMINS" ], "max_daily_amount": "10000", "max_daily_transactions": "1000" }, "non_account_role_name": [ "token_admin" ] } ], "encode": "JSON" } }
- Exemple de valeur de retour (tous les autres utilisateurs) :
{ "returnCode": "Success", "error": "", "result": { "payload": [ { "key": "oaccount~c44ffac4c46718e9744cb0aae2016d26a87a5bef5e2d1c0d1abc7d8782f0ba61", "role_name": null, "valueJson": { "account_id": "oaccount~c44ffac4c46718e9744cb0aae2016d26a87a5bef5e2d1c0d1abc7d8782f0ba61", "org_id": "CentralBank", "token_id": "USD", "application_groups": [ "SYSTEM_ADMINS" ] } } ], "encode": "JSON" } }
-
getApproverActionHistory
- Nom de la méthode initiale :
getActionHistory
- Cette méthode GET extrait l'historique des approbations ou des rejets effectués par l'appelant pour les opérations de menthe, de brûlure et de transfert (émission), y compris les détails de l'organisation et les ID utilisateur des comptes concernés (expéditeur, destinataire et notaire). Cette méthode ne peut être appelée que par
Token Admin
,Token Auditor
,Org Admin
,Org Auditor
ou le notaire. - Interrogation :
getApproverActionHistory?tokenId={{bc-token-id}}&peer={{peer}}
- Paramètres :
tokenId: string
– ID du jeton.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": [ { "from_account_id": "oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98", "from_org_id": "CentralBank", "holding_id": "ohold~cbdc~USD~b770", "holding_status": "APPROVE_BURN", "last_updated_time": "2025-08-25T13:21:24.000Z", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": null, "timetoexpiration": null, "to_account_id": null, "to_org_id": null, "token_name": null, "quantity": 200 }, { "from_account_id": null, "from_org_id": null, "holding_id": "ohold~cbdc~USD~e7b6", "holding_status": "APPROVE_MINT", "last_updated_time": "2025-08-25T13:20:50.000Z", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": null, "timetoexpiration": null, "to_account_id": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "to_org_id": "CentralBank", "token_name": null, "quantity": 1000 }, { "from_account_id": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_org_id": "CentralBank", "holding_id": "ohold~cbdc~USD~81d7c4ac", "holding_status": "EXECUTEHOLD", "last_updated_time": "2025-08-25T13:16:55.000Z", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": null, "timetoexpiration": null, "to_account_id": "oaccount~76687c724ddbc2d6e6664d9618b2bf1c2a9fe10f84887462447e4caba6aaaff3", "to_org_id": "Org1", "token_name": null, "quantity": 200 }, { "from_account_id": null, "from_org_id": null, "holding_id": "ohold~cbdc~USD~1e19", "holding_status": "APPROVE_MINT", "last_updated_time": "2025-08-13T06:12:41.000Z", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": null, "timetoexpiration": null, "to_account_id": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "to_org_id": "CentralBank", "token_name": null, "quantity": 10000 }, { "from_account_id": "oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98", "from_org_id": "CentralBank", "holding_id": "ohold~cbdc~USD~1f74", "holding_status": "REJECT_BURN", "last_updated_time": "2025-08-12T21:09:53.000Z", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": null, "timetoexpiration": null, "to_account_id": "", "to_org_id": null, "token_name": null, "quantity": 1000 }, { "from_account_id": "oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98", "from_org_id": "CentralBank", "holding_id": "ohold~cbdc~USD~d67c", "holding_status": "REJECT_BURN", "last_updated_time": "2025-08-12T21:09:47.000Z", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": null, "timetoexpiration": null, "to_account_id": "", "to_org_id": null, "token_name": null, "quantity": 2000 }, { "from_account_id": "oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98", "from_org_id": "CentralBank", "holding_id": "ohold~cbdc~USD~911b", "holding_status": "APPROVE_BURN", "last_updated_time": "2025-08-12T21:09:40.000Z", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": null, "timetoexpiration": null, "to_account_id": null, "to_org_id": null, "token_name": null, "quantity": 1000 }, { "from_account_id": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_org_id": "CentralBank", "holding_id": "ohold~cbdc~USD~ed815e20", "holding_status": "EXECUTEHOLD", "last_updated_time": "2025-08-12T21:09:25.000Z", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": null, "timetoexpiration": null, "to_account_id": "oaccount~3954f54a8bc7acdd0c3d0960104240f60d56c26c8a179430267359cd80ce3709", "to_org_id": "org2", "token_name": null, "quantity": 10000 }, { "from_account_id": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_org_id": "CentralBank", "holding_id": "ohold~cbdc~USD~12d87129", "holding_status": "EXECUTEHOLD", "last_updated_time": "2025-08-12T21:09:17.000Z", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": null, "timetoexpiration": null, "to_account_id": "oaccount~76687c724ddbc2d6e6664d9618b2bf1c2a9fe10f84887462447e4caba6aaaff3", "to_org_id": "Org1", "token_name": null, "quantity": 10000 }, { "from_account_id": "", "from_org_id": null, "holding_id": "ohold~cbdc~USD~54a4", "holding_status": "REJECT_MINT", "last_updated_time": "2025-08-12T21:01:27.000Z", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": null, "timetoexpiration": null, "to_account_id": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "to_org_id": "CentralBank", "token_name": null, "quantity": 40000 }, { "from_account_id": null, "from_org_id": null, "holding_id": "ohold~cbdc~USD~9b27", "holding_status": "APPROVE_MINT", "last_updated_time": "2025-08-12T21:01:16.000Z", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": null, "timetoexpiration": null, "to_account_id": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "to_org_id": "CentralBank", "token_name": null, "quantity": 30000 }, { "from_account_id": null, "from_org_id": null, "holding_id": "ohold~cbdc~USD~eda0", "holding_status": "APPROVE_MINT", "last_updated_time": "2025-08-12T21:01:05.000Z", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": null, "timetoexpiration": null, "to_account_id": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "to_org_id": "CentralBank", "token_name": null, "quantity": 20000 }, { "from_account_id": null, "from_org_id": null, "holding_id": "ohold~cbdc~USD~1baa", "holding_status": "APPROVE_MINT", "last_updated_time": "2025-08-12T21:01:03.000Z", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": null, "timetoexpiration": null, "to_account_id": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "to_org_id": "CentralBank", "token_name": null, "quantity": 10000 } ], "encode": "JSON" } }
-
getCBDCAccount
- Nom de la méthode initiale :
getCBDCAccount
- Cette méthode GET retourne les détails du compte pour un utilisateur et un jeton spécifiés. Cette méthode ne peut être appelée que par
Token Admin
ouToken Auditor
du code de chaîne, unOrg Admin
ouOrg Auditor
de l'organisation spécifiée ou leAccountOwner
du compte. - Interrogation :
/getCBDCAccount?accountId=account_id value&peer={{peer}}
- Paramètres :
accountId: string
– ID du compte.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": { "bapAccountVersion": 0, "assetType": "oaccount", "user_id": "cb_manager_demo", "custom_account_id": "10105678007891", "status": "active", "account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "org_id": "CentralBank", "token_type": "fungible", "token_id": "USD", "token_name": "cbdc", "balance": "0", "onhold_balance": "0", "onhold_burn_balance": "0", "application_groups": [ "SYSTEM_MANAGERS" ] }, "encode": "JSON" } }
-
getCBDCAccountBalance
- Nom de la méthode initiale :
getAccountBalance
- Cette méthode GET retourne le solde courant pour un compte et un jeton spécifiés. Cette méthode ne peut être appelée que par
Token Admin
ouToken Auditor
du code de chaîne, unOrg Admin
ouOrg Auditor
de l'organisation spécifiée ou leAccountOwner
du compte. /getCBDCAccountBalance?accountId=account_id value&peer={{peer}}
- Paramètres :
accountId: string
– ID du compte.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": { "msg": "Current Balance is: 100", "user_balance": 100 }, "encode": "JSON" } }
-
getCBDCAccountsByUser
- Nom de la méthode initiale :
getAccountsByUser
- Cette méthode retourne une liste de tous les ID compte pour un ID organisation et un ID utilisateur spécifiés. Cette méthode ne peut être appelée que par
Token Admin
ouToken Auditor
du code de chaîne, unOrg Admin
ouOrg Auditor
de l'organisation spécifiée ou leAccountOwner
du compte. /getCBDCAccountsByUser?orgId={{bc-org-id}}&userId={{bc-user-id}}&peer={{peer}}
- Paramètres :
orgId string
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation courante.userId string
– Nom d'utilisateur ou ID courriel de l'utilisateur.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": [ { "bapAccountVersion": 15, "assetType": "oaccount", "user_id": "cb__creator_demo", "custom_account_id": "10105678004567", "account_id": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "org_id": "CentralBank", "token_type": "fungible", "token_id": "USD", "token_name": "cbdc", "balance": "21000", "onhold_balance": "0", "onhold_burn_balance": "0", "application_groups": [ "SYSTEM_CREATORS" ] }, { "bapAccountVersion": 0, "assetType": "oaccount", "user_id": "cb__creator_demo", "custom_account_id": "Not Available", "account_id": "oaccount~388fb87df59c6a4fbf0400c58b61aa85f975a8c4209942006b0c0d6334fcf887", "org_id": "CentralBank", "token_type": "fungible", "token_id": "", "token_name": "", "balance": "0", "onhold_balance": "0", "onhold_burn_balance": "0", "application_groups": [ "application_groups value" ] } ], "encode": "JSON" } }
-
getCBDCAccountTransactionHistory
- Nom de la méthode initiale :
getAccountTransactionHistory
- Cette méthode retourne un tableau des détails de l'historique des transactions de compte pour un utilisateur et un jeton spécifiés. Cette méthode ne peut être appelée que par
Token Admin
ouToken Auditor
du code de chaîne, unOrg Admin
ouOrg Auditor
de l'organisation spécifiée ou leAccountOwner
du compte. /getCBDCAccountTransactionHistory?accountId=account_id value&peer={{peer}}
- Paramètres :
accountId: string
– ID du compte.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": [ { "transaction_id": "otransaction~4514aa229ebcc4d2fedcaa47c4301615e30c4a9bae45cf0256a5b80d75b3697a", "transacted_amount": 1000, "timestamp": "2025-08-25T13:20:50.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "APPROVE_MINT", "balance": 21000, "onhold_balance": 0 }, { "transaction_id": "otransaction~1982f73495060e0eef4d78282a91c41e27e8c95572739b0677a1e404a0d20aa9", "transacted_amount": 200, "timestamp": "2025-08-25T13:12:43.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "REQUEST_MINT", "balance": 20000, "onhold_balance": 0 }, { "transaction_id": "otransaction~fedd714cf1509f7517819d7cd4c0921d0b2f5d1ff6a25dcb08ab411defd6b5f3", "transacted_amount": 2000, "timestamp": "2025-08-21T05:23:25.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "REQUEST_MINT", "balance": 20000, "onhold_balance": 0 }, { "transaction_id": "otransaction~f33b47234f3ee0b636962c8c31c01d06523b789ca16b3b342d5080b71268bcc3", "transacted_amount": 1000, "timestamp": "2025-08-21T05:23:07.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "REQUEST_MINT", "balance": 20000, "onhold_balance": 0 }, { "transaction_id": "otransaction~cf934527149bc24f62a8ddeeea7f74a19a0f84d8f161535a771be49d2520d5b3", "transacted_amount": 10000, "timestamp": "2025-08-13T06:12:41.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "APPROVE_MINT", "balance": 20000, "onhold_balance": 0 }, { "transaction_id": "otransaction~f5c0e11ca61d9adc843658929e6de2a738ad586304f9e020f75bf4aac5e42a2c", "transacted_amount": 10000, "timestamp": "2025-08-13T06:12:04.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "REQUEST_MINT", "balance": 10000, "onhold_balance": 0 }, { "transaction_id": "otransaction~862aa9d9e877d3ea209b87299ab5b12c13ed5ce43d1cf1b934043c1dd02f58f6", "transacted_amount": 50000, "timestamp": "2025-08-12T21:04:22.000Z", "token_id": "USD", "category": "transfer", "transacted_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "transaction_type": "DEBIT", "balance": 10000, "onhold_balance": 0 }, { "transaction_id": "otransaction~8a74c6d87ca74a613aab9db5d40386f8d5b534f9800503af8ca27e8946d7616d", "transacted_amount": 40000, "timestamp": "2025-08-12T21:01:27.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "REJECT_MINT", "balance": 60000, "onhold_balance": 0 }, { "transaction_id": "otransaction~28ac66ba33f7ad0648448964b2b74525c9e3f0c9908c7a0484690b9baa56c2db", "transacted_amount": 30000, "timestamp": "2025-08-12T21:01:16.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "APPROVE_MINT", "balance": 60000, "onhold_balance": 0 }, { "transaction_id": "otransaction~7e32ad8f365ff59814e112f27602f30ab599fb9c1638784496c66a61a6277c22", "transacted_amount": 20000, "timestamp": "2025-08-12T21:01:05.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "APPROVE_MINT", "balance": 30000, "onhold_balance": 0 }, { "transaction_id": "otransaction~1477050bb9e55f4f471872b31fce0d2097f5d5e57d89a842070df5e36d7ab0da", "transacted_amount": 10000, "timestamp": "2025-08-12T21:01:03.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "APPROVE_MINT", "balance": 10000, "onhold_balance": 0 }, { "transaction_id": "otransaction~0e76c6931b7ee134e967e847d9730b867a0fd191d39697d83d36dd15745c02e3", "transacted_amount": 40000, "timestamp": "2025-08-12T21:00:20.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "REQUEST_MINT", "balance": 0, "onhold_balance": 0 }, { "transaction_id": "otransaction~07bbf9c190694371626da59ded5d87434d26f612891e13bb15bdd28f6086e760", "transacted_amount": 30000, "timestamp": "2025-08-12T21:00:01.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "REQUEST_MINT", "balance": 0, "onhold_balance": 0 }, { "transaction_id": "otransaction~8721175c6cbbce17b6c4bb6a444e475d07f52352dfd0d990679f342215153513", "transacted_amount": 20000, "timestamp": "2025-08-12T20:59:41.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "REQUEST_MINT", "balance": 0, "onhold_balance": 0 }, { "transaction_id": "otransaction~dc24c24d43a6525e807a39edcf8c6a2b6ccb81f0d755958f509509687eacee84", "transacted_amount": 10000, "timestamp": "2025-08-12T20:59:13.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "REQUEST_MINT", "balance": 0, "onhold_balance": 0 }, { "transaction_id": "otransaction~396e6ca5a11a9609632d0864026409d46a708fb95e3e21b39fa5f3fb78f90872", "transacted_amount": 0, "timestamp": "2025-08-12T20:43:20.000Z", "token_id": "", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transaction_type": "CREATE_ACCOUNT", "balance": 0, "onhold_balance": 0 } ], "encode": "JSON" } }
-
getCBDCAccountTransactionHistoryWithFilters
- Nom de la méthode initiale :
getAccountTransactionHistoryWithFiltersFromRichHistDB
- Cette méthode retourne les détails de l'historique des transactions de compte à partir de la base de données de l'historique complet. Cette méthode ne peut être appelée que par
Token Admin
ouToken Auditor
du code de chaîne, unOrg Admin
ouOrg Auditor
de l'organisation spécifiée ou leAccountOwner
du compte. /getCBDCAccountTransactionHistoryWithFilters?accountId=account_id value&customEndpoint=custom_endpoint value&bearerToken=bearer_token value&filters={"pageSize":20,"bookmark":"","startTime":"1900-01-01T00:00:00+00:00","endTime":"2100-01-01T00:00:00+00:00"}&peer={{peer}}
- Paramètres :
accountId: string
– ID du compte.customEndpoint
– Point d'extrémité du service RESTful de la base de données d'historique enrichi à partir duquel extraire l'historique des transactions.bearerToken
– Jeton à utiliser pour appeler le point d'extrémité RESTful afin de s'assurer que la demande est autorisée.filters: JSON object
– Paramètre facultatif. Si vide, tous les enregistrements sont retournés. La propriétépageSize
détermine le nombre d'enregistrements à retourner. SipageSize
a la valeur 0, la taille de page par défaut est 20. La propriétébookmark
détermine l'index de début des enregistrements à retourner. Les propriétésstartTime
etendTime
doivent être spécifiées au format RFC-3339.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": [ { "transaction_id": "otransaction~3140569a4ecb3c3f141cc2468fe21276640b7fd79013d951d9104b79072d8f9c", "transacted_amount": 200, "timestamp": "2025-08-25T13:16:55.000Z", "token_id": "USD", "transacted_account": "oaccount~76687c724ddbc2d6e6664d9618b2bf1c2a9fe10f84887462447e4caba6aaaff3", "transacted_org_id": "Org1", "transacted_user_id": "fi1_org_officer_demo", "transacted_custom_account_id": "20200222221111", "to_account": "oaccount~76687c724ddbc2d6e6664d9618b2bf1c2a9fe10f84887462447e4caba6aaaff3", "to_org_id": "Org1", "to_user_id": "fi1_org_officer_demo", "to_custom_account_id": "20200222221111", "from_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_org_id": "CentralBank", "from_user_id": "cb_issuer_demo", "from_custom_account_id": "10109999001234", "transaction_type": "EXECUTEHOLD", "category": "transfer", "balance": 26800, "onhold_balance": 300 }, { "transaction_id": "otransaction~2b75b3e8531a651f07c2d048d8546ad70ac49c66f0b82ed7626c1739090842ce", "transacted_amount": 100, "timestamp": "2025-08-25T13:16:06.000Z", "token_id": "USD", "transacted_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "transacted_org_id": "CentralBank", "transacted_user_id": "cb_issuer_demo", "transacted_custom_account_id": "10109999001234", "to_account": "oaccount~76687c724ddbc2d6e6664d9618b2bf1c2a9fe10f84887462447e4caba6aaaff3", "to_org_id": "Org1", "to_user_id": "fi1_org_officer_demo", "to_custom_account_id": "20200222221111", "from_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_org_id": "CentralBank", "from_user_id": "cb_issuer_demo", "from_custom_account_id": "10109999001234", "transaction_type": "ONHOLD", "holding_id": "ohold~cbdc~USD~e26f11da", "category": "transfer", "balance": 26800, "onhold_balance": 500 }, { "transaction_id": "otransaction~9e7bf14cf96c5f90170da9455b1318687785e936192f60b7cbeb1c8bfabc41d2", "transacted_amount": 100, "timestamp": "2025-08-21T06:57:19.000Z", "token_id": "USD", "transacted_account": "oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98", "transacted_org_id": "CentralBank", "transacted_user_id": "cb_retirer_demo", "transacted_custom_account_id": "10109999006543", "to_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "to_org_id": "CentralBank", "to_user_id": "cb_issuer_demo", "to_custom_account_id": "10109999001234", "from_account": "oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98", "from_org_id": "CentralBank", "from_user_id": "cb_retirer_demo", "from_custom_account_id": "10109999006543", "transaction_type": "CREDIT", "category": "transfer", "balance": 26900, "onhold_balance": 400 }, { "transaction_id": "otransaction~b3901b4754920a9c75e36069dc55024ad505e4c127f334eedf65ef6703dc6b86", "transacted_amount": 200, "timestamp": "2025-08-21T05:39:25.000Z", "token_id": "USD", "transacted_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "transacted_org_id": "CentralBank", "transacted_user_id": "cb_issuer_demo", "transacted_custom_account_id": "10109999001234", "to_account": "oaccount~3954f54a8bc7acdd0c3d0960104240f60d56c26c8a179430267359cd80ce3709", "to_org_id": "org2", "to_user_id": "fi2_org_officer_demo", "to_custom_account_id": "30300617202404", "from_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_org_id": "CentralBank", "from_user_id": "cb_issuer_demo", "from_custom_account_id": "10109999001234", "transaction_type": "ONHOLD", "holding_id": "ohold~cbdc~USD~77b75873", "category": "issuance", "balance": 26800, "onhold_balance": 400 }, { "transaction_id": "otransaction~d55c9dfc9feacb353544b5d8b2ae694162ade3890bcaaf715503fd1d6a73cd1a", "transacted_amount": 200, "timestamp": "2025-08-21T05:39:01.000Z", "token_id": "USD", "transacted_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "transacted_org_id": "CentralBank", "transacted_user_id": "cb_issuer_demo", "transacted_custom_account_id": "10109999001234", "to_account": "oaccount~76687c724ddbc2d6e6664d9618b2bf1c2a9fe10f84887462447e4caba6aaaff3", "to_org_id": "Org1", "to_user_id": "fi1_org_officer_demo", "to_custom_account_id": "20200222221111", "from_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_org_id": "CentralBank", "from_user_id": "cb_issuer_demo", "from_custom_account_id": "10109999001234", "transaction_type": "ONHOLD", "holding_id": "ohold~cbdc~USD~81d7c4ac", "category": "transfer", "balance": 27000, "onhold_balance": 200 }, { "transaction_id": "otransaction~751eaedbe4311edd5d17cae53d283caf397d0cb09f18d57a5e3fe61266875ff9", "transacted_amount": 200, "timestamp": "2025-08-13T09:59:22.000Z", "token_id": "USD", "transacted_account": "oaccount~3954f54a8bc7acdd0c3d0960104240f60d56c26c8a179430267359cd80ce3709", "transacted_org_id": "org2", "transacted_user_id": "fi2_org_officer_demo", "transacted_custom_account_id": "30300617202404", "to_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "to_org_id": "CentralBank", "to_user_id": "cb_issuer_demo", "to_custom_account_id": "10109999001234", "from_account": "oaccount~3954f54a8bc7acdd0c3d0960104240f60d56c26c8a179430267359cd80ce3709", "from_org_id": "org2", "from_user_id": "fi2_org_officer_demo", "from_custom_account_id": "30300617202404", "transaction_type": "CREDIT", "category": "transfer", "balance": 27200, "onhold_balance": 0 }, { "transaction_id": "otransaction~70155a8f4e388cc9395dbd03bedaf5a878705f5ad02302c8e9163218a5c3875a", "transacted_amount": 1000, "timestamp": "2025-08-13T06:22:56.000Z", "token_id": "USD", "transacted_account": "oaccount~76687c724ddbc2d6e6664d9618b2bf1c2a9fe10f84887462447e4caba6aaaff3", "transacted_org_id": "Org1", "transacted_user_id": "fi1_org_officer_demo", "transacted_custom_account_id": "20200222221111", "to_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "to_org_id": "CentralBank", "to_user_id": "cb_issuer_demo", "to_custom_account_id": "10109999001234", "from_account": "oaccount~76687c724ddbc2d6e6664d9618b2bf1c2a9fe10f84887462447e4caba6aaaff3", "from_org_id": "Org1", "from_user_id": "fi1_org_officer_demo", "from_custom_account_id": "20200222221111", "transaction_type": "CREDIT", "category": "transfer", "balance": 27000, "onhold_balance": 0 }, { "transaction_id": "otransaction~e595f3f0cc03fa5f58a546b8abbfaf155592e492f850581db2b8fed9a529c9e2", "transacted_amount": 10000, "timestamp": "2025-08-12T21:09:25.000Z", "token_id": "USD", "transacted_account": "oaccount~3954f54a8bc7acdd0c3d0960104240f60d56c26c8a179430267359cd80ce3709", "transacted_org_id": "org2", "transacted_user_id": "fi2_org_officer_demo", "transacted_custom_account_id": "30300617202404", "to_account": "oaccount~3954f54a8bc7acdd0c3d0960104240f60d56c26c8a179430267359cd80ce3709", "to_org_id": "org2", "to_user_id": "fi2_org_officer_demo", "to_custom_account_id": "30300617202404", "from_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_org_id": "CentralBank", "from_user_id": "cb_issuer_demo", "from_custom_account_id": "10109999001234", "transaction_type": "EXECUTEHOLD", "category": "issuance", "balance": 26000, "onhold_balance": 0 }, { "transaction_id": "otransaction~da92402859d87ae3069722d8e39cb0da448e9a5f67468233ee9b1fe7a4ebeef8", "transacted_amount": 10000, "timestamp": "2025-08-12T21:09:17.000Z", "token_id": "USD", "transacted_account": "oaccount~76687c724ddbc2d6e6664d9618b2bf1c2a9fe10f84887462447e4caba6aaaff3", "transacted_org_id": "Org1", "transacted_user_id": "fi1_org_officer_demo", "transacted_custom_account_id": "20200222221111", "to_account": "oaccount~76687c724ddbc2d6e6664d9618b2bf1c2a9fe10f84887462447e4caba6aaaff3", "to_org_id": "Org1", "to_user_id": "fi1_org_officer_demo", "to_custom_account_id": "20200222221111", "from_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_org_id": "CentralBank", "from_user_id": "cb_issuer_demo", "from_custom_account_id": "10109999001234", "transaction_type": "EXECUTEHOLD", "category": "issuance", "balance": 26000, "onhold_balance": 10000 }, { "transaction_id": "otransaction~6915145aaf09fbf4d96456febddc2aa87b48c08ddd8ff17a6bab5d310f67bb36", "transacted_amount": 1000, "timestamp": "2025-08-12T21:07:11.000Z", "token_id": "USD", "transacted_account": "oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98", "transacted_org_id": "CentralBank", "transacted_user_id": "cb_retirer_demo", "transacted_custom_account_id": "10109999006543", "to_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "to_org_id": "CentralBank", "to_user_id": "cb_issuer_demo", "to_custom_account_id": "10109999001234", "from_account": "oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98", "from_org_id": "CentralBank", "from_user_id": "cb_retirer_demo", "from_custom_account_id": "10109999006543", "transaction_type": "CREDIT", "category": "transfer", "balance": 26000, "onhold_balance": 20000 }, { "transaction_id": "otransaction~244d7172d1dc90a142e1f22204c76614c7eea814b3d61f33016b786f1b347784", "transacted_amount": 10000, "timestamp": "2025-08-12T21:05:39.000Z", "token_id": "USD", "transacted_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "transacted_org_id": "CentralBank", "transacted_user_id": "cb_issuer_demo", "transacted_custom_account_id": "10109999001234", "to_account": "oaccount~3954f54a8bc7acdd0c3d0960104240f60d56c26c8a179430267359cd80ce3709", "to_org_id": "org2", "to_user_id": "fi2_org_officer_demo", "to_custom_account_id": "30300617202404", "from_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_org_id": "CentralBank", "from_user_id": "cb_issuer_demo", "from_custom_account_id": "10109999001234", "transaction_type": "ONHOLD", "holding_id": "ohold~cbdc~USD~ed815e20", "category": "issuance", "balance": 25000, "onhold_balance": 20000 }, { "transaction_id": "otransaction~c63ec37966264493bde6fa666527b9cca11695c15611c32e89af49a2246f13f6", "transacted_amount": 10000, "timestamp": "2025-08-12T21:05:20.000Z", "token_id": "USD", "transacted_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "transacted_org_id": "CentralBank", "transacted_user_id": "cb_issuer_demo", "transacted_custom_account_id": "10109999001234", "to_account": "oaccount~76687c724ddbc2d6e6664d9618b2bf1c2a9fe10f84887462447e4caba6aaaff3", "to_org_id": "Org1", "to_user_id": "fi1_org_officer_demo", "to_custom_account_id": "20200222221111", "from_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_org_id": "CentralBank", "from_user_id": "cb_issuer_demo", "from_custom_account_id": "10109999001234", "transaction_type": "ONHOLD", "holding_id": "ohold~cbdc~USD~12d87129", "category": "issuance", "balance": 35000, "onhold_balance": 10000 }, { "transaction_id": "otransaction~5112f576c94c2d23c342479bfa37e34612414b3258a64b43cf51b920f4ff5868", "transacted_amount": 5000, "timestamp": "2025-08-12T21:05:02.000Z", "token_id": "USD", "transacted_account": "oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98", "transacted_org_id": "CentralBank", "transacted_user_id": "cb_retirer_demo", "transacted_custom_account_id": "10109999006543", "to_account": "oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98", "to_org_id": "CentralBank", "to_user_id": "cb_retirer_demo", "to_custom_account_id": "10109999006543", "from_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_org_id": "CentralBank", "from_user_id": "cb_issuer_demo", "from_custom_account_id": "10109999001234", "transaction_type": "DEBIT", "category": "burn", "balance": 45000, "onhold_balance": 0 }, { "transaction_id": "otransaction~862aa9d9e877d3ea209b87299ab5b12c13ed5ce43d1cf1b934043c1dd02f58f6", "transacted_amount": 50000, "timestamp": "2025-08-12T21:04:22.000Z", "token_id": "USD", "transacted_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "transacted_org_id": "CentralBank", "transacted_user_id": "cb__creator_demo", "transacted_custom_account_id": "10105678004567", "to_account": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "to_org_id": "CentralBank", "to_user_id": "cb_issuer_demo", "to_custom_account_id": "10109999001234", "from_account": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "from_org_id": "CentralBank", "from_user_id": "cb__creator_demo", "from_custom_account_id": "10105678004567", "transaction_type": "CREDIT", "category": "transfer", "balance": 50000, "onhold_balance": 0 } ], "encode": "JSON" } }
-
getCBDCRetiredQuantity
- Nom de la méthode initiale :
getBurnQuantity
- Cette méthode GET retourne la quantité totale de jetons brûlés pour une organisation spécifiée. Cette méthode ne peut être appelée que par
Token Admin
,Token Auditor
ou un utilisateur doté du rôle de brûleur. /getCBDCRetiredQuantity?tokenId={{bc-token-id}}&peer={{peer}}
- Paramètres :
tokenId: string
– ID du jeton.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": { "burnt_quantity": 1200 }, "encode": "JSON" } }
-
getOnHoldIds
- Nom de la méthode initiale :
getOnHoldIds
- Cette méthode GET retourne une liste de tous les ID portefeuille pour un compte spécifié. Cette méthode ne peut être appelée que par
Token Admin
ouToken Auditor
du code de chaîne, unOrg Admin
ouOrg Auditor
de l'organisation spécifiée ou leAccountOwner
du compte. /getOnHoldIds?accountId=account_id value&peer={{peer}}
- Paramètres :
accountId: string
– ID du compte.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": { "msg": "Holding Ids are: ohold~cbdc~USD~8e3147,ohold~cbdc~USD~8e315", "holding_ids": [ "ohold~cbdc~USD~8e3147", "ohold~cbdc~USD~8e315" ] }, "encode": "JSON" } }
-
getPendingCBDCIssuance
- Nom de la méthode initiale :
getPendingIssuance
- Cette méthode extrait toutes les transactions de sortie en attente (transfert) auxquelles l'appelant est affecté en tant qu'approbateur, y compris les détails de l'organisation et les codes d'utilisateur des comptes concernés (expéditeur, destinataire et notaire). Cette méthode ne peut être appelée que par
Token Admin
ouToken Auditor
du code de chaîne,Org Admin
ouOrg Auditor
ouNotary
. /getPendingCBDCIssuance?tokenId={{bc-token-id}}&orgId={{bc-org-id}}&peer={{peer}}
- Paramètres :
tokenId: string
– ID du jeton.orgId: string
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation courante.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": [ { "asset_type": "ONHOLD", "category": "issuance", "from_account_id": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_org_id": "CentralBank", "holding_id": "ohold~cbdc~USD~77b75873", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": "77b75873", "timetoexpiration": "0", "to_account_id": "oaccount~3954f54a8bc7acdd0c3d0960104240f60d56c26c8a179430267359cd80ce3709", "to_org_id": "org2", "token_id": "USD", "token_name": "cbdc", "quantity": 200 }, { "asset_type": "ONHOLD", "category": "transfer", "from_account_id": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_org_id": "CentralBank", "holding_id": "ohold~cbdc~USD~e26f11da", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "notary_org_id": "CentralBank", "operation_id": "e26f11da", "timetoexpiration": "0", "to_account_id": "oaccount~76687c724ddbc2d6e6664d9618b2bf1c2a9fe10f84887462447e4caba6aaaff3", "to_org_id": "Org1", "token_id": "USD", "token_name": "cbdc", "quantity": 100 } ], "encode": "JSON" } }
-
getPendingCBDCRequest
- Nom de la méthode initiale :
getPendingRequest
- Cette méthode extrait toutes les demandes en attente d'un type spécifié où l'appelant est affecté en tant qu'approbateur. Cette méthode ne peut être appelée que par
Token Admin
ouToken Auditor
du code de chaîne ou parNotary
. /getPendingCBDCRequest?tokenId={{bc-token-id}}&requestType=request_type value&orgId={{bc-org-id}}&peer={{peer}}
- Paramètres :
tokenId: string
– ID du jeton.requestType: string
– Type de transaction. Par exemple,mint
ouburn
.orgId: string
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation courante.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": [ { "valueJson": { "assetType": "ohold", "holding_id": "ohold~cbdc~USD~89ce", "operation_id": "89ce", "token_name": "cbdc", "from_org_id": "CentralBank", "operation_type": "mint", "status": "pending", "from_account_id": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "to_account_id": "", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "token_id": "USD", "quantity": 2000, "time_to_expiration": "0", "description": "Minting 2000 tokens" } }, { "valueJson": { "assetType": "ohold", "holding_id": "ohold~cbdc~USD~cf73", "operation_id": "cf73", "token_name": "cbdc", "from_org_id": "CentralBank", "operation_type": "mint", "status": "pending", "from_account_id": "oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41", "to_account_id": "", "notary_account_id": "oaccount~9b136ef4a60230846a8c14761683851a386d306b79493bc4d00433020c96cfa7", "token_id": "USD", "quantity": 200, "time_to_expiration": "0", "description": "Minting 200" } } ], "encode": "JSON" } }
-
getTotalCBDCBalanceByCallerOrgId
- Nom de la méthode initiale :
getTotalBalanceByCallerOrgId
- Cette méthode extrait le solde total de l'organisation de l'appelant. Cette méthode ne peut être appelée que par
Token Admin
,Token Auditor
,Org Admin
,Org Auditor
ou tout responsable de compte. /getTotalCBDCBalanceByCallerOrgId?peer={{peer}}
- Paramètres :
peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": { "totalBalance": 50500 }, "encode": "JSON" } }
-
getTotalCreatedCBDCTokens
- Nom de la méthode initiale :
getTotalMintedTokens
- Cette méthode retourne le nombre total de jetons frappés pour un jeton spécifié. Cette méthode ne peut être appelée que par
Token Admin
,Token Auditor
,Org Admin
ouOrg Auditor
. - Interrogation :
/getTotalCreatedCBDCTokens?tokenId={{bc-token-id}}&peer={{peer}}
- Paramètres :
tokenId: string
– ID du jeton.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": { "msg": "Total minted token for Token Id: USD is 71000 tokens.", "quantity": 71000 }, "encode": "JSON" } }
-
getTransactionWithBlockNumber
- Nom de la méthode initiale :
getTransactionWithBlockNumber
- Cette méthode GET retourne les détails de la transaction pour l'ID transaction spécifié.
- Interrogation :
/getTransactionWithBlockNumber?tokenId={{bc-token-id}}&transactionId=transaction_id value&peer={{peer}}
- Paramètres :
tokenId: string
– ID du jeton.transactionId: string
– ID de la transaction.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": [ { "blockNo": 340, "key": "otransaction~3140569a4ecb3c3f141cc2468fe21276640b7fd79013d951d9104b79072d8f9c", "metadata": null, "txnNo": 0, "value": null, "valueJson": { "assetType": "otransaction", "blockNo": 336, "txnNo": 1, "transaction_id": "otransaction~3140569a4ecb3c3f141cc2468fe21276640b7fd79013d951d9104b79072d8f9c", "token_id": "USD", "from_account_id": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "from_account_balance": 26800, "from_account_onhold_balance": 300, "to_account_id": "oaccount~76687c724ddbc2d6e6664d9618b2bf1c2a9fe10f84887462447e4caba6aaaff3", "transaction_type": "EXECUTE_HOLD_SENDER", "amount": 200, "timestamp": "2025-08-25T13:16:55.000Z", "number_of_sub_transactions": 0, "holding_id": "ohold~cbdc~USD~81d7c4ac", "sub_transaction": "false", "category": "transfer", "global_transaction_id": "b54d4333-f4bb-4ca4-a7b7-cc75b659d912" } } ], "encode": "JSON" } }
-
getUserByCBDCAccountId
- Nom de la méthode initiale :
getUserByAccountId
- Cette méthode retourne les détails de l'utilisateur (
orgId
,userId
ettokenId
) pour un compte spécifié. Cette méthode ne peut être appelée que parToken Admin
ouToken Auditor
du code de chaîne, ou parOrg Admin
ouOrg Auditor
de l'organisation spécifiée. - Interrogation :
/getUserByCBDCAccountId?accountId=account_id value&peer={{peer}}
- Paramètres :
accountId: string
– ID du compte.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": { "token_id": "USD", "org_id": "CentralBank", "user_id": "cb_admin_demo", "custom_account_id": "10101234000123" }, "encode": "JSON" } }
-
getUsersByRole
- Nom de la méthode initiale :
getUsersByRole
- Cette méthode GET retourne une liste de tous les utilisateurs pour un rôle et un jeton spécifiés. Cette méthode ne peut être appelée que par
Token Admin
ouToken Auditor
du code de chaîne. - Interrogation :
/getUsersByRole?tokenId={{bc-token-id}}&role=role value (for example minter / burner / notary)&peer={{peer}}
- Paramètres :
tokenId: string
– ID du jeton.role: string
– Nom du rôle à rechercher.peer: string
– Nom du noeud pair sur lequel exécuter l'interrogation.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "payload": { "users": [ { "token_id": "USD", "org_id": "CentralBank" } ] }, "encode": "JSON" } }
-
holdCBDCTokens
- Nom de la méthode initiale :
holdTokens
- Cette méthode crée un blocage au nom du responsable des jetons avec le compte
to_account_id
. Un compte de notaire est spécifié, qui est responsable de terminer ou de débloquer le blocage. Lorsque le blocage est créé, le solde de jeton spécifié par le payeur est bloqué. Un solde bloqué ne peut pas être transféré tant que le blocage n'est pas terminé ou annulé. Un compte doit déjà être créé pour l'appelant de cette méthode. - Données utiles :
{ "operationId": "operation_id value", "toAccountId": "to_account_id value", "notaryAccountId": "notary_account_id value", "quantity": 1, "timeToExpiration": "time_to_expiration value", "infoDetails": "{\"category\":\"category value\",\"description\":\"description value\"}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
operationId: string
– ID unique permettant d'identifier l'opération de blocage. En général, cet ID est transmis par l'application client.toAccountId: string
– ID compte du destinataire.notaryAccountId: string
– ID compte du notaire.quantity: number
– Nombre de jetons à mettre en attente.timeToExpiration
– Heure à laquelle le blocage expire. Spécifiez 0 pour un blocage permanent. Sinon, utilisez le format RFC-3339. Par exemple, 2021-06-02T12 :46 :06Z.infoDetails: JSON
– Description et catégorie telles qu'illustrées dans l'exemple suivant.{ "category" : "category input", "description" : "description input" }
endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "4793f3907eefce2f9fca7ef107405b0f116efb3afbf83fa0e61fe763690c8235", "payload": { "msg": "AccountId oaccount~76687c724ddbc2d6e6664d9618b2bf1c2a9fe10f84887462447e4caba6aaaff3 is successfully holding 100 tokens" }, "encode": "JSON", "sourceURL": "org1-oabcs1-nrt.blockchain.ocp.example.com:20012", "blockNumber": 343 } }
-
init
- Nom de la méthode initiale :
init
- Cette méthode est appelée lorsque le code de chaîne est déployé. Les informations de l'utilisateur sont enregistrées en tant que
Token Admin
du code de chaîne. - Données utiles :
{ "adminList": "[{\"org_id\":\"{{bc-org-id}}\",\"user_id\":\"{{bc-admin-user}}\"}]", "transientMapArgsFlag": true }
- Paramètres :
adminList array
– Tableau d'informations{user_id, org_id}
qui spécifie la liste des administrateurs de jetons. Le tableauadminList
est un paramètre obligatoire.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "fdb7dc89832c8045a333823b77fa24ae628178148dc93b3550040e070d7cd807", "payload": "", "encode": "UTF-8", "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20009", "blockNumber": 263 } }
-
initializeCBDCToken
- Nom de la méthode initiale :
initializeCBDCToken
- Cette méthode crée un jeton et initialise les propriétés du jeton. La ressource et ses propriétés sont enregistrées dans la base de données d'état. Cette méthode ne peut être appelée que par un
Token Admin
du code de chaîne. - Données utiles :
{ "tokenAsset": "{\"token_id\":\"{{bc-token-id}}\",\"token_desc\":\"USD dollar\",\"Currency_Name\":\"US currency\"}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
tokenAsset: <Token Class>
– La ressource de jeton est transmise en tant que paramètre à cette méthode. Les propriétés de la ressource de jeton sont décrites dans le fichier de modèle.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Retourne :
- En cas de succès, une représentation JSON de la ressource de jeton créée.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "524be506f53ddf27c42db2be2d7d7ed7f8746880c3bf7990605a4b50fe62a616", "payload": { "assetType": "otoken", "events": true, "token_id": "PHP", "token_name": "cbdc", "token_desc": "token_desc value", "token_standard": "ttf+", "token_type": "fungible", "token_unit": "fractional", "behaviors": [ "divisible", "mintable", "transferable", "burnable", "holdable", "roles" ], "roles": { "minter_role_name": "minter", "burner_role_name": "burner", "notary_role_name": "notary", "mint_approver_role_name": "notary", "burn_approver_role_name": "notary" }, "mintable": { "max_mint_quantity": 0, "mint_approval_required": true }, "burnable": { "burn_approval_required": true }, "divisible": { "decimal": 2 }, "Currency_Name": "Currency_Name value" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20011", "blockNumber": 344 } }
-
rejectCBDCCreation
- Nom de la méthode initiale :
rejectMint
- Cette méthode peut être appelée par un notaire pour rejeter une demande de frappe.
- Données utiles :
{ "tokenId": "{{bc-token-id}}", "operationId": "operation_id value", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
tokenId: string
- ID du jeton pour le rejet de la frappe.operationId: string
– ID opération unique qui représente la demande de menthe.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "182b99bb2ed753994a8c638ab9b08c3a4e73ac8159a3173a2a1f56b651d2eeac", "payload": { "msg": "Successfully rejected mint request with Operation Id '89ce' to mint 2000 tokens of token id USD" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20011", "blockNumber": 345 } }
-
rejectCBDCRetirement
- Nom de la méthode initiale :
rejectBurn
- Cette méthode peut être appelée par un notaire pour rejeter une demande de gravure.
- Données utiles :
{ "tokenId": "{{bc-token-id}}", "operationId": "operation_id value", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
tokenId: string
- ID du jeton à rejeter pour gravure.operationId: string
– ID opération unique qui représente la demande de gravure.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "af2cc8e43ecb4c5520d90a8d7955b5a47623a29b13eef47e31c16eb48cc0adec", "payload": { "msg": "Successfully rejected burn request with Operation Id '8d34' to burn 100 tokens of token id USD" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20011", "blockNumber": 346 } }
-
rejectHoldCBDCTokens
- Nom de la méthode initiale :
releaseHoldTokens
- Cette méthode POST libère un blocage sur les jetons. Le transfert n'est pas terminé et tous les jetons détenus sont à nouveau disponibles pour le propriétaire initial. Cette méthode peut être appelée par l'ID
AccountOwner
avec le rôlenotary
dans la limite de temps spécifiée ou par le payeur, le bénéficiaire ou le notaire après la limite de temps spécifiée. - Données utiles :
{ "tokenId": "{{bc-token-id}}", "operationId": "operation_id value", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
tokenId: string
– ID du jeton.operationId: string
– ID unique permettant d'identifier l'opération de blocage. En général, cet ID est transmis par l'application client.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "c628fb7738222ed969295ccc8d21b4be95d96e3aada4f14570f7820a7051b5f7", "payload": { "msg": "Successfully released '200' tokens from Operation Id '77b75873' to Account Id: oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a (Org-Id: CentralBank, User-Id: cb_issuer_demo)." }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20009", "blockNumber": 347 } }
-
removeCBAdmin
- Nom de la méthode initiale :
removeTokenAdmin
- Cette méthode POST supprime un utilisateur en tant que
Token Admin
du code de chaîne. Cette méthode ne peut être appelée que par unToken Admin
du code de chaîne. Un administrateur ne peut pas se supprimer lui-même. - Données utiles :
{ "orgId": "{{bc-org-id}}", "userId": "{{bc-user-id}}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
orgId: string
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation courante.userId: string
– Nom d'utilisateur ou ID courriel de l'utilisateur.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "6a3b9b568d04b5beb29830f91efe4e8c6310b6cf36940cecfb4ab690fbfde739", "payload": { "msg": "Successfully removed Token Admin (Org_Id: CB, User_Id: cb)" }, "encode": "JSON", "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010", "blockNumber": 218 } }
-
removeCBAuditor
- Nom de la méthode initiale :
removeTokenAuditor
- Cette méthode POST supprime un utilisateur en tant que
Token Auditor
du code de chaîne. Cette méthode ne peut être appelée que par unToken Admin
du code de chaîne. - Données utiles :
{ "orgId": "{{bc-org-id}}", "userId": "{{bc-user-id}}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
orgId: string
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation courante.userId: string
– Nom d'utilisateur ou ID courriel de l'utilisateur.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "a886a6040fbc76374a3c78c89ab0ffc9f7b8391cc5239b169bf3b878cf40c67b", "payload": { "msg": "Successfully removed Token Auditor (Org_Id: CB, User_Id: cb)" }, "encode": "JSON", "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010", "blockNumber": 219 } }
-
removeFIAdmin
- Nom de la méthode initiale :
removeOrgAdmin
- Cette méthode POST supprime un utilisateur en tant que
Org Admin
du code de chaîne. Cette méthode ne peut être appelée que parToken Admin
ouOrg Admin
de l'organisation spécifiée. UnOrg Admin
ne peut pas se supprimer lui-même. - Données utiles :
{ "orgId": "{{bc-org-id}}", "userId": "{{bc-user-id}}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
orgId: string
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation courante.userId: string
– Nom d'utilisateur ou ID courriel de l'utilisateur.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "e2a634f6093f89b1984e20ff86a513fabb7c3ade7cc9e27d9734b4aaf6c88597", "payload": { "msg": "Successfully removed Org Admin (Org_Id: CB, User_Id: cb)" }, "encode": "JSON", "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010", "blockNumber": 220 } }
-
removeFIAuditor
- Nom de la méthode initiale :
removeOrgAuditor
- Cette méthode POST supprime un utilisateur en tant que
Org Auditor
du code de chaîne. Cette méthode ne peut être appelée que parToken Admin
ouOrg Admin
de l'organisation spécifiée. - Données utiles :
{ "orgId": "{{bc-org-id}}", "userId": "{{bc-user-id}}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
orgId: string
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation courante.userId: string
– Nom d'utilisateur ou ID courriel de l'utilisateur.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "c3bc720461004a53b37c68d4bb264858b88d980bc093a0a3ebb62a32974fb306", "payload": { "msg": "Successfully removed Org Auditor (Org_Id: CB, User_Id: cb)" }, "encode": "JSON", "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010", "blockNumber": 221 } }
-
removeRole
- Nom de la méthode initiale :
removeRole
- Cette méthode supprime un rôle d'un utilisateur et d'un jeton spécifiés. Cette méthode ne peut être appelée que par un
Token Admin
du code de chaîne ou par unOrg Admin
de l'organisation spécifiée. - Données utiles :
{ "accountId": "account_id value", "role": "role value (for example minter / burner / notary)", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
accountId: string
– ID du compte.role: string
– Nom du rôle à supprimer de l'utilisateur spécifié. Les comportementsmintable
etburnable
correspondent aux propriétésminter_role_name
etburner_role_name
du fichier de spécification. De même, le rôlenotary
correspond à la propriéténotary_role_name
du fichier de spécification.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "d92538a8f9cf2d45a0c14307ce192c399230cbf4022cec5dd6ce560cca527bf3", "payload": { "msg": "Successfully removed role 'notary' from Account Id: oaccount~e8450f7a1f320658169315fb4148ad7cb4c47c31435420fd459665f41238221b" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010", "blockNumber": 72 } }
-
requestCBDCCreation
- Nom de la méthode initiale :
requestMint
- Cette méthode peut être appelée par un minter pour envoyer une demande au notaire minter de créer une quantité spécifiée de jetons.
- Données utiles :
{ "operationId": "operation_id value", "notaryAccountId": "notary_account_id value", "quantity": 1, "timeToExpiration": "time_to_expiration value", "infoDetails": "{\"category\":\"category value\",\"description\":\"description value\"}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
operationId: string
– ID opération unique qui représente la demande de menthe.notaryAccountId: string
– ID compte du notaire qui traitera la demande.quantity: number
– La quantité de jetons à la menthe.timeToExpiration
– Heure après laquelle la demande de frappe expire et n'est plus valide.infoDetails: JSON
– Objet spécifiant la catégorie (category
) et la description (description
) de la demande, comme illustré dans l'exemple suivant.{ "category" : "category input", "description" : "description input" }
endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "1982f73495060e0eef4d78282a91c41e27e8c95572739b0677a1e404a0d20aa9", "payload": { "msg": "AccountId oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41 has successfully submitted request to mint 200 tokens" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20009", "blockNumber": 332 } }
-
requestCBDCRetirement
- Nom de la méthode initiale :
requestBurn
- Cette méthode peut être appelée par un brûleur pour envoyer une demande au notaire de détruire une quantité spécifiée de jetons.
- Données utiles :
{ "operationId": "operation_id value", "notaryAccountId": "notary_account_id value", "quantity": 1, "timeToExpiration": "time_to_expiration value", "infoDetails": "{\"category\":\"category value\",\"description\":\"description value\"}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
operationId: string
– ID opération unique qui représente la demande de gravure.notaryAccountId: string
– ID compte du notaire qui traitera la demande.quantity: number
– La quantité de jetons à brûler.timeToExpiration
– Heure après laquelle la demande de gravure expire et n'est plus valide.infoDetails: JSON
– Objet spécifiant la catégorie (category
) et la description (description
) de la demande, comme illustré dans l'exemple suivant.{ "category" : "category input", "description" : "description input" }
endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "3b1ba40490dea9bcc4df6ad22ffc7651fbbea5d1889e42a1841ee48d6ae653c6", "payload": { "msg": "AccountId oaccount~cea6080858337b1575d6a76ed0bd07a0eacd8871e3f2f7f793729a0e4b0e8e98 has successfully submitted request to burn 100 tokens" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20011", "blockNumber": 333 } }
-
setApplicationGroups
- Nom de la méthode initiale :
setApplicationGroups
- Cette méthode POST est utilisée pour définir le paramètre
application_groups
dans les détails du compte pour les groupes d'applications spécifiés. Cette méthode ne peut être appelée que par unToken Admin
du code de chaîne ou par unOrg Admin
de l'organisation spécifiée. - Données utiles :
{ "accountId": "account_id value", "applicationGroups": "[\"application_groups value\"]", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
accountId: string
– ID compte du compte de jeton.applicationGroups: string[]
– Liste des groupes d'applications auxquels appartient l'ID utilisateur, définissant les associations de l'utilisateur dans l'application CBDC.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "828fd2ece518fcf266868c840b3b1fc6b967c5c64d7591c42eb18c0c7850dc32", "payload": { "bapAccountVersion": 10, "assetType": "oaccount", "account_id": "oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a", "org_id": "CentralBank", "token_type": "fungible", "token_id": "USD", "token_name": "cbdc", "balance": "02c4601262fa7ece1ffc909811f829ad973d4133ca27c9c0fa82972d441400ad3e", "onhold_balance": "028954d23bfabee1a10d9f5a07793dec08ab0f93fd506079b0fa33f525d527595f", "onhold_burn_balance": "028954d23bfabee1a10d9f5a07793dec08ab0f93fd506079b0fa33f525d527595f", "application_groups": [ "SYSTEM_RETIRERS" ] }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010", "blockNumber": 348 } }
-
setMaxDailyAmount
- Nom de la méthode initiale :
setMaxDailyAmount
- Cette méthode POST est utilisée pour définir le paramètre
maxDailyAmount
dans les détails du compte pour le montant spécifié. Cette méthode ne peut être appelée que par unToken Admin
du code de chaîne ou par unOrg Admin
de l'organisation spécifiée. - Données utiles :
{ "accountId": "account_id value", "maxDailyAmount": "max_daily_amount value", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
accountId: string
– ID compte du compte de jeton.maxDailyAmount: number
– Valeur du montant quotidien maximal pour le compte spécifié, qui définit le montant maximal pouvant être traité quotidiennement.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "d6a8c26602c2a9cef5d6d563dbc50044af6380c96f7295e2c8e1bbf576cef36f", "payload": { "msg": "Successfully set max daily amount for account id oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a to 1000000" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010", "blockNumber": 351 } }
-
setMaxDailyTransactionCount
- Nom de la méthode initiale :
setMaxDailyTransactionCount
- Cette méthode POST est utilisée pour définir le paramètre
maxDailyTransactions
dans les détails du compte pour le montant spécifié. Cette méthode ne peut être appelée que par unToken Admin
du code de chaîne ou par unOrg Admin
de l'organisation spécifiée. - Données utiles :
{ "accountId": "account_id value", "maxDailyTransactions": "max_daily_transactions value", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
accountId: string
– ID compte du compte de jeton.maxDailyTransactions: number
– Valeur du montant quotidien maximal pour le compte spécifié, qui définit le nombre maximal de transactions autorisées par jour.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "c819da688bbe9cd4ef6fae79af014c66438b5f9d17f771d3ffc5878288097614", "payload": { "msg": "Successfully set max daily transactions for account id oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a to 100000" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010", "blockNumber": 350 } }
-
suspendCBDCAccount
- Nom de la méthode initiale :
suspendAccount
- Cette méthode suspend un compte de jeton fongible. Une erreur est générée si aucune valeur
accountStatus
n'est trouvée dans le livre. Cette méthode ne peut être appelée que par unToken Admin
du code de chaîne ou par unOrg Admin
de l'organisation spécifiée. - Données utiles :
{ "accountId": "account_id value", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
accountId: string
– ID compte du compte de jeton.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "1fa66e75ba2ab9376944a8b4e362d5fe54e167f8ada989bd9653ea54f7557aea", "payload": { "assetType": "oaccountStatus", "status_id": "oaccountStatus~d0b8ba4d154d19fd7e61e7793795a5a5b65e2266102aafdd6d01cec1a3336c71", "account_id": "oaccount~c44ffac4c46718e9744cb0aae2016d26a87a5bef5e2d1c0d1abc7d8782f0ba61", "status": "suspended" }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20011", "blockNumber": 342 } }
-
transferCBDCTokens
- Nom de la méthode initiale :
transferTokens
- Cette méthode transfère les jetons de l'appelant vers un compte spécifié. L'appelant de la méthode doit avoir un compte. La quantité doit être comprise dans les valeurs décimales spécifiées par le paramètre
decimal
du comportementdivisible
dans le fichier de spécification. - Données utiles :
{ "toAccountId": "to_account_id value", "quantity": 1, "infoDetails": "{\"category\":\"category value\",\"description\":\"description value\"}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres :
toAccountId: string
– ID compte du destinataire.quantity: number
– Le nombre de jetons à transférer.infoDetails: JSON
– Objet spécifiant la catégorie (category
) et la description (description
) de la demande, comme illustré dans l'exemple suivant.{ "category" : "category input", "description" : "description input" }
endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "txid": "62eb436be7c29fc2ed9cae221e874d9a31b163fa10374e7da09bf5e09a96c3ff", "payload": { "msg": "Successfully transferred 10000 tokens from account id: oaccount~da6e14466a0ba9b48ebc18fa672addb92dffc371bf953c3229a95b2ff2d9cd41 to account id: oaccount~68d67712f500e9dac8c314c19744003a993250271d960e9b0d25267bb18dfe9a." }, "encode": "JSON", "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010", "blockNumber": 352 } }
L'ensemble d'API de conteneur inclut également les API approveHoldCBDCTokensInterOrg
et createCBDCAccount
, qui combinent les API de code de chaîne et les API de la console Oracle Blockchain Platform en un seul point d'extrémité pour la création de compte.
-
approveHoldCBDCTokensInterOrg
- Cette méthode transfère les jetons en toute sécurité entre les organisations. En interne, cette méthode utilise l'API de validation en deux phases d'Oracle Blockchain Platform.
- Données utiles :
{ "tokenId": "{{bc-token-id}}", "operationId": "operation_id value", "quantity": 1, "senderEndorsers": ["Sender Endorsers values"], "receiverEndorsers": ["Receiver Endorsers values"], "transientMapArgsFlag": true }
- Paramètres de données utiles :
tokenId: string
- ID du jeton CBDC à transférer. L'ID jeton doit exister dans le livre.operationId: string
– ID opération unique de la demande de transfert (bloquer) à approuver.quantity: number
– Le nombre de jetons à transférer.senderEndorsers: string[]
– Tableau des pairs de l'organisation expéditrice (par exemple,["peer0.senderorg", "peer1.senderorg"]
) qui doivent endosser la transaction.receiverEndorsers: string[]
– Tableau des pairs de l'organisation destinataire (par exemple,["peer0.receiverorg", "peer1.receiverorg"
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
{ "returnCode": "Success", "error": "", "result": { "transactions": [ { "channel": "buildtest", "chaincode": "WCBDCConfAug13", "txstatus": "Committed", "prepare": { "txid": "3140569a4ecb3c3f141cc2468fe21276640b7fd79013d951d9104b79072d8f9c", "blockNumber": 335 }, "commit": { "txid": "9cfa020acc13c1de911e8a53eae799f47c1947d88a608753edb4b97fe45d00cc", "blockNumber": 336 }, "rollback": {} }, { "channel": "buildtest", "chaincode": "WCBDCConfAug13", "txstatus": "Committed", "prepare": { "txid": "32137cd7e16c560f4d96d0f8999f6a267c1e95be2f5b11ef0541e574a6cd7275", "blockNumber": 335 }, "commit": { "txid": "ac55bd7648680ff6b795e4a99026d7c538f68167683e1e622e55778a2930614d", "blockNumber": 336 }, "rollback": {} } ], "lrc": {}, "globalStatus": "Success", "globalTxid": "b54d4333-f4bb-4ca4-a7b7-cc75b659d912", "txStartTime": "2025-08-25T13:16:55.825578503Z" } }
-
createCBDCAccount
-
L'API
createCBDCAccount
effectue les opérations suivantes dans l'ordre.- Crée un ID inscription pour l'utilisateur dans Oracle Blockchain Platform. Le code d'inscription créé est le même que celui de l'utilisateur, avec certaines limites. L'ID ne peut contenir que des caractères alphanumériques, des tirets (-) et des traits de soulignement (_). Si l'ID utilisateur contient d'autres caractères spéciaux, ils sont remplacés par des traits de soulignement (_). Par exemple, si l'ID utilisateur est adam.fripp@example.com, l'ID inscription créé est adam_fripp_example_com. Si l'inscription existe déjà pour le code d'utilisateur indiqué, aucune autre inscription n'est créée.
- Crée un compte dans le livre avec les détails fournis dans les données utiles.
- Associe le nouveau compte au jeton spécifié dans les données utiles.
- Affecte à l'utilisateur le rôle spécifié dans les données utiles.
Pour assurer la cohérence et éviter les données incomplètes, si l'une des étapes suivantes échoue, le code d'inscription créé à la première étape est supprimé.
- Données utiles :
{ "orgId": "{{bc-org-id}}", "userId": "{{bc-user-id}}", "applicationGroups": "[\"applicationGroups value\"]", "customAccountId": "custom_account_id value", "tokenId": "{{bc-token-id}}", "role": "role value (for example minter / burner / notary / tokenAdmin / tokenAuditor / orgAdmin / orgAuditor/ No)", "dailyLimits": "{\"max_daily_amount\":1000, \"max_daily_transactions\":100}", "endorsers": {{endorsers}}, "transientMapArgsFlag": true }
- Paramètres de données utiles :
orgId
– ID fournisseur de services d'adhésion (MSP) de l'utilisateur pour lequel créer le compte. L'ID doit commencer par un caractère alphanumérique et peut inclure des lettres, des chiffres et des caractères spéciaux tels que des traits de soulignement (_), des points (.), des signes at (@) et des tirets (-).userId
– Nom d'utilisateur ou ID courriel de l'utilisateur. L'ID doit commencer par un caractère alphanumérique et peut inclure des lettres, des chiffres et des caractères spéciaux tels que des traits de soulignement (_), des points (.), des signes at (@) et des tirets (-).applicationGroups
– Groupes d'applications auxquels le compte appartient. Par exemple,System_Admins
.customAccountId
– ID aléatoire unique pour les comptes qui utilisent du code de chaîne en mode confidentiel.tokenId
– ID du jeton associé au compte. L'ID doit commencer par un caractère alphanumérique et peut inclure des lettres, des chiffres et le trait de soulignement des caractères spéciaux (_) et le tiret (-). Il ne doit pas dépasser 16 caractères.role
– Le rôle doit avoir l'une des valeurs suivantes :minter
,burner
,notary
,tokenAdmin
,tokenAuditor
,orgAdmin
ouorgAuditor
.dailyLimits
– Deux champs numériques qui définissent les limites de transactions quotidiennes :max_daily_amount
etmax_daily_transactions
.endorsers: string[]
– Tableau des pairs (par exemple,peer1
,peer2
) qui doivent endosser la transaction.transientMapArgsFlag
– Valeur booléenne. Si vrai, les arguments sont envoyés via une carte transitoire pour la confidentialité. Si la valeur est Faux, les arguments sont envoyés via les données utiles standard.
- Exemple de valeur renvoyée :
"payload": { "msg": "Account created successfully and 'minter' role added to Account Id: oaccount~4a86f2843c2b0105c97a77202bd9aba519c81dcef27eccc1d89125ae32770700 (Org-Id: CB, User-Id: creator_user_cb)" "accountDetails": { "bapAccountVersion": 0, "assetType": "oaccount", "account_id": "oaccount~ce5c56d2068ce31b82136c8eea110a80b9251595d361db70924c4e989032a1be", "user_id": "creator_user_cb", "org_id": "CB", "token_type": "fungible", "token_id": "USD", "token_name": "", "balance": 0, "onhold_balance": 0, "application_groups": [ "CBDC_CREATORS" ], "max_daily_amount": 1000, "daily_amount": 0, "max_daily_transactions": 100, "daily_transactions": 0, "current_date": "2024-10-06T00:00:00.000Z" } }