BofAI · jizhen181-dot · Aug 26, 2026 · Aug 26, 2026
diff --git a/changelog/index.md b/changelog/index.md
@@ -7,6 +7,33 @@ description: 'Product updates and announcements for BANK OF AI — all products,
 
 Product updates and announcements for BANK OF AI.
 
+<div className="changelog-entry">
+<div className="changelog-date">Aug 25, 2026</div>
+<div className="changelog-body">
+
+### x402 SDK v1.1.0 · Docs
+
+<div className="changelog-tags"><span className="changelog-tag">New Release</span><span className="changelog-tag">x402</span><span className="changelog-tag">Docs</span></div>
+
+- **x402 SDK 1.1.0** — explicit payment flows (`upfront` / `escrow` on the wire as `extra.paymentFlow`, `authorization` by default), client spend controls on by default (`$1` per-payment cap, default-asset allowlist), payment-selection policies and lifecycle hooks, EVM smart-account support (ERC-7702, allowlisted ERC-6492), and a 90-second `HTTPFacilitatorClient` timeout. Upgrade all 11 packages together; Node.js 22+. [SDK Feature Matrix](../x402/sdk-features/)
+- **Docs corrections** — removed the obsolete facilitator-fee material (`base_fee`, `extra.fee`, `/fee/quote`); the anonymous `/settle` limit is 1 request/minute on the official deployment; GasFree is no longer described as auto-preferred — the CLI takes the first advertised requirement matching your filters, so pass `--scheme exact_gasfree` to force it; TRON Shasta is now documented as signed by the SDK/CLI but **not** settled by the official facilitator (use Nile or self-host); the CLI page now states its **pinned** dependencies — CLI 1.0.2 still bundles the `@bankofai/x402-*` SDK packages at 1.0.1 (`@bankofai/x402-gateway` at 1.0.2), so it does not yet carry the 1.1.0 client spend controls; and the Skills pages now install with `npx skills add … -g`. [x402 docs](../x402/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Aug 20, 2026</div>
+<div className="changelog-body">
+
+### Facilitator — BSC receipt reliability
+
+<div className="changelog-tags"><span className="changelog-tag">Fix</span><span className="changelog-tag">Facilitator</span></div>
+
+- Settlement receipt lookups on **BSC Mainnet** (`eip155:56`) fall back to a secondary RPC endpoint, so one unresponsive node no longer turns a settled payment into a failed one. [Official Facilitator](../x402/core-concepts/OfficialFacilitator/)
+
+</div>
+</div>
+
 <div className="changelog-entry">
 <div className="changelog-date">Jul 30, 2026</div>
 <div className="changelog-body">
@@ -22,13 +49,29 @@ Product updates and announcements for BANK OF AI.
 </div>
 </div>
 
+<div className="changelog-entry">
+<div className="changelog-date">Jul 29, 2026</div>
+<div className="changelog-body">
+
+### Official Facilitator — Base settlement
+
+<div className="changelog-tags"><span className="changelog-tag">Update</span><span className="changelog-tag">Facilitator</span><span className="changelog-tag">Base</span></div>
+
+- The official facilitator now settles **Base USDC** — `eip155:8453` (Mainnet) and `eip155:84532` (Sepolia) are enabled alongside TRON Mainnet/Nile and BSC Mainnet/Testnet. The bundled example facilitator still registers only `eip155:97` and `eip155:56` on the EVM side, so self-hosting Base sellers must add the Base ids themselves. [Official Facilitator](../x402/core-concepts/OfficialFacilitator/)
+- **Breaking for self-hosters** — the facilitator config now takes canonical CAIP-2 ids only; friendly aliases such as `bsc:mainnet` and `tron:nile` are no longer resolved and are rejected at startup.
+
+</div>
+</div>
+
 <div className="changelog-entry">
 <div className="changelog-date">Jul 21, 2026</div>
 <div className="changelog-body">
 
 ### Docs
 
-<div className="changelog-tags"><span className="changelog-tag">Product Updates</span><span className="changelog-tag">Docs</span><span className="changelog-tag">x402</span></div>
+<div className="changelog-tags"><span className="changelog-tag">Product Updates</span><span className="changelog-tag">Docs</span><span className="changelog-tag">x402</span><span className="changelog-tag">SKILLS</span></div>
+
+- **SKILLS — `x402-payment` now pays through `x402-cli`** (1.0.1 or newer) instead of bundled local scripts, with a `--dry-run` preview, `--max-amount` caps, a required GasFree fee cap, and canonical CAIP-2 TRON ids. [Details](./skills/)
 
 - **TRON network IDs now use CAIP-2 format** across the x402 docs — `tron:0x2b6653dc` (Mainnet), `tron:0xcd8690dc` (Nile), `tron:0x94a9059e` (Shasta). In application code, prefer the SDK constants `TRON_MAINNET` / `TRON_NILE` / `TRON_SHASTA` over hard-coded hex strings. [Network & Token Support](../x402/core-concepts/network-and-token-support/)
 - **`auth-capture` scheme removed** — x402 now documents four payment schemes: `exact`, `upto`, `batch-settlement`, and `exact_gasfree` (TRON). [SDK Features](../x402/sdk-features/)

diff --git a/changelog/skills.md b/changelog/skills.md
@@ -7,6 +7,24 @@ description: 'Release notes for SKILLS.'
 
 Release notes for SKILLS.
 
+<div className="changelog-entry">
+<div className="changelog-date">Jul 21, 2026</div>
+<div className="changelog-body">
+
+### x402-payment now runs on the x402 CLI
+
+<div className="changelog-tags"><span className="changelog-tag">Update</span><span className="changelog-tag">x402</span></div>
+
+- **Payments go through `x402-cli`** (1.0.1 or newer) instead of bundled local TypeScript scripts. The skill checks your installed version and tells you how to install the CLI when it is missing.
+- **Every payment is previewed and capped** — a `--dry-run --json` preview before the first payment to an unfamiliar endpoint, and `--max-amount` on the real request. GasFree payments must also cap the relayer fee with `--max-gasfree-fee`, which the payment cap does not cover.
+- **Canonical CAIP-2 TRON identifiers only** — `tron:0x2b6653dc`, `tron:0xcd8690dc`, `tron:0x94a9059e`. Shorthand aliases such as `tron:mainnet` are rejected. The `agent-wallet` skill uses the same identifiers.
+- The retired `--gasfree-info` / `--gasfree-activate` script flags are gone, and uninstall now handles custom skill directories.
+
+👉 [Skill Catalog](/McpServer-Skills/SKILLS/BANKOFAISkill/)
+
+</div>
+</div>
+
 <div className="changelog-entry">
 <div className="changelog-date">Jul 10, 2026</div>
 <div className="changelog-body">

diff --git a/changelog/x402.md b/changelog/x402.md
@@ -7,6 +7,39 @@ description: 'Release notes for the x402 payment protocol, SDK, and CLI.'
 
 Release notes for the x402 protocol, SDK, and [CLI](/x402/cli/).
 
+<div className="changelog-entry">
+<div className="changelog-date">Aug 25, 2026</div>
+<div className="changelog-body">
+
+### x402 SDK v1.1.0 — payment flows & wallet compatibility
+
+<div className="changelog-tags"><span className="changelog-tag">New Release</span><span className="changelog-tag">SDK</span></div>
+
+- **Payment flows are now explicit** — a scheme/network server declares the flows it supports per asset-transfer method. `upfront` and `escrow` travel on the wire as `extra.paymentFlow`; `authorization` stays the default and is omitted from `extra`. Legacy v1.0 servers that declare nothing keep using the authorization flow.
+- **Client spend controls are on by default** — a client pays only assets it recognizes from the default-asset registry, capped at `DEFAULT_MAX_AMOUNT_PER_PAYMENT` (`$1` worth) per payment. Raise the cap with `spendControls.maxAmountPerPayment`, allow a custom token with `spendControls.allowedAssets`, or switch the guard off with `spendControls: false`.
+- **Payment-selection policies and lifecycle hooks** — `PaymentPolicy` plus `onBeforePaymentCreation` / `onAfterPaymentCreation` / `onPaymentCreationFailure` / `onPaymentResponse`.
+- **EVM wallet compatibility** — deployed smart accounts, ERC-7702 delegation, and allowlisted ERC-6492 counterfactual wallets. ERC-6492 requires an explicit `eip6492AllowedFactories` allowlist on the facilitator.
+- **`HTTPFacilitatorClient`** gains typed timeout errors, rate-limit retries, stricter response validation, and a 90-second default timeout.
+- Upgrade all **11 `@bankofai/x402-*` packages together** — internal dependencies resolve to `~1.1.0`. The SDK requires **Node.js 22+**. Custom money parsers now receive decimal strings.
+
+👉 [SDK Feature Matrix](/x402/sdk-features/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Aug 20, 2026</div>
+<div className="changelog-body">
+
+### Facilitator — BSC receipt reliability
+
+<div className="changelog-tags"><span className="changelog-tag">Fix</span><span className="changelog-tag">Facilitator</span></div>
+
+- Settlement receipt lookups on **BSC Mainnet** (`eip155:56`) now fall back to a secondary RPC endpoint, so a single unresponsive node no longer turns a settled payment into a failed one.
+
+</div>
+</div>
+
 <div className="changelog-entry">
 <div className="changelog-date">Jul 30, 2026</div>
 <div className="changelog-body">
@@ -43,6 +76,23 @@ Release notes for the x402 protocol, SDK, and [CLI](/x402/cli/).
 </div>
 </div>
 
+<div className="changelog-entry">
+<div className="changelog-date">Jul 29, 2026</div>
+<div className="changelog-body">
+
+### Official Facilitator — Base settlement
+
+<div className="changelog-tags"><span className="changelog-tag">Update</span><span className="changelog-tag">Facilitator</span><span className="changelog-tag">Base</span></div>
+
+- The official facilitator now settles **Base USDC**: `eip155:8453` (Mainnet) and `eip155:84532` (Sepolia) are enabled alongside TRON Mainnet/Nile and BSC Mainnet/Testnet.
+- Every enabled network registers `exact`, `upto`, and `batch-settlement`; TRON additionally registers `exact_gasfree` where the service holds GasFree relayer credentials. Query `/supported` for the authoritative list. The bundled example facilitator (`facilitator/basic`) still registers only `eip155:97` and `eip155:56` on the EVM side (its `TRON_NETWORKS` already covers Nile/Shasta/Mainnet), so self-hosting Base sellers must add the Base ids to `EVM_NETWORKS` themselves.
+- **Breaking for self-hosters** — the facilitator config now takes canonical CAIP-2 ids only. Friendly aliases such as `bsc:mainnet` and `tron:nile` are no longer resolved and are rejected at startup. [Network & Token Support](/x402/core-concepts/network-and-token-support/)
+
+👉 [Official Facilitator](/x402/core-concepts/OfficialFacilitator/)
+
+</div>
+</div>
+
 <div className="changelog-entry">
 <div className="changelog-date">Jul 20, 2026</div>
 <div className="changelog-body">

diff --git a/devnotes/x402-stablecoin-payments-for-agents.md b/devnotes/x402-stablecoin-payments-for-agents.md
@@ -81,7 +81,7 @@ Its limits are equally clear: when the real cost is only known after execution,
 
 `exact_gasfree` is a TRON-only fixed-amount scheme. The payer can pay in USDT or USDD without holding TRX in their ordinary wallet; the official GasFree Proxy/relayer path submits the transaction and pays the corresponding on-chain resource cost.
 
-This is not universally "free" payment. The scheme requires the wallet, token, GasFree service, and Facilitator to all support the flow, and the fee may surface through service rules, asset balances, or the quote structure. Production deployments should explicitly check available assets, GasFree account status, fee configuration, and the failure fallback path — you cannot decide whether payment is possible from the main wallet's TRX balance alone.
+This is not universally "free" payment. The scheme requires the wallet, token, GasFree service, and Facilitator to all support the flow, and the cost surfaces as the GasFree **relayer fee**, which the client estimates and which is deducted from the payment token on top of the payment amount — the payment requirement itself carries no fee object. Production deployments should explicitly check available assets, GasFree account status, fee configuration, and the failure fallback path — you cannot decide whether payment is possible from the main wallet's TRX balance alone.
 
 ### 4.3 Upto: paying for actual usage
 

diff --git a/docs/BANK-OF-AI/QuickStart.md b/docs/BANK-OF-AI/QuickStart.md
@@ -19,7 +19,7 @@ Want your AI client to gain BANK OF AI's on-chain capabilities? Just **two steps
 Open whichever AI client you use (OpenClaw / Claude Code / Cursor / Codex / etc.) and paste this command in:
 
 ```
-Run npx skills add BofAI/skills to install every BANK OF AI Skill. After the install completes, run bankofai-guide to walk me through the next steps.
+Run npx skills add BofAI/skills -g to install every BANK OF AI Skill. After the install completes, run bankofai-guide to walk me through the next steps.
 Note: please install into this Agent's own skills directory.
 ```