@mantle-rwa/sdk 0.1.0

package/dist/types/modules/yield.d.ts

@@ -0,0 +1,143 @@
+/**
+ * YieldModule - Handles yield distribution management
+ */
+import { type Provider, type Signer } from 'ethers';
+import type { Distribution, DistributionConfig, DistributionPreview, PendingClaim, TransactionResult, TransactionOptions } from '../types';
+/**
+ * Instance of a connected yield distributor
+ */
+export declare class YieldDistributorInstance {
+    private readonly _contract;
+    private readonly _retries;
+    private readonly _retryDelay;
+    /** Distributor contract address */
+    readonly address: string;
+    constructor(address: string, provider: Provider, signer: Signer | null, retries: number, retryDelay: number);
+    /**
+     * Get the number of distributions
+     */
+    distributionCount(): Promise<number>;
+    /**
+     * Get distribution information
+     */
+    getDistributionInfo(distributionId: number): Promise<Distribution>;
+    /**
+     * Get claimable amount for an account
+     */
+    getClaimableAmount(distributionId: number, account: string): Promise<bigint>;
+    /**
+     * Check if an account has claimed from a distribution
+     */
+    hasClaimed(distributionId: number, account: string): Promise<boolean>;
+    /**
+     * Get all distributions
+     */
+    getDistributionHistory(): Promise<Distribution[]>;
+    /**
+     * Get pending claims for an account
+     */
+    getPendingClaims(account: string): Promise<PendingClaim[]>;
+    /**
+     * Create a new distribution
+     */
+    createDistribution(paymentToken: string, totalAmount: string, claimWindowDays?: number, options?: TransactionOptions): Promise<{
+        result: TransactionResult;
+        distributionId: number;
+    }>;
+    /**
+     * Claim yield from a distribution
+     */
+    claim(distributionId: number, options?: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * Claim yield from multiple distributions
+     */
+    claimMultiple(distributionIds: number[], options?: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * Handle unclaimed funds after claim window expires
+     */
+    handleUnclaimedFunds(distributionId: number, options?: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * Set the unclaimed funds recipient
+     */
+    setUnclaimedFundsRecipient(recipient: string, options?: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * Listen for DistributionCreated events
+     */
+    onDistributionCreated(callback: (distributionId: bigint, paymentToken: string, totalAmount: bigint, snapshotId: bigint) => void): () => void;
+    /**
+     * Listen for YieldClaimed events
+     */
+    onYieldClaimed(callback: (distributionId: bigint, claimant: string, amount: bigint) => void): () => void;
+}
+/**
+ * Module for yield distribution operations
+ */
+export declare class YieldModule {
+    private readonly _provider;
+    private readonly _signer;
+    private readonly _retries;
+    private readonly _retryDelay;
+    constructor(provider: Provider, signer: Signer | null, retries: number, retryDelay: number);
+    /**
+     * Connect to an existing yield distributor
+     */
+    connect(address: string): YieldDistributorInstance;
+    /**
+     * Create a distribution
+     *
+     * @param config - Distribution configuration
+     * @returns Transaction result with distribution ID
+     */
+    distribute(config: DistributionConfig): Promise<{
+        result: TransactionResult;
+        distributionId: number;
+    }>;
+    /**
+     * 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
+     */
+    previewDistribution(tokenAddress: string, totalAmount: string, snapshotId?: bigint, holderAddresses?: string[]): Promise<DistributionPreview>;
+    /**
+     * 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
+     */
+    calculateHolderYield(tokenAddress: string, holderAddress: string, totalAmount: string, snapshotId?: bigint): Promise<{
+        balance: bigint;
+        yieldAmount: bigint;
+        percentage: number;
+    }>;
+    /**
+     * Claim yield from a distribution
+     */
+    claim(distributorAddress: string, distributionId: number): Promise<TransactionResult>;
+    /**
+     * Claim all pending yields
+     */
+    claimAll(distributorAddress: string): Promise<TransactionResult>;
+    /**
+     * Get claimable amount for an account
+     */
+    getClaimableAmount(distributorAddress: string, distributionId: number, account: string): Promise<bigint>;
+    /**
+     * Get distribution history
+     */
+    getDistributionHistory(distributorAddress: string): Promise<Distribution[]>;
+    /**
+     * Get pending claims for an account
+     */
+    getPendingClaims(distributorAddress: string, account: string): Promise<PendingClaim[]>;
+}
+//# sourceMappingURL=yield.d.ts.map

package/dist/types/modules/yield.d.ts.map

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

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

@@ -0,0 +1,254 @@
+/**
+ * Core type definitions for the Mantle RWA SDK
+ */
+import type { TransactionReceipt } from 'ethers';
+/**
+ * Supported network names
+ */
+export type NetworkName = 'mantle' | 'mantle-sepolia';
+/**
+ * Custom network configuration
+ */
+export interface CustomNetwork {
+    rpcUrl: string;
+    chainId: number;
+    name?: string;
+    explorerUrl?: string;
+}
+/**
+ * Network configuration
+ */
+export interface NetworkConfig {
+    name: string;
+    chainId: number;
+    rpcUrl: string;
+    explorerUrl: string;
+    contracts?: {
+        factory?: string;
+    };
+}
+/**
+ * Accreditation tiers matching the smart contract enum
+ */
+export declare enum AccreditationTier {
+    None = 0,
+    Retail = 1,
+    Accredited = 2,
+    Institutional = 3
+}
+/**
+ * Parsed event from a transaction
+ */
+export interface ParsedEvent {
+    name: string;
+    args: Record<string, unknown>;
+    address: string;
+    blockNumber: number;
+    transactionHash: string;
+    logIndex: number;
+}
+/**
+ * Result of a transaction
+ */
+export interface TransactionResult {
+    hash: string;
+    blockNumber: number;
+    gasUsed: bigint;
+    status: 'success' | 'failed';
+    events: ParsedEvent[];
+    receipt: TransactionReceipt;
+}
+/**
+ * Options for transaction execution
+ */
+export interface TransactionOptions {
+    gasLimit?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    nonce?: number;
+    retries?: number;
+    retryDelay?: number;
+}
+/**
+ * Available compliance rule types
+ */
+export type ComplianceRule = 'accredited-investor' | 'transfer-limit-24h' | 'transfer-limit-30d' | 'holding-period' | 'max-investors' | 'geographic-restriction';
+/**
+ * Transfer eligibility check result
+ */
+export interface TransferEligibility {
+    eligible: boolean;
+    reason?: string;
+    checks: TransferCheck[];
+}
+/**
+ * Individual transfer check result
+ */
+export interface TransferCheck {
+    name: string;
+    passed: boolean;
+    details?: string;
+}
+/**
+ * Configuration for deploying a new RWA system
+ */
+export interface DeploymentConfig {
+    tokenName: string;
+    tokenSymbol: string;
+    initialSupply: string;
+    complianceModules?: string[];
+    yieldClaimWindowDays?: number;
+    vaultSigners: string[];
+    vaultThreshold: number;
+    vaultWithdrawalThreshold?: string;
+}
+/**
+ * Addresses of deployed contracts
+ */
+export interface DeployedContracts {
+    token: string;
+    vault: string;
+    yieldDistributor: string;
+    kycRegistry: string;
+}
+/**
+ * Configuration for deploying a token
+ */
+export interface TokenDeployConfig {
+    name: string;
+    symbol: string;
+    totalSupply: string;
+    complianceRules?: ComplianceRule[];
+    kycRegistryAddress?: string;
+}
+/**
+ * Token information
+ */
+export interface TokenInfo {
+    address: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    totalSupply: bigint;
+    paused: boolean;
+}
+/**
+ * Investor data from the KYC registry
+ */
+export interface InvestorData {
+    verified: boolean;
+    tier: AccreditationTier;
+    expiry: Date;
+    identityHash: string;
+}
+/**
+ * Verification session for KYC flow
+ */
+export interface VerificationSession {
+    sessionId: string;
+    provider: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'failed';
+    redirectUrl?: string;
+}
+/**
+ * Result of a KYC verification
+ */
+export interface VerificationResult {
+    verified: boolean;
+    tier: AccreditationTier;
+    identityHash: string;
+    expiryDate: Date;
+    rawData?: unknown;
+}
+/**
+ * Configuration for creating a distribution
+ */
+export interface DistributionConfig {
+    tokenAddress: string;
+    paymentToken: string;
+    totalAmount: string;
+    snapshotDate?: Date;
+    claimWindowDays?: number;
+}
+/**
+ * Preview of a distribution
+ */
+export interface DistributionPreview {
+    totalHolders: number;
+    totalSupplyAtSnapshot: bigint;
+    distributions: HolderDistribution[];
+}
+/**
+ * Distribution amount for a single holder
+ */
+export interface HolderDistribution {
+    address: string;
+    balance: bigint;
+    yieldAmount: bigint;
+    percentage: number;
+}
+/**
+ * Distribution information
+ */
+export interface Distribution {
+    id: number;
+    paymentToken: string;
+    totalAmount: bigint;
+    snapshotId: bigint;
+    claimDeadline: Date;
+    claimedAmount: bigint;
+}
+/**
+ * Pending claim for an account
+ */
+export interface PendingClaim {
+    distributionId: number;
+    amount: bigint;
+    paymentToken: string;
+    deadline: Date;
+}
+/**
+ * Withdrawal proposal
+ */
+export interface WithdrawalProposal {
+    id: number;
+    token: string;
+    amount: bigint;
+    recipient: string;
+    approvalCount: number;
+    executed: boolean;
+    approvers: string[];
+}
+/**
+ * Vault status information
+ */
+export interface VaultStatus {
+    isEmergency: boolean;
+    collateralizationRatio: number;
+    backingVerified: boolean;
+}
+/**
+ * Compliance report for regulatory purposes
+ */
+export interface ComplianceReport {
+    generatedAt: Date;
+    tokenAddress: string;
+    totalHolders: number;
+    verifiedHolders: number;
+    accreditedHolders: number;
+    transfersBlocked: number;
+    complianceScore: number;
+}
+/**
+ * Filing data for regulatory submissions
+ */
+export interface FilingData {
+    filingType: string;
+    tokenAddress: string;
+    reportingPeriod: {
+        start: Date;
+        end: Date;
+    };
+    data: Record<string, unknown>;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,80 @@
+/**
+ * Utility functions for the Mantle RWA SDK
+ */
+import { ethers, type TransactionReceipt, type Interface } from 'ethers';
+import type { ParsedEvent, TransactionResult } from '../types';
+/**
+ * Validate an Ethereum address
+ */
+export declare function isValidAddress(address: string): boolean;
+/**
+ * Validate and normalize an Ethereum address
+ */
+export declare function normalizeAddress(address: string): string;
+/**
+ * Parse a string amount to bigint with decimals
+ */
+export declare function parseAmount(amount: string, decimals?: number): bigint;
+/**
+ * Format a bigint amount to string with decimals
+ */
+export declare function formatAmount(amount: bigint, decimals?: number): string;
+/**
+ * Parse events from a transaction receipt
+ */
+export declare function parseEvents(receipt: TransactionReceipt, contractInterface: Interface): ParsedEvent[];
+/**
+ * Create a transaction result from a receipt
+ */
+export declare function createTransactionResult(receipt: TransactionReceipt, events: ParsedEvent[]): TransactionResult;
+/**
+ * Sleep for a specified duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Retry a function with exponential backoff
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: {
+    retries?: number;
+    delay?: number;
+    onRetry?: (error: unknown, attempt: number) => void;
+}): Promise<T>;
+/**
+ * Estimate gas with buffer
+ */
+export declare function estimateGasWithBuffer(estimateFn: () => Promise<bigint>, bufferPercent?: number): Promise<bigint>;
+/**
+ * Generate a keccak256 hash of identity data
+ */
+export declare function hashIdentityData(data: {
+    firstName?: string;
+    lastName?: string;
+    dateOfBirth?: string;
+    documentNumber?: string;
+    country?: string;
+}): string;
+/**
+ * Convert a timestamp to a Date object
+ */
+export declare function timestampToDate(timestamp: bigint | number): Date;
+/**
+ * Convert a Date to a Unix timestamp
+ */
+export declare function dateToTimestamp(date: Date): number;
+/**
+ * Check if a timestamp is expired
+ */
+export declare function isExpired(timestamp: bigint | number): boolean;
+/**
+ * Calculate percentage
+ */
+export declare function calculatePercentage(part: bigint, total: bigint): number;
+/**
+ * Chunk an array into smaller arrays
+ */
+export declare function chunk<T>(array: T[], size: number): T[][];
+/**
+ * Wait for a transaction to be mined
+ */
+export declare function waitForTransaction(provider: ethers.Provider, hash: string, confirmations?: number): Promise<TransactionReceipt>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAI/D;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAMvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,CAEzE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,CAE1E;AAED;;GAEG;AACH,wBAAgB,WAAW,CACvB,OAAO,EAAE,kBAAkB,EAC3B,iBAAiB,EAAE,SAAS,GAC7B,WAAW,EAAE,CAkCf;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACnC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,WAAW,EAAE,GACtB,iBAAiB,CASnB;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,CAAC,EACzB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IACL,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD,GACP,OAAO,CAAC,CAAC,CAAC,CAyBZ;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACvC,UAAU,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EACjC,aAAa,GAAE,MAAoC,GACpD,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAST;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAI7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAMxD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACpC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,IAAI,EAAE,MAAM,EACZ,aAAa,GAAE,MAAU,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAU7B"}

package/package.json

@@ -0,0 +1,52 @@
+{
+    "name": "@mantle-rwa/sdk",
+    "version": "0.1.0",
+    "description": "TypeScript SDK for RWA tokenization on Mantle Network",
+    "license": "MIT",
+    "type": "module",
+    "main": "./dist/cjs/index.js",
+    "module": "./dist/esm/index.js",
+    "types": "./dist/types/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/esm/index.js",
+            "require": "./dist/cjs/index.js",
+            "types": "./dist/types/index.d.ts"
+        }
+    },
+    "files": [
+        "dist",
+        "src"
+    ],
+    "scripts": {
+        "build": "npm run build:esm && npm run build:cjs && npm run build:types",
+        "build:esm": "tsc -p tsconfig.esm.json && node scripts/fix-esm-imports.js",
+        "build:cjs": "tsc -p tsconfig.cjs.json && node scripts/add-cjs-package-json.js",
+        "build:types": "tsc -p tsconfig.types.json",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "test:coverage": "vitest run --coverage",
+        "lint": "eslint src --ext .ts",
+        "clean": "rm -rf dist coverage",
+        "typecheck": "tsc --noEmit"
+    },
+    "dependencies": {
+        "ethers": "^6.11.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.11.0",
+        "@typescript-eslint/eslint-plugin": "^6.19.0",
+        "@typescript-eslint/parser": "^6.19.0",
+        "@vitest/coverage-v8": "^1.2.0",
+        "eslint": "^8.56.0",
+        "fast-check": "^3.15.0",
+        "typescript": "^5.3.3",
+        "vitest": "^1.2.0"
+    },
+    "peerDependencies": {
+        "ethers": "^6.0.0"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}