qvtx-developer-kit 1.0.0 → 1.1.0

package/.env.example

@@ -0,0 +1,108 @@
+# QVTX Developer Kit - Environment Configuration
+# Copy this file to .env and fill in your values
+
+# ===========================================
+# WALLET & AUTHENTICATION
+# ===========================================
+
+# Your wallet private key (NEVER commit this!)
+PRIVATE_KEY=your-private-key-here
+
+# Your wallet mnemonic (alternative to private key)
+MNEMONIC=your twelve word mnemonic phrase here
+
+# ===========================================
+# ETHEREUM & EVM CHAINS
+# ===========================================
+
+# Infura API Key (https://infura.io)
+INFURA_API_KEY=your-infura-api-key
+
+# Alchemy API Key (https://alchemy.com)
+ALCHEMY_API_KEY=your-alchemy-api-key
+
+# Custom RPC URLs (optional - overrides API keys)
+ETHEREUM_RPC=https://mainnet.infura.io/v3/YOUR_KEY
+GOERLI_RPC=https://goerli.infura.io/v3/YOUR_KEY
+SEPOLIA_RPC=https://sepolia.infura.io/v3/YOUR_KEY
+BSC_RPC=https://bsc-dataseed.binance.org/
+POLYGON_RPC=https://polygon-rpc.com/
+ARBITRUM_RPC=https://arb1.arbitrum.io/rpc
+AVALANCHE_RPC=https://api.avax.network/ext/bc/C/rpc
+OPTIMISM_RPC=https://mainnet.optimism.io
+
+# ===========================================
+# SOLANA
+# ===========================================
+
+# Solana Network (mainnet-beta, devnet, testnet)
+SOLANA_NETWORK=devnet
+
+# Custom Solana RPC (optional)
+SOLANA_RPC=https://api.devnet.solana.com
+
+# ===========================================
+# QVTX CONTRACT ADDRESSES
+# ===========================================
+
+# Ethereum Mainnet
+QVTX_TOKEN_ETH=0x...
+QVTX_GOVERNANCE_ETH=0x...
+QVTX_BRIDGE_ETH=0x...
+QVTX_STAKING_ETH=0x...
+QVTX_NFT_ETH=0x...
+
+# BSC Mainnet
+QVTX_TOKEN_BSC=0x...
+QVTX_BRIDGE_BSC=0x...
+
+# Polygon Mainnet
+QVTX_TOKEN_POLYGON=0x...
+QVTX_BRIDGE_POLYGON=0x...
+
+# Solana
+QVTX_TOKEN_SOLANA=...
+
+# ===========================================
+# API KEYS & SERVICES
+# ===========================================
+
+# Etherscan API Key (for contract verification)
+ETHERSCAN_API_KEY=your-etherscan-api-key
+
+# BSCScan API Key
+BSCSCAN_API_KEY=your-bscscan-api-key
+
+# PolygonScan API Key
+POLYGONSCAN_API_KEY=your-polygonscan-api-key
+
+# Pinata IPFS (for NFT metadata)
+PINATA_API_KEY=your-pinata-api-key
+PINATA_SECRET_KEY=your-pinata-secret-key
+
+# NFT.Storage (alternative IPFS)
+NFT_STORAGE_API_KEY=your-nft-storage-api-key
+
+# ===========================================
+# DEVELOPMENT & TESTING
+# ===========================================
+
+# Local Hardhat/Ganache
+LOCAL_RPC=http://127.0.0.1:8545
+
+# Test accounts (for local development only)
+TEST_ACCOUNT_1=0x...
+TEST_ACCOUNT_2=0x...
+
+# ===========================================
+# QVTX SPECIFIC
+# ===========================================
+
+# QVTX API Key (for premium features)
+QVTX_API_KEY=your-qvtx-api-key
+
+# QVTX Neural Storage endpoint
+QVTX_NEURAL_STORAGE=https://storage.quantvestrix.com
+
+# Enable debug logging
+DEBUG=false

