Variables de entorno

Nunca se commitean valores reales. Las variables sin valor por defecto se completan con tus propias credenciales. Lista completa en .env.example del backend.

CUSTODY_MASTER_SECRET, FILE_VAULT_SECRET y STELLAR_SECRET_KEY deben ser tres valores distintos entre sí.

Servidor y WhatsApp

Variable	Obligatoria	Descripción
`PORT`	No	Puerto del servidor (por defecto `3000`)
`NODE_ENV`	No	Entorno (`development` en `.env.example`)
`WHATSAPP_TOKEN`	Sí	Token de acceso de WhatsApp Cloud API
`WHATSAPP_PHONE_NUMBER_ID`	Sí	ID del número de teléfono de WhatsApp Business
`WHATSAPP_BUSINESS_ACCOUNT_ID`	No	ID de la cuenta de WhatsApp Business (está en `.env.example`; el runtime no la lee)
`WHATSAPP_API_VERSION`	No	Versión de la API (por defecto `v22.0`)
`VERIFY_TOKEN`	Sí	Token de verificación del webhook. En `.env.example` es `senda-verify-token`. Si está vacío, `GET /webhook` responde 403
`WHATSAPP_APP_SECRET`	Sí	App Secret de Meta; firma `X-Hub-Signature-256` del webhook. Sin este valor `POST /webhook` responde 403
`WHATSAPP_CLICK_TO_CHAT`	No	Número para el `wa.me` de regreso desde el alta web
`PUBLIC_BASE_URL`	No	URL pública del backend; Render setea `RENDER_EXTERNAL_URL` solo. Construye `/media/welcome.mp4` si no hay `WELCOME_VIDEO_URL`
`WELCOME_VIDEO_URL`	No	URL absoluta del video de bienvenida. Si no está, usamos `PUBLIC_BASE_URL` o `RENDER_EXTERNAL_URL` + `/media/welcome.mp4`

Stellar y USDC

Variable	Obligatoria	Descripción
`STELLAR_NETWORK`	Sí	Red de Stellar (`testnet`)
`STELLAR_HORIZON_URL`	Sí	Horizon (`https://horizon-testnet.stellar.org`)
`STELLAR_RPC_URL`	Sí	RPC de Soroban (`https://soroban-testnet.stellar.org`)
`STELLAR_FRIENDBOT_URL`	Sí (testnet)	Friendbot (`https://friendbot.stellar.org`)
`STELLAR_NETWORK_PASSPHRASE`	Sí	Passphrase de la red (`Test SDF Network ; September 2015`)
`STELLAR_CONTRACT_ID`	No	ID de SendaContract. Sin este valor no registramos el crédito en el contrato Soroban
`STELLAR_PUBLIC_KEY`	No	Clave pública de la cuenta operativa (está en `.env.example`; el runtime firma con `STELLAR_SECRET_KEY`)
`STELLAR_SECRET_KEY`	Sí	Clave secreta de la cuenta operativa
`STELLAR_TREASURY_SECRET_KEY`	No	Tesorería pooled. Si falta, usa `STELLAR_SECRET_KEY`
`USDC_SAC_CONTRACT_ID`	Sí	Stellar Asset Contract de USDC (`CDT2MY3QNV2RT2XULQWWXX2JELUWRWNXNKONCYG5MTIGZM7G5S2QNNGB`)
`USDC_CODE`	Sí	Código del activo (`USDC`)
`USDC_ISSUER`	Sí	Emisor del USDC (`GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5`)
`ENABLE_PUBLIC_CREDIT`	No	El crédito automático solo corre en testnet, salvo que esta variable sea `true` en red public

Custodia y wallets

Variable	Obligatoria	Descripción
`CUSTODY_MASTER_SECRET`	Sí	Secreto de la custodia invisible (SEP-30, fallback). Distinto de `STELLAR_SECRET_KEY`
`FILE_VAULT_SECRET`	Sí	Cifrado en reposo de códigos de retiro y wallets legado. Distinto de los otros dos secretos
`STELLAR_OFFRAMP_PUBLIC_KEY`	Sí	Cuenta `G…` del vault de retiro en efectivo; distinta de la cuenta operativa
`USE_PRIVY_WALLETS`	No	`false` mantiene la custodia SEP-30
`PRIVY_APP_ID`	Para Privy	ID de la app de Privy. Activa el flujo Privy (salvo `USE_PRIVY_WALLETS=false`)
`PRIVY_APP_SECRET`	Para Privy	Secreto de la app de Privy
`PRIVY_SESSION_SIGNER_ID`	Para Privy	Session signer delegado en `/setup`
`PRIVY_SESSION_SIGNER_PRIVATE_KEY`	Para Privy	Clave privada del session signer
`PRIVY_SPEND_POLICY_ID`	No	Policy de gasto del dashboard de Privy
`WEB_SETUP_PUBLIC_URL`	Para Privy	URL pública del mini sitio de alta
`WEB_SETUP_ORIGIN`	Para Privy	Origen permitido por CORS para el alta

Off-ramp y rendimiento

Variable	Obligatoria	Descripción
`SEP24_HOME_DOMAIN`	Sí	Dominio del ancla SEP-24 para el retiro a Mercado Pago (por defecto `testanchor.stellar.org`)
`BLEND_POOL_ID`	Sí	Pool de Blend en testnet para el rendimiento de USDC
`BLEND_USDC_SAC_ID`	No	SAC de USDC del pool Blend; si falta, usamos `USDC_SAC_CONTRACT_ID`
`BLEND_MAX_UTILIZATION`	No	Tope de uso del pool para aceptar depósitos (por defecto `0.85`)

Transcripción

Variable	Obligatoria	Descripción
`OPENAI_API_KEY`	Para notas de voz	Clave de OpenAI para `POST /v1/audio/transcriptions`
`OPENAI_TRANSCRIPTION_MODEL`	No	Modelo de transcripción (`whisper-1`)

Persistencia

Variable	Obligatoria	Descripción
`DATABASE_URL`	En Render	URI de Supabase (Transaction pooler, puerto 6543, `sslmode=require`). En local, SQLite (`data/senda.db`)
`SENDA_DATA_DIR`	No	Directorio de datos. Si no está, usamos `data/` bajo el cwd