Skip to main content
The Cycles page is a comprehensive component of the DFX Dashboard, providing a professional interface for managing cycles on the Internet Computer. Built with dfx 0.25.0 compatibility, it offers all essential cycle operations in an organized, tabbed interface for optimal developer experience.

​
Overview

Cycles Overview The redesigned Cycles page features a modern tabbed interface with three main sections designed for comprehensive cycle management:

Balance & Approvals

Check cycle balances and manage cycle spending approvals

Transfers & Top-ups

Transfer cycles between accounts and top up canisters

Convert & Faucet

Convert ICP to cycles and redeem faucet coupons

​
Interface Design Features

  • Fixed header with current balance display and refresh functionality
  • Tabbed navigation with colored icons for easy identification
  • Scrollable content areas for each tab section
  • Professional form layouts with comprehensive error handling
  • Toast notifications for operation feedback
  • Real-time balance updates with manual refresh capability
  • Network-aware operations with automatic network detection
  • Responsive design for different screen sizes

​
Cycle Management Operations

  • Balance & Approvals
  • Transfers & Top-ups
  • Convert & Faucet

​
Balance & Approvals Tab

Manage your cycle balances and configure spending approvals for automated systems and other principals.

​
Checking Cycle Balance

Cycles Balance and ApprovalsThe balance checking functionality provides comprehensive balance monitoring:

Balance Queries

Check current balance for any principal or subaccount

Network Support

Query balances across local, IC, or custom networks

Precision Options

Use precise balance option for exact cycle counts

Format Display

View balance in TC (trillion cycles) format

​
Balance Check Options

--network local    # Local development network
--network ic       # Internet Computer mainnet
--network custom   # Custom configured networks

​
Managing Cycle Approvals

Configure spending approvals to enable automated systems or other principals to spend cycles on your behalf:
1

Set Spender

Spender Principal: Enter the principal authorized to spend cycles
2

Define Limits

Amount: Set maximum cycles that can be spent
3

Add Context

Memo: Optional memo for transaction tracking
4

Set Expiration

Expires At: Set expiration timestamp for the approval

​
Approval Configuration Options

  • --spender: Principal authorized to spend cycles
  • Supports both user principals and canister principals
  • Validation ensures proper principal format
  • --amount: Maximum cycles that can be spent
  • Support for different cycle units (T, G, M, K)
  • Automatic validation against available balance
  • --memo: Optional memo for the approval
  • --expires-at: Expiration timestamp for the approval
  • Automatic cleanup of expired approvals
Use cycle approvals to enable automated systems or other principals to spend cycles on your behalf within defined limits. This is particularly useful for automated canister management and CI/CD systems.

​
Advanced Features

​
Network Selection Support

All cycle operations support comprehensive network selection for flexible development and production workflows:
  • Development Environment: Your local dfx development network
  • Fast Operations: Quick cycle operations for testing
  • No Real Costs: Use fabricated cycles for development
  • Production Environment: Internet Computer mainnet
  • Real Cycles: Actual cycle costs and transfers
  • Live Operations: Production cycle management
  • Flexible Configuration: Any custom networks you’ve configured
  • Testnet Support: Connect to various testnets
  • Development Networks: Custom development environments

​
Subaccount Support

Most operations support subaccount specification for organized fund management:

Source Subaccounts

Specify where cycles/ICP come from

Destination Subaccounts

Specify where cycles should go

Account Isolation

Keep different purposes separated

​
Error Handling & Validation

Comprehensive error handling ensures reliable operations:
  • Connectivity Detection: Network connectivity error detection
  • Network Status: Real-time network status monitoring
  • Automatic Retry: Intelligent retry mechanisms for transient failures
  • Insufficient Balance: Warnings for insufficient cycle/ICP balance
  • Balance Checking: Pre-operation balance verification
  • Fee Calculation: Automatic fee calculation and validation
  • Principal Validation: Invalid principal format detection
  • Amount Validation: Proper amount format and range checking
  • Subaccount Validation: 32-byte hex format verification
  • Transaction Failure: Recovery guidance for failed operations
  • Clear Error Messages: Detailed error descriptions and solutions
  • Help Resources: Links to relevant documentation and support

