rollback

Conceptos

Introducción Metadatos de ejecución

Comportamiento

Finaliza la ejecución del hook con estado: rechazo.

• Registra una cadena de retorno y un código de retorno en los metadatos de la transacción.
• Descarta todos los cambios de estado.
• Descarta todas las transacciones emit().
• Impide que la transacción originaria continúe.

Precaución

La transacción originaria fallará con tecHOOK_REJECTED y se cobrará una comisión. Ver: orden de ejecución.

Definición

C

int64_t rollback (
    uint32_t read_ptr,
    uint32_t read_len,
    uint64_t error_code
);

JavaScript

function rollback(error_msg: string, error_code: number): number

Ejemplo

C

rollback("¡Rechazado!", 9, 100);

JavaScript

rollback('¡Rechazado!', 100)

Parámetros

C

Nombre	Tipo	Descripción
read_ptr	uint32_t	Puntero a una cadena de retorno que se almacenará en los metadatos de ejecución. Puede ser cualquier texto definido por el desarrollador. Puede ser nulo.
read_len	uint32_t	Longitud de la cadena de retorno. Máximo 32. Puede ser nulo.
error_code	uint64_t	Código de retorno específico del hook que se almacenará en los metadatos. Similar al código de salida de una aplicación en sistemas *nix. Por convención, los errores son valores distintos de cero.

JavaScript

Nombre	Tipo	Descripción
error_msg	string	Cadena que se almacenará en los metadatos de ejecución. Puede ser cualquier texto definido por el desarrollador. Puede ser nulo.
error_code	number	Código de retorno específico del hook que se almacenará en los metadatos. Similar al código de salida de una aplicación en sistemas *nix. Por convención, los errores son valores distintos de cero.

Código de retorno

C

Tipo	Descripción
int64_t	Rollback finaliza el hook, por lo que no devuelve valor al llamador. Por convención todas las APIs devuelven int64_t, pero en este caso no se retorna nada.

JavaScript

Tipo	Descripción
number	Rollback finaliza el hook, por lo que no devuelve valor al llamador. Por convención todas las APIs devuelven number, pero en este caso no se retorna nada.