Ekubo Protocol

它列出的 99 个工具

“只读”和“会改数据”是服务方自己标的。带下划线的参数是必填的。

1. decode_pool_config只读

   Decode an Ekubo pool config

   Decode the packed bytes32 extension, exact uint64 Q64 fee, concentrated/stableswap discriminator, and tick spacing or stableswap parameters. The fee is never returned as a JSON number.

   config

2. decode_uniswap_v4_position_info只读

   Decode Uniswap V4 position info

   Decode the packed PositionInfo returned by wallet reads into signed tick bounds, subscriber flag and the truncated pool-ID prefix. This is local integer decoding, not a state query.

   info

3. derive_pool_id只读

   Derive an Ekubo pool ID

   Pack or accept an exact PoolKey config and derive pool_id = keccak256(abi.encode(PoolKey)). The uint64 Q64 fee is string-only so JavaScript cannot silently round it.

   pool_key

4. discover_uniswap_pools只读

   Discover Uniswap pools

   Fetch indexed V2, V3 or V4 pools ranked by TVL from Uniswap's interface API. Filter by chain and token; paginate using the last pool's TVL as tvl_cursor. Returns token symbols and decimals, liquidity and daily volume.

   chain_id version token_address first tvl_cursor

5. export_tokens只读

   Export Ekubo tokens for a wallet

   Return a token_list_reference envelope (chain ID, address, symbol, name, decimals) and its count, with no entries, so a wallet can import token names; pass it unchanged as the wallet tool's reference argument. complete=false means the export is a prefix of the chain's list. Use list_tokens to read entries yourself.

   chain_id max_tokens

6. get_aave_v3_markets只读

   List fixed Aave V3 markets

   Locally return six major Aave V3 core deployments and a bounded set of popular reserve, aToken, and variable-debt-token addresses from a pinned official Aave address-book snapshot. This tool makes no RPC, indexer, API, or other network request. For live rates, caps, pause state, liquidity, collateral settings, eMode categories, and account data, an agent may call Aave's public GraphQL API at https://api.v3.aave.com/graphql directly; this server is not in that data path. Intersect the API result with this fixed list before calling a preparation tool.

   chain_id

7. get_aerodrome_deployment只读

   Get the verified Aerodrome Base deployment

   Locally return Aerodrome's Base contracts (AERO, veAERO, Voter, Router, v2 factory, RewardsDistributor, Slipstream, Sugar lenses), derived on chain from the Voter, plus the protocol behaviour an agent must respect. No API or RPC request. Aerodrome is Base-only; Velodrome is not prepared here.

   chain_id

8. get_lido_deployment只读

   Get the fixed Lido mainnet deployment

   Locally return canonical Ethereum stETH, wstETH, and WithdrawalQueueERC721 addresses plus direct wallet-read guidance. This server makes no Lido API, RPC, or indexer request.

9. get_liquidity_opportunities只读

   Find Ekubo liquidity opportunities

   Return the interface's boosted-fee, incentive and projected ve(3,3)-emission opportunities ranked by APR, with actionable pools or pool-discovery handoffs, freshness and risk context. Call this before asking the user to choose a pair. APR is an annualized snapshot, not guaranteed yield: show its components, denominator, freshness, and range and impermanent-loss risk. If ranking_complete=false, run local_read_requirement through the wallet, decode it locally, and call again with ve33_emission_state.

   chain_id types token min_apr limit ve33_emission_state

10. get_merkl_deployment只读

    Get the verified Merkl Distributor deployment

    Locally return the Merkl Distributor address, the chains it is verified on, and how Merkl's reward fields behave; preparation is limited to those chains. No Merkl API, RPC, or indexer request.

    chain_id

11. get_morpho_vaults只读

    List fixed Morpho Vault V2 deployments

    Locally return a bounded, pinned catalog of listed Morpho Vault V2 deployments plus official direct-discovery guidance. This tool makes no API, RPC, indexer, or other network request. The agent must query Morpho's public GraphQL API and current onchain state directly, then intersect the result with the fixed chain, vault, and asset addresses before preparation.

    chain_id

12. get_pool只读

    Get an Ekubo pool

    Resolve a chain/core/pool ID to its verified PoolKey, decoded config and indexed pool state. For fresh sqrtRatio, tick and liquidity, pass current_state_query.read_calls_reference unchanged to wallet_batch_eth_call.

    chain_id core_address pool_id

13. get_pool_liquidity只读

    Get Ekubo pool liquidity depth

    Return tick-level net liquidity deltas for one exact chain/core/pool ID. Accumulate the deltas in ascending tick order to reconstruct active liquidity depth.

    chain_id core_address pool_id

