TronLink

https://docs.tronlink.org/
Admin
TronLink is a decentralized wallet for the TRON ecosystem that provides comprehensive developer...
Tokens:23,485
Snippets:235
Trust Score:9.7
Update:6 months ago
Show doc for...
Tokens:
Raw
### Installation and Basic Setup

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Install the core package and implement the session manager to start the server.

```bash
npm install @tronlink/tronlink-mcp-core
```

```javascript
import {
  createMcpServer,
  setSessionManager,
  type ISessionManager,
} from '@tronlink/tronlink-mcp-core';

// 1. Implement ISessionManager
class MySessionManager implements ISessionManager {
  // ... implement all 25+ methods
}

// 2. Register
setSessionManager(new MySessionManager());

// 3. Create and start server
const server = createMcpServer({
  name: 'My TronLink Server',
  version: '1.0.0',
});

await server.start();
```

--------------------------------

### TronLink MCP Server Quick Start Guide

Source: https://docs.tronlink.org/ai-support/mcp-server-tronlink

Provides essential steps to build, configure, and start the TronLink MCP server.

```bash
# 1. Build
npm install && npm run build

# 2. Configure .mcp.json (Nile testnet example)
# Add:
#   TL_TRONGRID_URL=https://nile.trongrid.io
#
# 3. If no wallet exists, choose one path:
#   Option A: call tl_wallet_create after startup
#   Option B: create one locally, then set AGENT_WALLET_PASSWORD

# 4. Use with Claude Code
# "Check my TRX balance"
# "Send 10 TRX to TAddress..."
# "Swap 100 TRX for USDT on SunSwap V3"

```

--------------------------------

### Quick Start: Using TronLink Skills with Claude Code

Source: https://docs.tronlink.org/ai-support/tronlink-skills

This section demonstrates how to quickly start using the TronLink Skills project with Claude Code. No installation is needed for read-only operations.

```bash
# 1. Clone
git clone <repo>
cd tronlink-skills

# 2. Use with Claude Code (no install needed for reads)
claude
> "What's the TRX balance of TAddress...?"
> "Show me the top trending tokens on TRON"
> "How much Energy do I need to send USDT?"
> "What's the best way to get Energy — freeze, rent, or burn?"

```

--------------------------------

### TRONLink Skills Quick Setup and Uninstall

Source: https://docs.tronlink.org/ai-support/tronlink-skills

Scripts for automatically installing TRONLink skills across all AI environments or performing a clean uninstall.

```bash
# Auto-install for all AI environments
bash install.sh

# Clean uninstall
bash uninstall.sh

```

--------------------------------

### TRONLink Skills Workflow Examples

Source: https://docs.tronlink.org/ai-support/tronlink-skills

These examples demonstrate common workflows for interacting with the TRON blockchain using TRONLink skills, such as checking balances, researching tokens, and analyzing staking.

```bash
tron-wallet (check balance) → tron-wallet (list tokens) → tron-resource (check energy status)
```

```bash
tron-token (search) → tron-market (price/chart) → tron-resource (check energy) → tron-swap (get quote)
```

```bash
tron-wallet (check balance) → tron-staking (staking info) → tron-staking (APY estimate) → tron-staking (SR list)
```

```bash
tron-resource (check status) → tron-resource (estimate cost) → tron-resource (optimize-cost)
```

--------------------------------

### Quick Start: Using TronLink Skills Directly with Node.js

Source: https://docs.tronlink.org/ai-support/tronlink-skills

This section shows how to use the TronLink Skills CLI directly using Node.js. This is an alternative to using it with Claude Code.

```bash
# 3. Or use directly
node scripts/tron_api.mjs wallet-balance --address TAddress...
node scripts/tron_api.mjs token-price --token USDT
node scripts/tron_api.mjs optimize-cost --address TAddress...

```

--------------------------------

### Project-Level MCP Config (Full Nile Setup)

Source: https://docs.tronlink.org/ai-support/mcp-server-tronlink

Extended project-level MCP configuration for a full Nile setup, including Playwright options, wallet, SunSwap, multisig, and gas-free service details. Ensure sensitive values like passwords and API keys are managed securely.

```json
{
  "mcpServers": {
    "tronlink": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": ".",
      "env": {
        "TRONLINK_EXTENSION_PATH": "/path/to/tronlink-extension/dist",
        "TL_MODE": "prod",
        "TL_HEADLESS": "false",
        "TL_TRONGRID_URL": "https://nile.trongrid.io",
        "AGENT_WALLET_PASSWORD": "your-wallet-password",
        "TL_SUNSWAP_ROUTER": "TKzxdSv2FZKQrEqkKVgp5DcwEXBEKMg2Ax",
        "TL_SUNSWAP_V3_ROUTER": "TB6xBCixqRPUSKiXb45ky1GhChFJ7qrfFj",
        "TL_MULTISIG_BASE_URL": "https://apinile.walletadapter.org",
        "TL_MULTISIG_SECRET_ID": "TEST",
        "TL_MULTISIG_SECRET_KEY": "TESTTESTTEST",
        "TL_MULTISIG_CHANNEL": "test",
        "TL_GASFREE_BASE_URL": "https://open-test-gasfree.io/nile/",
        "TL_GASFREE_API_KEY": "your_gasfree_api_key",
        "TL_GASFREE_API_SECRET": "your_gasfree_api_secret"
      }
    }
  }
}
```

--------------------------------

### Project-Level MCP Config (Basic)

Source: https://docs.tronlink.org/ai-support/mcp-server-tronlink

Basic project-level MCP configuration for TronLink, specifying the command to run and a TronGrid URL. This is a starting point for integration.

