Struct AccountTransfers

pub struct AccountTransfers {
    pub publication_id: Uuid,
    pub publication_datetime: DateTime<Utc>,
    pub account_address: Address,
    pub transaction_hash: Hash,
    pub transaction_index: u64,
    pub contract_address: Address,
    pub function_id: [u8; 4],
    pub block_number: BlockNumber,
    pub block_datetime: DateTime<Utc>,
    pub transfers: Vec<AccountTransfer>,
}

Represents token transfers (debits and credits) associated with a specific Ethereum account within a single transaction.

The account_address field identifies the primary account involved in these transfers.

An event will be generated for each account involved in a transaction, meaning if a transaction is not the primary in this event, in another event it will treated as the primary and credit and debit operations adjusted accordingly.

A single event can contain multiple token transfers (e.g., a customer is debited for a card payment but receives a credit as cashback)

Fields

publication_id: Uuid

ID of the event publication.

If the event is republished, a new ID will be generated for the publication.

Format: UUID v7 (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

publication_datetime: DateTime<Utc>

Datetime of the event publication.

Format: ISO 8601

account_address: Address

Address of the account that is part of all transfers. Also referenced as primary account address.

Format: Prefixed account address - 20 bytes - 0x1234567890123456789012345678901234567890

transaction_hash: Hash

Hash of the Ethereum transaction that originated transfers.

Format: Prefixed transaction hash - 32 bytes - 0x1234567890123456789012345678901234567890123456789012345678901234

transaction_index: u64

Index of the transaction in the block where it was generated.

Used for ordering multiple events from the same user that happened in the same block.

Format: Integer in base 10 - Range: 0 to u64::MAX

contract_address: Address

Address of the contract that originated transfers.

Format: Prefixed account address - 20 bytes - 0x1234567890123456789012345678901234567890

function_id: [u8; 4]

Identifier of the Ethereum function that originated transfers.

Format: Prefixed function signature - 4 bytes - 0x12345678

block_number: BlockNumber

Number of the block that originated transfers.

Format: Integer in base 10 - Range: 0 to u64::MAX

block_datetime: DateTime<Utc>

Datetime of the Ethereum block that originated transfers.

Format: ISO 8601

transfers: Vec<AccountTransfer>

List of transfers the account_address is part of.

Implementations

impl AccountTransfers

pub fn idempotency_key(&self) -> String

Idempotency key of the event payload.

It is unique for each distinct event, but consistent across retries or republications of the same event payload.

Format: String - transaction_hash::account_address - 0x1234567890123456789012345678901234567890123456789012345678901234::0x1234567890123456789012345678901234567890

Trait Implementations

impl Debug for AccountTransfers

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

Formats the value using the given formatter.

impl Event for AccountTransfers

fn event_key(&self) -> Result<String>

Returns the partition key component of the event.

fn event_headers(&self) -> Result<HashMap<String, String>>

Returns the headers component of the event.

fn event_payload(&self) -> Result<String>

Returns the payload component of the event.

impl Serialize for AccountTransfers

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.