@metamask-previews/snap-networks-utils 1.0.0-preview-e7a796a2 → 1.0.0-preview-2aa5deb

package/CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Add shared proof-of-ownership message parsing utilities, batch request/response structs, and batch request/response types. ([#268](https://github.com/MetaMask/internal-snaps/pull/268))
 - Add a `UuidStruct` Superstruct for validating UUID v4 strings. ([#243](https://github.com/MetaMask/internal-snaps/pull/243))
 - Add helpers `serialize`, `deserialize`, and `Serializable` for round-tripping `BigNumber`, `bigint`, `Uint8Array`, and `undefined` through snap state ([#197](https://github.com/MetaMask/internal-snaps/pull/197))
 - Add shared snap error utilities to the main package entry point ([#241](https://github.com/MetaMask/internal-snaps/pull/241))

package/dist/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InFlightCoalescer = exports.normalizeError = exports.isSnapRpcError = exports.createWithCatchAndThrowSnapError = exports.createTrackError = exports.createSnapErrorHandling = exports.validateOrigin = exports.DEFAULT_METAMASK_ORIGIN = exports.DEFAULT_DEV_ORIGINS = exports.DEFAULT_PROD_ORIGINS = exports.createOriginPermissions = exports.deserialize = exports.serialize = exports.LogLevel = exports.Logger = exports.chunks = exports.batchesAllWithChunks = exports.batchesAllSettledWithChunks = exports.batchesAllSettled = exports.batchesAll = exports.UuidStruct = exports.UrlStruct = exports.sanitizeUri = exports.sanitizeControlCharacters = exports.buildUrl = exports.safeMerge = exports.RemoteFeatureFlagsProvider = exports.REMOTE_FEATURE_FLAGS_PROVIDER_NAME = exports.AssetsProvider = exports.ASSETS_PROVIDER_NAME = void 0;
+exports.InFlightCoalescer = exports.normalizeError = exports.isSnapRpcError = exports.createWithCatchAndThrowSnapError = exports.createTrackError = exports.createSnapErrorHandling = exports.validateOrigin = exports.DEFAULT_METAMASK_ORIGIN = exports.DEFAULT_DEV_ORIGINS = exports.DEFAULT_PROD_ORIGINS = exports.createOriginPermissions = exports.PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = exports.ProofOfOwnershipMessageStruct = exports.ProofOfOwnershipBatchSuccessStruct = exports.ProofOfOwnershipBatchResponseStruct = exports.ProofOfOwnershipBatchRequestParamsStruct = exports.ProofOfOwnershipBatchRequestItemStruct = exports.ProofOfOwnershipBatchItemResponseStruct = exports.ProofOfOwnershipBatchErrorStruct = exports.parseProofOfOwnershipMessage = exports.deserialize = exports.serialize = exports.LogLevel = exports.Logger = exports.chunks = exports.batchesAllWithChunks = exports.batchesAllSettledWithChunks = exports.batchesAllSettled = exports.batchesAll = exports.UuidStruct = exports.UrlStruct = exports.sanitizeUri = exports.sanitizeControlCharacters = exports.buildUrl = exports.safeMerge = exports.RemoteFeatureFlagsProvider = exports.REMOTE_FEATURE_FLAGS_PROVIDER_NAME = exports.AssetsProvider = exports.ASSETS_PROVIDER_NAME = void 0;
 var AssetsProvider_1 = require("./providers/assets/AssetsProvider.cjs");
 Object.defineProperty(exports, "ASSETS_PROVIDER_NAME", { enumerable: true, get: function () { return AssetsProvider_1.ASSETS_PROVIDER_NAME; } });
 Object.defineProperty(exports, "AssetsProvider", { enumerable: true, get: function () { return AssetsProvider_1.AssetsProvider; } });
@@ -30,6 +30,16 @@ Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function ()
 var serialization_1 = require("./utils/serialization/serialization.cjs");
 Object.defineProperty(exports, "serialize", { enumerable: true, get: function () { return serialization_1.serialize; } });
 Object.defineProperty(exports, "deserialize", { enumerable: true, get: function () { return serialization_1.deserialize; } });
+var proofOfOwnership_1 = require("./utils/proofOfOwnership/proofOfOwnership.cjs");
+Object.defineProperty(exports, "parseProofOfOwnershipMessage", { enumerable: true, get: function () { return proofOfOwnership_1.parseProofOfOwnershipMessage; } });
+Object.defineProperty(exports, "ProofOfOwnershipBatchErrorStruct", { enumerable: true, get: function () { return proofOfOwnership_1.ProofOfOwnershipBatchErrorStruct; } });
+Object.defineProperty(exports, "ProofOfOwnershipBatchItemResponseStruct", { enumerable: true, get: function () { return proofOfOwnership_1.ProofOfOwnershipBatchItemResponseStruct; } });
+Object.defineProperty(exports, "ProofOfOwnershipBatchRequestItemStruct", { enumerable: true, get: function () { return proofOfOwnership_1.ProofOfOwnershipBatchRequestItemStruct; } });
+Object.defineProperty(exports, "ProofOfOwnershipBatchRequestParamsStruct", { enumerable: true, get: function () { return proofOfOwnership_1.ProofOfOwnershipBatchRequestParamsStruct; } });
+Object.defineProperty(exports, "ProofOfOwnershipBatchResponseStruct", { enumerable: true, get: function () { return proofOfOwnership_1.ProofOfOwnershipBatchResponseStruct; } });
+Object.defineProperty(exports, "ProofOfOwnershipBatchSuccessStruct", { enumerable: true, get: function () { return proofOfOwnership_1.ProofOfOwnershipBatchSuccessStruct; } });
+Object.defineProperty(exports, "ProofOfOwnershipMessageStruct", { enumerable: true, get: function () { return proofOfOwnership_1.ProofOfOwnershipMessageStruct; } });
+Object.defineProperty(exports, "PROOF_OF_OWNERSHIP_MESSAGE_PREFIX", { enumerable: true, get: function () { return proofOfOwnership_1.PROOF_OF_OWNERSHIP_MESSAGE_PREFIX; } });
 var createOriginPermissions_1 = require("./utils/originPermissions/createOriginPermissions.cjs");
 Object.defineProperty(exports, "createOriginPermissions", { enumerable: true, get: function () { return createOriginPermissions_1.createOriginPermissions; } });
 Object.defineProperty(exports, "DEFAULT_PROD_ORIGINS", { enumerable: true, get: function () { return createOriginPermissions_1.DEFAULT_PROD_ORIGINS; } });

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,wEAI2C;AAHzC,sHAAA,oBAAoB,OAAA;AACpB,gHAAA,cAAc,OAAA;AAGhB,8GAIqE;AAHnE,gJAAA,kCAAkC,OAAA;AAClC,wIAAA,0BAA0B,OAAA;AAG5B,6DAAwD;AAA/C,sGAAA,SAAS,OAAA;AAClB,0DAAqD;AAA5C,oGAAA,QAAQ,OAAA;AAEjB,0DAGmC;AAFjC,qHAAA,yBAAyB,OAAA;AACzB,uGAAA,WAAW,OAAA;AAEb,6DAAwD;AAA/C,sGAAA,SAAS,OAAA;AAClB,gEAA2D;AAAlD,wGAAA,UAAU,OAAA;AACnB,iDAM6B;AAL3B,mGAAA,UAAU,OAAA;AACV,0GAAA,iBAAiB,OAAA;AACjB,oHAAA,2BAA2B,OAAA;AAC3B,6GAAA,oBAAoB,OAAA;AACpB,+FAAA,MAAM,OAAA;AAER,oDAAyD;AAAhD,gGAAA,MAAM,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAQzB,yEAA6E;AAApE,0GAAA,SAAS,OAAA;AAAE,4GAAA,WAAW,OAAA;AAE/B,iGAK2D;AAJzD,kIAAA,uBAAuB,OAAA;AACvB,+HAAA,oBAAoB,OAAA;AACpB,8HAAA,mBAAmB,OAAA;AACnB,kIAAA,uBAAuB,OAAA;AAGzB,+EAA0E;AAAjE,gHAAA,cAAc,OAAA;AACvB,mDAMwB;AALtB,iHAAA,uBAAuB,OAAA;AACvB,0GAAA,gBAAgB,OAAA;AAChB,0HAAA,gCAAgC,OAAA;AAChC,wGAAA,cAAc,OAAA;AACd,wGAAA,cAAc,OAAA;AAEhB,0EAAqE;AAA5D,sHAAA,iBAAiB,OAAA","sourcesContent":["export {\n  ASSETS_PROVIDER_NAME,\n  AssetsProvider,\n  type AssetsProviderMessenger,\n} from './providers/assets/AssetsProvider';\nexport {\n  REMOTE_FEATURE_FLAGS_PROVIDER_NAME,\n  RemoteFeatureFlagsProvider,\n  type RemoteFeatureFlagsProviderMessenger,\n} from './providers/remote-feature-flags/RemoteFeatureFlagsProvider';\nexport { safeMerge } from './utils/safeMerge/safeMerge';\nexport { buildUrl } from './utils/buildUrl/buildUrl';\nexport type { BuildUrlParams } from './utils/buildUrl/buildUrl';\nexport {\n  sanitizeControlCharacters,\n  sanitizeUri,\n} from './utils/sanitize/sanitize';\nexport { UrlStruct } from './utils/urlStruct/urlStruct';\nexport { UuidStruct } from './utils/uuidStruct/uuidStruct';\nexport {\n  batchesAll,\n  batchesAllSettled,\n  batchesAllSettledWithChunks,\n  batchesAllWithChunks,\n  chunks,\n} from './utils/async/async';\nexport { Logger, LogLevel } from './utils/logger/Logger';\nexport type {\n  LoggerOptions,\n  LoggerMethod,\n  LogMethod,\n  LogMethodDecorator,\n  LoggerDecorators,\n} from './utils/logger/Logger';\nexport { serialize, deserialize } from './utils/serialization/serialization';\nexport type { Serializable } from './utils/serialization/types';\nexport {\n  createOriginPermissions,\n  DEFAULT_PROD_ORIGINS,\n  DEFAULT_DEV_ORIGINS,\n  DEFAULT_METAMASK_ORIGIN,\n} from './utils/originPermissions/createOriginPermissions';\nexport type { CreateOriginPermissionsParams } from './utils/originPermissions/createOriginPermissions';\nexport { validateOrigin } from './utils/originPermissions/validateOrigin';\nexport {\n  createSnapErrorHandling,\n  createTrackError,\n  createWithCatchAndThrowSnapError,\n  isSnapRpcError,\n  normalizeError,\n} from './utils/errors';\nexport { InFlightCoalescer } from './utils/dedupe/InFlightCoalescer';\nexport type {\n  CreateSnapErrorHandlingOptions,\n  CreateTrackErrorOptions,\n  CreateWithCatchAndThrowSnapErrorOptions,\n  LogErrorFn,\n  NormalizeErrorFn,\n  PrepareErrorForTrackingFn,\n  ShouldTrackErrorFn,\n  SnapRpcError,\n  SnapTrackErrorRequest,\n  TrackErrorCapableProvider,\n  TrackErrorFn,\n} from './utils/errors';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,wEAI2C;AAHzC,sHAAA,oBAAoB,OAAA;AACpB,gHAAA,cAAc,OAAA;AAGhB,8GAIqE;AAHnE,gJAAA,kCAAkC,OAAA;AAClC,wIAAA,0BAA0B,OAAA;AAG5B,6DAAwD;AAA/C,sGAAA,SAAS,OAAA;AAClB,0DAAqD;AAA5C,oGAAA,QAAQ,OAAA;AAEjB,0DAGmC;AAFjC,qHAAA,yBAAyB,OAAA;AACzB,uGAAA,WAAW,OAAA;AAEb,6DAAwD;AAA/C,sGAAA,SAAS,OAAA;AAClB,gEAA2D;AAAlD,wGAAA,UAAU,OAAA;AACnB,iDAM6B;AAL3B,mGAAA,UAAU,OAAA;AACV,0GAAA,iBAAiB,OAAA;AACjB,oHAAA,2BAA2B,OAAA;AAC3B,6GAAA,oBAAoB,OAAA;AACpB,+FAAA,MAAM,OAAA;AAER,oDAAyD;AAAhD,gGAAA,MAAM,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAQzB,yEAA6E;AAApE,0GAAA,SAAS,OAAA;AAAE,4GAAA,WAAW,OAAA;AAE/B,kFAUmD;AATjD,gIAAA,4BAA4B,OAAA;AAC5B,oIAAA,gCAAgC,OAAA;AAChC,2IAAA,uCAAuC,OAAA;AACvC,0IAAA,sCAAsC,OAAA;AACtC,4IAAA,wCAAwC,OAAA;AACxC,uIAAA,mCAAmC,OAAA;AACnC,sIAAA,kCAAkC,OAAA;AAClC,iIAAA,6BAA6B,OAAA;AAC7B,qIAAA,iCAAiC,OAAA;AAWnC,iGAK2D;AAJzD,kIAAA,uBAAuB,OAAA;AACvB,+HAAA,oBAAoB,OAAA;AACpB,8HAAA,mBAAmB,OAAA;AACnB,kIAAA,uBAAuB,OAAA;AAGzB,+EAA0E;AAAjE,gHAAA,cAAc,OAAA;AACvB,mDAMwB;AALtB,iHAAA,uBAAuB,OAAA;AACvB,0GAAA,gBAAgB,OAAA;AAChB,0HAAA,gCAAgC,OAAA;AAChC,wGAAA,cAAc,OAAA;AACd,wGAAA,cAAc,OAAA;AAEhB,0EAAqE;AAA5D,sHAAA,iBAAiB,OAAA","sourcesContent":["export {\n  ASSETS_PROVIDER_NAME,\n  AssetsProvider,\n  type AssetsProviderMessenger,\n} from './providers/assets/AssetsProvider';\nexport {\n  REMOTE_FEATURE_FLAGS_PROVIDER_NAME,\n  RemoteFeatureFlagsProvider,\n  type RemoteFeatureFlagsProviderMessenger,\n} from './providers/remote-feature-flags/RemoteFeatureFlagsProvider';\nexport { safeMerge } from './utils/safeMerge/safeMerge';\nexport { buildUrl } from './utils/buildUrl/buildUrl';\nexport type { BuildUrlParams } from './utils/buildUrl/buildUrl';\nexport {\n  sanitizeControlCharacters,\n  sanitizeUri,\n} from './utils/sanitize/sanitize';\nexport { UrlStruct } from './utils/urlStruct/urlStruct';\nexport { UuidStruct } from './utils/uuidStruct/uuidStruct';\nexport {\n  batchesAll,\n  batchesAllSettled,\n  batchesAllSettledWithChunks,\n  batchesAllWithChunks,\n  chunks,\n} from './utils/async/async';\nexport { Logger, LogLevel } from './utils/logger/Logger';\nexport type {\n  LoggerOptions,\n  LoggerMethod,\n  LogMethod,\n  LogMethodDecorator,\n  LoggerDecorators,\n} from './utils/logger/Logger';\nexport { serialize, deserialize } from './utils/serialization/serialization';\nexport type { Serializable } from './utils/serialization/types';\nexport {\n  parseProofOfOwnershipMessage,\n  ProofOfOwnershipBatchErrorStruct,\n  ProofOfOwnershipBatchItemResponseStruct,\n  ProofOfOwnershipBatchRequestItemStruct,\n  ProofOfOwnershipBatchRequestParamsStruct,\n  ProofOfOwnershipBatchResponseStruct,\n  ProofOfOwnershipBatchSuccessStruct,\n  ProofOfOwnershipMessageStruct,\n  PROOF_OF_OWNERSHIP_MESSAGE_PREFIX,\n} from './utils/proofOfOwnership/proofOfOwnership';\nexport type {\n  ProofOfOwnershipBatchError,\n  ProofOfOwnershipBatchItemResponse,\n  ProofOfOwnershipBatchRequestItem,\n  ProofOfOwnershipBatchRequestParams,\n  ProofOfOwnershipBatchResponse,\n  ProofOfOwnershipBatchSuccess,\n  ProofOfOwnershipMessage,\n} from './utils/proofOfOwnership/proofOfOwnership';\nexport {\n  createOriginPermissions,\n  DEFAULT_PROD_ORIGINS,\n  DEFAULT_DEV_ORIGINS,\n  DEFAULT_METAMASK_ORIGIN,\n} from './utils/originPermissions/createOriginPermissions';\nexport type { CreateOriginPermissionsParams } from './utils/originPermissions/createOriginPermissions';\nexport { validateOrigin } from './utils/originPermissions/validateOrigin';\nexport {\n  createSnapErrorHandling,\n  createTrackError,\n  createWithCatchAndThrowSnapError,\n  isSnapRpcError,\n  normalizeError,\n} from './utils/errors';\nexport { InFlightCoalescer } from './utils/dedupe/InFlightCoalescer';\nexport type {\n  CreateSnapErrorHandlingOptions,\n  CreateTrackErrorOptions,\n  CreateWithCatchAndThrowSnapErrorOptions,\n  LogErrorFn,\n  NormalizeErrorFn,\n  PrepareErrorForTrackingFn,\n  ShouldTrackErrorFn,\n  SnapRpcError,\n  SnapTrackErrorRequest,\n  TrackErrorCapableProvider,\n  TrackErrorFn,\n} from './utils/errors';\n"]}

package/dist/index.d.cts

@@ -11,6 +11,8 @@ export { Logger, LogLevel } from "./utils/logger/Logger.cjs";
 export type { LoggerOptions, LoggerMethod, LogMethod, LogMethodDecorator, LoggerDecorators, } from "./utils/logger/Logger.cjs";
 export { serialize, deserialize } from "./utils/serialization/serialization.cjs";
 export type { Serializable } from "./utils/serialization/types.cjs";
+export { parseProofOfOwnershipMessage, ProofOfOwnershipBatchErrorStruct, ProofOfOwnershipBatchItemResponseStruct, ProofOfOwnershipBatchRequestItemStruct, ProofOfOwnershipBatchRequestParamsStruct, ProofOfOwnershipBatchResponseStruct, ProofOfOwnershipBatchSuccessStruct, ProofOfOwnershipMessageStruct, PROOF_OF_OWNERSHIP_MESSAGE_PREFIX, } from "./utils/proofOfOwnership/proofOfOwnership.cjs";
+export type { ProofOfOwnershipBatchError, ProofOfOwnershipBatchItemResponse, ProofOfOwnershipBatchRequestItem, ProofOfOwnershipBatchRequestParams, ProofOfOwnershipBatchResponse, ProofOfOwnershipBatchSuccess, ProofOfOwnershipMessage, } from "./utils/proofOfOwnership/proofOfOwnership.cjs";
 export { createOriginPermissions, DEFAULT_PROD_ORIGINS, DEFAULT_DEV_ORIGINS, DEFAULT_METAMASK_ORIGIN, } from "./utils/originPermissions/createOriginPermissions.cjs";
 export type { CreateOriginPermissionsParams } from "./utils/originPermissions/createOriginPermissions.cjs";
 export { validateOrigin } from "./utils/originPermissions/validateOrigin.cjs";

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,KAAK,uBAAuB,GAC7B,8CAA0C;AAC3C,OAAO,EACL,kCAAkC,EAClC,0BAA0B,EAC1B,KAAK,mCAAmC,GACzC,wEAAoE;AACrE,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,QAAQ,EAAE,sCAAkC;AACrD,YAAY,EAAE,cAAc,EAAE,sCAAkC;AAChE,OAAO,EACL,yBAAyB,EACzB,WAAW,GACZ,sCAAkC;AACnC,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,UAAU,EAAE,0CAAsC;AAC3D,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,MAAM,GACP,gCAA4B;AAC7B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAA8B;AACzD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,gBAAgB,GACjB,kCAA8B;AAC/B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gDAA4C;AAC7E,YAAY,EAAE,YAAY,EAAE,wCAAoC;AAChE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GACxB,8DAA0D;AAC3D,YAAY,EAAE,6BAA6B,EAAE,8DAA0D;AACvG,OAAO,EAAE,cAAc,EAAE,qDAAiD;AAC1E,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,gCAAgC,EAChC,cAAc,EACd,cAAc,GACf,iCAAuB;AACxB,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,YAAY,EACV,8BAA8B,EAC9B,uBAAuB,EACvB,uCAAuC,EACvC,UAAU,EACV,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,GACb,iCAAuB"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,KAAK,uBAAuB,GAC7B,8CAA0C;AAC3C,OAAO,EACL,kCAAkC,EAClC,0BAA0B,EAC1B,KAAK,mCAAmC,GACzC,wEAAoE;AACrE,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,QAAQ,EAAE,sCAAkC;AACrD,YAAY,EAAE,cAAc,EAAE,sCAAkC;AAChE,OAAO,EACL,yBAAyB,EACzB,WAAW,GACZ,sCAAkC;AACnC,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,UAAU,EAAE,0CAAsC;AAC3D,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,MAAM,GACP,gCAA4B;AAC7B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAA8B;AACzD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,gBAAgB,GACjB,kCAA8B;AAC/B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gDAA4C;AAC7E,YAAY,EAAE,YAAY,EAAE,wCAAoC;AAChE,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,uCAAuC,EACvC,sCAAsC,EACtC,wCAAwC,EACxC,mCAAmC,EACnC,kCAAkC,EAClC,6BAA6B,EAC7B,iCAAiC,GAClC,sDAAkD;AACnD,YAAY,EACV,0BAA0B,EAC1B,iCAAiC,EACjC,gCAAgC,EAChC,kCAAkC,EAClC,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,GACxB,sDAAkD;AACnD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GACxB,8DAA0D;AAC3D,YAAY,EAAE,6BAA6B,EAAE,8DAA0D;AACvG,OAAO,EAAE,cAAc,EAAE,qDAAiD;AAC1E,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,gCAAgC,EAChC,cAAc,EACd,cAAc,GACf,iCAAuB;AACxB,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,YAAY,EACV,8BAA8B,EAC9B,uBAAuB,EACvB,uCAAuC,EACvC,UAAU,EACV,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,GACb,iCAAuB"}

package/dist/index.d.mts

@@ -11,6 +11,8 @@ export { Logger, LogLevel } from "./utils/logger/Logger.mjs";
 export type { LoggerOptions, LoggerMethod, LogMethod, LogMethodDecorator, LoggerDecorators, } from "./utils/logger/Logger.mjs";
 export { serialize, deserialize } from "./utils/serialization/serialization.mjs";
 export type { Serializable } from "./utils/serialization/types.mjs";
+export { parseProofOfOwnershipMessage, ProofOfOwnershipBatchErrorStruct, ProofOfOwnershipBatchItemResponseStruct, ProofOfOwnershipBatchRequestItemStruct, ProofOfOwnershipBatchRequestParamsStruct, ProofOfOwnershipBatchResponseStruct, ProofOfOwnershipBatchSuccessStruct, ProofOfOwnershipMessageStruct, PROOF_OF_OWNERSHIP_MESSAGE_PREFIX, } from "./utils/proofOfOwnership/proofOfOwnership.mjs";
+export type { ProofOfOwnershipBatchError, ProofOfOwnershipBatchItemResponse, ProofOfOwnershipBatchRequestItem, ProofOfOwnershipBatchRequestParams, ProofOfOwnershipBatchResponse, ProofOfOwnershipBatchSuccess, ProofOfOwnershipMessage, } from "./utils/proofOfOwnership/proofOfOwnership.mjs";
 export { createOriginPermissions, DEFAULT_PROD_ORIGINS, DEFAULT_DEV_ORIGINS, DEFAULT_METAMASK_ORIGIN, } from "./utils/originPermissions/createOriginPermissions.mjs";
 export type { CreateOriginPermissionsParams } from "./utils/originPermissions/createOriginPermissions.mjs";
 export { validateOrigin } from "./utils/originPermissions/validateOrigin.mjs";

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,KAAK,uBAAuB,GAC7B,8CAA0C;AAC3C,OAAO,EACL,kCAAkC,EAClC,0BAA0B,EAC1B,KAAK,mCAAmC,GACzC,wEAAoE;AACrE,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,QAAQ,EAAE,sCAAkC;AACrD,YAAY,EAAE,cAAc,EAAE,sCAAkC;AAChE,OAAO,EACL,yBAAyB,EACzB,WAAW,GACZ,sCAAkC;AACnC,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,UAAU,EAAE,0CAAsC;AAC3D,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,MAAM,GACP,gCAA4B;AAC7B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAA8B;AACzD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,gBAAgB,GACjB,kCAA8B;AAC/B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gDAA4C;AAC7E,YAAY,EAAE,YAAY,EAAE,wCAAoC;AAChE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GACxB,8DAA0D;AAC3D,YAAY,EAAE,6BAA6B,EAAE,8DAA0D;AACvG,OAAO,EAAE,cAAc,EAAE,qDAAiD;AAC1E,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,gCAAgC,EAChC,cAAc,EACd,cAAc,GACf,iCAAuB;AACxB,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,YAAY,EACV,8BAA8B,EAC9B,uBAAuB,EACvB,uCAAuC,EACvC,UAAU,EACV,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,GACb,iCAAuB"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,KAAK,uBAAuB,GAC7B,8CAA0C;AAC3C,OAAO,EACL,kCAAkC,EAClC,0BAA0B,EAC1B,KAAK,mCAAmC,GACzC,wEAAoE;AACrE,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,QAAQ,EAAE,sCAAkC;AACrD,YAAY,EAAE,cAAc,EAAE,sCAAkC;AAChE,OAAO,EACL,yBAAyB,EACzB,WAAW,GACZ,sCAAkC;AACnC,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,UAAU,EAAE,0CAAsC;AAC3D,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,MAAM,GACP,gCAA4B;AAC7B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAA8B;AACzD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,gBAAgB,GACjB,kCAA8B;AAC/B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gDAA4C;AAC7E,YAAY,EAAE,YAAY,EAAE,wCAAoC;AAChE,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,uCAAuC,EACvC,sCAAsC,EACtC,wCAAwC,EACxC,mCAAmC,EACnC,kCAAkC,EAClC,6BAA6B,EAC7B,iCAAiC,GAClC,sDAAkD;AACnD,YAAY,EACV,0BAA0B,EAC1B,iCAAiC,EACjC,gCAAgC,EAChC,kCAAkC,EAClC,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,GACxB,sDAAkD;AACnD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GACxB,8DAA0D;AAC3D,YAAY,EAAE,6BAA6B,EAAE,8DAA0D;AACvG,OAAO,EAAE,cAAc,EAAE,qDAAiD;AAC1E,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,gCAAgC,EAChC,cAAc,EACd,cAAc,GACf,iCAAuB;AACxB,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,YAAY,EACV,8BAA8B,EAC9B,uBAAuB,EACvB,uCAAuC,EACvC,UAAU,EACV,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,GACb,iCAAuB"}

package/dist/index.mjs

@@ -8,6 +8,7 @@ export { UuidStruct } from "./utils/uuidStruct/uuidStruct.mjs";
 export { batchesAll, batchesAllSettled, batchesAllSettledWithChunks, batchesAllWithChunks, chunks } from "./utils/async/async.mjs";
 export { Logger, LogLevel } from "./utils/logger/Logger.mjs";
 export { serialize, deserialize } from "./utils/serialization/serialization.mjs";
+export { parseProofOfOwnershipMessage, ProofOfOwnershipBatchErrorStruct, ProofOfOwnershipBatchItemResponseStruct, ProofOfOwnershipBatchRequestItemStruct, ProofOfOwnershipBatchRequestParamsStruct, ProofOfOwnershipBatchResponseStruct, ProofOfOwnershipBatchSuccessStruct, ProofOfOwnershipMessageStruct, PROOF_OF_OWNERSHIP_MESSAGE_PREFIX } from "./utils/proofOfOwnership/proofOfOwnership.mjs";
 export { createOriginPermissions, DEFAULT_PROD_ORIGINS, DEFAULT_DEV_ORIGINS, DEFAULT_METAMASK_ORIGIN } from "./utils/originPermissions/createOriginPermissions.mjs";
 export { validateOrigin } from "./utils/originPermissions/validateOrigin.mjs";
 export { createSnapErrorHandling, createTrackError, createWithCatchAndThrowSnapError, isSnapRpcError, normalizeError } from "./utils/errors/index.mjs";

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EAEf,8CAA0C;AAC3C,OAAO,EACL,kCAAkC,EAClC,0BAA0B,EAE3B,wEAAoE;AACrE,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,QAAQ,EAAE,sCAAkC;AAErD,OAAO,EACL,yBAAyB,EACzB,WAAW,EACZ,sCAAkC;AACnC,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,UAAU,EAAE,0CAAsC;AAC3D,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,MAAM,EACP,gCAA4B;AAC7B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAA8B;AAQzD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gDAA4C;AAE7E,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACxB,8DAA0D;AAE3D,OAAO,EAAE,cAAc,EAAE,qDAAiD;AAC1E,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,gCAAgC,EAChC,cAAc,EACd,cAAc,EACf,iCAAuB;AACxB,OAAO,EAAE,iBAAiB,EAAE,6CAAyC","sourcesContent":["export {\n  ASSETS_PROVIDER_NAME,\n  AssetsProvider,\n  type AssetsProviderMessenger,\n} from './providers/assets/AssetsProvider';\nexport {\n  REMOTE_FEATURE_FLAGS_PROVIDER_NAME,\n  RemoteFeatureFlagsProvider,\n  type RemoteFeatureFlagsProviderMessenger,\n} from './providers/remote-feature-flags/RemoteFeatureFlagsProvider';\nexport { safeMerge } from './utils/safeMerge/safeMerge';\nexport { buildUrl } from './utils/buildUrl/buildUrl';\nexport type { BuildUrlParams } from './utils/buildUrl/buildUrl';\nexport {\n  sanitizeControlCharacters,\n  sanitizeUri,\n} from './utils/sanitize/sanitize';\nexport { UrlStruct } from './utils/urlStruct/urlStruct';\nexport { UuidStruct } from './utils/uuidStruct/uuidStruct';\nexport {\n  batchesAll,\n  batchesAllSettled,\n  batchesAllSettledWithChunks,\n  batchesAllWithChunks,\n  chunks,\n} from './utils/async/async';\nexport { Logger, LogLevel } from './utils/logger/Logger';\nexport type {\n  LoggerOptions,\n  LoggerMethod,\n  LogMethod,\n  LogMethodDecorator,\n  LoggerDecorators,\n} from './utils/logger/Logger';\nexport { serialize, deserialize } from './utils/serialization/serialization';\nexport type { Serializable } from './utils/serialization/types';\nexport {\n  createOriginPermissions,\n  DEFAULT_PROD_ORIGINS,\n  DEFAULT_DEV_ORIGINS,\n  DEFAULT_METAMASK_ORIGIN,\n} from './utils/originPermissions/createOriginPermissions';\nexport type { CreateOriginPermissionsParams } from './utils/originPermissions/createOriginPermissions';\nexport { validateOrigin } from './utils/originPermissions/validateOrigin';\nexport {\n  createSnapErrorHandling,\n  createTrackError,\n  createWithCatchAndThrowSnapError,\n  isSnapRpcError,\n  normalizeError,\n} from './utils/errors';\nexport { InFlightCoalescer } from './utils/dedupe/InFlightCoalescer';\nexport type {\n  CreateSnapErrorHandlingOptions,\n  CreateTrackErrorOptions,\n  CreateWithCatchAndThrowSnapErrorOptions,\n  LogErrorFn,\n  NormalizeErrorFn,\n  PrepareErrorForTrackingFn,\n  ShouldTrackErrorFn,\n  SnapRpcError,\n  SnapTrackErrorRequest,\n  TrackErrorCapableProvider,\n  TrackErrorFn,\n} from './utils/errors';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EAEf,8CAA0C;AAC3C,OAAO,EACL,kCAAkC,EAClC,0BAA0B,EAE3B,wEAAoE;AACrE,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,QAAQ,EAAE,sCAAkC;AAErD,OAAO,EACL,yBAAyB,EACzB,WAAW,EACZ,sCAAkC;AACnC,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,UAAU,EAAE,0CAAsC;AAC3D,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,MAAM,EACP,gCAA4B;AAC7B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAA8B;AAQzD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gDAA4C;AAE7E,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,uCAAuC,EACvC,sCAAsC,EACtC,wCAAwC,EACxC,mCAAmC,EACnC,kCAAkC,EAClC,6BAA6B,EAC7B,iCAAiC,EAClC,sDAAkD;AAUnD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACxB,8DAA0D;AAE3D,OAAO,EAAE,cAAc,EAAE,qDAAiD;AAC1E,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,gCAAgC,EAChC,cAAc,EACd,cAAc,EACf,iCAAuB;AACxB,OAAO,EAAE,iBAAiB,EAAE,6CAAyC","sourcesContent":["export {\n  ASSETS_PROVIDER_NAME,\n  AssetsProvider,\n  type AssetsProviderMessenger,\n} from './providers/assets/AssetsProvider';\nexport {\n  REMOTE_FEATURE_FLAGS_PROVIDER_NAME,\n  RemoteFeatureFlagsProvider,\n  type RemoteFeatureFlagsProviderMessenger,\n} from './providers/remote-feature-flags/RemoteFeatureFlagsProvider';\nexport { safeMerge } from './utils/safeMerge/safeMerge';\nexport { buildUrl } from './utils/buildUrl/buildUrl';\nexport type { BuildUrlParams } from './utils/buildUrl/buildUrl';\nexport {\n  sanitizeControlCharacters,\n  sanitizeUri,\n} from './utils/sanitize/sanitize';\nexport { UrlStruct } from './utils/urlStruct/urlStruct';\nexport { UuidStruct } from './utils/uuidStruct/uuidStruct';\nexport {\n  batchesAll,\n  batchesAllSettled,\n  batchesAllSettledWithChunks,\n  batchesAllWithChunks,\n  chunks,\n} from './utils/async/async';\nexport { Logger, LogLevel } from './utils/logger/Logger';\nexport type {\n  LoggerOptions,\n  LoggerMethod,\n  LogMethod,\n  LogMethodDecorator,\n  LoggerDecorators,\n} from './utils/logger/Logger';\nexport { serialize, deserialize } from './utils/serialization/serialization';\nexport type { Serializable } from './utils/serialization/types';\nexport {\n  parseProofOfOwnershipMessage,\n  ProofOfOwnershipBatchErrorStruct,\n  ProofOfOwnershipBatchItemResponseStruct,\n  ProofOfOwnershipBatchRequestItemStruct,\n  ProofOfOwnershipBatchRequestParamsStruct,\n  ProofOfOwnershipBatchResponseStruct,\n  ProofOfOwnershipBatchSuccessStruct,\n  ProofOfOwnershipMessageStruct,\n  PROOF_OF_OWNERSHIP_MESSAGE_PREFIX,\n} from './utils/proofOfOwnership/proofOfOwnership';\nexport type {\n  ProofOfOwnershipBatchError,\n  ProofOfOwnershipBatchItemResponse,\n  ProofOfOwnershipBatchRequestItem,\n  ProofOfOwnershipBatchRequestParams,\n  ProofOfOwnershipBatchResponse,\n  ProofOfOwnershipBatchSuccess,\n  ProofOfOwnershipMessage,\n} from './utils/proofOfOwnership/proofOfOwnership';\nexport {\n  createOriginPermissions,\n  DEFAULT_PROD_ORIGINS,\n  DEFAULT_DEV_ORIGINS,\n  DEFAULT_METAMASK_ORIGIN,\n} from './utils/originPermissions/createOriginPermissions';\nexport type { CreateOriginPermissionsParams } from './utils/originPermissions/createOriginPermissions';\nexport { validateOrigin } from './utils/originPermissions/validateOrigin';\nexport {\n  createSnapErrorHandling,\n  createTrackError,\n  createWithCatchAndThrowSnapError,\n  isSnapRpcError,\n  normalizeError,\n} from './utils/errors';\nexport { InFlightCoalescer } from './utils/dedupe/InFlightCoalescer';\nexport type {\n  CreateSnapErrorHandlingOptions,\n  CreateTrackErrorOptions,\n  CreateWithCatchAndThrowSnapErrorOptions,\n  LogErrorFn,\n  NormalizeErrorFn,\n  PrepareErrorForTrackingFn,\n  ShouldTrackErrorFn,\n  SnapRpcError,\n  SnapTrackErrorRequest,\n  TrackErrorCapableProvider,\n  TrackErrorFn,\n} from './utils/errors';\n"]}

package/dist/utils/proofOfOwnership/proofOfOwnership.cjs

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProofOfOwnershipBatchResponseStruct = exports.ProofOfOwnershipBatchItemResponseStruct = exports.ProofOfOwnershipBatchErrorStruct = exports.ProofOfOwnershipBatchSuccessStruct = exports.ProofOfOwnershipBatchRequestParamsStruct = exports.ProofOfOwnershipBatchRequestItemStruct = exports.ProofOfOwnershipMessageStruct = exports.PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = void 0;
+exports.parseProofOfOwnershipMessage = parseProofOfOwnershipMessage;
+const superstruct_1 = require("@metamask/superstruct");
+const uuidStruct_1 = require("../uuidStruct/uuidStruct.cjs");
+/**
+ * Prefix for proof-of-ownership messages signed by network snaps.
+ */
+exports.PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = 'metamask:proof-of-ownership:';
+/**
+ * Validates parsed proof-of-ownership message fields.
+ */
+exports.ProofOfOwnershipMessageStruct = (0, superstruct_1.object)({
+    nonce: (0, superstruct_1.nonempty)((0, superstruct_1.string)()),
+    address: (0, superstruct_1.nonempty)((0, superstruct_1.string)()),
+});
+/**
+ * Validates one proof-of-ownership batch request item.
+ */
+exports.ProofOfOwnershipBatchRequestItemStruct = (0, superstruct_1.object)({
+    accountId: uuidStruct_1.UuidStruct,
+    message: (0, superstruct_1.string)(),
+});
+/**
+ * Validates proof-of-ownership batch request params.
+ */
+exports.ProofOfOwnershipBatchRequestParamsStruct = (0, superstruct_1.object)({
+    items: (0, superstruct_1.array)(exports.ProofOfOwnershipBatchRequestItemStruct),
+});
+/**
+ * Validates one successful proof-of-ownership batch result.
+ */
+exports.ProofOfOwnershipBatchSuccessStruct = (0, superstruct_1.object)({
+    accountId: uuidStruct_1.UuidStruct,
+    signature: (0, superstruct_1.string)(),
+});
+/**
+ * Validates one failed proof-of-ownership batch result.
+ */
+exports.ProofOfOwnershipBatchErrorStruct = (0, superstruct_1.object)({
+    accountId: uuidStruct_1.UuidStruct,
+    error: (0, superstruct_1.nonempty)((0, superstruct_1.string)()),
+});
+/**
+ * Validates one proof-of-ownership batch result.
+ */
+exports.ProofOfOwnershipBatchItemResponseStruct = (0, superstruct_1.union)([
+    exports.ProofOfOwnershipBatchSuccessStruct,
+    exports.ProofOfOwnershipBatchErrorStruct,
+]);
+/**
+ * Validates a proof-of-ownership batch response.
+ */
+exports.ProofOfOwnershipBatchResponseStruct = (0, superstruct_1.object)({
+    results: (0, superstruct_1.array)(exports.ProofOfOwnershipBatchItemResponseStruct),
+});
+/**
+ * Parses a plaintext proof-of-ownership message in the format
+ * `metamask:proof-of-ownership:{nonce}:{address}`.
+ *
+ * Address validity is intentionally not checked here because it is
+ * chain-specific. Callers should validate the returned address with the
+ * relevant network/address validator.
+ *
+ * @param message - The plaintext message to parse.
+ * @returns The parsed nonce and address.
+ * @throws Error if the message format is invalid.
+ */
+function parseProofOfOwnershipMessage(message) {
+    if (!message.startsWith(exports.PROOF_OF_OWNERSHIP_MESSAGE_PREFIX)) {
+        throw new Error(`Message must start with "${exports.PROOF_OF_OWNERSHIP_MESSAGE_PREFIX}"`);
+    }
+    const remainder = message.slice(exports.PROOF_OF_OWNERSHIP_MESSAGE_PREFIX.length);
+    const separatorIndex = remainder.lastIndexOf(':');
+    if (separatorIndex === -1) {
+        throw new Error('Message must follow the format "metamask:proof-of-ownership:{nonce}:{address}"');
+    }
+    const nonce = remainder.slice(0, separatorIndex);
+    const address = remainder.slice(separatorIndex + 1);
+    if (nonce.length === 0) {
+        throw new Error('Message must include a non-empty nonce');
+    }
+    if (address.length === 0) {
+        throw new Error('Message must include a non-empty address');
+    }
+    return { nonce, address };
+}
+//# sourceMappingURL=proofOfOwnership.cjs.map

package/dist/utils/proofOfOwnership/proofOfOwnership.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"proofOfOwnership.cjs","sourceRoot":"","sources":["../../../src/utils/proofOfOwnership/proofOfOwnership.ts"],"names":[],"mappings":";;;AA6HA,oEA6BC;AAzJD,uDAA+E;AAE/E,6DAAsD;AAEtD;;GAEG;AACU,QAAA,iCAAiC,GAAG,8BAA8B,CAAC;AAEhF;;GAEG;AACU,QAAA,6BAA6B,GAAG,IAAA,oBAAM,EAAC;IAClD,KAAK,EAAE,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC;IACzB,OAAO,EAAE,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC;CAC5B,CAAC,CAAC;AASH;;GAEG;AACU,QAAA,sCAAsC,GAAG,IAAA,oBAAM,EAAC;IAC3D,SAAS,EAAE,uBAAU;IACrB,OAAO,EAAE,IAAA,oBAAM,GAAE;CAClB,CAAC,CAAC;AASH;;GAEG;AACU,QAAA,wCAAwC,GAAG,IAAA,oBAAM,EAAC;IAC7D,KAAK,EAAE,IAAA,mBAAK,EAAC,8CAAsC,CAAC;CACrD,CAAC,CAAC;AASH;;GAEG;AACU,QAAA,kCAAkC,GAAG,IAAA,oBAAM,EAAC;IACvD,SAAS,EAAE,uBAAU;IACrB,SAAS,EAAE,IAAA,oBAAM,GAAE;CACpB,CAAC,CAAC;AASH;;GAEG;AACU,QAAA,gCAAgC,GAAG,IAAA,oBAAM,EAAC;IACrD,SAAS,EAAE,uBAAU;IACrB,KAAK,EAAE,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC;CAC1B,CAAC,CAAC;AASH;;GAEG;AACU,QAAA,uCAAuC,GAAG,IAAA,mBAAK,EAAC;IAC3D,0CAAkC;IAClC,wCAAgC;CACjC,CAAC,CAAC;AASH;;GAEG;AACU,QAAA,mCAAmC,GAAG,IAAA,oBAAM,EAAC;IACxD,OAAO,EAAE,IAAA,mBAAK,EAAC,+CAAuC,CAAC;CACxD,CAAC,CAAC;AASH;;;;;;;;;;;GAWG;AACH,SAAgB,4BAA4B,CAC1C,OAAe;IAEf,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,yCAAiC,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,4BAA4B,yCAAiC,GAAG,CACjE,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,yCAAiC,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,cAAc,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;IAEpD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC","sourcesContent":["import type { Infer } from '@metamask/superstruct';\nimport { array, nonempty, object, string, union } from '@metamask/superstruct';\n\nimport { UuidStruct } from '../uuidStruct/uuidStruct';\n\n/**\n * Prefix for proof-of-ownership messages signed by network snaps.\n */\nexport const PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = 'metamask:proof-of-ownership:';\n\n/**\n * Validates parsed proof-of-ownership message fields.\n */\nexport const ProofOfOwnershipMessageStruct = object({\n  nonce: nonempty(string()),\n  address: nonempty(string()),\n});\n\n/**\n * Parsed proof-of-ownership message fields.\n */\nexport type ProofOfOwnershipMessage = Infer<\n  typeof ProofOfOwnershipMessageStruct\n>;\n\n/**\n * Validates one proof-of-ownership batch request item.\n */\nexport const ProofOfOwnershipBatchRequestItemStruct = object({\n  accountId: UuidStruct,\n  message: string(),\n});\n\n/**\n * One proof-of-ownership batch request item.\n */\nexport type ProofOfOwnershipBatchRequestItem = Infer<\n  typeof ProofOfOwnershipBatchRequestItemStruct\n>;\n\n/**\n * Validates proof-of-ownership batch request params.\n */\nexport const ProofOfOwnershipBatchRequestParamsStruct = object({\n  items: array(ProofOfOwnershipBatchRequestItemStruct),\n});\n\n/**\n * Proof-of-ownership batch request params.\n */\nexport type ProofOfOwnershipBatchRequestParams = Infer<\n  typeof ProofOfOwnershipBatchRequestParamsStruct\n>;\n\n/**\n * Validates one successful proof-of-ownership batch result.\n */\nexport const ProofOfOwnershipBatchSuccessStruct = object({\n  accountId: UuidStruct,\n  signature: string(),\n});\n\n/**\n * One successful proof-of-ownership batch result.\n */\nexport type ProofOfOwnershipBatchSuccess = Infer<\n  typeof ProofOfOwnershipBatchSuccessStruct\n>;\n\n/**\n * Validates one failed proof-of-ownership batch result.\n */\nexport const ProofOfOwnershipBatchErrorStruct = object({\n  accountId: UuidStruct,\n  error: nonempty(string()),\n});\n\n/**\n * One failed proof-of-ownership batch result.\n */\nexport type ProofOfOwnershipBatchError = Infer<\n  typeof ProofOfOwnershipBatchErrorStruct\n>;\n\n/**\n * Validates one proof-of-ownership batch result.\n */\nexport const ProofOfOwnershipBatchItemResponseStruct = union([\n  ProofOfOwnershipBatchSuccessStruct,\n  ProofOfOwnershipBatchErrorStruct,\n]);\n\n/**\n * One proof-of-ownership batch result.\n */\nexport type ProofOfOwnershipBatchItemResponse = Infer<\n  typeof ProofOfOwnershipBatchItemResponseStruct\n>;\n\n/**\n * Validates a proof-of-ownership batch response.\n */\nexport const ProofOfOwnershipBatchResponseStruct = object({\n  results: array(ProofOfOwnershipBatchItemResponseStruct),\n});\n\n/**\n * Proof-of-ownership batch response shape.\n */\nexport type ProofOfOwnershipBatchResponse = Infer<\n  typeof ProofOfOwnershipBatchResponseStruct\n>;\n\n/**\n * Parses a plaintext proof-of-ownership message in the format\n * `metamask:proof-of-ownership:{nonce}:{address}`.\n *\n * Address validity is intentionally not checked here because it is\n * chain-specific. Callers should validate the returned address with the\n * relevant network/address validator.\n *\n * @param message - The plaintext message to parse.\n * @returns The parsed nonce and address.\n * @throws Error if the message format is invalid.\n */\nexport function parseProofOfOwnershipMessage(\n  message: string,\n): ProofOfOwnershipMessage {\n  if (!message.startsWith(PROOF_OF_OWNERSHIP_MESSAGE_PREFIX)) {\n    throw new Error(\n      `Message must start with \"${PROOF_OF_OWNERSHIP_MESSAGE_PREFIX}\"`,\n    );\n  }\n\n  const remainder = message.slice(PROOF_OF_OWNERSHIP_MESSAGE_PREFIX.length);\n  const separatorIndex = remainder.lastIndexOf(':');\n  if (separatorIndex === -1) {\n    throw new Error(\n      'Message must follow the format \"metamask:proof-of-ownership:{nonce}:{address}\"',\n    );\n  }\n\n  const nonce = remainder.slice(0, separatorIndex);\n  const address = remainder.slice(separatorIndex + 1);\n\n  if (nonce.length === 0) {\n    throw new Error('Message must include a non-empty nonce');\n  }\n\n  if (address.length === 0) {\n    throw new Error('Message must include a non-empty address');\n  }\n\n  return { nonce, address };\n}\n"]}

package/dist/utils/proofOfOwnership/proofOfOwnership.d.cts

@@ -0,0 +1,143 @@
+import type { Infer } from "@metamask/superstruct";
+/**
+ * Prefix for proof-of-ownership messages signed by network snaps.
+ */
+export declare const PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = "metamask:proof-of-ownership:";
+/**
+ * Validates parsed proof-of-ownership message fields.
+ */
+export declare const ProofOfOwnershipMessageStruct: import("@metamask/superstruct").Struct<{
+    nonce: string;
+    address: string;
+}, {
+    nonce: import("@metamask/superstruct").Struct<string, null>;
+    address: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * Parsed proof-of-ownership message fields.
+ */
+export type ProofOfOwnershipMessage = Infer<typeof ProofOfOwnershipMessageStruct>;
+/**
+ * Validates one proof-of-ownership batch request item.
+ */
+export declare const ProofOfOwnershipBatchRequestItemStruct: import("@metamask/superstruct").Struct<{
+    message: string;
+    accountId: string;
+}, {
+    accountId: import("@metamask/superstruct").Struct<string, null>;
+    message: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * One proof-of-ownership batch request item.
+ */
+export type ProofOfOwnershipBatchRequestItem = Infer<typeof ProofOfOwnershipBatchRequestItemStruct>;
+/**
+ * Validates proof-of-ownership batch request params.
+ */
+export declare const ProofOfOwnershipBatchRequestParamsStruct: import("@metamask/superstruct").Struct<{
+    items: {
+        message: string;
+        accountId: string;
+    }[];
+}, {
+    items: import("@metamask/superstruct").Struct<{
+        message: string;
+        accountId: string;
+    }[], import("@metamask/superstruct").Struct<{
+        message: string;
+        accountId: string;
+    }, {
+        accountId: import("@metamask/superstruct").Struct<string, null>;
+        message: import("@metamask/superstruct").Struct<string, null>;
+    }>>;
+}>;
+/**
+ * Proof-of-ownership batch request params.
+ */
+export type ProofOfOwnershipBatchRequestParams = Infer<typeof ProofOfOwnershipBatchRequestParamsStruct>;
+/**
+ * Validates one successful proof-of-ownership batch result.
+ */
+export declare const ProofOfOwnershipBatchSuccessStruct: import("@metamask/superstruct").Struct<{
+    accountId: string;
+    signature: string;
+}, {
+    accountId: import("@metamask/superstruct").Struct<string, null>;
+    signature: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * One successful proof-of-ownership batch result.
+ */
+export type ProofOfOwnershipBatchSuccess = Infer<typeof ProofOfOwnershipBatchSuccessStruct>;
+/**
+ * Validates one failed proof-of-ownership batch result.
+ */
+export declare const ProofOfOwnershipBatchErrorStruct: import("@metamask/superstruct").Struct<{
+    error: string;
+    accountId: string;
+}, {
+    accountId: import("@metamask/superstruct").Struct<string, null>;
+    error: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * One failed proof-of-ownership batch result.
+ */
+export type ProofOfOwnershipBatchError = Infer<typeof ProofOfOwnershipBatchErrorStruct>;
+/**
+ * Validates one proof-of-ownership batch result.
+ */
+export declare const ProofOfOwnershipBatchItemResponseStruct: import("@metamask/superstruct").Struct<{
+    accountId: string;
+    signature: string;
+} | {
+    error: string;
+    accountId: string;
+}, null>;
+/**
+ * One proof-of-ownership batch result.
+ */
+export type ProofOfOwnershipBatchItemResponse = Infer<typeof ProofOfOwnershipBatchItemResponseStruct>;
+/**
+ * Validates a proof-of-ownership batch response.
+ */
+export declare const ProofOfOwnershipBatchResponseStruct: import("@metamask/superstruct").Struct<{
+    results: ({
+        accountId: string;
+        signature: string;
+    } | {
+        error: string;
+        accountId: string;
+    })[];
+}, {
+    results: import("@metamask/superstruct").Struct<({
+        accountId: string;
+        signature: string;
+    } | {
+        error: string;
+        accountId: string;
+    })[], import("@metamask/superstruct").Struct<{
+        accountId: string;
+        signature: string;
+    } | {
+        error: string;
+        accountId: string;
+    }, null>>;
+}>;
+/**
+ * Proof-of-ownership batch response shape.
+ */
+export type ProofOfOwnershipBatchResponse = Infer<typeof ProofOfOwnershipBatchResponseStruct>;
+/**
+ * Parses a plaintext proof-of-ownership message in the format
+ * `metamask:proof-of-ownership:{nonce}:{address}`.
+ *
+ * Address validity is intentionally not checked here because it is
+ * chain-specific. Callers should validate the returned address with the
+ * relevant network/address validator.
+ *
+ * @param message - The plaintext message to parse.
+ * @returns The parsed nonce and address.
+ * @throws Error if the message format is invalid.
+ */
+export declare function parseProofOfOwnershipMessage(message: string): ProofOfOwnershipMessage;
+//# sourceMappingURL=proofOfOwnership.d.cts.map

package/dist/utils/proofOfOwnership/proofOfOwnership.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proofOfOwnership.d.cts","sourceRoot":"","sources":["../../../src/utils/proofOfOwnership/proofOfOwnership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAKnD;;GAEG;AACH,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;EAGxC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,KAAK,CACzC,OAAO,6BAA6B,CACrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sCAAsC;;;;;;EAGjD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,KAAK,CAClD,OAAO,sCAAsC,CAC9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;EAEnD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG,KAAK,CACpD,OAAO,wCAAwC,CAChD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;;EAG7C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,KAAK,CAC9C,OAAO,kCAAkC,CAC1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;EAG3C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,KAAK,CAC5C,OAAO,gCAAgC,CACxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uCAAuC;;;;;;QAGlD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG,KAAK,CACnD,OAAO,uCAAuC,CAC/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;EAE9C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,KAAK,CAC/C,OAAO,mCAAmC,CAC3C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,GACd,uBAAuB,CA2BzB"}

package/dist/utils/proofOfOwnership/proofOfOwnership.d.mts

@@ -0,0 +1,143 @@
+import type { Infer } from "@metamask/superstruct";
+/**
+ * Prefix for proof-of-ownership messages signed by network snaps.
+ */
+export declare const PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = "metamask:proof-of-ownership:";
+/**
+ * Validates parsed proof-of-ownership message fields.
+ */
+export declare const ProofOfOwnershipMessageStruct: import("@metamask/superstruct").Struct<{
+    nonce: string;
+    address: string;
+}, {
+    nonce: import("@metamask/superstruct").Struct<string, null>;
+    address: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * Parsed proof-of-ownership message fields.
+ */
+export type ProofOfOwnershipMessage = Infer<typeof ProofOfOwnershipMessageStruct>;
+/**
+ * Validates one proof-of-ownership batch request item.
+ */
+export declare const ProofOfOwnershipBatchRequestItemStruct: import("@metamask/superstruct").Struct<{
+    message: string;
+    accountId: string;
+}, {
+    accountId: import("@metamask/superstruct").Struct<string, null>;
+    message: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * One proof-of-ownership batch request item.
+ */
+export type ProofOfOwnershipBatchRequestItem = Infer<typeof ProofOfOwnershipBatchRequestItemStruct>;
+/**
+ * Validates proof-of-ownership batch request params.
+ */
+export declare const ProofOfOwnershipBatchRequestParamsStruct: import("@metamask/superstruct").Struct<{
+    items: {
+        message: string;
+        accountId: string;
+    }[];
+}, {
+    items: import("@metamask/superstruct").Struct<{
+        message: string;
+        accountId: string;
+    }[], import("@metamask/superstruct").Struct<{
+        message: string;
+        accountId: string;
+    }, {
+        accountId: import("@metamask/superstruct").Struct<string, null>;
+        message: import("@metamask/superstruct").Struct<string, null>;
+    }>>;
+}>;
+/**
+ * Proof-of-ownership batch request params.
+ */
+export type ProofOfOwnershipBatchRequestParams = Infer<typeof ProofOfOwnershipBatchRequestParamsStruct>;
+/**
+ * Validates one successful proof-of-ownership batch result.
+ */
+export declare const ProofOfOwnershipBatchSuccessStruct: import("@metamask/superstruct").Struct<{
+    accountId: string;
+    signature: string;
+}, {
+    accountId: import("@metamask/superstruct").Struct<string, null>;
+    signature: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * One successful proof-of-ownership batch result.
+ */
+export type ProofOfOwnershipBatchSuccess = Infer<typeof ProofOfOwnershipBatchSuccessStruct>;
+/**
+ * Validates one failed proof-of-ownership batch result.
+ */
+export declare const ProofOfOwnershipBatchErrorStruct: import("@metamask/superstruct").Struct<{
+    error: string;
+    accountId: string;
+}, {
+    accountId: import("@metamask/superstruct").Struct<string, null>;
+    error: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * One failed proof-of-ownership batch result.
+ */
+export type ProofOfOwnershipBatchError = Infer<typeof ProofOfOwnershipBatchErrorStruct>;
+/**
+ * Validates one proof-of-ownership batch result.
+ */
+export declare const ProofOfOwnershipBatchItemResponseStruct: import("@metamask/superstruct").Struct<{
+    accountId: string;
+    signature: string;
+} | {
+    error: string;
+    accountId: string;
+}, null>;
+/**
+ * One proof-of-ownership batch result.
+ */
+export type ProofOfOwnershipBatchItemResponse = Infer<typeof ProofOfOwnershipBatchItemResponseStruct>;
+/**
+ * Validates a proof-of-ownership batch response.
+ */
+export declare const ProofOfOwnershipBatchResponseStruct: import("@metamask/superstruct").Struct<{
+    results: ({
+        accountId: string;
+        signature: string;
+    } | {
+        error: string;
+        accountId: string;
+    })[];
+}, {
+    results: import("@metamask/superstruct").Struct<({
+        accountId: string;
+        signature: string;
+    } | {
+        error: string;
+        accountId: string;
+    })[], import("@metamask/superstruct").Struct<{
+        accountId: string;
+        signature: string;
+    } | {
+        error: string;
+        accountId: string;
+    }, null>>;
+}>;
+/**
+ * Proof-of-ownership batch response shape.
+ */
+export type ProofOfOwnershipBatchResponse = Infer<typeof ProofOfOwnershipBatchResponseStruct>;
+/**
+ * Parses a plaintext proof-of-ownership message in the format
+ * `metamask:proof-of-ownership:{nonce}:{address}`.
+ *
+ * Address validity is intentionally not checked here because it is
+ * chain-specific. Callers should validate the returned address with the
+ * relevant network/address validator.
+ *
+ * @param message - The plaintext message to parse.
+ * @returns The parsed nonce and address.
+ * @throws Error if the message format is invalid.
+ */
+export declare function parseProofOfOwnershipMessage(message: string): ProofOfOwnershipMessage;
+//# sourceMappingURL=proofOfOwnership.d.mts.map

package/dist/utils/proofOfOwnership/proofOfOwnership.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proofOfOwnership.d.mts","sourceRoot":"","sources":["../../../src/utils/proofOfOwnership/proofOfOwnership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAKnD;;GAEG;AACH,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;EAGxC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,KAAK,CACzC,OAAO,6BAA6B,CACrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sCAAsC;;;;;;EAGjD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,KAAK,CAClD,OAAO,sCAAsC,CAC9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;EAEnD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG,KAAK,CACpD,OAAO,wCAAwC,CAChD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;;EAG7C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,KAAK,CAC9C,OAAO,kCAAkC,CAC1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;EAG3C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,KAAK,CAC5C,OAAO,gCAAgC,CACxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uCAAuC;;;;;;QAGlD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG,KAAK,CACnD,OAAO,uCAAuC,CAC/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;EAE9C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,KAAK,CAC/C,OAAO,mCAAmC,CAC3C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,GACd,uBAAuB,CA2BzB"}

package/dist/utils/proofOfOwnership/proofOfOwnership.mjs

@@ -0,0 +1,85 @@
+import { array, nonempty, object, string, union } from "@metamask/superstruct";
+import { UuidStruct } from "../uuidStruct/uuidStruct.mjs";
+/**
+ * Prefix for proof-of-ownership messages signed by network snaps.
+ */
+export const PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = 'metamask:proof-of-ownership:';
+/**
+ * Validates parsed proof-of-ownership message fields.
+ */
+export const ProofOfOwnershipMessageStruct = object({
+    nonce: nonempty(string()),
+    address: nonempty(string()),
+});
+/**
+ * Validates one proof-of-ownership batch request item.
+ */
+export const ProofOfOwnershipBatchRequestItemStruct = object({
+    accountId: UuidStruct,
+    message: string(),
+});
+/**
+ * Validates proof-of-ownership batch request params.
+ */
+export const ProofOfOwnershipBatchRequestParamsStruct = object({
+    items: array(ProofOfOwnershipBatchRequestItemStruct),
+});
+/**
+ * Validates one successful proof-of-ownership batch result.
+ */
+export const ProofOfOwnershipBatchSuccessStruct = object({
+    accountId: UuidStruct,
+    signature: string(),
+});
+/**
+ * Validates one failed proof-of-ownership batch result.
+ */
+export const ProofOfOwnershipBatchErrorStruct = object({
+    accountId: UuidStruct,
+    error: nonempty(string()),
+});
+/**
+ * Validates one proof-of-ownership batch result.
+ */
+export const ProofOfOwnershipBatchItemResponseStruct = union([
+    ProofOfOwnershipBatchSuccessStruct,
+    ProofOfOwnershipBatchErrorStruct,
+]);
+/**
+ * Validates a proof-of-ownership batch response.
+ */
+export const ProofOfOwnershipBatchResponseStruct = object({
+    results: array(ProofOfOwnershipBatchItemResponseStruct),
+});
+/**
+ * Parses a plaintext proof-of-ownership message in the format
+ * `metamask:proof-of-ownership:{nonce}:{address}`.
+ *
+ * Address validity is intentionally not checked here because it is
+ * chain-specific. Callers should validate the returned address with the
+ * relevant network/address validator.
+ *
+ * @param message - The plaintext message to parse.
+ * @returns The parsed nonce and address.
+ * @throws Error if the message format is invalid.
+ */
+export function parseProofOfOwnershipMessage(message) {
+    if (!message.startsWith(PROOF_OF_OWNERSHIP_MESSAGE_PREFIX)) {
+        throw new Error(`Message must start with "${PROOF_OF_OWNERSHIP_MESSAGE_PREFIX}"`);
+    }
+    const remainder = message.slice(PROOF_OF_OWNERSHIP_MESSAGE_PREFIX.length);
+    const separatorIndex = remainder.lastIndexOf(':');
+    if (separatorIndex === -1) {
+        throw new Error('Message must follow the format "metamask:proof-of-ownership:{nonce}:{address}"');
+    }
+    const nonce = remainder.slice(0, separatorIndex);
+    const address = remainder.slice(separatorIndex + 1);
+    if (nonce.length === 0) {
+        throw new Error('Message must include a non-empty nonce');
+    }
+    if (address.length === 0) {
+        throw new Error('Message must include a non-empty address');
+    }
+    return { nonce, address };
+}
+//# sourceMappingURL=proofOfOwnership.mjs.map

package/dist/utils/proofOfOwnership/proofOfOwnership.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"proofOfOwnership.mjs","sourceRoot":"","sources":["../../../src/utils/proofOfOwnership/proofOfOwnership.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,8BAA8B;AAE/E,OAAO,EAAE,UAAU,EAAE,qCAAiC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,8BAA8B,CAAC;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC;IAClD,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;CAC5B,CAAC,CAAC;AASH;;GAEG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,MAAM,CAAC;IAC3D,SAAS,EAAE,UAAU;IACrB,OAAO,EAAE,MAAM,EAAE;CAClB,CAAC,CAAC;AASH;;GAEG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAG,MAAM,CAAC;IAC7D,KAAK,EAAE,KAAK,CAAC,sCAAsC,CAAC;CACrD,CAAC,CAAC;AASH;;GAEG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,MAAM,CAAC;IACvD,SAAS,EAAE,UAAU;IACrB,SAAS,EAAE,MAAM,EAAE;CACpB,CAAC,CAAC;AASH;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAC;IACrD,SAAS,EAAE,UAAU;IACrB,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;CAC1B,CAAC,CAAC;AASH;;GAEG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAG,KAAK,CAAC;IAC3D,kCAAkC;IAClC,gCAAgC;CACjC,CAAC,CAAC;AASH;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,MAAM,CAAC;IACxD,OAAO,EAAE,KAAK,CAAC,uCAAuC,CAAC;CACxD,CAAC,CAAC;AASH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAAe;IAEf,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iCAAiC,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,4BAA4B,iCAAiC,GAAG,CACjE,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,cAAc,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;IAEpD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC","sourcesContent":["import type { Infer } from '@metamask/superstruct';\nimport { array, nonempty, object, string, union } from '@metamask/superstruct';\n\nimport { UuidStruct } from '../uuidStruct/uuidStruct';\n\n/**\n * Prefix for proof-of-ownership messages signed by network snaps.\n */\nexport const PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = 'metamask:proof-of-ownership:';\n\n/**\n * Validates parsed proof-of-ownership message fields.\n */\nexport const ProofOfOwnershipMessageStruct = object({\n  nonce: nonempty(string()),\n  address: nonempty(string()),\n});\n\n/**\n * Parsed proof-of-ownership message fields.\n */\nexport type ProofOfOwnershipMessage = Infer<\n  typeof ProofOfOwnershipMessageStruct\n>;\n\n/**\n * Validates one proof-of-ownership batch request item.\n */\nexport const ProofOfOwnershipBatchRequestItemStruct = object({\n  accountId: UuidStruct,\n  message: string(),\n});\n\n/**\n * One proof-of-ownership batch request item.\n */\nexport type ProofOfOwnershipBatchRequestItem = Infer<\n  typeof ProofOfOwnershipBatchRequestItemStruct\n>;\n\n/**\n * Validates proof-of-ownership batch request params.\n */\nexport const ProofOfOwnershipBatchRequestParamsStruct = object({\n  items: array(ProofOfOwnershipBatchRequestItemStruct),\n});\n\n/**\n * Proof-of-ownership batch request params.\n */\nexport type ProofOfOwnershipBatchRequestParams = Infer<\n  typeof ProofOfOwnershipBatchRequestParamsStruct\n>;\n\n/**\n * Validates one successful proof-of-ownership batch result.\n */\nexport const ProofOfOwnershipBatchSuccessStruct = object({\n  accountId: UuidStruct,\n  signature: string(),\n});\n\n/**\n * One successful proof-of-ownership batch result.\n */\nexport type ProofOfOwnershipBatchSuccess = Infer<\n  typeof ProofOfOwnershipBatchSuccessStruct\n>;\n\n/**\n * Validates one failed proof-of-ownership batch result.\n */\nexport const ProofOfOwnershipBatchErrorStruct = object({\n  accountId: UuidStruct,\n  error: nonempty(string()),\n});\n\n/**\n * One failed proof-of-ownership batch result.\n */\nexport type ProofOfOwnershipBatchError = Infer<\n  typeof ProofOfOwnershipBatchErrorStruct\n>;\n\n/**\n * Validates one proof-of-ownership batch result.\n */\nexport const ProofOfOwnershipBatchItemResponseStruct = union([\n  ProofOfOwnershipBatchSuccessStruct,\n  ProofOfOwnershipBatchErrorStruct,\n]);\n\n/**\n * One proof-of-ownership batch result.\n */\nexport type ProofOfOwnershipBatchItemResponse = Infer<\n  typeof ProofOfOwnershipBatchItemResponseStruct\n>;\n\n/**\n * Validates a proof-of-ownership batch response.\n */\nexport const ProofOfOwnershipBatchResponseStruct = object({\n  results: array(ProofOfOwnershipBatchItemResponseStruct),\n});\n\n/**\n * Proof-of-ownership batch response shape.\n */\nexport type ProofOfOwnershipBatchResponse = Infer<\n  typeof ProofOfOwnershipBatchResponseStruct\n>;\n\n/**\n * Parses a plaintext proof-of-ownership message in the format\n * `metamask:proof-of-ownership:{nonce}:{address}`.\n *\n * Address validity is intentionally not checked here because it is\n * chain-specific. Callers should validate the returned address with the\n * relevant network/address validator.\n *\n * @param message - The plaintext message to parse.\n * @returns The parsed nonce and address.\n * @throws Error if the message format is invalid.\n */\nexport function parseProofOfOwnershipMessage(\n  message: string,\n): ProofOfOwnershipMessage {\n  if (!message.startsWith(PROOF_OF_OWNERSHIP_MESSAGE_PREFIX)) {\n    throw new Error(\n      `Message must start with \"${PROOF_OF_OWNERSHIP_MESSAGE_PREFIX}\"`,\n    );\n  }\n\n  const remainder = message.slice(PROOF_OF_OWNERSHIP_MESSAGE_PREFIX.length);\n  const separatorIndex = remainder.lastIndexOf(':');\n  if (separatorIndex === -1) {\n    throw new Error(\n      'Message must follow the format \"metamask:proof-of-ownership:{nonce}:{address}\"',\n    );\n  }\n\n  const nonce = remainder.slice(0, separatorIndex);\n  const address = remainder.slice(separatorIndex + 1);\n\n  if (nonce.length === 0) {\n    throw new Error('Message must include a non-empty nonce');\n  }\n\n  if (address.length === 0) {\n    throw new Error('Message must include a non-empty address');\n  }\n\n  return { nonce, address };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/snap-networks-utils",
-  "version": "1.0.0-preview-e7a796a2",
+  "version": "1.0.0-preview-2aa5deb",
   "description": "Shared utilities for MetaMask network snaps",
   "keywords": [
     "Ethereum",