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
• Kontopolitik - Prüfungsmethoden
• Genehmigungs-Policy-Prüfmethoden
• Genehmigungstransaktionsarten
• Transfereinschränkungsmethoden
• Benutzerdefinierte Methoden

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 Zeichenfolgenwert (true oder false), der angibt, ob das Konto die KYC-(Know Your Customer-)Anforderungen erfüllt.
  • amlCompliance: Ein Zeichenfolgenwert (true oder false), 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 Zeichenfolgenwert (true oder false), der angibt, ob das Konto eingeschränkten Übertragungen unterliegt. Wenn dieser Wert auf true gesetzt ist, folgen Direktübertragungen den Limits für den Übertragungseinschränkungszeitraum, und Sperrenübertragungen folgen dem niedrigsten Schwellenwert für die Genehmigungs-Policy.

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 Zeichenfolgenwert (true oder false), der angibt, ob das Konto die KYC-(Know Your Customer-)Anforderungen erfüllt.
  • amlCompliance: Ein Zeichenfolgenwert (true oder false), 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 Zeichenfolgenwert (true oder false), der angibt, ob das Konto eingeschränkten Übertragungen unterliegt. Wenn dieser Wert auf true gesetzt ist, folgen Direktübertragungen den Limits für den Übertragungseinschränkungszeitraum, und Sperrenübertragungen folgen dem niedrigsten Schwellenwert für die Genehmigungs-Policy.

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 mit einer Token Admin oder Token Auditor 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 mit einer Token Admin oder Token Auditor 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 mit einer Token Admin oder Token Auditor 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

getApprovalTransactionsById

Diese Methode ruft die Genehmigungstransaktion für eine angegebene Transaktions-ID ab. Diese Methode kann nur mit einer Token Admin oder Token Auditor 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": "hold4~CentralBank~creator",
            "approvalOperationId": "hold4",
            "fromAccountId": "oaccount~374e4e762940fc185c7cd5b6528c7f94985b6c56acf46abb746de6381589edd2",
            "toAccountId": "oaccount~79c427e614530eacad6fb07cff6048f6b96283e65019301320c9684932846f64",
            "approverOrgId": "CentralBank",
            "approverUserId": "creator",
            "totalApprovals": 2,
            "approvalsRequired": 2,
            "timestamp": "2025-12-10T20:01:14.000Z"
        },
        "encode": "JSON"
    }
}

getApprovalsByOperationId

Ursprünglicher Methodenname: getApprovalsByOperationId

Diese Methode gibt die Historie aller Genehmigungen zurück, die mit einer angegebenen Vorgangs-ID verknüpft sind. Diese Methode kann nur mit einer Token Admin oder Token Auditor aufgerufen werden.

getApprovalsByOperationId(operation_id: string)

Parameter:

• operation_id: string: Die eindeutige Vorgangs-ID der zu genehmigenden Anforderung.

Beispiel für Rückgabewert:

{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": [
            {
                "assetType": "ApprovalTransactions",
                "approvalTransactionId": "hold4~CentralBank~creator",
                "approvalOperationId": "hold4",
                "fromAccountId": "oaccount~374e4e762940fc185c7cd5b6528c7f94985b6c56acf46abb746de6381589edd2",
                "toAccountId": "oaccount~79c427e614530eacad6fb07cff6048f6b96283e65019301320c9684932846f64",
                "approverOrgId": "CentralBank",
                "approverUserId": "creator",
                "totalApprovals": 2,
                "approvalsRequired": 2,
                "timestamp": "2025-12-10T20:01:14.000Z"
            },
            {
                "assetType": "ApprovalTransactions",
                "approvalTransactionId": "hold4~CentralBank~manager",
                "approvalOperationId": "hold4",
                "fromAccountId": "oaccount~374e4e762940fc185c7cd5b6528c7f94985b6c56acf46abb746de6381589edd2",
                "toAccountId": "oaccount~79c427e614530eacad6fb07cff6048f6b96283e65019301320c9684932846f64",
                "approverOrgId": "CentralBank",
                "approverUserId": "manager",
                "totalApprovals": 1,
                "approvalsRequired": 2,
                "timestamp": "2025-12-10T20:01:06.000Z"
            }
        ],
        "encode": "JSON"
    }
}

getApprovalsByApprover

Ursprünglicher Methodenname: getApprovalsByApprover

Diese Methode gibt die Historie aller Genehmigungen zurück, die von einem angegebenen Benutzer abgeschlossen wurden. Diese Methode kann nur von einem Token Admin, Token Auditor, Org Admin, Org Auditor oder einem beliebigen Accounteigentümer aufgerufen werden.

getApprovalsByApprover(org_id: string, user_id: string)

Parameter:

• org_id: Die Mitgliedsdienstanbieter-(MSP-)ID des Benutzers.
• user_id: Der Benutzername oder die E-Mail-ID des Benutzers.

Beispiel für Rückgabewert:

