Solana のペイメント、ウォレット、トレーディング

Sol はコマンドラインツールで、Solana とやり取りする際に口頭で説明するのと同じ方法で作業できます。トランザクションを構築したりプログラム命令を管理する代わりに、やりたいことを説明します。誰かに支払う、トークンを買う、SOL をステーキングするなど。

キーはディスクのローカルに保存されます。環境変数に秘密鍵を置かず、設定する API キーもありません。

セットアップする

npx と @latest を使用することをお勧めします。これは常に最新バージョンを実行し、グローバルインストール管理は不要です:

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

ユーザーがグローバルインストール済み (npm install -g @solana-compass/cli) の場合、より短い sol コマンドを使用できます:

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

公開 RPC エンドポイントはレート制限が厳しいです。テスト以上のことをするなら、専用 RPC を使用してください。Helius、Triton、QuickNode はすべて無料ティアを提供しています。

Node.js >= 20 が必要です。

誰かに支払う

SOL、USDC、または任意の Solana トークンをウォレットアドレスに送信します。

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

完全な送信リファレンスは references/trading-commands.md を参照してください。

トークンを発見する

Solana トークンエコシステムを閲覧します。トレンド、最高取引量、最近ローンチされたものなど。

sol token browse trending                    # 今ホットなもの
sol token browse top-traded --interval 24h   # 24 時間で最高ボリューム
sol token browse recent --limit 10           # 最近ローンチ
sol token browse lst                         # リキッドステーキングトークン

結果はローカルトークンキャッシュに入力されるため、その後の token info と token price コールは即座に解決されます。

すべてのカテゴリとフラグについては references/trading-commands.md を参照してください。

トークンを買う・売る

任意のトークルを別のトークンにスワップします。Jupiter と DFlow を並列でクエリし、最高の価格を自動的に選択します。

sol token swap 50 usdc bonk               # BONK を購入 — 最高価格が勝つ
sol token swap 1.5 sol usdc               # SOL を USDC に売却
sol token swap 50 usdc bonk --quote-only  # 実行せずプレビュー
sol token swap 50 usdc bonk --router jupiter  # 特定のルーターを強制

すべてのスワップは実行時の価格を記録するため、後で原価と P&L を追跡できます。

スリップページやウォレット選択などについては references/trading-commands.md を参照してください。

DCA (ドルコスト平均法)

時間をかけて自動的に実行される定期的な購入をセットアップします。

sol token dca new 500 usdc sol --every day --count 10   # 毎日 SOL を購入
sol token dca new 1000 usdc bonk --every hour --count 20
sol token dca list                           # アクティブな DCA オーダーを確認
sol token dca cancel <orderKey>              # DCA をキャンセル

制約: 総最小 $100、少なくとも 2 つのオーダー、オーダー当たり $50 最小。 間隔: minute、hour、day、week、month。

リミットオーダー

トークンがターゲット価格に達すると実行されるオーダーを配置します。

sol token limit new 50 usdc bonk --at 0.000003   # $0.000003 で BONK を購入
sol token limit new 0.5 sol usdc --at 0.90        # $0.90 で USDC を購入
sol token limit list                              # アクティブなオーダーを確認
sol token limit cancel <orderKey>                 # オーダーをキャンセル

--quote-only を使用してオーダーを配置せずにオーダープランをプレビューします。

価格を確認する

sol token price sol
sol token price sol usdc bonk eth       # 一度に複数

自分が持っているものを確認する

sol wallet balance                      # USD 値を持つすべてのトークン
sol wallet balance trading              # 名前で特定のウォレット
sol token list                          # トークン残高のみ
sol wallet list                         # すべてのウォレット

ウォレットを作成・管理する

ウォレットは ~/.sol/wallets/ のローカルキーファイルです。環境変数にシードフレーズはありません。

sol wallet create                       # 新しいウォレット、自動命名
sol wallet create --name trading        # 名前を選択
sol wallet import --solana-cli          # Solana CLI からインポート
sol wallet set-default trading          # アクティブウォレットを切り替え

任意のコマンドで --wallet <name> を使用して特定のウォレットをターゲットにできます。

インポート、エクスポート、ラベル、履歴については references/wallet-commands.md を参照してください。

SOL をステーキングする

バリデーターに SOL をデリゲートしてステーキング報酬を獲得します。1 つのコマンドでプロセス全体を処理します。ステークアカウントの作成、資金化、デリゲートを行います。

sol stake new 10                        # 10 SOL をステーキング
sol stake list                          # ステークアカウント + 請求可能な tip
sol stake claim-mev                     # MEV 報酬を複利運用
sol stake withdraw 7gK...abc            # アンステーク

