読了時間：6分
動画による解説をご希望ですか？サヒルと一緒に、OrdinalsおよびRunes APIの使い方を学びましょう。
概要
ビットコインの生データを扱うのが面倒だと感じたことや、トークン化やデータインスクリプションといった高度な機能の実装に苦労した経験があるなら、QuicknodeのOrdinalsおよびRunes APIが、その課題を解決する効率的なソリューションを提供します。
このガイドでは、開発者の皆様にビットコイン上の「Ordinals」と「Runes」の機能を紹介し、QuicknodeのOrdinalsおよびRunes APIを活用してこれらの概念をどのように活用できるかを解説します。マーケットプレイスの構築、追跡ツールの開発、あるいは分析の検討など、どのような目的であれ、このガイドは第一歩を踏み出すための基礎を提供します。
主な業務内容
- ビットコインにおける「Ordinals」と「Runes」の基礎を学ぶ
- OrdinalsおよびRunes APIの主な機能を詳しく見てみましょう
- アプリケーション構築における実用的な活用事例をご覧ください
必要なもの
- ビットコインおよびブロックチェーン技術に関する基礎知識
- OrdinalsおよびRunes APIアドオンが有効化されたQuicknodeアカウント
- REST APIに関する知識、およびAPI呼び出しを行うための開発環境（Postman、cURL、あるいはPythonやJavaScriptなどのプログラミング言語など）のセットアップ
序数とルーンの理解
ビットコインは、常に強力でありながらシンプルなブロックチェーンでした。しかし、独自のデジタル資産やトークンを作成するというその可能性を引き出すことは、これまで困難でした。OrdinalsとRunesは、高度な機能を追加することでこの課題を解決し、開発者がビットコイン上に直接データを刻印したり、トークンを作成したりできるようにします。
序数とは何か？
Ordinalsは、ビットコインの最小単位である「サトシ」を活用して、ビットコインにデジタルアーティファクトを導入するプロトコルです。Ordinalsを使えば、任意のサトシに、画像やテキスト、さらには小さなプログラムといったコンテンツを埋め込むことができます。これは、通常のサトシを、他の人に送ることができるユニークなデジタルアーティファクトに変えるようなものです。その仕組みを簡単に説明すると、次のようになります：
技術的な実装
- ビットコインの各サトシには、採掘された順序に基づいて一意のシリアル番号が割り当てられています
- 新しいブロックがマイニングされると、そのブロック内のサトシには連番が割り当てられます
- これらの数字は「序数」であり、これがプロトコルの名前の由来となっています
登録手続き
- コンテンツの準備：デジタルコンテンツ（画像、テキストなど）を準備し、書き込み可能な形式に変換します。
- トランザクションの作成：ウィットネスセクション（ビットコインのトランザクションの一部で、任意のデータを格納するために設計された部分）にコンテンツデータを含む、特別なビットコイン・トランザクションが作成されます。
例えば、刻印されたサトシを紹介しているこのブロックエクスプローラーのリンクを見てみましょう。各刻印には、刻印ID、コンテンツタイプ、マイニングされたブロックなどの詳細情報が含まれていることがわかります。
「サトシ（sat）」とは、ビットコインの1単位を指す用語です。1サトシはビットコインの1/100,000,000に相当し、ビットコインにおける最小の価値単位です。
ルーンとは何ですか？
Ordinalsはユニークなアイテムの作成を目的としているのに対し、Runesはビットコイン上でトークンを作成するのに役立ちます。これにより、ビットコインを基盤として独自のデジタル通貨やポイントシステムを構築することが可能です。トークンの発行総数、配布方法、利用方法などのルールを設定できます。Runesを活用することで、ビットコインのセキュリティと分散化の利点を活かしながら、ビットコイン上で革新的な取り組みを行うことができます。
これは、「エッチング」と呼ばれるプロセスを通じて、ビットコインが本来備えているスクリプト機能を活用することで機能します。 ルーンを「エッチング」すると、そのルーンのシンボル、総供給量、小数点以下の桁数といった基本的な特性を定義する特別なビットコイン取引が生成されます。これらの特性は、一度エッチングされると、ブロックチェーン上で永久に不変のものとなります。ルーンはビットコインの未使用取引出力（UTXO）を基盤としており、各UTXOにはルーンの残高や送金に関するデータを含めることができます。
序数とルーン API
ビットコインを直接扱うのは、生のブロックチェーンデータを解析したり、取引間でサトシを追跡したり、インスクリプションやトークン向けのカスタムロジックを構築したりする必要があるため、難しい場合があります。
QuicknodeのOrdinalsおよびRunes APIを利用すれば、API呼び出しを通じてOrdinalsやRunesを簡単に扱うことができます。開発者にとっては、生のビットコインデータとやり取りする際の複雑さが解消され、開発を加速させ、より迅速にシステムを構築するためのツールが提供されます。
機能の概要
ブロックおよびネットワーク運用：
- ブロックの情報を取得する
- 現在のブロックの詳細を追跡する
刻印作業：
- 碑文の内容とメタデータを取得する
- ブロックまたはトランザクションごとに書き込みを検索する
- 碑文コレクションを閲覧する
- 再帰的なインスクリプションデータを取得する
サトシ・マネジメント：
- 特定のサトシとその位置を追跡する
- 特定のインデックスでサトシのデータを取得する
- 再帰的なサトシ情報を取得する
ルーンの運用：
- 各ルーンの詳細を確認する
- すべてのルーンのデータを取得する
一般的に用いられる手法
ord_getInscription: ID に基づいて、特定の碑文の詳細情報を取得します。ord_getInscriptionsByBlock: ブロック内のすべての碑文を取得します。ord_getSat: 特定のサトシの番号から、そのサトシに関するデータを取得します。ord_getRune: ID に基づいて特定のルーンに関するデータを取得します。
これらの機能を活用すれば、ビットコインの標準機能だけでは実現が難しいようなアプリケーションを構築することができます。次のセクションでは、実際に活用できるユースケースをいくつか紹介し、皆様がすぐに始められるようサポートします。
実用的な活用事例
1. インスクリプション・エクスプローラーの構築
目的：ユーザーが碑文を探求し、理解するためのプラットフォームを構築すること。
主な手法：
ord_getInscriptions- 利用可能な銘文IDを取得するord_getInscription- 特定の碑文に関する詳細情報を確認するord_getContent- 刻印の内容をHTML形式で取得する
実装のアイデア：
- すべての碑文をページ分けして表示する
- コンテンツタイプ、タイムスタンプ、SATの詳細など、インスクリプションのメタデータを詳細に表示できるようにする
- コンテンツの種類、ブロックの高さ、または銘文番号によるフィルタリングを実装する
- 子データを使用して、碑文間の関連性を表示する
- コンテンツタイプでサポートされている場合、表示の説明文を表示する
2. SAT分析ツール
目的：特定のサトシとその刻印を分析・追跡するためのツールを構築する。
主な手法：
ord_getSat- レア度、サイクル、エポックなどの詳細なSAT情報を確認するord_getInscription- 刻印の詳細を確認する
実装のアイデア：
- 希少度、サイクル、エポックなど、包括的な衛星情報を表示する
- 特定のサットに関連するすべての碑文を表示する
- ブロックごとのSAT分布を可視化する
- 衛星名または番号による検索を有効にする
- ブロックのタイムスタンプに基づいて、そのサットの歴史的背景を表示する
3. ブロックベースの碑文解析
目的：各ブロックにおける碑文のパターンと傾向を分析すること。
主な手法：
ord_getInscriptionsByBlock- 特定のブロックの刻銘を取得するord_getInscription- 詳細な銘文情報を確認する
実装のアイデア：
- ブロックごとの刻印密度に関する統計を生成する
- 碑文の種類ごとの分布を示す可視化を作成する
- 碑文の内容タイプに見られる共通のパターンを追跡する
- 碑文の料金体系を分析する
- 銘文の価値分布に関するレポートを作成する
4. ルーン管理ダッシュボード
目的：ルーンの活動状況や統計に関する詳細なビューを作成する。
主な手法：
ord_getRunes- すべてのルーンの一覧と詳細情報を確認するord_getRune- 特定のルーンの詳細を確認する
実装のアイデア：
- すべてのアクティブなルーンを、供給量、バーン量、ミント量などの主要指標とともに表示する
- ルーンの供給量と消費量の分布を表示する
- ルーンの鋳造パターンを追跡する
- 時間の経過に伴うルーンの活動状況を可視化する
- ルーンの特性（割り切れるかどうか、供給量など）によるフィルタリングを有効にする
5. 碑文の関係可視化ツール
目的：碑文間の関係を調査・可視化するためのツールを作成する。
主な手法：
ord_getChildren- 子要素の記述を取得するord_getInscription- 刻印の詳細を確認する
実装のアイデア：
- 親子関係のグラフ可視化を作成する
- 記述の階層構造を追跡する
- 碑文間の関係におけるパターンを分析する
- 碑文群の調査を可能にする
- 関連する碑文間のメタデータの相違点を表示する
6. コレクション・エクスプローラーとアナリティクス
目的：順序付きコレクションを発見・分析するためのプラットフォームを構築すること。
主な手法：
ord_getCollections- コレクションIDの一覧を取得する
実装のアイデア：
- ページネーション機能を備えたコレクションブラウザを構築する
- コレクションの統計情報と分析ダッシュボードを作成する
- さまざまなメタデータ属性によるコレクションのフィルタリングを有効にする
これらのユースケースは、それぞれ独立したツールとして実装することも、OrdinalsおよびRunesの分析を行う包括的なプラットフォームに統合することも可能です。このAPIは、Ordinalsエコシステムに向けた有益な知見やツールを生み出すために活用できる豊富なデータを提供します。
プロジェクトのアイデア探しに、当社のサンプルアプリリポジトリをぜひご覧ください。
環境のセットアップ
OrdinalsおよびRunes APIを利用するには、環境の設定が必要です。これには、Quicknodeアカウントの登録、エンドポイントの取得、およびAPIリクエストの設定が含まれます。
- Quicknodeアカウントにログインしてください
- まだ作成していない場合は、新しいビットコイン・メインネットのエンドポイントを作成してください
- 「Ordinals and Runes API」アドオンを有効にする
- APIが有効になっている状態のビットコインエンドポイントURLをコピーしてください
- メソッドの詳細な説明や使用例については、Quicknode APIのドキュメントをご覧ください。
- Postman などのツールやプログラミング言語を使用して、API リクエストを送信します
結論
OrdinalsおよびRunes APIは、開発者がビットコイン上で革新的な取り組みを行うための新たな可能性を切り開きます。マーケットプレイスからモニタリングツールに至るまで、その機能により幅広いアプリケーションの実現が可能になります。APIドキュメントを詳しく確認し、さらに多くのメソッドを探求して、プロジェクトにおいてビットコインのインスクリプションやRunesの可能性を最大限に引き出してください。
ご質問やサポートが必要な場合は、Discordや Twitterからお気軽にお問い合わせください。
皆様からのフィードバックを心よりお待ちしております！❤️
ご意見や新しいトピックに関するご要望などがありましたら、ぜひお知らせください。皆様からのご連絡を心よりお待ちしております。
リソース
- Quicknode ビットコイン開発者向けリソース
- Quicknode ビットコインドキュメント
- 序数とルーン API アドオン