tronz/examples

Runnable examples for the tronz TRON SDK.

These examples track tronz 0.4.1.

All examples target the Nile testnet. Read-only examples run without a private key; examples that send transactions require TRON_PRIVATE_KEY=<hex>.

Usage

# Read-only
cargo run -p examples-queries --example query

# With private key
TRON_PRIVATE_KEY=<hex> cargo run -p examples-staking --example stake

Overview

This repository contains the following examples:

• Queries
  • Query chain state
  • Address format conversions
  • TRX amount math
  • Connect to a custom endpoint
  • List witnesses (SRs)
  • Page witnesses by live votes
  • List governance proposals
• Signers
  • Generate a random keypair
  • Sign and verify a hash
  • Derive from a BIP-39 mnemonic
  • Encrypt and decrypt a keystore
  • Sign with an AWS KMS key
• Transfers
  • Send TRX
  • Send TRX with a memo
• Staking
  • Stake 2.0: freeze, delegate, claim
  • Stake 1.0 (legacy): freeze and unfreeze
  • Freeze for bandwidth
  • Delegate resource
  • Undelegate resource
  • Unfreeze (V2)
  • Cancel a pending unfreeze
  • Withdraw an expired unfreeze
  • Claim block/vote rewards
  • Vote for a witness
• Contracts
  • Read-only contract call
  • Set msg.sender with .caller()
  • State-changing contract call
  • Deploy a contract
  • Call a contract via JSON ABI
  • Estimate energy cost
  • Handle revert errors
  • Decode an event log
  • Decode a transaction receipt
• Sol macro (tron_sol!)
  • Type-safe bindings from a Solidity interface
  • Query typed events with generated filters
• Solidity node (irreversible state)
  • Read solidified blocks, accounts, and receipts
  • Typed TRC20 read against solidified state
  • Constant call against solidified state
  • Broadcast, then wait for solidification
• TRC10
  • Query token metadata by ID
  • Query token metadata by name
  • Check a TRC10 balance
  • Transfer TRC10 tokens
  • Issue a new TRC10 token
• TRC20
  • Balance and transfer
  • Approve and allowance
  • transferFrom flow
  • Decode Transfer events
• TRC721 (NFT)
  • Query NFT metadata and ownership
  • Transfer an NFT
  • Approve a spender or operator
• Accounts
  • Create an account on-chain
  • Set an account name
  • Update account permissions (multi-sig)

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.