Enum GunError 

pub enum GunError {
    InvalidData(String),
    Storage(Error),
    Serialization(Error),
    Network(String),
    InvalidSoul(String),
    NodeNotFound,
    Io(Error),
    UrlParseError(ParseError),
    WebRTC(String),
    Crypto(String),
}

Main error type for all Gun operations

All operations in Gun return GunResult<T> which is Result<T, GunError>. This enum covers all possible error conditions that can occur.

Error Variants

• InvalidData(String): Data format is invalid or doesn’t match expected structure
• Storage(#[from] sled::Error): Storage operation failed (disk full, corruption, etc.)
• Serialization(#[from] serde_json::Error): JSON serialization/deserialization failed
• Network(String): Network operation failed (connection lost, timeout, etc.)
• InvalidSoul(String): Soul (node ID) format is invalid
• NodeNotFound: Requested node doesn’t exist in the graph
• Io(#[from] std::io::Error): I/O operation failed (file read/write, etc.)
• UrlParseError(#[from] url::ParseError): URL parsing failed (invalid peer URL)
• WebRTC(String): WebRTC operation failed (connection, signaling, etc.)
• Crypto(String): Cryptographic operation failed (encryption, signing, etc.)

Error Handling

All errors implement std::error::Error and can be:

• Converted to strings with to_string() or Display trait
• Used with ? operator for error propagation
• Matched with pattern matching

Example

use gun::{Gun, GunError};
use serde_json::json;
 
let gun = Gun::new();
 
// Operations return GunResult
let result = gun.get("test").put(json!({"data": 42})).await;
 
match result {
    Ok(chain) => println!("Success: {:?}", chain),
    Err(GunError::Storage(e)) => eprintln!("Storage error: {}", e),
    Err(GunError::Network(msg)) => eprintln!("Network error: {}", msg),
    Err(e) => eprintln!("Other error: {}", e),
}

Variants

InvalidData(String)

Invalid data format or structure

Storage(Error)

Storage operation failed (from sled database)

Serialization(Error)

JSON serialization/deserialization failed

Network(String)

Network operation failed (connection, timeout, etc.)

InvalidSoul(String)

Invalid soul (node ID) format

NodeNotFound

Requested node not found in graph

Io(Error)

I/O operation failed (file operations, etc.)

UrlParseError(ParseError)

URL parsing failed (invalid peer URL format)

WebRTC(String)

WebRTC operation failed (connection, signaling, etc.)

Crypto(String)

Cryptographic operation failed (encryption, signing, etc.)

Trait Implementations

impl Debug for GunError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for GunError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for GunError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for GunError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for GunError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for GunError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for GunError

fn from(source: ParseError) -> Self

Converts to this type from the input type.