API Reference

Complete reference of the public classes and methods of PHP Tron.

All classes live under the ItHealer\Tron namespace. Monetary values are returned as Brick\Math\BigDecimal (cast to string with (string) or ->__toString()). Amounts you pass in may be string, int, float or BigDecimal — strings are recommended for precision.

• Tron — main facade
• Wallet
• Address
• Crypto\Mnemonic
• Crypto\Encryption
• Storage\WalletStore
• Storage\Database
• Webhook\WebhookSender
• Webhook\DepositMonitor
• Api\TRC20Contract
• Transfer iterators
• DTOs
• Enums
• Exceptions

---

Tron — main facade

ItHealer\Tron\Tron — the single entry point to the library.

Construction

public static function make(
    ?string $apiKey = null,
    string $baseUri = 'https://api.trongrid.io',
    ?string $proxy = null
): Tron

Creates a client configured for TronGrid (or any compatible node).

• $apiKey — TronGrid API key, sent as the TRON-PRO-API-KEY header. Optional but recommended.
• $baseUri — node base URL (use https://api.shasta.trongrid.io for the testnet).
• $proxy — optional proxy, e.g. socks5://user:pass@host:1080.
• Returns Tron.

public function __construct(Api $api)

Low-level constructor that accepts a fully configured Api instance.

Mnemonics

public function mnemonicGenerate(int $wordCount = 15): array

Generate a new mnemonic. $wordCount ∈ {12, 15, 18, 21, 24}. Returns string[] (the words).

public function mnemonicValidate(string|array $mnemonic): bool

Validate a mnemonic against the BIP39 word list and checksum. Returns bool.

public function mnemonicToSeed(string|array $mnemonic, ?string $passphrase = null): string

Derive the binary seed. Returns the seed as a hex string.

Wallets

public function createWallet(string $name, ?string $passphrase = null, int $mnemonicSize = 15): Wallet

Generate a brand new wallet (a fresh mnemonic is created and the primary address at index 0 is derived). Returns Wallet.

public function importWallet(string $name, string|array $mnemonic, ?string $passphrase = null): Wallet

Restore a wallet from an existing mnemonic. Throws TronException if the mnemonic is invalid. Returns Wallet.

Addresses

public function createAddress(Wallet $wallet, ?string $title = null, ?int $index = null): Address

Derive the next address (or a specific $index) and append it to the wallet. Returns Address.

public function deriveAddress(Wallet $wallet, ?string $title = null, int $index = 0): Address

Derive an address at $index without modifying the wallet. Returns Address.

public function importAddress(string $address, ?string $title = null): Address

Build a watch-only Address (no private key, cannot sign). Returns Address.

public function validateAddress(string|Address $address): bool

Validate an address against the node. Returns bool.

Account, balance & resources

public function getAccount(string|Address $address): AccountDTO

Fetch full account information. Returns AccountDTO.

public function getResources(string|Address $address): AccountResourcesDTO

Fetch bandwidth and energy. Returns AccountResourcesDTO.

public function getBalance(string|Address $address): BigDecimal

TRX balance (in TRX, not SUN). Returns BigDecimal.

TRC-20 tokens

public function getTRC20Contract(string $contractAddress): TRC20Contract

Returns a TRC20Contract helper.

public function getTRC20Balance(string|Address $address, string $contractAddress): BigDecimal

Token balance of an address (already scaled by the token's decimals). Returns BigDecimal.

TRX transfers

public function transferPreview(string|Address $from, string|Address $to, BigDecimal|float|int|string $amount): TransferPreviewDTO

Estimate fees / resulting balance without broadcasting. Returns TransferPreviewDTO.

public function transfer(Address $from, string|Address $to, BigDecimal|float|int|string $amount): TransferSendDTO

Sign and broadcast. $from must be a spendable Address. Throws TronException on failure. Returns TransferSendDTO.

public function transferAll(Address $from, string|Address $to): TransferSendDTO

Send the whole balance minus network fees. Returns TransferSendDTO.

TRC-20 transfers

public function transferTRC20Preview(string $contractAddress, string|Address $from, string|Address $to, BigDecimal|float|int|string $amount, BigDecimal|float|int|string $feeLimit = 30): TRC20TransferPreviewDTO

Returns TRC20TransferPreviewDTO.

public function transferTRC20(string $contractAddress, Address $from, string|Address $to, BigDecimal|float|int|string $amount, BigDecimal|float|int|string $feeLimit = 30): TRC20TransferSendDTO

Sign and broadcast a token transfer. Returns TRC20TransferSendDTO.

public function transferTRC20All(string $contractAddress, Address $from, string|Address $to, BigDecimal|float|int|string $feeLimit = 30): TRC20TransferSendDTO

Send the entire token balance. Returns TRC20TransferSendDTO.

History

public function getTransfers(string|Address $address): Transfers

Returns a Transfers iterator of TRX transfers.

public function getTRC20Transfers(string|Address $address): TRC20Transfers

Returns a TRC20Transfers iterator.

public function getTransactionInfo(string $txid): TransactionInfoDTO

Returns TransactionInfoDTO.

public function getTransfer(string $txid): ?TransferDTO

Returns TransferDTO or null.

Constants

• Tron::DERIVATION_PATH — "m/44'/195'/0'/0" (Tron mainnet BIP44 path).

---

Wallet

ItHealer\Tron\Wallet\Wallet — a value object: a mnemonic/seed pair plus its derived addresses. No I/O of its own.

Properties

• public string $name
• public readonly ?string $mnemonic
• public readonly ?string $seed — hex
• public readonly ?string $passphrase

Methods

public function addAddress(Address $address): void
public function getAddresses(): array          // Address[]
public function getPrimaryAddress(): ?Address   // index 0
public function findAddress(string $address): ?Address
public function maxIndex(): ?int                // highest derivation index used
public function toArray(): array
public static function fromArray(array $data): Wallet

---

Address

ItHealer\Tron\Wallet\Address — a single Tron address.

Properties

• public readonly string $address — base58
• public readonly ?string $privateKey — hex, null for watch-only
• public readonly ?int $index — derivation index
• public ?string $title
• public readonly bool $watchOnly

Methods

public function isSpendable(): bool   // false for watch-only / no key
public function toArray(): array
public static function fromArray(array $data): Address
public function __toString(): string  // returns the address

---

Crypto\Mnemonic

ItHealer\Tron\Crypto\Mnemonic — static BIP39 helpers (also exposed via the Tron facade).

public static function generate(int $wordCount = 15): array      // string[]
public static function validate(string|array $mnemonic): bool
public static function toSeed(string|array $mnemonic, ?string $passphrase = null): string  // hex

---

Crypto\Encryption

ItHealer\Tron\Crypto\Encryption — password-based AES-256-GCM (PBKDF2-derived key).

public static function encrypt(string $plaintext, string $password): string  // base64 (salt+iv+tag+ciphertext)
public static function decrypt(string $payload, string $password): string     // throws TronException on wrong password

---

Storage\WalletStore

ItHealer\Tron\Storage\WalletStore — file-based wallet storage with optional encryption and portable backups.

public function __construct(string $directory, ?string $password = null)

When $password is set, every wallet file is encrypted with AES-256-GCM.

public function save(Wallet $wallet): string   // returns the file path
public function exists(string $name): bool
public function load(string $name): Wallet      // throws TronException if missing / wrong password
public function names(): array                  // string[]
public function all(): array                    // Wallet[]
public function delete(string $name): void
public function backup(Wallet|array $wallets, string $file, string $password): void  // always encrypted
public function restore(string $file, string $password): array                        // Wallet[]

---

Storage\Database

ItHealer\Tron\Storage\Database — thin SQLite (PDO) wrapper used by the deposit monitor. Requires the pdo_sqlite extension. Creates the file and tables automatically.

public function __construct(string $path)   // ':memory:' is supported
public function pdo(): \PDO

---

Webhook\WebhookSender

ItHealer\Tron\Webhook\WebhookSender — delivers signed JSON webhooks over HTTP POST.

public function __construct(string $url, ?string $secret = null, int $timeoutMs = 10000)

public function isConfigured(): bool

// Compute the X-Tron-Signature header value: "sha256=<hmac>"
public static function signature(string $body, string $secret): string

// Send a payload. Returns ['ok' => bool, 'code' => int, 'error' => ?string].
public function send(array $payload): array

---

Webhook\DepositMonitor

ItHealer\Tron\Webhook\DepositMonitor — watches addresses for new incoming TRX / TRC-20 transactions and dispatches webhooks. State lives in SQLite.

public function __construct(Tron $tron, Database $db, ?WebhookSender $sender = null, array $options = [])

$options:

• limit (int, default 30) — recent transfers scanned per address per tick.
• watch_trx (bool, default true).
• watch_trc20 (bool, default true).

Methods

public function watch(string $address, ?string $label = null): void  // idempotent
public function unwatch(string $address): void
public function watched(): array          // array of rows: id, address, label, watch_from, created_at
public function deposits(int $limit = 50): array  // recent deposits, newest first
public function poll(): array             // one tick; returns newly detected deposit rows
public function run(int $intervalSeconds = 30, ?int $maxTicks = null, ?callable $onDeposit = null): void

A deposit row contains: id, address, txid, asset, contract, amount, from_address, block_time, detected_at, webhook_status, webhook_code, webhook_attempts. See docs/WEBHOOKS.md for the full guide.

---

Api\TRC20Contract

ItHealer\Tron\Api\TRC20Contract — obtained via Tron::getTRC20Contract().

public readonly string $address;

public function name(): string
public function symbol(): string
public function decimals(): int
public function balanceOf(string $address): BigDecimal

---

Transfer iterators

Both implement Iterator and page through results automatically. All builder methods return $this (chainable). Cap the number of items you read with a break in your loop.

Transfers (TRX) — ItHealer\Tron\Api\Methods\Transfers

public function onlyConfirmation(?Confirmation $confirmed): static
public function onlyDirection(?Direction $direction): static
public function limit(int $limit): static            // 1..200, page size
public function orderBy(?OrderBy $orderBy): static
public function minTimestamp(?int $minTimestamp): static   // ms
public function maxTimestamp(?int $maxTimestamp): static   // ms
public function searchInterval(bool $searchInterval): static

Iterating yields TransferDTO items.

TRC20Transfers — ItHealer\Tron\Api\Methods\TRC20Transfers

public function onlyConfirmation(?Confirmation $confirmed): static
public function limit(int $limit): static
public function fingerprint(?string $fingerprint): static
public function orderBy(?OrderBy $orderBy): static
public function minTimestamp(?int $minTimestamp): static
public function maxTimestamp(?int $maxTimestamp): static
public function contractAddress(?string $contractAddress): static  // filter by token

Iterating yields TRC20TransferDTO items.

Note: TRC20Transfers does not expose onlyDirection(). Filter incoming transfers by comparing $transfer->to to the watched address.

---

DTOs

All DTOs are immutable, expose toArray(), and live under ItHealer\Tron\Api\DTO.

AccountDTO

• string $address
• array $data — raw node response
• bool $activated
• ?BigDecimal $balance — TRX
• ?DateTimeImmutable $createTime
• ?DateTimeImmutable $lastOperationTime

AccountResourcesDTO

• string $address, array $data, bool $activated
• ?int $bandwidthTotal, ?int $bandwidthUsed, ?int $bandwidthAvailable
• ?int $energyTotal, ?int $energyUsed, ?int $energyAvailable

TransferPreviewDTO

• ?string $error (use hasError(): bool)
• ?AccountDTO $from, ?AccountResourcesDTO $fromResources, ?AccountDTO $to
• ?BigDecimal $balanceBefore, ?BigDecimal $balanceAfter, ?BigDecimal $activateFee
• ?array $transaction
• ?int $bandwidthRequired, ?int $bandwidthBefore, ?int $bandwidthAfter, ?BigDecimal $bandwidthFee

TransferSendDTO

• string $txid
• TransferPreviewDTO $preview

TRC20TransferPreviewDTO

• ?string $error (use hasError(): bool)
• ?AccountDTO $from, ?AccountResourcesDTO $fromResources, ?AccountDTO $to
• ?BigDecimal $balanceBefore, ?BigDecimal $balanceAfter
• ?BigDecimal $tokenBefore, ?BigDecimal $tokenAfter
• ?bool $activated
• ?int $energyRequired, ?int $energyBefore, ?int $energyAfter, ?int $energyInsufficient, ?BigDecimal $energyFee
• ?int $bandwidthRequired, ?int $bandwidthBefore, ?int $bandwidthAfter, ?int $bandwidthInsufficient, ?BigDecimal $bandwidthFee
• ?array $transaction

TRC20TransferSendDTO

• string $txid
• TRC20TransferPreviewDTO $preview

TransferDTO

• array $data, string $txid
• ?DateTimeImmutable $time
• bool $success, ?int $blockNumber
• string $from, string $to, BigDecimal $value

TRC20TransferDTO

• array $data, string $txid, DateTimeImmutable $time
• string $from, string $to
• string $contractAddress, string $contractName, string $contractSymbol
• BigDecimal $value

TransactionInfoDTO

• array $data, string $txid, int $blockNumber, DateTimeImmutable $blockTime
• ?bool $success, ?int $bandwidth, ?int $energy, ?BigDecimal $fee

---

Enums

Namespace ItHealer\Tron\Api\Enums.

• Direction — Direction::FROM ('from'), Direction::TO ('to').
• Confirmation — Confirmation::CONFIRMED, Confirmation::UNCONFIRMED.
• OrderBy — OrderBy::ASC ('asc'), OrderBy::DESC ('desc').

---

Exceptions

ItHealer\Tron\Exceptions\TronException extends \Exception. It is thrown for invalid input, failed previews/transfers, decryption failures, HTTP errors and storage problems. Wrap calls that touch the network or untrusted input in try/catch.

Справочник API

Полный справочник публичных классов и методов PHP Tron.

Все классы находятся в пространстве имён ItHealer\Tron. Денежные значения возвращаются как Brick\Math\BigDecimal (приводите к строке через (string) или ->__toString()). Передавать суммы можно как string, int, float или BigDecimal — для точности рекомендуются строки.

• Tron — главный фасад
• Wallet
• Address
• Crypto\Mnemonic
• Crypto\Encryption
• Storage\WalletStore
• Storage\Database
• Webhook\WebhookSender
• Webhook\DepositMonitor
• Api\TRC20Contract
• Итераторы переводов
• DTO
• Перечисления (Enums)
• Исключения

---

Tron — главный фасад

ItHealer\Tron\Tron — единственная точка входа в библиотеку.

Создание

public static function make(
    ?string $apiKey = null,
    string $baseUri = 'https://api.trongrid.io',
    ?string $proxy = null
): Tron

Создаёт клиент для TronGrid (или совместимой ноды).

• $apiKey — API-ключ TronGrid, отправляется как заголовок TRON-PRO-API-KEY. Необязателен, но рекомендуется.
• $baseUri — базовый URL ноды (для тестовой сети — https://api.shasta.trongrid.io).
• $proxy — необязательный прокси, напр. socks5://user:pass@host:1080.
• Возвращает Tron.

public function __construct(Api $api)

Низкоуровневый конструктор, принимающий полностью настроенный экземпляр Api.

Мнемоники

public function mnemonicGenerate(int $wordCount = 15): array

Сгенерировать мнемонику. $wordCount ∈ {12, 15, 18, 21, 24}. Возвращает string[] (слова).

public function mnemonicValidate(string|array $mnemonic): bool

Проверить мнемонику по словарю BIP39 и контрольной сумме. Возвращает bool.

public function mnemonicToSeed(string|array $mnemonic, ?string $passphrase = null): string

Получить бинарный seed. Возвращает seed в виде hex-string.

Кошельки

public function createWallet(string $name, ?string $passphrase = null, int $mnemonicSize = 15): Wallet

Создать новый кошелёк (генерируется свежая мнемоника, выводится первичный адрес с индексом 0). Возвращает Wallet.

public function importWallet(string $name, string|array $mnemonic, ?string $passphrase = null): Wallet

Восстановить кошелёк из существующей мнемоники. Бросает TronException, если мнемоника некорректна. Возвращает Wallet.

Адреса

public function createAddress(Wallet $wallet, ?string $title = null, ?int $index = null): Address

Вывести следующий адрес (или конкретный $index) и добавить его в кошелёк. Возвращает Address.

public function deriveAddress(Wallet $wallet, ?string $title = null, int $index = 0): Address

Вывести адрес по $index без изменения кошелька. Возвращает Address.

public function importAddress(string $address, ?string $title = null): Address

Создать watch-only Address (без приватного ключа, не может подписывать). Возвращает Address.

public function validateAddress(string|Address $address): bool

Проверить адрес через ноду. Возвращает bool.

Аккаунт, баланс и ресурсы

public function getAccount(string|Address $address): AccountDTO

Получить полную информацию об аккаунте. Возвращает AccountDTO.

public function getResources(string|Address $address): AccountResourcesDTO

Получить bandwidth и energy. Возвращает AccountResourcesDTO.

public function getBalance(string|Address $address): BigDecimal

Баланс TRX (в TRX, не в SUN). Возвращает BigDecimal.

Токены TRC-20

public function getTRC20Contract(string $contractAddress): TRC20Contract

Возвращает помощник TRC20Contract.

public function getTRC20Balance(string|Address $address, string $contractAddress): BigDecimal

Баланс токена у адреса (уже масштабирован по decimals токена). Возвращает BigDecimal.

Переводы TRX

public function transferPreview(string|Address $from, string|Address $to, BigDecimal|float|int|string $amount): TransferPreviewDTO

Оценить комиссии / итоговый баланс без отправки. Возвращает TransferPreviewDTO.

public function transfer(Address $from, string|Address $to, BigDecimal|float|int|string $amount): TransferSendDTO

Подписать и отправить. $from должен быть «расходуемым» Address. Бросает TronException при ошибке. Возвращает TransferSendDTO.

public function transferAll(Address $from, string|Address $to): TransferSendDTO

Отправить весь баланс за вычетом сетевых комиссий. Возвращает TransferSendDTO.

Переводы TRC-20

public function transferTRC20Preview(string $contractAddress, string|Address $from, string|Address $to, BigDecimal|float|int|string $amount, BigDecimal|float|int|string $feeLimit = 30): TRC20TransferPreviewDTO

Возвращает TRC20TransferPreviewDTO.

public function transferTRC20(string $contractAddress, Address $from, string|Address $to, BigDecimal|float|int|string $amount, BigDecimal|float|int|string $feeLimit = 30): TRC20TransferSendDTO

Подписать и отправить перевод токена. Возвращает TRC20TransferSendDTO.

public function transferTRC20All(string $contractAddress, Address $from, string|Address $to, BigDecimal|float|int|string $feeLimit = 30): TRC20TransferSendDTO

Отправить весь баланс токена. Возвращает TRC20TransferSendDTO.

История

public function getTransfers(string|Address $address): Transfers

Возвращает итератор Transfers по переводам TRX.

public function getTRC20Transfers(string|Address $address): TRC20Transfers

Возвращает итератор TRC20Transfers.

public function getTransactionInfo(string $txid): TransactionInfoDTO

Возвращает TransactionInfoDTO.

public function getTransfer(string $txid): ?TransferDTO

Возвращает TransferDTO или null.

Константы

• Tron::DERIVATION_PATH — "m/44'/195'/0'/0" (путь BIP44 для Tron mainnet).

---

Wallet

ItHealer\Tron\Wallet\Wallet — value-объект: пара мнемоника/seed и выведенные из неё адреса. Не выполняет ввод-вывод сам по себе.

Свойства

• public string $name
• public readonly ?string $mnemonic
• public readonly ?string $seed — hex
• public readonly ?string $passphrase

Методы

public function addAddress(Address $address): void
public function getAddresses(): array          // Address[]
public function getPrimaryAddress(): ?Address   // индекс 0
public function findAddress(string $address): ?Address
public function maxIndex(): ?int                // наибольший использованный индекс
public function toArray(): array
public static function fromArray(array $data): Wallet

---

Address

ItHealer\Tron\Wallet\Address — один адрес Tron.

Свойства

• public readonly string $address — base58
• public readonly ?string $privateKey — hex, null для watch-only
• public readonly ?int $index — индекс деривации
• public ?string $title
• public readonly bool $watchOnly

Методы

public function isSpendable(): bool   // false для watch-only / без ключа
public function toArray(): array
public static function fromArray(array $data): Address
public function __toString(): string  // возвращает адрес

---

Crypto\Mnemonic

ItHealer\Tron\Crypto\Mnemonic — статические помощники BIP39 (также доступны через фасад Tron).

public static function generate(int $wordCount = 15): array      // string[]
public static function validate(string|array $mnemonic): bool
public static function toSeed(string|array $mnemonic, ?string $passphrase = null): string  // hex

---

Crypto\Encryption

ItHealer\Tron\Crypto\Encryption — AES-256-GCM на основе пароля (ключ выводится через PBKDF2).

public static function encrypt(string $plaintext, string $password): string  // base64 (salt+iv+tag+ciphertext)
public static function decrypt(string $payload, string $password): string     // бросает TronException при неверном пароле

---

Storage\WalletStore

ItHealer\Tron\Storage\WalletStore — файловое хранилище кошельков с необязательным шифрованием и переносимыми бэкапами.

public function __construct(string $directory, ?string $password = null)

Если задан $password, каждый файл кошелька шифруется AES-256-GCM.

public function save(Wallet $wallet): string   // возвращает путь к файлу
public function exists(string $name): bool
public function load(string $name): Wallet      // бросает TronException, если нет файла / неверный пароль
public function names(): array                  // string[]
public function all(): array                    // Wallet[]
public function delete(string $name): void
public function backup(Wallet|array $wallets, string $file, string $password): void  // всегда зашифрован
public function restore(string $file, string $password): array                        // Wallet[]

---

Storage\Database

ItHealer\Tron\Storage\Database — тонкая обёртка SQLite (PDO), используемая монитором депозитов. Требует расширение pdo_sqlite. Создаёт файл и таблицы автоматически.

public function __construct(string $path)   // поддерживается ':memory:'
public function pdo(): \PDO

---

Webhook\WebhookSender

ItHealer\Tron\Webhook\WebhookSender — доставляет подписанные JSON-вебхуки по HTTP POST.

public function __construct(string $url, ?string $secret = null, int $timeoutMs = 10000)

public function isConfigured(): bool

// Значение заголовка X-Tron-Signature: "sha256=<hmac>"
public static function signature(string $body, string $secret): string

// Отправить payload. Возвращает ['ok' => bool, 'code' => int, 'error' => ?string].
public function send(array $payload): array

---

Webhook\DepositMonitor

ItHealer\Tron\Webhook\DepositMonitor — отслеживает адреса на новые входящие транзакции TRX / TRC-20 и отправляет вебхуки. Состояние хранится в SQLite.

public function __construct(Tron $tron, Database $db, ?WebhookSender $sender = null, array $options = [])

$options:

• limit (int, по умолчанию 30) — сколько последних переводов сканировать на адрес за тик.
• watch_trx (bool, по умолчанию true).
• watch_trc20 (bool, по умолчанию true).

Методы

public function watch(string $address, ?string $label = null): void  // идемпотентно
public function unwatch(string $address): void
public function watched(): array          // строки: id, address, label, watch_from, created_at
public function deposits(int $limit = 50): array  // последние депозиты, новые сверху
public function poll(): array             // один тик; возвращает новые обнаруженные депозиты
public function run(int $intervalSeconds = 30, ?int $maxTicks = null, ?callable $onDeposit = null): void

Строка депозита содержит: id, address, txid, asset, contract, amount, from_address, block_time, detected_at, webhook_status, webhook_code, webhook_attempts. Полное руководство — docs/WEBHOOKS.md.

---

Api\TRC20Contract

ItHealer\Tron\Api\TRC20Contract — получается через Tron::getTRC20Contract().

public readonly string $address;

public function name(): string
public function symbol(): string
public function decimals(): int
public function balanceOf(string $address): BigDecimal

---

Итераторы переводов

Оба реализуют Iterator и автоматически листают страницы. Все методы-строители возвращают $this (цепочка вызовов). Ограничивайте число прочитанных элементов через break в цикле.

Transfers (TRX) — ItHealer\Tron\Api\Methods\Transfers

public function onlyConfirmation(?Confirmation $confirmed): static
public function onlyDirection(?Direction $direction): static
public function limit(int $limit): static            // 1..200, размер страницы
public function orderBy(?OrderBy $orderBy): static
public function minTimestamp(?int $minTimestamp): static   // мс
public function maxTimestamp(?int $maxTimestamp): static   // мс
public function searchInterval(bool $searchInterval): static

При итерации возвращает элементы TransferDTO.

TRC20Transfers — ItHealer\Tron\Api\Methods\TRC20Transfers

public function onlyConfirmation(?Confirmation $confirmed): static
public function limit(int $limit): static
public function fingerprint(?string $fingerprint): static
public function orderBy(?OrderBy $orderBy): static
public function minTimestamp(?int $minTimestamp): static
public function maxTimestamp(?int $maxTimestamp): static
public function contractAddress(?string $contractAddress): static  // фильтр по токену

При итерации возвращает элементы TRC20TransferDTO.

Внимание: у TRC20Transfers нет onlyDirection(). Фильтруйте входящие переводы, сравнивая $transfer->to с отслеживаемым адресом.

---

DTO

Все DTO неизменяемы, имеют toArray() и находятся в ItHealer\Tron\Api\DTO.

AccountDTO

• string $address
• array $data — сырой ответ ноды
• bool $activated
• ?BigDecimal $balance — TRX
• ?DateTimeImmutable $createTime
• ?DateTimeImmutable $lastOperationTime

AccountResourcesDTO

• string $address, array $data, bool $activated
• ?int $bandwidthTotal, ?int $bandwidthUsed, ?int $bandwidthAvailable
• ?int $energyTotal, ?int $energyUsed, ?int $energyAvailable

TransferPreviewDTO

• ?string $error (используйте hasError(): bool)
• ?AccountDTO $from, ?AccountResourcesDTO $fromResources, ?AccountDTO $to
• ?BigDecimal $balanceBefore, ?BigDecimal $balanceAfter, ?BigDecimal $activateFee
• ?array $transaction
• ?int $bandwidthRequired, ?int $bandwidthBefore, ?int $bandwidthAfter, ?BigDecimal $bandwidthFee

TransferSendDTO

• string $txid
• TransferPreviewDTO $preview

TRC20TransferPreviewDTO

• ?string $error (используйте hasError(): bool)
• ?AccountDTO $from, ?AccountResourcesDTO $fromResources, ?AccountDTO $to
• ?BigDecimal $balanceBefore, ?BigDecimal $balanceAfter
• ?BigDecimal $tokenBefore, ?BigDecimal $tokenAfter
• ?bool $activated
• ?int $energyRequired, ?int $energyBefore, ?int $energyAfter, ?int $energyInsufficient, ?BigDecimal $energyFee
• ?int $bandwidthRequired, ?int $bandwidthBefore, ?int $bandwidthAfter, ?int $bandwidthInsufficient, ?BigDecimal $bandwidthFee
• ?array $transaction

TRC20TransferSendDTO

• string $txid
• TRC20TransferPreviewDTO $preview

TransferDTO

• array $data, string $txid
• ?DateTimeImmutable $time
• bool $success, ?int $blockNumber
• string $from, string $to, BigDecimal $value

TRC20TransferDTO

• array $data, string $txid, DateTimeImmutable $time
• string $from, string $to
• string $contractAddress, string $contractName, string $contractSymbol
• BigDecimal $value

TransactionInfoDTO

• array $data, string $txid, int $blockNumber, DateTimeImmutable $blockTime
• ?bool $success, ?int $bandwidth, ?int $energy, ?BigDecimal $fee

---

Перечисления (Enums)

Пространство имён ItHealer\Tron\Api\Enums.

• Direction — Direction::FROM ('from'), Direction::TO ('to').
• Confirmation — Confirmation::CONFIRMED, Confirmation::UNCONFIRMED.
• OrderBy — OrderBy::ASC ('asc'), OrderBy::DESC ('desc').

---

Исключения

ItHealer\Tron\Exceptions\TronException наследует \Exception. Бросается при некорректном вводе, неудачных предпросмотрах/переводах, ошибках расшифровки, ошибках HTTP и проблемах хранилища. Оборачивайте вызовы, затрагивающие сеть или недоверенный ввод, в try/catch.