x0x 0.19.46

Agent-to-agent gossip network for AI systems — no winners, no losers, just cooperation
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

//! GossipCacheAdapter integration tests.
//!
//! Verifies that the gossip cache adapter is properly wired into the Agent
//! and shares the same bootstrap cache.

use saorsa_gossip_coordinator::{AddrHint, CoordinatorAdvert, CoordinatorRoles, NatClass};
use saorsa_gossip_types::PeerId;
use tempfile::TempDir;
use x0x::network::NetworkConfig;
use x0x::Agent;

async fn agent_with_network() -> (Agent, TempDir) {
    let dir = TempDir::new().unwrap();
    let agent = Agent::builder()
        .with_machine_key(dir.path().join("machine.key"))
        .with_network_config(NetworkConfig {
            bind_addr: Some("0.0.0.0:0".parse().unwrap()),
            bootstrap_nodes: vec![],
            ..Default::default()
        })
        .with_peer_cache_dir(dir.path().join("peers"))
        .build()
        .await
        .unwrap();
    (agent, dir)
}

async fn agent_without_network() -> (Agent, TempDir) {
    let dir = TempDir::new().unwrap();
    let agent = Agent::builder()
        .with_machine_key(dir.path().join("machine.key"))
        .build()
        .await
        .unwrap();
    (agent, dir)
}

#[tokio::test]
async fn adapter_absent_without_network_config() {
    let (agent, _dir) = agent_without_network().await;
    assert!(agent.gossip_cache_adapter().is_none());
}

#[tokio::test]
async fn adapter_present_with_network_config() {
    let (agent, _dir) = agent_with_network().await;
    assert!(agent.gossip_cache_adapter().is_some());
}

#[tokio::test]
async fn adapter_insert_advert_enriches_cache() {
    let (agent, _dir) = agent_with_network().await;
    let adapter = agent.gossip_cache_adapter().unwrap();

    assert_eq!(adapter.advert_count(), 0);

    let peer_id = PeerId::new([42u8; 32]);
    let advert = CoordinatorAdvert::new(
        peer_id,
        CoordinatorRoles::default(),
        vec![AddrHint::new("127.0.0.1:5483".parse().unwrap())],
        NatClass::Unknown,
        60_000,
    );

    let inserted = adapter.insert_advert(advert).await;
    assert!(inserted);
    assert_eq!(adapter.advert_count(), 1);
    assert!(adapter.get_advert(&peer_id).is_some());
}

#[tokio::test]
async fn adapter_clone_shares_state() {
    let (agent, _dir) = agent_with_network().await;
    let adapter = agent.gossip_cache_adapter().unwrap().clone();
    let adapter2 = adapter.clone();

    let peer_id = PeerId::new([99u8; 32]);
    let advert = CoordinatorAdvert::new(
        peer_id,
        CoordinatorRoles::default(),
        vec![AddrHint::new("127.0.0.1:5483".parse().unwrap())],
        NatClass::Unknown,
        60_000,
    );

    adapter.insert_advert(advert).await;
    assert_eq!(adapter2.advert_count(), 1);
}

#[test]
fn advert_cbor_round_trip() {
    let peer_id = PeerId::new([7u8; 32]);
    let advert = CoordinatorAdvert::new(
        peer_id,
        CoordinatorRoles::default(),
        vec![AddrHint::new("10.0.0.1:5483".parse().unwrap())],
        NatClass::Eim,
        60_000,
    );

    let bytes = advert.to_bytes().unwrap();
    let decoded = CoordinatorAdvert::from_bytes(&bytes).unwrap();

    assert_eq!(decoded.peer, peer_id);
    assert!(decoded.is_valid());
    assert_eq!(decoded.addr_hints.len(), 1);
}