@bankofai/mcp-server-tron 1.1.3 → 1.1.5

package/README.md

@@ -36,7 +36,7 @@ Key capabilities:
 - **Smart Contracts**: Interact with any TRON smart contract (Read/Write).
 - **Tokens**: Transfer TRX and TRC20 tokens; check balances.
 - **Address Management**: Convert between Hex (0x...) and Base58 (T...) formats.
-- **Wallet Integration**: Support for Private Key and Mnemonic (BIP-39) wallets.
+- **Wallet Integration**: Agent-wallet (encrypted keystore), Private Key, and Mnemonic (BIP-39) wallets.
 - **Multi-Network**: Seamless support for Mainnet, Nile, and Shasta.
 - **Dynamic Access Control**: Automatically hides write tools if no wallet is configured or if `--readonly` mode is active.
 
@@ -91,9 +91,10 @@ Key capabilities:
 
 ### Wallet & Security
 
-- **Flexible Wallet**: Configure via `TRON_PRIVATE_KEY` or `TRON_MNEMONIC`.
+- **Agent Wallet (Recommended)**: Encrypted key storage via agent-wallet SDK — private keys never leave the keystore.
+- **Static Wallet**: Configure via `TRON_PRIVATE_KEY` or `TRON_MNEMONIC` environment variables.
 - **HD Wallet**: Supports BIP-44 derivation path `m/44'/195'/0'/0/{index}`.
-- **Signing**: Sign arbitrary messages.
+- **Signing**: Sign arbitrary messages and transactions.
 
 ## Supported Networks
 
@@ -110,7 +111,7 @@ Key capabilities:
 
 ```bash
 # Clone the repository
-git clone https://github.com/bankofai/mcp-server-tron.git
+git clone https://github.com/BofAI/mcp-server-tron.git
 cd mcp-server-tron
 
 # Install dependencies
@@ -134,23 +135,40 @@ To enable write operations (transfers, contract calls) and ensure reliable API a
     export TRONGRID_API_KEY="<YOUR_TRONGRID_API_KEY_HERE>"
     ```
 
-#### Wallet Configuration (Use Environment Variables)
+#### Wallet Configuration
 
