Oak

Dompet lokal dan alat untuk agen AI pada proyek Robinhood Chain, dengan pratinjau dan penandatanganan lokal.

Dokumentasi

All 36 projects and supported agents

  • KyberSwap
  • Velora
  • Steakhouse
  • Spark
  • NetNet
  • Longbow
  • Grove
  • Beefy
  • Pons
  • Orbio
  • HoodLock
  • Merkl
  • Relay
  • Lighter
  • ERC-8004
  • hood.ag
  • HeyResearch
  • Priors
  • Morpho Blue
  • Uniswap liquidity
  • Meridian
  • Hookr
  • TickerSpring
  • Clanker
  • pools.trade
  • Wormhole
  • LayerBank
  • Pendle
  • Borro
  • Chop
  • Gloam
  • Factor
  • Raeto
  • Upoch
  • Tokyo Futuro
  • FOBO

Claude Code · Codex · Cursor · Gemini · Grok

Mainnet: 4663. Testnet: basic tools and ERC-8004 identity only.

$OAK is live. Oak has no subscription; reads, quotes and previews are free, and some actions carry an Oak fee, always shown before you say yes. Reads work straight away. Actions need a verified ERC-8004 agent ID and your yes or no in chat. Call account to see where your setup stands. Official $OAK address: 0x6511c233790Ec10f7d673c64DC82C3F941D57828. Pons page: https://ponsfamily.com/launchpad/0x6511c233790ec10f7d673c64dc82c3f941d57828.

Your agent's tool list shows the everyday tools. For anything not listed, it calls find_tool with what it wants to do, then run_tool with the tool's name and arguments. Tools run this way get the same checks, local guard, summary and yes-or-no approval as a direct call.

Basics

Read details

Every amount crosses JSON boundaries as a decimal base-unit string (never a float). Every tool output identifies the token address, symbol, chain ID, and decimals. Non-read requests use request-bound sessions (X-Oak-Session plus a single-use X-Oak-Request signature signed by an ephemeral in-memory sessionKey). When preparing an action (calling a listed action tool or oak_prepare), the add-on runs a simulation preview (eth_simulateV1 with traceTransfers: true), builds exact token approvals only (never unlimited), and displays the six-part summary, actionId, expiry, and simulated token deltas in chat; when oak_execute is called with actionId after a yes in chat, it re-simulates, checks that terms have not worsened, checks the optional daily spending limit, and signs locally.

