Librerías SDK

TronZap proporciona librerías SDK oficiales para múltiples lenguajes de programación para ayudarte a integrar fácilmente con nuestra API. Estos SDK manejan la autenticación, las llamadas a la API y el manejo de errores, permitiéndote centrarte en construir tu aplicación.

SDK Disponibles

Actualmente ofrecemos SDK para los siguientes lenguajes:

SDK de PHP

bash

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

Ver SDK de PHP en GitHub

SDK de Node.js

Este SDK está diseñado para funcionar en múltiples plataformas JavaScript/TypeScript:

Node.js: v16.0.0 o superior
Bun: v1.0.0 o superior
Deno: v1.0.0 o superior

bash

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

Ver SDK de Node.js en GitHub

SDK de Python

bash

pip install tronzap-sdk

Ver SDK de Python en GitHub

Go SDK

Requisitos: Go 1.21 o superior, sin dependencias de terceros.

bash

go get github.com/tron-energy-market/tronzap-sdk-go

Ver SDK de Go en GitHub

Java SDK

Requisitos: Java 17 o superior.

MavenGradle

xml

<dependency>
    <groupId>com.tronzap</groupId>
    <artifactId>tronzap-java</artifactId>
    <version>1.0.0</version>
</dependency>

kotlin

implementation("com.tronzap:tronzap-java:1.0.0")

Ver SDK de Java en GitHub

