@metamask-previews/keyring-api 21.3.0-8508712 → 21.3.0-ca5bb42

package/dist/api/v2/wrapper/keyring-wrapper.mjs

@@ -0,0 +1,112 @@
+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 _KeyringWrapper_lock;
+import { Mutex } from "async-mutex";
+import { KeyringAccountRegistry } from "./keyring-account-registry.mjs";
+/**
+ * Generic adapter that turns an existing {@link Keyring} implementation into a
+ * {@link KeyringV2} instance.
+ *
+ * Consumers are expected to provide concrete mappings between high-level V2
+ * operations and the underlying keyring methods (for example BIP-44 account
+ * creation, private-key import, and request handling). This class focuses on
+ * the common mechanics required by all adapters: state serialization,
+ * account-ID/address mapping and basic account management.
+ */
+export class KeyringWrapper {
+    constructor(options) {
+        /**
+         * Mutex to ensure exclusive access to the inner keyring during
+         * operations that mutate its state.
+         */
+        _KeyringWrapper_lock.set(this, new Mutex());
+        /**
+         * Registry for KeyringAccount objects.
+         * Provides O(1) lookups by AccountId or address.
+         *
+         * Subclasses should use this registry when creating accounts and
+         * clear/update it when deleting accounts or deserializing state.
+         */
+        this.registry = new KeyringAccountRegistry();
+        this.inner = options.inner;
+        this.type = `${options.type}`;
+        this.capabilities = options.capabilities;
+    }
+    /**
+     * Execute an operation with exclusive access to the inner keyring.
+     *
+     * This method ensures thread-safety for operations that read or mutate
+     * the inner keyring state. All operations that modify the keyring
+     * (createAccounts, deleteAccount, deserialize) should use this method
+     * to prevent race conditions.
+     *
+     * Within the callback, use `this.inner` to access the inner keyring.
+     *
+     * @param callback - A function that performs the operation.
+     * @returns The result of the callback.
+     */
+    async withLock(callback) {
+        return __classPrivateFieldGet(this, _KeyringWrapper_lock, "f").runExclusive(callback);
+    }
+    /**
+     * Serialize the underlying keyring state to a JSON-serializable object.
+     *
+     * This simply delegates to the legacy keyring's {@link Keyring.serialize}
+     * implementation.
+     *
+     * @returns The serialized keyring state.
+     */
+    async serialize() {
+        return this.inner.serialize();
+    }
+    /**
+     * Hydrate the underlying keyring from a previously serialized state.
+     *
+     * This clears the registry, delegates to the legacy keyring's
+     * {@link Keyring.deserialize} implementation, and rebuilds the registry
+     * by calling {@link getAccounts}.
+     *
+     * @param state - The serialized keyring state.
+     */
+    async deserialize(state) {
+        await this.withLock(async () => {
+            // Clear the registry when deserializing
+            this.registry.clear();
+            // Deserialize the legacy keyring
+            await this.inner.deserialize(state);
+            // Rebuild the registry by calling getAccounts().
+            // Subclass implementations of getAccounts() should populate the registry
+            // as a side effect (see the abstract method's documentation).
+            await this.getAccounts();
+        });
+    }
+    /**
+     * Look up a single account by its {@link AccountId}.
+     *
+     * This method first checks the registry for O(1) lookup.
+     * If not found, it falls back to calling {@link getAccounts} which
+     * should populate the registry as a side effect.
+     *
+     * @param accountId - The AccountId to look up.
+     * @returns The matching KeyringAccount.
+     */
+    async getAccount(accountId) {
+        let cached = this.registry.get(accountId);
+        if (cached) {
+            return cached;
+        }
+        // Prime the registry by calling getAccounts
+        await this.getAccounts();
+        // Try registry again after priming
+        cached = this.registry.get(accountId);
+        if (!cached) {
+            throw new Error(`Account not found for id: ${accountId}`);
+        }
+        return cached;
+    }
+}
+_KeyringWrapper_lock = new WeakMap();
+//# sourceMappingURL=keyring-wrapper.mjs.map