​
Best Practices

Optimize your cycle monitoring:
  • Regular Monitoring: Use the balance checker to track cycle consumption patterns
  • Automated Alerts: Set up monitoring for low cycle balances
  • Consumption Analysis: Track usage patterns to predict future needs
  • Buffer Maintenance: Keep adequate cycle buffers for operations
Optimize cycle approvals:
  • Strategic Approvals: Use cycle approvals for automated systems with appropriate limits
  • Limit Management: Set conservative spending limits for security
  • Regular Audits: Review and update approvals regularly
  • Expiration Management: Use expiration dates for temporary approvals
Optimize ICP to cycle conversions:
  • Advance Planning: Convert ICP to cycles before critical operations to avoid delays
  • Rate Monitoring: Check ICP-to-cycles rates before large conversions
  • Batch Conversions: Consider larger, less frequent conversions for efficiency
  • Market Timing: Monitor market conditions for optimal conversion timing
Optimize cycle organization:
  • Subaccount Usage: Use subaccounts for organization by project or purpose
  • Transaction Records: Use memos to track the purpose of transfers and conversions
  • Documentation: Maintain clear records of cycle operations and purposes
  • Testing Protocol: Test operations on local networks before using mainnet

​
Troubleshooting

Common balance problems and solutions:Problem: Balance not updating or showing incorrect amounts
  • Click the refresh button to update manually
  • Check network connectivity and status
  • Verify you’re querying the correct network
  • Ensure proper principal/subaccount format
Problem: Insufficient balance errors
  • Verify actual balance before operations
  • Account for transaction fees in calculations
  • Check if cycles are in the correct subaccount
Common transfer issues:Problem: Transfer failures or timeouts
  • Double-check recipient principals and available cycle balance
  • Verify network connectivity and status
  • Ensure sufficient cycles for transfer and fees
  • Check destination principal format and validity
Problem: Canister top-up issues
  • Verify canister ID correctness and existence
  • Check canister can receive cycles (not stopped)
  • Ensure sufficient cycle availability for top-up
Common conversion problems:Problem: Failed ICP conversions
  • Ensure sufficient ICP balance and verify network status
  • Check current conversion rates and limits
  • Verify ICP is in the correct subaccount
  • Monitor network congestion affecting conversions
Problem: Faucet redemption failures
  • Verify coupon code validity and format
  • Check redemption limits and expiration
  • Ensure network supports faucet operations
  • Verify account can receive cycles
Common configuration issues:Problem: Approval problems
  • Check spender principal format and validity
  • Verify expiration settings and current time
  • Ensure sufficient cycles for approval amount
  • Review approval limits and permissions
Problem: Network errors
  • Verify dfx network configuration and connectivity
  • Check network status and availability
  • Ensure proper network selection in operations
  • Validate custom network configurations
Problem: Subaccount issues
  • Ensure subaccount format is correct (32-byte hex)
  • Verify subaccount exists and has sufficient balance
  • Check subaccount permissions and access

​
dfx 0.25.0 Compatibility

This interface is fully compatible with dfx 0.25.0 and includes enhanced features:

Updated Commands

Updated command syntax for all cycle operations

Enhanced Errors

Enhanced error messages with detailed feedback

Network Handling

Improved network handling for multiple network types

Performance

Optimized performance for faster operation execution

​
New dfx 0.25.0 Features

  • Better Subaccount Support: Enhanced subaccount handling across all operations
  • Improved Validation: More comprehensive input validation and error checking
  • Network Flexibility: Better support for custom and multiple networks
  • Faster Operations: Optimized command execution for better performance
  • Better Caching: Improved caching for frequently accessed data
  • Reduced Latency: Lower latency for common operations

​
Additional Resources

DFX Cycles Commands

Complete command reference for cycle operations

Understanding Cycles

Comprehensive guide to cycles on the Internet Computer

ICP to Cycles Conversion

Detailed guide to ICP-to-cycles conversion

Cycle Wallet Management

Cycle wallet and management best practices

Cycles Economy

Cycles economy whitepaper and technical details

Developer Economics

Understanding computation and storage costs
Ready to explore network configuration? Continue to the Network page to learn about network management, configuration, and connectivity options.
⌘I