qvtx-developer-kit 1.0.0 → 1.2.0

package/abis/QVTXVesting.json

@@ -0,0 +1,216 @@
+{
+  "contractName": "QVTXVesting",
+  "abi": [
+    {
+      "inputs": [{"internalType": "address", "name": "_qvtxToken", "type": "address"}],
+      "stateMutability": "nonpayable",
+      "type": "constructor"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {"indexed": true, "internalType": "address", "name": "previousOwner", "type": "address"},
+        {"indexed": true, "internalType": "address", "name": "newOwner", "type": "address"}
+      ],
+      "name": "OwnershipTransferred",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {"indexed": true, "internalType": "uint256", "name": "scheduleId", "type": "uint256"},
+        {"indexed": true, "internalType": "address", "name": "beneficiary", "type": "address"},
+        {"indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256"}
+      ],
+      "name": "TokensReleased",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {"indexed": true, "internalType": "uint256", "name": "scheduleId", "type": "uint256"},
+        {"indexed": false, "internalType": "uint256", "name": "refundAmount", "type": "uint256"}
+      ],
+      "name": "VestingRevoked",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {"indexed": true, "internalType": "uint256", "name": "scheduleId", "type": "uint256"},
+        {"indexed": true, "internalType": "address", "name": "beneficiary", "type": "address"},
+        {"indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256"},
+        {"indexed": false, "internalType": "uint8", "name": "vestingType", "type": "uint8"}
+      ],
+      "name": "VestingScheduleCreated",
+      "type": "event"
+    },
+    {
+      "inputs": [
+        {"internalType": "address[]", "name": "beneficiaries", "type": "address[]"},
+        {"internalType": "uint256[]", "name": "amounts", "type": "uint256[]"},
+        {"internalType": "uint8", "name": "vestingType", "type": "uint8"}
+      ],
+      "name": "batchCreateVestingSchedules",
+      "outputs": [{"internalType": "uint256[]", "name": "", "type": "uint256[]"}],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {"internalType": "address", "name": "beneficiary", "type": "address"},
+        {"internalType": "uint256", "name": "amount", "type": "uint256"},
+        {"internalType": "uint256", "name": "startTime", "type": "uint256"},
+        {"internalType": "uint256", "name": "cliffDuration", "type": "uint256"},
+        {"internalType": "uint256", "name": "vestingDuration", "type": "uint256"},
+        {"internalType": "uint256", "name": "slicePeriod", "type": "uint256"},
+        {"internalType": "bool", "name": "revocable", "type": "bool"}
+      ],
+      "name": "createCustomVestingSchedule",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {"internalType": "address", "name": "beneficiary", "type": "address"},
+        {"internalType": "uint256", "name": "amount", "type": "uint256"},
+        {"internalType": "uint8", "name": "vestingType", "type": "uint8"}
+      ],
+      "name": "createVestingSchedule",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "emergencyWithdraw",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "address", "name": "beneficiary", "type": "address"}],
+      "name": "getBeneficiarySchedules",
+      "outputs": [{"internalType": "uint256[]", "name": "", "type": "uint256[]"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "scheduleId", "type": "uint256"}],
+      "name": "getReleasableAmount",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "address", "name": "beneficiary", "type": "address"}],
+      "name": "getTotalReleasable",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "scheduleId", "type": "uint256"}],
+      "name": "getVestedAmount",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "scheduleId", "type": "uint256"}],
+      "name": "getVestingSchedule",
+      "outputs": [
+        {
+          "components": [
+            {"internalType": "uint256", "name": "id", "type": "uint256"},
+            {"internalType": "address", "name": "beneficiary", "type": "address"},
+            {"internalType": "uint256", "name": "totalAmount", "type": "uint256"},
+            {"internalType": "uint256", "name": "releasedAmount", "type": "uint256"},
+            {"internalType": "uint256", "name": "startTime", "type": "uint256"},
+            {"internalType": "uint256", "name": "cliffDuration", "type": "uint256"},
+            {"internalType": "uint256", "name": "vestingDuration", "type": "uint256"},
+            {"internalType": "uint256", "name": "slicePeriod", "type": "uint256"},
+            {"internalType": "bool", "name": "revocable", "type": "bool"},
+            {"internalType": "bool", "name": "revoked", "type": "bool"},
+            {"internalType": "uint8", "name": "vestingType", "type": "uint8"}
+          ],
+          "internalType": "struct QVTXVesting.VestingSchedule",
+          "name": "",
+          "type": "tuple"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "owner",
+      "outputs": [{"internalType": "address", "name": "", "type": "address"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "scheduleId", "type": "uint256"}],
+      "name": "release",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "releaseAll",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "scheduleId", "type": "uint256"}],
+      "name": "revoke",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "scheduleCount",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "totalReleased",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "totalVested",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "address", "name": "newOwner", "type": "address"}],
+      "name": "transferOwnership",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {"internalType": "uint8", "name": "vestingType", "type": "uint8"},
+        {"internalType": "uint256", "name": "cliffDuration", "type": "uint256"},
+        {"internalType": "uint256", "name": "vestingDuration", "type": "uint256"},
+        {"internalType": "uint256", "name": "slicePeriod", "type": "uint256"},
+        {"internalType": "bool", "name": "revocable", "type": "bool"}
+      ],
+      "name": "updatePresetConfig",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    }
+  ]
+}

package/abis/index.js

@@ -0,0 +1,16 @@
+'use strict';
+
+/**
+ * QVTX Contract ABIs
+ * Export all contract ABIs for easy importing
+ */
+
+module.exports = {
+    QVTXToken: require('./QVTXToken.json'),
+    QVTXGovernance: require('./QVTXGovernance.json'),
+    QVTXBridge: require('./QVTXBridge.json'),
+    QVTXNFT: require('./QVTXNFT.json'),
+    QVTXVesting: require('./QVTXVesting.json'),
+    QVTXRewards: require('./QVTXRewards.json'),
+    QVTXDirectPurchase: require('./QVTXDirectPurchase.json')
+};

package/bin/qvtx-developer-cli.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+'use strict';
+
+const { Command } = require('commander');
+const path = require('path');
+const fs = require('fs');
+
+const program = new Command();
+
+program
+    .name('qvtx')
+    .description('QVTX Developer Kit CLI - Build infinite throughput blockchain applications')
+    .version('1.0.0');
+
+program
+    .command('init [project-name]')
+    .description('Initialize a new QVTX project')
+    .option('-t, --template <type>', 'Project template (dapp, contract, full)', 'dapp')
+    .action(async (projectName, options) => {
+        const initScript = require('../tools/init-project');
+        await initScript.run(projectName, options);
+    });
+
+program
+    .command('create <type> [name]')
+    .description('Create a new component (dapp, contract)')
+    .action(async (type, name) => {
+        const createScript = require('../tools/create-template');
+        await createScript.run(type, name);
+    });
+
+program
+    .command('deploy [contract]')
+    .description('Deploy smart contract')
+    .option('-n, --network <network>', 'Target network', 'ethereum')
+    .option('-e, --env <environment>', 'Environment (mainnet, testnet)', 'testnet')
+    .action(async (contract, options) => {
+        const deployScript = require('../tools/deploy-tool');
+        await deployScript.run(contract, options);
+    });
+
+program
+    .command('test [pattern]')
+    .description('Run tests')
+    .option('-v, --verbose', 'Verbose output')
+    .action(async (pattern, options) => {
+        const testScript = require('../tools/run-tests');
+        await testScript.run(pattern, options);
+    });
+
+program
+    .command('build')
+    .description('Build the project')
+    .option('-p, --production', 'Production build')
+    .action(async (options) => {
+        const buildScript = require('../tools/build-tool');
+        await buildScript.run(options);
+    });
+
+program
+    .command('docs')
+    .description('Generate documentation')
+    .action(async () => {
+        const docsScript = require('../tools/generate-docs');
+        await docsScript.run();
+    });
+
+program
+    .command('networks')
+    .description('List supported networks')
+    .action(() => {
+        const QVTX = require('../index');
+        const kit = new QVTX();
+        console.log('\nSupported Networks:\n');
+        const networks = kit.getNetworks();
+        Object.entries(networks).forEach(([name, envs]) => {
+            console.log(`  ${name}:`);
+            Object.keys(envs).forEach(env => {
+                console.log(`    - ${env}`);
+            });
+        });
+        console.log('');
+    });
+
+program
+    .command('info')
+    .description('Show QVTX token info')
+    .action(() => {
+        const QVTX = require('../index');
+        const kit = new QVTX();
+        const info = kit.getTokenInfo();
+        console.log('\nQVTX Token Info:\n');
+        console.log(`  Name: ${info.name}`);
+        console.log(`  Symbol: ${info.symbol}`);
+        console.log(`  Decimals: ${info.decimals}`);
+        console.log(`  Total Supply: 1,000,000,000 QVTX\n`);
+    });
+
+program.parse();

package/config/index.js

@@ -0,0 +1,108 @@
+'use strict';
+
+/**
+ * QVTX Configuration Module
+ * Central configuration management
+ */
+
+const networks = require('./networks');
+const path = require('path');
+const fs = require('fs');
+
+// Load environment variables from .env if exists
+function loadEnv(envPath) {
+    const dotenvPath = envPath || path.join(process.cwd(), '.env');
+
+    if (fs.existsSync(dotenvPath)) {
+        const content = fs.readFileSync(dotenvPath, 'utf8');
+        const lines = content.split('\n');
+
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed && !trimmed.startsWith('#')) {
+                const [key, ...valueParts] = trimmed.split('=');
+                const value = valueParts.join('=').trim();
+                if (key && !process.env[key]) {
+                    process.env[key] = value;
+                }
+            }
+        }
+    }
+}
+
+// Default configuration
+const DEFAULT_CONFIG = {
+    network: 'ethereum',
+    environment: 'mainnet',
+    debug: false,
+    timeout: 30000,
+    retries: 3,
+    gasMultiplier: 1.2
+};
+
+// Get configuration value
+function get(key, defaultValue) {
+    const envKey = `QVTX_${key.toUpperCase()}`;
+    return process.env[envKey] || defaultValue;
+}
+
+// Get private key (with validation)
+function getPrivateKey() {
+    const key = process.env.PRIVATE_KEY;
+    if (!key) {
+        throw new Error('PRIVATE_KEY environment variable not set');
+    }
+    if (!key.startsWith('0x')) {
+        return '0x' + key;
+    }
+    return key;
+}
+
+// Get RPC URL for network
+function getRpcUrl(network, environment) {
+    const envKey = `${network.toUpperCase()}_RPC`;
+    if (process.env[envKey]) {
+        return process.env[envKey];
+    }
+
+    const networkConfig = networks.getNetwork(network, environment);
+    let rpc = networkConfig.rpc;
+
+    // Replace API key placeholders
+    if (rpc.includes('${INFURA_API_KEY}') && process.env.INFURA_API_KEY) {
+        rpc = rpc.replace('${INFURA_API_KEY}', process.env.INFURA_API_KEY);
+    }
+    if (rpc.includes('${ALCHEMY_API_KEY}') && process.env.ALCHEMY_API_KEY) {
+        rpc = rpc.replace('${ALCHEMY_API_KEY}', process.env.ALCHEMY_API_KEY);
+    }
+
+    return rpc;
+}
+
+// Get contract address
+function getContractAddress(contractName, network = 'ethereum') {
+    const envKey = `QVTX_${contractName.toUpperCase()}_${network.toUpperCase()}`;
+    return process.env[envKey] || null;
+}
+
+// Create configuration object
+function createConfig(options = {}) {
+    return {
+        ...DEFAULT_CONFIG,
+        ...options,
+        getPrivateKey,
+        getRpcUrl: (net, env) => getRpcUrl(net || options.network, env || options.environment),
+        getContractAddress
+    };
+}
+
+module.exports = {
+    loadEnv,
+    get,
+    getPrivateKey,
+    getRpcUrl,
+    getContractAddress,
+    createConfig,
+    DEFAULT_CONFIG,
+    ...networks
+};

package/config/networks.js

@@ -0,0 +1,247 @@
+'use strict';
+
+/**
+ * QVTX Network Configurations
+ * Supported blockchain networks and their settings
+ */
+
+const NETWORKS = {
+    // Ethereum
+    ethereum: {
+        mainnet: {
+            chainId: 1,
+            name: 'Ethereum Mainnet',
+            rpc: 'https://eth.llamarpc.com',
+            rpcAlternatives: [
+                'https://mainnet.infura.io/v3/${INFURA_API_KEY}',
+                'https://eth-mainnet.g.alchemy.com/v2/${ALCHEMY_API_KEY}',
+                'https://cloudflare-eth.com'
+            ],
+            nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+            blockExplorer: 'https://etherscan.io',
+            avgBlockTime: 12
+        },
+        goerli: {
+            chainId: 5,
+            name: 'Goerli Testnet',
+            rpc: 'https://goerli.infura.io/v3/${INFURA_API_KEY}',
+            nativeCurrency: { name: 'Goerli Ether', symbol: 'ETH', decimals: 18 },
+            blockExplorer: 'https://goerli.etherscan.io',
+            faucet: 'https://goerlifaucet.com',
+            avgBlockTime: 12
+        },
+        sepolia: {
+            chainId: 11155111,
+            name: 'Sepolia Testnet',
+            rpc: 'https://sepolia.infura.io/v3/${INFURA_API_KEY}',
+            nativeCurrency: { name: 'Sepolia Ether', symbol: 'ETH', decimals: 18 },
+            blockExplorer: 'https://sepolia.etherscan.io',
+            faucet: 'https://sepoliafaucet.com',
+            avgBlockTime: 12
+        }
+    },
+
+    // BNB Smart Chain
+    bsc: {
+        mainnet: {
+            chainId: 56,
+            name: 'BNB Smart Chain',
+            rpc: 'https://bsc-dataseed.binance.org/',
+            rpcAlternatives: [
+                'https://bsc-dataseed1.defibit.io/',
+                'https://bsc-dataseed1.ninicoin.io/'
+            ],
+            nativeCurrency: { name: 'BNB', symbol: 'BNB', decimals: 18 },
+            blockExplorer: 'https://bscscan.com',
+            avgBlockTime: 3
+        },
+        testnet: {
+            chainId: 97,
+            name: 'BSC Testnet',
+            rpc: 'https://data-seed-prebsc-1-s1.binance.org:8545/',
+            nativeCurrency: { name: 'Test BNB', symbol: 'tBNB', decimals: 18 },
+            blockExplorer: 'https://testnet.bscscan.com',
+            faucet: 'https://testnet.binance.org/faucet-smart',
+            avgBlockTime: 3
+        }
+    },
+
+    // Polygon
+    polygon: {
+        mainnet: {
+            chainId: 137,
+            name: 'Polygon Mainnet',
+            rpc: 'https://polygon-rpc.com/',
+            rpcAlternatives: [
+                'https://rpc-mainnet.maticvigil.com/',
+                'https://polygon-mainnet.g.alchemy.com/v2/${ALCHEMY_API_KEY}'
+            ],
+            nativeCurrency: { name: 'MATIC', symbol: 'MATIC', decimals: 18 },
+            blockExplorer: 'https://polygonscan.com',
+            avgBlockTime: 2
+        },
+        mumbai: {
+            chainId: 80001,
+            name: 'Mumbai Testnet',
+            rpc: 'https://rpc-mumbai.maticvigil.com/',
+            nativeCurrency: { name: 'Test MATIC', symbol: 'MATIC', decimals: 18 },
+            blockExplorer: 'https://mumbai.polygonscan.com',
+            faucet: 'https://faucet.polygon.technology/',
+            avgBlockTime: 2
+        }
+    },
+
+    // Arbitrum
+    arbitrum: {
+        mainnet: {
+            chainId: 42161,
+            name: 'Arbitrum One',
+            rpc: 'https://arb1.arbitrum.io/rpc',
+            rpcAlternatives: [
+                'https://arb-mainnet.g.alchemy.com/v2/${ALCHEMY_API_KEY}'
+            ],
+            nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+            blockExplorer: 'https://arbiscan.io',
+            avgBlockTime: 0.25
+        },
+        goerli: {
+            chainId: 421613,
+            name: 'Arbitrum Goerli',
+            rpc: 'https://goerli-rollup.arbitrum.io/rpc',
+            nativeCurrency: { name: 'Goerli Ether', symbol: 'ETH', decimals: 18 },
+            blockExplorer: 'https://goerli.arbiscan.io',
+            faucet: 'https://faucet.arbitrum.io/',
+            avgBlockTime: 0.25
+        }
+    },
+
+    // Avalanche
+    avalanche: {
+        mainnet: {
+            chainId: 43114,
+            name: 'Avalanche C-Chain',
+            rpc: 'https://api.avax.network/ext/bc/C/rpc',
+            rpcAlternatives: [
+                'https://avalanche-mainnet.infura.io/v3/${INFURA_API_KEY}'
+            ],
+            nativeCurrency: { name: 'AVAX', symbol: 'AVAX', decimals: 18 },
+            blockExplorer: 'https://snowtrace.io',
+            avgBlockTime: 2
+        },
+        fuji: {
+            chainId: 43113,
+            name: 'Avalanche Fuji',
+            rpc: 'https://api.avax-test.network/ext/bc/C/rpc',
+            nativeCurrency: { name: 'Test AVAX', symbol: 'AVAX', decimals: 18 },
+            blockExplorer: 'https://testnet.snowtrace.io',
+            faucet: 'https://faucet.avax.network/',
+            avgBlockTime: 2
+        }
+    },
+
+    // Optimism
+    optimism: {
+        mainnet: {
+            chainId: 10,
+            name: 'Optimism',
+            rpc: 'https://mainnet.optimism.io',
+            rpcAlternatives: [
+                'https://opt-mainnet.g.alchemy.com/v2/${ALCHEMY_API_KEY}'
+            ],
+            nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+            blockExplorer: 'https://optimistic.etherscan.io',
+            avgBlockTime: 2
+        },
+        goerli: {
+            chainId: 420,
+            name: 'Optimism Goerli',
+            rpc: 'https://goerli.optimism.io',
+            nativeCurrency: { name: 'Goerli Ether', symbol: 'ETH', decimals: 18 },
+            blockExplorer: 'https://goerli-optimism.etherscan.io',
+            avgBlockTime: 2
+        }
+    },
+
+    // Solana (different structure)
+    solana: {
+        'mainnet-beta': {
+            name: 'Solana Mainnet',
+            rpc: 'https://api.mainnet-beta.solana.com',
+            rpcAlternatives: [
+                'https://solana-api.projectserum.com'
+            ],
+            blockExplorer: 'https://explorer.solana.com'
+        },
+        devnet: {
+            name: 'Solana Devnet',
+            rpc: 'https://api.devnet.solana.com',
+            blockExplorer: 'https://explorer.solana.com?cluster=devnet',
+            faucet: 'https://solfaucet.com/'
+        },
+        testnet: {
+            name: 'Solana Testnet',
+            rpc: 'https://api.testnet.solana.com',
+            blockExplorer: 'https://explorer.solana.com?cluster=testnet'
+        }
+    }
+};
+
+// Helper functions
+function getNetwork(name, environment = 'mainnet') {
+    const network = NETWORKS[name.toLowerCase()];
+    if (!network) {
+        throw new Error(`Unknown network: ${name}`);
+    }
+    const env = network[environment];
+    if (!env) {
+        throw new Error(`Unknown environment: ${environment} for network ${name}`);
+    }
+    return env;
+}
+
+function getChainById(chainId) {
+    for (const [networkName, envs] of Object.entries(NETWORKS)) {
+        for (const [envName, config] of Object.entries(envs)) {
+            if (config.chainId === chainId) {
+                return { network: networkName, environment: envName, ...config };
+            }
+        }
+    }
+    return null;
+}
+
+function getAllNetworks() {
+    return NETWORKS;
+}
+
+function getMainnets() {
+    const mainnets = {};
+    for (const [name, envs] of Object.entries(NETWORKS)) {
+        if (envs.mainnet || envs['mainnet-beta']) {
+            mainnets[name] = envs.mainnet || envs['mainnet-beta'];
+        }
+    }
+    return mainnets;
+}
+
+function getTestnets() {
+    const testnets = {};
+    for (const [name, envs] of Object.entries(NETWORKS)) {
+        for (const [envName, config] of Object.entries(envs)) {
+            if (envName !== 'mainnet' && envName !== 'mainnet-beta') {
+                if (!testnets[name]) testnets[name] = {};
+                testnets[name][envName] = config;
+            }
+        }
+    }
+    return testnets;
+}
+
+module.exports = {
+    NETWORKS,
+    getNetwork,
+    getChainById,
+    getAllNetworks,
+    getMainnets,
+    getTestnets
+};