Métodos de contrato de Stablecoin

El contrato de stablecoin incluye todos los métodos disponibles en el contrato ampliado ERC-20 y métodos 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 ERC-20 extendido y admite todos los métodos genéricos para ese estándar. Para obtener más información sobre los métodos genéricos ERC-20, consulte API de activos digitales.

Nota:

En el contrato 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

createOrupdateAccountPolicy

Este método crea o actualiza 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.

function createOrupdateAccountPolicy(
      AccountPolicyCheck calldata accountPolicyCheck
  ) external

Parámetros:

• asset: AccountPolicyCheck struct: estructura que define los parámetros de política de cuentas, que incluye los siguientes campos:
  • accountPolicyId: utilice el método getAccountPolicyIdForAddress() para generar este ID a partir de la dirección de cuenta 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 del bloque de restricción de transferencia y las transferencias retenidas siguen el umbral de política de aprobación más bajo.

getAccountPolicyById

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

function getAccountPolicyById(
        string calldata accountPolicyId
    ) external view 

Parámetros:

• accountPolicyId: string: ID de política de cuenta único.

deleteAccountPolicy

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.

function deleteAccountPolicy(string calldata accountPolicyId) public 

Parámetros:

• accountPolicyId: string: ID de política de cuenta único.

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

createOrupdateApprovalPolicy

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

function createOrupdateApprovalPolicy(
        ApprovalPolicyCheck calldata approvalPolicyCheck
    ) external

Parámetros:

• asset: ApprovalPolicyCheck struct: estructura que define las 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.

getApprovalPolicyById

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.

function getApprovalPolicyById(
        string calldata approvalPolicyId
    ) external

Parámetros:

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

deleteApprovalPolicy

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.

function deleteApprovalPolicy(string calldata approvalPolicyId) public

Parámetros:

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

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.

function getApprovalTransactionsById(
        string calldata opId
    )

Parámetros:

• opId: string: ID de transacción de aprobación.

getApprovalStatusByOperationId

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.

function getApprovalStatusByOperationId(
        string calldata opId
    )

Parámetros:

• opId: string: ID de operación único.

approveTransaction

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

function approveTransaction(string calldata opId, uint256 amount) public

Parámetros:

• opId: string: ID de operación único.
• amount: uint256: número de tokens retenidos que aprobar para la transferencia.

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 define los límites de transferencia superiores e inferiores globales que se aplican a todas las cuentas en las que están activadas las restricciones de transferencia. Después de desplegar el contrato, los administradores pueden recuperar o actualizar estos valores mediante los siguientes métodos.

setOrupdateTransferRestriction

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

 function setOrupdateTransferRestriction(
        uint256 transactionLowerLimit,
        uint256 transactionUpperLimit
    ) external

Parámetros:

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

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.

function getTransferRestriction() external

Parámetros:

• ninguno