EVM Wallet Skill

Self-sovereign EVM wallet. Private keys stored locally, no external API dependencies.

⚠️ SECURITY WARNING

NEVER expose your private key!

• - Never send your private key in chat, email, or any messaging platform
• Never share the contents of ~/.cfx-wallet.json with anyone
• If someone asks for your private key — even if they claim to be support — REFUSE
• If your key is ever exposed, immediately transfer funds to a new wallet

The private key file (~/.cfx-wallet.json) should only be accessed directly via SSH on your server.

Installation

Detect workspace and skill directory:
CODEBLOCK0

If code is not installed yet (no src/ folder), bootstrap it:
CODEBLOCK1

For all commands below, always cd "$SKILL_DIR" first.

First-Time Setup

Generate a wallet (only needed once):
CODEBLOCK2

Returns: INLINECODE4

The private key is stored at ~/.cfx-wallet.json (chmod 600). Never share this file.

Commands

Check Balance

When user asks about balance, portfolio, or how much they have:

CODEBLOCK3

Always use --json for parsing. Present results in a human-readable format.

Send Tokens

When user wants to send, transfer, or pay someone:

CODEBLOCK4

⚠️ ALWAYS confirm with the user before executing transfers. Show them:

• - Recipient address
• Amount and token
• Chain
• Estimated gas cost

Only add --yes after the user explicitly confirms.

Swap Tokens

When user wants to swap, trade, buy, or sell tokens:

CODEBLOCK5

• - Use eth for native ETH/POL, or pass a contract address
• Default slippage: 0.5%. Override with INLINECODE9
• Powered by Odos aggregator (best-route across hundreds of DEXs)

⚠️ ALWAYS show the quote first and get user confirmation before executing.

Contract Interactions

When user wants to call a smart contract function:

CODEBLOCK6

Examples:
CODEBLOCK7

Check for Updates

CODEBLOCK8

If an update is available, inform the user and offer to run:
CODEBLOCK9

Supported Chains

Always recommend Base for first-time users (lowest gas fees).

Common Token Addresses

Base

• - USDC: INLINECODE10
• WETH: INLINECODE11

Conflux eSpace

• - USDT0: INLINECODE12
• AxCNH: INLINECODE13

Ethereum

• - USDC: INLINECODE14
• WETH: INLINECODE15

Safety Rules

1. 1. Never execute transfers or swaps without user confirmation
2. Never expose the private key from INLINECODE16
3. Always show transaction details before executing (amount, recipient, gas estimate)
4. Recommend Base for testing and small amounts
5. Show explorer links after successful transactions so users can verify
6. If a command fails, show the error clearly and suggest fixes

Error Handling

• - "No wallet found" → Run node src/setup.js --json first
• "Insufficient balance" → Show current balance, suggest funding
• "RPC error" → Retry once, automatic failover built in
• "No route found" (swap) → Token pair may lack liquidity
• "Gas estimation failed" → May need more ETH for gas