.NET (C#) SDK

Requisitos: .NET 8 o superior.

bash

dotnet add package Tronzap.Sdk

Ver SDK de .NET en GitHub

Ruby SDK

Requisitos: Ruby 3.3 o superior.

ruby

# Añade la gema a tu Gemfile
gem "tronzap-sdk"

bash

# o instálala directamente
gem install tronzap-sdk

Ver SDK de Ruby en GitHub

Rust SDK

Requisitos: Rust 1.85 o superior, un runtime de Tokio.

toml

[dependencies]
tronzap-sdk = "1.0"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

Ver SDK de Rust en GitHub

Uso Básico

Todos los SDK proporcionan una interfaz similar para interactuar con la API de TronZap. Aquí hay algunos ejemplos básicos:

php

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

// Inicializar el cliente
$apiToken = 'tu_api_token';
$apiSecret = 'tu_api_secret';
$client = new Client($apiToken, $apiSecret);

try {
    // Obtener servicios disponibles
    $services = $client->getServices();

    // Crear una transacción de energía
    $transaction = $client->createEnergyTransaction(
        'DIRECCIÓN_TRX', // Dirección de la billetera TRON
        65000,           // Cantidad de energía
        1,               // Duración (horas)
        'mi-tx-id',      // ID externo (opcional)
        false            // No activar dirección (opcional)
    );

    // Verificar el estado de la transacción
    $status = $client->checkTransaction($transaction['result']['transaction_id']);

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

javascript

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

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

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

    // Crear una transacción de energía
    const transaction = await client.createEnergyTransaction(
      'DIRECCIÓN_TRX', // Dirección de la billetera TRON
      65000,           // Cantidad de energía
      1,               // Duración (horas)
      'mi-tx-id',      // ID externo (opcional)
      true            // No activar dirección (opcional)
    );
    console.log(transaction);

    // Verificar el estado de la transacción
    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 el cliente
api_token = 'tu_api_token'
api_secret = 'tu_api_secret'
client = TronZapClient(api_token, api_secret)

try:
    # Obtener servicios disponibles
    services = client.get_services()

    # Crear una transacción de energía
    transaction = client.create_energy_transaction(
        address='DIRECCIÓN_TRX',  # Dirección de la billetera TRON
        energy_amount=65000,      # Cantidad de energía
        duration=1,               # Duración (horas)
        external_id='mi-tx-id',   # ID externo (opcional)
        activate_address=False    # No activar dirección (opcional)
    )

    # Verificar el estado de la transacción
    status = client.check_transaction(transaction['result']['transaction_id'])

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

package main

import (
	"context"
	"errors"
	"fmt"
	"log"

	tronzap "github.com/tron-energy-market/tronzap-sdk-go"
)

func main() {
	// Inicializar el cliente
	client := tronzap.NewClient("your_api_token", "your_api_secret")
	ctx := context.Background()

	// Obtener servicios disponibles
	services, err := client.GetServices(ctx)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", services)

	// Crear una transacción de energía
	tx, err := client.CreateEnergyTransaction(ctx, tronzap.EnergyTransactionRequest{
		Address:         "TRX_ADDRESS", // Dirección de la billetera TRON
		Energy:          65000,         // Cantidad de energía
		Duration:        1,             // Duración (horas)
		ExternalID:      "my-tx-id",    // ID externo (opcional)
		ActivateAddress: false,         // No activar dirección (opcional)
	})
	var apiErr *tronzap.APIError
	if errors.As(err, &apiErr) {
		log.Fatalf("Error: %s (Código: %d)", apiErr.Message, apiErr.Code)
	} else if err != nil {
		log.Fatal(err)
	}

	// Verificar el estado de la transacción
	status, err := client.CheckTransaction(ctx, tronzap.CheckTransactionRequest{ID: tx.ID})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(status.Status)
}

java

import com.tronzap.sdk.TronzapClient;
import com.tronzap.sdk.exception.ApiException;
import com.tronzap.sdk.exception.TronzapException;
import com.tronzap.sdk.request.CheckTransactionRequest;
import com.tronzap.sdk.request.EnergyTransactionRequest;
import com.tronzap.sdk.response.Services;
import com.tronzap.sdk.response.Transaction;

public class Example {
    public static void main(String[] args) {
        // Inicializar el cliente
        TronzapClient client = TronzapClient.builder()
                .apiToken("your_api_token")
                .apiSecret("your_api_secret")
                .build();

        try {
            // Obtener servicios disponibles
            Services services = client.getServices();
            System.out.println(services);

            // Crear una transacción de energía
            Transaction tx = client.createEnergyTransaction(
                    EnergyTransactionRequest.builder("TRX_ADDRESS", 65000) // Dirección de la billetera TRON, Cantidad de energía
                            .duration(1)              // Duración (horas)
                            .externalId("my-tx-id")   // ID externo (opcional)
                            .activateAddress(false)   // No activar dirección (opcional)
                            .build());

            // Verificar el estado de la transacción
            Transaction status = client.checkTransaction(CheckTransactionRequest.byId(tx.id()));
            System.out.println(status.status());

        } catch (ApiException e) {
            System.err.println("Error: " + e.getMessage() + " (Código: " + e.getCode() + ")");
        } catch (TronzapException e) {
            System.err.println("Error: " + e.getMessage());
        }
    }
}

csharp

using Tronzap.Sdk;
using Tronzap.Sdk.Exceptions;
using Tronzap.Sdk.Requests;
using Tronzap.Sdk.Responses;

// Inicializar el cliente
var client = new TronzapClient(new TronzapClientOptions
{
    ApiToken = "your_api_token",
    ApiSecret = "your_api_secret",
});

try
{
    // Obtener servicios disponibles
    ServiceRates services = await client.GetServicesAsync();
    Console.WriteLine(services);

    // Crear una transacción de energía
    Transaction tx = await client.CreateEnergyTransactionAsync(new EnergyTransactionRequest
    {
        Address = "TRX_ADDRESS",   // Dirección de la billetera TRON
        Energy = 65000,            // Cantidad de energía
        Duration = 1,              // Duración (horas)
        ExternalId = "my-tx-id",   // ID externo (opcional)
        ActivateAddress = false,   // No activar dirección (opcional)
    });

    // Verificar el estado de la transacción
    Transaction status = await client.CheckTransactionAsync(CheckTransactionRequest.ById(tx.Id));
    Console.WriteLine(status.Status);
}
catch (TronzapApiException e)
{
    Console.Error.WriteLine($"Error: {e.Message} (Código: {e.Code})");
}
catch (TronzapException e)
{
    Console.Error.WriteLine($"Error: {e.Message}");
}

ruby

require "tronzap"

# Inicializar el cliente
client = Tronzap::Client.new(
  api_token: "your_api_token",
  api_secret: "your_api_secret"
)

begin
  # Obtener servicios disponibles
  services = client.get_services
  p services

  # Crear una transacción de energía
  transaction = client.create_energy_transaction(
    address: "TRX_ADDRESS",   # Dirección de la billetera TRON
    energy: 65000,            # Cantidad de energía
    duration: 1,              # Duración (horas)
    external_id: "my-tx-id",  # ID externo (opcional)
    activate_address: false   # No activar dirección (opcional)
  )

  # Verificar el estado de la transacción
  status = client.check_transaction(id: transaction.id)
  puts status.status
rescue Tronzap::ApiError => e
  warn "Error: #{e.message} (Código: #{e.code})"
rescue Tronzap::Error => e
  warn "Error: #{e.message}"
end

rust

use tronzap_sdk::requests::{CheckTransactionRequest, EnergyTransactionRequest};
use tronzap_sdk::{TronzapClient, TronzapError};

async fn run() -> Result<(), TronzapError> {
    // Inicializar el cliente
    let client = TronzapClient::new("your_api_token", "your_api_secret")?;

    // Obtener servicios disponibles
    let services = client.get_services().await?;
    println!("{services:?}");

    // Crear una transacción de energía
    let request = EnergyTransactionRequest::new("TRX_ADDRESS", 65000) // Dirección de la billetera TRON, Cantidad de energía
        .duration(1)                // Duración (horas)
        .external_id("my-tx-id")    // ID externo (opcional)
        .activate_address(false);   // No activar dirección (opcional)
    let tx = client.create_energy_transaction(&request).await?;

    // Verificar el estado de la transacción
    let status = client
        .check_transaction(&CheckTransactionRequest::by_id(tx.id))
        .await?;
    println!("{}", status.status);
    Ok(())
}

#[tokio::main]
async fn main() {
    match run().await {
        Ok(()) => {}
        Err(TronzapError::Api(e)) => {
            eprintln!("Error: {} (Código: {:?})", e.message(), e.code())
        }
        Err(e) => eprintln!("Error: {e}"),
    }
}

Características

Todos nuestros SDK proporcionan las siguientes características:

Autenticación: Generación automática de firmas API para peticiones seguras
Información de Servicios: Obtener servicios disponibles y precios
Transacciones de Energía: Crear transacciones para compra de energía
Ancho de banda y paquetes de recursos: Comprar ancho de banda, o energía y ancho de banda en una sola transacción
Estimación de energía e información de dirección: Estimar la energía para una transferencia USDT y obtener los recursos y saldos de una dirección
Verificaciones AML: Analizar el riesgo de direcciones y transacciones
Activación de Dirección: Crear transacciones para activación de dirección
Estado de Transacción: Comprobar el estado de tus transacciones
Gestión de Cuenta: Obtener información del saldo de la cuenta y uso

Documentación

Para la documentación completa de cada SDK, por favor consulta sus respectivos repositorios de GitHub.

Librerías SDK ​

SDK Disponibles ​

SDK de PHP ​

SDK de Node.js ​

SDK de Python ​

Go SDK ​

Java SDK ​

.NET (C#) SDK ​

Ruby SDK ​

Rust SDK ​

Uso Básico ​

Características ​

Documentación ​

Librerías SDK

SDK Disponibles

SDK de PHP

SDK de Node.js

SDK de Python

Go SDK

Java SDK

.NET (C#) SDK

Ruby SDK

Rust SDK

Uso Básico

Características

Documentación