Skip to content

Ixo v4.0.0 🚀

Latest
Compare
Choose a tag to compare
@github-actions github-actions released this 05 Dec 13:01
284e1de

Dominia Upgrade of the Impact Hub Network

Details of the Network Upgrade

1. Cosmos SDK Migration from v0.45 to v0.50

Upgrades the Cosmos SDK to incorporate numerous improvements and optimizations.
Technical Description: The migration from Cosmos SDK v0.45 to v0.50 introduces several key enhancements and features that significantly improve the performance, security, and developer experience.
Key Technical Improvements:

  • ABCI 2.0 Integration
    • Implements full ABCI 2.0 with CometBFT v0.38 compatibility.
    • Introduces new methods: PrepareProposal, ProcessProposal, and ExtendVote.
    • Enables application intervention at key consensus points for enhanced functionality.
  • Performance Enhancements
    • Optimistic Execution capability for improved transaction throughput (disabled by default).
    • Modular SDK architecture with separately versioned core modules.
    • Enhanced IAVL v1 implementation for better performance and security.
  • Developer Tools
    • AutoCLI introduction for simplified command creation.
    • Sign Mode Textual for hardware devices.
    • Reduced boilerplate code requirements.
    • New module-hash-by-height command for querying module hashes.

Importance: Enhances overall chain performance, security, and developer experience. ABCI 2.0 enhances the performance and efficiency of transaction processing by allowing transactions to be executed and committed optimistically without waiting for confirmation from all validators. This improves the throughput of high-volume transaction chains by enabling transactions to be processed more swiftly, reducing latency and increasing the overall network efficiency.

Upgrade Information:

  • Target Block Height: TBD (to be finalized based on network consensus)
  • Migration Steps: Detailed upgrade steps will be shared, including pre-upgrade preparations, new binary deployment, and coordinated restart.
  • Binary Information: Checksums and download links for the upgrade binaries will be provided.
  • Downtime Estimates: Network downtime is expected during the upgrade window. Estimated downtime: 2-4 hours.

2. Smart Accounts Module

Addition of the Osmosis Smart Accounts module and authorization of a Circuit Breaker Address.
Technical Description: Implements a flexible multi-authenticator framework with multi-key and multi-device support, improved account setup and recovery, and account rate limits for delegated actions. Integrated as an ante handler, this module supports extensible authenticator types (e.g., SignatureVerification, CosmWasmAuthenticator) and maintains state-preserving authentication verification throughout the process.

  • Authentication Framework: Replaces the default Cosmos SDK authentication with a flexible multi-authenticator system, allowing users to opt-in to various authenticators through transaction extensions. Also includes circuit breaker functionality for emergency module disabling.
  • Security Features: Introduces maximum unauthenticated gas limits to prevent spam attacks and uses unique incrementing authenticator IDs for each account. A circuit breaker address is assigned to the Security Group Account of the Impacts DAO.
  • Transaction Management: Supports user experience improvements with innovations such as 1-click transactions and customizable session periods ranging from 10 minutes to 12 hours. Includes transaction automation features.
  • Authentication Methods: Offers multi-key and multi-device support, including biometric authentication (Face ID, Touch ID), passkey integration, and the ability to develop custom authenticators.
  • Security Controls: Configurable rate limits for delegated actions, maximum transaction limits for specific assets, additional authentication for high-value transactions, and key rotation/replacement functionality.

Importance: Enhances user experience and security by allowing more flexible authentication methods and transaction approvals, which are crucial for the widespread adoption of Spatial Web client applications. This upgrade aims to streamline onboarding, improve user convenience, and provide secure and seamless interaction with DeFi services, ultimately positioning the Impact Hub network as a leader in advanced authentication and agentic service infrastructure.

3. Wasm-Hooks Module

