@pezkuwi/hw-ledger 14.0.12 → 14.0.14

package/build-deno/LedgerGeneric.ts

@@ -1,271 +0,0 @@
-import { Buffer } from 'node:buffer';
-
-
-import type { TransportDef, TransportType } from 'https://deno.land/x/pezkuwi/hw-ledger-transports/types.ts';
-import type { AccountOptionsGeneric, LedgerAddress, LedgerSignature, LedgerVersion } from './types.ts';
-
-import { PolkadotGenericApp } from 'https://esm.sh/@zondax/ledger-substrate@1.1.1';
-
-import { transports } from 'https://deno.land/x/pezkuwi/hw-ledger-transports/mod.ts';
-import { hexAddPrefix, u8aToBuffer, u8aWrapBytes } from 'https://deno.land/x/pezkuwi/util/mod.ts';
-
-import { ledgerApps } from './defaults.ts';
-
-export { packageInfo } from './packageInfo.ts';
-
-type Chain = keyof typeof ledgerApps;
-
-type WrappedResult = Awaited<ReturnType<PolkadotGenericApp['getAddress' | 'getVersion' | 'sign' | 'signWithMetadata']>>;
-
-interface ResponseError {
-  errorMessage: string
-  returnCode: number
-}
-
-/** @internal Wraps a PolkadotGenericApp call, checking the result for any errors which result in a rejection */
-async function wrapError <T extends WrappedResult> (promise: Promise<T>): Promise<T> {
-  let result: T;
-
-  try {
-    result = await promise;
-  } catch (e: unknown) {
-    // We check to see if the propogated error is the newer ResponseError type.
-    // The response code use to be part of the result, but with the latest breaking changes from 0.42.x
-    // the interface and it's types have completely changed.
-    if ((e as ResponseError).returnCode) {
-      throw new Error(`${(e as ResponseError).returnCode}: ${(e as ResponseError).errorMessage}`);
-    }
-
-    throw new Error((e as Error).message);
-  }
-
-  return result;
-}
-
-/** @internal Wraps a signEd25519/signRawEd25519 call and returns the associated signature */
-function sign (method: 'signEd25519' | 'signRawEd25519', message: Uint8Array, slip44: number, accountIndex = 0, addressOffset = 0): (app: PolkadotGenericApp) => Promise<LedgerSignature> {
-  const bip42Path = `m/44'/${slip44}'/${accountIndex}'/${0}'/${addressOffset}'`;
-
-  return async (app: PolkadotGenericApp): Promise<LedgerSignature> => {
-    const { signature } = await wrapError(app[method](bip42Path, u8aToBuffer(message)));
-
-    return {
-      signature: hexAddPrefix(signature.toString('hex'))
-    };
-  };
-}
-
-/** @internal Wraps a signEcdsa/signRawEcdsa call and returns the associated signature */
-function signEcdsa (method: 'signEcdsa' | 'signRawEcdsa', message: Uint8Array, slip44: number, accountIndex = 0, addressOffset = 0): (app: PolkadotGenericApp) => Promise<LedgerSignature> {
-  const bip42Path = `m/44'/${slip44}'/${accountIndex}'/${0}'/${addressOffset}'`;
-
-  return async (app: PolkadotGenericApp): Promise<LedgerSignature> => {
-    const { r, s, v } = await wrapError(app[method](bip42Path, u8aToBuffer(message)));
-
-    const signature = Buffer.concat([r, s, v]);
-
-    return {
-      signature: hexAddPrefix(signature.toString('hex'))
-    };
-  };
-}
-
-/** @internal Wraps a signWithMetadataEd25519 call and returns the associated signature */
-function signWithMetadata (message: Uint8Array, slip44: number, accountIndex = 0, addressOffset = 0, { metadata }: Partial<AccountOptionsGeneric> = {}): (app: PolkadotGenericApp) => Promise<LedgerSignature> {
-  const bip42Path = `m/44'/${slip44}'/${accountIndex}'/${0}'/${addressOffset}'`;
-
-  return async (app: PolkadotGenericApp): Promise<LedgerSignature> => {
-    if (!metadata) {
-      throw new Error('The metadata option must be present when using signWithMetadata');
-    }
-
-    const bufferMsg = Buffer.from(message);
-
-    const { signature } = await wrapError(app.signWithMetadataEd25519(bip42Path, bufferMsg, metadata));
-
-    return {
-      signature: hexAddPrefix(signature.toString('hex'))
-    };
-  };
-}
-
-/** @internal Wraps a signWithMetadataEcdsa call and returns the associated signature */
-function signWithMetadataEcdsa (message: Uint8Array, slip44: number, accountIndex = 0, addressOffset = 0, { metadata }: Partial<AccountOptionsGeneric> = {}): (app: PolkadotGenericApp) => Promise<LedgerSignature> {
-  const bip42Path = `m/44'/${slip44}'/${accountIndex}'/${0}'/${addressOffset}'`;
-
-  return async (app: PolkadotGenericApp): Promise<LedgerSignature> => {
-    if (!metadata) {
-      throw new Error('The metadata option must be present when using signWithMetadata');
-    }
-
-    const bufferMsg = Buffer.from(message);
-
-    const { r, s, v } = await wrapError(app.signWithMetadataEcdsa(bip42Path, bufferMsg, metadata));
-
-    const signature = Buffer.concat([r, s, v]);
-
-    return {
-      signature: hexAddPrefix(signature.toString('hex'))
-    };
-  };
-}
-
-/**
- * @name Ledger
- *
- * @description
- * A very basic wrapper for a ledger app -
- *   - it connects automatically on use, creating an underlying interface as required
- *   - Promises reject with errors (unwrapped errors from @zondax/ledger-substrate-js)
- */
-export class LedgerGeneric {
-  readonly #transportDef: TransportDef;
-  readonly #slip44: number;
-  /**
-   * The chainId is represented by the chains token in all lowercase. Example: Polkadot -> dot
-   */
-  readonly #chainId?: string;
-  /**
-   * The metaUrl is seen as a server url that the underlying `PolkadotGenericApp` will use to
-   * retrieve the signature given a tx blob, and a chainId. It is important to note that if you would like to avoid
-   * having any network calls made, use `signWithMetadata`, and avoid `sign`.
-   */
-  readonly #metaUrl?: string;
-
-  #app: PolkadotGenericApp | null = null;
-
-  constructor (transport: TransportType, chain: Chain, slip44: number, chainId?: string, metaUrl?: string) {
-    const ledgerName = ledgerApps[chain];
-    const transportDef = transports.find(({ type }) => type === transport);
-
-    if (!ledgerName) {
-      throw new Error(`Unsupported Ledger chain ${chain}`);
-    } else if (!transportDef) {
-      throw new Error(`Unsupported Ledger transport ${transport}`);
-    }
-
-    this.#metaUrl = metaUrl;
-    this.#chainId = chainId;
-    this.#slip44 = slip44;
-    this.#transportDef = transportDef;
-  }
-
-  /**
-   * @description Returns the address associated with a specific Ed25519 account & address offset. Optionally
-   * asks for on-device confirmation
-   */
-  public async getAddress (ss58Prefix: number, confirm = false, accountIndex = 0, addressOffset = 0): Promise<LedgerAddress> {
-    const bip42Path = `m/44'/${this.#slip44}'/${accountIndex}'/${0}'/${addressOffset}'`;
-
-    return this.withApp(async (app: PolkadotGenericApp): Promise<LedgerAddress> => {
-      const { address, pubKey } = await wrapError(app.getAddressEd25519(bip42Path, ss58Prefix, confirm));
-
-      return {
-        address,
-        publicKey: hexAddPrefix(pubKey)
-      };
-    });
-  }
-
-  /**
-   * @description Returns the address associated with a specific ecdsa account & address offset. Optionally
-   * asks for on-device confirmation
-   */
-  public async getAddressEcdsa (confirm = false, accountIndex = 0, addressOffset = 0) {
-    const bip42Path = `m/44'/${this.#slip44}'/${accountIndex}'/${0}'/${addressOffset}'`;
-
-    return this.withApp(async (app: PolkadotGenericApp): Promise<LedgerAddress> => {
-      const { address, pubKey } = await wrapError(app.getAddressEcdsa(bip42Path, confirm));
-
-      return {
-        address,
-        publicKey: hexAddPrefix(pubKey)
-      };
-    });
-  }
-
-  /**
-   * @description Returns the version of the Ledger application on the device
-   */
-  public async getVersion (): Promise<LedgerVersion> {
-    return this.withApp(async (app: PolkadotGenericApp): Promise<LedgerVersion> => {
-      const { deviceLocked: isLocked, major, minor, patch, testMode: isTestMode } = await wrapError(app.getVersion());
-
-      return {
-        isLocked: !!isLocked,
-        isTestMode: !!isTestMode,
-        version: [major || 0, minor || 0, patch || 0]
-      };
-    });
-  }
-
-  /**
-   * @description Signs a transaction on the Ledger device. This requires the LedgerGeneric class to be instantiated with `chainId`, and `metaUrl`
-   */
-  public async sign (message: Uint8Array, accountIndex?: number, addressOffset?: number): Promise<LedgerSignature> {
-    return this.withApp(sign('signEd25519', message, this.#slip44, accountIndex, addressOffset));
-  }
-
-  /**
-   * @description Signs a message (non-transactional) on the Ledger device
-   */
-  public async signRaw (message: Uint8Array, accountIndex?: number, addressOffset?: number): Promise<LedgerSignature> {
-    return this.withApp(sign('signRawEd25519', u8aWrapBytes(message), this.#slip44, accountIndex, addressOffset));
-  }
-
-  /**
-   * @description Signs a transaction on the Ledger device with Ecdsa. This requires the LedgerGeneric class to be instantiated with `chainId`, and `metaUrl`
-   */
-  public async signEcdsa (message: Uint8Array, accountIndex?: number, addressOffset?: number): Promise<LedgerSignature> {
-    return this.withApp(signEcdsa('signEcdsa', u8aWrapBytes(message), this.#slip44, accountIndex, addressOffset));
-  }
-
-  /**
-   * @description Signs a message with Ecdsa (non-transactional) on the Ledger device
-   */
-  public async signRawEcdsa (message: Uint8Array, accountIndex?: number, addressOffset?: number): Promise<LedgerSignature> {
-    return this.withApp(signEcdsa('signRawEcdsa', u8aWrapBytes(message), this.#slip44, accountIndex, addressOffset));
-  }
-
-  /**
-   * @description Signs a transaction on the ledger device provided some metadata.
-   */
-  public async signWithMetadata (message: Uint8Array, accountIndex?: number, addressOffset?: number, options?: Partial<AccountOptionsGeneric>): Promise<LedgerSignature> {
-    return this.withApp(signWithMetadata(message, this.#slip44, accountIndex, addressOffset, options));
-  }
-
-  /**
-   * @description Signs a transaction on the ledger device for an ecdsa signature provided some metadata.
-   */
-  public async signWithMetadataEcdsa (message: Uint8Array, accountIndex?: number, addressOffset?: number, options?: Partial<AccountOptionsGeneric>) {
-    return this.withApp(signWithMetadataEcdsa(message, this.#slip44, accountIndex, addressOffset, options));
-  }
-
-  /**
-   * @internal
-   *
-   * Returns a created PolkadotGenericApp to perform operations against. Generally
-   * this is only used internally, to ensure consistent bahavior.
-   */
-  async withApp <T> (fn: (app: PolkadotGenericApp) => Promise<T>): Promise<T> {
-    try {
-      if (!this.#app) {
-        const transport = await this.#transportDef.create();
-
-        // We need this override for the actual type passing - the Deno environment
-        // is quite a bit stricter and it yields invalids between the two (specifically
-        // since we mangle the imports from .default in the types for CJS/ESM and between
-        // esm.sh versions this yields problematic outputs)
-        //
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any
-        this.#app = new PolkadotGenericApp(transport as any, this.#chainId, this.#metaUrl);
-      }
-
-      return await fn(this.#app);
-    } catch (error) {
-      this.#app = null;
-
-      throw error;
-    }
-  }
-}

package/build-deno/README.md

@@ -1,2 +0,0 @@
-# @pezkuwi/hw-ledger
-

package/build-deno/bundle.ts

@@ -1,3 +0,0 @@
-
-export { Ledger } from './Ledger.ts';
-export { LedgerGeneric } from './LedgerGeneric.ts';

package/build-deno/constants.ts

@@ -1,8 +0,0 @@
-
-export const LEDGER_DEFAULT_ACCOUNT = 0x80000000;
-
-export const LEDGER_DEFAULT_CHANGE = 0x80000000;
-
-export const LEDGER_DEFAULT_INDEX = 0x80000000;
-
-export const LEDGER_SUCCESS_CODE = 0x9000;

package/build-deno/defaults.ts

@@ -1,61 +0,0 @@
-
-export const prevLedgerRecord: Record<string, string> = {
-  acala: 'Acala',
-  ajuna: 'Ajuna',
-  'aleph-node': 'AlephZero',
-  astar: 'Astar',
-  bifrost: 'Bifrost',
-  'bifrost-kusama': 'BifrostKusama',
-  centrifuge: 'Centrifuge',
-  composable: 'Composable',
-  darwinia: 'Darwinia',
-  'dock-mainnet': 'Dock',
-  edgeware: 'Edgeware',
-  enjin: 'Enjin',
-  equilibrium: 'Equilibrium',
-  genshiro: 'Genshiro',
-  hydradx: 'HydraDX',
-  'interlay-parachain': 'Interlay',
-  karura: 'Karura',
-  khala: 'Khala',
-  kusama: 'Kusama',
-  matrixchain: 'Matrixchain',
-  nodle: 'Nodle',
-  origintrail: 'OriginTrail',
-  parallel: 'Parallel',
-  peaq: 'Peaq',
-  pendulum: 'Pendulum',
-  phala: 'Phala',
-  picasso: 'Picasso',
-  polkadex: 'Polkadex',
-  polkadot: 'Polkadot',
-  polymesh: 'Polymesh',
-  quartz: 'Quartz',
-  sora: 'Sora',
-  stafi: 'Stafi',
-  statemine: 'Statemine',
-  statemint: 'Statemint',
-  ternoa: 'Ternoa',
-  unique: 'Unique',
-  vtb: 'VTB',
-  xxnetwork: 'XXNetwork',
-  zeitgeist: 'Zeitgeist'
-};
-
-export const genericLedgerApps = {
-  bittensor: 'Bittensor',
-  creditcoin3: 'Creditcoin3',
-  dentnet: 'DENTNet',
-  encointer: 'Encointer',
-  frequency: 'Frequency',
-  integritee: 'Integritee',
-  liberland: 'Liberland',
-  mythos: 'Mythos',
-  polimec: 'Polimec',
-  vara: 'Vara'
-};
-
-export const ledgerApps: Record<string, string> = {
-  ...prevLedgerRecord,
-  ...genericLedgerApps
-};

package/build-deno/index.ts

@@ -1,4 +0,0 @@
-
-import './packageDetect.ts';
-
-export * from './bundle.ts';

package/build-deno/mod.ts

@@ -1,2 +0,0 @@
-
-export * from './index.ts';

package/build-deno/packageDetect.ts

@@ -1,9 +0,0 @@
-
-
-import { packageInfo as transportInfo } from 'https://deno.land/x/pezkuwi/hw-ledger-transports/packageInfo.ts';
-import { detectPackage } from 'https://deno.land/x/pezkuwi/util/mod.ts';
-import { packageInfo as utilInfo } from 'https://deno.land/x/pezkuwi/util/packageInfo.ts';
-
-import { packageInfo } from './packageInfo.ts';
-
-detectPackage(packageInfo, null, [transportInfo, utilInfo]);

package/build-deno/packageInfo.ts

@@ -1,3 +0,0 @@
-
-
-export const packageInfo = { name: '@pezkuwi/hw-ledger', path: new URL(import.meta.url).pathname, type: 'deno', version: '14.0.12' };

package/build-deno/types.ts

@@ -1,42 +0,0 @@
-import { Buffer } from 'node:buffer';
-
-
-import type { HexString } from 'https://deno.land/x/pezkuwi/util/types.ts';
-
-/**
- * Legacy Type that works with the `Ledger` class.
- */
-export interface AccountOptions {
-  /** The index of the account */
-  account: number;
-  /** The index of the address */
-  addressIndex: number;
-  /** The change to apply */
-  change: number;
-}
-
-export interface AccountOptionsGeneric extends AccountOptions {
-  /** Option for PolkadotGenericApp.signWithMetadata */
-  metadata: Buffer;
-}
-
-export interface LedgerAddress {
-  /** The ss58 encoded address */
-  address: string;
-  /** The hex-encoded publicKey */
-  publicKey: HexString;
-}
-
-export interface LedgerSignature {
-  /** A hex-encoded signature, as generated by the device */
-  signature: HexString;
-}
-
-export interface LedgerVersion {
-  /** Indicator flag for locked status */
-  isLocked: boolean;
-  /** Indicator flag for testmode status */
-  isTestMode: boolean;
-  /** The software version for this device */
-  version: [major: number, minor: number, patch: number];
-}

package/build-tsc/Ledger.d.ts

@@ -1,43 +0,0 @@
-import type { SubstrateApp } from '@zondax/ledger-substrate';
-import type { TransportType } from '@pezkuwi/hw-ledger-transports/types';
-import type { AccountOptions, LedgerAddress, LedgerSignature, LedgerVersion } from './types.js';
-import { ledgerApps } from './defaults.js';
-export { packageInfo } from './packageInfo.js';
-type Chain = keyof typeof ledgerApps;
-/**
- * @name Ledger
- *
- * @description
- * Legacy wrapper for a ledger app -
- *   - it connects automatically on use, creating an underlying interface as required
- *   - Promises reject with errors (unwrapped errors from @zondax/ledger-substrate)
- * @deprecated Use LedgerGeneric for up to date integration with ledger
- */
-export declare class Ledger {
-    #private;
-    constructor(transport: TransportType, chain: Chain);
-    /**
-     * Returns the address associated with a specific account & address offset. Optionally
-     * asks for on-device confirmation
-     */
-    getAddress(confirm?: boolean, accountOffset?: number, addressOffset?: number, { account, addressIndex, change }?: Partial<AccountOptions>): Promise<LedgerAddress>;
-    /**
-     * Returns the version of the Ledger application on the device
-     */
-    getVersion(): Promise<LedgerVersion>;
-    /**
-     * Signs a transaction on the Ledger device
-     */
-    sign(message: Uint8Array, accountOffset?: number, addressOffset?: number, options?: Partial<AccountOptions>): Promise<LedgerSignature>;
-    /**
-     * Signs a message (non-transactional) on the Ledger device
-     */
-    signRaw(message: Uint8Array, accountOffset?: number, addressOffset?: number, options?: Partial<AccountOptions>): Promise<LedgerSignature>;
-    /**
-     * @internal
-     *
-     * Returns a created SubstrateApp to perform operations against. Generally
-     * this is only used internally, to ensure consistent bahavior.
-     */
-    withApp<T>(fn: (app: SubstrateApp) => Promise<T>): Promise<T>;
-}

package/build-tsc/LedgerGeneric.d.ts

@@ -1,63 +0,0 @@
-import type { TransportType } from '@pezkuwi/hw-ledger-transports/types';
-import type { AccountOptionsGeneric, LedgerAddress, LedgerSignature, LedgerVersion } from './types.js';
-import { PolkadotGenericApp } from '@zondax/ledger-substrate';
-import { ledgerApps } from './defaults.js';
-export { packageInfo } from './packageInfo.js';
-type Chain = keyof typeof ledgerApps;
-/**
- * @name Ledger
- *
- * @description
- * A very basic wrapper for a ledger app -
- *   - it connects automatically on use, creating an underlying interface as required
- *   - Promises reject with errors (unwrapped errors from @zondax/ledger-substrate-js)
- */
-export declare class LedgerGeneric {
-    #private;
-    constructor(transport: TransportType, chain: Chain, slip44: number, chainId?: string, metaUrl?: string);
-    /**
-     * @description Returns the address associated with a specific Ed25519 account & address offset. Optionally
-     * asks for on-device confirmation
-     */
-    getAddress(ss58Prefix: number, confirm?: boolean, accountIndex?: number, addressOffset?: number): Promise<LedgerAddress>;
-    /**
-     * @description Returns the address associated with a specific ecdsa account & address offset. Optionally
-     * asks for on-device confirmation
-     */
-    getAddressEcdsa(confirm?: boolean, accountIndex?: number, addressOffset?: number): Promise<LedgerAddress>;
-    /**
-     * @description Returns the version of the Ledger application on the device
-     */
-    getVersion(): Promise<LedgerVersion>;
-    /**
-     * @description Signs a transaction on the Ledger device. This requires the LedgerGeneric class to be instantiated with `chainId`, and `metaUrl`
-     */
-    sign(message: Uint8Array, accountIndex?: number, addressOffset?: number): Promise<LedgerSignature>;
-    /**
-     * @description Signs a message (non-transactional) on the Ledger device
-     */
-    signRaw(message: Uint8Array, accountIndex?: number, addressOffset?: number): Promise<LedgerSignature>;
-    /**
-     * @description Signs a transaction on the Ledger device with Ecdsa. This requires the LedgerGeneric class to be instantiated with `chainId`, and `metaUrl`
-     */
-    signEcdsa(message: Uint8Array, accountIndex?: number, addressOffset?: number): Promise<LedgerSignature>;
-    /**
-     * @description Signs a message with Ecdsa (non-transactional) on the Ledger device
-     */
-    signRawEcdsa(message: Uint8Array, accountIndex?: number, addressOffset?: number): Promise<LedgerSignature>;
-    /**
-     * @description Signs a transaction on the ledger device provided some metadata.
-     */
-    signWithMetadata(message: Uint8Array, accountIndex?: number, addressOffset?: number, options?: Partial<AccountOptionsGeneric>): Promise<LedgerSignature>;
-    /**
-     * @description Signs a transaction on the ledger device for an ecdsa signature provided some metadata.
-     */
-    signWithMetadataEcdsa(message: Uint8Array, accountIndex?: number, addressOffset?: number, options?: Partial<AccountOptionsGeneric>): Promise<LedgerSignature>;
-    /**
-     * @internal
-     *
-     * Returns a created PolkadotGenericApp to perform operations against. Generally
-     * this is only used internally, to ensure consistent bahavior.
-     */
-    withApp<T>(fn: (app: PolkadotGenericApp) => Promise<T>): Promise<T>;
-}

package/build-tsc/bundle.d.ts

@@ -1,2 +0,0 @@
-export { Ledger } from './Ledger.js';
-export { LedgerGeneric } from './LedgerGeneric.js';

package/build-tsc/constants.d.ts

@@ -1,4 +0,0 @@
-export declare const LEDGER_DEFAULT_ACCOUNT = 2147483648;
-export declare const LEDGER_DEFAULT_CHANGE = 2147483648;
-export declare const LEDGER_DEFAULT_INDEX = 2147483648;
-export declare const LEDGER_SUCCESS_CODE = 36864;

package/build-tsc/defaults.d.ts

@@ -1,14 +0,0 @@
-export declare const prevLedgerRecord: Record<string, string>;
-export declare const genericLedgerApps: {
-    bittensor: string;
-    creditcoin3: string;
-    dentnet: string;
-    encointer: string;
-    frequency: string;
-    integritee: string;
-    liberland: string;
-    mythos: string;
-    polimec: string;
-    vara: string;
-};
-export declare const ledgerApps: Record<string, string>;

package/build-tsc/index.d.ts

@@ -1,2 +0,0 @@
-import './packageDetect.js';
-export * from './bundle.js';

package/build-tsc/packageDetect.d.ts

@@ -1 +0,0 @@
-export {};

package/build-tsc/packageInfo.d.ts

@@ -1,6 +0,0 @@
-export declare const packageInfo: {
-    name: string;
-    path: string;
-    type: string;
-    version: string;
-};

package/build-tsc/types.d.ts

@@ -1,34 +0,0 @@
-import type { HexString } from '@pezkuwi/util/types';
-/**
- * Legacy Type that works with the `Ledger` class.
- */
-export interface AccountOptions {
-    /** The index of the account */
-    account: number;
-    /** The index of the address */
-    addressIndex: number;
-    /** The change to apply */
-    change: number;
-}
-export interface AccountOptionsGeneric extends AccountOptions {
-    /** Option for PolkadotGenericApp.signWithMetadata */
-    metadata: Buffer;
-}
-export interface LedgerAddress {
-    /** The ss58 encoded address */
-    address: string;
-    /** The hex-encoded publicKey */
-    publicKey: HexString;
-}
-export interface LedgerSignature {
-    /** A hex-encoded signature, as generated by the device */
-    signature: HexString;
-}
-export interface LedgerVersion {
-    /** Indicator flag for locked status */
-    isLocked: boolean;
-    /** Indicator flag for testmode status */
-    isTestMode: boolean;
-    /** The software version for this device */
-    version: [major: number, minor: number, patch: number];
-}