util_accid

Comportamiento

C

• Lee una r-address desde read_ptr
• Escribe un Account ID de 20 bytes en write_ptr

JavaScript

• Lee una r-address desde raddress
• Devuelve un Account ID de 20 bytes o un ErrorCode

Definición

C

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

JavaScript

function util_accid(raddress: string): ErrorCode | ByteArray

Ejemplo

C

uint8_t accid_out[20];
uint8_t raddr_in[] = "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh";

int64_t bytes_written =
util_accid(accid_out, 20, raddr_in, sizeof(raddr_in)-1);
// Nota: si se especifica como string en C, tener en cuenta el carácter nulo

JavaScript

const accId = util_accid('rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh')

Parámetros

C

Nombre	Tipo	Descripción
write_ptr	uint32_t	Puntero a un buffer adecuado para almacenar el Account ID (mínimo 20 bytes)
write_len	uint32_t	Longitud del buffer de salida
read_ptr	uint32_t	Puntero a la r-address
read_len	uint32_t	Longitud de la r-address

JavaScript

Nombre	Tipo	Descripción
raddress	string	La r-address a convertir en Account ID en formato HEX

Código de retorno

C

Tipo	Descripción
int64_t	Número de bytes escritos (longitud del Account ID) Si es negativo, error: OUT_OF_BOUNDS - punteros fuera de la memoria del hook INVALID_ARGUMENT - read_ptr no apunta a una r-address válida TOO_SMALL - el buffer es insuficiente (debe ser 20 bytes) TOO_BIG - read_len es demasiado grande

JavaScript

Tipo	Descripción
string / number	Devuelve error si falla, o el Account ID en HEX como array de números