- Overview
- Setup
- Tutorials
- How Tos
- Reference
Asset Recovery¶
The DA Registry Asset Recovery is a service and operational feature offered to Asset Issuers and their Holders. It allows for the secure “recovery” of asset holdings from a lost or inactive node to a new node for the same partyID. This service ensures that DA Registry instruments remain accessible even if the technical means of access (such as a participant node) are permanently lost.
Key Functions¶
Asset Portability: Moves asset balances from an inaccessible node to a newly verified node.
Issuer-Led Governance: Provides Asset Issuers with the authority to validate and allow recovery requests, maintaining the integrity of the ledger.
Auditability: Every recovery action is recorded on the ledger, providing a transparent audit trail for compliance and regulatory purposes.
How the Recovery Process Works¶
This service restores access to digital assets and identity if the original system (source node) becomes inaccessible. It migrates a user’s “wallet” and active holdings to a healthy target node without requiring the failed node to be online.
1. Identity Migration¶
The system creates a replica of the user’s digital identity on a new “target” node. This is performed using a secure setup that does not require communication with the original, potentially broken node.
2. Asset Transfer (ACS Recovery)¶
The service gathers a complete list of the user’s current holdings and active contracts—known as the Active Contract Set (ACS)—from the system operator. These records are then imported directly into the new node.
3. Node Disconnection¶
To ensure a clean handoff, the original node is confirmed as disconnected from the network. This ensures no conflicting activity can occur during the migration.
4. Permission Granting¶
Once the identity and assets are moved, the new node is granted the legal and technical rights to act on behalf of the user. This is finalized by the holder signing with their private key.
5. Validation and Resumption¶
The system performs automated tests to confirm all migrated assets arrived safely. The user can then immediately begin performing new actions, such as minting or transferring tokens, from their new node.
Final State: After recovery, the new node functions exactly like the old one, containing both the original migrated assets and any new assets created post-recovery.
Information for Asset Holders¶
What the Service Does for You¶
If you lose access to your node or wallet due to hardware or infrastructure failure, but still possess your private key, you do not lose your underlying assets. The Recovery Service allows you to transition your holdings and partyID to a new node.
How to Access the Service¶
Prerequisite: You must be in possession of your private key.
Step 1: Reach out to your Asset Issuer.
Step 2: Submit a Recovery Request for your DA Registry Asset.
Step 3: Verify your identity with the Issuer.
Step 4: The Asset Issuer will coordinate with the Registry Operator to initiate the party and holdings replication.
Step 5: Follow instructions to recover access via a new node and validate your holdings.
Information for Asset Issuers¶
What the Service Does for You¶
As an Issuer, you are responsible for the lifecycle of the assets you create. This service provides the tools to support your holders during technical failures, ensuring high levels of asset safety.
How to Manage Recovery¶
Step 1: Receive recovery requests and perform off-ledger checks (identity verification, legal standing).
Step 2: Validate that for a given
partyID, the holder is in possession of the necessary private keys.Step 3: Align with the holder and the Registry Operator on the target node infrastructure.
Step 4: Provide holders with prepared recovery tooling; holders execute the workflow by signing with their private key.
Frequently Asked Questions (FAQ)¶
Q: Can a Holder initiate a recovery without the Issuer? A: No. To maintain security, the Registry only accepts verified requests from Asset Issuers.
Q: Do I need my original (failed) node to be online to start a recovery? A: No. The service leverages offline external party replication.
Q: Where does my asset data come from if my node is broken? A: Your Active Contract Set (ACS) is exported directly from the Registry Operator.
Q: How do I know the recovery was successful? A: The process includes a mandatory validation phase. Once moved, you should run integration tests to validate that all functions are active.