From onchainos-skills
Broadcasts pre-signed/raw transactions, estimates gas, simulates/dry-runs and tracks orders across XLayer, Solana, Ethereum, Base, BSC, Arbitrum, Polygon and 20+ chains. Invoke with `/okx-onchain-gateway`.
How this skill is triggered — by the user, by Claude, or both
Slash command
/onchainos-skills:okx-onchain-gatewayThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
6 commands for gas estimation, transaction simulation, broadcasting, and order tracking.
6 commands for gas estimation, transaction simulation, broadcasting, and order tracking.
Read
../okx-agentic-wallet/_shared/preflight.md. If that file does not exist, read_shared/preflight.mdinstead.
okx-dex-swapokx-dex-marketokx-dex-tokenokx-wallet-portfoliookx-onchain-gateway)Users may use Chinese or informal terms. Map them to the correct commands:
| Chinese / Slang | English | Maps To |
|---|---|---|
| 预估 gas / 估 gas / gas 费多少 | estimate gas, gas cost | gateway gas or gateway gas-limit |
| 广播交易 / 发送交易 / 发链上 | broadcast transaction, send tx on-chain | gateway broadcast |
| 模拟交易 / 干跑 | simulate transaction, dry-run | gateway simulate |
| 交易哈希是否上链 / 是否确认 / 确认状态 / 交易状态 | tx hash confirmed, check tx status | gateway orders |
| 已签名交易 | signed transaction | --signed-tx param for gateway broadcast |
| gas 价格 / 当前 gas | current gas price | gateway gas |
| 支持哪些链 | supported chains for broadcasting | gateway chains |
The CLI accepts human-readable chain names and resolves them automatically.
| Chain | Name | chainIndex |
|---|---|---|
| XLayer | xlayer | 196 |
| Solana | solana | 501 |
| Ethereum | ethereum | 1 |
| Base | base | 8453 |
| BSC | bsc | 56 |
| Arbitrum | arbitrum | 42161 |
| Polygon | polygon | 137 |
This table is illustrative — the gateway supports 20+ chains. Run onchainos gateway chains for the authoritative list.
| # | Command | Description |
|---|---|---|
| 1 | onchainos gateway chains | Get supported chains for gateway |
| 2 | onchainos gateway gas --chain <chain> | Get current gas prices for a chain |
| 3 | onchainos gateway gas-limit --from ... --to ... --chain ... | Estimate gas limit for a transaction |
| 4 | onchainos gateway simulate --from ... --to ... --data ... --chain ... | Simulate a transaction (dry-run) |
| 5 | onchainos gateway broadcast --signed-tx ... --address ... --chain ... | Broadcast a signed transaction |
| 6 | onchainos gateway orders --address ... --chain ... | Track broadcast order status |
| Compared Skill | This Skill (okx-onchain-gateway) | The Other Skill |
|---|---|---|
| okx-dex-swap | Broadcasts signed txs | Generates unsigned tx data |
| okx-agentic-wallet | For raw tx broadcast | For simple token transfers |
Rule of thumb: okx-onchain-gateway handles raw transaction broadcasting and gas estimation; it does NOT generate swap calldata or handle token transfers.
Match the user's request to a command in the Command Index above (use the Keyword Glossary to resolve Chinese / slang phrasing first).
--chain xlayer, low gas, fast confirmation) as the default, then ask which chain the user prefers--signed-tx → remind user to sign the transaction first (this CLI does NOT sign)--from, --to, optionally --data (calldata)--address and --chain, optionally --order-idonchainos gateway gas or gas-limit, display resultsonchainos gateway simulate, check for revert or successonchainos gateway broadcast with the signed tx, return orderId. For an EVM tx the upstream swap skill flagged for MEV protection, add the --mev-protection flag (see MEV Protection below).onchainos gateway orders, display order statusAfter displaying results, suggest 2-3 relevant follow-up actions:
| Just completed | Suggest |
|---|---|
gateway gas | 1. Estimate gas limit for a specific tx → onchainos gateway gas-limit (this skill) 2. Get a swap quote → okx-dex-swap |
gateway gas-limit | 1. Simulate the transaction → onchainos gateway simulate (this skill) 2. Proceed to broadcast → onchainos gateway broadcast (this skill) |
gateway simulate | 1. Broadcast the transaction → onchainos gateway broadcast (this skill) 2. Adjust and re-simulate if failed |
gateway broadcast | 1. Track order status → onchainos gateway orders (this skill) |
gateway orders | 1. View price of received token → okx-dex-market 2. Execute another swap → okx-dex-swap |
Present conversationally, e.g.: "Transaction broadcast! Would you like to track the order status?" — never expose skill names or endpoint paths to the user.
For detailed parameter tables, return field schemas, and usage examples for all 6 commands, consult:
references/cli-reference.md — Full CLI command reference with params, return fields, and examplesTo search for specific command details: grep -n "onchainos gateway <command>" references/cli-reference.md
--signed-tx format matches the chain.onchainos gateway chains first to verify.⚠️ Service is not available in your region. Please switch to a supported region and try again.--signed-tx is broadcast twice, the API may return an error or the same txHash — handle idempotently.This skill is the broadcast layer for EVM MEV protection: the okx-dex-swap skill decides whether protection is needed, and this skill applies it by adding the --mev-protection flag to gateway broadcast. The flag is a boolean — there are no per-chain tip or priority-fee parameters on this command.
| Chain | MEV via broadcast | How to apply |
|---|---|---|
| Ethereum | Yes | add --mev-protection to gateway broadcast |
| BSC | Yes | add --mev-protection to gateway broadcast |
| Base | Yes | add --mev-protection to gateway broadcast |
| Solana | Not via this skill | Solana MEV is handled on the swap path (okx-dex-swap, Jito tips), not at broadcast |
When the swap skill flags an EVM transaction for MEV protection, broadcast it with onchainos gateway broadcast --signed-tx ... --address ... --chain ... --mev-protection. For Solana, MEV protection is not a gateway concern — route it to the swap path.
18.5 Gwei), never raw wei21000, 145000)1.5 ETH), never base unitseip1559Protocol.suggestBaseFee + proposePriorityFee for EIP-1559 chains, normal for legacyethereum → 1, solana → 501)npx claudepluginhub okx/onchainos-skills --plugin onchainos-skillsExecutes on-chain DEX swaps, wallet portfolio queries, gas estimation, and transaction broadcasting on EVM/Solana chains via OKX Web3 API. Use for token swaps, balance checks, or tx broadcast on Ethereum, Solana, Base, BSC, Arbitrum, Polygon, etc.
Builds and signs crypto/DeFi transactions from natural language prompts. Simulates on forked chains before signing. Supports Ethereum, Base, Arbitrum, Optimism, Polygon, Linea and 40+ protocols.
Manages OKX Agentic Wallet operations: authentication, balances, token transfers, contract calls, and Gas Station (Solana stablecoin-gas).