StellarKraal-/.env.example at main · teslims2/StellarKraal- · 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
# ============================================================
# StellarKraal — Environment Variables
# ============================================================
# Copy this file to .env and fill in values for local dev:
#   cp .env.example .env
#
# Variables marked [Required] must be set before the service
# will start. Variables marked [Optional] have safe defaults.
#
# Variables marked [GitHub Secret: NAME] must also be stored
# as GitHub Actions repository secrets (Settings → Secrets
# and variables → Actions) so CI/CD workflows can inject them.
# Never commit real secrets to version control.
# ============================================================


# ------------------------------------------------------------
# SHARED — used by both frontend and backend
# ------------------------------------------------------------

# Stellar network to connect to.
# Format : "testnet" | "mainnet"
# Required. [GitHub Secret: NEXT_PUBLIC_NETWORK]
NEXT_PUBLIC_NETWORK=testnet

# Soroban JSON-RPC endpoint for the chosen network.
# Format : HTTPS URL
# Required. [GitHub Secret: RPC_URL]
RPC_URL=https://soroban-testnet.stellar.org

# Deployed Soroban contract address (C... or G... format).
# Obtain this after running `stellar contract deploy`.
# Format : 56-character Stellar contract/account ID
# Required. [GitHub Secret: CONTRACT_ID]
CONTRACT_ID=CAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD2KM


# ------------------------------------------------------------
# FRONTEND — Next.js (NEXT_PUBLIC_* vars are bundled at build)
# ------------------------------------------------------------

# Base URL of the backend API, used by the Next.js frontend.
# Must be reachable from the browser in production.
# Format : HTTP(S) URL, no trailing slash
# Required. [GitHub Secret: NEXT_PUBLIC_API_URL]
NEXT_PUBLIC_API_URL=http://localhost:3001

# Public Soroban RPC URL exposed to browser-side SDK calls.
# Usually the same value as RPC_URL.
# Format : HTTPS URL
# Required. [GitHub Secret: NEXT_PUBLIC_RPC_URL]
NEXT_PUBLIC_RPC_URL=https://soroban-testnet.stellar.org


# ------------------------------------------------------------
# BACKEND — Node.js / Express API
# ------------------------------------------------------------

# TCP port the Express server listens on.
# Format : integer 1–65535
# Optional. Default: 3001
PORT=3001

# Node.js runtime environment. Controls logging verbosity,
# error detail, and certain security defaults.
# Format : "development" | "production" | "test"
# Optional. Default: development
NODE_ENV=development

# Logging
LOG_LEVEL=info                 # Log level: debug, info, warn, error (default: info)
LOG_MAX_SIZE=10m               # Max size per log file before rotation (e.g., 10m, 100m)
LOG_MAX_FILES=7                # Number of log files to retain; files older than this are deleted

# Database
DATABASE_URL=postgresql://user:password@localhost:5432/db

# Directory path where structured audit logs are written.
# If unset, audit logging is disabled.
# Format : absolute or relative filesystem path
# Optional.
# AUDIT_LOG_DIR=/var/log/stellarkraal/audit

# --- Database ---

# PostgreSQL connection URL. Omit for SQLite (development).
# Required in production (staging/prod use PostgreSQL).
# Format : postgresql://user:password@host:5432/dbname
# Optional (falls back to SQLite when unset). [GitHub Secret: DATABASE_URL]
# DATABASE_URL=postgresql://user:password@localhost:5432/stellarkraal


# ------------------------------------------------------------
# ALERTING — Slack & PagerDuty (backend alert dispatcher)
# ------------------------------------------------------------

# Slack incoming webhook URL for deployment and alert messages.
# Create one at https://api.slack.com/messaging/webhooks
# Format : https://hooks.slack.com/services/T.../B.../...
# Optional (Slack alerts disabled if unset). [GitHub Secret: SLACK_WEBHOOK_URL]
SLACK_WEBHOOK_URL=https://hooks.slack.com/services/YOUR/SLACK/WEBHOOK

# PagerDuty Events API v2 routing key for critical-severity alerts.
# Find this in PagerDuty under Services → Integrations.
# Format : 32-character alphanumeric string
# Optional (PagerDuty alerts disabled if unset). [GitHub Secret: PAGERDUTY_ROUTING_KEY]
PAGERDUTY_ROUTING_KEY=your-pagerduty-routing-key

# Stellar Network
STELLAR_NETWORK=testnet
STELLAR_RPC_URL=https://soroban-testnet.stellar.org
# Stellar Horizon API URL (used as fallback for account balance reads when Soroban RPC is unavailable)
# HORIZON_URL=https://horizon-testnet.stellar.org