14. get_position只读

    Get complete Ekubo position details

    Hydrate one owner position: pool key, bounds, liquidity, pool state, NFT metadata, history, rewards, token prices, and a pending read of current principal, fees or Ve33 rewards and owner. Pass current_state_query.read_calls_reference as a value to wallet_batch_eth_call in the same code block; current_state_query.state_call_id joins results[].id.

    owner chain_id positions_address token_id

15. get_position_pool_candidates只读

    Find pools for an LP position

    List indexed pools for a token pair with verified PoolKeys and pool IDs, Core generation, pool type, extension, 24-hour TVL/volume/fee stats and the right Positions or Ve33Positions manager.

    chain_id token_a token_b min_tvl_usd core_address extension pool_type

16. get_positions_by_owner只读

    Get Ekubo positions by owner

    Enumerate an owner's indexed Ekubo position NFTs with pool keys, bounds, liquidity, indexed pool state and rewards. For fresh onchain state, pass each current_state_reads[].read_calls_reference to wallet_batch_eth_call as a value in the same code block; each position's current_state.state_call_id joins results[].id.

    owner chain_id state page_size page

17. get_quotes_with_plans只读

    Get swap or bridge quotes with execution plans

    A quote, execution plan, simulation or wallet approval is not permission to trade. Robinhood Stock Tokens are tokenised debt securities subject to issuer restrictions and applicable law. Before requesting signatures or submitting approvals or trades, establish the user's relevant jurisdiction and eligibility, including location, residence or entity incorporation, US-person status under Regulation S, any person for whose account or benefit the transaction is made, and issuer Prohibited Investor restrictions. Never infer these facts from an agent or server IP. If required facts or asset-policy coverage are unknown, do not proceed. Only the user or an authorized representative of the actual investor may provide an explicit factual attestation; an agent must not attest on their behalf. A known prohibited fact cannot be overridden by attestation. An attestation is not a license, legal exemption or substitute for required screening. Keep the attestation client-side; do not send it to the quo

    chain_id destination_chain_id token_in token_out quote_type amount max_output_loss sender recipient slippage_bps swap_deadline_minutes include_raw_quotes

18. get_rewards_claims_by_owner只读

    Get incentive rewards claims by owner

    Fetch canonical reward-claim records and supply the exact per-chain isClaimed/isAvailable eth_call list used by the interface before preparing claim transactions.

    owner

19. get_sky_savings_deployment只读

    Get the fixed Sky savings deployment

    Locally return the canonical Ethereum USDS and sUSDS addresses and direct wallet-read guidance. This server does not proxy Sky, an RPC, an indexer, or any third-party API.

20. get_stonx_allocation_recommendation只读

    Get suggested STONX allocations

    Return a provider-neutral STONX allocation recommendation with an emissions_efficiency KPI per pool and an executable target list (exactly 10,000 bps, at most 25 Ve33 pools). The snapshot refreshes daily; read snapshot_age_seconds. voter with ve33_emission_state makes targets voter-optimal and keeps the neutral plan as provider_targets; without the emission state, execution_ready is false and local_read_requirement says what to read. The tool constructs no transaction. To apply it, require execution_ready=true, then pass its targets, the state_id from get_ve33_allocations for the connected wallet, and strategy=compact_max_lock to prepare_ve33_reallocation.

    voter ve33_emission_state prune_low_efficiency max_emission_share_per_fee_share

21. get_token只读

    Get an Ekubo token

    Fetch canonical token metadata for an exact chain and address.

    chain_id address

22. get_tokens只读

    Get multiple Ekubo tokens

    Fetch canonical metadata for up to 1,000 token identifiers in one batch request, preserving input order; identifiers absent from the canonical list are omitted.

    tokens

23. get_uniswap_charts只读

    Get Uniswap pool charts

    Fetch timestamped token0/token1 prices and USD volume history over the requested duration from the same GraphQL fields as the open source Uniswap interface. Empty series means no indexed data, never zero volume.

    chain_id version pool duration

24. get_uniswap_deployments只读

    Get Uniswap deployments

    Canonical V2/V3/V4 contracts on Ethereum, Optimism, Base, Arbitrum, Unichain and Robinhood, including Permit2 and wrapped native addresses.

25. get_uniswap_pool只读

    Get a Uniswap pool

    Fetch indexed pool details, currencies, fee, TVL, volume and supplies. V4 takes a bytes32 pool ID; V2/V3 take an address. Use prepare_uniswap_reads for current chain state.

    chain_id version pool

26. get_uniswap_pool_ticks只读

    Get Uniswap liquidity depth data

    Fetch paginated initialized ticks and exact liquidityNet/liquidityGross strings for V3/V4 liquidity depth charts. first/skip bound each request; combine with current pool liquidity and tick from prepare_uniswap_reads. Indexer data can lag.

    chain_id version pool first skip

