@bloxchain/sdk 1.0.0-alpha

package/dist/utils/metaTx/metaTransaction.js

@@ -0,0 +1,271 @@
+import BaseStateMachineABI from '../../abi/BaseStateMachine.abi.json';
+/**
+ * @title MetaTransactionSigner
+ * @dev Standardized utility for creating and signing meta-transactions
+ *
+ * This utility leverages the contract's own EIP-712 message hash generation
+ * to avoid JavaScript replication issues and ensure signature compatibility.
+ *
+ * Architecture:
+ * - Step 1: Create unsigned meta-transaction (contract generates message hash)
+ * - Step 2: Sign the message hash (programmatic or external wallet)
+ * - Step 3: Verify signature and return complete meta-transaction
+ *
+ * Key Features:
+ * - Contract-based message hash generation
+ * - Separated unsigned creation and signing steps
+ * - Support for programmatic and frontend wallet signing
+ * - Type-safe meta-transaction creation
+ * - Automatic signature verification
+ * - Support for both new and existing transactions
+ *
+ * Security: Uses the contract's generateUnsignedForNewMetaTx/generateUnsignedForExistingMetaTx
+ * functions to ensure exact EIP-712 compliance with the on-chain implementation.
+ */
+export class MetaTransactionSigner {
+    constructor(client, walletClient, contractAddress, chain) {
+        this.client = client;
+        this.walletClient = walletClient;
+        this.contractAddress = contractAddress;
+        this.chain = chain;
+    }
+    /**
+     * @dev Creates an unsigned meta-transaction for a new operation
+     * @param txParams Transaction parameters
+     * @param metaTxParams Meta-transaction parameters
+     * @returns Unsigned meta-transaction ready for signing
+     */
+    async createUnsignedMetaTransactionForNew(txParams, metaTxParams) {
+        // Call the private method which handles the contract call
+        return await this.generateUnsignedMetaTransactionForNew(txParams, metaTxParams);
+    }
+    /**
+     * @dev Creates an unsigned meta-transaction for an existing operation
+     * @param txId Existing transaction ID
+     * @param metaTxParams Meta-transaction parameters
+     * @returns Unsigned meta-transaction ready for signing
+     */
+    async createUnsignedMetaTransactionForExisting(txId, metaTxParams) {
+        const result = await this.generateUnsignedMetaTransactionForExisting(txId, metaTxParams);
+        // The contract returns a complete MetaTransaction with data field populated
+        return {
+            txRecord: result.txRecord,
+            params: result.params,
+            message: result.message,
+            signature: result.signature,
+            data: result.data
+        };
+    }
+    /**
+     * @dev Signs an unsigned meta-transaction using private key (for remote Ganache compatibility)
+     * @param unsignedMetaTx Unsigned meta-transaction
+     * @param signerAddress Address of the signer
+     * @param privateKey Private key for signing (required for remote Ganache)
+     * @returns Complete signed meta-transaction
+     */
+    async signMetaTransaction(unsignedMetaTx, signerAddress, privateKey) {
+        // Use private key signing directly (matches sanity test pattern)
+        const { privateKeyToAccount } = await import('viem/accounts');
+        const account = privateKeyToAccount(privateKey);
+        // Sign the message hash using the account
+        const signature = await account.signMessage({
+            message: { raw: unsignedMetaTx.message }
+        });
+        // Verify signature matches expected signer
+        const recoveredAddress = await this.client.verifyMessage({
+            address: signerAddress,
+            message: { raw: unsignedMetaTx.message },
+            signature
+        });
+        if (!recoveredAddress) {
+            throw new Error('Signature verification failed');
+        }
+        // Return complete signed meta-transaction
+        return {
+            ...unsignedMetaTx,
+            signature
+        };
+    }
+    /**
+     * @dev Creates a signed meta-transaction with external signature (for frontend wallets)
+     * @param unsignedMetaTx Unsigned meta-transaction
+     * @param signature External signature from wallet
+     * @returns Complete signed meta-transaction
+     */
+    async createSignedMetaTransactionWithSignature(unsignedMetaTx, signature) {
+        // Verify signature
+        await this.verifySignature(unsignedMetaTx.message, signature, unsignedMetaTx.params.signer);
+        // Return complete signed meta-transaction
+        return {
+            ...unsignedMetaTx,
+            signature
+        };
+    }
+    /**
+     * @dev Creates a signed meta-transaction for a new operation (convenience method)
+     * @param txParams Transaction parameters
+     * @param metaTxParams Meta-transaction parameters
+     * @param signerAddress Address of the signer
+     * @param privateKey Private key for signing (required for remote Ganache)
+     * @returns Complete signed meta-transaction
+     */
+    async createSignedMetaTransactionForNew(txParams, metaTxParams, signerAddress, privateKey) {
+        const unsignedMetaTx = await this.createUnsignedMetaTransactionForNew(txParams, metaTxParams);
+        return await this.signMetaTransaction(unsignedMetaTx, signerAddress, privateKey);
+    }
+    /**
+     * @dev Creates a signed meta-transaction for an existing transaction (convenience method)
+     * @param txId Existing transaction ID
+     * @param metaTxParams Meta-transaction parameters
+     * @param signerAddress Address of the signer
+     * @param privateKey Private key for signing (required for remote Ganache)
+     * @returns Complete signed meta-transaction
+     */
+    async createSignedMetaTransactionForExisting(txId, metaTxParams, signerAddress, privateKey) {
+        const unsignedMetaTx = await this.createUnsignedMetaTransactionForExisting(txId, metaTxParams);
+        return await this.signMetaTransaction(unsignedMetaTx, signerAddress, privateKey);
+    }
+    /**
+     * @dev Generates unsigned meta-transaction for new operation using contract
+     * @param txParams Transaction parameters
+     * @param metaTxParams Meta-transaction parameters
+     * @returns Complete MetaTransaction from contract (with data field populated)
+     */
+    async generateUnsignedMetaTransactionForNew(txParams, metaTxParams) {
+        const result = await this.client.readContract({
+            address: this.contractAddress,
+            abi: this.getContractABI(),
+            functionName: 'generateUnsignedMetaTransactionForNew',
+            args: [
+                txParams.requester,
+                txParams.target,
+                txParams.value,
+                txParams.gasLimit,
+                txParams.operationType,
+                txParams.executionSelector,
+                txParams.executionParams,
+                metaTxParams
+            ],
+            // Include account for permission checks if wallet client is available
+            account: this.walletClient?.account
+        });
+        // The contract returns a complete MetaTransaction struct
+        // Extract all fields including data which is computed by prepareTransactionData
+        const metaTx = result;
+        if (!metaTx.message || metaTx.message === '0x0000000000000000000000000000000000000000000000000000000000000000') {
+            throw new Error('Contract did not generate a valid message hash');
+        }
+        return {
+            txRecord: metaTx.txRecord,
+            params: metaTx.params,
+            message: metaTx.message,
+            signature: metaTx.signature,
+            data: metaTx.data
+        };
+    }
+    /**
+     * @dev Generates unsigned meta-transaction for existing operation using contract
+     * @param txId Transaction ID
+     * @param metaTxParams Meta-transaction parameters
+     * @returns Complete MetaTransaction from contract (with data field populated)
+     */
+    async generateUnsignedMetaTransactionForExisting(txId, metaTxParams) {
+        const result = await this.client.readContract({
+            address: this.contractAddress,
+            abi: this.getContractABI(),
+            functionName: 'generateUnsignedMetaTransactionForExisting',
+            args: [txId, metaTxParams],
+            // Include account for permission checks if wallet client is available
+            account: this.walletClient?.account
+        });
+        // The contract returns a complete MetaTransaction struct
+        // Extract all fields including data which is computed by prepareTransactionData
+        const metaTx = result;
+        if (!metaTx.message || metaTx.message === '0x0000000000000000000000000000000000000000000000000000000000000000') {
+            throw new Error('Contract did not generate a valid message hash');
+        }
+        return {
+            txRecord: metaTx.txRecord,
+            params: metaTx.params,
+            message: metaTx.message,
+            signature: metaTx.signature,
+            data: metaTx.data
+        };
+    }
+    /**
+     * @dev Verifies a signature against a message hash and expected signer
+     * @param messageHash The message hash
+     * @param signature The signature to verify
+     * @param expectedSigner The expected signer address
+     */
+    async verifySignature(messageHash, signature, expectedSigner) {
+        const recoveredAddress = await this.client.verifyMessage({
+            address: expectedSigner,
+            message: { raw: messageHash },
+            signature
+        });
+        if (!recoveredAddress) {
+            throw new Error('Signature verification failed');
+        }
+    }
+    /**
+     * @dev Gets the contract ABI for meta-transaction functions
+     * Uses BaseStateMachine ABI to match the actual deployed contract
+     * @returns Contract ABI
+     */
+    getContractABI() {
+        return BaseStateMachineABI;
+    }
+}
+/**
+ * @dev Helper functions for creating meta-transaction parameters
+ */
+export class MetaTransactionBuilder {
+    /**
+     * @dev Creates meta-transaction parameters
+     * @param handlerContract Handler contract address
+     * @param handlerSelector Handler function selector
+     * @param action Transaction action
+     * @param deadline Deadline timestamp
+     * @param maxGasPrice Maximum gas price
+     * @param signer Signer address
+     * @param chainId Chain ID (optional, defaults to current chain)
+     * @param nonce Nonce (optional, will be fetched from contract)
+     * @returns Meta-transaction parameters
+     */
+    static createMetaTxParams(handlerContract, handlerSelector, action, deadline, maxGasPrice, signer, chainId, nonce) {
+        return {
+            chainId: chainId, // Default to mainnet
+            nonce: nonce || 0n,
+            handlerContract,
+            handlerSelector,
+            action,
+            deadline,
+            maxGasPrice,
+            signer
+        };
+    }
+    /**
+     * @dev Creates transaction parameters
+     * @param requester Requester address
+     * @param target Target contract address
+     * @param value Value to send
+     * @param gasLimit Gas limit
+     * @param operationType Operation type
+     * @param executionSelector Execution selector (bytes4)
+     * @param executionParams Execution parameters
+     * @returns Transaction parameters
+     */
+    static createTxParams(requester, target, value, gasLimit, operationType, executionSelector, executionParams) {
+        return {
+            requester,
+            target,
+            value,
+            gasLimit,
+            operationType,
+            executionSelector,
+            executionParams
+        };
+    }
+}
+//# sourceMappingURL=metaTransaction.js.map

