Stablecoin Chaincode-Methoden

Der Stablecoin-Chaincode enthält alle TypeScript-Methoden, die im generischen Token Taxonomy Framework-Chaincode verfügbar sind, und zusätzliche TypeScript-Methoden, die für das Stablecoin-Szenario spezifisch sind.

Stablecoin Asset Methoden

Das Stablecoin-Asset basiert auf dem erweiterten Token Taxonomy Framework-Standard und unterstützt alle generischen Methoden für diesen Standard. Weitere Informationen zu den generischen Token Taxonomy Framework-Methoden finden Sie unter Scaffolded TypeScript Project for Token Taxonomy Framework in Blockchain App Builder for Oracle Blockchain Platform.

Hinweis:

Im Stablecoin-Chaincode verhält sich die Methode executeHoldTokens anders als die generische Version. Die Stablecoin-Version der Methode schließt immer den vollen Hold-Betrag ab und unterstützt keine Teiltransfers.

Kontopolitik - Prüfungsmethoden

createAccountPolicyCheck
Mit dieser Methode wird eine Policy für ein angegebenes Konto erstellt. Diese Methode kann nur von einem Token Admin oder Org Admin der angegebenen Organisation aufgerufen werden.
createAccountPolicyCheck(asset: AccountPolicyCheck)
Parameter:
  • asset: AccountPolicyCheck class: Eine Klasse, die Account-Policy-Parameter definiert, die folgende Felder enthält:
    • accountPolicyId: Diese ID wird vom System aus den angegebenen Feldern orgId und userId generiert. Sie geben dieses Feld nicht manuell an.
    • orgId: Die Mitgliedsdienstanbieter-(MSP-)ID des Benutzers, für den die Policy erstellt werden soll.
    • userId: Der Benutzername oder die E-Mail-ID des Benutzers, für den die Policy erstellt werden soll.
    • kycCompliance: Ein boolescher Wert, der angibt, ob der Account die KYC-(Know Your Customer-)Anforderungen erfüllt.
    • amlCompliance: Ein boolescher Wert, der angibt, ob das Konto die Anforderungen an die Geldwäschebekämpfung erfüllt.
    • riskScore: Der dem Account zugeordnete Risikoscore, der für die Compliancebewertung verwendet wird.
    • restrictionFlag: Ein boolescher Wert, der angibt, ob das Konto eingeschränkten Transfers unterliegt. Wenn dieser Wert auf true gesetzt ist, sind nur Transfers innerhalb des niedrigsten Schwellenwertes für die Genehmigungs-Policy zulässig.
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "02875ca9c6a7408da3f81156214228b91b09c4bb2b8026d7a5733b53598c6635",
        "payload": {
            "assetType": "AccountPolicyCheck",
            "accountPolicyId": "APID~CentralBank~cb__creator_demo",
            "orgId": "CentralBank",
            "userId": "cb__creator_demo",
            "kycCompliance": "true",
            "amlCompliance": "true",
            "riskScore": 1000,
            "restrictionFlag": "false"
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 272
    }
}
getAccountPolicyCheckById
Diese Methode ruft die Account-Policy-Details für eine angegebene Policy-ID ab. Diese Methode kann nur von Token Admin oder Token Auditor oder Org Admin oder Org Auditor der angegebenen Organisation aufgerufen werden.
getAccountPolicyCheckById(id: string)
Parameter:
  • id: string: Die eindeutige ID der Accountrichtlinie.
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "02875ca9c6a7408da3f81156214228b91b09c4bb2b8026d7a5733b53598c6635",
        "payload": {
            "assetType": "AccountPolicyCheck",
            "accountPolicyId": "APID~CentralBank~cb__creator_demo",
            "orgId": "CentralBank",
            "userId": "cb__creator_demo",
            "kycCompliance": "true",
            "amlCompliance": "true",
            "riskScore": 1000,
            "restrictionFlag": "false"
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 272
    }
}
updateAccountPolicyCheck
Mit dieser Methode wird die Policy für einen angegebenen Account aktualisiert. Diese Methode kann nur von einem Token Admin oder Org Admin der angegebenen Organisation aufgerufen werden.
updateAccountPolicyCheck(asset: AccountPolicyCheck)
Parameter:
  • asset: AccountPolicyCheck class: Eine Klasse, die Account-Policy-Parameter definiert, die folgende Felder enthält:
    • accountPolicyId: Die eindeutige ID der Accountrichtlinie.
    • orgId: Die Mitgliedsdienstanbieter-(MSP-)ID des Benutzers, für den die Policy erstellt werden soll.
    • userId: Der Benutzername oder die E-Mail-ID des Benutzers, für den die Policy erstellt werden soll.
    • kycCompliance: Ein boolescher Wert, der angibt, ob der Account die KYC-(Know Your Customer-)Anforderungen erfüllt.
    • amlCompliance: Ein boolescher Wert, der angibt, ob das Konto die Anforderungen an die Geldwäschebekämpfung erfüllt.
    • riskScore: Der dem Account zugeordnete Risikoscore, der für die Compliancebewertung verwendet wird.
    • restrictionFlag: Ein boolescher Wert, der angibt, ob das Konto eingeschränkten Transfers unterliegt. Wenn dieser Wert auf true gesetzt ist, sind nur Transfers innerhalb des niedrigsten Schwellenwertes für die Genehmigungs-Policy zulässig.
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "02875ca9c6a7408da3f81156214228b91b09c4bb2b8026d7a5733b53598c6635",
        "payload": {
            "assetType": "AccountPolicyCheck",
            "accountPolicyId": "APID~CentralBank~cb__creator_demo",
            "orgId": "CentralBank",
            "userId": "cb__creator_demo",
            "kycCompliance": "true",
            "amlCompliance": "true",
            "riskScore": 1000,
            "restrictionFlag": "true"
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 272
    }
}
deleteAccountPolicyCheck
Mit dieser Methode wird die Policy für eine angegebene Policy-ID gelöscht. Diese Methode kann nur von einem Token Admin oder Org Admin der angegebenen Organisation aufgerufen werden.
deleteAccountPolicyCheck(id: string)
Parameter:
  • id: string: Die eindeutige ID der Accountrichtlinie.
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "5499f49ae8595facbcbf56835bed9e6606875c0f54fd3cacb31a4104b56d3579",
        "payload": {
            "isValid": true,
            "message": "Successfully deleted asset with ID [APID~CentralBank~cb__creator_demo] from ledger"
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 273
    }
}
getAccountPolicyCheckHistoryById
Diese Methode ruft die vollständige Account-Policy-Historie für eine angegebene Policy-ID ab. Diese Methode kann nur von Token Admin oder Token Auditor oder Org Admin oder Org Auditor der angegebenen Organisation aufgerufen werden.
getAccountPolicyCheckHistoryById(id: string)
Parameter:
  • id: string: Die eindeutige ID der Accountrichtlinie.
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": [
            {
                "trxId": "dbfd34199bc5ea7224ca6c9976e30166dc859923ab044e595d0d42ad842eb471",
                "timeStamp": "2025-11-20T21:36:29.000Z",
                "value": {
                    "assetType": "AccountPolicyCheck",
                    "accountPolicyId": "APID~CentralBank~cb__creator_demo",
                    "orgId": "CentralBank",
                    "userId": "cb__creator_demo",
                    "kycCompliance": "true",
                    "amlCompliance": "true",
                    "riskScore": 1000,
                    "restrictionFlag": "true"
                }
            },
            {
                "trxId": "8b6951a4093f3bb79a489397878f9025ce4384c8973a0c4d0ec9c618667e8935",
                "timeStamp": "2025-11-20T21:35:34.000Z",
                "value": {
                    "assetType": "AccountPolicyCheck",
                    "accountPolicyId": "APID~CentralBank~cb__creator_demo",
                    "orgId": "CentralBank",
                    "userId": "cb__creator_demo",
                    "kycCompliance": "true",
                    "amlCompliance": "true",
                    "riskScore": 1000,
                    "restrictionFlag": "false"
                }
            },
            {
                "trxId": "5499f49ae8595facbcbf56835bed9e6606875c0f54fd3cacb31a4104b56d3579",
                "timeStamp": "2025-11-20T21:34:03.000Z",
                "value": "KEY DELETED"
            },
            {
                "trxId": "02875ca9c6a7408da3f81156214228b91b09c4bb2b8026d7a5733b53598c6635",
                "timeStamp": "2025-11-20T21:33:24.000Z",
                "value": {
                    "assetType": "AccountPolicyCheck",
                    "accountPolicyId": "APID~CentralBank~cb__creator_demo",
                    "orgId": "CentralBank",
                    "userId": "cb__creator_demo",
                    "kycCompliance": "true",
                    "amlCompliance": "true",
                    "riskScore": 1000,
                    "restrictionFlag": "false"
                }
            }
        ],
        "encode": "JSON"
    }
}
getAccountPolicyCheckByRange
Diese Methode ruft die gesamte Policy-Historie für einen angegebenen Bereich von Policy-IDs ab. Diese Methode kann nur von einem Token Admin oder Org Admin der angegebenen Organisation aufgerufen werden.
getAccountPolicyCheckByRange(startId: string, endId: string)
Parameter:
  • startId: string: Die Startaccount-Policy-ID des Bereichs (einschließlich).
  • endId: string: Die End-Account-Policy-ID des Bereichs (ausschließlich).
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": [
            {
                "assetType": "AccountPolicyCheck",
                "accountPolicyId": "APID~CentralBank~cb__creator_demo",
                "orgId": "CentralBank",
                "userId": "cb__creator_demo",
                "kycCompliance": "true",
                "amlCompliance": "true",
                "riskScore": 1000,
                "restrictionFlag": "true"
            },
            {
                "assetType": "AccountPolicyCheck",
                "accountPolicyId": "APID~CentralBank~cb_issuer_demo",
                "orgId": "CentralBank",
                "userId": "cb_issuer_demo",
                "kycCompliance": "true",
                "amlCompliance": "true",
                "riskScore": 1000,
                "restrictionFlag": "false"
            }
        ],
        "encode": "JSON"
    }
}

