Skip to main content

Synapse API

Synapses are persistent, weighted connections between nodes.

Synapse Fields

FieldTypeDescription
idSynapseIdUnique identifier
remote_nodeNodeIdConnected node
weightf32Current strength (0.0-1.0)
stateSynapseStateCurrent lifecycle state
transportTransportUnderlying transport
established_atu64Formation timestamp
last_activeu64Last signal timestamp
signals_transmittedu64Total sent
signals_receivedu64Total received
avg_latency_nsu64Average latency

SynapseState Enum

enum SynapseState {
    Forming,
    Active,
    Weakening,
    Dormant,
    Pruned,
}

Querying Synapses

// All synapses
let all = node.synapses().await?;

// Filter by state
let active = node.synapses()
    .filter(|s| s.state == SynapseState::Active)
    .await?;

// Find by remote node
let synapse = node.synapse_to(remote_node_id).await?;

Manual Synapse Management

// Force form a synapse
node.connect("ntl://remote-node:4433").await?;

// Force prune a synapse
node.disconnect(synapse_id).await?;