@mantle-rwa/sdk 0.1.0

package/dist/cjs/modules/yield.js

@@ -0,0 +1,406 @@
+"use strict";
+/**
+ * YieldModule - Handles yield distribution management
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.YieldModule = exports.YieldDistributorInstance = void 0;
+const ethers_1 = require("ethers");
+const constants_1 = require("../constants");
+const errors_1 = require("../errors");
+const utils_1 = require("../utils");
+/**
+ * Instance of a connected yield distributor
+ */
+class YieldDistributorInstance {
+    _contract;
+    _retries;
+    _retryDelay;
+    /** Distributor contract address */
+    address;
+    constructor(address, provider, signer, retries, retryDelay) {
+        this.address = (0, utils_1.normalizeAddress)(address);
+        this._retries = retries;
+        this._retryDelay = retryDelay;
+        this._contract = new ethers_1.ethers.Contract(this.address, constants_1.YIELD_DISTRIBUTOR_ABI, signer || provider);
+    }
+    /*//////////////////////////////////////////////////////////////
+                            READ FUNCTIONS
+    //////////////////////////////////////////////////////////////*/
+    /**
+     * Get the number of distributions
+     */
+    async distributionCount() {
+        const count = await this._contract.distributionCount();
+        return Number(count);
+    }
+    /**
+     * Get distribution information
+     */
+    async getDistributionInfo(distributionId) {
+        const [paymentToken, totalAmount, snapshotId, claimDeadline, claimedAmount] = await this._contract.getDistributionInfo(distributionId);
+        return {
+            id: distributionId,
+            paymentToken,
+            totalAmount,
+            snapshotId,
+            claimDeadline: (0, utils_1.timestampToDate)(claimDeadline),
+            claimedAmount,
+        };
+    }
+    /**
+     * Get claimable amount for an account
+     */
+    async getClaimableAmount(distributionId, account) {
+        return this._contract.getClaimableAmount(distributionId, (0, utils_1.normalizeAddress)(account));
+    }
+    /**
+     * Check if an account has claimed from a distribution
+     */
+    async hasClaimed(distributionId, account) {
+        return this._contract.hasClaimed(distributionId, (0, utils_1.normalizeAddress)(account));
+    }
+    /**
+     * Get all distributions
+     */
+    async getDistributionHistory() {
+        const count = await this.distributionCount();
+        const distributions = [];
+        for (let i = 0; i < count; i++) {
+            distributions.push(await this.getDistributionInfo(i));
+        }
+        return distributions;
+    }
+    /**
+     * Get pending claims for an account
+     */
+    async getPendingClaims(account) {
+        const count = await this.distributionCount();
+        const pendingClaims = [];
+        const now = new Date();
+        for (let i = 0; i < count; i++) {
+            const hasClaimed = await this.hasClaimed(i, account);
+            if (hasClaimed)
+                continue;
+            const distribution = await this.getDistributionInfo(i);
+            if (distribution.claimDeadline < now)
+                continue;
+            const amount = await this.getClaimableAmount(i, account);
+            if (amount === 0n)
+                continue;
+            pendingClaims.push({
+                distributionId: i,
+                amount,
+                paymentToken: distribution.paymentToken,
+                deadline: distribution.claimDeadline,
+            });
+        }
+        return pendingClaims;
+    }
+    /*//////////////////////////////////////////////////////////////
+                            WRITE FUNCTIONS
+    //////////////////////////////////////////////////////////////*/
+    /**
+     * Create a new distribution
+     */
+    async createDistribution(paymentToken, totalAmount, claimWindowDays = constants_1.DEFAULTS.YIELD_CLAIM_WINDOW_DAYS, options) {
+        const tokenAddress = (0, utils_1.normalizeAddress)(paymentToken);
+        const amountWei = (0, utils_1.parseAmount)(totalAmount);
+        try {
+            const tx = await (0, utils_1.retry)(async () => {
+                const gasLimit = options?.gasLimit || await (0, utils_1.estimateGasWithBuffer)(() => this._contract.createDistribution.estimateGas(tokenAddress, amountWei, claimWindowDays));
+                return this._contract.createDistribution(tokenAddress, amountWei, claimWindowDays, { gasLimit });
+            }, { retries: options?.retries ?? this._retries, delay: options?.retryDelay ?? this._retryDelay });
+            const receipt = await tx.wait();
+            const events = (0, utils_1.parseEvents)(receipt, this._contract.interface);
+            const result = (0, utils_1.createTransactionResult)(receipt, events);
+            // Extract distribution ID from event
+            const createdEvent = events.find((e) => e.name === 'DistributionCreated');
+            const distributionId = Number(createdEvent?.args.distributionId || 0);
+            return { result, distributionId };
+        }
+        catch (error) {
+            throw (0, errors_1.parseContractError)(error, this.address, 'createDistribution');
+        }
+    }
+    /**
+     * Claim yield from a distribution
+     */
+    async claim(distributionId, options) {
+        try {
+            const tx = await (0, utils_1.retry)(async () => {
+                const gasLimit = options?.gasLimit || await (0, utils_1.estimateGasWithBuffer)(() => this._contract.claim.estimateGas(distributionId));
+                return this._contract.claim(distributionId, { gasLimit });
+            }, { retries: options?.retries ?? this._retries, delay: options?.retryDelay ?? this._retryDelay });
+            const receipt = await tx.wait();
+            const events = (0, utils_1.parseEvents)(receipt, this._contract.interface);
+            return (0, utils_1.createTransactionResult)(receipt, events);
+        }
+        catch (error) {
+            throw (0, errors_1.parseContractError)(error, this.address, 'claim');
+        }
+    }
+    /**
+     * Claim yield from multiple distributions
+     */
+    async claimMultiple(distributionIds, options) {
+        try {
+            const tx = await (0, utils_1.retry)(async () => {
+                const gasLimit = options?.gasLimit || await (0, utils_1.estimateGasWithBuffer)(() => this._contract.claimMultiple.estimateGas(distributionIds));
+                return this._contract.claimMultiple(distributionIds, { gasLimit });
+            }, { retries: options?.retries ?? this._retries, delay: options?.retryDelay ?? this._retryDelay });
+            const receipt = await tx.wait();
+            const events = (0, utils_1.parseEvents)(receipt, this._contract.interface);
+            return (0, utils_1.createTransactionResult)(receipt, events);
+        }
+        catch (error) {
+            throw (0, errors_1.parseContractError)(error, this.address, 'claimMultiple');
+        }
+    }
+    /**
+     * Handle unclaimed funds after claim window expires
+     */
+    async handleUnclaimedFunds(distributionId, options) {
+        try {
+            const tx = await (0, utils_1.retry)(async () => {
+                const gasLimit = options?.gasLimit || await (0, utils_1.estimateGasWithBuffer)(() => this._contract.handleUnclaimedFunds.estimateGas(distributionId));
+                return this._contract.handleUnclaimedFunds(distributionId, { gasLimit });
+            }, { retries: options?.retries ?? this._retries, delay: options?.retryDelay ?? this._retryDelay });
+            const receipt = await tx.wait();
+            const events = (0, utils_1.parseEvents)(receipt, this._contract.interface);
+            return (0, utils_1.createTransactionResult)(receipt, events);
+        }
+        catch (error) {
+            throw (0, errors_1.parseContractError)(error, this.address, 'handleUnclaimedFunds');
+        }
+    }
+    /**
+     * Set the unclaimed funds recipient
+     */
+    async setUnclaimedFundsRecipient(recipient, options) {
+        const recipientAddress = (0, utils_1.normalizeAddress)(recipient);
+        try {
+            const tx = await (0, utils_1.retry)(async () => {
+                const gasLimit = options?.gasLimit || await (0, utils_1.estimateGasWithBuffer)(() => this._contract.setUnclaimedFundsRecipient.estimateGas(recipientAddress));
+                return this._contract.setUnclaimedFundsRecipient(recipientAddress, { gasLimit });
+            }, { retries: options?.retries ?? this._retries, delay: options?.retryDelay ?? this._retryDelay });
+            const receipt = await tx.wait();
+            const events = (0, utils_1.parseEvents)(receipt, this._contract.interface);
+            return (0, utils_1.createTransactionResult)(receipt, events);
+        }
+        catch (error) {
+            throw (0, errors_1.parseContractError)(error, this.address, 'setUnclaimedFundsRecipient');
+        }
+    }
+    /*//////////////////////////////////////////////////////////////
+                            EVENT LISTENERS
+    //////////////////////////////////////////////////////////////*/
+    /**
+     * Listen for DistributionCreated events
+     */
+    onDistributionCreated(callback) {
+        const listener = (distributionId, paymentToken, totalAmount, snapshotId) => {
+            callback(distributionId, paymentToken, totalAmount, snapshotId);
+        };
+        this._contract.on('DistributionCreated', listener);
+        return () => this._contract.off('DistributionCreated', listener);
+    }
+    /**
+     * Listen for YieldClaimed events
+     */
+    onYieldClaimed(callback) {
+        const listener = (distributionId, claimant, amount) => {
+            callback(distributionId, claimant, amount);
+        };
+        this._contract.on('YieldClaimed', listener);
+        return () => this._contract.off('YieldClaimed', listener);
+    }
+}
+exports.YieldDistributorInstance = YieldDistributorInstance;
+/**
+ * Module for yield distribution operations
+ */
+class YieldModule {
+    _provider;
+    _signer;
+    _retries;
+    _retryDelay;
+    constructor(provider, signer, retries, retryDelay) {
+        this._provider = provider;
+        this._signer = signer;
+        this._retries = retries;
+        this._retryDelay = retryDelay;
+    }
+    /**
+     * Connect to an existing yield distributor
+     */
+    connect(address) {
+        if (!(0, utils_1.isValidAddress)(address)) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.INVALID_ADDRESS, `Invalid distributor address: ${address}`);
+        }
+        return new YieldDistributorInstance(address, this._provider, this._signer, this._retries, this._retryDelay);
+    }
+    /**
+     * Create a distribution
+     *
+     * @param config - Distribution configuration
+     * @returns Transaction result with distribution ID
+     */
+    async distribute(config) {
+        if (!(0, utils_1.isValidAddress)(config.tokenAddress)) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.INVALID_ADDRESS, `Invalid token address: ${config.tokenAddress}`);
+        }
+        if (!(0, utils_1.isValidAddress)(config.paymentToken)) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.INVALID_ADDRESS, `Invalid payment token address: ${config.paymentToken}`);
+        }
+        const distributor = this.connect(config.tokenAddress);
+        return distributor.createDistribution(config.paymentToken, config.totalAmount, config.claimWindowDays);
+    }
+    /**
+     * Preview a distribution (calculate per-holder amounts)
+     *
+     * This method calculates what each holder would receive based on their
+     * proportional ownership at the snapshot time.
+     *
+     * @param tokenAddress - The RWA token address
+     * @param totalAmount - Total amount to distribute (in token units)
+     * @param snapshotId - Optional snapshot ID (uses current balances if not provided)
+     * @param holderAddresses - Optional array of holder addresses to calculate for
+     * @returns Preview of the distribution with per-holder breakdown
+     */
+    async previewDistribution(tokenAddress, totalAmount, snapshotId, holderAddresses) {
+        if (!(0, utils_1.isValidAddress)(tokenAddress)) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.INVALID_ADDRESS, `Invalid token address: ${tokenAddress}`);
+        }
+        const token = new ethers_1.ethers.Contract(tokenAddress, constants_1.RWA_TOKEN_ABI, this._provider);
+        const totalAmountWei = (0, utils_1.parseAmount)(totalAmount);
+        // Get total supply at snapshot
+        let totalSupply;
+        if (snapshotId !== undefined) {
+            totalSupply = await token.totalSupplyAt(snapshotId);
+        }
+        else {
+            totalSupply = await token.totalSupply();
+        }
+        if (totalSupply === 0n) {
+            return {
+                totalHolders: 0,
+                totalSupplyAtSnapshot: 0n,
+                distributions: [],
+            };
+        }
+        // If holder addresses are provided, calculate their distributions
+        const distributions = [];
+        if (holderAddresses && holderAddresses.length > 0) {
+            for (const address of holderAddresses) {
+                const normalizedAddress = (0, utils_1.normalizeAddress)(address);
+                let balance;
+                if (snapshotId !== undefined) {
+                    balance = await token.balanceOfAt(normalizedAddress, snapshotId);
+                }
+                else {
+                    balance = await token.balanceOf(normalizedAddress);
+                }
+                if (balance > 0n) {
+                    // Calculate proportional yield amount
+                    const yieldAmount = (totalAmountWei * balance) / totalSupply;
+                    const percentage = Number((balance * 10000n) / totalSupply) / 100;
+                    distributions.push({
+                        address: normalizedAddress,
+                        balance,
+                        yieldAmount,
+                        percentage,
+                    });
+                }
+            }
+        }
+        return {
+            totalHolders: distributions.length,
+            totalSupplyAtSnapshot: totalSupply,
+            distributions,
+        };
+    }
+    /**
+     * Calculate yield amount for a specific holder
+     *
+     * @param tokenAddress - The RWA token address
+     * @param holderAddress - The holder's address
+     * @param totalAmount - Total distribution amount
+     * @param snapshotId - Optional snapshot ID
+     * @returns The calculated yield amount for the holder
+     */
+    async calculateHolderYield(tokenAddress, holderAddress, totalAmount, snapshotId) {
+        if (!(0, utils_1.isValidAddress)(tokenAddress)) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.INVALID_ADDRESS, `Invalid token address: ${tokenAddress}`);
+        }
+        if (!(0, utils_1.isValidAddress)(holderAddress)) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.INVALID_ADDRESS, `Invalid holder address: ${holderAddress}`);
+        }
+        const token = new ethers_1.ethers.Contract(tokenAddress, constants_1.RWA_TOKEN_ABI, this._provider);
+        const totalAmountWei = (0, utils_1.parseAmount)(totalAmount);
+        const normalizedHolder = (0, utils_1.normalizeAddress)(holderAddress);
+        // Get total supply and holder balance
+        let totalSupply;
+        let balance;
+        if (snapshotId !== undefined) {
+            totalSupply = await token.totalSupplyAt(snapshotId);
+            balance = await token.balanceOfAt(normalizedHolder, snapshotId);
+        }
+        else {
+            totalSupply = await token.totalSupply();
+            balance = await token.balanceOf(normalizedHolder);
+        }
+        if (totalSupply === 0n || balance === 0n) {
+            return { balance: 0n, yieldAmount: 0n, percentage: 0 };
+        }
+        // Calculate proportional yield amount
+        const yieldAmount = (totalAmountWei * balance) / totalSupply;
+        const percentage = Number((balance * 10000n) / totalSupply) / 100;
+        return { balance, yieldAmount, percentage };
+    }
+    /**
+     * Claim yield from a distribution
+     */
+    async claim(distributorAddress, distributionId) {
+        const distributor = this.connect(distributorAddress);
+        return distributor.claim(distributionId);
+    }
+    /**
+     * Claim all pending yields
+     */
+    async claimAll(distributorAddress) {
+        if (!this._signer) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.SIGNER_REQUIRED, 'A signer is required to claim yields');
+        }
+        const distributor = this.connect(distributorAddress);
+        const signerAddress = await this._signer.getAddress();
+        const pendingClaims = await distributor.getPendingClaims(signerAddress);
+        if (pendingClaims.length === 0) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.INVALID_CONFIGURATION, 'No pending claims to process');
+        }
+        const distributionIds = pendingClaims.map((c) => c.distributionId);
+        return distributor.claimMultiple(distributionIds);
+    }
+    /**
+     * Get claimable amount for an account
+     */
+    async getClaimableAmount(distributorAddress, distributionId, account) {
+        const distributor = this.connect(distributorAddress);
+        return distributor.getClaimableAmount(distributionId, account);
+    }
+    /**
+     * Get distribution history
+     */
+    async getDistributionHistory(distributorAddress) {
+        const distributor = this.connect(distributorAddress);
+        return distributor.getDistributionHistory();
+    }
+    /**
+     * Get pending claims for an account
+     */
+    async getPendingClaims(distributorAddress, account) {
+        const distributor = this.connect(distributorAddress);
+        return distributor.getPendingClaims(account);
+    }
+}
+exports.YieldModule = YieldModule;
+//# sourceMappingURL=yield.js.map

