@onekeyfe/hwk-trezor-adapter 1.1.29-alpha.4 → 1.1.29-alpha.5

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { IHardwareWallet, IConnector, TransportType, DeviceInfo, Response, ChainCapability, AllNetworkGetAddressParams, AllNetworkAddressResponse, TrezorDeviceSettingsParams, TrezorBrightnessParams, TrezorChangePinParams, UiResponseEvent, ChainForFingerprint, ICommonCallParams, EvmGetAddressParams, EvmAddress, EvmSignTxParams, EvmSignedTx, EvmSignMsgParams, EvmSignature, EvmSignTypedDataParams, BtcGetAddressParams, BtcAddress, BtcGetPublicKeyParams, BtcPublicKey, BtcSignTxParams, BtcSignedTx, BtcSignPsbtParams, BtcSignedPsbt, BtcSignMsgParams, BtcSignature, SolGetAddressParams, SolAddress, SolSignTxParams, SolSignedTx, SolSignMsgParams, SolSignature, TronGetAddressParams, TronAddress, TronSignTxParams, TronSignedTx, TronSignMsgParams, TronSignature, HardwareEventMap, DeviceEventListener, ConnectorDevice } from '@onekeyfe/hwk-adapter-core';
+import { IHardwareWallet, IConnector, TransportType, DeviceInfo, Response, ChainCapability, AllNetworkGetAddressParams, AllNetworkAddressResponse, TrezorDeviceSettingsParams, TrezorBrightnessParams, TrezorChangePinParams, UiResponseEvent, ChainForFingerprint, ICommonCallParams, EvmGetAddressParams, EvmAddress, EvmSignTxParams, EvmSignedTx, EvmSignMsgParams, EvmSignature, EvmSignTypedDataParams, BtcGetAddressParams, BtcAddress, BtcGetPublicKeyParams, BtcPublicKey, BtcSignTxParams, BtcSignedTx, BtcSignPsbtParams, BtcSignedPsbt, BtcSignMsgParams, BtcSignature, SolGetAddressParams, SolAddress, SolSignTxParams, SolSignedTx, SolSignMsgParams, SolSignature, TronGetAddressParams, TronAddress, TronSignTxParams, TronSignedTx, TronSignMsgParams, TronSignature, HardwareEventMap, DeviceEventListener, EvmEthereumDefinitions, ConnectorDevice } from '@onekeyfe/hwk-adapter-core';
 
 type TrezorPassphraseCallParams = {
     passphraseState?: string;
@@ -190,6 +190,76 @@ declare class TrezorAdapter implements IHardwareWallet {
     private _ensureDevicePermission;
 }
 
+/**
+ * Opt-in helpers for fetching Trezor Ethereum "definitions" — the SatoshiLabs-
+ * signed network/token metadata a Trezor device uses to render friendly names
+ * for chains and tokens that are NOT built into firmware.
+ *
+ * IMPORTANT — the SDK signing methods (evmSignTransaction / evmGetAddress / …)
+ * NEVER call these. A local hardware operation must not silently become a
+ * third-party network request (see PR #824 review). The caller decides whether,
+ * when, and where to fetch, then passes the result into the sign params as
+ * `ethereumDefinitions`. When omitted, the device falls back to a generic
+ * confirmation screen and signing still completes.
+ *
+ * Cross-process note: `fetchImpl` is a FUNCTION and cannot be serialized across
+ * an IPC / postMessage boundary. Call these helpers in a network-capable
+ * process and send only the resulting bytes (ArrayBuffer/hex) to the process
+ * that talks to the device. Use `baseUrl` (a string) to route through your own
+ * controlled proxy instead of hitting data.trezor.io directly.
+ */
+/** Default upstream (Trezor). Override with `baseUrl` to use your own proxy. */
+declare const DEFAULT_ETHEREUM_DEFINITIONS_BASE_URL = "https://data.trezor.io/firmware/eth-definitions";
+type FetchLike = (url: string) => Promise<{
+    status: number;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}>;
+type FetchEthereumDefinitionsParams = {
+    chainId?: number;
+    slip44?: number;
+    contractAddress?: string;
+    baseUrl?: string;
+    fetchImpl?: FetchLike;
+};
+type BuildEthereumDefinitionsForPathParams = {
+    path: string;
+    baseUrl?: string;
+    fetchImpl?: FetchLike;
+};
+type BuildEthereumDefinitionsForSignTxParams = {
+    path: string;
+    chainId: number;
+    to?: string;
+    data?: string;
+    baseUrl?: string;
+    fetchImpl?: FetchLike;
+};
+/** Derive the SLIP-44 coin type (unhardened) from a BIP44-style path. */
+declare function getSlip44FromPath(path: string): number;
+declare function fetchEthereumDefinitions({ chainId, slip44, contractAddress, baseUrl, fetchImpl, }: FetchEthereumDefinitionsParams): Promise<EvmEthereumDefinitions>;
+declare function buildEthereumDefinitionsForPath({ path, baseUrl, fetchImpl, }: BuildEthereumDefinitionsForPathParams): Promise<EvmEthereumDefinitions>;
+declare function buildEthereumDefinitionsForSignTx({ path, chainId, to, data, baseUrl, fetchImpl, }: BuildEthereumDefinitionsForSignTxParams): Promise<EvmEthereumDefinitions | undefined>;
+
+/**
+ * Opt-in helper for fetching a Trezor Solana token definition. Same contract as
+ * the Ethereum helpers (see ./ethereumDefinitions): the SDK signing path NEVER
+ * calls this — the caller fetches (through its own `baseUrl` proxy if desired)
+ * and passes the bytes into `solSignTransaction` params as
+ * `additionalInfo.encodedToken`. When omitted the device shows a generic token
+ * confirmation screen and signing still completes.
+ *
+ * `fetchImpl` is a function and must not cross an IPC boundary — fetch in a
+ * network-capable process and pass only the resulting bytes.
+ */
+/** Default upstream (Trezor). Override with `baseUrl` to use your own proxy. */
+declare const DEFAULT_SOLANA_TOKEN_DEFINITION_BASE_URL = "https://data.trezor.io/firmware/definitions/solana/token";
+type FetchSolanaTokenDefinitionParams = {
+    tokenMint: string;
+    baseUrl?: string;
+    fetchImpl?: FetchLike;
+};
+declare function fetchSolanaTokenDefinition({ tokenMint, baseUrl, fetchImpl, }: FetchSolanaTokenDefinitionParams): Promise<ArrayBuffer | undefined>;
+
 /**
  * SDK-global event bus. Per-runtime singleton; hosts forward events over their
  * own IPC when the adapter runs in an offscreen/background split.
@@ -254,4 +324,4 @@ declare function isTrezorBleServiceUuid(uuid: string): boolean;
 declare function isTrezorBleDescriptor(descriptor: TrezorBleDescriptor): boolean;
 declare function resolveTrezorBleConnectId(descriptor: TrezorBleDescriptor): string;
 
-export { type SdkEvent, type SdkEventListener, type SdkLogEvent, TREZOR_BLE_PACKET_SIZE, TREZOR_BLE_SUPPORTED_MODELS, TREZOR_BLE_UUIDS, TREZOR_SAFE_7_MODEL, TrezorAdapter, type TrezorBleDescriptor, type TrezorBleTransport, type TrezorBleTransportFactory, type TrezorConnectedDevice, type TrezorConnectorDevice, isTrezorBleDescriptor, isTrezorBleServiceUuid, isTrezorBleSupportedModel, isTrezorSafe7BleDescriptor, isTrezorSafe7BleName, normalizeTrezorBleUuid, offSdkEvent, onSdkEvent, resolveTrezorBleConnectId };
+export { type BuildEthereumDefinitionsForPathParams, type BuildEthereumDefinitionsForSignTxParams, DEFAULT_ETHEREUM_DEFINITIONS_BASE_URL, DEFAULT_SOLANA_TOKEN_DEFINITION_BASE_URL, type FetchEthereumDefinitionsParams, type FetchLike, type FetchSolanaTokenDefinitionParams, type SdkEvent, type SdkEventListener, type SdkLogEvent, TREZOR_BLE_PACKET_SIZE, TREZOR_BLE_SUPPORTED_MODELS, TREZOR_BLE_UUIDS, TREZOR_SAFE_7_MODEL, TrezorAdapter, type TrezorBleDescriptor, type TrezorBleTransport, type TrezorBleTransportFactory, type TrezorConnectedDevice, type TrezorConnectorDevice, buildEthereumDefinitionsForPath, buildEthereumDefinitionsForSignTx, fetchEthereumDefinitions, fetchSolanaTokenDefinition, getSlip44FromPath, isTrezorBleDescriptor, isTrezorBleServiceUuid, isTrezorBleSupportedModel, isTrezorSafe7BleDescriptor, isTrezorSafe7BleName, normalizeTrezorBleUuid, offSdkEvent, onSdkEvent, resolveTrezorBleConnectId };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { IHardwareWallet, IConnector, TransportType, DeviceInfo, Response, ChainCapability, AllNetworkGetAddressParams, AllNetworkAddressResponse, TrezorDeviceSettingsParams, TrezorBrightnessParams, TrezorChangePinParams, UiResponseEvent, ChainForFingerprint, ICommonCallParams, EvmGetAddressParams, EvmAddress, EvmSignTxParams, EvmSignedTx, EvmSignMsgParams, EvmSignature, EvmSignTypedDataParams, BtcGetAddressParams, BtcAddress, BtcGetPublicKeyParams, BtcPublicKey, BtcSignTxParams, BtcSignedTx, BtcSignPsbtParams, BtcSignedPsbt, BtcSignMsgParams, BtcSignature, SolGetAddressParams, SolAddress, SolSignTxParams, SolSignedTx, SolSignMsgParams, SolSignature, TronGetAddressParams, TronAddress, TronSignTxParams, TronSignedTx, TronSignMsgParams, TronSignature, HardwareEventMap, DeviceEventListener, ConnectorDevice } from '@onekeyfe/hwk-adapter-core';
+import { IHardwareWallet, IConnector, TransportType, DeviceInfo, Response, ChainCapability, AllNetworkGetAddressParams, AllNetworkAddressResponse, TrezorDeviceSettingsParams, TrezorBrightnessParams, TrezorChangePinParams, UiResponseEvent, ChainForFingerprint, ICommonCallParams, EvmGetAddressParams, EvmAddress, EvmSignTxParams, EvmSignedTx, EvmSignMsgParams, EvmSignature, EvmSignTypedDataParams, BtcGetAddressParams, BtcAddress, BtcGetPublicKeyParams, BtcPublicKey, BtcSignTxParams, BtcSignedTx, BtcSignPsbtParams, BtcSignedPsbt, BtcSignMsgParams, BtcSignature, SolGetAddressParams, SolAddress, SolSignTxParams, SolSignedTx, SolSignMsgParams, SolSignature, TronGetAddressParams, TronAddress, TronSignTxParams, TronSignedTx, TronSignMsgParams, TronSignature, HardwareEventMap, DeviceEventListener, EvmEthereumDefinitions, ConnectorDevice } from '@onekeyfe/hwk-adapter-core';
 
 type TrezorPassphraseCallParams = {
     passphraseState?: string;
@@ -190,6 +190,76 @@ declare class TrezorAdapter implements IHardwareWallet {
     private _ensureDevicePermission;
 }
 
+/**
+ * Opt-in helpers for fetching Trezor Ethereum "definitions" — the SatoshiLabs-
+ * signed network/token metadata a Trezor device uses to render friendly names
+ * for chains and tokens that are NOT built into firmware.
+ *
+ * IMPORTANT — the SDK signing methods (evmSignTransaction / evmGetAddress / …)
+ * NEVER call these. A local hardware operation must not silently become a
+ * third-party network request (see PR #824 review). The caller decides whether,
+ * when, and where to fetch, then passes the result into the sign params as
+ * `ethereumDefinitions`. When omitted, the device falls back to a generic
+ * confirmation screen and signing still completes.
+ *
+ * Cross-process note: `fetchImpl` is a FUNCTION and cannot be serialized across
+ * an IPC / postMessage boundary. Call these helpers in a network-capable
+ * process and send only the resulting bytes (ArrayBuffer/hex) to the process
+ * that talks to the device. Use `baseUrl` (a string) to route through your own
+ * controlled proxy instead of hitting data.trezor.io directly.
+ */
+/** Default upstream (Trezor). Override with `baseUrl` to use your own proxy. */
+declare const DEFAULT_ETHEREUM_DEFINITIONS_BASE_URL = "https://data.trezor.io/firmware/eth-definitions";
+type FetchLike = (url: string) => Promise<{
+    status: number;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}>;
+type FetchEthereumDefinitionsParams = {
+    chainId?: number;
+    slip44?: number;
+    contractAddress?: string;
+    baseUrl?: string;
+    fetchImpl?: FetchLike;
+};
+type BuildEthereumDefinitionsForPathParams = {
+    path: string;
+    baseUrl?: string;
+    fetchImpl?: FetchLike;
+};
+type BuildEthereumDefinitionsForSignTxParams = {
+    path: string;
+    chainId: number;
+    to?: string;
+    data?: string;
+    baseUrl?: string;
+    fetchImpl?: FetchLike;
+};
+/** Derive the SLIP-44 coin type (unhardened) from a BIP44-style path. */
+declare function getSlip44FromPath(path: string): number;
+declare function fetchEthereumDefinitions({ chainId, slip44, contractAddress, baseUrl, fetchImpl, }: FetchEthereumDefinitionsParams): Promise<EvmEthereumDefinitions>;
+declare function buildEthereumDefinitionsForPath({ path, baseUrl, fetchImpl, }: BuildEthereumDefinitionsForPathParams): Promise<EvmEthereumDefinitions>;
+declare function buildEthereumDefinitionsForSignTx({ path, chainId, to, data, baseUrl, fetchImpl, }: BuildEthereumDefinitionsForSignTxParams): Promise<EvmEthereumDefinitions | undefined>;
+
+/**
+ * Opt-in helper for fetching a Trezor Solana token definition. Same contract as
+ * the Ethereum helpers (see ./ethereumDefinitions): the SDK signing path NEVER
+ * calls this — the caller fetches (through its own `baseUrl` proxy if desired)
+ * and passes the bytes into `solSignTransaction` params as
+ * `additionalInfo.encodedToken`. When omitted the device shows a generic token
+ * confirmation screen and signing still completes.
+ *
+ * `fetchImpl` is a function and must not cross an IPC boundary — fetch in a
+ * network-capable process and pass only the resulting bytes.
+ */
+/** Default upstream (Trezor). Override with `baseUrl` to use your own proxy. */
+declare const DEFAULT_SOLANA_TOKEN_DEFINITION_BASE_URL = "https://data.trezor.io/firmware/definitions/solana/token";
+type FetchSolanaTokenDefinitionParams = {
+    tokenMint: string;
+    baseUrl?: string;
+    fetchImpl?: FetchLike;
+};
+declare function fetchSolanaTokenDefinition({ tokenMint, baseUrl, fetchImpl, }: FetchSolanaTokenDefinitionParams): Promise<ArrayBuffer | undefined>;
+
 /**
  * SDK-global event bus. Per-runtime singleton; hosts forward events over their
  * own IPC when the adapter runs in an offscreen/background split.
@@ -254,4 +324,4 @@ declare function isTrezorBleServiceUuid(uuid: string): boolean;
 declare function isTrezorBleDescriptor(descriptor: TrezorBleDescriptor): boolean;
 declare function resolveTrezorBleConnectId(descriptor: TrezorBleDescriptor): string;
 
-export { type SdkEvent, type SdkEventListener, type SdkLogEvent, TREZOR_BLE_PACKET_SIZE, TREZOR_BLE_SUPPORTED_MODELS, TREZOR_BLE_UUIDS, TREZOR_SAFE_7_MODEL, TrezorAdapter, type TrezorBleDescriptor, type TrezorBleTransport, type TrezorBleTransportFactory, type TrezorConnectedDevice, type TrezorConnectorDevice, isTrezorBleDescriptor, isTrezorBleServiceUuid, isTrezorBleSupportedModel, isTrezorSafe7BleDescriptor, isTrezorSafe7BleName, normalizeTrezorBleUuid, offSdkEvent, onSdkEvent, resolveTrezorBleConnectId };
+export { type BuildEthereumDefinitionsForPathParams, type BuildEthereumDefinitionsForSignTxParams, DEFAULT_ETHEREUM_DEFINITIONS_BASE_URL, DEFAULT_SOLANA_TOKEN_DEFINITION_BASE_URL, type FetchEthereumDefinitionsParams, type FetchLike, type FetchSolanaTokenDefinitionParams, type SdkEvent, type SdkEventListener, type SdkLogEvent, TREZOR_BLE_PACKET_SIZE, TREZOR_BLE_SUPPORTED_MODELS, TREZOR_BLE_UUIDS, TREZOR_SAFE_7_MODEL, TrezorAdapter, type TrezorBleDescriptor, type TrezorBleTransport, type TrezorBleTransportFactory, type TrezorConnectedDevice, type TrezorConnectorDevice, buildEthereumDefinitionsForPath, buildEthereumDefinitionsForSignTx, fetchEthereumDefinitions, fetchSolanaTokenDefinition, getSlip44FromPath, isTrezorBleDescriptor, isTrezorBleServiceUuid, isTrezorBleSupportedModel, isTrezorSafe7BleDescriptor, isTrezorSafe7BleName, normalizeTrezorBleUuid, offSdkEvent, onSdkEvent, resolveTrezorBleConnectId };

package/dist/index.js

@@ -1082,6 +1082,115 @@ var TrezorAdapter = class _TrezorAdapter {
   }
 };
 
+// src/utils/ethereumDefinitions.ts
+var DEFAULT_ETHEREUM_DEFINITIONS_BASE_URL = "https://data.trezor.io/firmware/eth-definitions";
+function getSlip44FromPath(path) {
+  const segments = path.trim().replace(/^m\//i, "").split("/");
+  const coinType = segments[1];
+  const parsed = coinType === void 0 ? NaN : Number(coinType.replace(/['hH]$/, ""));
+  if (!Number.isFinite(parsed)) {
+    throw new Error(`Cannot derive SLIP-44 coin type from path: ${path}`);
+  }
+  return parsed >= 2147483648 ? parsed - 2147483648 : parsed;
+}
+async function fetchEthereumDefinitions({
+  chainId,
+  slip44,
+  contractAddress,
+  baseUrl = DEFAULT_ETHEREUM_DEFINITIONS_BASE_URL,
+  fetchImpl = globalThis.fetch
+}) {
+  if (!chainId && !slip44) {
+    throw new Error("fetchEthereumDefinitions requires chainId or slip44");
+  }
+  if (!fetchImpl) {
+    return {};
+  }
+  const mode = chainId ? "chain-id" : "slip44";
+  const id = _nullishCoalesce(chainId, () => ( slip44));
+  const definitions = {};
+  const network = await fetchDefinition(`${baseUrl}/${mode}/${id}/network.dat`, fetchImpl);
+  if (network) {
+    definitions.encodedNetwork = network;
+  }
+  if (contractAddress) {
+    const token = await fetchDefinition(
+      `${baseUrl}/${mode}/${id}/token-${stripHexPrefix(contractAddress).toLowerCase()}.dat`,
+      fetchImpl
+    );
+    if (token) {
+      definitions.encodedToken = token;
+    }
+  }
+  return definitions;
+}
+async function buildEthereumDefinitionsForPath({
+  path,
+  baseUrl,
+  fetchImpl
+}) {
+  return fetchEthereumDefinitions({
+    slip44: getSlip44FromPath(path),
+    baseUrl,
+    fetchImpl
+  });
+}
+async function buildEthereumDefinitionsForSignTx({
+  path,
+  chainId,
+  to,
+  data,
+  baseUrl,
+  fetchImpl
+}) {
+  const dataHex = stripHexPrefix(_nullishCoalesce(data, () => ( "")));
+  if (chainId === 1 && !dataHex) {
+    return void 0;
+  }
+  return fetchEthereumDefinitions({
+    chainId,
+    slip44: getSlip44FromPath(path),
+    contractAddress: dataHex && to ? to : void 0,
+    baseUrl,
+    fetchImpl
+  });
+}
+async function fetchDefinition(url, fetchImpl) {
+  try {
+    const response = await fetchImpl(url);
+    if (response.status !== 200) {
+      return void 0;
+    }
+    return await response.arrayBuffer();
+  } catch (e3) {
+    return void 0;
+  }
+}
+function stripHexPrefix(value) {
+  return value.startsWith("0x") || value.startsWith("0X") ? value.slice(2) : value;
+}
+
+// src/utils/solanaTokenDefinition.ts
+var DEFAULT_SOLANA_TOKEN_DEFINITION_BASE_URL = "https://data.trezor.io/firmware/definitions/solana/token";
+async function fetchSolanaTokenDefinition({
+  tokenMint,
+  baseUrl = DEFAULT_SOLANA_TOKEN_DEFINITION_BASE_URL,
+  fetchImpl = globalThis.fetch
+}) {
+  if (!fetchImpl) {
+    return void 0;
+  }
+  try {
+    const response = await fetchImpl(`${baseUrl}/${tokenMint}.dat`);
+    if (response.status !== 200) {
+      return void 0;
+    }
+    return await response.arrayBuffer();
+  } catch (e4) {
+    return void 0;
+  }
+}
+
 // src/constants.ts
 var TREZOR_SAFE_7_MODEL = "T3W1";
 var TREZOR_BLE_SUPPORTED_MODELS = [TREZOR_SAFE_7_MODEL];
@@ -1141,5 +1250,12 @@ function resolveTrezorBleConnectId(descriptor) {
 
 
 
-exports.TREZOR_BLE_PACKET_SIZE = TREZOR_BLE_PACKET_SIZE; exports.TREZOR_BLE_SUPPORTED_MODELS = TREZOR_BLE_SUPPORTED_MODELS; exports.TREZOR_BLE_UUIDS = TREZOR_BLE_UUIDS; exports.TREZOR_SAFE_7_MODEL = TREZOR_SAFE_7_MODEL; exports.TrezorAdapter = TrezorAdapter; exports.isTrezorBleDescriptor = isTrezorBleDescriptor; exports.isTrezorBleServiceUuid = isTrezorBleServiceUuid; exports.isTrezorBleSupportedModel = isTrezorBleSupportedModel; exports.isTrezorSafe7BleDescriptor = isTrezorSafe7BleDescriptor; exports.isTrezorSafe7BleName = isTrezorSafe7BleName; exports.normalizeTrezorBleUuid = normalizeTrezorBleUuid; exports.offSdkEvent = offSdkEvent; exports.onSdkEvent = onSdkEvent; exports.resolveTrezorBleConnectId = resolveTrezorBleConnectId;
+
+
+
+
+
+
+
+exports.DEFAULT_ETHEREUM_DEFINITIONS_BASE_URL = DEFAULT_ETHEREUM_DEFINITIONS_BASE_URL; exports.DEFAULT_SOLANA_TOKEN_DEFINITION_BASE_URL = DEFAULT_SOLANA_TOKEN_DEFINITION_BASE_URL; exports.TREZOR_BLE_PACKET_SIZE = TREZOR_BLE_PACKET_SIZE; exports.TREZOR_BLE_SUPPORTED_MODELS = TREZOR_BLE_SUPPORTED_MODELS; exports.TREZOR_BLE_UUIDS = TREZOR_BLE_UUIDS; exports.TREZOR_SAFE_7_MODEL = TREZOR_SAFE_7_MODEL; exports.TrezorAdapter = TrezorAdapter; exports.buildEthereumDefinitionsForPath = buildEthereumDefinitionsForPath; exports.buildEthereumDefinitionsForSignTx = buildEthereumDefinitionsForSignTx; exports.fetchEthereumDefinitions = fetchEthereumDefinitions; exports.fetchSolanaTokenDefinition = fetchSolanaTokenDefinition; exports.getSlip44FromPath = getSlip44FromPath; exports.isTrezorBleDescriptor = isTrezorBleDescriptor; exports.isTrezorBleServiceUuid = isTrezorBleServiceUuid; exports.isTrezorBleSupportedModel = isTrezorBleSupportedModel; exports.isTrezorSafe7BleDescriptor = isTrezorSafe7BleDescriptor; exports.isTrezorSafe7BleName = isTrezorSafe7BleName; exports.normalizeTrezorBleUuid = normalizeTrezorBleUuid; exports.offSdkEvent = offSdkEvent; exports.onSdkEvent = onSdkEvent; exports.resolveTrezorBleConnectId = resolveTrezorBleConnectId;
 //# sourceMappingURL=index.js.map