@onekeyfe/hwk-trezor-core 1.1.27-alpha.100 → 1.1.29-alpha.1

package/dist/index.d.mts

@@ -1,6 +1,20 @@
+type TrezorDebugLogLevel = 'debug' | 'info' | 'warn' | 'error';
+type TrezorDebugLogEntry = {
+    level: TrezorDebugLogLevel;
+    scope: string;
+    event: string;
+    data?: Record<string, unknown>;
+    thpModuleForwarded?: boolean;
+};
+type TrezorDebugLogger = (entry: TrezorDebugLogEntry) => void;
+declare function shouldLogTrezorDebugEntry(entry: TrezorDebugLogEntry): boolean;
+declare function sanitizeTrezorDebugLogData(data?: Record<string, unknown>): Record<string, unknown> | undefined;
+declare function filterTrezorDebugLogEntry(entry: TrezorDebugLogEntry): TrezorDebugLogEntry | undefined;
+
 interface TrezorByteTransport {
     write(chunk: Buffer, signal?: AbortSignal): Promise<void>;
     read(signal?: AbortSignal): Promise<Buffer>;
+    reconnect?(): Promise<void>;
 }
 interface TrezorTransportProtocol {
     name: 'bridge' | 'v1' | 'v2';
@@ -44,19 +58,15 @@ type TrezorThpCallParams = {
     data?: Record<string, unknown>;
     skipAck?: boolean;
 };
-type TrezorDebugLogLevel = 'debug' | 'info' | 'warn' | 'error';
-type TrezorDebugLogEntry = {
-    level: TrezorDebugLogLevel;
-    scope: string;
-    event: string;
-    data?: Record<string, unknown>;
-};
-type TrezorDebugLogger = (entry: TrezorDebugLogEntry) => void;
 declare class TrezorFailureError extends Error {
     readonly code?: unknown;
     readonly response: TrezorMessageResponse<'Failure'>;
     constructor(response: TrezorMessageResponse<'Failure'>);
 }
+declare class TrezorProtocolError extends Error {
+    readonly code: string;
+    constructor(code: string, message?: string);
+}
 declare class TrezorCore {
     private readonly transport;
     private readonly protocol;
@@ -64,7 +74,13 @@ declare class TrezorCore {
     private readonly logger?;
     constructor({ transport, protocol, chunkSize, logger }: TrezorCoreOptions);
     call(name: TrezorMessageName, data?: Record<string, unknown>, options?: TrezorCallOptions): Promise<TrezorMessageResponse>;
-    private thpLoopLogger;
+    send(name: TrezorMessageName, data?: Record<string, unknown>, options?: TrezorCallOptions): Promise<void>;
+    receive(options?: TrezorCallOptions & {
+        name?: TrezorMessageName;
+    }): Promise<TrezorMessageResponse>;
+    private buildChunks;
+    private writeChunks;
+    private log;
 }
 declare class TrezorThpProtocol {
     private readonly thpState;
@@ -74,10 +90,19 @@ declare class TrezorThpProtocol {
     private applyReceivedState;
 }
 type TrezorCoreLike = {
+    send(name: string, data?: Record<string, unknown>, options?: TrezorCallOptions): Promise<void>;
+    receive(options?: TrezorCallOptions & {
+        name?: string;
+    }): Promise<TrezorMessageResponse>;
     call(name: string, data?: Record<string, unknown>, options?: TrezorCallOptions): Promise<TrezorMessageResponse>;
 };
 type TrezorCoreFactory = (transport: TrezorByteTransport, protocol: TrezorTransportProtocol, chunkSize: number, logger?: TrezorDebugLogger) => TrezorCoreLike;
 type TrezorSessionProtocol = 'v1' | 'thp';
+type TrezorPassphraseMode = 'prompt' | 'empty';
+type TrezorCreateAppSessionOptions = {
+    deriveCardano?: boolean;
+    passphraseMode?: TrezorPassphraseMode;
+};
 type TrezorDeviceSessionOptions = {
     transport: TrezorByteTransport;
     connectionType?: string;
@@ -158,6 +183,7 @@ type TrezorThpSessionOptions = {
         nfcData?: string;
     }) => Promise<TrezorThpPairingResponse>;
     onButtonRequest?: (payload: Record<string, unknown>) => Promise<void> | void;
+    onButtonRequestComplete?: (payload: Record<string, unknown>) => Promise<void> | void;
     onPinMatrixRequest?: (payload: TrezorPinMatrixRequestPayload) => Promise<string> | string;
     /**
      * Provide the passphrase for a session. Called at two points depending on
@@ -184,6 +210,14 @@ type TrezorThpSessionOptions = {
     }) => Promise<void> | void;
     logger?: TrezorDebugLogger;
 };
+/**
+ * Trezor derives the wallet from the EXACT passphrase bytes, so normalize to
+ * NFKD before sending — matches trezor-suite (DeviceCurrentSession / thp
+ * session) and OneKey hd-core. Without it the same human passphrase typed as
+ * composed vs decomposed Unicode would open DIFFERENT wallets. Idempotent; ''
+ * stays ''. Only for the passphrase string — never the `on_device` path.
+ */
+declare const normalizePassphrase: (value: string | undefined) => string;
 declare class TrezorDeviceSession {
     private readonly transport;
     private readonly connectionType?;
@@ -194,6 +228,7 @@ declare class TrezorDeviceSession {
     private protocol;
     private thpState?;
     private thpAppSessionActive;
+    private passphraseMode;
     private currentFeatures?;
     constructor(options: TrezorDeviceSessionOptions);
     get features(): Record<string, unknown> | undefined;
@@ -206,6 +241,7 @@ declare class TrezorDeviceSession {
     get isThp(): boolean;
     getThpState(): TrezorThpState | undefined;
     initialize(): Promise<Record<string, unknown>>;
+    private handshakeCancel;
     call(name: string, data?: Record<string, unknown>): Promise<{
         type: string;
         message: Record<string, unknown>;
@@ -214,11 +250,12 @@ declare class TrezorDeviceSession {
     /**
      * Create a NEW THP application session with a freshly-prompted passphrase
      * (or empty if the device has no passphrase protection). Returns the new
-     * session id (hex). The session knows nothing about wallet identity (XFP) —
-     * the adapter derives that (via master fingerprint) and owns the
-     * XFP↔sessionId map. Multiple sessions can coexist on one channel.
+     * session id (hex). The session knows nothing about wallet identity. Multiple
+     * sessions can coexist on one channel, but callers should not rely on cached
+     * app-session identity for wallet selection.
      */
-    createThpAppSession(deriveCardano?: boolean): Promise<string>;
+    createThpAppSession(options?: boolean | TrezorCreateAppSessionOptions): Promise<string>;
+    createV1AppSession(options?: TrezorCreateAppSessionOptions): Promise<void>;
     /**
      * Switch the active THP session to an existing id (host-side: just sets the
      * session-id byte in the next message header). The device must still hold
@@ -228,12 +265,15 @@ declare class TrezorDeviceSession {
     selectThpAppSession(sessionId: string): void;
     /** Active THP session id (hex), or undefined if none created/selected. */
     getThpAppSessionId(): string | undefined;
-    private ensureThpApplicationSession;
+    withDeviceState<T>(fn: () => Promise<T>, options?: {
+        deriveCardano?: boolean;
+    }): Promise<T>;
     private handleButtonRequest;
+    private handleButtonRequestComplete;
     private handlePinMatrixRequest;
     private handlePassphraseRequest;
     private cancelCurrentCall;
     private log;
 }
 
-export { type TrezorByteTransport, type TrezorCallOptions, TrezorCore, type TrezorCoreFactory, type TrezorCoreLike, type TrezorCoreOptions, type TrezorDebugLogEntry, type TrezorDebugLogLevel, type TrezorDebugLogger, TrezorDeviceSession, TrezorFailureError, type TrezorMessageName, type TrezorMessageResponse, type TrezorPinMatrixRequestPayload, type TrezorThpCallParams, type TrezorThpCredentials, type TrezorThpHandshakeCredentials, type TrezorThpHandshakeInitHandler, type TrezorThpHandshakeInitResponse, type TrezorThpPairingMethod, TrezorThpProtocol, type TrezorThpRawTransport, type TrezorThpSessionOptions, type TrezorThpState, type TrezorTransportProtocol };
+export { type TrezorByteTransport, type TrezorCallOptions, TrezorCore, type TrezorCoreFactory, type TrezorCoreLike, type TrezorCoreOptions, type TrezorCreateAppSessionOptions, type TrezorDebugLogEntry, type TrezorDebugLogLevel, type TrezorDebugLogger, TrezorDeviceSession, TrezorFailureError, type TrezorMessageName, type TrezorMessageResponse, type TrezorPassphraseMode, type TrezorPinMatrixRequestPayload, TrezorProtocolError, type TrezorThpCallParams, type TrezorThpCredentials, type TrezorThpHandshakeCredentials, type TrezorThpHandshakeInitHandler, type TrezorThpHandshakeInitResponse, type TrezorThpPairingMethod, TrezorThpProtocol, type TrezorThpRawTransport, type TrezorThpSessionOptions, type TrezorThpState, type TrezorTransportProtocol, filterTrezorDebugLogEntry, normalizePassphrase, sanitizeTrezorDebugLogData, shouldLogTrezorDebugEntry };

package/dist/index.d.ts

@@ -1,6 +1,20 @@
+type TrezorDebugLogLevel = 'debug' | 'info' | 'warn' | 'error';
+type TrezorDebugLogEntry = {
+    level: TrezorDebugLogLevel;
+    scope: string;
+    event: string;
+    data?: Record<string, unknown>;
+    thpModuleForwarded?: boolean;
+};
+type TrezorDebugLogger = (entry: TrezorDebugLogEntry) => void;
+declare function shouldLogTrezorDebugEntry(entry: TrezorDebugLogEntry): boolean;
+declare function sanitizeTrezorDebugLogData(data?: Record<string, unknown>): Record<string, unknown> | undefined;
+declare function filterTrezorDebugLogEntry(entry: TrezorDebugLogEntry): TrezorDebugLogEntry | undefined;
+
 interface TrezorByteTransport {
     write(chunk: Buffer, signal?: AbortSignal): Promise<void>;
     read(signal?: AbortSignal): Promise<Buffer>;
+    reconnect?(): Promise<void>;
 }
 interface TrezorTransportProtocol {
     name: 'bridge' | 'v1' | 'v2';
@@ -44,19 +58,15 @@ type TrezorThpCallParams = {
     data?: Record<string, unknown>;
     skipAck?: boolean;
 };
-type TrezorDebugLogLevel = 'debug' | 'info' | 'warn' | 'error';
-type TrezorDebugLogEntry = {
-    level: TrezorDebugLogLevel;
-    scope: string;
-    event: string;
-    data?: Record<string, unknown>;
-};
-type TrezorDebugLogger = (entry: TrezorDebugLogEntry) => void;
 declare class TrezorFailureError extends Error {
     readonly code?: unknown;
     readonly response: TrezorMessageResponse<'Failure'>;
     constructor(response: TrezorMessageResponse<'Failure'>);
 }
+declare class TrezorProtocolError extends Error {
+    readonly code: string;
+    constructor(code: string, message?: string);
+}
 declare class TrezorCore {
     private readonly transport;
     private readonly protocol;
@@ -64,7 +74,13 @@ declare class TrezorCore {
     private readonly logger?;
     constructor({ transport, protocol, chunkSize, logger }: TrezorCoreOptions);
     call(name: TrezorMessageName, data?: Record<string, unknown>, options?: TrezorCallOptions): Promise<TrezorMessageResponse>;
-    private thpLoopLogger;
+    send(name: TrezorMessageName, data?: Record<string, unknown>, options?: TrezorCallOptions): Promise<void>;
+    receive(options?: TrezorCallOptions & {
+        name?: TrezorMessageName;
+    }): Promise<TrezorMessageResponse>;
+    private buildChunks;
+    private writeChunks;
+    private log;
 }
 declare class TrezorThpProtocol {
     private readonly thpState;
@@ -74,10 +90,19 @@ declare class TrezorThpProtocol {
     private applyReceivedState;
 }
 type TrezorCoreLike = {
+    send(name: string, data?: Record<string, unknown>, options?: TrezorCallOptions): Promise<void>;
+    receive(options?: TrezorCallOptions & {
+        name?: string;
+    }): Promise<TrezorMessageResponse>;
     call(name: string, data?: Record<string, unknown>, options?: TrezorCallOptions): Promise<TrezorMessageResponse>;
 };
 type TrezorCoreFactory = (transport: TrezorByteTransport, protocol: TrezorTransportProtocol, chunkSize: number, logger?: TrezorDebugLogger) => TrezorCoreLike;
 type TrezorSessionProtocol = 'v1' | 'thp';
+type TrezorPassphraseMode = 'prompt' | 'empty';
+type TrezorCreateAppSessionOptions = {
+    deriveCardano?: boolean;
+    passphraseMode?: TrezorPassphraseMode;
+};
 type TrezorDeviceSessionOptions = {
     transport: TrezorByteTransport;
     connectionType?: string;
@@ -158,6 +183,7 @@ type TrezorThpSessionOptions = {
         nfcData?: string;
     }) => Promise<TrezorThpPairingResponse>;
     onButtonRequest?: (payload: Record<string, unknown>) => Promise<void> | void;
+    onButtonRequestComplete?: (payload: Record<string, unknown>) => Promise<void> | void;
     onPinMatrixRequest?: (payload: TrezorPinMatrixRequestPayload) => Promise<string> | string;
     /**
      * Provide the passphrase for a session. Called at two points depending on
@@ -184,6 +210,14 @@ type TrezorThpSessionOptions = {
     }) => Promise<void> | void;
     logger?: TrezorDebugLogger;
 };
+/**
+ * Trezor derives the wallet from the EXACT passphrase bytes, so normalize to
+ * NFKD before sending — matches trezor-suite (DeviceCurrentSession / thp
+ * session) and OneKey hd-core. Without it the same human passphrase typed as
+ * composed vs decomposed Unicode would open DIFFERENT wallets. Idempotent; ''
+ * stays ''. Only for the passphrase string — never the `on_device` path.
+ */
+declare const normalizePassphrase: (value: string | undefined) => string;
 declare class TrezorDeviceSession {
     private readonly transport;
     private readonly connectionType?;
@@ -194,6 +228,7 @@ declare class TrezorDeviceSession {
     private protocol;
     private thpState?;
     private thpAppSessionActive;
+    private passphraseMode;
     private currentFeatures?;
     constructor(options: TrezorDeviceSessionOptions);
     get features(): Record<string, unknown> | undefined;
@@ -206,6 +241,7 @@ declare class TrezorDeviceSession {
     get isThp(): boolean;
     getThpState(): TrezorThpState | undefined;
     initialize(): Promise<Record<string, unknown>>;
+    private handshakeCancel;
     call(name: string, data?: Record<string, unknown>): Promise<{
         type: string;
         message: Record<string, unknown>;
@@ -214,11 +250,12 @@ declare class TrezorDeviceSession {
     /**
      * Create a NEW THP application session with a freshly-prompted passphrase
      * (or empty if the device has no passphrase protection). Returns the new
-     * session id (hex). The session knows nothing about wallet identity (XFP) —
-     * the adapter derives that (via master fingerprint) and owns the
-     * XFP↔sessionId map. Multiple sessions can coexist on one channel.
+     * session id (hex). The session knows nothing about wallet identity. Multiple
+     * sessions can coexist on one channel, but callers should not rely on cached
+     * app-session identity for wallet selection.
      */
-    createThpAppSession(deriveCardano?: boolean): Promise<string>;
+    createThpAppSession(options?: boolean | TrezorCreateAppSessionOptions): Promise<string>;
+    createV1AppSession(options?: TrezorCreateAppSessionOptions): Promise<void>;
     /**
      * Switch the active THP session to an existing id (host-side: just sets the
      * session-id byte in the next message header). The device must still hold
@@ -228,12 +265,15 @@ declare class TrezorDeviceSession {
     selectThpAppSession(sessionId: string): void;
     /** Active THP session id (hex), or undefined if none created/selected. */
     getThpAppSessionId(): string | undefined;
-    private ensureThpApplicationSession;
+    withDeviceState<T>(fn: () => Promise<T>, options?: {
+        deriveCardano?: boolean;
+    }): Promise<T>;
     private handleButtonRequest;
+    private handleButtonRequestComplete;
     private handlePinMatrixRequest;
     private handlePassphraseRequest;
     private cancelCurrentCall;
     private log;
 }
 
-export { type TrezorByteTransport, type TrezorCallOptions, TrezorCore, type TrezorCoreFactory, type TrezorCoreLike, type TrezorCoreOptions, type TrezorDebugLogEntry, type TrezorDebugLogLevel, type TrezorDebugLogger, TrezorDeviceSession, TrezorFailureError, type TrezorMessageName, type TrezorMessageResponse, type TrezorPinMatrixRequestPayload, type TrezorThpCallParams, type TrezorThpCredentials, type TrezorThpHandshakeCredentials, type TrezorThpHandshakeInitHandler, type TrezorThpHandshakeInitResponse, type TrezorThpPairingMethod, TrezorThpProtocol, type TrezorThpRawTransport, type TrezorThpSessionOptions, type TrezorThpState, type TrezorTransportProtocol };
+export { type TrezorByteTransport, type TrezorCallOptions, TrezorCore, type TrezorCoreFactory, type TrezorCoreLike, type TrezorCoreOptions, type TrezorCreateAppSessionOptions, type TrezorDebugLogEntry, type TrezorDebugLogLevel, type TrezorDebugLogger, TrezorDeviceSession, TrezorFailureError, type TrezorMessageName, type TrezorMessageResponse, type TrezorPassphraseMode, type TrezorPinMatrixRequestPayload, TrezorProtocolError, type TrezorThpCallParams, type TrezorThpCredentials, type TrezorThpHandshakeCredentials, type TrezorThpHandshakeInitHandler, type TrezorThpHandshakeInitResponse, type TrezorThpPairingMethod, TrezorThpProtocol, type TrezorThpRawTransport, type TrezorThpSessionOptions, type TrezorThpState, type TrezorTransportProtocol, filterTrezorDebugLogEntry, normalizePassphrase, sanitizeTrezorDebugLogData, shouldLogTrezorDebugEntry };