```json
{
  "mcpServers": {
    "tronlink": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": ".",
      "env": {
        "TL_TRONGRID_URL": "https://nile.trongrid.io"
      }
    }
  }
}
```

--------------------------------

### Example Signed Hex String

Source: https://docs.tronlink.org/dapp/message-signing

This is an example of a successfully signed hexadecimal string returned by tronweb.trx.signMessageV2.

```plaintext
    0xb0e0b150b9b10dc348f25c7f38fc87f16e18c0d230d23946aac519a5ad9e45937f656012d33c09e9d9dec00b03fbb304e797f8991bb823dce676ac91e03a55991b

```

--------------------------------

### Clone and Use TRONLink Skills Repository

Source: https://docs.tronlink.org/ai-support/tronlink-skills

This command clones the TRONLink skills repository and allows direct usage of skills without needing an npm install for read-only operations.

```bash
# Clone and use directly
git clone <repo>
cd tronlink-skills
claude   # Auto-discovers SKILL.md files

```

--------------------------------

### Ledger Signed Transaction Body Example

Source: https://docs.tronlink.org/plugin-wallet/ledger-signing-update

Illustrates the structure of a successfully signed Ledger transaction body before and after the signature adaptation. The change affects the trailing bytes of the signature field.

```json
{
    "txID": "......",
    .....other property,
    "signature": [
        "......01"
    ]
}
```

```json
{
    "txID": "......",
    .....other property,
    "signature": [
        "......1c"
    ]
}
```

--------------------------------

### Get TronLink Provider via TIP-6963

Source: https://docs.tronlink.org/plugin-wallet/active-requests

Specification to ensure a DApp can obtain a specific wallet provider when multiple wallets exist simultaneously.

```APIDOC
## TIP-6963

### Description
This specification is implemented to ensure that a DApp can obtain a specific wallet provider when multiple wallets exist simultaneously and may compete to occupy the `window.tron` object.

### Method
(Not specified in the provided text)

### Endpoint
(Not specified in the provided text)

### Parameters
(Not specified in the provided text)

### Request Example
(Not specified in the provided text)

### Response
(Not specified in the provided text)
```

--------------------------------

### Initiate Sign Message Request

Source: https://docs.tronlink.org/mobile/deeplink

Use this link to trigger the TronLink application to sign a message. Ensure TronLink is installed and accessible.

```html
// Tronlink-v4.11.0
    <a href='tronlinkoutside://pull.activity?param={}'>Sign message</a>
```

--------------------------------

### TronLink Account Change Return Values

Source: https://docs.tronlink.org/plugin-wallet/passive-messages

Examples of the return values for the `accountsChanged` event, showing different scenarios like login, account switch, and wallet lock.

```javascript
['your_current_account_address']
```

```javascript
['TZ5XixnRyraxJJy996Q1sip85PHWuj4793']
```

```javascript
['TRKb2nAnCBfwxnLxgoKJro6VbyA6QmsuXq']
```

```javascript
[]
```

--------------------------------

### Sign a Hex Message with TronWeb

Source: https://docs.tronlink.org/plugin-wallet/active-requests

This code example shows how to sign a hexadecimal message using TronLink. The signed message can be used for backend verification to authenticate users. Ensure the DApp has website connection authorization.

```javascript
if (window.tronLink.ready) {
  const tronweb = tronLink.tronWeb;

  try {
    const message = "0x01EF";
    const signedString = await tronweb.trx.signMessageV2(message);
  } catch (e) {}
}

```

```plaintext
0xaa302ca153b10dff25b5f00a7e2f603c5916b8f6d78cdaf2122e24cab56ad39a79f60ff3916dde9761baaadea439b567475dde183ee3f8530b4cc76082b29c341c

```

```plaintext
Uncaught (in promise) Invalid transaction provided

```

--------------------------------

### Request TronLink Account Connection (TIP-1102)

Source: https://docs.tronlink.org/plugin-wallet/active-requests

Use this method to proactively connect to TronLink and request user authorization for account access. It follows the Ethereum EIP-1102 protocol. Ensure TronLink is installed and unlocked before calling.

```javascript
try {
  await tron.request({method: 'eth_requestAccounts'});
} catch (e) {}

```

--------------------------------

### Automation Tools (tl_ prefix)

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

List of available automation tools for UI interaction and session management.

```APIDOC
## Automation Tools

### Description
Tools prefixed with `tl_` used for browser automation, UI interaction, and state management.

### Categories
- **Session Management**: `tl_launch`, `tl_cleanup`
- **State & Discovery**: `tl_get_state`, `tl_describe_screen`, `tl_list_testids`, `tl_accessibility_snapshot`
- **UI Interaction**: `tl_click`, `tl_type`, `tl_wait_for`, `tl_scroll`, `tl_keyboard`, `tl_evaluate`
- **Knowledge Store**: `tl_knowledge_last`, `tl_knowledge_search`, `tl_knowledge_summarize`, `tl_knowledge_sessions`
```

--------------------------------

### Launch DApp in Explorer

Source: https://docs.tronlink.org/mobile/deeplink

Open a specific DApp URL within the TronLink DApp explorer.

```html
<a href='tronlinkoutside://pull.activity?param={}'>Open DApp</a>
```

```json
{
    "url": "https://www.tronlink.org/", //target DApp
    "action": "open",
    "protocol": "tronlink",
    "version": "1.0"
}
```

--------------------------------

### Error Message for Invalid Transaction

Source: https://docs.tronlink.org/dapp/message-signing

This is an example of an error message that may be returned if an invalid transaction is provided to the signing function.

