@hwlt/era-connect 0.1.0

package/dist/tron-Bo9HnvVE.js

@@ -0,0 +1,158 @@
+import { G as cbMap, L as xfpToHex, N as normalizeXfp, P as parsePath, T as concatBytes, W as cbBytes, Y as mapGet, Z as EraSdkError, _ as Ur, c as resolveRequestId, g as uuidStringify, h as normalizeRequestId, l as toUr, n as makeSignRequest, o as requireUrType, q as cbText, r as requireReplyMap, s as resolveContext, x as cborEncode, y as crc32, z as asBytes } from "./shared-B8Wc7ViU.js";
+import { n as encodeSignRequestProto, r as splitSignedTronTx, t as decodeSignResultProto } from "./messages-17Oup0-Z.js";
+import { Gunzip, gzipSync } from "fflate";
+//#region src/tron-proto/gzip.ts
+/** Smallest possible gzip stream: 10-byte header + 8-byte trailer. */
+const MIN_GZIP_BYTES = 18;
+/** Bytes fed to the inflater per step; bounds the overshoot past the cap. */
+const SLICE_BYTES = 1024;
+/** Deterministic gzip (fixed level, zeroed mtime) for reproducible request bytes. */
+function gzipCompress(data) {
+	return gzipSync(data, {
+		level: 9,
+		mtime: 0
+	});
+}
+/**
+* Inflate with a hard output ceiling.
+*
+* A one-shot gunzip allocates the entire output before anyone can refuse it —
+* gzip reaches ~1000:1 in practice, so a few hundred scanned bytes could ask
+* for an arbitrary allocation. The decoder is therefore driven in slices and
+* the output counted as it arrives; the moment the total would pass the cap,
+* feeding stops and the reply is refused.
+*
+* The trailer's ISIZE (declared inflated length) is used twice: as a cheap
+* refusal of honest bombs before any work, and as a truncation check at the
+* end — an inflater hands back a partial buffer for a truncated stream
+* without erroring, and a genuine device reply always declares honestly.
+*/
+function gunzipCapped(data, maxOutputBytes) {
+	if (data.length < MIN_GZIP_BYTES) throw new EraSdkError("gzip-error", "compressed payload is too short to be a gzip stream");
+	if (data[0] !== 31 || data[1] !== 139) throw new EraSdkError("gzip-error", "compressed payload is not a gzip stream");
+	const n = data.length;
+	const isize = (data[n - 4] | data[n - 3] << 8 | data[n - 2] << 16 | data[n - 1] << 24) >>> 0;
+	if (isize > maxOutputBytes) throw new EraSdkError("gzip-error", `compressed payload declares ${isize} bytes, over the ${maxOutputBytes} byte ceiling`);
+	const chunks = [];
+	let total = 0;
+	let overflowed = false;
+	let malformed = null;
+	const gunzip = new Gunzip((chunk) => {
+		if (overflowed) return;
+		if (total + chunk.length > maxOutputBytes) {
+			overflowed = true;
+			return;
+		}
+		chunks.push(chunk);
+		total += chunk.length;
+	});
+	try {
+		for (let offset = 0; offset < n && !overflowed; offset += SLICE_BYTES) {
+			const end = Math.min(offset + SLICE_BYTES, n);
+			const isLast = end === n;
+			gunzip.push(data.slice(offset, end), isLast);
+		}
+	} catch (e) {
+		malformed = e.message ?? "inflate error";
+	}
+	if (overflowed) throw new EraSdkError("gzip-error", `compressed payload inflates past the ${maxOutputBytes} byte ceiling`);
+	if (malformed !== null) throw new EraSdkError("gzip-error", `compressed payload is malformed: ${malformed}`);
+	const out = concatBytes(...chunks);
+	if (out.length !== isize) throw new EraSdkError("gzip-error", `compressed payload inflated to ${out.length} bytes but declares ${isize} — truncated or malformed`);
+	const declaredCrc = (data[n - 8] | data[n - 7] << 8 | data[n - 6] << 16 | data[n - 5] << 24) >>> 0;
+	if (crc32(out) !== declaredCrc) throw new EraSdkError("gzip-error", "compressed payload is malformed: CRC mismatch");
+	return out;
+}
+//#endregion
+//#region src/chains/tron.ts
+/**
+* Ceilings on the gzip blob a `keystone-sign-result` may carry. Tron is the
+* only chain whose reply is compressed, so it is the only one where a few
+* hundred scanned bytes can ask for an arbitrary allocation. Generous
+* multiples of the largest real device reply.
+*/
+const MAX_COMPRESSED_BYTES = 8192;
+const MAX_INFLATED_BYTES = 65536;
+const REPLY_TYPES = ["keystone-sign-result"];
+/**
+* Tron signing rides the structured `keystone-sign-request` (6101) envelope —
+* a gzip-compressed protobuf inside CBOR `{1: gzip(protobuf), 2: origin}`.
+* The registry's generic `tron-sign-request` (5101) is NOT accepted by the
+* device and gets no response; do not emit it.
+*/
+var TronChain = class {
+	constructor(config) {
+		this.context = resolveContext(config);
+	}
+	/** Build a `keystone-sign-request` (6101). Reply: `keystone-sign-result` (6102). */
+	generateSignRequest(props) {
+		const requestId = resolveRequestId(this.context, props.requestId);
+		parsePath(props.path);
+		const xfp = normalizeXfp(props.xfp);
+		if (props.rawData.length === 0) throw new EraSdkError("invalid-props", "rawData must not be empty");
+		if (!/^[0-9a-fA-F]{64}$/.test(props.latestBlock.hash)) throw new EraSdkError("invalid-props", "latestBlock.hash must be the FULL 64-hex block id (the device slices ref_block_hash from it)");
+		const proto = encodeSignRequestProto({
+			xfpHex: xfpToHex(xfp),
+			signId: uuidStringify(requestId),
+			hdPath: props.path,
+			timestamp: props.timestamp ?? 0,
+			decimals: props.display?.decimals ?? 6,
+			token: props.display?.token ?? "",
+			contractAddress: props.display?.contractAddress,
+			from: props.display?.from,
+			to: props.display?.to,
+			memo: props.display?.memo,
+			value: props.display?.value,
+			fee: props.display?.fee,
+			latestBlock: props.latestBlock,
+			rawData: props.rawData
+		});
+		const ur = new Ur("keystone-sign-request", cborEncode(cbMap([[1, cbBytes(gzipCompress(proto))], [2, cbText(props.origin ?? this.context.origin)]])));
+		return makeSignRequest({
+			ur,
+			requestId,
+			replyTypes: REPLY_TYPES,
+			context: this.context,
+			parse: (reply) => parseTronSignature(reply, requestId)
+		});
+	}
+	/**
+	* Parse a `keystone-sign-result` standalone. Tron carries the request id
+	* INSIDE the protobuf (`signId`); passing `expect.requestId` is what makes
+	* the echo check possible here — prefer `SignRequest.scanner().parse()`.
+	*/
+	parseSignature(input, expect) {
+		return parseTronSignature(toUr(input), expect?.requestId === void 0 ? void 0 : normalizeRequestId(expect.requestId));
+	}
+};
+function parseTronSignature(ur, expectedRequestId) {
+	requireUrType(ur, [...REPLY_TYPES], "keystone-sign-result");
+	const map = requireReplyMap(ur, "keystone-sign-result");
+	const compressed = asBytes(mapGet(map, 1));
+	if (!compressed) throw new EraSdkError("malformed-reply", "keystone-sign-result is missing the payload (key 1)");
+	if (compressed.length > MAX_COMPRESSED_BYTES) throw new EraSdkError("limit-exceeded", `keystone-sign-result payload is ${compressed.length} bytes, over the ${MAX_COMPRESSED_BYTES} byte ceiling`);
+	const result = decodeSignResultProto(gunzipCapped(compressed, MAX_INFLATED_BYTES));
+	if (expectedRequestId !== void 0) {
+		const expected = uuidStringify(expectedRequestId).toLowerCase();
+		if (result.signId.toLowerCase() !== expected) throw new EraSdkError("request-id-mismatch", result.signId === "" ? "keystone-sign-result does not echo the request id (signId)" : "keystone-sign-result echoes a different request id — it answers another sign request, not this one");
+	}
+	if (result.rawTx === "") throw new EraSdkError("malformed-reply", "keystone-sign-result has no signed transaction");
+	const signedTx = splitSignedTronTx(result.rawTx);
+	return {
+		requestId: expectedRequestId ?? signIdToBytes(result.signId),
+		txId: result.txId,
+		rawTx: result.rawTx,
+		signedTx
+	};
+}
+function signIdToBytes(signId) {
+	try {
+		return normalizeRequestId(signId);
+	} catch {
+		return /* @__PURE__ */ new Uint8Array(16);
+	}
+}
+//#endregion
+export { TronChain as t };
+
+//# sourceMappingURL=tron-Bo9HnvVE.js.map