package/dist/cjs/modules/yield.js.map

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

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/types/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Core type definitions for the Mantle RWA SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccreditationTier = void 0;
+/*//////////////////////////////////////////////////////////////
+                    ACCREDITATION TYPES
+//////////////////////////////////////////////////////////////*/
+/**
+ * Accreditation tiers matching the smart contract enum
+ */
+var AccreditationTier;
+(function (AccreditationTier) {
+    AccreditationTier[AccreditationTier["None"] = 0] = "None";
+    AccreditationTier[AccreditationTier["Retail"] = 1] = "Retail";
+    AccreditationTier[AccreditationTier["Accredited"] = 2] = "Accredited";
+    AccreditationTier[AccreditationTier["Institutional"] = 3] = "Institutional";
+})(AccreditationTier || (exports.AccreditationTier = AccreditationTier = {}));
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAoCH;;gEAEgE;AAEhE;;GAEG;AACH,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,yDAAQ,CAAA;IACR,6DAAU,CAAA;IACV,qEAAc,CAAA;IACd,2EAAiB,CAAA;AACnB,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B"}

package/dist/cjs/utils/index.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * Utility functions for the Mantle RWA SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidAddress = isValidAddress;
+exports.normalizeAddress = normalizeAddress;
+exports.parseAmount = parseAmount;
+exports.formatAmount = formatAmount;
+exports.parseEvents = parseEvents;
+exports.createTransactionResult = createTransactionResult;
+exports.sleep = sleep;
+exports.retry = retry;
+exports.estimateGasWithBuffer = estimateGasWithBuffer;
+exports.hashIdentityData = hashIdentityData;
+exports.timestampToDate = timestampToDate;
+exports.dateToTimestamp = dateToTimestamp;
+exports.isExpired = isExpired;
+exports.calculatePercentage = calculatePercentage;
+exports.chunk = chunk;
+exports.waitForTransaction = waitForTransaction;
+const ethers_1 = require("ethers");
+const errors_1 = require("../errors");
+const constants_1 = require("../constants");
+/**
+ * Validate an Ethereum address
+ */
+function isValidAddress(address) {
+    try {
+        return ethers_1.ethers.isAddress(address);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validate and normalize an Ethereum address
+ */
+function normalizeAddress(address) {
+    if (!isValidAddress(address)) {
+        throw new Error(`Invalid address: ${address}`);
+    }
+    return ethers_1.ethers.getAddress(address);
+}
+/**
+ * Parse a string amount to bigint with decimals
+ */
+function parseAmount(amount, decimals = 18) {
+    return ethers_1.ethers.parseUnits(amount, decimals);
+}
+/**
+ * Format a bigint amount to string with decimals
+ */
+function formatAmount(amount, decimals = 18) {
+    return ethers_1.ethers.formatUnits(amount, decimals);
+}
+/**
+ * Parse events from a transaction receipt
+ */
+function parseEvents(receipt, contractInterface) {
+    const events = [];
+    for (const log of receipt.logs) {
+        try {
+            const parsed = contractInterface.parseLog({
+                topics: log.topics,
+                data: log.data,
+            });
+            if (parsed) {
+                const args = {};
+                for (const [key, value] of Object.entries(parsed.args)) {
+                    // Skip numeric indices
+                    if (!/^\d+$/.test(key)) {
+                        args[key] = value;
+                    }
+                }
+                events.push({
+                    name: parsed.name,
+                    args,
+                    address: log.address,
+                    blockNumber: log.blockNumber,
+                    transactionHash: log.transactionHash,
+                    logIndex: log.index,
+                });
+            }
+        }
+        catch {
+            // Skip logs that don't match the interface
+        }
+    }
+    return events;
+}
+/**
+ * Create a transaction result from a receipt
+ */
+function createTransactionResult(receipt, events) {
+    return {
+        hash: receipt.hash,
+        blockNumber: receipt.blockNumber,
+        gasUsed: receipt.gasUsed,
+        status: receipt.status === 1 ? 'success' : 'failed',
+        events,
+        receipt,
+    };
+}
+/**
+ * Sleep for a specified duration
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Retry a function with exponential backoff
+ */
+async function retry(fn, options = {}) {
+    const { retries = constants_1.DEFAULTS.TRANSACTION_RETRIES, delay = constants_1.DEFAULTS.RETRY_DELAY_MS, onRetry } = options;
+    let lastError;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // Check if error is retryable
+            const networkError = (0, errors_1.parseNetworkError)(error);
+            if (!networkError.retryable) {
+                throw error;
+            }
+            if (attempt < retries) {
+                onRetry?.(error, attempt + 1);
+                await sleep(delay * Math.pow(2, attempt)); // Exponential backoff
+            }
+        }
+    }
+    throw lastError;
+}
+/**
+ * Estimate gas with buffer
+ */
+async function estimateGasWithBuffer(estimateFn, bufferPercent = constants_1.DEFAULTS.GAS_BUFFER_PERCENT) {
+    const estimate = await estimateFn();
+    const buffer = (estimate * BigInt(bufferPercent)) / 100n;
+    return estimate + buffer;
+}
+/**
+ * Generate a keccak256 hash of identity data
+ */
+function hashIdentityData(data) {
+    const normalized = JSON.stringify({
+        firstName: data.firstName?.toLowerCase().trim(),
+        lastName: data.lastName?.toLowerCase().trim(),
+        dateOfBirth: data.dateOfBirth,
+        documentNumber: data.documentNumber?.toUpperCase().trim(),
+        country: data.country?.toUpperCase().trim(),
+    });
+    return ethers_1.ethers.keccak256(ethers_1.ethers.toUtf8Bytes(normalized));
+}
+/**
+ * Convert a timestamp to a Date object
+ */
+function timestampToDate(timestamp) {
+    const ts = typeof timestamp === 'bigint' ? Number(timestamp) : timestamp;
+    return new Date(ts * 1000);
+}
+/**
+ * Convert a Date to a Unix timestamp
+ */
+function dateToTimestamp(date) {
+    return Math.floor(date.getTime() / 1000);
+}
+/**
+ * Check if a timestamp is expired
+ */
+function isExpired(timestamp) {
+    const now = Math.floor(Date.now() / 1000);
+    const ts = typeof timestamp === 'bigint' ? Number(timestamp) : timestamp;
+    return ts < now;
+}
+/**
+ * Calculate percentage
+ */
+function calculatePercentage(part, total) {
+    if (total === 0n)
+        return 0;
+    return Number((part * 10000n) / total) / 100;
+}
+/**
+ * Chunk an array into smaller arrays
+ */
+function chunk(array, size) {
+    const chunks = [];
+    for (let i = 0; i < array.length; i += size) {
+        chunks.push(array.slice(i, i + size));
+    }
+    return chunks;
+}
+/**
+ * Wait for a transaction to be mined
+ */
+async function waitForTransaction(provider, hash, confirmations = 1) {
+    const receipt = await provider.waitForTransaction(hash, confirmations);
+    if (!receipt) {
+        throw new errors_1.NetworkError(errors_1.ErrorCode.TIMEOUT, `Transaction ${hash} was not mined`, true);
+    }
+    return receipt;
+}
+//# sourceMappingURL=index.js.map