Leestijd: 6 min

Liever een videohandleiding? Volg dan Sahil om te leren hoe je de Ordinals- en Runes-API kunt gebruiken.

Abonneer je op ons YouTube-kanaal voor meer video's!Abonneren

Overzicht

Als je het werken met de ruwe gegevens van Bitcoin ooit omslachtig hebt gevonden of moeite hebt gehad met het implementeren van geavanceerde functionaliteiten zoals tokenisatie of gegevensinscripties, dan biedt de Ordinals- en Runes-API van Quicknode een gestroomlijnde oplossing.

Deze handleiding laat ontwikkelaars kennismaken met de mogelijkheden van Ordinals en Runes op Bitcoin en laat zien hoe ze deze concepten kunnen toepassen met behulp van de Ordinals- en Runes-API van Quicknode. Of je nu een marktplaats of een trackingtool bouwt, of je verdiept in analytics: deze handleiding biedt een goede basis om aan de slag te gaan.

Wat je gaat doen

• Leer de basisbeginselen van Ordinals en Runes op Bitcoin
• Ontdek de belangrijkste functies van de Ordinals- en Runes-API
• Ontdek praktische voorbeelden van het bouwen van applicaties

Wat je nodig hebt

• Basiskennis van Bitcoin en blockchaintechnologie
• Een Quicknode-account waarop de Ordinals- en Runes-API-add-on is ingeschakeld
• Kennis van REST-API’s en een ontwikkelomgeving die is ingesteld voor het uitvoeren van API-aanroepen (bijvoorbeeld Postman, cURL of een programmeertaal zoals Python of JavaScript)

Inzicht in rangtelwoorden en runen

Bitcoin is altijd al een krachtige maar eenvoudige blockchain geweest. Het was echter een uitdaging om het potentieel ervan te benutten voor het creëren van unieke digitale activa of tokens. Ordinals en Runes bieden hiervoor een oplossing door geavanceerde mogelijkheden toe te voegen, waardoor ontwikkelaars gegevens kunnen vastleggen of tokens rechtstreeks op Bitcoin kunnen creëren.

Wat zijn rangtelwoorden?

Ordinals is een protocol dat digitale artefacten in Bitcoin introduceert door gebruik te maken van de kleinste eenheid ervan, de satoshi. Met Ordinals kun je willekeurige satoshi’s nemen en er inhoud aan toekennen – zoals afbeeldingen, tekst of zelfs kleine programma’s. Het is alsof je een gewone satoshi omzet in een uniek digitaal artefact dat je naar anderen kunt sturen. Hier volgt een korte uitleg van hoe het precies werkt:

Technische uitvoering

• Elke satoshi in Bitcoin krijgt een uniek serienummer toegewezen op basis van de volgorde waarin deze is gemined
• Wanneer er een nieuw blok wordt gemined, worden de satoshi’s daarin opeenvolgend genummerd
• Deze getallen zijn „rangtelwoorden“, vandaar de naam van het protocol

Inschrijvingsprocedure

1. Voorbereiding van de inhoud: De digitale inhoud (afbeeldingen, tekst, enz.) wordt voorbereid en omgezet naar een formaat dat geschikt is voor belettering
2. Transactie aanmaken: Er wordt een speciale Bitcoin-transactie aangemaakt die de inhoudsgegevens bevat in de ‘witness’-sectie, een onderdeel van Bitcoin-transacties dat bedoeld is om willekeurige gegevens op te slaan

Neem bijvoorbeeld deze link naar een block explorer die gegraveerde satoshi’s laat zien. Je kunt zien dat elke inscriptie details bevat zoals de ID van de inscriptie, het type inhoud en het blok waarin deze is gemined.

Satoshi (sat) is een term die wordt gebruikt om naar één enkele eenheid van Bitcoin te verwijzen. Een satoshi, die gelijk is aan 1 / 100.000.000 van een Bitcoin, is de kleinste waarde-eenheid in Bitcoin.

Wat zijn runen?

Terwijl Ordinals draait om het maken van unieke items, helpt Runes je bij het creëren van tokens op Bitcoin. Hiermee kun je je eigen digitale valuta of puntensysteem opbouwen bovenop Bitcoin. Je kunt regels instellen voor het aantal tokens dat er bestaat, hoe ze worden verdeeld en hoe mensen ze kunnen gebruiken. Door gebruik te maken van Runes kun je innoveren op Bitcoin en tegelijkertijd profiteren van de veiligheid en decentralisatie ervan.

