rollback

Encerra a execução do hook com status: rejeição.

Registra uma string de retorno e um código de retorno nos metadados da transação.
Descarta todas as alterações de estado.
Descarta todas as transações emit().
Não permite que a transação de origem continue.

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

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

rollback("Rejeitado!", 9, 100);

rollback('Rejeitado!', 100)

Nome	Tipo	Descrição
read_ptr	uint32_t	Ponteiro para uma string de retorno a ser armazenada nos metadados de execução. Esta é qualquer string que o desenvolvedor do hook desejar retornar com a aceitação. Pode ser nulo.
read_len	uint32_t	O tamanho da string de retorno. No máximo 32. Pode ser nulo.
error_code	uint64_t	Um código de retorno específico deste hook a ser armazenado nos metadados de execução. Semelhante ao código de retorno de uma aplicação em um sistema *nix. Por convenção, valores diferentes de zero indicam falha.

Nome	Tipo	Descrição
error_msg	string	String a ser armazenada nos metadados de execução. Esta é qualquer string que o desenvolvedor do hook desejar retornar com a aceitação. Pode ser nulo.
error_code	number	Um código de retorno específico deste hook a ser armazenado nos metadados de execução. Semelhante ao código de retorno de uma aplicação em um sistema *nix. Por convenção, valores diferentes de zero indicam falha.

Tipo	Descrição
int64_t	Rollback encerra o hook, portanto nenhum valor é retornado ao chamador. Por convenção, todas as APIs de Hook retornam `int64_t`, mas neste caso nada é retornado.

Tipo	Descrição
number	Rollback encerra o hook, portanto nenhum valor é retornado ao chamador. Por convenção, todas as APIs de Hook retornam `number`, mas neste caso nada é retornado.