@hwlt/era-connect 0.4.0 → 0.5.0

package/README.md

@@ -83,16 +83,10 @@ today and speaks the rest through the same primitives.
 | Cosmos (~35 networks incl. Ethermint) | `cosmos-sign-request` / `evm-sign-request` | ADR-036 | `@hwlt/era-connect/cosmos` |
 | XRP | `ur:bytes` (XRP Toolkit convention) | — | `@hwlt/era-connect/xrp` |
 | Litecoin, Dogecoin, Dash | `crypto-psbt-extend` (same flow as Bitcoin) | — | `@hwlt/era-connect/btc` |
+| Bitcoin Cash | structured envelope (FORKID signing, CashAddr) | — | `@hwlt/era-connect/bch` |
 
-**Also supported by the device** — usable today via `era.raw` +
-`era.scanner({expectedTypes})`, dedicated modules on the roadmap (order driven
-by integrator demand):
-
-| Chain | Wire type | Module status |
-|---|---|---|
-| Bitcoin Cash | structured envelope (FORKID signing) | planned |
-
-Two things make the gap workable now: **linking already surfaces every account
+Every chain the current device firmware ships now has a dedicated module.
+Two things keep future additions workable: **linking already surfaces every account
 the device exports** (unknown chains still carry their path, fingerprint and
 public key), and the scanner/fountain layer is chain-agnostic. The device's
 chain list keeps growing — confirm the current set with the ERA team.

package/bch/package.json

@@ -0,0 +1,6 @@
+{
+  "main": "../dist/bch.cjs",
+  "module": "../dist/bch.js",
+  "types": "../dist/bch.d.ts",
+  "react-native": "../dist/bch.js"
+}

package/dist/bch-CK6dKGQA.d.ts

@@ -0,0 +1,74 @@
+import { _ as Ur, a as SignRequest, i as ExpectedReply, r as EraConnectConfig } from "./shared-CI8zhQiE.js";
+//#region src/chains/bch.d.ts
+/** One UTXO the transaction spends. P2PKH only — that is what the device signs. */
+interface BchTxInput {
+  /** Display-order (big-endian) txid of the UTXO, 64 hex chars. */
+  readonly txid: string;
+  /** Output index of the UTXO. */
+  readonly index: number;
+  /** UTXO value in satoshis — part of the BIP-143 sighash, so it MUST be exact. */
+  readonly value: number | bigint;
+  /** The compressed (33-byte) public key that owns the UTXO. */
+  readonly publicKey: Uint8Array | string;
+  /** Full derivation path of that key, e.g. `m/44'/145'/0'/0/0`. */
+  readonly path: string;
+}
+interface BchTxOutput {
+  /** CashAddr (P2PKH or P2SH), with or without the `bitcoincash:` prefix. */
+  readonly address: string;
+  /** Output value in satoshis. */
+  readonly value: number | bigint;
+  /** Marks the output as change on the device screen. Display only. */
+  readonly isChange?: boolean;
+  /** Shown with the change output; the address above is still what is paid. */
+  readonly changeAddressPath?: string;
+}
+interface BchSignRequestProps {
+  readonly requestId?: Uint8Array | string;
+  readonly inputs: readonly BchTxInput[];
+  /** Every output — change included — carries a real CashAddr. */
+  readonly outputs: readonly BchTxOutput[];
+  /** Fee in satoshis. Must equal `sum(inputs) - sum(outputs)` exactly. */
+  readonly fee: number | bigint;
+  /** Dust threshold shown on the device; defaults to 546. */
+  readonly dustThreshold?: number;
+  readonly memo?: string;
+  readonly xfp: string | number;
+  /** Milliseconds timestamp shown in the device log; 0 omits it. */
+  readonly timestamp?: number;
+  readonly origin?: string;
+}
+interface BchSignatureResult {
+  readonly requestId: Uint8Array;
+  /** Display-order txid of the signed transaction, as computed by the device. */
+  readonly txId: string;
+  /** Hex of the fully signed transaction — broadcast as-is. */
+  readonly rawTx: string;
+}
+/**
+ * Bitcoin Cash signing rides the structured `keystone-sign-request` (6101)
+ * envelope, NOT the PSBT path: the device's PSBT signer cannot apply the
+ * `SIGHASH_FORKID` (0x41) sighash BCH consensus requires, so a dedicated
+ * FORKID signer sits behind this envelope instead. The SDK therefore builds
+ * the transaction container from structured inputs/outputs here — the one
+ * chain where it is more than a transport.
+ *
+ * The device derives each input's signing key from its `path`, computes the
+ * BIP-143 sighash with FORKID over version-1/locktime-0/sequence-0xfffffffd
+ * legacy serialization, and returns the COMPLETE signed transaction.
+ */
+declare class BchChain {
+  private readonly context;
+  constructor(config?: EraConnectConfig);
+  /** Build a `keystone-sign-request` (6101). Reply: `keystone-sign-result` (6102). */
+  generateSignRequest(props: BchSignRequestProps): SignRequest<BchSignatureResult>;
+  /**
+   * Parse a `keystone-sign-result` standalone. The request id lives INSIDE
+   * the protobuf (`signId`); pass `expect.requestId` to enable the echo
+   * check — prefer `SignRequest.scanner().parse()`.
+   */
+  parseSignature(input: Ur | string, expect?: ExpectedReply): BchSignatureResult;
+}
+//#endregion
+export { BchTxOutput as a, BchTxInput as i, BchSignRequestProps as n, BchSignatureResult as r, BchChain as t };
+//# sourceMappingURL=bch-CK6dKGQA.d.ts.map

package/dist/bch-CpLACx0j.cjs

