Resetter Registration
Last updated
Last updated
In the case that a client loses all of her private keys, the client has an option to reset her DID, i.e. revoking all of her key series in that DID, with the approval of her resetters.
To invoke the reset operation, a list of resetters must be first registered with did_register_resetters operation. All resetters must also approve the registration themselves before the reset operation becomes available. In the resetter registration request, the client must specify (i) each resetter's DID address ("did_address") and (ii) each resetter's vote power ("vote_power") and (iii) the acceptable number of combined voting powers ("acceptable_votes") for approving the reset operation.
Note that the client cannot submit a request to reset her DID herself. To reset all key series in a DID, the client must contact each of her resetters individually and ask them to submit a reset request. For the reset operation to be complete, the combined voting powers from all resetters must surpass the threshold.
For a set resetters to become active, all resetters in the set must respond and approve the registration.
POST https://test-network.finema.co/did/<did_address>/reset
| Name | Type | Description |
|---|---|---|
The above message can then be encoded in Base64 and signed with ECDSA to obtain the following HTTP request
operation
string
The method's name that is "did_register_resetters".
did_address
string
The DID address.
current_key
string
The current public key in the series. It is used to verify the request's signature.
next_key_hash
string
The SHA-256 hash of the next public key in the series.
resetters
string
The list of the resetters. Each element in the list contains a resetter's DID address and voting power.
acceptable_votes
string
The voting power threshold in a resetter consensus.
nonce
number
The request nonce.