package/abis/QVTXBridge.json

@@ -0,0 +1,273 @@
+{
+  "contractName": "QVTXBridge",
+  "abi": [
+    {
+      "inputs": [
+        {"internalType": "address", "name": "_qvtxToken", "type": "address"},
+        {"internalType": "uint256", "name": "_chainId", "type": "uint256"}
+      ],
+      "stateMutability": "nonpayable",
+      "type": "constructor"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {"indexed": true, "internalType": "uint256", "name": "requestId", "type": "uint256"},
+        {"indexed": true, "internalType": "address", "name": "recipient", "type": "address"},
+        {"indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256"},
+        {"indexed": false, "internalType": "uint256", "name": "sourceChain", "type": "uint256"},
+        {"indexed": false, "internalType": "bytes32", "name": "sourceTxHash", "type": "bytes32"}
+      ],
+      "name": "BridgeCompleted",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {"indexed": true, "internalType": "uint256", "name": "requestId", "type": "uint256"},
+        {"indexed": true, "internalType": "address", "name": "sender", "type": "address"},
+        {"indexed": true, "internalType": "address", "name": "recipient", "type": "address"},
+        {"indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256"},
+        {"indexed": false, "internalType": "uint256", "name": "sourceChain", "type": "uint256"},
+        {"indexed": false, "internalType": "uint256", "name": "targetChain", "type": "uint256"}
+      ],
+      "name": "BridgeInitiated",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {"indexed": true, "internalType": "uint256", "name": "requestId", "type": "uint256"},
+        {"indexed": true, "internalType": "address", "name": "sender", "type": "address"},
+        {"indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256"}
+      ],
+      "name": "BridgeRefunded",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {"indexed": true, "internalType": "uint256", "name": "chainId", "type": "uint256"},
+        {"indexed": false, "internalType": "address", "name": "bridgeContract", "type": "address"}
+      ],
+      "name": "ChainAdded",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [{"indexed": true, "internalType": "uint256", "name": "chainId", "type": "uint256"}],
+      "name": "ChainRemoved",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {"indexed": true, "internalType": "address", "name": "to", "type": "address"},
+        {"indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256"}
+      ],
+      "name": "FeesWithdrawn",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [{"indexed": false, "internalType": "bool", "name": "status", "type": "bool"}],
+      "name": "Paused",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [{"indexed": true, "internalType": "address", "name": "newValidator", "type": "address"}],
+      "name": "ValidatorUpdated",
+      "type": "event"
+    },
+    {
+      "inputs": [
+        {"internalType": "uint256", "name": "chainId", "type": "uint256"},
+        {"internalType": "address", "name": "bridgeContract", "type": "address"}
+      ],
+      "name": "addChain",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {"internalType": "address", "name": "recipient", "type": "address"},
+        {"internalType": "uint256", "name": "amount", "type": "uint256"},
+        {"internalType": "uint256", "name": "targetChain", "type": "uint256"}
+      ],
+      "name": "bridge",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "payable",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "bridgeFee",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {"internalType": "address", "name": "recipient", "type": "address"},
+        {"internalType": "uint256", "name": "amount", "type": "uint256"},
+        {"internalType": "uint256", "name": "sourceChain", "type": "uint256"},
+        {"internalType": "bytes32", "name": "sourceTxHash", "type": "bytes32"},
+        {"internalType": "bytes", "name": "signature", "type": "bytes"}
+      ],
+      "name": "completeBridge",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "currentChainId",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "dailyLimit",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "requestId", "type": "uint256"}],
+      "name": "getBridgeRequest",
+      "outputs": [
+        {
+          "components": [
+            {"internalType": "uint256", "name": "id", "type": "uint256"},
+            {"internalType": "address", "name": "sender", "type": "address"},
+            {"internalType": "address", "name": "recipient", "type": "address"},
+            {"internalType": "uint256", "name": "amount", "type": "uint256"},
+            {"internalType": "uint256", "name": "sourceChain", "type": "uint256"},
+            {"internalType": "uint256", "name": "targetChain", "type": "uint256"},
+            {"internalType": "uint256", "name": "timestamp", "type": "uint256"},
+            {"internalType": "bytes32", "name": "txHash", "type": "bytes32"},
+            {"internalType": "uint8", "name": "status", "type": "uint8"}
+          ],
+          "internalType": "struct QVTXBridge.BridgeRequest",
+          "name": "",
+          "type": "tuple"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "address", "name": "user", "type": "address"}],
+      "name": "getUserBridgeRequests",
+      "outputs": [{"internalType": "uint256[]", "name": "", "type": "uint256[]"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "chainId", "type": "uint256"}],
+      "name": "isChainSupported",
+      "outputs": [{"internalType": "bool", "name": "", "type": "bool"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "maxBridgeAmount",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "minBridgeAmount",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "owner",
+      "outputs": [{"internalType": "address", "name": "", "type": "address"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "paused",
+      "outputs": [{"internalType": "bool", "name": "", "type": "bool"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "requestId", "type": "uint256"}],
+      "name": "refund",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "chainId", "type": "uint256"}],
+      "name": "removeChain",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "_fee", "type": "uint256"}],
+      "name": "setBridgeFee",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {"internalType": "uint256", "name": "_min", "type": "uint256"},
+        {"internalType": "uint256", "name": "_max", "type": "uint256"},
+        {"internalType": "uint256", "name": "_daily", "type": "uint256"}
+      ],
+      "name": "setLimits",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "bool", "name": "_paused", "type": "bool"}],
+      "name": "setPaused",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "address", "name": "_validator", "type": "address"}],
+      "name": "setValidator",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "address", "name": "newOwner", "type": "address"}],
+      "name": "transferOwnership",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "validator",
+      "outputs": [{"internalType": "address", "name": "", "type": "address"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "address payable", "name": "to", "type": "address"}],
+      "name": "withdrawFees",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {"stateMutability": "payable", "type": "receive"}
+  ]
+}

