riskmarket-sdk 1.0.0

package/dist/utils/helpers.d.ts

@@ -0,0 +1,75 @@
+import { ethers } from 'ethers';
+/**
+ * Utility class with helper functions
+ */
+export declare class Utils {
+    /**
+     * Validate Ethereum address
+     */
+    static isValidAddress(address: string): boolean;
+    /**
+     * Validate and checksum an address
+     */
+    static validateAddress(address: string): string;
+    /**
+     * Format token amount from wei to human-readable format
+     */
+    static formatAmount(amount: string | bigint, decimals?: number): string;
+    /**
+     * Parse human-readable amount to wei
+     */
+    static parseAmount(amount: string, decimals?: number): string;
+    /**
+     * Validate amount is positive and not zero
+     */
+    static validateAmount(amount: string): void;
+    /**
+     * Calculate deadline timestamp (current time + minutes)
+     */
+    static getDeadline(minutes?: number): number;
+    /**
+     * Calculate percentage difference
+     */
+    static calculatePercentageChange(oldValue: string, newValue: string): string;
+    /**
+     * Estimate gas with buffer (adds 20% buffer)
+     */
+    static addGasBuffer(gasEstimate: bigint | string, bufferPercent?: number): string;
+    /**
+     * Parse error message from contract call
+     */
+    static parseContractError(error: any): string;
+    /**
+     * Wait for transaction confirmation
+     */
+    static waitForTransaction(txHash: string, provider: ethers.Provider, confirmations?: number): Promise<ethers.TransactionReceipt | null>;
+    /**
+     * Get current gas prices
+     */
+    static getGasPrices(provider: ethers.Provider): Promise<{
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+    }>;
+    /**
+     * Convert chain ID to network name
+     */
+    static getNetworkName(chainId: number): string;
+    /**
+     * Sleep/delay utility
+     */
+    static sleep(ms: number): Promise<void>;
+    /**
+     * Retry logic for API calls
+     */
+    static retry<T>(fn: () => Promise<T>, maxRetries?: number, delayMs?: number): Promise<T>;
+    /**
+     * Format transaction hash with ellipsis
+     */
+    static shortenHash(hash: string, startLength?: number, endLength?: number): string;
+    /**
+     * Check if a transaction was successful
+     */
+    static isTransactionSuccessful(receipt: ethers.TransactionReceipt | null): boolean;
+}
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC;;GAEG;AACH,qBAAa,KAAK;IAChB;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAQ/C;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAU/C;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM;IAW3E;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM;IAWjE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAU3C;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,GAAE,MAAW,GAAG,MAAM;IAIhD;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAU5E;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,aAAa,GAAE,MAAW,GAAG,MAAM;IAMrF;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM;IAuB7C;;OAEG;WACU,kBAAkB,CAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,aAAa,GAAE,MAAU,GACxB,OAAO,CAAC,MAAM,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAa5C;;OAEG;WACU,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC;QAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;IAiBF;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAa9C;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;OAEG;WACU,KAAK,CAAC,CAAC,EAClB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,GAAE,MAAU,EACtB,OAAO,GAAE,MAAa,GACrB,OAAO,CAAC,CAAC,CAAC;IAiBb;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,GAAE,MAAU,EAAE,SAAS,GAAE,MAAU,GAAG,MAAM;IAOxF;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,kBAAkB,GAAG,IAAI,GAAG,OAAO;CAGnF"}

package/dist/utils/helpers.js

