everscale-network   ![Latest Version] ![Workflow badge] ![License Apache badge] ![Docs badge]

Implementation of the network part of the Everscale blockchain.

Network stack

text ┌─────────────────────┐ │ Overlay │ - Overlay: Virtual subnetwork ┌──────────┼──────────┐ │ - DHT: Kademlia-like Distributed Hash Table │ DHT │ RLDP │ │ - RLDP: Reliable Large Datagram Protocol ├──────────┴──────────┴──────────┤ │ ADNL │ - ADNL: Abstract Data Network Layer ├────────────────────────────────┤ │ UDP │ - underlying transport protocol └────────────────────────────────┘

Example

```rust use std::net::SocketAddrV4;

use anyhow::Result; use everscalenetwork::{adnl, NetworkBuilder}; use tlproto::{TlRead, TlWrite};

[derive(TlWrite, TlRead)]

[tl(boxed, id = 0x11223344)]

struct MyCustomData { counter: u32, }

async fn example() -> Result<()> { const DHTKEYTAG: usize = 0;

// NOTE: our ip address must be accessible from other peers
let socket_addr = "1.2.3.4:10000".parse::<SocketAddrV4>()?;

// Create and fill keystore
let keystore = adnl::Keystore::builder()
    .with_tagged_key([1u8; 32], DHT_KEY_TAG)?
    .build();

// Create basic network parts
let (_adnl, dht) = NetworkBuilder::with_adnl(socket_addr, keystore, Default::default())
    .with_dht(DHT_KEY_TAG, Default::default())
    .build()?;

// Store some data in DHT
let stored = dht
    .entry(dht.key().id(), "some_value")
    .with_data(MyCustomData { counter: 0 })
    .with_ttl(3600)
    .sign_and_store(dht.key())?
    .then_check(|_, MyCustomData { counter }| Ok(counter == 0))
    .await?;
assert!(stored);

Ok(())

} ```

For more information you can check the docs or the examples.

Minimum Rust version

The current minimum required Rust version is 1.60.

License

This project is licensed under the [License Apache].