Payments, Wallets and Trading on Solana

Sol is a command-line tool that lets you work with Solana the way you’d describe it out loud. Instead of constructing transactions and managing program instructions, you say what you want: pay someone, buy a token, stake your SOL.

Keys live locally on disk — no private keys in environment variables, no API keys to configure.

Get Set Up

Prefer npx — it always runs the latest version with no global install to manage:

npx @solana-compass/cli config set rpc.url https://your-rpc-endpoint.com
npx @solana-compass/cli wallet create --name my-wallet

If the user has installed globally (npm install -g @solana-compass/cli), you can use the shorter sol command instead:

sol config set rpc.url https://your-rpc-endpoint.com
sol wallet create --name my-wallet

The public RPC endpoint rate-limits aggressively. Use a dedicated RPC for anything beyond testing — Helius, Triton, and QuickNode all offer free tiers.

Requires Node.js >= 20.

Pay Someone

Send SOL, USDC, or any Solana token to a wallet address.

sol token send 50 usdc GkX...abc
sol token send 2 sol 7nY...xyz
sol token send 1000 bonk AgE...def --yes

Use --yes to skip the confirmation prompt — useful for automated payments between agents or apps. Confirmations are also skipped automatically in --json mode.

See references/trading-commands.md for the full send reference.

Discover Tokens

Browse the Solana token ecosystem — trending, most traded, recently launched, and more.

sol token browse trending                    # what's hot right now
sol token browse top-traded --interval 24h   # highest volume over 24h
sol token browse recent --limit 10           # just launched
sol token browse lst                         # liquid staking tokens

Results populate the local token cache, so subsequent token info and token price calls resolve instantly.

See references/trading-commands.md for all categories and flags.

Buy and Sell Tokens

Swap any token for any other token. Prices come from Jupiter — best rate across every Solana DEX, no API key needed.

sol token swap 50 usdc bonk             # buy BONK with USDC
sol token swap 1.5 sol usdc             # sell SOL for USDC
sol token swap 50 usdc bonk --quote-only  # preview without executing

Every swap records the price at execution time, so you can track cost basis and P&L later.

See references/trading-commands.md for slippage, wallet selection, etc.

Check Prices

sol token price sol
sol token price sol usdc bonk eth       # multiple at once

See What You Have

sol wallet balance                      # all tokens with USD values
sol wallet balance trading              # specific wallet by name
sol token list                          # just token balances
sol wallet list                         # all your wallets

Create and Manage Wallets

Wallets are local key files in ~/.sol/wallets/ — no seed phrases in environment variables.

sol wallet create                       # new wallet, auto-named
sol wallet create --name trading        # pick a name
sol wallet import --solana-cli          # import from Solana CLI
sol wallet set-default trading          # switch active wallet

Any command can target a specific wallet with --wallet <name>.

See references/wallet-commands.md for import, export, labels, history.

Stake SOL

Delegate SOL to a validator and earn staking rewards. One command handles the entire process — creating the stake account, funding it, and delegating.

sol stake new 10                        # stake 10 SOL
sol stake list                          # your stake accounts + claimable tips
sol stake claim-mev                     # compound MEV rewards
sol stake withdraw 7gK...abc            # unstake

See references/staking-commands.md for validator selection, partial withdrawals, and force unstake.

Earn Yield by Lending

Deposit tokens into Kamino Finance to earn interest, or borrow against your deposits.

sol lend rates usdc                     # current APY
sol lend deposit 100 usdc               # start earning
sol lend borrow 500 usdc --collateral sol
sol lend positions                      # everything you've got open

See references/lending-commands.md for full details.

Track How Your Portfolio Is Doing

See everything in one place — tokens, staked SOL, lending positions.

sol portfolio                           # the full picture
sol portfolio snapshot --label "monday"
sol portfolio compare                   # what changed since last snapshot
sol portfolio pnl                       # profit and loss over time

See references/portfolio-commands.md for snapshot management.

Structured Output

Every command supports --json for structured output. In JSON mode, confirmations are skipped automatically.

{ "ok": true, "data": { ... }, "meta": { "elapsed_ms": 450 } }

Error codes are UPPER_SNAKE_CASE (e.g. SWAP_FAILED). Check the ok field before reading data.

See references/json-output-format.md for the full schema.

Other Useful Commands

sol network                             # epoch, TPS, staking APY
sol tx 4xK9...abc                       # look up any transaction
sol config set rpc.url <url>            # change RPC endpoint

Tips

• Keep SOL for gas. Every Solana transaction costs ~0.000005 SOL, but token account creation costs ~0.002 SOL. Unless the user specifically asks to drain or close a wallet, keep at least 0.05 SOL as a reserve so future transactions don’t fail.
• Use full numbers, not shorthand. The CLI expects literal amounts: 1000000 not 1m, 50000 not 50k. Always expand shorthand before passing to a command.
• Addresses are raw public keys only. The CLI does not resolve .sol domains, SNS names, or contact labels — pass the full base58 public key for recipients.
• Ambiguous symbols pick the highest-liquidity match. If a symbol maps to multiple tokens, the CLI picks the one with the most trading volume on Jupiter. It does not prompt. Use sol token info <symbol> to verify what it resolves to, or pass a mint address to be explicit.
• Use --quote-only on swaps to preview before committing
• Use --wallet <name> to target a specific wallet
• The transaction log tracks all operations with USD prices at execution time — useful for cost basis and P&L

Permissions

The CLI supports fine-grained permissions via ~/.sol/config.toml. When a permission is set to false, the gated commands are not registered — they won’t appear in --help or sol <group> --help, and invoking them returns “unknown command”.

All permissions default to true (omitted = permitted). Example read-only config:

[permissions]
canTransfer = false
canSwap = false
canStake = false
canWithdrawStake = false
canLend = false
canWithdrawLend = false
canBurn = false
canCreateWallet = false
canRemoveWallet = false
canExportWallet = false

Read-only commands (token browse/price/info/list, wallet list/balance, stake list, lend rates/positions, portfolio, network, tx) are always available regardless of permissions.

Permissions cannot be changed via sol config set — they must be edited in config.toml directly.

Troubleshooting

See references/troubleshooting.md for common issues (RPC rate limits, token resolution, transaction timeouts).