qvtx-developer-kit 1.1.0 → 1.2.0

package/examples/direct-purchase.js

@@ -0,0 +1,300 @@
+/**
+ * QVTX Direct Purchase Example
+ *
+ * This example demonstrates how to use the QVTXDirectPurchase SDK
+ * to buy QVTX tokens directly from the ecosystem.
+ *
+ * Features shown:
+ * - Getting pricing information
+ * - Calculating costs
+ * - Purchasing with native currency (ETH/BNB/MATIC)
+ * - Purchasing with stablecoins (USDT/USDC)
+ * - Using referral codes for discounts
+ * - Managing vested tokens
+ * - Generating referral links
+ */
+
+const { createDirectPurchase, STABLECOINS } = require('qvtx-developer-kit/purchase');
+require('dotenv').config();
+
+// Configuration
+const CONFIG = {
+    // Replace with actual deployed contract address
+    purchaseContract: process.env.QVTX_PURCHASE_CONTRACT || '0x...',
+
+    // BSC Mainnet RPC
+    rpcUrl: process.env.BSC_RPC || 'https://bsc-dataseed.binance.org/',
+
+    // Your private key (NEVER commit this!)
+    privateKey: process.env.PRIVATE_KEY,
+
+    // QVTX Token on BSC
+    qvtxToken: '0x5ad163056FC308C5ab88bf9295EAA2C16F3db400'
+};
+
+async function main() {
+    console.log('='.repeat(60));
+    console.log('QVTX Direct Purchase Example');
+    console.log('='.repeat(60));
+
+    // Initialize the SDK
+    const purchase = createDirectPurchase({
+        provider: CONFIG.rpcUrl,
+        contractAddress: CONFIG.purchaseContract,
+        privateKey: CONFIG.privateKey
+    });
+
+    // ============================================
+    // 1. GET SALE INFORMATION
+    // ============================================
+    console.log('\n--- Sale Information ---\n');
+
+    // Check if sale is active
+    const isPaused = await purchase.isPaused();
+    console.log(`Sale Status: ${isPaused ? 'PAUSED' : 'ACTIVE'}`);
+
+    // Get purchase limits
+    const limits = await purchase.getPurchaseLimits();
+    console.log(`Min Purchase: ${limits.minPurchase} QVTX`);
+    console.log(`Max Purchase: ${limits.maxPurchase} QVTX`);
+    console.log(`Max Per Wallet: ${limits.maxWalletPurchase} QVTX`);
+    console.log(`Total Sale Cap: ${limits.totalSaleCap} QVTX`);
+    console.log(`Already Sold: ${limits.totalSold} QVTX`);
+    console.log(`Remaining: ${limits.remainingSupply} QVTX`);
+
+    // Get current price
+    const priceInBNB = await purchase.getPriceInNative();
+    console.log(`\nPrice: ${priceInBNB} BNB per QVTX`);
+
+    // ============================================
+    // 2. CALCULATE PURCHASE COSTS
+    // ============================================
+    console.log('\n--- Calculate Costs ---\n');
+
+    const buyAmount = '10000'; // Buy 10,000 QVTX
+
+    // Calculate cost in native currency
+    const nativeCost = await purchase.calculateNativeCost(buyAmount);
+    console.log(`Cost for ${buyAmount} QVTX: ${nativeCost} BNB`);
+
+    // Calculate cost with referral discount
+    const referrer = '0x1234567890123456789012345678901234567890';
+    const discountedCost = await purchase.calculateNativeCost(buyAmount, referrer);
+    console.log(`Cost with referral: ${discountedCost} BNB`);
+    console.log(`Savings: ${(parseFloat(nativeCost) - parseFloat(discountedCost)).toFixed(6)} BNB`);
+
+    // Get QVTX amount for specific BNB amount
+    const bnbAmount = '1.0';
+    const qvtxForBNB = await purchase.getQVTXForNative(bnbAmount);
+    console.log(`\n${bnbAmount} BNB = ${qvtxForBNB} QVTX`);
+
+    // ============================================
+    // 3. CHECK IF PURCHASE IS VALID
+    // ============================================
+    console.log('\n--- Validate Purchase ---\n');
+
+    // Get connected wallet address
+    const walletAddress = CONFIG.privateKey
+        ? new (require('ethers').Wallet)(CONFIG.privateKey).address
+        : '0x0000000000000000000000000000000000000000';
+
+    const validation = await purchase.canPurchase(walletAddress, buyAmount);
+    console.log(`Can purchase ${buyAmount} QVTX: ${validation.valid}`);
+    if (!validation.valid) {
+        console.log(`Reason: ${validation.reason}`);
+    }
+
+    // ============================================
+    // 4. GET WALLET INFORMATION
+    // ============================================
+    console.log('\n--- Wallet Info ---\n');
+
+    const walletInfo = await purchase.getWalletInfo(walletAddress);
+    console.log(`Total Purchased: ${walletInfo.totalPurchased} QVTX`);
+    console.log(`Remaining Allocation: ${walletInfo.remainingAllocation} QVTX`);
+    console.log(`Purchase Count: ${walletInfo.purchaseCount}`);
+
+    if (walletInfo.purchases.length > 0) {
+        console.log('\nPurchase History:');
+        walletInfo.purchases.forEach((p, i) => {
+            console.log(`  ${i + 1}. ${p.amount} QVTX on ${p.timestamp.toLocaleDateString()}`);
+        });
+    }
+
+    // ============================================
+    // 5. GET REFERRAL INFORMATION
+    // ============================================
+    console.log('\n--- Referral Info ---\n');
+
+    const referralInfo = await purchase.getReferralInfo(walletAddress);
+    console.log(`Referral Reward: ${referralInfo.rewardPercent}%`);
+    console.log(`Buyer Discount: ${referralInfo.discountPercent}%`);
+    console.log(`Your Referrals: ${referralInfo.referralCount}`);
+    console.log(`Total Earnings: ${referralInfo.totalEarnings} QVTX`);
+
+    // Generate your referral link
+    const referralLink = purchase.generateReferralLink(walletAddress);
+    console.log(`\nYour Referral Link: ${referralLink}`);
+
+    // ============================================
+    // 6. PURCHASE WITH NATIVE CURRENCY (BNB)
+    // ============================================
+    console.log('\n--- Purchase with BNB ---\n');
+
+    // IMPORTANT: Only run this if you want to make a real purchase!
+    const EXECUTE_PURCHASE = false;
+
+    if (EXECUTE_PURCHASE && CONFIG.privateKey) {
+        try {
+            // Get purchase summary before buying
+            const summary = await purchase.getPurchaseSummary(buyAmount, referrer);
+            console.log('Purchase Summary:');
+            console.log(`  Amount: ${summary.qvtxAmount} QVTX`);
+            console.log(`  Cost: ${summary.nativeCost} BNB`);
+            console.log(`  Referrer: ${summary.referrer}`);
+            console.log(`  Discount: ${summary.discount}`);
+
+            // Execute purchase
+            console.log('\nExecuting purchase...');
+            const tx = await purchase.purchaseWithNative(buyAmount, {
+                referrer: referrer
+            });
+
+            console.log(`Transaction Hash: ${tx.hash}`);
+            console.log('Waiting for confirmation...');
+
+            const receipt = await tx.wait();
+            console.log(`Confirmed in block: ${receipt.blockNumber}`);
+            console.log(`Gas Used: ${receipt.gasUsed.toString()}`);
+        } catch (error) {
+            console.error('Purchase failed:', error.message);
+        }
+    } else {
+        console.log('(Purchase execution disabled - set EXECUTE_PURCHASE = true to buy)');
+    }
+
+    // ============================================
+    // 7. PURCHASE WITH STABLECOIN (USDT)
+    // ============================================
+    console.log('\n--- Purchase with USDT ---\n');
+
+    const usdtAddress = STABLECOINS.bsc.USDT;
+    console.log(`USDT Address: ${usdtAddress}`);
+
+    // Check if USDT is supported
+    const supportedTokens = await purchase.getSupportedTokens();
+    const usdtSupported = supportedTokens.includes(usdtAddress);
+    console.log(`USDT Supported: ${usdtSupported}`);
+
+    if (usdtSupported) {
+        const usdtCost = await purchase.calculateTokenCost(usdtAddress, buyAmount);
+        console.log(`Cost for ${buyAmount} QVTX: ${usdtCost} USDT`);
+
+        // IMPORTANT: Only run this if you want to make a real purchase!
+        if (EXECUTE_PURCHASE && CONFIG.privateKey) {
+            try {
+                console.log('\nExecuting USDT purchase...');
+                const tx = await purchase.purchaseWithToken(usdtAddress, buyAmount, {
+                    referrer: referrer,
+                    approve: true // Auto-approve USDT spending
+                });
+
+                console.log(`Transaction Hash: ${tx.hash}`);
+                const receipt = await tx.wait();
+                console.log(`Confirmed in block: ${receipt.blockNumber}`);
+            } catch (error) {
+                console.error('USDT purchase failed:', error.message);
+            }
+        }
+    }
+
+    // ============================================
+    // 8. VESTING SCHEDULE MANAGEMENT
+    // ============================================
+    console.log('\n--- Vesting Schedules ---\n');
+
+    const vestingSchedules = await purchase.getVestingSchedules(walletAddress);
+
+    if (vestingSchedules.length === 0) {
+        console.log('No vesting schedules found.');
+        console.log('(Large purchases over threshold will have vesting)');
+    } else {
+        console.log(`Found ${vestingSchedules.length} vesting schedule(s):\n`);
+
+        for (const schedule of vestingSchedules) {
+            console.log(`Schedule #${schedule.index}:`);
+            console.log(`  Total: ${schedule.totalAmount} QVTX`);
+            console.log(`  Released: ${schedule.released} QVTX`);
+            console.log(`  Remaining: ${schedule.remaining} QVTX`);
+            console.log(`  Start: ${schedule.startTime.toLocaleDateString()}`);
+            console.log(`  End: ${schedule.endTime.toLocaleDateString()}`);
+            console.log(`  Duration: ${schedule.duration} days`);
+            console.log(`  Progress: ${schedule.percentVested.toFixed(2)}%\n`);
+
+            // Release vested tokens
+            if (EXECUTE_PURCHASE && parseFloat(schedule.remaining) > 0) {
+                try {
+                    console.log('  Releasing vested tokens...');
+                    const tx = await purchase.releaseVested(schedule.index);
+                    await tx.wait();
+                    console.log('  Released successfully!');
+                } catch (error) {
+                    console.error(`  Release failed: ${error.message}`);
+                }
+            }
+        }
+    }
+
+    // ============================================
+    // 9. WHITELIST CHECK (FOR PRIVATE SALES)
+    // ============================================
+    console.log('\n--- Whitelist Status ---\n');
+
+    const whitelistEnabled = await purchase.isWhitelistEnabled();
+    console.log(`Whitelist Mode: ${whitelistEnabled ? 'ENABLED (Private Sale)' : 'DISABLED (Public Sale)'}`);
+
+    if (whitelistEnabled) {
+        const isWhitelisted = await purchase.isWhitelisted(walletAddress);
+        console.log(`Your Status: ${isWhitelisted ? 'WHITELISTED' : 'NOT WHITELISTED'}`);
+    }
+
+    // ============================================
+    // DONE
+    // ============================================
+    console.log('\n' + '='.repeat(60));
+    console.log('Example complete!');
+    console.log('='.repeat(60));
+}
+
+// Run the example
+main().catch(console.error);
+
+/**
+ * Quick Purchase Function
+ * Use this for simple purchases in your own code
+ */
+async function quickPurchase(amount, options = {}) {
+    const purchase = createDirectPurchase({
+        provider: options.rpcUrl || CONFIG.rpcUrl,
+        contractAddress: options.contractAddress || CONFIG.purchaseContract,
+        privateKey: options.privateKey || CONFIG.privateKey
+    });
+
+    // Validate first
+    const wallet = new (require('ethers').Wallet)(options.privateKey || CONFIG.privateKey);
+    const { valid, reason } = await purchase.canPurchase(wallet.address, amount);
+
+    if (!valid) {
+        throw new Error(`Cannot purchase: ${reason}`);
+    }
+
+    // Execute purchase
+    const tx = await purchase.purchaseWithNative(amount, {
+        referrer: options.referrer
+    });
+
+    return tx;
+}
+
+// Export for use in other files
+module.exports = { quickPurchase };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "qvtx-developer-kit",
-    "version": "1.1.0",
+    "version": "1.2.0",
     "description": "Complete QuantVestrix QVTX Developer Package - Build infinite throughput blockchain applications with cross-chain rewards and neural storage",
     "main": "index.js",
     "types": "types/index.d.ts",
@@ -16,6 +16,7 @@
         "./storage": "./storage/index.js",
         "./config": "./config/index.js",
         "./test": "./test/index.js",
+        "./purchase": "./purchase/index.js",
         "./solana": "./languages/solana_sdk.js",
         "./blockchain-ai": "./languages/blockchain_ai_sdk.js",
         "./node-sdk": "./languages/node_sdk.js"
@@ -30,6 +31,7 @@
         "smart-contracts/",
         "rewards/",
         "storage/",
+        "purchase/",
         "bin/",
         "abis/",
         "types/",