```plaintext
    Uncaught (in promise) Invalid transaction provided

```

--------------------------------

### Listen for User Proactively Connected Website (Legacy)

Source: https://docs.tronlink.org/plugin-wallet/passive-messages

This listener handles the legacy `connectWeb` event, which is emitted when the user proactively connects to the website.

```javascript
window.addEventListener('message', function (e) {
  if (e.data.message && e.data.message.action == "connectWeb") {
      // handler logic
      console.log('got connectWeb event', e.data)
  }
})
```

--------------------------------

### Listen for User Confirmed Connection (Legacy)

Source: https://docs.tronlink.org/plugin-wallet/passive-messages

Use this listener for the legacy `acceptWeb` event, which indicates that the user has confirmed a connection request.

```javascript
window.addEventListener('message', function (e) {
  if (e.data.message && e.data.message.action == "acceptWeb") {
      // handler logic
      console.log('got acceptWeb event', e.data)
  }
})
```

--------------------------------

### Launch TronLink Wallet

Source: https://docs.tronlink.org/mobile/deeplink

Use a custom URI scheme to open the TronLink application.

```html
<a href='tronlinkoutside://pull.activity?param={}'>Open Tronlink</a>
```

```json
{
    "action": "open",
    "protocol": "tronlink",
    "version": "1.0"
}
```

--------------------------------

### FixtureCapability Interface

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Interface for managing wallet state presets and persistence.

```typescript
interface FixtureCapability {
  applyPreset(preset: string): Promise<void>
  getAvailablePresets(): string[]
  exportState(): Promise<WalletState>
  importState(state: WalletState): Promise<void>
}
```

--------------------------------

### Knowledge Store Storage Structure

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

The directory structure for session artifacts and step logs.

```text
test-artifacts/llm-knowledge/
├── tl-1741504523/
│   ├── session.json
│   └── steps/
│       ├── 2026-03-09T10-15-23-456Z-tl_click.json
│       └── ...
└── tl-1741504600/
    └── ...
```

--------------------------------

### Set TRONGrid API Key and Network

Source: https://docs.tronlink.org/ai-support/tronlink-skills

Configure optional environment variables for TRONGrid API key to increase rate limits and to switch between TRON networks like mainnet, shasta, or nile.

```bash
# Optional: TronGrid API key for higher rate limits
export TRONGRID_API_KEY="your-api-key"

# Optional: Switch network (default: mainnet)
export TRON_NETWORK="mainnet"    # or "shasta" / "nile"

```

--------------------------------

### BuildCapability Interface

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Interface for building the TronLink extension from source.

```typescript
interface BuildCapability {
  build(options?: BuildOptions): Promise<BuildResult>
}
```

--------------------------------

### Announce and Listen for TronLink Provider

Source: https://docs.tronlink.org/plugin-wallet/active-requests

This code demonstrates how a DApp can listen for the TIP6963:announceProvider event to obtain the TronLink provider. It includes checks to confirm the provider is indeed TronLink and sets up an event listener for account changes.

```typescript
interface TIP1193Provider {
  request: (args: RequestArguments) => Promise<unknown>;
  on(event: string, listener: (...args: any[]) => void): this;
  removeListener(event: string, listener: (...args: any[]) => void): this;
  tronWeb: TronWeb;
  [key: `is${string}`]: boolean;
}

/**
 * Represents the assets needed to display a wallet
 */
interface TIP6963ProviderInfo {
  uuid: string;
  name: string;
  icon: string;
  rdns: string;
}

interface TIP6963ProviderDetail {
  info: TIP6963ProviderInfo;
  provider: TIP1193Provider;
}

// Announce Event dispatched by a Wallet
interface TIP6963AnnounceProviderEvent extends CustomEvent {
  type: "TIP6963:announceProvider";
  detail: TIP6963ProviderDetail;
}

// The DApp listens to announced providers
window.addEventListener(
  "TIP6963:announceProvider",
  (event: TIP6963AnnounceProviderEvent) => {

    // Confirm if it is a Tronlink UUID
    if (event.detail.info.rdns !== 'org.tronlink.www' || event.detail.info.name !== 'TronLink') {
      console.error('it is NOT TronLink provider');
      return;
    }

    // event.detail.provider === window.tron
    const tronProvider = event.detail.provider;

    tronProvider.on('accountsChanged', (accountArray) => {
      console.log('tip-6963 accountsChanged', accountArray);
    })
  }
);

// The DApp dispatches a request event which will be heard by 
// Wallets' code that had run earlier
window.dispatchEvent(new Event("TIP6963:requestProvider"));

```

--------------------------------

### Element Targeting Methods

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Three ways to target UI elements for interaction.

```javascript
// 1. Accessibility Reference (recommended)
tl_click({ a11yRef: "e5" })

// 2. data-testid
tl_click({ testId: "send-button" })

// 3. CSS Selector
tl_click({ selector: ".confirm-btn" })
```

--------------------------------

### TronLink MCP Server Dependencies

Source: https://docs.tronlink.org/ai-support/mcp-server-tronlink

Lists the key packages and their purposes for the TronLink MCP server.

```markdown
Package | Version | Purpose  
---|---|---
`@noble/curves` | ^2.0.1 | secp256k1 ECDSA signing  
`@noble/hashes` | ^2.0.1 | Keccak-256, SHA256  
`@tronlink/tronlink-mcp-core` | local | Core MCP server framework  
`playwright` | ^1.49.0 | Browser automation  
`@bankofai/agent-wallet` | latest | Encrypted local wallet management (`local_secure`)  
`ws` | ^8.18.0 | WebSocket (multi-sig monitoring)  

```