-**Option 1: Private Key**
+Choose **one** of the following modes. If none is configured, the server runs in **read-only mode**.
+
+**Option 1: Agent-Wallet Mode (Recommended)**
+
+Private keys are encrypted at rest and never exposed in environment variables.
+
+> **Prerequisites**: Install and configure [agent-wallet](https://github.com/BofAI/agent-wallet/blob/main/doc/getting-started.md)
+
+```bash
+export AGENT_WALLET_PASSWORD="<YOUR_MASTER_PASSWORD>"
+export AGENT_WALLET_DIR="<YOUR_WALLET_DIR>"  # Optional, default: ~/.agent-wallet
+```
+
+> `AGENT_WALLET_PASSWORD` must match the master password used during `agent-wallet`. If not set, agent-wallet mode is disabled and the server falls back to static mode or read-only mode.
+
+**Option 2: Private Key**
 
 ```bash
-# Recommended: Add this to your ~/.zshrc or ~/.bashrc
 export TRON_PRIVATE_KEY="<YOUR_PRIVATE_KEY_HERE>"
 ```
 
-**Option 2: Mnemonic Phrase**
+**Option 3: Mnemonic Phrase**
 
 ```bash
-# Recommended: Add this to your ~/.zshrc or ~/.bashrc
 export TRON_MNEMONIC="<WORD1> <WORD2> ... <WORD12>"
-export TRON_ACCOUNT_INDEX="0" # Optional, default: 0
+export TRON_ACCOUNT_INDEX="0"  # Optional, default: 0
 ```
 
+> **Security Note**: Static modes store keys in plaintext environment variables. Agent-wallet mode is strongly recommended for production use.
+
+> See [`.env.example`](.env.example) for a complete list of all supported environment variables.
+
 ### Server Configuration
 
 The server runs on port **3001** by default in HTTP mode.
@@ -166,7 +184,7 @@ npm start
 # Start in readonly mode (disables write tools)
 npm start -- --readonly
 
-# Start in HTTP mode (Server-Sent Events)
+# Start in HTTP mode (Streamable HTTP)
 npm run start:http
 ```
 
@@ -181,65 +199,46 @@ npm test
 # Unit tests (mocked services, no network)
 npx vitest tests/core/tools.test.ts                    # All MCP tools registration & handlers
 npx vitest tests/core/services/contracts.test.ts       # Contract services
-npx vitest tests/core/services/accountResource.test.ts # Account resource services
+npx vitest tests/core/services/account-resource.test.ts # Account resource services
 npx vitest tests/core/services/staking.test.ts         # Staking services
 
-# Integration tests (real Nile RPC; write tests require TRON_PRIVATE_KEY)
+# Integration tests (real Nile RPC; write tests require AGENT_WALLET_PASSWORD or TRON_PRIVATE_KEY)
 npx vitest tests/core/tools_integration.test.ts        # Full tool flow on Nile
 npx vitest tests/core/services/multicall.test.ts       # Multicall integration
 npx vitest tests/core/services/services.test.ts        # Services integration
 ```
 
 - **Unit tests** use mocks and do not need network or wallet.
-- **Integration tests** (`tools_integration.test.ts`) call Nile RPC; most cases are read-only. Tests that broadcast transactions (e.g. `vote_witness`, `withdraw_balance`) run only when `TRON_PRIVATE_KEY` is set in the environment and are skipped otherwise.
+- **Integration tests** (`tools_integration.test.ts`) call Nile RPC; most cases are read-only. Tests that broadcast transactions (e.g. `vote_witness`, `withdraw_balance`) run only when a wallet is configured (`AGENT_WALLET_PASSWORD` or `TRON_PRIVATE_KEY`) and are skipped otherwise.
 
 ### Client Configuration
 
-To use this server with MCP clients like Claude Desktop, Cursor, or Google Antigravity, you need to add it to your configuration file.
-
-#### 1. Locate your Configuration File
+#### Option A: Quick Start (Recommended)
 
-| Application            | OS      | Config Path                                                       |
-| :--------------------- | :------ | :---------------------------------------------------------------- |
-| **Claude Desktop**     | macOS   | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-|                        | Windows | `%APPDATA%\Claude\claude_desktop_config.json`                     |
-| **Cursor**             | All     | Project root: `.cursor/mcp.json`                                  |
-| **Google Antigravity** | All     | `~/.config/antigravity/mcp.json`                                  |
-| **Opencode**           | All     | `~/.config/opencode/mcp.json`                                     |
+Runs the latest version directly from npm via stdio transport.
 
-#### 2. Add Server Definition
+**Claude Code:**
 
-Choose one of the following methods to add to your `mcpServers` object.
+```bash
+claude mcp add mcp-server-tron -- npx -y @bankofai/mcp-server-tron
+```
 
-**Option A: Quick Start (Recommended)**
-Runs the latest version directly from npm.
+With environment variables:
 
-```json
-{
-  "mcpServers": {
-    "mcp-server-tron": {
-      "command": "npx",
-      "args": ["-y", "@bankofai/mcp-server-tron"],
-      "env": {
-        "TRON_PRIVATE_KEY": "YOUR_KEY_HERE (Or set in system env)",
-        "TRONGRID_API_KEY": "YOUR_KEY_HERE (Or set in system env)"
-      }
-    }
-  }
-}
+```bash
+claude mcp add -e AGENT_WALLET_PASSWORD=xxx -e TRONGRID_API_KEY=xxx mcp-server-tron -- npx -y @bankofai/mcp-server-tron
 ```
 
-**Option B: Local Development**
-For developers running from the cloned repository.
+**Cursor** (`.cursor/mcp.json`):
 
 ```json
 {
   "mcpServers": {
     "mcp-server-tron": {
       "command": "npx",
-      "args": ["tsx", "/ABSOLUTE/PATH/TO/mcp-server-tron/src/index.ts"],
+      "args": ["-y", "@bankofai/mcp-server-tron"],
       "env": {
-        "TRON_PRIVATE_KEY": "YOUR_KEY_HERE (Or set in system env)",
+        "AGENT_WALLET_PASSWORD": "YOUR_PASSWORD (Or set in system env)",
         "TRONGRID_API_KEY": "YOUR_KEY_HERE (Or set in system env)"
       }
     }
@@ -247,48 +246,28 @@ For developers running from the cloned repository.
 }
 ```
 
-**Option C: Official Hosted Server (Remote)**
-Connect to the official hosted server at `https://mcp-server.bankofai.io`. No installation required, readonly mode.
+#### Option B: Official Hosted Server (Remote)
 
-Claude Desktop / Cursor / Claude Code:
+Connect to the official hosted server at `https://tron-mcp-server.bankofai.io`. No installation required, readonly mode.
 
-```json
-{
-  "mcpServers": {
-    "mcp-server-tron": {
-      "url": "https://mcp-server.bankofai.io/mcp"
-    }
-  }
-}
-```
+**Claude Code:**
 
-Google Antigravity:
-
-```json
-{
-  "mcpServers": {
-    "mcp-server-tron": {
-      "serverUrl": "https://mcp-server.bankofai.io/mcp"
-    }
-  }
-}
+```bash
+claude mcp add -transport http mcp-server-tron https://tron-mcp-server.bankofai.io/mcp
 ```
 
-Opencode:
+**Cursor** (`.cursor/mcp.json`):
 
 ```json
 {
-  "mcp": {
+  "mcpServers": {
     "mcp-server-tron": {
-      "type": "remote",
-      "url": "https://mcp-server.bankofai.io/mcp"
+      "url": "https://tron-mcp-server.bankofai.io/mcp"
     }
   }
 }
 ```
 
-**Important**: We recommend omitting the `env` section if you have already set these variables in your system environment. If your MCP client doesn't inherit system variables, use placeholders or ensure the config file is not shared or committed to version control.
-
 ## API Reference
 
 ### Tools
@@ -298,6 +277,8 @@ Opencode:
 | Tool Name            | Description                                         | Key Parameters |
 | :------------------- | :-------------------------------------------------- | :------------- |
 | `get_wallet_address` | Get the configured wallet's address (Base58 & Hex). | -              |
+| `list_wallets`       | List all available wallets with IDs and addresses.   | -              |
+| `select_wallet`      | Switch the active wallet at runtime (agent-wallet mode). | `walletId` |
 | `convert_address`    | Convert between Hex and Base58 formats.             | `address`      |
 
 #### Network & Resources
@@ -481,7 +462,9 @@ Opencode:
 ### Prompts
 
 - `prepare_transfer`: Interactive guide to prepare TRX/TRC20 transfers.
+- `interact_with_contract`: Step-by-step guide to interact with a smart contract.
 - `diagnose_transaction`: Analyze a transaction hash for status and errors.
+- `explain_tron_concept`: Explain a TRON blockchain concept with examples.
 - `analyze_wallet`: Comprehensive report of wallet assets.
 - `check_network_status`: Report on network health and resource costs.
 

package/build/core/prompts.js

@@ -16,7 +16,6 @@ import * as services from "./services/index.js";
  * @param options Registration options
  */
 export function registerTRONPrompts(server, options = {}) {
-    const { isWalletConfigured } = services;
     /**
      * Helper to register a prompt with automatic wallet requirement detection.
      * Prompts that guide write operations should only be registered if a wallet
@@ -33,7 +32,7 @@ export function registerTRONPrompts(server, options = {}) {
             return;
         }
         // 2. Skip if the prompt needs a wallet but none is configured
-        if (walletNeeded && !isWalletConfigured()) {
+        if (walletNeeded && services.getActiveWalletId() === null) {
             return;
         }
         server.registerPrompt(name, definition, handler);

package/build/core/prompts.js.map

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

package/build/core/services/account-resource.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Delegate staked resources (BANDWIDTH or ENERGY) to another address.
+ * Wraps TronWeb's transactionBuilder.delegateResource.
+ */
+export declare function delegateResource(params: {
+    amount: number;
+    receiverAddress: string;
+    resource: "BANDWIDTH" | "ENERGY";
+    lock?: boolean;
+    lockPeriod?: number;
+}, network?: string): Promise<string>;
+/**
+ * Revoke delegated resources (BANDWIDTH or ENERGY) from a receiver address.
+ * Wraps TronWeb's transactionBuilder.undelegateResource.
+ */
+export declare function undelegateResource(params: {
+    amount: number;
+    receiverAddress: string;
+    resource: "BANDWIDTH" | "ENERGY";
+}, network?: string): Promise<string>;
+/**
+ * Get the maximum amount of resources that can currently be delegated by an address.
+ * Wraps TronWeb's trx.getCanDelegatedMaxSize / walletsolidity.getcandelegatedmaxsize.
+ */
+export declare function getCanDelegatedMaxSize(address: string, resource: "BANDWIDTH" | "ENERGY", network?: string): Promise<{
+    address: string;
+    resource: "BANDWIDTH" | "ENERGY";
+    maxSizeSun: bigint;
+}>;
+/**
+ * Get delegated resource details between two addresses under Stake 2.0.
+ * Wraps TronWeb's trx.getDelegatedResourceV2 / wallet.getdelegatedresourcev2.
+ */
+export declare function getDelegatedResourceV2(fromAddress: string, toAddress: string, network?: string): Promise<{
+    from: string;
+    to: string;
+    delegatedResource: {
+        from: any;
+        to: any;
+        frozenBalanceForBandwidthSun: string;
+        frozenBalanceForEnergySun: string;
+        expireTimeForBandwidth: any;
+        expireTimeForEnergy: any;
+    }[];
+    raw: any;
+}>;
+/**
+ * Get delegated resource account index for an address under Stake 2.0.
+ * Wraps walletsolidity.getdelegatedresourceaccountindexv2.
+ */
+export declare function getDelegatedResourceAccountIndexV2(address: string, network?: string): Promise<{
+    account: any;
+    fromAccounts: any;
+    toAccounts: any;
+    raw: unknown;
+}>;

package/build/core/services/account-resource.js

@@ -0,0 +1,133 @@
+import { getTronWeb } from "./clients.js";
+import { getOwnerAddress, buildSignBroadcast } from "./agent-wallet.js";
+/**
+ * Delegate staked resources (BANDWIDTH or ENERGY) to another address.
+ * Wraps TronWeb's transactionBuilder.delegateResource.
+ */
+export async function delegateResource(params, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    const ownerAddress = await getOwnerAddress();
+    try {
+        const { amount, receiverAddress, resource, lock = false, lockPeriod = 0 } = params;
+        const tx = await tronWeb.transactionBuilder.delegateResource(amount, receiverAddress, resource, ownerAddress, lock, lockPeriod, {});
+        return await buildSignBroadcast(tx, network);
+    }
+    catch (error) {
+        throw new Error(`Failed to delegate resource: ${error.message}`);
+    }
+}
+/**
+ * Revoke delegated resources (BANDWIDTH or ENERGY) from a receiver address.
+ * Wraps TronWeb's transactionBuilder.undelegateResource.
+ */
+export async function undelegateResource(params, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    const ownerAddress = await getOwnerAddress();
+    try {
+        const { amount, receiverAddress, resource } = params;
+        const tx = await tronWeb.transactionBuilder.undelegateResource(amount, receiverAddress, resource, ownerAddress, {});
+        return await buildSignBroadcast(tx, network);
+    }
+    catch (error) {
+        throw new Error(`Failed to undelegate resource: ${error.message}`);
+    }
+}
+/**
+ * Get the maximum amount of resources that can currently be delegated by an address.
+ * Wraps TronWeb's trx.getCanDelegatedMaxSize / walletsolidity.getcandelegatedmaxsize.
+ */
+export async function getCanDelegatedMaxSize(address, resource, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    try {
+        // Prefer TronWeb helper if available
+        const type = resource === "ENERGY" ? 1 : 0;
+        // tronWeb.trx.getCanDelegatedMaxSize(address, resourceType)
+        const res = typeof tronWeb.trx.getCanDelegatedMaxSize === "function"
+            ? await tronWeb.trx.getCanDelegatedMaxSize(address, resource)
+            : await tronWeb.fullNode.request("wallet/getcandelegatedmaxsize", {
+                owner_address: tronWeb.address.toHex(address),
+                type,
+                visible: false,
+            }, "post");
+        const raw = res?.max_size;
+        if (raw === undefined || (typeof raw !== "number" && typeof raw !== "string")) {
+            throw new Error(`Unexpected response from getCanDelegatedMaxSize: ${JSON.stringify(res)}`);
+        }
+        const maxSizeSun = BigInt(raw);
+        return {
+            address,
+            resource,
+            maxSizeSun,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to get can delegated max size: ${error.message}`);
+    }
+}
+/**
+ * Get delegated resource details between two addresses under Stake 2.0.
+ * Wraps TronWeb's trx.getDelegatedResourceV2 / wallet.getdelegatedresourcev2.
+ */
+export async function getDelegatedResourceV2(fromAddress, toAddress, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    try {
+        const res = typeof tronWeb.trx.getDelegatedResourceV2 === "function"
+            ? await tronWeb.trx.getDelegatedResourceV2(fromAddress, toAddress, {
+                confirmed: true,
+            })
+            : await tronWeb.fullNode.request("wallet/getdelegatedresourcev2", {
+                fromAddress: tronWeb.address.toHex(fromAddress),
+                toAddress: tronWeb.address.toHex(toAddress),
+                visible: false,
+            }, "post");
+        const delegated = res?.delegatedResource || (Array.isArray(res) ? res : []);
+        // Normalize numeric fields to BigInt/string form for safety
+        const normalized = delegated.map((item) => {
+            const bandwidth = item.frozen_balance_for_bandwidth ?? 0;
+            const energy = item.frozen_balance_for_energy ?? 0;
+            return {
+                from: item.from || fromAddress,
+                to: item.to || toAddress,
+                frozenBalanceForBandwidthSun: BigInt(bandwidth).toString(),
+                frozenBalanceForEnergySun: BigInt(energy).toString(),
+                expireTimeForBandwidth: item.expire_time_for_bandwidth ?? 0,
+                expireTimeForEnergy: item.expire_time_for_energy ?? 0,
+            };
+        });
+        return {
+            from: fromAddress,
+            to: toAddress,
+            delegatedResource: normalized,
+            raw: res,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to get delegated resource v2: ${error.message}`);
+    }
+}
+/**
+ * Get delegated resource account index for an address under Stake 2.0.
+ * Wraps walletsolidity.getdelegatedresourceaccountindexv2.
+ */
+export async function getDelegatedResourceAccountIndexV2(address, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    try {
+        const res = await tronWeb.fullNode.request("wallet/getdelegatedresourceaccountindexv2", {
+            value: tronWeb.address.toHex(address),
+            visible: false,
+        }, "post");
+        const account = res?.account ?? address;
+        const fromAccounts = res?.fromAccounts ?? [];
+        const toAccounts = res?.toAccounts ?? [];
+        return {
+            account,
+            fromAccounts,
+            toAccounts,
+            raw: res,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to get delegated resource account index v2: ${error.message}`);
+    }
+}
+//# sourceMappingURL=account-resource.js.map

