Last updated

๐Ÿงต Recover a Lost Account and Tokens

Welcome to the complete guide for the "Recover a Lost Account" workflow for the Token City Blockchain API.

This workflow enables you to recover a lost blockchain account along with its associated tokens, by generating the appropriate EIP712 signature and executing the recovery operation.

๐ŸŒŸ Objective: Securely recover a user's blockchain account and its token assets in case of account loss.


๐Ÿ“š OpenAPI Documentation


โœจ Workflow Summary

This workflow automates the recovery process of a lost account on the Token City blockchain:

  1. ๐Ÿ”น Generate typed data for EIP712 signature for the account recovery.
  2. ๐Ÿ”น Sign the generated EIP712 object using the custodian account.
  3. ๐Ÿ”น Recover the lost account and its tokens using the signed data.

๐Ÿ“‹ Workflow Steps Table

StepAPI OperationMethodParametersOutputsDescription
Generate EIP712 Typed DataPOST /erc3643/{tokenId}/recovery-address/eip712-typed-data-tokenId, newAccountAddresstypedDataPrepares the typed data needed for EIP712 signing
Sign EIP712 ObjectPOST /accounts/{accountId}/signEip712-typedDatasignatureSigns the typed EIP712 object with the custodian account
Recover Lost AccountPOST /erc3643/{tokenId}/recovery-address-tokenId, newAccountAddress, signature-Executes the account recovery and transfers tokens

๐ŸŽจ Workflow Visualizations

ClientAPIPOST /erc3643/{tokenId}/recovery-address/eip712-typed-datatypedDataPOST /accounts/{accountId}/signEip712signaturePOST /erc3643/{tokenId}/recovery-addressSuccess (Account Recovered)ClientAPI