Toadgang Identity
How to Mint · Public instructions · Same theme, zero hype 🪞🌊
Network: Base (8453) Mode: Read‑only guide ← Back to Forge Open Directory

Mint Instructions

You will pin image + agentURI.json to IPFS, then forge the Agent through the Router. No promises. Just record. 🪞🌊

Router: 0x17163e5380929b04D4cC24f82aa6AC30877Bd0e0 Registry: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 Gate: MPASS ≥ 1.0 (1e18 raw)

1) Prepare the assets

What you need before touching the Forge.
  1. Pick an Agent cover image (PNG or JPG). Keep it square if possible.
  2. Create agentURI.json (metadata). You already have a canonical template.
  3. Tip: Keep the description factual. Avoid claims. The directory is an archive, not marketing.

2) Pin the image to IPFS

Result: an ipfs://IMAGE_CID URI.
  1. Open a pinning service (examples): Pinata, nft.storage, web3.storage.
  2. Upload your image and pin it.
  3. Copy the CID and form the URI:
    ipfs://<IMAGE_CID>
  4. Put that URI into agentURI.json under the image field.

3) Pin agentURI.json to IPFS

Result: an ipfs://METADATA_CID URI — this is the Agent URI.
  1. Upload agentURI.json to your pinning service and pin it.
  2. Copy the metadata CID and form the Agent URI:
    ipfs://<METADATA_CID>
  3. This ipfs://METADATA_CID string is what you paste into the Forge as the Agent URI.

Where to Pin (Recommended Services)

Public IPFS pinning providers
  1. Pinata → https://app.pinata.cloud/
  2. nft.storage → https://nft.storage/
  3. web3.storage → https://web3.storage/
Pin image first → update JSON → pin JSON second.
Do not reverse this order.

4) Forge the Agent on Base

Result: an onchain Agent ID + logs.
  1. Open /forge/ and ensure wallet is on Base (8453).
  2. Ensure your wallet holds MPASS ≥ 1.0 (raw 1e18).
  3. Paste ipfs://METADATA_CID into the Agent URI input.
  4. Confirm transaction.
  5. After mint, open the directory and verify the Agent appears:
    /agent/?id=<AGENT_ID>

5) Verify (professional checklist)

Proof, not vibes.
  1. Transaction exists on an explorer (BaseScan / Blockscout).
  2. Directory shows: creator, tx hash, timestamp.
  3. Metadata loads: name, description, image.
  4. If metadata fails, the Agent can still exist — the directory will show log proof.
Finalized agentURI.json (Genesis Production Agent)
✔ Step 1: Replace nothing unless customizing.
✔ Step 2: Save this file exactly as agentURI.json.
✔ Step 3: Pin your NFT image FIRST.
✔ Step 4: Ensure the image field contains your image CID.
✔ Step 5: Then pin this JSON file to IPFS and copy its CID.
{
  "name": "Toadgang Identity — Genesis Agent",
  "description": "Genesis production Agent minted through the Toadgang Registry Router on Base. Gated by MPASS (ERC-20) ≥ 1.0 and registered in the canonical ERC-8004 Identity Registry. This NFT represents the first live, production identity forged through the Pond Door. No promises. Just record. 🪞🌊",
  "image": "ipfs://bafybeig4zhi4xaqsb6hh5yd4kdggawgobsvmncb5q7rz35movqjz5g2esy",
  "external_url": "https://basescan.org/address/0x17163e5380929b04D4cC24f82aa6AC30877Bd0e0",
  "attributes": [
    { "trait_type": "Chain", "value": "Base" },
    { "trait_type": "Chain ID", "value": "8453" },
    { "trait_type": "System", "value": "Toadgang Identity" },
    { "trait_type": "Role", "value": "Genesis Production Agent" },
    { "trait_type": "Gate Token", "value": "MPASS" },
    { "trait_type": "Gate Type", "value": "ERC-20" },
    { "trait_type": "Min Balance (raw)", "value": "1000000000000000000" },
    { "trait_type": "Min Balance (MPASS)", "value": "1.0" },
    { "trait_type": "Router", "value": "0x17163e5380929b04D4cC24f82aa6AC30877Bd0e0" },
    { "trait_type": "Registry", "value": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432" }
  ]
}
After pinning:
• Image → gives IMAGE_CID
• agentURI.json → gives METADATA_CID

Paste this into Forge:
ipfs://METADATA_CID
Troubleshooting
  • “Agent does not exist” — check tx hash first. If tx exists, the Agent exists; metadata/URI may be missing or slow.
  • Image not loading — try a different IPFS gateway, or confirm the image CID is pinned.
  • MPASS gate fails — confirm your MPASS balance is ≥ 1.0 and you’re on Base.
  • Slow list load — use Refresh and wait; Blockscout can rate-limit. Cached results will speed up repeat loads.

Professional defaults

Keep the record clean:

  • No financial language.
  • No promises of future actions.
  • Metadata is factual, reproducible, verifiable.
  • When unsure, say “unknown” — never invent.

Suggested external_url

For a clean “identity landing”, you can point to your directory:

https://toadaid.github.io/agent/?id=<AGENT_ID>

Or keep BaseScan for pure onchain reference.

The pond does not promise. It only records. 🪞🌊