@@ -0,0 +1,139 @@
+const require_shared = require("./shared-Cu2yynP9.cjs");
+const require_keypath = require("./keypath-pzm_YIfN.cjs");
+const require_cashaddr = require("./cashaddr-Ci0_8ITN.cjs");
+const require_gzip = require("./gzip-CLzDX7AZ.cjs");
+const require_messages = require("./messages-orAQ52CI.cjs");
+//#region src/chains/bch.ts
+const MAX_COMPRESSED_BYTES = 8192;
+const MAX_INFLATED_BYTES = 65536;
+const REPLY_TYPES = ["keystone-sign-result"];
+/** Satoshi amounts must stay exact in a double; anything above is refused. */
+const MAX_SATOSHI = 2100000000000000n;
+function toSatoshi(value, label) {
+	if (typeof value === "number" && !Number.isSafeInteger(value)) throw new require_shared.EraSdkError("invalid-props", `${label} must be an integer satoshi amount`);
+	const v = typeof value === "number" ? BigInt(value) : value;
+	if (v <= 0n || v > MAX_SATOSHI) throw new require_shared.EraSdkError("invalid-props", `${label} must be a positive satoshi amount`);
+	return v;
+}
+function toPublicKeyHex(publicKey, label) {
+	const hex = typeof publicKey === "string" ? publicKey.toLowerCase() : require_shared.bytesToHex(publicKey);
+	if (!/^0[23][0-9a-f]{64}$/.test(hex)) throw new require_shared.EraSdkError("invalid-props", `${label} must be a 33-byte compressed public key`);
+	return hex;
+}
+/**
+* Bitcoin Cash signing rides the structured `keystone-sign-request` (6101)
+* envelope, NOT the PSBT path: the device's PSBT signer cannot apply the
+* `SIGHASH_FORKID` (0x41) sighash BCH consensus requires, so a dedicated
+* FORKID signer sits behind this envelope instead. The SDK therefore builds
+* the transaction container from structured inputs/outputs here — the one
+* chain where it is more than a transport.
+*
+* The device derives each input's signing key from its `path`, computes the
+* BIP-143 sighash with FORKID over version-1/locktime-0/sequence-0xfffffffd
+* legacy serialization, and returns the COMPLETE signed transaction.
+*/
+var BchChain = 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);
+		const xfp = require_keypath.normalizeXfp(props.xfp);
+		if (props.inputs.length === 0) throw new require_shared.EraSdkError("invalid-props", "at least one input is required");
+		if (props.outputs.length === 0) throw new require_shared.EraSdkError("invalid-props", "at least one output is required");
+		let inputSum = 0n;
+		const inputs = props.inputs.map((input, i) => {
+			if (!/^[0-9a-fA-F]{64}$/.test(input.txid)) throw new require_shared.EraSdkError("invalid-props", `input ${i}: txid must be 64 hex chars`);
+			if (!Number.isInteger(input.index) || input.index < 0) throw new require_shared.EraSdkError("invalid-props", `input ${i}: index must be a non-negative integer`);
+			require_keypath.parsePath(input.path);
+			const value = toSatoshi(input.value, `input ${i} value`);
+			inputSum += value;
+			return {
+				txidHex: input.txid.toLowerCase(),
+				index: input.index,
+				value,
+				publicKeyHex: toPublicKeyHex(input.publicKey, `input ${i} publicKey`),
+				ownerKeyPath: input.path
+			};
+		});
+		let outputSum = 0n;
+		const outputs = props.outputs.map((output, i) => {
+			const decoded = require_cashaddr.decodeCashAddr(output.address);
+			const value = toSatoshi(output.value, `output ${i} value`);
+			outputSum += value;
+			if (output.changeAddressPath !== void 0) require_keypath.parsePath(output.changeAddressPath);
+			return {
+				address: require_cashaddr.encodeCashAddr(decoded.type, decoded.hash, { withPrefix: output.address.includes(":") }),
+				value,
+				isChange: output.isChange ?? false,
+				changeAddressPath: output.changeAddressPath
+			};
+		});
+		const fee = toSatoshi(props.fee, "fee");
+		if (inputSum !== outputSum + fee) throw new require_shared.EraSdkError("invalid-props", `fee mismatch: inputs (${inputSum}) minus outputs (${outputSum}) is ${inputSum - outputSum}, but fee says ${fee}`);
+		const dustThreshold = props.dustThreshold ?? 546;
+		if (!Number.isInteger(dustThreshold) || dustThreshold < 0 || dustThreshold > 2147483647) throw new require_shared.EraSdkError("invalid-props", "dustThreshold must fit a non-negative int32");
+		const proto = require_messages.encodeBchSignRequestProto({
+			xfpHex: require_keypath.xfpToHex(xfp),
+			signId: require_shared.uuidStringify(requestId),
+			timestamp: props.timestamp ?? 0,
+			fee,
+			dustThreshold,
+			memo: props.memo,
+			inputs,
+			outputs
+		});
+		const ur = new require_shared.Ur("keystone-sign-request", require_shared.cborEncode(require_shared.cbMap([[1, require_shared.cbBytes(require_gzip.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) => parseBchSignature(reply, requestId)
+		});
+	}
+	/**
+	* Parse a `keystone-sign-result` standalone. The request id lives INSIDE
+	* the protobuf (`signId`); pass `expect.requestId` to enable the echo
+	* check — prefer `SignRequest.scanner().parse()`.
+	*/
+	parseSignature(input, expect) {
+		return parseBchSignature(require_shared.toUr(input), expect?.requestId === void 0 ? void 0 : require_shared.normalizeRequestId(expect.requestId));
+	}
+};
+function parseBchSignature(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(require_gzip.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");
+	if (!/^[0-9a-fA-F]+$/.test(result.rawTx) || result.rawTx.length % 2 !== 0) throw new require_shared.EraSdkError("malformed-reply", "keystone-sign-result rawTx is not hex");
+	return {
+		requestId: expectedRequestId ?? signIdToBytes(result.signId),
+		txId: result.txId,
+		rawTx: result.rawTx
+	};
+}
+function signIdToBytes(signId) {
+	try {
+		return require_shared.normalizeRequestId(signId);
+	} catch {
+		return /* @__PURE__ */ new Uint8Array(16);
+	}
+}
+//#endregion
+Object.defineProperty(exports, "BchChain", {
+	enumerable: true,
+	get: function() {
+		return BchChain;
+	}
+});
+
+//# sourceMappingURL=bch-CpLACx0j.cjs.map

package/dist/bch-CpLACx0j.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bch-CpLACx0j.cjs","names":["EraSdkError","bytesToHex","resolveContext","resolveRequestId","normalizeXfp","decodeCashAddr","encodeCashAddr","encodeBchSignRequestProto","xfpToHex","uuidStringify","UrValue","cborEncode","cbMap","cbBytes","gzipCompress","cbText","makeSignRequest","toUr","normalizeRequestId","requireReplyMap","asBytes","mapGet","decodeSignResultProto","gunzipCapped"],"sources":["../src/chains/bch.ts"],"sourcesContent":["import { cborEncode } from '../cbor/encode';\nimport { asBytes, cbBytes, cbMap, cbText, mapGet } from '../cbor/model';\nimport { bytesToHex } from '../core/bytes';\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 { BchProtoInput, BchProtoOutput } from '../tron-proto/messages';\nimport { decodeSignResultProto, encodeBchSignRequestProto } from '../tron-proto/messages';\nimport type { Ur } from '../ur/ur';\nimport { Ur as UrValue } from '../ur/ur';\nimport { decodeCashAddr, encodeCashAddr } from './cashaddr';\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 { CashAddrPayload, CashAddrType } from './cashaddr';\nexport { CASHADDR_PREFIX, decodeCashAddr, encodeCashAddr } from './cashaddr';\n\n/** One UTXO the transaction spends. P2PKH only — that is what the device signs. */\nexport interface BchTxInput {\n  /** Display-order (big-endian) txid of the UTXO, 64 hex chars. */\n  readonly txid: string;\n  /** Output index of the UTXO. */\n  readonly index: number;\n  /** UTXO value in satoshis — part of the BIP-143 sighash, so it MUST be exact. */\n  readonly value: number | bigint;\n  /** The compressed (33-byte) public key that owns the UTXO. */\n  readonly publicKey: Uint8Array | string;\n  /** Full derivation path of that key, e.g. `m/44'/145'/0'/0/0`. */\n  readonly path: string;\n}\n\nexport interface BchTxOutput {\n  /** CashAddr (P2PKH or P2SH), with or without the `bitcoincash:` prefix. */\n  readonly address: string;\n  /** Output value in satoshis. */\n  readonly value: number | bigint;\n  /** Marks the output as change on the device screen. Display only. */\n  readonly isChange?: boolean;\n  /** Shown with the change output; the address above is still what is paid. */\n  readonly changeAddressPath?: string;\n}\n\nexport interface BchSignRequestProps {\n  readonly requestId?: Uint8Array | string;\n  readonly inputs: readonly BchTxInput[];\n  /** Every output — change included — carries a real CashAddr. */\n  readonly outputs: readonly BchTxOutput[];\n  /** Fee in satoshis. Must equal `sum(inputs) - sum(outputs)` exactly. */\n  readonly fee: number | bigint;\n  /** Dust threshold shown on the device; defaults to 546. */\n  readonly dustThreshold?: number;\n  readonly memo?: string;\n  readonly xfp: string | number;\n  /** Milliseconds timestamp shown in the device log; 0 omits it. */\n  readonly timestamp?: number;\n  readonly origin?: string;\n}\n\nexport interface BchSignatureResult {\n  readonly requestId: Uint8Array;\n  /** Display-order txid of the signed transaction, as computed by the device. */\n  readonly txId: string;\n  /** Hex of the fully signed transaction — broadcast as-is. */\n  readonly rawTx: string;\n}\n\nconst MAX_COMPRESSED_BYTES = 8 * 1024;\nconst MAX_INFLATED_BYTES = 64 * 1024;\n\nconst REPLY_TYPES = ['keystone-sign-result'] as const;\n\n/** Satoshi amounts must stay exact in a double; anything above is refused. */\nconst MAX_SATOSHI = 2_100_000_000_000_000n; // 21M coins\n\nfunction toSatoshi(value: number | bigint, label: string): bigint {\n  // Refuse non-integers BEFORE BigInt() — BigInt(NaN) throws a raw RangeError.\n  if (typeof value === 'number' && !Number.isSafeInteger(value)) {\n    throw new EraSdkError('invalid-props', `${label} must be an integer satoshi amount`);\n  }\n  const v = typeof value === 'number' ? BigInt(value) : value;\n  if (v <= 0n || v > MAX_SATOSHI) {\n    throw new EraSdkError('invalid-props', `${label} must be a positive satoshi amount`);\n  }\n  return v;\n}\n\nfunction toPublicKeyHex(publicKey: Uint8Array | string, label: string): string {\n  const hex = typeof publicKey === 'string' ? publicKey.toLowerCase() : bytesToHex(publicKey);\n  if (!/^0[23][0-9a-f]{64}$/.test(hex)) {\n    throw new EraSdkError('invalid-props', `${label} must be a 33-byte compressed public key`);\n  }\n  return hex;\n}\n\n/**\n * Bitcoin Cash signing rides the structured `keystone-sign-request` (6101)\n * envelope, NOT the PSBT path: the device's PSBT signer cannot apply the\n * `SIGHASH_FORKID` (0x41) sighash BCH consensus requires, so a dedicated\n * FORKID signer sits behind this envelope instead. The SDK therefore builds\n * the transaction container from structured inputs/outputs here — the one\n * chain where it is more than a transport.\n *\n * The device derives each input's signing key from its `path`, computes the\n * BIP-143 sighash with FORKID over version-1/locktime-0/sequence-0xfffffffd\n * legacy serialization, and returns the COMPLETE signed transaction.\n */\nexport class BchChain {\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: BchSignRequestProps): SignRequest<BchSignatureResult> {\n    const requestId = resolveRequestId(this.context, props.requestId);\n    const xfp = normalizeXfp(props.xfp);\n    if (props.inputs.length === 0) {\n      throw new EraSdkError('invalid-props', 'at least one input is required');\n    }\n    if (props.outputs.length === 0) {\n      throw new EraSdkError('invalid-props', 'at least one output is required');\n    }\n\n    let inputSum = 0n;\n    const inputs: BchProtoInput[] = props.inputs.map((input, i) => {\n      if (!/^[0-9a-fA-F]{64}$/.test(input.txid)) {\n        throw new EraSdkError('invalid-props', `input ${i}: txid must be 64 hex chars`);\n      }\n      if (!Number.isInteger(input.index) || input.index < 0) {\n        throw new EraSdkError('invalid-props', `input ${i}: index must be a non-negative integer`);\n      }\n      parsePath(input.path); // validate shape; the wire carries the string form\n      const value = toSatoshi(input.value, `input ${i} value`);\n      inputSum += value;\n      return {\n        txidHex: input.txid.toLowerCase(),\n        index: input.index,\n        value,\n        publicKeyHex: toPublicKeyHex(input.publicKey, `input ${i} publicKey`),\n        ownerKeyPath: input.path,\n      };\n    });\n\n    let outputSum = 0n;\n    const outputs: BchProtoOutput[] = props.outputs.map((output, i) => {\n      // Decode AND re-encode: the wire must carry the canonical lowercase\n      // form. The device's own parser prepends a lowercase prefix before\n      // decoding, so the spec's all-uppercase (QR alphanumeric) spelling\n      // turns mixed-case there, is rejected — and the rejection FAILS OPEN\n      // into a zero pubkey hash, i.e. a signed burn output. Never forward\n      // the caller's spelling.\n      const decoded = decodeCashAddr(output.address);\n      const value = toSatoshi(output.value, `output ${i} value`);\n      outputSum += value;\n      if (output.changeAddressPath !== undefined) parsePath(output.changeAddressPath);\n      return {\n        address: encodeCashAddr(decoded.type, decoded.hash, {\n          withPrefix: output.address.includes(':'),\n        }),\n        value,\n        isChange: output.isChange ?? false,\n        changeAddressPath: output.changeAddressPath,\n      };\n    });\n\n    // The fee field is what the device SHOWS the user, but the fee the network\n    // takes is inputs minus outputs — an inconsistent pair would put a lie on\n    // the confirmation screen, so it is refused here.\n    const fee = toSatoshi(props.fee, 'fee');\n    if (inputSum !== outputSum + fee) {\n      throw new EraSdkError(\n        'invalid-props',\n        `fee mismatch: inputs (${inputSum}) minus outputs (${outputSum}) is ${\n          inputSum - outputSum\n        }, but fee says ${fee}`,\n      );\n    }\n\n    const dustThreshold = props.dustThreshold ?? 546;\n    if (!Number.isInteger(dustThreshold) || dustThreshold < 0 || dustThreshold > 0x7fffffff) {\n      throw new EraSdkError('invalid-props', 'dustThreshold must fit a non-negative int32');\n    }\n\n    const proto = encodeBchSignRequestProto({\n      // Zero-padded to eight characters — same firmware hex reader as Tron.\n      xfpHex: xfpToHex(xfp),\n      signId: uuidStringify(requestId),\n      timestamp: props.timestamp ?? 0,\n      fee,\n      dustThreshold,\n      memo: props.memo,\n      inputs,\n      outputs,\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) => parseBchSignature(reply, requestId),\n    });\n  }\n\n  /**\n   * Parse a `keystone-sign-result` standalone. The request id lives INSIDE\n   * the protobuf (`signId`); pass `expect.requestId` to enable the echo\n   * check — prefer `SignRequest.scanner().parse()`.\n   */\n  parseSignature(input: Ur | string, expect?: ExpectedReply): BchSignatureResult {\n    return parseBchSignature(\n      toUr(input),\n      expect?.requestId === undefined ? undefined : normalizeRequestId(expect.requestId),\n    );\n  }\n}\n\nfunction parseBchSignature(ur: Ur, expectedRequestId: Uint8Array | undefined): BchSignatureResult {\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 envelope. After\n  // it, ALWAYS run `verifyBchSignedTx` from `@hwlt/era-connect/verify` — the\n  // reply is a complete broadcastable transaction, and the echo alone does\n  // not prove its inputs and outputs are the ones that were requested.\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  if (!/^[0-9a-fA-F]+$/.test(result.rawTx) || result.rawTx.length % 2 !== 0) {\n    throw new EraSdkError('malformed-reply', 'keystone-sign-result rawTx is not hex');\n  }\n  const requestId = expectedRequestId ?? signIdToBytes(result.signId);\n  return { requestId, txId: result.txId, rawTx: result.rawTx };\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/bch-DHsIVJqK.d.cts

@@ -0,0 +1,74 @@
+import { _ as Ur, a as SignRequest, i as ExpectedReply, r as EraConnectConfig } from "./shared-CI8zhQiE.cjs";
+//#region src/chains/bch.d.ts
+/** One UTXO the transaction spends. P2PKH only — that is what the device signs. */
+interface BchTxInput {
+  /** Display-order (big-endian) txid of the UTXO, 64 hex chars. */
+  readonly txid: string;
+  /** Output index of the UTXO. */
+  readonly index: number;
+  /** UTXO value in satoshis — part of the BIP-143 sighash, so it MUST be exact. */
+  readonly value: number | bigint;
+  /** The compressed (33-byte) public key that owns the UTXO. */
+  readonly publicKey: Uint8Array | string;
+  /** Full derivation path of that key, e.g. `m/44'/145'/0'/0/0`. */
+  readonly path: string;
+}
+interface BchTxOutput {
+  /** CashAddr (P2PKH or P2SH), with or without the `bitcoincash:` prefix. */
+  readonly address: string;
+  /** Output value in satoshis. */
+  readonly value: number | bigint;
+  /** Marks the output as change on the device screen. Display only. */
+  readonly isChange?: boolean;
+  /** Shown with the change output; the address above is still what is paid. */
+  readonly changeAddressPath?: string;
+}
+interface BchSignRequestProps {
+  readonly requestId?: Uint8Array | string;
+  readonly inputs: readonly BchTxInput[];
+  /** Every output — change included — carries a real CashAddr. */
+  readonly outputs: readonly BchTxOutput[];
+  /** Fee in satoshis. Must equal `sum(inputs) - sum(outputs)` exactly. */
+  readonly fee: number | bigint;
+  /** Dust threshold shown on the device; defaults to 546. */
+  readonly dustThreshold?: number;
+  readonly memo?: string;
+  readonly xfp: string | number;
+  /** Milliseconds timestamp shown in the device log; 0 omits it. */
+  readonly timestamp?: number;
+  readonly origin?: string;
+}
+interface BchSignatureResult {
+  readonly requestId: Uint8Array;
+  /** Display-order txid of the signed transaction, as computed by the device. */
+  readonly txId: string;
+  /** Hex of the fully signed transaction — broadcast as-is. */
+  readonly rawTx: string;
+}
+/**
+ * Bitcoin Cash signing rides the structured `keystone-sign-request` (6101)
+ * envelope, NOT the PSBT path: the device's PSBT signer cannot apply the
+ * `SIGHASH_FORKID` (0x41) sighash BCH consensus requires, so a dedicated
+ * FORKID signer sits behind this envelope instead. The SDK therefore builds
+ * the transaction container from structured inputs/outputs here — the one
+ * chain where it is more than a transport.
+ *
+ * The device derives each input's signing key from its `path`, computes the
+ * BIP-143 sighash with FORKID over version-1/locktime-0/sequence-0xfffffffd
+ * legacy serialization, and returns the COMPLETE signed transaction.
+ */
+declare class BchChain {
+  private readonly context;
+  constructor(config?: EraConnectConfig);
+  /** Build a `keystone-sign-request` (6101). Reply: `keystone-sign-result` (6102). */
+  generateSignRequest(props: BchSignRequestProps): SignRequest<BchSignatureResult>;
+  /**
+   * Parse a `keystone-sign-result` standalone. The request id lives INSIDE
+   * the protobuf (`signId`); pass `expect.requestId` to enable the echo
+   * check — prefer `SignRequest.scanner().parse()`.
+   */
+  parseSignature(input: Ur | string, expect?: ExpectedReply): BchSignatureResult;
+}
+//#endregion
+export { BchTxOutput as a, BchTxInput as i, BchSignRequestProps as n, BchSignatureResult as r, BchChain as t };
+//# sourceMappingURL=bch-DHsIVJqK.d.cts.map

package/dist/bch-dMESlQfv.js

@@ -0,0 +1,134 @@
+import { B as cbMap, H as cbText, K as EraSdkError, N as asBytes, W as mapGet, _ as Ur, c as resolveRequestId, g as uuidStringify, h as normalizeRequestId, l as toUr, n as makeSignRequest, o as requireUrType, r as requireReplyMap, s as resolveContext, w as bytesToHex, x as cborEncode, z as cbBytes } from "./shared-Bbgejrus.js";
+import { i as parsePath, r as normalizeXfp, s as xfpToHex } from "./keypath-Bvv_cfHt.js";
+import { n as decodeCashAddr, r as encodeCashAddr } from "./cashaddr-BIzawizX.js";
+import { n as gzipCompress, t as gunzipCapped } from "./gzip-DyZLtgJJ.js";
+import { n as encodeBchSignRequestProto, t as decodeSignResultProto } from "./messages--XbVef_k.js";
+//#region src/chains/bch.ts
+const MAX_COMPRESSED_BYTES = 8192;
+const MAX_INFLATED_BYTES = 65536;
+const REPLY_TYPES = ["keystone-sign-result"];
+/** Satoshi amounts must stay exact in a double; anything above is refused. */
+const MAX_SATOSHI = 2100000000000000n;
+function toSatoshi(value, label) {
+	if (typeof value === "number" && !Number.isSafeInteger(value)) throw new EraSdkError("invalid-props", `${label} must be an integer satoshi amount`);
+	const v = typeof value === "number" ? BigInt(value) : value;
+	if (v <= 0n || v > MAX_SATOSHI) throw new EraSdkError("invalid-props", `${label} must be a positive satoshi amount`);
+	return v;
+}
+function toPublicKeyHex(publicKey, label) {
+	const hex = typeof publicKey === "string" ? publicKey.toLowerCase() : bytesToHex(publicKey);
+	if (!/^0[23][0-9a-f]{64}$/.test(hex)) throw new EraSdkError("invalid-props", `${label} must be a 33-byte compressed public key`);
+	return hex;
+}
+/**
+* Bitcoin Cash signing rides the structured `keystone-sign-request` (6101)
+* envelope, NOT the PSBT path: the device's PSBT signer cannot apply the
+* `SIGHASH_FORKID` (0x41) sighash BCH consensus requires, so a dedicated
+* FORKID signer sits behind this envelope instead. The SDK therefore builds
+* the transaction container from structured inputs/outputs here — the one
+* chain where it is more than a transport.
+*
+* The device derives each input's signing key from its `path`, computes the
+* BIP-143 sighash with FORKID over version-1/locktime-0/sequence-0xfffffffd
+* legacy serialization, and returns the COMPLETE signed transaction.
+*/
+var BchChain = 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);
+		const xfp = normalizeXfp(props.xfp);
+		if (props.inputs.length === 0) throw new EraSdkError("invalid-props", "at least one input is required");
+		if (props.outputs.length === 0) throw new EraSdkError("invalid-props", "at least one output is required");
+		let inputSum = 0n;
+		const inputs = props.inputs.map((input, i) => {
+			if (!/^[0-9a-fA-F]{64}$/.test(input.txid)) throw new EraSdkError("invalid-props", `input ${i}: txid must be 64 hex chars`);
+			if (!Number.isInteger(input.index) || input.index < 0) throw new EraSdkError("invalid-props", `input ${i}: index must be a non-negative integer`);
+			parsePath(input.path);
+			const value = toSatoshi(input.value, `input ${i} value`);
+			inputSum += value;
+			return {
+				txidHex: input.txid.toLowerCase(),
+				index: input.index,
+				value,
+				publicKeyHex: toPublicKeyHex(input.publicKey, `input ${i} publicKey`),
+				ownerKeyPath: input.path
+			};
+		});
+		let outputSum = 0n;
+		const outputs = props.outputs.map((output, i) => {
+			const decoded = decodeCashAddr(output.address);
+			const value = toSatoshi(output.value, `output ${i} value`);
+			outputSum += value;
+			if (output.changeAddressPath !== void 0) parsePath(output.changeAddressPath);
+			return {
+				address: encodeCashAddr(decoded.type, decoded.hash, { withPrefix: output.address.includes(":") }),
+				value,
+				isChange: output.isChange ?? false,
+				changeAddressPath: output.changeAddressPath
+			};
+		});
+		const fee = toSatoshi(props.fee, "fee");
+		if (inputSum !== outputSum + fee) throw new EraSdkError("invalid-props", `fee mismatch: inputs (${inputSum}) minus outputs (${outputSum}) is ${inputSum - outputSum}, but fee says ${fee}`);
+		const dustThreshold = props.dustThreshold ?? 546;
+		if (!Number.isInteger(dustThreshold) || dustThreshold < 0 || dustThreshold > 2147483647) throw new EraSdkError("invalid-props", "dustThreshold must fit a non-negative int32");
+		const proto = encodeBchSignRequestProto({
+			xfpHex: xfpToHex(xfp),
+			signId: uuidStringify(requestId),
+			timestamp: props.timestamp ?? 0,
+			fee,
+			dustThreshold,
+			memo: props.memo,
+			inputs,
+			outputs
+		});
+		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) => parseBchSignature(reply, requestId)
+		});
+	}
+	/**
+	* Parse a `keystone-sign-result` standalone. The request id lives INSIDE
+	* the protobuf (`signId`); pass `expect.requestId` to enable the echo
+	* check — prefer `SignRequest.scanner().parse()`.
+	*/
+	parseSignature(input, expect) {
+		return parseBchSignature(toUr(input), expect?.requestId === void 0 ? void 0 : normalizeRequestId(expect.requestId));
+	}
+};
+function parseBchSignature(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");
+	if (!/^[0-9a-fA-F]+$/.test(result.rawTx) || result.rawTx.length % 2 !== 0) throw new EraSdkError("malformed-reply", "keystone-sign-result rawTx is not hex");
+	return {
+		requestId: expectedRequestId ?? signIdToBytes(result.signId),
+		txId: result.txId,
+		rawTx: result.rawTx
+	};
+}
+function signIdToBytes(signId) {
+	try {
+		return normalizeRequestId(signId);
+	} catch {
+		return /* @__PURE__ */ new Uint8Array(16);
+	}
+}
+//#endregion
+export { BchChain as t };
+
+//# sourceMappingURL=bch-dMESlQfv.js.map

