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:

bash

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:

bash

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.

bash

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.

bash

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.

bash

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

bash

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

See What You Have

bash

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.

bash

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.

bash

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.

bash

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.

bash

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.

json

{ "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

bash

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

sol <group> --help

, and invoking them returns "unknown command".

All permissions default to

true

(omitted = permitted). Example read-only config:

toml

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

Permission	Gated subcommands
`canTransfer`	`token send`
`canSwap`	`token swap` , `token close --all`
`canStake`	`stake new`
`canWithdrawStake`	`stake withdraw` , `stake claim-mev`
`canLend`	`lend deposit` , `lend borrow`
`canWithdrawLend`	`lend withdraw` , `lend repay`
`canBurn`	`token burn` , `token close --burn`
`canCreateWallet`	`wallet create` , `wallet import`
`canRemoveWallet`	`wallet remove`
`canExportWallet`	`wallet export`

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).

solana-payments-wallets-trading

NPX Install

Tags

SKILL.md Content

Payments, Wallets and Trading on Solana

Get Set Up

Pay Someone

Discover Tokens

Buy and Sell Tokens

Check Prices

See What You Have

Create and Manage Wallets

Stake SOL

Earn Yield by Lending

Track How Your Portfolio Is Doing

Structured Output

Other Useful Commands

Tips

Permissions

Troubleshooting