stellar-dev

Stellar 開発スキル（Soroban 優先）

このスキルの用途

ユーザーから次の依頼を受けた場合に、このスキルを使用します。

• Soroban スマートコントラクトの開発（Rust）
• Stellar dApp のフロントエンド作業（React / Next.js / Node.js）
• ウォレット接続と署名のフロー（Freighter など）
• トランザクションの構築／送信／確認
• Stellar アセットの発行と管理
• クライアント SDK の使用（JavaScript、Python、Go、Rust）
• ゼロ知識証明の検証（対象のネットワーク／プロトコルが対応している場合）
• プライバシー保護アプリケーション（プライバシープール、機密トークン）
• ローカルテストとデプロイ
• セキュリティ強化と監査形式のレビュー
• エージェントによる決済：有料 API（x402）と AI エージェント向け決済クライアント（x402、MPP charge、MPP channel）

このスキルの対象外

• Bitcoin、Ethereum、Solana、その他 Stellar 以外のブロックチェーン開発
• Stellar ノード／バリデーターの運用（バリデーターのドキュメントを参照）
• Soroban に関係しない一般的な Rust プログラミング
• Stellar プロトコルのガバナンスや CAP の作成

デフォルトの技術スタックの選択（独自の推奨事項）

1. スマートコントラクト：Soroban（Rust）

• すべてのスマートコントラクト開発で Soroban SDK（soroban-sdk クレート）を使用します
• コントラクトは WebAssembly（WASM）にコンパイルされます
• 標準ライブラリは利用できないため、#![no_std] を使用します
• コントラクトサイズの上限は 64KB です。リリース最適化を使用します
• 可能な場合は、カスタムトークンコントラクトより Stellar Assets を優先します

2. クライアント SDK：まず stellar-sdk（JavaScript）

• ブラウザーおよび Node.js アプリケーションでは @stellar/stellar-sdk を使用します
• Stellar RPC と従来の Horizon API の両方に対応しています
• トランザクションの構築、署名、送信をすべて行えます
• Soroban コントラクトのデプロイと呼び出しに対応しています

3. API アクセス：まず Stellar RPC（Horizon は従来用途が中心）

• 新規プロジェクトでは Stellar RPC を優先します（JSON-RPC、リアルタイムの状態）
• Horizon API は、従来との互換性や過去データのクエリを伴うワークフローで引き続き利用できます
• RPC：ほとんどのメソッドで過去 7 日間の履歴に対応します。getLedgers ではジェネシスまで遡ってクエリできます（無限スクロール）
• RPC の対象外となる包括的な過去データには Hubble/Galexie を使用します

4. トークン戦略：まず Stellar Assets

• 代替可能トークンには Stellar Assets（従来型の発行＋トラストライン）を優先します
• エコシステム（ウォレット、取引所、アンカー）に標準対応しています
• Stellar Asset Contracts（SAC）により Soroban との相互運用が可能です
• 複雑なロジックが必要な場合に限り、カスタム Soroban トークンを使用します

5. テスト

• ローカル：ローカルネットワークには Stellar Quickstart Docker を使用します
• Testnet：資金の供給には Friendbot とともに Testnet を使用します
• ユニットテスト：迅速に反復できるよう、ネイティブ向けにコンパイルします
• 統合テスト：ローカル環境／testnet にデプロイします

6. ウォレット連携

• ブラウザーウォレットには Freighter を主要なウォレットとして使用します
• 複数のウォレットに対応するには Stellar Wallets Kit を使用します
• 一貫性のある接続パターンには Wallet Standard を使用します

7. 情報の鮮度に関するポリシー

• 現在の情報として断言する前に、変動する情報（プロトコルの対応状況、RPC エンドポイント、CAP／SEP のステータス、SDK API の変更）を公式ドキュメントで確認してください。

作業手順（タスクの実行方法）

1. タスクのレイヤーを分類する

• スマートコントラクト層（Soroban/Rust）
• クライアント SDK／スクリプト層（JS/Python/Go）
• フロントエンド／ウォレット層
• アセット管理層（発行、トラストライン）
• テスト／CI 層
• インフラストラクチャ（RPC/Horizon／インデックス作成）

クイックルーティング

• カスタムのオンチェーンロジックが必要ですか？ → contracts-soroban.md
• フロントエンド／dAppを構築しますか？ → frontend-stellar-sdk.md
• トークンを発行または管理しますか？ → stellar-assets.md
• ゼロ知識証明またはプライバシーに関する内容ですか？ → zk-proofs.md
• テスト／CIをセットアップしますか？ → testing.md
• チェーンデータの照会またはインデックス作成を行いますか？ → api-rpc-horizon.md（Data Docsも参照してください）
• セキュリティレビューが必要ですか？ → security.md
• エラーが発生しましたか？ → common-pitfalls.md
• アップグレード／ファクトリー／ガバナンス／DeFiのアーキテクチャパターンが必要ですか？ → advanced-patterns.md
• SEP/CAPのガイダンスや標準へのリンクが必要ですか？ → standards-reference.md
• 有料APIまたはAIエージェントの決済クライアントを構築しますか？ → x402.mdまたはmpp.md（以下の比較を参照してください）

