ledger_nonce

Behaviour

C

• Write a 32 byte random value to the write_ptr

JavaScript

• Retrieves the nonce of the current ledger.

Definition

C

C

int64_t ledger_nonce (
    uint32_t write_ptr,
    uint32_t write_len
);

JavaScript

function ledger_nonce(): ErrorCode | ByteArray

Example

C

uint8_t n[32];
int64_t bytes_written =
    ledger_nonce(n, 32);

JavaScript

const nonce = ledger_nonce()

Parameters

C

Name	Type	Description
write_ptr	uint32_t	Pointer to a buffer of a suitable size to store the output. Should be at least 32 bytes.
write_len	uint32_t	Length of the output buffer.

JavaScript

Return Code

C

Type	Description
ErrorCode | ByteArray	Returns an error code if an error occurs, or an array representing the nonce of the current ledger. specified outside of hook memory.

JavaScript

Type	Description
int64_t	The number of bytes written If negative, an error: OUT_OF_BOUNDS - pointers/lengths specified outside of hook memory.