@metamask-previews/snap-networks-utils 3.0.0-preview-e1350a35 → 3.0.0-preview-1421a20

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add the shared `BaseTransactionScanService` base class for network snap transaction scan services, owning the shared scan dependencies (Security Alerts API client, analytics, logger, error reporting) and the scan analytics orchestration ([#397](https://github.com/MetaMask/internal-snaps/pull/397))
+  - Add the shared Security Alerts API HTTP client for `BaseTransactionScanService`.
+
 ## [3.0.0]
 
 ### Added

package/dist/index.d.mts

@@ -2,6 +2,13 @@ export { ASSETS_PROVIDER_NAME, AssetsProvider, type AssetsProviderMessenger, } f
 export { REMOTE_FEATURE_FLAGS_PROVIDER_NAME, RemoteFeatureFlagsProvider, type RemoteFeatureFlagsProviderMessenger, } from "./providers/remote-feature-flags/RemoteFeatureFlagsProvider.mjs";
 export { AnalyticsService, SecurityEventType, TransactionEventType, } from "./services/analytics/AnalyticsService.mjs";
 export type { AnalyticsServiceOptions, SecurityAlertDetectedEventProperties, SecurityScanCompletedEventProperties, SnapTrackEventRequest, TrackEventCapableProvider, TransactionEventProperties, TransactionFinalizedEventProperties, WebSocketConnectionClosedEventProperties, } from "./services/analytics/AnalyticsService.mjs";
+export { SecurityAlertsApiClient, SECURITY_ALERTS_REQUEST_HEADERS, } from "./services/security-alerts/SecurityAlertsApiClient.mjs";
+export type { SecurityAlertsApiClientOptions } from "./services/security-alerts/SecurityAlertsApiClient.mjs";
+export { METAMASK_ORIGIN_URL, normalizeScanOrigin, SECURITY_ALERTS_SCAN_OPTIONS, SecurityAlertResponse, SecurityAlertsScanStatus, } from "./services/security-alerts/types.mjs";
+export type { SecurityAlertsScanOption } from "./services/security-alerts/types.mjs";
+export { BaseTransactionScanService } from "./services/security-alerts/BaseTransactionScanService.mjs";
+export type { BaseScanParams, BaseTransactionScanServiceOptions, SecurityScanOutcome, } from "./services/security-alerts/BaseTransactionScanService.mjs";
+export { deriveSecurityAlert, getSecurityAlertDescription, } from "./services/security-alerts/utils.mjs";
 export { safeMerge } from "./utils/safeMerge/safeMerge.mjs";
 export { resolveFlowTransactionType, resolveUnifiedSwapTransactionType, } from "./utils/transactionType/transactionType.mjs";
 export { buildUrl } from "./utils/buildUrl/buildUrl.mjs";
@@ -30,7 +37,7 @@ export { State } from "./utils/state/State.mjs";
 export type { StateConfig } from "./utils/state/State.mjs";
 export { InMemoryState } from "./utils/state/InMemoryState.mjs";
 export type { IStateManager } from "./utils/state/IStateManager.mjs";
-export { createSnapErrorHandling, createTrackError, createWithCatchAndThrowSnapError, formatAccountSyncFailures, getSyncFailuresFromSettledResult, isSnapRpcError, normalizeError, stringifyReason, SynchronizationError, } from "./utils/errors/index.mjs";
+export { createSnapErrorHandling, createTrackError, createWithCatchAndThrowSnapError, formatAccountSyncFailures, getSyncFailuresFromSettledResult, HttpError, isSnapRpcError, normalizeError, stringifyReason, SynchronizationError, } from "./utils/errors/index.mjs";
 export { InFlightCoalescer } from "./utils/dedupe/InFlightCoalescer.mjs";
 export { BrokenCircuitError, createFetchPolicy, createFetchPolicyError, FetchPolicyErrorName, isTransientError, MAX_RETRY_AFTER_MS, } from "./utils/fetchPolicy/createFetchPolicy.mjs";
 export type { CreateFetchPolicyOptions, FetchPolicyError, } from "./utils/fetchPolicy/createFetchPolicy.mjs";

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.mjs

@@ -1,6 +1,10 @@
 export { ASSETS_PROVIDER_NAME, AssetsProvider } from "./providers/assets/AssetsProvider.mjs";
 export { REMOTE_FEATURE_FLAGS_PROVIDER_NAME, RemoteFeatureFlagsProvider } from "./providers/remote-feature-flags/RemoteFeatureFlagsProvider.mjs";
 export { AnalyticsService, SecurityEventType, TransactionEventType } from "./services/analytics/AnalyticsService.mjs";
+export { SecurityAlertsApiClient, SECURITY_ALERTS_REQUEST_HEADERS } from "./services/security-alerts/SecurityAlertsApiClient.mjs";
+export { METAMASK_ORIGIN_URL, normalizeScanOrigin, SECURITY_ALERTS_SCAN_OPTIONS, SecurityAlertResponse, SecurityAlertsScanStatus } from "./services/security-alerts/types.mjs";
+export { BaseTransactionScanService } from "./services/security-alerts/BaseTransactionScanService.mjs";
+export { deriveSecurityAlert, getSecurityAlertDescription } from "./services/security-alerts/utils.mjs";
 export { safeMerge } from "./utils/safeMerge/safeMerge.mjs";
 export { resolveFlowTransactionType, resolveUnifiedSwapTransactionType } from "./utils/transactionType/transactionType.mjs";
 export { buildUrl } from "./utils/buildUrl/buildUrl.mjs";
@@ -21,7 +25,7 @@ export { createOriginPermissions, DEFAULT_PROD_ORIGINS, DEFAULT_DEV_ORIGINS, DEF
 export { validateOrigin } from "./utils/originPermissions/validateOrigin.mjs";
 export { State } from "./utils/state/State.mjs";
 export { InMemoryState } from "./utils/state/InMemoryState.mjs";
-export { createSnapErrorHandling, createTrackError, createWithCatchAndThrowSnapError, formatAccountSyncFailures, getSyncFailuresFromSettledResult, isSnapRpcError, normalizeError, stringifyReason, SynchronizationError } from "./utils/errors/index.mjs";
+export { createSnapErrorHandling, createTrackError, createWithCatchAndThrowSnapError, formatAccountSyncFailures, getSyncFailuresFromSettledResult, HttpError, isSnapRpcError, normalizeError, stringifyReason, SynchronizationError } from "./utils/errors/index.mjs";
 export { InFlightCoalescer } from "./utils/dedupe/InFlightCoalescer.mjs";
 export { BrokenCircuitError, createFetchPolicy, createFetchPolicyError, FetchPolicyErrorName, isTransientError, MAX_RETRY_AFTER_MS } from "./utils/fetchPolicy/createFetchPolicy.mjs";
 export { ActionHeader } from "./ui/ActionHeader/ActionHeader.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,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACrB,kDAA8C;AAW/C,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EAClC,oDAAgD;AACjD,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,EAAE,sBAAsB,EAAE,kDAA8C;AAK/E,OAAO,EAAE,QAAQ,EAAE,oCAAgC;AACnD,OAAO,EAAE,kBAAkB,EAAE,8CAA0C;AACvE,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EACjB,sCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,0CAAsC;AAC/D,OAAO,EACL,WAAW,EACX,iBAAiB,EAClB,6CAAyC;AAC1C,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,EAAE,KAAK,EAAE,gCAA4B;AAE5C,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAE5D,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,gCAAgC,EAChC,yBAAyB,EACzB,gCAAgC,EAChC,cAAc,EACd,cAAc,EACd,eAAe,EACf,oBAAoB,EACrB,iCAAuB;AACxB,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EACnB,kDAA8C;AAK/C,OAAO,EAAE,YAAY,EAAE,2CAAuC;AAE9D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,6BAAyB;AAEpD,OAAO,EAAE,gBAAgB,EAAE,mDAA+C;AAM1E,OAAO,EAAE,gBAAgB,EAAE,mDAA+C;AAO1E,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAC5D,OAAO,EAAE,UAAU,EAAE,qCAAiC;AACtD,OAAO,EAAE,QAAQ,EAAE,mCAA+B;AAClD,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAiB5D,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EACjB,8CAA0C","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 {\n  AnalyticsService,\n  SecurityEventType,\n  TransactionEventType,\n} from './services/analytics/AnalyticsService';\nexport type {\n  AnalyticsServiceOptions,\n  SecurityAlertDetectedEventProperties,\n  SecurityScanCompletedEventProperties,\n  SnapTrackEventRequest,\n  TrackEventCapableProvider,\n  TransactionEventProperties,\n  TransactionFinalizedEventProperties,\n  WebSocketConnectionClosedEventProperties,\n} from './services/analytics/AnalyticsService';\nexport { safeMerge } from './utils/safeMerge/safeMerge';\nexport {\n  resolveFlowTransactionType,\n  resolveUnifiedSwapTransactionType,\n} from './utils/transactionType/transactionType';\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 { asStrictKeyringAccount } from './utils/keyringAccount/keyringAccount';\nexport type {\n  ExtendedKeyringAccount,\n  KeyringAccountExtension,\n} from './utils/keyringAccount/keyringAccount';\nexport { parseEnv } from './utils/config/parseEnv';\nexport { BaseConfigProvider } from './utils/config/BaseConfigProvider';\nexport {\n  commaSeparatedListOf,\n  defaultedUrlStruct,\n  emptyToUndefined,\n  parseIntegerStruct,\n  parseFloatStruct,\n} from './utils/config/envStructs';\nexport { LogLevelStruct } from './utils/config/logLevelStruct';\nexport {\n  Environment,\n  EnvironmentStruct,\n} from './utils/config/environmentStruct';\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 { State } from './utils/state/State';\nexport type { StateConfig } from './utils/state/State';\nexport { InMemoryState } from './utils/state/InMemoryState';\nexport type { IStateManager } from './utils/state/IStateManager';\nexport {\n  createSnapErrorHandling,\n  createTrackError,\n  createWithCatchAndThrowSnapError,\n  formatAccountSyncFailures,\n  getSyncFailuresFromSettledResult,\n  isSnapRpcError,\n  normalizeError,\n  stringifyReason,\n  SynchronizationError,\n} from './utils/errors';\nexport { InFlightCoalescer } from './utils/dedupe/InFlightCoalescer';\nexport {\n  BrokenCircuitError,\n  createFetchPolicy,\n  createFetchPolicyError,\n  FetchPolicyErrorName,\n  isTransientError,\n  MAX_RETRY_AFTER_MS,\n} from './utils/fetchPolicy/createFetchPolicy';\nexport type {\n  CreateFetchPolicyOptions,\n  FetchPolicyError,\n} from './utils/fetchPolicy/createFetchPolicy';\nexport { ActionHeader } from './ui/ActionHeader/ActionHeader';\nexport type { ActionHeaderProps } from './ui/ActionHeader/ActionHeader';\nexport { Asset, AssetIcon } from './ui/Asset/Asset';\nexport type { AssetIconProps, AssetProps } from './ui/Asset/Asset';\nexport { EstimatedChanges } from './ui/EstimatedChanges/EstimatedChanges';\nexport type {\n  EstimatedChangesAsset,\n  EstimatedChangesLabels,\n  EstimatedChangesProps,\n} from './ui/EstimatedChanges/EstimatedChanges';\nexport { TransactionAlert } from './ui/TransactionAlert/TransactionAlert';\nexport type {\n  TransactionAlertError,\n  TransactionAlertLabels,\n  TransactionAlertProps,\n  TransactionAlertValidation,\n} from './ui/TransactionAlert/TransactionAlert';\nexport { InMemoryCache } from './utils/cache/InMemoryCache';\nexport { StateCache } from './utils/cache/StateCache';\nexport { useCache } from './utils/cache/useCache';\nexport { useCacheUntil } from './utils/cache/useCacheUntil';\nexport type { CacheOptions } from './utils/cache/useCache';\nexport type {\n  CacheUntilOptions,\n  ResultWithExpiry,\n} from './utils/cache/useCacheUntil';\nexport type {\n  ICache,\n  CacheEntry,\n  TimestampMilliseconds,\n} from './utils/cache/types';\nexport type {\n  CacheStateManager,\n  CacheStore,\n  CachePrefix,\n  StateValue,\n} from './utils/cache/StateCache';\nexport {\n  noopAssetHandlers,\n  wrapSnapHandlers,\n} from './utils/handlers/wrapSnapHandlers';\nexport type {\n  SnapHandlers,\n  WithCatchAndThrowSnapError,\n} from './utils/handlers/wrapSnapHandlers';\nexport type {\n  AccountSyncFailure,\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,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACrB,kDAA8C;AAW/C,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAChC,+DAA2D;AAE5D,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,4BAA4B,EAC5B,qBAAqB,EACrB,wBAAwB,EACzB,6CAAyC;AAE1C,OAAO,EAAE,0BAA0B,EAAE,kEAA8D;AAMnG,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC5B,6CAAyC;AAC1C,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EAClC,oDAAgD;AACjD,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,EAAE,sBAAsB,EAAE,kDAA8C;AAK/E,OAAO,EAAE,QAAQ,EAAE,oCAAgC;AACnD,OAAO,EAAE,kBAAkB,EAAE,8CAA0C;AACvE,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EACjB,sCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,0CAAsC;AAC/D,OAAO,EACL,WAAW,EACX,iBAAiB,EAClB,6CAAyC;AAC1C,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,EAAE,KAAK,EAAE,gCAA4B;AAE5C,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAE5D,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,gCAAgC,EAChC,yBAAyB,EACzB,gCAAgC,EAChC,SAAS,EACT,cAAc,EACd,cAAc,EACd,eAAe,EACf,oBAAoB,EACrB,iCAAuB;AACxB,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EACnB,kDAA8C;AAK/C,OAAO,EAAE,YAAY,EAAE,2CAAuC;AAE9D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,6BAAyB;AAEpD,OAAO,EAAE,gBAAgB,EAAE,mDAA+C;AAM1E,OAAO,EAAE,gBAAgB,EAAE,mDAA+C;AAO1E,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAC5D,OAAO,EAAE,UAAU,EAAE,qCAAiC;AACtD,OAAO,EAAE,QAAQ,EAAE,mCAA+B;AAClD,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAiB5D,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EACjB,8CAA0C","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 {\n  AnalyticsService,\n  SecurityEventType,\n  TransactionEventType,\n} from './services/analytics/AnalyticsService';\nexport type {\n  AnalyticsServiceOptions,\n  SecurityAlertDetectedEventProperties,\n  SecurityScanCompletedEventProperties,\n  SnapTrackEventRequest,\n  TrackEventCapableProvider,\n  TransactionEventProperties,\n  TransactionFinalizedEventProperties,\n  WebSocketConnectionClosedEventProperties,\n} from './services/analytics/AnalyticsService';\nexport {\n  SecurityAlertsApiClient,\n  SECURITY_ALERTS_REQUEST_HEADERS,\n} from './services/security-alerts/SecurityAlertsApiClient';\nexport type { SecurityAlertsApiClientOptions } from './services/security-alerts/SecurityAlertsApiClient';\nexport {\n  METAMASK_ORIGIN_URL,\n  normalizeScanOrigin,\n  SECURITY_ALERTS_SCAN_OPTIONS,\n  SecurityAlertResponse,\n  SecurityAlertsScanStatus,\n} from './services/security-alerts/types';\nexport type { SecurityAlertsScanOption } from './services/security-alerts/types';\nexport { BaseTransactionScanService } from './services/security-alerts/BaseTransactionScanService';\nexport type {\n  BaseScanParams,\n  BaseTransactionScanServiceOptions,\n  SecurityScanOutcome,\n} from './services/security-alerts/BaseTransactionScanService';\nexport {\n  deriveSecurityAlert,\n  getSecurityAlertDescription,\n} from './services/security-alerts/utils';\nexport { safeMerge } from './utils/safeMerge/safeMerge';\nexport {\n  resolveFlowTransactionType,\n  resolveUnifiedSwapTransactionType,\n} from './utils/transactionType/transactionType';\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 { asStrictKeyringAccount } from './utils/keyringAccount/keyringAccount';\nexport type {\n  ExtendedKeyringAccount,\n  KeyringAccountExtension,\n} from './utils/keyringAccount/keyringAccount';\nexport { parseEnv } from './utils/config/parseEnv';\nexport { BaseConfigProvider } from './utils/config/BaseConfigProvider';\nexport {\n  commaSeparatedListOf,\n  defaultedUrlStruct,\n  emptyToUndefined,\n  parseIntegerStruct,\n  parseFloatStruct,\n} from './utils/config/envStructs';\nexport { LogLevelStruct } from './utils/config/logLevelStruct';\nexport {\n  Environment,\n  EnvironmentStruct,\n} from './utils/config/environmentStruct';\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 { State } from './utils/state/State';\nexport type { StateConfig } from './utils/state/State';\nexport { InMemoryState } from './utils/state/InMemoryState';\nexport type { IStateManager } from './utils/state/IStateManager';\nexport {\n  createSnapErrorHandling,\n  createTrackError,\n  createWithCatchAndThrowSnapError,\n  formatAccountSyncFailures,\n  getSyncFailuresFromSettledResult,\n  HttpError,\n  isSnapRpcError,\n  normalizeError,\n  stringifyReason,\n  SynchronizationError,\n} from './utils/errors';\nexport { InFlightCoalescer } from './utils/dedupe/InFlightCoalescer';\nexport {\n  BrokenCircuitError,\n  createFetchPolicy,\n  createFetchPolicyError,\n  FetchPolicyErrorName,\n  isTransientError,\n  MAX_RETRY_AFTER_MS,\n} from './utils/fetchPolicy/createFetchPolicy';\nexport type {\n  CreateFetchPolicyOptions,\n  FetchPolicyError,\n} from './utils/fetchPolicy/createFetchPolicy';\nexport { ActionHeader } from './ui/ActionHeader/ActionHeader';\nexport type { ActionHeaderProps } from './ui/ActionHeader/ActionHeader';\nexport { Asset, AssetIcon } from './ui/Asset/Asset';\nexport type { AssetIconProps, AssetProps } from './ui/Asset/Asset';\nexport { EstimatedChanges } from './ui/EstimatedChanges/EstimatedChanges';\nexport type {\n  EstimatedChangesAsset,\n  EstimatedChangesLabels,\n  EstimatedChangesProps,\n} from './ui/EstimatedChanges/EstimatedChanges';\nexport { TransactionAlert } from './ui/TransactionAlert/TransactionAlert';\nexport type {\n  TransactionAlertError,\n  TransactionAlertLabels,\n  TransactionAlertProps,\n  TransactionAlertValidation,\n} from './ui/TransactionAlert/TransactionAlert';\nexport { InMemoryCache } from './utils/cache/InMemoryCache';\nexport { StateCache } from './utils/cache/StateCache';\nexport { useCache } from './utils/cache/useCache';\nexport { useCacheUntil } from './utils/cache/useCacheUntil';\nexport type { CacheOptions } from './utils/cache/useCache';\nexport type {\n  CacheUntilOptions,\n  ResultWithExpiry,\n} from './utils/cache/useCacheUntil';\nexport type {\n  ICache,\n  CacheEntry,\n  TimestampMilliseconds,\n} from './utils/cache/types';\nexport type {\n  CacheStateManager,\n  CacheStore,\n  CachePrefix,\n  StateValue,\n} from './utils/cache/StateCache';\nexport {\n  noopAssetHandlers,\n  wrapSnapHandlers,\n} from './utils/handlers/wrapSnapHandlers';\nexport type {\n  SnapHandlers,\n  WithCatchAndThrowSnapError,\n} from './utils/handlers/wrapSnapHandlers';\nexport type {\n  AccountSyncFailure,\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/services/security-alerts/BaseTransactionScanService.d.mts

@@ -0,0 +1,92 @@
+import type { TrackErrorFn } from "../../utils/errors/index.mjs";
+import type { Logger } from "../../utils/logger/Logger.mjs";
+import type { AnalyticsService } from "../analytics/AnalyticsService.mjs";
+import type { SecurityAlertsApiClient } from "./SecurityAlertsApiClient.mjs";
+/**
+ * Parameters identifying the origin and account a scan belongs to, resolved
+ * by the calling snap for scan analytics.
+ */
+export type BaseScanParams = {
+    /** The origin of the scan request. */
+    origin: string;
+    /** The CAIP-2 chain id of the scanned transaction. */
+    scope: string;
+    /** Type of the keyring account the scanned transaction belongs to. */
+    accountType?: string;
+};
+/**
+ * Minimal shape the analytics methods read from a completed scan result.
+ * Chain-specific scan result types must structurally satisfy it.
+ */
+export type SecurityScanOutcome = {
+    status: string;
+    validation?: {
+        type?: string | null;
+        reason?: string | null;
+    } | null;
+};
+/**
+ * Options for a {@link BaseTransactionScanService} constructor.
+ */
+export type BaseTransactionScanServiceOptions = {
+    securityAlertsApiClient: SecurityAlertsApiClient;
+    analyticsService: AnalyticsService;
+    logger: Logger;
+    /** Reports unexpected scan failures to Sentry. */
+    trackError: TrackErrorFn;
+};
+/**
+ * Base for the network snaps' transaction scan services.
+ *
+ * Owns the shared scan dependencies (Security Alerts API client, analytics,
+ * logger, error reporting) and the scan analytics orchestration. Each snap
+ * implements its own {@link scanTransaction} flow — request body, schema
+ * assertions, and response mapping are chain-specific — and calls the
+ * protected analytics methods as the scan completes or fails.
+ */
+export declare abstract class BaseTransactionScanService {
+    protected readonly securityAlertsApiClient: SecurityAlertsApiClient;
+    protected readonly analyticsService: AnalyticsService;
+    protected readonly logger: Logger;
+    protected readonly trackError: TrackErrorFn;
+    /**
+     * Creates a new base transaction scan service.
+     *
+     * @param options - The service options.
+     * @param options.securityAlertsApiClient - The shared scan API client.
+     * @param options.analyticsService - The shared analytics service.
+     * @param options.logger - The logger to use.
+     * @param options.trackError - Reports scan failures to Sentry.
+     */
+    constructor({ securityAlertsApiClient, analyticsService, logger, trackError, }: BaseTransactionScanServiceOptions);
+    /**
+     * The single scan entry point every network snap implements.
+     *
+     * Parameters are chain-specific and intentionally unconstrained here;
+     * implementations resolve to the mapped scan result, or `null` when the
+     * scan could not be performed. Analytics reporting is the implementation's
+     * responsibility, via {@link trackScanCompleted} / {@link trackScanFailed}.
+     *
+     * @param params - The chain-specific scan parameters.
+     * @returns The mapped scan result, or `null` when the scan failed.
+     */
+    abstract scanTransaction(params: unknown): Promise<SecurityScanOutcome | null>;
+    /**
+     * Tracks the analytics events of a completed scan: always a completed scan
+     * event, plus an alert-detected event when the verdict is reportable.
+     *
+     * Analytics are only tracked when the scan params carry an account type.
+     *
+     * @param params - The origin and account the scan belongs to.
+     * @param scan - The mapped scan result.
+     */
+    protected trackScanCompleted(params: BaseScanParams, scan: SecurityScanOutcome): Promise<void>;
+    /**
+     * Tracks the analytics events of a failed scan: a completed scan event with
+     * an error status, when the scan is tied to an account.
+     *
+     * @param params - The origin and account the scan belongs to.
+     */
+    protected trackScanFailed(params: BaseScanParams): Promise<void>;
+}
+//# sourceMappingURL=BaseTransactionScanService.d.mts.map

package/dist/services/security-alerts/BaseTransactionScanService.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseTransactionScanService.d.mts","sourceRoot":"","sources":["../../../src/services/security-alerts/BaseTransactionScanService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,qCAA2B;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,sCAAkC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,0CAAsC;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,sCAAkC;AAIzE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,GAAG,IAAI,CAAC;CACV,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,UAAU,EAAE,YAAY,CAAC;CAC1B,CAAC;AAEF;;;;;;;;GAQG;AACH,8BAAsB,0BAA0B;IAC9C,SAAS,CAAC,QAAQ,CAAC,uBAAuB,EAAE,uBAAuB,CAAC;IAEpE,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAEtD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAElC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAE5C;;;;;;;;OAQG;gBACS,EACV,uBAAuB,EACvB,gBAAgB,EAChB,MAAM,EACN,UAAU,GACX,EAAE,iCAAiC;IAOpC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,eAAe,CACtB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAEtC;;;;;;;;OAQG;cACa,kBAAkB,CAChC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC;IAiChB;;;;;OAKG;cACa,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAevE"}

package/dist/services/security-alerts/BaseTransactionScanService.mjs

@@ -0,0 +1,87 @@
+import { SecurityAlertsScanStatus } from "./types.mjs";
+import { deriveSecurityAlert, getSecurityAlertDescription } from "./utils.mjs";
+/**
+ * Base for the network snaps' transaction scan services.
+ *
+ * Owns the shared scan dependencies (Security Alerts API client, analytics,
+ * logger, error reporting) and the scan analytics orchestration. Each snap
+ * implements its own {@link scanTransaction} flow — request body, schema
+ * assertions, and response mapping are chain-specific — and calls the
+ * protected analytics methods as the scan completes or fails.
+ */
+export class BaseTransactionScanService {
+    securityAlertsApiClient;
+    analyticsService;
+    logger;
+    trackError;
+    /**
+     * Creates a new base transaction scan service.
+     *
+     * @param options - The service options.
+     * @param options.securityAlertsApiClient - The shared scan API client.
+     * @param options.analyticsService - The shared analytics service.
+     * @param options.logger - The logger to use.
+     * @param options.trackError - Reports scan failures to Sentry.
+     */
+    constructor({ securityAlertsApiClient, analyticsService, logger, trackError, }) {
+        this.securityAlertsApiClient = securityAlertsApiClient;
+        this.analyticsService = analyticsService;
+        this.logger = logger;
+        this.trackError = trackError;
+    }
+    /**
+     * Tracks the analytics events of a completed scan: always a completed scan
+     * event, plus an alert-detected event when the verdict is reportable.
+     *
+     * Analytics are only tracked when the scan params carry an account type.
+     *
+     * @param params - The origin and account the scan belongs to.
+     * @param scan - The mapped scan result.
+     */
+    async trackScanCompleted(params, scan) {
+        const { origin, accountType, scope } = params;
+        if (!accountType) {
+            return;
+        }
+        const securityAlert = deriveSecurityAlert(scan.validation?.type);
+        await this.analyticsService.trackSecurityScanCompleted({
+            origin,
+            accountType,
+            chainIdCaip: scope,
+            scanStatus: scan.status,
+            hasSecurityAlerts: Boolean(securityAlert),
+        });
+        if (!securityAlert) {
+            return;
+        }
+        const reason = scan.validation?.reason ?? null;
+        await this.analyticsService.trackSecurityAlertDetected({
+            origin,
+            accountType,
+            chainIdCaip: scope,
+            securityAlertResponse: securityAlert,
+            securityAlertReason: reason,
+            securityAlertDescription: getSecurityAlertDescription(reason),
+        });
+    }
+    /**
+     * Tracks the analytics events of a failed scan: a completed scan event with
+     * an error status, when the scan is tied to an account.
+     *
+     * @param params - The origin and account the scan belongs to.
+     */
+    async trackScanFailed(params) {
+        const { origin, accountType, scope } = params;
+        if (!accountType) {
+            return;
+        }
+        await this.analyticsService.trackSecurityScanCompleted({
+            origin,
+            accountType,
+            chainIdCaip: scope,
+            scanStatus: SecurityAlertsScanStatus.ERROR,
+            hasSecurityAlerts: false,
+        });
+    }
+}
+//# sourceMappingURL=BaseTransactionScanService.mjs.map

package/dist/services/security-alerts/BaseTransactionScanService.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseTransactionScanService.mjs","sourceRoot":"","sources":["../../../src/services/security-alerts/BaseTransactionScanService.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,wBAAwB,EAAE,oBAAgB;AACnD,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,oBAAgB;AAsC3E;;;;;;;;GAQG;AACH,MAAM,OAAgB,0BAA0B;IAC3B,uBAAuB,CAA0B;IAEjD,gBAAgB,CAAmB;IAEnC,MAAM,CAAS;IAEf,UAAU,CAAe;IAE5C;;;;;;;;OAQG;IACH,YAAY,EACV,uBAAuB,EACvB,gBAAgB,EAChB,MAAM,EACN,UAAU,GACwB;QAClC,IAAI,CAAC,uBAAuB,GAAG,uBAAuB,CAAC;QACvD,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAiBD;;;;;;;;OAQG;IACO,KAAK,CAAC,kBAAkB,CAChC,MAAsB,EACtB,IAAyB;QAEzB,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QAE9C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,mBAAmB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAEjE,MAAM,IAAI,CAAC,gBAAgB,CAAC,0BAA0B,CAAC;YACrD,MAAM;YACN,WAAW;YACX,WAAW,EAAE,KAAK;YAClB,UAAU,EAAE,IAAI,CAAC,MAAM;YACvB,iBAAiB,EAAE,OAAO,CAAC,aAAa,CAAC;SAC1C,CAAC,CAAC;QAEH,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,IAAI,IAAI,CAAC;QAE/C,MAAM,IAAI,CAAC,gBAAgB,CAAC,0BAA0B,CAAC;YACrD,MAAM;YACN,WAAW;YACX,WAAW,EAAE,KAAK;YAClB,qBAAqB,EAAE,aAAa;YACpC,mBAAmB,EAAE,MAAM;YAC3B,wBAAwB,EAAE,2BAA2B,CAAC,MAAM,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACO,KAAK,CAAC,eAAe,CAAC,MAAsB;QACpD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QAE9C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,gBAAgB,CAAC,0BAA0B,CAAC;YACrD,MAAM;YACN,WAAW;YACX,WAAW,EAAE,KAAK;YAClB,UAAU,EAAE,wBAAwB,CAAC,KAAK;YAC1C,iBAAiB,EAAE,KAAK;SACzB,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import type { TrackErrorFn } from '../../utils/errors';\nimport type { Logger } from '../../utils/logger/Logger';\nimport type { AnalyticsService } from '../analytics/AnalyticsService';\nimport type { SecurityAlertsApiClient } from './SecurityAlertsApiClient';\nimport { SecurityAlertsScanStatus } from './types';\nimport { deriveSecurityAlert, getSecurityAlertDescription } from './utils';\n\n/**\n * Parameters identifying the origin and account a scan belongs to, resolved\n * by the calling snap for scan analytics.\n */\nexport type BaseScanParams = {\n  /** The origin of the scan request. */\n  origin: string;\n  /** The CAIP-2 chain id of the scanned transaction. */\n  scope: string;\n  /** Type of the keyring account the scanned transaction belongs to. */\n  accountType?: string;\n};\n\n/**\n * Minimal shape the analytics methods read from a completed scan result.\n * Chain-specific scan result types must structurally satisfy it.\n */\nexport type SecurityScanOutcome = {\n  status: string;\n  validation?: {\n    type?: string | null;\n    reason?: string | null;\n  } | null;\n};\n\n/**\n * Options for a {@link BaseTransactionScanService} constructor.\n */\nexport type BaseTransactionScanServiceOptions = {\n  securityAlertsApiClient: SecurityAlertsApiClient;\n  analyticsService: AnalyticsService;\n  logger: Logger;\n  /** Reports unexpected scan failures to Sentry. */\n  trackError: TrackErrorFn;\n};\n\n/**\n * Base for the network snaps' transaction scan services.\n *\n * Owns the shared scan dependencies (Security Alerts API client, analytics,\n * logger, error reporting) and the scan analytics orchestration. Each snap\n * implements its own {@link scanTransaction} flow — request body, schema\n * assertions, and response mapping are chain-specific — and calls the\n * protected analytics methods as the scan completes or fails.\n */\nexport abstract class BaseTransactionScanService {\n  protected readonly securityAlertsApiClient: SecurityAlertsApiClient;\n\n  protected readonly analyticsService: AnalyticsService;\n\n  protected readonly logger: Logger;\n\n  protected readonly trackError: TrackErrorFn;\n\n  /**\n   * Creates a new base transaction scan service.\n   *\n   * @param options - The service options.\n   * @param options.securityAlertsApiClient - The shared scan API client.\n   * @param options.analyticsService - The shared analytics service.\n   * @param options.logger - The logger to use.\n   * @param options.trackError - Reports scan failures to Sentry.\n   */\n  constructor({\n    securityAlertsApiClient,\n    analyticsService,\n    logger,\n    trackError,\n  }: BaseTransactionScanServiceOptions) {\n    this.securityAlertsApiClient = securityAlertsApiClient;\n    this.analyticsService = analyticsService;\n    this.logger = logger;\n    this.trackError = trackError;\n  }\n\n  /**\n   * The single scan entry point every network snap implements.\n   *\n   * Parameters are chain-specific and intentionally unconstrained here;\n   * implementations resolve to the mapped scan result, or `null` when the\n   * scan could not be performed. Analytics reporting is the implementation's\n   * responsibility, via {@link trackScanCompleted} / {@link trackScanFailed}.\n   *\n   * @param params - The chain-specific scan parameters.\n   * @returns The mapped scan result, or `null` when the scan failed.\n   */\n  abstract scanTransaction(\n    params: unknown,\n  ): Promise<SecurityScanOutcome | null>;\n\n  /**\n   * Tracks the analytics events of a completed scan: always a completed scan\n   * event, plus an alert-detected event when the verdict is reportable.\n   *\n   * Analytics are only tracked when the scan params carry an account type.\n   *\n   * @param params - The origin and account the scan belongs to.\n   * @param scan - The mapped scan result.\n   */\n  protected async trackScanCompleted(\n    params: BaseScanParams,\n    scan: SecurityScanOutcome,\n  ): Promise<void> {\n    const { origin, accountType, scope } = params;\n\n    if (!accountType) {\n      return;\n    }\n\n    const securityAlert = deriveSecurityAlert(scan.validation?.type);\n\n    await this.analyticsService.trackSecurityScanCompleted({\n      origin,\n      accountType,\n      chainIdCaip: scope,\n      scanStatus: scan.status,\n      hasSecurityAlerts: Boolean(securityAlert),\n    });\n\n    if (!securityAlert) {\n      return;\n    }\n\n    const reason = scan.validation?.reason ?? null;\n\n    await this.analyticsService.trackSecurityAlertDetected({\n      origin,\n      accountType,\n      chainIdCaip: scope,\n      securityAlertResponse: securityAlert,\n      securityAlertReason: reason,\n      securityAlertDescription: getSecurityAlertDescription(reason),\n    });\n  }\n\n  /**\n   * Tracks the analytics events of a failed scan: a completed scan event with\n   * an error status, when the scan is tied to an account.\n   *\n   * @param params - The origin and account the scan belongs to.\n   */\n  protected async trackScanFailed(params: BaseScanParams): Promise<void> {\n    const { origin, accountType, scope } = params;\n\n    if (!accountType) {\n      return;\n    }\n\n    await this.analyticsService.trackSecurityScanCompleted({\n      origin,\n      accountType,\n      chainIdCaip: scope,\n      scanStatus: SecurityAlertsScanStatus.ERROR,\n      hasSecurityAlerts: false,\n    });\n  }\n}\n"]}

package/dist/services/security-alerts/SecurityAlertsApiClient.d.mts

@@ -0,0 +1,50 @@
+/**
+ * Headers sent with every Security Alerts API request.
+ */
+export declare const SECURITY_ALERTS_REQUEST_HEADERS: Record<string, string>;
+/**
+ * Options for a `SecurityAlertsApiClient` constructor.
+ */
+export type SecurityAlertsApiClientOptions = {
+    /**
+     * The full scan endpoint URL, e.g. `https://security-alerts.api.cx.metamask.io/tron/transaction/scan`.
+     */
+    scanUrl: string;
+    /** The fetch implementation to use. Defaults to `globalThis.fetch`. */
+    fetch?: typeof globalThis.fetch;
+};
+/**
+ * HTTP client for a Security Alerts API scan endpoint.
+ *
+ * Owns the request envelope shared by every chain — POSTing the JSON body,
+ * wrapping request failures, non-2xx responses, and malformed JSON bodies as
+ * {@link HttpError}, and parsing the JSON response — and nothing
+ * else.
+ *
+ * The request body is a chain-specific Blockaid contract: the caller
+ * supplies a typed body (e.g. checked with `satisfies` against a per-snap
+ * body type) and is responsible for validating the parsed response payload.
+ */
+export declare class SecurityAlertsApiClient {
+    #private;
+    /**
+     * Creates a new SecurityAlertsApiClient.
+     *
+     * @param options - The client options.
+     * @param options.scanUrl - The full scan endpoint URL. Validated once, so
+     * an invalid URL fails fast at construction.
+     * @param options.fetch - Optional fetch implementation; defaults to
+     * `globalThis.fetch`.
+     */
+    constructor({ scanUrl, fetch: fetchFn, }: SecurityAlertsApiClientOptions);
+    /**
+     * Scans a transaction by posting the request body to the scan endpoint.
+     *
+     * @param body - The chain-specific scan request body.
+     * @returns The parsed scan response.
+     * @throws HttpError if the request fails, the API responds
+     * with a non-2xx status, or the response body cannot be parsed as JSON.
+     */
+    scanTransaction(body: unknown): Promise<unknown>;
+}
+//# sourceMappingURL=SecurityAlertsApiClient.d.mts.map

package/dist/services/security-alerts/SecurityAlertsApiClient.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecurityAlertsApiClient.d.mts","sourceRoot":"","sources":["../../../src/services/security-alerts/SecurityAlertsApiClient.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGlE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,qBAAa,uBAAuB;;IAKlC;;;;;;;;OAQG;gBACS,EACV,OAAO,EACP,KAAK,EAAE,OAA0B,GAClC,EAAE,8BAA8B;IAOjC;;;;;;;OAOG;IACG,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAuBvD"}

package/dist/services/security-alerts/SecurityAlertsApiClient.mjs

@@ -0,0 +1,70 @@
+import { assert } from "@metamask/superstruct";
+import { HttpError } from "../../utils/errors/index.mjs";
+import { UrlStruct } from "../../utils/urlStruct/urlStruct.mjs";
+/**
+ * Headers sent with every Security Alerts API request.
+ */
+export const SECURITY_ALERTS_REQUEST_HEADERS = {
+    'Content-Type': 'application/json',
+    accept: 'application/json',
+};
+/**
+ * HTTP client for a Security Alerts API scan endpoint.
+ *
+ * Owns the request envelope shared by every chain — POSTing the JSON body,
+ * wrapping request failures, non-2xx responses, and malformed JSON bodies as
+ * {@link HttpError}, and parsing the JSON response — and nothing
+ * else.
+ *
+ * The request body is a chain-specific Blockaid contract: the caller
+ * supplies a typed body (e.g. checked with `satisfies` against a per-snap
+ * body type) and is responsible for validating the parsed response payload.
+ */
+export class SecurityAlertsApiClient {
+    #fetch;
+    #scanUrl;
+    /**
+     * Creates a new SecurityAlertsApiClient.
+     *
+     * @param options - The client options.
+     * @param options.scanUrl - The full scan endpoint URL. Validated once, so
+     * an invalid URL fails fast at construction.
+     * @param options.fetch - Optional fetch implementation; defaults to
+     * `globalThis.fetch`.
+     */
+    constructor({ scanUrl, fetch: fetchFn = globalThis.fetch, }) {
+        assert(scanUrl, UrlStruct);
+        this.#fetch = fetchFn;
+        this.#scanUrl = scanUrl;
+    }
+    /**
+     * Scans a transaction by posting the request body to the scan endpoint.
+     *
+     * @param body - The chain-specific scan request body.
+     * @returns The parsed scan response.
+     * @throws HttpError if the request fails, the API responds
+     * with a non-2xx status, or the response body cannot be parsed as JSON.
+     */
+    async scanTransaction(body) {
+        try {
+            const response = await this.#fetch(this.#scanUrl, {
+                headers: { ...SECURITY_ALERTS_REQUEST_HEADERS },
+                method: 'POST',
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                throw new HttpError(`HTTP error! status: ${response.status}`);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            if (error instanceof HttpError) {
+                throw error;
+            }
+            throw new HttpError('Security Alerts API error', {
+                cause: error,
+            });
+        }
+    }
+}
+//# sourceMappingURL=SecurityAlertsApiClient.mjs.map

package/dist/services/security-alerts/SecurityAlertsApiClient.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecurityAlertsApiClient.mjs","sourceRoot":"","sources":["../../../src/services/security-alerts/SecurityAlertsApiClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,8BAA8B;AAE/C,OAAO,EAAE,SAAS,EAAE,qCAA2B;AAC/C,OAAO,EAAE,SAAS,EAAE,4CAAwC;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAA2B;IACrE,cAAc,EAAE,kBAAkB;IAClC,MAAM,EAAE,kBAAkB;CAC3B,CAAC;AAcF;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,uBAAuB;IACzB,MAAM,CAA0B;IAEhC,QAAQ,CAAS;IAE1B;;;;;;;;OAQG;IACH,YAAY,EACV,OAAO,EACP,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC,KAAK,GACF;QAC/B,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAE3B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,eAAe,CAAC,IAAa;QACjC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE;gBAChD,OAAO,EAAE,EAAE,GAAG,+BAA+B,EAAE;gBAC/C,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC3B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,SAAS,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAChE,CAAC;YAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;gBAC/B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,IAAI,SAAS,CAAC,2BAA2B,EAAE;gBAC/C,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF","sourcesContent":["import { assert } from '@metamask/superstruct';\n\nimport { HttpError } from '../../utils/errors';\nimport { UrlStruct } from '../../utils/urlStruct/urlStruct';\n\n/**\n * Headers sent with every Security Alerts API request.\n */\nexport const SECURITY_ALERTS_REQUEST_HEADERS: Record<string, string> = {\n  'Content-Type': 'application/json',\n  accept: 'application/json',\n};\n\n/**\n * Options for a `SecurityAlertsApiClient` constructor.\n */\nexport type SecurityAlertsApiClientOptions = {\n  /**\n   * The full scan endpoint URL, e.g. `https://security-alerts.api.cx.metamask.io/tron/transaction/scan`.\n   */\n  scanUrl: string;\n  /** The fetch implementation to use. Defaults to `globalThis.fetch`. */\n  fetch?: typeof globalThis.fetch;\n};\n\n/**\n * HTTP client for a Security Alerts API scan endpoint.\n *\n * Owns the request envelope shared by every chain — POSTing the JSON body,\n * wrapping request failures, non-2xx responses, and malformed JSON bodies as\n * {@link HttpError}, and parsing the JSON response — and nothing\n * else.\n *\n * The request body is a chain-specific Blockaid contract: the caller\n * supplies a typed body (e.g. checked with `satisfies` against a per-snap\n * body type) and is responsible for validating the parsed response payload.\n */\nexport class SecurityAlertsApiClient {\n  readonly #fetch: typeof globalThis.fetch;\n\n  readonly #scanUrl: string;\n\n  /**\n   * Creates a new SecurityAlertsApiClient.\n   *\n   * @param options - The client options.\n   * @param options.scanUrl - The full scan endpoint URL. Validated once, so\n   * an invalid URL fails fast at construction.\n   * @param options.fetch - Optional fetch implementation; defaults to\n   * `globalThis.fetch`.\n   */\n  constructor({\n    scanUrl,\n    fetch: fetchFn = globalThis.fetch,\n  }: SecurityAlertsApiClientOptions) {\n    assert(scanUrl, UrlStruct);\n\n    this.#fetch = fetchFn;\n    this.#scanUrl = scanUrl;\n  }\n\n  /**\n   * Scans a transaction by posting the request body to the scan endpoint.\n   *\n   * @param body - The chain-specific scan request body.\n   * @returns The parsed scan response.\n   * @throws HttpError if the request fails, the API responds\n   * with a non-2xx status, or the response body cannot be parsed as JSON.\n   */\n  async scanTransaction(body: unknown): Promise<unknown> {\n    try {\n      const response = await this.#fetch(this.#scanUrl, {\n        headers: { ...SECURITY_ALERTS_REQUEST_HEADERS },\n        method: 'POST',\n        body: JSON.stringify(body),\n      });\n\n      if (!response.ok) {\n        throw new HttpError(`HTTP error! status: ${response.status}`);\n      }\n\n      return await response.json();\n    } catch (error) {\n      if (error instanceof HttpError) {\n        throw error;\n      }\n\n      throw new HttpError('Security Alerts API error', {\n        cause: error,\n      });\n    }\n  }\n}\n"]}

package/dist/services/security-alerts/types.d.mts

@@ -0,0 +1,44 @@
+/**
+ * Scan options recognized by the Security Alerts API scan endpoints.
+ *
+ * `simulation` requests an on-chain simulation of the transaction (asset
+ * diffs); `validation` requests a security verdict.
+ */
+export declare const SECURITY_ALERTS_SCAN_OPTIONS: readonly ["simulation", "validation"];
+export type SecurityAlertsScanOption = (typeof SECURITY_ALERTS_SCAN_OPTIONS)[number];
+/** Status of a completed security scan. */
+export declare const SecurityAlertsScanStatus: {
+    readonly SUCCESS: "SUCCESS";
+    readonly ERROR: "ERROR";
+};
+export type SecurityAlertsScanStatus = (typeof SecurityAlertsScanStatus)[keyof typeof SecurityAlertsScanStatus];
+/**
+ * Verdicts emitted by the Security Alerts API validation.
+ *
+ * Shared by all network snaps so scan results and analytics agree on the
+ * verdict vocabulary.
+ */
+export declare const SecurityAlertResponse: {
+    readonly Benign: "Benign";
+    readonly Warning: "Warning";
+    readonly Malicious: "Malicious";
+    readonly Error: "Error";
+};
+export type SecurityAlertResponse = (typeof SecurityAlertResponse)[keyof typeof SecurityAlertResponse];
+/**
+ * The URL substituted for the MetaMask in-app origin in scan request
+ * metadata, since the in-app browser reports no dapp URL.
+ */
+export declare const METAMASK_ORIGIN_URL = "https://metamask.io";
+/**
+ * Normalizes a dapp origin for scan request metadata.
+ *
+ * The MetaMask in-app browser reports the pseudo-origin `metamask`, which is
+ * not a usable URL; it is mapped to the MetaMask site. Other origins are
+ * returned unchanged.
+ *
+ * @param origin - The origin of the request.
+ * @returns The normalized origin.
+ */
+export declare function normalizeScanOrigin(origin: string): string;
+//# sourceMappingURL=types.d.mts.map

package/dist/services/security-alerts/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../../src/services/security-alerts/types.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,uCAG/B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD,2CAA2C;AAC3C,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;CAKxB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/services/security-alerts/types.mjs

@@ -0,0 +1,47 @@
+import { DEFAULT_METAMASK_ORIGIN } from "../../utils/originPermissions/createOriginPermissions.mjs";
+/**
+ * Scan options recognized by the Security Alerts API scan endpoints.
+ *
+ * `simulation` requests an on-chain simulation of the transaction (asset
+ * diffs); `validation` requests a security verdict.
+ */
+export const SECURITY_ALERTS_SCAN_OPTIONS = [
+    'simulation',
+    'validation',
+];
+/** Status of a completed security scan. */
+export const SecurityAlertsScanStatus = {
+    SUCCESS: 'SUCCESS',
+    ERROR: 'ERROR',
+};
+/**
+ * Verdicts emitted by the Security Alerts API validation.
+ *
+ * Shared by all network snaps so scan results and analytics agree on the
+ * verdict vocabulary.
+ */
+export const SecurityAlertResponse = {
+    Benign: 'Benign',
+    Warning: 'Warning',
+    Malicious: 'Malicious',
+    Error: 'Error',
+};
+/**
+ * The URL substituted for the MetaMask in-app origin in scan request
+ * metadata, since the in-app browser reports no dapp URL.
+ */
+export const METAMASK_ORIGIN_URL = 'https://metamask.io';
+/**
+ * Normalizes a dapp origin for scan request metadata.
+ *
+ * The MetaMask in-app browser reports the pseudo-origin `metamask`, which is
+ * not a usable URL; it is mapped to the MetaMask site. Other origins are
+ * returned unchanged.
+ *
+ * @param origin - The origin of the request.
+ * @returns The normalized origin.
+ */
+export function normalizeScanOrigin(origin) {
+    return origin === DEFAULT_METAMASK_ORIGIN ? METAMASK_ORIGIN_URL : origin;
+}
+//# sourceMappingURL=types.mjs.map

package/dist/services/security-alerts/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../../src/services/security-alerts/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,kEAA8D;AAEhG;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,YAAY;IACZ,YAAY;CACJ,CAAC;AAKX,2CAA2C;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACN,CAAC;AAKX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;CACN,CAAC;AAKX;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO,MAAM,KAAK,uBAAuB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC;AAC3E,CAAC","sourcesContent":["import { DEFAULT_METAMASK_ORIGIN } from '../../utils/originPermissions/createOriginPermissions';\n\n/**\n * Scan options recognized by the Security Alerts API scan endpoints.\n *\n * `simulation` requests an on-chain simulation of the transaction (asset\n * diffs); `validation` requests a security verdict.\n */\nexport const SECURITY_ALERTS_SCAN_OPTIONS = [\n  'simulation',\n  'validation',\n] as const;\n\nexport type SecurityAlertsScanOption =\n  (typeof SECURITY_ALERTS_SCAN_OPTIONS)[number];\n\n/** Status of a completed security scan. */\nexport const SecurityAlertsScanStatus = {\n  SUCCESS: 'SUCCESS',\n  ERROR: 'ERROR',\n} as const;\n\nexport type SecurityAlertsScanStatus =\n  (typeof SecurityAlertsScanStatus)[keyof typeof SecurityAlertsScanStatus];\n\n/**\n * Verdicts emitted by the Security Alerts API validation.\n *\n * Shared by all network snaps so scan results and analytics agree on the\n * verdict vocabulary.\n */\nexport const SecurityAlertResponse = {\n  Benign: 'Benign',\n  Warning: 'Warning',\n  Malicious: 'Malicious',\n  Error: 'Error',\n} as const;\n\nexport type SecurityAlertResponse =\n  (typeof SecurityAlertResponse)[keyof typeof SecurityAlertResponse];\n\n/**\n * The URL substituted for the MetaMask in-app origin in scan request\n * metadata, since the in-app browser reports no dapp URL.\n */\nexport const METAMASK_ORIGIN_URL = 'https://metamask.io';\n\n/**\n * Normalizes a dapp origin for scan request metadata.\n *\n * The MetaMask in-app browser reports the pseudo-origin `metamask`, which is\n * not a usable URL; it is mapped to the MetaMask site. Other origins are\n * returned unchanged.\n *\n * @param origin - The origin of the request.\n * @returns The normalized origin.\n */\nexport function normalizeScanOrigin(origin: string): string {\n  return origin === DEFAULT_METAMASK_ORIGIN ? METAMASK_ORIGIN_URL : origin;\n}\n"]}

package/dist/services/security-alerts/utils.d.mts

@@ -0,0 +1,18 @@
+/**
+ * Resolves the human-readable description of a security alert reason.
+ *
+ * @param reason - The Blockaid validation reason, if any.
+ * @returns A human-readable description of the alert.
+ */
+export declare function getSecurityAlertDescription(reason?: string | null): string;
+/**
+ * Resolves the analytics-reportable alert for a validation verdict.
+ *
+ * A verdict is reportable when the validation produced a real classification:
+ * not missing, not benign, and not an error (which means no verdict).
+ *
+ * @param type - The validation verdict, if any.
+ * @returns The reportable alert type, or null when there is nothing to report.
+ */
+export declare function deriveSecurityAlert(type?: string | null): string | null;
+//# sourceMappingURL=utils.d.mts.map

package/dist/services/security-alerts/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../../src/services/security-alerts/utils.ts"],"names":[],"mappings":"AAgCA;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAO1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAMvE"}

package/dist/services/security-alerts/utils.mjs

@@ -0,0 +1,50 @@
+import { SecurityAlertResponse } from "./types.mjs";
+/**
+ * Human-readable description suffixes for Blockaid validation reasons, shared
+ * by all network snaps so analytics descriptions agree across chains.
+ *
+ * Reasons missing from this table fall back to the raw reason.
+ *
+ * Reference: https://docs.blockaid.io/reference/response-reference
+ */
+const SECURITY_ALERT_REASON_DESCRIPTIONS = {
+    unfair_trade: "Unfair trade of assets, without adequate compensation to the owner's account",
+    transfer_farming: "Substantial transfer of the account's assets to untrusted entities",
+    writable_accounts_farming: 'Transaction exposes unused writable account, can be utilized in BIT-FLIP attacks patterns',
+    native_ownership_change: 'The account transferred ownership of its native SOL to untrusted entities',
+    spl_token_ownership_change: 'The account transferred ownership of its SPL tokens to untrusted entities',
+    exposure_farming: 'The account delegates ownership, thereby exposing its assets to untrusted spenders',
+    known_attacker: "A known attacker's account is involved in the transaction",
+    invalid_signature: 'One of the transactions provided contains non valid signatures, that can lead misleading simulation results',
+    honeypot: 'The account invests funds in a token that is part of an orchestrated honeypot scheme',
+    other: 'The transaction was marked as malicious for other reason, further details would be described in features field',
+};
+/**
+ * Resolves the human-readable description of a security alert reason.
+ *
+ * @param reason - The Blockaid validation reason, if any.
+ * @returns A human-readable description of the alert.
+ */
+export function getSecurityAlertDescription(reason) {
+    const suffix = SECURITY_ALERT_REASON_DESCRIPTIONS[reason ?? ''] ??
+        reason ??
+        'Unknown reason';
+    return `Security alert: ${suffix}`;
+}
+/**
+ * Resolves the analytics-reportable alert for a validation verdict.
+ *
+ * A verdict is reportable when the validation produced a real classification:
+ * not missing, not benign, and not an error (which means no verdict).
+ *
+ * @param type - The validation verdict, if any.
+ * @returns The reportable alert type, or null when there is nothing to report.
+ */
+export function deriveSecurityAlert(type) {
+    return type &&
+        type !== SecurityAlertResponse.Benign &&
+        type !== SecurityAlertResponse.Error
+        ? type
+        : null;
+}
+//# sourceMappingURL=utils.mjs.map

package/dist/services/security-alerts/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../../../src/services/security-alerts/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,oBAAgB;AAEhD;;;;;;;GAOG;AACH,MAAM,kCAAkC,GAA2B;IACjE,YAAY,EACV,8EAA8E;IAChF,gBAAgB,EACd,oEAAoE;IACtE,yBAAyB,EACvB,2FAA2F;IAC7F,uBAAuB,EACrB,2EAA2E;IAC7E,0BAA0B,EACxB,2EAA2E;IAC7E,gBAAgB,EACd,oFAAoF;IACtF,cAAc,EAAE,2DAA2D;IAC3E,iBAAiB,EACf,6GAA6G;IAC/G,QAAQ,EACN,sFAAsF;IACxF,KAAK,EACH,gHAAgH;CACnH,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAsB;IAChE,MAAM,MAAM,GACV,kCAAkC,CAAC,MAAM,IAAI,EAAE,CAAC;QAChD,MAAM;QACN,gBAAgB,CAAC;IAEnB,OAAO,mBAAmB,MAAM,EAAE,CAAC;AACrC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAoB;IACtD,OAAO,IAAI;QACT,IAAI,KAAK,qBAAqB,CAAC,MAAM;QACrC,IAAI,KAAK,qBAAqB,CAAC,KAAK;QACpC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC;AACX,CAAC","sourcesContent":["import { SecurityAlertResponse } from './types';\n\n/**\n * Human-readable description suffixes for Blockaid validation reasons, shared\n * by all network snaps so analytics descriptions agree across chains.\n *\n * Reasons missing from this table fall back to the raw reason.\n *\n * Reference: https://docs.blockaid.io/reference/response-reference\n */\nconst SECURITY_ALERT_REASON_DESCRIPTIONS: Record<string, string> = {\n  unfair_trade:\n    \"Unfair trade of assets, without adequate compensation to the owner's account\",\n  transfer_farming:\n    \"Substantial transfer of the account's assets to untrusted entities\",\n  writable_accounts_farming:\n    'Transaction exposes unused writable account, can be utilized in BIT-FLIP attacks patterns',\n  native_ownership_change:\n    'The account transferred ownership of its native SOL to untrusted entities',\n  spl_token_ownership_change:\n    'The account transferred ownership of its SPL tokens to untrusted entities',\n  exposure_farming:\n    'The account delegates ownership, thereby exposing its assets to untrusted spenders',\n  known_attacker: \"A known attacker's account is involved in the transaction\",\n  invalid_signature:\n    'One of the transactions provided contains non valid signatures, that can lead misleading simulation results',\n  honeypot:\n    'The account invests funds in a token that is part of an orchestrated honeypot scheme',\n  other:\n    'The transaction was marked as malicious for other reason, further details would be described in features field',\n};\n\n/**\n * Resolves the human-readable description of a security alert reason.\n *\n * @param reason - The Blockaid validation reason, if any.\n * @returns A human-readable description of the alert.\n */\nexport function getSecurityAlertDescription(reason?: string | null): string {\n  const suffix =\n    SECURITY_ALERT_REASON_DESCRIPTIONS[reason ?? ''] ??\n    reason ??\n    'Unknown reason';\n\n  return `Security alert: ${suffix}`;\n}\n\n/**\n * Resolves the analytics-reportable alert for a validation verdict.\n *\n * A verdict is reportable when the validation produced a real classification:\n * not missing, not benign, and not an error (which means no verdict).\n *\n * @param type - The validation verdict, if any.\n * @returns The reportable alert type, or null when there is nothing to report.\n */\nexport function deriveSecurityAlert(type?: string | null): string | null {\n  return type &&\n    type !== SecurityAlertResponse.Benign &&\n    type !== SecurityAlertResponse.Error\n    ? type\n    : null;\n}\n"]}

package/dist/utils/errors/httpError.d.mts

@@ -0,0 +1,20 @@
+/**
+ * Error thrown when an HTTP request to an API fails: the request could not
+ * be completed, the API responded with a non-2xx status, or a 2xx response
+ * body could not be parsed as JSON.
+ *
+ * The original error, when there is one, is available as `cause` (e.g. a
+ * `TypeError` for a network failure or a `SyntaxError` for an unparseable
+ * response body).
+ */
+export declare class HttpError extends Error {
+    /**
+     * Construct a new HTTP error.
+     *
+     * @param message - The error message, e.g. `'HTTP error! status: 503'`.
+     * @param options - Additional error options.
+     * @param options.cause - The underlying error that caused the failure, if any.
+     */
+    constructor(message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=httpError.d.mts.map

package/dist/utils/errors/httpError.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpError.d.mts","sourceRoot":"","sources":["../../../src/utils/errors/httpError.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC;;;;;;OAMG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD"}

package/dist/utils/errors/httpError.mjs

@@ -0,0 +1,23 @@
+/**
+ * Error thrown when an HTTP request to an API fails: the request could not
+ * be completed, the API responded with a non-2xx status, or a 2xx response
+ * body could not be parsed as JSON.
+ *
+ * The original error, when there is one, is available as `cause` (e.g. a
+ * `TypeError` for a network failure or a `SyntaxError` for an unparseable
+ * response body).
+ */
+export class HttpError extends Error {
+    /**
+     * Construct a new HTTP error.
+     *
+     * @param message - The error message, e.g. `'HTTP error! status: 503'`.
+     * @param options - Additional error options.
+     * @param options.cause - The underlying error that caused the failure, if any.
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'HttpError';
+    }
+}
+//# sourceMappingURL=httpError.mjs.map

package/dist/utils/errors/httpError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpError.mjs","sourceRoot":"","sources":["../../../src/utils/errors/httpError.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC;;;;;;OAMG;IACH,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF","sourcesContent":["/**\n * Error thrown when an HTTP request to an API fails: the request could not\n * be completed, the API responded with a non-2xx status, or a 2xx response\n * body could not be parsed as JSON.\n *\n * The original error, when there is one, is available as `cause` (e.g. a\n * `TypeError` for a network failure or a `SyntaxError` for an unparseable\n * response body).\n */\nexport class HttpError extends Error {\n  /**\n   * Construct a new HTTP error.\n   *\n   * @param message - The error message, e.g. `'HTTP error! status: 503'`.\n   * @param options - Additional error options.\n   * @param options.cause - The underlying error that caused the failure, if any.\n   */\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = 'HttpError';\n  }\n}\n"]}

package/dist/utils/errors/index.d.mts

@@ -1,4 +1,5 @@
 export { createSnapErrorHandling, createTrackError } from "./trackError.mjs";
+export { HttpError } from "./httpError.mjs";
 export { SynchronizationError, formatAccountSyncFailures, getSyncFailuresFromSettledResult, } from "./syncError.mjs";
 export type { AccountSyncFailure } from "./syncError.mjs";
 export { createWithCatchAndThrowSnapError, normalizeError } from "./errors.mjs";

package/dist/utils/errors/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,yBAAqB;AACzE,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,GACjC,wBAAoB;AACrB,YAAY,EAAE,kBAAkB,EAAE,wBAAoB;AACtD,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,qBAAiB;AAC5E,OAAO,EAAE,eAAe,EAAE,8BAA0B;AACpD,OAAO,EAAE,cAAc,EAAE,2BAAuB;AAChD,YAAY,EACV,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,GAC1B,yBAAqB;AACtB,YAAY,EACV,uCAAuC,EACvC,UAAU,EACV,gBAAgB,EAChB,YAAY,GACb,qBAAiB;AAClB,YAAY,EAAE,YAAY,EAAE,2BAAuB"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,yBAAqB;AACzE,OAAO,EAAE,SAAS,EAAE,wBAAoB;AACxC,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,GACjC,wBAAoB;AACrB,YAAY,EAAE,kBAAkB,EAAE,wBAAoB;AACtD,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,qBAAiB;AAC5E,OAAO,EAAE,eAAe,EAAE,8BAA0B;AACpD,OAAO,EAAE,cAAc,EAAE,2BAAuB;AAChD,YAAY,EACV,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,GAC1B,yBAAqB;AACtB,YAAY,EACV,uCAAuC,EACvC,UAAU,EACV,gBAAgB,EAChB,YAAY,GACb,qBAAiB;AAClB,YAAY,EAAE,YAAY,EAAE,2BAAuB"}

package/dist/utils/errors/index.mjs

@@ -1,4 +1,5 @@
 export { createSnapErrorHandling, createTrackError } from "./trackError.mjs";
+export { HttpError } from "./httpError.mjs";
 export { SynchronizationError, formatAccountSyncFailures, getSyncFailuresFromSettledResult } from "./syncError.mjs";
 export { createWithCatchAndThrowSnapError, normalizeError } from "./errors.mjs";
 export { stringifyReason } from "./stringifyReason.mjs";

package/dist/utils/errors/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,yBAAqB;AACzE,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,EACjC,wBAAoB;AAErB,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,qBAAiB;AAC5E,OAAO,EAAE,eAAe,EAAE,8BAA0B;AACpD,OAAO,EAAE,cAAc,EAAE,2BAAuB","sourcesContent":["export { createSnapErrorHandling, createTrackError } from './trackError';\nexport {\n  SynchronizationError,\n  formatAccountSyncFailures,\n  getSyncFailuresFromSettledResult,\n} from './syncError';\nexport type { AccountSyncFailure } from './syncError';\nexport { createWithCatchAndThrowSnapError, normalizeError } from './errors';\nexport { stringifyReason } from './stringifyReason';\nexport { isSnapRpcError } from './snapRpcError';\nexport type {\n  CreateSnapErrorHandlingOptions,\n  CreateTrackErrorOptions,\n  PrepareErrorForTrackingFn,\n  ShouldTrackErrorFn,\n  SnapTrackErrorRequest,\n  TrackErrorCapableProvider,\n} from './trackError';\nexport type {\n  CreateWithCatchAndThrowSnapErrorOptions,\n  LogErrorFn,\n  NormalizeErrorFn,\n  TrackErrorFn,\n} from './errors';\nexport type { SnapRpcError } from './snapRpcError';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,yBAAqB;AACzE,OAAO,EAAE,SAAS,EAAE,wBAAoB;AACxC,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,EACjC,wBAAoB;AAErB,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,qBAAiB;AAC5E,OAAO,EAAE,eAAe,EAAE,8BAA0B;AACpD,OAAO,EAAE,cAAc,EAAE,2BAAuB","sourcesContent":["export { createSnapErrorHandling, createTrackError } from './trackError';\nexport { HttpError } from './httpError';\nexport {\n  SynchronizationError,\n  formatAccountSyncFailures,\n  getSyncFailuresFromSettledResult,\n} from './syncError';\nexport type { AccountSyncFailure } from './syncError';\nexport { createWithCatchAndThrowSnapError, normalizeError } from './errors';\nexport { stringifyReason } from './stringifyReason';\nexport { isSnapRpcError } from './snapRpcError';\nexport type {\n  CreateSnapErrorHandlingOptions,\n  CreateTrackErrorOptions,\n  PrepareErrorForTrackingFn,\n  ShouldTrackErrorFn,\n  SnapTrackErrorRequest,\n  TrackErrorCapableProvider,\n} from './trackError';\nexport type {\n  CreateWithCatchAndThrowSnapErrorOptions,\n  LogErrorFn,\n  NormalizeErrorFn,\n  TrackErrorFn,\n} from './errors';\nexport type { SnapRpcError } from './snapRpcError';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/snap-networks-utils",
-  "version": "3.0.0-preview-e1350a35",
+  "version": "3.0.0-preview-1421a20",
   "description": "Shared utilities for MetaMask network snaps",
   "keywords": [
     "Ethereum",
@@ -63,7 +63,7 @@
     "@metamask/base-data-service": "^2.1.0",
     "@metamask/keyring-api": "^24.1.0",
     "@metamask/keyring-internal-api": "^12.0.0",
-    "@metamask/remote-feature-flag-controller": "^7.0.0",
+    "@metamask/remote-feature-flag-controller": "^5.0.0",
     "@metamask/snaps-sdk": "^12.0.1",
     "@metamask/superstruct": "^3.4.1",
     "@metamask/utils": "^11.11.0",