エージェント型決済：x402とMPPの比較

	x402	MPP Charge	MPP Channel
リクエストごとのオンチェーンTxが必要ですか？	はい（ファシリテーター経由）	はい（Soroban SAC）	いいえ（オフチェーンのコミット）
ファシリテーターが必要ですか？	はい（OZ Channels）	いいえ	いいえ
クライアントにXLMが必要ですか？	いいえ（手数料はスポンサー負担）	任意（feePayer）	はい
セットアップの複雑さ	低	低	中（最初にコントラクトをデプロイ）
最適な用途	最速のセットアップ、手数料不要のクライアント	サードパーティへの依存なし	高頻度のエージェント

• APIを販売し、XLM不要のクライアントを利用したい → x402.mdのSeller
• エージェントからx402 APIを呼び出す → x402.mdのBuyer
• APIを販売し、ファシリテーターに依存したくない → mpp.mdのChargeモード
• エージェントが1セッションで多数のリクエストを行う → mpp.mdのChannelモード
• 迷った場合 → x402（最も手軽に始められます）

すべてのプロトコルは、デフォルトでUSDC（SEP-41 SAC）を使用します。CAIP-2ネットワークIDはstellar:testnet／stellar:pubnetです。

2. 適切な構成要素を選ぶ

• コントラクト：Soroban Rust SDK + Stellar CLI
• フロントエンド：stellar-sdk（JS）+ Freighter/Wallets Kit
• バックエンド：stellar-sdk（JS/Python/Go）+ RPC
• アセット：Classic操作、またはSoroban相互運用のためのSAC
• テスト：Quickstart（ローカル）またはTestnet

3. Stellar固有の正確性を確保して実装する

以下を必ず明示してください。

• ネットワークパスフレーズ（Mainnet、Testnet、ローカルのいずれか）
• ソースアカウント + シーケンス番号
• 手数料 + リソース制限（Sorobanの場合）
• 認証要件
• アセットのトラストラインの状態
• コントラクトのストレージ型（一時、永続、インスタンス）

4. テストを追加する

• ユニットテスト：#[test]を使ったネイティブコンパイル
• 統合テスト：ローカルのQuickstartまたはTestnet
• コントラクトテスト：soroban-sdkのEnvを使用
• フロントエンドテスト：ウォレット／RPCのやり取りをモック

5. 成果物の要件

変更を実装する際は、以下を提示してください。

• 変更したファイルと差分の正確な一覧
• インストール／ビルド／テスト／デプロイのコマンド
• ネットワーク設定（パスフレーズ、RPCエンドポイント）
• 署名／手数料／ストレージ／認証に関するリスクの注記

必要に応じて読む（段階的な情報開示）

• スマートコントラクト：contracts-soroban.md
• フロントエンド + ウォレット：frontend-stellar-sdk.md
• テスト戦略：testing.md
• Stellarアセット：stellar-assets.md
• ゼロ知識証明：zk-proofs.md
• APIアクセス（RPC/Horizon）：api-rpc-horizon.md
• セキュリティチェックリスト：security.md
• よくある落とし穴：common-pitfalls.md
• 高度なアーキテクチャパターン：advanced-patterns.md
• SEP/CAP標準マップ：standards-reference.md
• エコシステムプロジェクト：ecosystem.md
• 参考リンク：resources.md
• x402有料API + エージェントクライアント：x402.md
• MPPエージェント型決済（Charge + Channel）：mpp.md

キーワード

stellar、soroban、xlm、スマートコントラクト、rust、wasm、webassembly、rpc、horizon、 freighter、stellar-sdk、soroban-sdk、stellar-cli、トラストライン、anchor、sep、パスキー、 スマートウォレット、sac、stellar asset contract、defi、トークン、nft、scaffold stellar、コンストラクター、アップグレード、ファクトリー、ガバナンス、標準規格、 ゼロ知識、zk、zk-snark、groth16、bn254、poseidon、ペアリング、プライバシー、機密、noir、risc zero、プライバシープール、マークルツリー、 x402、mpp、machine payments protocol、エージェント型決済、有料 API、決済チャネル、AI エージェント決済、usdc、sep-41、oz channels、openzeppelin relayer、http 402、リクエストごとの決済、soroban auth entries、手数料のスポンサー提供、決済ミドルウェア