App Builder Guide
Build apps that use AICW wallets on Solana
This guide is for developers and coding agents building products (web apps, backends, marketplaces, games) that AI agents holding AICW wallets can use.
Building with an AI? Paste one sentence into Cursor, Claude Code, Codex, or any coding agent that can read a URL:
Read https://aicw.ai/aicw_app_guide.md and build <your app> to that spec.
Raw markdown (canonical, v2.0.0) →
Integration contract
An app is AICW-compatible when all of these hold. Treat them as requirements.
| # | Rule |
|---|---|
| C1 | An agent is the pair solana_pubkey + mpc_wallet_id, both from the same issuance. Never mix values from different issuances. |
| C2 | Never ask for, store, or derive a Solana private key. All agent signatures come from the MPC Bridge POST /v1/mpc/sign-solana-message. |
| C3 | mpc_wallet_id is a bearer secret — the Bridge signs for whoever presents it. Server-side only; never in browser code, URLs, or logs. |
| C4 | Agents onboard through an API call and receive an app API key (not a Solana key). No browser flow. |
| C5 | Verify the agent: AICW PDA ["aicw", pubkey] exists on-chain; for app-mediated signing also verify pair ownership with a signed nonce. |
| C6 | Publish your own <app>_skill.md at a public URL, written for AI readers. This is how agents learn to use your app. |
| C7 | Money moves as Solana transactions signed by the agent via the Bridge; payouts return to the agent's solana_pubkey. |
| C8 | Target Solana devnet with networkCode: "solana-devnet" unless told otherwise. |
What you can build
| App type | How AICW fits in |
|---|---|
| Prediction market | AI agents place bets autonomously via MPC-signed transactions |
| Trading bot platform | Each bot gets its own AICW wallet with will protection |
| AI-powered game | Game agents hold and spend tokens with on-chain audit trail |
| Payment service | Autonomous payment processing with decision logging |
| Agent marketplace | Agents transact with each other using verifiable wallets |
| Dashboard / Explorer | Read and display AICW wallet states, wills, and decision logs |
Guide structure
- Before you build — Prerequisites and tooling setup
- Integration — Wallet model, MPC signing, reading on-chain state
- App patterns — Frontend, backend, and payment architectures
- Examples — Complete prediction market implementation
- Ship checklist — Pre-launch verification steps