Awesome-omni-skill w3rt-swap-safe

Execute a safe two-step Solana swap (quote/simulate then explicit confirm/execute) using w3rt runtime.

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/tools/w3rt-swap-safe" ~/.claude/skills/diegosouzapw-awesome-omni-skill-w3rt-swap-safe && rm -rf "$T"
manifest: skills/tools/w3rt-swap-safe/SKILL.md
source content

w3rt-swap-safe

This skill performs a two-step swap to avoid accidental execution and to survive client retries.

Safety rules (must follow)

  1. Always run quote first.
  2. Present a clear summary to the user (from/to/amount/slippage/route).
  3. Only execute after the user explicitly confirms.
  4. Start with small amounts when testing.

Step 1 — Quote (build + simulate later)

cd /home/davirain/clawd/web3AIRuntime
node scripts/w3rt_swap_safe.mjs quote --from SOL --to USDC --amount 0.01 --slippage-bps 50

If Jupiter is flaky and you want to allow fallback to Meteora:

node scripts/w3rt_swap_safe.mjs quote --from SOL --to USDC --amount 0.01 --slippage-bps 50 --allow-fallback

This prints JSON with

quoteId
. Save it.

Step 2 — Execute (requires explicit confirm phrase)

Only after the user confirms, run:

node scripts/w3rt_swap_safe.mjs exec --quote-id <QUOTE_ID> --confirm I_CONFIRM

Output handling

  • On success: show signature + Solscan link.
  • On simulation failure: show the error + first ~30 logs and STOP.
  • Never execute multiple times for the same
    quoteId
    .

Policy

This tool honors

~/.w3rt/config.yaml
policy fields:

policy:
  maxSlippageBps: 100
  maxSwapInputSol: 0.25
  maxSwapInputUsdc: 250
  requireConfirmPhrase: "I_CONFIRM"