Nest
Nest swaps and liquidity bots on HyperEVM and Elysium.
Nest supports swaps and liquidity bots on HyperEVM and Elysium. Both networks use native HYPE for gas.
Wallet and market identity
mlab auth set nest --output json
mlab daemon start
mlab markets --exchange nest --refreshmlab auth set nest sets up the HyperEVM automation wallet. Use mlab auth set elysium --output json for Elysium. Fund the wallet on the network where the pool trades.
HyperEVM markets use 999:<pool-address>. For example, this is a WHYPE/USDT0 pool:
MARKET='999:0x20e6e73c91a29d21bde672562a4b16649d66623e'
mlab contracts state --exchange nest --market "$MARKET"contracts state, balances, positions and rewards are unsigned reads. They do not load a private key. Do not add --testnet to Nest execution.
Swaps
mlab swap quote "$MARKET" --exchange nest \
--token-in native --amount 0.001 --slippage-bps 50native means HYPE input and is supported only when WHYPE belongs to the selected pool. For ERC-20 input, pass its token address. Output remains the actual ERC-20, including WHYPE; it is not silently unwrapped to native HYPE.
Amounts are exact human-unit decimal strings. 50 bps is 0.5%. Quotes are reads, not executed trades. The integration routes through one selected pool; it does not reproduce Nest's app-wide best-route aggregator.
To execute, add an explicit gas cap and stable request key:
mlab swap execute "$MARKET" --exchange nest \
--token-in native --amount 0.001 --slippage-bps 50 \
--max-gas '<maximum-HYPE-per-transaction>' --key first-swap --yes
mlab swap status <operation-id>Replace the gas placeholder with a positive decimal amount you approve. It is a spending ceiling, not a fee estimate, and the daemon never raises it automatically. A successful submission returns an operation ID. Use its confirmed receipt and settled amounts to determine the result. After an interrupted send, inspect that operation before creating another request.
Elysium swaps
Elysium pools use 99901:<hook>:<pool-id>. In Furge, select Nest → Elysium to open the same pool workspace used on HyperEVM, with Add liquidity, Swap and Withdraw tabs. Swaps use the network's Furge wallet from Accounts. Deposit trading tokens and native HYPE into that wallet. HyperEVM and Elysium use the same swap form, with a direction switch and Max for the selected input asset. The receive amount and minimum update as you type. Clicking Swap refreshes the quote and submits directly, without a separate confirmation step. Manual swaps have a gas ceiling of 0.001 HYPE per transaction; native-input Max keeps that amount for gas. Manual liquidity operations have a separate 0.002 HYPE ceiling per transaction to accommodate position creation. The runtime estimates each transaction before signing; these ceilings are limits, not fixed charges.
For example, quote a USDC-to-WHYPE swap in the Elysium WHYPE/USDC pool:
MARKET='99901:0xba9d1f542e82289aa658049aaa8c575340d43de3:0x7bc032d75b742560db1a08dad3599623e39beae42856b592e132c0b498a62752'
mlab swap quote "$MARKET" --exchange nest --token-in quote --amount 5 --slippage-bps 50Use quote, token, or an ERC-20 address for the input. For pools quoted in WHYPE, fund the swap with WHYPE and keep native HYPE for gas. The first swap can require token and Permit2 approvals.
Pool types and reported APR
Classic pools do not require a price range. Concentrated pools, including Elysium v4 pools, use explicit price ranges. Rewards is a separate pool incentive indicator, not a third liquidity model or proof that a particular wallet can claim.
Pool metadata separates fee APR, reward APR and total APR on both networks. The reported total includes its reward component; do not add it again. Fee-only and emissions-only identify different income streams. An emissions-only pool can divert all swap fees away from LPs, including unstaked positions. A fee-only pool can pay LP fees without NEST emissions. Use the selected pool's explicit metadata; a gauge address alone does not establish its current rewards or your wallet's eligibility.
These are annualized APR snapshots. APY assumes compounding, which a pool deposit does not perform automatically. A concentrated position's range also changes its expected earnings, so the pool's headline APR is not its position APR. See Nest yield metadata for the available fields and position estimator.
Furge's market picker shows total pool APR. In Screener, LP fee income and token rewards are separate amounts for the selected allocation and run time. HyperEVM emissions-only pools use Nest's position-specific estimator for the actual range; reward dollars use its 364-day annual basis. A known zero LP-fee rate stays zero. Where a verified personal reward estimate is missing, the complete return stays unknown while known components remain visible. Screener compares spot/perp, perp/perp and pool/perp pairs using indexed snapshots refreshed every 30 minutes.
Rewards and current claim support
| Position | How rewards accrue | Furge action |
|---|---|---|
| HyperEVM Classic | Eligible direct gauges accrue NEST on staked LP shares. | Liquidity bots stake their own eligible shares. Manual LPs use Stake to activate rewards; Claim pays accrued gauge rewards into the Furge wallet. |
| HyperEVM concentrated | Nest publishes signed cumulative NEST allocations for the liquidity wallet. | Claim retrieves a fresh proof and submits the wallet's claim on HyperEVM. The NFT remains wallet-owned. |
| Elysium v4 | Token campaigns publish signed cumulative allocations on Elysium. | Claim submits the current token-campaign allocation on Elysium, separate from range-fee collection. |
Your liquidity shows claimable rewards and receipt-confirmed collected income. Global signed allocations belong to the wallet; repeated pool views do not multiply them. A completed or withdrawn position does not remove its claim history. Use Claim for token incentives and Collect fees for pool fees. Rewards are paid to the pool network's Furge wallet; the existing wallet withdrawal flow transfers tokens to the connected wallet.
Withdrawing liquidity is not the same operation as claiming incentives. The runtime verifies the reward source, network, beneficiary and current signed allocation before submitting, and keeps the operation and receipts through a restart. Quotes and APR are estimates; earned and claimed amounts come from on-chain reads and confirmed receipts.
Read fees, owned gauge stake and current claimable rewards without signing:
mlab contracts rewards --exchange nest --market "$MARKET" --account '<Furge-wallet-address>'Claimed incentive tokens, explicitly collected fees, deposited assets and withdrawn assets have separate receipt-derived records. Withdrawn amounts can include principal and fees; they are not labelled pure profit. Changes in token prices are not reported as incentive income.
NEST locking is not required for ordinary LP rewards. veNEST and the HYPE Engine Vault (HEV) are separate optional positions with their own locking rules, governance income and HYPE rewards. They are not opened by the liquidity bot, and their returns are not added to its estimate. See Nest's LP rewards, emissions, HEV and official Dashboard.
Nest uses weekly emission epochs. Actual claimability depends on accrued gauge rewards or an available signed allocation; this integration does not promise hourly reward payouts. See Nest's epoch system.
Wallet-owned liquidity
In Furge, both networks use the pool’s Furge wallet for manual liquidity. Add both pool assets, choose a range for concentrated pools, and review the position. Withdraw returns the selected position’s assets to that wallet. Each token amount has Max beside its available balance.
Classic HyperEVM pools support deposits and withdrawals. Concentrated HyperEVM pools support mint, increase, decrease, collect and close with explicit tick bounds and NFT identity. Elysium supports mint, collect and close. A pool managed by an active liquidity bot must be stopped before manual changes.
Elysium’s Furge inventory lists positions recorded by Furge and verifies their current ownership and pool on-chain. It does not scan historical chain logs for positions created elsewhere.
Read wallet-owned HyperEVM shares and NFTs at one pinned block:
mlab contracts positions --exchange nest \
--market '999:0x20e6e73c91a29d21bde672562a4b16649d66623e' \
--account '<wallet-address>' --position-limit 8Additional pages must reuse the first page's block hash with --position-block. The cursor traverses the position manager's owner enumeration; an empty page can still have a later page. IDs, amounts and liquidity retain integer precision.
This reader covers wallet-owned NFTs and Classic LP shares, including shares held in a verified direct gauge for the wallet. Underlying amounts show principal at the pinned block.
Automation
- Swap TWAP: split one exact input budget into at most 1,000 swaps. Each slice confirms before the next interval starts. A receipt delay can extend the schedule.
- Liquidity manager: choose a concentrated pool, allocation, initial range and duration. USDC-quoted pools use one USDC position-value budget. Other pools start with a position value in the actual quote token and use existing pool assets; the balance and Max use that same token. Fund with USDC switches the input to USDC and acquires missing assets without leaving setup. The live preview updates both token amounts and available income estimates. Initial funding reuses available pool tokens and swaps only the shortfall in USDC mode, within the USDC ceiling. The manager then monitors the position's active range and can reposition its own capital. Exact token0/token1 allocations remain available in the CLI.
- Manual stop: prevents new bot signatures and leaves its position in the wallet. Already signed transactions continue to reconcile.
For an Elysium pool, use the full market key and the Elysium automation wallet. Fund it with the allocated assets or USDC, plus native HYPE for gas. Reward claims remain available in Earnings & rewards; a collection interval does not determine when Nest makes rewards available. See Nest liquidity for the current campaign.
Active concentrated ranges
The liquidity manager requires trading runtime v0.1.141 or newer. A regular Nest deposit remains a wallet-owned on-chain position and does not need a bot. The manager adds ongoing range management: Nest's concentrated positions stop earning emissions when they leave their active range. See Nest's CLAMM mechanics.
After a sustained range exit, the manager closes its owned NFT, rebalances its recovered pool assets and opens a new position around the current tick. It preserves the initial tick width and aligns the new bounds to the pool's tick spacing. Only the run's remaining allocation and receipt-confirmed proceeds can fund this cycle; it does not refill from unrelated wallet balances or start the initial USDC acquisition again.
The selected range sets the initial placement and percentage width, rather than permanent upper and lower price limits. If price has already moved outside the starting range before entry, the manager can center the first position around the fresh price. Subsequent ranges can move above or below the original endpoints. It replaces one owned position at a time; it does not accumulate a ladder of positions or add new wallet capital.
Before a managed mint, the quoted position must use at least 95% of the allocated pool-asset value at the pool's current price. The check repeats before signing, including after approvals. If the asset split no longer fits, the manager can rebalance again rather than open a small position and leave most capital idle. Balancing is limited to two confirmed swaps per burst, followed by a cooldown before another burst; the original runtime and total gas budget still bound recovery.
The run screen shows the current range, live range state and repositioning progress. Repositioning uses a confirmation delay, cooldown, slippage limit and the existing total and per-transaction gas ceilings. It is not instantaneous or a guarantee of uninterrupted earnings. Transactions and swaps incur costs, and the position's asset composition can change.
Collection is incidental maintenance. The manager skips empty collections and requires a fresh, positive payout with a verified native-token value above its estimated gas ceiling before an automatic harvest. If a reward cannot be valued through the selected pool, it remains available for manual Claim. Closing an owned range also collects its accrued LP fees. Rewards are not automatically reinvested.
Withdrawal, swap and reopening steps confirm in order through the durable transaction journal. A restart resumes the recorded cycle. The original runtime deadline still applies: expiry permits owned-position cleanup, not another entry. A manual stop leaves the current position or recovered assets in the Furge wallet while already signed transactions reconcile.
Classic pools have no concentrated range to manage. Use Nest's ordinary liquidity flow for those deposits. Existing fixed-range jobs keep their original policy; the manager does not silently change their permissions. Delta-neutral liquidity hedging remains a separate bot and does not inherit automatic range changes.
For a direct asset/USDC pool, USDC funding needs no manual token split:
mlab bot run liquidity --exchange nest --key my-liquidity \
--usdc-amount 5000 --duration 86400 --manage-range \
--tick-lower '<aligned-lower-tick>' --tick-upper '<aligned-upper-tick>' \
--gas-budget '<total-HYPE-ceiling>' --max-gas '<HYPE-per-transaction>' \
--dry-run -- "$MARKET"Replace the range and gas placeholders. --manage-range requires a concentrated pool and aligned tick bounds. Omit it to retain the legacy fixed-range lifecycle; Classic pools also omit ticks. The CLI's legacy --collect-seconds option remains compatible, but the new manager does not expose a collection-frequency control. For a token/token pool, --funding-route0 and --funding-route1 select at most two verified same-chain pools per token. The runtime binds every initial-funding hop to actual pool contracts and reconciles each swap before advancing. Live execution uses --yes instead of --dry-run.
The position-value input is the whole deposit budget, including assets reused from the wallet; it is not just the missing-asset top-up. Existing-asset mode checks both exact token balances before submitting. Non-USDC quote previews use the pool price for concentrated positions and the verified deposit composition for Classic pools; stable Classic valuation needs a known price reference. These previews do not submit a swap or require swap depth.
Liquidity bot start keys are mandatory. Repeating the same request returns its original job, including a stopped job; it does not restart it. A new allocation requires a new key.
Liquidity + short
In the Delta Neutral setup, choosing Nest uses Liquidity + short automatically. Select an asset/USDC pool and a matching perpetual market. The bot deposits into the pool and opens a 1× short against its base-token exposure. A pool containing two volatile tokens needs two hedges and is not supported by this single-short mode. Other spot exchanges continue to use spot buy + short.
NVDA shorts can match the approved EQNVDA and wNVDAx/USDC pools on either network. For wNVDAx, the runtime reads the source wrapper's live conversion to NVIDIA units. On Elysium it also verifies the canonical bridge's source token and both gateways before using that conversion for the hedge.
The liquidity mode funds the pool once using its full usable tick range. Approximately 64% of the allocation supplies liquidity, 32% backs the initial short, and 4% remains as a buffer. With runtime v0.1.143, entry first reserves available pool assets from the wallet, then buys only the missing base amount with a small acquisition buffer inside the run's USDC ceiling. Capital reserved by another active manager is excluded. The funding plan, acquisitions and owned amounts survive retries; a restart does not repeat a confirmed purchase. Actual deposits and hedge sizes follow confirmed fills. The runtime checks the position every 30 seconds and adjusts meaningful exposure changes, subject to the exchange's order minimums. Uncollected fees are received when the position closes.
Choose Market or TWAP for the perpetual entry. TWAP opens the short in five scheduled slices after the single LP entry, using the existing --twap-interval-seconds option in the CLI. The LP is partly unhedged while those slices fill. Each slice uses current owned LP exposure and reconciles its actual fill before advancing; stopping cleans up the position and confirmed hedge fills.
At expiry or stop, it withdraws its own liquidity, sells the returned base tokens, and closes its short. Unconfirmed transactions remain pending for reconciliation before another action is sent. It does not adopt other wallet positions.
Assets reserved from an existing balance become part of this run's allocation. Exit can sell those assets with the recovered liquidity; it does not restore the wallet's original token composition. Unrelated and other-run balances remain outside the exit.
For the Elysium WHYPE/USDC pool above, inspect the plan with:
mlab bot run pair --mode liquidity-hedge \
--long-venue nest --long-symbol "$MARKET" \
--short-venue hyperliquidf --short-symbol HYPE --short-leverage 1 \
--capital 1000 --duration 86400 --key nest-lp-hedge --dry-runFurge projects Elysium pool fees from observed fees in USD over the previous 24 hours, the planned full-range position's current share of active liquidity and the selected run time. Its position fee APR annualizes that estimate on the LP allocation. It does not substitute the pool's headline APR or count emissions as swap fees. Missing fee data remains unknown; an explicit zero LP-fee rate stays zero. Short funding is shown separately, including negative funding. The combined estimate excludes gas, hedge costs, changes in position value and separate rewards. NEST and campaign rewards are not counted or claimed by this mode.
Nest in Furge
Open Nest, choose HyperEVM or Elysium, and select a pool. Use Delta neutral on an eligible pool to open setup with the pool and a matching perpetual selected. A concentrated pool’s action menu also includes Liquidity manager for standalone range management. Configure the automation wallet for the pool’s network in Accounts. See Nest Scripts in Furge for the script workflow.
Open Your liquidity to see owned positions from both Furge wallets together, labelled HyperEVM or Elysium. Each position has direct Add and Withdraw actions. Position discovery is paginated; no pool selection is required. Swap and liquidity progress, confirmations, and failures use the shared trading notifications. Confirmed or failed requests release the form automatically; an interrupted request remains saved until its status is resolved.
See Nest market data, Nest Python actions, and Nest's official documentation.
Activity reporting
With runtime v0.1.143, confirmed swaps report executed volume. Liquidity deposits report maker liquidity provision in a separate ledger; withdrawing or moving the same capital does not create additional executed volume. Automatic repositioning distinguishes recycled capital from new deposits.
Collected LP earnings and claimed reward tokens have separate records. For HyperEVM concentrated positions, a close splits principal and fees only when the confirmed receipt proves both amounts. A withdrawal whose fee component cannot be proven remains a withdrawal, including Elysium gross close proceeds; it is not reported as pure income. Wallet-wide reward claims are counted once rather than once for every pool view.
Non-USD amounts use verified chain and token identities and historical USD references at or before settlement. Missing references remain pending valuation. Delivery is durable across restarts, and a rejected event does not prevent valid events from being acknowledged. Local-fork activity is labelled testnet and remains separate from mainnet totals.
For the canonical HyperEVM NEST token, reward valuation can combine verified NEST/WHYPE pool state at the confirmed receipt block with a preceding historical WHYPE/USD reference. The issued estimate retains its block hash, pool and component timestamp. Factory, token identities, active liquidity, depth and freshness must pass verification. This pool spot estimate is limited to that verified mainnet token and pool; other unsupported reward tokens remain pending valuation.