package/dist/bch-dMESlQfv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bch-dMESlQfv.js","names":["UrValue"],"sources":["../src/chains/bch.ts"],"sourcesContent":["import { cborEncode } from '../cbor/encode';\nimport { asBytes, cbBytes, cbMap, cbText, mapGet } from '../cbor/model';\nimport { bytesToHex } from '../core/bytes';\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 { BchProtoInput, BchProtoOutput } from '../tron-proto/messages';\nimport { decodeSignResultProto, encodeBchSignRequestProto } from '../tron-proto/messages';\nimport type { Ur } from '../ur/ur';\nimport { Ur as UrValue } from '../ur/ur';\nimport { decodeCashAddr, encodeCashAddr } from './cashaddr';\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 { CashAddrPayload, CashAddrType } from './cashaddr';\nexport { CASHADDR_PREFIX, decodeCashAddr, encodeCashAddr } from './cashaddr';\n\n/** One UTXO the transaction spends. P2PKH only — that is what the device signs. */\nexport interface BchTxInput {\n  /** Display-order (big-endian) txid of the UTXO, 64 hex chars. */\n  readonly txid: string;\n  /** Output index of the UTXO. */\n  readonly index: number;\n  /** UTXO value in satoshis — part of the BIP-143 sighash, so it MUST be exact. */\n  readonly value: number | bigint;\n  /** The compressed (33-byte) public key that owns the UTXO. */\n  readonly publicKey: Uint8Array | string;\n  /** Full derivation path of that key, e.g. `m/44'/145'/0'/0/0`. */\n  readonly path: string;\n}\n\nexport interface BchTxOutput {\n  /** CashAddr (P2PKH or P2SH), with or without the `bitcoincash:` prefix. */\n  readonly address: string;\n  /** Output value in satoshis. */\n  readonly value: number | bigint;\n  /** Marks the output as change on the device screen. Display only. */\n  readonly isChange?: boolean;\n  /** Shown with the change output; the address above is still what is paid. */\n  readonly changeAddressPath?: string;\n}\n\nexport interface BchSignRequestProps {\n  readonly requestId?: Uint8Array | string;\n  readonly inputs: readonly BchTxInput[];\n  /** Every output — change included — carries a real CashAddr. */\n  readonly outputs: readonly BchTxOutput[];\n  /** Fee in satoshis. Must equal `sum(inputs) - sum(outputs)` exactly. */\n  readonly fee: number | bigint;\n  /** Dust threshold shown on the device; defaults to 546. */\n  readonly dustThreshold?: number;\n  readonly memo?: string;\n  readonly xfp: string | number;\n  /** Milliseconds timestamp shown in the device log; 0 omits it. */\n  readonly timestamp?: number;\n  readonly origin?: string;\n}\n\nexport interface BchSignatureResult {\n  readonly requestId: Uint8Array;\n  /** Display-order txid of the signed transaction, as computed by the device. */\n  readonly txId: string;\n  /** Hex of the fully signed transaction — broadcast as-is. */\n  readonly rawTx: string;\n}\n\nconst MAX_COMPRESSED_BYTES = 8 * 1024;\nconst MAX_INFLATED_BYTES = 64 * 1024;\n\nconst REPLY_TYPES = ['keystone-sign-result'] as const;\n\n/** Satoshi amounts must stay exact in a double; anything above is refused. */\nconst MAX_SATOSHI = 2_100_000_000_000_000n; // 21M coins\n\nfunction toSatoshi(value: number | bigint, label: string): bigint {\n  // Refuse non-integers BEFORE BigInt() — BigInt(NaN) throws a raw RangeError.\n  if (typeof value === 'number' && !Number.isSafeInteger(value)) {\n    throw new EraSdkError('invalid-props', `${label} must be an integer satoshi amount`);\n  }\n  const v = typeof value === 'number' ? BigInt(value) : value;\n  if (v <= 0n || v > MAX_SATOSHI) {\n    throw new EraSdkError('invalid-props', `${label} must be a positive satoshi amount`);\n  }\n  return v;\n}\n\nfunction toPublicKeyHex(publicKey: Uint8Array | string, label: string): string {\n  const hex = typeof publicKey === 'string' ? publicKey.toLowerCase() : bytesToHex(publicKey);\n  if (!/^0[23][0-9a-f]{64}$/.test(hex)) {\n    throw new EraSdkError('invalid-props', `${label} must be a 33-byte compressed public key`);\n  }\n  return hex;\n}\n\n/**\n * Bitcoin Cash signing rides the structured `keystone-sign-request` (6101)\n * envelope, NOT the PSBT path: the device's PSBT signer cannot apply the\n * `SIGHASH_FORKID` (0x41) sighash BCH consensus requires, so a dedicated\n * FORKID signer sits behind this envelope instead. The SDK therefore builds\n * the transaction container from structured inputs/outputs here — the one\n * chain where it is more than a transport.\n *\n * The device derives each input's signing key from its `path`, computes the\n * BIP-143 sighash with FORKID over version-1/locktime-0/sequence-0xfffffffd\n * legacy serialization, and returns the COMPLETE signed transaction.\n */\nexport class BchChain {\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: BchSignRequestProps): SignRequest<BchSignatureResult> {\n    const requestId = resolveRequestId(this.context, props.requestId);\n    const xfp = normalizeXfp(props.xfp);\n    if (props.inputs.length === 0) {\n      throw new EraSdkError('invalid-props', 'at least one input is required');\n    }\n    if (props.outputs.length === 0) {\n      throw new EraSdkError('invalid-props', 'at least one output is required');\n    }\n\n    let inputSum = 0n;\n    const inputs: BchProtoInput[] = props.inputs.map((input, i) => {\n      if (!/^[0-9a-fA-F]{64}$/.test(input.txid)) {\n        throw new EraSdkError('invalid-props', `input ${i}: txid must be 64 hex chars`);\n      }\n      if (!Number.isInteger(input.index) || input.index < 0) {\n        throw new EraSdkError('invalid-props', `input ${i}: index must be a non-negative integer`);\n      }\n      parsePath(input.path); // validate shape; the wire carries the string form\n      const value = toSatoshi(input.value, `input ${i} value`);\n      inputSum += value;\n      return {\n        txidHex: input.txid.toLowerCase(),\n        index: input.index,\n        value,\n        publicKeyHex: toPublicKeyHex(input.publicKey, `input ${i} publicKey`),\n        ownerKeyPath: input.path,\n      };\n    });\n\n    let outputSum = 0n;\n    const outputs: BchProtoOutput[] = props.outputs.map((output, i) => {\n      // Decode AND re-encode: the wire must carry the canonical lowercase\n      // form. The device's own parser prepends a lowercase prefix before\n      // decoding, so the spec's all-uppercase (QR alphanumeric) spelling\n      // turns mixed-case there, is rejected — and the rejection FAILS OPEN\n      // into a zero pubkey hash, i.e. a signed burn output. Never forward\n      // the caller's spelling.\n      const decoded = decodeCashAddr(output.address);\n      const value = toSatoshi(output.value, `output ${i} value`);\n      outputSum += value;\n      if (output.changeAddressPath !== undefined) parsePath(output.changeAddressPath);\n      return {\n        address: encodeCashAddr(decoded.type, decoded.hash, {\n          withPrefix: output.address.includes(':'),\n        }),\n        value,\n        isChange: output.isChange ?? false,\n        changeAddressPath: output.changeAddressPath,\n      };\n    });\n\n    // The fee field is what the device SHOWS the user, but the fee the network\n    // takes is inputs minus outputs — an inconsistent pair would put a lie on\n    // the confirmation screen, so it is refused here.\n    const fee = toSatoshi(props.fee, 'fee');\n    if (inputSum !== outputSum + fee) {\n      throw new EraSdkError(\n        'invalid-props',\n        `fee mismatch: inputs (${inputSum}) minus outputs (${outputSum}) is ${\n          inputSum - outputSum\n        }, but fee says ${fee}`,\n      );\n    }\n\n    const dustThreshold = props.dustThreshold ?? 546;\n    if (!Number.isInteger(dustThreshold) || dustThreshold < 0 || dustThreshold > 0x7fffffff) {\n      throw new EraSdkError('invalid-props', 'dustThreshold must fit a non-negative int32');\n    }\n\n    const proto = encodeBchSignRequestProto({\n      // Zero-padded to eight characters — same firmware hex reader as Tron.\n      xfpHex: xfpToHex(xfp),\n      signId: uuidStringify(requestId),\n      timestamp: props.timestamp ?? 0,\n      fee,\n      dustThreshold,\n      memo: props.memo,\n      inputs,\n      outputs,\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) => parseBchSignature(reply, requestId),\n    });\n  }\n\n  /**\n   * Parse a `keystone-sign-result` standalone. The request id lives INSIDE\n   * the protobuf (`signId`); pass `expect.requestId` to enable the echo\n   * check — prefer `SignRequest.scanner().parse()`.\n   */\n  parseSignature(input: Ur | string, expect?: ExpectedReply): BchSignatureResult {\n    return parseBchSignature(\n      toUr(input),\n      expect?.requestId === undefined ? undefined : normalizeRequestId(expect.requestId),\n    );\n  }\n}\n\nfunction parseBchSignature(ur: Ur, expectedRequestId: Uint8Array | undefined): BchSignatureResult {\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 envelope. After\n  // it, ALWAYS run `verifyBchSignedTx` from `@hwlt/era-connect/verify` — the\n  // reply is a complete broadcastable transaction, and the echo alone does\n  // not prove its inputs and outputs are the ones that were requested.\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  if (!/^[0-9a-fA-F]+$/.test(result.rawTx) || result.rawTx.length % 2 !== 0) {\n    throw new EraSdkError('malformed-reply', 'keystone-sign-result rawTx is not hex');\n  }\n  const requestId = expectedRequestId ?? signIdToBytes(result.signId);\n  return { requestId, txId: result.txId, rawTx: result.rawTx };\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/bch.cjs

