tronz-contract 0.1.0

# tronz-contract

ABI bindings and contract instances for the [tronz](https://github.com/throgxyz/tronz) TRON SDK.

TRON smart contracts are EVM-compatible, so this crate reuses `alloy`'s
[`sol!`](https://docs.rs/alloy-sol-macro) macro and ABI codec directly rather than
hand-rolling an encoder.

## Features

| Feature | What it enables |
|---------|-----------------|
| *(none)* | Static ABI encode/decode via `sol!` (no I/O, no provider dep) |
| `provider` | [`ContractInstance`], [`Interface`], [`Trc20Instance`], and extension traits |

## Interacting with arbitrary contracts (dynamic ABI)

Load a JSON ABI at runtime and call any function by name:

```rust,ignore
use tronz_contract::{Interface, instance::ContractExt};
use alloy_json_abi::JsonAbi;

let abi: JsonAbi = serde_json::from_str(ABI_JSON).unwrap();
let contract = provider.contract(address, abi.into());

// read-only call
let values = contract.call("balanceOf", &[account.into()]).await?;

// state-changing call
let pending = contract.send("transfer", &[to.into(), amount.into()]).await?;
let receipt = pending.get_receipt().await?;
```

## Standard token interfaces (static ABI)

Use the typed wrappers for well-known standards:

```rust,ignore
use tronz_contract::trc20::Trc20Ext;

let token = provider.trc20(usdt_address);
println!("name    : {}", token.name().await?);
println!("balance : {}", token.balance_of(my_address).await?);

let pending = token.transfer(recipient, amount).await?;
let receipt = pending.get_receipt().await?;
```

## Crate layout

- [`trc20`] — static `sol!` bindings + [`Trc20Instance`] high-level wrapper
- [`interface`] — [`Interface`] wrapping [`JsonAbi`] with O(1) selector lookup
- [`instance`] — [`ContractInstance`] generic contract handle
- [`error`] — [`ContractError`] and [`Result`] type alias

[`ContractInstance`]: crate::instance::ContractInstance
[`Interface`]: crate::interface::Interface
[`Trc20Instance`]: crate::trc20::Trc20Instance
[`ContractError`]: crate::error::ContractError
[`Result`]: crate::error::Result
[`trc20`]: crate::trc20
[`interface`]: crate::interface
[`instance`]: crate::instance
[`error`]: crate::error
[`JsonAbi`]: alloy_json_abi::JsonAbi

## License

Licensed under either of [Apache License, Version 2.0](../../LICENSE-APACHE) or
[MIT license](../../LICENSE-MIT) at your option.