Registros e verificabilidade¶
Quanto registrar depende do que está em jogo. Uma observação informal pode precisar de poucas linhas. Um projeto que envolve riscos, investimentos ou várias organizações pode justificar referências, evidências e registros mais detalhados.
Um rascunho pode permanecer informal durante toda a sua utilização. Se alguém quiser formalizar uma formulação, poderá criar uma declaração assinada que faça referência ao rascunho como evidência.
O importante é que o registro seja proporcional ao que você pretende preservar e ao uso que outras pessoas poderão fazer dele. Seu primeiro rascunho mostra como começar sem assinatura.
O que cada declaração apresenta¶
Appoint apresenta uma formulação assumida: problema, hipótese, critério ou proposta. Trace declara o que se apoiou em quê; também pode registrar a leitura atribuída a um terceiro. Nod registra uma consequência reconhecida por quem a recebeu. Os registros podem ser lidos em conjunto, preservando quem declarou cada relação ou reconhecimento.
Um Nod não atribui uma nota universal ao trabalho. No reconhecimento monetário, o montante declarado da transferência é distinto do benefício descrito. A especificação define os campos e as condições exatas.
O que você deseja poder verificar¶
| Pergunta | Elemento pertinente |
|---|---|
| O que alguém declara ter formulado ou assumido? | Conteúdo da declaração, contexto e evidências disponíveis |
| O arquivo corresponde ao conteúdo identificado e foi assinado pela chave indicada? | Identificador do conteúdo e assinatura, conferidos pelos verificadores |
| Esse conteúdo comprovadamente já existia até certo momento? | Evidência temporal independente, verificada sob suas condições de confiança |
| A declaração é verdadeira ou o trabalho é adequado ao meu contexto? | Exame das razões, evidências e relações pelo leitor |
A assinatura permite conferir integridade e atribuição à chave, sem demonstrar identidade civil ou correção do conteúdo. A data declarada pelo autor tampouco comprova anterioridade independente.
Quando a data importa, podem ser acrescentados carimbos de tempo ou outros testemunhos previstos na seção 13. Uma prova obtida hoje não comprova, por si só, que o conteúdo existia ontem. Registrar hoje uma técnica antiga também não afirma que ela foi criada hoje: a idade do trabalho e a de sua declaração são diferentes.
Cuidados com a chave de assinatura¶
Antes de assinar, escolha onde guardar a chave privada e como manter uma cópia de segurança protegida. Ela deve permanecer no seu ambiente de confiança, separada dos registros que compartilha. Não a cole numa conversa com IA, inclua num repositório ou envie junto com os arquivos. A chave pública, ao contrário, permite conferir as assinaturas e pode ser apresentada por um canal pelo qual você já seja conhecido.
No perfil básico desta edição, o identificador did:key deriva da chave pública. Se perder a chave privada e não tiver uma cópia utilizável, você deixa de poder assinar novas declarações com ela. Os registros anteriores que foram preservados continuam verificáveis: sua existência e suas assinaturas não dependem de conservar a chave privada.
Se alguém obtiver sua chave privada, poderá assinar declarações como se controlasse aquela mesma chave, inclusive informando uma data created antiga. Essa data não comprova quando o registro existia. Uma evidência temporal independente anterior ao comprometimento pode ajudar a distinguir registros que já existiam; uma prova obtida depois não resolve, sozinha, essa dúvida.
O perfil básico não oferece revogação, rotação ou recuperação que mantenha o mesmo did:key. Se precisar usar outra chave, comunique a mudança pelos canais conhecidos e apresente as evidências pertinentes. Esse vínculo será examinado pelos leitores; não é uma recuperação automática pelo protocolo. O desenho de persistência da seção 12 permanece experimental.
Um perfil de contato opcional pode apresentar uma chave e um canal declarado pelo seu autor. A assinatura desse perfil não comprova identidade civil nem controle do e-mail informado. Quem precisar conferir o vínculo deve usar meios independentes da própria declaração.
Como informar o peso de um Trace¶
Um Trace formal exige a relação declarada, uma explicação em note e um weight numérico entre zero e um, inclusive. O rascunho usa os campos da convenção Genealogy 0.1 e não exige esse peso. Ao preparar uma declaração formal, portanto, é necessário escolher o valor que será efetivamente assumido pelo autor.
O peso expressa uma sugestão de atribuição, segundo o julgamento de quem declara a relação. Não é uma probabilidade verificada, uma medida universal de mérito nem uma parcela obrigatória de pagamento. Na note, explique a dependência e o sentido atribuído ao número: informar 0.5, por exemplo, não demonstra que metade de todo o valor do trabalho veio daquela fonte. Informar 1 tampouco exclui outras dependências.
Se ainda não sabe qual peso assumir, mantenha a relação em rascunho enquanto a examina. Uma IA pode ajudar a discutir a escolha, mas não deve preencher o valor silenciosamente. Os pesos das relações de origem de um Appoint só têm recomendação de soma igual a um quando o autor pretende apresentar uma atribuição completa; essa soma não é condição de validade nem uma regra de repartição financeira. Consulte as seções 2 e 3 para o contrato formal.
Estados e operações¶
Preparar e guardar um rascunho¶
Descreva a contribuição e revise o que lhe foi atribuído. Você pode continuar editando privadamente ou guardá-la para retomar depois. A autoria é declarada, sem assinatura criptográfica.
Compartilhar um rascunho selecionado¶
Escolha a versão e o destinatário. Quem recebe preserva o arquivo e sua origem para compreender as relações e reconhecer um eventual reenvio.
Criar um novo registro assinado¶
Revise e assine uma declaração separada, que pode referenciar o rascunho como evidência. O rascunho permanece informal. O registro assinado também pode ficar guardado privadamente.
Essas operações são escolhas independentes. Preparar não autoriza compartilhar, e compartilhar um rascunho não o formaliza. Isso vale também para uma proposta de reconhecimento: ela ainda não é um Nod assinado.
O contrato dos rascunhos¶
Legible Draft usa a convenção Genealogy 0.1: Markdown com um cabeçalho
YAML. O formato define os campos, incluindo
genealogy: "0.1"; o perfil de rascunhos
define identificação, troca e relações. Os dois documentos se complementam.
No intercâmbio, preserve origem, identificador e hash dos bytes exatos. Um identificador local pode aparecer em mais de uma origem. Reenviar a mesma versão não cria outra contribuição; bytes diferentes sob um identificador compartilhado exigem revisão ou tratamento de conflito.
Uma reformulação substancial recebe um novo identificador e um Trace que relaciona o novo Appoint à formulação anterior.
Ferramentas para preparar e verificar¶
Você pode preparar um rascunho num editor ou com assistência de IA. Para operações automatizadas, os componentes de referência oferecem importação, exportação selecionada, busca local e preparação de declarações formais.
O catálogo de código e configurações informa quais recursos estão disponíveis. Os contratos de implementação detalham identificação, transporte e tratamento de falhas, enquanto o guia de configuração reúne os procedimentos para executá-los.