Skip to main content
El panel de analíticas en l402kit.com/dashboard muestra estadísticas en tiempo real de todos los pagos que fluyen a través de tu API: total de sats recibidos, desglose por endpoint, tendencia de 7 días y transacciones recientes.

Configuración

El panel está protegido por un token secreto — DASHBOARD_SECRET. Lo generas una vez y lo almacenas donde guardas el resto de tus secretos.

1. Genera un secreto

openssl rand -hex 32
# → shdp_dash_a1b2c3d4e5f6...
O usa cualquier gestor de contraseñas para generar una cadena aleatoria robusta.

2. Configúralo en tu proveedor

Cloudflare Workers:
cd cloudflare/
wrangler secret put DASHBOARD_SECRET
# pega tu secreto cuando se te solicite
Node.js / otros:
# .env
DASHBOARD_SECRET=shdp_dash_a1b2c3d4e5f6...

3. Inicia sesión

Ve a l402kit.com/dashboard, introduce tu secreto y ya tienes acceso. Sin correo electrónico, sin OAuth, sin cookie — el secreto se envía como x-dashboard-secret en cada solicitud de estadísticas.

Qué verás

MétricaDescripción
Total de pagosConteo histórico de pagos L402 verificados
Total de satsSuma de todos los amount_sats de los pagos
Tendencia de 7 díasPagos y sats comparados con la ventana de 7 días anterior
Por endpointDesglose de qué rutas generaron qué ingresos
Últimos 20Pagos más recientes con hash, endpoint, monto y marca de tiempo

API

Los mismos datos están disponibles directamente a través de la API — útil para construir tu propio panel o enviar datos a Grafana.
curl https://l402kit.com/api/stats \
  -H "x-dashboard-secret: YOUR_SECRET"
{
  "totalPayments": 142,
  "totalSats": 14200,
  "shinydappsFee": 42,
  "trend": {
    "payments7d": 38,
    "payments7dPrev": 21,
    "sats7d": 3800,
    "sats7dPrev": 2100
  },
  "byOwner": {
    "you@blink.sv": { "count": 142, "sats": 14200 }
  },
  "recent": [...]
}

Modelo de seguridad

  • El secreto nunca sale de tu entorno — se compara del lado del servidor en el Cloudflare Worker usando igualdad estricta
  • No se emite ningún token de sesión — cada solicitud revalida el secreto
  • El secreto tiene acceso de solo lectura — únicamente puede llamar a /api/stats, no puede escribir ni eliminar datos
  • Genera un nuevo secreto en cualquier momento actualizando DASHBOARD_SECRET mediante wrangler secret put
Nunca confirmes DASHBOARD_SECRET en git. Agrégalo a tu .gitignore y usa wrangler secret put o el gestor de secretos de tu CI/CD.

Rotar el secreto

# Genera un nuevo secreto
openssl rand -hex 32

# Actualízalo en Cloudflare Workers
wrangler secret put DASHBOARD_SECRET

# Listo — el secreto anterior queda inmediatamente invalidado
No hay entradas de base de datos que actualizar. El Worker lee el secreto del entorno en cada solicitud.