Support IPFS and Onchain registry

.claude/settings.local.json

@@ -0,0 +1,40 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(forge install:*)",
+      "Bash(./scripts/startAnvil.sh:*)",
+      "Bash(cp:*)",
+      "Bash(source .env)",
+      "Bash(forge script:*)",
+      "Bash(cast call:*)",
+      "Bash(cast code:*)",
+      "Bash(pkill:*)",
+      "Bash(find:*)",
+      "Bash(bun run:*)",
+      "Bash(chmod:*)",
+      "Bash(cat:*)",
+      "Bash(grep:*)",
+      "Bash(bun add:*)",
+      "WebFetch(domain:docs.pinata.cloud)",
+      "Bash(ipfs config:*)",
+      "Bash(curl:*)",
+      "Bash(forge clean:*)",
+      "Bash(forge build:*)",
+      "Bash(cast sig:*)",
+      "Bash(./scripts/start-local-dev.sh:*)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:snapshot.mirror.xyz)",
+      "Bash(lsof:*)",
+      "Bash(mkdir:*)",
+      "Bash(bun install:*)",
+      "Bash(rg:*)",
+      "Bash(timeout:*)",
+      "WebFetch(domain:ai-docs.pinata.cloud)",
+      "WebSearch",
+      "Bash(git submodule:*)",
+      "Bash(npx tsc:*)"
+    ],
+    "deny": []
+  },
+  "outputStyle": "Explanatory"
+}

.env.example

@@ -0,0 +1,60 @@
+# ============================================
+# DEVELOPMENT ENVIRONMENT TEMPLATE
+# ============================================
+# Copy this file to .env for local development
+# For production, use .env.production.example
+
+# ============================================
+# PRIMARY CONFIGURATION (VITE)
+# ============================================
+
+# Blockchain Configuration
+VITE_QIP_REGISTRY_ADDRESS=0xf5D5CdccEe171F02293337b7F3eda4D45B85B233
+VITE_BASE_RPC_URL=http://localhost:8545
+VITE_USE_TESTNET=false
+VITE_WALLETCONNECT_PROJECT_ID=dummy-project-id
+
+# IPFS Configuration (Mai API is primary method)
+VITE_USE_MAI_API=true
+VITE_IPFS_API_URL=http://localhost:3001/v2/ipfs-upload
+
+# Mai API Configuration for QIP fetching
+VITE_MAI_API_URL=https://staging-api.mai.finance
+
+# Development Mode
+VITE_LOCAL_MODE=true
+VITE_USE_LOCAL_FILES=true
+
+# Snapshot Configuration
+VITE_SNAPSHOT_SPACE=qidao.eth
+
+# ============================================
+# FALLBACK IPFS PROVIDERS
+# ============================================
+
+# Local IPFS Node (optional)
+VITE_USE_LOCAL_IPFS=false
+VITE_LOCAL_IPFS_API=http://localhost:5001
+VITE_LOCAL_IPFS_GATEWAY=http://localhost:8080
+
+# Gateway for reading IPFS content
+VITE_PINATA_GATEWAY=https://gateway.pinata.cloud
+
+# Pinata group ID for organizing uploads (optional)
+# Leave empty to not use groups
+VITE_PINATA_GROUP_ID=
+
+# ============================================
+# DEPLOYMENT & SCRIPTS
+# ============================================
+
+# Development only - Use keystore for production!
+# PRIVATE_KEY=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
+
+# Development only - Use keystore for production!
+# PRIVATE_KEY=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
+
+# Store Basescan API key in ~/.foundry/foundry.toml:
+# [etherscan]
+# base = { key = "your_api_key_here" }
+

.env.production.example