--------------------------------

### TronLink Skills Project Structure

Source: https://docs.tronlink.org/ai-support/tronlink-skills

This is the directory structure for the TronLink Skills project. It includes scripts, skill definitions, documentation, and configuration files.

```bash
tronlink-skills/
├── README.md                          # Main documentation
├── package.json                       # Node.js manifest
├── install.sh                         # Auto-install for all AI environments
├── uninstall.sh                       # Clean uninstall
│
├── scripts/
│   ├── tron_api.mjs                   # Main CLI (34 commands, zero dependencies)
│   └── mcp_server.mjs                 # MCP protocol server wrapper
│
├── skills/                            # Skill definitions (auto-discovered)
│   ├── tron-wallet/SKILL.md
│   ├── tron-token/SKILL.md
│   ├── tron-market/SKILL.md
│   ├── tron-swap/SKILL.md
│   ├── tron-resource/SKILL.md
│   └── tron-staking/SKILL.md
│
├── docs/
│   ├── claude-integration-guide.md    # 3 integration methods
│   ├── resource-model.md              # Energy & Bandwidth deep dive
│   ├── staking-guide.md               # Stake 2.0 & APY explanation
│   └── integration-guide.sh
│
├── .claude-plugin/                    # Claude Code plugin config
├── .cursor-plugin/                    # Cursor IDE plugin config
├── .opencode/                         # OpenCode config
├── .codex/                            # Codex CLI setup
├── .claude/                           # Pre-configured test commands
├── _meta.json                         # Metadata for skill registries
└── LICENSE                            # MIT

```

--------------------------------

### Project-Level MCP Config (Direct API Tools)

Source: https://docs.tronlink.org/ai-support/mcp-server-tronlink

Project-level MCP configuration for direct API tools, omitting Playwright-specific settings. This is suitable when browser automation is not required.

```json
{
  "mcpServers": {
    "tronlink": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": ".",
      "env": {
        "TL_TRONGRID_URL": "https://nile.trongrid.io",
        "AGENT_WALLET_PASSWORD": "your-wallet-password",
        "TL_MULTISIG_BASE_URL": "https://apinile.walletadapter.org",
        "TL_MULTISIG_SECRET_ID": "TEST",
        "TL_MULTISIG_SECRET_KEY": "TESTTESTTEST",
        "TL_MULTISIG_CHANNEL": "test",
        "TL_GASFREE_BASE_URL": "https://open-test-gasfree.io/nile/",
        "TL_GASFREE_API_KEY": "your_gasfree_api_key",
        "TL_GASFREE_API_SECRET": "your_gasfree_api_secret"
      }
    }
  }
}
```

--------------------------------

### TronLink MCP Core Build and Development Commands

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

These npm scripts are used for building, developing, testing, and maintaining the TronLink MCP Core project. They cover compilation, watch mode, testing, linting, and cleanup.

```bash
npm run build      # Compile TypeScript to dist/
npm run dev        # Watch mode
npm run test       # Run Vitest tests
npm run lint       # ESLint
npm run clean      # Remove dist/

```

--------------------------------

### Register as MCP Server

Source: https://docs.tronlink.org/ai-support/tronlink-skills

Registering TRONLink as an MCP server provides 25 MCP tools that can be called by Claude Desktop or Claude Code.

```bash
# Register as MCP server
claude mcp add tronlink -- node ~/.tronlink-skills/scripts/mcp_server.mjs

```

--------------------------------

### Initiate a TRX Transfer

Source: https://docs.tronlink.org/dapp/transfer

Uses tronWeb to build a transaction, requests a signature from the TronLink wallet, and broadcasts the signed transaction.

```javascript
    if (window.tronLink.ready) {
      const tronweb = tronLink.tronWeb;
      const fromAddress = tronweb.defaultAddress.base58;
      const toAddress = "TAHQdDiZajMMP26STUnfsiRMNyXdxAJakZ";
      const tx = await tronweb.transactionBuilder.sendTrx(toAddress, 10, fromAddress); // Step1
      try {
        const signedTx = await tronweb.trx.sign(tx); // Step2
        await tronweb.trx.sendRawTransaction(signedTx); // Step3
      } catch (e) {
        // error handling
      }
    }
```

--------------------------------

### Event: connect

Source: https://docs.tronlink.org/plugin-wallet/passive-messages

Triggered when the provider initializes or reconnects to a chain.

```APIDOC
## Event: connect

### Description
Emitted when the TronLink provider is available and connected to a chain.

### Usage
```javascript
window.tron.on('connect', ({chainId}) => {
  console.log('got connect event', chainId)
})
```
```

--------------------------------

### Claude Desktop MCP Config

Source: https://docs.tronlink.org/ai-support/mcp-server-tronlink

Configuration for TronLink within Claude Desktop, specifying the command and arguments. Ensure the path to the index.js file is absolute.

```json
{
  "mcpServers": {
    "tronlink": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": { ... }
    }
  }
}
```

--------------------------------

### TronWeb Message Signing Request

Source: https://docs.tronlink.org/plugin-wallet/ledger-signing-update

Demonstrates how to initiate a message signing request using tron.tronWeb.trx.sign or tron.tronWeb.trx.signMessageV2. The actual signature hash returned by Ledger will be modified.

```javascript
tron.tronWeb.trx.sign('.....unsign_string');
```

```javascript
tron.tronWeb.trx.signMessageV2('.....unsign_string');
```

--------------------------------

### Flow Recipe Structure

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Defines multi-step workflows with parameters and execution steps.