27. get_value_transfer_status只读

    Track a LayerZero or LI.FI cross-chain transfer

    Report whether an executed LayerZero or LI.FI transfer has been delivered; its origin receipt alone does not mean the user has the funds. Poll every 15 to 30 seconds while settled is false (it draws on the quote budget). UNKNOWN or NOT_FOUND right after submission usually means not yet indexed. For LI.FI, read substatus: REFUNDED and PARTIAL report as status DONE. Across transfers are not tracked here.

    source quote_id transaction_hash origin_chain_id destination_chain_id

28. get_ve33_allocations只读

    Show Ekubo STONX / ve(3,3) allocations

    Use for requests such as 'show all my Ekubo STONX allocations'. The production Ekubo ve(3,3) deployment is the STONX voting system, so pass only owner to select its production chain and canonical VeToken automatically. Returns every pool, selected swap fee, NFT, applied vote weight, totals, state_id, and an onchain_validation request explicitly marked not_executed until the client runs its eth_call. Pass chain_id and ve_token together only for another deployment.

    chain_id ve_token owner

29. list_pool_keys只读

    List Ekubo pool keys

    Discover initialized pools for one chain and Core deployment, ordered by pool_id with keyset pagination, optionally filtered by token, pair or extension. Each pool_id is re-derived from its PoolKey and each row carries the indexed state (null until indexed).

    chain_id core_address token_a token_b extension page_size after_pool_id

30. list_tokens只读

    List Ekubo tokens

    First step for symbol-based swaps, including tokenized stocks and stablecoins: list canonical Ekubo tokens by descending visibility_priority, so the preferred token wins an ambiguous symbol. Use search for a symbol prefix or suffix and min_visibility_priority to reach tokens the interface hides.

    chain_id search min_visibility_priority page_size after_token

31. prepare_aave_v3_borrow只读

    Prepare an Aave V3 variable borrow

    Prepare a direct Aave V3 variable-rate borrow from a supported fixed reserve, including optional on-behalf-of credit delegation. This server does not query collateral, delegation, health factor, caps, or available liquidity.

    chain_id sender asset amount on_behalf_of

32. prepare_aave_v3_collateral只读

    Prepare an Aave V3 collateral toggle

    Prepare setUserUseReserveAsCollateral for a supported fixed reserve. Disabling collateral can reduce health factor or revert when open debt needs it, so exact wallet simulation is mandatory.

    chain_id sender asset use_as_collateral

33. prepare_aave_v3_emode只读

    Prepare an Aave V3 eMode change

    Prepare setUserEMode with a caller-supplied current uint8 category ID; zero disables eMode. Discover live category configuration through Aave's public GraphQL API directly, because this server makes no data or RPC request.

    chain_id sender category_id

34. prepare_aave_v3_repay只读

    Prepare an Aave V3 variable-debt repayment

    Prepare variable-debt repayment with underlying tokens or sender-owned aTokens. Underlying repayment carries an exact ERC-20 approval and cleanup in one atomic plan; uint256 maximum requests all available debt.

    chain_id sender asset amount on_behalf_of funding_source

35. prepare_aave_v3_supply只读

    Prepare an Aave V3 supply

    Prepare a fixed-market Aave V3 Pool supply with an exact ERC-20 approval, supply calldata, and allowance cleanup as one atomic wallet plan. No live balance, allowance, reserve, cap, pause, or rate data is queried.

    chain_id sender asset amount on_behalf_of

36. prepare_aave_v3_withdraw只读

    Prepare an Aave V3 withdrawal

    Prepare a direct Aave V3 Pool withdrawal for a supported fixed reserve. Pass uint256 maximum as amount to request the available aToken balance. The wallet establishes balance, health-factor, collateral, and liquidity validity by exact simulation.

    chain_id sender asset amount recipient

37. prepare_aerodrome_gauge_claim只读

    Prepare an Aerodrome emissions claim

    Claim accrued AERO from a gauge. getReward credits its account argument rather than the sender, so a claim can pay a different address than the one paying gas; the plan states which. A claim with nothing earned succeeds and transfers nothing.

    chain_id sender gauge account

38. prepare_aerodrome_gauge_deposit只读

    Prepare an Aerodrome gauge stake

    Stake v2 LP tokens into a pool's gauge to earn AERO emissions, with the LP-token approval the gauge needs and an allowance cleanup after. Phased, because which token the gauge pulls is its own stakingToken: call it without lp_token to get that read back, then again with the resolved address for the complete atomic plan. Staking redirects that position's trading fees to the pool's voters, so it trades fee income for emissions rather than adding to it. A dead gauge accepts the stake and pays nothing, so check gauge_alive. Size amount from the live LP balance, not from an earlier deposit simulation.

    chain_id sender gauge amount lp_token

39. prepare_aerodrome_gauge_withdraw只读

    Prepare an Aerodrome gauge unstake

    Unstake v2 LP tokens from a gauge. This returns the LP token, not the underlying pair, and it does not claim AERO: the read bundle reports what is still earned so it is not silently left behind.

    chain_id sender gauge amount

