@metamask-previews/eth-qr-keyring 1.0.0-065a890

package/dist/qr-keyring.mjs

@@ -0,0 +1,233 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _QrKeyring_instances, _QrKeyring_signer, _QrKeyring_accounts, _QrKeyring_accountToUnlock, _QrKeyring_currentPage, _QrKeyring_scanAndInitialize;
+import { add0x, getChecksumAddress } from "@metamask/utils";
+import { AirgappedSigner, KeyringMode } from "./airgapped-signer.mjs";
+export const QR_KEYRING_TYPE = 'QR Hardware Wallet Device';
+/**
+ * Returns the default serialized state of the QrKeyring.
+ *
+ * @returns The default serialized state.
+ */
+export const getDefaultSerializedQrKeyringState = () => ({
+    initialized: false,
+    accounts: [],
+});
+/**
+ * Normalizes an address to a 0x-prefixed checksum address.
+ *
+ * @param address - The address to normalize.
+ * @returns The normalized address as a Hex string.
+ */
+function normalizeAddress(address) {
+    return getChecksumAddress(add0x(address));
+}
+export class QrKeyring {
+    constructor(options) {
+        _QrKeyring_instances.add(this);
+        this.type = QR_KEYRING_TYPE;
+        _QrKeyring_signer.set(this, new AirgappedSigner());
+        _QrKeyring_accounts.set(this, []);
+        _QrKeyring_accountToUnlock.set(this, void 0);
+        _QrKeyring_currentPage.set(this, 0);
+        this.bridge = options.bridge;
+        if (options?.ur) {
+            this.submitUR(options.ur);
+        }
+    }
+    /**
+     * Serializes the QrKeyring state
+     *
+     * @returns The serialized state
+     */
+    async serialize() {
+        const source = __classPrivateFieldGet(this, _QrKeyring_signer, "f").getSourceDetails();
+        if (!source ||
+            ![KeyringMode.HD, KeyringMode.ACCOUNT].includes(source.keyringMode)) {
+            // the keyring has not initialized with a device source yet
+            return getDefaultSerializedQrKeyringState();
+        }
+        const accounts = __classPrivateFieldGet(this, _QrKeyring_accounts, "f").slice();
+        if (source.keyringMode === KeyringMode.HD) {
+            // These properties are only relevant for HD Keys
+            return {
+                initialized: true,
+                name: source.name,
+                keyringMode: KeyringMode.HD,
+                keyringAccount: source.keyringAccount,
+                xfp: source.xfp,
+                xpub: source.xpub,
+                hdPath: source.hdPath,
+                childrenPath: source.childrenPath,
+                accounts,
+                indexes: source.indexes,
+            };
+        }
+        // These properties are only relevant for Account Keys
+        return {
+            initialized: true,
+            name: source.name,
+            keyringMode: KeyringMode.ACCOUNT,
+            keyringAccount: source.keyringAccount,
+            xfp: source.xfp,
+            paths: source.paths,
+            accounts,
+            indexes: source.indexes,
+        };
+    }
+    /**
+     * Deserializes the QrKeyring state
+     *
+     * @param state - The serialized state to deserialize
+     */
+    async deserialize(state) {
+        if (!state.initialized) {
+            __classPrivateFieldSet(this, _QrKeyring_accounts, [], "f");
+            __classPrivateFieldGet(this, _QrKeyring_signer, "f").clear();
+            return;
+        }
+        __classPrivateFieldGet(this, _QrKeyring_signer, "f").init(state);
+        __classPrivateFieldSet(this, _QrKeyring_accounts, (state.accounts ?? []).map(normalizeAddress), "f");
+    }
+    /**
+     * Adds accounts to the QrKeyring
+     *
+     * @param accountsToAdd - The number of accounts to add
+     * @returns The accounts added
+     */
+    async addAccounts(accountsToAdd) {
+        const lastAccount = __classPrivateFieldGet(this, _QrKeyring_accounts, "f")[__classPrivateFieldGet(this, _QrKeyring_accounts, "f").length - 1];
+        const startIndex = __classPrivateFieldGet(this, _QrKeyring_accountToUnlock, "f") ??
+            (lastAccount ? __classPrivateFieldGet(this, _QrKeyring_signer, "f").indexFromAddress(lastAccount) : 0);
+        const newAccounts = [];
+        for (let i = 0; i < accountsToAdd; i++) {
+            const index = startIndex + i;
+            const address = __classPrivateFieldGet(this, _QrKeyring_signer, "f").addressFromIndex(index);
+            if (__classPrivateFieldGet(this, _QrKeyring_accounts, "f").includes(address)) {
+                continue;
+            }
+            __classPrivateFieldGet(this, _QrKeyring_accounts, "f").push(address);
+            newAccounts.push(address);
+        }
+        __classPrivateFieldSet(this, _QrKeyring_accountToUnlock, startIndex + accountsToAdd, "f");
+        return newAccounts;
+    }
+    /**
+     * Gets the accounts in the QrKeyring
+     *
+     * @returns The accounts in the QrKeyring
+     */
+    async getAccounts() {
+        return Array.from(__classPrivateFieldGet(this, _QrKeyring_accounts, "f").values());
+    }
+    /**
+     * Remove an account from the keyring
+     *
+     * @param address - The address of the account to remove
+     */
+    removeAccount(address) {
+        const normalizedAddress = normalizeAddress(address);
+        __classPrivateFieldSet(this, _QrKeyring_accounts, __classPrivateFieldGet(this, _QrKeyring_accounts, "f").filter((account) => account !== normalizedAddress), "f");
+    }
+    /**
+     * Submits a CBOR encoded UR to the QrKeyring
+     *
+     * @param ur - The CBOR encoded UR
+     */
+    submitUR(ur) {
+        __classPrivateFieldGet(this, _QrKeyring_signer, "f").init(ur);
+    }
+    /**
+     * Sets the next account index to unlock
+     *
+     * @param index - The index of the account to unlock
+     */
+    setAccountToUnlock(index) {
+        __classPrivateFieldSet(this, _QrKeyring_accountToUnlock, index, "f");
+    }
+    /**
+     * Get the name of the paired device or the keyring type
+     * if unavailable.
+     *
+     * @returns The name of the paired device or the keyring type.
+     */
+    getName() {
+        const source = __classPrivateFieldGet(this, _QrKeyring_signer, "f").getSourceDetails();
+        return source?.name ?? QR_KEYRING_TYPE;
+    }
+    /**
+     * Fetch the first page of accounts. If the keyring is not currently initialized,
+     * it will trigger a scan request to initialize it.
+     *
+     * @returns The first page of accounts as an array of Hex strings.
+     */
+    async getFirstPage() {
+        __classPrivateFieldSet(this, _QrKeyring_currentPage, 0, "f");
+        return this.getCurrentPage();
+    }
+    /**
+     * Fetch the next page of accounts. If the keyring is not currently initialized,
+     * it will trigger a scan request to initialize it.
+     *
+     * @returns The next page of accounts as an array of IndexedAddress objects.
+     */
+    async getNextPage() {
+        __classPrivateFieldSet(this, _QrKeyring_currentPage, __classPrivateFieldGet(this, _QrKeyring_currentPage, "f") + 1, "f");
+        return this.getCurrentPage();
+    }
+    /**
+     * Fetch the previous page of accounts. If the keyring is not currently initialized,
+     * it will trigger a scan request to initialize it.
+     *
+     * @returns The previous page of accounts as an array of IndexedAddress objects.
+     */
+    async getPreviousPage() {
+        if (__classPrivateFieldGet(this, _QrKeyring_currentPage, "f") > 0) {
+            __classPrivateFieldSet(this, _QrKeyring_currentPage, __classPrivateFieldGet(this, _QrKeyring_currentPage, "f") - 1, "f");
+        }
+        else {
+            __classPrivateFieldSet(this, _QrKeyring_currentPage, 0, "f");
+        }
+        return this.getCurrentPage();
+    }
+    /**
+     * Fetch the current page of accounts. If the keyring is not currently initialized,
+     * it will trigger a scan request to initialize it.
+     *
+     * @returns The current page of accounts as an array of IndexedAddress objects.
+     */
+    async getCurrentPage() {
+        if (!__classPrivateFieldGet(this, _QrKeyring_signer, "f").isInitialized()) {
+            await __classPrivateFieldGet(this, _QrKeyring_instances, "m", _QrKeyring_scanAndInitialize).call(this);
+        }
+        return __classPrivateFieldGet(this, _QrKeyring_signer, "f").getAddressesPage(__classPrivateFieldGet(this, _QrKeyring_currentPage, "f"));
+    }
+    /**
+     * Clear the keyring state and forget any paired device or accounts.
+     */
+    async forgetDevice() {
+        __classPrivateFieldGet(this, _QrKeyring_signer, "f").clear();
+        __classPrivateFieldSet(this, _QrKeyring_accounts, [], "f");
+        __classPrivateFieldSet(this, _QrKeyring_accountToUnlock, undefined, "f");
+        __classPrivateFieldSet(this, _QrKeyring_currentPage, 0, "f");
+    }
+}
+_QrKeyring_signer = new WeakMap(), _QrKeyring_accounts = new WeakMap(), _QrKeyring_accountToUnlock = new WeakMap(), _QrKeyring_currentPage = new WeakMap(), _QrKeyring_instances = new WeakSet(), _QrKeyring_scanAndInitialize = 
+/**
+ * Scan for a QR code and initialize the keyring with the
+ * scanned UR.
+ */
+async function _QrKeyring_scanAndInitialize() {
+    this.submitUR(await this.bridge.requestScan());
+};
+QrKeyring.type = QR_KEYRING_TYPE;
+//# sourceMappingURL=qr-keyring.mjs.map