```javascript
{
  id: "transfer_trx",
  name: "Send TRX",
  description: "Transfer TRX to another address",
  context: "both",                      // "playwright" | "api" | "both"
  preconditions: ["wallet unlocked"],
  params: [
    { name: "recipient", description: "Target TRON address", required: true },
    { name: "amount", description: "TRX amount", required: true }
  ],
  steps: [
    { tool: "navigate", input: { target: "send" } },
    { tool: "type", input: { testId: "address-input", text: "{{recipient}}" } },
    { tool: "type", input: { testId: "amount-input", text: "{{amount}}" } },
    { tool: "click", input: { a11yRef: "e5" } }
  ],
  tags: ["transfer", "basic"]
}
```

--------------------------------

### ISessionManager Environment Methods

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Methods for managing the environment mode and context.

```typescript
getEnvironmentMode(): 'e2e' | 'prod'
setContext(context: string, options?: any): Promise<void>
getContextInfo(): ContextInfo
```

--------------------------------

### Direct Command Execution with TRON API

Source: https://docs.tronlink.org/ai-support/tronlink-skills

Execute TRON API commands directly using Node.js scripts for various operations like checking wallet balance, token price, and swap quotes.

```bash
# Direct command execution
node scripts/tron_api.mjs wallet-balance --address TAddress...
node scripts/tron_api.mjs token-price --token USDT
node scripts/tron_api.mjs swap-quote --from TRX --to USDT --amount 100

```

--------------------------------

### Connect Website (Legacy)

Source: https://docs.tronlink.org/plugin-wallet/active-requests

Deprecated method for connecting websites, used for external TRX transfer, contract signing, and authorization.

```APIDOC
## POST /tron_requestAccounts

### Description
This is a deprecated method for connecting websites. It provides external TRX transfer, contract signing, and authorization functions. Users must authorize the requesting DApp before critical operations.

### Method
POST

### Endpoint
tron_requestAccounts

### Parameters
#### Query Parameters
- **None**

#### Request Body
- **method** (string) - Required - Fixed string `tron_requestAccounts`.
- **params** (object) - Optional - Parameters for the request.
  - **websiteIcon** (string) - Optional - DApp website icon URI (displayed in connected site list).
  - **websiteName** (string) - Optional - DApp website name.

### Request Example
```javascript
const res = await tronWeb.request({
  method: 'tron_requestAccounts',
  params: {
    websiteIcon: '<WEBSITE ICON URI>',
    websiteName: '<WEBSITE NAME>',
  }
});
```

### Response
#### Success Response (200)
- **code** (number) - 200 indicates success.
- **message** (string) - Message describing the result of the authorization.

#### Response Example
```json
{
  "code": 200,
  "message": "User approved connection"
}
```

#### Error Codes
- **None** (Wallet locked): Returns an empty string for the message when the wallet is locked.
- **4000** (Duplicate authorization request pending): Authorization requests are being processed, please do not resubmit.
- **4001** (User rejected connection): User rejected the request.
```

--------------------------------

### ContractSeedingCapability API

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Endpoints for deploying and managing smart contracts.

```APIDOC
## ContractSeedingCapability

### Description
Handles deployment of various smart contract types including TRC20, TRC721, and multisig contracts.

### Methods
- **seedContract(type, options)**: Deploys a single contract.
- **seedContracts(specs)**: Deploys multiple contracts based on specifications.
- **getContractAddress(name)**: Retrieves the address of a deployed contract by name.
- **listContracts()**: Returns a list of all deployed contracts.
```

--------------------------------

### Sign a Hex Message with TronLink

Source: https://docs.tronlink.org/dapp/message-signing

Use tronweb.trx.signMessageV2 to sign a hex message after connecting the wallet. Ensure window.tronLink.ready is true before proceeding. An exception will be thrown if the user rejects the signature request.

```javascript
    if (window.tronLink.ready) {
      const tronweb = tronLink.tronWeb;
      try {
        const message = "0x1e"; // any hex string
        const signedString = await tronweb.trx.signMessageV2(message);
      } catch (e) {}
    }

```

--------------------------------

### Listen for User Rejected Connection (Legacy)

Source: https://docs.tronlink.org/plugin-wallet/passive-messages

Use this event listener to detect when a user rejects a connection request from the DApp via the TronLink popup. This is a legacy message.

```javascript
window.addEventListener('message', function (e) {
  if (e.data.message && e.data.message.action == "rejectWeb") {
      // handler logic
      console.log('got rejectWeb event', e.data)
  }
})
```

--------------------------------

### TronLink MCP Server Project Structure

Source: https://docs.tronlink.org/ai-support/mcp-server-tronlink

Overview of the directory and file organization for the TronLink MCP server project.

```tree
mcp-server-tronlink/
├── src/
│   ├── index.ts                    # Server entry, config, capability registration
│   ├── wallet.ts                   # Encrypted wallet loading and password handling
│   ├── wallet-tools.ts             # Wallet list/create/switch tools
│   ├── session-manager.ts          # Browser lifecycle (TronLinkSessionManager)
│   ├── capabilities/
│   │   ├── on-chain.ts             # 14 on-chain operations (TronGrid)
│   │   ├── multisig.ts             # 5 multi-sig operations (REST + WS)
│   │   ├── gasfree.ts              # 3 gas-free transfer operations
│   │   ├── build.ts                # Extension webpack build
│   │   ├── state-snapshot.ts       # UI state extraction
│   │   └── tron-crypto.ts          # Address derivation, signing, Base58
│   └── flows/
│       ├── index.ts                # Flow registry (32 recipes)
│       ├── switch-network.ts       # Network switching flows
│       ├── transfer-trx.ts         # Transfer flows
│       ├── multisig.ts             # 6 multi-sig flows
│       ├── onchain.ts              # 11 on-chain flows
│       └── gasfree.ts              # 3 gas-free flows
├── dist/                           # Compiled output
├── .mcp.json                       # MCP configuration
├── .env.example                    # Environment variable reference
├── package.json
├── tsconfig.json
└── README.md

```

