Get the public key of the wallet.

Get account info from the blockchain. Args: pubkey: Public key of the account commitment: Optional commitment overrid

Calculate the associated token account address for a given owner and mint. This manually implements the ATA derivation without requiring the

Get or create a logger with the given name. Args: name: Logger name, typically __name__ level: Logging level Returns:

Wait for transaction confirmation and verify execution success. Confirms the transaction landed on-chain, then checks meta.err to ens

Get the latest blockhash. Returns: Recent blockhash as string

Get or create an IDL parser for the specified platform. Args: platform: Platform to get parser for verbose: Whether t

Get token balance for an account. Args: token_account: Token account address Returns: Token balance as integ

Close the client connection and stop the blockhash updater.

Get the global IDL manager instance. Returns: Global IDLManager instance

Decode a value based on its type definition.

Get the current state of a pump.fun bonding curve. Args: pool_address: Address of the bonding curve commitment: Optio

Get the program ID this parser monitors. Returns: Program ID for event filtering

Get list of platforms with IDL support. Returns: List of platforms that have IDL files configured

Acquire a token, waiting if the bucket is empty.

Get a nested value from the configuration using dot notation.

Decode a value based on its type definition.

Create platform implementation instances with IDL support. Args: platform: Platform to create implementations for cli

Get or create the AsyncClient instance. Returns: AsyncClient instance

Get the current state of a LetsBonk pool. Args: pool_address: Address of the pool state account Returns: Dic

Record a token detection event

Send a transaction with optional priority fee and compute unit limit. Args: instructions: List of instructions to includ

Decode account data using a specific account type from the IDL. Args: account_data: Raw account data bytes.

Derive the creator vault address. Args: creator: Creator address Returns: Creator vault address

Derive the pool/curve address for trading pair. Args: base_mint: Base token mint address quote_mint: Quote token mint

Derive the pool state address for a token pair. For LetsBonk, this derives the pool state PDA using base_mint and WSOL. Args:

Calculate the associated token account address for a given owner and mint. This manually implements the ATA derivation without requiring the

Calculate the associated token account address for a given owner and mint. This manually implements the ATA derivation without requiring the

Extract platform enum from configuration.

Convenience function to get platform implementations. Args: platform: Platform to get implementations for client: Solana RPC clie

Get list of supported listener types for a platform. Args: platform: Platform enum Returns: List of supported listener types

Count WebSocket/gRPC messages received by listener

Check if a platform is supported. Args: platform: Platform to check Returns: True if platform is registered,

Load and validate a bot configuration from a YAML file.

Convenience function to load an IDL parser. Args: idl_path: Path to the IDL JSON file verbose: Whether to print debug inform

Calculate minimum size in bytes for a type definition.

Calculate minimum size in bytes for a type definition.

Fetch transaction result from RPC. Args: signature: Transaction signature Returns: Transaction result dict o

Log trade information.

Calculate the priority fee based on the configuration. Args: accounts: List of accounts to consider for dynamic fee calc

Attempt to burn any remaining tokens and close the ATA. Skips if account doesn't exist or is already empty/closed. Args:

Create all implementations for a specific platform. Args: platform: Platform to create implementations for client: So

Decode account data using a specific account type from the IDL. Args: account_data: Raw account data bytes.

Execute trading operation. Args: token_info: Enhanced token information with platform support Returns: Trade

Get LetsBonk-specific additional accounts needed for trading. Args: token_info: Token information Returns: D

Calculate the associated token account address for a given owner and mint. This manually implements the ATA derivation without requiring the

Calculate profit/loss for the position. Args: current_price: Current price (uses exit_price if position is closed) Retur

Get the current state of a trading pool/curve. Args: pool_address: Address of the pool/curve Returns: Dictio

Get the pump.fun program ID this parser monitors. Returns: Pump.fun program ID

Get the Raydium LaunchLab program ID this parser monitors. Returns: Raydium LaunchLab program ID

Parse token creation from pump.fun instruction data using injected IDL parser. Args: instruction_data: Raw instruction data

Parse token creation from LetsBonk instruction data using injected IDL parser. Args: instruction_data: Raw instruction data

Send a raw RPC request with rate limiting, retry, and 429 handling. Args: body: JSON-RPC request body. max_retries: M

Register platform implementations. Args: platform: Platform enum value address_provider_class: AddressProvider implem

Check if a platform and listener type are compatible. Args: platform: Platform enum listener_type: Listener type string Retu

Create a CloseAccount instruction for the Token Program. Args: account: The account to close destination: Where to se

Create an InitializeAccount instruction for the Token Program. Args: account: The account to initialize mint: The tok

Decode user-defined types (structs and enums).

Decode user-defined types (structs and enums).

Derive the creator vault for a creator. Args: creator: Creator address Returns: Creator vault address

Generate a unique seed for WSOL account creation. Args: user: User's wallet address Returns: Unique seed str

Get compute unit override from configuration. Args: operation: "buy" or "sell" platform: Trading platform (unused - e

Get compute unit override from configuration. Args: operation: "buy" or "sell" platform: Trading platform (unused - e

Extracts the type name from a 'defined' type, handling old and new IDL formats.

Extracts the type name from a 'defined' type, handling old and new IDL formats.

Get the pool/curve address for price calculations using platform-agnostic method.

Handle a new token creation event.

Parse a CreateEvent payload (same on-chain layout for both create and create_v2).

Parse a CreateEvent payload (same on-chain layout for both create and create_v2).

Parse a CreateEvent payload (same on-chain layout for create and create_v2).

Print performance metrics for providers using a specific detection method

Create a WSOL account address using createAccountWithSeed pattern. Args: payer: The account that will pay for and own the new acc

Decode legacy Create instruction (Metaplex tokens) from instruction data.

Decode CreateV2 instruction (Token2022 tokens) from instruction data.

Decode event data using IDL event definitions. Args: event_data: Raw event data bytes (typically from base64 decoded log

Decode instruction data using IDL definitions.

Derive the associated bonding curve (ATA of bonding curve for the token). Args: mint: Token mint address bonding_curv

Derive the bonding curve v2 PDA for a token mint. Args: mint: Token mint address Returns: Bonding curve v2 a

Derive the creator fee vault PDA. This vault accumulates creator fees from trades. Args: creator: The pool creator's pub

Derive the fee config PDA. Returns: Fee config address

Derive the platform fee vault PDA. This vault accumulates platform fees from trades. Args: platform_config: The platform

Derive the quote vault address for a token pair. Args: base_mint: Base token mint address quote_mint: Quote token min

Derive user's associated token account address. Args: user: User's wallet address mint: Token mint address

Derive user's associated token account address. Args: user: User's wallet address mint: Token mint address

Derive the user volume accumulator PDA. Args: user: User address Returns: User volume accumulator address

Find the mayhem state PDA for a mint. Seeds: ["mayhem-state", mint] (note: hyphen, not underscore)

Find the mayhem token vault - this is an ATA for sol_vault. This is derived as an Associated Token Account with: - Owner: SOL_VAULT - Min

Safely extract account keys for an instruction from a versioned transaction. Handles both static account keys and loaded addresses from looku