@mantle-rwa/sdk 0.1.0

package/dist/esm/modules/yield.js

@@ -0,0 +1,401 @@
+/**
+ * YieldModule - Handles yield distribution management
+ */
+import { ethers } from 'ethers';
+import { YIELD_DISTRIBUTOR_ABI, RWA_TOKEN_ABI, DEFAULTS } from '../constants/index.js';
+import { RWAError, ErrorCode, parseContractError } from '../errors/index.js';
+import { isValidAddress, normalizeAddress, parseAmount, parseEvents, createTransactionResult, retry, estimateGasWithBuffer, timestampToDate, } from '../utils/index.js';
+/**
+ * Instance of a connected yield distributor
+ */
+export class YieldDistributorInstance {
+    _contract;
+    _retries;
+    _retryDelay;
+    /** Distributor contract address */
+    address;
+    constructor(address, provider, signer, retries, retryDelay) {
+        this.address = normalizeAddress(address);
+        this._retries = retries;
+        this._retryDelay = retryDelay;
+        this._contract = new ethers.Contract(this.address, 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: timestampToDate(claimDeadline),
+            claimedAmount,
+        };
+    }
+    /**
+     * Get claimable amount for an account
+     */
+    async getClaimableAmount(distributionId, account) {
+        return this._contract.getClaimableAmount(distributionId, normalizeAddress(account));
+    }
+    /**
+     * Check if an account has claimed from a distribution
+     */
+    async hasClaimed(distributionId, account) {
+        return this._contract.hasClaimed(distributionId, 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 = DEFAULTS.YIELD_CLAIM_WINDOW_DAYS, options) {
+        const tokenAddress = normalizeAddress(paymentToken);
+        const amountWei = parseAmount(totalAmount);
+        try {
+            const tx = await retry(async () => {
+                const gasLimit = options?.gasLimit || await 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 = parseEvents(receipt, this._contract.interface);
+            const result = 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 parseContractError(error, this.address, 'createDistribution');
+        }
+    }
+    /**
+     * Claim yield from a distribution
+     */
+    async claim(distributionId, options) {
+        try {
+            const tx = await retry(async () => {
+                const gasLimit = options?.gasLimit || await 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 = parseEvents(receipt, this._contract.interface);
+            return createTransactionResult(receipt, events);
+        }
+        catch (error) {
+            throw parseContractError(error, this.address, 'claim');
+        }
+    }
+    /**
+     * Claim yield from multiple distributions
+     */
+    async claimMultiple(distributionIds, options) {
+        try {
+            const tx = await retry(async () => {
+                const gasLimit = options?.gasLimit || await 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 = parseEvents(receipt, this._contract.interface);
+            return createTransactionResult(receipt, events);
+        }
+        catch (error) {
+            throw parseContractError(error, this.address, 'claimMultiple');
+        }
+    }
+    /**
+     * Handle unclaimed funds after claim window expires
+     */
+    async handleUnclaimedFunds(distributionId, options) {
+        try {
+            const tx = await retry(async () => {
+                const gasLimit = options?.gasLimit || await 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 = parseEvents(receipt, this._contract.interface);
+            return createTransactionResult(receipt, events);
+        }
+        catch (error) {
+            throw parseContractError(error, this.address, 'handleUnclaimedFunds');
+        }
+    }
+    /**
+     * Set the unclaimed funds recipient
+     */
+    async setUnclaimedFundsRecipient(recipient, options) {
+        const recipientAddress = normalizeAddress(recipient);
+        try {
+            const tx = await retry(async () => {
+                const gasLimit = options?.gasLimit || await 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 = parseEvents(receipt, this._contract.interface);
+            return createTransactionResult(receipt, events);
+        }
+        catch (error) {
+            throw 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);
+    }
+}
+/**
+ * Module for yield distribution operations
+ */
+export 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 (!isValidAddress(address)) {
+            throw new RWAError(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 (!isValidAddress(config.tokenAddress)) {
+            throw new RWAError(ErrorCode.INVALID_ADDRESS, `Invalid token address: ${config.tokenAddress}`);
+        }
+        if (!isValidAddress(config.paymentToken)) {
+            throw new RWAError(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 (!isValidAddress(tokenAddress)) {
+            throw new RWAError(ErrorCode.INVALID_ADDRESS, `Invalid token address: ${tokenAddress}`);
+        }
+        const token = new ethers.Contract(tokenAddress, RWA_TOKEN_ABI, this._provider);
+        const totalAmountWei = 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 = 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 (!isValidAddress(tokenAddress)) {
+            throw new RWAError(ErrorCode.INVALID_ADDRESS, `Invalid token address: ${tokenAddress}`);
+        }
+        if (!isValidAddress(holderAddress)) {
+            throw new RWAError(ErrorCode.INVALID_ADDRESS, `Invalid holder address: ${holderAddress}`);
+        }
+        const token = new ethers.Contract(tokenAddress, RWA_TOKEN_ABI, this._provider);
+        const totalAmountWei = parseAmount(totalAmount);
+        const normalizedHolder = 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 RWAError(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 RWAError(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);
+    }
+}
+//# sourceMappingURL=yield.js.map

package/dist/esm/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/esm/types/index.js

@@ -0,0 +1,17 @@
+/**
+ * Core type definitions for the Mantle RWA SDK
+ */
+/*//////////////////////////////////////////////////////////////
+                    ACCREDITATION TYPES
+//////////////////////////////////////////////////////////////*/
+/**
+ * Accreditation tiers matching the smart contract enum
+ */
+export 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 || (AccreditationTier = {}));
+//# sourceMappingURL=index.js.map

package/dist/esm/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,MAAM,CAAN,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,yDAAQ,CAAA;IACR,6DAAU,CAAA;IACV,qEAAc,CAAA;IACd,2EAAiB,CAAA;AACnB,CAAC,EALW,iBAAiB,KAAjB,iBAAiB,QAK5B"}

package/dist/esm/utils/index.js

@@ -0,0 +1,188 @@
+/**
+ * Utility functions for the Mantle RWA SDK
+ */
+import { ethers } from 'ethers';
+import { NetworkError, ErrorCode, parseNetworkError } from '../errors/index.js';
+import { DEFAULTS } from '../constants/index.js';
+/**
+ * Validate an Ethereum address
+ */
+export function isValidAddress(address) {
+    try {
+        return ethers.isAddress(address);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validate and normalize an Ethereum address
+ */
+export function normalizeAddress(address) {
+    if (!isValidAddress(address)) {
+        throw new Error(`Invalid address: ${address}`);
+    }
+    return ethers.getAddress(address);
+}
+/**
+ * Parse a string amount to bigint with decimals
+ */
+export function parseAmount(amount, decimals = 18) {
+    return ethers.parseUnits(amount, decimals);
+}
+/**
+ * Format a bigint amount to string with decimals
+ */
+export function formatAmount(amount, decimals = 18) {
+    return ethers.formatUnits(amount, decimals);
+}
+/**
+ * Parse events from a transaction receipt
+ */
+export 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
+ */
+export 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
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Retry a function with exponential backoff
+ */
+export async function retry(fn, options = {}) {
+    const { retries = DEFAULTS.TRANSACTION_RETRIES, delay = 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 = 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
+ */
+export async function estimateGasWithBuffer(estimateFn, bufferPercent = DEFAULTS.GAS_BUFFER_PERCENT) {
+    const estimate = await estimateFn();
+    const buffer = (estimate * BigInt(bufferPercent)) / 100n;
+    return estimate + buffer;
+}
+/**
+ * Generate a keccak256 hash of identity data
+ */
+export 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.keccak256(ethers.toUtf8Bytes(normalized));
+}
+/**
+ * Convert a timestamp to a Date object
+ */
+export function timestampToDate(timestamp) {
+    const ts = typeof timestamp === 'bigint' ? Number(timestamp) : timestamp;
+    return new Date(ts * 1000);
+}
+/**
+ * Convert a Date to a Unix timestamp
+ */
+export function dateToTimestamp(date) {
+    return Math.floor(date.getTime() / 1000);
+}
+/**
+ * Check if a timestamp is expired
+ */
+export function isExpired(timestamp) {
+    const now = Math.floor(Date.now() / 1000);
+    const ts = typeof timestamp === 'bigint' ? Number(timestamp) : timestamp;
+    return ts < now;
+}
+/**
+ * Calculate percentage
+ */
+export function calculatePercentage(part, total) {
+    if (total === 0n)
+        return 0;
+    return Number((part * 10000n) / total) / 100;
+}
+/**
+ * Chunk an array into smaller arrays
+ */
+export 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
+ */
+export async function waitForTransaction(provider, hash, confirmations = 1) {
+    const receipt = await provider.waitForTransaction(hash, confirmations);
+    if (!receipt) {
+        throw new NetworkError(ErrorCode.TIMEOUT, `Transaction ${hash} was not mined`, true);
+    }
+    return receipt;
+}
+//# sourceMappingURL=index.js.map

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

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