--------------------------------

### Legacy Compatibility Events

Source: https://docs.tronlink.org/plugin-wallet/passive-messages

Events retained for compatibility with version 3.x (rejectWeb, disconnectWeb, acceptWeb, connectWeb).

```APIDOC
## Legacy Compatibility Events

### Description
Events for connection lifecycle management (rejectWeb, disconnectWeb, acceptWeb, connectWeb).

### Usage
```javascript
window.addEventListener('message', function (e) {
  if (e.data.message && e.data.message.action == "rejectWeb") {
      console.log('got rejectWeb event', e.data)
  }
})
```
```

--------------------------------

### Connect Website TIP-1102

Source: https://docs.tronlink.org/plugin-wallet/active-requests

Proactively requests a TronLink connection and user authorization for signature operations. Follows Ethereum EIP-1102 protocol.

```APIDOC
## POST /eth_requestAccounts

### Description
Proactively requests a TronLink connection and user authorization for signature operations. This method follows the Ethereum EIP-1102 protocol.

### Method
POST

### Endpoint
eth_requestAccounts

### Parameters
#### Query Parameters
- **None**

#### Request Body
- **None**

### Request Example
```javascript
try {
  await tron.request({method: 'eth_requestAccounts'});
} catch (e) {}
```

### Response
#### Success Response (200)
- **account** (string) - The currently approved TronLink account address.

#### Response Example
```json
["TMVQGm1qAQYVdetCeGRRkTWYYrLXuHK2HC"]
```

#### Error Codes
- **4001** (User rejected request): Triggered when the user clicks “Reject” or closes the popup.
- **-32002** (Another process in progress): Another DApp process is ongoing, request cannot execute.
- **-32602** (Invalid parameters): Invalid or extra parameters were provided.
- **4200** (Method not supported): This method is not supported.
```

--------------------------------

### Wallet Management API

Source: https://docs.tronlink.org/ai-support/mcp-server-tronlink

Runtime wallet management using `@bankofai/agent-wallet` with encrypted local storage. Supports listing, creating, and setting active wallets.

```APIDOC
## Wallet Management API

### Description
Runtime wallet management via `@bankofai/agent-wallet` (encrypted `local_secure` storage).

### Tools
- `tl_wallet_list`: List all wallets with IDs, types, active status, and TRON addresses.
- `tl_wallet_create`: Auto-generate an encrypted wallet and attach it to the running MCP session.
- `tl_wallet_set_active`: Switch the active wallet by ID (hot-swaps into all capabilities).

### Wallet Initialization
If no wallet exists at startup, the server prompts two paths:
1. Call `tl_wallet_create` to auto-generate one.
2. Create one manually via CLI and set `AGENT_WALLET_PASSWORD`.

The auto-create path generates a random password, saves it to `~/.agent-wallet/runtime_secrets.json`, creates an encrypted `main` wallet, and enables the running session to use it.
```

--------------------------------

### Standardized Tool Response Format

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

All tools return a consistent JSON structure for success and error states.

```javascript
// Success
{
  ok: true,
  result: { /* tool-specific data */ },
  meta: {
    timestamp: "2026-03-09T10:15:23.456Z",
    sessionId: "tl-1741504523",
    durationMs: 234
  }
}

// Error
{
  ok: false,
  error: {
    code: "TL_CLICK_FAILED",       // One of 25+ error codes
    message: "Element not found",
    details: { /* optional */ }
  },
  meta: { timestamp, sessionId, durationMs }
}
```

--------------------------------

### Retrieve tronWeb Instance

Source: https://docs.tronlink.org/dapp/getting-started

Checks if the user is already connected to the DApp; if not, it requests account access before returning the tronWeb instance.

```javascript
    async function getTronWeb() {
      let tronWeb;
      if (window.tronLink.ready) {
        tronWeb = tronLink.tronWeb;
      } else {
        const res = await tronLink.request({ method: 'tron_requestAccounts' });
        if (res.code === 200) {
          tronWeb = tronLink.tronWeb;
        }
      }
      return tronWeb;
    }
```

--------------------------------

### Define ContractSeedingCapability Interface

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Interface for deploying and managing smart contracts.

```typescript
interface ContractSeedingCapability {
  seedContract(type: string, options?: any): Promise<ContractInfo>
  seedContracts(specs: ContractSpec[]): Promise<ContractInfo[]>
  getContractAddress(name: string): string | undefined
  listContracts(): ContractInfo[]
}
```

--------------------------------

### Listen for User Disconnected Website (Legacy)

Source: https://docs.tronlink.org/plugin-wallet/passive-messages

This listener is for the legacy `disconnectWeb` event, which is triggered when the user manually disconnects the website from TronLink.

```javascript
window.addEventListener('message', function (e) {
  if (e.data.message && e.data.message.action == "disconnectWeb") {
      // handler logic
      console.log('got disconnectWeb event', e.data)
  }
})
```

--------------------------------

### Define MultiSigCapability Interface

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Interface for multi-signature service integration.

