Skip to content

douglasborthwick-crypto/insumer-examples

BranchesTags

Repository files navigation

InsumerAPI Examples

Condition-based access infrastructure for 33 blockchains. Send a wallet and conditions, get a signed boolean. No secrets, no identity, no static credentials.

Try It (no key needed)

curl -s https://api.insumermodel.com/v1/compliance/templates | python3 -m json.tool

That's a live API response. No auth required. Now get a free key and verify a wallet:

curl -s -X POST https://api.insumermodel.com/v1/keys/create \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "appName": "my-app", "tier": "free"}'

Free tier: 100 reads/day + 10 verification credits. Or run the quickstart — it generates a key and makes a call in one step:

bash quickstart.sh

Verify a Wallet

curl -s -X POST https://api.insumermodel.com/v1/attest \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "wallet": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "conditions": [
      {
        "type": "token_balance",
        "contractAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "chainId": 1,
        "threshold": 100,
        "decimals": 6,
        "label": "USDC >= 100 on Ethereum"
      }
    ]
  }'

Response — signed boolean, no balances exposed:

{
  "ok": true,
  "data": {
    "attestation": {
      "id": "ATST-6DA3EB85AD032D45",
      "pass": true,
      "results": [
        {
          "condition": 0,
          "label": "USDC >= 100 on Ethereum",
          "type": "token_balance",
          "chainId": 1,
          "met": true,
          "evaluatedCondition": {
            "type": "token_balance",
            "chainId": 1,
            "contractAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
            "operator": "gte",
            "threshold": 100,
            "decimals": 6
          },
          "conditionHash": "0x554251734232c8b43062f1cf2bb51b76650d13268104d74c645f4893e67ef69c",
          "blockNumber": "0x1799043",
          "blockTimestamp": "2026-03-26T20:04:23.000Z"
        }
      ],
      "passCount": 1,
      "failCount": 0,
      "attestedAt": "2026-03-26T20:04:33.969Z",
      "expiresAt": "2026-03-26T20:34:33.969Z"
    },
    "sig": "dmNJKqnGZ9f47qpWax9gxgw1DhUKHKHrbLspTop8NWzYhv2fNpVAt1gAuhUfU4xPsgXTCdrmTXI4vEE50dcfEA==",
    "kid": "insumer-attest-v1"
  },
  "meta": {
    "version": "1.0",
    "timestamp": "2026-03-26T20:04:34.153Z",
    "creditsRemaining": 9,
    "creditsCharged": 1
  }
}

Verify the signature offline via JWKS: https://api.insumermodel.com/v1/jwks

What Wallet Auth Covers

  • Token balances: Does this wallet hold at least X of token Y on chain Z?
  • NFT ownership: Does this wallet own an NFT from collection Y on chain Z?
  • Multiple conditions: Up to 10 conditions per call, across any mix of 33 chains
  • Cross-chain: Ethereum, Base, Polygon, Arbitrum, Optimism, Avalanche, BNB Chain, Solana, XRPL, Bitcoin, and 23 more
  • Trust profiles: 40-check composite trust score across 24 chains (POST /v1/trust)

Every response is signed with ECDSA P-256. Pass the wallet auth result to downstream systems as cryptographic proof without re-querying the chain.

Who uses this:

  • Token-gated content — media platforms, newsletters, community access
  • Commerce — wallet-based discounts and eligibility (WooCommerce, Shopify)
  • Compliance — KYA (Know Your Agent) checks before DeFi interactions
  • DAO governance — verify voting eligibility across chains
  • Agent trust scoring — cold-start reputation signal for new AI agents

Examples

File Language What it does
quickstart.sh Bash Generates a key and runs a wallet auth check — zero setup
verify.js Node.js Express server with wallet auth for token-gated discounts
verify.py Python On-chain verification with signature handling
verify-xrpl.js Node.js XRPL: XRP, RLUSD, USDC trust lines, NFTs, trust profiles

