state

Comportamiento

C

• Lee una clave de Hook State de 32 bytes desde kread_ptr
• Escribe los datos (valor) asociados a esa clave en el buffer apuntado por write_ptr

JavaScript

• Recupera el valor del Hook State asociado a la clave especificada
• Devuelve un código de error o el valor del Hook State para la clave

Definición

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

Ejemplo

C

#define SBUF(str) (uint32_t)(str), sizeof(str)
if (state(SBUF(vault), SBUF(vault_key)) != 16)
    rollback(SBUF("Error: no se pudo leer el estado!"), 1);

JavaScript

const value = state(SBUF(vault), SBUF(vault_key))
if (typeof value === 'number' || value.length != 16)
    rollback("Error: no se pudo leer el estado!", 1);

Parámetros

C

Nombre	Tipo	Descripción
write_ptr	uint32_t	Puntero al buffer donde escribir los datos del Hook State
write_len	uint32_t	Longitud del buffer de escritura
kread_ptr	uint32_t	Puntero a un buffer que contiene la clave del Hook State
kread_len	uint32_t	Longitud de la clave del Hook State (debe ser 32)

Consejo

Asegúrate de comprobar el valor de retorno. Una consulta de estado puede fallar por varias razones y el buffer contendrá lo que tuviera antes de la llamada (normalmente ceros).

JavaScript

Nombre	Tipo	Descripción
key	ByteArray o HexString	La clave del Hook State de la que obtener el valor

Código de retorno

C

Tipo	Descripción
int64_t	Número de bytes escritos en el buffer de salida Si es negativo, error: OUT_OF_BOUNDS - punteros fuera de la memoria del hook DOESNT_EXIST - la clave de Hook State no tiene valor asociado TOO_BIG - la clave supera los 32 bytes TOO_SMALL - el buffer es demasiado pequeño

JavaScript

Tipo	Descripción
ByteArray o ErrorCode	Devuelve un código de error o el valor del Hook State