sway-book: fix forc call examples

docs/book/src/forc/plugins/forc_client/forc_call.md

@@ -1,236 +1,2 @@
-# Forc Call
-
-`forc-call` is a command-line tool for interacting with deployed Fuel contracts. It allows you to make contract calls, query contract state, and interact with any deployed contract on the Fuel network - all from your command line!
-
-The `forc call` command is part of the Forc toolchain and is installed alongside other Forc tools.
-
-## Getting Started
-
-Here are a few examples of what you can do with `forc call`:
-
-```sway
-contract;
-
-abi ContractABI {
-  fn add(a: u64, b: u64) -> u64;
-}
-
-impl ContractABI for Contract {
-  fn add(a: u64, b: u64) -> u64 {
-    a + b
-  }
-}
-```
-
-### List callable functions of a contract given it's ABI file
-
-```bash
-forc call 0xe18de7c7c8c61a1c706dccb3533caa00ba5c11b5230da4428582abf1b6831b4d \
-  --abi ./out/debug/counter-contract-abi.json \
-  --list-functions
-```
-
-Output:
-
-```log
-Available functions in contract: 0xe18de7c7c8c61a1c706dccb3533caa00ba5c11b5230da4428582abf1b6831b4d
-
-add(a: u64, b: u64) -> u64
-  forc call \
-    --abi ./out/debug/counter-contract-abi.json \
-    0xe18de7c7c8c61a1c706dccb3533caa00ba5c11b5230da4428582abf1b6831b4d \
-    add "0" "0"
-```
-
-### Call a simple addition function on a deployed contract (in dry-run mode)
-
-```bash
-forc call 0xe18de7c7c8c61a1c706dccb3533caa00ba5c11b5230da4428582abf1b6831b4d \
-  --abi ./out/debug/counter-contract-abi.json \
-  add 1 2
-```
-
-### Directly send funds to an address
-
-```bash
-forc call 0x2c7Fd852EF2BaE281e90ccaDf18510701989469f7fc4b042F779b58a39919Eec --amount 2 --mode=live
-```
-
-### Query the owner of a deployed [DEX contract](https://github.com/mira-amm/mira-v1-core) on testnet
-
-```bash
-forc call \
-  --testnet \
-  --abi https://raw.githubusercontent.com/mira-amm/mira-v1-periphery/refs/heads/main/fixtures/mira-amm/mira_amm_contract-abi.json \
-  0xd5a716d967a9137222219657d7877bd8c79c64e1edb5de9f2901c98ebe74da80 \
-  owner
-```
-
-## Usage
-
-The basic syntax for `forc call` is:
-
-```bash
-forc call [OPTIONS] --abi <ABI-PATH/URL> <CONTRACT_ID> <SELECTOR> [ARGS]...
-```
-
-Where the following arguments are required:
-
-- `CONTRACT_ID` is the ID of the deployed contract you want to interact with
-- `ABI-PATH/URL` is the path or URL to the contract's JSON ABI file
-- `SELECTOR` is the function name (selector) you want to call
-- `ARGS` are the arguments to pass to the function
-
-## Type Encoding
-
-When passing arguments to contract functions, values are encoded according to their Sway types.
-Here's how to format different types:
-
-| Types                                         | Example input                                                        | Notes                                                                                          |
-|-----------------------------------------------|----------------------------------------------------------------------|------------------------------------------------------------------------------------------------|
-| bool                                          | `true` or `false`                                                    |                                                                                                |
-| u8, u16, u32, u64, u128, u256                 | `42`                                                                 |                                                                                                |
-| b256                                          | `0x0000000000000000000000000000000000000000000000000000000000000042` or `0000000000000000000000000000000000000000000000000000000000000042` | `0x` prefix is optional |
-| bytes, RawSlice                               | `0x42` or `42`                                                       | `0x` prefix is optional                                                                                               |
-| String, StringSlice, StringArray (Fixed-size) | `"abc"`                                                              |                                                                                                |
-| Tuple                                         | `(42, true)`                                                         | The types in tuple can be different                                                                                               |
-| Array (Fixed-size), Vector (Dynamic)          | `[42, 128]`                                                          | The types in array or vector must be the same; i.e. you cannot have `[42, true]`              |
-| Struct                                        | `{42, 128}`                                                          | Since structs are packed encoded, the attribute names are not encoded; i.e. `{42, 128}`; this could represent the following `struct Polygon { x: u64, y: u64 }` |
-| Enum                                          | `(Active: true)` or `(1: true)`       | Enums are key-val pairs with keys as being variant name (case-sensitive) or variant index (starting from 0) and values as being the variant value; this could represent the following `enum MyEnum { Inactive, Active(bool) }` |
-
-## ABI Support
-
-The ABI (Application Binary Interface) can be provided in two ways.
-
-### Local file
-
-```bash
-forc call <CONTRACT_ID> --abi ./path/to/abi.json <FUNCTION> [ARGS...]
-```
-
-### Remote ABI file/URL
-
-```bash
-forc call <CONTRACT_ID> --abi https://example.com/abi.json <FUNCTION> [ARGS...]
-```
-
-## Network Configuration
-
-```bash
-forc call --node-url http://127.0.0.1:4000 ...
-# or
-forc call --target local ...
-```
-
-## Advanced Usage
-
-### Using Wallets
-
-```sh
-# utilising the forc-wallet
-forc call <CONTRACT_ID> --abi <PATH> <FUNCTION> --wallet
-```
-
-```sh
-# with an explicit signing key
-forc call <CONTRACT_ID> --abi <PATH> <FUNCTION> --signing-key <KEY>
-```
-
-### Asset Transfers
-
-```sh
-# Native asset transfer
-forc call <CONTRACT_ID> --abi <PATH> <FUNCTION> --amount 100 --live
-```
-
-```sh
-# Custom asset transfer
-forc call <CONTRACT_ID> --abi <PATH> <FUNCTION> \
-    --amount 100 \
-    --asset-id 0x1234... \
-    --live
-```
-
-### Gas Configuration
-
-```sh
-# Set gas price
-forc call <CONTRACT_ID> --abi <PATH> <FUNCTION> --gas-price 1
-
-# Forward gas to contract
-forc call <CONTRACT_ID> --abi <PATH> <FUNCTION> --gas-forwarded 1000
-
-# Set maximum fee
-forc call <CONTRACT_ID> --abi <PATH> <FUNCTION> --max-fee 5000
-```
-
-### Common Use Cases
-
-#### Contract State Queries
-
-```sh
-# Read contract state
-forc call <CONTRACT_ID> --abi <PATH> get_balance
-
-# Query with parameters
-forc call <CONTRACT_ID> --abi <PATH> get_user_info 0x1234...
-```
-
-#### Token Operations
-
-```sh
-# Check token balance
-forc call <CONTRACT_ID> --abi <PATH> balance_of 0x1234...
-
-# Transfer tokens
-forc call <CONTRACT_ID> --abi <PATH> transfer 0x1234... 100 --live
-```
-
-#### Contract Administration
-
-```sh
-# Check contract owner
-forc call <CONTRACT_ID> --abi <PATH> owner
-
-# Update contract parameters
-forc call <CONTRACT_ID> --abi <PATH> update_params 42 --live
-```
-
-## Tips and Tricks
-
-- Use `--mode simulate` to estimate gas costs before making live transactions
-- External contracts are automatically detected (via internal simulations), but can be manually specified with `--external-contracts`
-- For complex parameter types (tuples, structs, enums), refer to the parameter types table above
-- Always verify contract addresses and ABIs before making live calls
-- Use environment variables for sensitive data like signing keys: `SIGNING_KEY=<key>`
-
-## Troubleshooting
-
-### Common issues and solutions
-
-- **ABI Mismatch**:
-  - Ensure the ABI matches the deployed contract
-  - Verify function selectors match exactly
-
-- **Parameter Type Errors**:
-  - Check parameter formats in the types table
-  - Ensure correct number of parameters
-
-- **Network Issues**:
-  - Verify node connection
-  - Check network selection (testnet/mainnet)
-
-- **Transaction Failures**:
-  - Use simulation mode to debug
-  - Check gas settings
-  - Verify wallet has sufficient balance
-
-## Future Features
-
-The following features are planned for future releases:
-
-- Support direct transfer of asset(s) to addresses
-- Function signature based calls without ABI
-- Raw calldata input support
-- Function selector completion
-- Enhanced error messages, debugging, and logging (additional verbosity modes)
+# forc call
+<!-- source: scripts/mdbook-forc-documenter/examples/forc_call.md -->