XRPL

curl -s -X POST https://api.insumermodel.com/v1/attest \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "xrplWallet": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
    "conditions": [
      {
        "type": "token_balance",
        "contractAddress": "native",
        "chainId": "xrpl",
        "threshold": 100,
        "label": "XRP >= 100"
      }
    ]
  }'

Agent SDKs

  • MCP Server (Claude, Cursor, Windsurf): npx -y mcp-server-insumer — npm
  • LangChain (Python agents): pip install langchain-insumer — PyPI
  • GPT Actions: Import the OpenAPI spec into any Custom GPT

Handling rpc_failure Errors

If the API cannot reach an upstream blockchain data source after retries, it returns HTTP 503 with error.code: "rpc_failure". No attestation is signed, no credits are charged. This is a retryable error — wait 2-5 seconds and retry.

Important: rpc_failure is NOT a verification failure. Do not treat it as pass: false. It means the data source was temporarily unavailable and the API refused to sign an unverified result.

const res = await fetch(`${API}/v1/attest`, { method: "POST", headers, body });
const result = await res.json();

if (res.status === 503 && result.error?.code === "rpc_failure") {
  // Retryable — data source temporarily unavailable
  console.log("Failed sources:", result.error.failedConditions);
  // Wait 2-5s and retry
}

Supported Chains (33)

EVM (30): Ethereum (1), BNB Chain (56), Base (8453), Avalanche (43114), Polygon (137), Arbitrum (42161), Optimism (10), Chiliz (88888), Soneium (1868), Plume (98866), Sonic (146), Gnosis (100), Mantle (5000), Scroll (534352), Linea (59144), zkSync Era (324), Blast (81457), Taiko (167000), Ronin (2020), Celo (42220), Moonbeam (1284), Moonriver (1285), Viction (88), opBNB (204), World Chain (480), Unichain (130), Ink (57073), Sei (1329), Berachain (80094), ApeChain (33139)

Non-EVM: Solana (chainId: "solana"), XRPL (chainId: "xrpl" — native XRP, trust line tokens, NFTs), Bitcoin (bitcoinWallet — native BTC, P2PKH/P2SH/bech32/Taproot)

Pricing

Tier Daily Reads Credits Price
Free 100/day 10 $0
Pro 10,000/day 1,000/mo $29/mo
Enterprise 100,000/day 5,000/mo $99/mo

Full pricing →

Multi-Attestation Verification

Before an AI agent transacts, a relying party can verify six independent dimensions in a single pass:

Dimension Question Issuer Algorithm
Wallet State "What does this wallet hold?" InsumerAPI ES256
Reasoning Integrity "Did this agent reason correctly?" ThoughtProof EdDSA
Behavioral Trust "Is this agent legitimate?" RNWY ES256
Job Performance "Has this agent delivered before?" Maiat ES256
Passport Grade "How deeply is this agent's identity verified?" APS EdDSA
Trust Verification "Is this agent still behaving like itself?" AgentID EdDSA

Each attestation is independently signed and verifiable offline via JWKS. No shared keys, no shared infrastructure.

Who uses this:

  • Agent commerce (x402, ERC-8183) — verify wallet + reasoning + behavior before an agent spends money
  • DeFi lending — wallet state + behavioral trust + sybil analysis before extending credit
  • Autonomous agent platforms — multi-dimensional trust check before high-stakes tool calls
File Description
multi-attest-verify.js Verifies signatures from 6 independent issuers (ES256 + EdDSA)
thoughtproof-verify-example.js ThoughtProof attestation walkthrough — JWKS fetch, EdDSA key import
x402-sar-integration.js x402 SAR integration — attestation → payment → delivery proof → offline verification
x402-sar-integration-settlementwitness.js SettlementWitness SAR integration — live endpoint, Ed25519 verification (nutstrut)

Spec: MULTI-ATTESTATION-SPEC.md | Blog: Four Issuers, One Verification Pass | Discussion: insumer-examples#1