package/dist/utils/metaTx/metaTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metaTransaction.js","sourceRoot":"","sources":["../../../utils/metaTx/metaTransaction.tsx"],"names":[],"mappings":"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"}

package/dist/utils/validations.d.ts

@@ -0,0 +1,104 @@
+import { Address, PublicClient } from 'viem';
+import { MetaTransaction } from '../interfaces/lib.index';
+export declare class ContractValidations {
+    private client;
+    constructor(client: PublicClient);
+    /**
+     * @notice Validates a meta transaction's parameters
+     * @param metaTx The meta transaction to validate
+     * @throws Error if any validation fails
+     */
+    validateMetaTransaction(metaTx: MetaTransaction): Promise<void>;
+    /**
+     * @notice Validates a transaction record's parameters
+     * @param txRecord The transaction record to validate
+     * @throws Error if any validation fails
+     * @private
+     */
+    private validateTxRecord;
+    /**
+     * @notice Validates transaction parameters
+     * @param params The transaction parameters to validate
+     * @throws Error if any validation fails
+     * @private
+     */
+    private validateTxParams;
+    /**
+     * @notice Validates if a string is a valid hex value
+     * @param value The hex string to validate
+     * @param exactBytes Optional parameter for exact byte length
+     * @returns boolean indicating if the hex string is valid
+     * @private
+     */
+    private isValidHex;
+    /**
+     * @notice Validates payment details
+     * @param payment The payment details to validate
+     * @throws Error if any validation fails
+     * @private
+     */
+    private validatePaymentDetails;
+    /**
+     * @notice Validates if a timestamp is in the future
+     * @param timestamp The timestamp to validate
+     * @param errorMessage Custom error message
+     * @throws Error if timestamp is not in the future
+     */
+    validateFutureTimestamp(timestamp: number, errorMessage?: string): void;
+    /**
+     * @notice Validates if a period in minutes is valid
+     * @param periodInMinutes The period to validate
+     * @param errorMessage Custom error message
+     * @throws Error if period is not valid
+     */
+    validateTimePeriod(periodInMinutes: number, errorMessage?: string): void;
+    /**
+     * @notice Validates if an address has admin owner role
+     * @dev Equivalent to onlyAdminOwner modifier in Solidity
+     * @param address The address to validate
+     * @param adminOwner The expected admin owner address
+     * @throws Error if address is not admin owner
+     */
+    validateAdminOwner(address: Address | undefined, adminOwner: Address): void;
+    /**
+     * @notice Validates if an address has broadcaster role
+     * @dev Equivalent to onlyBroadcaster modifier in Solidity
+     * @param address The address to validate
+     * @param broadcaster The expected broadcaster address
+     * @throws Error if address is not broadcaster
+     */
+    validateBroadcaster(address: Address | undefined, broadcaster: Address): void;
+    /**
+     * @notice Validates if an address has recovery role
+     * @dev Equivalent to onlyRecovery modifier in Solidity
+     * @param address The address to validate
+     * @param recovery The expected recovery address
+     * @throws Error if address is not recovery address
+     */
+    validateRecovery(address: Address | undefined, recovery: Address): void;
+    /**
+     * @notice Validates if an address has a specific role
+     * @param address The address to validate
+     * @param roleAddress The expected role address
+     * @param roleName The name of the role for error messages
+     * @throws Error if address doesn't match role address
+     */
+    validateRole(address: Address | undefined, roleAddress: Address, roleName: string): void;
+    /**
+     * @notice Validates if an address has either of two roles
+     * @param address The address to validate
+     * @param role1Address First role address
+     * @param role2Address Second role address
+     * @param roleNames Names of the roles for error messages
+     * @throws Error if address doesn't match either role
+     */
+    validateMultipleRoles(address: Address | undefined, role1Address: Address, role2Address: Address, roleNames: string): void;
+    /**
+     * @notice Validates native token balance
+     * @param contractAddress The contract address to check
+     * @param requiredAmount The required balance amount
+     * @throws Error if balance is insufficient
+     */
+    validateNativeTokenBalance(contractAddress: Address, requiredAmount: bigint): Promise<void>;
+}
+//# sourceMappingURL=validations.d.ts.map