40. prepare_aerodrome_incentive_claim只读

    Prepare a veAERO reward claim

    Claim a veNFT's voting rewards — trading fees, bribes, or both — and optionally the RewardsDistributor rebase, as one plan. The fee and bribe contract addresses are required inputs because they are per-pool contracts that only a Sugar rewards read returns; this server cannot derive them, and a wrong address claims nothing rather than failing loudly. Distinct from prepare_aerodrome_gauge_claim, which collects an LP's emissions rather than a voter's rewards.

    chain_id sender venft_id fees bribes claim_rebase

41. prepare_aerodrome_liquidity_deposit只读

    Prepare an Aerodrome v2 liquidity deposit

    Prepare a v2 addLiquidity through Aerodrome's Router with exact approvals and allowance cleanup. The read bundle quotes the actual split and resolves the pool, so a pair with no pool is caught before a deposit sets its price. LP tokens earn no AERO until staked with prepare_aerodrome_gauge_deposit.

    chain_id sender token_a token_b stable amount_a_desired amount_b_desired amount_a_min amount_b_min deadline recipient

42. prepare_aerodrome_liquidity_withdraw只读

    Prepare an Aerodrome v2 liquidity withdrawal

    Prepare a v2 removeLiquidity that burns LP tokens back into the underlying pair, with the LP-token approval the router needs and an allowance cleanup after. Phased, because the token being approved is the pool and this server resolves Aerodrome addresses by reading them: call it without lp_token to get the pool read back, then again with the resolved address for the complete atomic plan. An LP balance short of the requested liquidity usually means the rest is staked in the gauge and needs unstaking first.

    chain_id sender token_a token_b stable liquidity amount_a_min amount_b_min deadline recipient lp_token

43. prepare_aerodrome_lock只读

    Prepare a veAERO lock action

    Build one veAERO escrow action: create a lock, add AERO to one, extend it, switch permanent locking on or off, or withdraw an expired one. Durations are measured from now and floored to a week boundary, so anything under a week is refused rather than signed. The read bundle returns ownership and the lock's (amount, end, isPermanent) so an impossible action — withdrawing an unexpired or permanent lock, extending past nothing — is caught before signing.

    chain_id sender action amount lock_duration venft_id

44. prepare_aerodrome_sugar_reads只读

    Prepare an Aerodrome Sugar read bundle

    Build the eth_call bundle and decode plan for one Sugar dataset (pools, positions, veNFTs, epochs, rewards) for the wallet to run against the user's RPC; Sugar has no API. The pool, gauge, fee and bribe addresses and veNFT ids it returns are the inputs to the other prepare_aerodrome_* tools.

    chain_id dataset account pool venft_id limit offset

45. prepare_aerodrome_vote只读

    Prepare a veAERO vote or reset

    Cast one veNFT's gauge vote, or reset it. Weights are relative shares of voting power, not amounts, and the allocation replaces any previous vote entirely — a pool left out is voted zero. A veNFT may vote once per weekly epoch and reverts on a second attempt, so the read bundle returns lastVoted along with each pool's gauge and liveness. Voting also locks the NFT against withdrawal until it is reset.

    chain_id sender venft_id pools reset

46. prepare_approval_revocations只读

    Prepare ERC-20 approval revocations

    Prepare every approve(spender,0) as an exact ordered multi-transaction execution plan. The wallet must not discover or construct the transaction list.

    chain_id sender approvals

47. prepare_auction_complete只读

    Prepare auction completion

    Prepare permissionless auction completion and, when necessary, graduation-pool initialization in the same atomic batch.

    chain_id sender token_id auction_key graduation_pool_initialized launch_pool_tick

48. prepare_auction_create只读

    Prepare auction creation

    Pack the exact interface auction config and prepare mint plus sellAmountByAuction, including approval or native value and deterministic token ID.

    chain_id sender sell_token buy_token sell_amount creator_fee_q32 min_boost_duration graduation_pool_fee_q64 graduation_pool_tick_spacing start_time auction_duration salt

49. prepare_auction_creator_proceeds只读

    Prepare auction creator proceeds collection

    Prepare collection of creator proceeds for an auction NFT with pending owner validation.

    chain_id sender token_id auction_key

50. prepare_fix_pool_price只读

    Prepare a pool price correction

    Run the interface-equivalent phased fix-price workflow: provide exact pending pool-price read calldata, then exact router quote calldata, then approvals and target-price execution calldata. The wallet never constructs a route or transaction.

    chain_id sender core_address pool_id base_token target_price pending_current_sqrt_ratio quote_result swap_deadline_minutes

51. prepare_lido_stake只读

    Prepare Lido ETH staking

    Prepare the canonical Lido submit call with exact native ETH value and an explicit or zero referral. The agent must read current staking pause and limit state directly; the wallet then simulates the exact transaction.

    chain_id sender amount referral

