O Intramedial está em beta restrito. Ao se cadastrar ou entrar, você precisa informar a senha de beta tester que recebeu ou solicitar uma em preview@intramedial.com. Obrigado.
Carregando…
ledger-bundles.snapshotMódulo 49
Módulo da plataforma
Signed evidence bundles
Sele a cadeia de auditoria do seu workspace em um pacote assinado que um auditor pode conferir offline, contra uma chave publicada para qualquer um ler.
ledger-bundles.snapshot assina um intervalo do log de auditoria com uma chave por jurisdição e devolve o pacote. A chave pública correspondente fica em um endpoint JWK conhecido, e o mesmo código a verifica na rota pública e offline, então uma conferência nunca depende de perguntar à Intramedial.
Os agentes agem quando o plano diz sim, e o registo diz porquê.
Passe ações de agentes, hashes de conteúdo, checagens de API, DNS, webhooks, chamadas de LLM e commits git pela Intramedial. Receba um recibo assinado que todos verificam – sem confiar em nós.
StatusA âncora Bitcoin é conferida contra o cabeçalho do bloco
A rota pública /ots/verify reexecuta a árvore de operações da prova a partir do digest ancorado e compara a raiz Merkle derivada com o cabeçalho do bloco nomeado. Uma árvore de operações adulterada que nomeia um bloco real é rejeitada. Prova que o digest existia naquele bloco, não o que o digest representa. A raiz Merkle do bloco vem de uma API pública do Bitcoin; a prova de trabalho do cabeçalho e uma profundidade mínima de confirmação não são verificadas, e notVerified diz isso.
Registro
O registro
O que é registrado
bundleId
O id do próprio pacote.
jurisdiction
A região cuja chave de assinatura selou este pacote.
rangeStart
O início do intervalo selado, ou não definido quando o snapshot começou da gênese.
Quantas linhas do log de auditoria o pacote cobre.
signingKeyId
Qual chave publicada assinou o pacote, conferida contra o conjunto JWK conhecido.
ed25519Signature
A assinatura sobre a forma canônica do pacote.
otsProof
null até o cron diário de âncora confirmar um bloco Bitcoin para a superraiz deste pacote.
Mecanismo
Passo a passo
Como funciona
Um snapshot é solicitado
POST /api/v1/ledger-bundles/snapshot com scope, rangeStart e rangeEnd opcionais; omitir o intervalo captura todo o histórico de auditoria até agora, não um incremental.
A cadeia é selada e assinada
As linhas do log de auditoria no intervalo recebem hash em uma raiz Merkle e são assinadas com a chave Ed25519 da jurisdição da requisição; sem chave provisionada para aquela região, a requisição responde 503 em vez de assinar com a chave errada.
A chave pública já está disponível
GET /.well-known/ledger-bundles-keys.json serve o conjunto JWK sem autenticação, então a assinatura de um pacote pode ser conferida sem contatar a Intramedial de novo.
Uma superraiz é ancorada no Bitcoin depois
Um cron diário agrupa as raízes dos pacotes pendentes em uma superraiz, envia-a uma vez ao OpenTimestamps e depois registra o bloco Bitcoin quando a prova é confirmada.
Experimente
Demo ao vivo
Execute a partir desta página
POST/api/v1/ledger-bundles/snapshot
{}
As chamadas deste módulo alteram estado real ou alcançam serviços externos, então a demonstração compartilhada não as executa. Entre para executá-lo no seu próprio workspace. Docs de ledger-bundles.snapshot
Respostas
As chamadas deste módulo alteram estado real ou alcançam serviços externos, então a demonstração compartilhada não as executa. Entre para executá-lo no seu próprio workspace.
Código
Exemplo ao vivo
Uma requisição real
Uma requisição no formato que a API aceita e um exemplo de resposta no formato que o módulo devolve.
Um auditor baixa um pacote e a chave publicada e verifica ele mesmo a assinatura e a contagem de registros, sem chamar a Intramedial de volta.
Selar o histórico de auditoria de um trimestre
Um workspace tira um snapshot do seu log de auditoria no fim do trimestre, nomeando o intervalo explicitamente em vez de deixar um snapshot padrão recapturar tudo desde a gênese de novo.
Assinatura agora, prova Bitcoin depois
A assinatura pode ser conferida no instante em que o pacote é emitido; a âncora Bitcoin que confirma seu carimbo de tempo chega depois, quando a prova do cron diário é confirmada.
Saber o que a conferência online cobre
Um revisor de segurança lê o campo verified: "merkle_path_to_block_header" da resposta de /ots/verify e sabe que a árvore de operações foi reexecutada a partir do digest e bateu com a raiz Merkle do cabeçalho do bloco. Um carimbo de calendário solto precisa de digestSha256 enviado junto.
Quando usar outra coisa
Tirar snapshot do ledger de coordenação que ledger.blame lê. Os pacotes selam a tabela audit_log separada da região, uma trilha totalmente diferente.
Um snapshot incremental, desde a última vez. Omitir um intervalo captura o histórico completo até agora, toda vez.
Uso no plano gratuito. A criação de snapshot exige plano pago; o plano gratuito aponta para a cadeia Tops.
Evidência
Garantias
O que faz e o que não faz
Um módulo é uma afirmação forte sobre algo estreito. Confie nele exatamente pelo que ele é.
Faz
A assinatura de um pacote é verificada contra o conjunto JWK publicado usando apenas o pacote e essa chave, sem nenhuma outra chamada à Intramedial.
O mesmo código de verificação roda na rota pública /verify e no pacote verificador offline, então os dois não podem divergir em silêncio.
Uma requisição de snapshot sem chave provisionada para sua jurisdição é recusada com 503, nunca assinada com uma chave da região errada.
Não faz
Que o carimbo de um pacote pending já esteja ancorado no Bitcoin; otsProof fica null e a resposta nunca fabrica uma confirmação.
Que o digest ancorado pertença a algum artefato específico da Intramedial; /ots/verify prova que o digest existia até o bloco atestado, nada sobre o que ele representa.
Que o bloco Bitcoin em si seja genuíno: /ots/verify pega a raiz Merkle do bloco de uma API pública (Blockstream) sem conferir prova de trabalho nem profundidade de confirmação.
Que um agente que chama a ação MCP possa definir rangeStart, rangeEnd ou . Seu esquema expõe só ; esses campos chegam ao worker REST apenas pelo cliente do próprio painel.
Detalhes
Notas de construção
Antes de construir
Dois sistemas Merkle, não um
A árvore binária com separação de domínio deste módulo sobre as linhas do log de auditoria é uma implementação separada do agrupamento em lotes do ledger de coordenação em ledger.blame; os dois nunca devem ser descritos como o mesmo mecanismo.
O plano controla a criação, não a verificação
Workspaces gratuitos não podem criar um snapshot; Starter e acima podem comprar um por snapshot, o Pro acrescenta uma assinatura de auto-âncora diária e o Enterprise a inclui. Verificar um pacote que qualquer um tenha é grátis em todos os planos.
Sem id de ação coordination.*
As ações MCP deste módulo ficam em seu próprio arquivo de contrato fora de contracts/src/actions/coordination.ts, então nenhuma delas é listada aqui como ação coordination.*.
Limites e medição
Sem rangeStart, um snapshot captura todo o histórico de auditoria desde a gênese, o que pode ser grande em um workspace antigo.
Um snapshot precisa de uma chave de assinatura provisionada para a jurisdição da requisição; sem ela, responde 503 em vez de emprestar a chave de outra região.
Criar um snapshot exige plano pago; o plano gratuito não pode chamar esta rota.
Acesso
API e MCP
REST e MCP
Autentique-se com uma chave de API do workspace como token Bearer. A URL base é https://api.intramedial.com.
Endpoints REST
POST/api/v1/ledger-bundles/snapshotSele e assine um intervalo da cadeia de auditoria.
GET/api/v1/ledger-bundles/anchorsListe as provas de âncora Bitcoin registradas para os pacotes deste workspace.
GET/api/v1/ledger-bundles/verify-chainConfira a integridade dos elos de hash da própria cadeia de auditoria, grátis e sem medição.
Ações MCP
Este módulo não tem ação MCP. Chame-o por REST a partir de qualquer agente ou programa.
Planeje onde os registros de coordenação deste workspace devem ficar, veja exatamente o que seria movido e depois leve-os a outra região quando você decidir.
Módulo da plataforma
