Métodos de código de cadena de Stablecoin

El código de cadena de stablecoin incluye todos los métodos TypeScript que están disponibles en el código de cadena genérico de Token Taxonomy Framework y los métodos TypeScript adicionales que son específicos del escenario de stablecoin.

Métodos de activos de Stablecoin

El activo de stablecoin se basa en el estándar extendido Token Taxonomy Framework y admite todos los métodos genéricos para ese estándar. Para obtener más información sobre los métodos genéricos de Token Taxonomy Framework, consulte Proyecto andamiaje TypeScript para Token Taxonomy Framework en Blockchain App Builder para Oracle Blockchain Platform.

Note:

En el código de cadena de stablecoin, el método executeHoldTokens se comporta de manera diferente a la versión genérica. La versión de stablecoin del método siempre completa el importe de retención completo y no admite transferencias parciales.

Métodos de comprobación de política de cuenta

createAccountPolicyCheck

Este método crea una política para una cuenta especificada. Este método solo puede ser llamado por un Token Admin o Org Admin de la organización especificada.

createAccountPolicyCheck(asset: AccountPolicyCheck)

Parámetros:

asset: AccountPolicyCheck class: clase que define los parámetros de política de cuenta, que incluye los siguientes campos:
- accountPolicyId: el sistema genera este ID a partir de los campos orgId y userId especificados. Este campo no se proporciona manualmente.
- orgId: ID del proveedor de servicios de afiliación (MSP) del usuario para el que se va a crear la política.
- userId: nombre de usuario o ID de correo electrónico del usuario para el que se va a crear la política.
- kycCompliance: un valor de cadena (true o false) que indica si la cuenta cumple los requisitos de KYC (Know Your Customer).
- amlCompliance: valor de cadena (true o false) que indica si la cuenta cumple los requisitos de AML (Antilavado de dinero).
- riskScore: puntuación de riesgo asociada a la cuenta, que se utiliza para la evaluación de conformidad.
- restrictionFlag: valor de cadena (true o false) que indica si la cuenta está sujeta a transferencias restringidas. Si se define en true, las transferencias directas siguen los límites de bloque de restricción de transferencia y las transferencias retenidas siguen el umbral de política de aprobación más bajo.

Ejemplo de valor devuelto:

