Passwortgeschützte Tron-Wallets per API erstellen
Tron-Wallets mit Passwort anlegen, damit die API nie den privaten Schlüssel zurückgibt. So erstellen, senden, exportieren und ändern Sie geschützte Adressen.
Geprüft von Maurice Sobiera
Eine passwortgeschützte Tron-Wallet ist eine Adresse, die Sie über die Chaingateway-API mit dem Parameter password anlegen. Der private Schlüssel wird mit diesem Passwort verschlüsselt und nicht in der Antwort zurückgegeben. Um von der Adresse zu senden, übergeben Sie das Passwort statt des Schlüssels. Chaingateway speichert das Passwort nicht. Ein verlorenes Passwort lässt sich deshalb nicht wiederherstellen.
Was hat sich mit passwortgeschützten Wallets geändert?
Bis zum 18. Februar 2025 gab die API bei Tron-Adressen den privaten Schlüssel in der Antwort zurück.
Das passt zu temporären Adressen.
Der Schlüssel landet dabei aber in Ihren Logs, Ihrer Datenbank und in jedem System, das die Antwort verarbeitet. Passwortgeschützte Wallets sind die Alternative. Die Dokumentation zur Wallet-Verwaltung nennt sie die empfohlene Methode. Sie beschreibt den Schlüssel als verschlüsselt mit Ihrem Passwort und mit den eigenen Verschlüsselungsmechanismen von Chaingateway. Die unsichere Variante gibt es weiterhin. Lassen Sie password weg, erhalten Sie den privaten Schlüssel direkt und müssen ihn selbst speichern.
Wie erstellt man eine passwortgeschützte Tron-Wallet?
Senden Sie eine POST-Anfrage an /api/v2/tron/addresses mit einem password:
curl --request POST \ --url https://app.chaingateway.io/api/v2/tron/addresses \ --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "password": "your_secure_password" }'Die Antwort enthält die neue Adresse in data. Den privaten Schlüssel enthält sie nicht. Verwenden Sie ein langes, zufälliges Passwort aus einem Passwort-Manager. Das OWASP-Spickzettel zur Authentifizierung nennt Passwörter unter 15 Zeichen schwach, wenn kein zweiter Faktor sie schützt. Ein Wallet-Passwort hat keinen zweiten Faktor. Bewahren Sie es in Ihrem Secrets-Speicher auf, denn für jede spätere Anfrage an diese Adresse brauchen Sie dasselbe Passwort.
Wie sendet man von einer passwortgeschützten Wallet?
Übergeben Sie das Feld password statt privatekey. Ein TRX-Transfer braucht from, to, amount und password:
curl --request POST \ --url https://app.chaingateway.io/api/v2/tron/transactions \ --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "from": "TSenderAddress", "to": "TDestinationAddress", "amount": 100, "password": "your_secure_password"}'Dasselbe Feld password funktioniert bei POST /api/v2/tron/transactions/trc20, .../trc721 und .../trc10. TRC20-Transfers brauchen außerdem eine contractaddress. Ein TRC20-Transfer von einer Adresse ohne TRX oder gestakte Energy scheitert mit Status 422. Das erklärt das Tutorial zu TronFuel und Paymaster. Der Chaingateway Paymaster ist veraltet. Für die Gebühren empfehlen wir TronFuel.
Wie exportiert man den Schlüssel, ändert das Passwort oder importiert einen Schlüssel?
Drei weitere Endpunkte vervollständigen den Lebenszyklus der Wallet. Jeder nimmt die Adresse im Pfad entgegen:
| Aufgabe | Anfrage | Body |
|---|---|---|
| Privaten Schlüssel exportieren | POST /api/v2/tron/addresses/export/{address} | password |
| Passwort ändern | POST /api/v2/tron/addresses/{address} | old_password, new_password |
| Vorhandenen Schlüssel importieren | POST /api/v2/tron/addresses/import | address, privatekey, password |
Mit dem Import verschieben Sie eine bestehende, ungeschützte Adresse unter Passwortschutz. Nach dem Import senden Sie von der Adresse mit dem Passwort und übergeben den Schlüssel nicht mehr. Löschen Sie den Schlüssel aus Ihrem eigenen Speicher, sobald Sie einen Testtransfer im Testnetz geprüft haben. Der Export ist der Notausgang. Er erlaubt Ihnen, den Dienst mit Ihrem Schlüssel zu verlassen, und er braucht das Passwort.
Was leistet der Passwortschutz nicht?
Ein Tron-Konto wird durch seinen privaten Schlüssel kontrolliert, wie die Tron-Dokumentation festhält. Deshalb schützen Sie den Schlüssel.
Das Passwort schützt den Schlüssel im ruhenden Zustand.
Es schützt nicht vor einem kompromittierten Server, der das Passwort bereits kennt. Auch ein verlorenes Passwort hilft es nicht. Laut der Dokumentation kann Chaingateway eine Wallet mit verlorenem Passwort nicht wiederherstellen. Sichern Sie das Passwort und testen Sie den Export einmal, bevor Sie echtes Geld bewegen. Halten Sie große Guthaben in einer Wallet, deren Schlüssel Sie selbst besitzen. Nutzen Sie die API-Wallets als Hot-Wallets mit begrenztem Guthaben.
Bevor Sie echtes Geld bewegen, gehen Sie diese Checkliste durch:
- Legen Sie eine Wallet im Testnetz an und senden Sie einen kleinen Transfer mit dem Passwort.
- Exportieren Sie den privaten Schlüssel einmal und prüfen Sie, dass er zur Adresse passt.
- Ändern Sie das Passwort. Prüfen Sie, dass ein Versand mit dem alten Passwort scheitert und einer mit dem neuen funktioniert.
- Speichern Sie das Passwort in Ihrem Secrets-Manager und entfernen Sie es aus dem Shell-Verlauf und den Logs.
Nutzen Sie zuerst das Testnetz. Fügen Sie jeder der obigen Anfragen den Header X-Network: testnet hinzu, legen Sie eine Wallet auf Nile an und durchlaufen Sie Erstellen, Senden, Exportieren und Passwortänderung. Die Seite unterstützte Netzwerke listet die Testnetze. Die Dokumentation zu den Tron-Netzwerken erklärt Nile und Shasta.
Welche Fragen kommen am häufigsten vor?
Funktioniert eine Passwort-Wallet auch auf anderen Chains?
Ja. Die Dokumentation zur Wallet-Verwaltung beschreibt den Parameter password für /api/v2/{blockchain}/addresses. Die OpenAPI-Datei listet Adress-Endpunkte mit demselben Muster für Ethereum, BNB Smart Chain, Polygon und Arbitrum.
Kann Chaingateway ein verlorenes Passwort zurücksetzen?
Nein. Laut der Dokumentation kann Chaingateway den privaten Schlüssel einer Wallet mit verlorenem Passwort nicht wiederherstellen. Exportieren Sie den Schlüssel deshalb einmal und speichern Sie ihn in Ihrem eigenen Tresor.
Brauchen Webhooks das Wallet-Passwort?
Nein. Ein Webhook überwacht eine Adresse und braucht nur die Adresse, eine URL und einen Filter. Das Passwort brauchen Sie zum Signieren von Transaktionen, zum Exportieren des Schlüssels und zum Ändern des Passworts.
Kann ich passwortgeschützte und ungeschützte Wallets mischen?
Ja. Jede Adresse wird entweder mit oder ohne Passwort angelegt. In einer Anfrage senden Sie entweder password oder privatekey. Das beschreibt die OpenAPI-Datei für die Transaktions-Endpunkte.
Möchten Sie das selbst umsetzen? API-Key erhalten — 7 Tage kostenlos testen, keine Karte nötig — oder werfen Sie einen Blick auf Tron-API für die vollständige Endpoint-Referenz.