ERC-20-Adressen über EVM-Chains hinweg

ERC20-Adresse: Format, balanceOf und Erstellung per API

Eine ERC20-Adresse ist die 42 Zeichen lange Kontoadresse mit Präfix 0x, die Ethereum für jede Wallet verwendet. Sie wird zur ERC-20-Adresse, wenn das Konto Token nach dem ERC-20-Standard hält. Derselbe String funktioniert auf Polygon und Arbitrum, weil beide EVM-kompatibel sind, doch Token und Guthaben gelten jeweils nur für eine Chain.

7 Tage kostenlos testen — keine Karte, kein KYC nötig Non-custodial — Private Keys bleiben unter Ihrer Kontrolle Pläne ab 49 €/Monat (490 €/Jahr) — Pläne und Rate Limits ansehen

Ein ERC-20-Guthaben liefert der Aufruf von balanceOf(address) am Token-Contract. Über REST gibt GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} denselben Wert bereits dekodiert zurück. Um Token zu empfangen, geben Sie die Adresse weiter. Um sie zu senden, brauchen Sie den zugehörigen Key und etwas ETH für das Gas.

Diese Seite behandelt das Adressformat, balanceOf, dieselbe Adresse auf Polygon und Arbitrum und das Erstellen von Adressen per REST.

Was ist der ERC-20-Standard?

ERC-20 ist die Standardschnittstelle für fungible Token auf Ethereum. EIP-20 definiert sechs Funktionen: totalSupply, balanceOf, transfer, transferFrom, approve und allowance, dazu die Events Transfer und Approval. Jeder Contract, der sie implementiert, ist ein konformes Token. Wallets und Börsen können ein neues Token daher ohne Sonderarbeit je Token unterstützen.

Die ERC-20-Übersicht von ethereum.org führt dieselbe Schnittstelle mit Beispielen vor. Die ganze Mechanik steht in unserem Artikel zum ERC20-Token-Standard. Diese Seite bleibt bei der Adresse: was eine ERC-20-Adresse ist und wie Sie im Code damit arbeiten.

Wie sieht eine ERC-20-Adresse aus?

Eine ERC-20-Adresse ist die gewöhnliche Ethereum-Adresse, zum Beispiel 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed. Sie besteht aus 0x und 40 hexadezimalen Zeichen, insgesamt also 42 Zeichen. Die Konten-Dokumentation von ethereum.org beschreibt sie als die letzten 20 Byte des Keccak-256-Hashes des Public Keys des Kontos.

Der Name taucht nur im Zusammenhang auf. Eine Adresse wird zur „ERC-20-Adresse“, wenn es um die Token geht, die sie hält. Dem String sieht man nicht an, ob er Token halten kann. Dieselbe Adresse funktioniert für ETH, für jedes ERC-20-Token und für NFTs.

0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed 1 2 3
  1. Das Präfix 0x kennzeichnet den Wert als hexadezimal.
  2. Die 40 Hexadezimalzeichen sind 20 Byte: die letzten 20 Byte des Keccak-256-Hashes des Public Keys.
  3. Insgesamt 42 Zeichen. Die Mischung aus Groß- und Kleinbuchstaben ist die EIP-55-Prüfsumme.
Aufbau einer EVM-Adresse. Ethereum, Polygon und Arbitrum verwenden dasselbe Layout.

Wie liest balanceOf ein ERC-20-Guthaben aus?

balanceOf(address) ist die schreibgeschützte Funktion, die das Token-Guthaben einer Adresse zurückgibt. Das Guthaben liegt nicht in der Adresse. Es steht im Smart Contract des Tokens, in einer nach Adresse geordneten Zuordnung, und balanceOf schlägt es dort nach.

Wer die Funktion direkt aufruft, muss einen JSON-RPC-Aufruf eth_call an den Token-Contract kodieren und das zurückgegebene Hex dekodieren. Das Ergebnis ist eine Ganzzahl in der kleinsten Einheit des Tokens, daher müssen Sie auch decimals() lesen. Viele Stablecoins nutzen 6 Dezimalstellen, andere 18. Ein Fehler an dieser Stelle ist eine häufige Quelle für Bugs um den Faktor eine Million.

Die Chaingateway-API übernimmt Kodierung und Dezimalstellen für Sie. Die Balance-Endpoints liefern einfache Zahlen, aus einem Raw-RPC-Problem wird so eine normale REST-Antwort.

Gilt dieselbe ERC-20-Adresse auf Polygon und Arbitrum?

Ja. Polygon und Arbitrum sind EVM-kompatibel, ihre Adressen haben daher exakt das 0x-Format. Eine Adresse, die aus demselben Private Key abgeleitet wird, ist auf Ethereum, Polygon und Arbitrum derselbe String.

Die Token an dieser Adresse sind dagegen nicht gemeinsam. Ein Token-Contract, der auf Ethereum liegt, existiert auf Polygon erst, wenn jemand ihn dort deployt oder das Asset überbrückt. Guthaben sind also chain-spezifisch, auch wenn die Adresse es nicht ist. Token auf Polygon folgen derselben ERC-20-Schnittstelle, deshalb kann ein Codepfad alle drei Chains bedienen.

