Errores comunes

Spectra expone cada error con un código estable. Los códigos son buscables en logs, tickets de soporte y diagnósticos del editor de scripts.

Errores del desktop

| Código | Significado | Resolución | |---|---|---| | E_GPU_INIT | Falló la selección del adaptador wgpu | Reinicia; si persiste, verifica que el driver de GPU soporte Vulkan/Metal/DX12. | | E_BROKER_AUTH | El bróker rechazó tu API key | Re-introduce credenciales; verifica que la key sea read-write si vas a tradear. | | E_SCRIPT_BUDGET | Script excedió presupuesto CPU/memoria | Ver Sandbox; simplifica el loop o pide presupuesto extendido. | | E_DATA_GAP | El feed de datos históricos tiene un gap en el rango pedido | Otro marco temporal suele funcionar; reporta el gap si reproducible. | | E_WORKSPACE_CORRUPT | El JSON del workspace guardado falló al parsear | Perfil → Workspaces → Reset (borra solo ese workspace; lo demás queda). |

Errores del cloud worker

Aparecen en respuestas de webhook y Perfil → Webhooks → Activity.

| Código | HTTP | Significado | |---|---|---| | signature_invalid | 401 | Mismatch HMAC. Verifica que los bytes del body que firmaste coincidan con los que POSTeaste. | | timestamp_out_of_range | 401 | Skew del reloj del emisor > 5 min. Revisa NTP. | | ip_not_allowed | 403 | La allowlist te excluye. Añade el IP de origen. | | cap_breached | 403 | Tope de pérdida diaria infringido. Espera al próximo 00:00 del timezone del bróker, o resetea manual. | | secret_paused | 403 | Pausado por admin o auto. Mira Activity para la causa. | | idempotent_replay | 200 | Mismo client_id visto en las últimas 24 h. Devuelve el resultado original. | | replay_attack | 409 | Mismo (timestamp, body) visto recién. Bug del emisor o ataque. | | rate_limited | 429 | > 1 req/seg/secret. Backoff. | | broker_rejected | 502 | El bróker devolvió no-2xx. Body incluye razón del bróker. |

Errores del editor de scripts

El compilador de la VM bytecode emite errores con línea + columna. Los más comunes:

• type_mismatch — los operandos no tienen tipos compatibles. Inspecciona los tipos inferidos vía Editor → Inspect (Cmd+I).
• unbound_identifier — typo o let faltante.
• arity_error — número de argumentos incorrecto a un built-in.
• series_index_negative — series[N] requiere N >= 0.

Reportando

Si un error reproduce con pasos, abre ticket en [email protected] incluyendo el código, la versión del build (Help → About → Copy diagnostic) y el export de workspace si es relevante.