@dynamic-labs-wallet/tron 0.0.0 → 1.0.1

package/index.cjs

@@ -0,0 +1,1155 @@
+'use strict';
+
+var browser = require('@dynamic-labs-wallet/browser');
+var sha3 = require('@noble/hashes/sha3');
+var sha256 = require('@noble/hashes/sha256');
+var bs58 = require('bs58');
+var sdkApiCore = require('@dynamic-labs/sdk-api-core');
+
+function _interopNamespaceDefault(e) {
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var sdkApiCore__namespace = /*#__PURE__*/_interopNamespaceDefault(sdkApiCore);
+
+/**
+ * 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;
+/**
+ * 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).
+ *
+ * Mainnet, Shasta, and Nile share the same address format — the network is
+ * resolved by the RPC endpoint, not the address itself.
+ *
+ * @see https://github.com/tronprotocol/tips/blob/master/tip-21.md
+ */ var hexToBytes$1 = function(hex) {
+    var buf = Buffer.from(hex, 'hex');
+    return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+};
+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$2(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. Mirrors the shape of `formatTempoMessage` so the wallet client can
+ * treat both chains uniformly.
+ *
+ * - `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$2(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 converts this into a
+ * `MessageHash` (`isFormatted: true`) before handing it to `sign(...)` so
+ * the forward-MPC path sees a pre-hashed payload.
+ */ var formatTronMessage = function(message, logger) {
+    try {
+        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);
+    } catch (error) {
+        logger.error('[DynamicTronWalletClient]: Error formatting TRON message:', error);
+        throw error;
+    }
+};
+
+/**
+ * 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'));
+};
+
+function _instanceof$1(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+/**
+ * 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, logger) {
+    try {
+        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);
+    } catch (error) {
+        logger.error('[DynamicTronWalletClient]: Error serializing ECDSA signature:', _instanceof$1(error, Error) ? error.message : String(error));
+        throw error;
+    }
+};
+
+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';
+
+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 _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+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
+        };
+    }
+}
+/**
+ * Wallet client for TRON (SLIP-44 coin type 195, secp256k1 / ECDSA).
+ *
+ * V1 surface (matches the locked Wave C-1 handoff):
+ *  - create / signMessageV2 / signTransaction / importPrivateKey / exportPrivateKey
+ *  - No legacy V1 message signing (`signMessage` returns a TIP-191 result;
+ *    consumers should call `signMessageV2`).
+ *  - 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 forward-MPC 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, internalOptions) {
+        var environmentId = param.environmentId, authToken = param.authToken, backupServiceAuthToken = param.backupServiceAuthToken, baseApiUrl = param.baseApiUrl, baseMPCRelayApiUrl = param.baseMPCRelayApiUrl, storageKey = param.storageKey, debug = param.debug, featureFlags = param.featureFlags, _param_authMode = param.authMode, authMode = _param_authMode === void 0 ? browser.AuthMode.HEADER : _param_authMode, sdkVersion = param.sdkVersion, forwardMPCClient = param.forwardMPCClient, logger = param.logger;
+        _class_call_check(this, DynamicTronWalletClient);
+        var _this;
+        _this = _call_super(this, DynamicTronWalletClient, [
+            {
+                environmentId: environmentId,
+                authToken: authToken,
+                backupServiceAuthToken: backupServiceAuthToken,
+                baseApiUrl: baseApiUrl,
+                baseMPCRelayApiUrl: baseMPCRelayApiUrl,
+                storageKey: storageKey,
+                debug: debug,
+                featureFlags: featureFlags,
+                authMode: authMode,
+                sdkVersion: sdkVersion,
+                forwardMPCClient: forwardMPCClient,
+                logger: logger
+            },
+            internalOptions
+        ]), _define_property(_this, "chainName", 'TRON');
+        return _this;
+    }
+    _create_class(DynamicTronWalletClient, [
+        {
+            key: "createWalletAccount",
+            value: /**
+   * Create a new TRON wallet account using MPC key generation.
+   */ function createWalletAccount(param) {
+                var thresholdSignatureScheme = param.thresholdSignatureScheme, _param_password = param.password, password = _param_password === void 0 ? undefined : _param_password, onError = param.onError, signedSessionId = param.signedSessionId; param.traceContext;
+                var _this = this;
+                return _async_to_generator(function() {
+                    var ceremonyCompleteResolver, ceremonyCompletePromise, _ref, rawPublicKey, clientKeyShares, _this_deriveAccountAddress, accountAddress, publicKeyHex, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    5,
+                                    ,
+                                    6
+                                ]);
+                                ceremonyCompletePromise = new Promise(function(resolve) {
+                                    ceremonyCompleteResolver = resolve;
+                                });
+                                return [
+                                    4,
+                                    _this.keyGen({
+                                        chainName: _this.chainName,
+                                        thresholdSignatureScheme: thresholdSignatureScheme,
+                                        onError: function(error) {
+                                            _this.logger.error(ERROR_CREATE_WALLET_ACCOUNT, error);
+                                            onError === null || onError === void 0 ? void 0 : onError(error);
+                                        },
+                                        onCeremonyComplete: function(accountAddress, walletId) {
+                                            var chainConfig = browser.getMPCChainConfig(_this.chainName);
+                                            _this.initializeWalletMapEntry({
+                                                accountAddress: accountAddress,
+                                                walletId: walletId,
+                                                chainName: _this.chainName,
+                                                thresholdSignatureScheme: thresholdSignatureScheme,
+                                                derivationPath: JSON.stringify(Object.fromEntries(chainConfig.derivationPath.map(function(value, index) {
+                                                    return [
+                                                        index,
+                                                        value
+                                                    ];
+                                                })))
+                                            });
+                                            ceremonyCompleteResolver(undefined);
+                                        },
+                                        password: password,
+                                        signedSessionId: signedSessionId
+                                    })
+                                ];
+                            case 1:
+                                _ref = _state.sent(), rawPublicKey = _ref.rawPublicKey, clientKeyShares = _ref.clientKeyShares;
+                                return [
+                                    4,
+                                    ceremonyCompletePromise
+                                ];
+                            case 2:
+                                _state.sent();
+                                if (!rawPublicKey || !clientKeyShares) {
+                                    throw new Error(ERROR_KEYGEN_FAILED);
+                                }
+                                _this.checkRawPublicKeyInstance(rawPublicKey);
+                                _this_deriveAccountAddress = _this.deriveAccountAddress({
+                                    rawPublicKey: rawPublicKey
+                                }), accountAddress = _this_deriveAccountAddress.accountAddress, publicKeyHex = _this_deriveAccountAddress.publicKeyHex;
+                                return [
+                                    4,
+                                    _this.setClientKeySharesToStorage({
+                                        accountAddress: accountAddress,
+                                        clientKeyShares: clientKeyShares
+                                    })
+                                ];
+                            case 3:
+                                _state.sent();
+                                return [
+                                    4,
+                                    _this.storeEncryptedBackupByWallet({
+                                        accountAddress: accountAddress,
+                                        clientKeyShares: clientKeyShares,
+                                        password: password,
+                                        signedSessionId: signedSessionId
+                                    })
+                                ];
+                            case 4:
+                                _state.sent();
+                                return [
+                                    2,
+                                    {
+                                        accountAddress: accountAddress,
+                                        rawPublicKey: rawPublicKey,
+                                        publicKeyHex: publicKeyHex
+                                    }
+                                ];
+                            case 5:
+                                error = _state.sent();
+                                if (_instanceof(error, Error) && error.message === browser.ERROR_PASSWORD_MISMATCH) {
+                                    throw error;
+                                }
+                                _this.logger.error(ERROR_CREATE_WALLET_ACCOUNT, error);
+                                throw new Error(ERROR_CREATE_WALLET_ACCOUNT);
+                            case 6:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            key: "signMessage",
+            value: /**
+   * TIP-191 personal-sign for TRON. This is the `signMessageV2` surface
+   * referenced in the rollout — there is no V1 legacy message-sign path.
+   *
+   * The TIP-191 prefix + keccak256 hashing happens client-side; the resulting
+   * 32-byte digest is sent to the forward-MPC relay as `isFormatted: true`
+   * (matches the EVM/TEMPO forward-MPC contract).
+   */ function signMessage(param) {
+                var message = param.message, accountAddress = param.accountAddress, _param_password = param.password, password = _param_password === void 0 ? undefined : _param_password, signedSessionId = param.signedSessionId, mfaToken = param.mfaToken, elevatedAccessToken = param.elevatedAccessToken, context = param.context, onError = param.onError, traceContext = param.traceContext;
+                var _this = this;
+                return _async_to_generator(function() {
+                    var digest, signatureEcdsa, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                if (!accountAddress) {
+                                    throw new Error(ERROR_ACCOUNT_ADDRESS_REQUIRED);
+                                }
+                                return [
+                                    4,
+                                    _this.verifyPassword({
+                                        accountAddress: accountAddress,
+                                        password: password,
+                                        signedSessionId: signedSessionId
+                                    })
+                                ];
+                            case 1:
+                                _state.sent();
+                                _state.label = 2;
+                            case 2:
+                                _state.trys.push([
+                                    2,
+                                    4,
+                                    ,
+                                    5
+                                ]);
+                                digest = formatTronMessage(message, _this.logger);
+                                return [
+                                    4,
+                                    _this.sign({
+                                        message: digest,
+                                        accountAddress: accountAddress,
+                                        chainName: _this.chainName,
+                                        password: password,
+                                        signedSessionId: signedSessionId,
+                                        isFormatted: true,
+                                        mfaToken: mfaToken,
+                                        elevatedAccessToken: elevatedAccessToken,
+                                        context: context,
+                                        onError: onError,
+                                        traceContext: traceContext
+                                    })
+                                ];
+                            case 3:
+                                signatureEcdsa = _state.sent();
+                                return [
+                                    2,
+                                    serializeECDSASignature(signatureEcdsa, _this.logger)
+                                ];
+                            case 4:
+                                error = _state.sent();
+                                _this.logger.error(ERROR_SIGN_MESSAGE, error);
+                                throw new Error(ERROR_SIGN_MESSAGE);
+                            case 5:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            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 MPC 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. Returning a string
+   * (rather than the object) matches the SDK's iframe `signTransaction`
+   * contract, which only carries strings over message transport.
+   */ function signTransaction(param) {
+                var senderAddress = param.senderAddress, transaction = param.transaction, _param_password = param.password, password = _param_password === void 0 ? undefined : _param_password, signedSessionId = param.signedSessionId, mfaToken = param.mfaToken, elevatedAccessToken = param.elevatedAccessToken, context = param.context, onError = param.onError, traceContext = param.traceContext;
+                var _this = this;
+                return _async_to_generator(function() {
+                    var rawParsed, parsedTransaction, digestBytes, txid, resolvedContext, signatureEcdsa, serializedSig, hexSig, _parsedTransaction_signature, existingSignatures, _parsedTransaction_txID, signed, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                if (!senderAddress) {
+                                    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;
+                                return [
+                                    4,
+                                    _this.verifyPassword({
+                                        accountAddress: senderAddress,
+                                        password: password,
+                                        signedSessionId: signedSessionId
+                                    })
+                                ];
+                            case 1:
+                                _state.sent();
+                                _state.label = 2;
+                            case 2:
+                                _state.trys.push([
+                                    2,
+                                    4,
+                                    ,
+                                    5
+                                ]);
+                                digestBytes = getTronTxId(parsedTransaction.raw_data_hex);
+                                txid = getTronTxIdHex(parsedTransaction.raw_data_hex);
+                                resolvedContext = _object_spread_props(_object_spread({}, context), {
+                                    tronTransaction: {
+                                        rawDataHex: parsedTransaction.raw_data_hex,
+                                        txid: txid
+                                    }
+                                });
+                                return [
+                                    4,
+                                    _this.sign({
+                                        message: digestBytes,
+                                        accountAddress: senderAddress,
+                                        chainName: _this.chainName,
+                                        password: password,
+                                        signedSessionId: signedSessionId,
+                                        isFormatted: true,
+                                        mfaToken: mfaToken,
+                                        elevatedAccessToken: elevatedAccessToken,
+                                        context: resolvedContext,
+                                        onError: onError,
+                                        traceContext: traceContext
+                                    })
+                                ];
+                            case 3:
+                                signatureEcdsa = _state.sent();
+                                serializedSig = serializeECDSASignature(signatureEcdsa, _this.logger);
+                                hexSig = serializedSig.slice(2);
+                                existingSignatures = (_parsedTransaction_signature = parsedTransaction.signature) !== null && _parsedTransaction_signature !== void 0 ? _parsedTransaction_signature : [];
+                                signed = _object_spread_props(_object_spread({}, parsedTransaction), {
+                                    txID: (_parsedTransaction_txID = parsedTransaction.txID) !== null && _parsedTransaction_txID !== void 0 ? _parsedTransaction_txID : txid.slice(2),
+                                    signature: _to_consumable_array(existingSignatures).concat([
+                                        hexSig
+                                    ])
+                                });
+                                return [
+                                    2,
+                                    JSON.stringify(signed)
+                                ];
+                            case 4:
+                                error = _state.sent();
+                                _this.logger.error(ERROR_SIGN_TRANSACTION, error);
+                                throw new Error(ERROR_SIGN_TRANSACTION);
+                            case 5:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            /**
+   * Derive account address from ECDSA public key.
+   *
+   * TRON addresses are the keccak256 hash of the uncompressed pubkey (minus
+   * the 0x04 prefix), last 20 bytes, prefixed with 0x41, then Base58Check
+   * encoded.
+   */ 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: "exportPrivateKey",
+            value: /**
+   * Export private key from MPC key shares.
+   *
+   * TRON uses the raw hex (no encoded prefix) for its private key format,
+   * matching what tronweb / TronLink expose. We return it as 0x-prefixed
+   * so it round-trips cleanly through `importPrivateKey`.
+   */ function exportPrivateKey(param) {
+                var accountAddress = param.accountAddress, _param_password = param.password, password = _param_password === void 0 ? undefined : _param_password, signedSessionId = param.signedSessionId, mfaToken = param.mfaToken, elevatedAccessToken = param.elevatedAccessToken, traceContext = param.traceContext;
+                var _this = this;
+                return _async_to_generator(function() {
+                    var derivedPrivateKey, hex, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    2,
+                                    ,
+                                    3
+                                ]);
+                                return [
+                                    4,
+                                    _this.exportKey({
+                                        accountAddress: accountAddress,
+                                        chainName: _this.chainName,
+                                        password: password,
+                                        signedSessionId: signedSessionId,
+                                        mfaToken: mfaToken,
+                                        elevatedAccessToken: elevatedAccessToken,
+                                        traceContext: traceContext
+                                    })
+                                ];
+                            case 1:
+                                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 2:
+                                error = _state.sent();
+                                _this.logger.error(ERROR_EXPORT_PRIVATE_KEY, error);
+                                throw new Error(ERROR_EXPORT_PRIVATE_KEY);
+                            case 3:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            key: "offlineExportPrivateKey",
+            value: /**
+   * Offline export of private key from key shares.
+   */ 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: /**
+   * Import an existing TRON private key into MPC.
+   */ function importPrivateKey(param) {
+                var privateKey = param.privateKey, chainName = param.chainName, thresholdSignatureScheme = param.thresholdSignatureScheme, _param_password = param.password, password = _param_password === void 0 ? undefined : _param_password, onError = param.onError, signedSessionId = param.signedSessionId, publicAddressCheck = param.publicAddressCheck, legacyWalletId = param.legacyWalletId;
+                var _this = this;
+                return _async_to_generator(function() {
+                    var ceremonyCompleteResolver, ceremonyCompletePromise, formattedPrivateKey, _ref, rawPublicKey, clientKeyShares, _this_deriveAccountAddress, accountAddress, publicKeyHex, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    5,
+                                    ,
+                                    6
+                                ]);
+                                if (publicAddressCheck && !isValidTronAddress(publicAddressCheck)) {
+                                    throw new Error('Invalid TRON address provided for publicAddressCheck');
+                                }
+                                ceremonyCompletePromise = new Promise(function(resolve) {
+                                    ceremonyCompleteResolver = resolve;
+                                });
+                                formattedPrivateKey = privateKey.startsWith('0x') ? privateKey.slice(2) : privateKey;
+                                return [
+                                    4,
+                                    _this.importRawPrivateKey({
+                                        chainName: chainName,
+                                        privateKey: formattedPrivateKey,
+                                        thresholdSignatureScheme: thresholdSignatureScheme,
+                                        onCeremonyComplete: function(accountAddress, walletId) {
+                                            _this.initializeWalletMapEntry({
+                                                accountAddress: accountAddress,
+                                                walletId: walletId,
+                                                chainName: _this.chainName,
+                                                thresholdSignatureScheme: thresholdSignatureScheme
+                                            });
+                                            ceremonyCompleteResolver(undefined);
+                                        },
+                                        onError: onError,
+                                        legacyWalletId: legacyWalletId,
+                                        password: password,
+                                        signedSessionId: signedSessionId
+                                    })
+                                ];
+                            case 1:
+                                _ref = _state.sent(), rawPublicKey = _ref.rawPublicKey, clientKeyShares = _ref.clientKeyShares;
+                                return [
+                                    4,
+                                    ceremonyCompletePromise
+                                ];
+                            case 2:
+                                _state.sent();
+                                if (!rawPublicKey || !clientKeyShares) {
+                                    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');
+                                }
+                                return [
+                                    4,
+                                    _this.setClientKeySharesToStorage({
+                                        accountAddress: accountAddress,
+                                        clientKeyShares: clientKeyShares
+                                    })
+                                ];
+                            case 3:
+                                _state.sent();
+                                return [
+                                    4,
+                                    _this.storeEncryptedBackupByWallet({
+                                        accountAddress: accountAddress,
+                                        clientKeyShares: clientKeyShares,
+                                        password: password,
+                                        signedSessionId: signedSessionId
+                                    })
+                                ];
+                            case 4:
+                                _state.sent();
+                                return [
+                                    2,
+                                    {
+                                        accountAddress: accountAddress,
+                                        rawPublicKey: rawPublicKey,
+                                        publicKeyHex: publicKeyHex
+                                    }
+                                ];
+                            case 5:
+                                error = _state.sent();
+                                _this.logger.error(ERROR_IMPORT_PRIVATE_KEY, error);
+                                onError === null || onError === void 0 ? void 0 : onError(error);
+                                throw error;
+                            case 6:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            key: "getTronWallets",
+            value: /**
+   * Get all TRON wallets known to this client.
+   */ function getTronWallets() {
+                var _this = this;
+                return _async_to_generator(function() {
+                    var wallets;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    _this.getWallets()
+                                ];
+                            case 1:
+                                wallets = _state.sent();
+                                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                                return [
+                                    2,
+                                    wallets.filter(function(wallet) {
+                                        return wallet.chainName === 'TRON';
+                                    })
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            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;
+}(browser.DynamicWalletClient);
+
+exports.sdkApiCore = sdkApiCore__namespace;
+exports.DynamicTronWalletClient = DynamicTronWalletClient;
+exports.TRON_ADDRESS_PREFIX = TRON_ADDRESS_PREFIX;
+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;