package/dist/tron-Bo9HnvVE.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tron-Bo9HnvVE.js","names":["UrValue"],"sources":["../src/tron-proto/gzip.ts","../src/chains/tron.ts"],"sourcesContent":["import { Gunzip, gzipSync } from 'fflate';\nimport { concatBytes } from '../core/bytes';\nimport { EraSdkError } from '../core/errors';\nimport { crc32 } from '../ur/crc32';\n\n/** Smallest possible gzip stream: 10-byte header + 8-byte trailer. */\nconst MIN_GZIP_BYTES = 18;\n\n/** Bytes fed to the inflater per step; bounds the overshoot past the cap. */\nconst SLICE_BYTES = 1024;\n\n/** Deterministic gzip (fixed level, zeroed mtime) for reproducible request bytes. */\nexport function gzipCompress(data: Uint8Array): Uint8Array {\n  return gzipSync(data, { level: 9, mtime: 0 });\n}\n\n/**\n * Inflate with a hard output ceiling.\n *\n * A one-shot gunzip allocates the entire output before anyone can refuse it —\n * gzip reaches ~1000:1 in practice, so a few hundred scanned bytes could ask\n * for an arbitrary allocation. The decoder is therefore driven in slices and\n * the output counted as it arrives; the moment the total would pass the cap,\n * feeding stops and the reply is refused.\n *\n * The trailer's ISIZE (declared inflated length) is used twice: as a cheap\n * refusal of honest bombs before any work, and as a truncation check at the\n * end — an inflater hands back a partial buffer for a truncated stream\n * without erroring, and a genuine device reply always declares honestly.\n */\nexport function gunzipCapped(data: Uint8Array, maxOutputBytes: number): Uint8Array {\n  if (data.length < MIN_GZIP_BYTES) {\n    throw new EraSdkError('gzip-error', 'compressed payload is too short to be a gzip stream');\n  }\n  if (data[0] !== 0x1f || data[1] !== 0x8b) {\n    throw new EraSdkError('gzip-error', 'compressed payload is not a gzip stream');\n  }\n  const n = data.length;\n  const isize =\n    (data[n - 4]! | (data[n - 3]! << 8) | (data[n - 2]! << 16) | (data[n - 1]! << 24)) >>> 0;\n  if (isize > maxOutputBytes) {\n    throw new EraSdkError(\n      'gzip-error',\n      `compressed payload declares ${isize} bytes, over the ${maxOutputBytes} byte ceiling`,\n    );\n  }\n\n  const chunks: Uint8Array[] = [];\n  let total = 0;\n  let overflowed = false;\n  let malformed: string | null = null;\n\n  const gunzip = new Gunzip((chunk) => {\n    if (overflowed) return;\n    if (total + chunk.length > maxOutputBytes) {\n      overflowed = true;\n      return;\n    }\n    chunks.push(chunk);\n    total += chunk.length;\n  });\n\n  try {\n    for (let offset = 0; offset < n && !overflowed; offset += SLICE_BYTES) {\n      const end = Math.min(offset + SLICE_BYTES, n);\n      const isLast = end === n;\n      gunzip.push(data.slice(offset, end), isLast);\n    }\n  } catch (e) {\n    malformed = (e as Error).message ?? 'inflate error';\n  }\n\n  if (overflowed) {\n    throw new EraSdkError(\n      'gzip-error',\n      `compressed payload inflates past the ${maxOutputBytes} byte ceiling`,\n    );\n  }\n  if (malformed !== null) {\n    throw new EraSdkError('gzip-error', `compressed payload is malformed: ${malformed}`);\n  }\n  const out = concatBytes(...chunks);\n  if (out.length !== isize) {\n    throw new EraSdkError(\n      'gzip-error',\n      `compressed payload inflated to ${out.length} bytes but declares ${isize} — truncated or malformed`,\n    );\n  }\n  // The trailer CRC32 (little-endian, bytes n-8..n-5) must cover the inflated\n  // output. The streaming inflater does not verify it, and the reference\n  // implementation's native decoder does — without this check a corrupted\n  // stream, or a CONCATENATED multi-member stream (whose final member's CRC\n  // cannot cover the whole output), would be accepted here and refused there.\n  const declaredCrc =\n    (data[n - 8]! | (data[n - 7]! << 8) | (data[n - 6]! << 16) | (data[n - 5]! << 24)) >>> 0;\n  if (crc32(out) !== declaredCrc) {\n    throw new EraSdkError('gzip-error', 'compressed payload is malformed: CRC mismatch');\n  }\n  return out;\n}\n","import { cborEncode } from '../cbor/encode';\nimport { asBytes, cbBytes, cbMap, cbText, mapGet } from '../cbor/model';\nimport { EraSdkError } from '../core/errors';\nimport { normalizeRequestId, uuidStringify } from '../core/rand';\nimport { normalizeXfp, parsePath, xfpToHex } from '../registry/keypath';\nimport { gunzipCapped, gzipCompress } from '../tron-proto/gzip';\nimport type { SignedTronTx, TronLatestBlock } from '../tron-proto/messages';\nimport {\n  decodeSignResultProto,\n  encodeSignRequestProto,\n  splitSignedTronTx,\n} from '../tron-proto/messages';\nimport type { Ur } from '../ur/ur';\nimport { Ur as UrValue } from '../ur/ur';\nimport type { ChainContext, EraConnectConfig, ExpectedReply, SignRequest } from './shared';\nimport {\n  makeSignRequest,\n  requireReplyMap,\n  requireUrType,\n  resolveContext,\n  resolveRequestId,\n  toUr,\n} from './shared';\n\nexport type { TronLatestBlock } from '../tron-proto/messages';\n\nexport interface TronSignRequestProps {\n  readonly requestId?: Uint8Array | string;\n  /**\n   * Serialized `Transaction.raw_data` — THE signing source of truth. The\n   * device signs `sha256(rawData) = txID` and returns the transaction with\n   * `raw_data` unmodified.\n   */\n  readonly rawData: Uint8Array;\n  /** Full signing path, e.g. `m/44'/195'/0'/0/0`. */\n  readonly path: string;\n  readonly xfp: string | number;\n  /**\n   * Reference block context. Source it from a LIVE now-block query and pass\n   * the FULL 64-hex block id.\n   */\n  readonly latestBlock: TronLatestBlock;\n  /** On-device display only; safe to omit for opaque dApp transactions. */\n  readonly display?: {\n    readonly token?: string;\n    readonly contractAddress?: string;\n    readonly from?: string;\n    readonly to?: string;\n    readonly value?: string;\n    readonly memo?: string;\n    readonly fee?: number;\n    readonly decimals?: number;\n  };\n  readonly timestamp?: number;\n  readonly origin?: string;\n}\n\nexport interface TronSignatureResult {\n  readonly requestId: Uint8Array;\n  /** `sha256(raw_data)` hex, as computed by the device. */\n  readonly txId: string;\n  /** Hex of the fully assembled signed transaction — broadcast as-is. */\n  readonly rawTx: string;\n  /** The signed frame split into `raw_data` + signatures (65-byte r||s||recovery each). */\n  readonly signedTx: SignedTronTx;\n}\n\n/**\n * Ceilings on the gzip blob a `keystone-sign-result` may carry. Tron is the\n * only chain whose reply is compressed, so it is the only one where a few\n * hundred scanned bytes can ask for an arbitrary allocation. Generous\n * multiples of the largest real device reply.\n */\nconst MAX_COMPRESSED_BYTES = 8 * 1024;\nconst MAX_INFLATED_BYTES = 64 * 1024;\n\nconst REPLY_TYPES = ['keystone-sign-result'] as const;\n\n/**\n * Tron signing rides the structured `keystone-sign-request` (6101) envelope —\n * a gzip-compressed protobuf inside CBOR `{1: gzip(protobuf), 2: origin}`.\n * The registry's generic `tron-sign-request` (5101) is NOT accepted by the\n * device and gets no response; do not emit it.\n */\nexport class TronChain {\n  private readonly context: ChainContext;\n\n  constructor(config?: EraConnectConfig) {\n    this.context = resolveContext(config);\n  }\n\n  /** Build a `keystone-sign-request` (6101). Reply: `keystone-sign-result` (6102). */\n  generateSignRequest(props: TronSignRequestProps): SignRequest<TronSignatureResult> {\n    const requestId = resolveRequestId(this.context, props.requestId);\n    parsePath(props.path); // validate shape; the wire carries the string form\n    const xfp = normalizeXfp(props.xfp);\n    if (props.rawData.length === 0) {\n      throw new EraSdkError('invalid-props', 'rawData must not be empty');\n    }\n    if (!/^[0-9a-fA-F]{64}$/.test(props.latestBlock.hash)) {\n      throw new EraSdkError(\n        'invalid-props',\n        'latestBlock.hash must be the FULL 64-hex block id (the device slices ref_block_hash from it)',\n      );\n    }\n\n    const proto = encodeSignRequestProto({\n      // Zero-padded to eight characters: the firmware parses this string with\n      // a hex reader that yields 0 for anything shorter than 4 bytes, and a\n      // zero fingerprint fails validation — a wallet whose fingerprint starts\n      // with a zero byte (1 in 256) could not sign at all without the pad.\n      xfpHex: xfpToHex(xfp),\n      signId: uuidStringify(requestId),\n      hdPath: props.path,\n      timestamp: props.timestamp ?? 0,\n      decimals: props.display?.decimals ?? 6,\n      token: props.display?.token ?? '',\n      contractAddress: props.display?.contractAddress,\n      from: props.display?.from,\n      to: props.display?.to,\n      memo: props.display?.memo,\n      value: props.display?.value,\n      fee: props.display?.fee,\n      latestBlock: props.latestBlock,\n      rawData: props.rawData,\n    });\n\n    const ur = new UrValue(\n      'keystone-sign-request',\n      cborEncode(\n        cbMap([\n          [1, cbBytes(gzipCompress(proto))],\n          [2, cbText(props.origin ?? this.context.origin)],\n        ]),\n      ),\n    );\n    return makeSignRequest({\n      ur,\n      requestId,\n      replyTypes: REPLY_TYPES,\n      context: this.context,\n      parse: (reply) => parseTronSignature(reply, requestId),\n    });\n  }\n\n  /**\n   * Parse a `keystone-sign-result` standalone. Tron carries the request id\n   * INSIDE the protobuf (`signId`); passing `expect.requestId` is what makes\n   * the echo check possible here — prefer `SignRequest.scanner().parse()`.\n   */\n  parseSignature(input: Ur | string, expect?: ExpectedReply): TronSignatureResult {\n    return parseTronSignature(\n      toUr(input),\n      expect?.requestId === undefined ? undefined : normalizeRequestId(expect.requestId),\n    );\n  }\n}\n\nfunction parseTronSignature(\n  ur: Ur,\n  expectedRequestId: Uint8Array | undefined,\n): TronSignatureResult {\n  requireUrType(ur, [...REPLY_TYPES], 'keystone-sign-result');\n  const map = requireReplyMap(ur, 'keystone-sign-result');\n  const compressed = asBytes(mapGet(map, 1));\n  if (!compressed) {\n    throw new EraSdkError('malformed-reply', 'keystone-sign-result is missing the payload (key 1)');\n  }\n  if (compressed.length > MAX_COMPRESSED_BYTES) {\n    throw new EraSdkError(\n      'limit-exceeded',\n      `keystone-sign-result payload is ${compressed.length} bytes, over the ${MAX_COMPRESSED_BYTES} byte ceiling`,\n    );\n  }\n  const result = decodeSignResultProto(gunzipCapped(compressed, MAX_INFLATED_BYTES));\n\n  // The signId echo is the ONLY anti-replay binding on this chain — the\n  // device's own bytes are broadcast verbatim, so a stale reply that skipped\n  // this check would finalize a payment the user did not approve now.\n  if (expectedRequestId !== undefined) {\n    const expected = uuidStringify(expectedRequestId).toLowerCase();\n    if (result.signId.toLowerCase() !== expected) {\n      throw new EraSdkError(\n        'request-id-mismatch',\n        result.signId === ''\n          ? 'keystone-sign-result does not echo the request id (signId)'\n          : 'keystone-sign-result echoes a different request id — it answers another sign request, not this one',\n      );\n    }\n  }\n  if (result.rawTx === '') {\n    throw new EraSdkError('malformed-reply', 'keystone-sign-result has no signed transaction');\n  }\n  const signedTx = splitSignedTronTx(result.rawTx);\n  const requestId = expectedRequestId ?? signIdToBytes(result.signId);\n  return { requestId, txId: result.txId, rawTx: result.rawTx, signedTx };\n}\n\nfunction signIdToBytes(signId: string): Uint8Array {\n  try {\n    return normalizeRequestId(signId);\n  } catch {\n    return new Uint8Array(16);\n  }\n}\n"],"mappings":"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"}

package/dist/tron-CQIEqjCA.cjs

@@ -0,0 +1,163 @@
+const require_shared = require("./shared-nISrEktU.cjs");
+const require_messages = require("./messages-BzcdWlg1.cjs");
+let fflate = require("fflate");
+//#region src/tron-proto/gzip.ts
+/** Smallest possible gzip stream: 10-byte header + 8-byte trailer. */
+const MIN_GZIP_BYTES = 18;
+/** Bytes fed to the inflater per step; bounds the overshoot past the cap. */
+const SLICE_BYTES = 1024;
+/** Deterministic gzip (fixed level, zeroed mtime) for reproducible request bytes. */
+function gzipCompress(data) {
+	return (0, fflate.gzipSync)(data, {
+		level: 9,
+		mtime: 0
+	});
+}
+/**
+* Inflate with a hard output ceiling.
+*
+* A one-shot gunzip allocates the entire output before anyone can refuse it —
+* gzip reaches ~1000:1 in practice, so a few hundred scanned bytes could ask
+* for an arbitrary allocation. The decoder is therefore driven in slices and
+* the output counted as it arrives; the moment the total would pass the cap,
+* feeding stops and the reply is refused.
+*
+* The trailer's ISIZE (declared inflated length) is used twice: as a cheap
+* refusal of honest bombs before any work, and as a truncation check at the
+* end — an inflater hands back a partial buffer for a truncated stream
+* without erroring, and a genuine device reply always declares honestly.
+*/
+function gunzipCapped(data, maxOutputBytes) {
+	if (data.length < MIN_GZIP_BYTES) throw new require_shared.EraSdkError("gzip-error", "compressed payload is too short to be a gzip stream");
+	if (data[0] !== 31 || data[1] !== 139) throw new require_shared.EraSdkError("gzip-error", "compressed payload is not a gzip stream");
+	const n = data.length;
+	const isize = (data[n - 4] | data[n - 3] << 8 | data[n - 2] << 16 | data[n - 1] << 24) >>> 0;
+	if (isize > maxOutputBytes) throw new require_shared.EraSdkError("gzip-error", `compressed payload declares ${isize} bytes, over the ${maxOutputBytes} byte ceiling`);
+	const chunks = [];
+	let total = 0;
+	let overflowed = false;
+	let malformed = null;
+	const gunzip = new fflate.Gunzip((chunk) => {
+		if (overflowed) return;
+		if (total + chunk.length > maxOutputBytes) {
+			overflowed = true;
+			return;
+		}
+		chunks.push(chunk);
+		total += chunk.length;
+	});
+	try {
+		for (let offset = 0; offset < n && !overflowed; offset += SLICE_BYTES) {
+			const end = Math.min(offset + SLICE_BYTES, n);
+			const isLast = end === n;
+			gunzip.push(data.slice(offset, end), isLast);
+		}
+	} catch (e) {
+		malformed = e.message ?? "inflate error";
+	}
+	if (overflowed) throw new require_shared.EraSdkError("gzip-error", `compressed payload inflates past the ${maxOutputBytes} byte ceiling`);
+	if (malformed !== null) throw new require_shared.EraSdkError("gzip-error", `compressed payload is malformed: ${malformed}`);
+	const out = require_shared.concatBytes(...chunks);
+	if (out.length !== isize) throw new require_shared.EraSdkError("gzip-error", `compressed payload inflated to ${out.length} bytes but declares ${isize} — truncated or malformed`);
+	const declaredCrc = (data[n - 8] | data[n - 7] << 8 | data[n - 6] << 16 | data[n - 5] << 24) >>> 0;
+	if (require_shared.crc32(out) !== declaredCrc) throw new require_shared.EraSdkError("gzip-error", "compressed payload is malformed: CRC mismatch");
+	return out;
+}
+//#endregion
+//#region src/chains/tron.ts
+/**
+* Ceilings on the gzip blob a `keystone-sign-result` may carry. Tron is the
+* only chain whose reply is compressed, so it is the only one where a few
+* hundred scanned bytes can ask for an arbitrary allocation. Generous
+* multiples of the largest real device reply.
+*/
+const MAX_COMPRESSED_BYTES = 8192;
+const MAX_INFLATED_BYTES = 65536;
+const REPLY_TYPES = ["keystone-sign-result"];
+/**
+* Tron signing rides the structured `keystone-sign-request` (6101) envelope —
+* a gzip-compressed protobuf inside CBOR `{1: gzip(protobuf), 2: origin}`.
+* The registry's generic `tron-sign-request` (5101) is NOT accepted by the
+* device and gets no response; do not emit it.
+*/
+var TronChain = class {
+	constructor(config) {
+		this.context = require_shared.resolveContext(config);
+	}
+	/** Build a `keystone-sign-request` (6101). Reply: `keystone-sign-result` (6102). */
+	generateSignRequest(props) {
+		const requestId = require_shared.resolveRequestId(this.context, props.requestId);
+		require_shared.parsePath(props.path);
+		const xfp = require_shared.normalizeXfp(props.xfp);
+		if (props.rawData.length === 0) throw new require_shared.EraSdkError("invalid-props", "rawData must not be empty");
+		if (!/^[0-9a-fA-F]{64}$/.test(props.latestBlock.hash)) throw new require_shared.EraSdkError("invalid-props", "latestBlock.hash must be the FULL 64-hex block id (the device slices ref_block_hash from it)");
+		const proto = require_messages.encodeSignRequestProto({
+			xfpHex: require_shared.xfpToHex(xfp),
+			signId: require_shared.uuidStringify(requestId),
+			hdPath: props.path,
+			timestamp: props.timestamp ?? 0,
+			decimals: props.display?.decimals ?? 6,
+			token: props.display?.token ?? "",
+			contractAddress: props.display?.contractAddress,
+			from: props.display?.from,
+			to: props.display?.to,
+			memo: props.display?.memo,
+			value: props.display?.value,
+			fee: props.display?.fee,
+			latestBlock: props.latestBlock,
+			rawData: props.rawData
+		});
+		const ur = new require_shared.Ur("keystone-sign-request", require_shared.cborEncode(require_shared.cbMap([[1, require_shared.cbBytes(gzipCompress(proto))], [2, require_shared.cbText(props.origin ?? this.context.origin)]])));
+		return require_shared.makeSignRequest({
+			ur,
+			requestId,
+			replyTypes: REPLY_TYPES,
+			context: this.context,
+			parse: (reply) => parseTronSignature(reply, requestId)
+		});
+	}
+	/**
+	* Parse a `keystone-sign-result` standalone. Tron carries the request id
+	* INSIDE the protobuf (`signId`); passing `expect.requestId` is what makes
+	* the echo check possible here — prefer `SignRequest.scanner().parse()`.
+	*/
+	parseSignature(input, expect) {
+		return parseTronSignature(require_shared.toUr(input), expect?.requestId === void 0 ? void 0 : require_shared.normalizeRequestId(expect.requestId));
+	}
+};
+function parseTronSignature(ur, expectedRequestId) {
+	require_shared.requireUrType(ur, [...REPLY_TYPES], "keystone-sign-result");
+	const map = require_shared.requireReplyMap(ur, "keystone-sign-result");
+	const compressed = require_shared.asBytes(require_shared.mapGet(map, 1));
+	if (!compressed) throw new require_shared.EraSdkError("malformed-reply", "keystone-sign-result is missing the payload (key 1)");
+	if (compressed.length > MAX_COMPRESSED_BYTES) throw new require_shared.EraSdkError("limit-exceeded", `keystone-sign-result payload is ${compressed.length} bytes, over the ${MAX_COMPRESSED_BYTES} byte ceiling`);
+	const result = require_messages.decodeSignResultProto(gunzipCapped(compressed, MAX_INFLATED_BYTES));
+	if (expectedRequestId !== void 0) {
+		const expected = require_shared.uuidStringify(expectedRequestId).toLowerCase();
+		if (result.signId.toLowerCase() !== expected) throw new require_shared.EraSdkError("request-id-mismatch", result.signId === "" ? "keystone-sign-result does not echo the request id (signId)" : "keystone-sign-result echoes a different request id — it answers another sign request, not this one");
+	}
+	if (result.rawTx === "") throw new require_shared.EraSdkError("malformed-reply", "keystone-sign-result has no signed transaction");
+	const signedTx = require_messages.splitSignedTronTx(result.rawTx);
+	return {
+		requestId: expectedRequestId ?? signIdToBytes(result.signId),
+		txId: result.txId,
+		rawTx: result.rawTx,
+		signedTx
+	};
+}
+function signIdToBytes(signId) {
+	try {
+		return require_shared.normalizeRequestId(signId);
+	} catch {
+		return /* @__PURE__ */ new Uint8Array(16);
+	}
+}
+//#endregion
+Object.defineProperty(exports, "TronChain", {
+	enumerable: true,
+	get: function() {
+		return TronChain;
+	}
+});
+
+//# sourceMappingURL=tron-CQIEqjCA.cjs.map

package/dist/tron-CQIEqjCA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tron-CQIEqjCA.cjs","names":["gzipSync","EraSdkError","Gunzip","concatBytes","crc32","resolveContext","resolveRequestId","normalizeXfp","EraSdkError","encodeSignRequestProto","xfpToHex","uuidStringify","UrValue","cborEncode","cbMap","cbBytes","cbText","makeSignRequest","toUr","normalizeRequestId","requireReplyMap","asBytes","mapGet","decodeSignResultProto","splitSignedTronTx"],"sources":["../src/tron-proto/gzip.ts","../src/chains/tron.ts"],"sourcesContent":["import { Gunzip, gzipSync } from 'fflate';\nimport { concatBytes } from '../core/bytes';\nimport { EraSdkError } from '../core/errors';\nimport { crc32 } from '../ur/crc32';\n\n/** Smallest possible gzip stream: 10-byte header + 8-byte trailer. */\nconst MIN_GZIP_BYTES = 18;\n\n/** Bytes fed to the inflater per step; bounds the overshoot past the cap. */\nconst SLICE_BYTES = 1024;\n\n/** Deterministic gzip (fixed level, zeroed mtime) for reproducible request bytes. */\nexport function gzipCompress(data: Uint8Array): Uint8Array {\n  return gzipSync(data, { level: 9, mtime: 0 });\n}\n\n/**\n * Inflate with a hard output ceiling.\n *\n * A one-shot gunzip allocates the entire output before anyone can refuse it —\n * gzip reaches ~1000:1 in practice, so a few hundred scanned bytes could ask\n * for an arbitrary allocation. The decoder is therefore driven in slices and\n * the output counted as it arrives; the moment the total would pass the cap,\n * feeding stops and the reply is refused.\n *\n * The trailer's ISIZE (declared inflated length) is used twice: as a cheap\n * refusal of honest bombs before any work, and as a truncation check at the\n * end — an inflater hands back a partial buffer for a truncated stream\n * without erroring, and a genuine device reply always declares honestly.\n */\nexport function gunzipCapped(data: Uint8Array, maxOutputBytes: number): Uint8Array {\n  if (data.length < MIN_GZIP_BYTES) {\n    throw new EraSdkError('gzip-error', 'compressed payload is too short to be a gzip stream');\n  }\n  if (data[0] !== 0x1f || data[1] !== 0x8b) {\n    throw new EraSdkError('gzip-error', 'compressed payload is not a gzip stream');\n  }\n  const n = data.length;\n  const isize =\n    (data[n - 4]! | (data[n - 3]! << 8) | (data[n - 2]! << 16) | (data[n - 1]! << 24)) >>> 0;\n  if (isize > maxOutputBytes) {\n    throw new EraSdkError(\n      'gzip-error',\n      `compressed payload declares ${isize} bytes, over the ${maxOutputBytes} byte ceiling`,\n    );\n  }\n\n  const chunks: Uint8Array[] = [];\n  let total = 0;\n  let overflowed = false;\n  let malformed: string | null = null;\n\n  const gunzip = new Gunzip((chunk) => {\n    if (overflowed) return;\n    if (total + chunk.length > maxOutputBytes) {\n      overflowed = true;\n      return;\n    }\n    chunks.push(chunk);\n    total += chunk.length;\n  });\n\n  try {\n    for (let offset = 0; offset < n && !overflowed; offset += SLICE_BYTES) {\n      const end = Math.min(offset + SLICE_BYTES, n);\n      const isLast = end === n;\n      gunzip.push(data.slice(offset, end), isLast);\n    }\n  } catch (e) {\n    malformed = (e as Error).message ?? 'inflate error';\n  }\n\n  if (overflowed) {\n    throw new EraSdkError(\n      'gzip-error',\n      `compressed payload inflates past the ${maxOutputBytes} byte ceiling`,\n    );\n  }\n  if (malformed !== null) {\n    throw new EraSdkError('gzip-error', `compressed payload is malformed: ${malformed}`);\n  }\n  const out = concatBytes(...chunks);\n  if (out.length !== isize) {\n    throw new EraSdkError(\n      'gzip-error',\n      `compressed payload inflated to ${out.length} bytes but declares ${isize} — truncated or malformed`,\n    );\n  }\n  // The trailer CRC32 (little-endian, bytes n-8..n-5) must cover the inflated\n  // output. The streaming inflater does not verify it, and the reference\n  // implementation's native decoder does — without this check a corrupted\n  // stream, or a CONCATENATED multi-member stream (whose final member's CRC\n  // cannot cover the whole output), would be accepted here and refused there.\n  const declaredCrc =\n    (data[n - 8]! | (data[n - 7]! << 8) | (data[n - 6]! << 16) | (data[n - 5]! << 24)) >>> 0;\n  if (crc32(out) !== declaredCrc) {\n    throw new EraSdkError('gzip-error', 'compressed payload is malformed: CRC mismatch');\n  }\n  return out;\n}\n","import { cborEncode } from '../cbor/encode';\nimport { asBytes, cbBytes, cbMap, cbText, mapGet } from '../cbor/model';\nimport { EraSdkError } from '../core/errors';\nimport { normalizeRequestId, uuidStringify } from '../core/rand';\nimport { normalizeXfp, parsePath, xfpToHex } from '../registry/keypath';\nimport { gunzipCapped, gzipCompress } from '../tron-proto/gzip';\nimport type { SignedTronTx, TronLatestBlock } from '../tron-proto/messages';\nimport {\n  decodeSignResultProto,\n  encodeSignRequestProto,\n  splitSignedTronTx,\n} from '../tron-proto/messages';\nimport type { Ur } from '../ur/ur';\nimport { Ur as UrValue } from '../ur/ur';\nimport type { ChainContext, EraConnectConfig, ExpectedReply, SignRequest } from './shared';\nimport {\n  makeSignRequest,\n  requireReplyMap,\n  requireUrType,\n  resolveContext,\n  resolveRequestId,\n  toUr,\n} from './shared';\n\nexport type { TronLatestBlock } from '../tron-proto/messages';\n\nexport interface TronSignRequestProps {\n  readonly requestId?: Uint8Array | string;\n  /**\n   * Serialized `Transaction.raw_data` — THE signing source of truth. The\n   * device signs `sha256(rawData) = txID` and returns the transaction with\n   * `raw_data` unmodified.\n   */\n  readonly rawData: Uint8Array;\n  /** Full signing path, e.g. `m/44'/195'/0'/0/0`. */\n  readonly path: string;\n  readonly xfp: string | number;\n  /**\n   * Reference block context. Source it from a LIVE now-block query and pass\n   * the FULL 64-hex block id.\n   */\n  readonly latestBlock: TronLatestBlock;\n  /** On-device display only; safe to omit for opaque dApp transactions. */\n  readonly display?: {\n    readonly token?: string;\n    readonly contractAddress?: string;\n    readonly from?: string;\n    readonly to?: string;\n    readonly value?: string;\n    readonly memo?: string;\n    readonly fee?: number;\n    readonly decimals?: number;\n  };\n  readonly timestamp?: number;\n  readonly origin?: string;\n}\n\nexport interface TronSignatureResult {\n  readonly requestId: Uint8Array;\n  /** `sha256(raw_data)` hex, as computed by the device. */\n  readonly txId: string;\n  /** Hex of the fully assembled signed transaction — broadcast as-is. */\n  readonly rawTx: string;\n  /** The signed frame split into `raw_data` + signatures (65-byte r||s||recovery each). */\n  readonly signedTx: SignedTronTx;\n}\n\n/**\n * Ceilings on the gzip blob a `keystone-sign-result` may carry. Tron is the\n * only chain whose reply is compressed, so it is the only one where a few\n * hundred scanned bytes can ask for an arbitrary allocation. Generous\n * multiples of the largest real device reply.\n */\nconst MAX_COMPRESSED_BYTES = 8 * 1024;\nconst MAX_INFLATED_BYTES = 64 * 1024;\n\nconst REPLY_TYPES = ['keystone-sign-result'] as const;\n\n/**\n * Tron signing rides the structured `keystone-sign-request` (6101) envelope —\n * a gzip-compressed protobuf inside CBOR `{1: gzip(protobuf), 2: origin}`.\n * The registry's generic `tron-sign-request` (5101) is NOT accepted by the\n * device and gets no response; do not emit it.\n */\nexport class TronChain {\n  private readonly context: ChainContext;\n\n  constructor(config?: EraConnectConfig) {\n    this.context = resolveContext(config);\n  }\n\n  /** Build a `keystone-sign-request` (6101). Reply: `keystone-sign-result` (6102). */\n  generateSignRequest(props: TronSignRequestProps): SignRequest<TronSignatureResult> {\n    const requestId = resolveRequestId(this.context, props.requestId);\n    parsePath(props.path); // validate shape; the wire carries the string form\n    const xfp = normalizeXfp(props.xfp);\n    if (props.rawData.length === 0) {\n      throw new EraSdkError('invalid-props', 'rawData must not be empty');\n    }\n    if (!/^[0-9a-fA-F]{64}$/.test(props.latestBlock.hash)) {\n      throw new EraSdkError(\n        'invalid-props',\n        'latestBlock.hash must be the FULL 64-hex block id (the device slices ref_block_hash from it)',\n      );\n    }\n\n    const proto = encodeSignRequestProto({\n      // Zero-padded to eight characters: the firmware parses this string with\n      // a hex reader that yields 0 for anything shorter than 4 bytes, and a\n      // zero fingerprint fails validation — a wallet whose fingerprint starts\n      // with a zero byte (1 in 256) could not sign at all without the pad.\n      xfpHex: xfpToHex(xfp),\n      signId: uuidStringify(requestId),\n      hdPath: props.path,\n      timestamp: props.timestamp ?? 0,\n      decimals: props.display?.decimals ?? 6,\n      token: props.display?.token ?? '',\n      contractAddress: props.display?.contractAddress,\n      from: props.display?.from,\n      to: props.display?.to,\n      memo: props.display?.memo,\n      value: props.display?.value,\n      fee: props.display?.fee,\n      latestBlock: props.latestBlock,\n      rawData: props.rawData,\n    });\n\n    const ur = new UrValue(\n      'keystone-sign-request',\n      cborEncode(\n        cbMap([\n          [1, cbBytes(gzipCompress(proto))],\n          [2, cbText(props.origin ?? this.context.origin)],\n        ]),\n      ),\n    );\n    return makeSignRequest({\n      ur,\n      requestId,\n      replyTypes: REPLY_TYPES,\n      context: this.context,\n      parse: (reply) => parseTronSignature(reply, requestId),\n    });\n  }\n\n  /**\n   * Parse a `keystone-sign-result` standalone. Tron carries the request id\n   * INSIDE the protobuf (`signId`); passing `expect.requestId` is what makes\n   * the echo check possible here — prefer `SignRequest.scanner().parse()`.\n   */\n  parseSignature(input: Ur | string, expect?: ExpectedReply): TronSignatureResult {\n    return parseTronSignature(\n      toUr(input),\n      expect?.requestId === undefined ? undefined : normalizeRequestId(expect.requestId),\n    );\n  }\n}\n\nfunction parseTronSignature(\n  ur: Ur,\n  expectedRequestId: Uint8Array | undefined,\n): TronSignatureResult {\n  requireUrType(ur, [...REPLY_TYPES], 'keystone-sign-result');\n  const map = requireReplyMap(ur, 'keystone-sign-result');\n  const compressed = asBytes(mapGet(map, 1));\n  if (!compressed) {\n    throw new EraSdkError('malformed-reply', 'keystone-sign-result is missing the payload (key 1)');\n  }\n  if (compressed.length > MAX_COMPRESSED_BYTES) {\n    throw new EraSdkError(\n      'limit-exceeded',\n      `keystone-sign-result payload is ${compressed.length} bytes, over the ${MAX_COMPRESSED_BYTES} byte ceiling`,\n    );\n  }\n  const result = decodeSignResultProto(gunzipCapped(compressed, MAX_INFLATED_BYTES));\n\n  // The signId echo is the ONLY anti-replay binding on this chain — the\n  // device's own bytes are broadcast verbatim, so a stale reply that skipped\n  // this check would finalize a payment the user did not approve now.\n  if (expectedRequestId !== undefined) {\n    const expected = uuidStringify(expectedRequestId).toLowerCase();\n    if (result.signId.toLowerCase() !== expected) {\n      throw new EraSdkError(\n        'request-id-mismatch',\n        result.signId === ''\n          ? 'keystone-sign-result does not echo the request id (signId)'\n          : 'keystone-sign-result echoes a different request id — it answers another sign request, not this one',\n      );\n    }\n  }\n  if (result.rawTx === '') {\n    throw new EraSdkError('malformed-reply', 'keystone-sign-result has no signed transaction');\n  }\n  const signedTx = splitSignedTronTx(result.rawTx);\n  const requestId = expectedRequestId ?? signIdToBytes(result.signId);\n  return { requestId, txId: result.txId, rawTx: result.rawTx, signedTx };\n}\n\nfunction signIdToBytes(signId: string): Uint8Array {\n  try {\n    return normalizeRequestId(signId);\n  } catch {\n    return new Uint8Array(16);\n  }\n}\n"],"mappings":"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"}

package/dist/tron-YllfTmx6.d.ts

@@ -0,0 +1,63 @@
+import { _ as Ur, a as SignRequest, i as ExpectedReply, r as EraConnectConfig } from "./shared-CI8zhQiE.js";
+import { n as TronLatestBlock, t as SignedTronTx } from "./messages-DsPvW8Oi.js";
+//#region src/chains/tron.d.ts
+interface TronSignRequestProps {
+  readonly requestId?: Uint8Array | string;
+  /**
+   * Serialized `Transaction.raw_data` — THE signing source of truth. The
+   * device signs `sha256(rawData) = txID` and returns the transaction with
+   * `raw_data` unmodified.
+   */
+  readonly rawData: Uint8Array;
+  /** Full signing path, e.g. `m/44'/195'/0'/0/0`. */
+  readonly path: string;
+  readonly xfp: string | number;
+  /**
+   * Reference block context. Source it from a LIVE now-block query and pass
+   * the FULL 64-hex block id.
+   */
+  readonly latestBlock: TronLatestBlock;
+  /** On-device display only; safe to omit for opaque dApp transactions. */
+  readonly display?: {
+    readonly token?: string;
+    readonly contractAddress?: string;
+    readonly from?: string;
+    readonly to?: string;
+    readonly value?: string;
+    readonly memo?: string;
+    readonly fee?: number;
+    readonly decimals?: number;
+  };
+  readonly timestamp?: number;
+  readonly origin?: string;
+}
+interface TronSignatureResult {
+  readonly requestId: Uint8Array;
+  /** `sha256(raw_data)` hex, as computed by the device. */
+  readonly txId: string;
+  /** Hex of the fully assembled signed transaction — broadcast as-is. */
+  readonly rawTx: string;
+  /** The signed frame split into `raw_data` + signatures (65-byte r||s||recovery each). */
+  readonly signedTx: SignedTronTx;
+}
+/**
+ * Tron signing rides the structured `keystone-sign-request` (6101) envelope —
+ * a gzip-compressed protobuf inside CBOR `{1: gzip(protobuf), 2: origin}`.
+ * The registry's generic `tron-sign-request` (5101) is NOT accepted by the
+ * device and gets no response; do not emit it.
+ */
+declare class TronChain {
+  private readonly context;
+  constructor(config?: EraConnectConfig);
+  /** Build a `keystone-sign-request` (6101). Reply: `keystone-sign-result` (6102). */
+  generateSignRequest(props: TronSignRequestProps): SignRequest<TronSignatureResult>;
+  /**
+   * Parse a `keystone-sign-result` standalone. Tron carries the request id
+   * INSIDE the protobuf (`signId`); passing `expect.requestId` is what makes
+   * the echo check possible here — prefer `SignRequest.scanner().parse()`.
+   */
+  parseSignature(input: Ur | string, expect?: ExpectedReply): TronSignatureResult;
+}
+//#endregion
+export { TronSignRequestProps as n, TronSignatureResult as r, TronChain as t };
+//# sourceMappingURL=tron-YllfTmx6.d.ts.map

package/dist/tron-gG51KMnX.d.cts

@@ -0,0 +1,63 @@
+import { _ as Ur, a as SignRequest, i as ExpectedReply, r as EraConnectConfig } from "./shared-CI8zhQiE.cjs";
+import { n as TronLatestBlock, t as SignedTronTx } from "./messages-DsPvW8Oi.cjs";
+//#region src/chains/tron.d.ts
+interface TronSignRequestProps {
+  readonly requestId?: Uint8Array | string;
+  /**
+   * Serialized `Transaction.raw_data` — THE signing source of truth. The
+   * device signs `sha256(rawData) = txID` and returns the transaction with
+   * `raw_data` unmodified.
+   */
+  readonly rawData: Uint8Array;
+  /** Full signing path, e.g. `m/44'/195'/0'/0/0`. */
+  readonly path: string;
+  readonly xfp: string | number;
+  /**
+   * Reference block context. Source it from a LIVE now-block query and pass
+   * the FULL 64-hex block id.
+   */
+  readonly latestBlock: TronLatestBlock;
+  /** On-device display only; safe to omit for opaque dApp transactions. */
+  readonly display?: {
+    readonly token?: string;
+    readonly contractAddress?: string;
+    readonly from?: string;
+    readonly to?: string;
+    readonly value?: string;
+    readonly memo?: string;
+    readonly fee?: number;
+    readonly decimals?: number;
+  };
+  readonly timestamp?: number;
+  readonly origin?: string;
+}
+interface TronSignatureResult {
+  readonly requestId: Uint8Array;
+  /** `sha256(raw_data)` hex, as computed by the device. */
+  readonly txId: string;
+  /** Hex of the fully assembled signed transaction — broadcast as-is. */
+  readonly rawTx: string;
+  /** The signed frame split into `raw_data` + signatures (65-byte r||s||recovery each). */
+  readonly signedTx: SignedTronTx;
+}
+/**
+ * Tron signing rides the structured `keystone-sign-request` (6101) envelope —
+ * a gzip-compressed protobuf inside CBOR `{1: gzip(protobuf), 2: origin}`.
+ * The registry's generic `tron-sign-request` (5101) is NOT accepted by the
+ * device and gets no response; do not emit it.
+ */
+declare class TronChain {
+  private readonly context;
+  constructor(config?: EraConnectConfig);
+  /** Build a `keystone-sign-request` (6101). Reply: `keystone-sign-result` (6102). */
+  generateSignRequest(props: TronSignRequestProps): SignRequest<TronSignatureResult>;
+  /**
+   * Parse a `keystone-sign-result` standalone. Tron carries the request id
+   * INSIDE the protobuf (`signId`); passing `expect.requestId` is what makes
+   * the echo check possible here — prefer `SignRequest.scanner().parse()`.
+   */
+  parseSignature(input: Ur | string, expect?: ExpectedReply): TronSignatureResult;
+}
+//#endregion
+export { TronSignRequestProps as n, TronSignatureResult as r, TronChain as t };
+//# sourceMappingURL=tron-gG51KMnX.d.cts.map

package/dist/tron.cjs

@@ -0,0 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_shared = require("./shared-nISrEktU.cjs");
+const require_tron = require("./tron-CQIEqjCA.cjs");
+const require_messages = require("./messages-BzcdWlg1.cjs");
+exports.AnimatedUr = require_shared.AnimatedUr;
+exports.EraSdkError = require_shared.EraSdkError;
+exports.TronChain = require_tron.TronChain;
+exports.TypedUrScanner = require_shared.TypedUrScanner;
+exports.Ur = require_shared.Ur;
+exports.UrScanner = require_shared.UrScanner;
+exports.splitSignedTronTx = require_messages.splitSignedTronTx;

package/dist/tron.d.cts

@@ -0,0 +1,4 @@
+import { _ as Ur, a as SignRequest, c as TypedUrScanner, d as EraErrorCode, f as EraSdkError, i as ExpectedReply, l as UrScanner, p as AnimatedUr, r as EraConnectConfig } from "./shared-CI8zhQiE.cjs";
+import { n as TronLatestBlock, r as splitSignedTronTx, t as SignedTronTx } from "./messages-DsPvW8Oi.cjs";
+import { n as TronSignRequestProps, r as TronSignatureResult, t as TronChain } from "./tron-gG51KMnX.cjs";
+export { AnimatedUr, type EraConnectConfig, type EraErrorCode, EraSdkError, type ExpectedReply, type SignRequest, type SignedTronTx, TronChain, type TronLatestBlock, type TronSignRequestProps, type TronSignatureResult, TypedUrScanner, Ur, UrScanner, splitSignedTronTx };

package/dist/tron.d.ts

@@ -0,0 +1,4 @@
+import { _ as Ur, a as SignRequest, c as TypedUrScanner, d as EraErrorCode, f as EraSdkError, i as ExpectedReply, l as UrScanner, p as AnimatedUr, r as EraConnectConfig } from "./shared-CI8zhQiE.js";
+import { n as TronLatestBlock, r as splitSignedTronTx, t as SignedTronTx } from "./messages-DsPvW8Oi.js";
+import { n as TronSignRequestProps, r as TronSignatureResult, t as TronChain } from "./tron-YllfTmx6.js";
+export { AnimatedUr, type EraConnectConfig, type EraErrorCode, EraSdkError, type ExpectedReply, type SignRequest, type SignedTronTx, TronChain, type TronLatestBlock, type TronSignRequestProps, type TronSignatureResult, TypedUrScanner, Ur, UrScanner, splitSignedTronTx };

package/dist/tron.js

@@ -0,0 +1,4 @@
+import { Z as EraSdkError, _ as Ur, d as UrScanner, f as AnimatedUr, u as TypedUrScanner } from "./shared-B8Wc7ViU.js";
+import { t as TronChain } from "./tron-Bo9HnvVE.js";
+import { r as splitSignedTronTx } from "./messages-17Oup0-Z.js";
+export { AnimatedUr, EraSdkError, TronChain, TypedUrScanner, Ur, UrScanner, splitSignedTronTx };