Product Docs
Product DocsTechnical DocsLearning & GovernanceUseful Links
  • Product Docs
  • Node Docs
  • Learning Docs
  • Node documentation for cheqd network
  • 👉Getting Started
    • Setup a new cheqd node
      • Pre-Requisites & Requirements
      • (Alternative) Install with Docker
      • Configure cheqd node
      • Configure cosmovisor
    • Command Line usage
      • Manage keys
      • Manage accounts
      • Manage a node
      • Make transactions
      • Use fee abstraction
  • 🏦Validator Guides
    • Guide for validators
      • FAQs for validators
      • Optimising disk storage with pruning
      • Troubleshooting consistently high CPU/memory loads
      • Unjailing a jailed validator
      • Move validator to a different machine
      • Backup and restore node keys with Hashicorp Vault
    • Network-wide Software Upgrades
      • Upgrade Guides
        • Upgrade to v0.6.x
        • Upgrade to v2.x (with Ubuntu 24.04 LTS upgrade)
        • Upgrade to v3.x
        • Upgrade to v3.1.x
      • Creating a software upgrade proposal
      • Upgrade Process
  • 🧑‍💻Developing on cheqd
    • Building from source
      • Build with Docker
      • Run a localnet with Docker
    • Indexers
      • SubQuery
  • Architecture
    • Architecture Decision Record (ADR) Process
    • Identity ADRs
    • List of ADRs
      • ADR 001: Payment mechanism for issuing credentials
      • ADR 002: Importing/exporting mnemonic keys from Cosmos
      • ADR 003: Command Line Interface (CLI) tools
      • ADR 004: Token fractions
      • ADR 005: Genesis parameters
      • ADR 006: Community tax
      • ADR 007: Revocation registry
      • ADR 011: AnonCreds
      • ADR Template
  • 🤝Contributing to cheqd
    • Contributor Guide
    • License
    • Code of Conduct
    • Security Policy
  • 🆘Support
    • System Status
    • Slack Channel
    • Discord
Powered by GitBook
LogoLogo

General

  • Website
  • Blog
  • Get $CHEQ

Product Docs

  • Product Docs
  • cheqd Studio
  • Creds.xyz
  • Bug/Feature Requests

Technical Docs

  • Node Docs
  • GitHub
  • Block Explorer

Learning Docs

  • Learning Docs
  • Governance Docs
  • Governance Forum
  • Governance Explorer
On this page
  • Important notes
  • Ensure your transaction fee configuration works after the upgrade
  • Features
  • 🔥 EIP-1559 Feemarket Implementation
  • 🌐 Fee Abstraction Module
  • 🔄 IBC Packet Forwarding Middleware
  • 🔧 New Message Definitions for Governance and Token Management
  • 🌟 What This Means for You
  • 🎯 Next Steps
  • Release Notes for cheqd-node v3.0.1
  • What's Changed

Was this helpful?

Edit on GitHub
Export as PDF
  1. Validator Guides
  2. Network-wide Software Upgrades
  3. Upgrade Guides

Upgrade to v3.x

Last updated 4 months ago

Was this helpful?

Important notes

  1. Any validators upgrading should have before attempting this upgrade

  2. After this upgrade, Keplr Wallet unfortunately cannot support dynamic fee lookups for Cosmos SDK chains that are not natively integrated into their wallet. Therefore, we recommend users to .

Ensure your transaction fee configuration works after the upgrade

For non-identity transactions (e.g., standard transfers, staking, rewards, etc), this upgrade introduces EIP-1559 style burns, with the introduction of a feemarket module which introduces dynamic gas pricing. This might affect how you attach/calculate fees when submitting transactions.

Recommended settings for CLI

Use --gas auto and --gas-adjustment (with value of 1.7 to 1.8) for optimal results. Using fixed --fees is unlikely to work if you don't look up real-time gas prices on the network.

Monitoring real-time gas prices using CLI

cheqd-noded query feemarket gas-price ncheq

Monitoring real-time gas prices using REST API

Initiating a GET request at https://api.cheqd.net/feemarket/v1/gas_price/ncheq. The result will be an object as:

{
  "price": {
    "denom": "ncheq",
    "amount": "0.005000000000000000"
  }
}

Interpreting the real-time gas prices API response

Interpret the value of price.amount as the fixed fee in price.denom units, in which case 5000000000000000ncheq using --fees OR calculate the gas prices necessary by multiplying the value of price.amount by (10^4) * (10^9) = 10^13, in which case resulting in 50ncheq. Any increase in the indicative gas price or gas limit will result in greater quantities than the suggested minimum base fee.

Features

