cookie-jar/example.env at dev · greenpill-dev-guild/cookie-jar · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
# Cookie Jar Environment Configuration

# =============================================================================
# BLOCKCHAIN NETWORKS & RPC ENDPOINTS
# =============================================================================

# Alchemy API Key (works across all supported networks)
NEXT_PUBLIC_ALCHEMY_API_KEY=your_alchemy_api_key

# Moralis API Key (alternative NFT provider)
NEXT_PUBLIC_MORALIS_API_KEY=your_moralis_api_key

# =============================================================================
# NFT & METADATA SERVICES
# =============================================================================

# OpenSea API Key (for collection verification and floor prices)
NEXT_PUBLIC_OPENSEA_API_KEY=your_opensea_api_key

# Reservoir API Key (for NFT marketplace data)
NEXT_PUBLIC_RESERVOIR_API_KEY=your_reservoir_api_key

# IPFS Gateway Configuration
NEXT_PUBLIC_IPFS_GATEWAY=https://gateway.pinata.cloud/ipfs/
NEXT_PUBLIC_PINATA_JWT=your_pinata_jwt_for_uploads

# =============================================================================
# DEVELOPMENT & TESTING
# =============================================================================

# Enable debug mode for NFT validation
NEXT_PUBLIC_DEBUG_NFT_VALIDATION=false

# Mock NFT data in development (set to true to use mock data)
NEXT_PUBLIC_USE_MOCK_NFT_DATA=false

# NFT validation cache duration (minutes)
NEXT_PUBLIC_NFT_CACHE_DURATION=60

# Maximum NFTs to load per collection (performance limit)
NEXT_PUBLIC_MAX_NFTS_PER_COLLECTION=1000

# =============================================================================
# SECURITY & RATE LIMITING
# =============================================================================

# Rate limiting for NFT API calls (requests per minute)
NEXT_PUBLIC_API_RATE_LIMIT=60

# Timeout for NFT metadata fetching (milliseconds)
NEXT_PUBLIC_NFT_FETCH_TIMEOUT=10000

# Maximum concurrent NFT validation requests
NEXT_PUBLIC_MAX_CONCURRENT_VALIDATIONS=5

# =============================================================================
# ANALYTICS & MONITORING
# =============================================================================

# Enable NFT gating analytics
NEXT_PUBLIC_ENABLE_NFT_ANALYTICS=true

# Sentry DSN for error tracking
NEXT_PUBLIC_SENTRY_DSN=your_sentry_dsn


# =============================================================================
# CONTRACT DEPLOYMENT CONFIGURATION
# =============================================================================
# Production deployments use Foundry Keystore (SECURE)
# Import your account: cast wallet import deployer --interactive
KEYSTORE_ACCOUNT=deployer

# Local development only (NOT for production!)
# Only set this for local Anvil deployments
# PRIVATE_KEY=your_private_key_for_local_development_only

# Deployer address for reference (not used in deployment)
DEPLOYER_ADDRESS=your_deployer_address


# RPC URLs for deployment
ETHEREUM_RPC_URL=https://eth-mainnet.g.alchemy.com/v2/your_api_key
BASE_RPC_URL=https://base-mainnet.g.alchemy.com/v2/your_api_key
SEPOLIA_RPC_URL=https://eth-sepolia.g.alchemy.com/v2/your_api_key

# Etherscan API keys for contract verification
ETHERSCAN_API_KEY=your_etherscan_api_key

# =============================================================================
# USAGE INSTRUCTIONS
# =============================================================================

# 1. Copy this file to .env.local for local development
# 2. Replace placeholder values with your actual API keys
# 3. Never commit .env.local to version control
# 4. For production, set these as environment variables on your deployment platform

# REQUIRED for basic functionality:
# - NEXT_PUBLIC_ALCHEMY_API_KEY (at minimum)

# RECOMMENDED for full features:
# - NEXT_PUBLIC_OPENSEA_API_KEY (for collection verification)
# - NEXT_PUBLIC_PINATA_JWT (for IPFS uploads)

# OPTIONAL enhancements:
# - NEXT_PUBLIC_MORALIS_API_KEY (alternative NFT provider)
# - NEXT_PUBLIC_RESERVOIR_API_KEY (marketplace data)