package/build/core/services/account-resource.js.map

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

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

@@ -18,16 +18,15 @@ export declare function getAccountBalance(address: string, blockHash: string, bl
     block_identifier?: any;
 }>;
 /**
- * Generate a new account offline (keypair generation, no network interaction)
- * @returns Object with privateKey, publicKey, and address (base58 + hex)
+ * Generate a new account.
+ * Unified interface that returns a new keypair (ephemeral).
  */
 export declare function generateAccount(): Promise<{
-    privateKey: string;
-    publicKey: string;
     address: {
         base58: string;
-        hex: string;
     };
+    privateKey: string;
+    message: string;
 }>;
 /**
  * Validate a TRON address
@@ -85,30 +84,27 @@ export declare function getDelegatedResourceIndex(address: string, network?: str
 }>;
 /**
  * Activate a new account on the TRON network (costs bandwidth from the creator)
- * @param privateKey Creator's private key
  * @param newAddress Address to activate
  * @param network Network name
  * @returns Transaction hash
  */
-export declare function createAccount(privateKey: string, newAddress: string, network?: string): Promise<string>;
+export declare function createAccount(newAddress: string, network?: string): Promise<string>;
 /**
  * Update account name (can only be set once)
- * @param privateKey Account's private key
  * @param accountName New account name
  * @param network Network name
  * @returns Transaction hash
  */