バリデーター選択、部分的な引き出し、強制アンステークについては references/staking-commands.md を参照してください。

レンディングで利回りを獲得する

Kamino、MarginFi、Drift、Jupiter Lend、Loopscale の 5 つのプロトコルにまたがるレート比較と貸出。CLI は自動的に最高レートを選択するか、--protocol で特定のプロトコルをターゲットにできます。

sol lend rates usdc                     # すべてのプロトコルで APY を比較
sol lend deposit 100 usdc               # 最高預金レートを自動選択
sol lend deposit 5 sol --protocol kamino
sol lend borrow 500 usdc --collateral sol
sol lend positions                      # すべてのプロトコルにまたがるすべてのポジション

詳細については references/lending-commands.md を参照してください。

ボルトで利回りを獲得する

Kamino Earn と Loopscale にまたがるマネージド利回りボルト。生のレンディングと異なり、ボルトは戦略管理を自動的に処理します。トークンを預金すればプロトコルが利回りを最適化します。CLI は最高 APY ボルトを自動選択するか、特定のプロトコルまたはボルトをターゲットにできます。

sol earn usdc                              # USDC ボルトと APY をリスト
sol earn sol                               # SOL ボルトをリスト
sol earn                                   # すべてのボルト、APY でソート
sol earn deposit 100 usdc                  # 最高 APY ボルトを自動選択
sol earn deposit 5 sol --protocol kamino   # 特定のプロトコルをターゲット
sol earn positions                         # ボルトポジション
sol earn withdraw max usdc                 # 完全引き出し
sol earn withdraw 50 usdc --protocol loopscale

Earn ポジションはトークン、ステーキング、レンディング、LP と共に sol portfolio に表示されます。

リキュディティを提供する

Orca、Raydium、Meteora、Kamino にまたがるプールにリクイディティを追加します。TVL/APY/ボリュームでプールを閲覧し、柔軟な価格範囲で預金し、P&L と無常損失を使用してポジションを追跡し、追加報酬を農場します。

sol lp pools sol usdc                          # SOL/USDC プールを閲覧
sol lp pools --sort apy --type clmm            # 最高 APY 集中プール
sol lp deposit HJPj...abc 100 usdc --range 10  # +/-10% 価格範囲で預金
sol lp positions                               # P&L を含むすべてのポジション
sol lp claim 9xK...abc                         # 未請求手数料を請求
sol lp withdraw 9xK...abc                      # リクイディティを削除

ファーミング、プール作成、プロトコル固有のフラグを含む詳細については references/lp-commands.md を参照してください。

予測市場で取引する

Jupiter 経由で Polymarket と Kalshi から予測市場を閲覧・取引します。カテゴリには暗号資産、スポーツ、政治、文化などが含まれます。

sol predict list crypto                     # 暗号資産イベントを閲覧
sol predict search "solana"                 # キーワードで検索
sol predict event POLY-89525                # マーケット付きイベント詳細
sol predict market POLY-701571              # 価格 + オーダーブック

sol predict buy 5 yes POLY-701571           # YES コントラクトを購入
sol predict positions                       # 未実現 P&L 付きオープンポジション
sol predict sell <positionPubkey>            # ポジションをクローズ
sol predict claim <positionPubkey>           # 解決した利益を請求
sol predict history                         # トランザクション履歴

ポジションは未実現 P&L を含む sol portfolio に表示されます。

完全なリファレンスについては references/prediction-commands.md を参照してください。

x402 で API の料金を支払う

x402 プロトコル経由での支払いが必要な URL をフェッチします。curl のように機能します。stdout はレスポンスボディ、支払い情報は stderr に出力されます。

sol fetch https://api.example.com/data             # 自動的に 402 レスポンスに支払う
sol fetch https://api.example.com/data --dry-run   # 支払わずに価格を表示
sol fetch https://api.example.com/data --max 0.05  # USDC での支出上限

sol fetch https://api.example.com/rpc \
  -X POST -d '{"query":"..."}' \
  -H "Accept: application/json"                    # ヘッダー付き POST

サーバーが 402 Payment Required を返す場合、CLI は USDC 転送に署名し、支払いを附属させて再試行します。サーバーはトランザクションを提出します。ウォレットは部分的にのみ署名します。

支払い前に費用を検査するには --dry-run を使用します。支出上限を設定するには --max を使用します。出力はデフォルトではパイプフレンドリーです (本体は stdout、支払い情報は stderr)。

