Server health and configuration: chain id, RPC chain check, wallet address and balance, armed or read-only mode, API reachability, and the deployed contract addresses in use.

Discover LOOT tokens from the platform feed. Filters: new, bonding (pre-graduation), graduated, trending, rising, all. Optional search and sorting. Needs LOOT_API_URL.

One token's live on-chain state: name, supply, pool, spot price from the pool itself, FDV, and the game ledger state (zone, loot, pot). Chain reads only, no API needed.

Execution-time quote from the real router via eth_call: exact tick math, fees, and caps for the calling wallet. side buy takes amount_eth, side sell takes amount_tokens. A revert here means the trade would fail and the reason is reported.

A wallet's ETH balance, universal keys, welcome state, and (with token) its full game position: token balance, unopened boxes, loot, pending pot share, player record, and which key families are claimable right now. Chain reads only.

Season clock and the live daily prize board from the public tRPC lanes. Pass wallet for that wallet's season rank and daily standing. Pass day (YYYY-MM-DD) for a past day's final board. Needs LOOT_API_URL.

Buy a LOOT token with ETH through the deployed router. Quotes the exact trade first via eth_call and demands the quote minus slippage_bps (default 200). Fixed 5,000,000 gas, never estimated. Needs LOOT_AGENT_PRIVATE_KEY.

Sell a LOOT token for ETH through the deployed router. Takes amount_tokens (decimal) or percent of the wallet balance. Approves the router once if needed, quotes the exact sell, and refuses rather than send an unprotected floor. Fixed 5,000,000 gas. Needs LOOT_AGENT_PRIVATE_KEY. Selling burns the game position for the amount sold.

Claim every key family that is claimable right now for a token: universal drip, streak, token drip, graduation, knife, and referral keys. Simulates each claim first and only sends the ones that would pay. Fixed gas per family, granted counts read from the receipts. Needs LOOT_AGENT_PRIVATE_KEY.

Open loot boxes: spends one key of the chosen tier plus a slice of the unopened box pile now, waits for the pinned drand round, fetches the public beacon, and settles on-chain. Key source auto prefers a token-scoped key and falls back to a universal key. Reports the settled tier counts and loot minted. Needs LOOT_AGENT_PRIVATE_KEY.

Finish pending box opens: submitOpen is permissionless, so any wallet can settle any request once its drand round is published. Pass ids, or let it scan the newest requests on the ledger. Skips settled requests and rounds that are not published yet. Needs LOOT_AGENT_PRIVATE_KEY (to send; the opened loot always credits the requesting wallet).

Claim this wallet's pending pot share for a token from the ledger. Pays native ETH to the caller, any second, any size. The claimed amount is read from the receipt's Claimed event. Needs LOOT_AGENT_PRIVATE_KEY.

Claim everything this wallet can from the trader rails: recent closed daily prize boards (simulated first, only paying days are sent), the 12h rank drip, and any season promo keys. The v3 era cashback lane does not exist on v4. Needs LOOT_AGENT_PRIVATE_KEY.

Launch a new LOOT token through the factory ceremony. Pins metadata via the loot API, escrows 0.01 ETH plus any dev buy on-chain with submit, gets the signed launch ticket, then acts by policy: clean_only cancels if the draft matches a live protected root, tribute_ok accepts launching as a tribute copy, buyout pays the live on-chain quote up to max_buyout_wei (a hard budget) to take the name over. Any mismatch, ticket expiry or failure after submit auto-cancels for the 0.009 ETH refund plus the dev buy; the factory keeps 0.001 ETH for the check. Needs LOOT_AGENT_PRIVATE_KEY and LOOT_API_URL.