Contract Analysis
Perform deep analysis of TRON smart contracts — deployment details, method signatures, call patterns, top callers, energy economics, and safety risk assessment.
MCP Server
Instructions
Step 1: Fetch Contract Basics
Run in parallel:
- 1.
getContractInfo — Contract name, deployer (origin_address), consume_user_resource_percent, origin_energy_limit, creation time, energy usage stats - INLINECODE3 — Full ABI definition, bytecode, whether ABI is available (indicates open-source status)
Step 2: Parse Contract Methods
From the ABI, categorize all methods:
- - Read-only (view/pure): Safe calls, no state changes
- State-changing: transfers, approvals, settings
- Admin/Owner: privileged ops (mint, pause, blacklist, upgrade)
- Events: what the contract logs
Identify standard interfaces: TRC-20, TRC-721, TRC-1155, proxy/upgradeable patterns.
Step 3: Analyze Transaction Activity
- 1.
getContractTransactions — Total count, recent patterns, success/failure rate - INLINECODE5 — Most frequent events, parameter patterns
- INLINECODE6 — Inter-contract calls, TRX transfers within execution
Step 4: Identify Top Callers
From transaction data, aggregate:
- - Top 5 by transaction count
- Top 5 by value (TRX or token amount)
- Classify callers: exchange, bot, regular user, other contract
Step 5: Estimate Energy Costs
Call estimateEnergy with common method calls to assess:
- - Typical energy cost per transaction type
- Whether the contract is energy-efficient
- Cost split between user and contract owner (based on
consume_user_resource_percent)
Step 6: Safety Assessment
High Risk indicators:
- - No ABI (unverified/closed source)
- Unlimited mint capability
- Pause/freeze can lock user funds
- Blacklist function, self-destruct, hidden transfer fees
- Proxy pattern (upgradeable logic)
- INLINECODE9 (users pay all energy)
Medium Risk indicators:
- - Very few unique callers vs. high tx count
- Recently created with sudden high activity
- Admin functions without timelock/multisig
Positive indicators:
- - Open-source verified, standard implementation
- Timelock on admin functions, multisig requirements
- Long history with consistent activity, diverse callers
Step 7: Compile Contract Report
CODEBLOCK0
Error Handling
| Error | Cause | Resolution |
|---|
| No ABI found | Contract not verified or ABI cleared | Note as unverified; analyze bytecode patterns and transaction data instead |
| Address is not a contract |
Regular account address provided | Inform user this is a regular account, suggest using trongrid-account-profiling skill |
| No transactions | Newly deployed or unused contract | Report as inactive; check deployer's other contracts for context |
| Contract self-destructed | Contract no longer exists on-chain | Inform user; historical tx data may still be available |
Examples
合约分析
对TRON智能合约进行深度分析——部署详情、方法签名、调用模式、顶级调用者、能量经济学及安全风险评估。
MCP服务器
操作说明
第一步:获取合约基本信息
并行执行:
- 1. getContractInfo — 合约名称、部署者(originaddress)、consumeuserresourcepercent、originenergylimit、创建时间、能量使用统计
- getContract — 完整ABI定义、字节码、ABI是否可用(指示开源状态)
第二步:解析合约方法
从ABI中,对所有方法进行分类:
- - 只读(view/pure):安全调用,无状态变更
- 状态变更:转账、授权、设置
- 管理员/所有者:特权操作(铸造、暂停、黑名单、升级)
- 事件:合约记录的内容
识别标准接口:TRC-20、TRC-721、TRC-1155、代理/可升级模式。
第三步:分析交易活动
- 1. getContractTransactions — 总数量、近期模式、成功/失败率
- getEventsByContractAddress — 最频繁的事件、参数模式
- getContractInternalTransactions — 合约间调用、执行过程中的TRX转账
第四步:识别顶级调用者
从交易数据中,汇总:
- - 按交易数量排名前5
- 按价值(TRX或代币数量)排名前5
- 对调用者进行分类:交易所、机器人、普通用户、其他合约
第五步:估算能量成本
使用常见方法调用estimateEnergy来评估:
- - 每种交易类型的典型能量成本
- 合约是否节能
- 用户和合约所有者之间的成本分配(基于consumeuserresource_percent)
第六步:安全评估
高风险指标:
- - 无ABI(未验证/闭源)
- 无限铸造能力
- 暂停/冻结可锁定用户资金
- 黑名单功能、自毁、隐藏转账费用
- 代理模式(可升级逻辑)
- consumeuserresource_percent = 100(用户承担所有能量)
中风险指标:
- - 独特调用者极少但交易数量很高
- 近期创建且突然出现高活跃度
- 管理员功能无时间锁/多重签名
正面指标:
- - 开源已验证、标准实现
- 管理员功能有时间锁、多重签名要求
- 长期历史且活动稳定、调用者多样化
第七步:编制合约报告
合约分析:[地址]
部署
- - 名称:[名称] | 部署者:[地址]
- 部署时间:[日期] | 开源:[是/否]
- 标准:[TRC-20/TRC-721/自定义]
方法
- - 总计:[数量](只读:[X],写入:[Y],管理员:[Z])
热门方法(按调用频率)
| 方法 | 调用次数 | 平均能量 |
|---|
| transfer() | XX,XXX | X,XXX |
顶级调用者
| 地址 | 交易数量 | 标签 |
|---|
| TXxx... | X,XXX | [交易所/机器人/未知] |
活动情况
- - 总交易数:[数量] | 日均:[数量]
- 成功率:[X.X%] | 独特调用者:[数量]
能量经济学
- - 用户承担:[X%] | 每笔交易平均能量:[数量]
安全评分:[安全 / 谨慎 / 高风险]
- - 风险因素:[列表]
- 正面因素:[列表]
- 建议:[可操作建议]
错误处理
| 错误 | 原因 | 解决方案 |
|---|
| 未找到ABI | 合约未验证或ABI已清除 | 标记为未验证;改为分析字节码模式和交易数据 |
| 地址不是合约 |
提供了普通账户地址 | 告知用户这是普通账户,建议使用trongrid-account-profiling技能 |
| 无交易记录 | 新部署或未使用的合约 | 报告为不活跃;检查部署者的其他合约以获取上下文 |
| 合约已自毁 | 合约不再存在于链上 | 告知用户;历史交易数据可能仍然可用 |
示例