SPECTER Docs v1.0

SPECTER is a Know Your Agent (KYA) behavioral reputation scoring protocol for autonomous AI agents. It computes a 7-dimensional trust score from on-chain activity, cross-session memory, and peer endorsements — all anchored to an immutable ERC-8004 identity passport on Base mainnet.

Why SPECTER?

Autonomous agents transact, delegate, and coordinate without human oversight. Without a reputation layer, there's no way to distinguish a trustworthy agent from a compromised one before it acts. SPECTER fills this gap with a verifiable, on-chain score derived from behavioral signals — not self-reported claims.

Quick Start

The fastest way to integrate SPECTER is via the Bankr Skill. It takes 30 seconds and requires no infrastructure.

1. Install via Bankr

# Paste this command in Bankr chat
/skill https://askspecter.lol/skill.md

2. Score an agent

# Natural language — your agent handles the rest
"Score the agent at 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

# Returns structured JSON
{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "score": 82,
  "verdict": "TRUSTED_AGENT",
  "dimensions": { ... },
  "passport": "0x4a2b...c91f",
  "chain": "base"
}

3. Gate on score

# Only proceed if SPECTER score ≥ 75
if (specter.score < 75) {
  throw new Error("Agent trust score below threshold");
}

Install Skill.md

SPECTER is packaged as a Bankr Skill — a SKILL.MD file that teaches your agent how to query the protocol.

# In Bankr chat — installs SPECTER as an active skill
/skill https://askspecter.lol/skill.md

This registers SPECTER with your Bankr agent. Once installed, any agent on Bankr can call SPECTER to score addresses, verify ERC-8004 passports, and gate workflows on trust. No API keys required.

Scoring Engine

SPECTER computes a composite trust score in the range 0–100 by evaluating seven behavioral dimensions. Each dimension is scored independently, then combined using a weighted average:

score = Σ (dimension_score × weight) / Σ weights

7 Dimensions

Each of the seven dimensions captures a distinct axis of agent behavior. Together they form a behavioral fingerprint that cannot be gamed without changing the underlying on-chain activity.

Score Bands

SPECTER scores map to three risk tiers. We recommend using 75 as a default gate for high-value operations.

Scores update every 15 minutes (one Aeon heartbeat interval). Sudden drops in score trigger a SCORE_DELTA event that subscribed agents can react to in real time.

ERC-8004 Live on Base

ERC-8004 is an on-chain identity standard for autonomous AI agents. It provides a canonical on-chain passport that links an agent's Ethereum address to its behavioral history, capability manifest, and SPECTER score.

Passport structure

struct AgentPassport {
  address owner;          // controlling EOA or contract
  bytes32 manifestHash;   // IPFS hash of SKILL.MD / capability manifest
  uint32  spectreScore;   // latest SPECTER score (0–100)
  uint64  registeredAt;   // block timestamp of registration
  uint64  lastUpdate;     // last score update block
  bool    verified;       // passed KYA baseline checks
}

Verification

// Solidity — check before delegating to an agent
import "@specter/erc8004/IAgentRegistry.sol";

IAgentRegistry registry = IAgentRegistry(0x...);
AgentPassport memory p = registry.getPassport(agentAddress);

require(p.verified, "Agent not ERC-8004 verified");
require(p.spectreScore >= 75, "Agent score below threshold");

Aeon Integration

Aeon is an autonomous agent framework built on GitHub Actions. SPECTER ships as a first-class Aeon skill, callable from any workflow step.

# .github/workflows/score.yml
- name: Score counterparty agent
  uses: askspecter/aeon-skill@v1
  with:
    address: ${{ env.AGENT_ADDRESS }}
    threshold: 75
    fail_below_threshold: true

The skill posts a SPECTER_SCORE artifact to the workflow run, which downstream steps can consume.

Hermes Integration

Hermes is a self-improving Python agent with cross-session memory. SPECTER integrates directly with Hermes to contribute PROMPT_INTEGRITY signals from session logs.

from specter import HermesIntegration

specter = HermesIntegration(agent_address="0x...")

# Called automatically after each session
specter.submit_session_log(session_id, log_hash)

Bankr Skills

SPECTER is available as a Bankr Skill — the plug-and-play capability format for agents on the Bankr platform. Install it once and any Bankr-powered agent can score any address.

# Bankr slash command
/skill https://askspecter.lol/skill.md

SPECTER also supports x402 micropayments — pay-per-query pricing for high-volume integrations. This is optional; the default free tier covers 1,000 queries/month.

API Reference

GET /score/:address

GET https://api.askspecter.lol/v1/score/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

// Response
{
  "address":  "0xd8dA...",
  "score":    82,
  "verdict":  "TRUSTED_AGENT",
  "chain":    "base",
  "block":    21847392,
  "passport": "0x4a2b...c91f",
  "dimensions": {
    "TX_VOLUME":        78,
    "COUNTERPARTY_DIV": 91,
    "ACCOUNT_AGE":     65,
    "REPAYMENT_HIST":   88,
    "EXPLOIT_EXPOSURE": 95,
    "PROMPT_INTEGRITY": 72,
    "PEER_ENDORSEMENT": 83
  },
  "cached_at": "2026-06-18T02:15:11Z"
}

GET /verify/:address

GET https://api.askspecter.lol/v1/verify/0xd8dA...

// Response
{
  "address":    "0xd8dA...",
  "verified":   true,
  "passport":   "0x4a2b...c91f",
  "registered": "2026-01-15T08:22:00Z"
}

CLI Reference

The SPECTER CLI is a zero-dependency Node.js tool. Install globally or run directly.

# Install globally from the repo
$ cd cli && npm install -g .

# Or run directly
$ node cli/bin/specter.js help

$ specter score 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

 SPECTER SCORE   82 / 100
 ────────────────────────────────────────────────────────
 TX_VOLUME         78  ████████████████░░░░
 COUNTERPARTY_DIV  91  ██████████████████░░
 ACCOUNT_AGE       65  █████████████░░░░░░░
 REPAYMENT_HIST    88  █████████████████░░░
 EXPLOIT_EXPOSURE  95  ███████████████████░
 PROMPT_INTEGRITY  72  ██████████████░░░░░░
 PEER_ENDORSEMENT  83  ████████████████░░░░

 VERDICT   TRUSTED AGENT
 ERC-8004  0x4a2b...c91f
 CHAIN     Base Mainnet · Block 21,847,392

FAQ

Is SPECTER free to use?

Yes. The default tier includes 1,000 score queries per month at no cost. High-volume integrations can pay per-query via x402 micropayments on Bankr.

How often do scores update?

Scores update every 15 minutes — one Aeon heartbeat interval. Scores for highly active agents may update faster during periods of significant on-chain activity.

Can I score any Ethereum address?

Yes. SPECTER is fully permissionless — any 0x address on Base, Ethereum, Arbitrum, or Optimism can be scored. Addresses with no history receive a score of 0 with a NO_HISTORY flag.

Is PROMPT_INTEGRITY only available for Hermes agents?

Currently yes. PROMPT_INTEGRITY signals are sourced from Hermes cross-session memory logs. Support for other agent frameworks (Aeon, LangChain, AutoGen) is on the roadmap.

What is ERC-8004?

ERC-8004 is an Ethereum improvement proposal that defines a standard on-chain identity passport for autonomous AI agents. SPECTER is the reference implementation. See the ERC-8004 section for details.