@@ -0,0 +1,13 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_shared = require("./shared-Cu2yynP9.cjs");
+const require_cashaddr = require("./cashaddr-Ci0_8ITN.cjs");
+const require_bch = require("./bch-CpLACx0j.cjs");
+exports.AnimatedUr = require_shared.AnimatedUr;
+exports.BchChain = require_bch.BchChain;
+exports.CASHADDR_PREFIX = require_cashaddr.CASHADDR_PREFIX;
+exports.EraSdkError = require_shared.EraSdkError;
+exports.TypedUrScanner = require_shared.TypedUrScanner;
+exports.Ur = require_shared.Ur;
+exports.UrScanner = require_shared.UrScanner;
+exports.decodeCashAddr = require_cashaddr.decodeCashAddr;
+exports.encodeCashAddr = require_cashaddr.encodeCashAddr;

package/dist/bch.d.cts

@@ -0,0 +1,26 @@
+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 { a as BchTxOutput, i as BchTxInput, n as BchSignRequestProps, r as BchSignatureResult, t as BchChain } from "./bch-DHsIVJqK.cjs";
+//#region src/chains/cashaddr.d.ts
+/** The default (mainnet) human-readable prefix. */
+declare const CASHADDR_PREFIX = "bitcoincash";
+type CashAddrType = 'p2pkh' | 'p2sh';
+interface CashAddrPayload {
+  readonly type: CashAddrType;
+  /** The 20-byte hash160. */
+  readonly hash: Uint8Array;
+  readonly prefix: string;
+}
+/**
+ * Decode a CashAddr, with or without its `prefix:`. Only 20-byte P2PKH and
+ * P2SH payloads are accepted — those are the two script kinds the device
+ * builds outputs for.
+ */
+declare function decodeCashAddr(address: string, expectedPrefix?: string): CashAddrPayload;
+/** Encode a 20-byte hash160 as a CashAddr. Returns the bare form by default. */
+declare function encodeCashAddr(type: CashAddrType, hash: Uint8Array, options?: {
+  prefix?: string | undefined;
+  withPrefix?: boolean | undefined;
+}): string;
+//#endregion
+export { AnimatedUr, BchChain, type BchSignRequestProps, type BchSignatureResult, type BchTxInput, type BchTxOutput, CASHADDR_PREFIX, type CashAddrPayload, type CashAddrType, type EraConnectConfig, type EraErrorCode, EraSdkError, type ExpectedReply, type SignRequest, TypedUrScanner, Ur, UrScanner, decodeCashAddr, encodeCashAddr };
+//# sourceMappingURL=bch.d.cts.map

