ETH-, BNB-, TRX- und BTC-Transaktionen senden
Um einen nativen Coin mit Chaingateway zu senden, schicken Sie Absender, Empfänger, Betrag und ein Signaturgeheimnis per POST /api/v2/{chain}/transactions. Chaingateway signiert die Transaktion, überträgt sie ins Netzwerk und gibt die Transaktions-ID (txid) zurück. Das Signaturgeheimnis ist das Wallet-password bei passwortgeschützten Adressen oder der privatekey bei Adressen ohne Passwort. Das Tutorial behandelt ETH, BNB, MATIC, TRX, BTC und SOL.
Token wie USDT nutzen andere Endpunkte, die Token-Transaktionen erstellen beschreibt. Sie benötigen einen API-Token und eine aufgeladene Adresse, siehe Schnellstart und Adressen erstellen.
Wie sende ich ETH, BNB oder MATIC?
Abschnitt betitelt „Wie sende ich ETH, BNB oder MATIC?“Nutzen Sie den Endpunkt der Chain: /ethereum, /bsc, /polygon oder /arbitrum. Der Body für die EVM-Chains hat drei Pflichtfelder und ein Signaturgeheimnis.
| Feld | Pflicht | Bedeutung |
|---|---|---|
from | ja | Absenderadresse, geprüft als 40 Hex-Zeichen mit optionalem 0x. |
to | ja | Empfängeradresse, gleiches Format. |
amount | ja | Der zu sendende Betrag. |
password | eines von beiden | Wallet-Passwort. Pflicht, wenn privatekey fehlt. |
privatekey | eines von beiden | Private Key des Absenders, für Adressen ohne Passwort. |
gas, gasprice, maxPriorityFeePerGas, maxFeePerGas, nonce, data | nein | Optionale Transaktionseinstellungen. |
Senden Sie zuerst einen kleinen Betrag im Testnet, mit dem Header X-Network: testnet, und vergleichen Sie die Änderung des Guthabens, bevor Sie echtes Guthaben bewegen. Die Einheit von amount richtet sich nach der API-Referenz des Endpunkts, prüfen Sie sie dort. Der Authorization-Header enthält Ihren Token: Authorization: Bearer YOUR_API_TOKEN.
curl --request POST \ --url https://app.chaingateway.io/api/v2/ethereum/transactions \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --data '{ "from": "0xYourSenderAddress", "to": "0xRecipientAddress", "amount": "0.1", "password": "YourPassword"}'import requests
url = "https://app.chaingateway.io/api/v2/ethereum/transactions"payload = { "from": "0xYourSenderAddress", "to": "0xRecipientAddress", "amount": "0.1", "password": "YourPassword"}headers = { 'Accept': 'application/json', 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_API_TOKEN'}
response = requests.post(url, json=payload, headers=headers)print(response.json())const axios = require('axios');
const url = 'https://app.chaingateway.io/api/v2/ethereum/transactions';const payload = { from: '0xYourSenderAddress', to: '0xRecipientAddress', amount: '0.1', password: 'YourPassword'};const headers = { 'Accept': 'application/json', 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_API_TOKEN'};
axios.post(url, payload, { headers }) .then(response => { console.log(response.data); }) .catch(error => { console.error(error.response?.data ?? error); });<?phprequire 'vendor/autoload.php';
use GuzzleHttp\Client;
$client = new Client();$response = $client->post('https://app.chaingateway.io/api/v2/ethereum/transactions', [ 'headers' => [ 'Accept' => 'application/json', 'Authorization' => 'Bearer YOUR_API_TOKEN', ], 'json' => [ 'from' => '0xYourSenderAddress', 'to' => '0xRecipientAddress', 'amount' => '0.1', 'password' => 'YourPassword' ]]);
echo $response->getBody();Ein erfolgreicher Aufruf antwortet mit dem Status 201 und dem Transaktions-Hash:
{ "status": 201, "ok": true, "message": "Succesfully created transaction", "data": { "txid": "0x73344d178812d4919e9002c560781f288030edf72ece88823ef1c377dfb71f27" }}Wie sende ich TRX?
Abschnitt betitelt „Wie sende ich TRX?“POST /api/v2/tron/transactions erwartet from, to und amount sowie password oder privatekey. Tron-Adressen müssen dem Muster T gefolgt von 33 alphanumerischen Zeichen entsprechen. Der Absender braucht genug TRX für den Betrag und für die Netzwerkressourcen, die der Transfer verbraucht, wie das Ressourcenmodell von TRON beschreibt.
curl --request POST \ --url https://app.chaingateway.io/api/v2/tron/transactions \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --data '{ "from": "YourSenderAddress", "to": "RecipientAddress", "amount": 1, "privatekey": "YourPrivateKey"}'Die Antwort hat dieselbe Form wie die EVM-Antwort oben, der Transaktions-Hash steht in data.txid. Wenn Sie Transaktionen in Ihrem eigenen Code signieren, liefert POST /api/v2/tron/transactions/build eine unsignierte Transaktion. POST /api/v2/tron/transactions/broadcast nimmt die signierte Transaktion im Feld signed_transaction entgegen.
Wie sende ich BTC?
Abschnitt betitelt „Wie sende ich BTC?“Bitcoin sendet von einem Wallet, nicht von einer einzelnen Adresse. POST /api/v2/bitcoin/transactions verlangt to, amount, walletname, password und speed. Die speed ist fast, medium oder slow und legt die Gebührenstufe fest. Das optionale Feld subtractfee zieht die Gebühr vom Betrag ab, statt sie obendrauf zu rechnen.
curl --request POST \ --url https://app.chaingateway.io/api/v2/bitcoin/transactions \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --data '{ "to": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq", "amount": 0.0001, "walletname": "mywallet", "password": "YourWalletPassword", "speed": "medium", "subtractfee": false}'Bitcoin-Adressen werden gegen das Muster (bc1|tb1|[13]) gefolgt von 25 bis 39 Zeichen geprüft, das Mainnet- und Testnet-Formate akzeptiert. Der Bitcoin Developer Guide zu Transaktionen erklärt Inputs, Outputs und Gebühren.
Wie sende ich SOL?
Abschnitt betitelt „Wie sende ich SOL?“POST /api/v2/solana/transactions erwartet from, to, amount und den privatekey des Absenders. Die OpenAPI-Datei führt alle vier als Pflichtfelder auf und kennt für Solana keinen Passwort-Modus. SPL-Token nutzen POST /api/v2/solana/transactions/SPL mit dem zusätzlichen Feld contractaddress, das die Mint-Adresse des Tokens enthält.
Wie setze ich Gas und Gebühren auf EVM-Chains?
Abschnitt betitelt „Wie setze ich Gas und Gebühren auf EVM-Chains?“Das müssen Sie nicht, denn gas, gasprice, maxPriorityFeePerGas und maxFeePerGas sind optional. Wenn Sie sie selbst setzen möchten, lesen Sie den aktuellen Preis mit GET /api/v2/ethereum/gasprice. Der Aufruf gibt in data einen Wert wie {"gasPrice":"12.28"} zurück. Die beiden max-Felder entsprechen den Gebührenparametern von EIP-1559. Die Ethereum-Dokumentation zu Transaktionen listet alle Transaktionsfelder auf, auch nonce.
Wie prüfe ich, ob die Transaktion durchgegangen ist?
Abschnitt betitelt „Wie prüfe ich, ob die Transaktion durchgegangen ist?“Nutzen Sie die txid aus der Antwort. GET /api/v2/ethereum/transactions/{txid} gibt die Transaktion zurück, und GET /api/v2/ethereum/transactions/{txid}/decoded gibt sie mit dekodierten Input-Daten zurück. Ein Transaktions-Hash, den der Node nicht kennt, beantwortet die API mit dem Status 422 und der Meldung transaction not found. Um benachrichtigt zu werden, wenn Guthaben eintrifft, erstellen Sie einen Webhook, statt abzufragen.
Welche Fehler kann ich erwarten?
Abschnitt betitelt „Welche Fehler kann ich erwarten?“Fehler nutzen denselben Envelope wie erfolgreiche Aufrufe, mit ok auf false.
| Status | Meldung | Ursache |
|---|---|---|
| 401 | Wrong password provided | Das password passt nicht zur Adresse. |
| 422 | insufficient funds for gas * price + value: ... | Das Guthaben deckt Betrag plus Gebühr nicht ab. |
| 422 | Data validation failed | Ein Feld fehlt oder hat das falsche Format. Das Objekt errors nennt es. |
| 422 | Error: The wallet passphrase entered was incorrect. | Bitcoin: Das Wallet-password ist falsch. |
Wichtige Informationen
Abschnitt betitelt „Wichtige Informationen“Chaingateway speichert weder Ihre Passwörter noch die Private Keys von ungesicherten Adressen. Gehen sie verloren, kann niemand das Guthaben auf der Adresse wiederherstellen. Bewahren Sie beides in einem Secrets-Store auf, niemals in Client-Code.