Common Failure States
Representative failure states a user or integrator is most likely to encounter. Internal-only guards, deployment errors, and exhaustive revert coverage stay out of the public docs.
Common Failures
26| Error | Contract | Description |
|---|---|---|
| UserAlreadyExists() | Heliox | The owner account is already registered. |
| UserNotExists() | Heliox / HelioxRunner | The requested owner or vault is not enrolled for the action. |
| PlanDisabled() | Heliox | The selected plan is not available. |
| NotEnoughTokenForRegistration() | Heliox | The billing wallet does not hold enough fee token for registration. |
| NotEnoughTokenForReRegister() | Heliox | The billing wallet does not hold enough fee token for renewal. |
| NotEnoughToken() | Heliox | The billing wallet does not hold enough fee token for credit purchase. |
| CycleFeeFailed() | Heliox | The credit-purchase payment path failed. |
| NoCycleCredits() | Heliox / HelioxRunner | No cycle credits remain for the requested execution step. |
| NoActiveCycle() | Heliox / HelioxRunner | The action requires an active cycle. |
| BadTradePct() | Heliox | The requested max trade percentage is outside the supported range. |
| TooLargeSlippage() | Heliox | The requested slippage cap exceeds the current protocol limit. |
| VaultInfrastructureNotConfigured() | Heliox | Vault registry wiring has not been completed for this deployment. |
| VaultNotRegistered() | Heliox | The provided Safe vault is unknown to the Heliox vault registry. |
| VaultInactive() | Heliox | The provided Safe vault is registered but not active. |
| VaultNotOwnedByCaller() | Heliox | The caller is not the currently recognized owner of the Safe vault. |
| VaultOwnerControlDrift(address) | HelioxStorage | Heliox no longer sees the registry owner as the live 1-of-1 Safe controller, so vault actions fail closed. |
| VaultPoolUnavailable(bytes32) | HelioxStorage | The configured pool is not currently usable for vault execution. |
| VaultEngineUnavailable(bytes32,uint32) | HelioxStorage | The configured engine family or version is unavailable. |
| UnsupportedEngineSelection() | HelioxStorage | The chosen engine family/version is not allowed for the selected pool. |
| NotAllowed() | Heliox / HelioxLens | The caller is not authorized for the requested action. |
| GlobalPaused() | Heliox | Protocol execution is globally paused. |
| SubscriptionNotLive() | Heliox | The owner subscription is inactive or expired. |
| BadReferral() | Heliox | The referral address is invalid. |
| ReferrerAlreadySet() | HelioxReferralTreasury | The referral relationship is immutable after first registration. |
| OnlyHeliox() | HelioxPayments / HelioxReferralTreasury | The call is reserved for the Heliox core contract. |
| OnlyPayments() | HelioxReferralTreasury | The call is reserved for the Payments module. |