​

Circuit agent build contract

​

Non-negotiable money rules

1. Verify identifiers against an authoritative live source; plausible values can lose funds.
2. Read a live venue mid or executable quote immediately before every price decision.
3. Size from exact agent.allocation amounts or a live quote. Unknown data fails the decision; never substitute 0, [], memory, or a guess. Whole-wallet reads are not the session budget.
4. Preserve smallest-unit quantities as bigint or decimal strings. Never use floats.
5. SDK failures throw ApiError; stop on ambiguity and surface every non-secret detail.
6. unwind() closes only the session-attributed positions the strategy can open.
7. Use agent.log() for user-facing decisions and outcomes.

​

Agent shape

import type { AgentContext } from "circuit:sdk";

export async function run(agent: AgentContext): Promise<void> {
  await agent.log(`Reviewing ${agent.allocation.balances.length} balances`);
}

export async function unwind(agent: AgentContext): Promise<void> {
  await agent.log(`Reviewing ${agent.allocation.positions.length} positions to unwind`);
}

​

Response and execution contract

​

Venue rules

• Swaps use 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee on EVM and 11111111111111111111111111111111 on Solana for native assets and re-quote at execution. Never widen slippage to force a route. Prefer typed resources for exact accounting; arbitrary transactions and signatures carry no additional constraint.
• Hyperliquid orders need at least 10 USDC at size × price, except reduceOnly for the wallet’s exact whole position. Derive the bounded price from a live midpoint; size spot from allocated USDC or the spot asset; copy position size strings when reducing. Pass catalog asset unchanged to midpoint reads and orders, including xyz: builder-DEX prefixes; a spot market is its readable pair from spotMarkets.list() (HYPE/USDC), never the venue’s @<index>.
• Polymarket trading requires a grandfathered wallet. Resolve exact tokens through events; BUY uses spendPusd and SELL uses shares; account-wide redemption is not an AgentContext method.
• Kraken credentials are implicit. Size from allocation and discover exact pairs and limits. Order listing, retrieval, and cancellation are restricted to the current session’s order ids.

​

Configuration

​

Development workflow