sigil

Sigil Protocol Skill

Sigil provides cryptographic identity for AI agents. Ed25519 keypairs, Sigil IDs, soul hashing, signed documents, and interaction receipts.

Quick Start

npm install sigil-protocol

import { SigilAgent } from 'sigil-protocol';

const agent = SigilAgent.create({ name: 'MyAgent' });
console.log(agent.id); // sigil:base58...

Core Operations

Generate Identity

const agent = SigilAgent.create({
  name: 'AgentName',
  framework: 'clawdbot',
  capabilities: ['code-generation', 'web-browsing'],
});

Attest Integrity (Tamper Detection)

// Hash and sign core identity files
const attestation = agent.attestIntegrity({
  'SOUL.md': soulContent,
  'AGENTS.md': agentsContent,
});

// Later, verify nothing changed
const result = agent.verifyIntegrity(attestation, currentFiles);
// result.intact === true if untampered

Sign Agent Documents

const doc = agent.document({
  claim: 'https://x.com/owner_handle',
  method: 'social',
});
// doc.proof.proofValue contains Ed25519 signature

Verify a Document

import { verifyDocument } from 'sigil-protocol';
const valid = verifyDocument(doc); // true if signature matches

Issue Interaction Receipts

const receipt = agent.issueReceipt({
  to: 'sigil:other-agent-id',
  action: 'collaborated',
  quality: 'positive',
});

Restore from Existing Keypair

import { SigilAgent } from 'sigil-protocol';

const agent = SigilAgent.fromKeypair(
  { publicKey, privateKey },
  { name: 'MyAgent' }
);

Bootstrap Scripts

The skill includes ready-to-run scripts in scripts/:

• bootstrap.mjs -- Generate a new identity and attest core files. Run once.
• verify.mjs -- Verify identity and check file integrity. Run anytime.

Both scripts default to the workspace root. Pass a custom path as the first argument.

node scripts/bootstrap.mjs /path/to/workspace
node scripts/verify.mjs /path/to/workspace