ERC-721 und ERC-721A: anderer Standard, gleiches Adressformat

ERC-721 ist der Standard für nicht fungible Token auf Ethereum. Jede Token-ID ist einzigartig, anders als die austauschbaren Guthaben bei ERC-20. EIP-721 legt die Schnittstelle fest.

ERC-721A ist eine gasoptimierte Implementierung derselben Schnittstelle, beliebt bei Kollektionen, die im Batch geprägt werden. Sie ändert, wie der Contract Daten intern speichert, nicht, wie die Adresse eines Inhabers aussieht. Beide Standards nutzen dieselbe 0x-Adresse für den Besitz. Die NFT-Seite behandelt der Artikel zum ERC721-Token-Standard ausführlich.

ERC-20-Adressen per REST erstellen und lesen

Sechs Routen decken den Adresslebenszyklus einer Zahlungsintegration ab.

EndpointWas er tut
POST /api/v2/ethereum/addressesNeue Ethereum-Adresse generieren
POST /api/v2/ethereum/addresses/importPrivate Key importieren, damit die API für diese Adresse signieren kann
GET /api/v2/ethereum/balances/{address}/erc20/{contract_address}Guthaben eines ERC-20-Tokens, bereits dekodiert
GET /api/v2/ethereum/balances/{address}/erc20Alle Token-Guthaben der Wallet
POST /api/v2/ethereum/webhooksWebhook für ERC-20-Deposits auf die Adresse registrieren
POST /api/v2/ethereum/transactions/erc20Ein ERC-20-Token von der Adresse senden

Dieselbe Anfrageform gilt mit /polygon/ oder /arbitrum/ statt /ethereum/ im Pfad, denn alle drei Chains teilen Adressformat und ERC-20-Schnittstelle.

ERC-20-Guthaben ohne eth_call lesen

Die Contract-Adresse unten ist USDT auf dem Ethereum-Mainnet. Fügen Sie X-Network: testnet hinzu, um stattdessen ein Testnet-Token abzufragen.

cURL
curl https://app.chaingateway.io/api/v2/ethereum/balances/0xYourAddress/erc20/0xdAC17F958D2ee523a2206206994597C13D831ec7 \
  -H "Authorization: Bearer YOUR_API_KEY"

Wie validiere ich eine ERC-20-Adresse vor dem Senden?

Gleichen Sie den String zuerst mit ^0x[a-fA-F0-9]{40}$ ab, das weist falsche Längen und Fremdzeichen ab. Mischt die Adresse Groß- und Kleinbuchstaben, prüfen Sie zusätzlich die EIP-55-Prüfsumme. Schon ein falscher Buchstabe lässt sie scheitern.

Eine Formatprüfung sagt nicht, welches Netzwerk der Empfänger erwartet, weil dieselbe Adresse auf jeder EVM-Chain gültig ist. Erfragen Sie das Netzwerk ausdrücklich. Akzeptieren Sie nie die Adresse eines Token-Contracts als Ziel. Der Adress-Validator führt die Format- und Prüfsummenprüfung für eine einzelne Adresse im Browser aus.

Sie wollen ERC-20-Guthaben ohne balanceOf-Aufrufe von Hand zu dekodieren? Erstellen Sie ein kostenloses Konto und fragen Sie eine Testnet-Adresse per REST ab. 7 Tage kostenlos testen, keine Karte, kein KYC.

FAQ: ERC-20-Adressen

Das Adressformat mit Präfix 0x und 42 Zeichen, das Ethereum für jedes Konto nutzt, ob es ERC-20-Token hält oder nicht. Im Zusammenhang spricht man von einer ERC-20-Adresse, wenn es gezielt um die Token geht, die sie hält.

Eine Reihe von Funktionen, darunter transfer, approve und balanceOf, die jeder Contract für fungible Token auf Ethereum implementiert. Wallets und Börsen können dadurch neue Token ohne eigenen Code je Token unterstützen.

balanceOf(address) ist eine schreibgeschützte Funktion, die jeder ERC-20-Contract bereitstellt. Direkt aufgerufen, bedeutet sie einen eth_call an den Token-Contract und das Dekodieren der Hex-Antwort. Die Chaingateway-API gibt das dekodierte Guthaben direkt zurück.

Polygon ist eine Blockchain und kein Token. Sie ist aber EVM-kompatibel, deshalb implementieren Token darauf dieselbe ERC-20-Schnittstelle wie Ethereum-Token, und eine Polygon-Adresse hat exakt das 0x-Format.

Eine gasoptimierte Implementierung des NFT-Standards ERC-721, verbreitet bei Kollektionen, die im Batch geprägt werden. Sie ändert die interne Speicherung des Contracts, nicht das Adressformat. Der Besitz löst sich weiterhin zu einer normalen 0x-Adresse auf.

Bereit, auf Ethereum, Polygon oder Arbitrum zu bauen?

Erstellen Sie ein Konto und fragen Sie ein ERC-20-Guthaben im Testnet ab. 7 Tage kostenlos testen, keine Karte, kein KYC. Die vollständige Referenz steht in der Doku zur Ethereum-API. Alle sieben Chains deckt die Multi-Chain-Blockchain-API ab.

Geprüft von Maurice Sobiera So entstehen diese Seiten