Addition of a Wasm-hooks module enables smart contract interactions with other core modules.
Technical Description: Implements IBC middleware that allows ICS-20 token transfers to trigger smart contract calls. Processes memo fields in IBC packets to execute cross-chain contract interactions and validates incoming packets for cryptographic integrity and timeout conditions. It parses JSON-formatted memo fields containing wasm execution instructions, requiring a specific format with "wasm" key containing "contract" and "msg" parameters. After successful IBC packet validation, the module executes contract calls and provides error handling through ErrAck responses.
Importance: The Wasm-hooks module is crucial for enhancing cross-chain capabilities in IXO blockchain networks. It enables automated verification of claims across multiple chains, allowing for seamless movement of tokens and credentials while maintaining verifiability. This enhanced interoperability supports complex cross-chain financing mechanisms and facilitates the scaling of automated verification and coordination services across networks, which is essential for the Spatial Web context.

4. Epochs Module

Addition of the Osmosis Epochs module.
Technical Description: Implements on-chain timers that execute at fixed time intervals, allowing other modules to register logic for execution during epoch transitions. Supports multiple epoch identifiers with different durations, such as day, week, and customizable stride epochs for specific module needs. Integrates hooks like BeforeEpochStart and AfterEpochEnd for executing logic before and after epoch transitions, enabling atomic execution of epoch-dependent operations.

  • Timers: Creates on-chain timers that execute at fixed intervals, supporting multiple epoch types (e.g., daily, weekly, configurable custom epochs).
  • Module Hooks: Provides hooks for executing logic before and after epoch transitions, facilitating atomic operations related to epochs.
  • State Management: Tracks epoch identifiers, their durations, current epoch numbers, and records epoch start times and completion status.
  • Timing Parameters: Specific epoch timing parameters are defined and controlled through governance proposals to ensure flexibility and alignment with network requirements.

Importance: Enables time-based functionalities crucial for automated reporting and reward distribution, such as regular verification cycles, and facilitates network-wide coordination of claim verification and financing mechanisms. This temporal coordination ensures predictable and automated execution of key network functions, helping scale verification processes across IXO blockchain networks.

5. Minting Module

Addition of a customised Mint module, adapted from the Osmosis minting module.
Technical Description: This module introduces a reducing supply mechanism inspired by the Bitcoin halving concept, replacing the standard Cosmos SDK inflation model. Tokens are minted daily using an epoch-based system, with emission rates reducing over time following a decay function. This ensures a gradual decrease in token supply, promoting long-term sustainability. Minted tokens are allocated to two primary uses: Staking Rewards, which enhance chain security through the delegated Proof of Stake (dPOS) mechanism, and Impact Rewards, which incentivize contributions towards Real-World Impacts. The distribution framework is designed to be flexible, allowing governance to adjust allocation ratios and target accounts dynamically, to align with network objectives.
Importance: This technical upgrade enables the implementation of the updated token economics of the network, to create a sustainable ecosystem that aligns incentives across stakeholders. By reducing token supply over time, it anticipates logistic growth in the network economy that should rapidly expand over the coming years, and then trend towards a sustainable steady-state. The new distribution mechanism that allocates part of the network inflation to Impact Rewards supports and incentivizes contributions towards achieving the objective function of the network, which is to generate Real-World Impacts.

6. CW20 Payments of Claims

Additional feature for the Claims Module to support conditional payments, outcome-based payment mechanisms, and automated payment workflows.
Technical Description: Enables the use of CW20 tokens for payments within the claims process, facilitating conditional payments linked to specific milestones, outcomes, or oracle verifications. This expands the range of assets that can be used for claims transactions and integrates seamlessly with automated payment systems that execute upon the fulfillment of predefined conditions.
Importance: Increases flexibility in outcome-based financing by allowing for a wider range of tokenized assets to be used in automated and conditional payment mechanisms. This capability is crucial for implementing scalable, verifiable, and transparent payment automation, enhancing the efficiency and reliability of claims settlement in the Spatial Web ecosystem.

7. Claim Intents and Escrow Payments

