X Layer RPC
Wat is X Layer?
X Layer is een zero-knowledge rollup (zkRollup) Layer 2-oplossing voor Ethereum, gebaseerd op zkEVM-technologie. Het maakt gebruik van een hybride bewijsaanpak: er worden STARK-bewijzen gegenereerd voor de uitvoering, die vervolgens recursief worden verpakt in een SNARK voor efficiënte verificatie op de blockchain. Dit zorgt ervoor dat transacties wiskundig geldig zijn en tegelijkertijd de beveiliging van Ethereum behouden.
In tegenstelling tot optimistische rollups zijn bij X Layer geen challenge-periodes nodig voor opnames, omdat geldigheidsbewijzen na indiening cryptografische zekerheid bieden. De definitieve afwikkeling hangt af van de intervallen waarmee bewijzen worden ingediend — doorgaans minuten in plaats van dagen — maar verloopt nog steeds sneller dan bij optimistische rollups. De transactiekosten zijn aanzienlijk lager dan op het Ethereum-mainnet, dankzij besparingen door het bundelen van transacties en het comprimeren van calldata.
X Layer biedt compatibiliteit op bytecode-niveau met de Ethereum Virtual Machine (EVM). Deze zkEVM-architectuur ondersteunt vrijwel alle EVM-opcodes en precompiles, met slechts kleine verschillen in uitzonderingsgevallen, zoals gaskosten. Dit zorgt ervoor dat de meeste bestaande Ethereum-smartcontracts en -toepassingen zonder aanpassingen kunnen worden geïmplementeerd, waardoor een brede compatibiliteit met de uitvoeringsomgeving, de tools en het ontwikkelaarsecosysteem van Ethereum behouden blijft, terwijl tegelijkertijd zero-knowledge-beveiligingsgaranties worden geboden.
Interactie met de X-laag
X Layer biedt volledige ondersteuning voor de standaard JSON-RPC-interface van Ethereum en biedt daarnaast extra Layer 2-specifieke functionaliteit. Dit zorgt voor volledige compatibiliteit met bestaande Ethereum-tools, zodat ontwikkelaars X Layer naadloos kunnen gebruiken met tools zoals MetaMask, Hardhat, Foundry en Web3-bibliotheken, zonder dat ze hun code hoeven aan te passen.
Met de X Layer API kun je:
- Voer alle standaard Ethereum JSON-RPC-methoden uit (
eth_call,eth_sendTransaction,eth_getBalance) - Toegang tot X-laag-specifieke methoden voor rollup-bewerkingen (bijvoorbeeld het opvragen van de status van bewijzen en bridge-interacties)
- Informatie opvragen over brugactiviteit, batchverzendingen en de status van de verificatie van bewijzen
- Abonneer je op realtime L2-gebeurtenissen via WebSocket-verbindingen
- Gebruik de beschikbare traceer- en inspectietools voor een grondigere foutopsporing in de blockchain
Je kunt verbinding maken met de API door:
- Een lokaal X Layer-knooppunt beheren
- Gebruikmaken van een gehoste provider, zoals een Quicknode X Layer-eindpunt, dat toegang biedt tot het X Layer-mainnet met een hoge betrouwbaarheid, archiefgegevens en verbeterde prestaties
Ondersteunde netwerken
Quicknode biedt toegang tot de volgende X Layer-netwerken:
XLayer maakt gebruik van een re-genesis bij blok 42,810,021. Historische gegevens van vóór dit blok zijn weliswaar beschikbaar, maar worden op oudere knooppunten opgeslagen en automatisch doorgestuurd wanneer je een specifiek bloknummer opgeeft voor methoden zoals eth_getBlockByNumber, eth_getBalance, en debug_trace*.
Blok 42.810.021 zelf is niet traceerbaar en kan terugkeren {"code":4444,"message":"pruned history unavailable"}.
X Layer maakt gebruik van twee verschillende knooppuntclients, die op de re-genesis-grens (blok 42.810.021) van elkaar zijn gescheiden:
- Blok
42,810,021en eerder — Hiervoor is een cdk-Erigon knooppunt. Geth-knooppunten geven het volgende terugnullvoor deze historische transacties. - Na het blok
42,810,021— Hiervoor is een Geth knooppunt. Erigon-knooppunten geven het volgende terug:nullvoor deze lopende transacties.
Om gegevens van vóór de regeneratie op te vragen, voeg je de x-qn-hoogte header met het nummer van het doelblok in je verzoek, zodat het wordt doorgestuurd naar de cdk-Erigon node. Zonder deze header worden verzoeken standaard doorgestuurd naar de Geth knooppunt, dus de header is niet vereist voor blokken die na de regeneratie zijn aangemaakt.
Voorbeeld van vóór de regeneratie (cdk-Erigon, blok ≤ 42.810.021):
curl --location 'https://docs-demo.xlayer-mainnet.quiknode.pro/' \
--header 'Content-Type: application/json' \
--header 'x-qn-height: 42810020' \
--data '{"method":"eth_getBlockByNumber","params":["0x28D3AA4",false],"id":1,"jsonrpc":"2.0"}'
Voorbeeld na regeneratie (Geth, blok > 42.810.021):
curl --location 'https://docs-demo.xlayer-mainnet.quiknode.pro/' \
--header 'Content-Type: application/json' \
--data '{"method":"eth_getBlockByNumber","params":["0x28D3AA6",false],"id":1,"jsonrpc":"2.0"}'
Uitgebreide handleiding voor ontwikkelaars die met Quicknode op X Layer bouwen:
Snelstart
Ga snel aan de slag met X Layer. Volg onze stapsgewijze snelstartgids om je eindpunt in te stellen en je eerste API-verzoek te doen.
Eindpunten van providers
Ontdek hoe u uw X Layer-eindpunten kunt configureren en beheren voor optimale prestaties en betrouwbaarheid.
Overzicht van de API
Ontdek de ondersteunde API’s, netwerken, Quicknode-producten en verbeterde API-functies waarmee u krachtige applicaties kunt bouwen.
Marktplaats
Ontdek en integreer krachtige add-ons en tools uit de Quicknode Marketplace om je Web3-toepassingen te verbeteren.
Beveiliging van eindpunten
Beveilig uw eindpunten met authenticatie, whitelisting en beproefde beveiligingsmaatregelen.
Foutcodes
Leer meer over veelvoorkomende foutcodes en stappen voor het oplossen van problemen bij X Layer API-verzoeken.