forc-plugins/forc-client/src/cmd/call.rs

@@ -163,76 +163,99 @@ pub enum Operation {
 /// Perform Fuel RPC calls from the comfort of your command line.
 #[derive(Debug, Parser, Clone)]
 #[clap(bin_name = "forc call", version)]
-#[clap(after_help = r#"EXAMPLES:
+#[clap(after_help = r#"
+## EXAMPLES:
 
-# Call a contract with function parameters
-» forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
+### Call a contract with function parameters
+```sh
+forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
     --abi ./contract-abi.json \
     get_balance 0x0087675439e10a8351b1d5e4cf9d0ea6da77675623ff6b16470b5e3c58998423
+```
 
-# Call a contract with function parameters; additionally print logs, receipts and script json
-» forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
+### Call a contract with function parameters; additionally print logs, receipts and script json
+```sh
+forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
     --abi ./contract-abi.json \
     get_balance 0x0087675439e10a8351b1d5e4cf9d0ea6da77675623ff6b16470b5e3c58998423 \
     -vv
+```
 
-# Call a contract without function parameters
-» forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
+### Call a contract without function parameters
+```sh
+forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
     --abi ./contract-abi.json \
     get_name
+```
 
-# Call a contract that makes external contract calls
-» forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
+### Call a contract that makes external contract calls
+```sh
+forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
     --abi ./contract-abi.json \
     transfer 0xf8f8b6283d7fa5b672b530cbb84fcccb4ff8dc40f8176ef4544ddb1f1952ad07 \
     --contracts 0xf8f8b6283d7fa5b672b530cbb84fcccb4ff8dc40f8176ef4544ddb1f1952ad07
+```
 
-# Call a contract in simulation mode
-» forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
+### Call a contract in simulation mode
+```sh
+forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
     --abi ./contract-abi.json \
     add 1 2 \
     --mode simulate
+```
 
-# Call a contract in dry-run mode on custom node URL using explicit signing-key
-» forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
+### Call a contract in dry-run mode on custom node URL using explicit signing-key
+```sh
+forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
     --node-url "http://127.0.0.1:4000/v1/graphql" \
     --signing-key 0x... \
     --abi ./contract-abi.json \
     add 1 2 \
     --mode dry-run
+```
 
-# Call a contract in live mode which performs state changes on testnet using forc-wallet
-» forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
+### Call a contract in live mode which performs state changes on testnet using forc-wallet
+```sh
+forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
     --testnet \
     --wallet \
     --abi ./contract-abi.json \
     add 1 2 \
     --mode live
+```
 
-# Call a contract payable function which transfers value of native asset on mainnet
-» forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
+### Call a contract payable function which transfers value of native asset on mainnet
+```sh
+forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
     --abi ./contract-abi.json \
     transfer 0xf8f8b6283d7fa5b672b530cbb84fcccb4ff8dc40f8176ef4544ddb1f1952ad07 \
     --mode live \
     --amount 100
+```
 
-# Call a contract payable function which transfers value of custom asset
-» forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
+### Call a contract payable function which transfers value of custom asset
+```sh
+forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
     --abi ./contract-abi.json \
     transfer 0xf8f8b6283d7fa5b672b530cbb84fcccb4ff8dc40f8176ef4544ddb1f1952ad07 \
     --amount 100 \
     --asset-id 0x0087675439e10a8351b1d5e4cf9d0ea6da77675623ff6b16470b5e3c58998423 \
     --live
+```
 
-# List all available functions in a contract
-» forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
+### List all available functions in a contract
+```sh
+forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
     --abi ./contract-abi.json \
     --list-functions
+```
 
-# Direct transfer of asset to a contract or address
-» forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
+### Direct transfer of asset to a contract or address
+```sh
+forc call 0x0dcba78d7b09a1f77353f51367afd8b8ab94b5b2bb6c9437d9ba9eea47dede97 \
     --amount 100 \
     --mode live
+```
 "#)]
 pub struct Command {
     /// The contract ID to call