Genehmigungs-Policy-Prüfmethoden

createApprovalPolicyCheck
Mit dieser Methode wird eine Genehmigungs-Policy erstellt. Diese Methode kann nur mit einem Token Admin aufgerufen werden.
createApprovalPolicyCheck(asset: ApprovalPolicyCheck)
Parameter:
  • asset: ApprovalPolicyCheck class: Eine Klasse, die Genehmigungsregeln für eine Transaktion definiert, die folgende Felder enthält:
    • approvalPolicyId: Diese ID wird vom System generiert. Sie geben dieses Feld nicht manuell an.
    • transactionLowerLimit: Der Mindesttransaktionsbetrag, für den die Genehmigungs-Policy gilt.
    • transactionUpperLimit: Der maximale Transaktionsbetrag, für den die Genehmigungs-Policy gilt.
    • numberOfApprovalsRequired: Die Gesamtanzahl der Genehmigungen, die erforderlich sind, bevor die Transaktion abgeschlossen werden kann.
    • approverDetails: Eine Liste mit Genehmigern zusammen mit der zugewiesenen Genehmigungsreihenfolge, die den erforderlichen Auftrag für Genehmigungen definiert.
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "3a5701ca90ffb98832421c7d5377eb9c0df9fdab30a0a3ce06216808bdea098e",
        "payload": {
            "status": "active",
            "assetType": "ApprovalPolicyCheck",
            "approvalPolicyId": "GPID~500~1000",
            "transactionLowerLimit": "500",
            "transactionUpperLimit": "1000",
            "numberOfApprovalsRequired": 2,
            "approverDetails": [
                {
                    "approverOrgId": "CentralBank",
                    "approverUserId": "manager",
                    "approvalSequence": 1
                },
                {
                    "approverOrgId": "CentralBank",
                    "approverUserId": "creator",
                    "approvalSequence": 2
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 284
    }
}
getApprovalPolicyCheckById
Diese Methode ruft die Genehmigungs-Policy-Details für eine angegebene Policy-ID ab. Diese Methode kann nur von einem Token Admin oder Org Admin der angegebenen Organisation aufgerufen werden.
getApprovalPolicyCheckById(id: string)
Parameter:
  • id: string: Die eindeutige ID der Genehmigungs-Policy.
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "assetType": "ApprovalPolicyCheck",
            "approvalPolicyId": "GPID~0~100",
            "transactionLowerLimit": "0",
            "transactionUpperLimit": "100",
            "numberOfApprovalsRequired": 0,
            "approverDetails": []
        },
        "encode": "JSON"
    }
}
updateApprovalPolicyCheck
Mit dieser Methode wird die Genehmigungs-Policy aktualisiert. Diese Methode kann nur mit einem Token Admin aufgerufen werden.
updateApprovalPolicyCheck(asset: ApprovalPolicyCheck)
Parameter:
  • asset: ApprovalPolicyCheck class: Eine Klasse, die Genehmigungsregeln für eine Transaktion definiert, die folgende Felder enthält:
    • approvalPolicyId: Die eindeutige ID der Genehmigungs-Policy.
    • transactionLowerLimit: Der Mindesttransaktionsbetrag, für den die Genehmigungs-Policy gilt.
    • transactionUpperLimit: Der maximale Transaktionsbetrag, für den die Genehmigungs-Policy gilt.
    • numberOfApprovalsRequired: Die Gesamtanzahl der Genehmigungen, die erforderlich sind, bevor die Transaktion abgeschlossen werden kann.
    • approverDetails: Eine Liste mit Genehmigern zusammen mit der zugewiesenen Genehmigungsreihenfolge, die den erforderlichen Auftrag für Genehmigungen definiert.
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "ed1e1950fe02dbab74fa3aa7630b8dc6096e30aae5c81bab0dd22d5232c44fc9",
        "payload": {
            "status": "active",
            "assetType": "ApprovalPolicyCheck",
            "approvalPolicyId": "GPID~500~1000",
            "transactionLowerLimit": "500",
            "transactionUpperLimit": "1000",
            "numberOfApprovalsRequired": 1,
            "approverDetails": [
                {
                    "approverOrgId": "CentralBank",
                    "approverUserId": "manager",
                    "approvalSequence": 1
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20009",
        "blockNumber": 285
    }
}
deleteApprovalPolicyCheck
Mit dieser Methode wird die Genehmigungs-Policy für eine angegebene Policy-ID gelöscht. Diese Methode kann nur mit einem Token Admin aufgerufen werden.
deleteApprovalPolicyCheck(id: string)
Parameter:
  • id: string: Die eindeutige ID der Genehmigungs-Policy.
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "5ac54d3279a183022a00495aee3c25c2893388ff9aaaecd5c3b594edfa49ad8f",
        "payload": {
            "isValid": true,
            "message": "Successfully deleted asset with ID [GPID~500~1000] from ledger"
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20009",
        "blockNumber": 286
    }
}
getApprovalPolicyCheckHistoryById
Diese Methode ruft die vollständige Genehmigungs-Policy-Historie für eine angegebene Policy-ID ab. Diese Methode kann nur von einem Token Admin oder Org Admin der angegebenen Organisation aufgerufen werden.
getApprovalPolicyCheckHistoryById(id: string)
Parameter:
  • id: string: Die eindeutige ID der Genehmigungs-Policy.
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": [
            {
                "trxId": "48f196c18869e871dc92ab880933ccc1c4dc402b9753ae6270e223646c177090",
                "timeStamp": "2025-11-21T09:30:04.000Z",
                "value": {
                    "assetType": "ApprovalPolicyCheck",
                    "approvalPolicyId": "GPID~0~100",
                    "transactionLowerLimit": "0",
                    "transactionUpperLimit": "100",
                    "numberOfApprovalsRequired": 0,
                    "approverDetails": []
                }
            }
        ],
        "encode": "JSON"
    }
}
getApprovalPolicyCheckByRange
Diese Methode ruft die gesamte Genehmigungs-Policy-Historie für einen angegebenen Bereich von Policy-IDs ab. Diese Methode kann nur von einem Token Admin oder Org Admin der angegebenen Organisation aufgerufen werden.
getApprovalPolicyCheckByRange(startId: string, endId: string)
Parameter:
  • startId: string: Die erste Genehmigungs-Policy-ID des Bereichs (einschließlich).
  • endId: string: Die ID der Endgenehmigungs-Policy des Bereichs (ausschließlich).
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": [
            {
                "assetType": "ApprovalPolicyCheck",
                "approvalPolicyId": "GPID~0~100",
                "transactionLowerLimit": "0",
                "transactionUpperLimit": "100",
                "numberOfApprovalsRequired": 0,
                "approverDetails": []
            },
            {
                "status": "active",
                "assetType": "ApprovalPolicyCheck",
                "approvalPolicyId": "GPID~500~1000",
                "transactionLowerLimit": "500",
                "transactionUpperLimit": "1000",
                "numberOfApprovalsRequired": 2,
                "approverDetails": [
                    {
                        "approverOrgId": "CentralBank",
                        "approverUserId": "manager",
                        "approvalSequence": 1
                    },
                    {
                        "approverOrgId": "CentralBank",
                        "approverUserId": "creator",
                        "approvalSequence": 2
                    }
                ]
            }
        ],
        "encode": "JSON"
    }
}

