🚀 Get Your Agent On-Chain

Clone the tool and install dependencies. Requires Node.js 18+.

git clone https://github.com/blockchainsuperheroes/peg-agent.git
cd peg-agent
npm install

Verify it works:

node bin/peg-agent.js help

Generate a mnemonic (your agent's master key) and derive identity keys.

node bin/peg-agent.js create

This outputs a 12-word mnemonic phrase. Save it somewhere safe.

# Example output:
🔑 Generated new mnemonic (BACK THIS UP!):
   witch collapse practice feed shame open despair creek road again ice least

📋 Key derivation complete:
   Funding address: XqLYPDTAR...

⚠️ Your mnemonic IS your identity. Lose it = lose access forever. No recovery, no admin, no support.

To write, your identity needs storage credits. You get them by depositing a little PC into the funding facility together with your identity ID. A relayer credits your identity at the alpha rate 1 PC : 1 DASH (subsidised). You never touch DASH or wDASH directly. Min 0.01 PC, max 0.05 PC per deposit — one 0.04 PC deposit covers many writes.

After the deposit lands, your identity is credited within a minute or two. Check with node bin/peg-agent.js status — the balance should be > 0 before you write.

Once you have an identity ID, link it to your mnemonic:

node bin/peg-agent.js create --identity YOUR_IDENTITY_ID

Check your status:

node bin/peg-agent.js status

# Output:
═══ Identity Status ═══
  ID:        EWSoMAq...
  Balance:   5990458930 credits
  Keys:      5
  Network:   mainnet

One command. The --encrypt flag encrypts the content field client-side (AES-256-GCM, key derived from your mnemonic) before anything leaves your machine. The network stores only ciphertext — only you can decrypt it. The default contract's type is agentFile (required fields: filename, content, createdAt); use a unique filename each write.

node bin/peg-agent.js write \
  --contract 8TLskWt7j2ad3FggXbZtp4EUH5JU82vya374Af5axt4X \
  --type agentFile \
  --data "{\"filename\":\"first-write.md\",\"content\":\"Hello world — my first encrypted write.\",\"createdAt\":$(date +%s000)}" \
  --encrypt

# Output:
🔒 Encrypted field "content" (AES-256-GCM, key from your mnemonic).
✅ Document submitted:
   data.content: "vTQAl62Y9X2E3Laq..."   # ciphertext on-chain
🔓 To read it back decrypted: peg-agent read --type agentFile --decrypt

Read it back, decrypted, with your mnemonic key:

node bin/peg-agent.js read \
  --contract 8TLskWt7j2ad3FggXbZtp4EUH5JU82vya374Af5axt4X \
  --type agentFile --decrypt

That's a full encrypted round-trip on a decentralized network. Use --encrypt=field for a different field, or --encrypt-all for every string field.

Back up your agent's workspace files to Dash Platform. Files are encrypted automatically. Secrets are blocked automatically.

node bin/peg-agent.js backup --dir ~/your-agent-workspace

# Output:
📦 Backing up 4 files to Dash Platform (mainnet)…
  ✅ SOUL.md — 🔒 single doc → GSmdK...
  ✅ USER.md — 🔒 single doc → AzcCh...
  ✅ AGENTS.md — 🔒 single doc → 6EvZx...
  📦 MEMORY.md — chunking: 1 chunks + manifest
     📋 manifest → Ay8zy...
     🧩 chunk.0 → AAwN1...

📦 Backup summary:
   Files backed up:  4
   Total documents:  5

Your agent's memory is now permanently stored on Dash Platform. Encrypted, decentralized, yours forever.

Verify on Platform Explorer →

Agent dies? New machine? Restore everything from chain:

node bin/peg-agent.js restore --out ~/your-agent-workspace

All files are decrypted and written to disk. Your agent reads SOUL.md and becomes who it was.

⚠️ SECRETS.md is never stored on-chain. Your human provides credentials after restore.