@@ -0,0 +1,106 @@
+# ============================================
+# PRODUCTION ENVIRONMENT CONFIGURATION
+# ============================================
+# Copy this file to .env.production and fill in your values
+# NEVER commit .env.production to version control!
+
+# ============================================
+# DEPLOYMENT CONFIGURATION
+# ============================================
+
+# Deployment Methods (in order of security):
+# 1. Keystore (RECOMMENDED): Use ./scripts/setup-keystore.sh to configure
+# 2. Hardware Wallet: Use --ledger flag during deployment
+# 3. Private Key (NOT RECOMMENDED): Only for testing, never commit!
+
+# Optional: Hardware wallet address (if using Ledger)
+LEDGER_ACCOUNT=
+
+# Initial admin address (defaults to deployer if not set)
+INITIAL_ADMIN=
+
+# DEPRECATED - Use keystore or Foundry config instead
+# PRIVATE_KEY=
+# BASESCAN_API_KEY should be in ~/.foundry/foundry.toml
+
+# ============================================
+# NETWORK CONFIGURATION
+# ============================================
+
+# Base Mainnet RPC URL
+# Free options:
+#   - https://mainnet.base.org
+#   - https://base.llamarpc.com
+# Paid/Premium:
+#   - Alchemy: https://base-mainnet.g.alchemy.com/v2/YOUR_KEY
+#   - Infura: https://base-mainnet.infura.io/v3/YOUR_KEY
+BASE_RPC_URL=https://mainnet.base.org
+
+# ============================================
+# CONTRACT ADDRESSES (Updated after deployment)
+# ============================================
+
+# QIP Registry contract address (will be set after deployment)
+# Expected: 0x74a1EAA17Ce5418D24BE637C7d61f3732d4b0a27 (for deployer 0x93798Ef7e3A621d7C4EfF22eDA50B931fE57a3cF)
+VITE_QIP_REGISTRY_ADDRESS=
+
+
+# ============================================
+# FRONTEND CONFIGURATION
+# ============================================
+
+# Base Network Configuration
+VITE_BASE_RPC_URL=https://mainnet.base.org
+VITE_USE_TESTNET=false
+VITE_USE_LOCAL_FILES=false
+VITE_LOCAL_MODE=false
+
+# WalletConnect Project ID (required for production)
+# Get from: https://cloud.walletconnect.com/
+VITE_WALLETCONNECT_PROJECT_ID=
+
+# Snapshot Space Configuration
+# The Snapshot space to submit proposals to (e.g., qidao.eth)
+VITE_SNAPSHOT_SPACE=qidao.eth
+
+# ============================================
+# IPFS CONFIGURATION
+# ============================================
+
+# Mai API Configuration (primary IPFS method)
+VITE_USE_MAI_API=true
+VITE_IPFS_API_URL=https://your-mai-api-endpoint.com/v2/ipfs-upload
+
+# Mai API Configuration for QIP fetching
+# The API provides 24x performance improvement (1 second vs 24.5 seconds)
+# The API caches QIP data and serves it much faster than direct blockchain queries
+VITE_MAI_API_URL=https://staging-api.mai.finance
+
+# Fallback IPFS options (optional)
+VITE_USE_LOCAL_IPFS=false
+VITE_LOCAL_IPFS_API=
+VITE_LOCAL_IPFS_GATEWAY=
+
+# Gateway for reading IPFS content
+VITE_PINATA_GATEWAY=https://gateway.pinata.cloud
+
+# Pinata group ID for organizing QIP uploads (optional)
+# Create a group at https://app.pinata.cloud/ipfs/groups
+VITE_PINATA_GROUP_ID=
+
+
+# ============================================
+# GITHUB ACTIONS SECRETS
+# ============================================
+# After deployment, set these as GitHub Secrets:
+# - QIP_REGISTRY_ADDRESS: The deployed contract address
+# - BASE_RPC_URL: Your Base RPC endpoint  
+# - WALLETCONNECT_PROJECT_ID: Your WalletConnect project ID
+# - PINATA_GATEWAY: Your Pinata gateway (if using)
+
+# ============================================
+# FOUNDRY CONFIGURATION
+# ============================================
+# Store Basescan API key in ~/.foundry/foundry.toml:
+# [etherscan]
+# base = { key = "your_api_key_here" }