mirror of
https://github.com/logos-blockchain/logos-execution-zone.git
synced 2026-06-09 00:40:00 +00:00
4bcffafe27
BREAKING CHANGE:
- Crate `nssa` renamed to `lee`; update `Cargo.toml` dependencies from `nssa = { workspace = true }` to `lee = { workspace = true }`.
- Crate `nssa_core` renamed to `lee_core`; update similarly.
- Crate `key_protocol` moved under `lee`; update `Cargo.toml` dependencies from `key_protocol = { workspace = true }` to `lee_key_protocol = { workspace = true }`.
- Type `NSSATransaction` (in `common`) renamed to `LeeTransaction`.
- Error type `nssa::error::NssaError` renamed to `lee::error::LeeError`.
- Error type `nssa_core::error::NssaCoreError` renamed to `lee_core::error::LeeCoreError`.
- All `use nssa::` and `use nssa_core::` import paths must be updated to `use lee::` and `use lee_core::` respectively.
- Guest programs must replace `write_nssa_outputs` with `write_lee_outputs`.
- The sequencer RocksDB column family for the chain state was renamed. Existing databases are incompatible and must be wiped before running the new version.
- Domain separators updated: `"NSSA_seed"` → `"LEE_seed"` (key derivation), `"NSSA/v0.2/KDF-SHA256/"` → `"LEE/v0.2/KDF-SHA256/"` (encryption KDF), `"/NSSA/v0.2/AccountId/PDA/"` →
`"/LEE/v0.2/AccountId/PDA/"` (public PDA address derivation). All previously derived keys, encrypted outputs, and public PDA addresses are invalidated.
65 lines
1.8 KiB
Rust
65 lines
1.8 KiB
Rust
//! Error handling for the FFI layer.
|
|
//!
|
|
//! Uses numeric error codes with error messages printed to stderr.
|
|
|
|
/// Error codes returned by FFI functions.
|
|
#[repr(C)]
|
|
#[must_use]
|
|
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
|
|
pub enum WalletFfiError {
|
|
/// Operation completed successfully.
|
|
Success = 0,
|
|
/// A null pointer was passed where a valid pointer was expected.
|
|
NullPointer = 1,
|
|
/// Invalid UTF-8 string.
|
|
InvalidUtf8 = 2,
|
|
/// Wallet handle is not initialized.
|
|
WalletNotInitialized = 3,
|
|
/// Configuration error.
|
|
ConfigError = 4,
|
|
/// Storage/persistence error.
|
|
StorageError = 5,
|
|
/// Network/RPC error.
|
|
NetworkError = 6,
|
|
/// Account not found.
|
|
AccountNotFound = 7,
|
|
/// Key not found for account.
|
|
KeyNotFound = 8,
|
|
/// Insufficient funds for operation.
|
|
InsufficientFunds = 9,
|
|
/// Invalid account ID format.
|
|
InvalidAccountId = 10,
|
|
/// Tokio runtime error.
|
|
RuntimeError = 11,
|
|
/// Password required but not provided.
|
|
PasswordRequired = 12,
|
|
/// Block synchronization error.
|
|
SyncError = 13,
|
|
/// Serialization/deserialization error.
|
|
SerializationError = 14,
|
|
/// Invalid conversion from FFI types to LEE types.
|
|
InvalidTypeConversion = 15,
|
|
/// Invalid Key value.
|
|
InvalidKeyValue = 16,
|
|
/// Internal error (catch-all).
|
|
InternalError = 99,
|
|
}
|
|
|
|
impl WalletFfiError {
|
|
/// Check if it's [`WalletFfiError::Success`] or panic.
|
|
pub fn unwrap(self) {
|
|
let Self::Success = self else {
|
|
panic!("Called `unwrap()` on error value `{self:#?}`");
|
|
};
|
|
}
|
|
}
|
|
|
|
/// Log an error message to stderr.
|
|
#[expect(
|
|
clippy::print_stderr,
|
|
reason = "In FFI context it's better to print errors than to return strings"
|
|
)]
|
|
pub fn print_error(msg: impl Into<String>) {
|
|
eprintln!("[wallet-ffi] {}", msg.into());
|
|
}
|