{
    "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

Este método obtiene los detalles de la política de cuenta para un ID de política especificado. Este método solo puede ser llamado por Token Admin o Token Auditor, o por Org Admin o Org Auditor de la organización especificada.

getAccountPolicyCheckById(id: string)

Parámetros:

id: string: ID de política de cuenta único.

Ejemplo de valor devuelto:

{
    "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

Este método actualiza la política para una cuenta especificada. Este método solo puede ser llamado por un Token Admin o Org Admin de la organización especificada.

updateAccountPolicyCheck(asset: AccountPolicyCheck)

Parámetros:

asset: AccountPolicyCheck class: clase que define los parámetros de política de cuenta, que incluye los siguientes campos:
- accountPolicyId: ID de política de cuenta único.
- orgId: ID del proveedor de servicios de afiliación (MSP) del usuario para el que se va a crear la política.
- userId: nombre de usuario o ID de correo electrónico del usuario para el que se va a crear la política.
- kycCompliance: un valor de cadena (true o false) que indica si la cuenta cumple los requisitos de KYC (Know Your Customer).
- amlCompliance: valor de cadena (true o false) que indica si la cuenta cumple los requisitos de AML (Antilavado de dinero).
- riskScore: puntuación de riesgo asociada a la cuenta, que se utiliza para la evaluación de conformidad.
- restrictionFlag: valor de cadena (true o false) que indica si la cuenta está sujeta a transferencias restringidas. Si se define en true, las transferencias directas siguen los límites de bloque de restricción de transferencia y las transferencias retenidas siguen el umbral de política de aprobación más bajo.

Ejemplo de valor devuelto:

{
    "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

Este método suprime la política para un ID de política especificado. Este método solo puede ser llamado por un Token Admin o Org Admin de la organización especificada.

deleteAccountPolicyCheck(id: string)

Parámetros:

id: string: ID de política de cuenta único.

Ejemplo de valor devuelto:

{
    "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

Este método obtiene el historial completo de políticas de cuenta para un ID de política especificado. Este método solo puede ser llamado por Token Admin o Token Auditor, o por Org Admin o Org Auditor de la organización especificada.

getAccountPolicyCheckHistoryById(id: string)

Parámetros:

id: string: ID de política de cuenta único.

Ejemplo de valor devuelto:

{
    "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

Este método obtiene todo el historial de políticas para un rango especificado de ID de políticas. Este método solo puede ser llamado por un Token Admin o Org Admin de la organización especificada.

getAccountPolicyCheckByRange(startId: string, endId: string)

Parámetros:

startId: string: ID de política de cuenta inicial del rango (incluido).
endId: string: ID de política de cuenta final del rango (exclusivo).

Ejemplo de valor devuelto:

{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": [
            {
                "assetType": "AccountPolicyCheck",
                "accountPolicyId": "APID~CentralBank~cb__creator_demo",
                "orgId": "CentralBank",
                "userId": "cb__creator_demo",
                "kycCompliance": "true",
                "amlCompliance": "true",
                "riskScore": 1000,
                "restrictionFlag": "true"
            },
            {
                "assetType": "AccountPolicyCheck",
                "accountPolicyId": "APID~CentralBank~cb_issuer_demo",
                "orgId": "CentralBank",
                "userId": "cb_issuer_demo",
                "kycCompliance": "true",
                "amlCompliance": "true",
                "riskScore": 1000,
                "restrictionFlag": "false"
            }
        ],
        "encode": "JSON"
    }
}

Métodos de comprobación de política de aprobación

createApprovalPolicyCheck

Este método crea una política de aprobación. Este método solo se puede llamar mediante Token Admin.

createApprovalPolicyCheck(asset: ApprovalPolicyCheck)

Parámetros:

asset: ApprovalPolicyCheck class: clase que define reglas de aprobación para una transacción, que incluye los siguientes campos:
- approvalPolicyId: el sistema genera este ID. Este campo no se proporciona manualmente.
- transactionLowerLimit: importe mínimo de transacción al que se aplica la política de aprobación.
- transactionUpperLimit: importe máximo de transacción al que se aplica la política de aprobación.
- numberOfApprovalsRequired: número total de aprobaciones necesarias antes de que se pueda completar la transacción.
- approverDetails: lista de aprobadores junto con la secuencia de aprobación asignada, que define el orden obligatorio para las aprobaciones.

Ejemplo de valor devuelto:

{
    "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

Este método obtiene los detalles de la política de aprobación para un ID de política especificado. Este método solo se puede llamar mediante Token Admin o Token Auditor.

getApprovalPolicyCheckById(id: string)

Parámetros:

id: string: ID de política de aprobación único.

Ejemplo de valor devuelto:

{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "assetType": "ApprovalPolicyCheck",
            "approvalPolicyId": "GPID~0~100",
            "transactionLowerLimit": 0,
            "transactionUpperLimit": 100,
            "numberOfApprovalsRequired": 0,
            "approverDetails": []
        },
        "encode": "JSON"
    }
}

updateApprovalPolicyCheck

Este método actualiza la política de aprobación. Este método solo se puede llamar mediante Token Admin.

updateApprovalPolicyCheck(asset: ApprovalPolicyCheck)

Parámetros:

asset: ApprovalPolicyCheck class: clase que define reglas de aprobación para una transacción, que incluye los siguientes campos:
- approvalPolicyId: ID de política de aprobación único.
- transactionLowerLimit: importe mínimo de transacción al que se aplica la política de aprobación.
- transactionUpperLimit: importe máximo de transacción al que se aplica la política de aprobación.
- numberOfApprovalsRequired: número total de aprobaciones necesarias antes de que se pueda completar la transacción.
- approverDetails: lista de aprobadores junto con la secuencia de aprobación asignada, que define el orden obligatorio para las aprobaciones.

Ejemplo de valor devuelto:

{
    "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

Este método suprime la política de aprobación para un ID de política especificado. Este método solo se puede llamar mediante Token Admin.

deleteApprovalPolicyCheck(id: string)

Parámetros:

id: string: ID de política de aprobación único.

Ejemplo de valor devuelto:

{
    "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

Este método obtiene el historial completo de políticas de aprobación para un ID de política especificado. Este método solo se puede llamar mediante Token Admin o Token Auditor.

getApprovalPolicyCheckHistoryById(id: string)

Parámetros:

id: string: ID de política de aprobación único.

Ejemplo de valor devuelto:

{
    "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

Este método obtiene todo el historial de políticas de aprobación para un rango especificado de ID de políticas. Este método solo se puede llamar mediante Token Admin o Token Auditor.

getApprovalPolicyCheckByRange(startId: string, endId: string)

Parámetros:

startId: string: ID de política de aprobación inicial del rango (incluido).
endId: string: ID de política de aprobación final del rango (exclusivo).

Ejemplo de valor devuelto:

{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": [
            {
                "assetType": "ApprovalPolicyCheck",
                "approvalPolicyId": "GPID~0~100",
                "transactionLowerLimit": 0,
                "transactionUpperLimit": 100,
                "numberOfApprovalsRequired": 0,
                "approverDetails": []
            },
            {
                "status": "active",
                "assetType": "ApprovalPolicyCheck",
                "approvalPolicyId": "GPID~500~1000",
                "transactionLowerLimit": 500,
                "transactionUpperLimit": 1000,
                "numberOfApprovalsRequired": 2,
                "approverDetails": [
                    {
                        "approverOrgId": "CentralBank",
                        "approverUserId": "manager",
                        "approvalSequence": 1
                    },
                    {
                        "approverOrgId": "CentralBank",
                        "approverUserId": "creator",
                        "approvalSequence": 2
                    }
                ]
            }
        ],
        "encode": "JSON"
    }
}

Métodos de transacciones de aprobación

getApprovalTransactionsById

Este método obtiene la transacción de aprobación para un ID de transacción especificado. Este método solo se puede llamar mediante Token Admin o Token Auditor.

getApprovalTransactionsById(id: string)

Parámetros:

id: string: ID generado por el sistema de la transacción de aprobación.

Ejemplo de valor devuelto:

{
    "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

Nombre del método original: getApprovalsByOperationId

Este método devuelve el historial de todas las aprobaciones asociadas a un ID de operación especificado. Este método solo se puede llamar mediante Token Admin o Token Auditor.

getApprovalsByOperationId(operation_id: string)

Parámetros:

operation_id: string: ID de operación único de la solicitud de aprobación.

Ejemplo de valor devuelto:

{
    "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

Nombre del método original: getApprovalsByApprover

Este método devuelve el historial de todas las aprobaciones completadas por un usuario especificado. Este método solo puede ser llamado por un Token Admin, Token Auditor, Org Admin, Org Auditor o cualquier propietario de cuenta.

getApprovalsByApprover(org_id: string, user_id: string)

Parámetros:

org_id: ID del proveedor de servicios de membresía (MSP) del usuario.
user_id: nombre de usuario o ID de correo electrónico del usuario.

Ejemplo de valor devuelto:

{
    "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"
    }
}

Métodos de restricción de transferencia

Puede utilizar restricciones de transferencia para controlar los importes de transacción mínimo y máximo permitidos para las transferencias de token. Las restricciones de transferencia se aplican cuando una cuenta tiene el valor restrictionFlag definido en true. Las restricciones de transferencia funcionan independientemente de las reglas de política de aprobación utilizadas para las operaciones de retención. El activo TransferRestriction definido en el archivo de especificación define los límites de transferencia globales inferior y superior que se aplican a todas las cuentas en las que están activadas las restricciones de transferencia. Después de desplegar el código de cadena, los administradores pueden recuperar o actualizar estos valores mediante los siguientes métodos.

getTransferRestriction

Nombre del método original: getTransferRestriction

Este método devuelve la configuración de restricción de transferencia actual, incluidos los límites de transacción inferior y superior. Este método solo se puede llamar mediante Token Admin o Token Auditor.

getTransferRestriction()

Parámetros:

ninguno

Ejemplo de valor devuelto:

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

updateTransferRestriction

Nombre del método original: updateTransferRestriction

Este método actualiza la configuración de restricción de transferencia mediante la definición de nuevos límites de transacción superior e inferior. Este método solo se puede llamar mediante Token Admin.

updateTransferRestriction(transactionLowerLimit: number, transactionUpperLimit: number)

Parámetros:

transactionLowerLimit: importe mínimo de transferencia permitido.
transactionUpperLimit: importe máximo de transferencia permitido que se puede procesar sin una gobernanza especial.

Ejemplo de valor devuelto:

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

Métodos personalizados

getApproverDetailsByTransferAmount

Este método obtiene los detalles del aprobador que son necesarios para un importe de transferencia determinado. Este método solo se puede llamar mediante Token Admin o Token Auditor.

getApproverDetailsByTransferAmount(Amount: number)

Parámetros:

amount: number: importe de la transferencia.

Ejemplo de valor devuelto:

{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "5874105c14abd67e68cb4dacf82f2a2dca6cc9da4f5b27fcc91c83a60b7249e1",
        "payload": {
            "approverDetails": [
                {
                    "approverOrgId": "CentralBank",
                    "approverUserId": "manager",
                    "approvalSequence": 1
                },
                {
                    "approverOrgId": "CentralBank",
                    "approverUserId": "creator",
                    "approvalSequence": 2
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "centralbank-oabcs1-nrt.blockchain.ocp.example.com:20010",
        "blockNumber": 292
    }
}

approveTransaction

Un aprobador puede utilizar este método para aprobar una transacción de retención.

approveTransaction(token_id: string, operation_id: string, quantity: number)

Parámetros:

token_id: string: ID del token.
operation_id: string: ID único para identificar la operación de retención. Normalmente, la aplicación cliente transfiere este ID.
quantity: number: número de tokens retenidos que aprobar para la transferencia.

Ejemplo de valor devuelto:

{
    "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"
    }
}