Skip to main content
Replace a public DID document with authorization proof. First call Prepare a DID update with action: "replace_document" and the complete document. Decode the returned payload_to_sign hex into binary bytes, sign with the current Ed25519 root key, and submit the returned request plus its Base64 signature. The v2 proof binds the encoded document and current document nonce. Old replacement proofs are rejected by runtime spec 125.

Request

string
required
The DID to update.
string
required
The DID to update. It must match the path.
object
The replacement public DID document. Provide exactly one of document or doc_blob.
string
An encoded public DID document. Provide exactly one of doc_blob or document.
string
required
The returned v2:<document-nonce>:<valid-until-epoch-milliseconds> proof token. Copy it unchanged and submit before expiry; its lifetime cannot exceed one hour.
string
required
The current Ed25519 root public key, as returned by preparation.
string
required
The authorization signature.

Response

string
required
The submission status.
string
required
The DID affected by the request.
string
required
The public operation name.
string
required
The submitted transaction hash.
string
required
A human-readable submission result.
202 Accepted means the Directory accepted the request for processing. It does not confirm final settlement.

Straight to the point

  • Operation: set_document_with_proof
  • Replacement: complete document or doc_blob
  • Public proof fields: timestamp, pubkey, and signature
  • Never send the private key