> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intention.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 開発者

> APIリファレンス、統合ガイド、SDK、テストネットのツール、Intention上で開発するためのソースコードの在り処です。

Intention上で開発するために必要なものは、すべて以下のいずれかにあります。このページはその地図です。

初めて統合する場合は**統合ガイド**から始めてください。SDKのインストールから、テストネットで注文が約定するところまでを順に説明します。システムの全体像がすでに分かっていてフィールド単位の詳細だけが必要なら、**APIリファレンス**に直接進んでください。

<h2 id="start-here">
  まずここから
</h2>

<CardGroup cols={2}>
  <Card title="統合ガイド" icon="book-open" href="https://dev.intention.xyz/">
    開発者向けの通しの手順です。インストール、認証と署名、RESTのクイックスタート、アカウント、マーケットデータ、注文、取引フロー、USDCの送金、レート制限までを順にたどります。
  </Card>

  <Card title="APIリファレンス" icon="plug" href="https://testnet-openapi.intention.xyz/">
    RESTとWebSocketの完全な仕様です。スキーマと、ブラウザ上でリクエストを実行できるツールが付属します。
  </Card>
</CardGroup>

<h2 id="what-the-api-covers">
  APIがカバーする範囲
</h2>

リファレンスは以下のグループに分かれています。件数は現行のテストネット仕様におけるエンドポイント数です。

| グループ             | 扱う内容                                           |
| ---------------- | ---------------------------------------------- |
| **Markets**      | 無期限先物マーケットの一覧、板、約定、ローソク足、資金調達率                 |
| **Trading**      | 未約定注文、約定、クライアント注文IDによる照会                       |
| **Transactions** | トランザクションの送信、一括送信、シミュレーション、エンコード、完了待ちと、gasの見積もり |
| **Accounts**     | アドレスとサブアドレスの状態、ポジション、注文履歴、取引履歴、送金、資金調達の支払い     |
| **DEX Config**   | 無期限先物とスポットの定義、手数料設定、レバレッジティア、エージェントの紐付け        |
| **Oracle**       | 現在のブロックにおける認証済み価格                              |
| **Dashboard**    | アカウント価値、損益の推移、取引カレンダー、サマリー                     |
| **Export**       | 注文履歴、取引履歴、資金調達の支払いのCSV出力                       |
| **WebSocket**    | 板、約定、ティッカー、ローソク足、サブアカウント、ブロック、トランザクションの購読チャンネル |

<h2 id="testnet-tools">
  テストネットのツール
</h2>

開発用のインタラクティブなツールです。いずれも開発者向けサイトで提供しています。

<CardGroup cols={2}>
  <Card title="フォーセット" icon="faucet" href="https://dev.intention.xyz/tools-faucet">
    新しいアカウント用にテストネットの資金を請求します。
  </Card>

  <Card title="注文の照会" icon="magnifying-glass" href="https://dev.intention.xyz/tools-order-lookup">
    IDから任意の注文のステータスと履歴を確認します。
  </Card>

  <Card title="WebSocketテスター" icon="signal-stream" href="https://dev.intention.xyz/tools-websocket">
    稼働中のチャンネルを購読し、生のメッセージを確認します。
  </Card>

  <Card title="BCSベリファイア" icon="binary" href="https://dev.intention.xyz/tools-bcs-verifier">
    署名する前に、シリアライズされたトランザクションが意図どおりにエンコードされているか確認します。
  </Card>
</CardGroup>

<h2 id="sdks-and-source">
  SDKとソース
</h2>

<CardGroup cols={2}>
  <Card title="SDK" icon="cubes" href="https://dev.intention.xyz/installation">
    TypeScript、Go、Python、C++の公式SDKです。アカウント生成、署名、注文の組み立て、送金に対応します。
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/intentionxyz">
    SDK、ノードソフトウェア、リファレンス実装のソースです。
  </Card>
</CardGroup>

<Note>
  公開している仕様は、現時点ではテストネットを対象としています。エンドポイントの形は開発を進められる程度には安定していますが、メインネットでまだ検証されていないものは、メインネットのリリースノートに別段の記載があるまで変更されうるものとして扱ってください。
</Note>

<h2 id="run-a-node">
  ノードを運用する
</h2>

ノードの運用は**開放されていません**。バリデータセットはIntention Labsと招待されたパートナーが運用しており、参加は登録ではなく承認によります。公開された参加フローはなく、一般向けに配布されるバイナリもありません。

インフラを運用する必要がある場合は、件名に**Node operator**と記載して`contact@intention.xyz`宛にメールしてください。存在する役割と記載すべき内容は[ノードを運用する](/ja/developers/run-a-node)を参照してください。

<Note>
  ノードを欲しがる理由の大半は、読み取りアクセスの理由です。安定したクエリ、履歴、他人のインデクサーに依存しないこと。いずれも上記のAPIと[インデクサー](/ja/protocol/architecture/indexer)で満たせるので、何かを運用する必要はありません。
</Note>

<h2 id="getting-help">
  サポートを受ける
</h2>

統合に関する質問、想定外のエンドポイントの挙動、商業的な取り決めは、いずれも`contact@intention.xyz`が窓口です。記載すべき内容は[APIと連携に関する質問](/ja/help/builder-questions)を参照してください。