Librerie SDK

TronZap fornisce librerie SDK ufficiali per diversi linguaggi di programmazione per aiutarti a integrarti facilmente con la nostra API. Questi SDK gestiscono l'autenticazione, le chiamate API e la gestione degli errori, permettendoti di concentrarti sulla costruzione della tua applicazione.

SDK Disponibili

Attualmente offriamo SDK per i seguenti linguaggi:

SDK PHP

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

Visualizza SDK PHP su GitHub

SDK Node.js

Questo SDK è progettato per funzionare su diverse piattaforme JavaScript/TypeScript:

• Node.js: v16.0.0 o superiore
• Bun: v1.0.0 o superiore
• Deno: v1.0.0 o superiore

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

Visualizza SDK Node.js su GitHub

SDK Python

pip install tronzap-sdk

Visualizza SDK Python su GitHub

Utilizzo Base

Tutti gli SDK forniscono un'interfaccia simile per interagire con l'API TronZap. Ecco alcuni esempi di base:

PHP

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

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

try {
    // Ottieni i servizi disponibili
    $services = $client->getServices();

    // Crea una transazione energetica
    $transaction = $client->createEnergyTransaction(
        'TRX_ADDRESS', // Indirizzo wallet TRON
        65000,         // Quantità di energia
        1,             // Durata (ore)
        'my-tx-id',    // ID esterno (opzionale)
        false          // Non attivare l'indirizzo (opzionale)
    );

    // Controlla lo stato della transazione
    $status = $client->checkTransaction($transaction['result']['transaction_id']);

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

Node.js

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

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

async function main() {
  try {
    // Ottieni i servizi disponibili
    const services = await client.getServices();
    console.log(services);

    // Crea transazione energetica
    const transaction = await client.createEnergyTransaction(
      'TRON_WALLET_ADDRESS',
      65150,
      1,
      'my-tx-id',  // ID esterno opzionale
      true        // Opzionale: attiva indirizzo se necessario
    );
    console.log(transaction);

    // Controlla lo stato della transazione
    const status = await client.checkTransaction(transaction.result.transaction_id);
    console.log(status);

  } catch (error) {
    if (error instanceof TronZapError) {
      console.error(`Errore API TronZap: ${error.message} (Codice: ${error.code})`);
    } else {
      // Controlla il tipo di errore prima di accedere alle sue proprietà
      if (error instanceof Error) {
        console.error(`Errore generale: ${error.message}`);
      } else {
        console.error('Si è verificato un errore sconosciuto:', error);
      }
    }
  }
}

main();

Python

from tronzap_sdk import TronZapClient, TronZapError

# Inizializza il client
api_token = 'your_api_token'
api_secret = 'your_api_secret'
client = TronZapClient(api_token, api_secret)

try:
    # Ottieni i servizi disponibili
    services = client.get_services()

    # Crea una transazione energetica
    transaction = client.create_energy_transaction(
        address='TRX_ADDRESS',  # Indirizzo wallet TRON
        energy_amount=65000,    # Quantità di energia
        duration=1,             # Durata (ore)
        external_id='my-tx-id', # ID esterno (opzionale)
        activate_address=False  # Non attivare l'indirizzo (opzionale)
    )

    # Controlla lo stato della transazione
    status = client.check_transaction(transaction['result']['transaction_id'])

except TronZapError as e:
    print(f"Errore: {e.message} (Codice: {e.code})")

Caratteristiche

Tutti i nostri SDK forniscono le seguenti caratteristiche:

• Autenticazione: Generazione automatica di firme API per richieste sicure
• Informazioni sui Servizi: Ottieni servizi disponibili e prezzi
• Transazioni Energetiche: Crea transazioni per l'acquisto di energia
• Attivazione Indirizzo: Crea transazioni per l'attivazione dell'indirizzo
• Stato Transazione: Controlla lo stato delle tue transazioni
• Gestione Account: Ottieni saldo dell'account e informazioni sull'utilizzo

Documentazione

Per la documentazione completa su ogni SDK, consulta i rispettivi repository GitHub.