From 213fd26e4fd8d465f01563ad955a58deb55b0c4b Mon Sep 17 00:00:00 2001 From: Tasos Derisiotis <50984242+Eengineer1@users.noreply.github.com> Date: Mon, 17 Feb 2025 20:30:45 +0200 Subject: [PATCH 01/11] docs: Added feeabstraction basis --- docs/cheqd-cli/cheqd-cli-fee-abstraction.md | 166 ++++++++++++++++++++ 1 file changed, 166 insertions(+) create mode 100644 docs/cheqd-cli/cheqd-cli-fee-abstraction.md diff --git a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md new file mode 100644 index 0000000..201d45e --- /dev/null +++ b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md @@ -0,0 +1,166 @@ +# Leveraging Fee Abstraction through cheqd CLI + +## Overview + +A `cheqd-node` instance can be controlled and configured using the [cheqd Cosmos CLI](README.md). + +This document contains the commands for writing token transactions in any supported IBC denomination on Osmosis. Various commands are available for declaring fees in transactions, along with querying and configuring allowed denominations through governance proposals. + +## Querying for allowed IBC denominations + +### Querying allowed IBC denominations via CLI + +```bash +cheqd-noded query feeabs all-host-chain-config --node +``` + +#### Arguments + +* `--node`: IP address or URL of node to send the request to + +#### Example + +```bash +$ cheqd-noded query feeabs all-host-chain-config --node https://rpc.cheqd.network:443 + +all_host_chain_config: + - ibc_denom: ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4 + osmosis_pool_token_denom_in: ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4 + pool_id: 1273 + status: 0 +``` + +> **Note**: Use `--output json` to get the output in JSON format. + +If the `status` is `0`, the IBC denomination is allowed for transactions. If the `status` is `1`, the IBC denomination is not allowed for transactions. Also, if the IBC denomination is not included in the response, it is not allowed for transactions. + +## Querying and declaring fees in transactions + +### Querying real-time gas prices via CLI + +Refer to the [Querying real-time gas prices via CLI](cheqd-cli-token-transactions.md#querying-real-time-gas-prices-via-cli) section in the [cheqd-cli-token-transactions.md](cheqd-cli-token-transactions.md) document. + +> **Note**: The real-time gas prices are used to calculate the fees for transactions. Denominations for fees are specified in the chain-native denomination, which is `ncheq`. You'll need to convert the gas price amount to the desired IBC denomination, as described within the next section. + +### Converting gas prices from `ncheq` to IBC denomination and vice versa + +```bash +cheqd-noded query feeabs osmo-arithmetic-twap --node +``` + +#### Arguments + +* `ibc_denom`: The IBC denomination to convert the gas price to +* `--node`: IP address or URL of node to send the request to + +#### Example + +```bash +$ cheqd-noded query feeabs osmo-arithmetic-twap ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4 --node https://rpc.cheqd.network:443 + +osmo_arithmetic_twap: "34874.714483483365588155" +``` + +> **Note**: Use `--output json` to get the output in JSON format. + +If the desired IBC denomination is not configured, the response will error out with a message indicating that the IBC denomination is not allowed for transactions. + +### Declaring fees in transactions + +```bash +cheqd-noded tx bank --gas --gas-prices --fees --node +``` + +#### Arguments + +* `from_key_or_address`: The key or address of the sender. If the key is used, the key must be unlocked in the keyring. +* `to_address`: The address of the recipient +* `amount`: The amount to send, in the format `1000ncheq`. The amount must be in the chain-native denomination, which is `ncheq` +* `gas`: The amount of gas to use or `auto` to calculate the gas automatically +* `gas_prices`: The gas prices to use, in the format `5000ncheq` or `0.0000016ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4` +* `fees`: The fees to pay, in the format `1000000000ncheq` or `0.032ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4` +* `--node`: IP address or URL of node to send the request to + +> **Note**: Use either `--gas` and `--gas-prices` or `--fees` to declare fees in transactions. If `--fees` is used, the `--gas` and `--gas-prices` flags are ignored. + +#### Example + +##### Declaring fees in transactions using `--gas` and `--gas-prices` + +```bash +$ cheqd-noded tx bank key1 cheqd1rnr5jrt4exl0samwj0yegv99jeskl0hsxmcz96 1000000000ncheq --gas auto --gas-prices 0.00000016ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4 --node https://rpc.cheqd.network:443 + +{"height":"0","txhash":"","codespace":"","code":0,"data":"","raw_log":"[]","logs":[],"info":"","gas_wanted":"0","gas_used":"0","tx":null,"timestamp":"","events":[]} +``` + +##### Declaring fees in transactions using `--fees` + +```bash +$ cheqd-noded tx bank key1 cheqd1rnr5jrt4exl0samwj0yegv99jeskl0hsxmcz96 1000000000ncheq --fees 0.032ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4 --node https://rpc.cheqd.network:443 -y + +{"height":"0","txhash":"","codespace":"","code":0,"data":"","raw_log":"[]","logs":[],"info":"","gas_wanted":"0","gas_used":"0","tx":null,"timestamp":"","events":[]} +``` + +> **Note**: Use with the `-y` flag to skip the confirmation prompt. Any fees declared in transactions are deducted from the sender's account by first converting the fees to the chain-native denomination, which is `ncheq`. Use with any compatible transaction type declared in the `tx` command. + +##### Declaring fees for identity transactions + +```bash +$ cheqd-noded tx cheqd create-did did-document.json --fees 1.6ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4 --node https://rpc.cheqd.network:443 -y + +{"height":"0","txhash":"","codespace":"","code":0,"data":"","raw_log":"[]","logs":[],"info":"","gas_wanted":"0","gas_used":"0","tx":null,"timestamp":"","events":[]} +``` + +Identity transactions require fees to be declared using the `--fees` flag. The fees are deducted from the sender's account by first converting the fees to the chain-native denomination, which is `ncheq`. + +Similarly, declare fees for DID-Linked Resource transactions using the `--fees` flag. + +```bash +$ cheqd-noded tx resource create resource-payload.json data.json --fees 0.08ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4 --node https://rpc.cheqd.network:443 -y + +{"height":"0","txhash":"","codespace":"","code":0,"data":"","raw_log":"[]","logs":[],"info":"","gas_wanted":"0","gas_used":"0","tx":null,"timestamp":"","events":[]} +``` + +## Configuring allowed IBC denominations through governance proposals + +### Submitting a governance proposal to allow an IBC denomination + +```bash +cheqd-noded tx gov submit-legacy-proposal add-hostzone-config --from --node +``` + +#### Arguments + +* `proposal-file`: The JSON file containing the proposal details +* `key`: The key of the proposer to submit the proposal on behalf of +* `--node`: IP address or URL of node to send the request to + +#### Example + +```bash +$ cheqd-noded tx gov submit-legacy-proposal add-hostzone-config proposal.json --from key1 --gas auto --gas-prices 5000ncheq --node https://rpc.cheqd.network:443 + +{"height":"0","txhash":"","codespace":"","code":0,"data":"","raw_log":"[]","logs":[],"info":"","gas_wanted":"0","gas_used":"0","tx":null,"timestamp":"","events":[]} +``` + +```json +{ + "title": "Add $USDC IBC denomination to Host Zone", + "description": "Add $USDC IBC denomination to the Host Zone configuration", + "host_chain_fee_abs_config": { + "ibc_denom": "ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4", + "osmosis_pool_token_denom_in": "ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4", + "pool_id": "1273", + "status": 0 + }, + "deposit": "100000000000ncheq" +} +``` + +> **Note**: Use with the `add-hostzone-config` proposal type to allow an IBC denomination for transactions. The proposal must be submitted by a proposer with the required deposit amount in the chain-native denomination, which is `ncheq`. The proposal details are specified in the JSON file. Fees can be declared using either the `--gas` and `--gas-prices` flags or the `--fees` flag. + +## Appendix + +* `ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4`: The $USDC IBC denomination for the Osmosis chain +* `ibc/92AE2F53284505223A1BB80D132F859A00E190C6A738772F0B3EF65E20BA484F`: The $EURe IBC denomination for the Osmosis chain +* `ibc/7A08C6F11EF0F59EB841B9F788A87EC9F2361C7D9703157EC13D940DC53031FA`: The $CHEQ IBC denomination for the Osmosis chain From 65c28559fea7944b0ff175f4353105e349fafdb7 Mon Sep 17 00:00:00 2001 From: Tasos Derisiotis <50984242+Eengineer1@users.noreply.github.com> Date: Tue, 18 Feb 2025 09:45:22 +0200 Subject: [PATCH 02/11] Added anchor --- SUMMARY.md | 1 + 1 file changed, 1 insertion(+) diff --git a/SUMMARY.md b/SUMMARY.md index 8a4665b..715e771 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -12,6 +12,7 @@ * [Manage accounts](docs/cheqd-cli/cheqd-cli-accounts.md) * [Manage a node](docs/cheqd-cli/cheqd-cli-node-management.md) * [Make transactions](docs/cheqd-cli/cheqd-cli-token-transactions.md) + * [Use fee abstraction](docs/cheqd-cli/cheqd-cli-fee-abstraction.md) ## 🏦 Validator Guides From 1a4c4d0cd26f77033bf10cafbf72cd861f1865ec Mon Sep 17 00:00:00 2001 From: Tasos Derisiotis <50984242+Eengineer1@users.noreply.github.com> Date: Tue, 18 Feb 2025 14:07:57 +0200 Subject: [PATCH 03/11] Align values --- docs/cheqd-cli/cheqd-cli-fee-abstraction.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md index 201d45e..32bec2e 100644 --- a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md +++ b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md @@ -77,7 +77,7 @@ cheqd-noded tx bank --gas --ga * `to_address`: The address of the recipient * `amount`: The amount to send, in the format `1000ncheq`. The amount must be in the chain-native denomination, which is `ncheq` * `gas`: The amount of gas to use or `auto` to calculate the gas automatically -* `gas_prices`: The gas prices to use, in the format `5000ncheq` or `0.0000016ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4` +* `gas_prices`: The gas prices to use, in the format `5000ncheq` or `0.00000016ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4` * `fees`: The fees to pay, in the format `1000000000ncheq` or `0.032ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4` * `--node`: IP address or URL of node to send the request to From 7546beb35e3e4ff10a70999c9119c82a8971011f Mon Sep 17 00:00:00 2001 From: Ankur Banerjee Date: Wed, 19 Feb 2025 17:11:55 +0100 Subject: [PATCH 04/11] Update cheqd-cli-fee-abstraction.md --- docs/cheqd-cli/cheqd-cli-fee-abstraction.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md index 32bec2e..acdd9c7 100644 --- a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md +++ b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md @@ -4,7 +4,9 @@ A `cheqd-node` instance can be controlled and configured using the [cheqd Cosmos CLI](README.md). -This document contains the commands for writing token transactions in any supported IBC denomination on Osmosis. Various commands are available for declaring fees in transactions, along with querying and configuring allowed denominations through governance proposals. +This document contains the Fee Abstraction commands for [paying for transactions](cheqd-cli-token-transactions.md) using governance-approved alternative tokens, e.g., a stablecoin such as USDC. The Fee Abstraction module routes requests for supported IBC denominations to [Osmosis DEX](https://app.osmosis.zone), and uses existing liquidity pools (e.g., the [CHEQ/USDC pool](https://app.osmosis.zone/pool/1273)) to convert the tokens on the fly. The underlying transaction on cheqd network is **always** funded in CHEQ tokens. + +Various commands are available for declaring fees in transactions, along with querying and configuring allowed denominations through governance proposals. ## Querying for allowed IBC denominations From fc606bd25c9db2ac483dd28ae17bb9b12570677a Mon Sep 17 00:00:00 2001 From: Ankur Banerjee Date: Wed, 19 Feb 2025 18:26:23 +0100 Subject: [PATCH 05/11] Update cheqd-cli-fee-abstraction.md --- docs/cheqd-cli/cheqd-cli-fee-abstraction.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md index acdd9c7..90f3065 100644 --- a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md +++ b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md @@ -8,7 +8,9 @@ This document contains the Fee Abstraction commands for [paying for transactions Various commands are available for declaring fees in transactions, along with querying and configuring allowed denominations through governance proposals. -## Querying for allowed IBC denominations +## Supported IBC denominations + +Fees for transactions cannot be denominated in arbitrary alternative tokens, when attempting to pay for transactions with non-CHEQ tokens. Supported IBC denominations must be approved using decentralised governance. ### Querying allowed IBC denominations via CLI From 99654eeab29778922285d9f6c86066ea4eb2abe8 Mon Sep 17 00:00:00 2001 From: Tasos Derisiotis <50984242+Eengineer1@users.noreply.github.com> Date: Wed, 19 Feb 2025 20:45:46 +0200 Subject: [PATCH 06/11] Added clarification --- docs/cheqd-cli/cheqd-cli-fee-abstraction.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md index 90f3065..f8e5bc7 100644 --- a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md +++ b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md @@ -12,6 +12,10 @@ Various commands are available for declaring fees in transactions, along with qu Fees for transactions cannot be denominated in arbitrary alternative tokens, when attempting to pay for transactions with non-CHEQ tokens. Supported IBC denominations must be approved using decentralised governance. +## Interacting with Fee Abstraction + +The equivalent IBC denomination amount is required to pay for transactions. **Ensure** this amount is available in the respective Osmosis account in possession of the sender. + ### Querying allowed IBC denominations via CLI ```bash From 8b67adcfda7a54e0ad592b0bdce79781094a1b30 Mon Sep 17 00:00:00 2001 From: Tasos Derisiotis <50984242+Eengineer1@users.noreply.github.com> Date: Wed, 19 Feb 2025 20:58:44 +0200 Subject: [PATCH 07/11] Added REST API alternative --- docs/cheqd-cli/cheqd-cli-fee-abstraction.md | 42 +++++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md index f8e5bc7..07829b8 100644 --- a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md +++ b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md @@ -42,6 +42,48 @@ all_host_chain_config: If the `status` is `0`, the IBC denomination is allowed for transactions. If the `status` is `1`, the IBC denomination is not allowed for transactions. Also, if the IBC denomination is not included in the response, it is not allowed for transactions. +### Querying allowed IBC denominations via REST API + +You can also query allowed IBC denominations using the REST API, which can be useful for applications that do not use the node CLI. You can fetch this by initiating a GET request to: + +* **Mainnet**: `https://api.cheqd.net/fee-abstraction/feeabs/v1/all-host-chain-config` +* **Testnet**: `https://api.cheqd.network/fee-abstraction/feeabs/v1/all-host-chain-config` + +#### Response format for allowed IBC denominations from REST API + +```json +{ + "all_host_chain_config": [ + { + "ibc_denom": "ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4", + "osmosis_pool_token_denom_in": "ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4", + "pool_id": "1273", + "status": 0 + } + ] +} +``` + +### Querying allowed IBC denominations via REST API with a specific IBC denomination + +You can also query allowed IBC denominations for a specific IBC denomination using the REST API. You can fetch this by initiating a GET request to: + +* **Mainnet**: `https://api.cheqd.net/fee-abstraction/feeabs/v1/host-chain-config/` +* **Testnet**: `https://api.cheqd.network/fee-abstraction/feeabs/v1/host-chain-config/` + +#### Response format for allowed IBC denominations from REST API with a specific IBC denomination + +```json +{ + "host_chain_config": { + "ibc_denom": "ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4", + "osmosis_pool_token_denom_in": "ibc/498A0751C798A0D9A389AA3691123DADA57DAA4FE165D5C75894505B876BA6E4", + "pool_id": "1273", + "status": 0 + } +} +``` + ## Querying and declaring fees in transactions ### Querying real-time gas prices via CLI From 359828a9ec7357202c0de5cedfb2e08ce0d85caa Mon Sep 17 00:00:00 2001 From: Ankur Banerjee Date: Thu, 20 Feb 2025 11:46:25 +0100 Subject: [PATCH 08/11] Added pre-requisites --- docs/cheqd-cli/cheqd-cli-fee-abstraction.md | 26 +++++++++++++++++++-- 1 file changed, 24 insertions(+), 2 deletions(-) diff --git a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md index 07829b8..07e457e 100644 --- a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md +++ b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md @@ -12,9 +12,31 @@ Various commands are available for declaring fees in transactions, along with qu Fees for transactions cannot be denominated in arbitrary alternative tokens, when attempting to pay for transactions with non-CHEQ tokens. Supported IBC denominations must be approved using decentralised governance. -## Interacting with Fee Abstraction +## Prerequisites for using Fee Abstraction + +The equivalent IBC denomination amount is required to pay for transactions. **Ensure this amount is available in the equivalent Osmosis account** related to the cheqd account/key provided in the transaction. + +### Looking up balance of equivalent Osmosis account + +You can find out if you've got sufficient balance in supported IBC denominations using the following methods: + +1. **Through Leap Wallet** + 1. Ensure you have added the cheqd wallet you want to use for transactions to a supported desktop/mobile wallet. The recommended wallet app is [Leap Wallet](https://www.leapwallet.io/download). If you previously used Keplr Wallet, we recommend [migrating from Keplr Wallet to Leap Wallet](https://docs.cheqd.io/product/network/wallets/migrate) as it has better support for [looking up real-time gas prices](./cheqd-cli-token-transactions.md). + 2. Once you've added the cheqd wallet account to Leap Wallet, use the network switcher to switch to **Osmosis**. This will allow you to see the balances you have on Osmosis chain, including native OSMO as well as any IBC denominations such as USDC. +2. **Converting your cheqd address to Osmosis using CLI** + 1. TASOS: We should probably add this under the [key management](./cheqd-cli-key-management.md) and link to it from here. + 2. Once you have obtained your Osmosis address, you can look up its balance using the [Osmosis CLI](https://docs.osmosis.zone/osmosis-core/osmosisd/) or through a block explorer like [Mintscan](https://mintscan.io/osmosis). -The equivalent IBC denomination amount is required to pay for transactions. **Ensure** this amount is available in the respective Osmosis account in possession of the sender. +### Getting sufficient balance of supported IBC denominations on equivalent Osmosis account + +If you do not have sufficient balances in supported IBC denominations on Osmosis, you need to top-up the specific token you want in your Osmosis account + +#### For USDC + +1. If you already have USDC (regardless of which chain it is on), use [Noble Express Transfer](https://express.noble.xyz/) to transfer it as Cosmos-native Noble USDC into Osmosis. +2. Acquire USDC on Osmosis by [swapping existing tokens to USDC](https://docs.osmosis.zone/overview/educate/getting-started#swapping-tokens). + +## Interacting with Fee Abstraction ### Querying allowed IBC denominations via CLI From 00c1fe90f4c1c66017d831675aece408a34c199b Mon Sep 17 00:00:00 2001 From: Ankur Banerjee Date: Thu, 20 Feb 2025 11:51:58 +0100 Subject: [PATCH 09/11] Update cheqd-cli-fee-abstraction.md --- docs/cheqd-cli/cheqd-cli-fee-abstraction.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md index 07e457e..4b7597a 100644 --- a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md +++ b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md @@ -40,6 +40,8 @@ If you do not have sufficient balances in supported IBC denominations on Osmosis ### Querying allowed IBC denominations via CLI +As tokens supported for fee abstraction can only be allowlisted by governance, use the following command to find out which IBC denominations are supported: + ```bash cheqd-noded query feeabs all-host-chain-config --node ``` @@ -47,6 +49,7 @@ cheqd-noded query feeabs all-host-chain-config --node #### Arguments * `--node`: IP address or URL of node to send the request to +* `--output json` (optional): Provides the output in JSON format #### Example @@ -60,9 +63,10 @@ all_host_chain_config: status: 0 ``` -> **Note**: Use `--output json` to get the output in JSON format. +#### Response -If the `status` is `0`, the IBC denomination is allowed for transactions. If the `status` is `1`, the IBC denomination is not allowed for transactions. Also, if the IBC denomination is not included in the response, it is not allowed for transactions. +1. The `ibc_denom` is the IBC denomination of the supported asset **on Osmsosis** (not the IBC denomination of the asset on cheqd). +2. If the `status` is `0`, the IBC denomination is allowed for transactions. If the `status` is `1`, the IBC denomination is not allowed for transactions. Also, if the IBC denomination is not included in the response, it is not allowed for transactions. ### Querying allowed IBC denominations via REST API @@ -124,6 +128,7 @@ cheqd-noded query feeabs osmo-arithmetic-twap --node * `ibc_denom`: The IBC denomination to convert the gas price to * `--node`: IP address or URL of node to send the request to +* `--output json` (optional): Provides the output in JSON format #### Example @@ -133,8 +138,6 @@ $ cheqd-noded query feeabs osmo-arithmetic-twap ibc/498A0751C798A0D9A389AA369112 osmo_arithmetic_twap: "34874.714483483365588155" ``` -> **Note**: Use `--output json` to get the output in JSON format. - If the desired IBC denomination is not configured, the response will error out with a message indicating that the IBC denomination is not allowed for transactions. ### Declaring fees in transactions From c433e51a8f034c7bba800ed505af97e39864cae0 Mon Sep 17 00:00:00 2001 From: Tasos Derisiotis <50984242+Eengineer1@users.noreply.github.com> Date: Thu, 20 Feb 2025 14:07:39 +0200 Subject: [PATCH 10/11] Added address conversion section --- docs/cheqd-cli/cheqd-cli-fee-abstraction.md | 2 +- docs/cheqd-cli/cheqd-cli-key-management.md | 4 ++++ 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md index 4b7597a..7d52c6f 100644 --- a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md +++ b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md @@ -24,7 +24,7 @@ You can find out if you've got sufficient balance in supported IBC denominations 1. Ensure you have added the cheqd wallet you want to use for transactions to a supported desktop/mobile wallet. The recommended wallet app is [Leap Wallet](https://www.leapwallet.io/download). If you previously used Keplr Wallet, we recommend [migrating from Keplr Wallet to Leap Wallet](https://docs.cheqd.io/product/network/wallets/migrate) as it has better support for [looking up real-time gas prices](./cheqd-cli-token-transactions.md). 2. Once you've added the cheqd wallet account to Leap Wallet, use the network switcher to switch to **Osmosis**. This will allow you to see the balances you have on Osmosis chain, including native OSMO as well as any IBC denominations such as USDC. 2. **Converting your cheqd address to Osmosis using CLI** - 1. TASOS: We should probably add this under the [key management](./cheqd-cli-key-management.md) and link to it from here. + 1. Refer to the [Converting bech32 address from / to chain-native prefix and vice-versa](./cheqd-cli-key-management.md#converting-bech32-address-from--to-chain-native-prefix-and-vice-versa) section in the [Manage keys](./cheqd-cli-key-management.md) page to convert your cheqd address to Osmosis. 2. Once you have obtained your Osmosis address, you can look up its balance using the [Osmosis CLI](https://docs.osmosis.zone/osmosis-core/osmosisd/) or through a block explorer like [Mintscan](https://mintscan.io/osmosis). ### Getting sufficient balance of supported IBC denominations on equivalent Osmosis account diff --git a/docs/cheqd-cli/cheqd-cli-key-management.md b/docs/cheqd-cli/cheqd-cli-key-management.md index e07a48b..8d40ea0 100644 --- a/docs/cheqd-cli/cheqd-cli-key-management.md +++ b/docs/cheqd-cli/cheqd-cli-key-management.md @@ -67,3 +67,7 @@ Most transactions will require you to use `--from ` param which is a ```bash cheqd-noded tx --from ``` + +### Converting bech32 address from / to chain-native prefix and vice-versa + +Refer to external tooling such as this [bech32 converter](https://cosmosdrops.io/en/tools/bech32-converter) to convert between bech32 addresses and chain-native addresses. From 2586ca0bfb4c27575b1093769cb984b58dc03d83 Mon Sep 17 00:00:00 2001 From: Ankur Banerjee Date: Thu, 20 Feb 2025 13:11:07 +0100 Subject: [PATCH 11/11] copyedit --- docs/cheqd-cli/cheqd-cli-fee-abstraction.md | 2 +- docs/cheqd-cli/cheqd-cli-key-management.md | 4 ---- 2 files changed, 1 insertion(+), 5 deletions(-) diff --git a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md index 7d52c6f..b869246 100644 --- a/docs/cheqd-cli/cheqd-cli-fee-abstraction.md +++ b/docs/cheqd-cli/cheqd-cli-fee-abstraction.md @@ -24,7 +24,7 @@ You can find out if you've got sufficient balance in supported IBC denominations 1. Ensure you have added the cheqd wallet you want to use for transactions to a supported desktop/mobile wallet. The recommended wallet app is [Leap Wallet](https://www.leapwallet.io/download). If you previously used Keplr Wallet, we recommend [migrating from Keplr Wallet to Leap Wallet](https://docs.cheqd.io/product/network/wallets/migrate) as it has better support for [looking up real-time gas prices](./cheqd-cli-token-transactions.md). 2. Once you've added the cheqd wallet account to Leap Wallet, use the network switcher to switch to **Osmosis**. This will allow you to see the balances you have on Osmosis chain, including native OSMO as well as any IBC denominations such as USDC. 2. **Converting your cheqd address to Osmosis using CLI** - 1. Refer to the [Converting bech32 address from / to chain-native prefix and vice-versa](./cheqd-cli-key-management.md#converting-bech32-address-from--to-chain-native-prefix-and-vice-versa) section in the [Manage keys](./cheqd-cli-key-management.md) page to convert your cheqd address to Osmosis. + 1. Use a [bech32 converter tool like this one](https://cosmosdrops.io/en/tools/bech32-converter) to convert a cheqd wallet address to an Osmosis address (use the prefix `osmo` for target address to convert to). 2. Once you have obtained your Osmosis address, you can look up its balance using the [Osmosis CLI](https://docs.osmosis.zone/osmosis-core/osmosisd/) or through a block explorer like [Mintscan](https://mintscan.io/osmosis). ### Getting sufficient balance of supported IBC denominations on equivalent Osmosis account diff --git a/docs/cheqd-cli/cheqd-cli-key-management.md b/docs/cheqd-cli/cheqd-cli-key-management.md index 8d40ea0..e07a48b 100644 --- a/docs/cheqd-cli/cheqd-cli-key-management.md +++ b/docs/cheqd-cli/cheqd-cli-key-management.md @@ -67,7 +67,3 @@ Most transactions will require you to use `--from ` param which is a ```bash cheqd-noded tx --from ``` - -### Converting bech32 address from / to chain-native prefix and vice-versa - -Refer to external tooling such as this [bech32 converter](https://cosmosdrops.io/en/tools/bech32-converter) to convert between bech32 addresses and chain-native addresses.