@bankofai/mcp-server-tron 1.1.1

package/build/core/prompts.js

@@ -0,0 +1,468 @@
+import { z } from "zod";
+/**
+ * Register task-oriented prompts with the MCP server
+ *
+ * All prompts follow a consistent structure:
+ * - Clear objective statement
+ * - Step-by-step instructions
+ * - Expected outputs
+ * - Safety/security considerations
+ *
+ * Prompts guide the model through complex workflows that would otherwise
+ * require multiple tool calls in the correct sequence.
+ *
+ * @param server The MCP server instance
+ */
+export function registerTRONPrompts(server) {
+    // ============================================================================
+    // TRANSACTION PROMPTS
+    // ============================================================================
+    server.registerPrompt("prepare_transfer", {
+        description: "Safely prepare and execute a token transfer with validation checks",
+        argsSchema: {
+            tokenType: z
+                .enum(["trx", "trc20"])
+                .describe("Token type: 'trx' for native or 'trc20' for contract tokens"),
+            recipient: z.string().describe("Recipient address"),
+            amount: z.string().describe("Amount to transfer (in TRX or token units)"),
+            network: z.string().optional().describe("Network name (default: mainnet)"),
+            tokenAddress: z.string().optional().describe("Token contract address (required for TRC20)"),
+        },
+    }, ({ tokenType, recipient, amount, network = "mainnet", tokenAddress }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `# Token Transfer Task
+
+**Objective**: Safely transfer ${amount} ${tokenType === "trx" ? "TRX" : "TRC20 tokens"} to ${recipient} on ${network}
+
+## Validation & Checks
+Before executing any transfer:
+1. **Wallet Verification**: Call \`get_wallet_address\` to confirm the sending wallet
+2. **Balance Check**:
+   ${tokenType === "trx"
+                        ? "- Call `get_balance` to verify TRX balance"
+                        : `- Call \`get_token_balance\` with tokenAddress=${tokenAddress} to verify balance`}
+3. **Resource Analysis**: Call \`get_chain_parameters\` to assess current network costs (Energy/Bandwidth)
+
+## Execution Steps
+${tokenType === "trx"
+                        ? `
+1. Summarize: sender address, recipient, amount, and estimated cost
+2. Request confirmation from user
+3. Call \`transfer_trx\` with to="${recipient}", amount="${amount}", network="${network}"
+4. Return transaction hash to user
+5. Call \`get_transaction_info\` to confirm completion
+`
+                        : `
+1. Summarize: sender, recipient, token, amount
+2. Request confirmation
+3. Call \`transfer_trc20\` with tokenAddress, recipient, amount
+4. Wait for confirmation with \`get_transaction_info\`
+`}
+
+## Output Format
+- **Transaction Hash**: Clear hex value
+- **Status**: Pending or Confirmed
+- **User Confirmation**: Always ask before sending
+
+## Safety Considerations
+- Never send more than available balance
+- Double-check recipient address
+- Explain any approval requirements
+`,
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("interact_with_contract", {
+        description: "Safely execute write operations on a smart contract with validation and confirmation",
+        argsSchema: {
+            contractAddress: z.string().describe("Contract address to interact with"),
+            functionName: z.string().describe("Function to call (e.g., 'mint', 'swap', 'stake')"),
+            args: z.string().optional().describe("Comma-separated function arguments"),
+            value: z.string().optional().describe("TRX value to send (for payable functions)"),
+            network: z.string().optional().describe("Network name (default: mainnet)"),
+        },
+    }, ({ contractAddress, functionName, args, value, network = "mainnet" }) => {
+        const argsList = args ? args.split(",").map((a) => a.trim()) : [];
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `# Smart Contract Interaction
+
+**Objective**: Safely execute ${functionName} on contract ${contractAddress} on ${network}
+
+## Prerequisites Check
+
+### 1. Wallet Verification
+- Call \`get_wallet_address\` to confirm the wallet that will execute this transaction
+- Verify this is the correct wallet for this operation
+
+### 2. Contract Analysis
+- Use \`read_contract\` or external knowledge to understand the function parameters
+- Check function type:
+  * **View/Pure**: Read-only (use \`read_contract\` instead)
+  * **Nonpayable**: State-changing, no TRX required
+  * **Payable**: State-changing, can accept TRX
+
+### 3. Function Parameter Validation
+For function: **${functionName}**
+${argsList.length > 0 ? `Arguments provided: ${argsList.join(", ")}` : "No arguments provided"}
+
+- Verify parameter types match the contract requirements
+- Validate addresses are correct (Base58 or Hex)
+- Check numeric values are in correct units
+
+### 4. Pre-execution Checks
+
+**Balance Check**:
+- Call \`get_balance\` to verify sufficient TRX balance
+- Account for Energy/Bandwidth costs + value (if payable)
+
+**Resource Estimation**:
+- Call \`get_chain_parameters\` to check current unit prices
+- Estimate Energy and Bandwidth usage
+
+## Execution Process
+
+### 1. Present Summary to User
+Before executing, show:
+- **Contract**: ${contractAddress}
+- **Network**: ${network}
+- **Function**: ${functionName}
+- **Arguments**: ${argsList.length > 0 ? argsList.join(", ") : "None"}
+${value ? `- **Value**: ${value} TRX` : ""}
+- **From**: [wallet address from step 1]
+- **Estimated Resource Cost**: [Energy / Bandwidth estimation]
+
+### 2. Request User Confirmation
+⚠️ **IMPORTANT**: Always ask user to confirm before executing write operations
+- Clearly state what will happen
+- Show all costs involved
+- Explain any risks or irreversible actions
+
+### 3. Execute Transaction
+Only after user confirms:
+\`\`\`
+Call write_contract with:
+- contractAddress: "${contractAddress}"
+- functionName: "${functionName}"
+${argsList.length > 0 ? `- args: ${JSON.stringify(argsList)}` : ""}
+${value ? `- value: "${value}"` : ""}
+- network: "${network}"
+\`\`\`
+
+### 4. Monitor Transaction
+After execution:
+1. Return transaction hash to user
+2. Call \`get_transaction_info\` to verify success
+3. If failed, call \`diagnose_transaction\` to understand why
+
+## Output Format
+
+**Pre-Execution Summary**:
+- Contract details
+- Function and parameters
+- Cost breakdown
+- Risk assessment
+
+**Confirmation Request**:
+"Ready to execute ${functionName} on ${contractAddress}. Proceed? (yes/no)"
+
+**Execution Result**:
+- Transaction Hash: [hash]
+- Status: Pending/Confirmed/Failed
+- Energy Used: [actual energy used]
+- Bandwidth Used: [actual bandwidth used]
+
+## Safety Considerations
+
+### Critical Checks
+- ✅ Check function parameters are correct type and format
+- ✅ Ensure sufficient balance for fees + value
+- ✅ Validate addresses (no typos, correct network)
+- ✅ Understand what the function does before calling
+
+### Common Risks
+- **Irreversible**: Most blockchain transactions cannot be undone
+- **Fee Loss**: Failed transactions still consume Energy/Bandwidth
+- **Approval Risks**: Be careful with unlimited approvals
+- **Access Control**: Verify you have permission to call this function
+`,
+                    },
+                },
+            ],
+        };
+    });
+    server.registerPrompt("diagnose_transaction", {
+        description: "Analyze transaction status, failures, and provide debugging insights",
+        argsSchema: {
+            txHash: z.string().describe("Transaction hash to diagnose"),
+            network: z.string().optional().describe("Network name (default: mainnet)"),
+        },
+    }, ({ txHash, network = "mainnet" }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `# Transaction Diagnosis
+
+**Objective**: Analyze transaction ${txHash} on ${network} and identify any issues
+
+## Investigation Process
+
+### 1. Gather Transaction Data
+- Call \`get_transaction\` to fetch transaction details
+- Call \`get_transaction_info\` to get status and energy/bandwidth used
+- Note: both calls are read-only and free
+
+### 2. Status Assessment
+Determine transaction state:
+- **Pending**: Not yet mined
+- **Confirmed**: Successfully executed (contractRet='SUCCESS')
+- **Failed**: Execution failed (contractRet='REVERT' or other error)
+
+### 3. Failure Analysis
+If transaction failed, investigate:
+
+**Out of Energy**:
+- Check energy_usage vs energy_limit
+- If usage >= limit, suggest increasing fee limit
+
+**Contract Revert**:
+- Check function called and parameters
+- Verify sufficient balance/approvals
+- Look for require/revert statements in contract
+
+### 4. Resource Analysis
+- Calculate energy/bandwidth cost
+- Compare to current chain parameters
+
+## Output Format
+
+Provide structured diagnosis:
+- **Status**: Pending/Confirmed/Failed with reason
+- **Transaction Hash**: The hash analyzed
+- **From/To**: Addresses involved
+- **Resource Usage**: Energy / Bandwidth used
+- **Issue (if failed)**: Root cause and explanation
+- **Recommended Actions**: Next steps to resolve
+`,
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("explain_tron_concept", {
+        description: "Explain TRON and blockchain concepts with examples",
+        argsSchema: {
+            concept: z
+                .string()
+                .describe("Concept to explain (Energy, Bandwidth, Super Representative, TRC20, TRC721, etc)"),
+        },
+    }, ({ concept }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `# Concept Explanation: ${concept}
+
+**Objective**: Provide clear, practical explanation of "${concept}"
+
+## Explanation Structure
+
+### 1. Definition
+- What is it?
+- Simple one-sentence summary
+- Technical name/terminology
+
+### 2. How It Works
+- Step-by-step explanation
+- Why it exists/why it's important (e.g., Resource model prevents spam)
+- How it relates to TRON blockchain
+
+### 3. Real-World Analogy
+- Compare to familiar concept (e.g., Bandwidth like internet data, Energy like CPU time)
+- Make it relatable for beginners
+- Highlight key differences
+
+### 4. Practical Examples
+- Real transaction scenarios
+- Numbers and metrics where applicable (e.g., Transfer costs ~300 Bandwidth)
+- Common scenarios
+- Edge cases or gotchas
+
+### 5. Relevance to Users
+- Why should developers/users care?
+- How does it affect transactions/costs?
+- How to optimize (e.g., Staking for resources)?
+- Common mistakes to avoid
+
+## Output Format
+
+Provide explanation in sections:
+
+**What is ${concept}?**
+[Definition and overview]
+
+**How Does It Work?**
+[Mechanics and process]
+
+**Example**
+[Real or hypothetical scenario]
+
+**Key Takeaways**
+[Bullet points of important facts]
+
+**Common Questions**
+- Question 1? Answer
+- Question 2? Answer
+
+## Important
+- Use clear, non-technical language first
+- Progress to technical details
+- Include concrete numbers where helpful
+- Be honest about complexity
+- Suggest further learning if needed
+`,
+                },
+            },
+        ],
+    }));
+    // ============================================================================
+    // WALLET ANALYSIS PROMPTS
+    // ============================================================================
+    server.registerPrompt("analyze_wallet", {
+        description: "Get comprehensive overview of wallet assets, balances, and activity",
+        argsSchema: {
+            address: z.string().describe("Wallet address to analyze"),
+            network: z.string().optional().describe("Network name (default: mainnet)"),
+            tokens: z.string().optional().describe("Comma-separated token addresses to check"),
+        },
+    }, ({ address, network = "mainnet", tokens }) => {
+        const tokenList = tokens ? tokens.split(",").map((t) => t.trim()) : [];
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `# Wallet Analysis
+
+**Objective**: Provide complete asset overview for ${address} on ${network}
+
+## Information Gathering
+
+### 1. Address Resolution
+- Call \`convert_address\` to get both Hex and Base58 formats
+
+### 2. Native Token Balance
+- Call \`get_balance\` to fetch TRX balance
+- Report both sun and TRX formats
+
+### 3. Token Balances
+${tokenList.length > 0
+                            ? `- Call \`get_token_balance\` for each token:\n${tokenList.map((t) => `  * ${t}`).join("\n")}`
+                            : `- If specific tokens provided: call \`get_token_balance\` for each`}
+
+## Output Format
+
+Provide analysis with clear sections:
+
+**Wallet Overview**
+- Address (Base58): [address]
+- Address (Hex): [hex]
+- Network: [network]
+
+**TRX Balance**
+- TRX: [formatted amount]
+- Sun: [raw amount]
+
+**Token Holdings** (if requested)
+- Token: [address]
+- Symbol: [symbol]
+- Balance: [formatted]
+- Decimals: [decimals]
+
+**Summary**
+- Primary holdings
+- Notable observations
+`,
+                    },
+                },
+            ],
+        };
+    });
+    // ============================================================================
+    // NETWORK & EDUCATION PROMPTS
+    // ============================================================================
+    server.registerPrompt("check_network_status", {
+        description: "Check current network health and conditions",
+        argsSchema: {
+            network: z.string().optional().describe("Network name (default: mainnet)"),
+        },
+    }, ({ network = "mainnet" }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `# Network Status Check
+
+**Objective**: Assess health and current conditions of ${network}
+
+## Status Assessment
+
+### 1. Gather Current Data
+Call these read-only tools:
+- \`get_chain_info\` for chain ID and current block number
+- \`get_latest_block\` for block details and timing
+- \`get_chain_parameters\` for current resource costs
+
+### 2. Network Health Analysis
+
+**Block Production**:
+- Current block number
+- Block timing (normal ~3 sec for Tron)
+- Consistent vs irregular blocks
+
+**Resource Market**:
+- Energy Fee
+- Bandwidth Fee
+
+**Overall Status**:
+- Operational: Yes/No
+- Issues detected: Yes/No
+
+## Output Format
+
+**Network Status Report: ${network}**
+
+**Overall Status**
+- Operational Status: [Online/Degraded/Offline]
+- Current Block: [number]
+- Network Time: [timestamp]
+
+**Performance Metrics**
+- Block Time: [seconds] (normal: 3s)
+- Energy Fee: [amount]
+- Bandwidth Fee: [amount]
+
+**Recommendations**
+
+For **sending transactions now**:
+- Status is Green/Yellow/Red
+`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/build/core/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/core/prompts.ts"],"names":[],"mappings":"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"}

package/build/core/resources.d.ts

@@ -0,0 +1,14 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register TRON-related resources with the MCP server
+ *
+ * Resources are application-driven, read-only data that clients can explicitly load.
+ * For an AI agent use case, most data should be exposed through tools instead,
+ * which allow the model to discover and autonomously fetch information.
+ *
+ * The supported_networks resource provides a static reference list that clients
+ * may want to browse when configuring which networks to use.
+ *
+ * @param server The MCP server instance
+ */
+export declare function registerTRONResources(server: McpServer): void;

package/build/core/resources.js

@@ -0,0 +1,42 @@
+import { getSupportedNetworks } from "./chains.js";
+/**
+ * Register TRON-related resources with the MCP server
+ *
+ * Resources are application-driven, read-only data that clients can explicitly load.
+ * For an AI agent use case, most data should be exposed through tools instead,
+ * which allow the model to discover and autonomously fetch information.
+ *
+ * The supported_networks resource provides a static reference list that clients
+ * may want to browse when configuring which networks to use.
+ *
+ * @param server The MCP server instance
+ */
+export function registerTRONResources(server) {
+    server.registerResource("supported_networks", "tron://networks", {
+        description: "Get list of all supported TRON networks and their configuration",
+        mimeType: "application/json",
+    }, async (uri) => {
+        try {
+            const networks = getSupportedNetworks();
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        text: JSON.stringify({ supportedNetworks: networks }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=resources.js.map

package/build/core/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/core/resources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,gBAAgB,CACrB,oBAAoB,EACpB,iBAAiB,EACjB;QACE,WAAW,EAAE,iEAAiE;QAC9E,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;YACxC,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,iBAAiB,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC/D;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,IAAI,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACzE;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/core/services/address.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Service for handling address conversions (Hex <-> Base58)
+ */
+export declare function toHexAddress(address: string): string;
+export declare function toBase58Address(address: string): string;
+export declare function isBase58(address: string): boolean;
+export declare function isHex(address: string): boolean;
+export declare const resolveAddress: (nameOrAddress: string, _network?: string) => Promise<string>;

package/build/core/services/address.js

@@ -0,0 +1,52 @@
+import { TronWeb } from "tronweb";
+/**
+ * Service for handling address conversions (Hex <-> Base58)
+ */
+export function toHexAddress(address) {
+    if (address.startsWith("T")) {
+        return TronWeb.address.toHex(address);
+    }
+    return address;
+}
+export function toBase58Address(address) {
+    if (address.startsWith("41")) {
+        return TronWeb.address.fromHex(address);
+    }
+    if (address.startsWith("0x")) {
+        // TronWeb expects 41 prefix for hex addresses usually, but 0x might be passed from EVM habits
+        // 0x prefix usually needs to be replaced with 41 if it's a valid Tron address in hex
+        // However, TronWeb.address.fromHex handles 0x prefix by assuming it's an ETH address and converting?
+        // Let's rely on TronWeb's robust handling
+        return TronWeb.address.fromHex(address);
+    }
+    return address;
+}
+export function isBase58(address) {
+    return address.startsWith("T") && TronWeb.isAddress(address);
+}
+export function isHex(address) {
+    // Base58 addresses start with T, Hex addresses don't (0-9, a-f)
+    if (address.startsWith("T"))
+        return false;
+    let cleanAddress = address;
+    if (address.startsWith("0x")) {
+        cleanAddress = address.substring(2);
+    }
+    // If it's a 20-byte hex (40 chars), prefix with 41 to verify as a Tron address
+    // TronWeb.address.fromHex handles this auto-prefixing, so isHex should validate it too
+    if (cleanAddress.length === 40) {
+        cleanAddress = "41" + cleanAddress;
+    }
+    return TronWeb.isAddress(cleanAddress);
+}
+// Re-export utility for convenience
+export const resolveAddress = async (nameOrAddress, _network) => {
+    // Tron doesn't have ENS exactly like ETH.
+    // If it's a valid address, return it.
+    if (TronWeb.isAddress(nameOrAddress)) {
+        return nameOrAddress;
+    }
+    // Future: Implement Tron NS resolution if needed
+    throw new Error(`Invalid address or unsupported name service: ${nameOrAddress}`);
+};
+//# sourceMappingURL=address.js.map

package/build/core/services/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../src/core/services/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;GAEG;AAEH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,8FAA8F;QAC9F,qFAAqF;QACrF,qGAAqG;QACrG,0CAA0C;QAC1C,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,gEAAgE;IAChE,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1C,IAAI,YAAY,GAAG,OAAO,CAAC;IAC3B,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,+EAA+E;IAC/E,uFAAuF;IACvF,IAAI,YAAY,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC/B,YAAY,GAAG,IAAI,GAAG,YAAY,CAAC;IACrC,CAAC;IAED,OAAO,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC;AAED,oCAAoC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,aAAqB,EAAE,QAAiB,EAAmB,EAAE;IAChG,0CAA0C;IAC1C,sCAAsC;IACtC,IAAI,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC;QACrC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,iDAAiD;IACjD,MAAM,IAAI,KAAK,CAAC,gDAAgD,aAAa,EAAE,CAAC,CAAC;AACnF,CAAC,CAAC"}

package/build/core/services/balance.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Get TRX balance for an address
+ */
+export declare function getTRXBalance(address: string, network?: string): Promise<{
+    wei: bigint;
+    ether: string;
+    formatted: string;
+    symbol: string;
+    decimals: number;
+}>;
+/**
+ * Get TRC20 token balance
+ */
+export declare function getTRC20Balance(tokenAddress: string, walletAddress: string, network?: string): Promise<{
+    raw: bigint;
+    formatted: string;
+    token: {
+        symbol: any;
+        decimals: number;
+        address: string;
+    };
+}>;
+/**
+ * Get TRC1155 balance
+ */
+export declare function getTRC1155Balance(contractAddress: string, ownerAddress: string, tokenId: bigint, network?: string): Promise<bigint>;