@formo/analytics-react-native 0.1.0

package/lib/commonjs/lib/wagmi/WagmiEventHandler.js

@@ -0,0 +1,445 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.WagmiEventHandler = void 0;
+var _events = require("../../types/events");
+var _logger = require("../logger");
+/**
+ * WagmiEventHandler for React Native
+ *
+ * Handles wallet event tracking by hooking into Wagmi v2's config.subscribe()
+ * and TanStack Query's MutationCache.
+ */
+
+// Interface for FormoAnalytics to avoid circular dependency
+
+class WagmiEventHandler {
+  unsubscribers = [];
+  trackingState = {
+    isProcessing: false
+  };
+  processedMutations = new Set();
+  pendingStatusChanges = [];
+  constructor(formoAnalytics, wagmiConfig, queryClient) {
+    this.formo = formoAnalytics;
+    this.wagmiConfig = wagmiConfig;
+    this.queryClient = queryClient;
+    _logger.logger.info("WagmiEventHandler: Initializing Wagmi integration");
+    this.setupConnectionListeners();
+    if (this.queryClient) {
+      this.setupMutationTracking();
+    } else {
+      _logger.logger.warn("WagmiEventHandler: QueryClient not provided, signature and transaction events will not be tracked");
+    }
+  }
+
+  /**
+   * Set up listeners for wallet connection, disconnection, and chain changes
+   */
+  setupConnectionListeners() {
+    _logger.logger.info("WagmiEventHandler: Setting up connection listeners");
+
+    // Subscribe to status changes
+    const statusUnsubscribe = this.wagmiConfig.subscribe(state => state.status, (status, prevStatus) => {
+      this.handleStatusChange(status, prevStatus);
+    });
+    this.unsubscribers.push(statusUnsubscribe);
+
+    // Subscribe to chain ID changes
+    const chainIdUnsubscribe = this.wagmiConfig.subscribe(state => state.chainId, (chainId, prevChainId) => {
+      this.handleChainChange(chainId, prevChainId);
+    });
+    this.unsubscribers.push(chainIdUnsubscribe);
+    _logger.logger.info("WagmiEventHandler: Connection listeners set up successfully");
+  }
+
+  // Maximum pending status changes to prevent unbounded queue growth
+  static MAX_PENDING_STATUS_CHANGES = 10;
+
+  /**
+   * Handle status changes (connect/disconnect)
+   */
+  async handleStatusChange(status, prevStatus) {
+    if (this.trackingState.isProcessing) {
+      // Limit queue size to prevent unbounded growth during rapid status changes
+      if (this.pendingStatusChanges.length >= WagmiEventHandler.MAX_PENDING_STATUS_CHANGES) {
+        _logger.logger.warn("WagmiEventHandler: Pending status change queue full, dropping oldest");
+        this.pendingStatusChanges.shift();
+      }
+      // Queue status change to process after current one completes
+      this.pendingStatusChanges.push({
+        status,
+        prevStatus
+      });
+      _logger.logger.debug("WagmiEventHandler: Queuing status change for later processing");
+      return;
+    }
+    this.trackingState.isProcessing = true;
+    try {
+      // Process current status change
+      await this.processStatusChange(status, prevStatus);
+
+      // Process pending status changes iteratively (inline, no recursion)
+      while (this.pendingStatusChanges.length > 0) {
+        const pending = this.pendingStatusChanges.shift();
+        await this.processStatusChange(pending.status, pending.prevStatus);
+      }
+    } finally {
+      this.trackingState.isProcessing = false;
+    }
+  }
+
+  /**
+   * Process a single status change (extracted for iterative processing)
+   */
+  async processStatusChange(status, prevStatus) {
+    try {
+      const state = this.getState();
+      const address = this.getConnectedAddress(state);
+      const chainId = state.chainId;
+      _logger.logger.info("WagmiEventHandler: Status changed", {
+        status,
+        prevStatus,
+        address,
+        chainId
+      });
+
+      // Handle disconnect
+      if (status === "disconnected" && prevStatus === "connected") {
+        if (this.formo.isAutocaptureEnabled("disconnect")) {
+          await this.formo.disconnect({
+            chainId: this.trackingState.lastChainId,
+            address: this.trackingState.lastAddress
+          });
+        }
+        this.trackingState.lastAddress = undefined;
+        this.trackingState.lastChainId = undefined;
+      }
+
+      // Handle connect
+      if (status === "connected" && prevStatus !== "connected") {
+        if (address && chainId !== undefined) {
+          this.trackingState.lastAddress = address;
+          this.trackingState.lastChainId = chainId;
+          if (this.formo.isAutocaptureEnabled("connect")) {
+            const connectorName = this.getConnectorName(state);
+            const connectorId = this.getConnectorId(state);
+            await this.formo.connect({
+              chainId,
+              address
+            }, {
+              ...(connectorName && {
+                providerName: connectorName
+              }),
+              // Connector ID is typically the rdns for EIP-6963 wallets
+              ...(connectorId && {
+                rdns: connectorId
+              })
+            });
+          }
+        }
+      }
+      this.trackingState.lastStatus = status;
+    } catch (error) {
+      _logger.logger.error("WagmiEventHandler: Error handling status change:", error);
+    }
+  }
+
+  /**
+   * Handle chain ID changes
+   */
+  async handleChainChange(chainId, prevChainId) {
+    // Skip if no change, chainId is undefined, or this is initial connection (prevChainId undefined)
+    if (chainId === prevChainId || chainId === undefined || prevChainId === undefined) {
+      return;
+    }
+    const state = this.getState();
+    if (state.status !== "connected") {
+      return;
+    }
+    const address = this.getConnectedAddress(state);
+    if (!address) {
+      _logger.logger.warn("WagmiEventHandler: Chain changed but no address found");
+      return;
+    }
+    _logger.logger.info("WagmiEventHandler: Chain changed", {
+      chainId,
+      prevChainId,
+      address
+    });
+    this.trackingState.lastChainId = chainId;
+    if (this.formo.isAutocaptureEnabled("chain")) {
+      try {
+        await this.formo.chain({
+          chainId,
+          address
+        });
+      } catch (error) {
+        _logger.logger.error("WagmiEventHandler: Error tracking chain change:", error);
+      }
+    }
+  }
+
+  /**
+   * Set up mutation tracking for signatures and transactions
+   */
+  setupMutationTracking() {
+    if (!this.queryClient) {
+      return;
+    }
+    _logger.logger.info("WagmiEventHandler: Setting up mutation tracking");
+    const mutationCache = this.queryClient.getMutationCache();
+    const unsubscribe = mutationCache.subscribe(event => {
+      this.handleMutationEvent(event);
+    });
+    this.unsubscribers.push(unsubscribe);
+    _logger.logger.info("WagmiEventHandler: Mutation tracking set up successfully");
+  }
+
+  /**
+   * Handle mutation cache events
+   */
+  handleMutationEvent(event) {
+    if (event.type !== "updated") {
+      return;
+    }
+    const mutation = event.mutation;
+    const mutationKey = mutation.options.mutationKey;
+    if (!mutationKey || mutationKey.length === 0) {
+      return;
+    }
+    const mutationType = mutationKey[0];
+    const state = mutation.state;
+    const mutationStateKey = `${mutation.mutationId}:${state.status}`;
+    if (this.processedMutations.has(mutationStateKey)) {
+      return;
+    }
+    this.processedMutations.add(mutationStateKey);
+    _logger.logger.debug("WagmiEventHandler: Mutation event", {
+      mutationType,
+      mutationId: mutation.mutationId,
+      status: state.status
+    });
+    if (mutationType === "signMessage" || mutationType === "signTypedData") {
+      this.handleSignatureMutation(mutationType, mutation);
+    }
+    if (mutationType === "sendTransaction" || mutationType === "writeContract") {
+      this.handleTransactionMutation(mutationType, mutation);
+    }
+
+    // Cleanup old mutations
+    if (this.processedMutations.size > 1000) {
+      const entries = Array.from(this.processedMutations);
+      for (let i = 0; i < 500; i++) {
+        const entry = entries[i];
+        if (entry) {
+          this.processedMutations.delete(entry);
+        }
+      }
+    }
+  }
+
+  /**
+   * Handle signature mutations
+   */
+  handleSignatureMutation(mutationType, mutation) {
+    if (!this.formo.isAutocaptureEnabled("signature")) {
+      return;
+    }
+    const state = mutation.state;
+    const variables = state.variables || {};
+    const chainId = this.trackingState.lastChainId;
+    const address = this.trackingState.lastAddress;
+    if (!address) {
+      _logger.logger.warn("WagmiEventHandler: Signature event but no address available");
+      return;
+    }
+    if (!chainId || chainId === 0) {
+      _logger.logger.warn("WagmiEventHandler: Signature event but no valid chainId available");
+      return;
+    }
+    try {
+      let status;
+      let signatureHash;
+      if (state.status === "pending") {
+        status = _events.SignatureStatus.REQUESTED;
+      } else if (state.status === "success") {
+        status = _events.SignatureStatus.CONFIRMED;
+        signatureHash = state.data;
+      } else if (state.status === "error") {
+        status = _events.SignatureStatus.REJECTED;
+      } else {
+        return;
+      }
+      let message;
+      if (mutationType === "signMessage") {
+        message = variables.message || "";
+      } else {
+        message = JSON.stringify(variables.message || variables.types || {});
+      }
+      _logger.logger.info("WagmiEventHandler: Tracking signature event", {
+        status,
+        mutationType,
+        address,
+        chainId
+      });
+      this.formo.signature({
+        status,
+        chainId,
+        address,
+        message,
+        ...(signatureHash && {
+          signatureHash
+        })
+      }).catch(error => {
+        _logger.logger.error("WagmiEventHandler: Error tracking signature:", error);
+      });
+    } catch (error) {
+      _logger.logger.error("WagmiEventHandler: Error handling signature mutation:", error);
+    }
+  }
+
+  /**
+   * Handle transaction mutations
+   */
+  handleTransactionMutation(mutationType, mutation) {
+    if (!this.formo.isAutocaptureEnabled("transaction")) {
+      return;
+    }
+    const state = mutation.state;
+    const variables = state.variables || {};
+    const chainId = this.trackingState.lastChainId || variables.chainId;
+    // Only use variables.account as fallback, not variables.address which is the contract address
+    const address = this.trackingState.lastAddress || variables.account;
+    if (!address) {
+      _logger.logger.warn("WagmiEventHandler: Transaction event but no address available");
+      return;
+    }
+    if (!chainId || chainId === 0) {
+      _logger.logger.warn("WagmiEventHandler: Transaction event but no valid chainId available");
+      return;
+    }
+    try {
+      let status;
+      let transactionHash;
+      if (state.status === "pending") {
+        status = _events.TransactionStatus.STARTED;
+      } else if (state.status === "success") {
+        status = _events.TransactionStatus.BROADCASTED;
+        transactionHash = state.data;
+      } else if (state.status === "error") {
+        status = _events.TransactionStatus.REJECTED;
+      } else {
+        return;
+      }
+      const data = variables.data;
+      const to = variables.to || variables.address;
+      const value = variables.value?.toString();
+      _logger.logger.info("WagmiEventHandler: Tracking transaction event", {
+        status,
+        mutationType,
+        address,
+        chainId,
+        transactionHash
+      });
+      this.formo.transaction({
+        status,
+        chainId,
+        address,
+        ...(data && {
+          data
+        }),
+        ...(to && {
+          to
+        }),
+        ...(value && {
+          value
+        }),
+        ...(transactionHash && {
+          transactionHash
+        })
+      }).catch(error => {
+        _logger.logger.error("WagmiEventHandler: Error tracking transaction:", error);
+      });
+    } catch (error) {
+      _logger.logger.error("WagmiEventHandler: Error handling transaction mutation:", error);
+    }
+  }
+
+  /**
+   * Get current Wagmi state
+   */
+  getState() {
+    if (typeof this.wagmiConfig.getState === "function") {
+      return this.wagmiConfig.getState();
+    }
+    if (this.wagmiConfig.state) {
+      return this.wagmiConfig.state;
+    }
+    _logger.logger.warn("WagmiEventHandler: Unable to get state from config, returning default state");
+    return {
+      status: "disconnected",
+      connections: new Map(),
+      current: undefined,
+      chainId: undefined
+    };
+  }
+
+  /**
+   * Get connected address from state
+   */
+  getConnectedAddress(state) {
+    if (!state.current) {
+      return undefined;
+    }
+    const connection = state.connections.get(state.current);
+    if (!connection || connection.accounts.length === 0) {
+      return undefined;
+    }
+    return connection.accounts[0];
+  }
+
+  /**
+   * Get connector name from state
+   */
+  getConnectorName(state) {
+    if (!state.current) {
+      return undefined;
+    }
+    const connection = state.connections.get(state.current);
+    return connection?.connector.name;
+  }
+
+  /**
+   * Get connector ID from state (typically the rdns for EIP-6963 wallets)
+   */
+  getConnectorId(state) {
+    if (!state.current) {
+      return undefined;
+    }
+    const connection = state.connections.get(state.current);
+    return connection?.connector.id;
+  }
+
+  /**
+   * Clean up subscriptions
+   */
+  cleanup() {
+    _logger.logger.info("WagmiEventHandler: Cleaning up subscriptions");
+    for (const unsubscribe of this.unsubscribers) {
+      try {
+        unsubscribe();
+      } catch (error) {
+        _logger.logger.error("WagmiEventHandler: Error during cleanup:", error);
+      }
+    }
+    this.unsubscribers = [];
+    this.processedMutations.clear();
+    this.pendingStatusChanges = [];
+    _logger.logger.info("WagmiEventHandler: Cleanup complete");
+  }
+}
+exports.WagmiEventHandler = WagmiEventHandler;
+//# sourceMappingURL=WagmiEventHandler.js.map

