Tron

Getting Started

The Tron Snap allows MetaMask and dapps to support all Tron-related networks and address types.

• @metamask/tron-wallet-snap
• @metamask/tron-wallet-test-dapp

Prerequisites

• MetaMask Flask
• Nodejs 22. We strongly recommend you install via NVM to avoid incompatibility issues between different node projects.
• Once installed, you should also install Yarn with npm i -g yarn to make working with this repository easiest.

Installing

nvm use
yarn install

Configuration

Please see ./src/packages/.env.example for reference

Running

Quick Start

yarn start

• Snap server and debug page: http://localhost:8080/
• Example UI dapp: http://localhost:3000/

Snap

⚠️ When snap updates you will need to still reconnect from the dapp to see changes

# Running Snap via watch mode
yarn workspace @metamask/tron-wallet-snap start

Git Hooks & Manifest Handling

The snap.manifest.json contains a shasum that differs between local and production builds. Git hooks ensure the repository always contains production-ready builds:

On Commit (with snap changes)

1. Detects if any packages/snap/ files are staged
2. Runs build:prod → updates manifest with production settings and shasum
3. Stages the updated snap.manifest.json
4. Runs lint:fix on all files

On Push

1. Runs the test suite
2. Push proceeds if tests pass

Local Development

yarn start builds with local settings (adds localhost origins and dev permissions). These are automatically converted to production settings when you commit.