Struct Currency 

#[repr(C)]
pub struct Currency(pub [u8; 20]);

Represents a currency code in the XRPL, which is a 20-byte identifier.

Currency codes in XRPL can be either:

• Standard currencies: 3-character ASCII codes (e.g., “USD”, “EUR”) stored in bytes 12-14
• Non-standard currencies: Full 20-byte hex values for custom tokens

Derived Traits

• Copy: Efficient for this 20-byte struct, enabling implicit copying
• PartialEq, Eq: Enable comparisons and use in hash-based collections
• Debug, Clone: Standard traits for development and consistency

Tuple Fields

0: [u8; 20]

Implementations

impl Currency

pub fn new(code: [u8; 20]) -> Self

Creates a new Currency from a 20-byte array.

pub fn as_bytes(&self) -> &[u8; 20]

Gets the raw bytes of the Currency.

Trait Implementations

impl Clone for Currency

fn clone(&self) -> Currency

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Currency

impl Debug for Currency

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Currency

impl FieldDecoder for Currency

FieldDecoder for XRPL currency codes: decodes a 20-byte buffer into a Currency, failing if the host wrote a different number of bytes.

type Buffer = [u8; 20]

The buffer a get_field caller allocates before invoking the host function. Each type picks its own size (an associated type, not a const, so this stays on stable Rust).

fn empty_buffer() -> Self::Buffer

Returns a zero-initialized buffer of this type’s Buffer size.

fn decode(buf: Self::Buffer, bytes_written: usize) -> Result<Self, DecodeError>

Decodes Self from the full Buffer (as written by the host, then zero-padded to the buffer’s size), given bytes_written — the number of bytes the host actually wrote.

impl From<[u8; 3]> for Currency

fn from(bytes: [u8; 3]) -> Self

Converts to this type from the input type.

impl From<[u8; 20]> for Currency

fn from(value: [u8; 20]) -> Self

Converts to this type from the input type.

impl FromLedger for Currency

impl PartialEq for Currency

fn eq(&self, other: &Currency) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Currency