{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": [
            {
                "assetType": "ApprovalTransactions",
                "approvalTransactionId": "hold4~CentralBank~manager",
                "approvalOperationId": "hold4",
                "fromAccountId": "oaccount~374e4e762940fc185c7cd5b6528c7f94985b6c56acf46abb746de6381589edd2",
                "toAccountId": "oaccount~79c427e614530eacad6fb07cff6048f6b96283e65019301320c9684932846f64",
                "approverOrgId": "CentralBank",
                "approverUserId": "manager",
                "totalApprovals": 1,
                "approvalsRequired": 2,
                "timestamp": "2025-12-10T20:01:06.000Z"
            },
            {
                "assetType": "ApprovalTransactions",
                "approvalTransactionId": "hold3~CentralBank~manager",
                "approvalOperationId": "hold3",
                "fromAccountId": "oaccount~374e4e762940fc185c7cd5b6528c7f94985b6c56acf46abb746de6381589edd2",
                "toAccountId": "oaccount~79c427e614530eacad6fb07cff6048f6b96283e65019301320c9684932846f64",
                "approverOrgId": "CentralBank",
                "approverUserId": "manager",
                "totalApprovals": 1,
                "approvalsRequired": 2,
                "timestamp": "2025-12-10T19:10:53.000Z"
            },
            {
                "assetType": "ApprovalTransactions",
                "approvalTransactionId": "hold2~CentralBank~manager",
                "approvalOperationId": "hold2",
                "fromAccountId": "oaccount~374e4e762940fc185c7cd5b6528c7f94985b6c56acf46abb746de6381589edd2",
                "toAccountId": "oaccount~79c427e614530eacad6fb07cff6048f6b96283e65019301320c9684932846f64",
                "approverOrgId": "CentralBank",
                "approverUserId": "manager",
                "totalApprovals": 1,
                "approvalsRequired": 2,
                "timestamp": "2025-12-10T19:05:39.000Z"
            }
        ],
        "encode": "JSON"
    }
}

Transfereinschränkungsmethoden

Mit Transfereinschränkungen können Sie die Mindest- und Höchsttransaktionsbeträge kontrollieren, die für Tokenübertragungen zulässig sind. Transfereinschränkungen werden angewendet, wenn für ein Konto der Wert restrictionFlag auf true gesetzt ist. Übertragungsbeschränkungen funktionieren unabhängig von den Genehmigungs-Policy-Regeln, die für Sperrvorgänge verwendet werden. Das in der Spezifikationsdatei definierte Asset TransferRestriction legt die globalen unteren und oberen Transferlimits fest, die für alle Konten gelten, für die Transferbeschränkungen aktiviert sind. Nachdem der Chaincode bereitgestellt wurde, können Administratoren diese Werte mit den folgenden Methoden abrufen oder aktualisieren.

getTransferRestriction

Ursprünglicher Methodenname: getTransferRestriction

Diese Methode gibt die aktuelle Konfiguration der Transfereinschränkung zurück, einschließlich der unteren und oberen Transaktionslimits. Diese Methode kann nur mit einer Token Admin oder Token Auditor aufgerufen werden.

getTransferRestriction()

Parameter:

• Kein

Beispiel für Rückgabewert:

{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "assetType": "TransferRestriction",
            "transferRestrictionId": "transferRestriction~GLOBAL",
            "transactionLowerLimit": 0,
            "transactionUpperLimit": 1000
        },
        "encode": "JSON"
    }
}

updateTransferRestriction

Ursprünglicher Methodenname: updateTransferRestriction

Mit dieser Methode wird die Konfiguration der Übertragungseinschränkung aktualisiert, indem neue untere und obere Transaktionslimits festgelegt werden. Diese Methode kann nur mit einem Token Admin aufgerufen werden.

updateTransferRestriction(transactionLowerLimit: number, transactionUpperLimit: number)

Parameter:

• transactionLowerLimit: Der zulässige Mindesttransferbetrag.
• transactionUpperLimit: Der maximal zulässige Transferbetrag, der ohne spezielle Governance verarbeitet werden kann.

Beispiel für Rückgabewert:

{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "assetType": "TransferRestriction",
            "transferRestrictionId": "transferRestriction~GLOBAL",
            "transactionLowerLimit": 0,
            "transactionUpperLimit": 10000
        },
        "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": {
        "payload": {
            "assetType": "ApprovalTransactions",
            "approvalTransactionId": "hold4~CentralBank~creator",
            "approvalOperationId": "hold4",
            "fromAccountId": "oaccount~374e4e762940fc185c7cd5b6528c7f94985b6c56acf46abb746de6381589edd2",
            "toAccountId": "oaccount~79c427e614530eacad6fb07cff6048f6b96283e65019301320c9684932846f64",
            "approverOrgId": "CentralBank",
            "approverUserId": "creator",
            "totalApprovals": 2,
            "approvalsRequired": 2,
            "timestamp": "2025-12-10T20:01:14.000Z"
        },
        "encode": "JSON"
    }
}