docs: enhance convert contract readme (#10)

Author: fmorency

contracts/converter/README.md

@@ -4,7 +4,14 @@ A CosmWasm smart contract for converting between MFX and different token denomin
 
 ## Overview
 
-The Converter contract facilitates the conversion of MFX tokens to target tokens at a predetermined exchange rate. 
+The Converter contract facilitates the conversion of MFX tokens to target tokens at a predetermined exchange rate.
+
+## Deployed Contracts
+
+| Network | Contract Address |
+|---------|------------------|
+| Mainnet | `manifest1wug8sewp6cedgkmrmvhl3lf3tulagm9hnvy8p0rppz9yjw0g4wtqdnm0gk` |
+| Testnet | `manifest1c4p5p0eajlymxak8z5ugmksfpvp5zmm3scrwdrtd5a6mwxnhsa9qnsfftk` |
 
 ## Features
 
@@ -100,6 +107,187 @@ Get current admin address:
 }
 ```
 
+## Interacting with the Contract
+
+You can interact with the deployed converter contract using either REST (via `curl`) or RPC (via `manifestd`).
+
+### Network Endpoints
+
+| Network | REST API | RPC |
+|---------|----------|-----|
+| Mainnet | `https://nodes.manifest.network/manifest/api` | `https://nodes.manifest.network/manifest/rpc` |
+| Testnet | `https://nodes.liftedinit.tech/manifest/testnet/api` | `https://nodes.liftedinit.tech/manifest/testnet/rpc` |
+
+For more information on network configurations, see:
+- [Mainnet Configuration](https://docs.manifest.network/network-configurations/mainnet)
+- [Testnet Configuration](https://docs.manifest.network/network-configurations/testnet)
+
+### Prerequisites
+
+#### Installing manifestd
+
+To use RPC commands, you need `manifestd` installed. It is a CosmosSDK-based chain binary with CosmWasm enabled.
+
+```bash
+# Clone and build from source
+git clone https://github.com/manifest-network/manifest-ledger
+cd manifest-ledger
+make install
+```
+
+#### Base64 Encoding for REST Queries
+
+REST API queries require the JSON query message to be base64-encoded. You can encode messages using:
+
+```bash
+# Linux/macOS
+echo -n '{"config":{}}' | base64
+# Output: eyJjb25maWciOnt9fQ==
+
+echo -n '{"admin":{}}' | base64
+# Output: eyJhZG1pbiI6e319
+```
+
+### Query Examples
+
+#### Get Contract Configuration
+
+**Mainnet (REST)**
+```bash
+curl "https://nodes.manifest.network/manifest/api/cosmwasm/wasm/v1/contract/manifest1wug8sewp6cedgkmrmvhl3lf3tulagm9hnvy8p0rppz9yjw0g4wtqdnm0gk/smart/eyJjb25maWciOnt9fQ=="
+```
+
+**Mainnet (RPC)**
+```bash
+manifestd q wasm contract-state smart manifest1wug8sewp6cedgkmrmvhl3lf3tulagm9hnvy8p0rppz9yjw0g4wtqdnm0gk '{"config":{}}' --node https://nodes.manifest.network/manifest/rpc
+```
+
+**Testnet (REST)**
+```bash
+curl "https://nodes.liftedinit.tech/manifest/testnet/api/cosmwasm/wasm/v1/contract/manifest1c4p5p0eajlymxak8z5ugmksfpvp5zmm3scrwdrtd5a6mwxnhsa9qnsfftk/smart/eyJjb25maWciOnt9fQ=="
+```
+
+**Testnet (RPC)**
+```bash
+manifestd q wasm contract-state smart manifest1c4p5p0eajlymxak8z5ugmksfpvp5zmm3scrwdrtd5a6mwxnhsa9qnsfftk '{"config":{}}' --node https://nodes.liftedinit.tech/manifest/testnet/rpc
+```
+
+#### Get Contract Admin
+
+**Mainnet (REST)**
+```bash
+curl "https://nodes.manifest.network/manifest/api/cosmwasm/wasm/v1/contract/manifest1wug8sewp6cedgkmrmvhl3lf3tulagm9hnvy8p0rppz9yjw0g4wtqdnm0gk/smart/eyJhZG1pbiI6e319"
+```
+
+**Mainnet (RPC)**
+```bash
+manifestd q wasm contract-state smart manifest1wug8sewp6cedgkmrmvhl3lf3tulagm9hnvy8p0rppz9yjw0g4wtqdnm0gk '{"admin":{}}' --node https://nodes.manifest.network/manifest/rpc
+```
+
+**Testnet (REST)**
+```bash
+curl "https://nodes.liftedinit.tech/manifest/testnet/api/cosmwasm/wasm/v1/contract/manifest1c4p5p0eajlymxak8z5ugmksfpvp5zmm3scrwdrtd5a6mwxnhsa9qnsfftk/smart/eyJhZG1pbiI6e319"
+```
+
+**Testnet (RPC)**
+```bash
+manifestd q wasm contract-state smart manifest1c4p5p0eajlymxak8z5ugmksfpvp5zmm3scrwdrtd5a6mwxnhsa9qnsfftk '{"admin":{}}' --node https://nodes.liftedinit.tech/manifest/testnet/rpc
+```
+
+### Execute Examples
+
+Execute transactions require a wallet with funds to pay for gas fees. The examples below use `manifestd` with a configured wallet.
+
+#### Convert Tokens
+
+Convert source tokens to target tokens. You must send the source tokens as funds with the transaction.
+
+**Mainnet**
+```bash
+manifestd tx wasm execute manifest1wug8sewp6cedgkmrmvhl3lf3tulagm9hnvy8p0rppz9yjw0g4wtqdnm0gk '{"convert":{}}' \
+  --amount 1000000umfx \
+  --from <your-wallet> \
+  --gas auto \
+  --gas-adjustment 1.5 \
+  --gas-prices 1.0umfx \
+  --node https://nodes.manifest.network/manifest/rpc \
+  --chain-id manifest-ledger-mainnet
+```
+
+**Testnet**
+```bash
+manifestd tx wasm execute manifest1c4p5p0eajlymxak8z5ugmksfpvp5zmm3scrwdrtd5a6mwxnhsa9qnsfftk '{"convert":{}}' \
+  --amount 1000000umfx \
+  --from <your-wallet> \
+  --gas auto \
+  --gas-adjustment 1.5 \
+  --gas-prices 1.0umfx \
+  --node https://nodes.liftedinit.tech/manifest/testnet/rpc \
+  --chain-id manifest-ledger-testnet
+```
+
+> **Note**: Replace `1000000umfx` with the actual source token denomination and amount configured in the contract. Query the contract configuration first to see the current `source_denom`.
+
+#### Update Config (Admin Only)
+
+Update the contract configuration. Only the contract admin can execute this.
+
+**Mainnet**
+```bash
+manifestd tx wasm execute manifest1wug8sewp6cedgkmrmvhl3lf3tulagm9hnvy8p0rppz9yjw0g4wtqdnm0gk \
+  '{"update_config":{"config":{"rate":"2.0","paused":false}}}' \
+  --from <admin-wallet> \
+  --gas auto \
+  --gas-adjustment 1.5 \
+  --gas-prices 1.0umfx \
+  --node https://nodes.manifest.network/manifest/rpc \
+  --chain-id manifest-ledger-mainnet
+```
+
+**Testnet**
+```bash
+manifestd tx wasm execute manifest1c4p5p0eajlymxak8z5ugmksfpvp5zmm3scrwdrtd5a6mwxnhsa9qnsfftk \
+  '{"update_config":{"config":{"rate":"2.0","paused":false}}}' \
+  --from <admin-wallet> \
+  --gas auto \
+  --gas-adjustment 1.5 \
+  --gas-prices 1.0umfx \
+  --node https://nodes.liftedinit.tech/manifest/testnet/rpc \
+  --chain-id manifest-ledger-testnet
+```
+
+> **Note**: All fields in `update_config` are optional. Only include the fields you want to change.
+
+#### Update Admin (Admin Only)
+
+Transfer admin privileges to a new address. Only the current admin can execute this.
+
+**Mainnet**
+```bash
+manifestd tx wasm execute manifest1wug8sewp6cedgkmrmvhl3lf3tulagm9hnvy8p0rppz9yjw0g4wtqdnm0gk \
+  '{"update_admin":{"admin":"manifest1newadminaddress..."}}' \
+  --from <current-admin-wallet> \
+  --gas auto \
+  --gas-adjustment 1.5 \
+  --gas-prices 1.0umfx \
+  --node https://nodes.manifest.network/manifest/rpc \
+  --chain-id manifest-ledger-mainnet
+```
+
+**Testnet**
+```bash
+manifestd tx wasm execute manifest1c4p5p0eajlymxak8z5ugmksfpvp5zmm3scrwdrtd5a6mwxnhsa9qnsfftk \
+  '{"update_admin":{"admin":"manifest1newadminaddress..."}}' \
+  --from <current-admin-wallet> \
+  --gas auto \
+  --gas-adjustment 1.5 \
+  --gas-prices 1.0umfx \
+  --node https://nodes.liftedinit.tech/manifest/testnet/rpc \
+  --chain-id manifest-ledger-testnet
+```
+
+> **Warning**: Admin transfer is irreversible. The contract does not allow renouncing admin privileges (setting admin to null).
+
 ## Development
 
 ### Building
@@ -124,3 +312,4 @@ Apache-2.0
 
 - **Repository**: https://github.com/manifest-network/manifest-contracts
 - **Homepage**: https://manifest.network
+- **manifestd**: https://github.com/manifest-network/manifest-ledger