We're excited to announce the latest protocol upgrade to our community. This release brings cutting-edge features designed to enhance transaction efficiency, fee flexibility, and cross-chain interoperability. Here's what's coming your way:

🔥 EIP-1559 Feemarket Implementation

  • Revolutionising the fee structure for a smoother, more efficient user experience. The advanced Additive Increase Multiplicative Decrease (AIMD) model ensures fair and efficient fee adjustments.

  • Base Fee: Dynamically adjusts based on network congestion. This fee is burnt, reducing token supply and enhancing the economic value of $CHEQ.

  • Priority Fee: Optional tip for validators to prioritise your transactions.

  • Block Elasticity: Dynamic block sizes to address congestion, improving transaction times while mitigating volatility in fees and maximising block utilisation.

  • Congestion-Responsive: Adjustments maintain a balance between supply and demand for network resources.

🌐 Fee Abstraction Module

  • Cross-Chain Token Support: Pay transaction fees in tokens from any IBC-enabled Cosmos chain.

  • IBC Hooks: Facilitate cross-chain smart contract calls, opening new use cases like multi-hop swaps.

  • Fee Conversions: Automatically convert IBC-denominated tokens to native fees before final settlement.

🔄 IBC Packet Forwarding Middleware

  • Streamlining cross-chain communication with robust packet forwarding:

  • Atomic Multi-Hop Flows: Secure and synchronized token transfers across multiple chains.

  • Asynchronous Acknowledgements: Track the outcome of multi-hop transfers from the initiating chain.

🔧 New Message Definitions for Governance and Token Management

Simplifying token minting and burning through governance-approved mechanisms mainly aimed at reducing complexity of $DOCK to $CHEQ token migration:

  • MsgBurn: Allows manual burning of native tokens with full validation.

  • MsgMint: Enables governance-controlled token minting and distribution to specific addresses.

🌟 What This Means for You

  • Improved User Experience: Transaction fees are simpler, predictable, and wallet-friendly.

  • Enhanced Token Utility: CHEQ’s role as the network’s core currency is strengthened.

  • Cross-Chain Opportunities: Broader support for IBC tokens ensures a seamless multi-chain experience.

  • Governance and Transparency: New tools for community-driven token supply management.

🎯 Next Steps

If the software upgrade proposal is approved, this upgrade will go live at block height 16502390, which is expected to be around Thursday, 12th December 2024, 9am UTC.

We’re excited to bring these advancements to the ecosystem and look forward to your feedback. Let’s build the future of Decentralised Identity together!

Release Notes for cheqd-node v3.0.1

What's Changed

feat: Integrate feemarket + reworked ante, post handler decorator distinction by @vishal-kanna in

feat!: Integrate feemarket + reworked ante, post handler decorator distinction by @Eengineer1 in

feat: add fee abs module by @atheeshp in

feat: Added MsgBurn per signer by @vishal-kanna in

feat: add fee-abs docker tests by @atheeshp in

feat: add msg mint by @atheeshp in

ci: Bump relevant CI packages [DEV-4449] by @filipdjokic in

ci: Fix super-linter errors by @filipdjokic in

ci: Check linter rules by @ankurdotb in

chore(deps): Bump amannn/action-semantic-pull-request from 5.4.0 to 5.5.3 by @dependabot in

fix: Restore upgrade testing suite for v3.x line by @vishal-kanna in

feat: Update AssertionMethod Validator by @DaevMithran in

build: Bump direct + selectively indirect by @Eengineer1 in

chore(deps-dev): Bump semantic-release from 24.1.2 to 24.2.0 by @dependabot in

Full Changelog:

🏦
carried out the Ubuntu 24.04 LTS upgrade to v2.0.2
migrate to Leap Wallet from Keplr Wallet
https://github.com/cheqd/cheqd-node/pull/782
https://github.com/cheqd/cheqd-node/pull/786
https://github.com/cheqd/cheqd-node/pull/780
https://github.com/cheqd/cheqd-node/pull/783
https://github.com/cheqd/cheqd-node/pull/787
https://github.com/cheqd/cheqd-node/pull/784
https://github.com/cheqd/cheqd-node/pull/791
https://github.com/cheqd/cheqd-node/pull/795
https://github.com/cheqd/cheqd-node/pull/798
https://github.com/cheqd/cheqd-node/pull/771
https://github.com/cheqd/cheqd-node/pull/789
https://github.com/cheqd/cheqd-node/pull/796
https://github.com/cheqd/cheqd-node/pull/806
https://github.com/cheqd/cheqd-node/pull/809
https://github.com/cheqd/cheqd-node/compare/v2.0.2...v3.0.1