package/dist/utils/validations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validations.d.ts","sourceRoot":"","sources":["../../utils/validations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAA4B,MAAM,MAAM,CAAC;AACvE,OAAO,EAAE,eAAe,EAAsC,MAAM,yBAAyB,CAAC;AAG9F,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAG9B;;;;OAIG;IACG,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CrE;;;;;OAKG;YACW,gBAAgB;IAkC9B;;;;;OAKG;YACW,gBAAgB;IAsC9B;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAiBlB;;;;;OAKG;YACW,sBAAsB;IAwBpC;;;;;OAKG;IACH,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,GAAE,MAA0C,GAAG,IAAI;IAM1G;;;;;OAKG;IACH,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,GAAE,MAA8B,GAAG,IAAI;IAM/F;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAI3E;;;;;;OAMG;IACH,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI;IAI7E;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAIvE;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMxF;;;;;;;OAOG;IACH,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAM1H;;;;;OAKG;IACG,0BAA0B,CAAC,eAAe,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMlG"}

package/dist/utils/validations.js

@@ -0,0 +1,254 @@
+import { TxStatus } from '../types/lib.index';
+export class ContractValidations {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * @notice Validates a meta transaction's parameters
+     * @param metaTx The meta transaction to validate
+     * @throws Error if any validation fails
+     */
+    async validateMetaTransaction(metaTx) {
+        // Validate signature
+        // 65 bytes signature when converted to hex string becomes 132 characters (0x + 130)
+        if (!metaTx.signature || metaTx.signature.length !== 132) {
+            throw new Error("Invalid signature length");
+        }
+        // Validate chain ID
+        const currentChainId = await this.client.getChainId();
+        if (BigInt(metaTx.params.chainId) !== BigInt(currentChainId)) {
+            throw new Error("Chain ID mismatch");
+        }
+        // Validate handler contract
+        if (!metaTx.params.handlerContract) {
+            throw new Error("Invalid handler contract address");
+        }
+        // Validate handler selector (must be 4 bytes)
+        if (!metaTx.params.handlerSelector || !(/^0x[0-9a-f]{8}$/i.test(metaTx.params.handlerSelector))) {
+            throw new Error("Invalid handler selector format");
+        }
+        // Validate deadline
+        const currentTimestamp = Math.floor(Date.now() / 1000);
+        if (currentTimestamp > metaTx.params.deadline) {
+            throw new Error("Meta-transaction expired");
+        }
+        // Validate max gas price
+        const currentGasPrice = await this.client.getGasPrice();
+        if (currentGasPrice > BigInt(metaTx.params.maxGasPrice) && metaTx.params.maxGasPrice > BigInt(0)) {
+            throw new Error(`Current gas price exceeds maximum allowed: ${currentGasPrice} > ${metaTx.params.maxGasPrice}`);
+        }
+        // Validate signer
+        if (!metaTx.params.signer) {
+            throw new Error("Invalid signer address");
+        }
+        // Validate transaction record
+        await this.validateTxRecord(metaTx.txRecord);
+    }
+    /**
+     * @notice Validates a transaction record's parameters
+     * @param txRecord The transaction record to validate
+     * @throws Error if any validation fails
+     * @private
+     */
+    async validateTxRecord(txRecord) {
+        // Validate txId
+        if (txRecord.txId <= 0) {
+            throw new Error("Invalid transaction ID");
+        }
+        // Validate status (must be PENDING for meta transactions)
+        if (txRecord.status !== TxStatus.PENDING) {
+            throw new Error(`Transaction must be in pending state: ${txRecord.status}`);
+        }
+        // Validate params
+        await this.validateTxParams(txRecord.params);
+        // Validate result (must be empty for pending transactions)
+        if (txRecord.result) {
+            // First check if it's a valid hex string
+            if (!this.isValidHex(txRecord.result)) {
+                throw new Error("Invalid hex format for transaction result");
+            }
+            // For pending transactions, only allow '0x' or '0x0' or '0x000000'
+            const strippedResult = txRecord.result.replace(/^0x0*$/, '0x');
+            if (strippedResult !== '0x') {
+                throw new Error("Result must be empty for pending transactions");
+            }
+        }
+        // Validate payment details if present
+        if (txRecord.payment) {
+            await this.validatePaymentDetails(txRecord.payment);
+        }
+    }
+    /**
+     * @notice Validates transaction parameters
+     * @param params The transaction parameters to validate
+     * @throws Error if any validation fails
+     * @private
+     */
+    async validateTxParams(params) {
+        // Validate requester address
+        if (!params.requester) {
+            throw new Error("Invalid requester address");
+        }
+        // Validate target address
+        if (!params.target) {
+            throw new Error("Invalid target address");
+        }
+        // Validate value (must be non-negative)
+        if (BigInt(params.value) < BigInt(0)) {
+            throw new Error("Negative value not allowed");
+        }
+        // Validate gas limit (0 means use all available gas, which is valid)
+        if (params.gasLimit < 0) {
+            throw new Error("Invalid gas limit");
+        }
+        // Validate operation type (must be valid hex)
+        if (!(/^0x[0-9a-f]{64}$/i.test(params.operationType))) {
+            throw new Error("Invalid operation type format");
+        }
+        // Validate execution selector (must be valid bytes4)
+        if (!(/^0x[0-9a-f]{8}$/i.test(params.executionSelector))) {
+            throw new Error("Invalid execution selector format");
+        }
+        // Validate execution params (must be valid hex)
+        if (!params.executionParams || !(/^0x[0-9a-f]*$/i.test(params.executionParams))) {
+            throw new Error("Missing or invalid parameters");
+        }
+    }
+    /**
+     * @notice Validates if a string is a valid hex value
+     * @param value The hex string to validate
+     * @param exactBytes Optional parameter for exact byte length
+     * @returns boolean indicating if the hex string is valid
+     * @private
+     */
+    isValidHex(value, exactBytes) {
+        if (!value || typeof value !== 'string' || !value.startsWith('0x')) {
+            return false;
+        }
+        const hexDigits = value.slice(2);
+        if (hexDigits.length % 2 !== 0) {
+            return false;
+        }
+        if (exactBytes !== undefined && hexDigits.length !== exactBytes * 2) {
+            return false;
+        }
+        return /^[0-9a-f]*$/i.test(hexDigits);
+    }
+    /**
+     * @notice Validates payment details
+     * @param payment The payment details to validate
+     * @throws Error if any validation fails
+     * @private
+     */
+    async validatePaymentDetails(payment) {
+        // Validate recipient address if any payment is specified
+        if (BigInt(payment.nativeTokenAmount) > BigInt(0) || BigInt(payment.erc20TokenAmount) > BigInt(0)) {
+            if (!payment.recipient) {
+                throw new Error("Invalid payment recipient address");
+            }
+        }
+        // Validate native token amount
+        if (BigInt(payment.nativeTokenAmount) < BigInt(0)) {
+            throw new Error("Negative native token amount not allowed");
+        }
+        // Validate ERC20 token details if specified
+        if (BigInt(payment.erc20TokenAmount) > BigInt(0)) {
+            if (!payment.erc20TokenAddress) {
+                throw new Error("Invalid ERC20 token address");
+            }
+            if (BigInt(payment.erc20TokenAmount) < BigInt(0)) {
+                throw new Error("Negative ERC20 token amount not allowed");
+            }
+        }
+    }
+    /**
+     * @notice Validates if a timestamp is in the future
+     * @param timestamp The timestamp to validate
+     * @param errorMessage Custom error message
+     * @throws Error if timestamp is not in the future
+     */
+    validateFutureTimestamp(timestamp, errorMessage = "Timestamp must be in the future") {
+        if (timestamp <= Math.floor(Date.now() / 1000)) {
+            throw new Error(errorMessage);
+        }
+    }
+    /**
+     * @notice Validates if a period in minutes is valid
+     * @param periodInMinutes The period to validate
+     * @param errorMessage Custom error message
+     * @throws Error if period is not valid
+     */
+    validateTimePeriod(periodInMinutes, errorMessage = "Invalid time period") {
+        if (periodInMinutes <= 0) {
+            throw new Error(errorMessage);
+        }
+    }
+    /**
+     * @notice Validates if an address has admin owner role
+     * @dev Equivalent to onlyAdminOwner modifier in Solidity
+     * @param address The address to validate
+     * @param adminOwner The expected admin owner address
+     * @throws Error if address is not admin owner
+     */
+    validateAdminOwner(address, adminOwner) {
+        this.validateRole(address, adminOwner, "admin owner");
+    }
+    /**
+     * @notice Validates if an address has broadcaster role
+     * @dev Equivalent to onlyBroadcaster modifier in Solidity
+     * @param address The address to validate
+     * @param broadcaster The expected broadcaster address
+     * @throws Error if address is not broadcaster
+     */
+    validateBroadcaster(address, broadcaster) {
+        this.validateRole(address, broadcaster, "broadcaster");
+    }
+    /**
+     * @notice Validates if an address has recovery role
+     * @dev Equivalent to onlyRecovery modifier in Solidity
+     * @param address The address to validate
+     * @param recovery The expected recovery address
+     * @throws Error if address is not recovery address
+     */
+    validateRecovery(address, recovery) {
+        this.validateRole(address, recovery, "recovery owner");
+    }
+    /**
+     * @notice Validates if an address has a specific role
+     * @param address The address to validate
+     * @param roleAddress The expected role address
+     * @param roleName The name of the role for error messages
+     * @throws Error if address doesn't match role address
+     */
+    validateRole(address, roleAddress, roleName) {
+        if (!address || address !== roleAddress) {
+            throw new Error(`Restricted to ${roleName}`);
+        }
+    }
+    /**
+     * @notice Validates if an address has either of two roles
+     * @param address The address to validate
+     * @param role1Address First role address
+     * @param role2Address Second role address
+     * @param roleNames Names of the roles for error messages
+     * @throws Error if address doesn't match either role
+     */
+    validateMultipleRoles(address, role1Address, role2Address, roleNames) {
+        if (!address || (address !== role1Address && address !== role2Address)) {
+            throw new Error(`Restricted to ${roleNames}`);
+        }
+    }
+    /**
+     * @notice Validates native token balance
+     * @param contractAddress The contract address to check
+     * @param requiredAmount The required balance amount
+     * @throws Error if balance is insufficient
+     */
+    async validateNativeTokenBalance(contractAddress, requiredAmount) {
+        const balance = await this.client.getBalance({ address: contractAddress });
+        if (balance < requiredAmount) {
+            throw new Error("Insufficient native token balance");
+        }
+    }
+}
+//# sourceMappingURL=validations.js.map

package/dist/utils/validations.js.map

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