@sudobility/types 1.8.21

package/dist/index.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * @johnqh/types - Common TypeScript types for 0xmail.box projects
+ *
+ * This package contains all shared TypeScript definitions used across
+ * the 0xmail.box ecosystem including business logic types, blockchain
+ * types, configuration interfaces, infrastructure types, and utility functions.
+ *
+ * @version 1.0.0
+ * @license MIT
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageType = exports.WalletType = exports.ChainType = exports.AnalyticsEvent = exports.TransactionStatus = exports.MessageType = exports.NotificationType = exports.RequestStatus = exports.MobileView = exports.EmailComposeType = exports.FontSize = exports.Theme = exports.Chain = exports.AuthStatus = exports.debounceAsync = exports.clearExpiredCache = exports.withCache = exports.withTimeout = exports.safeParallel = exports.withLoadingState = exports.safeAsync = exports.RpcHelpers = void 0;
+// Re-export all types from the types module
+__exportStar(require("./types"), exports);
+// Re-export all utilities
+__exportStar(require("./utils"), exports);
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "RpcHelpers", { enumerable: true, get: function () { return utils_1.RpcHelpers; } });
+// Export async utilities
+var utils_2 = require("./utils");
+Object.defineProperty(exports, "safeAsync", { enumerable: true, get: function () { return utils_2.safeAsync; } });
+Object.defineProperty(exports, "withLoadingState", { enumerable: true, get: function () { return utils_2.withLoadingState; } });
+Object.defineProperty(exports, "safeParallel", { enumerable: true, get: function () { return utils_2.safeParallel; } });
+Object.defineProperty(exports, "withTimeout", { enumerable: true, get: function () { return utils_2.withTimeout; } });
+Object.defineProperty(exports, "withCache", { enumerable: true, get: function () { return utils_2.withCache; } });
+Object.defineProperty(exports, "clearExpiredCache", { enumerable: true, get: function () { return utils_2.clearExpiredCache; } });
+Object.defineProperty(exports, "debounceAsync", { enumerable: true, get: function () { return utils_2.debounceAsync; } });
+// Export the most commonly used enums
+var types_1 = require("./types");
+// Business enums
+Object.defineProperty(exports, "AuthStatus", { enumerable: true, get: function () { return types_1.AuthStatus; } });
+Object.defineProperty(exports, "Chain", { enumerable: true, get: function () { return types_1.Chain; } });
+Object.defineProperty(exports, "Theme", { enumerable: true, get: function () { return types_1.Theme; } });
+Object.defineProperty(exports, "FontSize", { enumerable: true, get: function () { return types_1.FontSize; } });
+Object.defineProperty(exports, "EmailComposeType", { enumerable: true, get: function () { return types_1.EmailComposeType; } });
+Object.defineProperty(exports, "MobileView", { enumerable: true, get: function () { return types_1.MobileView; } });
+Object.defineProperty(exports, "RequestStatus", { enumerable: true, get: function () { return types_1.RequestStatus; } });
+Object.defineProperty(exports, "NotificationType", { enumerable: true, get: function () { return types_1.NotificationType; } });
+// Blockchain enums
+Object.defineProperty(exports, "MessageType", { enumerable: true, get: function () { return types_1.MessageType; } });
+Object.defineProperty(exports, "TransactionStatus", { enumerable: true, get: function () { return types_1.TransactionStatus; } });
+// Infrastructure enums
+Object.defineProperty(exports, "AnalyticsEvent", { enumerable: true, get: function () { return types_1.AnalyticsEvent; } });
+Object.defineProperty(exports, "ChainType", { enumerable: true, get: function () { return types_1.ChainType; } });
+Object.defineProperty(exports, "WalletType", { enumerable: true, get: function () { return types_1.WalletType; } });
+Object.defineProperty(exports, "StorageType", { enumerable: true, get: function () { return types_1.StorageType; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;AAEH,4CAA4C;AAC5C,0CAAwB;AAExB,0BAA0B;AAC1B,0CAAwB;AA0GxB,iCAAqC;AAA5B,mGAAA,UAAU,OAAA;AAEnB,yBAAyB;AACzB,iCASiB;AARf,kGAAA,SAAS,OAAA;AACT,yGAAA,gBAAgB,OAAA;AAChB,qGAAA,YAAY,OAAA;AACZ,oGAAA,WAAW,OAAA;AACX,kGAAA,SAAS,OAAA;AACT,0GAAA,iBAAiB,OAAA;AACjB,sGAAA,aAAa,OAAA;AAIf,sCAAsC;AACtC,iCAoBiB;AAnBf,iBAAiB;AACjB,mGAAA,UAAU,OAAA;AACV,8FAAA,KAAK,OAAA;AACL,8FAAA,KAAK,OAAA;AACL,iGAAA,QAAQ,OAAA;AACR,yGAAA,gBAAgB,OAAA;AAChB,mGAAA,UAAU,OAAA;AACV,sGAAA,aAAa,OAAA;AACb,yGAAA,gBAAgB,OAAA;AAEhB,mBAAmB;AACnB,oGAAA,WAAW,OAAA;AACX,0GAAA,iBAAiB,OAAA;AAEjB,uBAAuB;AACvB,uGAAA,cAAc,OAAA;AACd,kGAAA,SAAS,OAAA;AACT,mGAAA,UAAU,OAAA;AACV,oGAAA,WAAW,OAAA"}

package/dist/types/blockchain/common.cjs

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * @fileoverview Common type definitions for multi-chain MailBox system
+ * @description Shared types and interfaces for EVM and Solana implementations
+ * @author MailBox Team
+ * @version 1.4.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROTOCOL_CONSTANTS = exports.TransactionStatus = exports.MessageType = void 0;
+exports.isSolanaAddress = isSolanaAddress;
+exports.isEvmAddress = isEvmAddress;
+exports.isSolanaRecipient = isSolanaRecipient;
+exports.isEvmRecipient = isEvmRecipient;
+/**
+ * Message type enumeration
+ * @enum MessageType
+ */
+var MessageType;
+(function (MessageType) {
+    /** Standard message with 10% fee */
+    MessageType["STANDARD"] = "standard";
+    /** Priority message with full fee and 90% revenue share */
+    MessageType["PRIORITY"] = "priority";
+    /** Pre-prepared standard message */
+    MessageType["PREPARED_STANDARD"] = "prepared_standard";
+    /** Pre-prepared priority message */
+    MessageType["PREPARED_PRIORITY"] = "prepared_priority";
+})(MessageType || (exports.MessageType = MessageType = {}));
+/**
+ * Transaction status enumeration
+ * @enum TransactionStatus
+ */
+var TransactionStatus;
+(function (TransactionStatus) {
+    /** Transaction successful */
+    TransactionStatus["SUCCESS"] = "success";
+    /** Transaction failed */
+    TransactionStatus["FAILED"] = "failed";
+    /** Transaction pending confirmation */
+    TransactionStatus["PENDING"] = "pending";
+})(TransactionStatus || (exports.TransactionStatus = TransactionStatus = {}));
+// ============================================================================
+// TYPE GUARDS
+// ============================================================================
+/**
+ * Type guard to check if a value is a Solana PublicKey string
+ * @param value - Value to check
+ * @returns True if value is a valid Solana address
+ */
+function isSolanaAddress(value) {
+    return (typeof value === 'string' && /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(value));
+}
+/**
+ * Type guard to check if a value is an EVM address
+ * @param value - Value to check
+ * @returns True if value is EVM address string
+ */
+function isEvmAddress(value) {
+    return typeof value === 'string' && /^0x[a-fA-F0-9]{40}$/.test(value);
+}
+/**
+ * Type guard to check if recipient is for Solana
+ * @param recipient - Message recipient
+ * @returns True if recipient is Solana address
+ */
+function isSolanaRecipient(recipient) {
+    return isSolanaAddress(recipient);
+}
+/**
+ * Type guard to check if recipient is for EVM
+ * @param recipient - Message recipient
+ * @returns True if recipient is EVM address
+ */
+function isEvmRecipient(recipient) {
+    return isEvmAddress(recipient);
+}
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+/**
+ * Protocol constants used across implementations
+ */
+exports.PROTOCOL_CONSTANTS = {
+    /** Base send fee: 0.1 USDC (100,000 with 6 decimals) */
+    SEND_FEE: 100000n,
+    /** Claim period: 60 days in seconds */
+    CLAIM_PERIOD: 60 * 24 * 60 * 60,
+    /** Revenue share percentages */
+    REVENUE_SHARES: {
+        SENDER: 90,
+        OWNER: 10,
+    },
+    /** USDC token decimals */
+    USDC_DECIMALS: 6,
+    /** Maximum message lengths */
+    MAX_LENGTHS: {
+        SUBJECT: 200,
+        BODY: 2000,
+        MAIL_ID: 100,
+    },
+};
+//# sourceMappingURL=common.js.map

package/dist/types/blockchain/common.d.ts

@@ -0,0 +1,262 @@
+/**
+ * @fileoverview Common type definitions for multi-chain MailBox system
+ * @description Shared types and interfaces for EVM and Solana implementations
+ * @author MailBox Team
+ * @version 1.4.2
+ */
+import { MessageBase, UnifiedError, Result, Optional } from '../common';
+import { Chain } from '../business/enums';
+/**
+ * Chain configuration with API keys
+ * All other chain information (RPC URLs, chain ID, USDC addresses, etc.)
+ * can be derived using RpcHelpers
+ */
+export interface ChainConfig {
+    /** Chain identifier */
+    chain: Chain;
+    /** Alchemy API key for RPC access */
+    alchemyApiKey: string;
+    /** Etherscan Multichain API key for block explorer access */
+    etherscanApiKey: string;
+}
+/**
+ * Represents a message recipient - can be EVM address or Solana PublicKey string
+ * @example
+ * // EVM
+ * const evmRecipient: MessageRecipient = "0x742d35Cc6634C0532925a3b8D2C36B7f1234567";
+ *
+ * // Solana
+ * const solanaRecipient: MessageRecipient = "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM";
+ */
+export type MessageRecipient = string;
+/**
+ * Core message structure used across all chains
+ * @interface Message
+ */
+export interface Message extends Omit<MessageBase, 'from' | 'to'> {
+    /** Message sender address/pubkey */
+    from: MessageRecipient;
+    /** Message recipient address/pubkey */
+    to: MessageRecipient;
+    /** Block timestamp when sent */
+    timestamp: number;
+    /** Transaction hash/signature */
+    txHash: string;
+    /** Message type classification */
+    messageType: MessageType;
+}
+/**
+ * Pre-prepared message using external storage
+ * @interface PreparedMessage
+ */
+export interface PreparedMessage {
+    /** Message sender address/pubkey */
+    from: MessageRecipient;
+    /** Message recipient address/pubkey */
+    to: MessageRecipient;
+    /** External message identifier (IPFS hash, UUID, etc.) */
+    mailId: string;
+    /** Block timestamp when sent */
+    timestamp: number;
+    /** Transaction hash/signature */
+    txHash: string;
+    /** Message type classification */
+    messageType: MessageType;
+}
+/**
+ * Message type enumeration
+ * @enum MessageType
+ */
+export declare enum MessageType {
+    /** Standard message with 10% fee */
+    STANDARD = "standard",
+    /** Priority message with full fee and 90% revenue share */
+    PRIORITY = "priority",
+    /** Pre-prepared standard message */
+    PREPARED_STANDARD = "prepared_standard",
+    /** Pre-prepared priority message */
+    PREPARED_PRIORITY = "prepared_priority"
+}
+/**
+ * Fee structure for messages
+ * @interface FeeStructure
+ */
+export interface FeeStructure {
+    /** Base send fee (0.1 USDC with 6 decimals) */
+    sendFee: bigint;
+    /** Fee for standard messages (10% of sendFee) */
+    standardFee: bigint;
+    /** Fee for priority messages (100% of sendFee) */
+    priorityFee: bigint;
+    /** Owner share percentage (10%) */
+    ownerShare: number;
+    /** Sender revenue share percentage (90%) */
+    senderShare: number;
+}
+/**
+ * Claimable revenue information
+ * @interface ClaimableRevenue
+ */
+export interface ClaimableRevenue {
+    /** Amount claimable in USDC */
+    amount: bigint;
+    /** Timestamp when claim was created */
+    timestamp: number;
+    /** Expiration timestamp (60 days from creation) */
+    expiresAt: number;
+    /** Whether the claim has expired */
+    isExpired: boolean;
+}
+/**
+ * Contract/Program addresses for deployment
+ * @interface DeploymentAddresses
+ */
+export interface DeploymentAddresses {
+    /** Mailer contract/program address */
+    mailer: string;
+    /** MailService contract/program address (if applicable) */
+    mailService?: Optional<string>;
+    /** USDC token mint/contract address */
+    usdcToken: string;
+}
+/**
+ * Configuration for unified client
+ * @interface ClientConfig
+ */
+export interface ClientConfig {
+    /** RPC endpoint URL */
+    rpcUrl: string;
+    /** Chain ID */
+    chainId: number;
+    /** Contract/program addresses */
+    addresses: DeploymentAddresses;
+    /** Optional wallet private key for signing */
+    privateKey?: Optional<string>;
+    /** Optional custom RPC configuration */
+    rpcConfig?: Optional<RpcConfig>;
+}
+/**
+ * RPC configuration options
+ * @interface RpcConfig
+ */
+export interface RpcConfig {
+    /** Request timeout in milliseconds */
+    timeout?: Optional<number>;
+    /** Maximum retry attempts */
+    maxRetries?: Optional<number>;
+    /** Rate limiting options */
+    rateLimit?: Optional<{
+        requestsPerSecond: number;
+        maxConcurrent: number;
+    }>;
+}
+/**
+ * Transaction result for successful operations
+ * @interface TransactionResult
+ */
+export interface TransactionResult {
+    /** Transaction hash/signature */
+    txHash: string;
+    /** Block number/slot */
+    block: number;
+    /** Gas/compute units used */
+    gasUsed?: Optional<bigint>;
+    /** Transaction status */
+    status: TransactionStatus;
+    /** Optional logs/events emitted */
+    logs?: Optional<string[]>;
+}
+/**
+ * Transaction status enumeration
+ * @enum TransactionStatus
+ */
+export declare enum TransactionStatus {
+    /** Transaction successful */
+    SUCCESS = "success",// STATUS_VALUES.SUCCESS
+    /** Transaction failed */
+    FAILED = "failed",// STATUS_VALUES.FAILED
+    /** Transaction pending confirmation */
+    PENDING = "pending"
+}
+export type { UnifiedError, Result };
+export type OperationError = UnifiedError;
+/**
+ * Options for sending messages
+ * @interface SendMessageOptions
+ */
+export interface SendMessageOptions {
+    /** Message priority level */
+    priority?: Optional<'standard' | 'priority'>;
+    /** Optional gas price/compute budget override */
+    gasConfig?: Optional<{
+        gasPrice?: Optional<bigint>;
+        gasLimit?: Optional<bigint>;
+    }>;
+    /** Optional confirmation requirements */
+    confirmations?: Optional<number>;
+}
+export type { PaginationOptions, PaginationInfo, PaginatedResponse, } from '../common';
+/**
+ * Query filters for messages
+ * @interface MessageFilter
+ */
+export interface MessageFilter {
+    /** Filter by sender */
+    from?: Optional<MessageRecipient>;
+    /** Filter by recipient */
+    to?: Optional<MessageRecipient>;
+    /** Filter by message type */
+    messageType?: Optional<MessageType>;
+    /** Filter by date range */
+    dateRange?: Optional<{
+        from: Date;
+        to: Date;
+    }>;
+}
+/**
+ * Type guard to check if a value is a Solana PublicKey string
+ * @param value - Value to check
+ * @returns True if value is a valid Solana address
+ */
+export declare function isSolanaAddress(value: unknown): value is string;
+/**
+ * Type guard to check if a value is an EVM address
+ * @param value - Value to check
+ * @returns True if value is EVM address string
+ */
+export declare function isEvmAddress(value: unknown): value is string;
+/**
+ * Type guard to check if recipient is for Solana
+ * @param recipient - Message recipient
+ * @returns True if recipient is Solana address
+ */
+export declare function isSolanaRecipient(recipient: MessageRecipient): boolean;
+/**
+ * Type guard to check if recipient is for EVM
+ * @param recipient - Message recipient
+ * @returns True if recipient is EVM address
+ */
+export declare function isEvmRecipient(recipient: MessageRecipient): boolean;
+/**
+ * Protocol constants used across implementations
+ */
+export declare const PROTOCOL_CONSTANTS: {
+    /** Base send fee: 0.1 USDC (100,000 with 6 decimals) */
+    readonly SEND_FEE: 100000n;
+    /** Claim period: 60 days in seconds */
+    readonly CLAIM_PERIOD: number;
+    /** Revenue share percentages */
+    readonly REVENUE_SHARES: {
+        readonly SENDER: 90;
+        readonly OWNER: 10;
+    };
+    /** USDC token decimals */
+    readonly USDC_DECIMALS: 6;
+    /** Maximum message lengths */
+    readonly MAX_LENGTHS: {
+        readonly SUBJECT: 200;
+        readonly BODY: 2000;
+        readonly MAIL_ID: 100;
+    };
+};
+//# sourceMappingURL=common.d.ts.map

package/dist/types/blockchain/common.d.ts.map

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

package/dist/types/blockchain/common.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * @fileoverview Common type definitions for multi-chain MailBox system
+ * @description Shared types and interfaces for EVM and Solana implementations
+ * @author MailBox Team
+ * @version 1.4.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROTOCOL_CONSTANTS = exports.TransactionStatus = exports.MessageType = void 0;
+exports.isSolanaAddress = isSolanaAddress;
+exports.isEvmAddress = isEvmAddress;
+exports.isSolanaRecipient = isSolanaRecipient;
+exports.isEvmRecipient = isEvmRecipient;
+/**
+ * Message type enumeration
+ * @enum MessageType
+ */
+var MessageType;
+(function (MessageType) {
+    /** Standard message with 10% fee */
+    MessageType["STANDARD"] = "standard";
+    /** Priority message with full fee and 90% revenue share */
+    MessageType["PRIORITY"] = "priority";
+    /** Pre-prepared standard message */
+    MessageType["PREPARED_STANDARD"] = "prepared_standard";
+    /** Pre-prepared priority message */
+    MessageType["PREPARED_PRIORITY"] = "prepared_priority";
+})(MessageType || (exports.MessageType = MessageType = {}));
+/**
+ * Transaction status enumeration
+ * @enum TransactionStatus
+ */
+var TransactionStatus;
+(function (TransactionStatus) {
+    /** Transaction successful */
+    TransactionStatus["SUCCESS"] = "success";
+    /** Transaction failed */
+    TransactionStatus["FAILED"] = "failed";
+    /** Transaction pending confirmation */
+    TransactionStatus["PENDING"] = "pending";
+})(TransactionStatus || (exports.TransactionStatus = TransactionStatus = {}));
+// ============================================================================
+// TYPE GUARDS
+// ============================================================================
+/**
+ * Type guard to check if a value is a Solana PublicKey string
+ * @param value - Value to check
+ * @returns True if value is a valid Solana address
+ */
+function isSolanaAddress(value) {
+    return (typeof value === 'string' && /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(value));
+}
+/**
+ * Type guard to check if a value is an EVM address
+ * @param value - Value to check
+ * @returns True if value is EVM address string
+ */
+function isEvmAddress(value) {
+    return typeof value === 'string' && /^0x[a-fA-F0-9]{40}$/.test(value);
+}
+/**
+ * Type guard to check if recipient is for Solana
+ * @param recipient - Message recipient
+ * @returns True if recipient is Solana address
+ */
+function isSolanaRecipient(recipient) {
+    return isSolanaAddress(recipient);
+}
+/**
+ * Type guard to check if recipient is for EVM
+ * @param recipient - Message recipient
+ * @returns True if recipient is EVM address
+ */
+function isEvmRecipient(recipient) {
+    return isEvmAddress(recipient);
+}
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+/**
+ * Protocol constants used across implementations
+ */
+exports.PROTOCOL_CONSTANTS = {
+    /** Base send fee: 0.1 USDC (100,000 with 6 decimals) */
+    SEND_FEE: 100000n,
+    /** Claim period: 60 days in seconds */
+    CLAIM_PERIOD: 60 * 24 * 60 * 60,
+    /** Revenue share percentages */
+    REVENUE_SHARES: {
+        SENDER: 90,
+        OWNER: 10,
+    },
+    /** USDC token decimals */
+    USDC_DECIMALS: 6,
+    /** Maximum message lengths */
+    MAX_LENGTHS: {
+        SUBJECT: 200,
+        BODY: 2000,
+        MAIL_ID: 100,
+    },
+};
+//# sourceMappingURL=common.js.map

package/dist/types/blockchain/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/types/blockchain/common.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAiRH,0CAIC;AAOD,oCAEC;AAOD,8CAEC;AAOD,wCAEC;AAtOD;;;GAGG;AACH,IAAY,WASX;AATD,WAAY,WAAW;IACrB,oCAAoC;IACpC,oCAAqB,CAAA;IACrB,2DAA2D;IAC3D,oCAAqB,CAAA;IACrB,oCAAoC;IACpC,sDAAuC,CAAA;IACvC,oCAAoC;IACpC,sDAAuC,CAAA;AACzC,CAAC,EATW,WAAW,2BAAX,WAAW,QAStB;AAiHD;;;GAGG;AACH,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,6BAA6B;IAC7B,wCAAmB,CAAA;IACnB,yBAAyB;IACzB,sCAAiB,CAAA;IACjB,uCAAuC;IACvC,wCAAmB,CAAA;AACrB,CAAC,EAPW,iBAAiB,iCAAjB,iBAAiB,QAO5B;AAqDD,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;;;GAIG;AACH,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,CACzE,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,SAA2B;IAC3D,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,SAA2B;IACxD,OAAO,YAAY,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;GAEG;AACU,QAAA,kBAAkB,GAAG;IAChC,wDAAwD;IACxD,QAAQ,EAAE,OAAQ;IAElB,uCAAuC;IACvC,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IAE/B,gCAAgC;IAChC,cAAc,EAAE;QACd,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,EAAE;KACV;IAED,0BAA0B;IAC1B,aAAa,EAAE,CAAC;IAEhB,8BAA8B;IAC9B,WAAW,EAAE;QACX,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,GAAG;KACb;CACO,CAAC"}

package/dist/types/blockchain/index.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateMessage = exports.validateDomain = exports.validateAmount = exports.validateAddress = exports.isSolanaRecipient = exports.isSolanaAddress = exports.isEvmRecipient = exports.isEvmAddress = exports.TransactionStatus = exports.PROTOCOL_CONSTANTS = exports.MessageType = void 0;
+var common_1 = require("./common");
+Object.defineProperty(exports, "MessageType", { enumerable: true, get: function () { return common_1.MessageType; } });
+Object.defineProperty(exports, "PROTOCOL_CONSTANTS", { enumerable: true, get: function () { return common_1.PROTOCOL_CONSTANTS; } });
+Object.defineProperty(exports, "TransactionStatus", { enumerable: true, get: function () { return common_1.TransactionStatus; } });
+Object.defineProperty(exports, "isEvmAddress", { enumerable: true, get: function () { return common_1.isEvmAddress; } });
+Object.defineProperty(exports, "isEvmRecipient", { enumerable: true, get: function () { return common_1.isEvmRecipient; } });
+Object.defineProperty(exports, "isSolanaAddress", { enumerable: true, get: function () { return common_1.isSolanaAddress; } });
+Object.defineProperty(exports, "isSolanaRecipient", { enumerable: true, get: function () { return common_1.isSolanaRecipient; } });
+// Validation types
+var validation_1 = require("./validation");
+Object.defineProperty(exports, "validateAddress", { enumerable: true, get: function () { return validation_1.validateAddress; } });
+Object.defineProperty(exports, "validateAmount", { enumerable: true, get: function () { return validation_1.validateAmount; } });
+Object.defineProperty(exports, "validateDomain", { enumerable: true, get: function () { return validation_1.validateDomain; } });
+Object.defineProperty(exports, "validateMessage", { enumerable: true, get: function () { return validation_1.validateMessage; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,4 @@
+export type { ChainConfig, ClaimableRevenue, ClientConfig, DeploymentAddresses, FeeStructure, Message, MessageFilter, MessageRecipient, OperationError, PaginationOptions, PreparedMessage, Result, RpcConfig, SendMessageOptions, TransactionResult, } from './common';
+export { MessageType, PROTOCOL_CONSTANTS, TransactionStatus, isEvmAddress, isEvmRecipient, isSolanaAddress, isSolanaRecipient, } from './common';
+export { validateAddress, validateAmount, validateDomain, validateMessage, } from './validation';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/blockchain/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,MAAM,EACN,SAAS,EACT,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/types/blockchain/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateMessage = exports.validateDomain = exports.validateAmount = exports.validateAddress = exports.isSolanaRecipient = exports.isSolanaAddress = exports.isEvmRecipient = exports.isEvmAddress = exports.TransactionStatus = exports.PROTOCOL_CONSTANTS = exports.MessageType = void 0;
+var common_1 = require("./common");
+Object.defineProperty(exports, "MessageType", { enumerable: true, get: function () { return common_1.MessageType; } });
+Object.defineProperty(exports, "PROTOCOL_CONSTANTS", { enumerable: true, get: function () { return common_1.PROTOCOL_CONSTANTS; } });
+Object.defineProperty(exports, "TransactionStatus", { enumerable: true, get: function () { return common_1.TransactionStatus; } });
+Object.defineProperty(exports, "isEvmAddress", { enumerable: true, get: function () { return common_1.isEvmAddress; } });
+Object.defineProperty(exports, "isEvmRecipient", { enumerable: true, get: function () { return common_1.isEvmRecipient; } });
+Object.defineProperty(exports, "isSolanaAddress", { enumerable: true, get: function () { return common_1.isSolanaAddress; } });
+Object.defineProperty(exports, "isSolanaRecipient", { enumerable: true, get: function () { return common_1.isSolanaRecipient; } });
+// Validation types
+var validation_1 = require("./validation");
+Object.defineProperty(exports, "validateAddress", { enumerable: true, get: function () { return validation_1.validateAddress; } });
+Object.defineProperty(exports, "validateAmount", { enumerable: true, get: function () { return validation_1.validateAmount; } });
+Object.defineProperty(exports, "validateDomain", { enumerable: true, get: function () { return validation_1.validateDomain; } });
+Object.defineProperty(exports, "validateMessage", { enumerable: true, get: function () { return validation_1.validateMessage; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/blockchain/index.ts"],"names":[],"mappings":";;;AAmBA,mCAQkB;AAPhB,qGAAA,WAAW,OAAA;AACX,4GAAA,kBAAkB,OAAA;AAClB,2GAAA,iBAAiB,OAAA;AACjB,sGAAA,YAAY,OAAA;AACZ,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,2GAAA,iBAAiB,OAAA;AAGnB,mBAAmB;AACnB,2CAKsB;AAJpB,6GAAA,eAAe,OAAA;AACf,4GAAA,cAAc,OAAA;AACd,4GAAA,cAAc,OAAA;AACd,6GAAA,eAAe,OAAA"}