ledger_keylet

Comportamento

C

• Lê um Keylet de 34 bytes a partir de lread_ptr
• Lê um Keylet de 32 bytes a partir de hread_ptr
• Busca no ledger pelo primeiro (menor) Keylet deste tipo neste intervalo.
• Se algum Keylet correspondente for encontrado, escreve-o em write_ptr.

JavaScript

• Esta função busca no ledger pelo primeiro (menor) Keylet deste tipo no intervalo fornecido.
• Retorna o número de bytes escritos (34 bytes) em caso de sucesso, ou um código de erro se ocorrer um erro.

Definição

C

C

int64_t ledger_keylet (
    uint32_t write_ptr,
    uint32_t write_len,
    uint32_t lread_ptr,
    uint32_t lread_len,
    uint32_t hread_ptr,
    uint32_t hread_len
);

JavaScript

function ledger_keylet(
    low: ByteArray | HexString,
    high: ByteArray | HexString
  ): ErrorCode | ByteArray

Exemplo

C

C

//TODO

JavaScript

ledger_keylet(low, high)

Parâmetros

C

Nome	Tipo	Descrição
write_ptr	uint32_t	Ponteiro para um buffer para armazenar o Keylet serializado de saída. .
write_len	uint32_t	Tamanho do buffer de saída. Deve ser 34 bytes
lread_ptr	uint32_t	Ponteiro para o Keylet serializado de 34 bytes que representa o limite inferior do intervalo de Keylets a ser buscado.
lread_len	uint32_t	Sempre 34 bytes
hread_ptr	uint32_t	Ponteiro para o Keylet serializado de 34 bytes que representa o limite superior do intervalo de Keylets a ser buscado.
hread_len	uint32_t	Sempre 34 bytes

JavaScript

Nome	Tipo	Descrição
low	ByteArray | HexString	Ponteiro para o Keylet serializado de 34 bytes que representa o limite inferior do intervalo de Keylets a ser buscado.
high	ByteArray | HexString	Ponteiro para o Keylet serializado de 34 bytes que representa o limite superior do intervalo de Keylets a ser buscado.

Código de Retorno

C

Tipo

Descrição

int64_t

O número de bytes escritos (34 bytes) em caso de sucesso. Se negativo, um erro: OUT_OF_BOUNDS - ponteiros/tamanhos especificados fora da memória do hook. TOO_SMALL / TOO_BIG - write_len, lread_len ou hread_len não era 34 bytes INVALID_ARGUMENT - Um ou mais dos Keylets fornecidos não era um Keylet serializado válido DOES_NOT_MATCH - Os dois Keylets fornecidos não eram do mesmo Tipo de Keylet. DOESNT_EXIST - Nenhum Keylet correspondente foi encontrado no intervalo especificado.

JavaScript

Tipo	Descrição
ErrorCode | ByteArray	Retorna o número de bytes escritos (34 bytes) em caso de sucesso, ou um código de erro se ocorrer um erro.