TON CONTRACT AUDIT / Trail of Bits
TON vulnerability scanner
Pins the TON scanner's refusal to omit a coverage row, and its requirement to cite the stored address a Jetton sender is compared against.
“Refuses a partial TON scan, requires every pattern verdict, and says a Jetton sender must be compared to a stored address.”
01 / THE REASONING
Why this made the selection.
- An empty verdict or a missing pattern row is an incomplete scan, and not having looked is not an n/a.
- The file rejects treating the sender as obviously the Jetton wallet and tells the reviewer to cite the stored address used in the comparison, and to name the reserve before dismissing gas.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- plugins/building-secure-contracts/skills/ton-vulnerability-scanner/SKILL.md
- plugins/building-secure-contracts/README.md
- README.md
- LICENSE
Our findings
- A report that is silent on any of the patterns is treated as looking like a clean contract, so every row has to be emitted even when the verdict is clear.
- An empty verdict cell is incomplete in the same way as a missing row, and not having looked is not an n/a.
- Silence is rejected because a reader cannot tell it apart from not having checked.
- Calling the sender obviously the Jetton wallet is rejected; the file requires the stored address used in the comparison.
- Dismissing gas because a message is non-bounceable is rejected; the file says to name the reserve.
- The checklist will not accept a finished audit without the coverage table and a verdict on every row.
Not established by this review
- The resource was not executed.
- No FunC contract was scanned and no local sandbox test was run.
- resources/VULNERABILITY_PATTERNS.md was not opened.
- The attack walkthrough in the reporting template was not copied into this record.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
/plugin install trailofbits/skills/plugins/building-secure-contracts Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- The building-secure-contracts README shows `/plugin install trailofbits/skills/plugins/building-secure-contracts`. That installs the plugin, not this skill alone.
- The repository README shows `/plugin marketplace add trailofbits/skills`. That adds the marketplace, not this skill.
- No fetched line installs only ton-vulnerability-scanner.
Before you start
- Claude Code, because both install lines are Claude plugin commands
- A FunC contract tree to review; this review did not supply one
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/building-secure-contracts/skills/ton-vulnerability-scanner/SKILL.md
Supports: Coverage-table refusal, stored-address comparison, and the reserve requirement
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/building-secure-contracts/README.md
Supports: Plugin install line for the building-secure-contracts plugin
- Repository README ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md
Supports: Marketplace install line and the CC-BY-SA-4.0 statement
- Repository LICENSE ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE
Supports: Attribution-ShareAlike 4.0 International Public License