otxn_field

Comportamiento

C

• Busca el campo sf especificado en la transacción origen
• Escribe la versión serializada del campo en el buffer de salida

JavaScript

• Obtiene el valor de un campo específico en la transacción origen.
• Devuelve el valor del campo como un array de números, o un ErrorCode si falla.

Definición

C

int64_t otxn_field (
    uint32_t write_ptr,
    uint32_t write_len,
    uint32_t field_id
);

JavaScript

function otxn_field(field_id: number): ErrorCode | ByteArray

Ejemplo

C

int64_t account_field_len =
    otxn_field(account_field, 20, sfAccount);

JavaScript

const account_field = otxn_field(sfAccount)

Parámetros

C

Nombre	Tipo	Descripción
write_ptr	uint32_t	Puntero a un buffer adecuado para almacenar la salida
write_len	uint32_t	Longitud del buffer de salida
field_id	uint32_t	Código sf del campo que se desea obtener. Para calcularlo manualmente: toma el type serializado y desplázalo a los 16 bits más altos de un uint32_t, luego coloca el field en los 16 bits más bajos. Ejemplo: sfEmitNonce → type=5, field=11 → 0x050BU

Importante

El código de campo no se escribe en el buffer de salida, solo el contenido (payload) del campo.

En el momento de escribir esto, en Hooks Public Testnet, los campos STI_ACCOUNT como sfAccount se devuelven sin el byte inicial de longitud variable.

JavaScript

Nombre	Tipo	Descripción
field_id	number	Devuelve el valor del campo especificado como un array de números, o un error si falla la búsqueda

Código de retorno

C

Tipo	Descripción
int64_t	Número de bytes escritos Si es negativo, error: OUT_OF_BOUNDS - punteros fuera de la memoria del hook TOO_SMALL - el buffer de salida es demasiado pequeño INVALID_FIELD - el field_id no es válido DOESNT_EXIST - el campo no existe en la transacción origen

JavaScript

Tipo	Descripción
ByteArray o ErrorCode	Devuelve el valor del campo como un array de números, o un ErrorCode si falla la búsqueda