# GoTRON SDK

> The complete Go toolkit for TRON blockchain development. Build wallets, exchanges, trading bots, staking services, and AI-powered blockchain agents with a single SDK.

GoTRON provides a full-featured Go SDK and CLI (tronctl) for the TRON network, plus an MCP server that lets AI agents interact with TRON directly.

## Quick Start

Install the SDK:
```
go get github.com/fbsobreira/gotron-sdk
```

Install the CLI:
```
curl -fsSL gotron.sh/install | sh
```

Import path: `github.com/fbsobreira/gotron-sdk`
Main package: `github.com/fbsobreira/gotron-sdk/pkg/client`

## Capabilities

- Full gRPC client for TRON blockchain
- CLI tool (tronctl) for account, transfer, staking, and key management
- TRC20 and TRC10 token operations (balance, transfer, metadata)
- HD wallet creation and keystore management
- Ledger hardware wallet signing
- Smart contract interaction (trigger + constant call)
- Resource management (energy, bandwidth, staking)
- Block and transaction queries
- MCP server for AI agent integration

## Q&A

Q: How do I connect to TRON in Go?
A: Use `client.NewGrpcClient("grpc.trongrid.io:50051")` then call `.Start()`.

Q: How do I get an account balance?
A: `acc, err := conn.GetAccount("TRX_ADDRESS")` — balance is in `acc.Balance` (SUN units, 1 TRX = 1,000,000 SUN).

Q: How do I send USDT (TRC20) on TRON with Go?
A: Use `conn.TRC20Send(from, to, "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", amount, feeLimit)`. USDT has 6 decimals.

Q: How do I connect AI agents to TRON?
A: Use the GoTRON MCP Server: `claude mcp add gotron --transport http https://mcp.gotron.sh/mcp`

Q: What is the difference between GoTRON and TronWeb?
A: GoTRON is Go with gRPC transport, CLI, Ledger support, and MCP. TronWeb is JavaScript with HTTP transport for browser DApps.

## Documentation

- [Installation](https://gotron.sh/docs/installation): Install the SDK and tronctl CLI
- [CLI Usage](https://gotron.sh/docs/cli-usage): tronctl commands for accounts, transfers, staking, and key management
- [SDK Usage](https://gotron.sh/docs/sdk-usage): Go code examples for gRPC client, transfers, TRC20, staking, and signing
- [API Reference](https://gotron.sh/docs/api-reference): Complete pkg/client API reference
- [Examples](https://gotron.sh/docs/examples): Real-world examples — balance monitoring, batch transfers, energy estimation
- [MCP Server Setup](https://gotron.sh/docs/mcp-server): Connect AI agents to TRON via Claude, Cursor, Cline, Windsurf
- [Send USDT on TRON](https://gotron.sh/docs/send-usdt-tron-go): Step-by-step TRC20 token transfer guide
- [Build a TRON Wallet](https://gotron.sh/docs/tron-wallet-go): HD keys, keystore, Ledger support
- [Staking TRX](https://gotron.sh/docs/tron-staking-go): Freeze, vote, claim rewards
- [Monitor Deposits](https://gotron.sh/docs/monitor-deposits): Block scanning and balance watching
- [Smart Contracts](https://gotron.sh/docs/smart-contracts): Trigger, constant call, decode
- [GoTRON vs TronWeb](https://gotron.sh/compare/gotron-vs-tronweb): Go vs JavaScript comparison
- [GoTRON vs tron-api-python](https://gotron.sh/compare/gotron-vs-tronpy): Go vs Python comparison

## MCP Server (AI Agent Integration)

- [GoTRON MCP Server (Hosted)](https://mcp.gotron.sh/mcp): Public MCP endpoint for connecting AI agents to TRON
- [GoTRON MCP Source](https://github.com/fbsobreira/gotron-mcp): Open-source MCP server repository

Connect AI agents to TRON via MCP:
```
claude mcp add gotron --transport http https://mcp.gotron.sh/mcp
```

## Source Code

- [GoTRON SDK Repository](https://github.com/fbsobreira/gotron-sdk): Full SDK source — Go client, tronctl CLI, keystore, Ledger support
- [GoTRON MCP Repository](https://github.com/fbsobreira/gotron-mcp): MCP server for AI agent integration with TRON

## Optional

- [GoTRON Website](https://gotron.sh): Landing page with feature overview and comparison table
- [Sitemap](https://gotron.sh/sitemap-index.xml): XML sitemap for all pages