Bibliothèques SDK

TronZap fournit des bibliothèques SDK officielles pour plusieurs langages de programmation pour vous aider à intégrer facilement notre API. Ces SDK gèrent l'authentification, les appels API et la gestion des erreurs, vous permettant de vous concentrer sur la construction de votre application.

SDK Disponibles

Nous proposons actuellement des SDK pour les langages suivants :

SDK PHP

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

Voir le SDK PHP sur GitHub

SDK Node.js

Ce SDK est conçu pour fonctionner sur plusieurs plateformes JavaScript/TypeScript :

• Node.js: v16.0.0 ou supérieur
• Bun: v1.0.0 ou supérieur
• Deno: v1.0.0 ou supérieur

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

Voir le SDK Node.js sur GitHub

SDK Python

pip install tronzap-sdk

Voir le SDK Python sur GitHub

Utilisation de Base

Tous les SDK fournissent une interface similaire pour interagir avec l'API TronZap. Voici quelques exemples de base :

PHP

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

// Initialiser le client
$apiToken = 'votre_token_api';
$apiSecret = 'votre_secret_api';
$client = new Client($apiToken, $apiSecret);

try {
    // Obtenir les services disponibles
    $services = $client->getServices();

    // Créer une transaction d'énergie
    $transaction = $client->createEnergyTransaction(
        'ADRESSE_TRX', // Adresse du portefeuille TRON
        65000,         // Quantité d'énergie
        1,             // Durée (heures)
        'mon-tx-id',   // ID externe (optionnel)
        false          // Ne pas activer l'adresse (optionnel)
    );

    // Vérifier le statut de la transaction
    $status = $client->checkTransaction($transaction['result']['transaction_id']);

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

Node.js

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

// Initialiser le client
const client = new TronZapClient({
  apiToken: 'votre_token_api',
  apiSecret: 'votre_secret_api'
});

async function main() {
  try {
    // Obtenir les services disponibles
    const services = await client.getServices();
    console.log(services);

    // Créer une transaction d'énergie
    const transaction = await client.createEnergyTransaction(
      'ADRESSE_PORTEFEUILLE_TRON',
      65150,
      1,
      'mon-tx-id',  // ID externe optionnel
      true         // Optionnel: activer l'adresse si nécessaire
    );
    console.log(transaction);

    // Vérifier le statut de la transaction
    const status = await client.checkTransaction(transaction.result.transaction_id);
    console.log(status);

  } catch (error) {
    if (error instanceof TronZapError) {
      console.error(`Erreur API TronZap: ${error.message} (Code: ${error.code})`);
    } else {
      // Vérifier le type d'erreur avant d'accéder à ses propriétés
      if (error instanceof Error) {
        console.error(`Erreur générale: ${error.message}`);
      } else {
        console.error('Une erreur inconnue s\'est produite:', error);
      }
    }
  }
}

main();

Python

from tronzap_sdk import TronZapClient, TronZapError

# Initialiser le client
api_token = 'votre_token_api'
api_secret = 'votre_secret_api'
client = TronZapClient(api_token, api_secret)

try:
    # Obtenir les services disponibles
    services = client.get_services()

    # Créer une transaction d'énergie
    transaction = client.create_energy_transaction(
        address='ADRESSE_TRX',  # Adresse du portefeuille TRON
        energy_amount=65000,    # Quantité d'énergie
        duration=1,             # Durée (heures)
        external_id='mon-tx-id', # ID externe (optionnel)
        activate_address=False  # Ne pas activer l'adresse (optionnel)
    )

    # Vérifier le statut de la transaction
    status = client.check_transaction(transaction['result']['transaction_id'])

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

Fonctionnalités

Tous nos SDK fournissent les fonctionnalités suivantes :

• Authentification : Génération automatique de signatures API pour des requêtes sécurisées
• Informations sur les Services : Obtenir les services disponibles et leurs tarifs
• Transactions d'Énergie : Créer des transactions pour l'achat d'énergie
• Activation d'Adresse : Créer des transactions pour l'activation d'adresse
• Statut des Transactions : Vérifier le statut de vos transactions
• Gestion de Compte : Obtenir le solde du compte et les informations d'utilisation

Documentation

Pour la documentation complète sur chaque SDK, veuillez vous référer à leurs dépôts GitHub respectifs.