ledger_keylet

Comportamiento

C

• Lee un Keylet de 34 bytes desde lread_ptr
• Lee un Keylet de 34 bytes desde hread_ptr
• Busca en el ledger el primer (más bajo) Keylet de este tipo dentro de ese rango
• Si se encuentra alguno, lo escribe en write_ptr

JavaScript

• Esta función busca en el ledger el primer (más bajo) Keylet de este tipo dentro del rango indicado.
• Devuelve el número de bytes escritos (34 bytes) en caso de éxito, o un código de error si ocurre un fallo.

Definición

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

Ejemplo

C

C

//TODO

JavaScript

ledger_keylet(low, high)

Parámetros

C

Nombre	Tipo	Descripción
write_ptr	uint32_t	Puntero a un buffer donde almacenar el Keylet serializado
write_len	uint32_t	Longitud del buffer de salida (debe ser 34 bytes)
lread_ptr	uint32_t	Puntero al Keylet serializado de 34 bytes que representa el límite inferior del rango
lread_len	uint32_t	Siempre 34 bytes
hread_ptr	uint32_t	Puntero al Keylet serializado de 34 bytes que representa el límite superior del rango
hread_len	uint32_t	Siempre 34 bytes

JavaScript

Nombre	Tipo	Descripción
low	ByteArray | HexString	Keylet serializado de 34 bytes que representa el límite inferior del rango
high	ByteArray | HexString	Keylet serializado de 34 bytes que representa el límite superior del rango

Código de retorno

C

Tipo	Descripción
int64_t	Número de bytes escritos (34 bytes) en caso de éxito. Si es negativo, error: OUT_OF_BOUNDS - punteros fuera de la memoria del hook TOO_SMALL / TOO_BIG - los tamaños no son 34 bytes INVALID_ARGUMENT - uno o más Keylets no son válidos DOES_NOT_MATCH - los Keylets no son del mismo tipo DOESNT_EXIST - no se encontró ningún Keylet en el rango

JavaScript

Tipo	Descripción
ErrorCode | ByteArray	Devuelve los 34 bytes del Keylet o un código de error si falla