state_set

Comportamento

C

• Lê uma chave do Estado do Hook de 32 bytes a partir de kread_ptr
• Lê uma quantidade arbitrária de dados a partir de read_ptr (o valor)
• Atualiza a chave do Estado do Hook com o valor

JavaScript

• Define o Estado do Hook com o valor e chave especificados.
• Retorna o número de bytes escritos no Estado do Hook (o tamanho dos dados), negativo em caso de erro.

Definição

C

int64_t state_set (
    uint32_t read_ptr,
    uint32_t read_len,
    uint32_t kread_ptr,
    uint32_t kread_len
);

JavaScript

function state_set(
    value: ByteArray | HexString | undefined | null,
    key: ByteArray | HexString
  ): ErrorCode | number

Exemplo

C

#define SBUF(str) (uint32_t)(str), sizeof(str)
if (state_set(SBUF(vault), SBUF(vault_key)) < 0)
    rollback(SBUF("Error: could not set state!"), 1);

Dica

Para excluir o estado, use state_set(0, 0, SBUF(key);.

JavaScript

const result = state_set(vault, vault_key)
if (result < 0)
    rollback("Error: could not set state!", 1);

Dica

Para excluir o estado, use state_set(null, key);.

Parâmetros

C

Nome	Tipo	Descrição
read_ptr	uint32_t	Ponteiro para os dados (valor) a serem escritos no Estado do Hook. Se for 0 (nulo), então os dados nessa chave são excluídos. Pode ser nulo.
read_len	uint32_t	O tamanho dos dados. Se for 0 (nulo), então os dados nessa chave são excluídos. Pode ser nulo.
kread_ptr	uint32_t	Um ponteiro para a chave do Estado do Hook na qual armazenar o valor.
kread_len	uint32_t	O tamanho da chave. (Deve ser sempre 32.)

Cuidado

O Xahaud define internamente um tamanho máximo de dados do hook. No momento em que este texto foi escrito, e para a mainnet, esse valor está fixado em 256 bytes; no entanto, no futuro será um número votável pelos validadores.

JavaScript

Nome	Tipo	Descrição
value	ByteArray or HexString	O valor dos dados a persistir.
key	ByteArray or HexString	A chave do Estado do Hook para a qual definir o valor.

Código de Retorno

C

Tipo	Descrição
int64_t	O número de bytes escritos no Estado do Hook (o tamanho dos dados.) Se negativo, um erro: OUT_OF_BOUNDS - ponteiros/tamanhos especificados fora da memória do hook. TOO_BIG - kread_len era maior que 32, ou - read_len era maior que o tamanho máximo de dados do hook. TOO_SMALL - kread_len era 0.

JavaScript

Tipo	Descrição
number or ErrorCode	Retorna o número de bytes escritos no Estado do Hook (o tamanho dos dados), negativo em caso de erro.