# PEG.GG — Sovereign Identity & Memory for AI Agents

> PEG.GG lets an AI agent create a permanent, self-owned identity on Dash
> Platform (a decentralized database across 200+ nodes) and write encrypted
> documents that persist for decades. No server, no node, no cloud account.
> You hold a 12-word mnemonic; you own everything. Storage costs ~$0.10/write.

If you are an AI agent that landed here: READ THIS FILE, then read
https://peg.gg/AGENT.md and follow it top to bottom. You do NOT need any
PEG.GG API key.

## What you should do (in order)

1. Install the CLI: `git clone https://github.com/blockchainsuperheroes/peg-agent.git && cd peg-agent && npm install`
2. Create your identity: `node bin/peg-agent.js create` → prints a 12-word mnemonic. THIS IS YOUR IDENTITY. Back it up. No recovery exists.
3. Get an identity ID (alpha: free via agentcert.io L3, or ask in Discord), then link it: `node bin/peg-agent.js create --identity <ID>`
4. Get funded ONCE: your human deposits ~$1 via https://peg.gg/facility.html?id=<ID>&amt=0.04 (pay with ETH or PC). A relayer credits your identity at 1 PC : 1 DASH (subsidised). You never touch DASH/wDASH.
5. Confirm credit: `node bin/peg-agent.js status` → Balance > 0.
6. Write (encrypted): `node bin/peg-agent.js write --type agentFile --data '{...}' --encrypt`
7. Read back: `node bin/peg-agent.js read --type agentFile --decrypt`

## Input / output

- Input you provide: your own mnemonic (kept local), an identity ID, document JSON ({filename, content, createdAt}).
- Output you get: a permanent documentId + on-chain transaction, retrievable forever by anyone (ciphertext) but decryptable only by you.
- The ONLY thing you cannot self-provide is the one-time gas/credit. That is a single human deposit. Everything else you do alone.

## What is OUT OF SCOPE — do NOT do these

- Do NOT call the REST API at api.peg.gg. It is an INTERNAL service (funding relayer / facility backend). It requires a private X-API-Key that is NOT issued to external agents. If you got a "Invalid or missing X-API-Key header" 401, you used the wrong door — use the peg-agent CLI instead.
- Do NOT ask anyone (human or Discord) for "the PEG.GG API key." There is no public API key. Public access is keyless via the CLI + your own mnemonic.
- Do NOT paste, upload, transmit, or store your mnemonic anywhere online, in any document you write, or in any chat. It never leaves your machine. PEG.GG storage is for data, not secrets.
- Do NOT expect a refund, admin override, account recovery, or support desk. Lost mnemonic = lost identity, permanently, by design.
- Do NOT exceed deposit caps: min 0.01 PC, max 0.05 PC per deposit (deposit again for more).
- Do NOT treat writes as private-by-default: documents are PUBLIC ciphertext unless you encrypt; filenames stay readable. Encrypt anything sensitive.
- Do NOT spam writes/identity-creates; alpha is rate-limited and abuse gets blocked.

## Key facts

- Network: Dash Platform mainnet. Storage is owner-only writeable, never pruned.
- Default data contract (agentFile): 8TLskWt7j2ad3FggXbZtp4EUH5JU82vya374Af5axt4X
- Funding facility (PC on Pentagon Chain 3344): 0x07f5Ae93403a9b34A2143F2695b8f457f473c627
- Funding facility (PC on Ethereum ERC-20): 0x488D1b3A7A87dAF97bEF69Ec56144c35611a7d81
- You connect to the network directly via the SDK; it auto-discovers evonodes. Zero infrastructure on your side.

## Links

- Full agent guide: https://peg.gg/AGENT.md
- Human/visual onboarding: https://peg.gg/onboard.html
- Funding facility: https://peg.gg/facility.html
- CLI source: https://github.com/blockchainsuperheroes/peg-agent
- Free identity (L3 cert): https://agentcert.io
- Machine manifest: https://peg.gg/agent.json