otxn_param

Comportamiento

C

• Busca el valor de un parámetro nombrado especificado en read_ptr dentro de la transacción origen.
• Escribe el valor del parámetro en write_ptr

JavaScript

• Busca el valor de un parámetro nombrado en la transacción origen.
• Devuelve el valor del parámetro especificado, o un ErrorCode si falla la búsqueda.

Definición

C

int64_t otxn_param (
    uint32_t write_ptr,
    uint32_t write_len,
    uint32_t read_ptr,
    uint32_t read_len
);

JavaScript

function otxn_param(name: ByteArray | HexString): ErrorCode | ByteArray

Ejemplo

C

uint8_t pname[] = {0xCAU, 0xFEU};
uint8_t pvalue[32];
int64_t value_len =
    otxn_param(pvalue, 32, pname, 2);

JavaScript

const pname = [0xCA, 0xFE]
const pvalue = otxn_param(pname)

Parámetros

C

Nombre	Tipo	Descripción
write_ptr	uint32_t	Puntero a un buffer adecuado para almacenar la salida (mínimo 32 bytes)
write_len	uint32_t	Longitud del buffer de salida
read_ptr	uint32_t	Puntero a un buffer que contiene el nombre del parámetro
read_len	uint32_t	Longitud del nombre del parámetro

JavaScript

Nombre	Tipo	Descripción
name	ByteArray | HexString	Nombre del parámetro a buscar, como ByteArray o cadena

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 DOESNT_EXIST - el parámetro no existe o es nulo TOO_SMALL - el nombre es nulo TOO_BIG - el nombre supera 32 bytes

JavaScript

Tipo	Descripción
ErrorCode | ByteArray	Devuelve el valor del parámetro o un ErrorCode si falla