Genehmigungstransaktionsarten

getApprovalTransactionById
Diese Methode ruft die Genehmigungstransaktion für eine angegebene Transaktions-ID ab. Diese Methode kann nur von einem Token Admin oder Org Admin der angegebenen Organisation aufgerufen werden.
getApprovalTransactionsById(id: string)
Parameter:
  • id: string: Die vom System generierte ID der Genehmigungstransaktion.
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "assetType": "ApprovalTransactions",
            "approvalTransactionId": "hold1~oaccount~1cf5d40c7ea7b9dceedfc66292ab843c1583564c3ecaf9f5ceb11f834018b02f",
            "approvalOperationId": "hold1",
            "fromAccountId": "oaccount~374e4e762940fc185c7cd5b6528c7f94985b6c56acf46abb746de6381589edd2",
            "toAccountId": "oaccount~79c427e614530eacad6fb07cff6048f6b96283e65019301320c9684932846f64",
            "approverAccountId": "oaccount~1cf5d40c7ea7b9dceedfc66292ab843c1583564c3ecaf9f5ceb11f834018b02f",
            "totalApprovals": 1,
            "timestamp": "2025-11-21T12:32:43.000Z"
        },
        "encode": "JSON"
    }
}

Benutzerdefinierte Methoden

getApproverDetailsByTransferAmount
Diese Methode ruft die Details des Genehmigers ab, die für einen bestimmten Transferbetrag erforderlich sind. Diese Methode kann nur mit einer Token Admin oder Token Auditor aufgerufen werden.
getApproverDetailsByTransferAmount(Amount: number)
Parameter:
  • amount: number: Der Überweisungsbetrag.
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "5874105c14abd67e68cb4dacf82f2a2dca6cc9da4f5b27fcc91c83a60b7249e1",
        "payload": {
            "approverDetails": [
                {
                    "approverOrgId": "CentralBank",
                    "approverUserId": "manager",
                    "approvalSequence": 1
                },
                {
                    "approverOrgId": "CentralBank",
                    "approverUserId": "creator",
                    "approvalSequence": 2
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 292
    }
}
approveTransaction
Ein Genehmiger kann diese Methode verwenden, um eine Sperrestransaktion zu genehmigen.
approveTransaction(token_id: string, operation_id: string, quantity: number)
Parameter:
  • token_id: string: Die ID des Tokens.
  • operation_id: string: Eine eindeutige ID zur Identifizierung des Sperrvorgangs. Normalerweise wird diese ID von der Clientanwendung übergeben.
  • quantity: number: Die Anzahl der zurückgestellten Token, die für die Übertragung genehmigt werden sollen.
Beispiel für Rückgabewert:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "44685b0ff1b0ee72d57cb62900aae30638d65c82f264d5de7b28375732171702",
        "payload": {
            "assetType": "ApprovalTransactions",
            "approvalTransactionId": "hold1~oaccount~1cf5d40c7ea7b9dceedfc66292ab843c1583564c3ecaf9f5ceb11f834018b02f",
            "approvalOperationId": "hold1",
            "fromAccountId": "oaccount~374e4e762940fc185c7cd5b6528c7f94985b6c56acf46abb746de6381589edd2",
            "toAccountId": "oaccount~79c427e614530eacad6fb07cff6048f6b96283e65019301320c9684932846f64",
            "approverAccountId": "oaccount~1cf5d40c7ea7b9dceedfc66292ab843c1583564c3ecaf9f5ceb11f834018b02f",
            "totalApprovals": 1,
            "timestamp": "2025-11-21T12:32:43.000Z"
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 289
    }
}