Documentación de la herramienta

Cómo leer un historial del directorio PLC

Qué es el directorio PLC, los campos de una operación did:plc (claves de rotación, métodos de verificación, alias, servicios, prev, sig), la anulación y los tombstones.

Qué es el directorio PLC

did:plc es el método DID que usan casi todas las cuentas de Bluesky. Su registro, el directorio PLC (plc.directory), es un servicio público que guarda, para cada identidad, la lista firmada de todos los cambios que se le han hecho. Cualquiera puede leerla: el documento actual en GET /{did}, el registro completo en GET /{did}/log/audit.

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

La respuesta es una lista de entradas, de la más antigua a la más reciente. Cada entrada contiene una operación firmada y lo que añade el directorio: cid (el hash del contenido de la operación), nullified y createdAt (cuándo la recibió el directorio).

Los campos de una operación

Una plc_operation contiene todo el estado de la identidad, no solo lo que cambió: para encontrar el cambio hay que compararla con la operación anterior, como hace la herramienta.

CampoQué contiene
rotationKeysLas claves autorizadas a firmar la siguiente operación; la primera tiene la prioridad más alta. Normalmente la clave de tu servidor, a veces tu propia clave de recuperación.
verificationMethodsLas claves de la propia cuenta; atproto es la clave de firma que firma tus publicaciones y registros.
alsoKnownAsLos alias: la primera entrada at:// es el handle.
servicesDónde vive la cuenta: atproto_pds es su servidor (PDS); un labeler añade atproto_labeler.
prevEl CID de la operación que esta sustituye, null para la primera.
sigLa firma de la operación por una de las 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": "…"
}

Las identidades más antiguas empezaron con una operación create de 2022, en el formato antiguo, con los campos signingKey, recoveryKey, handle y service. La herramienta la lee como la implementación de referencia: la clave de firma pasa a ser el método atproto, [recoveryKey, signingKey] las claves de rotación, el handle un alias at:// y el servicio el atproto_pds.

Anulación y recuperación

Las claves de rotación están ordenadas por prioridad. Durante las 72 horas siguientes a una operación, una clave con más prioridad que la que la firmó puede firmar otra operación con el mismo prev: el directorio marca entonces la primera como nullified: true y la identidad sigue la nueva. Así es como una clave de recuperación recupera una identidad tras un cambio no deseado.

Una operación anulada se queda en el registro, así que la herramienta la mantiene en la cronología con una etiqueta «Anulada» y compara las operaciones siguientes con la última válida.

Los tombstones

Una plc_tombstone desactiva la identidad en el registro: no tiene estado, solo prev y sig. Como cualquier operación, puede anularse en menos de 72 horas con una clave de rotación de más prioridad que la que la firmó, lo que restablece la identidad. Pasado ese plazo, el DID ya no lleva a ningún documento y ninguna operación puede seguirla. La herramienta muestra la identidad como «Desactivada», y una tombstone anulada con su etiqueta «Anulada».

Cómo leer un traslado

Cuando una cuenta se traslada a otro servidor, su nuevo servidor toma el control de la identidad en una sola operación, firmada con la clave de rotación del servidor anterior:

  • services.atproto_pds.endpoint pasa al nuevo servidor;
  • verificationMethods.atproto pasa a la clave de firma del nuevo servidor;
  • rotationKeys cambia: la clave del servidor anterior se sustituye por la del nuevo.

Por eso, un traslado de servidor con claves de rotación nuevas en menos de un día es el aspecto de una migración, y también el de una cuenta robada: la herramienta añade una nota cuando lo ve. Si no trasladaste tu cuenta, contacta con quien aloja tu servidor. Para dar a un bot un handle reconocible sin trasladarlo, consulta Consigue tu handle.

Historial PLC

Cada cambio de handle, de servidor y de clave de una cuenta.