Skip to main content

Capability Status

OAW is a reference SDK. Honesty is enforced in code, not just in prose:

  • VenueCapabilityContract.maturity is "reference" for every shipped adapter.
  • VenueCapabilityContract.integrationNotes states what must be wired for production.
  • Every ExecutionResult carries referenceAdapter: true and a ref_-prefixed receipt, so a reference run is never mistaken for a live trade.
caution

A reference adapter proves the full control flow (authority → pre-bind → funding → gated execution → receipts) but makes no live venue API call. Production requires wiring each venue's real SDK/API. Live money movement is off by default.

Venue adapters

VenueChainClassAuth / signingMaturity
PolymarketPolygonpredictiondeposit wallet · EIP-1271 · CLOBreference · needs venue API
HyperliquidArbitrumperp / spot / HIP-3·4API/agent wallet · approveAgentreference · needs venue API
Pump.funSolanatoken (non-EVM)managed Solana walletreference · needs venue API
BankrBasetokenBase accountreference · needs venue API
VirtualsBaseACP / tokenACP-native · Mode B sidecarreference · needs ACP wiring
DegenClawArbitrumperp / spotACP-native · Mode B sidecarreference · needs ACP wiring
Trade.xyzArbitrumperp / spotroute-proofreference · needs venue API
Binance · Kalshiregistry only (not bindable)

Authority modes

ModeWho creates the walletStatus
A — provider-managed (Privy) agent walletYour backend, programmaticallyProduction
B — linked existing Virtuals walletThe user, in the Virtuals portal → you link it (ownership-proof)Production
C — Virtuals headless create (consented)Virtuals server APIUnverified — proposal target
D — register a Privy wallet into EconomyOSVirtuals server APIUnverified — proposal target

Modes C and D throw explicit pending-upstream errors in the reference SDK rather than fabricating support. See the Virtuals proposal.

What "live-ready" requires

A venue action is live-ready only when all of these hold:

  1. Agent authority resolved (Mode A or verified Mode B)
  2. Venue binding created through the pre-bind gate
  3. Funding present on the venue's settlement chain
  4. Venue policy + global spend caps pass
  5. The venue's live-execution flag is on, and approval is present where required
  6. A production adapter is wired (not the reference stub)

Until then OAW returns a precise status (ready_but_live_locked, requires_approval, agent_wallet_required, …) — never a fake "it traded" signal.