Document OKX Wallet + X Layer x402 path#11
Open
lowjiansheng wants to merge 4 commits into
Open
Conversation
API-Gateway now settles x402 on X Layer via the OKX facilitator (eip155:196 mainnet USDT / eip155:1952 testnet USDG). Surface this in the skills so agents route OKX Wallet users to X Layer and X Layer requests to OKX Wallet — Coinbase's facilitator does not cover X Layer. - SKILL.md: wallet/chain pairing in the auth tree and a new "OKX Wallet → X Layer" alternative setup path (via `npx skills add okx/onchainos-skills`), keeping Coinbase/Base as the default. - openclaw-skill/SKILL.md: add Supported settlement chains table (Base, Solana, X Layer mainnet, X Layer testnet) and a wallet-pairing note. The X402_PRIVATE_KEY flow is unchanged. - claude/messari.skill: repackaged from SKILL.md.
The OKX onchainos wallet skill (npx skills add okx/onchainos-skills) is not installed by default, so an agent could silently fall back to Coinbase/Base when a user actually wants X Layer. Wire the install into the auth decision tree explicitly: - "no wallet + no API key" leaf now branches by intent: X Layer/OKX → install onchainos; otherwise → install Coinbase payments-mcp. - Add an anti-misroute guardrail: install the wallet matching the chain the user wants; don't default to the other chain just because its connector is present. Note that onchainos isn't installed by default and only the user can run the npx install + sign-in. claude/messari.skill repackaged from SKILL.md.
Testnet was only documented for the OKX/X Layer path (Base and Solana are mainnet-only), and the testnet asset was wrong (listed USDG, but the gateway settles testnet in USD₮0). Rather than fix an inconsistency no other chain has, remove the testnet references and keep X Layer mainnet-only (eip155:196, USD₮0). claude/messari.skill repackaged from SKILL.md.
Mirrors the testnet removal already done in SKILL.md — the OpenClaw settlement-chains table still listed an X Layer testnet (eip155:1952, USDG) row. Remove it so no skill artifact references testnet; X Layer is documented mainnet-only (eip155:196, USD₮0), consistent with Base/Solana.
jaksonkallio
approved these changes
Jun 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
eip155:196mainnet, USDG oneip155:1952testnet). The Coinbase facilitator does not support X Layer, so the wallet a user has determines which chain we route them to.SKILL.md: wallet/chain pairing in the auth decision tree + a new "OKX Wallet → X Layer" alternative setup path (installed vianpx skills add okx/onchainos-skills). Coinbase Wallet → Base USDC remains the default.openclaw-skill/SKILL.md: added a "Supported settlement chains" table (Base, Solana, X Layer mainnet/testnet) and a wallet-pairing note. TheX402_PRIVATE_KEYflow itself is unchanged — same Python client signs for whichever EVM chain the facilitator returns.claude/messari.skill: repackaged from the updatedSKILL.md(also resyncs a small pre-existing description drift between the ZIP and the root file).Routing rules now documented
Test plan
npx skills add okx/onchainos-skillsand the X Layer funding step, not the Coinbase flow.claude/messari.skillvia the 1-click installer and verify the packagedSKILL.mdmatches the repo file and renders correctly in-client.