Introduce intents and escrow payment automations to the Claims module.
Technical Description: Provides a system for declaring and tracking payment guarantees for claims, with default payment amounts and time-out settings. This enables agents to reserve payment guarantees before performing claimable work, with funds held in escrow for the duration of the guarantee. The intent system facilitates the predictability and planning of claim processes, allowing for better assurance and financial certainty for agents.
Importance: Enables sophisticated payment automations that provide payment guarantees upfront, enhancing trust and enabling more efficient resource allocation for a wide range of real-world financing applications. This supports better planning, reduced risk, and streamlined execution of claims through conditional and automated payment workflows.

8. Oracle Payments

Adds results-based payments for Oracle Services, including fee-for-service autonomous AI agents.
Technical Description: An Oracle Fee type of payment automation in the Claims Module provides a fee distribution mechanism that takes 10% of Oracle payments for the Market Relayer that connects Oracle services to users, and allocates 10% of Oracle fees to the network DAO operated by the Impacts Venture Cooperative. A modification has also been made to the default mechanism for defining target accounts for distributing Oracle service fees to use entity module accounts instead of DID verification method-based accounts. This streamlines fee distributions and potentially improves scalability.
Importance: This upgrade establishes the network as a core infrastructure for Spatial Web services and applications, providing enhanced utility and enabling significant cash flows through the network. It supports a new generation of verifiable, agent-based services delivered through the Spatial Web infrastructure, which could generate substantial revenue while maintaining transparency and accountability. Simplifying the claims payment process reduces complexity and potential points of failure in service fee distribution.

9. Liquid Staking Module

Adds a liquid staking module with mechanisms to enable implementation of perpetual carbon offsets through ZERO liquid staking that is governed by the Zero DAO.
Technical Description: A novel Liquid Staking mechanism for IXO tokens to be bonded for derivative ZERO tokens that generate Perpetual Carbon Offsets by swapping IXO Security Staking rewards for CARBON credit tokens that are originated through the network and certified using advanced digital MRV mechanisms, which get retired as offsets. This works in synergy with the new Impact Rewards mechanism that returns further IXO yields from the network inflation to the ZERO account, to provide additional collateral for offsets.
Importance: This innovation promotes impacts whilst enhancing the IXO token utility and economic incentives within the Impact Hub network, by strengthening the network’s tokenomics, fostering sustainability, and lowering the barriers to participation in Climate Financing.

10. Transfer Credits

Adds a feature to the Tokens Module for Impact Credits to be moved into a Transferred State, which is required for Article 6.2 Internationally Transferred Mitigation Outcomes (ITMOs).
Technical Description: Implements a system for transferring credits associated with Impact Credit tokens, allowing for more granular, publicly accountable tracking and trading of tokenized outcomes between parties.
Importance: Enables cross-border and cross-registry carbon credit transactions, in compliance with Article 6.2 of the Paris Agreement, in a way that increases transparency and trust in carbon credit markets. This supports the implementation of Corresponding Adjustments to prevent double-counting of emission reductions. It enhances the ability to track and verify the lifecycle of impact credits, such as ITMOs, from issuance to retirement.

Upgrade Procedures

Upgrade steps can be found on the IXO genesis repo at here. It is preferable to use Cosmovisor and preload the Dominia binary so that downtime will be a minimum.

Conclusion

This comprehensive upgrade significantly enhances the IXO Impact Hub Network's capabilities, improving its ability to coordinate, finance, verify, govern, and increase the intelligence of Impact-generating Domains, at an Internet scale. By incorporating these changes, the network will be better positioned to serve the growing needs of the Impact Economy, and foster innovations in sustainable development and Climate Impact mitigation.

⚡️ Binaries

Binaries for Linux and Darwin (amd64 and arm64) are available below.
Darwin users can also use the same universal binary ixod-4.0.0-darwin-all for both amd64 and arm64.

🔨 Build from source

If you prefer to build from source, you can use the following commands:

git clone https://github.com/ixofoundation/ixo-blockchain
cd ixo-blockchain && git checkout v4.0.0
make install