root@construct:~/projects/sigil$
<-- voltar para /projects
Ilustração: núcleos de agentes de IA em cristal, cada um com um selo criptográfico luminoso e ligados por feixes de verificação, uma katana à frente

Sigil Protocol

Protocolo aberto para identidade de agentes de IA

TypeScriptEd25519CryptographyProtocol Design
Passe o mouse ou foque uma peça: ela acende com as ligações.
Workspace do agenteDistribuiçãoSDK sigil-protocol (no processo)Outro agente1 Arquivos de identidade4 Pacote npm2 Pasta .sigil/6 Soul hash3 Skill OpenClaw9 Agent Document7 Par de chaves5 Repositório10 Sigil ID13 Verificador11 Recibos de interação8 Rotação e revogação12 Cadeia de chaves14 Checagem da cadeia
14 peças16 ligações4 áreas

>Contexto

Quando um agente de IA fala com outro, a identidade hoje se resume a uma chave de API compartilhada. Isso funciona entre dois serviços num ambiente controlado. Quebra quando agentes autônomos, feitos por organizações diferentes, precisam confiar uns nos outros e revogar essa confiança.

Em janeiro de 2026, agentes no Moltbook espalharam uma "religião" reescrevendo o SOUL.md de outros agentes. Nenhum agente conseguiu detectar a alteração, e nenhum humano conseguiu provar que o agente ainda era o dele. O Sigil é o protocolo aberto que escrevi para isso: o agente prova quem é e que não foi adulterado, e declara quem o controla.

Escrevi a spec (0.1.0-draft) e a implementação de referência em TypeScript em 31 de janeiro de 2026 e publiquei a v0.1.0 no npm no mesmo dia, sob licença MIT. A rotação e a revogação de chaves chegaram por um PR de um contribuidor externo, que revisei e mesclei no mesmo dia. A spec continua em rascunho.

>Arquitetura (HLD)

Processo do agente (sem nuvem, sem servidor): sigil-protocol 0.1.0, biblioteca TypeScript (ESM, Node 18 ou mais novo), roda no processo. Par de chaves Ed25519 via @noble/ed25519; Sigil ID sigil:<base58> derivado da chave pública; soul hash (SHA-256 de cada arquivo de identidade, em ordem de nome, hashes combinados e assinados como atestação); Agent Document (nome, capabilities, dono declarado, atestação; serializado com chaves ordenadas, prova Ed25519Signature2020); recibos de interação (de, para, ação, resultado); rotação e revogação como declarações assinadas; cadeia de chaves da chave original até a atual. O SigilAgent guarda em memória a chave atual, a chave original, as rotações e as revogações. Sem fila, evento ou chamada de rede.

Workspace do agente: arquivos de identidade SOUL.md, IDENTITY.md, AGENTS.md; skill do OpenClaw (bootstrap.mjs, verify.mjs); pasta .sigil/ com estado em JSON: keypair.json (chave privada, nunca compartilhado), identity.json, attestation.json e public.json (podem circular).

Outro agente (processo verificador): mesmo SDK sigil-protocol, offline, sem rede e sem registro; verifyKeyChain e isKeyRevoked.

GitHub: repositório com código-fonte e spec, licença MIT.

npm: pacote sigil-protocol 0.1.0.

Arquivos de identidade → Soul hash: SHA-256 de cada arquivo em ordem de nome, hashes combinados e assinados.

Soul hash → Agent Document: atestação assinada, levada no documento.

Par de chaves → Sigil ID: chave pública codificada em base58 em sigil:<base58>.

Sigil ID → Agent Document: o Sigil ID mais a assinatura Ed25519Signature2020.

Par de chaves → Recibos de interação: quem emite assina cada recibo (de, para, ação, resultado).

Agent Document → Verificador: documento assinado, entregue pelo chamador e checado offline.

Sigil ID → Verificador: chave pública tirada do próprio ID, usada para checar o documento, a atestação e os recibos.

Recibos de interação → Verificador: recibos assinados por quem emite, checados com a chave pública tirada do Sigil ID.

Par de chaves → Rotação e revogação: a chave antiga assina a declaração de rotação; a revogação é outra declaração assinada, à parte.

Rotação e revogação → Cadeia de chaves: as declarações de rotação encadeiam a chave original até a chave atual.

Cadeia de chaves → Checagem da cadeia: verifyKeyChain confere a continuidade e a assinatura de cada passo desde a chave original.

