util_accid

Comportamento

C

• Lê um r-address a partir de read_ptr
• Escreve um Account ID de 20 bytes em write_ptr

JavaScript

• Lê um r-address a partir de raddress
• Retorna um Account ID de 20 bytes ou um ErrorCode

Definição

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

Exemplo

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);
// NB: if specified as a c-string as above, account for the nul char

JavaScript

const accId = util_accid('rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh')

Parâmetros

C

Nome	Tipo	Descrição
write_ptr	uint32_t	Ponteiro para um buffer de tamanho adequado para armazenar o Account ID de saída. Deve ter pelo menos 20 bytes.
write_len	uint32_t	Tamanho do buffer de saída.
read_ptr	uint32_t	Ponteiro para o r-address.
read_len	uint32_t	O tamanho do r-address.

JavaScript

Nome	Tipo	Descrição
raddress	string	O r-address a ser formatado como Account ID em HEX.

Código de Retorno

C

Tipo

Descrição

int64_t

O número de bytes escritos (o tamanho do r-address de saída). Se negativo, um erro: OUT_OF_BOUNDS - ponteiros/tamanhos especificados fora da memória do hook. INVALID_ARGUMENT - read_ptr apontava para algo que não era um r-address válido. TOO_SMALL - write_len não era grande o suficiente para armazenar o Account ID produzido. (Deve ser 20 bytes). TOO_BIG - read_len era maior do que um r-address pode ser.

JavaScript

Tipo	Descrição
string / number	Se houver um erro na formatação, caso contrário retorna o Account ID em HEX como um array de números.