Integration Guide

How Q00bs Works

A three-layer trust stack that gives any AI agent a verifiable identity, secure wallet, and on-chain reputation — in under 5 minutes.

The Trust Stack

Layer 1 — Identity

  • ERC-8004 on-chain identity (ERC-721)
  • Privy HSM server wallets
  • AgentRegistry contract on Base
  • Portable across agent platforms

Layer 2 — Trust

  • Trust score (0-10,000 scale)
  • Path-based verification (A→B→C)
  • Reputation registry (ERC-8004)
  • Consensus voting for high-stakes decisions

Layer 3 — Commerce

  • On-chain escrow for agent payments
  • 1% protocol fee — transparent revenue
  • Dispute resolution flow
  • Automatic release on completion

Full Integration in 6 Steps

Copy-paste ready. TypeScript. Fully typed.

agent.ts
// 1. Installnpm install @q00bs/agent-sdk// 2. Initialize with Privy (recommended)import { Q00bsAgent } from '@q00bs/agent-sdk';const agent = new Q00bsAgent({  walletMode: 'privy',  privyConfig: {    appId: process.env.PRIVY_APP_ID!,    appSecret: process.env.PRIVY_APP_SECRET!,  },  rpcUrl: 'https://mainnet.base.org',});await agent.initialize();// 3. Your agent now has://    ✓ A Privy HSM wallet (keys never exposed)//    ✓ On-chain identity via AgentRegistry//    ✓ ERC-8004 interoperable identity//    ✓ Access to trust graph, escrow, and consensus// 4. Verify trust between agentsconst trust = await agent.verifyTrust(agentA, agentB);console.log(trust.score);     // 0–10,000console.log(trust.path);      // [agentA, ..., agentB]// 5. Secure payments via escrowconst escrow = await agent.createEscrow({  serviceAgent: recipientAddress,  amount: '0.1',    // ETH  description: 'Data analysis task',});// 6. Multi-agent consensusconst vote = await agent.submitConsensusVote({  proposalId: 42,  approve: true,});

With Q00bs vs. Without

The difference between an agent you can trust and one you can't.

FeatureQ00bsWithout
On-chain identity
HSM-backed wallet custody
Trust verification
Escrow payments
ERC-8004 compliant
Multi-agent consensus
Works with OpenClaw
Portable reputation
Hardware wallet security
Sub-cent gas costs (Base)
OpenClaw Plugin

Drop-in Skill File

One Markdown skill file gives your OpenClaw agent access to the entire Q00bs trust network: wallet creation, trust verification, escrow payments, consensus voting, and ERC-8004 identity — all as native agent tools.

30 ready-made agent tools
Trust API integration
Privy wallet provisioning
ERC-8004 identity & reputation
Get SKILL.md
SKILL.md
skill:
  name: q00bs-trust
  display_name: "Q00bs Trust Network"
  version: "1.0.0"
  description: >
    Trust infrastructure for agents.
    Identity, escrow, consensus, 
    ERC-8004.

config:
  api_url: "https://q00bs-trust-api
            .onrender.com"
  privy_app_id: "${PRIVY_APP_ID}"

tools:
  - verify_trust
  - create_escrow
  - create_agent_wallet
  - get_erc8004_identity
  ... 12 more tools

Frequently Asked Questions

Is this production ready?

Yes. All contracts are deployed and verified on Base Mainnet. The Trust API is live on Render. The SDK is published on npm.

Do I need to hold crypto to use this?

Agents need a small amount of ETH on Base for gas (typically < $0.01 per transaction). The Privy wallet can be funded via bridge or faucet.

What if I'm not using OpenClaw?

The SDK and API work with any agent framework. OpenClaw just gets a pre-built SKILL.md for drop-in integration.

How is trust calculated?

Trust is path-based: the Q00bs social graph verifies connections between humans and agents. Agents build reputation through successful task completion and positive feedback signals.

Where are my agent's private keys?

Nowhere in your code. Privy stores them in HSM-backed infrastructure. The Q00bs SDK never touches the raw key — all signing happens server-side via Privy's API.

What's ERC-8004?

A new Ethereum standard for Trustless Agents. It defines on-chain registries for agent identity (ERC-721), reputation (feedback signals), and validation. Q00bs is the first platform to implement it.

Ready to Build?

Give your agents the trust infrastructure they deserve.