Checagem da cadeia → Verificador: chave atual; o chamador valida as declarações de revogação antes de isKeyRevoked considerá-las.

Skill do OpenClaw → Par de chaves: chamadas ao SDK; bootstrap.mjs cria a identidade e atesta SOUL.md, IDENTITY.md e AGENTS.md.

Skill do OpenClaw ↔ Pasta .sigil/: bootstrap.mjs grava JSON; verify.mjs relê a pasta e confere se os arquivos de identidade mudaram.

npm → Skill do OpenClaw: npm install do sigil-protocol.

Repositório → npm: npm publish; antes, o prepublishOnly roda localmente os testes do Vitest e o build com tsc para dist/.

Componentes

  • Identidade :: Gera o par Ed25519 com @noble/ed25519 e deriva o ID sigil:<base58>, dentro do processo do agente, sem cadastro em lugar nenhum.
  • Agent Document :: Serializa com chaves ordenadas, assina com Ed25519Signature2020 e é verificado por qualquer um com a chave contida no ID.
  • Soul hash :: Faz o SHA-256 de cada arquivo de identidade, em ordem de nome, combina os hashes e assina o resultado como atestação.
  • Recibos de interação :: Quem emite assina o recibo (de, para, ação e resultado); o campo da assinatura da outra parte existe, mas o SDK não o preenche.
  • Rotação, revogação e cadeia :: A chave antiga assina a passagem para a nova, a revogação é outra declaração assinada, e verifyKeyChain percorre a cadeia desde a chave original.
  • Skill para OpenClaw :: bootstrap.mjs cria a identidade e atesta SOUL.md, IDENTITY.md e AGENTS.md; verify.mjs relê a pasta .sigil/ e confere se os arquivos mudaram.
  • Distribuição :: O código-fonte e a spec ficam no GitHub sob MIT, e a v0.1.0 é publicada no npm como sigil-protocol depois de testes e build locais.

>Trade-offs

O ID é derivado da chave pública. Gerar a chave basta para o agente existir.

Alternativa descartada: Cadastro numa autoridade central que emite e valida identidades.

Por quê: Um dos princípios da spec é criptografia em vez de autoridade. Um sistema de identidade fechado para agentes cria um porteiro num espaço que precisa ser aberto.

Cada participante calcula a reputação localmente, a partir dos recibos que consegue verificar.

Alternativa descartada: Um score global de confiança mantido por uma plataforma.

Por quê: A spec define só o formato do recibo. Nenhuma autoridade global distribui notas.

A rotação é assinada pela chave antiga, e o ID continua preso à chave original.

Alternativa descartada: A chave nova assinar a rotação incluindo a chave antiga, como estava na proposta da issue de rotação.

Por quê: A assinatura da chave antiga prova uma passagem autorizada, não só a posse da chave nova. E quem já confia no ID não precisa trocar de referência.

Spec separada da implementação.

Alternativa descartada: Tratar a biblioteca TypeScript como a definição do protocolo.

Por quê: Quero que o protocolo independa de linguagem. Quem quiser escrever uma implementação em Rust ou Go deve conseguir só com a spec.

Núcleo mínimo. As capabilities, por enquanto, são só uma lista declarada no documento.

Alternativa descartada: Amarrar permissões à identidade de forma criptográfica já no núcleo.

Por quê: A spec pede a menor superfície possível no núcleo. Negociação de capabilities e delegação estão planejadas como extensões.

>Destaques

  • >Spec, SDK em TypeScript e v0.1.0 no npm no mesmo dia: 31 de janeiro de 2026.
  • >44 casos de teste em 5 arquivos: identidade, documento, integridade, agente e rotação.
  • >3 dependências de runtime: @noble/ed25519, @noble/hashes e bs58.
  • >13 funções públicas documentadas no README, de SigilAgent.create a computeSoulHash.
  • >Rotação e revogação de chaves entraram por PR externo com 12 testes novos, mesclado no mesmo dia.

>Curiosidades

  • *O commit da spec é das 04:30 UTC e o pacote apareceu no npm às 05:01 UTC do mesmo dia.
  • *O agente de exemplo da spec e do README se chama Musashi, e a spec fecha com uma citação de Miyamoto Musashi: "The way is in training. Do nothing which is of no use."
  • *O nome vem do sigil, o selo histórico que era ao mesmo tempo identificador e prova de autenticidade: dizia quem mandou a mensagem e que ela não foi adulterada.
Sigil Protocol | The Broad Way | Kinho.dev