6 Minuten Lesezeit
Möchten Sie lieber eine Videoanleitung? Dann schauen Sie sich das Video mit Sahil an und erfahren Sie, wie Sie die Ordinals- und Runes-API nutzen können.
Übersicht
Wenn Sie die Arbeit mit den Rohdaten von Bitcoin bisher als umständlich empfunden haben oder Schwierigkeiten bei der Implementierung fortgeschrittener Funktionen wie Tokenisierung oder Datenbeschriftungen hatten, bietet die Ordinals- und Runes-API von Quicknode eine optimierte Lösung.
Dieser Leitfaden bietet Entwicklern einen Überblick über die Möglichkeiten von Ordinals und Runes auf Bitcoin und zeigt, wie sie diese Konzepte mithilfe der Ordinals- und Runes-API von Quicknode nutzen können. Ganz gleich, ob Sie einen Marktplatz oder ein Tracking-Tool entwickeln oder sich mit Analysen beschäftigen – dieser Leitfaden bietet Ihnen eine solide Grundlage für den Einstieg.
Ihre Aufgaben
- Lernen Sie die Grundlagen von Ordinals und Runes bei Bitcoin kennen
- Entdecken Sie die wichtigsten Funktionen der Ordinals- und Runes-API
- Entdecken Sie praktische Anwendungsbeispiele für die Entwicklung von Anwendungen
Was Sie benötigen
- Grundkenntnisse über Bitcoin und die Blockchain-Technologie
- Ein Quicknode-Konto mit aktiviertem Add-on für die Ordinals- und Runes-API
- Kenntnisse im Umgang mit REST-APIs und einer für API-Aufrufe eingerichteten Entwicklungsumgebung (z. B. Postman, cURL oder eine Programmiersprache wie Python oder JavaScript)
Ordinalzahlen und Runen verstehen
Bitcoin war schon immer eine leistungsstarke und zugleich unkomplizierte Blockchain. Allerdings war es bislang eine Herausforderung, ihr Potenzial für die Schaffung einzigartiger digitaler Vermögenswerte oder Token voll auszuschöpfen. Ordinals und Runes lösen dieses Problem durch erweiterte Funktionen, die es Entwicklern ermöglichen, Daten einzubetten oder Token direkt auf Bitcoin zu erstellen.
Was sind Ordinalzahlen?
Ordinals ist ein Protokoll, das digitale Artefakte in Bitcoin einführt, indem es dessen kleinste Einheit, den Satoshi, nutzt. Mit Ordinals können Sie jeden beliebigen Satoshi mit Inhalten versehen – beispielsweise mit Bildern, Text oder sogar kleinen Programmen. Es ist, als würde man einen gewöhnlichen Satoshi in ein einzigartiges digitales Artefakt verwandeln, das man an andere versenden kann. Hier eine kurze Erklärung, wie das konkret funktioniert:
Technische Umsetzung
- Jedem Satoshi in Bitcoin wird eine eindeutige Seriennummer zugewiesen, die sich nach der Reihenfolge richtet, in der er geschürft wurde.
- Wenn ein neuer Block geschürft wird, werden die darin enthaltenen Satoshis fortlaufend nummeriert
- Diese Zahlen sind „Ordnungszahlen“, daher der Name des Protokolls
Anmeldeverfahren
- Vorbereitung der Inhalte: Die digitalen Inhalte (Bilder, Texte usw.) werden aufbereitet und in ein beschreibbares Format konvertiert.
- Transaktionserstellung: Es wird eine spezielle Bitcoin-Transaktion erstellt, die die Inhaltsdaten im „Witness“- Abschnitt enthält – einem Teil von Bitcoin-Transaktionen, der zur Speicherung beliebiger Daten vorgesehen ist.