package/dist/bch.d.ts

@@ -0,0 +1,26 @@
+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 { a as BchTxOutput, i as BchTxInput, n as BchSignRequestProps, r as BchSignatureResult, t as BchChain } from "./bch-CK6dKGQA.js";
+//#region src/chains/cashaddr.d.ts
+/** The default (mainnet) human-readable prefix. */
+declare const CASHADDR_PREFIX = "bitcoincash";
+type CashAddrType = 'p2pkh' | 'p2sh';
+interface CashAddrPayload {
+  readonly type: CashAddrType;
+  /** The 20-byte hash160. */
+  readonly hash: Uint8Array;
+  readonly prefix: string;
+}
+/**
+ * Decode a CashAddr, with or without its `prefix:`. Only 20-byte P2PKH and
+ * P2SH payloads are accepted — those are the two script kinds the device
+ * builds outputs for.
+ */
+declare function decodeCashAddr(address: string, expectedPrefix?: string): CashAddrPayload;
+/** Encode a 20-byte hash160 as a CashAddr. Returns the bare form by default. */
+declare function encodeCashAddr(type: CashAddrType, hash: Uint8Array, options?: {
+  prefix?: string | undefined;
+  withPrefix?: boolean | undefined;
+}): string;
+//#endregion
+export { AnimatedUr, BchChain, type BchSignRequestProps, type BchSignatureResult, type BchTxInput, type BchTxOutput, CASHADDR_PREFIX, type CashAddrPayload, type CashAddrType, type EraConnectConfig, type EraErrorCode, EraSdkError, type ExpectedReply, type SignRequest, TypedUrScanner, Ur, UrScanner, decodeCashAddr, encodeCashAddr };
+//# sourceMappingURL=bch.d.ts.map