package/abis/QVTXGovernance.json

@@ -0,0 +1,267 @@
+{
+  "contractName": "QVTXGovernance",
+  "abi": [
+    {
+      "inputs": [{"internalType": "address", "name": "_qvtxToken", "type": "address"}],
+      "stateMutability": "nonpayable",
+      "type": "constructor"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {"indexed": false, "internalType": "string", "name": "param", "type": "string"},
+        {"indexed": false, "internalType": "uint256", "name": "value", "type": "uint256"}
+      ],
+      "name": "ConfigUpdated",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [{"indexed": true, "internalType": "uint256", "name": "id", "type": "uint256"}],
+      "name": "ProposalCanceled",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {"indexed": true, "internalType": "uint256", "name": "id", "type": "uint256"},
+        {"indexed": true, "internalType": "address", "name": "proposer", "type": "address"},
+        {"indexed": false, "internalType": "string", "name": "title", "type": "string"},
+        {"indexed": false, "internalType": "address", "name": "target", "type": "address"},
+        {"indexed": false, "internalType": "uint256", "name": "startBlock", "type": "uint256"},
+        {"indexed": false, "internalType": "uint256", "name": "endBlock", "type": "uint256"}
+      ],
+      "name": "ProposalCreated",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [{"indexed": true, "internalType": "uint256", "name": "id", "type": "uint256"}],
+      "name": "ProposalExecuted",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {"indexed": true, "internalType": "uint256", "name": "id", "type": "uint256"},
+        {"indexed": false, "internalType": "uint256", "name": "eta", "type": "uint256"}
+      ],
+      "name": "ProposalQueued",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {"indexed": true, "internalType": "address", "name": "voter", "type": "address"},
+        {"indexed": true, "internalType": "uint256", "name": "proposalId", "type": "uint256"},
+        {"indexed": false, "internalType": "uint8", "name": "support", "type": "uint8"},
+        {"indexed": false, "internalType": "uint256", "name": "votes", "type": "uint256"},
+        {"indexed": false, "internalType": "string", "name": "reason", "type": "string"}
+      ],
+      "name": "VoteCast",
+      "type": "event"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "proposalId", "type": "uint256"}],
+      "name": "cancel",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {"internalType": "uint256", "name": "proposalId", "type": "uint256"},
+        {"internalType": "uint8", "name": "support", "type": "uint8"}
+      ],
+      "name": "castVote",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {"internalType": "uint256", "name": "proposalId", "type": "uint256"},
+        {"internalType": "uint8", "name": "support", "type": "uint8"},
+        {"internalType": "string", "name": "reason", "type": "string"}
+      ],
+      "name": "castVoteWithReason",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "proposalId", "type": "uint256"}],
+      "name": "execute",
+      "outputs": [],
+      "stateMutability": "payable",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "proposalId", "type": "uint256"}],
+      "name": "getProposal",
+      "outputs": [
+        {
+          "components": [
+            {"internalType": "uint256", "name": "id", "type": "uint256"},
+            {"internalType": "address", "name": "proposer", "type": "address"},
+            {"internalType": "string", "name": "title", "type": "string"},
+            {"internalType": "string", "name": "description", "type": "string"},
+            {"internalType": "uint256", "name": "forVotes", "type": "uint256"},
+            {"internalType": "uint256", "name": "againstVotes", "type": "uint256"},
+            {"internalType": "uint256", "name": "abstainVotes", "type": "uint256"},
+            {"internalType": "uint256", "name": "startBlock", "type": "uint256"},
+            {"internalType": "uint256", "name": "endBlock", "type": "uint256"},
+            {"internalType": "bool", "name": "executed", "type": "bool"},
+            {"internalType": "bool", "name": "canceled", "type": "bool"},
+            {"internalType": "uint8", "name": "state", "type": "uint8"}
+          ],
+          "internalType": "struct QVTXGovernance.ProposalInfo",
+          "name": "",
+          "type": "tuple"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "proposalId", "type": "uint256"}],
+      "name": "getProposalState",
+      "outputs": [{"internalType": "uint8", "name": "", "type": "uint8"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {"internalType": "uint256", "name": "proposalId", "type": "uint256"},
+        {"internalType": "address", "name": "voter", "type": "address"}
+      ],
+      "name": "getReceipt",
+      "outputs": [
+        {
+          "components": [
+            {"internalType": "bool", "name": "hasVoted", "type": "bool"},
+            {"internalType": "uint8", "name": "support", "type": "uint8"},
+            {"internalType": "uint256", "name": "votes", "type": "uint256"}
+          ],
+          "internalType": "struct QVTXGovernance.Receipt",
+          "name": "",
+          "type": "tuple"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "owner",
+      "outputs": [{"internalType": "address", "name": "", "type": "address"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "proposalCount",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "proposalThreshold",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {"internalType": "string", "name": "title", "type": "string"},
+        {"internalType": "string", "name": "description", "type": "string"},
+        {"internalType": "address", "name": "target", "type": "address"},
+        {"internalType": "uint256", "name": "value", "type": "uint256"},
+        {"internalType": "bytes", "name": "callData", "type": "bytes"}
+      ],
+      "name": "propose",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "proposalId", "type": "uint256"}],
+      "name": "queue",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "quorumVotes",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "qvtxToken",
+      "outputs": [{"internalType": "address", "name": "", "type": "address"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "_threshold", "type": "uint256"}],
+      "name": "setProposalThreshold",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "_quorum", "type": "uint256"}],
+      "name": "setQuorumVotes",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "_delay", "type": "uint256"}],
+      "name": "setTimelockDelay",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [{"internalType": "uint256", "name": "_period", "type": "uint256"}],
+      "name": "setVotingPeriod",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "timelockDelay",
+      "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": [],
+      "name": "votingDelay",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "votingPeriod",
+      "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {"stateMutability": "payable", "type": "receive"}
+  ]
+}