SDK库

TronZap为多种编程语言提供官方SDK库，帮助您轻松集成我们的API。这些SDK处理身份验证、API调用和错误处理，让您专注于构建应用程序。

可用SDK

我们目前为以下语言提供SDK：

PHP SDK

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

在GitHub上查看PHP SDK

Node.js SDK

此SDK设计用于跨多个JavaScript/TypeScript平台：

• Node.js: v16.0.0或更高版本
• Bun: v1.0.0或更高版本
• Deno: v1.0.0或更高版本

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

在GitHub上查看Node.js SDK

Python SDK

pip install tronzap-sdk

在GitHub上查看Python SDK

基本用法

所有SDK都提供了与TronZap API交互的相似接口。以下是一些基本示例：

PHP

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

// 初始化客户端
$apiToken = 'your_api_token';
$apiSecret = 'your_api_secret';
$client = new Client($apiToken, $apiSecret);

try {
    // 获取可用服务
    $services = $client->getServices();

    // 创建能量交易
    $transaction = $client->createEnergyTransaction(
        'TRX_ADDRESS', // 波场钱包地址
        65000,         // 能量数量
        1,             // 持续时间（小时）
        'my-tx-id',    // 外部ID（可选）
        false          // 不激活地址（可选）
    );

    // 检查交易状态
    $status = $client->checkTransaction($transaction['result']['transaction_id']);

} catch (TronZapException $e) {
    echo "错误: " . $e->getMessage() . " (代码: " . $e->getCode() . ")\n";
}

Node.js

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

// 初始化客户端
const client = new TronZapClient({
  apiToken: 'your_api_token',
  apiSecret: 'your_api_secret'
});

async function main() {
  try {
    // 获取可用服务
    const services = await client.getServices();
    console.log(services);

    // 创建能量交易
    const transaction = await client.createEnergyTransaction(
      'TRON_WALLET_ADDRESS',
      65150,
      1,
      'my-tx-id',  // 可选外部ID
      true        // 可选：如需要则激活地址
    );
    console.log(transaction);

    // 检查交易状态
    const status = await client.checkTransaction(transaction.result.transaction_id);
    console.log(status);

  } catch (error) {
    if (error instanceof TronZapError) {
      console.error(`TronZap API错误: ${error.message} (代码: ${error.code})`);
    } else {
      // 在访问其属性之前对错误进行类型检查
      if (error instanceof Error) {
        console.error(`一般错误: ${error.message}`);
      } else {
        console.error('发生未知错误:', error);
      }
    }
  }
}

main();

Python

from tronzap_sdk import TronZapClient, TronZapError

# 初始化客户端
api_token = 'your_api_token'
api_secret = 'your_api_secret'
client = TronZapClient(api_token, api_secret)

try:
    # 获取可用服务
    services = client.get_services()

    # 创建能量交易
    transaction = client.create_energy_transaction(
        address='TRX_ADDRESS',  # 波场钱包地址
        energy_amount=65000,    # 能量数量
        duration=1,             # 持续时间（小时）
        external_id='my-tx-id', # 外部ID（可选）
        activate_address=False  # 不激活地址（可选）
    )

    # 检查交易状态
    status = client.check_transaction(transaction['result']['transaction_id'])

except TronZapError as e:
    print(f"错误: {e.message} (代码: {e.code})")

功能特性

我们的所有SDK都提供以下功能：

• 身份验证：自动生成API签名以确保请求安全
• 服务信息：获取可用服务和定价
• 能量交易：创建能量购买交易
• 地址激活：创建地址激活交易
• 交易状态：检查您的交易状态
• 账户管理：获取账户余额和使用信息

文档

有关每个SDK的完整文档，请参考其各自的GitHub仓库。