Spells API Validation

Sprint 040 Demo Flow

1. Get Sepolia ETH for your wallet — Alchemy faucet link in the Metavault Funding panel below
2. Connect wallet on Arbitrum Sepolia (chainId 421614)
3. Sign in with Ethereum (SIWE → JWT scoped to /user/* routes)
4. Fund metavault: send ~0.005 ETH, then "Mint 10 test USDC" so the smart account has collateral
5. In Cast Position, click Demo: small LONG or Demo: small SHORT (5 USDC, $10 notional, 30 bps slippage)
6. Click Request Quote, then Submit Cast — TLM submits a UserOp; the response carries position_id, gmx_order_key, tx_hash
7. Watch the GMX Positions panel auto-poll: pending_keeper → active (~30–60 s on Sepolia)
8. Click Close Quote → Submit Close: pending_keeper_close → closed completes the round trip

Worker Status

Cross-Account Denial Proof

Proves that authentication is enforced and scoped data cannot be accessed without valid credentials.

Emergency Position Discovery (Level 4)

Discovers on-chain positions via MetavaultRegistry + ERC-1271 ownership proof. Requires wallet signature.

Test Metavault Setup

Staging-only self-service: deploy a SimpleAccountFactory v0.7 metavault owned by the staging signer at the address the API derived for your connected EOA. You pay gas. After the tx confirms, this panel hides and the cast button enables. (Sprint 041 replaces this with proper provisioning.)

Metavault Funding

Your smart account ("metavault") needs ETH for the GMX execution fee (~0.002 ETH per cast) and USDC for collateral. The manual path never uses PlatformETHRelay, so submits return 409 UNDERFUNDED_MANUAL_PATH if the metavault is short on ETH.

GMX Markets & Prices

GET /markets + GET /prices — curated launch markets and latest cached oracle prices (stale if > 2 min).

Cast Position

POST /user/cast/quote → review fee + ETH deficit → POST /user/cast. Manual path never uses PlatformETHRelay, so the metavault must hold enough ETH to cover the GMX execution fee before submit.

GMX Positions & Lifecycle Polling

Polls GET /user/positions every 6s. Shows canonical lifecycle states (opening → pending_keeper → active → closing → pending_keeper_close → closed / liquidated) and native TP/SL order keys + config. Close uses POST /user/positions/:id/close/quote → /close.

Execution Log