Environments

Environment Types

Required Environment Variables

Core

# Database
DATABASE_URL=postgresql://posit:posit_dev@localhost:5434/posit

# AWS (LocalStack in development)
AWS_REGION=us-east-1
AWS_ENDPOINT_URL=http://localhost:4576
AWS_ACCESS_KEY_ID=test
AWS_SECRET_ACCESS_KEY=test

Solana (Required)

# Helius API - Required for Solana parsing
HELIUS_API_KEY=your_helius_key
SOLANA_RPC_URL=https://mainnet.helius-rpc.com/?api-key=YOUR_KEY

Multi-Chain (Optional)

# Base Chain
BASE_RPC_URL=https://base-mainnet.g.alchemy.com/v2/YOUR_KEY
ALCHEMY_API_KEY=your_alchemy_key

# Hyperliquid
HYPERLIQUID_API_URL=https://api.hyperliquid.xyz
HYPERLIQUID_WS_URL=wss://api.hyperliquid.xyz/ws

Authentication

# Privy - Sign-in-with-Solana
PRIVY_APP_ID=your_app_id
PRIVY_APP_SECRET=your_app_secret

# Security
ENCRYPTION_MASTER_KEY=your_32_byte_hex_key  # For wallet-user mapping encryption
WEBHOOK_SIGNING_SECRET=your_webhook_secret  # For webhook signature verification

Pricing APIs

# Token pricing
BIRDEYE_API_KEY=your_birdeye_key  # Fallback pricing API

Payments (Optional)

# Lemon Squeezy
LEMON_SQUEEZY_API_KEY=your_key
LEMON_SQUEEZY_WEBHOOK_SECRET=your_webhook_secret

Secrets Management

Production secrets are stored in AWS Secrets Manager with the posit/ prefix.

Secret Names

Seeding Local Secrets

# Seed LocalStack with test secrets
pnpm --filter @posit/cli init-secrets

# List all secrets
pnpm --filter @posit/cli init-secrets --list

# Get a secret value
pnpm --filter @posit/cli init-secrets --get api-keys/helius

Port Mapping

Local services use non-standard ports to avoid conflicts:

Local DNS

For testing hostname-based routing, add entries to /etc/hosts:

# Run setup script
sudo ./scripts/setup-hosts.sh

# Or manually add:
127.0.0.1 positlabs.local
127.0.0.1 api.positlabs.local
127.0.0.1 app.positlabs.local
127.0.0.1 minio.positlabs.local

Getting API Keys