package/dist/qr-keyring.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-keyring.mjs","sourceRoot":"","sources":["../src/qr-keyring.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Keyring } from '@metamask/keyring-utils';\nimport type { Hex } from '@metamask/utils';\nimport { add0x, getChecksumAddress } from '@metamask/utils';\n\nimport {\n  type AirgappedSignerDetails,\n  type IndexedAddress,\n  AirgappedSigner,\n  KeyringMode,\n} from './airgapped-signer';\n\nexport const QR_KEYRING_TYPE = 'QR Hardware Wallet Device';\n\nexport type QrKeyringBridge = {\n  requestScan: () => Promise<string>;\n};\n\nexport type QrKeyringOptions = {\n  ur?: string;\n  bridge: QrKeyringBridge;\n};\n\n/**\n * The state of the QrKeyring\n *\n * @property accounts - The accounts in the QrKeyring\n */\nexport type SerializedQrKeyringState = {\n  version?: number;\n  accounts?: string[];\n  currentAccount?: number;\n} & (\n  | {\n      initialized?: false;\n    }\n  | ({\n      initialized: true;\n    } & AirgappedSignerDetails)\n);\n\n/**\n * Returns the default serialized state of the QrKeyring.\n *\n * @returns The default serialized state.\n */\nexport const getDefaultSerializedQrKeyringState =\n  (): SerializedQrKeyringState => ({\n    initialized: false,\n    accounts: [],\n  });\n\n/**\n * Normalizes an address to a 0x-prefixed checksum address.\n *\n * @param address - The address to normalize.\n * @returns The normalized address as a Hex string.\n */\nfunction normalizeAddress(address: string): Hex {\n  return getChecksumAddress(add0x(address));\n}\n\nexport class QrKeyring implements Keyring {\n  static type = QR_KEYRING_TYPE;\n\n  readonly type = QR_KEYRING_TYPE;\n\n  readonly bridge: QrKeyringBridge;\n\n  readonly #signer: AirgappedSigner = new AirgappedSigner();\n\n  #accounts: Hex[] = [];\n\n  #accountToUnlock?: number | undefined;\n\n  #currentPage: number = 0;\n\n  constructor(options: QrKeyringOptions) {\n    this.bridge = options.bridge;\n\n    if (options?.ur) {\n      this.submitUR(options.ur);\n    }\n  }\n\n  /**\n   * Serializes the QrKeyring state\n   *\n   * @returns The serialized state\n   */\n  async serialize(): Promise<SerializedQrKeyringState> {\n    const source = this.#signer.getSourceDetails();\n\n    if (\n      !source ||\n      ![KeyringMode.HD, KeyringMode.ACCOUNT].includes(source.keyringMode)\n    ) {\n      // the keyring has not initialized with a device source yet\n      return getDefaultSerializedQrKeyringState();\n    }\n\n    const accounts = this.#accounts.slice();\n\n    if (source.keyringMode === KeyringMode.HD) {\n      // These properties are only relevant for HD Keys\n      return {\n        initialized: true,\n        name: source.name,\n        keyringMode: KeyringMode.HD,\n        keyringAccount: source.keyringAccount,\n        xfp: source.xfp,\n        xpub: source.xpub,\n        hdPath: source.hdPath,\n        childrenPath: source.childrenPath,\n        accounts,\n        indexes: source.indexes,\n      };\n    }\n    // These properties are only relevant for Account Keys\n    return {\n      initialized: true,\n      name: source.name,\n      keyringMode: KeyringMode.ACCOUNT,\n      keyringAccount: source.keyringAccount,\n      xfp: source.xfp,\n      paths: source.paths,\n      accounts,\n      indexes: source.indexes,\n    };\n  }\n\n  /**\n   * Deserializes the QrKeyring state\n   *\n   * @param state - The serialized state to deserialize\n   */\n  async deserialize(state: SerializedQrKeyringState): Promise<void> {\n    if (!state.initialized) {\n      this.#accounts = [];\n      this.#signer.clear();\n      return;\n    }\n\n    this.#signer.init(state);\n    this.#accounts = (state.accounts ?? []).map(normalizeAddress);\n  }\n\n  /**\n   * Adds accounts to the QrKeyring\n   *\n   * @param accountsToAdd - The number of accounts to add\n   * @returns The accounts added\n   */\n  async addAccounts(accountsToAdd: number): Promise<Hex[]> {\n    const lastAccount = this.#accounts[this.#accounts.length - 1];\n    const startIndex =\n      this.#accountToUnlock ??\n      (lastAccount ? this.#signer.indexFromAddress(lastAccount) : 0);\n    const newAccounts: Hex[] = [];\n\n    for (let i = 0; i < accountsToAdd; i++) {\n      const index = startIndex + i;\n      const address = this.#signer.addressFromIndex(index);\n\n      if (this.#accounts.includes(address)) {\n        continue;\n      }\n\n      this.#accounts.push(address);\n      newAccounts.push(address);\n    }\n\n    this.#accountToUnlock = startIndex + accountsToAdd;\n    return newAccounts;\n  }\n\n  /**\n   * Gets the accounts in the QrKeyring\n   *\n   * @returns The accounts in the QrKeyring\n   */\n  async getAccounts(): Promise<Hex[]> {\n    return Array.from(this.#accounts.values());\n  }\n\n  /**\n   * Remove an account from the keyring\n   *\n   * @param address - The address of the account to remove\n   */\n  removeAccount(address: Hex): void {\n    const normalizedAddress = normalizeAddress(address);\n    this.#accounts = this.#accounts.filter(\n      (account) => account !== normalizedAddress,\n    );\n  }\n\n  /**\n   * Submits a CBOR encoded UR to the QrKeyring\n   *\n   * @param ur - The CBOR encoded UR\n   */\n  submitUR(ur: string): void {\n    this.#signer.init(ur);\n  }\n\n  /**\n   * Sets the next account index to unlock\n   *\n   * @param index - The index of the account to unlock\n   */\n  setAccountToUnlock(index: number): void {\n    this.#accountToUnlock = index;\n  }\n\n  /**\n   * Get the name of the paired device or the keyring type\n   * if unavailable.\n   *\n   * @returns The name of the paired device or the keyring type.\n   */\n  getName(): string {\n    const source = this.#signer.getSourceDetails();\n    return source?.name ?? QR_KEYRING_TYPE;\n  }\n\n  /**\n   * Fetch the first page of accounts. If the keyring is not currently initialized,\n   * it will trigger a scan request to initialize it.\n   *\n   * @returns The first page of accounts as an array of Hex strings.\n   */\n  async getFirstPage(): Promise<IndexedAddress[]> {\n    this.#currentPage = 0;\n    return this.getCurrentPage();\n  }\n\n  /**\n   * Fetch the next page of accounts. If the keyring is not currently initialized,\n   * it will trigger a scan request to initialize it.\n   *\n   * @returns The next page of accounts as an array of IndexedAddress objects.\n   */\n  async getNextPage(): Promise<IndexedAddress[]> {\n    this.#currentPage += 1;\n    return this.getCurrentPage();\n  }\n\n  /**\n   * Fetch the previous page of accounts. If the keyring is not currently initialized,\n   * it will trigger a scan request to initialize it.\n   *\n   * @returns The previous page of accounts as an array of IndexedAddress objects.\n   */\n  async getPreviousPage(): Promise<IndexedAddress[]> {\n    if (this.#currentPage > 0) {\n      this.#currentPage -= 1;\n    } else {\n      this.#currentPage = 0;\n    }\n    return this.getCurrentPage();\n  }\n\n  /**\n   * Fetch the current page of accounts. If the keyring is not currently initialized,\n   * it will trigger a scan request to initialize it.\n   *\n   * @returns The current page of accounts as an array of IndexedAddress objects.\n   */\n  async getCurrentPage(): Promise<IndexedAddress[]> {\n    if (!this.#signer.isInitialized()) {\n      await this.#scanAndInitialize();\n    }\n\n    return this.#signer.getAddressesPage(this.#currentPage);\n  }\n\n  /**\n   * Clear the keyring state and forget any paired device or accounts.\n   */\n  async forgetDevice(): Promise<void> {\n    this.#signer.clear();\n    this.#accounts = [];\n    this.#accountToUnlock = undefined;\n    this.#currentPage = 0;\n  }\n\n  /**\n   * Scan for a QR code and initialize the keyring with the\n   * scanned UR.\n   */\n  async #scanAndInitialize(): Promise<void> {\n    this.submitUR(await this.bridge.requestScan());\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@metamask-previews/eth-qr-keyring",
+  "version": "1.0.0-065a890",
+  "description": "A simple standard interface for a series of Ethereum private keys.",
+  "keywords": [
+    "ethereum",
+    "keyring",
+    "qr",
+    "metamask"
+  ],
+  "homepage": "https://github.com/MetaMask/accounts/packages/keyring-eth-qr#readme",
+  "bugs": {
+    "url": "https://github.com/MetaMask/accounts/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MetaMask/accounts.git"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.cts",
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc --build tsconfig.build.json",
+    "build:clean": "rimraf dist && yarn build",
+    "build:docs": "typedoc",
+    "build:force": "tsc --build tsconfig.build.json --force",
+    "changelog:update": "../../scripts/update-changelog.sh @metamask/eth-simple-keyring",
+    "changelog:validate": "../../scripts/validate-changelog.sh @metamask/eth-simple-keyring",
+    "publish:preview": "yarn npm publish --tag preview",
+    "sample": "ts-node src/sample.ts",
+    "test": "jest",
+    "test:clean": "jest --clearCache",
+    "test:verbose": "jest --verbose",
+    "test:watch": "jest --watch"
+  },
+  "dependencies": {
+    "@ethereumjs/util": "^9.1.0",
+    "@keystonehq/bc-ur-registry-eth": "^0.19.1",
+    "@keystonehq/ur-decoder": "^0.12.2",
+    "@metamask/keyring-utils": "3.0.0",
+    "@metamask/utils": "^11.3.0",
+    "@ngraveio/bc-ur": "^1.1.13",
+    "hdkey": "^2.1.0"
+  },
+  "devDependencies": {
+    "@keystonehq/base-eth-keyring": "^0.15.1",
+    "@keystonehq/metamask-airgapped-keyring": "^0.15.2",
+    "@lavamoat/allow-scripts": "^3.2.1",
+    "@metamask/auto-changelog": "^3.4.4",
+    "@types/hdkey": "^2.0.1",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.12.12",
+    "deepmerge": "^4.2.2",
+    "depcheck": "^1.4.7",
+    "jest": "^29.5.0",
+    "ts-jest": "^29.0.5",
+    "ts-node": "^10.9.2",
+    "typedoc": "^0.25.13",
+    "typescript": "~4.8.4"
+  },
+  "engines": {
+    "node": "^18.18 || >=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "lavamoat": {
+    "allowScripts": {
+      "keccak": true,
+      "secp256k1": true,
+      "@lavamoat/preinstall-always-fail": false,
+      "ethereumjs-tx>ethereumjs-util>ethereum-cryptography>keccak": false,
+      "ethereumjs-tx>ethereumjs-util>ethereum-cryptography>secp256k1": false,
+      "@keystonehq/ur-decoder>@keystonehq/bc-ur-registry-eth>ethereumjs-util>ethereum-cryptography>keccak": false,
+      "@lavamoat/allow-scripts>@lavamoat/preinstall-always-fail": false,
+      "hdkey>secp256k1": false
+    }
+  }
+}