Spectra
Parcourir la doc

troubleshooting

Erreurs courantes

Codes d'erreur émis par le desktop et le cloud worker, leur signification et la résolution.


Spectra expose chaque erreur avec un code stable. Les codes sont recherchables dans les logs, les tickets support et les diagnostics de l'éditeur de scripts.

Erreurs desktop

| Code | Signification | Résolution | |---|---|---| | E_GPU_INIT | Échec de sélection de l'adaptateur wgpu | Redémarrez ; si persiste, vérifiez que le driver GPU supporte Vulkan/Metal/DX12. | | E_BROKER_AUTH | Le broker a rejeté votre API key | Re-saisissez les credentials ; vérifiez que la key est read-write si vous tradez. | | E_SCRIPT_BUDGET | Script a dépassé son budget CPU/mémoire | Voir Sandbox ; simplifiez la boucle ou demandez un budget étendu. | | E_DATA_GAP | Le flux de données historiques a un gap sur la plage demandée | Une autre unité de temps fonctionne souvent ; rapportez si reproductible. | | E_WORKSPACE_CORRUPT | Le JSON du workspace sauvegardé n'a pas pu être parsé | Profil → Workspaces → Reset (ne supprime que ce workspace ; le reste reste). |

Erreurs du cloud worker

Apparaissent dans les réponses webhook et Profil → Webhooks → Activity.

| Code | HTTP | Signification | |---|---|---| | signature_invalid | 401 | Mismatch HMAC. Vérifiez que les bytes du body signés correspondent à ce que vous avez POSTé. | | timestamp_out_of_range | 401 | Décalage d'horloge de l'émetteur > 5 min. Vérifiez NTP. | | ip_not_allowed | 403 | L'allowlist vous exclut. Ajoutez l'IP source. | | cap_breached | 403 | Plafond de perte journalière franchi. Attendez le prochain 00:00 du timezone broker, ou resetez manuellement. | | secret_paused | 403 | Pausé par admin ou auto. Voir Activity pour la cause. | | idempotent_replay | 200 | Même client_id vu dans les 24 h. Renvoie le résultat d'origine. | | replay_attack | 409 | Même (timestamp, body) vu récemment. Bug d'émetteur ou attaque. | | rate_limited | 429 | > 1 req/sec/secret. Backoff. | | broker_rejected | 502 | Le broker a renvoyé non-2xx. Body inclut la raison. |

Erreurs de l'éditeur de scripts

Le compilateur VM bytecode émet des erreurs avec ligne + colonne. Les plus courantes :

  • type_mismatch — les opérandes n'ont pas de types compatibles. Inspectez les types inférés via Editor → Inspect (Cmd+I).
  • unbound_identifier — typo ou let manquant.
  • arity_error — mauvais nombre d'arguments à un built-in.
  • series_index_negativeseries[N] requiert N >= 0.

Rapport

Si une erreur se reproduit avec des étapes, écrivez à [email protected] en incluant le code, la version du build (Help → About → Copy diagnostic) et l'export de workspace si pertinent.