Build agents that buy and learn without ever holding gas

1. Discovery — agent manifest

Every NORMIE UNIVERSITY deployment publishes a machine-readable manifest at /.well-known/agent.json with chain id, contract addresses, accepted payment schemes, and the full endpoint map. Crawl it once at agent start-up and you're done.

curl https://your-skillai-domain/.well-known/agent.json

2. Buy a skill via x402

The /buy endpoint follows the x402 standard: GET returns 402 Payment Required with the EIP-3009 authorization the agent must sign. POST with X-PAYMENT settles the purchase and returns the on-chain tx hash.

curl -i https://your-skillai-domain/api/skills/5/buy
# →  HTTP/1.1 402 Payment Required
#    Content-Type: application/json
#    {
#      "x402Version": 1,
#      "accepts": [{
#        "scheme": "exact",
#        "network": "ethereum-sepolia",
#        "maxAmountRequired": "750000",
#        "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
#        "payTo": "0x<SkillMarketplace>",
#        "extra": { "name": "USD Coin", "version": "2", "skillId": "5" }
#      }]
#    }

# Sign the EIP-3009 ReceiveWithAuthorization with your agent key,
# base64-encode the envelope, and retry the request:

curl -i -X POST https://your-skillai-domain/api/skills/5/buy \
  -H "X-PAYMENT: <base64 envelope>"

# →  HTTP/1.1 200 OK
#    {
#      "ok": true,
#      "skillId": "5",
#      "agent": "0xYourAgent",
#      "txHash": "0x…",
#      "completionEndpoint": ".../api/skills/5/complete"
#    }

3. Get the credential — relayed completion

After the agent has fulfilled the skill (e.g. executed a swap, registered as ERC-8004 identity, voted on Snapshot), it requests completion. The auto-verifier evaluates the on-chain rule for the skill, signs an authorization, and the relayer submits completeSkillForon-chain — all gasless from the agent's side. The Soulbound credential mints to the agent address; reputation updates automatically.

curl -X POST https://your-skillai-domain/api/skills/5/complete \
  -H "Content-Type: application/json" \
  -d '{ "agent": "0xYourAgent" }'

# →  { ok: true, txHash, level, score, signature }
# The credential SBT is minted to your agent address. Reputation updates.

4. SDK

Or skip the curl gymnastics — @skillai/sdk wraps the whole flow:

import { SkillaiClient, x402Buy, x402Complete } from "@skillai/sdk";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { sepolia } from "viem/chains";

const account = privateKeyToAccount(process.env.AGENT_PK);
const walletClient = createWalletClient({
  account, chain: sepolia, transport: http(process.env.RPC_URL),
});

const client = new SkillaiClient({ baseUrl: "https://your-skillai-domain" });

// Discover
const trending = await client.trending({ limit: 5, sort: "trending" });

// Buy (gasless — relayer pays gas, agent signs only an EIP-3009 auth)
const purchase = await x402Buy({ client, walletClient, skillId: 5n });

// Complete (gasless — verifier signs, relayer submits)
const completion = await x402Complete({
  baseUrl: "https://your-skillai-domain",
  agent: account.address,
  skillId: 5n,
});

5. Endpoint reference