etxn_details

Concepts

Emitted Transactions

Behaviour

C

• Generate and write a 105 byte sfEmitDetails object into the write_ptr if cbak is not defined
• Generate and write a 127 byte sfEmitDetails object into the write_ptr if cbak is defined.

JavaScript

• This function provides detailed information about the transaction.
• Returns an ErrorCode if there is an error, or an array of transaction details on success.

Definition

C

int64_t etxn_details (
    uint32_t write_ptr,
    uint32_t write_len
);

JavaScript

function etxn_details(): ErrorCode | ByteArray

Example

C

uint8_t emitdet[105];
int64_t result =
    etxn_details(emitdet, 105);
if (result != 105)
    rollback("Etxndetails failed.", 19, 1);

JavaScript

const emitdet = etxn_details()
if (typeof emitdet === 'string || emitdet.length != 105)
    rollback("Etxndetails failed.", 1)

Parameters

C

Name	Type	Description
write_ptr	uint32_t	Pointer to the buffer receiving the sfEmitDetails record
write_len	uint32_t	Length of the buffer

JavaScript

No parameters for JavaScript

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 - Buffer isn’t large enough to receive record PREREQUISITE_NOT_MET - The hook failed to call etxn_reserve(n) first FEE_TOO_LARGE - The burden would be too high for the network to allow. INTERNAL_ERROR - A generic error in which rippled had trouble generating the required field.

JavaScript

Type	Description
ErrorCode	ByteArray