otxn_id

Behaviour

C

• Write the canonical hash of the originating transaction to the output buffer.
• If flags = 1 and the transaction is an EMIT_FAILURE transaction then write the canonical hash of the originating transaction that caused the emission.

JavaScript

• Output the canonical hash of the originating transaction.
• Returns the transaction hash as an array of numbers, or an ErrorCode if the retrieval fails.

Definition

C

int64_t otxn_id (
    uint32_t write_ptr,
    uint32_t write_len,
    uint32_t flags
);

JavaScript

function otxn_id(flag: number): ErrorCode | ByteArray

Example

C

uint8_t txn_id[32];
int64_t bytes_written =
    otxn_id(txn_id, 32, 0);

JavaScript

const tx_id = otxn_id(0)

Parameters

C

Name	Type	Description
write_ptr	uint32_t	Pointer to a buffer of to store the hash.
write_len	uint32_t	Length of the output buffer. Should be at least 32 bytes.
flags	uint32_t	If 0: Write the canonical hash of the originating transaction. If 1 AND the originating transaction is an EMIT_FAILURE: Write the canonical hash of the emitting transaction.

JavaScript

Name	Type	Description
flags	number	If 0: Write the canonical hash of the originating transaction. If 1 AND the originating transaction is an EMIT_FAILURE: Write the canonical hash of the emitting transaction.

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. TOO_SMALL - output buffer was not large enough to hold the serialized object

JavaScript

Type	Description
ErrorCode | ByteArray	Returns the transaction hash as an array of numbers, or an ErrorCode if the retrieval fails.