Documentação da ferramenta

Como ler um histórico do diretório PLC

O que é o diretório PLC, os campos de uma operação did:plc (chaves de rotação, métodos de verificação, alias, serviços, prev, sig), a anulação e os tombstones.

O que é o diretório PLC

did:plc é o método DID que quase todas as contas Bluesky usam. O seu registo, o diretório PLC (plc.directory), é um serviço público que guarda, para cada identidade, a lista assinada de todas as alterações que lhe foram feitas. Qualquer pessoa a pode ler: o documento atual em GET /{did}, o registo completo em GET /{did}/log/audit.

sh
curl https://plc.directory/did:plc:z72i7hdynmk6r22z27h6tvur/log/audit

A resposta é uma lista de entradas, da mais antiga para a mais recente. Cada entrada contém uma operação assinada e o que o diretório lhe acrescenta: cid (o hash do conteúdo da operação), nullified e createdAt (quando o diretório a recebeu).

Os campos de uma operação

Uma plc_operation contém todo o estado da identidade, não só o que mudou: para encontrar a alteração, é preciso compará-la com a operação anterior, como faz a ferramenta.

CampoO que contém
rotationKeysAs chaves autorizadas a assinar a operação seguinte; a primeira tem a prioridade mais alta. Normalmente a chave do seu servidor, por vezes a sua própria chave de recuperação.
verificationMethodsAs chaves da própria conta; atproto é a chave de assinatura que assina as suas publicações e registos.
alsoKnownAsOs alias: a primeira entrada at:// é o handle.
servicesOnde vive a conta: atproto_pds é o seu servidor (PDS); um labeler acrescenta atproto_labeler.
prevO CID da operação que esta substitui, null para a primeira.
sigA assinatura da operação por uma das rotationKeys anteriores.
json
{
  "type": "plc_operation",
  "rotationKeys": ["did:key:zQ3sh…"],
  "verificationMethods": { "atproto": "did:key:zQ3sh…" },
  "alsoKnownAs": ["at://alice.example.com"],
  "services": {
    "atproto_pds": {
      "type": "AtprotoPersonalDataServer",
      "endpoint": "https://pds.example.com"
    }
  },
  "prev": "bafyrei…",
  "sig": "…"
}

As identidades mais antigas começaram com uma operação create de 2022, no formato antigo, com os campos signingKey, recoveryKey, handle e service. A ferramenta lê-a como a implementação de referência: a chave de assinatura passa a ser o método atproto, [recoveryKey, signingKey] as chaves de rotação, o handle um alias at:// e o serviço o atproto_pds.

Anulação e recuperação

As chaves de rotação estão ordenadas por prioridade. Durante as 72 horas seguintes a uma operação, uma chave com mais prioridade do que a que a assinou pode assinar outra operação com o mesmo prev: o diretório marca então a primeira como nullified: true e a identidade segue a nova. É assim que uma chave de recuperação recupera uma identidade depois de uma alteração indesejada.

Uma operação anulada fica no registo, por isso a ferramenta mantém-na na cronologia com uma etiqueta «Anulada» e compara as operações seguintes com a última válida.

Os tombstones

Uma plc_tombstone desativa a identidade no registo: não tem estado, só prev e sig. Como qualquer operação, pode ser anulada em menos de 72 horas por uma chave de rotação com mais prioridade do que a que a assinou, o que restabelece a identidade. Passado esse prazo, o DID já não leva a nenhum documento e nenhuma operação a pode seguir. A ferramenta mostra a identidade como «Desativada», e uma tombstone anulada com a sua etiqueta «Anulada».

Como ler uma mudança de servidor

Quando uma conta muda para outro servidor, o novo servidor assume a identidade numa única operação, assinada pela chave de rotação do servidor antigo:

  • services.atproto_pds.endpoint passa para o novo servidor;
  • verificationMethods.atproto passa para a chave de assinatura do novo servidor;
  • rotationKeys muda: a chave do servidor antigo é substituída pela do novo.

Por isso, uma mudança de servidor com chaves de rotação novas em menos de um dia é o aspeto de uma migração, e também o de uma conta roubada: a ferramenta acrescenta uma nota quando a vê. Se não mudou a sua conta de servidor, contacte quem aloja o seu servidor. Para dar a um bot um handle reconhecível sem o mudar de servidor, consulte Obter o seu handle.

Histórico PLC

Cada mudança de handle, de servidor e de chave de uma conta.