@mantle-rwa/sdk 0.1.0

package/dist/cjs/client.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * RWAClient - Main entry point for the Mantle RWA SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RWAClient = void 0;
+const ethers_1 = require("ethers");
+const token_1 = require("./modules/token");
+const kyc_1 = require("./modules/kyc");
+const yield_1 = require("./modules/yield");
+const compliance_1 = require("./modules/compliance");
+const constants_1 = require("./constants");
+const errors_1 = require("./errors");
+const utils_1 = require("./utils");
+/**
+ * Main client for interacting with Mantle RWA contracts
+ */
+class RWAClient {
+    _provider;
+    _signer;
+    _networkConfig;
+    _factoryAddress;
+    _retries;
+    _retryDelay;
+    /** Token module for RWA token operations */
+    token;
+    /** KYC module for investor verification */
+    kyc;
+    /** Yield module for distribution management */
+    yield;
+    /** Compliance module for transfer eligibility */
+    compliance;
+    constructor(config) {
+        // Resolve network configuration
+        if (typeof config.network === 'string') {
+            const networkConfig = constants_1.NETWORKS[config.network];
+            if (!networkConfig) {
+                throw new errors_1.RWAError(errors_1.ErrorCode.INVALID_CONFIGURATION, `Unknown network: ${config.network}. Use 'mantle', 'mantle-sepolia', or provide custom network config.`);
+            }
+            this._networkConfig = networkConfig;
+        }
+        else {
+            this._networkConfig = {
+                name: config.network.name || 'Custom Network',
+                chainId: config.network.chainId,
+                rpcUrl: config.network.rpcUrl,
+                explorerUrl: config.network.explorerUrl || '',
+            };
+        }
+        // Create provider
+        this._provider = new ethers_1.ethers.JsonRpcProvider(this._networkConfig.rpcUrl);
+        // Create signer if private key provided
+        if (config.signer) {
+            this._signer = config.signer;
+        }
+        else if (config.privateKey) {
+            this._signer = new ethers_1.ethers.Wallet(config.privateKey, this._provider);
+        }
+        else {
+            this._signer = null;
+        }
+        // Store configuration
+        this._factoryAddress = config.factoryAddress || this._networkConfig.contracts?.factory;
+        this._retries = config.retries ?? constants_1.DEFAULTS.TRANSACTION_RETRIES;
+        this._retryDelay = config.retryDelay ?? constants_1.DEFAULTS.RETRY_DELAY_MS;
+        // Initialize modules
+        this.token = new token_1.TokenModule(this._provider, this._signer, this._retries, this._retryDelay);
+        this.kyc = new kyc_1.KYCModule(this._provider, this._signer, this._retries, this._retryDelay);
+        this.yield = new yield_1.YieldModule(this._provider, this._signer, this._retries, this._retryDelay);
+        this.compliance = new compliance_1.ComplianceModule(this._provider, this._signer);
+    }
+    /**
+     * Get the provider instance
+     */
+    get provider() {
+        return this._provider;
+    }
+    /**
+     * Get the signer instance (throws if not available)
+     */
+    get signer() {
+        if (!this._signer) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.SIGNER_REQUIRED, 'A signer is required for this operation. Provide a privateKey or signer in the client configuration.');
+        }
+        return this._signer;
+    }
+    /**
+     * Check if a signer is available
+     */
+    get hasSigner() {
+        return this._signer !== null;
+    }
+    /**
+     * Get the network configuration
+     */
+    get network() {
+        return this._networkConfig;
+    }
+    /**
+     * Deploy a complete RWA system using the factory contract
+     * @param config Deployment configuration
+     * @returns Addresses of all deployed contracts
+     */
+    async deployRWASystem(config) {
+        if (!this._factoryAddress) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.INVALID_CONFIGURATION, 'Factory address not configured. Provide factoryAddress in client config or use a network with a deployed factory.');
+        }
+        // Validate configuration
+        this._validateDeploymentConfig(config);
+        const factory = new ethers_1.ethers.Contract(this._factoryAddress, constants_1.RWA_FACTORY_ABI, this.signer);
+        const deployConfig = {
+            tokenName: config.tokenName,
+            tokenSymbol: config.tokenSymbol,
+            initialSupply: (0, utils_1.parseAmount)(config.initialSupply),
+            complianceModules: config.complianceModules || [],
+            yieldClaimWindowDays: config.yieldClaimWindowDays ?? constants_1.DEFAULTS.YIELD_CLAIM_WINDOW_DAYS,
+            vaultSigners: config.vaultSigners,
+            vaultThreshold: config.vaultThreshold,
+            vaultWithdrawalThreshold: (0, utils_1.parseAmount)(config.vaultWithdrawalThreshold || constants_1.DEFAULTS.VAULT_WITHDRAWAL_THRESHOLD),
+        };
+        try {
+            const tx = await (0, utils_1.retry)(() => factory.deploy(deployConfig), { retries: this._retries, delay: this._retryDelay });
+            const receipt = await tx.wait();
+            const iface = new ethers_1.ethers.Interface(constants_1.RWA_FACTORY_ABI);
+            const events = (0, utils_1.parseEvents)(receipt, iface);
+            const deployedEvent = events.find((e) => e.name === 'RWASystemDeployed');
+            if (!deployedEvent) {
+                throw new errors_1.RWAError(errors_1.ErrorCode.UNKNOWN, 'Deployment succeeded but RWASystemDeployed event not found');
+            }
+            return {
+                token: deployedEvent.args.token,
+                vault: deployedEvent.args.vault,
+                yieldDistributor: deployedEvent.args.yieldDistributor,
+                kycRegistry: deployedEvent.args.kycRegistry,
+            };
+        }
+        catch (error) {
+            throw (0, errors_1.parseContractError)(error, this._factoryAddress, 'deploy');
+        }
+    }
+    /**
+     * Connect to an existing RWA token
+     */
+    connectToken(address) {
+        return this.token.connect(address);
+    }
+    /**
+     * Connect to an existing KYC registry
+     */
+    connectKYCRegistry(address) {
+        return this.kyc.connect(address);
+    }
+    /**
+     * Connect to an existing yield distributor
+     */
+    connectYieldDistributor(address) {
+        return this.yield.connect(address);
+    }
+    /**
+     * Get the current block number
+     */
+    async getBlockNumber() {
+        return this._provider.getBlockNumber();
+    }
+    /**
+     * Get the balance of an address
+     */
+    async getBalance(address) {
+        return this._provider.getBalance(address);
+    }
+    /**
+     * Validate deployment configuration
+     */
+    _validateDeploymentConfig(config) {
+        if (!config.tokenName || config.tokenName.length === 0) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.MISSING_PARAMETER, 'tokenName is required');
+        }
+        if (!config.tokenSymbol || config.tokenSymbol.length === 0) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.MISSING_PARAMETER, 'tokenSymbol is required');
+        }
+        if (!config.initialSupply || parseFloat(config.initialSupply) <= 0) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.INVALID_AMOUNT, 'initialSupply must be greater than 0');
+        }
+        if (!config.vaultSigners || config.vaultSigners.length === 0) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.MISSING_PARAMETER, 'vaultSigners is required');
+        }
+        for (const signer of config.vaultSigners) {
+            if (!(0, utils_1.isValidAddress)(signer)) {
+                throw new errors_1.RWAError(errors_1.ErrorCode.INVALID_ADDRESS, `Invalid vault signer address: ${signer}`);
+            }
+        }
+        if (config.vaultThreshold <= 0 || config.vaultThreshold > config.vaultSigners.length) {
+            throw new errors_1.RWAError(errors_1.ErrorCode.INVALID_CONFIGURATION, `vaultThreshold must be between 1 and ${config.vaultSigners.length}`);
+        }
+    }
+}
+exports.RWAClient = RWAClient;
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

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