Betrachten Sie zum Beispiel diesen Link zu einem Block-Explorer, der eingetragene Satoshis zeigt. Sie können sehen, dass jede Eintragung Details wie die Eintragungs-ID, den Inhaltstyp und den Block enthält, in dem sie gemined wurde.
„Satoshi“ (sat) ist eine Bezeichnung für eine einzelne Einheit von Bitcoin. Ein Satoshi, der 1/100.000.000 eines Bitcoins entspricht, ist die kleinste Werteinheit von Bitcoin.
Was sind Runen?
Während es bei Ordinals darum geht, einzigartige Objekte zu erstellen, hilft Ihnen Runes dabei, Token auf Bitcoin zu erstellen. Damit können Sie auf Basis von Bitcoin Ihre eigene digitale Währung oder Ihr eigenes Punktesystem entwickeln. Sie können Regeln festlegen, wie viele Token es gibt, wie sie verteilt werden und wie Nutzer sie einsetzen können. Durch den Einsatz von Runes können Sie auf Bitcoin innovativ sein und gleichzeitig von dessen Sicherheit und Dezentralisierung profitieren.
Das funktioniert, indem die nativen Skriptfunktionen von Bitcoin durch einen als „Etching“ bezeichneten Prozess genutzt werden. Wenn man eine Rune „etcht“, erstellt man eine spezielle Bitcoin-Transaktion, die die grundlegenden Eigenschaften der Rune definiert, wie beispielsweise ihr Symbol, den Gesamtvorrat und die Dezimalgenauigkeit. Diese Eigenschaften sind nach dem „Etching“ dauerhaft unveränderlich in der Blockchain verankert. Runen nutzen Bitcoins „Unspent Transaction Outputs“ (UTXOs) als Grundlage, wobei jedes UTXO Daten über Rune-Guthaben und -Transfers enthalten kann.
Ordinalzahlen und Runen-API
Die direkte Arbeit mit Bitcoin kann schwierig sein, da sie das Auswerten von Blockchain-Rohdaten, das Nachverfolgen von Satoshis über Transaktionen hinweg und die Entwicklung benutzerdefinierter Logik für Inschriften oder Token erfordert.
Die Ordinals- und Runes-API von Quicknode erleichtert die Arbeit mit Ordinals und Runes über API-Aufrufe. Für Entwickler entfällt dadurch die Komplexität des Umgangs mit Bitcoin-Rohdaten, und es stehen Tools zur Verfügung, die die Entwicklung beschleunigen und Ihnen helfen, schneller Ergebnisse zu erzielen.
Funktionsübersicht
Block- und Netzwerkbetrieb:
- Blockinformationen abrufen
- Aktuelle Blockdetails nachverfolgen
Inschriftenarbeiten:
- Inhalt und Metadaten der Inschrift abrufen
- Einträge nach Block oder Transaktion suchen
- Inschriften-Sammlungen durchsuchen
- Rekursive Beschriftungsdaten abrufen
Satoshi-Management:
- Bestimmte Satoshis und deren Standorte nachverfolgen
- Satoshi-Daten an bestimmten Indizes abrufen
- Rekursive Satoshi-Informationen abrufen
Runen-Operationen:
- Einzelne Runen-Details anzeigen
- Alle Runendaten abrufen
Häufig verwendete Methoden
ord_getInscription: Details zu einer bestimmten Inschrift anhand ihrer ID abrufen.ord_getInscriptionsByBlock: Alle Inschriften innerhalb eines Blocks abrufen.ord_getSat: Daten zu einem bestimmten Satoshi anhand seiner Nummer abrufen.ord_getRune: Daten zu einer bestimmten Rune anhand ihrer ID abrufen.
Mit diesen Funktionen können Sie Anwendungen entwickeln, die mit den nativen Funktionen von Bitcoin allein nur schwer zu realisieren wären. Im nächsten Abschnitt werden wir einige praktische Anwendungsfälle durchgehen, um Ihnen den Einstieg zu erleichtern.
Praktische Anwendungsbeispiele
1. Entwicklung eines „Inscription Explorer“
Ziel: Schaffung einer Plattform, auf der Nutzer Inschriften erkunden und verstehen können.
Wichtigste Methoden:
ord_getInscriptions- Verfügbare Inschriften-IDs abrufenord_getInscription- Erhalten Sie detaillierte Informationen zu bestimmten Inschriftenord_getContent- Den Inhalt der Inschrift im HTML-Format abrufen
Umsetzungsideen:
- Eine paginierte Ansicht aller Einträge erstellen
- Detaillierte Anzeige der Metadaten zu Einträgen aktivieren, einschließlich Inhaltstyp, Zeitstempel und Satellitendaten
- Filterung nach Inhaltstyp, Blockhöhe oder Beschriftungsnummer implementieren
- Zeige die Beziehungen zwischen den Inschriften anhand der untergeordneten Daten an
- Inschriftinhalt anzeigen, sofern dies vom Inhaltstyp unterstützt wird
2. SAT-Analyse-Tool
Ziel: Entwicklung eines Tools zur Analyse und Nachverfolgung bestimmter Satoshis und ihrer Inschriften.
Wichtigste Methoden:
ord_getSat- Erhalte detaillierte Satellitendaten wie Seltenheit, Umlaufzeit und Epocheord_getInscription- Details zur Inschrift abrufen
Umsetzungsideen:
- Umfassende Satellitendaten anzeigen, darunter Seltenheit, Umlaufzyklus und Epoche
- Alle Inschriften anzeigen, die zu einem bestimmten Satelliten gehören
- Visualisierungen der SAT-Verteilung über die Blöcke hinweg erstellen
- Suche nach Satellitennamen oder -nummer aktivieren
- Zeige den historischen Kontext des SATs anhand seines Block-Zeitstempels an
3. Blockbasierte Inschriftenanalyse
Ziel: Analyse der Einschreibungsmuster und -trends über verschiedene Blöcke hinweg.
Wichtigste Methoden:
ord_getInscriptionsByBlock- Inschriften für bestimmte Blöcke abrufenord_getInscription- Detaillierte Informationen zur Inschrift abrufen
Umsetzungsideen:
- Statistiken zur Inschriften-Dichte pro Block erstellen
- Erstellen Sie Visualisierungen, die die Verteilung der Inschriftenarten darstellen
- Häufige Muster bei den Inhaltstypen von Inschriften erfassen
- Gebührenstrukturen für Eintragungen analysieren
- Berichte über die Verteilung der Inschriftenwerte erstellen
4. Rune-Management-Dashboard
Ziel: Erstellung einer detaillierten Übersicht über Runenaktivitäten und -statistiken.
Wichtigste Methoden:
ord_getRunes- Liste aller Runen mit Details anzeigenord_getRune- Details zu einer bestimmten Rune abrufen
Umsetzungsideen:
- Alle aktiven Runen mit ihren wichtigsten Kennzahlen wie Angebot, Verbrennungen und Prägungen anzeigen
- Verteilung der Runenvorräte und der Runenverbrennungen anzeigen
- Runenprägungsmuster nachverfolgen
- Visualisierungen der Runenaktivität im Zeitverlauf erstellen
- Filterung nach Runeneigenschaften (Teilbarkeit, Verfügbarkeit usw.) aktivieren
5. Visualisierung von Inschriftenbeziehungen
Ziel: Entwicklung eines Tools zur Untersuchung und Visualisierung von Zusammenhängen zwischen Inschriften.
Wichtigste Methoden:
ord_getChildren- Untertitel abrufenord_getInscription- Details zur Inschrift abrufen
Umsetzungsideen:
- Erstellen Sie eine grafische Darstellung der Eltern-Kind-Beziehungen
- Hierarchien von Beschriftungen nachverfolgen
- Muster in den Beziehungen zwischen Inschriften analysieren
- Erkundung von Inschriftenfamilien ermöglichen
- Unterschiede in den Metadaten zwischen verwandten Inschriften anzeigen
6. Collection Explorer und Analytics
Ziel: Schaffung einer Plattform zur Erschließung und Analyse von Ordinalsammlungen.
Wichtigste Methoden:
ord_getCollections- Die Liste der Sammlungs-IDs abrufen
Umsetzungsideen:
- Erstellen Sie einen Sammlungsbrowser mit Paginierungsfunktion
- Erstellen Sie Dashboards mit Sammlungsstatistiken und Analysen
- Filtern von Sammlungen nach verschiedenen Metadatenattributen aktivieren
Jeder dieser Anwendungsfälle kann als eigenständiges Tool umgesetzt oder zu einer umfassenden Plattform für die Analyse von Ordinals und Runes kombiniert werden. Die API stellt umfangreiche Daten bereit, die zur Gewinnung wertvoller Erkenntnisse und zur Entwicklung von Tools für das Ordinals-Ökosystem genutzt werden können.
Schauen Sie sich unser Repository mit Beispiel-Apps an, um Inspiration für Ihr Projekt zu finden.
Einrichten Ihrer Umgebung
Um die Ordinals- und Runes-API nutzen zu können, müssen Sie Ihre Umgebung einrichten. Dazu müssen Sie sich für ein Quicknode-Konto registrieren, Ihren Endpunkt abrufen und API-Anfragen einrichten.
- Melden Sie sich bei Ihrem Quicknode-Konto an
- Erstellen Sie einen neuen Bitcoin-Mainnet-Endpunkt, falls Sie dies noch nicht getan haben.
- Das Add-on „Ordinals and Runes API “ aktivieren
- Kopieren Sie die URL Ihres Bitcoin-Endpunkts, bei dem die API aktiviert ist
- In unserer Quicknode-API-Dokumentation finden Sie detaillierte Methodenbeschreibungen und Beispiele.
- Verwenden Sie ein Tool wie Postman oder eine Programmiersprache, um API-Anfragen zu senden
Fazit
Die Ordinals- und Runes-API eröffnet Entwicklern neue Möglichkeiten für Innovationen im Bereich Bitcoin. Von Marktplätzen bis hin zu Überwachungstools – ihre Funktionen ermöglichen eine Vielzahl von Anwendungen. Tauchen Sie in die API-Dokumentation ein, um weitere Methoden zu entdecken und das Potenzial von Bitcoin-Inschriften und Runes in Ihren Projekten voll auszuschöpfen.
Wenn du Fragen hast oder Hilfe benötigst, kannst du dich gerne über Discord oder Twitter an uns wenden.
Wir ❤️ Feedback!
Teilen Sie uns gerne mit, wenn Sie Feedback oder Vorschläge für neue Themen haben. Wir freuen uns auf Ihre Rückmeldung.
Ressourcen
- Quicknode -Ressourcen für Bitcoin -Entwickler
- Quicknode-Bitcoin -Dokumentation
- Add-on „Ordinalzahlen und Runen-API“