curl フラグマッピングと JSON 出力形式を含む完全なリファレンスについては references/fetch-commands.md を参照してください。

ポートフォリオの進行状況を追跡する

すべてを 1 か所で確認します。トークン、ステーク SOL、レンディングポジション、オープンオーダー。

sol portfolio                           # 全体像
sol portfolio compare                   # 最後のスナップショット以来の変更
sol portfolio pnl                       # 時間経過による損益

ポートフォリオビューはアクティブな DCA およびリミットオーダーを埋埋進捗で表示するため、ロック資本は常に表示されます。スナップショットは各ビューで自動的に取得されます (5 分ごとにレート制限)。そのため sol portfolio compare は常に最新データを持ちます。

スナップショット管理については references/portfolio-commands.md を参照してください。

構造化出力

すべてのコマンドは構造化出力用に --json をサポートしていますが、デフォルトの人間が読める出力は読みやすく解釈しやすいように設計されています。人間と LLM エージェント両方にとって。オートメーションパイプラインでスクリプト作成またはコマンドをチェーンしている場合を除き、人間が読める出力を使用します。

人間の出力はフォーマットされたテーブル、次のアクションのサインポスト、完全な ID とアドレスを表示して、後続のコマンドにコピーペーストできるようにします。各コマンドリファレンスで出力の例を参照してください。

プログラムでの使用の場合、--json は CommandResult<T> エンベロープを返します: { "ok": true, "data": { ... }, "meta": { "elapsed_ms": 450 } }. 完全なスキーマについては references/json-output-format.md を参照してください。

その他の便利なコマンド

sol network                             # エポック、TPS、ステーキング APY
sol tx 4xK9...abc                       # 任意のトランザクションを検索
sol config set rpc.url <url>            # RPC エンドポイントを変更

ヒント

• ガス用に SOL を保持する。 Solana のすべてのトランザクションは約 ~0.000005 SOL かかりますが、トークンアカウント作成には約 ~0.002 SOL かかります。ユーザーが具体的にウォレットをドレーンまたはクローズするよう求めない限り、将来のトランザクションが失敗しないよう、少なくとも 0.05 SOL を予備として保持してください。
• 短縮形ではなく完全な数字を使用します。 CLI は文字通りの量を期待します: 1m ではなく 1000000、50k ではなく 50000。常にコマンドに渡す前に短縮形を展開してください。
• アドレスは raw public キーのみです。 CLI は .sol ドメイン、SNS 名、連絡先ラベルを解決しません。受け取り人の完全な base58 public キーを渡してください。
• 曖昧なシンボルは最高流動性マッチを選択します。 シンボルが複数のトークンにマップされている場合、CLI は Jupiter で最もトレーディングボリュームを持つものを選択します。プロンプトは表示されません。sol token info <symbol> を使用して何に解決されるか確認するか、ミントアドレスを渡して明示的にしてください。
• スワップで --quote-only を使用してコミットする前にプレビュー
• 特定のウォレットをターゲットにするには --wallet <name> を使用
• トランザクションログは実行時の USD 価格を持つすべての操作を追跡します。原価と P&L に有用です

権限

CLI は ~/.sol/config.toml 経由で細粒度の権限をサポートします。権限が false に設定されている場合、ゲートされたコマンドは登録されません。--help または sol <group> --help に表示されず、呼び出すと "unknown command" が返されます。

すべての権限はデフォルトで true になります (省略 = 許可)。読み取り専用設定の例:

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

権限	ゲートされたサブコマンド
canTransfer	token send
canSwap	token swap, token close --all, token dca new/cancel, token limit new/cancel
canStake	stake new
canWithdrawStake	stake withdraw, stake claim-mev
canLend	lend deposit, earn deposit, lp deposit, lp farm stake, lp create
canWithdrawLend	lend withdraw, earn withdraw, lp withdraw, lp claim, lp farm unstake/harvest
canBorrow	lend borrow, lend repay
canBurn	token burn, token close --burn
canCreateWallet	wallet create, wallet import
canRemoveWallet	wallet remove
canExportWallet	wallet export
canFetch	fetch (x402 支払い)

読み取り専用コマンド (token browse/price/info/list, wallet list/balance, stake list, lend rates/positions, earn list/positions, lp pools/info/positions/configs/farm list, portfolio, network, tx) は権限に関わらず常に利用可能です。

セキュリティコントロール

CLI はエージェント駆動ワークフロー用に 3 つの保護層を提供します: 権限 (許可される操作)、トランザクション制限 (使用可能な金額)、アロウリスト (許可されるアドレスとトークン)。

セキュリティセットアップ

