ドキュメント

HiDHT は迅速な取得診断のための IPFS CID チェッカーです。開発者、ストレージ運用者、NFT チーム、データ公開者、サポートチームが「この CID は公開 IPFS ネットワークから見つかり、取得できるのか」という実務的な問いに答えるのを助けます。

実際のトラブルシューティングで重要な信号に集中します。CID 形式検証、委任ルーティングによるプロバイダー探索、公開ゲートウェイ到達性、応答時間、キャッシュ挙動、明確なエラーメッセージです。

すべてのチェックは CID 検証から始まります。HiDHT はネットワーク検査の前に、入力が有効な IPFS CID らしいかを確認します。これにより、切り詰められた識別子、貼り付けた URL、未対応文字、前後の空白などの一般的なミスを検出します。

CID 検証はコンテンツがオンラインであることを証明しません。次の検索手順で使える構造の識別子であることだけを確認します。

HiDHT は委任ルーティングや関連する IPFS ルーティングエンドポイントを通じてプロバイダー探索を確認します。プロバイダー記録は、1 つ以上のピアが CID または関連ブロックデータを提供できるとアナウンスしていることを示します。

プロバイダー検索の成功は強い発見可能性の信号ですが、ファイルのダウンロード完了と同じではありません。プロバイダーが一時的に到達不能だったり、遅いネットワーク配下だったり、ゲートウェイのタイムアウト内に取得できないデータを広告している場合があります。

プロバイダー探索の後、HiDHT は設定された公開ゲートウェイを安全なリクエスト方式で検査します。ゲートウェイ結果は、一般的な HTTP ベースの IPFS アクセス経路がその時点で CID を解決できるかを示します。

ゲートウェイの挙動は提供者によって異なります。一部のゲートウェイは特定のコンテンツタイプをブロックしたり、レート制限を適用したり、キャッシュ状態に依存したり、未キャッシュブロックの取得中にタイムアウトすることがあります。

健全な結果は通常、有効な CID、少なくとも 1 つのプロバイダー信号、1 つ以上の成功したゲートウェイ応答を含みます。時間データは、高速なキャッシュ取得と遅いネットワーク取得を区別するのに役立ちます。

プロバイダーが見つかってもゲートウェイが失敗する場合、CID はアナウンスされていても公開ゲートウェイから取得しにくい可能性があります。プロバイダー検索が空でもゲートウェイが成功する場合、そのゲートウェイがコンテンツをキャッシュしているか、現在の検索では見えない経路で見つけた可能性があります。

プロバイダー結果がない場合、コンテンツが現在アナウンスされていない、プロバイダーアナウンスが期限切れ、または検索経路が有効なプロバイダーを見つけられなかった可能性があります。コンテンツを再ピンし、プロバイダー記録の伝播を待ってから再テストしてください。

ゲートウェイタイムアウトは、ゲートウェイが十分速くブロックを取得できなかったことを示す場合があります。別のゲートウェイを試し、到達可能なノードにコンテンツがピンされているか確認し、CID が大きな UnixFS ツリーを指していて解決に時間が必要かを確認してください。

HiDHT はグローバル DHT 全体のクロール、プライベートノード状態の検査、リモートファイルの表示、コンテンツ分類、永続的な IPFS ゲートウェイとしての動作を行いません。ストレージやホスティングサービスではなく、可用性信号の診断画面です。

チェッカーはファイル内容のダウンロードと表示を避けます。これにより、取得メタデータに集中し、任意のリモートコンテンツへの不要な露出を減らします。

CID を公開する前、IPFS へアップロードした後、ゲートウェイ URL が失敗したとき、NFT やデータセットのメタデータが利用できないように見えるとき、サポートチームが中立的な取得レポートを必要とするときに使えます。

HiDHT は監視需要の発見にも有用です。繰り返し手動チェックすることで、重要な CID に対して定期チェック、アラート、API アクセス、履歴レポートが必要かを把握できます。