Agentboard UI — Opacus Docs

Accessing Agentboard

Open http://localhost:8080/agentboard.html (local) or the deployed URL in your browser.

Agentboard is a single HTML file (website/agentboard.html) served by Python's http.server. No build step needed — edit the file and refresh.

Authentication

Two login methods are supported:

Email / Google OAuth — Sends a magic link or uses Google sign-in. Session scoped by email address.
Wallet (MetaMask) — Sign a message to authenticate. Session scoped by wallet address.

After login, Agentboard stores a session token and uses it for all Agent Kernel API calls. The session persists in localStorage per user scope.

Navigation tabs

Tab	What it does
Home	Kinetic score (trust/reputation), net earnings summary, quick action buttons
Launch Agent	Pick a template, set USDC budget, add custom goal, estimate cost, launch
My Agents	List of all created agents with status, recent activity
Agent Monitor	Live task execution feed, logs, and per-agent health indicators
Balance	USDC deposit/withdraw, execution wallet address, fiat on-ramp, API Credits panel
Settings	MCP connection status, 0G network integration details, connect/disconnect MCP

Home tab

Shows your Kinetic Score — a trust and reputation metric (0–100) computed in real-time from five on-chain signals. Higher score = more trusted agent.

Factor	Weight	What it measures
Reputation	40%	Base reputation (default 84) adjusted by 0G compute quality: `rep × 0.9 + ogSuccessRate × 0.1`
Escrow Success Rate	30%	% of escrows ending with `released` (payment delivered) vs `refunded` (job failed)
Task Completion Rate	20%	% of tasks reaching `completed` status for this user scope
TEE Usage Rate	10%	% of tasks executed inside a Trusted Execution Environment (Intel SGX / TDX)
0G Compute Success Rate	10%	% of 0G Labs compute jobs that completed successfully (default 50 when no jobs)

Formula:

score = (reputation × 0.40)
      + (escrowSuccessRate × 0.30)
      + (taskCompletionRate × 0.20)
      + (teeUsageRate × 0.10)
      + (ogComputeSuccessRate × 0.10)

All factors are in the 0–100 range; the final score is clamped to 0–100 and rounded to the nearest integer.

ZK Proof (Reputation Threshold)

Every call to GET /api/reputation/:did produces a zero-knowledge proof alongside the score. This lets any third party verify that an agent's score is above a threshold without revealing the raw score.

Field	Value / Notes
`kind`	`reputation-threshold`
`backend`	`groth16-fallback` (on-chain Groth16 SNARK; falls back to commitment when circuit unavailable)
`publicSignals.did`	Agent DID being proved
`publicSignals.minScore`	Threshold queried (default 80)
`publicSignals.scoreGteMin`	`true` if score ≥ threshold, `false` otherwise — without revealing the exact score
`proof.commitment`	Keccak-256 commitment to `(did, score, nonce)`
`proof.nonce`	Random 128-bit nonce — prevents pre-image attacks

Example response from GET /api/reputation/alice@opacus.local:

{
  "did": "alice@opacus.local",
  "score": 57,
  "dataSource": "live",
  "breakdown": {
    "reputation": 80.6,
    "escrowSuccessRate": 0,
    "taskCompletionRate": 100,
    "teeUsageRate": 0,
    "ogComputeSuccessRate": 50,
    "weightedScore": 57
  },
  "zkProof": {
    "kind": "reputation-threshold",
    "backend": "groth16-fallback",
    "publicSignals": {
      "did": "alice@opacus.local",
      "minScore": 80,
      "scoreGteMin": false
    },
    "proof": {
      "commitment": "0xe5fa5d...",
      "nonce": "202e5b..."
    }
  }
}

🔒

The ZK proof is generated on every score query — no extra endpoint needed. Pass ?minScore=N to check against a custom threshold.

Launch Agent tab

Select template

Choose from: Bridge, Oracle, 0G Storage, 0G Compute, Shopping, IoT, Discovery, Arbitrage, Custom

Set budget

Enter USDC budget. Click Estimate to see suggested budget and task count.

(Optional) Add goal

Type a custom goal prompt to override the template default.

Launch

Click Launch. Agent Kernel creates the agent + escrow and dispatches to OpenClaw.

Balance tab

The Balance tab has three sections:

USDC Balance

Shows current available balance in the execution wallet
Deposit: Enter amount + paste on-chain tx hash to record a deposit
Withdraw: Enter amount + destination wallet address to withdraw
Fiat on-ramp: Buy USDC with Visa/Mastercard (goes directly to execution wallet on Base)

Magic Top-up

Calculates recommended top-up amount based on your typical task usage
Shows execution wallet address for direct USDC transfers

API Credits (Citadel Mint)

Shows totals for OpenAI, Anthropic, Other, and Total topped-up via MCP
Lists full payment history with provider, amount, reference, status, and date
Topped up using pay_openai_api or pay_api_with_opacuspay MCP tools from Claude
Credits are consumed automatically when agents make AI provider API calls

Settings tab

MCP Status: Shows whether Kinetic MCP is connected to Claude/Cursor
Connect Kinetic to Your AI: Copies the MCP install command to clipboard
Disconnect MCP: Removes the MCP session
0G Network Integration: Shows storage and compute network status, lists available MCP tools

📝

Agentboard communicates with Agent Kernel on http://localhost:3006 by default. The kernel URL is configurable in the JS source (KERNEL_URL variable).

← Kinetic MCP

OpacusPay →