エージェントはセキュリティ設定の構成を支援でき、その後ユーザーは確認してロックします:

# 1. 権限を設定
sol config set permissions.canSwap true
sol config set permissions.canTransfer false

# 2. トランザクション制限を設定
sol config set limits.maxTransactionUsd 500
sol config set limits.maxDailyUsd 2000

# 3. アロウリストを設定
sol config set allowlist.tokens So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
sol config set allowlist.addresses DRtXHDgC312wpNdNCSb8vCoXDcofCJcPHdAynKGz7Vr,7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU

# 4. レビュー — ロックする前にすべてが正しく見えることを確認
sol config status

# 5. ロック — CLI 経由のすべての変更を防止
sol config lock

ロック後、セキュリティ設定は ~/.sol/config.toml を直接編集することでのみ人間が変更できます。

トランザクション制限

設定	説明
limits.maxTransactionUsd	トランザクション当たりの最大 USD 値。欠落 = 制限なし。
limits.maxDailyUsd	ローリング 24 時間ウィンドウで使用される最大 USD の合計。欠落 = 制限なし。

制限は以下に適用されます: token swap, token send, stake new, lend deposit, lend borrow, DCA 作成、およびリミットオーダー作成。自身のウォレットへの引き出し、MEV 請求、または読み取り操作には適用されません。

アドレスアロウリスト

allowlist.addresses — ウォレットアドレスのカンマ区切りリスト。設定されている場合、アウトバウンド転送 (token send) はリストされたアドレスとローカルウォレットデータベース内のすべてのウォレット (自身のウォレットは常に許可) に制限されます。空白または欠落 = 制限なし。

トークンアロウリスト

allowlist.tokens — トークンシンボルまたはミントアドレスのカンマ区切りリスト。設定されている場合、スワップ、DCA 作成、およびリミットオーダーの場合、入出力トークンの両方がリスト内にある必要があります。空白または欠落 = すべてのトークンが許可。

セキュリティステータスを確認する

sol config status              # 人間が読める可能なセキュリティ概要
sol config status --json       # エージェント用の構造化出力

完全なセキュリティ体制を表示します: すべての権限と有効化されているかどうか、トランザクション制限と現在の 24 時間使用量、アドレスとトークンアロウリスト、設定がロックされているかどうか、および潜在的なリスクに関する警告 (例えば、制限が設定されていない、公開 RPC が使用中)。エージェントは sol config status を使用して、config.toml を直接読むのではなく、何ができるかを理解する必要があります。

重要: ファイルシステムアクセス

エージェントに ~/.sol/ への読み取りまたは書き込みアクセスを許可しないでください。 このディレクトリには秘密鍵とセキュリティ構成が含まれています。エージェントは sol CLI コマンド経由でのみ Solana と相互作用し、設定またはキーファイルを直接読むことでは決して相互作用しないはずです。セキュリティセットアップ支援後、ユーザーは sol config lock でセキュリティをロックし、~/.sol/ へのファイルシステムアクセスを制限することをお勧めします。

セキュリティモデル

秘密鍵は ~/.sol/wallets/ のファイルとして保存されます。CLI はトランザクション署名時にそれらを読み取ります。環境変数または stdout に公開されることはありません。このツールを使用する LLM エージェントは、それらのファイルを明示的に開かない限り、生のキー素材を読み取ることができません。これには標準の権限モードでのユーザー承認が必要です。

権限、制限、アロウリストはいっしょに CLI ができることを制御します。エージェントは権限が有効化されており、制限とアロウリストチェックに合格し、and 各 CLI 呼び出しに対するユーザー承認を取得する必要があります。

これが保護しないもの: これらのコントロールは CLI とエージェント権限レベルで機能します。同じマシン上の別のソフトウェアがキーファイルを読むのを防ぎません。同じ OS ユーザーアカウントで実行される任意のツール、MCP サーバー、プラグイン、またはスクリプトは、直接 ~/.sol/wallets/ を読み取ることができます。エージェントに追加ツールへのアクセスを許可する場合、特に任意のファイルを読み取ったりシェルコマンドを実行できるツール、それらのツールは Sol CLI 権限に関わらず秘密鍵を抽出できます。

ウォレット残高をリスクに合わせて保持します。エージェント駆動ワークフロー用に資金が限定された専用ウォレットを使用し、自動化ツーリングにアクセスできるキーファイルに大量の保有物を保存しないでください。

トラブルシューティング

一般的な問題 (RPC レート制限、トークン解決、トランザクションタイムアウト) については references/troubleshooting.md を参照してください。