#distributed #blockchain #framework #web3 #network

no-std tdn

Trusted Distributed Network. (Also a framework for building blockchain/web3 applications).

18 releases

new 0.10.3 Feb 24, 2024
0.10.2 Oct 17, 2023
0.10.1 Jun 26, 2023
0.10.0 Dec 27, 2022
0.0.1 Nov 4, 2019

#396 in Magic Beans

Download history 28/week @ 2023-11-03 35/week @ 2023-11-10 21/week @ 2023-11-17 39/week @ 2023-11-24 78/week @ 2023-12-01 9/week @ 2023-12-08 41/week @ 2023-12-15 50/week @ 2023-12-22 8/week @ 2023-12-29 7/week @ 2024-01-05 9/week @ 2024-01-12 46/week @ 2024-01-19 37/week @ 2024-01-26 30/week @ 2024-02-02 44/week @ 2024-02-09 366/week @ 2024-02-16

478 downloads per month
Used in tdn_permission


2.5K SLoC

crate doc


TDN: Let data transfer safely, make the network stable, secure, and highly available.

As the network interconnection, TDN includes peer-to-peer, centralized gateway, proxy & relay service, LAN, RPC, Near, etc.

As the framework of decentralized applications, TDN uses the Layer and Group models. We built this framework because we feel that the blockchain is very limited. If you want a more open and free distributed application development technology, and Pluggable, lightweight application framework, TDN can satisfy you.


use std::sync::Arc;
use tdn::prelude::*;
use tdn::types::rpc::{json, RpcError, RpcHandler, RpcParam};

struct State(u32);

async fn main() {
    let (peer_addr, send, mut out_recv) = start().await.unwrap();
    println!("Example: peer id: {:?}", peer_addr);

    let mut rpc_handler = RpcHandler::new(State(1));
    rpc_handler.add_method("say_hello", |_params: Vec<RpcParam>, state: Arc<State>| async move {
        assert_eq!(1, state.0);

    while let Some(message) = out_recv.recv().await {
        match message {
            ReceiveMessage::Own(msg) => match msg {
                RecvType::Connect(peer, _data) => {
                    println!("receive own peer {} join", peer.id.short_show());
                RecvType::Leave(peer) => {
                    println!("receive own peer {} leave", peer.id.short_show());
                RecvType::Event(peer_id, _data) => {
                    println!("receive own event from {}", peer_id.short_show());
                _ => {
                    println!("nerver here!")
            ReceiveMessage::Group(msg) => match msg {
                RecvType::Connect(peer, _data) => {
                    println!("receive group peer {} join", peer.id.short_show());
                RecvType::Result(..) => {
                RecvType::Leave(peer) => {
                    println!("receive group peer {} leave", peer.id.short_show());
                RecvType::Event(peer_id, _data) => {
                    println!("receive group event from {}", peer_id.short_show());
                _ => {}
            ReceiveMessage::Layer(fgid, _tgid, msg) => match msg {
                RecvType::Connect(peer, _data) => {
                    println!("Layer Join: {}, Addr: {}.", fgid, peer.id.short_show());
                RecvType::Result(..) => {
                _ => {}
            ReceiveMessage::Rpc(uid, params, is_ws) => {
                if let Ok(HandleResult {
                    mut rpcs,
                    owns: _,
                    groups: _,
                    layers: _,
                    networks: _,
                }) = rpc_handler.handle(params).await
                    loop {
                        if rpcs.len() != 0 {
                            let msg = rpcs.remove(0);
                            send.send(SendMessage::Rpc(uid, msg, is_ws))
                                .expect("TDN channel closed");
                        } else {
            ReceiveMessage::NetworkLost => {
                println!("No network connections");
  • install lastest Rust and cd ./tdn
  • cargo run --example simple Congratulation, you are running a trusted distributed network :)

more sample


  • Support different data structures
  • Support different consensus algorithms
  • Support different permission mechanisms
  • Support different account systems
  • Applications can communicate with others
  • Trust can be passed on and accumulated

4-type Applications

TDN can build 4-type network for applications. Use feature to control. (Tip: one group, is one chain, is one application)

  • single. Support only one group, and no layers. Like Bitcoin.
  • std (default). Support only one group, and multiple layers (cross-chain, Interactive with other groups).
  • multiple. Support many groups (in one runtime, support many applications), and no layers. Like Ethereum.
  • full. Support many groups, and multiple layers.


TDN with future

TDN Groups And Layers

Pluggable library

  • tdn-did decentralized identity.
  • tdn-storage Storage library, include Local file, Local db, Distributed db, Decentralized db.
  • tdn-permission Group permission library, include permissioned & permissionless group algorithm.

For more information, please visit:

Core QA

  1. What is Layers & Groups? Simply Group is application, one application is one group, Layer is communication between apps. In the Group, users can define everything. The Layer is divided into upper and lower, upper is this application depends on others, lower is others depends on this. If app is an independent application that does not interact with other applications, then you can completely ignore Layer.

  2. Different consensus? Consensus is expensive. Not all applications require global consensus to be used. Local consensus can speed up the usability of applications. Local consensus can be different. Users can define self-consensus in different applications. The results of the consensus can also be sent to different applications through the layer. In this way, the consensus results can be passed to the upper layer. After the upper layer consensus is obtained, a larger range and stronger consensus irreversible result can be formed.

  3. Different permission? Why do we need a different permission mechanism? Because in different applications, some applications require an open permissionless environment, such as Bitcoin, and some require a permissioned environment. For example, We built a synchronization which is distributed between my own devices is inaccessible to outsiders. At the same time, Layer supports applications in different permission environments, allowing data interaction.

  4. Different block & transaction data structure? Similarly, different applications have completely different data structures. Therefore, in the TDN, we use a common byte stream format. Users can customize the data format of the application. The communication with the TDN is only serialization and deserialization.

  5. Different account system? In the TDN, there will be a default p2p network address (PeerId) in the p2p system. The user can use the PeerId to replace the ip address. The TDN will search the PeerId in the network and establish a connection. At the same time, the user can also Fully customize the account model and connection verification method of the application.


This project is licensed under either of

at your option.


~619K SLoC