state_foreign_set

Comportamiento

C

• Lee una clave de Hook State de 32 bytes desde kread_ptr
• Lee una cantidad arbitraria de datos desde read_ptr (el valor)
• Lee un namespace de 32 bytes desde nread_ptr
• Lee un Account ID de 20 bytes desde aread_ptr
• Actualiza la clave de Hook State en la cuenta especificada dentro del namespace indicado con el valor dado
• Pero solo si un Grant en esa cuenta lo permite
• Si la cuenta del Hook se especifica en aread_ptr, el comportamiento será el de state_set, pero permitiendo aún especificar el namespace mediante nread_ptr

JavaScript

• Establece el Hook State externo con el valor, clave, namespace y Account ID especificados
• Esta operación requiere autorización y un Grant que permita esta acción
• Devuelve el número de bytes escritos en el Hook State (la longitud de los datos), negativo en caso de error

Definición

C

int64_t state_foreign_set (
    uint32_t read_ptr,
    uint32_t read_len,
    uint32_t kread_ptr,
    uint32_t kread_len,
    uint32_t nread_ptr,
    uint32_t nread_len,
    uint32_t aread_ptr,
    uint32_t aread_len
);

JavaScript

function state_foreign_set(
    value: ByteArray | HexString | undefined | null,
    key: ByteArray | HexString,
    namespace: ByteArray | HexString | undefined | null,
    accountid: ByteArray | HexString | undefined | null
  ): ErrorCode | number

Ejemplo

C

#define SBUF(str) (uint32_t)(str), sizeof(str)
if (state_foreign_set(SBUF(vault), SBUF(vault_key), SBUF(namespace), SBUF(account)) < 0)
    rollback(SBUF("Error: no se pudo establecer el estado externo!"), 1);

JavaScript

if (state_foreign_set(vault, vault_key, namespace, account) < 0)
    rollback("Error: no se pudo establecer el estado externo!", 1);

Parámetros

C

Nombre	Tipo	Descripción
read_ptr	uint32_t	Puntero a los datos (valor) a escribir en el Hook State. Si es 0 (null), se elimina el dato en esa clave. Puede ser null.
read_len	uint32_t	Longitud de los datos. Si es 0 (null), se elimina el dato en esa clave. Puede ser null.
kread_ptr	uint32_t	Puntero a la clave de Hook State donde se almacenará el valor
kread_len	uint32_t	Longitud de la clave (debe ser siempre 32)
nread_ptr	uint32_t	Puntero al namespace al que pertenece la clave
nread_len	uint32_t	Longitud del namespace (debe ser siempre 32)
aread_ptr	uint32_t	Puntero al Account ID cuyo estado se desea modificar
aread_len	uint32_t	Longitud del Account ID (debe ser siempre 20)

Precaución

Xahau establece internamente un tamaño máximo de datos para Hooks. En el momento de escribir esto y en la testnet pública, está fijado en 128 bytes, aunque en el futuro será un valor votable por los validadores.

JavaScript

Nombre	Tipo	Descripción
value	ByteArray o HexString	El valor de los datos a almacenar
key	ByteArray o HexString	La clave del Hook State donde guardar el valor
namespace	ByteArray o HexString	El namespace del Hook
accountid	ByteArray o HexString	El propietario del estado

Código de retorno

C

Tipo

Descripción

int64_t

Número de bytes escritos en el Hook State (longitud de los datos) Si es negativo, error: OUT_OF_BOUNDS - punteros fuera de la memoria del hook TOO_BIG - kread_len mayor que 32 o - read_len mayor que el tamaño máximo permitido TOO_SMALL - kread_len es 0 NOT_AUTHORIZED - no existe un HookGrant válido en la cuenta externa PREVIOUS_FAILURE_PREVENTS_RETRY - una llamada previa falló con NOT_AUTHORIZED y no se permite reintentar

JavaScript

Tipo	Descripción
number o ErrorCode	Devuelve el número de bytes escritos o un error (negativo en caso de fallo)