Okx Security

1---2name: okx-security3description: "Use this skill for security scanning: check transaction safety, is this transaction safe, pre-execution check, security scan, token risk scanning, honeypot detection, DApp/URL phishing detection, message signature safety, malicious transaction detection, approval safety checks, token approval management. Triggers: 'is this token safe', 'check token security', 'honeypot check', 'scan this tx', 'scan this swap tx', 'tx risk check', 'is this URL a scam', 'check if this dapp is safe', 'phishing site check', 'is this signature safe', 'check this signing request', 'check my approvals', 'show risky approvals', 'revoke approval', 'check if this approve is safe', token authorization, ERC20 allowance, Permit2. Covers token-scan, dapp-scan, tx-scan (EVM+Solana pre-execution), sig-scan (EIP-712/personal_sign), approvals (ERC-20/Permit2). Chinese: 安全扫描, 代币安全, 蜜罐检测, 貔貅盘, 钓鱼网站, 交易安全, 签名安全, 代币风险, 授权管理, 授权查询, 风险授权, 代币授权. Do NOT use for wallet balance/send/history — use okx-agentic-wallet."4license: MIT5metadata:6  author: okx7  version: "2.3.0"8  homepage: "https://web3.okx.com"9---10 11# Onchain OS Security12 135 commands for token risk analysis, DApp phishing detection, transaction pre-execution security, signature safety, and approval management.14 15## Pre-flight Checks16 17Every 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.18 191. **Resolve latest stable version**: Fetch the latest stable release tag from the GitHub API:20   ```21   curl -sSL "https://api.github.com/repos/okx/onchainos-skills/releases/latest"22   ```23   Extract the `tag_name` field (e.g., `v1.0.5`) into `LATEST_TAG`.24   If the API call fails and `onchainos` is already installed locally, skip steps 2-325   and continue with step 4 (the user may be offline or rate-limited; a stale26   binary is better than blocking). If `onchainos` is **not** installed, **stop** and27   tell the user to check their network connection or install manually from28   https://github.com/okx/onchainos-skills.29 302. **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:31   - Download the installer and its checksum file from the latest release tag:32     - **macOS/Linux**:33       `curl -sSL "https://raw.githubusercontent.com/okx/onchainos-skills/${LATEST_TAG}/install.sh" -o /tmp/onchainos-install.sh`34       `curl -sSL "https://github.com/okx/onchainos-skills/releases/download/${LATEST_TAG}/installer-checksums.txt" -o /tmp/installer-checksums.txt`35     - **Windows**:36       `Invoke-WebRequest -Uri "https://raw.githubusercontent.com/okx/onchainos-skills/${LATEST_TAG}/install.ps1" -OutFile "$env:TEMP\onchainos-install.ps1"`37       `Invoke-WebRequest -Uri "https://github.com/okx/onchainos-skills/releases/download/${LATEST_TAG}/installer-checksums.txt" -OutFile "$env:TEMP\installer-checksums.txt"`38   - Verify the installer's SHA256 against `installer-checksums.txt`. On mismatch, **stop** and warn — the installer may have been tampered with.39   - Execute: `sh /tmp/onchainos-install.sh` (or `& "$env:TEMP\onchainos-install.ps1"` on Windows).40     The installer handles version comparison internally and only downloads the binary if needed.41   - On other failures, point to https://github.com/okx/onchainos-skills.42 433. **Verify binary integrity** (once per session): Run `onchainos --version` to get the installed44   version (e.g., `1.0.5` or `2.0.0-beta.0`). Construct the installed tag as `v<version>`.45   Download `checksums.txt` for the **installed version's tag** (not necessarily LATEST_TAG):46   `curl -sSL "https://github.com/okx/onchainos-skills/releases/download/v<version>/checksums.txt" -o /tmp/onchainos-checksums.txt`47   Look up the platform target and compare the installed binary's SHA256 against the checksum.48   On mismatch, reinstall (step 2) and re-verify. If still mismatched, **stop** and warn.49   - Platform targets — macOS: `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-msvc`50   - Hash command — macOS/Linux: `shasum -a 256 ~/.local/bin/onchainos`; Windows: `(Get-FileHash "$env:USERPROFILE\.local\bin\onchainos.exe" -Algorithm SHA256).Hash.ToLower()`51 524. **Version drift check** — REQUIRED, run even if steps 1-3 were skipped.53   - Run `onchainos --version` → CLI version (e.g., `2.2.9`)54   - Read `version` field from this file's YAML frontmatter (e.g., `version: "2.0.0"` at the top)55   - If CLI version > skill version → warn: **"⚠️ Skill outdated (skill vX.Y.Z < CLI vA.B.C). Re-install skills to get the latest features and fixes."**56   - Continue to the user's command.575. **Do NOT auto-reinstall on command failures.** Report errors and suggest58   `onchainos --version` or manual reinstall from https://github.com/okx/onchainos-skills.596. **Rate limit errors.** If a command hits rate limits, the shared API key may60   be throttled. Suggest creating a personal key at the61   [OKX Developer Portal](https://web3.okx.com/onchain-os/dev-portal). If the62   user creates a `.env` file, remind them to add `.env` to `.gitignore`.63 64## Fail-safe Principle (CRITICAL)65 66### Scan completed — risk detected67 68If a security scan **completes successfully** and returns `action: "block"` or `action: "warn"`, follow the Risk Action Priority Rule below. The Agent MUST NOT override risk verdicts.69 70### Scan failed — infrastructure error71 72If a security scan **fails to complete** (network error, API timeout, rate limiting, malformed response), the Agent MUST:73- Report the error clearly to the user.74- **Ask the user** whether to retry the scan or proceed without scan results.75- If the user chooses to proceed, display a warning:76  > "⚠️ Security scan could not be completed. Proceeding without verification — please ensure you trust this operation."77- Log the skipped scan for auditability.78 79> A security scan that fails to complete is NOT a "pass". Always inform the user and let them make an explicit decision.80 81## Risk Action Priority Rule82 83### tx-scan / sig-scan (transaction & signature scanning)84 85`block` > `warn` > safe (empty). The top-level `action` field reflects the highest priority from `riskItemDetail`.86 87| `action` value | Risk Level | Agent Behavior |88|---|---|---|89| (empty/null) | Low risk | Safe to proceed |90| `warn` | Medium risk | Show risk details, ask for explicit user confirmation |91| `block` | High risk | Do NOT proceed, show risk details, recommend cancel |92 93- Risk scan result is still valid even if simulation fails (`simulator.revertReason` may contain the revert reason).94- If `warnings` field is populated, the scan completed but some data may be incomplete. Still present available risk information.95- An empty/null `action` in a **successful** API response means "no risk detected". But if the API call **failed**, the absence of `action` does NOT mean safe — apply the fail-safe principle.96 97### token-scan (token risk label scanning)98 99Token-scan returns a **`riskLevel`** field (`CRITICAL`, `HIGH`, `MEDIUM`, `LOW`) that represents the overall token risk, computed server-side from all boolean labels, tax thresholds, and additional signals (off-chain intelligence, ML models). The Agent uses this field directly and applies different actions for **buy** vs. **sell** operations.100 101| `riskLevel` | Buy Action | Sell Action |102|---|---|---|103| **CRITICAL** | `block` — refuse to buy | `warn` — display risk, allow sell |104| **HIGH** | `warn` + **pause** — require explicit yes/no | `warn` — display risk, allow sell |105| **MEDIUM** | `warn` — info notice, continue | `warn` — info notice, continue |106| **LOW** | safe — proceed | safe — proceed |107 108> Full label catalog, tax threshold rules, and display format are defined in `references/risk-token-detection.md`. **Always load that reference before executing `token-scan`.**109 110Key principles:111- **`riskLevel` is authoritative**: The API returns the overall risk level server-side. The Agent reads `riskLevel` directly — no client-side computation from individual labels is needed.112- **Buy is stricter than sell**: `CRITICAL` blocks buy but only warns on sell (to allow stop-loss exit).113- **`HIGH` buy requires explicit user confirmation** (yes/no) — do not auto-continue.114- Individual label levels are **not displayed** to the user — only the overall `riskLevel` is shown, with triggered labels listed without level prefixes.115- If `isChainSupported: false`, skip detection with a warning; do not block.116- If API fails, warn but do not block. In swap context, token-scan failures auto-continue with a warning to avoid blocking time-sensitive trades — this overrides the general fail-safe's ask-user behavior.117 118> Security commands do not require wallet login. They work with any address.119 120## Chain Name Support121 122The CLI accepts human-readable chain names and resolves them automatically.123 124| Chain | Name | chainIndex |125|---|---|---|126| XLayer | `xlayer` | `196` |127| Ethereum | `ethereum` or `eth` | `1` |128| Solana | `solana` or `sol` | `501` |129| BSC | `bsc` or `bnb` | `56` |130| Polygon | `polygon` or `matic` | `137` |131| Arbitrum | `arbitrum` or `arb` | `42161` |132| Base | `base` | `8453` |133| Avalanche | `avalanche` or `avax` | `43114` |134| Optimism | `optimism` or `op` | `10` |135| zkSync Era | `zksync` | `324` |136| Linea | `linea` | `59144` |137| Scroll | `scroll` | `534352` |138 139**Address format note**: EVM addresses (`0x...`) work across Ethereum/BSC/Polygon/Arbitrum/Base etc. Solana addresses (Base58) and Bitcoin addresses (UTXO) have different formats. Do NOT mix formats across chain types.140 141## Command Index142 143| # | Command | Description |144|---|---|---|145| 1 | `onchainos security token-scan` | Token risk / honeypot detection (all chains) |146| 2 | `onchainos security dapp-scan` | DApp / URL phishing detection (chain-agnostic) |147| 3 | `onchainos security tx-scan` | Transaction pre-execution security (EVM + Solana) |148| 4 | `onchainos security sig-scan` | Message signature security (EVM only) |149| 5 | `onchainos security approvals` | Token approval / Permit2 authorization query (EVM only) |150 151## Reference Loading Rules (MANDATORY)152 153Before executing ANY security command, you **MUST** read the corresponding reference document from `skills/okx-security/references/`. Do NOT rely on prior knowledge — always load the reference first.154 155| User intent | Read this file FIRST |156|---|---|157| Token safety, honeypot, is this token safe, 代币安全, 蜜罐检测, 貔貅盘 | `references/risk-token-detection.md` |158| DApp/URL phishing, is this site safe, 钓鱼网站 | `references/risk-domain-detection.md` |159| Transaction safety, tx pre-execution, signature safety, approve safety, 交易安全, 签名安全 | `references/risk-transaction-detection.md` |160| Approvals, allowance, Permit2, revoke, 授权管理, 授权查询, 风险授权 | `references/risk-approval-monitoring.md` |161 162> When a workflow involves multiple commands (e.g., token-scan then tx-scan), load each reference before executing that command.163 164## Integration with Other Skills165 166Security scanning is often a prerequisite for other wallet operations:167- Before `wallet send` with a contract token: run `token-scan` to verify token safety168- Before `wallet contract-call` with approve calldata: run `tx-scan` to check spender169- Before interacting with any DApp URL: run `dapp-scan`170- Before signing any EIP-712 message: run `sig-scan`171 172Use `okx-agentic-wallet` skill for the subsequent send/contract-call operations.