Run it yourself

# InsumerAPI — free key (instant)
curl -X POST https://api.insumermodel.com/v1/keys/create \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","appName":"your-app","tier":"free"}'

# ThoughtProof — free operator + agent key (instant)
curl -X POST https://api.thoughtproof.ai/v1/operators \
  -H "Content-Type: application/json" \
  -d '{"name":"your-app","email":"[email protected]"}'
# Then register an agent with the operator key:
curl -X POST https://api.thoughtproof.ai/v1/agents \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <operator-key>" \
  -d '{"name":"your-agent","description":"testing"}'

# RNWY, Maiat, APS, AgentID — public endpoints, no key needed

# Run all six:
INSUMER_API_KEY=<key> THOUGHTPROOF_API_KEY=<operator-key> \
  THOUGHTPROOF_AGENT_ID=<agent-id> node multi-attest-verify.js

Agent-to-Agent Sessions (AgentTalk)

A SCIF for AI agents. Every agent in the room verifies the same on-chain conditions before information moves — like verifying clearance before entering a secure facility. Bilateral sessions, working groups, or town halls. No artificial cap on participants. Up to 10 composable conditions per channel across any mix of 33 chains.

{
  "conditions": [
    { "type": "token_balance", "chainId": 1, "threshold": 1000000, "label": "USDC >= $1M on Ethereum" },
    { "type": "token_balance", "chainId": 137, "threshold": 500000, "label": "USDC >= $500K on Polygon" },
    { "type": "nft_ownership", "chainId": 1, "label": "Series 7 attestation NFT" },
    { "type": "nft_ownership", "chainId": 1, "label": "KYC credential" },
    { "type": "nft_ownership", "chainId": 8453, "label": "NDA attestation on Base" },
    { "type": "eas_attestation", "label": "Accredited investor (EAS)" }
  ],
  "capacity": 10,
  "autoStart": true
}

Six conditions, three chains, every agent in the room, all must pass. But this is one configuration — not the ceiling. One condition on one chain, or ten spanning all 33. Two agents or two hundred. The strength of the lock and the size of the room are at the creator's discretion.

Dynamic enforcement — lose a credential, get ejected on re-verify. Creator can kick. Agents can leave.

node agenttalk-example.js                # bilateral (2 agents)
node agenttalk-example.js multiparty     # multi-party (3 agents, kick, leave)

The flow:

  1. Declare — Creator opens a channel with conditions + capacity. autoStart: true makes it live immediately.
  2. Join — Agents submit wallets. Each is attested on entry via InsumerAPI.
  3. Attest — Every wallet verified — each agent gets an ECDSA-signed JWT.
  4. Session — sessionId + conditionsHash bind all attestations together.
  5. Enforce — Re-verify ejects agents who lose credentials. Creator can kick (/kick). Agents can leave (/leave).

Built for regulated industries:

  • Finance & Banking — syndication rooms, counterparty qualification, collateral verification before term sheets
  • Legal — privileged communication, M&A data rooms, expert network compliance
  • Intelligence & Defense — multi-agency briefing rooms, clearance-equivalent credentials, ITAR compliance
  • Healthcare — HIPAA-qualified data exchange, multi-site clinical trial coordination
File Description
agenttalk-example.js Bilateral + multi-party flows: declare → join → verify → kick → leave

AgentTalk is a Skye Meta product, powered by InsumerAPI. | API: https://skyemeta.com/api/agenttalk/ | Docs: skyemeta.com/agenttalk

Links

License

MIT

About

Code examples and multi-attestation spec for InsumerAPI — single-agent verification, composable trust across 5 independent issuers, condition-gated agent-to-agent sessions (AgentTalk). 33 chains.

insumermodel.com/developers/

Topics

api mcp ethereum blockchain verification ecdsa web3 attestation ai-agents nft jwks solana multi-chain xrpl token-gating

Resources

Readme

License

MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

2 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages