@trezor/connect 10.0.0-beta.1 → 10.0.0-beta.2

package/lib/device/Device.d.ts

@@ -1,259 +0,0 @@
-import type { DeviceBusyStatus, DeviceFirmwareStatus, DeviceState, Device as DeviceTyped, DeviceUniquePath, Features, FirmwareHashCheckResult, FirmwareReleaseConfigInfo, FirmwareType, PROTO, UnavailableCapabilities } from '@trezor/connect-common';
-import { DEVICE } from '@trezor/connect-common';
-import type { CreateLogger } from '@trezor/connect-common/lib/types/settings';
-import type { FirmwareRelease } from '@trezor/device-utils';
-import type { TransportProtocol } from '@trezor/protocol';
-import { thp as protocolThp } from '@trezor/protocol';
-import { type Descriptor, type Session, type Transport } from '@trezor/transport-common';
-import { TypedEmitter } from '@trezor/utils';
-import type { VersionArray } from '@trezor/utils/lib/versionUtils';
-import type { TypedCallProvider } from "./DeviceCurrentSession.js";
-import type { DeviceEvents, DeviceLifecycleEvents, IDevice, RunOptions } from "../types/idevice.js";
-export { type DeviceEvents } from "../types/idevice.js";
-type DeviceParams = {
-  id: DeviceUniquePath;
-  transport: Transport;
-  descriptor: Descriptor;
-  createLogger: CreateLogger;
-};
-export declare class Device extends TypedEmitter<DeviceEvents> implements IDevice {
-  readonly transport: Transport;
-  private thp;
-  readonly descriptor: Pick<Descriptor, 'apiType' | 'id' | 'type' | 'path' | 'model'>;
-  private sessionAcquired;
-  private _protocol;
-  get protocol(): TransportProtocol;
-  getThpState(): protocolThp.ThpState | undefined;
-  private unreadableError?;
-  private _firmwareStatus;
-  get firmwareStatus(): DeviceFirmwareStatus;
-  private _currentRelease?;
-  get currentRelease(): FirmwareRelease | undefined;
-  private _firmwareReleaseConfigInfo?;
-  get firmwareReleaseConfigInfo(): FirmwareReleaseConfigInfo | undefined;
-  private _features;
-  get features(): {
-    label?: string | null | undefined;
-    session_id?: string | null | undefined;
-    language?: string | null | undefined;
-    auto_lock_delay_ms?: number | null | undefined;
-    display_rotation?: "North" | "East" | "South" | "West" | null | undefined;
-    passphrase_always_on_device?: boolean | null | undefined;
-    safety_checks?: "Strict" | "PromptAlways" | "PromptTemporarily" | null | undefined;
-    experimental_features?: boolean | null | undefined;
-    hide_passphrase_from_host?: boolean | undefined;
-    haptic_feedback?: boolean | undefined;
-    auto_lock_delay_battery_ms?: number | undefined;
-    flags?: number | null | undefined;
-    passphrase_protection?: boolean | null | undefined;
-    no_backup?: boolean | null | undefined;
-    unfinished_backup?: boolean | null | undefined;
-    pin_protection?: boolean | null | undefined;
-    backup_type?: "Bip39" | "Slip39_Basic" | "Slip39_Advanced" | "Slip39_Single_Extendable" | "Slip39_Basic_Extendable" | "Slip39_Advanced_Extendable" | null | undefined;
-    vendor?: string | undefined;
-    build_version?: number | undefined;
-    bootloader_mode?: boolean | null | undefined;
-    initialized?: boolean | null | undefined;
-    revision?: string | null | undefined;
-    bootloader_hash?: string | null | undefined;
-    imported?: boolean | null | undefined;
-    unlocked?: boolean | null | undefined;
-    _passphrase_cached?: boolean | undefined;
-    firmware_present?: boolean | null | undefined;
-    backup_availability?: "NotAvailable" | "Required" | "Available" | null | undefined;
-    fw_major?: number | null | undefined;
-    fw_minor?: number | null | undefined;
-    fw_patch?: number | null | undefined;
-    fw_build?: number | undefined;
-    fw_vendor?: string | null | undefined;
-    recovery_status?: "Nothing" | "Recovery" | "Backup" | null | undefined;
-    sd_card_present?: boolean | null | undefined;
-    sd_protection?: boolean | null | undefined;
-    wipe_code_protection?: boolean | null | undefined;
-    busy?: boolean | undefined;
-    homescreen_format?: "Toif" | "Jpeg" | "ToiG" | null | undefined;
-    unit_color?: number | undefined;
-    unit_btconly?: boolean | undefined;
-    homescreen_width?: number | undefined;
-    homescreen_height?: number | undefined;
-    bootloader_locked?: boolean | undefined;
-    language_version_matches?: boolean | undefined;
-    unit_packaging?: number | undefined;
-    recovery_type?: "NormalRecovery" | "DryRun" | "UnlockRepeatedBackup" | null | undefined;
-    optiga_sec?: number | undefined;
-    soc?: number | undefined;
-    firmware_corrupted?: boolean | undefined;
-    led?: boolean | undefined;
-    usb_connected?: boolean | undefined;
-    wireless_connected?: boolean | undefined;
-    tap_to_wake?: boolean | undefined;
-    capabilities: ("Capability_Bitcoin" | "Capability_Bitcoin_like" | "Capability_Binance" | "Capability_Cardano" | "Capability_Crypto" | "Capability_EOS" | "Capability_Ethereum" | "Capability_Lisk" | "Capability_Monero" | "Capability_NEM" | "Capability_Ripple" | "Capability_Stellar" | "Capability_Tezos" | "Capability_U2F" | "Capability_Shamir" | "Capability_ShamirGroups" | "Capability_PassphraseEntry" | "Capability_Solana" | "Capability_Translations" | "Capability_Brightness" | "Capability_Haptic" | "Capability_BLE" | "Capability_NFC" | "Capability_Tron" | "Capability_N4W1" | "Capability_TouchWakeup")[];
-    model: string;
-    major_version: number;
-    minor_version: number;
-    patch_version: number;
-    device_id: string | null;
-    internal_model: PROTO.DeviceModelInternal;
-  };
-  private wasUsedElsewhere;
-  private acquirePromise?;
-  private releasePromise?;
-  private runAbort?;
-  private runPromise?;
-  private keepTransportSession;
-  private currentSession?;
-  private instance;
-  private state;
-  private busy?;
-  private _unavailableCapabilities;
-  get unavailableCapabilities(): Readonly<UnavailableCapabilities>;
-  private _firmwareType?;
-  get firmwareType(): FirmwareType | undefined;
-  private get possibleHIDdevice();
-  get possibleT1(): boolean;
-  private name;
-  private color?;
-  private availableTranslations;
-  private authenticityChecks;
-  private readonly uniquePath;
-  private readonly createLogger;
-  private readonly logger;
-  readonly lifecycle: TypedEmitter<DeviceLifecycleEvents>;
-  private lastEmittedMessage?;
-  private sessionDfd?;
-  constructor({
-    id,
-    transport,
-    descriptor,
-    createLogger
-  }: DeviceParams);
-  get transportPath(): import("@trezor/transport-common").PathPublic;
-  private readonly onTransportStopped;
-  private readonly onTransportDeviceEvent;
-  private getSessionChangePromise;
-  private waitAndCompareSession;
-  acquire(): import("@trezor/transport-common").AsyncResultWithTypedError<Session, "Unable to open device" | "Wrong result type." | "Network request failed" | "device disconnected during action" | "device not found" | "wrong previous session" | "unexpected error" | "Aborted by timeout" | "Aborted by signal" | "This transport can not be used in this environment" | "LIBUSB_ERROR_ACCESS">;
-  reset(): void;
-  setBusy(value?: DeviceBusyStatus): void;
-  release(): import("@trezor/transport-common").AsyncResultWithTypedError<null, "Unable to open device" | "Wrong result type." | "Network request failed" | "device disconnected during action" | "device not found" | "wrong previous session" | "unexpected error" | "Aborted by timeout" | "Aborted by signal" | "This transport can not be used in this environment" | "session not found"> | undefined;
-  setupThp(): void;
-  handshake(): Promise<boolean>;
-  private updateDescriptor;
-  emitDeviceChanged(): void;
-  startPiggybackAck(): void;
-  stopPiggybackAck(): Promise<void>;
-  run(fn?: () => Promise<void>, options?: RunOptions): Promise<void>;
-  interrupt(reason: Error): Promise<void>;
-  get currentRun(): Promise<void> | undefined;
-  private usedElsewhere;
-  private _runInner;
-  getCurrentSession(): TypedCallProvider;
-  getCommands(): {
-    unlockPath: (params?: PROTO.UnlockPath) => Promise<{
-      type: "UnlockedPathRequest";
-      message: {
-        mac: string;
-      };
-    }>;
-    getPublicKey: (params: PROTO.GetPublicKey, unlock?: PROTO.UnlockPath) => Promise<{
-      descriptor?: string | undefined;
-      root_fingerprint?: number | undefined;
-      xpub: string;
-      node: {
-        private_key?: string | undefined;
-        fingerprint: number;
-        depth: number;
-        child_num: number;
-        chain_code: string;
-        public_key: string;
-      };
-    }>;
-    getAddress: ({
-      address_n,
-      show_display,
-      multisig,
-      script_type,
-      chunkify
-    }: PROTO.GetAddress, coinInfo: import("@trezor/connect-common").BitcoinNetworkInfo) => Promise<{
-      mac?: string | undefined;
-      address: string;
-    }>;
-    ethereumGetPublicKey: ({
-      address_n,
-      show_display
-    }: PROTO.EthereumGetPublicKey) => Promise<{
-      xpub: string;
-      node: {
-        private_key?: string | undefined;
-        fingerprint: number;
-        depth: number;
-        child_num: number;
-        chain_code: string;
-        public_key: string;
-      };
-    }>;
-    ethereumGetAddress: (params: PROTO.EthereumGetAddress) => Promise<{
-      mac?: string | undefined;
-      _old_address?: string | undefined;
-      address: string;
-    }>;
-    getHDNode: (params: PROTO.GetPublicKey, options: {
-      coinInfo: import("@trezor/connect-common").BitcoinNetworkInfo;
-      validation?: boolean;
-      unlockPath?: PROTO.UnlockPath;
-    }) => Promise<{
-      publicKey: string;
-      path: number[];
-      serializedPath: string;
-      displayablePublicKey: string;
-    } & {
-      xpubSegwit?: string | undefined;
-      descriptorChecksum?: string | undefined;
-      rootFingerprint?: number | undefined;
-      descriptor?: string | undefined;
-      childNum: number;
-      xpub: string;
-      chainCode: string;
-      fingerprint: number;
-      depth: number;
-    }>;
-    preauthorize: (throwError: boolean) => Promise<boolean>;
-    getAccountDescriptor: (coinInfo: import("@trezor/connect-common").CoinInfo, address_n: number[], derivationType?: PROTO.CardanoDerivationType) => Promise<import("./DeviceCommands").AccountDescriptor>;
-    typedCall: PROTO.TypedCall;
-  };
-  setInstance(instance?: number): void;
-  getInstance(): number;
-  getState(): DeviceState | undefined;
-  setState(state?: Partial<DeviceState>): void;
-  initialize(useCardanoDerivation: boolean): Promise<void>;
-  getFeatures(): Promise<void>;
-  getAuthenticityChecks(): {
-    firmwareRevision: import("@trezor/connect-common").FirmwareRevisionCheckResult | null;
-    firmwareHash: FirmwareHashCheckResult | null;
-  };
-  setAuthenticityChecks(firmwareHash: FirmwareHashCheckResult | null): void;
-  private checkFirmwareRevisionWithRetries;
-  private checkFirmwareRevision;
-  private _updateCurrentRelease;
-  private _updateFeatures;
-  private deviceVersionCheck;
-  private updateNameAndColor;
-  updateFeature<K extends keyof Pick<Features, 'soc'>>(key: K, value: Features[K]): void;
-  prompt<T extends typeof DEVICE.PIN | typeof DEVICE.PASSPHRASE | typeof DEVICE.WORD | typeof DEVICE.THP_PAIRING>(type: T, args: Omit<DeviceEvents[T], 'callback'>): Promise<Parameters<DeviceEvents[T]["callback"]>[0]>;
-  isUnacquired(): boolean;
-  private disconnect;
-  isBootloader(): boolean;
-  isInitialized(): boolean;
-  isSeedless(): boolean;
-  getVersion(): VersionArray | undefined;
-  atLeast(versions: string[] | string): boolean;
-  isUsed(): boolean;
-  isUsedHere(): boolean;
-  getBusy(): DeviceBusyStatus | undefined;
-  isUsedElsewhere(): boolean;
-  getUniquePath(): DeviceUniquePath;
-  hasUnexpectedMode(allow: string[]): "ui-device_bootloader_mode" | "ui-device_not_initialized" | "ui-device_seedless" | null;
-  private getStatus;
-  private getDeviceThp;
-  toMessageObject(): DeviceTyped;
-}