Struct Node 

pub struct Node {
    pub data: Map<String, Value>,
    pub meta: Map<String, Value>,
}

A node in the Gun graph

Nodes are the fundamental data structure in Gun. Each node has:

• data: Key-value pairs storing the actual data
• meta: Metadata including the soul (#) and state timestamps (>)

Nodes are identified by their “soul” (stored in meta["#"]), which is a unique identifier generated by GunCore::uuid.

State information is stored in meta[">"] as a map from key to timestamp.

Example

use gun::state::Node;
use serde_json::json;

let mut node = Node::with_soul("user_123".to_string());
node.data.insert("name".to_string(), json!("Alice"));
node.data.insert("age".to_string(), json!(30));

Fields

data: Map<String, Value>

meta: Map<String, Value>

Implementations

impl Node

pub fn new() -> Self

Create a new empty node without a soul

The soul will need to be set later using meta.insert("#", ...).

pub fn with_soul(soul: String) -> Self

Create a new node with a specific soul

Arguments

• soul - The unique identifier for this node

Example

use gun::state::Node;

let node = Node::with_soul("user_123".to_string());

pub fn get_soul(&self) -> Option<String>

Get the soul (unique identifier) of this node

Returns None if the node doesn’t have a soul set.

Returns

The soul string, or None if not set.

Example

use gun::state::Node;

let node = Node::with_soul("user_123".to_string());
assert_eq!(node.get_soul(), Some("user_123".to_string()));

Trait Implementations

impl Clone for Node

fn clone(&self) -> Node

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Node

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

Formats the value using the given formatter.

impl Default for Node

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Node

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Node

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.