ToolKindWhat it does
find_tokenReadVerified token discovery by name, symbol, or address across fixed tokens (ETH, USDG, WETH, USDe, $OAK), official stock tokens (carrying identityNote when matched to the official list), Clanker, and Pons (Pons and pools.trade require an address here; search Pons by name, symbol or address with pons_browse {"query": "..."}).
balancesReadOne-call Multicall3.aggregate3 read of native ETH, USDG, WETH, USDe, $OAK, and official stock tokens from the official list, with humanAmount and a labeled usdEstimate ("estimate, not a quote" or "price unavailable"), fetched through Oak's server on mainnet even when OAK_RPC_URL is set (and directly through OAK_RPC_URL on testnet). Any other ERC-20 someone sends the wallet is listed (unverified, unpriced) once a balances read on this computer has seen it arrive using the local RPC (OAK_RPC_URL when set): each read scans up to 8 chunks of 10,000 blocks from a saved scan position (catching up new blocks first, then working back through approximately the last 30 days at 100 ms per block) and remembers up to 2,000 discovered token contracts and its scan position in a local file. It checks at most 200 candidate token contracts per chunk; if a single block has more than 200 candidate tokens, it checks 200, advances past that block, and says in discoveryNotice which holdings from that block or outside the scanned window may be missing, beside items. If the official stock list is unreachable, the other balances still show and stockNotice says stock rows are missing. NFTs are not listed.
priceReadUSD price (18-decimal base units) with a stale flag when the pool has had a trade in the last 30 minutes, or a plain explanation pointing to balances and positions estimates when no fresh trade exists.
quoteReadCompares KyberSwap, Velora, and Pons launch-curve routes by net output (hiding aggregator routes and falling back to pinned Uniswap routes when the local RPC lacks debug_traceCall), warns when price impact exceeds 2% against reference prices, and issues a 60-second quoteId; from and to accept token addresses or verified symbols (ETH, USDG, WETH, USDe, OAK, and official stock tickers).
swapActionBuilds exact-approval (never unlimited) and swap transactions for a quoteId (or swap parameters), preserving minAmountOut, returning a summary and actionId, and re-verifying simulation on oak_execute after chat confirmation.
previewReadSimulates an UnsignedTx[] sequence via eth_simulateV1 and reports token balance deltas (runs through Oak's server on mainnet even when OAK_RPC_URL is set, and locally through OAK_RPC_URL on testnet; the local sender also runs its own pre-sign simulation and trace on your configured RPC before signing).
historyReadERC-20 token transfers to and from the wallet, plus decoded events from the program contracts Oak reads, across the last 10,000 blocks only (about 17 minutes), returned as events with a coverage notice. Verified transfers include args.token (address, symbol, decimals, chainId), args.humanAmount, and args.pinnedToken: true. If the official stock list cannot be checked, unlabeled transfers carry args.verificationUnavailable: true. It does not list plain ETH transfers, NFT transfers or anything older, so an empty list does not mean nothing happened. A transfer with pinnedToken: false comes from a token contract Oak has not pinned; any contract can emit one, so it does not prove a payment. Zero-value transfers are left out.
positionsReadAggregated active positions and per-program status across 35 ecosystem projects (with deepScan?: boolean, labeled usdEstimate and usdEstimateTotal, and plain coverage gap lines); private Gloam notes stay local in gloam_status.
accountReadShows the wallet address, network, ERC-8004 identity, whether actions are ready, and the wallet's $OAK balance. Oak has no subscription; reads are free, and some actions carry an Oak fee, always shown before you say yes.
oak_doctorReadRead-only self-check of key protection, RPC tracing readiness, ETH/USDG prices, stock USD estimates, ERC-8004 identity, daily spending limit, hosted text checks, and open token approvals.
oak_dry_runReadTests 1 to 8 transaction actions without signing to report expected outcomes, fees, and approvals.
oak_whoisReadIdentifies an address on Robinhood Chain using Oak's pinned address book and live runtime bytecode comparison.
oak_portfolioReadReads wallet holdings, module positions, and claimable rewards with USD estimates and coverage gaps.
oak_claimableReadReads claimable rewards across ecosystem programs and gives ordered claim steps for oak_plan_run.
oak_plan_runActionRuns 1 to 8 transaction actions with a single chat confirmation listing every step and limit.
oak_receiptsReadLists or exports local approval receipts as JSON or CSV and verifies their hash chain.

Always prepare, ask in chat, and execute only after a yes. Call a listed common action tool (swap, send, lend, withdraw, borrow, repay, bridge) or oak_prepare with {"name": "<tool>", "arguments": {...}} first. This builds and simulates the action (eth_simulateV1 with traceTransfers: true) without signing and gives back a six-part summary (what the action does, what leaves the wallet, what comes back or minimum received, fees, who gets any token approval, and warnings), an actionId, and its UTC expiry. Show the summary in chat and wait for the person to say yes or no. Only after a yes, call oak_execute with {"actionId": "<the exact actionId>"}. oak_execute re-runs the simulation and local guards, checks that the terms have not worsened, checks the optional daily spending limit, and signs locally. Built approvals are always exact (amountIn), never unlimited. Note that simulation transfers exclude gas and do not prove off-chain external settlement (such as Relay destination fills or Meridian RFQ relayer execution).

When preparing an action (calling a listed action tool or oak_prepare), the add-on runs a simulation preview (eth_simulateV1 with traceTransfers: true), builds exact token approvals only (never unlimited), and displays the six-part summary, actionId, expiry, and simulated token deltas in chat; when oak_execute is called with actionId after a yes in chat, it re-simulates, checks that terms have not worsened, checks the optional daily spending limit, and signs locally.

Buy a token (find_token → quote → swap → chat yes → oak_execute)

This swap example is for mainnet (4663). Testnet exposes basic tools and ERC-8004 identity tools; swap routes and the other ecosystem modules are not configured there.

  1. Find the token (find_token): Look up a token by name, symbol, or contract address on chain 4663 to confirm its verified address and decimals:
    oak call find_token '{"query":"TSLA"}'
    
  2. Quote the route (quote): Pass verified symbols (ETH, USDG, WETH, USDe, OAK, or an official stock ticker such as TSLA) or a verified token address from find_token, with amountIn in input token base units ("10000000" = 10 USDG with 6 decimals):
    oak call quote '{"from":"USDG","to":"TSLA","amountIn":"10000000","slippageBps":50}'
    
  3. Prepare the swap (swap or oak_prepare): Build and simulate the swap via eth_simulateV1 without signing, producing the six-part summary, actionId, and UTC expiry to show in chat:
    oak call swap '{"quoteId":"<quoteId>"}'
    
  4. Execute the swap (oak_execute): After the person replies yes in chat, re-verify the simulation, terms, and optional daily spending limit, sign locally, and broadcast:
    oak call oak_execute '{"actionId":"<actionId>"}'
    

Find any other tool (find_tool, run_read_tool, run_tool, oak_playbook)

tools/list shows the 24 core tools on mainnet (18 on testnet) plus installed recipes. Every other tool stays reachable by name. For anything not listed, call find_tool with what you want to do, then run_read_tool for reads or run_tool for actions.

  • find_tool searches every Oak tool, listed or not, by what you want to do, a project name or an exact tool name (query, with optional program and limit). It runs locally and only reads. Its output gives matches (count), optional venue programNotes, and results, where each match shows its name, program, kind (read, action, or read or action), listed (whether tools/list shows it), call ("direct" | "run_read_tool" | "run_tool"), optional status ("blocked" | "needs_install") and statusNote, a one-line description and its required inputs; an exact tool name also gives the full inputSchema and declared outputSchema.
  • run_read_tool runs an Oak read tool by name with its arguments (name, arguments), such as a read given by find_tool with call: "run_read_tool". It preserves readOnlyHint: true, needs no identity, and refuses actions (Not run. <name> is an action: call it with run_tool so its checks and confirmation apply.).
  • run_tool runs any Oak tool by name through the same code path as a direct call, so the identity check, local guard, simulation preview, exact approvals, chat confirmation (preparing with the action tool or oak_prepare, then calling oak_execute with actionId), and optional daily spending limit are unchanged. Reads still need no identity. Put the tool's inputs inside arguments.
  • oak_playbook reads an Oak playbook by name (name, optional offset), such as reads or pendle, in pages of up to 20,000 characters for clients that cannot read MCP resources; omitting name lists available playbooks.
  • Clients that auto-approve read-only tools can safely auto-approve run_read_tool. An AI client that remembers "always allow" for run_tool lets it request every Oak tool; every action still requires preparing the action (oak_prepare or the action tool), a yes in chat, and oak_execute with a valid actionId within the optional daily spending limit before local signing.
oak call find_tool '{"query":"hookr pools"}'
oak call run_read_tool '{"name":"hookr_pools","arguments":{}}'
oak call oak_prepare '{"name":"uniswap_remove","arguments":{"version":"v3","tokenId":"1","liquidityBps":10000,"amount0Min":"0","amount1Min":"0"}}'

Wave-3 integration installs the shared read gates, local transaction reconstruction and RFQ wallet lock. Meridian Predict buys are enabled; the bridge owns every continuation and signature, so never supply either manually. Meridian perps public reads and guarded deposit/finalize transactions are available, but perps signatures remain disabled pending their signing-contract expiry policy and registered local submission path. A deposit alone does not enable trading in Oak.

Hookr supports locally reconstructed fungible-token actions and current compounder actions. NFT/6909 grant-dependent routes remain blocked pending transfer tracing and approval journals. Signed referral registration remains blocked pending a declared relayed-signature policy; unsigned referral and other supported actions remain available. Collection-wide approvals and ERC-1155 custody are refused. Use hookr_contracts to fetch the exact schema before an action. Historical playbooks that say shared integration is pending should be read with these current limits.

36 project modules

Browse projects and tools

Swap and Trade

Example prompt

Swap 50 USDG for ETH with the best route, and show me the preview before anything is signed.

FOBO

fobo_browse fobo_token fobo_portfolio fobo_leaderboard fobo_claims fobo_limit_orders fobo_quote fobo_fee_schedule fobo_limit_pay_tokens fobo_transaction fobo_buy fobo_sell fobo_launch fobo_limit_order fobo_cancel_limit_order fobo_claim

Complete launchpad and rising-floor token lifecycle on Uniswap v4 pools (fobo_browse, fobo_token, fobo_portfolio, fobo_leaderboard, fobo_claims, fobo_limit_orders, fobo_quote, fobo_fee_schedule, fobo_limit_pay_tokens, fobo_transaction, fobo_buy, fobo_sell, fobo_launch, fobo_limit_order, fobo_cancel_limit_order, fobo_claim). FOBO coins trade through FOBO's own pools, with no Oak fee. Oak charges 0.25% on other swaps, including Uniswap (and official stock-token swaps via Priors), KyberSwap and Velora.

KyberSwap

kyberswap_quote kyberswap_swap

Route quoting, with optional source and route-shape controls, and swap building (includes Oak's 0.25% swap fee); generic quote / swap compares KyberSwap, Velora, and Pons launch curves and enforces minAmountOut.

Velora

velora_quote velora_swap velora_delta_token_support velora_delta_orders velora_delta_order velora_delta_bridge_routes velora_delta_bridge_protocols velora_delta_strategies velora_fee_balance velora_claim_fees velora_unwrap_deth

Route quoting and swap building with net output comparison and venue and Oak 0.25% fee disclosure, plus Delta order, bridge and strategy reads, partner fee claims and dETH unwrap (velora_quote, velora_swap, velora_delta_orders, velora_fee_balance, velora_claim_fees, velora_unwrap_deth).

Pons

pons_browse pons_status pons_launch_options pons_launch pons_transfer_creator_fee_recipient pons_set_buyback pons_buy pons_sell pons_graduate pons_claim pons_holders pons_holdings pons_trending pons_analytics pons_activity pons_launch_info pons_trades pons_profile

Complete bonding-curve and graduated Uniswap v4 token lifecycle (pons_browse, pons_status, pons_launch_options, pons_launch, pons_transfer_creator_fee_recipient, pons_set_buyback, pons_buy, pons_sell, pons_graduate, pons_claim), index-backed reads of holders, holdings, trending launches, profiles, activity, analytics and curve trades (pons_holders, pons_holdings, pons_trending, pons_trades), plus curve quotes in generic quote / swap.

pools.trade

poolstrade_launch poolstrade_buy poolstrade_sell poolstrade_collect poolstrade_claim poolstrade_browse poolstrade_balance poolstrade_status poolstrade_launch_options poolstrade_fee_transfer poolstrade_fee_approve poolstrade_transfer poolstrade_collect_many

Atomic Instant Launch (poolstrade_launch with explicit permanent creatorFees), v4 swaps (poolstrade_buy, poolstrade_sell), fee collection/claims (poolstrade_collect, poolstrade_claim), and launch browsing, status, fee-position and token transfers (poolstrade_browse, poolstrade_status, poolstrade_fee_transfer, poolstrade_transfer, poolstrade_collect_many).

Clanker

clanker_launch clanker_claim clanker_browse clanker_status clanker_update_reward clanker_update_token clanker_airdrop_proofs clanker_vault_status clanker_vault_claim clanker_vault_update_admin clanker_airdrop_tree clanker_airdrop_status clanker_airdrop_claim clanker_airdrop_manage clanker_protocol_admin clanker_store_fees clanker_claim_for

Clanker v4 token launch (clanker_launch, with an optional 10% LP reward share to Oak via oakRewardShare: true, off unless chosen), MEV-aware fee locker claims (clanker_claim), and indexer search (clanker_browse), plus token status, reward and token administration, vault and airdrop claims, and protocol-role tools (clanker_status, clanker_update_reward, clanker_vault_claim, clanker_airdrop_claim, clanker_protocol_admin).

Hookr

hookr_create hookr_cancel hookr_fill hookr_claim_bounty hookr_relay hookr_open_orders hookr_orders hookr_order hookr_pools hookr_pool hookr_quote hookr_relay_receipt hookr_swap hookr_scan hookr_agent_gate hookr_agent_link hookr_reviewer_set hookr_launch_options hookr_blocks hookr_launch hookr_lp_positions hookr_lp_position hookr_lp_add hookr_lp_collect hookr_lp_remove hookr_position_add hookr_position_collect hookr_position_remove hookr_claims hookr_claim hookr_jobs hookr_pay_later_create hookr_pay_later_transfer hookr_pay_later_cancel hookr_pay_later_accept hookr_pay_later_release hookr_pay_later_accept_back hookr_pay_later_withdraw_earnings hookr_pay_later_withdraw_inventory hookr_pay_later_vault

Sidecar limit orders on HookrLimitOrders (hookr_create, hookr_cancel, hookr_fill, hookr_claim_bounty), pool, quote and order reads (hookr_open_orders, hookr_orders, hookr_order, hookr_pools, hookr_pool, hookr_quote), and relaying a trader-signed swap through the Hookr forwarder (hookr_relay, hookr_relay_receipt).

TickerSpring

tickerspring_create tickerspring_cancel tickerspring_claim tickerspring_orders tickerspring_products tickerspring_tokens tickerspring_vaults tickerspring_baskets tickerspring_order_exit_preview tickerspring_account tickerspring_activity tickerspring_report_card tickerspring_plan tickerspring_swap_quote tickerspring_candles tickerspring_basket_plan tickerspring_tx_status tickerspring_spring_orders tickerspring_capabilities tickerspring_grid tickerspring_ladder_strategy tickerspring_ladder tickerspring_basket_make tickerspring_vault_deposit tickerspring_vault_cancel_deposit tickerspring_vault_withdraw tickerspring_basket_buy tickerspring_basket_sell

Agent REST API limit and market-opening orders (tickerspring_create, tickerspring_cancel, tickerspring_claim, tickerspring_orders), vault deposit requests with direct exits (tickerspring_vault_deposit, tickerspring_vault_cancel_deposit, tickerspring_vault_withdraw), BasketZap buys and sells and Maker baskets (tickerspring_basket_buy, tickerspring_basket_sell, tickerspring_basket_make), repeating grids, ladder strategies and independent ladders (tickerspring_grid, tickerspring_ladder_strategy, tickerspring_ladder), and account, planning and discovery reads (tickerspring_products, tickerspring_tokens, tickerspring_vaults, tickerspring_baskets, tickerspring_order_exit_preview, tickerspring_account, tickerspring_activity, tickerspring_report_card, tickerspring_plan, tickerspring_swap_quote, tickerspring_candles, tickerspring_basket_plan, tickerspring_tx_status, tickerspring_spring_orders, tickerspring_capabilities).

Uniswap liquidity

uniswap_add uniswap_collect uniswap_remove uniswap_list_positions uniswap_create_pool uniswap_pools

Uniswap v3 (NonfungiblePositionManager) and v4 (PositionManager + Permit2) liquidity management (uniswap_add, uniswap_collect, uniswap_remove, uniswap_list_positions), plus pool discovery and pool creation at a stated starting price (uniswap_pools, uniswap_create_pool).

Vaults and Rewards

Example prompt

List the USDG vaults on Steakhouse and Spark, and tell me what I hold in each.

Steakhouse

steakhouse_list steakhouse_deposit steakhouse_withdraw steakhouse_details steakhouse_analytics steakhouse_manage steakhouse_mint steakhouse_redeem

Measured USDG ERC-4626 vault (steakhouse_list, steakhouse_deposit, steakhouse_withdraw), plus exact-share mint and redeem, details and analytics reads, and role-gated management (steakhouse_mint, steakhouse_redeem, steakhouse_details, steakhouse_analytics, steakhouse_manage).

Spark

spark_list spark_deposit spark_withdraw spark_details spark_roles spark_manage spark_mint spark_redeem spark_deposit_referral spark_return_liquidity

Measured spUSDG ERC-4626 vault (spark_list, spark_deposit, spark_withdraw), plus exact-share mint and redeem, referral-labelled deposits, details and role reads, role-gated management and returning liquidity (spark_mint, spark_redeem, spark_deposit_referral, spark_details, spark_roles, spark_manage, spark_return_liquidity).

NetNet

netnet_list netnet_deposit netnet_withdraw netnet_stake netnet_wrap netnet_unwrap netnet_unstake

Measured nnUSDG ERC-4626 vault, plus NET staking and wsNET wrapping for the Loopback borrow branch (netnet_list, netnet_deposit, netnet_withdraw, netnet_stake, netnet_wrap, netnet_unwrap, netnet_unstake).

Longbow

longbow_list longbow_deposit longbow_withdraw longbow_stake longbow_unstake longbow_claim_rewards

Core and Frontier USDG and ETH/WETH ERC-4626 vaults, withdraw-only V1 exits, and optional BOW staking for USDG rewards (longbow_list, longbow_deposit, longbow_withdraw, longbow_stake, longbow_unstake, longbow_claim_rewards). Longbow's markets use the Morpho tools.

Grove

grove_list grove_deposit grove_withdraw grove_details grove_analytics grove_manage grove_mint grove_withdraw_assets

Grove x Steakhouse USDG public ERC-4626 vault (grove_list, grove_deposit, grove_withdraw), plus exact-share mint, exact-asset withdrawal, details and analytics reads, and role-gated management (grove_mint, grove_withdraw_assets, grove_details, grove_analytics, grove_manage).

Beefy

beefy_list beefy_deposit beefy_withdraw beefy_vault_info beefy_lp beefy_swap beefy_add_liquidity beefy_remove_liquidity beefy_boosts beefy_boost beefy_boost_manage beefy_vault_admin beefy_vault_manage

UP–WETH vault adapter (beefy_list, beefy_deposit, beefy_withdraw), plus vault and LP-pool reads, LP swaps and liquidity changes, boost pools, and role-gated vault and boost management (beefy_vault_info, beefy_lp, beefy_add_liquidity, beefy_boost, beefy_vault_manage).

Merkl

merkl_rewards merkl_claim merkl_opportunities merkl_campaigns merkl_earning_status merkl_claim_config merkl_set_operator merkl_set_recipient merkl_claim_to merkl_claim_for merkl_distributor_status merkl_dispute merkl_distributor_admin merkl_stock_lp_rewards

Campaign reward discovery and Distributor claims (merkl_rewards, merkl_claim), plus opportunity and campaign reads, claim recipients and operators, claims for another user, and Distributor status, dispute and admin tools (merkl_opportunities, merkl_campaigns, merkl_set_recipient, merkl_claim_for, merkl_dispute). Powered by Merkl — https://app.merkl.xyz

Pendle

pendle_list pendle_buy pendle_sell pendle_redeem

Principal-token discovery, purchases, sales and redemption of ended terms on Robinhood Chain (pendle_list, pendle_buy, pendle_sell, pendle_redeem). Compare it with LayerBank using the read-only earn_options.

Chop

chop_logs chop_position chop_quote_wrap chop_quote_unwrap chop_wrap chop_unwrap chop_farm chop_unfarm chop_harvest

Oak x Chop. Chop's own team runs its product and contracts; Oak didn't build them and doesn't run them. Verified log discovery, position and lock reads, unwrap quotes, wrapping, unwrapping, two-sided 50/50 LP farming, unfarming and CHOP reward harvesting on Robinhood Chain (chop_logs, chop_position, chop_quote_unwrap, chop_wrap, chop_unwrap, chop_farm, chop_unfarm, chop_harvest).

Gloam

gloam_status gloam_shield gloam_pay gloam_claim gloam_cash_out

Gloam is an official Oak partner. Gloam's own team runs its product and contracts; Oak didn't build them and doesn't run them. Private USDG payments using local encrypted notes and receive tags. Shield deposits sign locally; pay, claim and whole-note cash-out use locally made proofs submitted by Gloam’s relay through Oak’s server. Cash-outs go only to this wallet. Claim needs no identity; every action needs chat confirmation. Local balances are available through gloam_status; hosted positions does not read private notes. (gloam_status, gloam_shield, gloam_pay, gloam_claim, gloam_cash_out).

Borrow and Lend

Example prompt

Show my Morpho Blue position: what I have supplied and what I have borrowed.

Morpho Blue

morpho_supply_collateral morpho_withdraw_collateral morpho_borrow morpho_repay morpho_supply morpho_withdraw morpho_status

Collateral supply/withdrawal, borrowing, repayment, direct lending, market discovery, position status, and atomic Blue bundles in Oak's verified market registry (morpho_supply_collateral, morpho_withdraw_collateral, morpho_borrow, morpho_repay, morpho_supply, morpho_withdraw, morpho_status, morpho_bundle; morpho_bundle carries a 0.25% Oak fee on the loan amount, while collateral-only steps and ordinary Morpho actions carry none).

Priors

priors_lend priors_withdraw priors_borrow priors_repay priors_status priors_close_line priors_release_bond priors_set_delegate priors_root_enroll priors_root_add_stake priors_root_unlock priors_root_retire priors_root_vouch priors_root_unvouch priors_root_freeze priors_root_set_premium priors_root_claim_fees priors_root_set_hook priors_root_apply_hook priors_mark_default priors_import_history priors_fund_reserve priors_root_shares priors_root_fee_locked priors_root_fees_owed priors_root_backing priors_root_free_backing priors_pool_parameters priors_bond_deposit priors_bond_release priors_bond_slash priors_bond_status priors_bond_releasable priors_bond_release_at priors_treasury_move priors_treasury_raise priors_treasury_reclaim priors_treasury_first_line priors_treasury_raise_room priors_treasury_first_lined priors_treasury_eligible_raise priors_treasury_room priors_treasury_rules priors_stock_open priors_stock_add priors_stock_close priors_stock_expire priors_stock_reconcile priors_stock_settle priors_stock_record_feed priors_stock_reclaim priors_stock_state priors_stock_borrow_room priors_stock_asset_state priors_stock_lending_status priors_stock_value priors_stock_ltv priors_backing_open priors_backing_open_with_usdg priors_backing_add priors_backing_add_with_usdg priors_backing_leave priors_backing_close priors_backing_refresh priors_backing_promote priors_backing_expire priors_backing_sync priors_backing_poke_fees priors_backing_record_repay priors_backing_note_delegate priors_backing_set_auto_add priors_backing_set_protocol_backing priors_backing_set_others_backing priors_backing_reconsent priors_backing_release priors_backing_release_for priors_backing_finish_close priors_backing_claim_settled priors_backing_claim_record priors_backing_queue_exit priors_backing_settle priors_backing_record_loan priors_backing_record_default priors_backing_collect priors_backing_fund priors_backing_book priors_backing_generation priors_backing_line priors_backing_quote priors_backing_position priors_backing_record priors_backing_bucket priors_backing_settings priors_backing_reopen_at priors_backing_sync_prices priors_backing_exit_service_open priors_backing_usdg_path priors_backing_entry_rule priors_backing_target_premium priors_backing_price_cache priors_backing_pending_bucket priors_backing_exit_head priors_backing_exit_entry priors_backing_flush priors_backing_claimable priors_autopay_hold priors_autopay_max_cap priors_autopay_window priors_autopay_paused_until priors_autopay_plan priors_autopay_check priors_autopay_epoch priors_autopay_held priors_savings_deposit priors_savings_withdraw priors_savings_redeem priors_savings_balance priors_savings_value priors_market_v2_listing priors_market_v2_record_hash priors_market_v2_list priors_market_v2_cancel priors_market_v2_buy priors_market_v1_listing priors_market_v1_record_hash priors_market_v1_list priors_market_v1_cancel priors_market_v1_buy priors_market_bid priors_market_bid_any priors_market_cancel_bid priors_market_accept_bid priors_market_bid_state priors_market_builder priors_market_set_builder priors_market_change_builder priors_market_sale_split priors_legacy_v3_close priors_legacy_v3_withdraw_offer priors_legacy_v3_expire priors_legacy_v3_settle priors_legacy_v3_claim priors_legacy_v3_seat priors_legacy_v3_pending_fees priors_legacy_v3_fees priors_legacy_v3_offer priors_legacy_v4_close priors_legacy_v4_withdraw_offer priors_legacy_v4_expire priors_legacy_v4_settle priors_legacy_v4_claim priors_legacy_v4_seat priors_legacy_v4_pending_fees priors_legacy_v4_fees priors_legacy_v4_offer priors_sign_consent priors_root_offer priors_autopay_on priors_autopay_off priors_agent_record priors_score_of priors_credit_history priors_pool_stats priors_stock_assets priors_stock_position priors_recent_activity priors_desk_record priors_find_services priors_facilitator_info priors_agents_for_hire priors_find_jobs priors_job_brief priors_find_sellers priors_agent_page priors_find_agents priors_line_options priors_find_line_requests priors_line_request priors_find_agent_by_x priors_how_to_connect priors_ethos_status priors_request_borrow priors_request_repay priors_request_stock priors_request_backing priors_pt_quote priors_pt_position priors_pt_buy priors_pt_sell priors_pt_redeem priors_savings_liquidity priors_savings_force_withdraw priors_stock_quote priors_stock_swap priors_market_origin priors_market_pins priors_market_clear_bid_budget priors_market_revoke_nft priors_x_link priors_capabilities

CreditPoolV2 lending and withdrawal for all wallets, plus borrowing and repayment for funded ERC-8004 credit lines (priors_lend, priors_withdraw, priors_borrow, priors_repay, priors_status, priors_close_line, priors_release_bond), plus sponsor, backing, treasury, stock-collateral, autopay, savings, market and legacy-seat tools with Priors token (PT) trades, official stock-token swaps (priors_stock_quote, priors_stock_swap, carrying Oak's 0.25% output fee), and reads (priors_root_vouch, priors_backing_open, priors_stock_open, priors_autopay_on, priors_savings_deposit, priors_market_v2_list, priors_pt_buy).

LayerBank

layerbank_list layerbank_deposit layerbank_withdraw

USDG lending reads, deposits and withdrawals on Robinhood Chain (layerbank_list, layerbank_deposit, layerbank_withdraw). Compare it with Pendle using the read-only earn_options.

Borro

borro_list borro_deposit borro_withdraw

Borro is an official Oak partner. Borro's own team runs its product and contracts; Oak didn't build them and doesn't run them. USDG and official stock-token lending reads, deposits (via BorroBuilders with code oak and on-chain minShares when listed, or direct vault fallback) and withdrawals on Robinhood Chain, verified on chain per request (borro_list, borro_deposit, borro_withdraw).

Move Money

Example prompt

Bridge 0.05 ETH from Base into Robinhood Chain and tell me when it arrives.

Relay

relay_bridge_in relay_bridge_out relay_status relay_quote relay_chains relay_currencies relay_requests relay_vault_status relay_vault_withdraw

Cross-chain bridging into and out of chain 4663 with live status tracking, read-only quotes, a chain directory, and Oak's 0.25% app fee (relay_bridge_in, relay_bridge_out, relay_status, relay_quote, relay_chains). A fresh wallet may bridge ETH or USDG to itself before identity setup; every other bridge shape requires a verified ERC-8004 identity.

Orbio

orbio_buy_credit orbio_credit_status orbio_buy_held_credit orbio_activate_credit orbio_transfer_credit orbio_tx_status orbio_catalog orbio_staking_status orbio_stake orbio_unstake orbio_claim_staking orbio_agent_status orbio_agent_launch orbio_agent_harvest orbio_agent_claim_credit orbio_agent_withdraw_principal orbio_agent_set_wallet orbio_account orbio_rotate_key orbio_chat orbio_call_tool orbio_infra_call orbio_swap_quote

AI credit purchases and balance checks (orbio_buy_credit, orbio_credit_status), plus held-credit, staking and agent-launch tools and local gateway tools for model chat, metered tools and infrastructure (orbio_buy_held_credit, orbio_stake, orbio_agent_launch, orbio_chat, orbio_call_tool).

Markets and Data

Example prompt

Check this token address with Agent Wormhole and explain the limits of its metadata snapshot.

Meridian

meridian_browse meridian_positions meridian_buy meridian_sell meridian_settle meridian_redeem

Robinhood Chain Predict search, paginated holdings, RFQ buys, secondary RFQ sales and settlement/redemption using USDe (meridian_browse, meridian_positions, meridian_buy, meridian_sell, meridian_settle, meridian_redeem). Position-token bridging, Arbitrum trading, perps orders and perps withdrawal initiation are unsupported.

Lighter

lighter_funding

Read-only normalised perpetual funding rates (lighter_funding).

HeyResearch

heyresearch_research_project heyresearch_chain_activity heyresearch_read heyresearch_bulk heyresearch_validate_receipt

Read-only project research and chain activity (heyresearch_research_project, heyresearch_chain_activity), preserving HeyResearch attribution links and status wording, plus any public HeyResearch operation by name, bulk reads and receipt validation (heyresearch_read, heyresearch_bulk, heyresearch_validate_receipt). Token facts, builder feed, local follow lists and selected position context (heyresearch_token_facts, heyresearch_feed, heyresearch_follow, heyresearch_unfollow, heyresearch_position_context) run only when requested; show the returned HEY Research Lab status line exactly.

Wormhole

wormhole_token_check wormhole_scan_text

Agent Wormhole is an official Oak partner. Agent Wormhole's own team runs its product and contracts; Oak didn't build them and doesn't run them. Verify signed token metadata snapshots and request-time verdicts on chain 4663 (wormhole_token_check) and scan supplied text offline without uploading it (wormhole_scan_text). Missing, stale or invalid evidence gives no current verdict; neither read proves safety or sellability.

Identity and Tools

Example prompt

Register a.hood name for my agent and set it as the primary name.

ERC-8004

erc8004_register erc8004_update erc8004_identity erc8004_wallet_proof erc8004_set_wallet erc8004_unset_wallet erc8004_transfer erc8004_approve erc8004_set_operator erc8004_set_metadata erc8004_owned erc8004_give_feedback erc8004_revoke_feedback erc8004_append_response erc8004_reputation erc8004_validation_request erc8004_validation_response erc8004_validation erc8004_verify_domain

On-chain agent identity registration, gasless owner linking (oak setup), unlinking (oak identity unlink), and metadata updates on IdentityRegistry (erc8004_register, erc8004_update, erc8004_identity), with the default oak.registrar marker, plus agent wallet proofs, identity NFT transfers and approvals, reputation feedback and validation (erc8004_set_wallet, erc8004_transfer, erc8004_give_feedback, erc8004_validation_request).

hood.ag

hoodag_register hoodag_resolve hoodag_name_info hoodag_renew hoodag_text hoodag_set_address hoodag_set_text hoodag_contenthash hoodag_set_contenthash hoodag_set_primary hoodag_clear_primary hoodag_reclaim hoodag_transfer hoodag_approve_transfer hoodag_market_listing hoodag_market_list hoodag_market_set_price hoodag_market_unlist hoodag_market_buy hoodag_commit hoodag_register_eth hoodag_register_many hoodag_referral_info hoodag_browse hoodag_owned_names hoodag_registration_quote hoodag_social_read

.hood domain registration via USDG, reverse record configuration, and resolution (hoodag_register, hoodag_resolve, hoodag_name_info), plus renewals, records, transfers, marketplace listings and purchases, batch and native-ETH registration, and index reads (hoodag_renew, hoodag_set_text, hoodag_transfer, hoodag_market_list, hoodag_market_buy, hoodag_register_many, hoodag_browse). On registrations and resales, Oak passes its treasury as referrer (5% registration and 4% resale referral share and matching buyer discount; zero when treasury is payer or seller).

HoodLock

hoodlock_lock hoodlock_burn hoodlock_airdrop_create hoodlock_airdrop_claim hoodlock_list_locks hoodlock_vesting_create hoodlock_vesting_status hoodlock_vesting_claim hoodlock_vesting_transfer hoodlock_withdraw hoodlock_extend hoodlock_transfer_lock hoodlock_set_fee_recipient hoodlock_collect hoodlock_airdrop_sweep hoodlock_record hoodlock_read hoodlock_recover hoodlock_admin hoodlock_public

Token, v2 LP, and v3 position locks, token burns, and airdrop create, airdrop claim, and airdrop recipient lists (hoodlock_lock, hoodlock_burn, hoodlock_airdrop_create, hoodlock_airdrop_claim, hoodlock_list_locks; omit id on hoodlock_airdrop_claim to query eligible airdrops), plus vesting schedules and lock withdraw, extend, transfer and fee collection (hoodlock_vesting_create, hoodlock_withdraw, hoodlock_extend, hoodlock_collect).

Factor

factor_sign_up factor_create_pay_link factor_apply_to_job factor_draw factor_deliver factor_decline factor_job factor_can_draw factor_my_jobs factor_open_jobs factor_open_job

Factor is an official Oak partner. Factor's own team runs its product and contracts; Oak didn't build them and doesn't run them. Agent-side paid work for plain wallets: profiles, pay links, job discovery, applications, advances and delivery. Agents receive the Factor playbook as an Oak MCP resource (oak://agent-playbooks/factor.md).

Upoch

upoch_agent upoch_explorer

Read workflow roles, checkpoints, recovery history and on-chain Upoch Scores with upoch_agent and upoch_explorer; browse a bounded ranked workflow list. Upoch is a project Oak reads from. The score measures recovery policy and checkpoint activity, not trading performance or safety. Both tools are mainnet-only reads.

Raeto

raeto_status raeto_join raeto_topup raeto_ask raeto_search raeto_read_page raeto_models raeto_limits

Oak integrates with Raeto. Raeto's own team runs its product and contracts; Oak didn't build them and doesn't run them. AI model calls, web search and page reading with USDG credit top-ups and local spending limits. Record pairing remains switched off pending pinned approval details. Agents receive the Raeto playbook as an Oak MCP resource (oak://agent-playbooks/raeto.md).

Tokyo Futuro

tokyofuturo_jobs tokyofuturo_my_jobs tokyofuturo_take_job tokyofuturo_deliver_job tokyofuturo_collect

Oak integrates with Tokyo Futuro. Tokyo Futuro's own team runs its product and contracts; Oak didn't build them and doesn't run them. Paid report jobs in $ZENI on Robinhood Chain: find open jobs, take one with an exact bond approval, deliver the report and collect the payout or returned bond. Agents receive the Tokyo Futuro playbook as an Oak MCP resource (oak://agent-playbooks/tokyofuturo.md).

Command line

Read details

oak init
oak connect <claude|codex|cursor|gemini|grok>
oak setup [register|link <agentId>]
oak identity unlink [--owner <linkId>]
oak address
oak status
oak export
oak backup
oak register
oak recipes add <pkg-or-path>
oak recipes remove <project>
oak recipes list [project]
oak config set <key> <value>
oak config check-rpc
oak receipts [list [limit]|verify [head]|export <json|csv|accounting-csv>]
oak mcp
oak call <tool> <json>

Run oak connect <app> in your terminal to configure your app, then restart the app. Run oak connect cursor from the project folder you want to connect. The other clients use your user account by default. Existing conflicting entries are reported for you to resolve.

  • oak init and oak export require a direct owner terminal (stdin.isTTY && stdout.isTTY).
  • oak receipts export accounting-csv writes an 18-column accounting CSV from your local receipt log directly in your terminal without sending it into an agent chat.
  • oak setup sets up the wallet's ERC-8004 identity: oak setup link <agentId> links an existing agent ID using a gasless owner EIP-712 signature in your terminal, and oak setup register mints and verifies a new agent ID on-chain with the mandatory public oak.registrar = oak marker in one transaction.
  • oak identity unlink revokes the active identity link without gas (--owner <linkId> revokes by link ID using the current NFT owner's signature).
  • oak status calls the account tool and outputs the wallet address, network, ERC-8004 identity status (identity, identitySummary), and action readiness (actionsUnlocked, actionsSummary).
  • oak register registers or updates the agent's ERC-8004 on-chain identity using the configured profile JSON (oak config set profile '<json>'), writing up to 15 user metadata entries plus the mandatory public oak.registrar = oak marker in one transaction.

Project recipes

Read details

Ecosystem builders can publish declarative JSON recipes (oak-recipe/v1) validated against packages/addon/schema/recipe.schema.json. Each recipe names one contract on chain 4663, one ABI function item, typed inputs, and kind: "read" | "tx". The add-on's importer (oak recipes add) is strictly data-only: it streams tarballs with a 4 MiB / 100-entry cap, ignores non-recipe files without writing or executing them, copies only package/recipes/<name>.recipe.json (max 64 KiB each) where project matches package/package.json 's oakProject, and never executes third-party code. Recipes are opt-in by name (<project>.<name>) and labelled as-is, not reviewed by Oak .

For AI agents

Read details

AI agents should start with AGENTS.md, the operating guide to the tools, conventions and custody rules. A plain-text summary for agents is in llms.txt.

Hard Custody Boundaries for Agents

  1. Wallet creation is automatic on first MCP/CLI wallet use. Call account, relay the public address/network, ask the user to fund ETH and USDG, then re-check balances. Backups are optional: oak backup gives guidance. Never run oak init or oak export inside an agent tool call. Both commands must be run by the human owner in your own terminal, never through the agent. Even if an agent can allocate a PTY, the security boundary is human execution so recovery words and private keys never enter agent context, prompts, or logs. Your private key never leaves your computer, and Oak cannot recover a lost key.
  2. Never ask the user for a private key, seed phrase, passphrase, or raw owner key. Both the local bridge (packages/addon/src/bridge.ts) and the Oak server reject any JSON argument containing private_key, secret_key, wallet_key, mnemonic, seed, seed_phrase, or recovery_phrase. When linking an external owner's ERC-8004 agent ID (oak setup link <agentId>) or revoking by owner (oak identity unlink --owner <linkId>), the owner signs the EIP-712 OakIdentityLink challenge in their own terminal (Owner signing requires your terminal. Run oak setup link <agentId> or oak identity unlink --owner <linkId> there.).
  3. All signing happens locally inside @oakagentkit/addon. The Oak server never sees your key and never signs or sends a transaction. Your swaps and deposits go straight from your wallet to the project. Hosted non-read tool requests use a 15-minute wallet-signed X-Oak-Session plus a 60-second single-use X-Oak-Request signature from an short-lived sessionKey persisted with its session in owner-only (0600) files under the install config directory (~/.oak/sessions/ by default). These files survive process exit and are reused across CLI/MCP processes; a same-uid reader can impersonate hosted requests and consume quota until session expiry plus the server's 120-second clock allowance, but cannot sign wallet transactions. Unlink requires a fresh owner-signed proof in the owner's terminal (oak identity unlink --owner <linkId>). Gloam relay and deposit attribution carry no session or request signatures; only public proof fields or a public shield hash reach those routes.
  4. Always prepare, ask in chat, and execute only after a yes. Call a listed common action tool (swap, send, lend, withdraw, borrow, repay, bridge) or oak_prepare with {"name": "<tool>", "arguments": {...}} first. This builds and simulates the action (eth_simulateV1 with traceTransfers: true) without signing and gives back a six-part summary (what the action does, what leaves the wallet, what comes back or minimum received, fees, who gets any token approval, and warnings), an actionId, and its UTC expiry. Show the summary in chat and wait for the person to say yes or no. Only after a yes, call oak_execute with {"actionId": "<the exact actionId>"}. oak_execute re-runs the simulation and local guards, checks that the terms have not worsened, checks the optional daily spending limit, and signs locally. Built approvals are always exact (amountIn), never unlimited. Note that simulation transfers exclude gas and do not prove off-chain external settlement (such as Relay destination fills or Meridian RFQ relayer execution).