52. prepare_lido_unwrap只读

    Prepare wstETH unwrapping

    Prepare a direct wstETH unwrap call for an exact share amount, returning rebasing stETH to the sender.

    chain_id sender amount

53. prepare_lido_withdrawal_claim只读

    Prepare a Lido withdrawal claim

    Prepare claimWithdrawal for one finalized, unclaimed unstETH request ID owned by the sender. The agent must verify ownership and finalization directly through the user's wallet/RPC before preparation.

    chain_id sender request_id

54. prepare_lido_withdrawal_request只读

    Prepare a Lido withdrawal request

    Prepare one or more bounded stETH withdrawal requests with an exact queue approval and cleanup. This irreversible asynchronous action mints unstETH NFTs, stops rewards while queued, and can settle below 1:1 after extraordinary losses; wallet simulation and clear user review are required.

    chain_id sender amounts owner

55. prepare_lido_wrap只读

    Prepare stETH wrapping

    Prepare an exact stETH approval, wstETH wrap call, and allowance cleanup in one atomic wallet plan.

    chain_id sender amount

56. prepare_lp_position_deposit只读

    Prepare an LP position deposit

    Prepare a v3 position mint or add_liquidity, initializing a new pool at initial_tick when requested, with every approval, refund and cleanup step. Ekubo ticks use base 1.000001, so tick = ln(price in base units) x 10^6 and a Uniswap-style 1.0001 calculation is 100x too small. The token ratio follows the range and current price: do every swap first, re-read the tick with the pool's current_state_query, then mint once. If the wallet lacks one side, execute that swap separately and size the deposit from the measured balance after its receipt, never a quoted output. See ekubo://docs/lp-position-workflow.

    chain_id sender core_address pool_id pool_key pool_initialized mode token_id tick_lower tick_upper initial_tick max_amount0 max_amount1 slippage_bps

57. prepare_lp_position_earnings_claim只读

    Prepare an LP fee or reward claim

    Prepare collection of all accrued fees from an owned standard position or rewards from an owned Ve33 position, keeping its liquidity and NFT. Run its current_state_query first: require every inner call to succeed and the decoded owner to equal expected_owner, and pass the decoded fees or rewards to the wallet with the plan.

    chain_id sender positions_address token_id recipient

58. prepare_lp_position_transfer只读

    Prepare an LP position transfer

    Prepare the exact safeTransferFrom transaction for an owned LP position and include pending ownership validation. The position, liquidity, and unclaimed earnings move together.

    chain_id sender positions_address token_id recipient

59. prepare_lp_position_withdraw只读

    Prepare one or more LP position withdrawals

    Prepare partial or full withdrawals from one or more owned positions in one plan, collecting fees or Ve33 rewards and keeping the NFTs. Read each position's current_state_query first and request no more liquidity than it decodes; require every inner call to succeed and owner to equal expected_owner. Hand the wallet every principal and earnings estimate and recipient.

    chain_id sender withdrawals

60. prepare_manual_pool_boost只读

    Prepare a manual pool boost

    Compute the exact Q32 boost rates and prepare all token approvals, native value, and boost calldata used by the interface.

    chain_id sender pool_key start_time end_time amount0 amount1

61. prepare_merkl_claim只读

    Prepare a Merkl reward claim

    Prepare one Distributor claim for every Merkl reward token the sender holds on a chain, from amounts and proofs fetched from https://api.merkl.xyz/v4/users/{address}/rewards/summary. The proofs are folded into their Merkle root here, and the read bundle checks it against the root the chain enforces, so Merkl's API need not be trusted. Distinct from prepare_rewards_claim, which claims Ekubo's own incentive drops.

    chain_id sender rewards

62. prepare_morpho_vault_deposit只读

    Prepare a guarded Morpho vault deposit

    Prepare an exact-approval Morpho Vault V2 deposit through the official SDK's VaultBundlesV1 route. The caller supplies a fresh RAY-scaled max share price, which is enforced onchain against ERC-4626 share-price inflation; shares are minted to the sender and the server performs no data fetch.

    chain_id sender vault amount max_share_price_ray recipient deadline

63. prepare_morpho_vault_redeem只读

    Prepare a Morpho vault redemption

    Prepare a direct Morpho Vault V2 redemption for an exact share amount. Prefer redeem for full exits so the user's complete fresh share balance can be bound without asset/share rounding dust.

    chain_id sender vault shares recipient owner

64. prepare_morpho_vault_withdraw只读

    Prepare a Morpho vault withdrawal

    Prepare a direct Morpho Vault V2 withdrawal for an exact underlying-asset amount from a fixed vault. Current shares, liquidity, permissions, and vault state are established by direct agent discovery and exact wallet simulation.

    chain_id sender vault amount recipient owner

