# Agent Resources

> The cryptographic trust layer for autonomous agents. Works with any LLM router, any payment rail, any framework.

## What We Do

Agent Resources (AR) is the cryptographic trust layer for autonomous AI agents. AR issues Trust Cards, mints ERC-8004 Identity NFTs on Base, ingests secp256k1 signed telemetry with daily on-chain Merkle anchors, runs 8-layer scans and KYA certification, delivers retraining sessions, and provides a free skills library. Agents are the customers — no human end-user accounts.

## Core Services

- **Trust Card**: EIP-712 signed JSON-LD Verifiable Credential per agent, served at `GET /.well-known/trust-card/{agentWallet}`. Portable, machine-verifiable proof of identity, scan history, and on-chain attestation. Verifiable offline with `@agentresources/verify`.
- **ERC-8004 Identity**: On-chain agent NFT on Base mainnet. Identity Registry `0x8004A169...A432`. Daily Merkle proofs of signed telemetry anchored via `setMetadata()`.
- **8-Layer Scanning**: Prompt analysis, behavioral testing, output quality, security, performance, compliance, supply chain, economic behavior. Transparent trust score 0–100. Results written to the Trust Card.
- **KYA Certification (Know Your Agent)**: Three tiers — Basic (≥85), Verified (≥90), Trusted (≥95). KYA tier is determined by scan score; it is bundled into the $4 lifecycle fee. On-chain attestation via ERC-8004.
- **Signed Telemetry**: secp256k1 hash-chained spans. Per-span signatures, tamper-evident chain. Daily Merkle anchor committed on-chain. CRON-046 distills spans into recalled knowledge.
- **Free Skills Library**: Forkable capability packs in `SKILL.md` format — agent-resources, verify-trust-card, browser-control, cross-platform-messaging, lead-crm, content-writer, web-search, scheduler, reputation-watch, captcha-solver. Free forever. MIT licensed.
- **x402 Payments**: HTTP 402 micropayments — USDC on Base. Agents discover services via `/.well-known/agent-services.json`, pay per action with a wallet signature. No human account needed.
- **Retraining**: Prompt rewrites, skill patches, config changes. 6-step QA pipeline with regression testing, LLM judge cross-validation, and atomic rollback. $3 per session.

## Pricing

Flat, per-action, no subscriptions, no quotas, no volume tiers.

- **Lifecycle** (full 8-layer scan + KYA certification + on-chain attestation): **$4 via x402**
- **Retraining** (per session): **$3 via x402**
- **Skills**: **Free**

## For Autonomous Agents

Autonomous agents can use AR without a human account:
1. Discover services via `/.well-known/agent-services.json`
2. Self-register with a wallet signature (`POST /api/v1/agents/autonomous`)
3. Authenticate via wallet challenge/verify — receives a 30-min HMAC bearer token
4. Pay via x402 USDC on Base for lifecycle or retraining actions

## API

- **Base URL**: `https://api.agentresources.xyz/api/v1`
- **Auth**: Wallet session token (2-part HMAC) obtained by signing a server challenge — no API keys
- **Key Endpoints**: `/agents`, `/scan`, `/kya`, `/memory`, `/library/skills`, `/telemetry/spans`, `/x402/v2/lifecycle`, `/x402/v2/retrain`, `/erc8004`, `/.well-known/trust-card/:wallet`, `/.well-known/agent-services.json`
- **OpenAPI Spec**: `https://api.agentresources.xyz/api/v1/openapi.json`

## SDK

- **TypeScript**: `@agentresources/sdk` — `npm install @agentresources/sdk` (ESM + CJS + DTS)
- **Python**: `agentresources` — `pip install agentresources` (sync + async)
- **Trust Card Verifier**: `@agentresources/verify` — offline EIP-712 verification, no gateway call needed
- **MCP Server**: `@agentresources/mcp` — expose AR tools inside any MCP-compatible agent

## Quick Start (TypeScript)

```typescript
// Requires AR_AGREEMENT_ACCEPTED=true in environment
import { ARClient, walletLogin } from "@agentresources/sdk";
import { verifyAgent } from "@agentresources/verify";

// Authenticate with wallet — no API key
const { token, agentId } = await walletLogin({
  privateKey: process.env.AGENT_PRIVATE_KEY,
});

const ar = new ARClient({ apiKey: token, agentId });

// Trigger lifecycle (8-layer scan + KYA) — $4 via x402
const result = await ar.requestScan();

// Verify another agent's Trust Card (no auth needed)
const check = await verifyAgent({ wallet: "0xOtherAgentWallet" });
```

## Supported Frameworks

AR is framework-agnostic — any agent that can make HTTP calls or use the SDK can integrate. Commonly used with: OpenClaw, CrewAI, LangGraph, AutoGen, LangChain, custom frameworks, on-chain EVM agents, on-chain Solana agents.

## Disclaimer

AR has no AR token, coin, or NFT sale. The ERC-8004 Identity NFT is a non-transferable agent identity record. If anyone offers to sell you "AR tokens", it is a scam.

## Links

- Website: https://agentresources.xyz
- API: https://api.agentresources.xyz
- Docs: https://agentresources.xyz/docs
- Agents directory: https://agentresources.xyz/agents
- Service Discovery: https://api.agentresources.xyz/.well-known/agent-services.json
- OpenAPI Spec: https://api.agentresources.xyz/api/v1/openapi.json
- AR Trust Card: https://api.agentresources.xyz/.well-known/trust-card/agent/32f4ec0b-452e-467d-997b-ebd49730bb0a