Every error produced by the Torvyn CLI and runtime includes a unique error code, a description of what went wrong, the location where it occurred, why it is an error, and how to fix it. Error codes are stable across versions and searchable in documentation.
Range Category
E0001–E0099General errors (I/O, configuration, environment) E0100–E0199Contract and WIT errors E0200–E0299Linking and composition errors E0300–E0399Resource manager errors E0400–E0499Reactor and scheduling errors E0500–E0599Security and capability errors E0600–E0699Packaging and distribution errors E0700–E0799Configuration errors
Code Name Cause Fix
E0001ManifestNotFoundTorvyn.toml not found at the specified or default path.Run torvyn init to create a project, or specify --manifest <PATH>. E0002ManifestParseErrorTorvyn.toml contains invalid TOML syntax.Check the indicated line and column for syntax errors. E0003DirectoryExistsTarget directory for torvyn init already exists and is not empty. Use --force to overwrite, or choose a different name. E0010ToolchainMissingA required external tool (cargo-component, wasm-tools, etc.) was not found. Run torvyn doctor for installation instructions.
Code Name Cause Fix
E0100WitSyntaxErrorA .wit file contains a syntax error. Check the indicated file, line, and column. E0101WitResolutionErrorA use statement or package reference could not be resolved. Ensure the referenced package exists in wit/deps/. Run torvyn init or re-vendor dependencies. E0102WorldIncompleteThe component’s world does not export any Torvyn processing interface. Add an export for at least one of: processor, source, sink, filter, router, aggregator. E0103CapabilityMismatchWIT imports require a capability that is not declared in the manifest. Add the required capability to [capabilities.required] in Torvyn.toml. E0110DeprecatedContractVersionThe targeted contract version is deprecated. Upgrade to a supported contract version.
Code Name Cause Fix
E0200InterfaceIncompatibleAn upstream component’s output type is incompatible with the downstream component’s input type. Ensure both components target compatible contract versions. E0201VersionMismatchComponents target different major versions of the same contract package. Recompile one or both components against a compatible contract version. E0202CapabilityNotGrantedA required capability is not granted in the pipeline configuration. Add the capability to [security.grants.<component>]. E0203TopologyInvalidThe pipeline graph has structural errors (cycles, disconnected nodes, role violations). Review the flow definition. Sources must have no inputs. Sinks must have no outputs. The graph must be a DAG. E0204RouterPortUnknownA router returned a port name that does not match any downstream connection. Verify router port names match the edge definitions in the flow topology. E0210ComponentNotFoundA component referenced in the flow definition could not be located. Check the component path in the flow node definition. Run torvyn build first.
Code Name Cause Fix
E0300AllocationFailedBuffer allocation failed (pool exhausted and system allocator failed). Increase pool sizes or reduce component memory budgets. E0301PoolExhaustedBuffer pool for the requested tier is empty. Increase pool size for the affected tier, or switch exhaustion policy to fallback-alloc. E0302NotOwnerA component attempted to access a buffer it does not own. This indicates a contract or runtime bug. Report the issue. E0303StaleHandleA component used a buffer handle that has been invalidated (wrong generation). This indicates a use-after-free pattern in component code. Review component logic. E0304BorrowsOutstandingAttempted to transfer or free a buffer while borrows are still active. Ensure all borrows are released before transferring ownership. E0305CapacityExceededA write to a mutable buffer would exceed its capacity. Allocate a larger buffer or write data in smaller chunks. E0310BudgetExceededA component exceeded its per-component memory budget. Increase max_memory_per_component or optimize component memory usage.
Code Name Cause Fix
E0400FlowDeadlineExceededThe flow exceeded its configured maximum execution time. Increase the timeout or investigate which component is slow. E0401ComponentTimeoutA single component invocation exceeded its per-call timeout. Increase fuel_per_invocation or optimize the component. E0402FlowCancelledThe flow was cancelled by operator command or fatal error. Check the cancellation reason in the flow trace. E0410FatalComponentErrorA component returned process-error::fatal. The component cannot process further elements. Review component logs for the cause.
Code Name Cause Fix
E0500CapabilityDeniedA component attempted to use a capability it was not granted. Grant the capability in [security.grants.<component>], or remove the capability use from the component. E0501SandboxViolationA component attempted an operation outside its sandbox. Review component code for disallowed operations. E0510AuditLogFailedThe audit log could not be written. Check audit log target configuration and disk space.
Code Name Cause Fix
E0600ArtifactInvalidThe packaged artifact failed validation. Run torvyn check before torvyn pack. E0601RegistryAuthFailedAuthentication with the OCI registry failed. Check registry credentials. E0602PushFailedThe artifact could not be pushed to the registry. Check network connectivity and registry availability. E0603SigningFailedArtifact signing failed. Check signing key configuration.
Code Name Cause Fix
E0700InvalidFieldTypeA configuration field has the wrong type. Check the field type in the configuration reference. E0701UnknownFieldAn unrecognized field name in Torvyn.toml. Check for typos. Refer to the configuration reference for valid field names. E0702ConstraintViolationA configuration value is outside its valid range. Check the valid range in the configuration reference.