util_raddr

Comportamiento

C

• Lee un Account ID de 20 bytes desde read_ptr
• Escribe la dirección r equivalente para ese Account ID en write_ptr

JavaScript

• Lee un Account ID de 20 bytes desde accountid
• Devuelve la dirección r equivalente para ese Account ID

Definición

C

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

JavaScript

function util_raddr(accountid: ByteArray | HexString): ErrorCode | string

Ejemplo

C

uint8_t raddr_out[40];
uint8_t acc_id[20] =
{
    0x2dU, 0xd8U, 0xaaU, 0xdbU, 0x4eU, 0x15U,
    0xebU, 0xeaU,  0x0eU, 0xfdU, 0x78U, 0xd1U, 0xb0U,
    0x35U, 0x91U,  0x04U, 0x7bU, 0xfaU, 0x1eU,  0x0eU
};
int64_t bytes_written =
    util_raddr(raddr_out, sizeof(raddr_out), acc_id, 20);

JavaScript

const raddr = util_raddr('8D329C03074A98EF0488AB6ABBF5883F68CCFD4E')
// o
const raddr = util_raddr([
    0x8D, 0x32, 0x9C, 0x03, 0x07, 0x4A, 0x98, 0xEF, 0x04, 0x88,
    0xAB, 0x6A, 0xBB, 0xF5, 0x88, 0x3F, 0x68, 0xCC, 0xFD, 0x4E
])

Parámetros

C

Nombre	Tipo	Descripción
write_ptr	uint32_t	Puntero a un buffer de tamaño suficiente para almacenar la dirección r. Se recomiendan al menos 35 bytes.
write_len	uint32_t	Longitud del buffer de salida.
read_ptr	uint32_t	Puntero al Account ID.
read_len	uint32_t	Longitud de la entrada. Siempre 20.

JavaScript

Nombre	Tipo	Descripción
accountid	number[] / string	El Account ID en HEX que se convertirá a dirección r. Puede proporcionarse como array de números o como string.

Código de retorno

C

Tipo	Descripción
int64_t	Número de bytes escritos (longitud de la dirección r generada). Si es negativo, indica error: OUT_OF_BOUNDS - punteros/longitudes fuera de la memoria del hook. INVALID_ARGUMENT - read_len no era 20. TOO_SMALL - write_len no era suficiente para almacenar la dirección r.

JavaScript

Tipo	Descripción
string / number	Devuelve un ErrorCode si hay error, o la dirección r como string