package/lib/commonjs/lib/wagmi/WagmiEventHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_events","require","_logger","WagmiEventHandler","unsubscribers","trackingState","isProcessing","processedMutations","Set","pendingStatusChanges","constructor","formoAnalytics","wagmiConfig","queryClient","formo","logger","info","setupConnectionListeners","setupMutationTracking","warn","statusUnsubscribe","subscribe","state","status","prevStatus","handleStatusChange","push","chainIdUnsubscribe","chainId","prevChainId","handleChainChange","MAX_PENDING_STATUS_CHANGES","length","shift","debug","processStatusChange","pending","getState","address","getConnectedAddress","isAutocaptureEnabled","disconnect","lastChainId","lastAddress","undefined","connectorName","getConnectorName","connectorId","getConnectorId","connect","providerName","rdns","lastStatus","error","chain","mutationCache","getMutationCache","unsubscribe","event","handleMutationEvent","type","mutation","mutationKey","options","mutationType","mutationStateKey","mutationId","has","add","handleSignatureMutation","handleTransactionMutation","size","entries","Array","from","i","entry","delete","variables","signatureHash","SignatureStatus","REQUESTED","CONFIRMED","data","REJECTED","message","JSON","stringify","types","signature","catch","account","transactionHash","TransactionStatus","STARTED","BROADCASTED","to","value","toString","transaction","connections","Map","current","connection","get","accounts","connector","name","id","cleanup","clear","exports"],"sourceRoot":"../../../../src","sources":["lib/wagmi/WagmiEventHandler.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/lib/wagmi/index.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _WagmiEventHandler = require("./WagmiEventHandler");
+Object.keys(_WagmiEventHandler).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _WagmiEventHandler[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _WagmiEventHandler[key];
+    }
+  });
+});
+var _types = require("./types");
+Object.keys(_types).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _types[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _types[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

package/lib/commonjs/lib/wagmi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_WagmiEventHandler","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_types"],"sourceRoot":"../../../../src","sources":["lib/wagmi/index.ts"],"mappings":";;;;;AAAA,IAAAA,kBAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,kBAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,kBAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,kBAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,MAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,MAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,MAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,MAAA,CAAAL,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/lib/commonjs/lib/wagmi/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/commonjs/lib/wagmi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["lib/wagmi/types.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/base.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=base.js.map

package/lib/commonjs/types/base.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/base.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/events.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TransactionStatus = exports.SignatureStatus = void 0;
+//#region Specific Event Types
+let SignatureStatus = exports.SignatureStatus = /*#__PURE__*/function (SignatureStatus) {
+  SignatureStatus["REQUESTED"] = "requested";
+  SignatureStatus["REJECTED"] = "rejected";
+  SignatureStatus["CONFIRMED"] = "confirmed";
+  return SignatureStatus;
+}({});
+let TransactionStatus = exports.TransactionStatus = /*#__PURE__*/function (TransactionStatus) {
+  TransactionStatus["STARTED"] = "started";
+  TransactionStatus["REJECTED"] = "rejected";
+  TransactionStatus["BROADCASTED"] = "broadcasted";
+  TransactionStatus["CONFIRMED"] = "confirmed";
+  TransactionStatus["REVERTED"] = "reverted";
+  return TransactionStatus;
+}({});
+//# sourceMappingURL=events.js.map

package/lib/commonjs/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SignatureStatus","exports","TransactionStatus"],"sourceRoot":"../../../src","sources":["types/events.ts"],"mappings":";;;;;;AAyCA;AAAA,IAsFYA,eAAe,GAAAC,OAAA,CAAAD,eAAA,0BAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAA,OAAfA,eAAe;AAAA;AAAA,IAMfE,iBAAiB,GAAAD,OAAA,CAAAC,iBAAA,0BAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAA,OAAjBA,iBAAiB;AAAA","ignoreList":[]}

package/lib/commonjs/types/index.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _base = require("./base");
+Object.keys(_base).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _base[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _base[key];
+    }
+  });
+});
+var _events = require("./events");
+Object.keys(_events).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _events[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _events[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

package/lib/commonjs/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_base","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_events"],"sourceRoot":"../../../src","sources":["types/index.ts"],"mappings":";;;;;AAAA,IAAAA,KAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,KAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,KAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,KAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,OAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,OAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,OAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,OAAA,CAAAL,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/lib/commonjs/utils/address.js

@@ -0,0 +1,82 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getValidAddress = getValidAddress;
+exports.isBlockedAddress = isBlockedAddress;
+exports.isValidAddress = isValidAddress;
+exports.toChecksumAddress = toChecksumAddress;
+var _keccak = require("ethereum-cryptography/keccak.js");
+var _utils = require("ethereum-cryptography/utils.js");
+/**
+ * Address validation and checksum utilities
+ *
+ * Uses ethereum-cryptography for proper EIP-55 checksum computation
+ */
+
+/**
+ * Convert Uint8Array to hex string
+ */
+function toHex(bytes) {
+  return Array.from(bytes).map(b => b.toString(16).padStart(2, "0")).join("");
+}
+
+/**
+ * Check if a string is a valid Ethereum address
+ */
+function isValidAddress(address) {
+  if (!address) return false;
+  if (typeof address !== "string") return false;
+
+  // Check if it matches basic hex address format
+  return /^0x[a-fA-F0-9]{40}$/.test(address);
+}
+
+/**
+ * Convert address to EIP-55 checksum format
+ *
+ * Uses keccak256 from ethereum-cryptography for correct checksumming
+ * See: https://eips.ethereum.org/EIPS/eip-55
+ */
+function toChecksumAddress(address) {
+  if (!isValidAddress(address)) {
+    return address;
+  }
+  const lowercaseAddress = address.toLowerCase().replace("0x", "");
+  const hash = toHex((0, _keccak.keccak256)((0, _utils.utf8ToBytes)(lowercaseAddress)));
+  let checksumAddress = "0x";
+  for (let i = 0; i < lowercaseAddress.length; i++) {
+    const char = lowercaseAddress[i];
+    if (char && parseInt(hash[i] || "0", 16) >= 8) {
+      checksumAddress += char.toUpperCase();
+    } else {
+      checksumAddress += char;
+    }
+  }
+  return checksumAddress;
+}
+
+/**
+ * Get valid address or null
+ */
+function getValidAddress(address) {
+  if (!address) return null;
+  const trimmed = typeof address === "string" ? address.trim() : address;
+  if (!isValidAddress(trimmed)) return null;
+  return trimmed;
+}
+
+/**
+ * Blocked addresses that should not emit events
+ * (zero address, dead address)
+ */
+const BLOCKED_ADDRESSES = new Set(["0x0000000000000000000000000000000000000000", "0x000000000000000000000000000000000000dead"]);
+
+/**
+ * Check if address is in blocked list
+ */
+function isBlockedAddress(address) {
+  return BLOCKED_ADDRESSES.has(address.toLowerCase());
+}
+//# sourceMappingURL=address.js.map

package/lib/commonjs/utils/address.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_keccak","require","_utils","toHex","bytes","Array","from","map","b","toString","padStart","join","isValidAddress","address","test","toChecksumAddress","lowercaseAddress","toLowerCase","replace","hash","keccak256","utf8ToBytes","checksumAddress","i","length","char","parseInt","toUpperCase","getValidAddress","trimmed","trim","BLOCKED_ADDRESSES","Set","isBlockedAddress","has"],"sourceRoot":"../../../src","sources":["utils/address.ts"],"mappings":";;;;;;;;;AAMA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AAPA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA,SAASE,KAAKA,CAACC,KAAiB,EAAU;EACxC,OAAOC,KAAK,CAACC,IAAI,CAACF,KAAK,CAAC,CACrBG,GAAG,CAAEC,CAAC,IAAKA,CAAC,CAACC,QAAQ,CAAC,EAAE,CAAC,CAACC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAC3CC,IAAI,CAAC,EAAE,CAAC;AACb;;AAEA;AACA;AACA;AACO,SAASC,cAAcA,CAACC,OAAe,EAAW;EACvD,IAAI,CAACA,OAAO,EAAE,OAAO,KAAK;EAC1B,IAAI,OAAOA,OAAO,KAAK,QAAQ,EAAE,OAAO,KAAK;;EAE7C;EACA,OAAO,qBAAqB,CAACC,IAAI,CAACD,OAAO,CAAC;AAC5C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,iBAAiBA,CAACF,OAAe,EAAU;EACzD,IAAI,CAACD,cAAc,CAACC,OAAO,CAAC,EAAE;IAC5B,OAAOA,OAAO;EAChB;EAEA,MAAMG,gBAAgB,GAAGH,OAAO,CAACI,WAAW,CAAC,CAAC,CAACC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;EAChE,MAAMC,IAAI,GAAGhB,KAAK,CAAC,IAAAiB,iBAAS,EAAC,IAAAC,kBAAW,EAACL,gBAAgB,CAAC,CAAC,CAAC;EAE5D,IAAIM,eAAe,GAAG,IAAI;EAE1B,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGP,gBAAgB,CAACQ,MAAM,EAAED,CAAC,EAAE,EAAE;IAChD,MAAME,IAAI,GAAGT,gBAAgB,CAACO,CAAC,CAAC;IAChC,IAAIE,IAAI,IAAIC,QAAQ,CAACP,IAAI,CAACI,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE;MAC7CD,eAAe,IAAIG,IAAI,CAACE,WAAW,CAAC,CAAC;IACvC,CAAC,MAAM;MACLL,eAAe,IAAIG,IAAI;IACzB;EACF;EAEA,OAAOH,eAAe;AACxB;;AAEA;AACA;AACA;AACO,SAASM,eAAeA,CAC7Bf,OAAkC,EACnB;EACf,IAAI,CAACA,OAAO,EAAE,OAAO,IAAI;EACzB,MAAMgB,OAAO,GAAG,OAAOhB,OAAO,KAAK,QAAQ,GAAGA,OAAO,CAACiB,IAAI,CAAC,CAAC,GAAGjB,OAAO;EACtE,IAAI,CAACD,cAAc,CAACiB,OAAO,CAAC,EAAE,OAAO,IAAI;EACzC,OAAOA,OAAO;AAChB;;AAEA;AACA;AACA;AACA;AACA,MAAME,iBAAiB,GAAG,IAAIC,GAAG,CAAS,CACxC,4CAA4C,EAC5C,4CAA4C,CAC7C,CAAC;;AAEF;AACA;AACA;AACO,SAASC,gBAAgBA,CAACpB,OAAe,EAAW;EACzD,OAAOkB,iBAAiB,CAACG,GAAG,CAACrB,OAAO,CAACI,WAAW,CAAC,CAAC,CAAC;AACrD","ignoreList":[]}