====== 260221 QUBIC.NET Toolkit を使用して QUBIC オラクルマシン にクエリを送信する方法 ======
{{ .:pasted:20260222-010633.png?400}}

> 出典 [[https://qubic-org.b-cdn.net/images/dots-circle.png|How to Query Qubic Oracle Machines Using the Qubic.Net Toolkit]]

**執筆者:** Qubic チーム / **公開日:** 2026年2月21日

　[[tag/オラクルマシン|]]（Oracle Machines） が Qubic メインネットで稼働開始しました。誰でもネットワークのネイティブなオラクルインフラにクエリを送信し、検証済みの現実世界のデータをオンチェーンで受け取ることができるようになりました。

　[[tag/Qubic.Net-Toolkit]] を使用すれば、ポイント＆クリックのデスクトップインターフェースを通じてこれにアクセスできます。コードもコマンドラインも不要です。このガイドでは、ダウンロードから最初のオラクル応答を得るまでの全プロセスを順を追って説明します。

===== ❓ QUBIC における ORACLE MACHINES とは？ =====

　ブロックチェーンは、すでにオンチェーンに存在するデータしか扱うことができません。[[tag/スマートコントラクト]]単体では、ビットコインの現在の価格やサッカーの試合結果を自力で確認する方法はありません。

　[[tag/オラクルマシン]] はこの問題を解決します。これらは Qubic コアノードと外部データソースの間に位置し、現実世界の情報を取得して、ブロックチェーンが信頼できるフォーマットで送り返します。その後、Qubic の 676 台の [[tag/Computor]] が Quorum (定足数) コンセンサスを通じて応答を検証し、初めてオンチェーンで利用可能になります。

　ローンチ時には 2 つの[[tag/オラクル]]インターフェースが利用可能です。複数のプロバイダーからライブの暗号資産価格データを取得する「Price Oracle」と、クエリフローを検証するためのテストデータを返す「Mock Oracle」です。エコシステムの成長に伴い、さらに多くのインターフェースタイプが追加される予定です。

===== 🛠️ 始める前に必要なもの =====

  * **Qubic [[tag/秘密鍵|シード]] (Seed):** 
    * ネットワーク上のあなたのアイデンティティを生成する、55文字の小文字のパスワードです。
    * すでに [[https://wallet.qubic.org/|Qubic ウォレット]]を使用している場合は、それを持っています。
    * このシードは厳重に保管してください。
    * Qubic がこれを尋ねることは決してありませんし、これを持っている人は誰でもあなたの資金をコントロールできてしまいます。

  * **資金の入ったウォレット:** 
    * オラクルの各クエリには 10 QU のコストがかかり、これは永久に[[tag/バーン]] (焼却) されます。
    * クエリを送信する前に、ウォレットに最低でも 10 QU を保有している必要があります。

  * **[[tag/Qubic.Net-Toolkit]]:** 
    * Windows、macOS、Linux で利用可能です。
    * GitHub の Releases ページ（https://github.com/qubic/Qubic.NET/releases） から最新リリースを入手してください。

===== 🚀 ステップ 1: ツールキットのダウンロードと起動 =====

　[[https://github.com/qubic/Qubic.NET/releases|Releases ページ]]にアクセスし、お使いのオペレーティングシステム用の zip ファイルをダウンロードします。

  * **Windows:** 
    * zip を展開し、`Qubic.Net.Toolkit.exe` をダブルクリックします。

  * **macOS:** 
    * お使いのチップ (Apple Silicon または Intel) に合った zip をダウンロードします。macOS のビルド済みバイナリはサーバーモードのみをサポートしています：

<code>
chmod +x Qubic.Net.Toolkit
./Qubic.Net.Toolkit --server
</code>

  * **Linux:** 
    * 展開し、実行可能にして実行します。
    * デスクトップモードは Ubuntu 24.04+、Debian 13+、Fedora 39+、および Arch で動作します。
    * 古いディストリビューションは自動的にサーバーモードにフォールバックします。

　ダウンロードしたファイルの [[tag/SHA-256ハッシュ]]が、各リリースで公開されている `.sha256` ファイルと一致するかを常に検証してください。

　起動すると、現在のティック、エポック、ネットワークのステータスを示すダッシュボードが表示されます。

{{.:pasted:20260222-010707.png?800}}

===== 🔑 ステップ 2: シードの入力と接続 =====

　トップバーに、55文字の Qubic [[tag/秘密鍵|シード]]を入力します。ツールバーには「Seed active (シードがアクティブ)」と省略されたアドレスが表示されます。黄色のバナーは、シードがこのセッションの間だけメモリに保持されていることを確認するものです。

　接続する前に、トップバーの接続モードのドロップダウンを確認してください。ツールキットのデフォルトは RPC モードですが、[[tag/オラクルマシン|Oracle Machine]] のクエリには Direct Network モードが必要です。ドロップダウンを **Direct Network** に切り替え、ノードアドレスを `corenet.qubic.li` に、ポートを `21841` に設定します。その後、「Connect (接続)」をクリックします。右上のステータスバッジが「Not connected (未接続)」からアクティブな状態に切り替わるはずです。

　終了時は、[[tag/秘密鍵|シード]]をメモリから消去するために必ず「Clear (クリア)」をクリックしてください。

===== 🧭 ステップ 3: ORACLE MACHINE への移動 =====

　左側のサイドバーを下にスクロールし、Send & Sign、Contracts、DeFi、Utility の下を通過します。「TOOLS (ツール)」セクションの下にある「Oracle Machine」をクリックします。

　メインパネルには、Query (クエリ)、Lookup (検索)、Browse (閲覧)、Statistics (統計) の 4 つのタブを持つ Oracle Machine (OM) ページが表示されます。デフォルトでは Query が選択されています。

===== ⚙️ ステップ 4: オラクルクエリの設定 =====

　Query タブには、「Send Oracle Query (オラクルクエリを送信)」というラベルのフォームと、「Fee: 10 QU (手数料: 10 QU)」というバッジが表示されます。各フィールドの機能は以下の通りです：

{{.:pasted:20260222-010807.png?800}}

  * **Interface (インターフェース)**
    * クエリを送信したいオラクルのタイプを選択します：
    * **Price Oracle (価格オラクル):** 
      * 外部プロバイダーからライブの暗号資産価格データを取得します。
    * **Mock Oracle (テスト用):** 
      * 数値 (uint64) を受け取り、それをそのまま返し、double 型で返します。
      * クエリのフローがエンドツーエンドで機能するかを検証するのに便利です。
      * モッククエリにも 10 QU のコストがかかります。

{{.:pasted:20260222-010838.png?800}}

  * **Oracle Source (オラクルソース)**
    * オラクルが価格を取得する外部データプロバイダーです。
    * 個別の取引所 (Binance、MEXC、Gate.io) および組み合わせたソース (Binance + MEXC、Binance + Gate.io、Gate.io + MEXC) が含まれます。
    * 組み合わせたソースは両方のプロバイダーから価格を集約し、単一の取引所からの偏ったデータのリスクを軽減します。
    * 最初のテストでは Binance が手堅いデフォルトの選択肢です。

{{.:pasted:20260222-010905.png?800}}


  * **Currency Pair (通貨ペア)**
    * 価格を知りたい取引ペアです。
    * USDT に対してクオートされる主要なペアが利用可能です：
      * BTC/USDT、ETH/USDT、BNB/USDT、SOL/USDT、XRP/USDT、DOGE/USDT、ADA/USDT、AVAX/USDT、LINK/USDT、DOT/USDT など。

{{.:pasted:20260222-010942.png?800}}

  * **Timestamp (UTC) (タイムスタンプ)**
    * 価格が対応すべき正確な時間です。デフォルトは「現在」です。特定の瞬間の価格データが必要な場合は調整してください。

  * **Timeout (seconds) (タイムアウト秒数)**
    * リクエストが失敗したとマークされるまでに応答を待つ時間です。デフォルトは 60 秒で、1 から 3600 の範囲で設定できます。ほとんどのクエリでは 60 のままにしておきます。

===== 📤 ステップ 5: クエリの送信と結果の確認 =====

　青い「Send Oracle Query (10 QU)」ボタンをクリックします。10 QU の手数料が差し引かれ、永久に[[tag/バーン]]されます。

　クエリはネットワークの処理パイプラインに入ります。Oracle Machine がリクエストを受け取り、選択したプロバイダーからデータを取得して、Qubic コアノードに返します。[[tag/Computor]] が [[tag/クォーラム|Quorum]] を通じて応答を検証し、検証済みの結果がオンチェーンに着地します。通常の条件下では、予想される応答時間は約 10 秒です。

　Oracle Machine ページの他のタブを使用してクエリを追跡します：

  * **Lookup (検索):** 
    * トランザクションの詳細によって特定のクエリを検索します。

  * **Browse (閲覧):** 
    * ネットワーク全体の最近のオラクルクエリと応答を表示します。

  * **Statistics (統計):** 
    * オラクルの使用状況と応答時間に関する集計データです。

　クエリのステータスは、Pending (処理中)、Successful (配信完了)、または Failed (タイムアウト) のいずれかで表示されます。

===== ⚠️ 重要な注意事項 =====

  * **[[tag/シード]]の安全性は絶対です。** 
    * ツールキットはシードをディスクに書き込むことも、ネットワーク経由で送信することも決してありません（メモリ上にのみ存在します）。
    * 毎回のセッション後にクリアしてください。シードを求めてくる人は誰でも詐欺師です。

  * **サーバーモードに関する注意。** 
    * ''--server'' フラグを付けて実行すると、ローカルホストで暗号化されていない HTTP が使用されます。
    * マシン上の他のソフトウェアが理論上これを傍受する可能性があります。可能な場合はデスクトップモードを優先してください。

  * **これはベータ版ソフトウェアです。** 
    * ツールキットは現在活発に開発中です。エラーが発生する可能性があります。

  * **オラクルの手数料はすべてバーンされます。** 
    * 1クエリあたり 10 QU は、どのウォレットやチームにも渡りません。流通から永久に削除されます。

===== 💡 これを使って何が構築できるか？ =====

　オラクルクエリは、Qubic 上で新しいカテゴリのアプリケーションを解き放ちます。検証された現実世界の結果から自動的に決済される予測市場。信頼できる価格フィードから清算をトリガーする DeFi プロトコル。測定可能な条件が満たされたときに支払いを行うパラメトリック保険。

　ツールキットは、開発中にクエリをテストするのに最適です。本番環境での使用のために、[[https://github.com/qubic/Qubic.Net|Qubic.Net ライブラリ]]を通じてプログラム的に同じインフラを利用できます。

　技術的な詳細については、[[https://github.com/qubic/oracle-machine|Oracle Machine のリポジトリ]]と [[https://docs.qubic.org/developers/oracles/|Qubic の開発者向けドキュメント]]を参照してください。

　[[tag/オラクルマシン]] は稼働中です。現実世界と Qubic [[tag/スマートコントラクト]]間のデータパイプラインが開かれました。クエリを始めましょう。

　質問やフィードバックはありますか？ [[https://discord.gg/qubic|Qubic Discord コミュニティ]]にご参加ください。

{{tag>オラクルマシン オラクル Qubic.net Qubic.net-toolkit blog news }}