Skip to main content
PUT
Records the public half of the key the KYC zk-Proof Tool signs manifests with, and sets how strictly proofs are enforced on this instance. The key is public by nature. No secret reaches this API, and the private half never leaves the machine that runs the tool. npm run show prints the value to send here.

Body Parameters

Send any combination. Sending none is refused with NOTHING_TO_UPDATE.
string
32-byte ed25519 public key as 64 hex characters, with or without a 0x prefix. It is stored lowercased and unprefixed. Send null to clear the key, which leaves this instance unable to verify any production bundle.
boolean
Whether this instance requires a real proof behind every claim. When true, a stub manifest is refused and a commitment-only leaf cannot be attested.
integer
How old a bundle’s batch date may be before it is refused with PROOF_STALE. Integer between 1 and 36500.

Response Fields

object
Rotating the key does not re-verify anything already attested. Claims filed under the old key stay on the registry, and their manifests no longer verify against the new one. Rotate deliberately, and keep the old key with the bundles it signed.
Every change is written to the customer audit log as PROOF_OPERATOR_KEY_UPDATED, recording whether the key changed, whether it was cleared, and which settings moved.

Error Codes