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

package/lib/device/DeviceCurrentSession.d.ts

@@ -0,0 +1,750 @@
+import { MessagesSchema as Messages } from '@trezor/protobuf';
+import { type MessageResponse, type Session, type Transport } from '@trezor/transport-common';
+import { type Logger } from '@trezor/utils';
+import type { IDevice } from "../types/idevice.js";
+import type { TypedCallProvider } from "../types/typed-call-provider.js";
+type AbortableOptions = {
+  timeout?: number;
+  signal?: AbortSignal;
+};
+export type { TypedCallProvider } from "../types/typed-call-provider.js";
+export declare class DeviceCurrentSession implements TypedCallProvider {
+  private readonly device;
+  private readonly transport;
+  private readonly session;
+  private readonly logger;
+  private disposed?;
+  private callPromise?;
+  private abortController?;
+  constructor(device: IDevice, transport: Transport, session: Session, logger: Logger);
+  isDisposed(): boolean;
+  typedCall(type: Messages.WireInMessage, expectedType: Messages.WireOutMessage | Messages.WireOutMessage[], msg?: Messages.MessagePayload<Messages.WireInMessage>): Promise<{
+    type: "Success";
+    message: {
+      message: string;
+    };
+  } | {
+    type: "PublicKey";
+    message: {
+      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;
+      };
+    };
+  } | {
+    type: "Address";
+    message: {
+      mac?: string | undefined;
+      address: string;
+    };
+  } | {
+    type: "OwnershipId";
+    message: {
+      ownership_id: string;
+    };
+  } | {
+    type: "MessageSignature";
+    message: {
+      address: string;
+      signature: string;
+    };
+  } | {
+    type: "TxRequest";
+    message: {
+      request_type?: "TXINPUT" | "TXOUTPUT" | "TXMETA" | "TXFINISHED" | "TXEXTRADATA" | "TXORIGINPUT" | "TXORIGOUTPUT" | "TXPAYMENTREQ" | undefined;
+      details?: {
+        extra_data_len?: number | undefined;
+        tx_hash?: string | undefined;
+        request_index?: number | undefined;
+        extra_data_offset?: number | undefined;
+      } | undefined;
+      serialized?: {
+        signature?: string | undefined;
+        serialized_tx?: string | undefined;
+        signature_index?: number | undefined;
+      } | undefined;
+    };
+  } | {
+    type: "OwnershipProof";
+    message: {
+      ownership_proof: string;
+      signature: string;
+    };
+  } | {
+    type: "FirmwareRequest";
+    message: {
+      length: number;
+      offset: number;
+    };
+  } | {
+    type: "CardanoNativeScriptHash";
+    message: {
+      script_hash: string;
+    };
+  } | {
+    type: "CardanoAddress";
+    message: {
+      mac?: string | undefined;
+      address: string;
+    };
+  } | {
+    type: "CardanoPublicKey";
+    message: {
+      xpub: string;
+      node: {
+        private_key?: string | undefined;
+        fingerprint: number;
+        depth: number;
+        child_num: number;
+        chain_code: string;
+        public_key: string;
+      };
+    };
+  } | {
+    type: "CardanoTxItemAck";
+    message: {};
+  } | {
+    type: "CardanoTxAuxiliaryDataSupplement";
+    message: {
+      auxiliary_data_hash?: string | undefined;
+      cvote_registration_signature?: string | undefined;
+      type: Messages.CardanoTxAuxiliaryDataSupplementType;
+    };
+  } | {
+    type: "CardanoTxWitnessResponse";
+    message: {
+      chain_code?: string | undefined;
+      type: Messages.CardanoTxWitnessType;
+      signature: string;
+      pub_key: string;
+    };
+  } | {
+    type: "CardanoTxBodyHash";
+    message: {
+      tx_hash: string;
+    };
+  } | {
+    type: "CardanoSignTxFinished";
+    message: {};
+  } | {
+    type: "CardanoMessageDataRequest";
+    message: {
+      length: number;
+      offset: number;
+    };
+  } | {
+    type: "CardanoMessageSignature";
+    message: {
+      address: string;
+      signature: string;
+      pub_key: string;
+    };
+  } | {
+    type: "CipheredKeyValue";
+    message: {
+      value: string;
+    };
+  } | {
+    type: "SignedIdentity";
+    message: {
+      public_key: string;
+      address: string;
+      signature: string;
+    };
+  } | {
+    type: "ECDHSessionKey";
+    message: {
+      public_key?: string | undefined;
+      session_key: string;
+    };
+  } | {
+    type: "Features";
+    message: {
+      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: Messages.DeviceModelInternal;
+    };
+  } | {
+    type: "DataChunkRequest";
+    message: {
+      data_length: number;
+      data_offset: number;
+    };
+  } | {
+    type: "Entropy";
+    message: {
+      entropy: string;
+    };
+  } | {
+    type: "FirmwareHash";
+    message: {
+      hash: string;
+    };
+  } | {
+    type: "AuthenticityProof";
+    message: {
+      tropic_signature?: string | undefined;
+      mcu_signature?: string | undefined;
+      optiga_certificates: string[];
+      optiga_signature: string;
+      tropic_certificates: string[];
+      mcu_certificates: string[];
+    };
+  } | {
+    type: "AuthenticityProofSizes";
+    message: {
+      tropic_signature?: number | undefined;
+      mcu_signature?: number | undefined;
+      optiga_certificates: number[];
+      optiga_signature: number;
+      tropic_certificates: number[];
+      mcu_certificates: number[];
+    };
+  } | {
+    type: "AuthenticityProofChunk";
+    message: {
+      chunk: string;
+    };
+  } | {
+    type: "EntropyRequest";
+    message: {
+      entropy_commitment?: string | undefined;
+      prev_entropy?: string | undefined;
+    };
+  } | {
+    type: "EntropyCheckReady";
+    message: {};
+  } | {
+    type: "NextU2FCounter";
+    message: {
+      u2f_counter: number;
+    };
+  } | {
+    type: "PreauthorizedRequest";
+    message: {};
+  } | {
+    type: "Nonce";
+    message: {
+      nonce: string;
+    };
+  } | {
+    type: "UnlockedPathRequest";
+    message: {
+      mac: string;
+    };
+  } | {
+    type: "SerialNumber";
+    message: {
+      serial_number: string;
+    };
+  } | {
+    type: "EosPublicKey";
+    message: {
+      wif_public_key: string;
+      raw_public_key: string;
+    };
+  } | {
+    type: "EosTxActionRequest";
+    message: {
+      data_size?: number | undefined;
+    };
+  } | {
+    type: "EosSignedTx";
+    message: {
+      signature: string;
+    };
+  } | {
+    type: "EthereumPublicKey";
+    message: {
+      xpub: string;
+      node: {
+        private_key?: string | undefined;
+        fingerprint: number;
+        depth: number;
+        child_num: number;
+        chain_code: string;
+        public_key: string;
+      };
+    };
+  } | {
+    type: "EthereumAddress";
+    message: {
+      mac?: string | undefined;
+      _old_address?: string | undefined;
+      address: string;
+    };
+  } | {
+    type: "EthereumTxRequest";
+    message: {
+      data_length?: number | undefined;
+      signature_v?: number | undefined;
+      signature_r?: string | undefined;
+      signature_s?: string | undefined;
+    };
+  } | {
+    type: "EthereumDefinitionRequest";
+    message: {
+      func_sig?: string | undefined;
+      chain_id: number;
+      token_address: string;
+    };
+  } | {
+    type: "EthereumMessageSignature";
+    message: {
+      address: string;
+      signature: string;
+    };
+  } | {
+    type: "EthereumTypedDataSignature";
+    message: {
+      address: string;
+      signature: string;
+    };
+  } | {
+    type: "EthereumAuth7702Signature";
+    message: {
+      signature_v: number;
+      signature_r: string;
+      signature_s: string;
+    };
+  } | {
+    type: "EthereumTypedDataStructRequest";
+    message: {
+      name: string;
+    };
+  } | {
+    type: "EthereumTypedDataValueRequest";
+    message: {
+      member_path: number[];
+    };
+  } | {
+    type: "EvoluNode";
+    message: {
+      data: string;
+    };
+  } | {
+    type: "EvoluRegistrationRequest";
+    message: {
+      rotation_index?: number | undefined;
+      signature: string;
+      certificate_chain: string[];
+    };
+  } | {
+    type: "EvoluDelegatedIdentityKey";
+    message: {
+      rotation_index?: number | undefined;
+      private_key: string;
+    };
+  } | {
+    type: "EvoluIndexManagementResponse";
+    message: {
+      rotation_index?: number | undefined;
+    };
+  } | {
+    type: "MoneroAddress";
+    message: {
+      address: string;
+    };
+  } | {
+    type: "MoneroWatchKey";
+    message: {
+      address: string;
+      watch_key: string;
+    };
+  } | {
+    type: "MoneroTransactionInitAck";
+    message: {
+      rsig_data?: {
+        mask?: string | undefined;
+        rsig_type?: number | undefined;
+        offload_type?: number | undefined;
+        rsig?: string | undefined;
+        bp_version?: number | undefined;
+        grouping: number[];
+        rsig_parts: string[];
+      } | undefined;
+      hmacs: string[];
+    };
+  } | {
+    type: "MoneroTransactionSetInputAck";
+    message: {
+      vini: string;
+      vini_hmac: string;
+      pseudo_out: string;
+      pseudo_out_hmac: string;
+      pseudo_out_alpha: string;
+      spend_key: string;
+    };
+  } | {
+    type: "MoneroTransactionInputViniAck";
+    message: {};
+  } | {
+    type: "MoneroTransactionAllInputsSetAck";
+    message: {
+      rsig_data?: {
+        mask?: string | undefined;
+        rsig_type?: number | undefined;
+        offload_type?: number | undefined;
+        rsig?: string | undefined;
+        bp_version?: number | undefined;
+        grouping: number[];
+        rsig_parts: string[];
+      } | undefined;
+    };
+  } | {
+    type: "MoneroTransactionSetOutputAck";
+    message: {
+      rsig_data?: {
+        mask?: string | undefined;
+        rsig_type?: number | undefined;
+        offload_type?: number | undefined;
+        rsig?: string | undefined;
+        bp_version?: number | undefined;
+        grouping: number[];
+        rsig_parts: string[];
+      } | undefined;
+      tx_out?: string | undefined;
+      vouti_hmac?: string | undefined;
+      out_pk?: string | undefined;
+      ecdh_info?: string | undefined;
+    };
+  } | {
+    type: "MoneroTransactionAllOutSetAck";
+    message: {
+      extra?: string | undefined;
+      full_message_hash?: string | undefined;
+      tx_prefix_hash: string;
+      rv: {
+        message?: string | undefined;
+        txn_fee?: number | undefined;
+        rv_type?: number | undefined;
+      };
+    };
+  } | {
+    type: "MoneroTransactionSignInputAck";
+    message: {
+      signature?: string | undefined;
+      pseudo_out?: string | undefined;
+    };
+  } | {
+    type: "MoneroTransactionFinalAck";
+    message: {
+      tx_enc_keys?: string | undefined;
+      cout_key?: string | undefined;
+      salt?: string | undefined;
+      rand_mult?: string | undefined;
+      opening_key?: string | undefined;
+    };
+  } | {
+    type: "MoneroKeyImageExportInitAck";
+    message: {};
+  } | {
+    type: "MoneroKeyImageSyncStepAck";
+    message: {
+      kis: {
+        iv?: string | undefined;
+        blob?: string | undefined;
+      }[];
+    };
+  } | {
+    type: "MoneroKeyImageSyncFinalAck";
+    message: {
+      enc_key?: string | undefined;
+    };
+  } | {
+    type: "MoneroGetTxKeyAck";
+    message: {
+      salt?: string | undefined;
+      tx_keys?: string | undefined;
+      tx_derivations?: string | undefined;
+    };
+  } | {
+    type: "MoneroLiveRefreshStartAck";
+    message: {};
+  } | {
+    type: "MoneroLiveRefreshStepAck";
+    message: {
+      salt?: string | undefined;
+      key_image?: string | undefined;
+    };
+  } | {
+    type: "MoneroLiveRefreshFinalAck";
+    message: {};
+  } | {
+    type: "DebugMoneroDiagAck";
+    message: {
+      ins?: number | undefined;
+      p1?: number | undefined;
+      p2?: number | undefined;
+      data1?: string | undefined;
+      data2?: string | undefined;
+      pd: number[];
+    };
+  } | {
+    type: "NostrPubkey";
+    message: {
+      pubkey: string;
+    };
+  } | {
+    type: "NostrEventSignature";
+    message: {
+      signature: string;
+      id: string;
+      pubkey: string;
+    };
+  } | {
+    type: "RippleAddress";
+    message: {
+      mac?: string | undefined;
+      address: string;
+    };
+  } | {
+    type: "RippleSignedTx";
+    message: {
+      signature: string;
+      serialized_tx: string;
+    };
+  } | {
+    type: "SolanaPublicKey";
+    message: {
+      public_key: string;
+    };
+  } | {
+    type: "SolanaAddress";
+    message: {
+      mac?: string | undefined;
+      address: string;
+    };
+  } | {
+    type: "SolanaTxSignature";
+    message: {
+      signature: string;
+    };
+  } | {
+    type: "SolanaMessageSignature";
+    message: {
+      signed_data?: string | undefined;
+      signature: string;
+    };
+  } | {
+    type: "StellarAddress";
+    message: {
+      mac?: string | undefined;
+      address: string;
+    };
+  } | {
+    type: "StellarTxOpRequest";
+    message: {};
+  } | {
+    type: "StellarSignedTx";
+    message: {
+      public_key: string;
+      signature: string;
+    };
+  } | {
+    type: "StellarTxExtRequest";
+    message: {};
+  } | {
+    type: "Telemetry";
+    message: {
+      min_temp_c?: number | undefined;
+      max_temp_c?: number | undefined;
+      battery_errors?: number | undefined;
+      battery_cycles?: number | undefined;
+    };
+  } | {
+    type: "TezosAddress";
+    message: {
+      mac?: string | undefined;
+      address: string;
+    };
+  } | {
+    type: "TezosPublicKey";
+    message: {
+      public_key: string;
+    };
+  } | {
+    type: "TezosSignedTx";
+    message: {
+      signature: string;
+      sig_op_contents: string;
+      operation_hash: string;
+    };
+  } | {
+    type: "ThpPairingRequestApproved";
+    message: {};
+  } | {
+    type: "ThpPairingPreparationsFinished";
+    message: {};
+  } | {
+    type: "ThpCodeEntryCommitment";
+    message: {
+      commitment: string;
+    };
+  } | {
+    type: "ThpCodeEntryCpaceTrezor";
+    message: {
+      cpace_trezor_public_key: string;
+    };
+  } | {
+    type: "ThpCodeEntrySecret";
+    message: {
+      secret: string;
+    };
+  } | {
+    type: "ThpQrCodeSecret";
+    message: {
+      secret: string;
+    };
+  } | {
+    type: "ThpNfcTagTrezor";
+    message: {
+      tag: string;
+    };
+  } | {
+    type: "ThpCredentialResponse";
+    message: {
+      credential: string;
+      trezor_static_public_key: string;
+    };
+  } | {
+    type: "ThpEndResponse";
+    message: {};
+  } | {
+    type: "TronAddress";
+    message: {
+      mac?: string | undefined;
+      address: string;
+    };
+  } | {
+    type: "TronContractRequest";
+    message: {};
+  } | {
+    type: "TronSignature";
+    message: {
+      signature: string;
+    };
+  } | {
+    type: "ThpPairingRequestApproved";
+    message: import("@trezor/protocol/lib/protocol-thp").ThpPairingRequestApproved;
+  } | {
+    type: "ThpPairingPreparationsFinished";
+    message: import("@trezor/protocol/lib/protocol-thp").ThpPairingPreparationsFinished;
+  } | {
+    type: "ThpCodeEntryCommitment";
+    message: import("@trezor/protocol/lib/protocol-thp").ThpCodeEntryCommitment;
+  } | {
+    type: "ThpCodeEntryCpaceTrezor";
+    message: import("@trezor/protocol/lib/protocol-thp").ThpCodeEntryCpaceTrezor;
+  } | {
+    type: "ThpCodeEntrySecret";
+    message: import("@trezor/protocol/lib/protocol-thp").ThpCodeEntrySecret;
+  } | {
+    type: "ThpQrCodeSecret";
+    message: import("@trezor/protocol/lib/protocol-thp").ThpQrCodeSecret;
+  } | {
+    type: "ThpNfcTagTrezor";
+    message: import("@trezor/protocol/lib/protocol-thp").ThpNfcTagTrezor;
+  } | {
+    type: "ThpCredentialResponse";
+    message: import("@trezor/protocol/lib/protocol-thp").ThpCredentialResponse;
+  } | {
+    type: "ThpEndResponse";
+    message: import("@trezor/protocol/lib/protocol-thp").ThpEndResponse;
+  }>;
+  private callLoop;
+  call(name: string, data: Record<string, unknown>, options?: AbortableOptions): Promise<{
+    success: false;
+    error: Error;
+  } | {
+    success: true;
+    payload: MessageResponse;
+  }>;
+  send(name: string, data: Record<string, unknown>, options?: AbortableOptions): Promise<{
+    success: false;
+    error: Error;
+  } | {
+    success: true;
+    payload: undefined;
+  }>;
+  receive(options?: AbortableOptions): Promise<{
+    success: false;
+    error: Error;
+  } | {
+    success: true;
+    payload: MessageResponse;
+  }>;
+  cancelCall(): Promise<{
+    success: false;
+    error: Error;
+  } | {
+    success: true;
+    payload: MessageResponse;
+  }>;
+  abort(reason: Error): Promise<void>;
+}