privacy/env.example at main · Mirokugang/privacy · 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
109
110
111
112
113
114
# GhostSOL Environment Configuration
#
# Copy this file to .env and fill in your values
# NEVER commit .env files to version control
#
# Security Note:
# - Variables prefixed with NEXT_PUBLIC_ are exposed to the browser
# - Server-only variables (without NEXT_PUBLIC_) are only available server-side
# - Private keys and API keys should NEVER be prefixed with NEXT_PUBLIC_

# =============================================================================
# Required Configuration
# =============================================================================

# Solana cluster (devnet or mainnet-beta)
# For Next.js apps, use NEXT_PUBLIC_CLUSTER for client-side access
SOLANA_CLUSTER=devnet
NEXT_PUBLIC_CLUSTER=devnet

# Solana RPC endpoint URL
# For Next.js apps, use NEXT_PUBLIC_RPC_URL for client-side access
SOLANA_RPC_URL=https://api.devnet.solana.com
NEXT_PUBLIC_RPC_URL=https://api.devnet.solana.com

# =============================================================================
# Optional Configuration
# =============================================================================

# Fallback RPC endpoint (used if primary fails)
SOLANA_RPC_URL_FALLBACK=https://api.mainnet-beta.solana.com

# =============================================================================
# RPC Provider Configuration (Production-Grade)
# =============================================================================

# Helius RPC Configuration
# Helius provides reliable RPC services with ZK Compression support
# Get your API key at: https://www.helius.dev/
HELIUS_API_KEY=your-helius-api-key-here
RPC_PRIORITY_HELIUS=1

# QuickNode RPC Configuration (optional)
# Get your endpoint at: https://www.quicknode.com/
# QUICKNODE_ENDPOINT=https://your-endpoint.quiknode.pro/your-token/
# QUICKNODE_API_KEY=your-quicknode-api-key (optional)
# RPC_PRIORITY_QUICKNODE=2

# Alchemy RPC Configuration (optional)
# Get your API key at: https://www.alchemy.com/
# ALCHEMY_API_KEY=your-alchemy-api-key
# RPC_PRIORITY_ALCHEMY=3

# Triton RPC Configuration (optional)
# Get your endpoint at: https://triton.one/
# TRITON_ENDPOINT=https://your-endpoint.rpcpool.com
# TRITON_API_KEY=your-triton-api-key (optional)
# RPC_PRIORITY_TRITON=4

# Custom RPC Configuration (optional)
# Use this for any other RPC provider
# CUSTOM_RPC_URL=https://your-custom-rpc.com
# CUSTOM_RPC_API_KEY=your-custom-api-key (optional)
# CUSTOM_RPC_SUPPORTS_ZK=false
# RPC_PRIORITY_CUSTOM=5

# =============================================================================
# RPC Infrastructure Settings
# =============================================================================

# Enable RPC health checking (default: true)
RPC_ENABLE_HEALTH_CHECK=true

# Enable rate limiting (default: true)
RPC_ENABLE_RATE_LIMITING=true

# Enable RPC metrics collection (default: true)
RPC_ENABLE_METRICS=true

# =============================================================================
# Security-Sensitive Variables (NEVER commit to version control)
# =============================================================================

# Private key for wallet operations (NEVER use NEXT_PUBLIC_ prefix)
# Format: Base58 encoded private key
# WARNING: Only set this in secure server environments
# PRIVATE_KEY=your-private-key-here

# Auditor key for viewing keys (privacy features)
# WARNING: Only set this in secure server environments
# AUDITOR_KEY=your-auditor-key-here

# Encryption keys for privacy features
# WARNING: Only set this in secure server environments
# ENCRYPTION_KEY=your-encryption-key-here

# =============================================================================
# Production Configuration
# =============================================================================

# In production, ensure:
# - All RPC URLs use HTTPS (HTTP is not allowed in production)
# - Sensitive variables are only set server-side
# - Environment is set to production
# NODE_ENV=production

# =============================================================================
# Development Tips
# =============================================================================

# 1. Copy this file: cp env.example .env
# 2. Fill in required values
# 3. Never commit .env to git (already in .gitignore)
# 4. For Next.js apps, use NEXT_PUBLIC_ prefix for client-side variables only
# 5. Test your configuration before deploying