Avalanche RPC Endpoint mit ERPC - Dokumentation
Avalanche RPC Endpoint Dokumentation
Nutzen Sie ERPC als Ihren Avalanche RPC Endpoint für HTTP JSON-RPC-Anfragen und WebSocket-Abonnements. Avalanche RPC ist Teil der RPC APIs von ERPC innerhalb unserer Global Edge Blockchain Infrastructure, und der API key kann über das ERPC Web Dashboard verwaltet werden.
Sie können denselben RPC key wie bei Solana und Ethereum verwenden.
Bitte fügen Sie Ihren API key zum Parameter 'api-key' hinzu.
Endpoints
Senden Sie JSON-RPC 2.0-Anfragen als HTTP POST an:
text
https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>Für Abonnements verbinden Sie sich per WebSocket mit:
text
wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>Die Upstream-API wird anhand des exakten JSON-RPC-Methodennamens ausgewählt, sodass C-Chain-, X-Chain- und P-Chain-Aufrufe alle an denselben Endpoint gehen.
Beispiele
Hier ist ein Beispiel für eine HTTP-Anfrage.
bash
curl https://edge.erpc.global/ava?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl https://edge.erpc.global/ava?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'Hier ist ein Beispiel für ein WebSocket-Abonnement.
bash
wscat -c "wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>"
# After connected, send:
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}wscat -c "wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>"
# After connected, send:
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}Sie können Ihren API key im ERPC Web Dashboard abrufen und prüfen: ERPC Web Dashboard
Batch-Anfragen
JSON-RPC-Batches mit bis zu 256 Aufrufen pro HTTP-Anfrage werden für C-Chain-EVM-Methoden unterstützt, und JSON-RPC-Benachrichtigungen werden ebenfalls akzeptiert. Die nativen Avalanche-Namensräume —
avax.*, avm.*, platform.*, proposervm.* und info.upgrades — werden einzeln aufgerufen. Jeder Aufruf in einem Batch wird als eigener Aufruf gemessen.Token-Nutzung
Die Nutzung wird in Token zu einem Flatrate-Satz pro JSON-RPC-Aufruf gemessen – derselbe Satz für jede Avalanche RPC-Methode. Jeder Eintrag in einem HTTP-Batch und jeder JSON-RPC-Aufruf über eine WebSocket-Verbindung wird separat gemessen. Den aktuellen Token-Satz pro Aufruf finden Sie in der Avalanche RPC API-Referenz.
Unterstützte Methoden
Der Endpoint deckt die C-Chain-EVM-JSON-RPC-Methodenfamilien ab –
eth_*, net_*, txpool_* und web3_* – einschließlich Konto- und Block-Lesevorgängen (eth_getBalance, eth_getBlockByNumber, eth_getLogs), Transaktionsablauf (eth_sendRawTransaction, eth_getTransactionReceipt), Gebührendaten (eth_gasPrice, eth_maxPriorityFeePerGas), Call-Simulation (eth_call, eth_estimateGas), Filtern (eth_newFilter, eth_getFilterChanges), Txpool-Inspektion (txpool_status, txpool_content), den C-Chain-Erweiterungen (eth_getAssetBalance, eth_baseFee) und WebSocket-Abonnements (eth_subscribe, eth_unsubscribe).Die nativen Avalanche-APIs werden vom selben Endpoint bereitgestellt: atomare C-Chain-Operationen (
avax.getAtomicTx, avax.getUTXOs, avax.issueTx), die X-Chain (avm.getBalance, avm.getTx, avm.issueTx), die P-Chain (platform.getCurrentValidators, platform.getStake, platform.getHeight, platform.issueTx, proposervm.getProposedHeight) und Netzwerk-Upgrade-Zeitpunkte (info.upgrades).Die vollständige Methodenliste mit Request- und Response-Strukturen finden Sie in der Avalanche RPC API-Referenz.
Antwort-Statuscodes
| HTTP-Status | Bedeutung |
|---|---|
| 200 | Upstream JSON-RPC-Antwort. |
| 400 | Fehlender API key oder ungültige JSON-RPC-Anfrage. |
| 401 | Nicht autorisierter API key. |
| 429 | Rate-limitiert. Der retry-after-Header gibt die Wartezeit in Sekunden an. |
| 502 | Die Upstream-RPC-Anfrage konnte nicht abgeschlossen werden. |
| 503 | Der Dienst ist vorübergehend nicht verfügbar. |
Eine JSON-RPC-Methode außerhalb des veröffentlichten Katalogs wird mit HTTP
400 und JSON-RPC-Fehler -32601 (Method not found) beantwortet, und ein Batch mit mehr als 256 Aufrufen wird mit HTTP 400 beantwortet.WebSocket-Verbindungen verwenden zusätzlich zu den obigen Codes
101 (Protokoll-Upgrade akzeptiert) und 426 (ein WebSocket-Upgrade-Handshake ist erforderlich).Avalanche RPC Methoden und Dokumentation
Die vollständige Liste der Standardmethoden, Parameter und Abonnement-Spezifikationen finden Sie in der offiziellen Dokumentation. Sie deckt sowohl HTTP- als auch WebSocket-Nutzung ab.
- C-Chain (EVM JSON-RPC): https://build.avax.network/docs/rpcs/c-chain
- X-Chain (
avm.*): https://build.avax.network/docs/rpcs/x-chain - P-Chain (
platform.*): https://build.avax.network/docs/rpcs/p-chain