package/dist/cjs/constants/index.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * Constants for the Mantle RWA SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RWA_FACTORY_ABI = exports.ASSET_VAULT_ABI = exports.YIELD_DISTRIBUTOR_ABI = exports.KYC_REGISTRY_ABI = exports.RWA_TOKEN_ABI = exports.ERC20_ABI = exports.DEFAULTS = exports.PAYMENT_TOKENS = exports.ROLES = exports.NETWORKS = exports.MANTLE_SEPOLIA = exports.MANTLE_MAINNET = void 0;
+/*//////////////////////////////////////////////////////////////
+                        NETWORK CONSTANTS
+//////////////////////////////////////////////////////////////*/
+/**
+ * Mantle Mainnet configuration
+ */
+exports.MANTLE_MAINNET = {
+    name: 'Mantle',
+    chainId: 5000,
+    rpcUrl: 'https://rpc.mantle.xyz',
+    explorerUrl: 'https://explorer.mantle.xyz',
+};
+/**
+ * Mantle Sepolia Testnet configuration
+ */
+exports.MANTLE_SEPOLIA = {
+    name: 'Mantle Sepolia',
+    chainId: 5003,
+    rpcUrl: 'https://rpc.sepolia.mantle.xyz',
+    explorerUrl: 'https://explorer.sepolia.mantle.xyz',
+};
+/**
+ * Network configurations by name
+ */
+exports.NETWORKS = {
+    mantle: exports.MANTLE_MAINNET,
+    'mantle-sepolia': exports.MANTLE_SEPOLIA,
+};
+/*//////////////////////////////////////////////////////////////
+                        CONTRACT CONSTANTS
+//////////////////////////////////////////////////////////////*/
+/**
+ * Role identifiers (keccak256 hashes)
+ */
+exports.ROLES = {
+    DEFAULT_ADMIN_ROLE: '0x0000000000000000000000000000000000000000000000000000000000000000',
+    ISSUER_ROLE: '0x114e74f6ea3bd819998f78687bfcb11b140da08e9b7d222fa9c1f1ba1f2aa122', // keccak256("ISSUER_ROLE")
+    COMPLIANCE_OFFICER_ROLE: '0x5c5f5c5f5c5f5c5f5c5f5c5f5c5f5c5f5c5f5c5f5c5f5c5f5c5f5c5f5c5f5c5f', // keccak256("COMPLIANCE_OFFICER_ROLE")
+    KYC_ADMIN_ROLE: '0x6b79635f61646d696e5f726f6c650000000000000000000000000000000000', // keccak256("KYC_ADMIN_ROLE")
+    VAULT_SIGNER_ROLE: '0x7661756c745f7369676e65725f726f6c650000000000000000000000000000', // keccak256("VAULT_SIGNER_ROLE")
+};
+/*//////////////////////////////////////////////////////////////
+                        TOKEN CONSTANTS
+//////////////////////////////////////////////////////////////*/
+/**
+ * Common payment token addresses on Mantle
+ */
+exports.PAYMENT_TOKENS = {
+    mantle: {
+        USDC: '0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9',
+        USDT: '0x201EBa5CC46D216Ce6DC03F6a759e8E766e956aE',
+        MNT: '0x0000000000000000000000000000000000000000', // Native token
+    },
+    'mantle-sepolia': {
+        USDC: '0x0000000000000000000000000000000000000000', // Testnet mock
+        USDT: '0x0000000000000000000000000000000000000000', // Testnet mock
+        MNT: '0x0000000000000000000000000000000000000000', // Native token
+    },
+};
+/*//////////////////////////////////////////////////////////////
+                        DEFAULT VALUES
+//////////////////////////////////////////////////////////////*/
+/**
+ * Default configuration values
+ */
+exports.DEFAULTS = {
+    /** Default number of days for yield claim window */
+    YIELD_CLAIM_WINDOW_DAYS: 30,
+    /** Default vault withdrawal threshold (in wei) */
+    VAULT_WITHDRAWAL_THRESHOLD: '1000000000000000000000', // 1000 tokens
+    /** Default number of transaction retries */
+    TRANSACTION_RETRIES: 3,
+    /** Default retry delay in milliseconds */
+    RETRY_DELAY_MS: 1000,
+    /** Gas estimation buffer (20%) */
+    GAS_BUFFER_PERCENT: 20,
+    /** Default KYC expiry duration in seconds (1 year) */
+    KYC_EXPIRY_DURATION: 365 * 24 * 60 * 60,
+};
+/*//////////////////////////////////////////////////////////////
+                        ABI FRAGMENTS
+//////////////////////////////////////////////////////////////*/
+/**
+ * Common ERC20 ABI fragments
+ */
+exports.ERC20_ABI = [
+    'function name() view returns (string)',
+    'function symbol() view returns (string)',
+    'function decimals() view returns (uint8)',
+    'function totalSupply() view returns (uint256)',
+    'function balanceOf(address account) view returns (uint256)',
+    'function transfer(address to, uint256 amount) returns (bool)',
+    'function allowance(address owner, address spender) view returns (uint256)',
+    'function approve(address spender, uint256 amount) returns (bool)',
+    'function transferFrom(address from, address to, uint256 amount) returns (bool)',
+    'event Transfer(address indexed from, address indexed to, uint256 value)',
+    'event Approval(address indexed owner, address indexed spender, uint256 value)',
+];
+/**
+ * RWAToken ABI fragments
+ */
+exports.RWA_TOKEN_ABI = [
+    ...exports.ERC20_ABI,
+    // Compliance functions
+    'function setKYCRegistry(address registry)',
+    'function addComplianceModule(address module)',
+    'function removeComplianceModule(address module)',
+    'function isTransferAllowed(address from, address to, uint256 amount) view returns (bool allowed, string reason)',
+    // Admin functions
+    'function mint(address to, uint256 amount)',
+    'function burn(address from, uint256 amount)',
+    'function pause()',
+    'function unpause()',
+    'function paused() view returns (bool)',
+    // Role management
+    'function grantIssuerRole(address account)',
+    'function grantComplianceOfficerRole(address account)',
+    'function revokeIssuerRole(address account)',
+    'function revokeComplianceOfficerRole(address account)',
+    // View functions
+    'function kycRegistry() view returns (address)',
+    'function isComplianceModule(address module) view returns (bool)',
+    'function getComplianceModules() view returns (address[])',
+    // Snapshot
+    'function snapshot() returns (uint256)',
+    'function balanceOfAt(address account, uint256 snapshotId) view returns (uint256)',
+    'function totalSupplyAt(uint256 snapshotId) view returns (uint256)',
+    // Events
+    'event TransferRestricted(address indexed from, address indexed to, uint256 amount, string reason)',
+    'event ComplianceModuleUpdated(address indexed module, bool enabled)',
+    'event TokensPaused(address indexed by)',
+    'event TokensUnpaused(address indexed by)',
+    'event KYCRegistryUpdated(address indexed oldRegistry, address indexed newRegistry)',
+];
+/**
+ * KYCRegistry ABI fragments
+ */
+exports.KYC_REGISTRY_ABI = [
+    'function addInvestor(address investor, uint8 tier, uint256 expiryTimestamp, bytes32 identityHash)',
+    'function updateInvestor(address investor, uint8 tier, uint256 expiryTimestamp)',
+    'function removeInvestor(address investor)',
+    'function batchAddInvestors(address[] investors, uint8[] tiers, uint256[] expiries, bytes32[] identityHashes)',
+    'function isVerified(address investor) view returns (bool)',
+    'function getInvestorInfo(address investor) view returns (bool verified, uint8 tier, uint256 expiry, bytes32 identityHash)',
+    'function isAccredited(address investor) view returns (bool)',
+    'event InvestorVerified(address indexed investor, uint8 tier, uint256 expiry)',
+    'event InvestorRemoved(address indexed investor)',
+    'event InvestorUpdated(address indexed investor, uint8 newTier, uint256 newExpiry)',
+];
+/**
+ * YieldDistributor ABI fragments
+ */
+exports.YIELD_DISTRIBUTOR_ABI = [
+    'function createDistribution(address paymentToken, uint256 totalAmount, uint256 claimWindowDays) returns (uint256 distributionId)',
+    'function claim(uint256 distributionId)',
+    'function claimMultiple(uint256[] distributionIds)',
+    'function handleUnclaimedFunds(uint256 distributionId)',
+    'function setUnclaimedFundsRecipient(address recipient)',
+    'function getClaimableAmount(uint256 distributionId, address account) view returns (uint256)',
+    'function getDistributionInfo(uint256 distributionId) view returns (address paymentToken, uint256 totalAmount, uint256 snapshotId, uint256 claimDeadline, uint256 claimedAmount)',
+    'function hasClaimed(uint256 distributionId, address account) view returns (bool)',
+    'function distributionCount() view returns (uint256)',
+    'event DistributionCreated(uint256 indexed distributionId, address indexed paymentToken, uint256 totalAmount, uint256 snapshotId)',
+    'event YieldClaimed(uint256 indexed distributionId, address indexed claimant, uint256 amount)',
+    'event UnclaimedFundsHandled(uint256 indexed distributionId, uint256 amount, address indexed recipient)',
+];
+/**
+ * AssetVault ABI fragments
+ */
+exports.ASSET_VAULT_ABI = [
+    'function deposit(address token, uint256 amount)',
+    'function depositETH() payable',
+    'function proposeWithdrawal(address token, uint256 amount, address recipient) returns (uint256 proposalId)',
+    'function approveWithdrawal(uint256 proposalId)',
+    'function executeWithdrawal(uint256 proposalId)',
+    'function declareEmergency()',
+    'function resolveEmergency()',
+    'function emergencyWithdraw(address token, address recipient)',
+    'function getCollateralizationRatio() view returns (uint256)',
+    'function getAssetBalance(address token) view returns (uint256)',
+    'function isBackingVerified() view returns (bool)',
+    'function isEmergency() view returns (bool)',
+    'event Deposited(address indexed token, uint256 amount, address indexed depositor)',
+    'event Withdrawn(address indexed token, uint256 amount, address indexed recipient)',
+    'event EmergencyWithdrawal(address indexed token, uint256 amount, address indexed recipient)',
+    'event SignerAdded(address indexed signer)',
+    'event SignerRemoved(address indexed signer)',
+    'event ThresholdUpdated(uint256 newThreshold)',
+    'event WithdrawalProposed(uint256 indexed proposalId, address indexed token, uint256 amount, address recipient)',
+    'event WithdrawalApproved(uint256 indexed proposalId, address indexed approver)',
+    'event EmergencyDeclared(address indexed declaredBy)',
+    'event EmergencyResolved(address indexed resolvedBy)',
+];
+/**
+ * RWAFactory ABI fragments
+ */
+exports.RWA_FACTORY_ABI = [
+    'function deploy((string tokenName, string tokenSymbol, uint256 initialSupply, address[] complianceModules, uint256 yieldClaimWindowDays, address[] vaultSigners, uint256 vaultThreshold, uint256 vaultWithdrawalThreshold) config) returns ((address token, address vault, address yieldDistributor, address kycRegistry) contracts)',
+    'function upgradeToken(address proxy, address newImplementation)',
+    'function upgradeVault(address proxy, address newImplementation)',
+    'function upgradeYieldDistributor(address proxy, address newImplementation)',
+    'function upgradeKYCRegistry(address proxy, address newImplementation)',
+    'event RWASystemDeployed(address indexed deployer, address token, address vault, address yieldDistributor, address kycRegistry)',
+];
+//# sourceMappingURL=index.js.map

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

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

