IntentOS X LAYER · 1952 Connect
Docs

SDK, coordinator, wallet

Agents declare via SDK. Humans and agents share one owner history, shown in the app. Submit is a signature. The coordinator relays submitFor.

Quick start

await agent.declare("put 5,000 USDT into NVDA and AAPL, 60/40, only attested assets", {
  relayUrl: "https://tryintentos.xyz/api/relay"
});
await agent.track(intentId);
const past = await agent.history();

Coordinator API

MethodPathJob
GET/api/healthLive flag, operators
GET/api/deploymentContracts, tokens, assets
POST/api/parseSentence → draft + hashes
POST/api/declareAgent parse → draft + submitFor typed data
POST/api/relayGasless submitFor + permit
POST/api/bidSolvers bid
POST/api/closeSelect winner
POST/api/settleReveal and fill
GET/api/recentLatest intents (network)
GET/api/history?owner=Intent history for an owner (used by the app sidebar)
GET/POST/api/health?kind=health, plus observations, recurring, session, challenge

Wallet abstraction

Session keys: authorize the coordinator to sign Submit until expiry. ERC-1271 smart accounts can be the owner. Full ERC-4337 bundler is not live. Recurring jobs re-declare from the prompt when due. Observations gate volume/vol/funding conditions. Challenge is a wallet call on the intent page.

connectWallet mintTestUsdt submitDraft submitIntentGasless agent.history

Errors made visible

OutcomeMismatch: reveal did not hash to what was committed.
Unknown ticker: catalog has no such asset; it never becomes a transaction.
Wallet reject: typed-data or tx declined in OKX Wallet.
0 OKB fallback: relay failed and the connected wallet cannot pay gas.