```typescript
interface MultiSigCapability {
  queryAuth(address: string): Promise<AuthResult>
  submitTransaction(params: SubmitParams): Promise<SubmitResult>
  queryTransactionList(params: ListParams): Promise<TxListResult>
  connectWebSocket(params: WsParams): Promise<void>
  disconnectWebSocket(): Promise<void>
}
```

--------------------------------

### ISessionManager Session Lifecycle Methods

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Methods for managing the lifecycle of a session, including launching and cleanup.

```typescript
hasActiveSession(): boolean
getSessionId(): string
getSessionState(): SessionState
getSessionMetadata(): SessionMetadata
launch(input: LaunchInput): Promise<LaunchResult>
cleanup(): Promise<void>
```

--------------------------------

### ISessionManager Screenshot Method

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Captures a screenshot of the current session state.

```typescript
screenshot(options?: ScreenshotOptions): Promise<ScreenshotResult>
```

--------------------------------

### Define StateSnapshotCapability Interface

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Interface for extracting wallet state from the UI.

```typescript
interface StateSnapshotCapability {
  getSnapshot(): Promise<StateSnapshot>  // screen, address, balance, energy, bandwidth
}
```

--------------------------------

### ISessionManager Navigation Methods

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Methods for navigating to specific areas of the TronLink interface.

```typescript
navigateToHome(): Promise<void>
navigateToSettings(): Promise<void>
navigateToUrl(url: string): Promise<void>
navigateToNotification(): Promise<void>
waitForNotificationPage(timeoutMs?: number): Promise<Page>
```

--------------------------------

### Perform Multi-Signature Transfer

Source: https://docs.tronlink.org/dapp/multi-sign-transfer

Initiates a multi-signature transaction, prompts the user for signing, and broadcasts the raw transaction. Ensure TronLink is ready before execution.

```javascript
    if (window.tronLink.ready) {
      const tronweb = tronLink.tronWeb;
      const toAddress = "TRKb2nAnCBfwxnLxgoKJro6VbyA6QmsuXq";
      const activePermissionId = 2;
      const tx = await tronweb.transactionBuilder.sendTrx(
        toAddress, 10,
        { permissionId: activePermissionId}
      ); // step 1
      try {
        const signedTx = await tronweb.trx.multiSign(tx, undefined, activePermissionId); // step 2
        await tronweb.trx.sendRawTransaction(signedTx); // step 3
      } catch (e) {}
    }

```

--------------------------------

### ISessionManager Accessibility Reference Methods

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Methods for managing accessibility references and mapping.

```typescript
setRefMap(map: Map<string, any>): void
getRefMap(): Map<string, any>
clearRefMap(): void
resolveA11yRef(ref: string): any
```

--------------------------------

### Login and Request Address

Source: https://docs.tronlink.org/mobile/deeplink

Request user authentication and wallet address from TronLink.

```html
<a href='tronlinkoutside://pull.activity?param={}'>Login/Request Address</a>
```

```json
{
  "url": "https://justlend.org/#/home",
  "callbackUrl": "http://xxx/api/tron/v1/callback",
  "dappIcon": "https://test/icon.png",
  "dappName": "Test demo",
  "protocol": "TronLink",
  "version": "1.0",
  "chainId": "0x2b6653dc",
  "action": "login",
  "actionId": "e5471a9c-b0f1-418b-8634-3de60d68a288"
}
```

```json
{
  "actionId": "e5471a9c-b0f1-418b-8634-3de60d68a288",
  "address": "TSPrmJetAMo6S6RxMd4tswzeRCFVegBNig",
  "code": 0,
  "id": 1780812177,
  "message": "success"
}
```

--------------------------------

### Listen for TronLink Service Connection

Source: https://docs.tronlink.org/plugin-wallet/passive-messages

This event is emitted when TronLink is available and connects to a chain. It's useful for initializing DApp functionality after TronLink is ready.

```javascript
window.tron.on('connect', ({chainId}) => {
  // handler logic
  console.log('got accountsChanged event', chainId)
})
```

--------------------------------

### Capability Interfaces

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Definitions for the pluggable capability interfaces used to extend the functionality of the MCP server.

```APIDOC
## Capability Interfaces

### BuildCapability
- **build(options?: BuildOptions)**: Promise<BuildResult> - Builds the TronLink extension from source.

### FixtureCapability
- **applyPreset(preset: string)**: Promise<void> - Applies a specific wallet state preset.
- **getAvailablePresets()**: string[] - Returns a list of available wallet state presets.
- **exportState()**: Promise<WalletState> - Exports the current wallet state.
- **importState(state: WalletState)**: Promise<void> - Imports a wallet state into the current session.
```

--------------------------------

### OnChainCapability API

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

Endpoints for direct on-chain operations via TronGrid REST API.

```APIDOC
## OnChainCapability

### Description
Facilitates direct blockchain interactions such as transfers, staking, and multisig management.

### Methods
- **getAddress()**: Retrieves the current wallet address.
- **getAccount(address)**: Fetches account details.
- **send(params)**: Executes a transaction.
- **stake(params)**: Performs staking operations.
- **swap(params)**: Executes a token swap.
```

--------------------------------

### Listen for TronLink Account Changes

Source: https://docs.tronlink.org/plugin-wallet/passive-messages

Use this event listener to detect when the user's Tron account changes. This includes login, account switching, and wallet locking events.

```javascript
window.tron.on('accountsChanged', (accountArray) => {
  // handler logic
  console.log('got accountsChanged event', accountArray)
})
```

--------------------------------

### TronLink MCP Core Project Structure

Source: https://docs.tronlink.org/ai-support/tronlink-mcp-core

This tree displays the directory and file organization for the TronLink MCP Core project. It shows the location of source files, compiled output, and configuration files.