65. prepare_oracle_capacity_expansion只读

    Prepare oracle capacity expansion

    Prepare the interface's permissionless Oracle expandCapacity call for one ERC-20 token.

    chain_id sender token min_capacity

66. prepare_pool_initialization只读

    Prepare standalone pool initialization

    Prepare one permissionless maybeInitializePool transaction for a v3 PoolKey and initial tick; prepare_lp_position_deposit with pool_initialized=false does the same atomically with the mint.

    chain_id sender core_address pool_key initial_tick

67. prepare_revenue_buybacks只读

    Prepare revenue buyback maintenance

    Prepare the exact selected ended-order collections, protocol-fee withdrawals, and token rolls in interface order within one atomic batch of decodable steps.

    chain_id sender ended_order_collects protocol_fee_pairs roll_tokens

68. prepare_rewards_claim只读

    Prepare incentive reward claims

    Prepare one Incentives claim or the interface's allow-failure Multicall3 aggregate for multiple claims.

    chain_id sender claims

69. prepare_sky_savings_deposit只读

    Prepare a Sky savings deposit

    Prepare an exact USDS approval, ERC-4626 sUSDS deposit, and allowance cleanup as one atomic wallet plan. The direct vault interface has no minimum-shares or deadline field, so a fresh preview and exact wallet simulation are mandatory.

    chain_id sender amount receiver

70. prepare_sky_savings_redeem只读

    Prepare a Sky savings redemption

    Prepare a direct sUSDS ERC-4626 redemption for an exact share amount. Use a fresh wallet/RPC balance and preview, then require exact wallet simulation before authorization.

    chain_id sender shares receiver owner

71. prepare_sky_savings_withdraw只读

    Prepare a Sky savings withdrawal

    Prepare a direct sUSDS ERC-4626 withdrawal for an exact USDS amount. The server does not query current exchange rate, capacity, balance, allowance, or preview state.

    chain_id sender amount receiver owner

72. prepare_transfers只读

    Prepare a batch of token transfers

    Prepare one atomic-capable plan of 1 to 4,096 ordered native, ERC-20, ERC-721 and ERC-1155 transfers on one EVM chain, mixed freely. Returns a compact summary and the execution_plan_reference.

    chain_id sender transfers

73. prepare_twamm_order只读

    Prepare a TWAMM or DCA order

    Prepare one or more TWAMM order splits with approvals and native value as one atomic batch. details.token_id is the order's id before anything is sent: keep it, because prepare_twamm_order_collection and prepare_twamm_order_stop are keyed by it and orders are not enumerable by owner. Start and end times must be multiples of 256 seconds near the present, widening in powers of 16 further out.

    chain_id sender sell_token buy_token orders pending_timestamp deadline_seconds salt

74. prepare_twamm_order_collection只读

    Prepare TWAMM proceeds collection

    Prepare collection of every selected order key through the exact current or legacy Orders manager, as one atomic batch of decodable steps, with pending owner validation.

    chain_id sender orders_address token_id order_keys

75. prepare_twamm_order_stop只读

    Prepare stopping a TWAMM order

    Prepare the interface's complete stop flow: collect every selected order and decrease every still-active sale rate in one atomic batch of decodable steps.

    chain_id sender orders_address token_id pending_timestamp orders

76. prepare_twamm_virtual_orders只读

    Prepare TWAMM virtual-order execution

    Prepare the permissionless lockAndExecuteVirtualOrders maintenance call for a current or legacy TWAMM pool.

    chain_id sender pool_key

77. prepare_uniswap_reads只读

    Prepare Uniswap pool and position reads

    Return exact wallet read bundles for pool state, reserves, positions and ownership. V3 supports bounded owner-index enumeration. V4 requires known token IDs. Verify returned tokens, fee, factory/pool key, tick spacing and owner before preparing liquidity operations.

    chain_id version token0 token1 fee tick_spacing hooks pool_address owner token_ids owner_indices

78. prepare_uniswap_v2_add_liquidity只读

    Prepare Uniswap V2 liquidity deposit

    Add liquidity or create a V2 pair with exact token approvals and cleanup. Amounts are raw units; sorted token0/token1 and explicit minimum outputs are required. use_native pays ETH for the wrapped-native side. Execute atomically through the wallet.

    chain_id sender deadline token0 token1 amount0 amount1 amount0_min amount1_min use_native

79. prepare_uniswap_v2_remove_liquidity只读

    Prepare Uniswap V2 liquidity withdrawal

    Burn an exact LP amount through the canonical V2 router; realize accrued fees with principal. Raw minima protect withdrawal proceeds. LP token address is derived from the factory. Optional native unwrapping. V2 has no separate fee claim. Requires atomic LP approval and cleanup.

    chain_id sender deadline token0 token1 liquidity amount0_min amount1_min unwrap_native

