Asset Recovery - XentFi API Documentation

Overview

flowchart LR
subgraph Source["Source Wallet (Compromised/Lost)"]
Assets[All Assets\nETH, USDC, USDT, etc.]
end

subgraph Recovery["Asset Recovery Process"]
Validate[Validate Ownership]
Transfer[Bulk Transfer]
Confirm[Confirmation]
end

subgraph Destination["Destination Wallet (Safe)"]
Safe[Designated Safe Wallet]
end

Assets --> Validate --> Transfer --> Confirm --> Safe

Why Asset Recovery?

🚨 Emergency Response

Quickly secure funds when a wallet is compromised or keys are lost

⚡ One-Click Recovery

Single operation to move all assets from source to destination wallet

🔒 Secure Transfer

All transfers are secure, audited, and require proper authentication

📊 Audit Trail

Complete record of recovery operations for compliance

🌐 Multi-Asset

Recover all supported assets across multiple blockchains

🎯 Precision Control

Recover specific assets or entire wallet contents

When to Use Asset Recovery

Emergency Scenarios

Scenario	Action	Priority
Private key compromised	Immediate recovery to safe wallet	Critical
Team member departure	Recover assets from their wallets	High
Suspicious activity	Move funds to secure location	Critical
Wallet sunsetting	Consolidate before deactivation	Medium
Security audit	Temporary fund relocation	Low

Recovery Triggers

flowchart TD
Trigger[Recovery Trigger] --> Type{Trigger Type}

| Type --> | Manual | Manual[Admin Initiated] |
| -------- | ------ | ----------------------- |

Manual --> Human[Human Review Required]
Auto --> Conditions{Conditions Met?}

| Conditions --> | Yes | Execute[Execute Recovery] |
| -------------- | --- | ------------------------- |

Human --> Execute
Execute --> Complete[Recovery Complete]

Prerequisites

Before performing asset recovery, ensure:

✅ You have a destination wallet (safe wallet) configured
✅ You have proper authentication (API key with recovery permissions)
✅ The source wallet is accessible (even if compromised)
✅ You understand which assets will be recovered
✅ You have notified relevant stakeholders

Recovery Process

sequenceDiagram
participant Admin
participant API as XentFi API
participant Source as Source Wallet
participant Dest as Destination Wallet
participant Audit as Audit Log

Admin->>API: Initiate asset recovery
API->>API: Validate permissions
API->>Source: Check wallet ownership
Source-->>API: Ownership confirmed

API->>Source: Get all asset balances
Source-->>API: Return balances

API->>API: Calculate gas requirements

loop For Each Asset
API->>Source: Transfer asset
Source->>Dest: Send funds
Dest-->>API: Transfer confirmed
end

API->>Audit: Log recovery details
API-->>Admin: Recovery complete

Performing Asset Recovery

Recover All Assets

curl -X POST https://api.xentfi.com/v1/wallets/{walletId}/recover \
-H "apiKey: your-api-key" \
-H "orgId: your-org-id" \
-H "Content-Type: application/json" \
-d '{
"destinationWalletId": "safe-wallet-id",
"recoverAll": true
}'

{

"data": {
"recoveryId": "rec_123e4567-e89b-12d3-a456-426614174000",
"sourceWalletId": "source-wallet-id",
"destinationWalletId": "safe-wallet-id",
"status": "processing",
"assets": [
{
"symbol": "ETH",
"amount": "1.5",
"status": "completed",
"transactionHash": "0xabc123..."
},
{
"symbol": "USDC",
"amount": "5000",
"status": "completed",
"transactionHash": "0xdef456..."
},
{
"symbol": "USDT",
"amount": "3000",
"status": "pending",
"transactionHash": null
}
],
"startedAt": "2024-01-15T10:30:00.000Z"
}
}

Recover Specific Assets

curl -X POST https://api.xentfi.com/v1/wallets/{walletId}/recover \
-H "apiKey: your-api-key" \
-H "orgId: your-org-id" \
-H "Content-Type: application/json" \
-d '{
"destinationWalletId": "safe-wallet-id",
"assets": ["ETH", "USDC"],
"skipZeroBalances": true
}'

Dry Run Recovery (Simulation)