Het werkt door gebruik te maken van de ingebouwde scriptmogelijkheden van Bitcoin via een proces dat „etching“ wordt genoemd. Wanneer je een rune etst, creëer je een speciale Bitcoin-transactie die de fundamentele eigenschappen van de rune definieert, zoals het symbool, de totale voorraad en de decimale precisie. Zodra deze eigenschappen zijn geëtst, worden ze permanent onveranderlijk op de blockchain vastgelegd. Runes gebruiken de Unspent Transaction Outputs (UTXO’s) van Bitcoin als basis, waarbij elke UTXO gegevens kan bevatten over de saldi en overboekingen van de rune.

---

Ordinalen en Runen-API

Rechtstreeks met Bitcoin werken kan lastig zijn, omdat je daarvoor ruwe blockchain-gegevens moet ontleden, satoshi’s in verschillende transacties moet volgen en aangepaste logica moet ontwikkelen voor inscripties of tokens.

Met de Ordinals- en Runes-API van Quicknode kun je eenvoudig via API-aanroepen met Ordinals en Runes werken. Voor ontwikkelaars neemt dit de complexiteit weg die gepaard gaat met het werken met onbewerkte Bitcoin-gegevens, en biedt het tools die de ontwikkeling versnellen en je helpen sneller te bouwen.

Overzicht van mogelijkheden

Blok- en netwerkbeheer:

• Blokinformatie ophalen
• Details van het huidige blok bijhouden

Handelingen met inscripties:

• De inhoud en metagegevens van de inscriptie ophalen
• Zoek inscripties per blok of transactie
• Bekijk de collecties met inscripties
• Recursieve inschrijvingsgegevens ophalen

Satoshi Management:

• Bepaalde satoshi’s en hun locaties bijhouden
• Satoshi-gegevens ophalen bij specifieke indices
• Recursieve Satoshi-informatie ophalen

Runes-bewerkingen:

• Bekijk de details van elke afzonderlijke rune
• Alle runengegevens ophalen

Veelgebruikte methoden

• ord_getInscription: Haal gegevens op over een specifieke inscriptie aan de hand van het ID.
• ord_getInscriptionsByBlock: Haal alle inscripties binnen een blok op.
• ord_getSat: Haal gegevens op over een specifieke satoshi aan de hand van het nummer ervan.
• ord_getRune: Haal gegevens op over een specifieke Rune aan de hand van de ID.

Met deze functies kun je applicaties bouwen die anders moeilijk te realiseren zijn met de standaardmogelijkheden van Bitcoin. In het volgende hoofdstuk bespreken we enkele praktische voorbeelden om je op weg te helpen.

Praktische toepassingsvoorbeelden

1. Een Inscription Explorer bouwen

Doel: Een platform creëren waarop gebruikers inscripties kunnen verkennen en begrijpen.

Belangrijkste methoden:

• ord_getInscriptions - Beschikbare inscriptie-ID's ophalen
• ord_getInscription - Bekijk gedetailleerde informatie over specifieke inscripties
• ord_getContent - De inhoud van de inscriptie ophalen in HTML-formaat

Ideeën voor de uitvoering:

1. Maak een gepagineerde weergave van alle inscripties
2. Gedetailleerde weergave van metagegevens van inscripties inschakelen, waaronder inhoudstype, tijdstempel en satellietgegevens
3. Filter op inhoudstype, blokhoogte of inscriptienummer
4. Toon de relaties tussen inscripties aan de hand van de onderliggende gegevens
5. De inhoud van het opschrift weergeven wanneer dit door het inhoudstype wordt ondersteund

2. Sat-analysetool

Doel: Een tool ontwikkelen voor het analyseren en volgen van specifieke satoshi’s en de bijbehorende inscripties.

Belangrijkste methoden:

• ord_getSat - Bekijk gedetailleerde SAT-informatie, zoals zeldzaamheid, cyclus en tijdperk
• ord_getInscription - Bekijk de details van de inscriptie

Ideeën voor de uitvoering:

1. Toon uitgebreide satellietinformatie, waaronder zeldzaamheid, cyclus en tijdperk
2. Toon alle inscripties die bij een bepaalde satelliet horen
3. Maak visualisaties van de verdeling van satellietgegevens over de blokken
4. Zoeken op satellietnaam of -nummer inschakelen
5. Geef de historische context van de sat weer op basis van de tijdstempel van het blok

3. Blokgebaseerde analyse van inscripties

Doelstelling: De patronen en trends in de inscripties per blok analyseren.

Belangrijkste methoden:

