state

Comportamento

C

• Lê uma chave do Estado do Hook de 32 bytes a partir de kread_ptr
• Escreve os dados (valor) dessa chave no buffer apontado por write_ptr

JavaScript

• Recupera o valor do Estado do Hook associado à chave especificada.
• Retorna um código de erro ou o valor do Estado do Hook para a chave.

Definição

C

int64_t state (
    uint32_t write_ptr,
    uint32_t write_len,
    uint32_t kread_ptr,
    uint32_t kread_len
);

JavaScript

function state(key: ByteArray | HexString): ErrorCode | ByteArray

Exemplo

C

#define SBUF(str) (uint32_t)(str), sizeof(str)
if (state(SBUF(vault), SBUF(vault_key)) != 16)
    rollback(SBUF("Error: could not read state!"), 1);

JavaScript

const value = state(SBUF(vault), SBUF(vault_key))
if (typeof value === 'number' || value.length != 16)
    rollback("Error: could not read state!", 1);

Parâmetros

C

Nome	Tipo	Descrição
write_ptr	uint32_t	Um ponteiro para o buffer no qual escrever os dados do Estado do Hook.
write_len	uint32_t	O tamanho do buffer de escrita.
kread_ptr	uint32_t	Ponteiro para um buffer contendo a chave do Estado do Hook.
kread_len	uint32_t	O tamanho da chave do Estado do Hook. (Deve ser 32.)

Dica

Certifique-se de verificar o valor de retorno. Uma busca de estado pode falhar por uma série de motivos, e o buffer então conterá o que continha antes da chamada (normalmente tudo zeros).

JavaScript

Nome	Tipo	Descrição
key	ByteArray or HexString	A chave do Estado do Hook da qual recuperar o valor.

Código de Retorno

C

Tipo

Descrição

int64_t

O número de bytes escritos no buffer de escrita. Se negativo, um erro: OUT_OF_BOUNDS - ponteiros/tamanhos especificados fora da memória do hook. DOESNT_EXIST - a chave do Estado do Hook especificada não possui um valor associado no ledger no momento da chamada. TOO_BIG - a chave especificada por read_ptr e read_len era maior que 32 bytes. TOO_SMALL - o buffer de saída era muito pequeno para armazenar os dados do Estado do Hook.

JavaScript

Tipo	Descrição
ByteArray or ErrorCode	Retorna um código de erro ou o valor do Estado do Hook para a chave.