From 5f4740bdf05edbbe642381d5e17b26478a34510c Mon Sep 17 00:00:00 2001
From: Jade Of Wallstreet <samuelchimmy@gmail.com>
Date: Sat, 23 May 2026 21:41:31 +0100
Subject: [PATCH 1/2] docs(minipay): add USDT and USDC 6-decimal note to ERC20
 transfer snippet

---
 build-on-celo/build-on-minipay/code-library.mdx | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/build-on-celo/build-on-minipay/code-library.mdx b/build-on-celo/build-on-minipay/code-library.mdx
index 599fdc75d..ffae3df6a 100644
--- a/build-on-celo/build-on-minipay/code-library.mdx
+++ b/build-on-celo/build-on-minipay/code-library.mdx
@@ -358,6 +358,12 @@ console.log(attestations.accounts);
 
 ## Request an ERC20 token transfer
 
+<Warning>
+  USDT and USDC on Celo use **6 decimals**, not 18. Pass `tokenDecimals` as `6` when
+  transferring either token. Using `18` will send 1,000,000,000,000× more than intended.
+  USDm uses 18 decimals.
+</Warning>
+
 ```js
 import { createWalletClient, createPublicClient, custom, http, encodeFunctionData, parseUnits } from "viem";
 import { celo, celoSepolia } from "viem/chains";
@@ -378,16 +384,16 @@ const publicClient = createPublicClient({
 async function requestTransfer(tokenAddress, transferValue, tokenDecimals, receiverAddress) {
   const hash = await walletClient.sendTransaction({
     to: tokenAddress,
-    // Mainnet addresses:
-    // USDm: '0x765DE816845861e75A25fCA122bb6898B8B1282a'
-    // USDC: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C'
-    // USDT: '0x48065fbbe25f71c9282ddf5e1cd6d6a887483d5e'
+    // Mainnet token addresses and their decimals:
+    // USDm: '0x765DE816845861e75A25fCA122bb6898B8B1282a'  (18 decimals)
+    // USDC: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C'  (6 decimals)
+    // USDT: '0x48065fbbe25f71c9282ddf5e1cd6d6a887483d5e'  (6 decimals)
     data: encodeFunctionData({
       abi: stableTokenABI, // Token ABI from @celo/abis
       functionName: "transfer",
       args: [
         receiverAddress,
-        // Different tokens can have different decimals, USDm (18), USDC (6)
+        // USDm uses 18 decimals; USDC and USDT use 6 decimals
         parseUnits(`${Number(transferValue)}`, tokenDecimals),
       ],
     }),

From 508b5910a9fac1069ed63b7347d68d1942878053 Mon Sep 17 00:00:00 2001
From: Jade Of Wallstreet <samuelchimmy@gmail.com>
Date: Sat, 23 May 2026 21:41:52 +0100
Subject: [PATCH 2/2] docs(fee-abstraction): add USDT celocli transfer example
 with adapter address

---
 .../fee-abstraction/using-fee-abstraction.mdx       | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/build-on-celo/fee-abstraction/using-fee-abstraction.mdx b/build-on-celo/fee-abstraction/using-fee-abstraction.mdx
index 99b31a63f..806d40578 100644
--- a/build-on-celo/fee-abstraction/using-fee-abstraction.mdx
+++ b/build-on-celo/fee-abstraction/using-fee-abstraction.mdx
@@ -65,7 +65,18 @@ celocli transfer:erc20 \
   --privateKey [PRIVATE_KEY]
 ```
 
-When using USDC or USDT, use the adapter address (not the token address) to avoid inaccuracies caused by their 6-decimal precision.
+When using USDC or USDT, use the **adapter address** (not the token address) as `--gasCurrency`. Both tokens use 6 decimals — pass `--value` in units of `10^6` (e.g. `1000000` = 1 USDT/USDC).
+
+Transfer 1 USDT using USDT as the fee currency:
+```bash
+celocli transfer:erc20 \
+  --erc20Address 0x48065fbbe25f71c9282ddf5e1cd6d6a887483d5e \
+  --from 0x22ae7Cf4cD59773f058B685a7e6B7E0984C54966 \
+  --to 0xDF7d8B197EB130cF68809730b0D41999A830c4d7 \
+  --value 1000000 \
+  --gasCurrency 0x0e2a3e05bc9a16f5292a6170456a710cb89c6f72 \
+  --privateKey [PRIVATE_KEY]
+```
 
 ---