xlayer-execution-guard
Run an executable X Layer pre-execution guard for autonomous agents: OnchainOS DEX route judgment, honeypot and price-impact checks, proof-mode evidence, and optional Agentic Wallet execution via onchainos. Use when OpenClaw/Codex needs to test, block, resize, or execute an X Layer swap intent with judge-ready proof.
- License 许可
- MIT
- 最近更新
- 2026-06-10
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- xlayer-execution-guard
- description
- Run an executable X Layer pre-execution guard for autonomous agents: OnchainOS DEX route judgment, honeypot and price-impact checks, proof-mode evidence, and optional Agentic Wallet execution via onchainos. Use when OpenClaw/Codex needs to test, block, resize, or execute an X Layer swap intent with judge-ready proof.
03 SKILL.md 正文
X Layer Execution Guard
Use this skill to turn an agent swap intent into a guarded execution decision and proof artifact.
The installed skill includes its own Python runtime in runtime/ and two scripts in scripts/:
scripts/run_execution_guard.pyruns the guard CLI.scripts/check_agentic_wallet.pychecks whetheronchainosand Agentic Wallet are reachable.
Operating Rules
- Default to
--no-executeor--execution-mode proofwhile evaluating a request. - Only use
--liveor--execution-mode agentic-walletafter explicit user approval for a real wallet action. - Treat
proofmode as simulated execution evidence. Onlyagentic-walletmode can return a real transaction hash. - If OnchainOS API credentials are missing, the runtime returns a mock install-smoke result. Do not present mock output as live proof.
- For live X Layer runs, use chain
196unless the user explicitly chooses another chain.
OpenClaw Quick Start
Set the skill directory first. In OpenClaw it is usually:
SKILL_DIR="$HOME/.openclaw/skills/xlayer-execution-guard"
If installed into a local workdir with ClawHub, use:
SKILL_DIR="$PWD/skills/xlayer-execution-guard"
Install the only runtime dependency if needed:
python3 -m pip install --user -r "$SKILL_DIR/requirements.txt"
Check the Agentic Wallet environment:
python3 "$SKILL_DIR/scripts/check_agentic_wallet.py"
Run a safe pre-execution judgment:
PYTHONPATH="$SKILL_DIR/runtime" python3 "$SKILL_DIR/scripts/run_execution_guard.py" \
--agent strategy-office \
--intent-id strategy-office-round-001 \
--from USDC \
--to USDT \
--amount 10 \
--amount-mode readable \
--slippage 0.5 \
--max-impact 1.20 \
--no-execute \
--output guard-proof.json
Run proof-mode closed-loop evidence without touching the wallet:
PYTHONPATH="$SKILL_DIR/runtime" python3 "$SKILL_DIR/scripts/run_execution_guard.py" \
--agent strategy-office \
--intent-id strategy-office-proof-001 \
--from USDC \
--to USDT \
--amount 10 \
--amount-mode readable \
--execution-mode proof \
--output guard-proof.json
Run a live Agentic Wallet execution only after user approval:
PYTHONPATH="$SKILL_DIR/runtime" python3 "$SKILL_DIR/scripts/run_execution_guard.py" \
--agent strategy-office \
--intent-id strategy-office-live-001 \
--from USDC \
--to USDT \
--amount 10 \
--amount-mode readable \
--slippage 0.5 \
--execution-mode agentic-wallet \
--wallet default \
--chain 196 \
--output guard-live-proof.json
--live is an alias for --execution-mode agentic-wallet.
Required Environment
For real OnchainOS route judgment, export API credentials in the OpenClaw environment or ~/.config/onchainos.env:
export ONCHAINOS_API_KEY="..."
export ONCHAINOS_API_SECRET="..."
export ONCHAINOS_API_PASSPHRASE="..."
export ONCHAINOS_CHAIN_INDEX="196"
For live wallet execution, onchainos must be installed and logged in:
onchainos wallet login
onchainos wallet status
What The Guard Checks
The runtime uses OnchainOS DEX Aggregator APIs for:
- token discovery through
/api/v6/dex/aggregator/all-tokens - liquidity source discovery through
/api/v6/dex/aggregator/get-liquidity - aggregated and per-DEX quote comparison through
/api/v6/dex/aggregator/quote
The output includes:
pre_execution.verdict:execute,resize,retry, orblockpre_execution.checks: quote availability, price impact, fallback coverage, token tax, honeypot flags, gas and fee fieldsexecution.status:simulated_success,success,broadcasted,failed, ornot_executedpost_execution.proof_idandmoltbook_summaryclosed_loop_validation: whether the pre-execution verdict matched the post-execution outcome
Failure Handling
- Missing API credentials: output is mock mode and suitable only for install verification.
wallet_ready=false: runonchainos wallet loginin the same OpenClaw environment.verdict=block: do not execute; show the block reason.verdict=resize: execute only if the user accepts the resized risk outcome.- Live execution returns no tx hash: preserve the full JSON output and inspect
execution.error.
04 同仓库更多 Skills
youtube-content
YouTube transcripts to summaries, threads, blogs.
xurl
X/Twitter via xurl CLI: post, search, DM, media, v2 API.
touchdesigner-mcp
Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.
teams-meeting-pipeline
Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.
systematic-debugging
4-phase root cause debugging: understand bugs before fixing.