DOCSEARCHbyAlgolia
Submit Docs

HAQQ Network Documentation

website·Indexed 34 days ago

https://docs.haqq.network

A scalable, high-throughput Proof-of-Stake blockchain compatible with the Ethereum Virtual Machine (EVM) and built using the Cosmos SDK. The documentation covers L1 and L2 network architecture, including the Testethiq Testnet, validator setup, IBC relayer configuration, and the x/erc20, x/vesting, and x/feemarket modules. It provides guides for developing dApps and smart contracts, using the Ethereum JSON-RPC API, and connecting wallets such as MetaMask, Keplr, and Ledger to interact with the native Islamic Coin (ISLM).

Tokens
49.3K
Snippets
210
Records
376
Agent score
59%

What's inside HAQQ Network

  1. Overview of the Haqq Fee Market (x/feemarket) module

    The x/feemarket module implements an EIP-1559 compatible fee market for the Haqq network. It allows the network to define a global transaction fee that varies based on network activity. Unlike Ethereum, which burns the base fee, the Haqq feemarket module allocates the base fee for regular Cosmos SDK fee distribution.

  2. Overview of HAQQ JSON-RPC API

    The HAQQ JSON-RPC Server provides a stateless, lightweight API to connect to the HAQQ blockchain and interact with the EVM. It allows developers to read and send Ethereum-formatted transactions on the HAQQ Cosmos chain. The API supports both HTTP and WebSocket transports, which must be enabled via command-line flags or the app.toml configuration file. Data is formatted using JSON (RFC 4627).

  3. Overview of HAQQ Wallet features

    HAQQ Wallet is a non-custodial digital wallet designed for the HAQQ network and Islamic Coin ($ISLM). It provides users with full ownership of their private keys for asset security. Key capabilities include:

    • Asset Management: Storing, sending, and receiving $ISLM.
    • Staking & DeFi: Staking $ISLM to earn rewards and accessing decentralized finance (DeFi) opportunities, including passive income and raffles.
    • Trading: Access to decentralized exchanges for transactions across ecosystems.
    • Compliance: Designed to be Shariah-compliant for ethical finance.

  4. Overview of the HAQQ x/bank module

    The x/bank module in the HAQQ Network is a custom wrapper around the native Cosmos SDK x/bank module. It is designed to be 'EVM-first', enabling trustless, on-chain bidirectional internal conversion of tokens between the HAQQ EVM and Cosmos runtimes. It utilizes x/erc20 features to convert native Cosmos sdk.Coins (Coins) to ERC-20 (Tokens) during transfers, allowing users to maintain consistent balance information across different wallet types (e.g., Keplr and MetaMask).

  5. Overview of the HAQQ Network x/epochs module

    The x/epochs module provides on-chain timers that execute at fixed time intervals, known as "epochs". It allows other HAQQ Network modules to register logic that should be triggered at specific intervals (e.g., once a week) starting from a defined UTC time. Each timer is identified by a unique identifier, and an epoch's duration is defined as end time = start time + timer interval.

  6. Overview of the x/liquidvesting module

    The x/liquidvesting module in the HAQQ Network allows users to create partially liquid tokens (aLIQUIDX) in exchange for locked ISLM tokens on a 1-to-1 basis. These liquid tokens carry the original vesting schedule of the locked ISLM but can be transferred, sold peer-to-peer, or converted back to ISLM.

    Key characteristics include:

    • EVM Integration: aLIQUIDX tokens are automatically registered as ERC20 tokens on the EVM layer.
    • Unique Denominations: Each issuance of liquid tokens generates a new unique denomination (e.g., aLIQUID1, aLIQUID2).
    • Schedule Preservation: Each liquid token is associated with the specific vesting schedule of the user who created it. Any user who later redeems these tokens must adhere to that original schedule.
    • Prerequisites: This module interacts with ClawbackVestingAccount, x/vesting, and x/erc20.

  7. Overview of REStake for HAQQ Network

    REStake is a staking tool that allows delegators to grant permission to a validator to automatically compound their rewards. For validators, it provides a script to identify granted delegators and execute compounding transactions automatically, increasing the attractiveness of the validator and the total amount of staked tokens.

  8. Overview of the HAQQ x/erc20 module

    The x/erc20 module enables trustless, on-chain bidirectional conversion of tokens between the HAQQ EVM (x/evm) and Cosmos (x/bank) runtimes. This allows users to convert native Cosmos sdk.Coins to ERC-20 tokens and vice versa while maintaining fungibility and ownership. This is critical because Cosmos coins (held in the bank module) are not natively compatible with EVM smart contracts that require the ERC-20 standard.

  9. Overview of HAQQ L1 Network Roles

    The HAQQ network is a public Proof-of-Stake (PoS) blockchain powered by CometBFT Core. It utilizes three primary roles:

    • Validators: Run full nodes, participate in consensus by signing blocks, and vote on governance proposals. Their influence is weighted by their total stake. Only the top 150 validators by weight are active.
    • Delegators: ISLM holders who delegate their tokens to a validator to earn a portion of the rewards. They share the risk of slashing if the validator misbehaves.
    • Full Nodes: Programs that fully validate all transactions and blocks. While necessary for validators, any user can run a full node to support the network.

  10. Overview of ClawbackVestingAccount in HAQQ Network

    The x/vesting module introduces the ClawbackVestingAccount, which implements the Cosmos SDK VestingAccount interface. This account type is used to allocate tokens (such as ISLM) subject to vesting, lockup, and clawback. It is primarily used for airdrops, core team allocations, and advisor incentives to ensure long-term project participation.

    Key mechanisms include:

    • Vesting: Gradually granting permission to transfer and delegate tokens over time.
    • Lockup: Preventing the transfer of tokens and the execution of Ethereum transactions that spend ISLM.
    • Clawback: Allowing the original funder to retrieve unvested tokens if a commitment or contract is breached.

  11. Overview of the HAQQ x/evm module

    The x/evm module implements the Ethereum Virtual Machine (EVM) as a Cosmos SDK module. It enables the deployment of smart contracts, interaction with the EVM state machine (state transitions), and compatibility with standard EVM tooling on a high-throughput Proof-of-Stake blockchain. It leverages CometBFT for transaction throughput and finality, and IBC for horizontal scalability.

  12. Overview of HAQQ Network custom modules

    The HAQQ Network implements several production-grade custom modules to extend the functionality of the blockchain, including native ERC-20 support and specific tokenomics logic:

    • bank: Token transfer functionalities extended to natively support ERC-20 token transfers.
    • coinomics: Handles HAQQ Network tokenomics.
    • epochs: Executes custom state transitions every period (epoch).
    • erc20: Provides trustless, on-chain bidirectional internal conversion of tokens between HAQQ EVM and Cosmos runtimes.
    • evm: Enables Smart Contract deployment and execution on Cosmos.
    • feemarket: Implements a fee market based on the EIP1559 specification.
    • ibc: Cross-chain token transfer functionalities extended to natively support ERC-20 tokens.
    • vesting: Manages vesting accounts with lockup and clawback capabilities.
    • liquidvesting: Allows liquidation and redemption of vesting tokens while preserving the vesting schedule.