Zum Inhalt springen

Ethereum- und Tron-Adressen per API erstellen

Eine Adresse erstellen Sie mit einer einzigen Anfrage: POST /api/v2/{chain}/addresses. Enthält der Body ein password, speichert Chaingateway den Private Key verschlüsselt, und die Antwort gibt nur die Adresse zurück. Ohne Passwort enthält die Antwort den Private Key. Dieses Tutorial zeigt beide Varianten für Ethereum und Tron. Dieselben Anfragen funktionieren für BNB Smart Chain, Polygon und Arbitrum.

Für die folgenden Aufrufe benötigen Sie einen API-Token. Wie Sie ihn erstellen, erklärt der Schnellstart.

Adresse erstellen: POST-Anfrage an /addresses mit oder ohne Passwort, die Antwort enthält die Adresse und ohne Passwort zusätzlich den Private Key POST /api/v2/{chain}/addresses Authorization: Bearer token Mit Passwort Key wird verschlüsselt gespeichert, Antwort:Adresse Ohne Passwort Antwort: Adresse und Private Key, Siespeichern den Key
Das Passwort entscheidet, wer den Private Key hält.

Wie erstelle ich eine passwortgeschützte Adresse?

Abschnitt betitelt „Wie erstelle ich eine passwortgeschützte Adresse?“

Senden Sie das Feld password im JSON-Body. Für EVM-Chains erstellt Chaingateway einen Keystore. Das ist ein verschlüsseltes Dateiformat für einen Private Key, beschrieben in der Web3-Secret-Storage-Definition. Der Keystore wird mit Ihrem Passwort verschlüsselt. Wer nur den Keystore oder nur das Passwort besitzt, kann nicht auf die Adresse zugreifen. Ihre Transaktionen benötigen das Passwort statt des Private Keys.

Das password wählen Sie selbst. Chaingateway speichert es nicht und kann es nicht wiederherstellen. Geht das Passwort verloren, verlieren Sie den Zugriff auf die Adresse. Bewahren Sie es deshalb in einem Passwortmanager oder einem Secrets-Store auf.

Terminal-Fenster
curl --request POST \
--url https://app.chaingateway.io/api/v2/ethereum/addresses \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data '{"password":"choose-a-strong-password"}'

Die Antwort hat den Status 201. Die OpenAPI-Datei schreibt den Schlüssel der Adresse adderess:

{
"status": 201,
"ok": true,
"message": "Address created",
"data": {
"adderess": "0x7d3bC832A0860fD882FF4C2359e10268f4E5CCf8"
}
}

Lassen Sie password weg. Die Antwort enthält dann den Private Key, und jede Transaktion von dieser Adresse braucht den Key in einem Feld privatekey. Nutzen Sie diesen Modus nur für Einmal-Adressen, denn ein Private Key, der in jeder Anfrage mitgesendet wird, lässt sich leicht abgreifen. Das Beispiel erstellt eine Tron-Adresse.

Terminal-Fenster
curl --request POST \
--url https://app.chaingateway.io/api/v2/tron/addresses \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN'

Eine Tron-Adresse, die ohne Passwort erstellt wird, liefert das Schlüsselmaterial direkt zurück:

{
"status": 201,
"ok": true,
"message": "Address created",
"data": {
"privateKey": "59f1c6200e01a2ca9471411f10198bfa63678d0e87cc2ca30f9c4a68dee78edc",
"publicKey": "040fe6e677442c36f7fdd5535ba3ff1cef0110d78363420f7e24b65298990e3467aed68b9a67e1396d84753db25b32a2fa3e1fc0a673f01638e9bcfab2d8f4ceb5",
"hexAddress": "41a56a6505ffbee78eb916dd44f4846874deddaebd",
"address": "TR3qx91smURF3R455V1ubqtoUsZbgqikfg"
}
}

Speichern Sie den privateKey zusammen mit der address an einem sicheren Ort. Der Key in diesem Beispiel ist ein Beispielwert, laden Sie ihn also nie mit Guthaben auf. Wie die base58-Adresse und die Hex-Adresse zusammenhängen, erklärt die Tron-Kontodokumentation.

Lesen Sie das Guthaben, laden Sie die Adresse auf und senden Sie dann von ihr. GET /api/v2/ethereum/balances/{address} gibt das Guthaben der Adresse als String zurück:

{
"status": 200,
"ok": true,
"message": "Balance fetched",
"data": "0.000000000000000000"
}

Eine neue Adresse beginnt mit dem Guthaben null. Senden Sie Coins von einem Wallet, das Sie kontrollieren. Arbeiten Sie mit X-Network: testnet, nutzen Sie stattdessen den Testnet-Faucet der Chain. GET /api/v2/ethereum/addresses listet jede Adresse auf, die Sie erstellt und nicht gelöscht haben. Wenn Sie eine Benachrichtigung erhalten möchten, sobald Guthaben eintrifft, erstellen Sie einen Webhook für die Adresse. Wie Sie Guthaben von der Adresse senden, behandelt Transaktionen erstellen.

Bei Bitcoin und Solana läuft es anders. Bei Bitcoin erstellen Sie zuerst mit POST /api/v2/bitcoin/wallets ein Wallet und fügen ihm dann Adressen hinzu. Bei Solana erstellt POST /api/v2/solana/addresses die Adresse. Wallet-Verwaltung beschreibt beides.

Welche Fehler kann die Adresserstellung zurückgeben?

Abschnitt betitelt „Welche Fehler kann die Adresserstellung zurückgeben?“

Adress-Aufrufe nutzen den Standard-Envelope, bei einem Fehler steht ok auf false. Ein fehlender oder ungültiger Token liefert den Status 401 mit {"message":"Unauthenticated."}. Ein Body, der die Validierung nicht besteht, liefert den Status 422 mit Data validation failed und den Feldnamen in errors. Ist das Adresslimit Ihres Tarifs ausgeschöpft, antwortet die API mit dem Status 422 und Your address limit exceeded. Please upgrade your plan. Die OpenAPI-Datei zeigt diese Meldung für Bitcoin-Wallets.

DELETE /api/v2/ethereum/addresses/{address} entfernt eine Adresse und verringert die Zahl der Adressen, die auf Ihren Tarif angerechnet werden. Löschen Sie Adressen, die Sie nicht mehr brauchen. Exportieren Sie vorher aber den Private Key, falls auf der Adresse noch Guthaben liegen kann.

Wie sind Adressen auf den einzelnen Chains aufgebaut?

Abschnitt betitelt „Wie sind Adressen auf den einzelnen Chains aufgebaut?“

Ethereum und die anderen EVM-Chains verwenden 20-Byte-Adressen, die als 40 Hex-Zeichen mit dem Präfix 0x geschrieben werden. Die Ethereum-Dokumentation zu Accounts beschreibt, wie ein Externally Owned Account aus einem Schlüsselpaar abgeleitet wird. Tron-Adressen beginnen mit T und haben 34 Zeichen. Dieses Format prüft die API mit dem Muster T[a-zA-Z0-9]{33}. Die TRON-Kontodokumentation ist die Primärquelle für dieses Format.