SDK Bibliotheken

TronZap bietet offizielle SDK Bibliotheken für mehrere Programmiersprachen, um Ihnen bei der einfachen Integration mit unserer API zu helfen. Diese SDKs kümmern sich um Authentifizierung, API-Aufrufe und Fehlerbehandlung, sodass Sie sich auf die Entwicklung Ihrer Anwendung konzentrieren können.

Verfügbare SDKs

Wir bieten derzeit SDKs für die folgenden Sprachen an:

PHP SDK

composer require tron-energy-market/tronzap-sdk-php

PHP SDK auf GitHub ansehen

Node.js SDK

Dieses SDK ist für die Verwendung auf mehreren JavaScript/TypeScript-Plattformen ausgelegt:

• Node.js: v16.0.0 oder höher
• Bun: v1.0.0 oder höher
• Deno: v1.0.0 oder höher

npm install tronzap-sdk
# oder
yarn add tronzap-sdk
# oder
pnpm add tronzap-sdk

Node.js SDK auf GitHub ansehen

Python SDK

pip install tronzap-sdk

Python SDK auf GitHub ansehen

Grundlegende Verwendung

Alle SDKs bieten eine ähnliche Schnittstelle für die Interaktion mit der TronZap API. Hier sind einige grundlegende Beispiele:

PHP

<?php
use TronZap\Client;
use TronZap\Exception\TronZapException;

// Client initialisieren
$apiToken = 'your_api_token';
$apiSecret = 'your_api_secret';
$client = new Client($apiToken, $apiSecret);

try {
    // Verfügbare Services abrufen
    $services = $client->getServices();

    // Energie-Transaktion erstellen
    $transaction = $client->createEnergyTransaction(
        'TRX_ADDRESS', // TRON Wallet-Adresse
        65000,         // Energie-Menge
        1,             // Dauer (Stunden)
        'my-tx-id',    // Externe ID (optional)
        false          // Adresse nicht aktivieren (optional)
    );

    // Transaktionsstatus prüfen
    $status = $client->checkTransaction($transaction['result']['transaction_id']);

} catch (TronZapException $e) {
    echo "Fehler: " . $e->getMessage() . " (Code: " . $e->getCode() . ")\n";
}

Node.js

import { TronZapClient, TronZapError } from 'tronzap-sdk';

// Client initialisieren
const client = new TronZapClient({
  apiToken: 'your_api_token',
  apiSecret: 'your_api_secret'
});

async function main() {
  try {
    // Verfügbare Services abrufen
    const services = await client.getServices();
    console.log(services);

    // Energie-Transaktion erstellen
    const transaction = await client.createEnergyTransaction(
      'TRON_WALLET_ADDRESS',
      65150,
      1,
      'my-tx-id',  // Optionale externe ID
      true        // Optional: Adresse bei Bedarf aktivieren
    );
    console.log(transaction);

    // Transaktionsstatus prüfen
    const status = await client.checkTransaction(transaction.result.transaction_id);
    console.log(status);

  } catch (error) {
    if (error instanceof TronZapError) {
      console.error(`TronZap API Fehler: ${error.message} (Code: ${error.code})`);
    } else {
      // Typprüfung des Fehlers vor Zugriff auf seine Eigenschaften
      if (error instanceof Error) {
        console.error(`Allgemeiner Fehler: ${error.message}`);
      } else {
        console.error('Ein unbekannter Fehler ist aufgetreten:', error);
      }
    }
  }
}

main();

Python

from tronzap_sdk import TronZapClient, TronZapError

# Client initialisieren
api_token = 'your_api_token'
api_secret = 'your_api_secret'
client = TronZapClient(api_token, api_secret)

try:
    # Verfügbare Services abrufen
    services = client.get_services()

    # Energie-Transaktion erstellen
    transaction = client.create_energy_transaction(
        address='TRX_ADDRESS',  # TRON Wallet-Adresse
        energy_amount=65000,    # Energie-Menge
        duration=1,             # Dauer (Stunden)
        external_id='my-tx-id', # Externe ID (optional)
        activate_address=False  # Adresse nicht aktivieren (optional)
    )

    # Transaktionsstatus prüfen
    status = client.check_transaction(transaction['result']['transaction_id'])

except TronZapError as e:
    print(f"Fehler: {e.message} (Code: {e.code})")

Funktionen

Alle unsere SDKs bieten die folgenden Funktionen:

• Authentifizierung: Automatische Generierung von API-Signaturen für sichere Anfragen
• Service-Informationen: Verfügbare Services und Preise abrufen
• Energie-Transaktionen: Transaktionen für Energie-Kauf erstellen
• Adress-Aktivierung: Transaktionen für Adress-Aktivierung erstellen
• Transaktionsstatus: Status Ihrer Transaktionen prüfen
• Kontoverwaltung: Kontostand und Nutzungsinformationen abrufen

Dokumentation

Für vollständige Dokumentation zu jedem SDK besuchen Sie bitte die entsprechenden GitHub-Repositories.