From onchainos-skills
Broadcasts transactions, estimates gas, simulates txs, checks status, and tracks orders across Ethereum, Solana, Base, BSC, Arbitrum, Polygon, and 20+ chains via onchainos CLI.
npx claudepluginhub okx/onchainos-skills --plugin onchainos-skillsThis skill uses the workspace's default tool permissions.
6 commands for gas estimation, transaction simulation, broadcasting, and order tracking.
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).
Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.
6 commands for gas estimation, transaction simulation, broadcasting, and order tracking.
Every time before running any onchainos command, always follow these steps in order. Do not echo routine command output to the user; only provide a brief status update when installing, updating, or handling a failure.
Resolve latest stable version: Fetch the latest stable release tag from the GitHub API:
curl -sSL "https://api.github.com/repos/okx/onchainos-skills/releases/latest"
Extract the tag_name field (e.g., v1.0.5) into LATEST_TAG.
If the API call fails and onchainos is already installed locally, skip steps 2-3
and continue with step 4 (the user may be offline or rate-limited; a stale
binary is better than blocking). If onchainos is not installed, stop and
tell the user to check their network connection or install manually from
https://github.com/okx/onchainos-skills.
Install or update: If onchainos is not found, or if the cache at ~/.onchainos/last_check ($env:USERPROFILE\.onchainos\last_check on Windows) is older than 12 hours:
curl -sSL "https://raw.githubusercontent.com/okx/onchainos-skills/${LATEST_TAG}/install.sh" -o /tmp/onchainos-install.sh
curl -sSL "https://github.com/okx/onchainos-skills/releases/download/${LATEST_TAG}/installer-checksums.txt" -o /tmp/installer-checksums.txtInvoke-WebRequest -Uri "https://raw.githubusercontent.com/okx/onchainos-skills/${LATEST_TAG}/install.ps1" -OutFile "$env:TEMP\onchainos-install.ps1"
Invoke-WebRequest -Uri "https://github.com/okx/onchainos-skills/releases/download/${LATEST_TAG}/installer-checksums.txt" -OutFile "$env:TEMP\installer-checksums.txt"installer-checksums.txt. On mismatch, stop and warn — the installer may have been tampered with.sh /tmp/onchainos-install.sh (or & "$env:TEMP\onchainos-install.ps1" on Windows).
The installer handles version comparison internally and only downloads the binary if needed.Verify binary integrity (once per session): Run onchainos --version to get the installed
version (e.g., 1.0.5 or 2.0.0-beta.0). Construct the installed tag as v<version>.
Download checksums.txt for the installed version's tag (not necessarily LATEST_TAG):
curl -sSL "https://github.com/okx/onchainos-skills/releases/download/v<version>/checksums.txt" -o /tmp/onchainos-checksums.txt
Look up the platform target and compare the installed binary's SHA256 against the checksum.
On mismatch, reinstall (step 2) and re-verify. If still mismatched, stop and warn.
arm64->aarch64-apple-darwin, x86_64->x86_64-apple-darwin; Linux: x86_64->x86_64-unknown-linux-gnu, aarch64->aarch64-unknown-linux-gnu, i686->i686-unknown-linux-gnu, armv7l->armv7-unknown-linux-gnueabihf; Windows: AMD64->x86_64-pc-windows-msvc, x86->i686-pc-windows-msvc, ARM64->aarch64-pc-windows-msvcshasum -a 256 ~/.local/bin/onchainos; Windows: (Get-FileHash "$env:USERPROFILE\.local\bin\onchainos.exe" -Algorithm SHA256).Hash.ToLower()Version drift check — REQUIRED, run even if steps 1-3 were skipped.
onchainos --version → CLI version (e.g., 2.2.9)version field from this file's YAML frontmatter (e.g., version: "2.0.0" at the top)Do NOT auto-reinstall on command failures. Report errors and suggest
onchainos --version or manual reinstall from https://github.com/okx/onchainos-skills.
Rate limit errors. If a command hits rate limits, the shared API key may
be throttled. Suggest creating a personal key at the
OKX Developer Portal. If the
user creates a .env file, remind them to add .env to .gitignore.
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 |
# Get current gas price on XLayer
onchainos gateway gas --chain xlayer
# Estimate gas limit for a transaction
onchainos gateway gas-limit --from 0xYourWallet --to 0xRecipient --chain xlayer
# Simulate a transaction (dry-run)
onchainos gateway simulate --from 0xYourWallet --to 0xContract --data 0x... --chain xlayer
# Broadcast a signed transaction
onchainos gateway broadcast --signed-tx 0xf86c...signed --address 0xYourWallet --chain xlayer
# Track order status
onchainos gateway orders --address 0xYourWallet --chain xlayer --order-id 123456789
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 |
| # | 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.
This skill is the final mile — it takes a signed transaction and sends it on-chain. It pairs with swap (to get tx data).
User: "Swap 1 ETH for USDC and broadcast it"
1. okx-dex-swap onchainos swap execute --from ... --to ... --amount ... --chain ethereum --wallet <addr>
User: "Swap 100 USDC for ETH" (EVM, merged approve+swap flow from okx-dex-swap)
When okx-dex-swap determines that approve and swap should be merged (see okx-dex-swap Swap Flow), this skill handles the batch broadcast:
1. okx-dex-swap provides two signed transactions: approve (nonce=N) + swap (nonce=N+1)
2. onchainos gateway broadcast --signed-tx <approve_signed_hex> --address <addr> --chain ethereum
↓ broadcast approve first
3. onchainos gateway broadcast --signed-tx <swap_signed_hex> --address <addr> --chain ethereum
↓ broadcast swap immediately after (do NOT wait for approve confirmation)
4. onchainos gateway orders --address <addr> --chain ethereum → track both txs
Error handling: If approve broadcast fails, do NOT broadcast the swap tx. If approve succeeds but swap broadcast fails, the approval is on-chain and reusable — retry the swap only.
User: "Simulate this transaction first, then broadcast if safe"
1. onchainos gateway simulate --from 0xWallet --to 0xContract --data 0x... --chain ethereum
↓ simulation passes (no revert)
2. onchainos gateway broadcast --signed-tx <signed_hex> --address 0xWallet --chain ethereum
3. onchainos gateway orders --address 0xWallet --chain ethereum --order-id <orderId>
User: "Check gas, swap for USDC, then send it"
1. onchainos gateway gas --chain ethereum → check gas prices
2. okx-dex-swap onchainos swap execute --from ... --to ... --amount ... --chain ethereum --wallet <addr>
onchainos gateway gasonchainos gateway gas-limitonchainos gateway simulateonchainos gateway broadcastonchainos gateway ordersonchainos gateway chains--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 signed tx, return orderId. If MEV protection was requested by the upstream swap skill, include the appropriate MEV parameters (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 where MEV protection is actually applied. The okx-dex-swap skill determines whether MEV protection is needed; this skill executes it.
| Chain | Support | How to Apply |
|---|---|---|
| Ethereum | Yes | Pass enableMevProtection: true to the broadcast API |
| BSC | Yes | Pass enableMevProtection: true to the broadcast API |
| Solana | Yes | Use Jito tips (tips param). Mutually exclusive with computeUnitPrice — do NOT set both. |
| Base | Pending confirmation | Check latest API docs before enabling |
| Others | No | MEV protection not available |
When the swap skill flags a transaction for MEV protection, ensure the broadcast request includes the appropriate parameters. For EVM chains, this means adding enableMevProtection: true to the API call. For Solana, use the tips parameter for Jito bundling.
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)