From cdef531fd9358a58c033eb1e66dfdfaa9e59474e Mon Sep 17 00:00:00 2001
From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com>
Date: Tue, 24 Feb 2026 03:05:36 +0000
Subject: [PATCH] docs: sync documentation with v0.13.0

Updated documentation to reflect gas tracking improvements in v0.13.0:

- Added `gasUsedWei` field to direct execution status response example
- Updated Web3 plugin outputs to include `gasUsed` for all write operations:
  - Write Contract now returns gasUsed and transactionLink
  - Transfer Native Token now returns gasUsed and transactionLink
  - Transfer ERC20 Token now returns gasUsed

These changes align with the implementation where gas usage is now properly
tracked from transaction receipts instead of being hardcoded to "0".

Other v0.13.0 changes (analytics search atom, protocol registry events) are
internal implementation details that do not require documentation updates.
---
 docs/api/direct-execution.md | 1 +
 docs/plugins/web3.md         | 6 +++---
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/api/direct-execution.md b/docs/api/direct-execution.md
index 2089c28d..e067f71d 100644
--- a/docs/api/direct-execution.md
+++ b/docs/api/direct-execution.md
@@ -209,6 +209,7 @@ Check the status of a direct execution.
   "type": "transfer",
   "transactionHash": "0x...",
   "transactionLink": "https://etherscan.io/tx/0x...",
+  "gasUsedWei": "21000000000000",
   "result": {...},
   "error": null,
   "createdAt": "2024-01-01T00:00:00Z",
diff --git a/docs/plugins/web3.md b/docs/plugins/web3.md
index 0cf58826..46037a8d 100644
--- a/docs/plugins/web3.md
+++ b/docs/plugins/web3.md
@@ -393,7 +393,7 @@ Execute state-changing functions on smart contracts using your Para wallet. Requ
 
 **Inputs:** Network, Contract Address, ABI (auto-fetched), Function, Function Arguments, Gas Limit Multiplier (optional, in Advanced section)
 
-**Outputs:** `success`, `transactionHash`, `result`, `error`
+**Outputs:** `success`, `transactionHash`, `transactionLink`, `gasUsed`, `result`, `error`
 
 **When to use:** Execute DeFi operations (harvest, compound, rebalance), respond to on-chain events, automate protocol maintenance.
 
@@ -407,7 +407,7 @@ Send ETH, MATIC, or other native tokens from your Para wallet to a recipient add
 
 **Inputs:** Network, Amount (ETH), Recipient Address, Gas Limit Multiplier (optional, in Advanced section)
 
-**Outputs:** `success`, `transactionHash`, `error`
+**Outputs:** `success`, `transactionHash`, `transactionLink`, `gasUsed`, `error`
 
 **When to use:** Refill bot wallets, distribute funds, automate payroll.
 
@@ -421,7 +421,7 @@ Send ERC20 tokens from your Para wallet to a recipient address.
 
 **Inputs:** Network, Token, Amount, Recipient Address, Gas Limit Multiplier (optional, in Advanced section)
 
-**Outputs:** `success`, `transactionHash`, `transactionLink`, `amount`, `symbol`, `recipient`, `error`
+**Outputs:** `success`, `transactionHash`, `transactionLink`, `gasUsed`, `amount`, `symbol`, `recipient`, `error`
 
 **When to use:** Distribute tokens, move funds between wallets, automate token transfers based on conditions.