tiny-world-builder/.env.example at main · jasonkneen/tiny-world-builder · 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
# Tiny World Builder — local development environment variables
# Copy to .env and fill in the values for your local setup.
# Lines starting with # are comments and are ignored.

# ---- Database ----
# Netlify Postgres connection string (set automatically by Netlify CLI / netlify dev).
# For local dev, run: npm run db:local (see docs/worlds.md for setup).
NETLIFY_DATABASE_URL=postgres://user:password@localhost:5432/tinyworld

# ---- Auth ----
# Secret for signing wallet session JWTs. Generate with:
#   node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
TINYWORLD_WALLET_SESSION_SECRET=

# Fallback wallet secret (used if TINYWORLD_WALLET_SESSION_SECRET is not set).
# TINYWORLD_AUTH_SECRET=

# ---- World economy ----
# Shared secret between this server and the PartyKit room (harvest grants).
# Must match the WORLDS_SERVICE_TOKEN in partykit.json / your PartyKit deploy.
WORLDS_SERVICE_TOKEN=

# HMAC secret for signed room join tokens (falls back to WORLDS_SERVICE_TOKEN).
# WORLDS_JOIN_SECRET=

# ---- Solana payments ----
# Solana public key that receives world purchase payments.
# Leave blank to disable world purchasing (worlds will be unclaimed-only).
TINYWORLD_PAYMENT_WALLET=

# $TINYWORLD token mint (drives holdings-based allowance GOLD). VERIFIED live on Solana
# mainnet: this is a Token-2022 token (program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb),
# 6 decimals. The reader (lib/solana.mjs tokenSummaryForOwner) was tested against it and
# returns correct balances via the {mint} filter. Until this is set in the Netlify env,
# wallet.mjs returns configured:false and every holdings read is 0.
# TINYWORLD_TOKEN_MINT=7bK4jRMa3aY85wJMQEQqWsmY9mmrRT32AFWZ23cBpump

# Production RPC — the default public mainnet RPC rate-limits hard. Set a Helius/QuickNode
# Production RPC -- the default public mainnet RPC rate-limits hard. Set a Helius/QuickNode
# (or similar) URL for the holdings reads to be reliable at scale.
# SOLANA_RPC_URL=

# ---- Optional integrations ----
# OpenAI API key for AI world generation (feature disabled when blank).
# OPENAI_API_KEY=

# LiveKit credentials for voice chat (feature disabled when blank).
# LIVEKIT_API_KEY=
# LIVEKIT_API_SECRET=
# LIVEKIT_WS_URL=

# ---- Netlify auto-set (do not set manually in prod) ----
# URL=https://your-site.netlify.app
# DEPLOY_PRIME_URL=
# DEPLOY_URL=

# ---- Dev/test only — NEVER set in production ----
# Skips on-chain payment verification so you can claim worlds locally.
# WORLDS_TEST_BYPASS_PAYMENT=1