package/dist/bch.js

@@ -0,0 +1,4 @@
+import { K as EraSdkError, _ as Ur, d as UrScanner, f as AnimatedUr, u as TypedUrScanner } from "./shared-Bbgejrus.js";
+import { n as decodeCashAddr, r as encodeCashAddr, t as CASHADDR_PREFIX } from "./cashaddr-BIzawizX.js";
+import { t as BchChain } from "./bch-dMESlQfv.js";
+export { AnimatedUr, BchChain, CASHADDR_PREFIX, EraSdkError, TypedUrScanner, Ur, UrScanner, decodeCashAddr, encodeCashAddr };

package/dist/{btc-B_Nq2H4T.js → btc-BmVgvvBd.js}

@@ -84,7 +84,7 @@ function parseMessageSignature(ur, expectedRequestId) {
 	const requestId = requireRequestIdEcho(map, 1, expectedRequestId, "btc-signature");
 	const sigValue = asBytes(mapGet(map, 2));
 	if (sigValue === void 0) throw new EraSdkError("malformed-reply", "btc-signature is missing the signature (key 2)");
-	if (sigValue.length === 0) throw new EraSdkError("empty-signature", "the device returned an empty signature — Bitcoin message signing supports legacy P2PKH (1...) addresses only");
+	if (sigValue.length === 0) throw new EraSdkError("empty-signature", "the device returned an empty signature — the address kind is not message-signable on this firmware (older firmware: legacy P2PKH only; 2.1.0+: everything but Taproot)");
 	let signature;
 	try {
 		signature = base64.decode(asciiDecode(sigValue));
@@ -105,4 +105,4 @@ function parseMessageSignature(ur, expectedRequestId) {
 //#endregion
 export { BtcChain as t };
 
-//# sourceMappingURL=btc-B_Nq2H4T.js.map
+//# sourceMappingURL=btc-BmVgvvBd.js.map