@@ -0,0 +1,185 @@
+import { ethers } from 'ethers';
+import { SDKError, ErrorType } from '../types';
+/**
+ * Utility class with helper functions
+ */
+export class Utils {
+    /**
+     * Validate Ethereum address
+     */
+    static isValidAddress(address) {
+        try {
+            return ethers.isAddress(address);
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Validate and checksum an address
+     */
+    static validateAddress(address) {
+        if (!this.isValidAddress(address)) {
+            throw new SDKError(`Invalid Ethereum address: ${address}`, ErrorType.VALIDATION_ERROR);
+        }
+        return ethers.getAddress(address);
+    }
+    /**
+     * Format token amount from wei to human-readable format
+     */
+    static formatAmount(amount, decimals = 18) {
+        try {
+            return ethers.formatUnits(amount, decimals);
+        }
+        catch (error) {
+            throw new SDKError(`Failed to format amount: ${error}`, ErrorType.VALIDATION_ERROR);
+        }
+    }
+    /**
+     * Parse human-readable amount to wei
+     */
+    static parseAmount(amount, decimals = 18) {
+        try {
+            return ethers.parseUnits(amount, decimals).toString();
+        }
+        catch (error) {
+            throw new SDKError(`Failed to parse amount: ${error}`, ErrorType.VALIDATION_ERROR);
+        }
+    }
+    /**
+     * Validate amount is positive and not zero
+     */
+    static validateAmount(amount) {
+        const amountBN = BigInt(amount);
+        if (amountBN <= 0n) {
+            throw new SDKError('Amount must be greater than zero', ErrorType.VALIDATION_ERROR);
+        }
+    }
+    /**
+     * Calculate deadline timestamp (current time + minutes)
+     */
+    static getDeadline(minutes = 20) {
+        return Math.floor(Date.now() / 1000) + minutes * 60;
+    }
+    /**
+     * Calculate percentage difference
+     */
+    static calculatePercentageChange(oldValue, newValue) {
+        const old = parseFloat(oldValue);
+        const newVal = parseFloat(newValue);
+        if (old === 0)
+            return '0';
+        const change = ((newVal - old) / old) * 100;
+        return change.toFixed(2);
+    }
+    /**
+     * Estimate gas with buffer (adds 20% buffer)
+     */
+    static addGasBuffer(gasEstimate, bufferPercent = 20) {
+        const estimate = BigInt(gasEstimate);
+        const buffer = estimate * BigInt(bufferPercent) / 100n;
+        return (estimate + buffer).toString();
+    }
+    /**
+     * Parse error message from contract call
+     */
+    static parseContractError(error) {
+        // Check for common error patterns
+        if (error.reason) {
+            return error.reason;
+        }
+        if (error.message) {
+            // Extract revert reason if present
+            const revertMatch = error.message.match(/reason="([^"]*)"/);
+            if (revertMatch) {
+                return revertMatch[1];
+            }
+            return error.message;
+        }
+        if (error.data?.message) {
+            return error.data.message;
+        }
+        return 'Unknown error occurred';
+    }
+    /**
+     * Wait for transaction confirmation
+     */
+    static async waitForTransaction(txHash, provider, confirmations = 1) {
+        try {
+            const receipt = await provider.waitForTransaction(txHash, confirmations);
+            return receipt;
+        }
+        catch (error) {
+            throw new SDKError(`Transaction failed: ${this.parseContractError(error)}`, ErrorType.TRANSACTION_ERROR, { txHash });
+        }
+    }
+    /**
+     * Get current gas prices
+     */
+    static async getGasPrices(provider) {
+        try {
+            const feeData = await provider.getFeeData();
+            return {
+                gasPrice: feeData.gasPrice || undefined,
+                maxFeePerGas: feeData.maxFeePerGas || undefined,
+                maxPriorityFeePerGas: feeData.maxPriorityFeePerGas || undefined,
+            };
+        }
+        catch (error) {
+            throw new SDKError(`Failed to fetch gas prices: ${error}`, ErrorType.NETWORK_ERROR);
+        }
+    }
+    /**
+     * Convert chain ID to network name
+     */
+    static getNetworkName(chainId) {
+        const networks = {
+            1: 'Ethereum Mainnet',
+            5: 'Goerli',
+            11155111: 'Sepolia',
+            137: 'Polygon',
+            42161: 'Arbitrum One',
+            10: 'Optimism',
+        };
+        return networks[chainId] || `Unknown Network (${chainId})`;
+    }
+    /**
+     * Sleep/delay utility
+     */
+    static sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Retry logic for API calls
+     */
+    static async retry(fn, maxRetries = 3, delayMs = 1000) {
+        let lastError;
+        for (let i = 0; i < maxRetries; i++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error;
+                if (i < maxRetries - 1) {
+                    await this.sleep(delayMs * (i + 1));
+                }
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Format transaction hash with ellipsis
+     */
+    static shortenHash(hash, startLength = 6, endLength = 4) {
+        if (hash.length <= startLength + endLength) {
+            return hash;
+        }
+        return `${hash.slice(0, startLength)}...${hash.slice(-endLength)}`;
+    }
+    /**
+     * Check if a transaction was successful
+     */
+    static isTransactionSuccessful(receipt) {
+        return receipt?.status === 1;
+    }
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AmanUllah2/raingames-sdk"
+  },
+  "name": "riskmarket-sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "SDK for Risk market Protocol",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && rollup -c",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "lint": "eslint src --ext .ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "blockchain",
+    "ethereum",
+    "web3",
+    "sdk"
+  ],
+  "author": "Quecko Inc",
+  "license": "MIT",
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@types/node": "^20.11.5",
+    "@typescript-eslint/eslint-plugin": "^6.19.1",
+    "@typescript-eslint/parser": "^6.19.1",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "rollup": "^4.9.6",
+    "tslib": "^2.6.2",
+    "typescript": "^5.3.3"
+  },
+  "dependencies": {
+    "ethers": "^6.10.0",
+    "axios": "^1.6.5"
+  },
+  "peerDependencies": {
+    "ethers": "^6.0.0"
+  }
+}