etxn_nonce

Generate a 32 byte nonce for use in an emitted transaction

Concepts

• Emitted Transactions

Behaviour

C

• Write the 32 byte Hash to the write_ptr

Javascript

• Returns an ErrorCode if there is an error, or an array containing the nonce value on success.

Definition

C

int64_t etxn_nonce (
    uint32_t write_ptr,
    uint32_t write_len
);

Javascript

function etxn_nonce(): ErrorCode | ByteArray

Example

C

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

Javascript

const nonce = etxn_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

No parameters

Return Code

C

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

Javascript

Type	Description
ErrorCode | ByteArray	Returns an ErrorCode if there is an error, or an array containing the nonce value on success.