package/dist/api/v2/wrapper/keyring-wrapper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyring-wrapper.mjs","sourceRoot":"","sources":["../../../../src/api/v2/wrapper/keyring-wrapper.ts"],"names":[],"mappings":";;;;;;AAEA,OAAO,EAAE,KAAK,EAAE,oBAAoB;AAEpC,OAAO,EAAE,sBAAsB,EAAE,uCAAmC;AAgCpE;;;;;;;;;GASG;AACH,MAAM,OAAgB,cAAc;IA2BlC,YAAY,OAA4C;QAhBxD;;;WAGG;QACM,+BAAQ,IAAI,KAAK,EAAE,EAAC;QAE7B;;;;;;WAMG;QACgB,aAAQ,GACzB,IAAI,sBAAsB,EAAsB,CAAC;QAGjD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;;;OAYG;IACO,KAAK,CAAC,QAAQ,CACtB,QAA+B;QAE/B,OAAO,uBAAA,IAAI,4BAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IAChC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW,CAAC,KAAW;QAC3B,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC7B,wCAAwC;YACxC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YAEtB,iCAAiC;YACjC,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAEpC,iDAAiD;YACjD,yEAAyE;YACzE,8DAA8D;YAC9D,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAgBD;;;;;;;;;OASG;IACH,KAAK,CAAC,UAAU,CAAC,SAAoB;QACnC,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,4CAA4C;QAC5C,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzB,mCAAmC;QACnC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,6BAA6B,SAAS,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CA+CF","sourcesContent":["import type { Keyring, AccountId } from '@metamask/keyring-utils';\nimport type { Json } from '@metamask/utils';\nimport { Mutex } from 'async-mutex';\n\nimport { KeyringAccountRegistry } from './keyring-account-registry';\nimport type {\n  CreateAccountOptions,\n  ExportAccountOptions,\n  ExportedAccount,\n} from '..';\nimport type { KeyringAccount } from '../../account';\nimport type { KeyringRequest } from '../../request';\nimport type { KeyringV2 } from '../keyring';\nimport type { KeyringCapabilities } from '../keyring-capabilities';\nimport type { KeyringType } from '../keyring-type';\n\n/**\n * Basic options for constructing a {@link KeyringWrapper}.\n */\nexport type KeyringWrapperOptions<InnerKeyring extends Keyring> = {\n  /**\n   * The underlying \"old\" keyring instance that this wrapper adapts.\n   */\n  inner: InnerKeyring;\n\n  /**\n   * The concrete keyring type exposed through the V2 interface.\n   */\n  type: KeyringType;\n\n  /**\n   * Capabilities of the underlying keyring.\n   */\n  capabilities: KeyringCapabilities;\n};\n\n/**\n * Generic adapter that turns an existing {@link Keyring} implementation into a\n * {@link KeyringV2} instance.\n *\n * Consumers are expected to provide concrete mappings between high-level V2\n * operations and the underlying keyring methods (for example BIP-44 account\n * creation, private-key import, and request handling). This class focuses on\n * the common mechanics required by all adapters: state serialization,\n * account-ID/address mapping and basic account management.\n */\nexport abstract class KeyringWrapper<\n  InnerKeyring extends Keyring,\n  KeyringAccountType extends KeyringAccount = KeyringAccount,\n> implements KeyringV2\n{\n  readonly type: `${KeyringType}`;\n\n  readonly capabilities: KeyringCapabilities;\n\n  protected readonly inner: InnerKeyring;\n\n  /**\n   * Mutex to ensure exclusive access to the inner keyring during\n   * operations that mutate its state.\n   */\n  readonly #lock = new Mutex();\n\n  /**\n   * Registry for KeyringAccount objects.\n   * Provides O(1) lookups by AccountId or address.\n   *\n   * Subclasses should use this registry when creating accounts and\n   * clear/update it when deleting accounts or deserializing state.\n   */\n  protected readonly registry =\n    new KeyringAccountRegistry<KeyringAccountType>();\n\n  constructor(options: KeyringWrapperOptions<InnerKeyring>) {\n    this.inner = options.inner;\n    this.type = `${options.type}`;\n    this.capabilities = options.capabilities;\n  }\n\n  /**\n   * Execute an operation with exclusive access to the inner keyring.\n   *\n   * This method ensures thread-safety for operations that read or mutate\n   * the inner keyring state. All operations that modify the keyring\n   * (createAccounts, deleteAccount, deserialize) should use this method\n   * to prevent race conditions.\n   *\n   * Within the callback, use `this.inner` to access the inner keyring.\n   *\n   * @param callback - A function that performs the operation.\n   * @returns The result of the callback.\n   */\n  protected async withLock<Result>(\n    callback: () => Promise<Result>,\n  ): Promise<Result> {\n    return this.#lock.runExclusive(callback);\n  }\n\n  /**\n   * Serialize the underlying keyring state to a JSON-serializable object.\n   *\n   * This simply delegates to the legacy keyring's {@link Keyring.serialize}\n   * implementation.\n   *\n   * @returns The serialized keyring state.\n   */\n  async serialize(): Promise<Json> {\n    return this.inner.serialize();\n  }\n\n  /**\n   * Hydrate the underlying keyring from a previously serialized state.\n   *\n   * This clears the registry, delegates to the legacy keyring's\n   * {@link Keyring.deserialize} implementation, and rebuilds the registry\n   * by calling {@link getAccounts}.\n   *\n   * @param state - The serialized keyring state.\n   */\n  async deserialize(state: Json): Promise<void> {\n    await this.withLock(async () => {\n      // Clear the registry when deserializing\n      this.registry.clear();\n\n      // Deserialize the legacy keyring\n      await this.inner.deserialize(state);\n\n      // Rebuild the registry by calling getAccounts().\n      // Subclass implementations of getAccounts() should populate the registry\n      // as a side effect (see the abstract method's documentation).\n      await this.getAccounts();\n    });\n  }\n\n  /**\n   * Return all accounts managed by this keyring.\n   *\n   * Concrete adapters are responsible for mapping the underlying keyring's\n   * notion of accounts (typically addresses returned by\n   * {@link Keyring.getAccounts}) into {@link KeyringAccount} objects.\n   * Implementations should use the configured {@link KeyringAccountRegistry}\n   * to establish the account ID/address mapping so that\n   * {@link getAccount} works as expected.\n   *\n   * @returns The list of managed accounts.\n   */\n  abstract getAccounts(): Promise<KeyringAccount[]>;\n\n  /**\n   * Look up a single account by its {@link AccountId}.\n   *\n   * This method first checks the registry for O(1) lookup.\n   * If not found, it falls back to calling {@link getAccounts} which\n   * should populate the registry as a side effect.\n   *\n   * @param accountId - The AccountId to look up.\n   * @returns The matching KeyringAccount.\n   */\n  async getAccount(accountId: AccountId): Promise<KeyringAccount> {\n    let cached = this.registry.get(accountId);\n    if (cached) {\n      return cached;\n    }\n\n    // Prime the registry by calling getAccounts\n    await this.getAccounts();\n\n    // Try registry again after priming\n    cached = this.registry.get(accountId);\n    if (!cached) {\n      throw new Error(`Account not found for id: ${accountId}`);\n    }\n\n    return cached;\n  }\n\n  /**\n   * Create one or more new accounts managed by this keyring.\n   *\n   * Implementations are responsible for interpreting the\n   * {@link CreateAccountOptions} (for example BIP-44 derivation or\n   * private-key import) and returning the resulting {@link KeyringAccount}\n   * objects. Implementors should also ensure that the registry is updated so\n   * that {@link getAccount} works for newly created accounts.\n   */\n  abstract createAccounts(\n    options: CreateAccountOptions,\n  ): Promise<KeyringAccount[]>;\n\n  /**\n   * Remove the account associated with the given {@link AccountId} from this\n   * keyring.\n   *\n   * Implementations are expected to translate the ID to an underlying\n   * address (typically via the registry) and then invoke the appropriate\n   * removal mechanism on the legacy keyring.\n   */\n  abstract deleteAccount(accountId: AccountId): Promise<void>;\n\n  /**\n   * Export the secrets associated with the given account in a format\n   * described by {@link ExportAccountOptions}.\n   *\n   * This method is optional, and concrete adapters should only\n   * implement it if the underlying keyring supports exporting\n   * accounts.\n   */\n  exportAccount?(\n    accountId: AccountId,\n    options?: ExportAccountOptions,\n  ): Promise<ExportedAccount>;\n\n  /**\n   * Handle a high-level {@link KeyringRequest} on behalf of this keyring.\n   *\n   * Concrete adapters are responsible for routing the request's method and\n   * parameters to the appropriate legacy keyring APIs (for example signing\n   * transactions or decrypting messages) and returning a JSON-serializable\n   * result.\n   */\n  abstract submitRequest(request: KeyringRequest): Promise<Json>;\n}\n"]}

package/dist/eth/erc4337/types.d.cts

@@ -6,7 +6,7 @@ import { type Infer } from "@metamask/superstruct";
  */
 export declare const EthUserOperationStruct: import("@metamask/superstruct").Struct<{
     nonce: string;
-    sender: string;
+    sender: `0x${string}`;
     initCode: string;
     callData: string;
     callGasLimit: string;
@@ -17,7 +17,7 @@ export declare const EthUserOperationStruct: import("@metamask/superstruct").Str
     paymasterAndData: string;
     signature: string;
 }, {
-    sender: import("@metamask/superstruct").Struct<string, null>;
+    sender: import("@metamask/superstruct").Struct<`0x${string}`, null>;
     nonce: import("@metamask/superstruct").Struct<string, null>;
     initCode: import("@metamask/superstruct").Struct<string, null>;
     callData: import("@metamask/superstruct").Struct<string, null>;
@@ -37,12 +37,12 @@ export type EthUserOperation = Infer<typeof EthUserOperationStruct>;
 export declare const EthBaseTransactionStruct: import("@metamask/superstruct").Struct<{
     value: string;
     data: string;
-    to: string;
+    to: `0x${string}`;
 }, {
     /**
      * Address of the transaction recipient.
      */
-    to: import("@metamask/superstruct").Struct<string, null>;
+    to: import("@metamask/superstruct").Struct<`0x${string}`, null>;
     /**
      * Amount of wei to transfer to the recipient.
      */

package/dist/eth/erc4337/types.d.mts

@@ -6,7 +6,7 @@ import { type Infer } from "@metamask/superstruct";
  */
 export declare const EthUserOperationStruct: import("@metamask/superstruct").Struct<{
     nonce: string;
-    sender: string;
+    sender: `0x${string}`;
     initCode: string;
     callData: string;
     callGasLimit: string;
@@ -17,7 +17,7 @@ export declare const EthUserOperationStruct: import("@metamask/superstruct").Str
     paymasterAndData: string;
     signature: string;
 }, {
-    sender: import("@metamask/superstruct").Struct<string, null>;
+    sender: import("@metamask/superstruct").Struct<`0x${string}`, null>;
     nonce: import("@metamask/superstruct").Struct<string, null>;
     initCode: import("@metamask/superstruct").Struct<string, null>;
     callData: import("@metamask/superstruct").Struct<string, null>;
@@ -37,12 +37,12 @@ export type EthUserOperation = Infer<typeof EthUserOperationStruct>;
 export declare const EthBaseTransactionStruct: import("@metamask/superstruct").Struct<{
     value: string;
     data: string;
-    to: string;
+    to: `0x${string}`;
 }, {
     /**
      * Address of the transaction recipient.
      */
-    to: import("@metamask/superstruct").Struct<string, null>;
+    to: import("@metamask/superstruct").Struct<`0x${string}`, null>;
     /**
      * Amount of wei to transfer to the recipient.
      */

package/dist/eth/index.cjs

@@ -16,6 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./constants.cjs"), exports);
 __exportStar(require("./erc4337/index.cjs"), exports);
+__exportStar(require("./rpc/index.cjs"), exports);
 __exportStar(require("./types.cjs"), exports);
 __exportStar(require("./utils.cjs"), exports);
+__exportStar(require("./v2/index.cjs"), exports);
 //# sourceMappingURL=index.cjs.map

package/dist/eth/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAA4B;AAC5B,sDAA0B;AAC1B,8CAAwB;AACxB,8CAAwB","sourcesContent":["export * from './constants';\nexport * from './erc4337';\nexport * from './types';\nexport * from './utils';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAA4B;AAC5B,sDAA0B;AAC1B,kDAAsB;AACtB,8CAAwB;AACxB,8CAAwB;AACxB,iDAAqB","sourcesContent":["export * from './constants';\nexport * from './erc4337';\nexport * from './rpc';\nexport * from './types';\nexport * from './utils';\nexport * from './v2';\n"]}

package/dist/eth/index.d.cts

@@ -1,5 +1,7 @@
 export * from "./constants.cjs";
 export * from "./erc4337/index.cjs";
+export * from "./rpc/index.cjs";
 export * from "./types.cjs";
 export * from "./utils.cjs";
+export * from "./v2/index.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/eth/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":"AAAA,gCAA4B;AAC5B,oCAA0B;AAC1B,4BAAwB;AACxB,4BAAwB"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":"AAAA,gCAA4B;AAC5B,oCAA0B;AAC1B,gCAAsB;AACtB,4BAAwB;AACxB,4BAAwB;AACxB,+BAAqB"}

package/dist/eth/index.d.mts

@@ -1,5 +1,7 @@
 export * from "./constants.mjs";
 export * from "./erc4337/index.mjs";
+export * from "./rpc/index.mjs";
 export * from "./types.mjs";
 export * from "./utils.mjs";
+export * from "./v2/index.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/eth/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":"AAAA,gCAA4B;AAC5B,oCAA0B;AAC1B,4BAAwB;AACxB,4BAAwB"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":"AAAA,gCAA4B;AAC5B,oCAA0B;AAC1B,gCAAsB;AACtB,4BAAwB;AACxB,4BAAwB;AACxB,+BAAqB"}

package/dist/eth/index.mjs

@@ -1,5 +1,7 @@
 export * from "./constants.mjs";
 export * from "./erc4337/index.mjs";
+export * from "./rpc/index.mjs";
 export * from "./types.mjs";
 export * from "./utils.mjs";
+export * from "./v2/index.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/eth/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":"AAAA,gCAA4B;AAC5B,oCAA0B;AAC1B,4BAAwB;AACxB,4BAAwB","sourcesContent":["export * from './constants';\nexport * from './erc4337';\nexport * from './types';\nexport * from './utils';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":"AAAA,gCAA4B;AAC5B,oCAA0B;AAC1B,gCAAsB;AACtB,4BAAwB;AACxB,4BAAwB;AACxB,+BAAqB","sourcesContent":["export * from './constants';\nexport * from './erc4337';\nexport * from './rpc';\nexport * from './types';\nexport * from './utils';\nexport * from './v2';\n"]}

package/dist/eth/rpc/index.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./params.cjs"), exports);
+//# sourceMappingURL=index.cjs.map

package/dist/eth/rpc/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/eth/rpc/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAAyB","sourcesContent":["export * from './params';\n"]}

package/dist/eth/rpc/index.d.cts

@@ -0,0 +1,2 @@
+export * from "./params.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/eth/rpc/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/eth/rpc/index.ts"],"names":[],"mappings":"AAAA,6BAAyB"}

package/dist/eth/rpc/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./params.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/eth/rpc/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/eth/rpc/index.ts"],"names":[],"mappings":"AAAA,6BAAyB"}

package/dist/eth/rpc/index.mjs

@@ -0,0 +1,2 @@
+export * from "./params.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/eth/rpc/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/eth/rpc/index.ts"],"names":[],"mappings":"AAAA,6BAAyB","sourcesContent":["export * from './params';\n"]}

package/dist/eth/rpc/params.cjs

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * Superstruct validation schemas for Ethereum JSON-RPC method parameters.
+ *
+ * These structs provide runtime validation for the parameters passed to various
+ * Ethereum RPC methods. They can be used by keyring implementations to validate
+ * incoming requests before processing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EthGetEncryptionPublicKeyParamsStruct = exports.EthSignEip7702AuthorizationParamsStruct = exports.EthGetAppKeyAddressParamsStruct = exports.EthDecryptParamsStruct = exports.EthSignTypedDataParamsStruct = exports.EthSignTypedDataV1ParamsStruct = exports.EthPersonalSignParamsStruct = exports.EthSignParamsStruct = exports.EthSignTransactionParamsStruct = exports.EthGetEncryptionPublicKeyOptionsStruct = exports.EthEip7702AuthorizationStruct = exports.EthEncryptedDataStruct = exports.EthTypedMessageStruct = exports.EthTypedDataTypesStruct = exports.EthTypedDataV1Struct = exports.EthTransactionDataStruct = void 0;
+const keyring_utils_1 = require("@metamask/keyring-utils");
+const superstruct_1 = require("@metamask/superstruct");
+const types_1 = require("../types.cjs");
+/**
+ * A struct for validating Ethereum transaction data.
+ *
+ * This uses `type()` instead of `object()` to allow extra properties,
+ * since transaction formats can vary and include additional fields.
+ * The actual transaction validation is performed by the transaction library.
+ */
+exports.EthTransactionDataStruct = (0, superstruct_1.type)({
+    to: (0, superstruct_1.optional)((0, superstruct_1.nullable)(types_1.EthAddressStruct)),
+    from: (0, superstruct_1.optional)(types_1.EthAddressStruct),
+    nonce: (0, superstruct_1.optional)((0, superstruct_1.union)([(0, superstruct_1.string)(), (0, superstruct_1.number)()])),
+    value: (0, superstruct_1.optional)((0, superstruct_1.union)([(0, superstruct_1.string)(), (0, superstruct_1.number)()])),
+    data: (0, superstruct_1.optional)(types_1.EthBytesStruct),
+    gas: (0, superstruct_1.optional)((0, superstruct_1.union)([(0, superstruct_1.string)(), (0, superstruct_1.number)()])),
+    gasLimit: (0, superstruct_1.optional)((0, superstruct_1.union)([(0, superstruct_1.string)(), (0, superstruct_1.number)()])),
+    gasPrice: (0, superstruct_1.optional)((0, superstruct_1.union)([(0, superstruct_1.string)(), (0, superstruct_1.number)()])),
+    maxFeePerGas: (0, superstruct_1.optional)((0, superstruct_1.union)([(0, superstruct_1.string)(), (0, superstruct_1.number)()])),
+    maxPriorityFeePerGas: (0, superstruct_1.optional)((0, superstruct_1.union)([(0, superstruct_1.string)(), (0, superstruct_1.number)()])),
+    accessList: (0, superstruct_1.optional)((0, superstruct_1.array)((0, superstruct_1.type)({
+        address: types_1.EthAddressStruct,
+        storageKeys: (0, superstruct_1.array)((0, superstruct_1.string)()),
+    }))),
+    type: (0, superstruct_1.optional)((0, superstruct_1.union)([(0, superstruct_1.string)(), (0, superstruct_1.number)()])),
+    chainId: (0, superstruct_1.optional)((0, superstruct_1.union)([(0, superstruct_1.string)(), (0, superstruct_1.number)()])),
+});
+/**
+ * A struct for TypedDataV1 format (legacy typed data).
+ * This is an array of { type, name, value } objects.
+ */
+exports.EthTypedDataV1Struct = (0, superstruct_1.array)((0, keyring_utils_1.object)({
+    type: (0, superstruct_1.string)(),
+    name: (0, superstruct_1.string)(),
+    value: (0, superstruct_1.unknown)(),
+}));
+/**
+ * A struct for TypedData types definition.
+ * Maps type names to arrays of { name, type } definitions.
+ */
+exports.EthTypedDataTypesStruct = (0, superstruct_1.record)((0, superstruct_1.string)(), (0, superstruct_1.array)((0, keyring_utils_1.object)({
+    name: (0, superstruct_1.string)(),
+    type: (0, superstruct_1.string)(),
+})));
+/**
+ * A struct for TypedMessage format (EIP-712 V3/V4).
+ * Contains types, domain, primaryType, and message.
+ */
+exports.EthTypedMessageStruct = (0, keyring_utils_1.object)({
+    types: exports.EthTypedDataTypesStruct,
+    primaryType: (0, superstruct_1.string)(),
+    domain: (0, superstruct_1.record)((0, superstruct_1.string)(), (0, superstruct_1.any)()),
+    message: (0, superstruct_1.record)((0, superstruct_1.string)(), (0, superstruct_1.any)()),
+});
+/**
+ * A struct for EIP-1024 encrypted data format (x25519-xsalsa20-poly1305).
+ */
+exports.EthEncryptedDataStruct = (0, keyring_utils_1.object)({
+    version: (0, superstruct_1.literal)('x25519-xsalsa20-poly1305'),
+    nonce: (0, superstruct_1.string)(),
+    ephemPublicKey: (0, superstruct_1.string)(),
+    ciphertext: (0, superstruct_1.string)(),
+});
+/**
+ * A struct for EIP-7702 authorization tuple.
+ * Format: [chainId, address, nonce]
+ */
+exports.EthEip7702AuthorizationStruct = (0, superstruct_1.tuple)([
+    (0, superstruct_1.number)(), // chainId
+    types_1.EthAddressStruct, // address (contract to delegate to)
+    (0, superstruct_1.number)(), // nonce
+]);
+/**
+ * A struct for getEncryptionPublicKey options.
+ */
+exports.EthGetEncryptionPublicKeyOptionsStruct = (0, superstruct_1.record)((0, superstruct_1.string)(), (0, superstruct_1.unknown)());
+// ============================================================================
+// RPC Method Parameter Structs
+// ============================================================================
+/**
+ * Parameters for `eth_signTransaction`.
+ */
+exports.EthSignTransactionParamsStruct = (0, superstruct_1.tuple)([exports.EthTransactionDataStruct]);
+/**
+ * Parameters for `eth_sign`.
+ */
+exports.EthSignParamsStruct = (0, superstruct_1.tuple)([
+    types_1.EthAddressStruct, // address
+    types_1.EthBytesStruct, // data (hex-encoded message hash)
+]);
+/**
+ * Parameters for `personal_sign`.
+ */
+exports.EthPersonalSignParamsStruct = (0, superstruct_1.union)([
+    (0, superstruct_1.tuple)([types_1.EthBytesStruct]), // [data]
+    (0, superstruct_1.tuple)([types_1.EthBytesStruct, types_1.EthAddressStruct]), // [data, address]
+]);
+/**
+ * Parameters for `eth_signTypedData_v1`.
+ */
+exports.EthSignTypedDataV1ParamsStruct = (0, superstruct_1.tuple)([
+    types_1.EthAddressStruct, // address
+    exports.EthTypedDataV1Struct, // typed data array
+]);
+/**
+ * Parameters for `eth_signTypedData_v3` and `eth_signTypedData_v4`.
+ */
+exports.EthSignTypedDataParamsStruct = (0, superstruct_1.tuple)([
+    types_1.EthAddressStruct, // address
+    exports.EthTypedMessageStruct, // typed data object
+]);
+/**
+ * Parameters for `eth_decrypt`.
+ */
+exports.EthDecryptParamsStruct = (0, superstruct_1.tuple)([exports.EthEncryptedDataStruct]);
+/**
+ * Parameters for `eth_getAppKeyAddress`.
+ */
+exports.EthGetAppKeyAddressParamsStruct = (0, superstruct_1.tuple)([
+    (0, superstruct_1.string)(), // origin URL
+]);
+/**
+ * Parameters for `eth_signEip7702Authorization`.
+ *
+ * @example
+ * ```ts
+ * const params = [[1, '0xContractAddress', 0]];
+ * ```
+ */
+exports.EthSignEip7702AuthorizationParamsStruct = (0, superstruct_1.tuple)([
+    exports.EthEip7702AuthorizationStruct,
+]);
+/**
+ * Parameters for `eth_getEncryptionPublicKey`.
+ */
+exports.EthGetEncryptionPublicKeyParamsStruct = (0, superstruct_1.tuple)([
+    types_1.EthAddressStruct, // address
+    (0, superstruct_1.optional)(exports.EthGetEncryptionPublicKeyOptionsStruct), // options
+]);
+//# sourceMappingURL=params.cjs.map

package/dist/eth/rpc/params.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.cjs","sourceRoot":"","sources":["../../../src/eth/rpc/params.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Superstruct validation schemas for Ethereum JSON-RPC method parameters.\n *\n * These structs provide runtime validation for the parameters passed to various\n * Ethereum RPC methods. They can be used by keyring implementations to validate\n * incoming requests before processing.\n */\n\nimport { object } from '@metamask/keyring-utils';\nimport type { Infer } from '@metamask/superstruct';\nimport {\n  any,\n  array,\n  literal,\n  nullable,\n  number,\n  optional,\n  record,\n  string,\n  tuple,\n  type,\n  union,\n  unknown,\n} from '@metamask/superstruct';\n\nimport { EthAddressStruct, EthBytesStruct } from '../types';\n\n/**\n * A struct for validating Ethereum transaction data.\n *\n * This uses `type()` instead of `object()` to allow extra properties,\n * since transaction formats can vary and include additional fields.\n * The actual transaction validation is performed by the transaction library.\n */\nexport const EthTransactionDataStruct = type({\n  to: optional(nullable(EthAddressStruct)),\n  from: optional(EthAddressStruct),\n  nonce: optional(union([string(), number()])),\n  value: optional(union([string(), number()])),\n  data: optional(EthBytesStruct),\n  gas: optional(union([string(), number()])),\n  gasLimit: optional(union([string(), number()])),\n  gasPrice: optional(union([string(), number()])),\n  maxFeePerGas: optional(union([string(), number()])),\n  maxPriorityFeePerGas: optional(union([string(), number()])),\n  accessList: optional(\n    array(\n      type({\n        address: EthAddressStruct,\n        storageKeys: array(string()),\n      }),\n    ),\n  ),\n  type: optional(union([string(), number()])),\n  chainId: optional(union([string(), number()])),\n});\n\nexport type EthTransactionData = Infer<typeof EthTransactionDataStruct>;\n\n/**\n * A struct for TypedDataV1 format (legacy typed data).\n * This is an array of { type, name, value } objects.\n */\nexport const EthTypedDataV1Struct = array(\n  object({\n    type: string(),\n    name: string(),\n    value: unknown(),\n  }),\n);\n\nexport type EthTypedDataV1 = Infer<typeof EthTypedDataV1Struct>;\n\n/**\n * A struct for TypedData types definition.\n * Maps type names to arrays of { name, type } definitions.\n */\nexport const EthTypedDataTypesStruct = record(\n  string(),\n  array(\n    object({\n      name: string(),\n      type: string(),\n    }),\n  ),\n);\n\nexport type EthTypedDataTypes = Infer<typeof EthTypedDataTypesStruct>;\n\n/**\n * A struct for TypedMessage format (EIP-712 V3/V4).\n * Contains types, domain, primaryType, and message.\n */\nexport const EthTypedMessageStruct = object({\n  types: EthTypedDataTypesStruct,\n  primaryType: string(),\n  domain: record(string(), any()),\n  message: record(string(), any()),\n});\n\nexport type EthTypedMessage = Infer<typeof EthTypedMessageStruct>;\n\n/**\n * A struct for EIP-1024 encrypted data format (x25519-xsalsa20-poly1305).\n */\nexport const EthEncryptedDataStruct = object({\n  version: literal('x25519-xsalsa20-poly1305'),\n  nonce: string(),\n  ephemPublicKey: string(),\n  ciphertext: string(),\n});\n\nexport type EthEncryptedData = Infer<typeof EthEncryptedDataStruct>;\n\n/**\n * A struct for EIP-7702 authorization tuple.\n * Format: [chainId, address, nonce]\n */\nexport const EthEip7702AuthorizationStruct = tuple([\n  number(), // chainId\n  EthAddressStruct, // address (contract to delegate to)\n  number(), // nonce\n]);\n\nexport type EthEip7702Authorization = Infer<\n  typeof EthEip7702AuthorizationStruct\n>;\n\n/**\n * A struct for getEncryptionPublicKey options.\n */\nexport const EthGetEncryptionPublicKeyOptionsStruct = record(\n  string(),\n  unknown(),\n);\n\n// ============================================================================\n// RPC Method Parameter Structs\n// ============================================================================\n\n/**\n * Parameters for `eth_signTransaction`.\n */\nexport const EthSignTransactionParamsStruct = tuple([EthTransactionDataStruct]);\n\nexport type EthSignTransactionParams = Infer<\n  typeof EthSignTransactionParamsStruct\n>;\n\n/**\n * Parameters for `eth_sign`.\n */\nexport const EthSignParamsStruct = tuple([\n  EthAddressStruct, // address\n  EthBytesStruct, // data (hex-encoded message hash)\n]);\n\nexport type EthSignParams = Infer<typeof EthSignParamsStruct>;\n\n/**\n * Parameters for `personal_sign`.\n */\nexport const EthPersonalSignParamsStruct = union([\n  tuple([EthBytesStruct]), // [data]\n  tuple([EthBytesStruct, EthAddressStruct]), // [data, address]\n]);\n\nexport type EthPersonalSignParams = Infer<typeof EthPersonalSignParamsStruct>;\n\n/**\n * Parameters for `eth_signTypedData_v1`.\n */\nexport const EthSignTypedDataV1ParamsStruct = tuple([\n  EthAddressStruct, // address\n  EthTypedDataV1Struct, // typed data array\n]);\n\nexport type EthSignTypedDataV1Params = Infer<\n  typeof EthSignTypedDataV1ParamsStruct\n>;\n\n/**\n * Parameters for `eth_signTypedData_v3` and `eth_signTypedData_v4`.\n */\nexport const EthSignTypedDataParamsStruct = tuple([\n  EthAddressStruct, // address\n  EthTypedMessageStruct, // typed data object\n]);\n\nexport type EthSignTypedDataParams = Infer<typeof EthSignTypedDataParamsStruct>;\n\n/**\n * Parameters for `eth_decrypt`.\n */\nexport const EthDecryptParamsStruct = tuple([EthEncryptedDataStruct]);\n\nexport type EthDecryptParams = Infer<typeof EthDecryptParamsStruct>;\n\n/**\n * Parameters for `eth_getAppKeyAddress`.\n */\nexport const EthGetAppKeyAddressParamsStruct = tuple([\n  string(), // origin URL\n]);\n\nexport type EthGetAppKeyAddressParams = Infer<\n  typeof EthGetAppKeyAddressParamsStruct\n>;\n\n/**\n * Parameters for `eth_signEip7702Authorization`.\n *\n * @example\n * ```ts\n * const params = [[1, '0xContractAddress', 0]];\n * ```\n */\nexport const EthSignEip7702AuthorizationParamsStruct = tuple([\n  EthEip7702AuthorizationStruct,\n]);\n\nexport type EthSignEip7702AuthorizationParams = Infer<\n  typeof EthSignEip7702AuthorizationParamsStruct\n>;\n\n/**\n * Parameters for `eth_getEncryptionPublicKey`.\n */\nexport const EthGetEncryptionPublicKeyParamsStruct = tuple([\n  EthAddressStruct, // address\n  optional(EthGetEncryptionPublicKeyOptionsStruct), // options\n]);\n"]}