Skip to content

TronLink/tronlink-skills

Repository files navigation

TronLink Wallet Skills

AI Agent skills for TronLink wallet and the TRON ecosystem. Provides wallet management, token queries, market data, DEX swap, resource (Energy/Bandwidth) management, and TRX staking across the TRON network.

Node.js >= 18 required (uses native fetch and crypto).

Why TRON Needs Its Own Skill Set

TRON has a unique resource model (Energy & Bandwidth) that differs fundamentally from EVM gas. Transactions consume Bandwidth; smart contract calls consume Energy. Users must stake TRX (Stake 2.0) or burn TRX to obtain these resources. This makes TRON wallet operations, cost estimation, and transaction planning significantly different from Ethereum-based chains — and no existing AI agent skill covers this properly.

Installation — One Command

Recommended (auto-detects your AI environment)

curl -sSL https://raw.githubusercontent.com/TronLink/tronlink-skills/main/install.sh | sh

This automatically detects Claude Code, Cursor, Codex, OpenCode, or Windsurf and configures everything.

Uninstall

# If you still have the repo locally:
sh uninstall.sh

# Or run remotely:
curl -sSL https://raw.githubusercontent.com/TronLink/tronlink-skills/main/uninstall.sh | sh

Removes MCP registrations, symlinks, copied config files, and ~/.tronlink-skills.

Claude Code

# Option A: Vercel Skills CLI
npx skills add TronLink/tronlink-skills

# Option B: Claude Code plugin marketplace
/plugin marketplace add TronLink/tronlink-skills
/plugin install tronlink-skills

# Option C: MCP Server (manual)
claude mcp add tronlink-skills -- node ~/.tronlink-skills/scripts/mcp_server.mjs

Cursor / Windsurf

npx skills add TronLink/tronlink-skills

Codex CLI

Fetch and follow instructions from https://raw.githubusercontent.com/TronLink/tronlink-skills/main/.codex/INSTALL.md

Available Skills

Skill Description
tron-wallet Wallet setup, TRX/TRC-20 balances, transaction history, account info
tron-token Token search, metadata, contract verification, holder analysis, trending tokens
tron-market Real-time prices, K-line data, trade history, whale monitoring, smart money signals
tron-swap DEX swap quote & route (SunSwap, etc.), transaction status
tron-resource Energy & Bandwidth query, estimation, cost optimization
tron-staking SR list, staking info, APY estimation

Quick Start

# Clone the repo
git clone https://github.com/TronLink/tronlink-skills.git
cd tronlink-skills

# Check TRX balance
node scripts/tron_api.mjs wallet-balance --address TXYZabc123...

# Get token info
node scripts/tron_api.mjs token-info --contract TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t

# Get swap quote
node scripts/tron_api.mjs swap-quote \
  --from-token TRX \
  --to-token TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t \
  --amount 100

# Check energy & bandwidth
node scripts/tron_api.mjs resource-info --address TXYZabc123...

Zero Dependencies for Read Operations

The CLI uses native Node.js fetch (Node 18+) and native crypto for all read-only operations. No npm install needed for:

  • Balance queries, token info, market data
  • Resource estimation, energy price
  • Transaction history, address validation
  • SR list, staking APY calculation

Prerequisites

  • Node.js 18+ (for native fetch support)
  • TronGrid API Key (optional — apply at TronGrid Dashboard)
  • TronScan API Key (optional — raises TronScan rate limits and enables full token-search)
# Optional: higher rate limits
export TRONGRID_API_KEY="your-api-key"
export TRONSCAN_API_KEY="your-api-key"   # raises TronScan limits + enables token-search (/search/v2)

# Optional: switch network
export TRON_NETWORK="mainnet"  # or "shasta" / "nile"

Supported Networks

Network Endpoint
Mainnet https://api.trongrid.io
Shasta Testnet https://api.shasta.trongrid.io
Nile Testnet https://nile.trongrid.io

Skill Workflows

Check Balance: tron-wallet (check balance) → tron-resource (estimate energy cost)

Research Token: tron-token (search token) → tron-market (price/chart) → tron-swap (get quote)

Staking Info: tron-wallet (check TRX balance) → tron-staking (staking info, SR list, APY)

Resource Optimization: tron-resource (check energy/bandwidth) → tron-resource (estimate cost) → tron-resource (rent energy)

Architecture

Natural Language Input
    ↓
AI Agent (Claude Code / Cursor / OpenClaw / Custom)
    ↓
tron_api.mjs (Node.js 18+, native fetch — zero deps)
    ↓  ← TronGrid / TronScan API keys (both optional)
    ├── TronGrid        — accounts, resources, chain params, tx, address validation
    ├── TronScan        — token metadata, holders, transfers, approvals, rankings
    ├── CoinGecko       — prices, K-line, trending tokens
    └── Sun.io router   — DEX swap quotes
    ↓
Structured JSON → Agent interprets → Natural language response

All Commands (40 total)

Wallet (8 commands)

wallet-balance      token-balance       wallet-tokens       tx-history
account-info        validate-address    wallet-approvals    wallet-overview

Token (8 commands)

token-info          token-search        contract-info       token-holders
trending-tokens     token-rankings      token-security      token-overview

Market (8 commands)

token-price         kline               trade-history       dex-volume
whale-transfers     large-transfers     pool-info           market-overview

Swap (3 commands)

swap-quote          swap-route          tx-status

Resource (9 commands)

resource-info       estimate-energy     estimate-bandwidth  energy-price
bandwidth-price     tx-cost             chain-params        energy-rental
optimize-cost

Staking (3 commands)

sr-list             staking-info        staking-apy

Diagnostics (1 command)

health-check

Compatible Platforms

Platform Status Notes
Claude Code Clone repo, add SKILL.md to project context
Cursor Clone into project, reference SKILL.md
OpenClaw Native skill support
Manus Auto-install and execute
Dify Use as Code node or API Tool
LangChain / CrewAI Wrap as a Tool

Security Notes

  • This skill set is read-only — no private keys or signing operations
  • All operations use public read-only TRON APIs (TronGrid, TronScan, CoinGecko, Sun.io router) — each rate-limited without a key; set TRONGRID_API_KEY / TRONSCAN_API_KEY to raise the limits
  • Built-in TRC-20 symbols (USDT, USDC, USDD, etc.) auto-resolve to verified contracts. TRX is the native coin, not a contract — use it with price/market/wallet commands (token-price --contract TRX, market-overview, wallet-balance). The contract-only commands (token-info, contract-info, token-holders, token-security, token-overview) don't apply to native TRX and return a hint pointing you to those commands.

License

MIT License Copyright (c) 2026 TronLink

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors