Skip to main content

Economy Chain

Overview​

Economy Chain handles the financial parts of the Chromia network, such as leasing containers and rewarding providers as well as stakers. It also manages the CHR token itself and has a CHR token bridge toward EVM networks.

Core functions​

Centralized token management​

The Economy Chain functions as the central hub for CHR token operations, offering several advantages:

  • Streamlined payments: Dapps can request CHR payments directly from the Economy Chain, providing a standardized payment interface.
  • Proof-based transactions: Users complete transactions on the Economy Chain and provide cryptographic proof to dapps, enabling trustless verification of payments without requiring dapps to directly interact with the Economy Chain.
  • Immediate settlement: Services and assets are delivered upon verification of payment proof, reducing the need for complex escrow systems.

Cross-Chain bridge integration​

The Economy Chain integrates with Chromia's official bridge infrastructure, providing:

  • EVM chain support: Direct bridging of CHR tokens between the Economy Chain and major networks:
    • Ethereum Mainnet
    • Binance Smart Chain

Network economy management​

As the foundation for Chromia's native economic system, the Economy Chain:

  • Processes all CHR-based container lease payments.
  • Manages automated distribution of rewards to network providers.
  • Maintains transparent payment records on a single chain.
  • Pays staking rewards to stakers based on the amount staked and provider delegation.

Account creation​

To interact with the Economy Chain, users must first create an account. There are two methods for account creation:

Method 1: Bridging CHR from EVM-compatible blockchains​

Bridge CHR tokens from Ethereum Mainnet or Binance Smart Chain to the Economy Chain. For detailed bridging information, see the Bridge documentation.

Recommended for EVM users

Choose this method if you already hold CHR on Ethereum or BSC.

Steps:

  1. Prepare your EVM wallet: Ensure you have at least 10 CHR tokens on Ethereum Mainnet or Binance Smart Chain.
  2. Access the bridge: Visit the Chromia Vault or use the official bridge.
  3. Initiate transfer: Follow the bridging process to transfer CHR to the Economy Chain.
  4. Account creation: Your account will be created during the bridging process. If you haven't linked your EVM address to an existing account, you may need to complete the account linking process through the Vault interface.

Method 2: Cross-chain transfer​

Create an account by transferring CHR from any other Chromia chain to the Economy Chain.

For existing Chromia users

Choose this method if you already hold CHR on another Chromia chain (e.g., Token Chain, ColorPool).

Steps:

  1. Source chain account: Ensure you have at least 20 CHR tokens on any Chromia chain (Token Chain, ColorPool, etc.).
  2. Generate recipient address: Create a new account address for the Economy Chain recipient. You can do this by going to Economy Chain on Chromia Vault and click Create Dapp Account
  3. Transfer funds: Send at least 20 CHR to the unregistered address using the Chromia Vault. 10 CHR will be used as a one-time account creation fee, leaving 10 CHR in your account balance.
  4. Account activation: Visit the Chromia Vault to activate your account. The remaining funds will be available in your account after activation.

Integration resources​

For dapp developers​

To integrate Economy Chain functionality into your dapp, you can leverage the following resources:

CHR payment integration​

  • Streamlined payments: Your dapp can request CHR payments directly from the Economy Chain
  • Integration guide: See the Exchange Integration Guide for comprehensive examples
  • Memo transfers: Learn about memo-based transfers in the Memo Guide
  • Streamlined payments: Your dapp can request CHR payments directly from the Economy Chain.
  • Integration guide: See the Exchange Integration Guide for comprehensive examples.
  • Memo transfers: Learn about memo-based transfers in the Memo Guide.

Cross-chain functionality​

Code examples and libraries​

FT4 integration​

  • Asset management: Use FT4 for comprehensive asset management on the Economy Chain.
  • Account linking: Implement cross-chain account management using FT4's account linking features.

Next steps​

  1. Review the Exchange Integration Guide for step-by-step implementation.
  2. Explore the FT4 documentation for advanced asset management features.
  3. Check the Bridge documentation for cross-chain asset transfers.
  4. Review the Exchange Integration Guide for step-by-step implementation
  5. Explore the FT4 documentation for advanced asset management features
  6. Check the Bridge documentation for cross-chain asset transfers

For additional support, refer to the Economy Chain source code and test implementations in the GitLab repository.

Repository​

The Economy Chain is open source and available on GitLab:

Repository: https://gitlab.com/chromaway/core/directory-chain/-/tree/dev/src/economy_chain