-export declare function updateAccount(privateKey: string, accountName: string, network?: string): Promise<string>;
+export declare function updateAccount(accountName: string, network?: string): Promise<string>;
 /**
  * Update account permissions (multi-signature configuration)
- * @param privateKey Account's private key
  * @param ownerPermission Owner permission configuration
  * @param activePermissions Active permission(s) configuration
  * @param witnessPermission Optional witness permission (for Super Representatives)
  * @param network Network name
  * @returns Transaction hash
  */
-export declare function updateAccountPermissions(privateKey: string, ownerPermission: {
+export declare function updateAccountPermissions(ownerPermission: {
     type: number;
     permission_name: string;
     threshold: number;

package/build/core/services/account.js

@@ -1,5 +1,6 @@
 import { TronWeb } from "tronweb";
-import { getTronWeb, getWallet } from "./clients.js";
+import { getTronWeb } from "./clients.js";
+import { getOwnerAddress, buildSignBroadcast, generateAccountKeypair as generateAccountService, } from "./agent-wallet.js";
 /**
  * Get full account information from the TRON network
  * @param address Account address (Base58 or Hex)
@@ -39,13 +40,17 @@ export async function getAccountBalance(address, blockHash, blockNumber, network
     }
 }
 /**
- * Generate a new account offline (keypair generation, no network interaction)
- * @returns Object with privateKey, publicKey, and address (base58 + hex)
+ * Generate a new account.
+ * Unified interface that returns a new keypair (ephemeral).
  */
 export async function generateAccount() {
     try {
-        const account = await TronWeb.createAccount();
-        return account;
+        const result = await generateAccountService();
+        return {
+            address: { base58: result.address },
+            privateKey: result.privateKey,
+            message: result.message,
+        };
     }
     catch (error) {
         throw new Error(`Failed to generate account: ${error.message}`);
@@ -132,23 +137,16 @@ export async function getDelegatedResourceIndex(address, network = "mainnet") {
 }
 /**
  * Activate a new account on the TRON network (costs bandwidth from the creator)
- * @param privateKey Creator's private key
  * @param newAddress Address to activate
  * @param network Network name
  * @returns Transaction hash
  */
-export async function createAccount(privateKey, newAddress, network = "mainnet") {
-    const tronWeb = getWallet(privateKey, network);
+export async function createAccount(newAddress, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    const ownerAddress = await getOwnerAddress();
     try {
-        const transaction = await tronWeb.transactionBuilder.createAccount(newAddress, tronWeb.defaultAddress.base58 || undefined);
-        const signedTx = await tronWeb.trx.sign(transaction, privateKey);
-        const result = await tronWeb.trx.sendRawTransaction(signedTx);
-        if (result.result) {
-            return result.txid;
-        }
-        else {
-            throw new Error(`CreateAccount failed: ${JSON.stringify(result)}`);
-        }
+        const transaction = await tronWeb.transactionBuilder.createAccount(newAddress, ownerAddress);
+        return await buildSignBroadcast(transaction, network);
     }
     catch (error) {
         throw new Error(`Failed to create account: ${error.message}`);
@@ -156,23 +154,16 @@ export async function createAccount(privateKey, newAddress, network = "mainnet")
 }
 /**
  * Update account name (can only be set once)
- * @param privateKey Account's private key
  * @param accountName New account name
  * @param network Network name
  * @returns Transaction hash
  */
-export async function updateAccount(privateKey, accountName, network = "mainnet") {
-    const tronWeb = getWallet(privateKey, network);
+export async function updateAccount(accountName, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    const ownerAddress = await getOwnerAddress();
     try {
-        const transaction = await tronWeb.transactionBuilder.updateAccount(accountName, tronWeb.defaultAddress.base58 || undefined);
-        const signedTx = await tronWeb.trx.sign(transaction, privateKey);
-        const result = await tronWeb.trx.sendRawTransaction(signedTx);
-        if (result.result) {
-            return result.txid;
-        }
-        else {
-            throw new Error(`UpdateAccount failed: ${JSON.stringify(result)}`);
-        }
+        const transaction = await tronWeb.transactionBuilder.updateAccount(accountName, ownerAddress);
+        return await buildSignBroadcast(transaction, network);
     }
     catch (error) {
         throw new Error(`Failed to update account: ${error.message}`);
@@ -180,25 +171,18 @@ export async function updateAccount(privateKey, accountName, network = "mainnet"
 }
 /**
  * Update account permissions (multi-signature configuration)
- * @param privateKey Account's private key
  * @param ownerPermission Owner permission configuration
  * @param activePermissions Active permission(s) configuration
  * @param witnessPermission Optional witness permission (for Super Representatives)
  * @param network Network name
  * @returns Transaction hash
  */
-export async function updateAccountPermissions(privateKey, ownerPermission, activePermissions, witnessPermission, network = "mainnet") {
-    const tronWeb = getWallet(privateKey, network);
+export async function updateAccountPermissions(ownerPermission, activePermissions, witnessPermission, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    const ownerAddress = await getOwnerAddress();
     try {
-        const transaction = await tronWeb.transactionBuilder.updateAccountPermissions(tronWeb.defaultAddress.base58 || undefined, ownerPermission, witnessPermission, activePermissions);
-        const signedTx = await tronWeb.trx.sign(transaction, privateKey);
-        const result = await tronWeb.trx.sendRawTransaction(signedTx);
-        if (result.result) {
-            return result.txid;
-        }
-        else {
-            throw new Error(`AccountPermissionUpdate failed: ${JSON.stringify(result)}`);
-        }
+        const transaction = await tronWeb.transactionBuilder.updateAccountPermissions(ownerAddress, ownerPermission, witnessPermission, activePermissions);
+        return await buildSignBroadcast(transaction, network);
     }
     catch (error) {
         throw new Error(`Failed to update account permissions: ${error.message}`);