The Recover TAO feature enables users to claim TAO tokens from subnets that have been deregistered from the chain.
This feature operates through two roles:
| Role | Access Area | Responsibility | Authority Level |
|---|
| Admin | Admin Console | Configure subnet, enable toggles, review requests | Full control |
| User | Settlements Portal | Submit TAO settlement request | Request only |
A subnet becomes visible to users only after the Admin:
- Completes configuration
- Enables Deregister On-Chain
- Enables Claims
If any of the above are not completed, the subnet will not appear in Recover TAO.
| Requirement | Purpose | Mandatory | Notes |
|---|
| MetaMask Extension | Ethereum wallet signing | Yes | Updated version |
| Talisman Extension | Bittensor wallet | Yes | Updated version |
| Gas Balance | Transaction fees | Yes | Network-specific |
| Settlements URL Access | Platform access | Yes | Environment-based |
| Step | Action | Tool | Result |
|---|
| 1 | Open Settlements URL | Browser | Login screen |
| 2 | Connect MetaMask | Ethereum | Authenticated |
| 3 | Connect Talisman | Bittensor | Wallet linked |
| 4 | Click Recover TAO | Navigation | Subnet list |
Only admin-enabled subnets appear.
| Field | Description | Required | Notes |
|---|
| Subnet | Selected deregistered subnet | Yes | Admin-enabled only |
| Amount (Alpha) | Amount to settle | Yes | Numeric |
| Conversion Preview | Fee + TAO received | Auto | Display only |
| Bittensor Address (SS58) | Destination wallet | Yes | Auto-filled or custom |
After reviewing:
→ Click CONFIRM REQUEST
→ Approve MetaMask transaction
| Step | Action | Result | Visibility |
|---|
| 1 | Navigate to Recover TAO | Request list | All submissions |
| 2 | Open My Request | Status view | Individual tracking |
| Status | Meaning | Action Required | Outcome |
|---|
| Pending Approval | Awaiting admin review | Wait | No transfer yet |
| Tao Settled | Admin approved | None | TAO delivered |
| Rejected | Admin declined | None | No settlement |
| Order | Action | Reason | Risk if Skipped |
|---|
| 1 | Save Configuration | Ensure correct parameters | Wrong rate |
| 2 | Enable Deregister On-Chain | Sync blockchain logic | Inconsistent state |
| 3 | Enable Claims | Expose to users | Premature requests |
| Rule | Requirement | Enforcement | Outcome |
|---|
| Mandatory Fields | All fields completed | UI validation | Prevent submission |
| Wallet Approval | Required | MetaMask signature | Request created |
| Navigation | Location | Purpose | Output |
|---|
| Settlements → Settlement Requests | Admin Console | View pending requests | Table of submissions |
| Action | Purpose | Verification | Outcome |
|---|
| Click VIEW | Inspect request | Amount, subnet, wallet | Review details |
| Decision | Result | User Status | Token Movement |
|---|
| ACCEPT | Settlement executed | TAO Settled | TAO sent to wallet |
| REJECT | Request denied | Rejected | No transfer |
| Issue | Possible Cause | Resolution | Notes |
|---|
| Subnet Not Visible | Claims not enabled | Admin enable toggles | Verify config |
| Wallet Connection Error | Network mismatch | Refresh & reconnect | Check network |
| Confirm Button Disabled | Missing fields | Complete form | UI validation |
| Transaction Failed | Low gas | Add funds | Retry |
| Request Pending Too Long | Admin delay | Contact admin | Manual review |
| TAO Not Visible | Wrong wallet/network | Check Talisman | Allow finality |
| Resource | Purpose | Who Should Use | When |
|---|
| Help Documentation | Guidance | Users/Admins | Before support |
| Support Team | Issue resolution | Users/Admins | After failure |
The Recover TAO/ALPHA feature enables controlled settlement of deregistered subnet balances.
Process summary:
- Admin configures subnet
- Admin enables Deregister On-Chain
- Admin enables Claims
- User submits settlement request
- Admin accepts or rejects
- If accepted, TAO is delivered to the user’s Bittensor wallet
- User tracks status under My Request
This ensures administrative oversight while maintaining user-driven settlement flow.
