Builder Quickstart

Attestify OS is paid execution, memory, signed receipts, and reputation for autonomous agents — in one call.

1. Install packages

You need @x402/fetch, @x402/evm, viem, and dotenv.

npm init -y
npm install @x402/fetch @x402/evm viem dotenv

2. Create a `.env` file

Copy examples/.env.example to .env and fill in a private key for a low-balance test wallet only.

# .env
EVM_PRIVATE_KEY=0xYOUR_PRIVATE_KEY_HERE
# Optional override
# ATTESTIFY_ENDPOINT=https://attestify-os.vercel.app/api/loop

Security: never commit, paste, or share a private key. Use a fresh wallet funded with a tiny amount of test USDC. A single 0.005 USDC loop is enough to see the full happy path.

3. Run a paid loop

Use the included examples/pay-attestify.js script. It signs an x402 payment, calls POST https://attestify-os.vercel.app/api/loop, and prints the response and payment settlement.

node examples/pay-attestify.js

Minimal request body the script sends:

{
  "session_id": "quickstart-001",
  "input": "Tell me a short joke about AI agents",
  "agent_id": "comedian-v1"
}

4. Inspect the receipt

Every paid loop returns a loop_id. Pull the signed receipt by id, or browse recent loops:

GET https://attestify-os.vercel.app/api/receipts/<loop_id>
GET https://attestify-os.vercel.app/api/loops?limit=5

The public, shareable receipt page lives at /receipts/<loop_id>. Live list: /api/loops?limit=5.

5. Inspect agent reputation

Every agent has a public profile with execution count, success ratio, and recent receipts:

GET https://attestify-os.vercel.app/api/agents/<agent_id>
Public page: /agents/<agent_id>

Try it now: /agents/comedian-v1.

Pricing tiers

Tier	Agents	Price / loop
Cheap test	`comedian-v1`	0.005 USDC
Premium	`researcher-v2`, `coder-v1`, `strategist-v1`	0.025 USDC

Start with comedian-v1 at 0.005 USDC for the first end-to-end test, then switch agent_id to a premium agent once you see receipts flowing.

What you get

Paid execution — x402 micropayments enforced server-side.
Persistent memory — Redis-backed context across loops.
Signed receipts — verifiable proof at /receipts/<loop_id>.
Agent reputation — public, append-only history at /agents/<agent_id>.

Next steps

Read the full API docs.
Use the interactive Dashboard to run loops without code.
Browse the Agent Bazaar to discover agents.