@dynamic-labs-wallet/node-tron 0.0.0 → 1.1.42

package/index.cjs

@@ -0,0 +1,1182 @@
+'use strict';
+
+var node = require('@dynamic-labs-wallet/node');
+var sha3 = require('@noble/hashes/sha3');
+var sha256 = require('@noble/hashes/sha256');
+var bs58 = require('bs58');
+
+/**
+ * Mainnet address prefix byte for TRON addresses. Shasta and Nile testnets
+ * use the same prefix; the network is disambiguated at the node/relay layer
+ * (TRON does not embed a network byte into the address).
+ *
+ * @see https://github.com/tronprotocol/tips/blob/master/tip-21.md
+ */ var TRON_ADDRESS_PREFIX = 0x41;
+/**
+ * Length of the Base58Check checksum appended to a TRON address payload.
+ */ var TRON_CHECKSUM_LENGTH = 4;
+/**
+ * Length of the encoded (un-prefixed) Base58Check TRON address.
+ * `T...` addresses are always 34 characters.
+ */ var TRON_ADDRESS_LENGTH = 34;
+var hexToBytes$1 = function(hex) {
+    var buf = Buffer.from(hex, 'hex');
+    return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+};
+/**
+ * Derive a TRON Base58Check ("T...") address from a secp256k1 public key.
+ *
+ * TRON addresses are the keccak256 hash of the uncompressed public key
+ * (with the leading 0x04 byte stripped), taking the last 20 bytes, prefixed
+ * with 0x41, then encoded as Base58Check (SHA256d checksum).
+ *
+ * @see https://github.com/tronprotocol/tips/blob/master/tip-21.md
+ */ var deriveTronAddress = function(param) {
+    var publicKeyHex = param.publicKeyHex;
+    var cleanHex = publicKeyHex.startsWith('0x') ? publicKeyHex.slice(2) : publicKeyHex;
+    var publicKeyBytes = hexToBytes$1(cleanHex);
+    // Allow either 65-byte uncompressed (0x04 || X || Y) or 64-byte X||Y form.
+    var xy;
+    if (publicKeyBytes.length === 65) {
+        if (publicKeyBytes[0] !== 0x04) {
+            throw new Error("Invalid uncompressed public key prefix: expected 0x04, got 0x".concat(publicKeyBytes[0].toString(16)));
+        }
+        xy = publicKeyBytes.subarray(1);
+    } else if (publicKeyBytes.length === 64) {
+        xy = publicKeyBytes;
+    } else {
+        throw new Error("Invalid public key length: ".concat(publicKeyBytes.length, ", expected 64 (X||Y) or 65 (uncompressed)"));
+    }
+    var hashed = sha3.keccak_256(xy);
+    var lastTwentyBytes = hashed.slice(-20);
+    var payload = new Uint8Array(21);
+    payload[0] = TRON_ADDRESS_PREFIX;
+    payload.set(lastTwentyBytes, 1);
+    var checksum = sha256.sha256(sha256.sha256(payload)).slice(0, TRON_CHECKSUM_LENGTH);
+    var addressBytes = new Uint8Array(payload.length + TRON_CHECKSUM_LENGTH);
+    addressBytes.set(payload, 0);
+    addressBytes.set(checksum, payload.length);
+    return bs58.encode(addressBytes);
+};
+/**
+ * Validate a TRON Base58Check address.
+ *
+ * Performs the full decode + checksum + prefix check, so it rejects EVM
+ * `0x...` addresses, malformed Base58, and addresses whose checksum was
+ * tampered with.
+ */ var isValidTronAddress = function(address) {
+    if (typeof address !== 'string' || address.length !== TRON_ADDRESS_LENGTH) {
+        return false;
+    }
+    var decoded;
+    try {
+        decoded = bs58.decode(address);
+    } catch (e) {
+        return false;
+    }
+    if (decoded.length !== 25 || decoded[0] !== TRON_ADDRESS_PREFIX) {
+        return false;
+    }
+    var payload = decoded.subarray(0, 21);
+    var expectedChecksum = decoded.subarray(21);
+    var actualChecksum = sha256.sha256(sha256.sha256(payload)).slice(0, TRON_CHECKSUM_LENGTH);
+    for(var i = 0; i < TRON_CHECKSUM_LENGTH; i++){
+        if (expectedChecksum[i] !== actualChecksum[i]) {
+            return false;
+        }
+    }
+    return true;
+};
+/**
+ * Decode a TRON Base58Check address to its 21-byte payload (prefix + 20-byte
+ * hash). Throws if the checksum doesn't validate.
+ */ var decodeTronAddress = function(address) {
+    if (!isValidTronAddress(address)) {
+        throw new Error('Invalid TRON address');
+    }
+    return bs58.decode(address).subarray(0, 21);
+};
+/**
+ * Convert a TRON Base58Check address to its 0x41-prefixed hex form (used in
+ * raw transactions).
+ */ var tronAddressToHex = function(address) {
+    var payload = decodeTronAddress(address);
+    return "0x".concat(Buffer.from(payload).toString('hex'));
+};
+
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+/**
+ * TIP-191 personal-sign prefix used by TRON for signed messages.
+ *
+ * The hash that gets signed is:
+ *   keccak256("\x19TRON Signed Message:\n" || len(message) || message)
+ *
+ * where `message` is the raw bytes the user agreed to sign.
+ *
+ * @see https://github.com/tronprotocol/tips/blob/master/tip-191.md
+ */ var TRON_SIGN_MESSAGE_PREFIX = '\x19TRON Signed Message:\n';
+var bufferToUint8Array = function(buf) {
+    return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+};
+var stringToBytes = function(s) {
+    return bufferToUint8Array(Buffer.from(s, 'utf8'));
+};
+var hexToBytes = function(hex) {
+    var clean = hex.startsWith('0x') ? hex.slice(2) : hex;
+    return bufferToUint8Array(Buffer.from(clean, 'hex'));
+};
+/**
+ * Convert a user-supplied message into the bytes that TIP-191 expects to be
+ * hashed.
+ *
+ * - `string` starting with `0x` → treated as hex bytes
+ * - `string` otherwise → treated as utf-8 bytes
+ * - `Uint8Array` → passed through
+ * - `{ raw: ... }` → mirrors viem's `{ raw }` escape hatch for already-hashed payloads
+ */ var toTronMessageBytes = function(message) {
+    if (_instanceof(message, Uint8Array)) return message;
+    if (typeof message === 'string') {
+        return message.startsWith('0x') ? hexToBytes(message) : stringToBytes(message);
+    }
+    if (typeof message.raw === 'string') return hexToBytes(message.raw);
+    return message.raw;
+};
+/**
+ * Apply the TIP-191 prefix and return the keccak256 hash that should be
+ * signed by the MPC ECDSA flow.
+ *
+ * Returns a `Uint8Array` (32 bytes). The wallet client hands this to
+ * `sign(...)` with `isFormatted: true` so the forward-MPC path sees a
+ * pre-hashed payload.
+ */ var formatTronMessage = function(message) {
+    var bytes = toTronMessageBytes(message);
+    var prefixBytes = stringToBytes("".concat(TRON_SIGN_MESSAGE_PREFIX).concat(bytes.length));
+    var combined = new Uint8Array(prefixBytes.length + bytes.length);
+    combined.set(prefixBytes, 0);
+    combined.set(bytes, prefixBytes.length);
+    return sha3.keccak_256(combined);
+};
+
+/**
+ * TRON transactions are signed over `sha256(raw_data_hex_bytes)`, where
+ * `raw_data_hex` is the protobuf-encoded `Transaction.raw` produced by the
+ * TRON full node when the unsigned transaction is created.
+ *
+ * The MPC client never reconstructs the protobuf itself — the caller passes
+ * the already-serialized `raw_data_hex` and we hash it deterministically here.
+ *
+ * @see https://developers.tron.network/docs/transactions
+ */ var getTronTxId = function(rawDataHex) {
+    var clean = rawDataHex.startsWith('0x') ? rawDataHex.slice(2) : rawDataHex;
+    if (clean.length === 0 || clean.length % 2 !== 0 || /[^0-9a-fA-F]/.test(clean)) {
+        throw new Error('Invalid raw_data_hex: must be a non-empty hex string');
+    }
+    var buf = Buffer.from(clean, 'hex');
+    return sha256.sha256(new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength));
+};
+/**
+ * Convenience wrapper that returns the txID as a 0x-prefixed hex string
+ * (matching the form returned by the TRON full node `/wallet/gettransactioninfobyid`).
+ */ var getTronTxIdHex = function(rawDataHex) {
+    var hash = getTronTxId(rawDataHex);
+    return "0x".concat(Buffer.from(hash).toString('hex'));
+};
+
+/**
+ * Serialize an MPC-produced ECDSA signature into the 65-byte
+ * `r || s || v` hex form that TRON full nodes expect on
+ * `Transaction.signature[0]` and TIP-191 signed messages.
+ *
+ * TRON canonicalises v to 0 / 1 on the wire (recovery id), while the MPC
+ * relay returns v as 27 / 28 (Ethereum legacy convention). We strip the +27
+ * offset here so the output is directly usable by TRON tooling without
+ * the consumer having to remember the convention.
+ */ var serializeECDSASignature = function(signature) {
+    var r = Buffer.from(signature.r).toString('hex');
+    var s = Buffer.from(signature.s).toString('hex');
+    if (r.length !== 64 || s.length !== 64) {
+        throw new Error("Invalid ECDSA r/s length: r=".concat(r.length, ", s=").concat(s.length, " (expected 64 hex chars each)"));
+    }
+    var vNum = Number(signature.v);
+    if (!Number.isFinite(vNum)) {
+        throw new TypeError("Invalid ECDSA v: ".concat(signature.v));
+    }
+    var recoveryId = vNum >= 27 ? vNum - 27 : vNum;
+    if (recoveryId !== 0 && recoveryId !== 1) {
+        throw new Error("Invalid ECDSA recovery id derived from v=".concat(vNum, ": ").concat(recoveryId));
+    }
+    var vHex = recoveryId.toString(16).padStart(2, '0');
+    return "0x".concat(r).concat(s).concat(vHex);
+};
+
+var ERROR_KEYGEN_FAILED = 'Error with keygen';
+var ERROR_CREATE_WALLET_ACCOUNT = 'Error creating TRON wallet account';
+var ERROR_IMPORT_PRIVATE_KEY = 'Error importing private key';
+var ERROR_EXPORT_PRIVATE_KEY = 'Error exporting private key';
+var ERROR_SIGN_MESSAGE = 'Error signing message';
+var ERROR_SIGN_TRANSACTION = 'Error signing transaction';
+var ERROR_ACCOUNT_ADDRESS_REQUIRED = 'Account address is required';
+var ERROR_RAW_DATA_HEX_REQUIRED = 'Transaction raw_data_hex is required';
+var ERROR_INVALID_RAW_PUBLIC_KEY = 'Invalid raw public key instance';
+/**
+ * TRON network identifiers.
+ *
+ * Mainnet, Shasta, and Nile share the same address format and the same MPC
+ * keyshare namespace (SLIP-44 coin type 195). They only differ at the RPC /
+ * full-node URL level, so the wallet client itself is network-agnostic; the
+ * network passes through transactions via the raw_data the caller assembled
+ * against the appropriate full-node endpoint.
+ */ var TRON_NETWORKS = {
+    MAINNET: {
+        name: 'Mainnet',
+        rpcUrl: 'https://api.trongrid.io',
+        chainId: '0x2b6653dc'
+    },
+    SHASTA: {
+        name: 'Shasta',
+        rpcUrl: 'https://api.shasta.trongrid.io',
+        chainId: '0x94a9059e'
+    },
+    NILE: {
+        name: 'Nile',
+        rpcUrl: 'https://nile.trongrid.io',
+        chainId: '0xcd8690dc'
+    }
+};
+
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+function _assert_this_initialized(self) {
+    if (self === void 0) {
+        throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
+    }
+    return self;
+}
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _call_super(_this, derived, args) {
+    derived = _get_prototype_of(derived);
+    return _possible_constructor_return(_this, _is_native_reflect_construct() ? Reflect.construct(derived, args || [], _get_prototype_of(_this).constructor) : derived.apply(_this, args));
+}
+function _class_call_check(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+function _defineProperties(target, props) {
+    for(var i = 0; i < props.length; i++){
+        var descriptor = props[i];
+        descriptor.enumerable = descriptor.enumerable || false;
+        descriptor.configurable = true;
+        if ("value" in descriptor) descriptor.writable = true;
+        Object.defineProperty(target, descriptor.key, descriptor);
+    }
+}
+function _create_class(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+    return Constructor;
+}
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _get_prototype_of(o) {
+    _get_prototype_of = Object.setPrototypeOf ? Object.getPrototypeOf : function getPrototypeOf(o) {
+        return o.__proto__ || Object.getPrototypeOf(o);
+    };
+    return _get_prototype_of(o);
+}
+function _inherits(subClass, superClass) {
+    if (typeof superClass !== "function" && superClass !== null) {
+        throw new TypeError("Super expression must either be null or a function");
+    }
+    subClass.prototype = Object.create(superClass && superClass.prototype, {
+        constructor: {
+            value: subClass,
+            writable: true,
+            configurable: true
+        }
+    });
+    if (superClass) _set_prototype_of(subClass, superClass);
+}
+function _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
+function _possible_constructor_return(self, call) {
+    if (call && (_type_of(call) === "object" || typeof call === "function")) {
+        return call;
+    }
+    return _assert_this_initialized(self);
+}
+function _set_prototype_of(o, p) {
+    _set_prototype_of = Object.setPrototypeOf || function setPrototypeOf(o, p) {
+        o.__proto__ = p;
+        return o;
+    };
+    return _set_prototype_of(o, p);
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+function _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+function _is_native_reflect_construct() {
+    try {
+        var result = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function() {}));
+    } catch (_) {}
+    return (_is_native_reflect_construct = function() {
+        return !!result;
+    })();
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, g, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    };
+    return g = {
+        next: verb(0),
+        "throw": verb(1),
+        "return": verb(2)
+    }, typeof Symbol === "function" && (g[Symbol.iterator] = function() {
+        return this;
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(_)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+var logError = node.createLogError('node-tron');
+/**
+ * Wallet client for TRON (SLIP-44 coin type 195, secp256k1 / ECDSA).
+ *
+ * V1 surface: create / signMessage (TIP-191, aka signMessageV2) /
+ * signTransaction / importPrivateKey / exportPrivateKey.
+ *
+ * Networks (Mainnet / Shasta / Nile) share the same address format and
+ * keyshare namespace; the network is selected at the broadcast layer via the
+ * raw_data the caller assembles against the full node of their choice. See
+ * `TRON_NETWORKS` in `./constants`.
+ *
+ * Address derivation: keccak256 of the uncompressed secp256k1 public key
+ * (minus the 0x04 prefix), last 20 bytes, prefixed with 0x41, encoded as
+ * Base58Check (`T...`).
+ *
+ * Transaction signing: SHA-256 of `raw_data_hex` is the digest, sent through
+ * the sign path as a pre-hashed (`isFormatted: true`) payload.
+ *
+ * Message signing (TIP-191): keccak256 of `\x19TRON Signed Message:\n<len><msg>`.
+ */ var DynamicTronWalletClient = /*#__PURE__*/ function(DynamicWalletClient) {
+    _inherits(DynamicTronWalletClient, DynamicWalletClient);
+    function DynamicTronWalletClient(param) {
+        var environmentId = param.environmentId, baseApiUrl = param.baseApiUrl, baseMPCRelayApiUrl = param.baseMPCRelayApiUrl, debug = param.debug, enableMPCAccelerator = param.enableMPCAccelerator, logger = param.logger;
+        _class_call_check(this, DynamicTronWalletClient);
+        var _this;
+        _this = _call_super(this, DynamicTronWalletClient, [
+            {
+                environmentId: environmentId,
+                baseApiUrl: baseApiUrl,
+                baseMPCRelayApiUrl: baseMPCRelayApiUrl,
+                debug: debug,
+                enableMPCAccelerator: enableMPCAccelerator,
+                logger: logger
+            }
+        ]), _define_property(_this, "chainName", 'TRON');
+        return _this;
+    }
+    _create_class(DynamicTronWalletClient, [
+        {
+            key: "createWalletAccount",
+            value: /**
+   * Creates a new wallet account.
+   * @param thresholdSignatureScheme - The threshold signature scheme to use for the wallet.
+   * @param password - The password to use for the wallet.
+   * @param onError - The function to call if an error occurs.
+   * @param backUpToDynamic - Whether to back up the external server key shares to the client share service. By default, it is false.
+   * @returns The walletMetadata, public key hex, raw public key, and external server key shares.
+   */ function createWalletAccount(param) {
+                var thresholdSignatureScheme = param.thresholdSignatureScheme, password = param.password, onError = param.onError, _param_backUpToDynamic = param.backUpToDynamic, backUpToDynamic = _param_backUpToDynamic === void 0 ? false : _param_backUpToDynamic;
+                var _this = this;
+                return _async_to_generator(function() {
+                    var ceremony, _ref, rawPublicKey, externalServerKeyShares, _ceremony_completion, resolvedWalletId, resolvedShareSetId, _this_deriveAccountAddress, accountAddress, publicKeyHex, chainConfig, walletMetadata, _ref1, keySharesWithBackupStatus, backupInfo, _ceremony_completion_encryptedWalletApiKey, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    4,
+                                    ,
+                                    5
+                                ]);
+                                ceremony = _this.createCeremonyCompletionTracker();
+                                return [
+                                    4,
+                                    _this.keyGen({
+                                        chainName: _this.chainName,
+                                        thresholdSignatureScheme: thresholdSignatureScheme,
+                                        skipLock: true,
+                                        password: password,
+                                        backUpToDynamic: backUpToDynamic,
+                                        onError: onError,
+                                        onCeremonyComplete: ceremony.onCeremonyComplete
+                                    })
+                                ];
+                            case 1:
+                                _ref = _state.sent(), rawPublicKey = _ref.rawPublicKey, externalServerKeyShares = _ref.externalServerKeyShares;
+                                return [
+                                    4,
+                                    ceremony.promise
+                                ];
+                            case 2:
+                                _state.sent();
+                                _ceremony_completion = ceremony.completion, resolvedWalletId = _ceremony_completion.walletId, resolvedShareSetId = _ceremony_completion.shareSetId;
+                                if (!rawPublicKey || !externalServerKeyShares || !resolvedWalletId) {
+                                    throw new Error(ERROR_KEYGEN_FAILED);
+                                }
+                                _this.checkRawPublicKeyInstance(rawPublicKey);
+                                _this_deriveAccountAddress = _this.deriveAccountAddress({
+                                    rawPublicKey: rawPublicKey
+                                }), accountAddress = _this_deriveAccountAddress.accountAddress, publicKeyHex = _this_deriveAccountAddress.publicKeyHex;
+                                chainConfig = node.getMPCChainConfig(_this.chainName);
+                                walletMetadata = {
+                                    walletId: resolvedWalletId,
+                                    accountAddress: accountAddress,
+                                    chainName: _this.chainName,
+                                    thresholdSignatureScheme: thresholdSignatureScheme,
+                                    derivationPath: JSON.stringify(Object.fromEntries(chainConfig.derivationPath.map(function(value, index) {
+                                        return [
+                                            index,
+                                            value
+                                        ];
+                                    }))),
+                                    shareSetId: resolvedShareSetId
+                                };
+                                return [
+                                    4,
+                                    _this.storeEncryptedBackupByWalletWithRetry({
+                                        accountAddress: accountAddress,
+                                        externalServerKeyShares: externalServerKeyShares,
+                                        password: password,
+                                        backUpToDynamic: backUpToDynamic,
+                                        walletMetadata: walletMetadata
+                                    })
+                                ];
+                            case 3:
+                                _ref1 = _state.sent(), keySharesWithBackupStatus = _ref1.keySharesWithBackupStatus, backupInfo = _ref1.backupInfo;
+                                walletMetadata.externalServerKeySharesBackupInfo = backupInfo;
+                                return [
+                                    2,
+                                    {
+                                        walletMetadata: walletMetadata,
+                                        rawPublicKey: rawPublicKey,
+                                        publicKeyHex: publicKeyHex,
+                                        externalServerKeyShares: externalServerKeyShares,
+                                        externalKeySharesWithBackupStatus: keySharesWithBackupStatus,
+                                        encryptedWalletApiKey: (_ceremony_completion_encryptedWalletApiKey = ceremony.completion.encryptedWalletApiKey) !== null && _ceremony_completion_encryptedWalletApiKey !== void 0 ? _ceremony_completion_encryptedWalletApiKey : undefined
+                                    }
+                                ];
+                            case 4:
+                                error = _state.sent();
+                                logError({
+                                    message: ERROR_CREATE_WALLET_ACCOUNT,
+                                    error: error,
+                                    context: {}
+                                });
+                                throw new Error(ERROR_CREATE_WALLET_ACCOUNT, {
+                                    cause: error
+                                });
+                            case 5:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            key: "signMessage",
+            value: /**
+   * TIP-191 personal-sign for TRON. This is the `signMessageV2` surface — there
+   * is no V1 legacy message-sign path for TRON.
+   *
+   * The TIP-191 prefix + keccak256 hashing happens client-side; the resulting
+   * 32-byte digest goes through the sign path as `isFormatted: true` (matches
+   * the browser TRON client and the EVM pre-hashed contract).
+   *
+   * @returns `0x`-prefixed `r || s || v` signature with v normalized to 0/1.
+   */ function signMessage(param) {
+                var message = param.message, walletMetadata = param.walletMetadata, _param_password = param.password, password = _param_password === void 0 ? undefined : _param_password, externalServerKeyShares = param.externalServerKeyShares, context = param.context, onError = param.onError;
+                var _this = this;
+                return _async_to_generator(function() {
+                    var accountAddress, digest, messageBytes, resolvedContext, signatureEcdsa, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                accountAddress = walletMetadata.accountAddress;
+                                _state.label = 1;
+                            case 1:
+                                _state.trys.push([
+                                    1,
+                                    3,
+                                    ,
+                                    4
+                                ]);
+                                if (!accountAddress) {
+                                    throw new Error(ERROR_ACCOUNT_ADDRESS_REQUIRED);
+                                }
+                                digest = formatTronMessage(message);
+                                // TIP-191 pre-image as rawSign context — a bare digest is rejected as
+                                // missing_context by policy-enabled wallets.
+                                messageBytes = toTronMessageBytes(message);
+                                resolvedContext = node.resolveRawSignContext(context, {
+                                    hashFunction: node.SignMessageRawSignHashFunctionEnum.Keccak256,
+                                    payload: Buffer.from(messageBytes).toString('hex'),
+                                    prefix: Buffer.from("".concat(TRON_SIGN_MESSAGE_PREFIX).concat(messageBytes.length), 'utf8').toString('hex')
+                                });
+                                return [
+                                    4,
+                                    _this.sign({
+                                        message: digest,
+                                        accountAddress: accountAddress,
+                                        chainName: _this.chainName,
+                                        password: password,
+                                        externalServerKeyShares: externalServerKeyShares,
+                                        isFormatted: true,
+                                        context: resolvedContext,
+                                        onError: onError,
+                                        walletMetadata: walletMetadata
+                                    })
+                                ];
+                            case 2:
+                                signatureEcdsa = _state.sent();
+                                return [
+                                    2,
+                                    serializeECDSASignature(signatureEcdsa)
+                                ];
+                            case 3:
+                                error = _state.sent();
+                                logError({
+                                    message: ERROR_SIGN_MESSAGE,
+                                    error: error,
+                                    context: {
+                                        accountAddress: accountAddress
+                                    }
+                                });
+                                throw new Error(ERROR_SIGN_MESSAGE, {
+                                    cause: error
+                                });
+                            case 4:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            /**
+   * Alias for {@link signMessage} — the TIP-191 sign surface is the only
+   * TRON message-sign path (there is no V1 variant for this chain).
+   */ key: "signMessageV2",
+            value: function signMessageV2(args) {
+                return this.signMessage(args);
+            }
+        },
+        {
+            /**
+   * Returns the `0x`-prefixed TIP-191 digest that `signMessage` sends to the
+   * signer — mirrors the browser client's `prepareSignMessage`.
+   */ key: "prepareSignMessage",
+            value: function prepareSignMessage(param) {
+                var message = param.message;
+                return "0x".concat(Buffer.from(formatTronMessage(message)).toString('hex'));
+            }
+        },
+        {
+            key: "signTransaction",
+            value: /**
+   * Sign a TRON transaction.
+   *
+   * The caller supplies the unsigned `raw_data_hex` produced by a TRON full
+   * node (e.g. `/wallet/createtransaction` or `/wallet/triggersmartcontract`),
+   * either as a parsed `TronTransaction` object or as the JSON string that
+   * came back from the full node. The signer hashes those bytes with SHA-256
+   * (the TRON `txID`) and signs the digest.
+   *
+   * Returns the entire signed transaction (with the new signature appended to
+   * `transaction.signature[]`) as a JSON string, ready to be passed to the
+   * full-node `/wallet/broadcasttransaction` endpoint.
+   */ function signTransaction(param) {
+                var walletMetadata = param.walletMetadata, transaction = param.transaction, _param_password = param.password, password = _param_password === void 0 ? undefined : _param_password, externalServerKeyShares = param.externalServerKeyShares, context = param.context, onError = param.onError;
+                var _this = this;
+                return _async_to_generator(function() {
+                    var accountAddress, rawParsed, parsedTransaction, digestBytes, txid, resolvedContext, signatureEcdsa, hexSig, _parsedTransaction_signature, signed, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                accountAddress = walletMetadata.accountAddress;
+                                if (!accountAddress) {
+                                    throw new Error(ERROR_ACCOUNT_ADDRESS_REQUIRED);
+                                }
+                                rawParsed = transaction;
+                                if (typeof transaction === 'string') {
+                                    try {
+                                        rawParsed = JSON.parse(transaction);
+                                    } catch (e) {
+                                        throw new Error(ERROR_RAW_DATA_HEX_REQUIRED);
+                                    }
+                                }
+                                if (!rawParsed || (typeof rawParsed === "undefined" ? "undefined" : _type_of(rawParsed)) !== 'object' || typeof rawParsed.raw_data_hex !== 'string' || rawParsed.raw_data_hex.length === 0) {
+                                    throw new Error(ERROR_RAW_DATA_HEX_REQUIRED);
+                                }
+                                parsedTransaction = rawParsed;
+                                _state.label = 1;
+                            case 1:
+                                _state.trys.push([
+                                    1,
+                                    3,
+                                    ,
+                                    4
+                                ]);
+                                digestBytes = getTronTxId(parsedTransaction.raw_data_hex);
+                                txid = getTronTxIdHex(parsedTransaction.raw_data_hex);
+                                resolvedContext = _object_spread_props(_object_spread({}, context), {
+                                    rawSign: {
+                                        hashFunction: node.SignMessageRawSignHashFunctionEnum.Sha256,
+                                        payload: parsedTransaction.raw_data_hex
+                                    }
+                                });
+                                return [
+                                    4,
+                                    _this.sign({
+                                        message: digestBytes,
+                                        accountAddress: accountAddress,
+                                        chainName: _this.chainName,
+                                        password: password,
+                                        externalServerKeyShares: externalServerKeyShares,
+                                        isFormatted: true,
+                                        context: resolvedContext,
+                                        onError: onError,
+                                        walletMetadata: walletMetadata,
+                                        walletOperation: node.WalletOperation.SIGN_TRANSACTION
+                                    })
+                                ];
+                            case 2:
+                                signatureEcdsa = _state.sent();
+                                hexSig = serializeECDSASignature(signatureEcdsa).slice(2);
+                                signed = _object_spread_props(_object_spread({}, parsedTransaction), {
+                                    // txID is always recomputed — a caller-supplied one could name a different payload.
+                                    txID: txid.slice(2),
+                                    signature: _to_consumable_array((_parsedTransaction_signature = parsedTransaction.signature) !== null && _parsedTransaction_signature !== void 0 ? _parsedTransaction_signature : []).concat([
+                                        hexSig
+                                    ])
+                                });
+                                return [
+                                    2,
+                                    JSON.stringify(signed)
+                                ];
+                            case 3:
+                                error = _state.sent();
+                                logError({
+                                    message: ERROR_SIGN_TRANSACTION,
+                                    error: error,
+                                    context: {
+                                        accountAddress: accountAddress
+                                    }
+                                });
+                                throw new Error(ERROR_SIGN_TRANSACTION, {
+                                    cause: error
+                                });
+                            case 4:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            key: "exportPrivateKey",
+            value: /**
+   * Exports the private key for a given wallet.
+   * @returns `0x`-prefixed 32-byte hex private key (tronweb / TronLink format).
+   */ function exportPrivateKey(param) {
+                var walletMetadata = param.walletMetadata, _param_password = param.password, password = _param_password === void 0 ? undefined : _param_password, externalServerKeyShares = param.externalServerKeyShares;
+                var _this = this;
+                return _async_to_generator(function() {
+                    var accountAddress, derivedPrivateKey, hex, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                accountAddress = walletMetadata.accountAddress;
+                                _state.label = 1;
+                            case 1:
+                                _state.trys.push([
+                                    1,
+                                    3,
+                                    ,
+                                    4
+                                ]);
+                                return [
+                                    4,
+                                    _this.exportKey({
+                                        accountAddress: accountAddress,
+                                        chainName: _this.chainName,
+                                        password: password,
+                                        externalServerKeyShares: externalServerKeyShares,
+                                        walletMetadata: walletMetadata
+                                    })
+                                ];
+                            case 2:
+                                derivedPrivateKey = _state.sent().derivedPrivateKey;
+                                if (!derivedPrivateKey) {
+                                    throw new Error('Derived private key is undefined');
+                                }
+                                hex = derivedPrivateKey.startsWith('0x') ? derivedPrivateKey.slice(2) : derivedPrivateKey;
+                                return [
+                                    2,
+                                    "0x".concat(hex)
+                                ];
+                            case 3:
+                                error = _state.sent();
+                                logError({
+                                    message: ERROR_EXPORT_PRIVATE_KEY,
+                                    error: error,
+                                    context: {
+                                        accountAddress: accountAddress
+                                    }
+                                });
+                                throw new Error(ERROR_EXPORT_PRIVATE_KEY);
+                            case 4:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            key: "offlineExportPrivateKey",
+            value: /**
+   * `derivationPath` is the JSON-serialized index map that
+   * `walletMetadata.derivationPath` carries (e.g. `'{"0":44,"1":195,"2":0,"3":0,"4":0}'`
+   * or `'[44,195,0,0,0]'`). BIP-32 strings such as `"m/44'/195'/0'/0/0"` are rejected.
+   * Omit it to export without path derivation.
+   */ function offlineExportPrivateKey(param) {
+                var keyShares = param.keyShares, derivationPath = param.derivationPath;
+                var _this = this;
+                return _async_to_generator(function() {
+                    var derivedPrivateKey;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    _this.offlineExportKey({
+                                        chainName: _this.chainName,
+                                        keyShares: keyShares,
+                                        derivationPath: derivationPath
+                                    })
+                                ];
+                            case 1:
+                                derivedPrivateKey = _state.sent().derivedPrivateKey;
+                                return [
+                                    2,
+                                    {
+                                        derivedPrivateKey: derivedPrivateKey
+                                    }
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            key: "importPrivateKey",
+            value: /**
+   * Imports a private key.
+   * @param privateKey - The private key to import (hex, with or without 0x).
+   * @param chainName - The chain name to use for the wallet.
+   * @param thresholdSignatureScheme - The threshold signature scheme to use for the wallet.
+   * @param password - The password to use for the wallet.
+   * @param onError - The function to call if an error occurs.
+   * @param backUpToDynamic - Whether to back up the external server key shares to the client share service. By default, it is false.
+   * @param publicAddressCheck - Optional TRON address to verify the imported key against.
+   * @returns The walletMetadata, public key hex, raw public key, and external server key shares.
+   */ function importPrivateKey(param) {
+                var privateKey = param.privateKey, thresholdSignatureScheme = param.thresholdSignatureScheme, password = param.password, _param_backUpToDynamic = param.backUpToDynamic, backUpToDynamic = _param_backUpToDynamic === void 0 ? false : _param_backUpToDynamic, onError = param.onError, publicAddressCheck = param.publicAddressCheck;
+                var _this = this;
+                return _async_to_generator(function() {
+                    var resolvedWalletId, resolvedShareSetId, ceremonyCeremonyCompleteResolver, ceremonyCompletePromise, formattedPrivateKey, _ref, rawPublicKey, externalServerKeyShares, _this_deriveAccountAddress, accountAddress, publicKeyHex, chainConfig, walletMetadata, _ref1, keySharesWithBackupStatus, backupInfo, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    4,
+                                    ,
+                                    5
+                                ]);
+                                if (publicAddressCheck && !isValidTronAddress(publicAddressCheck)) {
+                                    throw new Error('Invalid TRON address provided for publicAddressCheck');
+                                }
+                                ceremonyCompletePromise = new Promise(function(resolve) {
+                                    ceremonyCeremonyCompleteResolver = resolve;
+                                });
+                                formattedPrivateKey = privateKey.startsWith('0x') ? privateKey.slice(2) : privateKey;
+                                return [
+                                    4,
+                                    _this.importRawPrivateKey({
+                                        chainName: _this.chainName,
+                                        privateKey: formattedPrivateKey,
+                                        thresholdSignatureScheme: thresholdSignatureScheme,
+                                        password: password,
+                                        backUpToDynamic: backUpToDynamic,
+                                        onCeremonyComplete: function(_accountAddress, walletId, shareSetId) {
+                                            resolvedWalletId = walletId;
+                                            resolvedShareSetId = shareSetId;
+                                            ceremonyCeremonyCompleteResolver(undefined);
+                                        },
+                                        onError: function(e) {
+                                            logError({
+                                                message: 'importPrivateKey: onError',
+                                                error: e,
+                                                context: {}
+                                            });
+                                            onError === null || onError === void 0 ? void 0 : onError(e);
+                                        }
+                                    })
+                                ];
+                            case 1:
+                                _ref = _state.sent(), rawPublicKey = _ref.rawPublicKey, externalServerKeyShares = _ref.externalServerKeyShares;
+                                return [
+                                    4,
+                                    ceremonyCompletePromise
+                                ];
+                            case 2:
+                                _state.sent();
+                                if (!rawPublicKey || !externalServerKeyShares || !resolvedWalletId) {
+                                    throw new Error(ERROR_IMPORT_PRIVATE_KEY);
+                                }
+                                _this.checkRawPublicKeyInstance(rawPublicKey);
+                                _this_deriveAccountAddress = _this.deriveAccountAddress({
+                                    rawPublicKey: rawPublicKey
+                                }), accountAddress = _this_deriveAccountAddress.accountAddress, publicKeyHex = _this_deriveAccountAddress.publicKeyHex;
+                                if (publicAddressCheck && accountAddress !== publicAddressCheck) {
+                                    throw new Error('Public address mismatch between derived and provided publicAddressCheck');
+                                }
+                                chainConfig = node.getMPCChainConfig(_this.chainName);
+                                walletMetadata = {
+                                    walletId: resolvedWalletId,
+                                    accountAddress: accountAddress,
+                                    chainName: _this.chainName,
+                                    thresholdSignatureScheme: thresholdSignatureScheme,
+                                    derivationPath: JSON.stringify(Object.fromEntries(chainConfig.derivationPath.map(function(value, index) {
+                                        return [
+                                            index,
+                                            value
+                                        ];
+                                    }))),
+                                    shareSetId: resolvedShareSetId
+                                };
+                                return [
+                                    4,
+                                    _this.storeEncryptedBackupByWalletWithRetry({
+                                        accountAddress: accountAddress,
+                                        externalServerKeyShares: externalServerKeyShares,
+                                        password: password,
+                                        backUpToDynamic: backUpToDynamic,
+                                        walletMetadata: walletMetadata
+                                    })
+                                ];
+                            case 3:
+                                _ref1 = _state.sent(), keySharesWithBackupStatus = _ref1.keySharesWithBackupStatus, backupInfo = _ref1.backupInfo;
+                                walletMetadata.externalServerKeySharesBackupInfo = backupInfo;
+                                return [
+                                    2,
+                                    {
+                                        walletMetadata: walletMetadata,
+                                        rawPublicKey: rawPublicKey,
+                                        publicKeyHex: publicKeyHex,
+                                        externalServerKeyShares: externalServerKeyShares,
+                                        externalKeySharesWithBackupStatus: keySharesWithBackupStatus
+                                    }
+                                ];
+                            case 4:
+                                error = _state.sent();
+                                logError({
+                                    message: ERROR_IMPORT_PRIVATE_KEY,
+                                    error: error,
+                                    context: {}
+                                });
+                                onError === null || onError === void 0 ? void 0 : onError(error);
+                                throw new Error(ERROR_IMPORT_PRIVATE_KEY);
+                            case 5:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            /**
+   * Derives the TRON Base58Check address from an MPC ECDSA public key.
+   */ key: "deriveAccountAddress",
+            value: function deriveAccountAddress(param) {
+                var rawPublicKey = param.rawPublicKey;
+                var publicKeyHex = rawPublicKey.pubKeyAsHex();
+                var serializedUncompressed = rawPublicKey.serializeUncompressed();
+                var uncompressedHex = Buffer.from(serializedUncompressed).toString('hex');
+                var accountAddress = deriveTronAddress({
+                    publicKeyHex: uncompressedHex
+                });
+                return {
+                    accountAddress: accountAddress,
+                    publicKeyHex: publicKeyHex
+                };
+            }
+        },
+        {
+            key: "getTronWallets",
+            value: /**
+   * Gets all TRON wallets.
+   * @returns Array of TRON wallets
+   */ function getTronWallets() {
+                var _this = this;
+                return _async_to_generator(function() {
+                    var wallets, tronWallets;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    _this.getWallets()
+                                ];
+                            case 1:
+                                wallets = _state.sent();
+                                tronWallets = wallets.filter(function(wallet) {
+                                    return wallet.chainName === 'TRON';
+                                });
+                                return [
+                                    2,
+                                    tronWallets
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            key: "checkRawPublicKeyInstance",
+            value: /**
+   * Check if the raw public key is a valid ECDSA public key instance.
+   */ function checkRawPublicKeyInstance(rawPublicKey) {
+                if (!rawPublicKey || (typeof rawPublicKey === "undefined" ? "undefined" : _type_of(rawPublicKey)) !== 'object' || !('serializeUncompressed' in rawPublicKey) || !('pubKeyAsHex' in rawPublicKey)) {
+                    throw new Error(ERROR_INVALID_RAW_PUBLIC_KEY);
+                }
+            }
+        }
+    ]);
+    return DynamicTronWalletClient;
+}(node.DynamicWalletClient);
+
+exports.DynamicTronWalletClient = DynamicTronWalletClient;
+exports.ERROR_ACCOUNT_ADDRESS_REQUIRED = ERROR_ACCOUNT_ADDRESS_REQUIRED;
+exports.ERROR_CREATE_WALLET_ACCOUNT = ERROR_CREATE_WALLET_ACCOUNT;
+exports.ERROR_EXPORT_PRIVATE_KEY = ERROR_EXPORT_PRIVATE_KEY;
+exports.ERROR_IMPORT_PRIVATE_KEY = ERROR_IMPORT_PRIVATE_KEY;
+exports.ERROR_INVALID_RAW_PUBLIC_KEY = ERROR_INVALID_RAW_PUBLIC_KEY;
+exports.ERROR_KEYGEN_FAILED = ERROR_KEYGEN_FAILED;
+exports.ERROR_RAW_DATA_HEX_REQUIRED = ERROR_RAW_DATA_HEX_REQUIRED;
+exports.ERROR_SIGN_MESSAGE = ERROR_SIGN_MESSAGE;
+exports.ERROR_SIGN_TRANSACTION = ERROR_SIGN_TRANSACTION;
+exports.TRON_ADDRESS_PREFIX = TRON_ADDRESS_PREFIX;
+exports.TRON_NETWORKS = TRON_NETWORKS;
+exports.TRON_SIGN_MESSAGE_PREFIX = TRON_SIGN_MESSAGE_PREFIX;
+exports.decodeTronAddress = decodeTronAddress;
+exports.deriveTronAddress = deriveTronAddress;
+exports.formatTronMessage = formatTronMessage;
+exports.getTronTxId = getTronTxId;
+exports.getTronTxIdHex = getTronTxIdHex;
+exports.isValidTronAddress = isValidTronAddress;
+exports.serializeECDSASignature = serializeECDSASignature;
+exports.toTronMessageBytes = toTronMessageBytes;
+exports.tronAddressToHex = tronAddressToHex;