The plugin’s interface_hash does not match the expected hash set on PluginHostBuilder::interface_hash(). The plugin was compiled against a different version of the interface trait (method signatures changed).
Fields
got: u64, expected: u64 (displayed as hex).
Resolution
Rebuild the plugin against the current version of the interface crate. Only changes to required method signatures affect the hash.
The .sig file exists but the Ed25519 signature does not verify against any trusted key. The dylib may have been tampered with, or was signed with an untrusted key.
Fields
path: String.
Resolution
Re-sign the plugin with a trusted key, or add the signing key to the host’s trusted keys.
Output deserialization failed after a successful FFI call (STATUS_OK), or PluginError deserialization failed when handling STATUS_PLUGIN_ERROR.
Fields
String – error description.
Resolution
Ensure the output type parameter O matches the type the plugin method actually returns. Both host and plugin always use bincode, so type mismatch is the usual cause.
The plugin returned STATUS_BUFFER_TOO_SMALL (-1). Only used with the Arena buffer strategy — the host retries once with a larger buffer before surfacing this error. The retry is automatic, so CallError::BufferTooSmall usually indicates a bug in the plugin’s size reporting or a pathological case (output larger than the arena max). PluginAllocated plugins never return this status.
Fields
None.
Resolution
Check the plugin’s Arena write logic: it must report the required byte count in *out_cap when returning STATUS_BUFFER_TOO_SMALL, and must succeed on the retry with that size.
method not implemented (capability bit {bit} not set)
Trigger
An optional method was called but the plugin does not implement it (the corresponding capability bit is not set). This variant is reserved for that exact case — not for out-of-range method indices (see InvalidMethodIndex).
Fields
bit: u32 – the capability bit index.
Resolution
Check PluginHandle::has_capability(bit) before calling optional methods. Use a plugin that implements the required optional method.
invalid method index {index} (plugin has {count} method(s))
Trigger
call_method was invoked with a method index greater than or equal to the plugin’s method_count. Indicates a programming error in the caller (typo, stale constant, wrong plugin).
Fields
index: usize – the index passed. count: u32 – the plugin’s actual method count.
Resolution
Fix the caller. Use the METHOD_* constants from the interface’s generated companion module rather than hard-coded indices.
Business logic error returned by plugin method implementations. Defined in fidius_core::error. Serialized across the FFI boundary. Implements std::error::Error (via thiserror), so it composes with standard Rust error handling (?, anyhow, etc.).
Optional structured details as a JSON string (stored as String rather than serde_json::Value for bincode compatibility – see Wire Format for rationale).
Create a PluginError with structured details. The serde_json::Value is serialized to a JSON string for storage — bincode cannot deserialize a free-form serde_json::Value directly (no deserialize_any), so storing it as a String keeps the error struct bincode-compatible.
The package.toml file contains invalid TOML syntax, is missing required [package] header fields, or the [metadata] section does not match the host-defined schema type M.
Fields
Inner toml::de::Error with line/column and field information.
Resolution
Fix the TOML syntax or add the missing fields. If using a typed schema, ensure the [metadata] section matches all required fields in the schema struct.