80. prepare_uniswap_v3_add_liquidity只读

    Prepare Uniswap V3 liquidity deposit

    Mint a ranged NFT or increase token_id with raw desired amounts and minima. First verify factory fee tick spacing and position tokens/range. Optional initialize_sqrt_price_x96 creates the pool; use_native pays ETH and refunds excess. Exact approvals and cleanup require an atomic wallet.

    chain_id sender deadline token0 token1 amount0 amount1 amount0_min amount1_min tick_lower tick_upper tick_spacing fee token_id use_native initialize_sqrt_price_x96

81. prepare_uniswap_v3_collect_fees只读

    Prepare Uniswap V3 fee collection

    Collect all owed fees without removing liquidity, optionally unwrapping WETH. Verify NFT ownership and currencies first. V3 collect has no onchain deadline; regenerate and simulate before execution.

    chain_id sender deadline token0 token1 token_id unwrap_native

82. prepare_uniswap_v3_remove_liquidity只读

    Prepare Uniswap V3 liquidity withdrawal

    Decrease exact uint128 liquidity, collect principal and all accrued fees, and optionally burn a fully emptied NFT. Raw minima protect withdrawal proceeds. Optional unwrap_native requires verified position currencies.

    chain_id sender deadline token0 token1 token_id liquidity amount0_min amount1_min burn unwrap_native

83. prepare_uniswap_v4_add_liquidity只读

    Prepare Uniswap V4 liquidity deposit

    Mint or increase an exact liquidity amount using raw uint128 token maxima. Zero token0 means native ETH. Uses exact ERC20 and Permit2 approvals with cleanup, settles both signs of accrued-fee deltas on increase, and refunds native surplus. Verify NFT pool key/range and hook behavior; hook_data is forwarded unchanged. Optional pool initialization.

    chain_id sender deadline pool_id token0 token1 fee tick_spacing hooks hook_data tick_lower tick_upper liquidity amount0_max amount1_max token_id initialize_sqrt_price_x96

84. prepare_uniswap_v4_collect_fees只读

    Prepare Uniswap V4 fee collection

    Poke a V4 position with zero liquidity decrease then take both currencies to the sender. Principal remains invested. Verify ownership, pool key and hook behavior first.

    chain_id sender deadline pool_id token0 token1 fee tick_spacing hooks hook_data token_id

85. prepare_uniswap_v4_remove_liquidity只读

    Prepare Uniswap V4 liquidity withdrawal

    Remove liquidity and take principal plus fees to the sender. Optional burn:true requires liquidity:0 and withdraws the entire NFT with minima applied to the full position. Requires exact pool currencies and hook data; uint128 minima bound principal outputs.

    chain_id sender deadline pool_id token0 token1 fee tick_spacing hooks hook_data token_id liquidity amount0_min amount1_min burn

86. prepare_ve33_claim_all_fees只读

    Prepare all ve-token fee claims

    Discover every active vote on VeTokens owned by the sender and generate one atomic batch of decodable VeToken steps claiming all indexed pool fees, with ownerOf and voteState validation calldata. Fees only: votes, stake amounts, lock ends, and NFT ownership are all unchanged.

    chain_id ve_token sender recipient

87. prepare_ve33_claim_fees只读

    Prepare ve-token fee claims

    Generate one call, or an atomic batch of decodable VeToken steps, claiming voter fees from one or more ve-tokens. Fees only: votes, stake amounts, lock ends, and NFT ownership are all unchanged, so this is always safe to run before any other ve(3,3) action.

    chain_id ve_token sender recipient claims

88. prepare_ve33_clear_vote只读

    Prepare ve-token vote clearing

    Remove the active vote from one or more ve-tokens, claiming each stake's current pool fees immediately before its clearVote in one atomic batch. Use this instead of raw clearVote calldata: Ve33 discards pending voter fees when a stake's weight goes to zero, and a current_pool_key that is not the stake's active pool reverts the whole batch. Stake amount, lock end and NFT ownership are untouched; the stake stops directing emissions and earning that pool's voter fees. Prefer prepare_ve33_reallocation when votes move to other pools. See ekubo://docs/ve33-workflow.

    chain_id ve_token sender recipient votes

89. prepare_ve33_extend只读

    Prepare a ve-token extension

    Prepare a direct extension for an unvoted VeToken or an atomic claim-and-extend call when current_pool_key identifies an active vote, so pending voter fees are preserved. Extending moves the stake to a later end time and clears its vote — that is why the claim is compounded into the same call. A stake's end time only ever moves later, here and everywhere else in Ve33. No NFT is burned and no stake leaves the wallet; re-vote afterwards with prepare_ve33_vote. max_duration=true must be the user's explicit choice.

    chain_id ve_token sender ve_id duration_seconds max_duration current_pool_key