```tree
tronlink-mcp-core/
├── src/
│   ├── index.ts                           # Public API exports
│   ├── mcp-server/
│   │   ├── server.ts                      # createMcpServer() factory
│   │   ├── session-manager.ts             # ISessionManager interface
│   │   ├── knowledge-store.ts             # Persistent step recording
│   │   ├── discovery.ts                   # Page inspection utilities
│   │   ├── schemas.ts                     # Zod validation schemas
│   │   ├── constants.ts                   # TIMEOUTS, LIMITS, URLs, SCREENS
│   │   ├── tools/
│   │   │   ├── definitions.ts             # Tool registry & routing
│   │   │   ├── run-tool.ts                # Execution wrapper (auto-logs)
│   │   │   ├── launch.ts                  # tl_launch
│   │   │   ├── cleanup.ts                 # tl_cleanup
│   │   │   ├── state.ts                   # tl_get_state
│   │   │   ├── navigation.ts              # Navigation tools
│   │   │   ├── interaction.ts             # UI interaction tools
│   │   │   ├── discovery-tools.ts         # Element discovery
│   │   │   ├── screenshot.ts              # Screenshot capture
│   │   │   ├── on-chain.ts                # 14 on-chain tools
│   │   │   ├── multisig.ts                # 5 multisig tools
│   │   │   ├── gasfree.ts                 # 3 gasfree tools
│   │   │   ├── knowledge.ts               # Knowledge store tools
│   │   │   ├── flows.ts                   # Flow listing
│   │   │   ├── batch.ts                   # Batch execution
│   │   │   └── helpers.ts                 # Shared utilities
│   │   ├── types/
│   │   │   ├── responses.ts               # McpResponse types
│   │   │   ├── errors.ts                  # ErrorCodes enum
│   │   │   ├── session.ts                 # Session types
│   │   │   ├── step-record.ts             # Step recording types
│   │   │   ├── tool-inputs.ts             # All tool input types
│   │   │   └── tool-outputs.ts            # All tool output types
│   │   └── utils/
│   │       ├── response.ts                # createSuccessResponse / createErrorResponse
│   │       ├── errors.ts                  # extractErrorMessage
│   │       └── zod-to-json-schema.ts      # Zod → JSON Schema conversion
│   ├── capabilities/
│   │   ├── types.ts                       # 9 capability interfaces
│   │   └── context.ts                     # Environment config types
│   ├── flows/
│   │   ├── types.ts                       # FlowRecipe, FlowParam types
│   │   └── registry.ts                    # FlowRegistry class
│   ├── launcher/
│   │   ├── extension-id-resolver.ts       # Extension ID extraction
│   │   └── extension-readiness.ts         # Extension load detection
│   └── utils/
│       └── index.ts                       # generateSessionId, etc.
├── dist/                                  # Compiled output + .d.ts
├── package.json
├── tsconfig.json
└── README.md

```

--------------------------------

### Perform Transfer

Source: https://docs.tronlink.org/mobile/deeplink

Initiate a token transfer request via DeepLink.

```html
<a href='tronlinkoutside://pull.activity?param={}'>Transfer</a>
```

```json
{
    "url": "https://justlend.org/#/home",
    "callbackUrl": "http://3.12.131.175:7777/api/tron/v1/callback",
    "dappIcon": "https://test/icon.png",
    "dappName": "Test demo",
    "protocol": "TronLink",
    "version": "1.0",
    "chainId": "0x2b6653dc",
    "memo": "Reward",
    "from": "TSPrmJetAMo6S6RxMd4tswzeRCFVegBNig",
    "to": "TXd9duqtcyyj4pBCKvXKNqmazxxDw5SdBa",
    "loginAddress": "TSPrmJetAMo6S6RxMd4tswzeRCFVegBNig",
    "tokenId": "0",
    "contract": "",
    "amount": "20",
    "action": "transfer",
    "actionId": "408170fc-7919-4459-be5e-05a9d4b4065e"
  }
```

```json
{
    "actionId": "099482f0-ee12-4703-bb7b-2e9d8c7c61a1",
    "code": 0,
    "id": 1142367107,
    "message": "success",
    "transactionHash": "e8ffe9b92c771e66999732b810bf2493be389464191040d8666a26dc449fa5f0"
  }
```

--------------------------------

### Request TronLink Account Connection (Legacy)

Source: https://docs.tronlink.org/plugin-wallet/active-requests

This is a deprecated method for connecting to TronLink and authorizing a DApp. It is recommended to use the TIP-1102 method instead. This method requires website icon and name for display in the TronLink interface.

```javascript
const res = await tronWeb.request(
  {
    method: 'tron_requestAccounts',
    params: {
      websiteIcon: '<WEBSITE ICON URI>',
      websiteName: '<WEBSITE NAME>',
    } as RequestAccountParams,
  }
);

```

--------------------------------

### Switch Network via wallet_switchEthereumChain

Source: https://docs.tronlink.org/plugin-wallet/active-requests

Request to switch the DApp's active network chain in TronLink.

```javascript
try {
  await tronLink.request({
    method: 'wallet_switchEthereumChain',
    params: [{chainId: '0x2b6653dc'}]
  });
} catch (e) {}
```

--------------------------------

### Set screen orientation in TronLink

Source: https://docs.tronlink.org/mobile/dapp-support

Configures the screen orientation for a specific DApp URL. Use '1' for vertical and '2' for horizontal orientation.

```java
  // url: DApp page url
  // screenModel: "1" -> vertical;"2" -> horizontal
  void setScreenModel(String url, String screenModel)
```
Tokens:
Raw