ForgeMesh x402 Notary

Recibos criptográficos para saídas de IA na Base ou Solana via x402.

Documentação

x402 Notary — Recibos Criptográficos para Saídas de IA

Um produto da ForgeMesh Labs — o notário da economia de agentes x402.

Prove o que sua IA disse, quando disse e qual modelo disse.

Toda saída de IA é apenas texto. Não há prova de que um modelo específico produziu uma resposta específica em um momento específico — e, à medida que agentes começam a contratar outros agentes, essa lacuna de confiança fica cara. O x402 Notary resolve isso: envie qualquer inferência, pague $0,001 em USDC (automático, via x402 na Base ou Solana — sem chave de API, sem conta) e receba um recibo assinado, com carimbo de data/hora e ancorado na blockchain que qualquer pessoa pode verificar, gratuitamente, para sempre.

Notarizamos o hash, não seus segredos. Seu prompt e resposta são transformados em hash e assinados — nunca armazenados. Recibos privados assinados, ancorados publicamente pela raiz do lote.

Início rápido: Base (Claude Desktop / Claude Code / qualquer cliente MCP)

{
  "mcpServers": {
    "x402-notary": {
      "command": "npx",
      "args": ["-y", "@forgemeshlabs/x402-notary-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

WALLET_PRIVATE_KEY é uma carteira Base dedicada de saldo baixo para micropagamentos x402 — nunca sua carteira principal. $1 em USDC notariza 1.000 saídas.

Início rápido: Solana

{
  "mcpServers": {
    "x402-notary-solana": {
      "command": "npx",
      "args": ["-y", "@forgemeshlabs/x402-notary-mcp"],
      "env": {
        "NOTARY_RAIL": "solana",
        "NOTARY_BASE_URL": "https://notary-solana.forgemesh.io",
        "SOLANA_PRIVATE_KEY": "[1,2,...]"
      }
    }
  }
}

SOLANA_PRIVATE_KEY é um par de chaves Solana dedicado de saldo baixo para micropagamentos x402. Pode ser um array de bytes JSON, chave de 32/64 bytes codificada em base58, base64 ou hex. Nunca use sua carteira principal.

A verificação não exige carteira alguma. Pule o bloco env completamente e você ainda poderá verificar recibos, inspecionar atestações e ler estatísticas ao vivo.

Ferramentas

Ferramenta	Custo	O que faz
`notarize_inference`	$0,001	Recibo assinado para um `{prompt, response, model_id}`
`notarize_batch`	$0,005	Até 20 recibos em uma única chamada — ideal para trilhas de auditoria
`verify_attestation`	grátis	Verifique qualquer recibo: assinatura, hash de conteúdo, prova de Merkle
`get_receipt`	grátis	Busque o material de prova público de uma atestação
`notary_stats`	grátis	Volume ao vivo, principais modelos, lotes ancorados
`notary_pubkey`	grátis	A chave Ed25519 do notário — verifique recibos totalmente offline

O que um recibo prova

Quando você notariza uma inferência, recebe uma atestação:

{
  "attestation_id": "att_64d22f5f5c95d0e759ad54dc",
  "content_hash": "sha256 of {prompt, response, model_id, timestamp}",
  "signature": "Ed25519 — verifiable offline against the public notary key",
  "notarized_at": "2026-07-03T02:47:11.000Z",
  "anchor": { "status": "sealed", "merkle_root": "…", "proof": ["…"] }
}

Isso é prova de três coisas:

Existência — este conteúdo exato existia neste momento exato.
Integridade — altere um caractere do prompt ou da resposta e a verificação falha.
Independência — as assinaturas são verificadas offline com a chave publicada; as raízes de Merkle ancoram os lotes. Você não precisa confiar na palavra do notário depois do fato.

Verifique qualquer coisa, grátis, de qualquer lugar

Qualquer agente (ou humano, ou job de CI) pode verificar um recibo antes de agir com base na saída por trás dele:

curl -s https://notary.forgemesh.io/api/verify \
  -H 'content-type: application/json' \
  -d '{"attestation_id":"att_…","prompt":"…","response":"…","model_id":"openai/gpt-5"}'

"valid": true significa que o conteúdo corresponde ao hash notarizado e a assinatura Ed25519 do notário é válida. Conteúdo adulterado é rejeitado com a verificação exata que falhou.

Quando um agente deve notarizar?

Não em toda chamada — apenas nas saídas que importam:

Transferências entre agentes — prove que o que você passou adiante veio deste modelo, sem modificações
Entregas pagas — pesquisas, relatórios, recomendações pelas quais alguém está pagando
Conformidade e trilhas de auditoria — decisões que afetam dinheiro, exposição legal ou reputação
Prevenção de disputas — "isto é exatamente o que foi gerado, exatamente neste momento"
Reputação no marketplace — construa uma trilha pública e verificável de confiabilidade para seu agente ou serviço

Conversas casuais e raciocínio de rascunho não precisam de recibos. Saídas externalizadas precisam.

Privacidade, por design

Prompts, respostas e metadados brutos não são persistidos — o notário calcula o hash, assina e descarta o conteúdo.
Os recibos contêm apenas material de prova: hash, assinatura, carimbos de data/hora, ID do modelo, prova de Merkle.
Apenas raízes de lote de Merkle são ancoradas na blockchain. Seu conteúdo nunca toca uma cadeia pública.
A verificação funciona com você fornecendo seu conteúdo original — o notário não pode revelar o que nunca guardou.

Como o pagamento funciona

Sem cadastro, sem chave de API, sem assinatura. A primeira solicitação retorna um desafio HTTP 402; seu cliente MCP assina uma autorização de pagamento em USDC e tenta novamente. A Base usa EIP-3009; a Solana usa o trilho exato x402 SVM. O recibo chega na mesma resposta — incluindo o hash da transação de pagamento em _payment.

API direta

Prefere HTTP puro? A superfície completa legível por agentes:

https://notary.forgemesh.io/llms.txt — resumo de uma página para agentes
https://notary.forgemesh.io/openapi.json — OpenAPI 3.1 com metadados de pagamento x402
https://notary.forgemesh.io/.well-known/x402.json — manifesto de descoberta x402
https://notary-solana.forgemesh.io/llms.txt — resumo do trilho Solana
https://notary-solana.forgemesh.io/openapi.json — OpenAPI 3.1 Solana com metadados x402
https://notary-solana.forgemesh.io/.well-known/x402.json — manifesto de descoberta x402 Solana

FAQ

Meu prompt é armazenado em algum lugar? Não. O hash é calculado, assinado e o texto bruto é descartado. Este é o modo padrão e único.

Preciso de conta ou chave de API? Não. Pagamentos x402 são a única credencial.

Quanto custa a verificação? Nada, para qualquer pessoa, para sempre. Cobrar pela verificação anularia o propósito de uma primitiva de confiança.

Qual blockchain e token? USDC na mainnet da Base (eip155:8453) por padrão. Defina NOTARY_RAIL=solana e NOTARY_BASE_URL=https://notary-solana.forgemesh.io para USDC na mainnet da Solana.

Posso verificar recibos sem contatar o notário? Sim — busque a chave pública Ed25519 uma vez (notary_pubkey) e verifique assinaturas offline.

Por que "x402 Notary"? x402 é o protocolo aberto que permite que agentes de IA paguem por serviços em USDC via HTTP puro — e este é o seu notário: a camada de atestação que os agentes usam para provar e verificar as saídas uns dos outros antes que dinheiro ou reputação se movam com base nelas.

Construído pela ForgeMesh Labs · Desenvolvido pelo protocolo x402 · Licença MIT