PendingVaultFlow

Documentation for eth_defi.vault.flow_events.PendingVaultFlow Python class.

class PendingVaultFlow

Bases: object

An indexed asynchronous vault request event.

This object is the protocol-neutral bridge between event discovery and higher-level accounting recovery. It intentionally carries both the raw request facts and a serialised ticket payload that can be fed back to the protocol-specific vault ticket reconstruction path.

Parameters
  • chain_id – EVM chain id where the event was emitted.

  • vault_address – Vault contract that emitted the request event.

  • owner – Economic owner of the request.

  • controller – ERC-7540 controller address where applicable. Protocols without a separate controller use the owner address.

  • direction – Deposit or redemption request.

  • status – Status implied by the event. Request events are emitted before settlement, so this is normally pending; callers can query the current status with the reconstructed ticket.

  • request_id – Protocol request id, if any.

  • settlement_id – Protocol settlement id, if any.

  • raw_assets – Raw denomination token amount for deposits, when known.

  • raw_shares – Raw vault share amount for redemptions, when known.

  • request_tx_hash – Transaction hash that emitted the request event.

  • request_block_number – Block number that emitted the request event.

  • request_block_timestamp – Naive UTC timestamp for the request block, when provided by the event backend.

  • log_index – Log index for stable event identity.

  • ticket_data – Serialised protocol ticket data compatible with the manager’s reconstruct_*_ticket() methods.

Attributes summary

chain_id

vault_address

owner

controller

direction

status

request_id

settlement_id

raw_assets

raw_shares

request_tx_hash

request_block_number

request_block_timestamp

log_index

ticket_data

Methods summary

__init__(chain_id, vault_address, owner, ...)

__init__(chain_id, vault_address, owner, controller, direction, status, request_id, settlement_id, raw_assets, raw_shares, request_tx_hash, request_block_number, request_block_timestamp, log_index, ticket_data)
Parameters
Return type

None