dart_web3_tron

A full-featured TRON extension for the Dart Web3 ecosystem. Effortlessly interact with the TVM (Tron Virtual Machine), manage Bandwidth/Energy, and perform high-speed asset transfers.

🚀 Features

• TVM Primitives: Base58Check addressing and Protobuf-based transaction modeling.
• Resource Management: Logic for Freezing/Unfreezing TRX to gain Bandwidth and Energy.
• TRC-20 Support: Specialized wrappers for USDT and other popular tokens on TRON.
• Multi-Sig & Permissions: Advanced support for TRON's multi-signature and account permission systems.

Usage Flow

sequenceDiagram
    participant U as User
    participant C as TronClient
    participant R as Resource Hub
    participant P as ProtoBuilder
    participant N as Tron Node
    U->>C: transfer(TRC20)
    C->>R: check Energy balance
    R-->>C: sufficient
    C->>P: encode function call
    P-->>C: transaction protobuf
    C->>C: sign with Base58 key
    C->>N: broadcastTransaction
    N-->>U: Confirmed!

🏗️ Architecture

graph TD
    App[Dart App] --> TronClient[Tron Client]
    TronClient --> FullNode[Full Node RPC]
    TronClient --> Solidity[Solidity Node]
    
    subgraph Resource [Economic Model]
        BW[Bandwidth]
        EN[Energy]
    end
    
    TronClient --> Resource

📚 Technical Reference

Core Classes

🛡️ Security Considerations

• Burn vs Stake: If an account has zero Energy, TRX will be burned for transaction fees. Always verify resource availability in the UI before execution.
• Base58 Integrity: TRON addresses use a leading T. Ensure proper validation to prevent sending TRX to Ethereum addresses by mistake.
• Contract Expiration: TRON transaction expiration is relative. The SDK automatically sets optimal values based on the latest block height.

💻 Usage

Transferring USDT (TRC-20)

import 'package:dart_web3_tron/dart_web3_tron.dart';

void main() async {
  final tron = TronClient(apiKey: '...');
  final usdt = Trc20Contract(address: 'TR7NHq...', client: tron);

  final hash = await usdt.transfer(
    to: 'ReceiverTAddress...',
    amount: BigInt.from(10000000), // 10.0 USDT
    signer: myTronSigner,
  );
  
  print('Tron Tx Hash: $hash');
}

📦 Installation

dependencies:
  dart_web3_tron: ^0.1.0