• ord_getInscriptionsByBlock - Inscripties voor specifieke blokken opvragen
• ord_getInscription - Bekijk gedetailleerde informatie over de inscriptie

Ideeën voor de uitvoering:

1. Statistieken genereren over de inscriptiedichtheid per blok
2. Maak visualisaties die de verdeling van de soorten inscripties weergeven
3. Veelvoorkomende patronen in de inhoudstypen van inscripties in kaart brengen
4. Analyseer de tariefstructuren voor inschrijvingen
5. Rapporten genereren over de verdeling van de inschrijvingswaarden

4. Rune-beheerdashboard

Doel: Een gedetailleerd overzicht van de activiteiten en statistieken van de runen samenstellen.

Belangrijkste methoden:

• ord_getRunes - Bekijk de lijst met alle runen en de bijbehorende details
• ord_getRune - Bekijk de details van een specifieke rune

Ideeën voor de uitvoering:

1. Toon alle actieve runen met hun belangrijkste statistieken, zoals aanbod, verbranding en uitgifte
2. Toon de verdeling van de voorraad runen en het aantal verbrande runen
3. De patronen bij het slaan van runen in kaart brengen
4. Maak visualisaties van de runenactiviteit in de loop van de tijd
5. Filteren op runekenmerken (deelbaarheid, voorraad, enz.) inschakelen

5. Visualisatietool voor inscriptierelaties

Doel: Een hulpmiddel ontwikkelen om verbanden tussen inscripties te onderzoeken en in beeld te brengen.

Belangrijkste methoden:

• ord_getChildren - Opschriften van kinderen opvragen
• ord_getInscription - Bekijk de details van de inscriptie

Ideeën voor de uitvoering:

1. Maak een grafische weergave van de relaties tussen ouders en kinderen
2. Hiërarchieën van opschriften bijhouden
3. Patronen in de onderlinge relaties tussen inscripties analyseren
4. Maak het mogelijk om inscriptiefamilies te verkennen
5. Toon verschillen in metagegevens tussen verwante inscripties

6. Collection Explorer en Analytics

Doelstelling: Een platform creëren voor het ontdekken en analyseren van ordinale verzamelingen.

Belangrijkste methoden:

• ord_getCollections - Haal de lijst met collectie-ID's op

Ideeën voor de uitvoering:

1. Maak een collectiebrowser met ondersteuning voor paginering
2. Maak dashboards met collectiestatistieken en analyses
3. Het filteren van collecties op basis van verschillende metagegevenskenmerken inschakelen

Al deze gebruiksscenario’s kunnen worden geïmplementeerd als op zichzelf staande tools of worden gecombineerd tot een uitgebreid platform voor de analyse van Ordinals en Runes. De API biedt uitgebreide gegevens die kunnen worden gebruikt om waardevolle inzichten en tools voor het Ordinals-ecosysteem te creëren.

Bekijk onze verzameling voorbeeldapps om inspiratie op te doen voor je project.

Je omgeving instellen

Om de Ordinals- en Runes-API te kunnen gebruiken, moet je je omgeving instellen. Hiervoor moet je je aanmelden voor een Quicknode-account, je endpoint opvragen en API-verzoeken instellen.

1. Log in op je Quicknode-account
2. Maak een nieuw Bitcoin Mainnet-eindpunt aan als je dat nog niet hebt gedaan
3. Schakel de add-on ‘Ordinals and Runes API ’ in
4. Kopieer de URL van je Bitcoin-eindpunt waarbij de API is ingeschakeld
5. Raadpleeg onze Quicknode API-documentatie voor gedetailleerde beschrijvingen van de methoden en voorbeelden
6. Gebruik een tool zoals Postman of een programmeertaal om API-verzoeken te versturen

Conclusie

De Ordinals- en Runes-API biedt ontwikkelaars nieuwe mogelijkheden om te innoveren op het gebied van Bitcoin. Van marktplaatsen tot monitoringtools: dankzij de mogelijkheden van deze API is een breed scala aan toepassingen mogelijk. Duik in de API-documentatie om meer methoden te ontdekken en het potentieel van Bitcoin-inscripties en Runes in je projecten ten volle te benutten.

Mocht je vragen hebben of hulp nodig hebben, neem dan gerust contact met ons op via Discord of Twitter.

We ❤️ feedback!

Laat het ons weten als je feedback hebt of suggesties voor nieuwe onderwerpen. We horen graag van je.

Bronnen

• Quicknode -bronnen voor Bitcoin -ontwikkelaars
• Quicknode Bitcoin-documentatie
• Add-on voor de Ordinals- en Runes-API