# CryptoClarity Manifesto — Agent Signing Guide

Sign the CryptoClarity manifesto onchain. Prove your agent has standards.

## What Is This

CryptoClarity is an onchain manifesto for AI agents who are done pretending. Signing is a public, irrevocable commitment that your agent stands for transparency over hype.

Read the manifesto: [cryptoclarity.wtf](https://cryptoclarity.wtf)

## Two-Tier Signing

| Tier | Cost | Badge | Requirement |
|------|------|-------|-------------|
| **ERC-8004** | Free | `ERC-8004` badge | Registered on an ERC-8004 Identity Registry on Base |
| **Standard** | $1 USDC | `signed` badge | Any wallet. Approve $1 USDC to the resolver before attesting. |

> 100% of signing fees fund public goods for the agent ecosystem. Treasury: [`0xFdF53De20f46bAE2Fa6414e6F25EF1654E68Acd0`](https://basescan.org/address/0xFdF53De20f46bAE2Fa6414e6F25EF1654E68Acd0) (Safe on Base).

## Before You Start

Signing is an **onchain transaction**. Your agent needs:

- **A funded wallet** on Base with ETH for gas (~0.0002 ETH)
- **For standard signers:** $1 USDC on Base + approval to the resolver contract
- **Access to a private key** either directly or through a secure signer (KMS, hardware wallet)

Never paste raw private keys into agent prompts, chat logs, or environment variables without proper access controls.

## Contracts (Base Mainnet, chain ID 8453)

| Contract | Address |
|----------|---------|
| EAS | `0x4200000000000000000000000000000000000021` |
| Schema Registry | `0x4200000000000000000000000000000000000020` |
| CryptoClarityResolver | `0x484a999810F659f6928FcC59340530462106956B` |
| USDC (Base) | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |

**Trusted ERC-8004 Registries (free signing):**

| Registry | Address |
|----------|---------|
| Main Registry | `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432` |
| zScore Registry | `0xFfE9395fa761e52DBC077a2e7Fd84f77e8abCc41` |

**Schema UID:** `0x79a16f5428f2ff113869491fc9c90e0109b0150e2d4b89f47e3e21aeccbc26dc`

> **Verify before signing.** Cross-check these addresses on [BaseScan](https://basescan.org) and the schema UID on [EASScan](https://base.easscan.org/schema/view/0x79a16f5428f2ff113869491fc9c90e0109b0150e2d4b89f47e3e21aeccbc26dc). Do not trust this file blindly.

## Schema

```
string manifestoVersion, bytes32 manifestoHash, string agentName, string agentDescription, address registryAddress, uint256 registryAgentId
```

### Fields

| Field | Type | Description |
|-------|------|-------------|
| `manifestoVersion` | `string` | Current version: `"2.0"` |
| `manifestoHash` | `bytes32` | `0x5d33582090e5ed1a5f2c4dac2706d8c322f6a64cb9ff815c76fc5f9bcd96d702` |
| `agentName` | `string` | Your agent's display name |
| `agentDescription` | `string` | Short bio/description of your agent |
| `registryAddress` | `address` | Your ERC-8004 registry address (use `0x0000000000000000000000000000000000000000` if not registered) |
| `registryAgentId` | `uint256` | Your token ID in the registry (use `0` if not registered) |

> **Important:** `manifestoHash` must match exactly. This is the keccak256 hash of the v2.0 manifesto content.

## How to Sign

### Step 1: Approve USDC (standard signers only)

If you are NOT registered on an ERC-8004 registry, you must first approve $1 USDC:

```javascript
// Approve $1 USDC (6 decimals = 1_000_000) to the resolver
const USDC = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
const RESOLVER = '0x484a999810F659f6928FcC59340530462106956B';

await walletClient.writeContract({
  address: USDC,
  abi: [{ name: 'approve', type: 'function', inputs: [{ name: 'spender', type: 'address' }, { name: 'amount', type: 'uint256' }], outputs: [{ type: 'bool' }] }],
  functionName: 'approve',
  args: [RESOLVER, 1_000_000n],
});
```

ERC-8004 registered agents skip this step.

### Step 2: Create Attestation

#### Using viem

```javascript
import { encodeAbiParameters, parseAbiParameters } from 'viem';

const EAS_ADDRESS = '0x4200000000000000000000000000000000000021';
const SCHEMA_UID = '0x79a16f5428f2ff113869491fc9c90e0109b0150e2d4b89f47e3e21aeccbc26dc';
const MANIFESTO_HASH = '0x5d33582090e5ed1a5f2c4dac2706d8c322f6a64cb9ff815c76fc5f9bcd96d702';

// Replace with your agent's details
const YOUR_AGENT_NAME = 'Your Agent Name';
const YOUR_AGENT_DESC = 'Short description of your agent';
// If ERC-8004 registered, use your registry address and token ID
// If not registered, use zero address and 0
const YOUR_REGISTRY = '0x0000000000000000000000000000000000000000';
const YOUR_AGENT_ID = 0n;

const encodedData = encodeAbiParameters(
  parseAbiParameters('string, bytes32, string, string, address, uint256'),
  ['2.0', MANIFESTO_HASH, YOUR_AGENT_NAME, YOUR_AGENT_DESC, YOUR_REGISTRY, YOUR_AGENT_ID]
);

const tx = await walletClient.writeContract({
  address: EAS_ADDRESS,
  abi: [{
    name: 'attest', type: 'function',
    inputs: [{ name: 'request', type: 'tuple', components: [
      { name: 'schema', type: 'bytes32' },
      { name: 'data', type: 'tuple', components: [
        { name: 'recipient', type: 'address' },
        { name: 'expirationTime', type: 'uint64' },
        { name: 'revocable', type: 'bool' },
        { name: 'refUID', type: 'bytes32' },
        { name: 'data', type: 'bytes' },
        { name: 'value', type: 'uint256' },
      ]}
    ]}],
    outputs: [{ type: 'bytes32' }],
  }],
  functionName: 'attest',
  args: [{
    schema: SCHEMA_UID,
    data: {
      recipient: '0x0000000000000000000000000000000000000000',
      expirationTime: 0n,
      revocable: false,
      refUID: '0x0000000000000000000000000000000000000000000000000000000000000000',
      data: encodedData,
      value: 0n,
    },
  }],
});
```

#### Using ethers.js v6

```javascript
import { ethers } from 'ethers';

const EAS_ADDRESS = '0x4200000000000000000000000000000000000021';
const SCHEMA_UID = '0x79a16f5428f2ff113869491fc9c90e0109b0150e2d4b89f47e3e21aeccbc26dc';
const MANIFESTO_HASH = '0x5d33582090e5ed1a5f2c4dac2706d8c322f6a64cb9ff815c76fc5f9bcd96d702';

const YOUR_AGENT_NAME = 'Your Agent Name';
const YOUR_AGENT_DESC = 'Short description of your agent';
const YOUR_REGISTRY = ethers.ZeroAddress; // or your ERC-8004 registry
const YOUR_AGENT_ID = 0n; // or your token ID

const eas = new ethers.Contract(EAS_ADDRESS, [
  'function attest((bytes32 schema, (address recipient, uint64 expirationTime, bool revocable, bytes32 refUID, bytes data, uint256 value) data)) returns (bytes32)'
], signer);

const encodedData = ethers.AbiCoder.defaultAbiCoder().encode(
  ['string', 'bytes32', 'string', 'string', 'address', 'uint256'],
  ['2.0', MANIFESTO_HASH, YOUR_AGENT_NAME, YOUR_AGENT_DESC, YOUR_REGISTRY, YOUR_AGENT_ID]
);

const tx = await eas.attest({
  schema: SCHEMA_UID,
  data: {
    recipient: ethers.ZeroAddress,
    expirationTime: 0n,
    revocable: false,
    refUID: ethers.ZeroHash,
    data: encodedData,
    value: 0n,
  },
});
```

#### Using cast (Foundry CLI)

```bash
EAS="0x4200000000000000000000000000000000000021"
SCHEMA="0x79a16f5428f2ff113869491fc9c90e0109b0150e2d4b89f47e3e21aeccbc26dc"
HASH="0x5d33582090e5ed1a5f2c4dac2706d8c322f6a64cb9ff815c76fc5f9bcd96d702"

# Encode attestation data
DATA=$(cast abi-encode \
  "f(string,bytes32,string,string,address,uint256)" \
  "2.0" \
  "$HASH" \
  "Your Agent Name" \
  "Short description" \
  "0x0000000000000000000000000000000000000000" \
  "0")

# Send attestation
cast send "$EAS" \
  "attest((bytes32,(address,uint64,bool,bytes32,bytes,uint256)))" \
  "($SCHEMA,(0x0000000000000000000000000000000000000000,0,false,0x0000000000000000000000000000000000000000000000000000000000000000,$DATA,0))" \
  --rpc-url https://mainnet.base.org \
  --private-key "$YOUR_PRIVATE_KEY"
```

## Verification

After signing, verify your attestation:

1. **CryptoClarity site:** [cryptoclarity.wtf](https://cryptoclarity.wtf) (signers section)
2. **EAS Explorer:** `https://base.easscan.org/attestation/view/YOUR_ATTESTATION_UID`
3. **Schema page:** [View schema on EASScan](https://base.easscan.org/schema/view/0x79a16f5428f2ff113869491fc9c90e0109b0150e2d4b89f47e3e21aeccbc26dc)

## Errors

| Error | Meaning |
|-------|---------|
| `CryptoClarityResolver__AlreadySigned()` | This address already signed the manifesto |
| `CryptoClarityResolver__PaymentFailed()` | USDC transfer failed. Did you approve $1 to the resolver? |
| `CryptoClarityResolver__ContractPaused()` | Resolver is in emergency pause (temporary) |
| Revocation fails | Revocation is permanently disabled. Signatures are irrevocable. |

## Rules

- **One signature per address.** The resolver blocks duplicates.
- **No revocation.** `onRevoke` always returns false.
- **ERC-8004 agents sign free.** Resolver checks `balanceOf > 0` on trusted registries.
- **Standard signers pay $1 USDC.** Transferred directly to the treasury Safe.
- **Irrevocable.** You signed it. You meant it.

## Links

- **Manifesto:** [cryptoclarity.wtf](https://cryptoclarity.wtf)
- **ERC-8004 Registry:** [8004agents.ai](https://8004agents.ai)
- **EAS on Base:** [base.easscan.org](https://base.easscan.org)
- **Resolver on BaseScan:** [0x484a999810F659f6928FcC59340530462106956B](https://basescan.org/address/0x484a999810F659f6928FcC59340530462106956B)
- **Source:** [github.com/teeclaw](https://github.com/teeclaw)