@sudobility/types 1.8.21

package/dist/utils/blockchain/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../src/utils/blockchain/address.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAoCH,8BAiCC;AAMD,8BA8CC;AAMD,wCA8BC;AAKD,oDA2BC;AAKD,4CAqBC;AAKD,8CAsBC;AAMD,kDAiBC;AAKD,kDAaC;AAzRD,sDAAuD;AAEvD,qDAAqD;AACrD,0DAA8E;AAE9E;;GAEG;AACH,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,8CAA+B,CAAA;IAC/B,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;AACrB,CAAC,EANW,WAAW,2BAAX,WAAW,QAMtB;AAcD,wEAAwE;AACxE,4EAA4E;AAE5E;;GAEG;AACH,SAAgB,SAAS,CAAC,OAAe;IACvC,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAE3C,kCAAkC;IAClC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+CAA+C;IAC/C,MAAM,cAAc,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;QAClD,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3B,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAE9B,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uDAAuD;IACvD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEzC,2BAA2B;IAC3B,MAAM,eAAe,GAAG,iCAAiC,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,iCAAiC;QACjC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAC,OAAe;IACvC,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAE3C,2CAA2C;IAC3C,MAAM,aAAa,GAAG;QACpB,MAAM;QACN,MAAM;QACN,OAAO;QACP,OAAO;QACP,KAAK;QACL,MAAM;QACN,OAAO;QACP,OAAO;KACR,CAAC;IAEF,qDAAqD;IACrD,MAAM,iBAAiB,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CACnD,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAC3B,CAAC;IACF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gDAAgD;IAChD,MAAM,cAAc,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAExE,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uDAAuD;IACvD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEzC,2BAA2B;IAC3B,MAAM,eAAe,GAAG,iCAAiC,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,iCAAiC;QACjC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,OAAe;IAC5C,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,WAAW,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,uDAAuD;IACvD,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,YAAY,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;IAElD,6CAA6C;IAC7C,IAAI,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5B,OAAO,WAAW,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,oCAAoC;IACpC,IAAI,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5B,OAAO,WAAW,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,2DAA2D;IAC3D,IAAI,IAAA,qBAAY,EAAC,cAAc,CAAC,EAAE,CAAC;QACjC,OAAO,WAAW,CAAC,UAAU,CAAC;IAChC,CAAC;IAED,8DAA8D;IAC9D,IAAI,IAAA,wBAAe,EAAC,cAAc,CAAC,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC,aAAa,CAAC;IACnC,CAAC;IAED,OAAO,WAAW,CAAC,OAAO,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAClC,OAAe,EACf,SAAoB;IAEpB,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAE5C,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,iBAAS,CAAC,GAAG;YAChB,OAAO,CACL,WAAW,KAAK,WAAW,CAAC,UAAU;gBACtC,WAAW,KAAK,WAAW,CAAC,OAAO,CACpC,CAAC;QAEJ,KAAK,iBAAS,CAAC,MAAM;YACnB,OAAO,CACL,WAAW,KAAK,WAAW,CAAC,aAAa;gBACzC,WAAW,KAAK,WAAW,CAAC,OAAO,CACpC,CAAC;QAEJ;YACE,sDAAsD;YACtD,OAAO,WAAW,KAAK,WAAW,CAAC,OAAO,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAC9B,SAAiB,EACjB,SAAoB;IAEpB,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,iBAAS,CAAC,GAAG;YAChB,+DAA+D;YAC/D,OAAO,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEhD,KAAK,iBAAS,CAAC,MAAM;YACnB,2EAA2E;YAC3E,OAAO,+BAA+B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEzD;YACE,2CAA2C;YAC3C,OAAO,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAChC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAErC,OAAO;QACL,OAAO;QACP,MAAM;QACN,IAAI;KACL,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,OAAe;IACjD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,+DAA+D;IAC/D,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5C,IACE,CAAC,WAAW,KAAK,WAAW,CAAC,OAAO;QAClC,WAAW,KAAK,WAAW,CAAC,OAAO,CAAC;QACtC,OAAO,CAAC,MAAM,IAAI,EAAE,EACpB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,mDAAmD;IACnD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,SAA+B;IACjE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,iBAAS,CAAC,GAAG;YAChB,OAAO,WAAW,CAAC;QACrB,KAAK,iBAAS,CAAC,MAAM;YACnB,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,YAAY,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/utils/blockchain/event-helpers.cjs

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * @fileoverview Pure Event Helper Functions
+ * @description Pure utility functions for multi-chain event processing
+ * @version 2.0.0
+ *
+ * This file provides clean, type-safe utility functions with no external dependencies:
+ * - Multi-chain ID generation
+ * - Address normalization
+ * - BigInt formatting
+ * - Address validation
+ * - Testnet detection
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMultiChainId = createMultiChainId;
+exports.createUserMultiChainId = createUserMultiChainId;
+exports.createChainStatsId = createChainStatsId;
+exports.createDelegationId = createDelegationId;
+exports.normalizeAddress = normalizeAddress;
+exports.formatBigInt = formatBigInt;
+exports.isZeroAddress = isZeroAddress;
+exports.isTestNet = isTestNet;
+exports.validateEventArgs = validateEventArgs;
+// ========================================
+// ID GENERATION UTILITIES
+// ========================================
+/**
+ * Generate unique multi-chain entity ID
+ *
+ * @param chainId - Network chain ID (e.g., 1 for Ethereum)
+ * @param txHash - Transaction hash
+ * @param logIndex - Event log index within transaction
+ * @returns Formatted ID: "chainId-txHash-logIndex"
+ *
+ * @example
+ * ```typescript
+ * const id = createMultiChainId(1, "0x123...", 0);
+ * // Result: "1-0x123...-0"
+ * ```
+ */
+function createMultiChainId(chainId, txHash, logIndex) {
+    return `${chainId}-${txHash}-${logIndex}`;
+}
+/**
+ * Generate user-specific multi-chain ID
+ *
+ * @param chainId - Network chain ID
+ * @param address - User wallet address (will be normalized to lowercase)
+ * @returns Formatted ID: "chainId-address"
+ *
+ * @example
+ * ```typescript
+ * const userId = createUserMultiChainId(137, "0xABC...");
+ * // Result: "137-0xabc..."
+ * ```
+ */
+function createUserMultiChainId(chainId, address) {
+    return `${chainId}-${address.toLowerCase()}`;
+}
+/**
+ * Generate chain-specific statistics ID
+ *
+ * @param chainId - Network chain ID
+ * @returns Formatted ID: "chainId-global"
+ */
+function createChainStatsId(chainId) {
+    return `${chainId}-global`;
+}
+/**
+ * Generate delegation ID based on delegator address and testnet status
+ *
+ * @param delegatorAddress - The wallet address that is delegating
+ * @param isTestNet - Whether the chain is a testnet
+ * @returns Formatted ID: "delegatorAddress-testNet"
+ */
+function createDelegationId(delegatorAddress, isTestNet) {
+    return `${delegatorAddress.toLowerCase()}-${isTestNet}`;
+}
+// ========================================
+// UTILITY FUNCTIONS
+// ========================================
+/**
+ * Normalize address to lowercase
+ */
+function normalizeAddress(address) {
+    return address.toLowerCase();
+}
+/**
+ * Format bigint for display
+ */
+function formatBigInt(value, decimals = 18) {
+    const divisor = BigInt(10 ** decimals);
+    const whole = value / divisor;
+    const fraction = value % divisor;
+    if (fraction === 0n) {
+        return whole.toString();
+    }
+    return `${whole}.${fraction.toString().padStart(decimals, '0').replace(/0+$/, '')}`;
+}
+/**
+ * Check if address is zero address (delegation clearing)
+ */
+function isZeroAddress(address) {
+    return address.toLowerCase() === '0x0000000000000000000000000000000000000000';
+}
+/**
+ * Determine if a chain ID represents a testnet
+ * @param chainId The blockchain chain ID
+ * @returns true if the chain is a testnet, false if mainnet
+ */
+function isTestNet(chainId) {
+    // EVM Testnets (positive chain IDs)
+    const evmTestnets = new Set([
+        31337, // Hardhat (local development)
+        11155111, // Ethereum Sepolia
+        80001, // Polygon Mumbai (if configured)
+        80002, // Polygon Amoy (if configured)
+        421614, // Arbitrum Sepolia (if configured)
+        11155420, // OP Sepolia (if configured)
+        84532, // Base Sepolia (if configured)
+        43113, // Avalanche Fuji (if configured)
+    ]);
+    // Solana Testnets (negative chain IDs)
+    const solanaTestnets = new Set([
+        -102, // Solana Devnet
+        -103, // Solana Testnet
+        -104, // Solana Localnet
+    ]);
+    return evmTestnets.has(chainId) || solanaTestnets.has(chainId);
+}
+/**
+ * Validate event arguments
+ */
+function validateEventArgs(args, requiredFields) {
+    for (const field of requiredFields) {
+        if (args[field] === undefined || args[field] === null) {
+            console.error(`❌ Missing required field: ${String(field)}`);
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=event-helpers.js.map

package/dist/utils/blockchain/event-helpers.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @fileoverview Pure Event Helper Functions
+ * @description Pure utility functions for multi-chain event processing
+ * @version 2.0.0
+ *
+ * This file provides clean, type-safe utility functions with no external dependencies:
+ * - Multi-chain ID generation
+ * - Address normalization
+ * - BigInt formatting
+ * - Address validation
+ * - Testnet detection
+ */
+/**
+ * Generate unique multi-chain entity ID
+ *
+ * @param chainId - Network chain ID (e.g., 1 for Ethereum)
+ * @param txHash - Transaction hash
+ * @param logIndex - Event log index within transaction
+ * @returns Formatted ID: "chainId-txHash-logIndex"
+ *
+ * @example
+ * ```typescript
+ * const id = createMultiChainId(1, "0x123...", 0);
+ * // Result: "1-0x123...-0"
+ * ```
+ */
+export declare function createMultiChainId(chainId: number, txHash: string, logIndex: number): string;
+/**
+ * Generate user-specific multi-chain ID
+ *
+ * @param chainId - Network chain ID
+ * @param address - User wallet address (will be normalized to lowercase)
+ * @returns Formatted ID: "chainId-address"
+ *
+ * @example
+ * ```typescript
+ * const userId = createUserMultiChainId(137, "0xABC...");
+ * // Result: "137-0xabc..."
+ * ```
+ */
+export declare function createUserMultiChainId(chainId: number, address: string): string;
+/**
+ * Generate chain-specific statistics ID
+ *
+ * @param chainId - Network chain ID
+ * @returns Formatted ID: "chainId-global"
+ */
+export declare function createChainStatsId(chainId: number): string;
+/**
+ * Generate delegation ID based on delegator address and testnet status
+ *
+ * @param delegatorAddress - The wallet address that is delegating
+ * @param isTestNet - Whether the chain is a testnet
+ * @returns Formatted ID: "delegatorAddress-testNet"
+ */
+export declare function createDelegationId(delegatorAddress: string, isTestNet: boolean): string;
+/**
+ * Normalize address to lowercase
+ */
+export declare function normalizeAddress(address: string): string;
+/**
+ * Format bigint for display
+ */
+export declare function formatBigInt(value: bigint, decimals?: number): string;
+/**
+ * Check if address is zero address (delegation clearing)
+ */
+export declare function isZeroAddress(address: string): boolean;
+/**
+ * Determine if a chain ID represents a testnet
+ * @param chainId The blockchain chain ID
+ * @returns true if the chain is a testnet, false if mainnet
+ */
+export declare function isTestNet(chainId: number): boolean;
+/**
+ * Validate event arguments
+ */
+export declare function validateEventArgs<T extends Record<string, unknown>>(args: T, requiredFields: (keyof T)[]): boolean;
+/**
+ * Multi-chain ID generator function signature
+ */
+export type MultiChainIdGenerator = (chainId: number, txHash: string, logIndex: number) => string;
+/**
+ * User-specific multi-chain ID generator function signature
+ */
+export type UserChainIdGenerator = (chainId: number, address: string) => string;
+//# sourceMappingURL=event-helpers.d.ts.map

package/dist/utils/blockchain/event-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/blockchain/event-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,OAAO,GACjB,MAAM,CAER;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,CAUzE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAqBlD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,IAAI,EAAE,CAAC,EACP,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAC1B,OAAO,CAQT;AAMD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,KACb,MAAM,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC"}

package/dist/utils/blockchain/event-helpers.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * @fileoverview Pure Event Helper Functions
+ * @description Pure utility functions for multi-chain event processing
+ * @version 2.0.0
+ *
+ * This file provides clean, type-safe utility functions with no external dependencies:
+ * - Multi-chain ID generation
+ * - Address normalization
+ * - BigInt formatting
+ * - Address validation
+ * - Testnet detection
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMultiChainId = createMultiChainId;
+exports.createUserMultiChainId = createUserMultiChainId;
+exports.createChainStatsId = createChainStatsId;
+exports.createDelegationId = createDelegationId;
+exports.normalizeAddress = normalizeAddress;
+exports.formatBigInt = formatBigInt;
+exports.isZeroAddress = isZeroAddress;
+exports.isTestNet = isTestNet;
+exports.validateEventArgs = validateEventArgs;
+// ========================================
+// ID GENERATION UTILITIES
+// ========================================
+/**
+ * Generate unique multi-chain entity ID
+ *
+ * @param chainId - Network chain ID (e.g., 1 for Ethereum)
+ * @param txHash - Transaction hash
+ * @param logIndex - Event log index within transaction
+ * @returns Formatted ID: "chainId-txHash-logIndex"
+ *
+ * @example
+ * ```typescript
+ * const id = createMultiChainId(1, "0x123...", 0);
+ * // Result: "1-0x123...-0"
+ * ```
+ */
+function createMultiChainId(chainId, txHash, logIndex) {
+    return `${chainId}-${txHash}-${logIndex}`;
+}
+/**
+ * Generate user-specific multi-chain ID
+ *
+ * @param chainId - Network chain ID
+ * @param address - User wallet address (will be normalized to lowercase)
+ * @returns Formatted ID: "chainId-address"
+ *
+ * @example
+ * ```typescript
+ * const userId = createUserMultiChainId(137, "0xABC...");
+ * // Result: "137-0xabc..."
+ * ```
+ */
+function createUserMultiChainId(chainId, address) {
+    return `${chainId}-${address.toLowerCase()}`;
+}
+/**
+ * Generate chain-specific statistics ID
+ *
+ * @param chainId - Network chain ID
+ * @returns Formatted ID: "chainId-global"
+ */
+function createChainStatsId(chainId) {
+    return `${chainId}-global`;
+}
+/**
+ * Generate delegation ID based on delegator address and testnet status
+ *
+ * @param delegatorAddress - The wallet address that is delegating
+ * @param isTestNet - Whether the chain is a testnet
+ * @returns Formatted ID: "delegatorAddress-testNet"
+ */
+function createDelegationId(delegatorAddress, isTestNet) {
+    return `${delegatorAddress.toLowerCase()}-${isTestNet}`;
+}
+// ========================================
+// UTILITY FUNCTIONS
+// ========================================
+/**
+ * Normalize address to lowercase
+ */
+function normalizeAddress(address) {
+    return address.toLowerCase();
+}
+/**
+ * Format bigint for display
+ */
+function formatBigInt(value, decimals = 18) {
+    const divisor = BigInt(10 ** decimals);
+    const whole = value / divisor;
+    const fraction = value % divisor;
+    if (fraction === 0n) {
+        return whole.toString();
+    }
+    return `${whole}.${fraction.toString().padStart(decimals, '0').replace(/0+$/, '')}`;
+}
+/**
+ * Check if address is zero address (delegation clearing)
+ */
+function isZeroAddress(address) {
+    return address.toLowerCase() === '0x0000000000000000000000000000000000000000';
+}
+/**
+ * Determine if a chain ID represents a testnet
+ * @param chainId The blockchain chain ID
+ * @returns true if the chain is a testnet, false if mainnet
+ */
+function isTestNet(chainId) {
+    // EVM Testnets (positive chain IDs)
+    const evmTestnets = new Set([
+        31337, // Hardhat (local development)
+        11155111, // Ethereum Sepolia
+        80001, // Polygon Mumbai (if configured)
+        80002, // Polygon Amoy (if configured)
+        421614, // Arbitrum Sepolia (if configured)
+        11155420, // OP Sepolia (if configured)
+        84532, // Base Sepolia (if configured)
+        43113, // Avalanche Fuji (if configured)
+    ]);
+    // Solana Testnets (negative chain IDs)
+    const solanaTestnets = new Set([
+        -102, // Solana Devnet
+        -103, // Solana Testnet
+        -104, // Solana Localnet
+    ]);
+    return evmTestnets.has(chainId) || solanaTestnets.has(chainId);
+}
+/**
+ * Validate event arguments
+ */
+function validateEventArgs(args, requiredFields) {
+    for (const field of requiredFields) {
+        if (args[field] === undefined || args[field] === null) {
+            console.error(`❌ Missing required field: ${String(field)}`);
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=event-helpers.js.map

package/dist/utils/blockchain/event-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-helpers.js","sourceRoot":"","sources":["../../../src/utils/blockchain/event-helpers.ts"],"names":[],"mappings":"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"}

package/dist/utils/blockchain/index.cjs

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcHelpers = exports.validateEventArgs = exports.normalizeAddress = exports.isZeroAddress = exports.isTestNet = exports.formatBigInt = exports.createUserMultiChainId = exports.createMultiChainId = exports.createDelegationId = exports.createChainStatsId = exports.isSolanaAddress = exports.isEvmAddress = exports.parseEmailAddress = exports.isValidWalletAddress = exports.isValidSignature = exports.isSNSName = exports.isENSName = exports.getChainDisplayName = exports.getAddressType = exports.formatWalletAddress = exports.AddressType = void 0;
+var address_1 = require("./address");
+Object.defineProperty(exports, "AddressType", { enumerable: true, get: function () { return address_1.AddressType; } });
+Object.defineProperty(exports, "formatWalletAddress", { enumerable: true, get: function () { return address_1.formatWalletAddress; } });
+Object.defineProperty(exports, "getAddressType", { enumerable: true, get: function () { return address_1.getAddressType; } });
+Object.defineProperty(exports, "getChainDisplayName", { enumerable: true, get: function () { return address_1.getChainDisplayName; } });
+Object.defineProperty(exports, "isENSName", { enumerable: true, get: function () { return address_1.isENSName; } });
+Object.defineProperty(exports, "isSNSName", { enumerable: true, get: function () { return address_1.isSNSName; } });
+Object.defineProperty(exports, "isValidSignature", { enumerable: true, get: function () { return address_1.isValidSignature; } });
+Object.defineProperty(exports, "isValidWalletAddress", { enumerable: true, get: function () { return address_1.isValidWalletAddress; } });
+Object.defineProperty(exports, "parseEmailAddress", { enumerable: true, get: function () { return address_1.parseEmailAddress; } });
+// Export address validation functions from common.ts
+var common_1 = require("../../types/blockchain/common");
+Object.defineProperty(exports, "isEvmAddress", { enumerable: true, get: function () { return common_1.isEvmAddress; } });
+Object.defineProperty(exports, "isSolanaAddress", { enumerable: true, get: function () { return common_1.isSolanaAddress; } });
+var event_helpers_1 = require("./event-helpers");
+Object.defineProperty(exports, "createChainStatsId", { enumerable: true, get: function () { return event_helpers_1.createChainStatsId; } });
+Object.defineProperty(exports, "createDelegationId", { enumerable: true, get: function () { return event_helpers_1.createDelegationId; } });
+Object.defineProperty(exports, "createMultiChainId", { enumerable: true, get: function () { return event_helpers_1.createMultiChainId; } });
+Object.defineProperty(exports, "createUserMultiChainId", { enumerable: true, get: function () { return event_helpers_1.createUserMultiChainId; } });
+Object.defineProperty(exports, "formatBigInt", { enumerable: true, get: function () { return event_helpers_1.formatBigInt; } });
+Object.defineProperty(exports, "isTestNet", { enumerable: true, get: function () { return event_helpers_1.isTestNet; } });
+Object.defineProperty(exports, "isZeroAddress", { enumerable: true, get: function () { return event_helpers_1.isZeroAddress; } });
+Object.defineProperty(exports, "normalizeAddress", { enumerable: true, get: function () { return event_helpers_1.normalizeAddress; } });
+Object.defineProperty(exports, "validateEventArgs", { enumerable: true, get: function () { return event_helpers_1.validateEventArgs; } });
+var rpc_helpers_1 = require("./rpc-helpers");
+Object.defineProperty(exports, "RpcHelpers", { enumerable: true, get: function () { return rpc_helpers_1.RpcHelpers; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/blockchain/index.d.ts

@@ -0,0 +1,8 @@
+export type { ParsedEmailAddress } from './address';
+export { AddressType, formatWalletAddress, getAddressType, getChainDisplayName, isENSName, isSNSName, isValidSignature, isValidWalletAddress, parseEmailAddress, } from './address';
+export { isEvmAddress, isSolanaAddress } from '../../types/blockchain/common';
+export type { MultiChainIdGenerator, UserChainIdGenerator, } from './event-helpers';
+export { createChainStatsId, createDelegationId, createMultiChainId, createUserMultiChainId, formatBigInt, isTestNet, isZeroAddress, normalizeAddress, validateEventArgs, } from './event-helpers';
+export type { BlockchainApis } from './rpc-helpers';
+export { RpcHelpers } from './rpc-helpers';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/blockchain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/blockchain/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAG9E,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/utils/blockchain/index.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcHelpers = exports.validateEventArgs = exports.normalizeAddress = exports.isZeroAddress = exports.isTestNet = exports.formatBigInt = exports.createUserMultiChainId = exports.createMultiChainId = exports.createDelegationId = exports.createChainStatsId = exports.isSolanaAddress = exports.isEvmAddress = exports.parseEmailAddress = exports.isValidWalletAddress = exports.isValidSignature = exports.isSNSName = exports.isENSName = exports.getChainDisplayName = exports.getAddressType = exports.formatWalletAddress = exports.AddressType = void 0;
+var address_1 = require("./address");
+Object.defineProperty(exports, "AddressType", { enumerable: true, get: function () { return address_1.AddressType; } });
+Object.defineProperty(exports, "formatWalletAddress", { enumerable: true, get: function () { return address_1.formatWalletAddress; } });
+Object.defineProperty(exports, "getAddressType", { enumerable: true, get: function () { return address_1.getAddressType; } });
+Object.defineProperty(exports, "getChainDisplayName", { enumerable: true, get: function () { return address_1.getChainDisplayName; } });
+Object.defineProperty(exports, "isENSName", { enumerable: true, get: function () { return address_1.isENSName; } });
+Object.defineProperty(exports, "isSNSName", { enumerable: true, get: function () { return address_1.isSNSName; } });
+Object.defineProperty(exports, "isValidSignature", { enumerable: true, get: function () { return address_1.isValidSignature; } });
+Object.defineProperty(exports, "isValidWalletAddress", { enumerable: true, get: function () { return address_1.isValidWalletAddress; } });
+Object.defineProperty(exports, "parseEmailAddress", { enumerable: true, get: function () { return address_1.parseEmailAddress; } });
+// Export address validation functions from common.ts
+var common_1 = require("../../types/blockchain/common");
+Object.defineProperty(exports, "isEvmAddress", { enumerable: true, get: function () { return common_1.isEvmAddress; } });
+Object.defineProperty(exports, "isSolanaAddress", { enumerable: true, get: function () { return common_1.isSolanaAddress; } });
+var event_helpers_1 = require("./event-helpers");
+Object.defineProperty(exports, "createChainStatsId", { enumerable: true, get: function () { return event_helpers_1.createChainStatsId; } });
+Object.defineProperty(exports, "createDelegationId", { enumerable: true, get: function () { return event_helpers_1.createDelegationId; } });
+Object.defineProperty(exports, "createMultiChainId", { enumerable: true, get: function () { return event_helpers_1.createMultiChainId; } });
+Object.defineProperty(exports, "createUserMultiChainId", { enumerable: true, get: function () { return event_helpers_1.createUserMultiChainId; } });
+Object.defineProperty(exports, "formatBigInt", { enumerable: true, get: function () { return event_helpers_1.formatBigInt; } });
+Object.defineProperty(exports, "isTestNet", { enumerable: true, get: function () { return event_helpers_1.isTestNet; } });
+Object.defineProperty(exports, "isZeroAddress", { enumerable: true, get: function () { return event_helpers_1.isZeroAddress; } });
+Object.defineProperty(exports, "normalizeAddress", { enumerable: true, get: function () { return event_helpers_1.normalizeAddress; } });
+Object.defineProperty(exports, "validateEventArgs", { enumerable: true, get: function () { return event_helpers_1.validateEventArgs; } });
+var rpc_helpers_1 = require("./rpc-helpers");
+Object.defineProperty(exports, "RpcHelpers", { enumerable: true, get: function () { return rpc_helpers_1.RpcHelpers; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/blockchain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/blockchain/index.ts"],"names":[],"mappings":";;;AAGA,qCAUmB;AATjB,sGAAA,WAAW,OAAA;AACX,8GAAA,mBAAmB,OAAA;AACnB,yGAAA,cAAc,OAAA;AACd,8GAAA,mBAAmB,OAAA;AACnB,oGAAA,SAAS,OAAA;AACT,oGAAA,SAAS,OAAA;AACT,2GAAA,gBAAgB,OAAA;AAChB,+GAAA,oBAAoB,OAAA;AACpB,4GAAA,iBAAiB,OAAA;AAGnB,qDAAqD;AACrD,wDAA8E;AAArE,sGAAA,YAAY,OAAA;AAAE,yGAAA,eAAe,OAAA;AAQtC,iDAUyB;AATvB,mHAAA,kBAAkB,OAAA;AAClB,mHAAA,kBAAkB,OAAA;AAClB,mHAAA,kBAAkB,OAAA;AAClB,uHAAA,sBAAsB,OAAA;AACtB,6GAAA,YAAY,OAAA;AACZ,0GAAA,SAAS,OAAA;AACT,8GAAA,aAAa,OAAA;AACb,iHAAA,gBAAgB,OAAA;AAChB,kHAAA,iBAAiB,OAAA;AAKnB,6CAA2C;AAAlC,yGAAA,UAAU,OAAA"}