Bibliotecas SDK

TronZap fornece bibliotecas SDK oficiais para várias linguagens de programação para ajudar você a integrar facilmente com nossa API. Essas SDKs lidam com autenticação, chamadas de API e tratamento de erros, permitindo que você se concentre na construção de sua aplicação.

SDKs Disponíveis

Atualmente oferecemos SDKs para as seguintes linguagens:

SDK PHP

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

Ver SDK PHP no GitHub

SDK Node.js

Este SDK foi desenvolvido para funcionar em várias plataformas JavaScript/TypeScript:

• Node.js: v16.0.0 ou superior
• Bun: v1.0.0 ou superior
• Deno: v1.0.0 ou superior

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

Ver SDK Node.js no GitHub

SDK Python

pip install tronzap-sdk

Ver SDK Python no GitHub

Uso Básico

Todas as SDKs fornecem uma interface similar para interagir com a API TronZap. Aqui estão alguns exemplos básicos:

PHP

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

// Inicializar o cliente
$apiToken = 'seu_api_token';
$apiSecret = 'seu_api_secret';
$client = new Client($apiToken, $apiSecret);

try {
    // Obter serviços disponíveis
    $services = $client->getServices();

    // Criar uma transação de energia
    $transaction = $client->createEnergyTransaction(
        'ENDEREÇO_TRX', // Endereço da carteira TRON
        32000,          // Quantidade de energia
        1,              // Duração (horas)
        'minha-tx-id',  // ID externo (opcional)
        false           // Não ativar endereço (opcional)
    );

    // Verificar status da transação
    $status = $client->checkTransaction($transaction['result']['transaction_id']);

} catch (TronZapException $e) {
    echo "Erro: " . $e->getMessage() . " (Código: " . $e->getCode() . ")\n";
}

Node.js

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

// Inicializar o cliente
const client = new TronZapClient({
  apiToken: 'your_api_token',
  apiSecret: 'your_api_secret'
});

async function main() {
  try {
    // Obter serviços disponíveis
    const services = await client.getServices();
    console.log(services);

    // Criar uma transação de energia
    const transaction = await client.createEnergyTransaction(
      'ENDEREÇO_TRX', // Endereço da carteira TRON
      32000,          // Quantidade de energia
      1,              // Duração (horas)
      'minha-tx-id',  // ID externo (opcional)
      true           // Não ativar endereço (opcional)
    );
    console.log(transaction);

    // Verificar status da transação
    const status = await client.checkTransaction(transaction.result.transaction_id);
    console.log(status);

  } catch (error) {
    if (error instanceof TronZapError) {
      console.error(`TronZap API Error: ${error.message} (Code: ${error.code})`);
    } else {
      // Type check the error before accessing its properties
      if (error instanceof Error) {
        console.error(`General error: ${error.message}`);
      } else {
        console.error('An unknown error occurred:', error);
      }
    }
  }
}

main();

Python

from tronzap_sdk import TronZapClient, TronZapError

# Inicializar o cliente
api_token = 'seu_api_token'
api_secret = 'seu_api_secret'
client = TronZapClient(api_token, api_secret)

try:
    # Obter serviços disponíveis
    services = client.get_services()

    # Criar uma transação de energia
    transaction = client.create_energy_transaction(
        address='ENDEREÇO_TRX',    # Endereço da carteira TRON
        energy_amount=32000,       # Quantidade de energia
        duration=1,                # Duração (horas)
        external_id='minha-tx-id', # ID externo (opcional)
        activate_address=False     # Não ativar endereço (opcional)
    )

    # Verificar status da transação
    status = client.check_transaction(transaction['result']['transaction_id'])

except TronZapError as e:
    print(f"Erro: {e.message} (Código: {e.code})")

Funcionalidades

Todas as nossas SDKs fornecem as seguintes funcionalidades:

• Autenticação: Geração automática de assinaturas de API para requisições seguras
• Informações de Serviços: Obter serviços disponíveis e preços
• Transações de Energia: Criar transações para compra de energia
• Ativação de Endereço: Criar transações para ativação de endereço
• Status de Transação: Verificar o status das suas transações
• Gerenciamento de Conta: Obter informações de saldo e uso da conta

Documentação

Para documentação completa sobre cada SDK, consulte seus respectivos repositórios no GitHub.