sto_validate

Conceitos

Objetos Serializados

Comportamento

C

• Analisa um STObject apontado por read_ptr
• Retorna 1 se a serialização for válida, 0 caso contrário.

JavaScript

• O blob (ex: transação serializada) é fornecido para ser validado.
• Retorna o número 1 se o STObject for válido, 0 se não for, ou um código de erro se a validação falhar.

Definição

C

int64_t sto_validate (
    uint32_t read_ptr,
    uint32_t read_len
);

JavaScript

function sto_validate(blob: ByteArray | HexString): ErrorCode | number

Exemplo

C

int64_t result =
  sto_validate(tx_out, sizeof(tx_out));

if (tx_len <= 0)
    rollback("Invalid STO.", 12, 1);

JavaScript

const result = sto_validate(tx_out)

if (result <= 0)
    rollback("Invalid STO.", 1)

Parâmetros

C

Nome	Tipo	Descrição
read_ptr	uint32_t	O buffer de onde o STObject de origem será lido
read_len	uint32_t	O tamanho do objeto de origem

JavaScript

Nome	Tipo	Descrição
blob	ByteArray | HexString	O blob (ex: transação serializada) a ser validado.

Código de Retorno

C

Tipo	Descrição
int64_t	1 se o STObject apontado por read_ptr for um STObject válido. 0 se não for. Se negativo, um erro: OUT_OF_BOUNDS - ponteiros/tamanhos especificados fora da memória do hook.

JavaScript

Tipo	Descrição
ErrorCode | number	Retorna o número 1 se o STObject for válido, 0 se não for, ou um código de erro se a validação falhar.