Expand description
§ironclad-wallet
Ethereum wallet management for the Ironclad agent runtime. Provides HD wallet generation, on-chain balance tracking, x402 payment protocol (EIP-3009), treasury policy enforcement, and DeFi yield optimization.
§Key Types
WalletService– Top-level facade composing wallet, treasury, and yield engineWallet– HD wallet with key loading/generationTreasuryPolicy– Spending limits and survival-tier-aware capsYieldEngine– DeFi yield optimization (Aave/Compound on Base)X402Handler– x402 payment protocol handlerMoney– USDC amount type with formatting
§Modules
wallet– Wallet loading, generation, address, balancetreasury– Treasury policy engine with per-payment caps and reservesyield_engine– DeFi protocol integration for idle capitalx402– EIP-3009transferWithAuthorizationpayment flowmoney– USDC amount type and arithmetic
Re-exports§
pub use evm_submit::EvmContractCall;pub use evm_submit::get_evm_transaction_receipt_status;pub use evm_submit::submit_evm_contract_call;pub use money::Money;pub use treasury::TreasuryPolicy;pub use wallet::TokenBalance;pub use wallet::Wallet;pub use x402::PaymentRequirements;pub use x402::WalletPaymentHandler;pub use x402::X402Handler;pub use yield_engine::YieldEngine;
Modules§
- evm_
submit - money
- Fixed-point money type (cents) for treasury and financial logic.
- treasury
- wallet
- x402
- yield_
engine - Yield engine: Aave V3 supply/withdraw and aToken balance.
When
chain_rpc_urlis set, uses real Aave Pool on Base Sepolia; otherwise mock behavior for tests.