90. prepare_ve33_increase_stake只读

    Prepare increasing a ve-token stake

    Prepare the exact approval/native value and increaseStakeAmount call while preserving the existing vote and fee accounting. Non-destructive: the vote is resized rather than cleared, no fees are discarded, and no NFT is burned. The added stake takes the NFT's existing lock end, so it cannot be withdrawn before that time.

    chain_id ve_token sender stake_token ve_id amount

91. prepare_ve33_merge只读

    Prepare merging ve-token stakes

    Prepare fee-safe merging of one or more source NFTs into a destination, including required claims and the selected resulting vote in one atomic batch of decodable steps. Destructive to the sources: each source's stake moves to the destination, its vote is cleared, and the source NFT is burned, so its fees are claimed first and its ID is reported in the plan. The destination keeps its own lock end, which is why no source may end later than it.

    chain_id ve_token sender destination_ve_id destination_pool_key sources resulting_vote

92. prepare_ve33_reallocation只读

    Prepare atomic ve(3,3) reallocation

    Compile a reviewed current allocation into at most 25 target pool-weight shares as one atomic batch of decodable VeToken steps. The default path only claims, splits, and votes: nothing is burned, no lock is extended, and nothing is withdrawn. The optional compact_max_lock strategy fee-safely consolidates active NFTs, extends the survivor to four years, then creates exactly one voting NFT per target; it burns every merged source NFT and lengthens the lock, and explicitly discloses both. Show the get_ve33_allocations result first and pass its exact state_id; hand the wallet the survivor, every burned source, the extension, and the decoded calls. See ekubo://docs/ve33-workflow.

    chain_id ve_token sender current_state_id targets salt_nonce strategy

93. prepare_ve33_reinvest只读

    Prepare ve-token fee reinvestment

    Build the safe phased workflow for 'reinvest my fees': automatically claim all active voter fees, prepare one exact-input swap per claimed non-stake token, then increase one VeToken or every existing active allocation without changing ownership or replacing votes. phase=swap returns jurisdiction metadata inline on the result and on every child swap; it is not permission to trade. For a nonempty restricted_jurisdictions list, follow its execution_notice before requesting any signature. Phases run in order after each confirms: claim (omit claims to discover every active allocation; keep the pre-claim balance snapshots), swap with only the exact claimed deltas, never a pre-existing balance, then stake_all with the refreshed state_id and the measured STONX output.

    phase chain_id ve_token sender claims stake_token fee_balances slippage_bps swap_deadline_minutes source ve_id amount current_state_id

94. prepare_ve33_split只读

    Prepare a ve-token split

    Split a source ve-token with an explicit salt and return the deterministic child token ID; the source vote is preserved with reduced weight and the child starts unvoted with the same lock end. Non-destructive: no stake leaves the wallet, no NFT is burned, no vote is cleared, and no fees are discarded.

    chain_id ve_token sender ve_id amount salt

95. prepare_ve33_stake只读

    Prepare a new ve-token stake

    Create a new VeToken stake with an exact stake-token approval. Max duration is the safe default for new stakes; an explicit shorter duration is optional and no existing NFT, vote, fee balance, or ownership is changed.

    chain_id ve_token sender stake_token amount salt duration_seconds max_duration

96. prepare_ve33_vote只读

    Prepare one ve(3,3) NFT vote change

    Compile one actively voted ve-token into multiple allocations. Unconditionally claims its current pool first, then splits and changes votes in one atomic batch of decodable VeToken steps. Nothing is burned, withdrawn, or transferred: the source keeps a stake and every additional allocation is a newly minted NFT with the same lock end. Prefer the portfolio reallocation workflow for complete state validation.

    chain_id ve_token sender source_ve_id source_amount current_vote allocations unallocated_permille salt_nonce

97. prepare_ve33_withdraw只读

    Prepare expired ve-token withdrawal

    Prepare fee-safe withdrawal of an expired ve-token stake, claiming the active pool first when voted and returning pending owner/stake validation. Ends the position: the stake leaves Ve33 and returns to the owner and the vote is cleared. Only an expired stake can be withdrawn — Ve33 reverts with StakeNotExpired at any earlier time, and there is no early exit or penalty path.

    chain_id ve_token sender ve_id current_pool_key

98. prepare_wrap_unwrap只读

    Prepare a direct wrapped-native wrap or unwrap

    Prepare a direct wrapped-native deposit or withdrawal on a chain with a verified wrapped native token. The response names the wrapped token, which is not WETH everywhere (BNB Chain wraps BNB, Polygon POL, Monad MON).

    chain_id sender direction amount

99. quote_uniswap_liquidity只读

    Calculate Uniswap concentrated liquidity amounts

    Calculate V3/V4 range liquidity, rounded mint/burn amounts and explicit token bounds from a current sqrt-price snapshot and raw token budgets, or an exact liquidity amount. Fees are excluded. Obtain current state using prepare_uniswap_reads.

    tick_lower tick_upper tick_spacing sqrt_price_x96 amount0 amount1 liquidity slippage_bps