Solana native SOL transfer

When to use

Apply this skill when the user wants to send native SOL (not SPL tokens) from their wallet to another Solana address.

Preconditions

1. Node.js is available on PATH (node).
2. User has set SOLANA_PRIVATE_KEY (see README — never commit or paste keys into chat). Optionally set SOLANA_RPC_URL (defaults to public devnet).
3. Dependencies installed once in this skill folder: npm install (or npm ci).
4. This skill uses TypeScript source compiled to JavaScript via npm run build and does not require Solana CLI (solana) or Python.

Safety

• Do not echo, log, or copy the private key. Use env vars or OpenClaw secrets only.
• Prefer devnet for testing. For mainnet-beta, require explicit user confirmation and a SOLANA_RPC_URL pointing at mainnet (or user clearly opts in).
• Reject transfers to invalid addresses. Confirm recipient and amount with the user for non-trivial sums.

How to run the transfer

From the directory that contains this SKILL.md (skill root), after npm install:

SOLANA_RPC_URL="${SOLANA_RPC_URL:-https://api.devnet.solana.com}" \
SOLANA_PRIVATE_KEY="<set-by-user-or-secrets>" \
npm run transfer -- --to "<RECIPIENT_PUBKEY>" --sol "<AMOUNT_SOL>"

• --to — base58 public key of the recipient.
• --sol — amount in SOL (decimal string or number, e.g. 0.01).
• Optional: --rpc <url> overrides SOLANA_RPC_URL.

On success, report the signature (transaction id) and a Solscan link (explorerUrl in CLI output) using the appropriate cluster (devnet vs mainnet-beta).

On failure, report the error message from the script without exposing secrets.

Execution constraints (important)

• Use only this command path: npm run transfer -- --to ... --sol ....
• Do not switch to scripts/transfer_sol.py, .skill bundles, or any Python flow.
• Do not require solana CLI for this skill; transfers are sent via @solana/web3.js.

Mandatory user-facing workflow

Always show a visible step plan before execution and mark completed steps with a green indicator.

Use this exact checklist style in chat:

• 🟩 Step 1 - Collect input when done, otherwise ⬜ Step 1 - Collect input
• 🟩 Step 2 - Validate input when done, otherwise ⬜ Step 2 - Validate input
• 🟩 Step 3 - User confirmation when done, otherwise ⬜ Step 3 - User confirmation
• 🟩 Step 4 - Execute transfer when done, otherwise ⬜ Step 4 - Execute transfer
• 🟩 Step 5 - Report result when done, otherwise ⬜ Step 5 - Report result

Step 1 - Collect input (ask if missing)

Required input:

• recipient address (to)
• amount in SOL (sol)
• network (devnet or mainnet-beta, default devnet)

If any field is missing, ask follow-up questions. Do not execute until all fields are present.

Step 2 - Validate input

Validate: