Nomos blockchain node
Go to file
Álex 739df1737a
feature(encoder): Implement Iterator over DaBlob for EncodedData (#952)
2024-12-19 18:40:18 +01:00
.cargo fix link flgs (#144) 2023-05-08 17:28:10 +02:00
.github fix: Codecov workflow output directory cleanup (#866) 2024-10-30 17:15:27 +08:00
book Add mdBook skeleton (#640) 2024-04-24 23:18:51 +09:00
ci CI: Update Rust 1.82 (#831) 2024-10-20 00:17:22 +09:00
clients/executor-http-client Cli: Dissemination and retrieval (#851) 2024-10-24 16:21:27 +03:00
consensus chore: cryptarchia unit tests update (#657) 2024-06-27 19:22:54 +02:00
ledger/nomos-ledger Move POL definition into nomos-core (#837) 2024-10-30 11:46:51 +01:00
nodes chore(dependencies): Update overwatch dependencies to enable instrument gating. (#965) 2024-12-19 18:08:39 +01:00
nomos-blend fix(blend): correctly check the last layer in `MockBlendMessage` (#957) 2024-12-19 17:15:05 +09:00
nomos-cli Cli: Deserialization and runtime fixes (#854) 2024-10-25 14:56:37 +03:00
nomos-core refactor: Replace remaining bincode calls with wire. (#946) 2024-12-18 17:37:41 +01:00
nomos-da feature(encoder): Implement Iterator over DaBlob for EncodedData (#952) 2024-12-19 18:40:18 +01:00
nomos-libp2p Mix: remove all of the previous mixnet stuff (#822) 2024-10-17 00:19:20 +09:00
nomos-services chore(dependencies): Update overwatch dependencies to enable instrument gating. (#965) 2024-12-19 18:08:39 +01:00
nomos-tracing Tracing: Otlp metrics (#909) 2024-11-07 04:25:20 +02:00
nomos-utils Mixnet v1 (#569) 2024-03-12 15:47:35 +09:00
proof_of_leadership/risc0/prover/src Move POL definition into nomos-core (#837) 2024-10-30 11:46:51 +01:00
testnet refactor(blend): rename `mix` to `blend` (#938) 2024-12-12 12:05:56 +09:00
tests chore(dependencies): Update overwatch dependencies to enable instrument gating. (#965) 2024-12-19 18:08:39 +01:00
.codecov.yml Disable codecov annotations (#409) 2023-09-15 15:11:50 +03:00
.dockerignore Docker image for nomos node (#60) 2023-02-01 10:37:15 +02:00
.env.example Testnet: Kzgrs config (#797) 2024-10-02 14:26:39 +03:00
.env.testnet Testnet: Kzgrs config (#797) 2024-10-02 14:26:39 +03:00
.gitignore Add clone and copy to CoverTrafficSettings (#911) 2024-11-07 06:40:22 +01:00
.pre-commit-config.yaml ci(pre-commit): config and docs (#942) 2024-12-12 12:13:24 +01:00
CONTRIBUTING.md ci(pre-commit): config and docs (#942) 2024-12-12 12:13:24 +01:00
Cargo.toml refactor(blend): rename `mix` to `blend` (#938) 2024-12-12 12:05:56 +09:00
Dockerfile CI: Update Rust 1.82 (#831) 2024-10-20 00:17:22 +09:00
README.md Tracing: Otlp metrics (#909) 2024-11-07 04:25:20 +02:00
compose.debug.yml Tracing: Otlp metrics (#909) 2024-11-07 04:25:20 +02:00
compose.static.yml Tracing: Otlp metrics (#909) 2024-11-07 04:25:20 +02:00
compose.yml Testnet: Kzgrs config (#797) 2024-10-02 14:26:39 +03:00
rustfmt.toml add rustfmt.toml (#118) 2023-04-19 15:59:51 +08:00
shell.nix CI: Rust 1.80 (#684) 2024-07-31 15:40:32 +03:00
sim_config.json.example Simulation initialization (#122) 2023-05-08 13:06:39 +03:00

README.md

nomos-node

Nomos blockchain node mvp

Project structure

  • nomos-core: Nomos core is the collection of essential structures for the Nomos mvp and experimental nodes.
  • nomos-services: Nomos services is the collection of components that are used as building blocks of the Nomos node prototype and the experimental nodes.
    • consensus
    • log
    • http
    • mempool
    • network
  • nodes: Nomos nodes is the collection of nodes that are used to run the Nomos mvp and experimental nodes.
    • nomos-node: main implementation of the Nomos mvp node.
    • mockpool-node: node with single mempool service, used to measure transaction dissemination.

Services

The Nomos node uses Overwatch as its main internal framework. This means that services request communication channels to other services to interchange information through a specified messaging API.

Service architecture

Most of the services are implemented with the same idea behind. There is a front layer responsible for handling the Overwatch service and a back layer that implements the actual service logic.

This allows us to easily replace components as needed in a type level system. In any case, a node can be setup in a declarative way composing the types. For example:

...
#[derive(Services)]
struct MockPoolNode {
    logging: ServiceHandle<Logger>,
    network: ServiceHandle<NetworkService<Waku>>,
    mockpool: ServiceHandle<MempoolService<WakuAdapter<Tx>, MockPool<TxId, Tx>>>,
    http: ServiceHandle<HttpService<AxumBackend>>,
    bridges: ServiceHandle<HttpBridgeService>,
}

Docker

To build and run a docker container with Nomos node run:

docker build -t nomos .
docker run nomos /etc/nomos/config.yml

To run a node with a different configuration run:

docker run -v /path/to/config.yml:/etc/nomos/config.yml nomos /etc/nomos/config.yml