Wallet
Comprehensive Internet Computer wallet management - Controllers, address book, custodians, cycle transfers, settings, and faucet operations
The Wallet page provides comprehensive management of your Internet Computer wallet, including controller management, address book functionality, custodian operations, and cycle transfers. This page centralizes all wallet-related operations in a professional tabbed interface with full dfx 0.25.0 compatibility.
Overview
The Wallet page is organized into six main functional areas, each designed to handle specific aspects of wallet management:
Controllers
Manage wallet controllers with administrative access
Address Book
Store and manage addresses locally with DFX integration
Custodians
Authorize and manage custodians with limited permissions
Cycle Transfers
Send cycles between canisters and wallets
Wallet Settings
Configure wallet name and perform upgrades
Faucet
Redeem faucet coupons for development cycles
The wallet functionality requires an active wallet canister. Ensure you have a wallet set up before using these features. You can create a wallet using the dfx identity deploy-wallet command.
Wallet Management Tabs
Controllers Tab
Controllers have administrative access to your wallet canister. This tab provides comprehensive controller management capabilities:
Controller Overview
View Controllers
List all current controllers with their principals and copy functionality
Controller Status
Display controller count and authorization status
Adding Controllers
Initiate Addition
Click the “Add Controller” button to start the process
Enter Principal
Enter the principal ID of the new controller in the input field
Select Network
Choose the appropriate network (local or IC) for the operation
Authorize
Click “Add” to authorize the new controller with administrative access
Removing Controllers
Locate Controller
Find the controller you want to remove from the list
Initiate Removal
Click the trash icon next to their principal
Confirm Action
Confirm the removal in the confirmation dialog
Complete Removal
The controller will be removed from your wallet
Be very careful when managing controllers. Removing all controllers can make your wallet inaccessible. Always ensure you maintain at least one controller with administrative access.
Controllers Tab
Controllers have administrative access to your wallet canister. This tab provides comprehensive controller management capabilities:
Controller Overview
View Controllers
List all current controllers with their principals and copy functionality
Controller Status
Display controller count and authorization status
Adding Controllers
Initiate Addition
Click the “Add Controller” button to start the process
Enter Principal
Enter the principal ID of the new controller in the input field
Select Network
Choose the appropriate network (local or IC) for the operation
Authorize
Click “Add” to authorize the new controller with administrative access
Removing Controllers
Locate Controller
Find the controller you want to remove from the list
Initiate Removal
Click the trash icon next to their principal
Confirm Action
Confirm the removal in the confirmation dialog
Complete Removal
The controller will be removed from your wallet
Be very careful when managing controllers. Removing all controllers can make your wallet inaccessible. Always ensure you maintain at least one controller with administrative access.
Address Book Tab
The Address Book provides local storage for frequently used addresses and principals with DFX integration:
Key Features
Local Storage
Addresses are stored locally in the app for quick access
DFX Integration
Also displays addresses from dfx wallet addresses
Search & Filter
Find addresses quickly with advanced filtering
Import/Export
Manage your address collection with backup capabilities
Adding New Addresses
Start Creation
Click the “Add Address” button to open the form
Fill Details
Complete the address information:
- Label: Descriptive name for easy identification
- Address: Principal ID or account identifier
- Type: Select “Principal” or “Account”
- Notes: Optional description for context
Save Address
Click “Save” to store the address in your local collection
Address Management
Use descriptive labels for your addresses to make them easy to find. Consider organizing by project or purpose (e.g., “Main Canister”, “Test Account”, “Production Wallet”).
Custodians Tab
Custodians can perform operations on behalf of your wallet but have more limited permissions than controllers:
Custodian Overview
View Custodians
List authorized custodians with their principals and permissions
Authorization Status
Show authorization status and permission levels
Authorizing Custodians
Start Authorization
Click the “Authorize Custodian” button
Enter Principal
Enter the principal ID to authorize as custodian
Select Network
Choose the appropriate network for the operation
Grant Permissions
Click “Authorize” to grant custodian permissions
Deauthorizing Custodians
Locate Custodian
Find the custodian to remove from the authorized list
Initiate Removal
Click the “Deauthorize” button next to their entry
Confirm Action
Confirm the deauthorization action
Complete Removal
The custodian will lose wallet permissions
Custodians can send cycles and perform basic wallet operations but cannot add/remove controllers or other custodians. This provides a secure way to grant limited access.
Cycle Transfers Tab
Send cycles from your wallet to canisters or other wallets with comprehensive transfer management:
Wallet Balance Management
Current Balance
Balance displayed prominently with proper formatting
Refresh Function
Update balance with real-time refresh capability
Unit Display
Balance shown in cycles with appropriate unit scaling
Sending Cycles
Enter Destination
Destination: Enter the canister ID or principal to receive cycles
Specify Amount
Amount: Specify cycles to send with unit selector (T, G, M, K)
Select Network
Network: Choose local or IC network for the transfer
Add Memo
Memo: Optional transaction note for record keeping
Execute Transfer
Click “Send Cycles” to execute the transfer
Transfer Features
Always verify the destination address before sending cycles. Transactions cannot be reversed once confirmed. Use the memo field to track the purpose of transfers.
Wallet Settings Tab
Configure your wallet name and perform maintenance operations:
Wallet Information Display
Wallet Name
Current wallet name with edit functionality
Wallet Principal
Wallet principal with copy-to-clipboard feature
Network Status
Network status indicator and connection info
Renaming Your Wallet
Start Rename
Click the “Set Name” button to begin renaming
Enter New Name
Enter the new wallet name in the input field
Save Changes
Click “Update” to save the new name
Confirm Update
The new name will be applied to your wallet
Wallet Upgrade Management
Wallet upgrades should be performed carefully. Ensure you have backups of important data before upgrading. Test upgrades on development networks first.
Faucet Tab
Redeem faucet coupons to receive free cycles for development and testing:
Coupon Redemption Process
Enter Coupon
Enter coupon code in the designated input field
Select Network
Select network (typically local for development purposes)
Redeem Coupon
Click “Redeem Coupon” to claim your free cycles
Confirm Success
Success confirmation with cycle amount received
Faucet Features
Coupon Validation
Validation before submission to prevent errors
Network Selection
Choose appropriate network for redemption
Balance Update
Automatic balance update after successful redemption
Error Handling
Clear feedback for invalid or expired coupons
Faucet coupons are typically used for development and testing. They provide free cycles to help you get started with Internet Computer development without initial investment.
Network Support
All wallet operations support multiple network configurations for flexible development and production workflows:
The network selector is available in each tab where applicable, ensuring you’re always operating on the intended network.
Best Practices
Troubleshooting
Security Considerations
Additional Resources
IC Wallet Documentation
Complete Internet Computer wallet documentation
Cycle Management Guide
Comprehensive guide to cycle management
DFX Wallet Commands
Command line reference for wallet operations
Security Best Practices
Security guidelines for wallet management
Ready to explore cycle management? Continue to the Cycles page to learn about cycle monitoring, management, and optimization strategies.