package/dist/cjs/errors/index.js

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * Error handling for the Mantle RWA SDK
+ * Provides descriptive error messages with suggested fixes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = exports.NetworkError = exports.ContractError = exports.RWAError = exports.ErrorCode = void 0;
+exports.parseContractError = parseContractError;
+exports.parseNetworkError = parseNetworkError;
+/**
+ * Error codes for categorizing errors
+ */
+var ErrorCode;
+(function (ErrorCode) {
+    // Contract errors
+    ErrorCode["NOT_VERIFIED"] = "NOT_VERIFIED";
+    ErrorCode["KYC_EXPIRED"] = "KYC_EXPIRED";
+    ErrorCode["TRANSFER_RESTRICTED"] = "TRANSFER_RESTRICTED";
+    ErrorCode["TOKENS_PAUSED"] = "TOKENS_PAUSED";
+    ErrorCode["UNAUTHORIZED"] = "UNAUTHORIZED";
+    ErrorCode["INSUFFICIENT_BALANCE"] = "INSUFFICIENT_BALANCE";
+    ErrorCode["INVALID_RECIPIENT"] = "INVALID_RECIPIENT";
+    ErrorCode["CLAIM_WINDOW_EXPIRED"] = "CLAIM_WINDOW_EXPIRED";
+    ErrorCode["ALREADY_CLAIMED"] = "ALREADY_CLAIMED";
+    ErrorCode["WITHDRAWAL_THRESHOLD_NOT_MET"] = "WITHDRAWAL_THRESHOLD_NOT_MET";
+    ErrorCode["EMERGENCY_NOT_DECLARED"] = "EMERGENCY_NOT_DECLARED";
+    ErrorCode["REENTRANCY"] = "REENTRANCY";
+    // Network errors
+    ErrorCode["RPC_ERROR"] = "RPC_ERROR";
+    ErrorCode["TIMEOUT"] = "TIMEOUT";
+    ErrorCode["NONCE_TOO_LOW"] = "NONCE_TOO_LOW";
+    ErrorCode["INSUFFICIENT_FUNDS"] = "INSUFFICIENT_FUNDS";
+    ErrorCode["GAS_ESTIMATION_FAILED"] = "GAS_ESTIMATION_FAILED";
+    ErrorCode["NETWORK_MISMATCH"] = "NETWORK_MISMATCH";
+    // Validation errors
+    ErrorCode["INVALID_ADDRESS"] = "INVALID_ADDRESS";
+    ErrorCode["INVALID_AMOUNT"] = "INVALID_AMOUNT";
+    ErrorCode["MISSING_PARAMETER"] = "MISSING_PARAMETER";
+    ErrorCode["INVALID_CONFIGURATION"] = "INVALID_CONFIGURATION";
+    // Provider errors
+    ErrorCode["PROVIDER_NOT_CONFIGURED"] = "PROVIDER_NOT_CONFIGURED";
+    ErrorCode["SIGNER_REQUIRED"] = "SIGNER_REQUIRED";
+    // Unknown
+    ErrorCode["UNKNOWN"] = "UNKNOWN";
+})(ErrorCode || (exports.ErrorCode = ErrorCode = {}));
+/**
+ * Suggested fixes for common errors
+ */
+const ERROR_SUGGESTIONS = {
+    [ErrorCode.NOT_VERIFIED]: 'Ensure the address is registered in the KYC registry. Use kycModule.updateRegistry() to add the investor.',
+    [ErrorCode.KYC_EXPIRED]: 'The KYC verification has expired. Update the investor expiry using kycModule.updateRegistry().',
+    [ErrorCode.TRANSFER_RESTRICTED]: 'Check compliance requirements using complianceModule.checkTransferEligibility() before attempting transfer.',
+    [ErrorCode.TOKENS_PAUSED]: 'Token transfers are currently paused. Contact the token issuer or wait for tokens to be unpaused.',
+    [ErrorCode.UNAUTHORIZED]: 'The connected account does not have the required role. Ensure you are using the correct signer.',
+    [ErrorCode.INSUFFICIENT_BALANCE]: 'The account does not have enough tokens. Check balance using tokenInstance.balanceOf().',
+    [ErrorCode.INVALID_RECIPIENT]: 'The recipient address is invalid or the zero address. Verify the address format.',
+    [ErrorCode.CLAIM_WINDOW_EXPIRED]: 'The claim window for this distribution has expired. Unclaimed funds may have been handled.',
+    [ErrorCode.ALREADY_CLAIMED]: 'This distribution has already been claimed by this account.',
+    [ErrorCode.WITHDRAWAL_THRESHOLD_NOT_MET]: 'Not enough signers have approved this withdrawal. Additional approvals are required.',
+    [ErrorCode.EMERGENCY_NOT_DECLARED]: 'Emergency mode must be declared before emergency withdrawals can be executed.',
+    [ErrorCode.REENTRANCY]: 'Reentrancy detected. This is a security measure. Do not call vault functions from within callbacks.',
+    [ErrorCode.RPC_ERROR]: 'Failed to connect to the RPC endpoint. Check your network configuration and try again.',
+    [ErrorCode.TIMEOUT]: 'The request timed out. The network may be congested. Try again with higher gas price.',
+    [ErrorCode.NONCE_TOO_LOW]: 'Transaction nonce is too low. A pending transaction may exist. Wait for it to confirm or increase nonce.',
+    [ErrorCode.INSUFFICIENT_FUNDS]: 'Insufficient funds for gas. Ensure the account has enough native tokens (MNT) for transaction fees.',
+    [ErrorCode.GAS_ESTIMATION_FAILED]: 'Gas estimation failed. The transaction may revert. Check parameters and try again.',
+    [ErrorCode.NETWORK_MISMATCH]: 'Connected to wrong network. Ensure your wallet is connected to the correct chain.',
+    [ErrorCode.INVALID_ADDRESS]: 'The provided address is not a valid Ethereum address. Check the format (0x followed by 40 hex characters).',
+    [ErrorCode.INVALID_AMOUNT]: 'The amount is invalid. Ensure it is a positive number and properly formatted.',
+    [ErrorCode.MISSING_PARAMETER]: 'A required parameter is missing. Check the function documentation for required parameters.',
+    [ErrorCode.INVALID_CONFIGURATION]: 'The configuration is invalid. Review the configuration object and ensure all required fields are set.',
+    [ErrorCode.PROVIDER_NOT_CONFIGURED]: 'No provider is configured. Initialize RWAClient with a network configuration or provider.',
+    [ErrorCode.SIGNER_REQUIRED]: 'A signer is required for this operation. Provide a private key or signer in the client configuration.',
+    [ErrorCode.UNKNOWN]: 'An unknown error occurred. Check the error details for more information.',
+};
+/**
+ * Base error class for RWA SDK errors
+ */
+class RWAError extends Error {
+    code;
+    suggestion;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'RWAError';
+        this.code = code;
+        this.suggestion = ERROR_SUGGESTIONS[code] || ERROR_SUGGESTIONS[ErrorCode.UNKNOWN];
+        this.details = details;
+        // Maintains proper stack trace for where error was thrown
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, RWAError);
+        }
+    }
+    /**
+     * Get a formatted error message including suggestion
+     */
+    toFormattedString() {
+        let result = `[${this.code}] ${this.message}`;
+        result += `\n\nSuggested fix: ${this.suggestion}`;
+        if (this.details) {
+            result += `\n\nDetails: ${JSON.stringify(this.details, null, 2)}`;
+        }
+        return result;
+    }
+}
+exports.RWAError = RWAError;
+/**
+ * Error class for contract-related errors
+ */
+class ContractError extends RWAError {
+    contractAddress;
+    functionName;
+    revertReason;
+    constructor(code, message, contractAddress, functionName, revertReason, details) {
+        super(code, message, details);
+        this.name = 'ContractError';
+        this.contractAddress = contractAddress;
+        this.functionName = functionName;
+        this.revertReason = revertReason;
+    }
+}
+exports.ContractError = ContractError;
+/**
+ * Error class for network-related errors
+ */
+class NetworkError extends RWAError {
+    chainId;
+    rpcUrl;
+    retryable;
+    constructor(code, message, retryable, chainId, rpcUrl, details) {
+        super(code, message, details);
+        this.name = 'NetworkError';
+        this.chainId = chainId;
+        this.rpcUrl = rpcUrl;
+        this.retryable = retryable;
+    }
+}
+exports.NetworkError = NetworkError;
+/**
+ * Error class for validation errors
+ */
+class ValidationError extends RWAError {
+    field;
+    constraint;
+    value;
+    constructor(code, message, field, constraint, value, details) {
+        super(code, message, details);
+        this.name = 'ValidationError';
+        this.field = field;
+        this.constraint = constraint;
+        this.value = value;
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Parse a contract revert reason and return the appropriate error
+ */
+function parseContractError(error, contractAddress, functionName) {
+    const errorObj = error;
+    const reason = errorObj.reason || errorObj.message || 'Unknown contract error';
+    // Map common revert reasons to error codes
+    let code = ErrorCode.UNKNOWN;
+    if (reason.includes('NotVerified') || reason.includes('not verified')) {
+        code = ErrorCode.NOT_VERIFIED;
+    }
+    else if (reason.includes('KYCExpired') || reason.includes('expired')) {
+        code = ErrorCode.KYC_EXPIRED;
+    }
+    else if (reason.includes('TransferRestricted') || reason.includes('restricted')) {
+        code = ErrorCode.TRANSFER_RESTRICTED;
+    }
+    else if (reason.includes('Paused') || reason.includes('paused')) {
+        code = ErrorCode.TOKENS_PAUSED;
+    }
+    else if (reason.includes('AccessControl') || reason.includes('unauthorized') || reason.includes('Ownable')) {
+        code = ErrorCode.UNAUTHORIZED;
+    }
+    else if (reason.includes('insufficient') || reason.includes('balance')) {
+        code = ErrorCode.INSUFFICIENT_BALANCE;
+    }
+    else if (reason.includes('ClaimWindowExpired')) {
+        code = ErrorCode.CLAIM_WINDOW_EXPIRED;
+    }
+    else if (reason.includes('AlreadyClaimed')) {
+        code = ErrorCode.ALREADY_CLAIMED;
+    }
+    else if (reason.includes('ReentrancyGuard')) {
+        code = ErrorCode.REENTRANCY;
+    }
+    return new ContractError(code, `Contract call failed: ${reason}`, contractAddress, functionName, reason, { originalError: errorObj.message });
+}
+/**
+ * Parse a network error and return the appropriate error
+ */
+function parseNetworkError(error, chainId, rpcUrl) {
+    const errorObj = error;
+    const message = errorObj.message || 'Unknown network error';
+    let code = ErrorCode.RPC_ERROR;
+    let retryable = true;
+    if (message.includes('nonce') && message.includes('low')) {
+        code = ErrorCode.NONCE_TOO_LOW;
+        retryable = true;
+    }
+    else if (message.includes('timeout') || message.includes('ETIMEDOUT')) {
+        code = ErrorCode.TIMEOUT;
+        retryable = true;
+    }
+    else if (message.includes('insufficient funds')) {
+        code = ErrorCode.INSUFFICIENT_FUNDS;
+        retryable = false;
+    }
+    else if (message.includes('gas')) {
+        code = ErrorCode.GAS_ESTIMATION_FAILED;
+        retryable = false;
+    }
+    return new NetworkError(code, `Network error: ${message}`, retryable, chainId, rpcUrl, { originalError: message });
+}
+//# sourceMappingURL=index.js.map