chore(docs): erc20 docs feedback

Author: dancoombs

docs-site

@@ -16,7 +16,7 @@ for full descriptions of the parameters used in the following example.
   "method": "wallet_requestAccount",
   "params": [
     { 
-      "signerAddress": "'$SIGNER_ADDRESS'",
+      "signerAddress": "'$SIGNER_ADDRESS'"
     }
   ]
 }

docs/pages/transactions/pay-gas-with-any-token/api-postop.mdx

@@ -12,7 +12,7 @@
   "method": "wallet_requestAccount",
   "params": [
     { 
-      "signerAddress": "'$SIGNER_ADDRESS'",
+      "signerAddress": "'$SIGNER_ADDRESS'"
     }
   ]
 }

docs/pages/transactions/pay-gas-with-any-token/api-preop.mdx

@@ -38,7 +38,7 @@ const { preparedCallIds } = await client.sendCalls({
 
 ```ts twoslash title="client.ts"
 import "dotenv/config";
-import { Address, Hex, toHex } from "viem";
+import { type Address, type Hex, toHex } from "viem";
 import { LocalAccountSigner } from "@aa-sdk/core";
 import { alchemy, sepolia } from "@account-kit/infra";
 import { createSmartWalletClient } from "@account-kit/wallet-client";

docs/pages/transactions/pay-gas-with-any-token/client.mdx

@@ -1,22 +1,22 @@
 ---
 title: Pay gas with any token
 description: Enable users to pay gas with ERC-20 tokens like USDC
-slug: wallets/transactions/sponsor-gas/pay-gas-with-any-token/overview
+slug: wallets/transactions/pay-gas-with-any-token
 ---
 
 Gas fees paid in the native token can feel foreign to users that primarily hold stablecoins or your app's own token.
-With smart wallets, you can allow users to pay for gas with any ERC-20 token, streamlining the user experience.
+With Smart Wallets, you can allow users to pay for gas with any ERC-20 token, streamlining the user experience.
 
 ## How it works
 
-When a user pays for gas with an ERC-20 token, the gas is fronted using the network's native gas token and the ERC-20 tokens are transferred from the user's wallet to a wallet you configure in the policy. The equivalent USD amount and the admin fee are then added to your monthly invoice.
+When a user pays for gas with an ERC-20 token, the gas is fronted using the network's native gas token and the ERC-20 tokens are transferred from the user's wallet to a wallet you configure in the policy.
+The equivalent USD amount and the admin fee are then added to the developer's monthly invoice.
 
-We recommend using "post-operation" mode for most use cases. This mode requires users to hold enough of the gas token in their wallet after their operation completes to pay the gas fee. If the balance is insufficient, the transaction reverts and you sponsor any gas used without ERC-20 payment. If this doesn't work for your use case, see the [ERC-20 gas payment modes](#erc-20-gas-payment-modes) section below for more options.
+Post-operation mode is recommended. This mode requires users to hold enough of the gas token in their wallet after their operation completes to pay the gas fee. If the balance is insufficient, the transaction reverts and you sponsor any gas used without ERC-20 payment. If this doesn't work for your use case, see the [ERC-20 gas payment modes](#erc-20-gas-payment-modes) section below for more options.
 
 ## Prerequisites
 
 - API key from your [dashboard](https://dashboard.alchemy.com/apps)
-- [Smart Wallets installed and configured in your project](/docs/wallets/pages/react/setup.mdx).
 - [A "pay gas with any token" policy](https://dashboard.alchemy.com/gas-manager/policy/create).
 
 ## Implementation
@@ -40,14 +40,17 @@ We recommend using "post-operation" mode for most use cases. This mode requires
 Pay gas with any token also works with the prepare calls methods in the various frameworks. Usage of the capability will be the same as when using send calls. It is recommended to use prepare calls if you want to inspect the prepared call prior to prompting the user for signature.
 
 <Tabs>
-  <Tab title="React">TODO - add link to `usePrepareCalls`</Tab>
+  <Tab title="React">
+    See the [`usePrepareCalls` react
+    hook](/wallets/reference/account-kit/react/hooks/usePrepareCalls)
+  </Tab>
   <Tab title="Javascript">
     See the [`prepareCalls` SDK
-    reference](/docs/wallets/reference/account-kit/wallet-client/functions/prepareCalls)
+    reference](/wallets/reference/account-kit/wallet-client/functions/prepareCalls)
   </Tab>
   <Tab title="API">
     See the [`wallet_prepareCalls` API
-    reference](/docs/wallets/api/smart-wallets/wallet-api-endpoints/wallet-api-endpoints/wallet-prepare-calls)
+    reference](/wallets/api/smart-wallets/wallet-api-endpoints/wallet-api-endpoints/wallet-prepare-calls)
   </Tab>
 </Tabs>
 
@@ -58,7 +61,7 @@ The configured mode determines when the user's token payment occurs.
 
 **[Recommended] Post-Operation**
 
-- No upfront allowance is required
+- No upfront allowance is required.
 - The user signs an approval inside the same calls batch, and the paymaster pulls the token after the operation has executed.
 - If that post-operation transfer fails, the entire batch is reverted and you (the developer) pay the gas fee.
 
@@ -68,15 +71,15 @@ The configured mode determines when the user's token payment occurs.
 - This can be done either through a prior call to `approve()` or by using an [ERC-7597 Permit](https://eips.ethereum.org/EIPS/eip-7597) signature.
 - If the required allowance isn't in place when the user operation is submitted, it will be rejected.
 
-We recommend using post-operation mode for most use cases. This mode:
+Post-operation mode is recommended for most use cases. This mode:
 
 - Is the most gas efficient as it only requires a single transfer.
 - Works with all ERC-20 tokens.
 - Only ever requires a single signature from the user.
 
-However, because tokens are deducted after execution, you may be required to pay for gas without receiving sufficient ERC-20 payment.
-Ensure that users have enough token left over to pay for gas after the operation, otherwise you won't receive payment from users for gas and the operation will revert.
-If the operation results in a static amount of the user’s ERC-20 token balance after execution and you can account for this before submitting the operation, use PostOp mode.
+However, because tokens are deducted after execution, the developer may be required to pay for gas without receiving sufficient ERC-20 payment.
+The developer should ensure that users have enough token left over to pay for gas after the operation, otherwise they won't receive payment from users for gas and the operation will revert.
+If the operation results in a static amount of the user’s ERC-20 token balance after execution and the developer can account for this before submitting the operation, use PostOp mode.
 
 Examples of static amounts:
 
@@ -163,7 +166,7 @@ approval, the following steps inject the permit:
 
 Build more:
 
-- [Sponsor gas for users](/docs/wallets/transactions/sponsor-gas/sponsor-gas)
+- [Sponsor gas for users](/wallets/transactions/sponsor-gas)
 
 Troubleshooting:
 

docs/pages/transactions/pay-gas-with-any-token/index.mdx

@@ -1,13 +1,17 @@
 <Info>Required SDK version: ^v4.61.0</Info>
 
 Use the `useSendCalls` hook and the `paymasterService` capability parameter to send calls with
-an ERC20 token paymaster. You can also use the `usePrepareCalls` hook to only prepare the operation for signing.
+an ERC20 token paymaster.
+
+**Prerequisites**
+
+- [Smart Wallets installed and configured in your project](/docs/wallets/pages/react/setup.mdx).
 
 <CodeBlocks>
 
 ```ts twoslash title="sendCalls.tsx" focus={5-7,14-27}
 import { useSendCalls, useSmartAccountClient } from "@account-kit/react";
-import { config } from "@/app/components/config";
+import { config } from "./config";
 
 export default function SendCalls() {
   const { client } = useSmartAccountClient({});
@@ -58,7 +62,7 @@ export default function SendCalls() {
 ```
 
 ```ts twoslash title="config.ts"
-import { Address, toHex } from "viem";
+import { type Address, toHex } from "viem";
 
 export const config = {
   policyId: process.env.ALCHEMY_POLICY_ID!,