curl -X POST https://api.xentfi.com/v1/wallets/{walletId}/recover/dry-run \
-H "apiKey: your-api-key" \
-H "orgId: your-org-id" \
-H "Content-Type: application/json" \
-d '{
"destinationWalletId": "safe-wallet-id"
}'

{

"data": {
"recoverableAssets": [
{
"symbol": "ETH",
"amount": "1.5",
"estimatedGas": "0.002",
"estimatedValue": "5250"
},
{
"symbol": "USDC",
"amount": "5000",
"estimatedGas": "0.0005",
"estimatedValue": "5000"
}
],
"totalEstimatedGas": "0.0025",
"totalEstimatedValue": "10250"
}
}

Recovery Status

Status Tracking

Status	Description	Next Action
`pending`	Recovery initiated, waiting	Monitor progress
`processing`	Transfers in progress	Wait for completion
`completed`	All assets recovered	Verify destination
`partial`	Some assets recovered	Retry failed assets
`failed`	Recovery failed	Investigate and retry

Check Recovery Status

curl -X GET https://api.xentfi.com/v1/recovery/{recoveryId} \
-H "apiKey: your-api-key" \
-H "orgId: your-org-id"

Recovery Best Practices

Designate safe wallets - Configure dedicated safe wallets before emergencies
Test recovery process - Perform dry runs regularly
Document procedures - Create runbooks for recovery scenarios
Limit permissions - Restrict recovery to authorized personnel only
Audit regularly - Review recovery logs for suspicious activity
Notify stakeholders - Alert team when recovery is initiated

Security Considerations

Risk	Mitigation
Unauthorized recovery	Multi-signature approval for recovery
Wrong destination wallet	Wallet address whitelisting
Partial recovery	Automatic retry for failed transfers
Gas price spikes	Configurable gas limits
Network congestion	Queue and retry mechanism

Recovery Configuration

Safe Wallet Setup

{
"safeWalletId": "safe-wallet-id",
"name": "Emergency Safe Wallet",
"blockchain": "eth-mainnet",
"address": "0xSafeWalletAddress...",
"isActive": true,
"requiresApproval": true,
"approvers": ["admin1@company.com", "admin2@company.com"]
}

Approval Workflow

stateDiagram-v2
[*] --> Requested: Admin requests recovery
Requested --> Approved: 2+ approvers approve
Requested --> Rejected: Any approver rejects
Approved --> Executed: Recovery executed
Rejected --> [*]
Executed --> [*]

Webhook Events

Event	Trigger	Payload contains
`recovery.started`	Recovery initiated	Recovery ID, source, destination
`recovery.asset.completed`	Asset transferred	Asset details, transaction hash
`recovery.asset.failed`	Transfer failed	Asset, error reason
`recovery.completed`	All assets recovered	Summary of transfers
`recovery.failed`	Recovery failed	Error details

Troubleshooting

Insufficient gas for recovery

Solution: Ensure source wallet has enough native tokens (ETH, MATIC, etc.) for gas fees. Add gas funds if needed.

Recovery stuck in processing

Possible causes:

Network congestion
Gas price too low
Destination wallet issues

Solution: Monitor transaction status and retry if needed.

Partial recovery only

Solution:

Check which assets failed
Verify destination supports those assets
Retry failed assets individually

Pricing

Feature	Starter	Professional	Business	Enterprise
Asset recovery	❌	✅	✅	✅
Dry run simulation	❌	✅	✅	✅
Approval workflow	❌	❌	✅	✅
Priority execution	❌	❌	✅	✅
Recovery webhooks	❌	✅	✅	✅

Master Wallets

Source and destination wallet management

Security

Security best practices

Webhooks

Recovery event notifications

​Overview

​Why Asset Recovery?

🚨 Emergency Response

⚡ One-Click Recovery

🔒 Secure Transfer

📊 Audit Trail

🌐 Multi-Asset

🎯 Precision Control

​When to Use Asset Recovery

​Emergency Scenarios

​Recovery Triggers

​Prerequisites

​Recovery Process

​Performing Asset Recovery

​Recover All Assets

​Recover Specific Assets

​Dry Run Recovery (Simulation)

​Recovery Status

​Status Tracking

​Check Recovery Status

​Recovery Best Practices

​Security Considerations

​Recovery Configuration

​Safe Wallet Setup

​Approval Workflow

​Webhook Events

​Troubleshooting

​Pricing

​Related Products