Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
73 commits
Select commit Hold shift + click to select a range
2311463
refactor(common): route block inscriptions through one codec
agureev Nov 10, 2026
0b8974c
fix(sequencer): size blocks by their inscription bytes
agureev Nov 10, 2026
d032b50
feat!: hash transactions and blocks over proof digests, and fetch pro…
agureev Nov 12, 2026
486331d
test: pin the digest-form hashes, the proof store and fetching proofs…
agureev Nov 12, 2026
8be3ca5
feat!: inscribe blocks in digest form and settle them by the skip rule
agureev Nov 12, 2026
98a4551
test(chain_state): select and settle by the skip rule
agureev Nov 12, 2026
6175399
test(sequencer, common): digest-form blocks, transaction caps and the…
agureev Nov 12, 2026
d399c8b
test(indexer, cross_zone): index and deliver only settled blocks
agureev Nov 12, 2026
7e09fd4
Merge remote-tracking branch 'origin/dev' into artem/block-proof-gossip
agureev Nov 12, 2026
8babfdf
fixup! Merge remote-tracking branch 'origin/dev' into artem/block-pro…
agureev Nov 12, 2026
dab220c
fixup! Merge remote-tracking branch 'origin/dev' into artem/block-pro…
agureev Nov 12, 2026
ab8872d
refactor(executor): take the proof store from the chain state
agureev Nov 12, 2026
50f2dc1
refactor(common): read a transaction's or a block's proofs through on…
agureev Nov 12, 2026
84a8a76
refactor(common): hydrate a digest-form block to an Option
agureev Nov 12, 2026
02b7119
refactor(chain_state): keep one proof store handle and measure the di…
agureev Nov 12, 2026
824a671
test: drop size and pinning tests another layer already pins
agureev Nov 12, 2026
28edb80
refactor(gossip): fetch proofs over libp2p's JSON request-response codec
agureev Nov 12, 2026
55beee4
fixup! refactor(common): read a transaction's or a block's proofs thr…
agureev Nov 12, 2026
5d6058c
refactor(cross_zone): fold a peer's batch once for both structural re…
agureev Nov 12, 2026
c2a1029
test(chain_state): build the shared private transfer with the apply t…
agureev Nov 12, 2026
50d411b
test(sequencer): run a watcher pass through one helper
agureev Nov 12, 2026
6cea44b
fixup! test(chain_state): build the shared private transfer with the …
agureev Nov 12, 2026
caf2dc1
Revert "refactor(cross_zone): fold a peer's batch once for both struc…
agureev Nov 12, 2026
ce4cbf0
refactor(executor): settle a held block's deliveries in the replay's …
agureev Nov 12, 2026
273ac01
refactor(indexer): chain each batch on the fold's final message
agureev Nov 12, 2026
323452c
refactor(chain_state): read batches with try_unfold
agureev Nov 12, 2026
5b854d5
test(chain_state): name the skip-rule fixture blocks by their roles
agureev Nov 17, 2026
da5411e
refactor(chain_state): check a proof against the cap in one place
agureev Nov 17, 2026
0324dce
fix(executor): cache a submitted proof only within the proof cap
agureev Nov 17, 2026
b6cff42
refactor(lee): make the proof digest a plain 32-byte array
agureev Nov 17, 2026
39ce634
refactor(chain_state): rename fold outcomes, verdicts and blocker fields
agureev Nov 17, 2026
a566af8
refactor(sequencer): name follow's hydration result for what it reports
agureev Nov 17, 2026
538020b
refactor(indexer): name the ingestion loop's state and actions
agureev Nov 17, 2026
5e32cf7
docs: describe settlement as settled state and trim review comments
agureev Nov 17, 2026
6b156c8
test(chain_state): a misplaced block on the settled tip is punishable
agureev Nov 17, 2026
a5b308f
test(executor): cache a proof within the cap and refuse one over it
agureev Nov 17, 2026
11a519f
test(chain_state): pin the skip-rule tests' windows, offences and lat…
agureev Nov 17, 2026
a8b509f
docs(indexer): describe what a failed pass reads again and what stays…
agureev Nov 17, 2026
e0ee779
Merge remote-tracking branch 'origin/dev' into artem/block-proof-gossip
agureev Nov 18, 2026
09bc0b6
feat(storage): add a Logos Storage REST client
agureev Nov 18, 2026
d88a7fc
feat(sequencer): track verified proof locators and their holds
agureev Nov 18, 2026
94828dd
feat(sequencer): bound proof downloads and keep live capacity
agureev Nov 18, 2026
2ee6c7b
feat!(common): inscribe a Storage locator per private transaction
agureev Nov 18, 2026
27c00a2
feat!(sequencer): announce private transactions by digest and locator
agureev Nov 18, 2026
a999685
feat!(sequencer): recover missing proofs by locator and digest lookup
agureev Nov 18, 2026
50fa0f7
feat(indexer): fetch proofs from Logos Storage, with getProof as reco…
agureev Nov 18, 2026
a791bfe
feat(sequencer_stake): sign availability approvals
agureev Nov 18, 2026
d945c37
feat(sequencer): approve candidates whose proofs this node serves
agureev Nov 18, 2026
83f2683
feat!(sequencer): publish proof-bearing blocks on a two-thirds availa…
agureev Nov 18, 2026
92f9c7d
chore(docker): run a pinned Logos Storage node beside the sequencer a…
agureev Nov 18, 2026
c00700a
docs: document Logos Storage proof distribution
agureev Nov 18, 2026
51aabe6
test(common): pin the locator inscription and its charge
agureev Nov 18, 2026
f9c6617
test(storage): screen manifests and bound downloads
agureev Nov 18, 2026
d911af8
test(sequencer): admit announced private transactions after screening
agureev Nov 18, 2026
91bb07e
test(sequencer): count availability approvals and fall back to public…
agureev Nov 18, 2026
7002c13
test(indexer): recover proofs by locator and by digest
agureev Nov 18, 2026
cc4a013
test(sequencer): recover a proof by digest after a wrong locator
agureev Nov 18, 2026
fd3fed6
fixup! feat!(sequencer): announce private transactions by digest and …
agureev Nov 18, 2026
81746c2
fixup! feat(storage): add a Logos Storage REST client
agureev Nov 18, 2026
195dc55
fixup! feat(sequencer): bound proof downloads and keep live capacity
agureev Nov 18, 2026
0662be6
fixup! feat!(common): inscribe a Storage locator per private transaction
agureev Nov 18, 2026
11138ea
fixup! feat!(sequencer): announce private transactions by digest and …
agureev Nov 18, 2026
7e6cc7f
fixup! feat!(sequencer): recover missing proofs by locator and digest…
agureev Nov 18, 2026
5669d13
fixup! feat(indexer): fetch proofs from Logos Storage, with getProof …
agureev Nov 18, 2026
6632653
fixup! feat(sequencer): approve candidates whose proofs this node serves
agureev Nov 18, 2026
6269903
fixup! feat!(sequencer): publish proof-bearing blocks on a two-thirds…
agureev Nov 18, 2026
e0cc696
fixup! test(sequencer): admit announced private transactions after sc…
agureev Nov 18, 2026
3f39219
fixup! test(sequencer): count availability approvals and fall back to…
agureev Nov 18, 2026
5944d95
fixup! feat(storage): add a Logos Storage REST client
agureev Nov 18, 2026
417914c
fixup! feat(sequencer): bound proof downloads and keep live capacity
agureev Nov 18, 2026
497155d
fixup! feat!(sequencer): recover missing proofs by locator and digest…
agureev Nov 18, 2026
1d7322f
fixup! feat(indexer): fetch proofs from Logos Storage, with getProof …
agureev Nov 18, 2026
047f115
fixup! feat!(sequencer): publish proof-bearing blocks on a two-thirds…
agureev Nov 18, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .env.local
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@
LEZ_COMPOSE_SEQUENCER_IMAGE=lez/sequencer_service:mdns
LEZ_COMPOSE_INDEXER_IMAGE=lez/indexer_service:latest
LEZ_COMPOSE_EXPLORER_IMAGE=lez/explorer_service:latest
LEZ_COMPOSE_LOGOS_STORAGE_IMAGE=lez/logos_storage:latest

# Bedrock.
# Host port Bedrock is published on, for tools outside Docker.
Expand Down
58 changes: 57 additions & 1 deletion Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

5 changes: 5 additions & 0 deletions Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,7 @@ members = [
"lez/mempool",
"lez/wallet",
"lez/common",
"lez/logos_storage",
"lez/logging",
"lez/programs",
"lez/programs/bridge",
Expand Down Expand Up @@ -95,6 +96,7 @@ lee = { path = "lee/state_machine" }
lee_core = { path = "lee/state_machine/core" }
program_loader_core = { path = "lee/program_loader" }
common = { path = "lez/common" }
logos_storage = { path = "lez/logos_storage" }
chain_state = { path = "lez/chain_state" }
mempool = { path = "lez/mempool" }
logging = { path = "lez/logging" }
Expand Down Expand Up @@ -177,6 +179,7 @@ openssl = { version = "0.10", features = ["vendored"] }
openssl-probe = { version = "0.1.2" }
serde = { version = "1.0.60", default-features = false, features = ["derive"] }
serde_json = "1.0.81"
multibase = "0.9"
serde_yaml = "0.9.34"
serde_with = "3.16.1"
actix = "0.13.0"
Expand Down Expand Up @@ -215,10 +218,12 @@ libp2p = { version = "0.57", features = [
"ed25519",
"gossipsub",
"identify",
"json",
"kad",
"macros",
"mdns",
"quic",
"request-response",
"tokio",
] }
aes-gcm = { version = "0.10.3", features = ["zeroize"] }
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ To our knowledge, this design is unique to LEZ. Other privacy-focused programmab
2. Transfer from public to private (local / privacy-preserving execution)
- Alice runs the token program `Transfer` function locally, sending to Bob’s private account.
- A ZKP of correct execution is generated.
- The proof is submitted to the blockchain and verified by validators.
- The proof is submitted to the validators, which verify it and serve it over Logos Storage; only its digest and Storage CID are published on-chain.
- Alice’s public balance is updated on-chain.
- Bob’s private balance remains hidden, while the transfer is provably correct.

Expand Down Expand Up @@ -228,15 +228,15 @@ just run-sequencer-standalone

## Running with Docker

The root `docker-compose.yml` runs the whole local stack: a dev Bedrock node, a four-sequencer devnet, the indexer and the explorer. The Bedrock image is built from the Cargo-authoritative node, so resolve it first:
The root `docker-compose.yml` runs the whole local stack: a dev Bedrock node, a four-sequencer devnet, the indexer and the explorer, each sequencer and the indexer beside a Logos Storage node of its own that distributes proofs. The Bedrock image is built from the Cargo-authoritative node, so resolve it first:

```bash
just resolve-bedrock-node
docker compose up # add --profile monitoring for Prometheus, Loki + Grafana
docker compose up indexer_service # or just a service and what it depends on
```

Bedrock, sequencer and indexer state persist in volumes, so `docker compose stop`/`start` and
Bedrock, sequencer, indexer and Logos Storage state persist in volumes, so `docker compose stop`/`start` and
rebuilds resume where they left off. To start over from a fresh chain:

```bash
Expand Down
60 changes: 60 additions & 0 deletions docker-compose.yml
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,19 @@ x-sequencer: &sequencer
depends_on:
logos-blockchain-node-0: { condition: service_healthy }
indexer_service: { condition: service_healthy }
logos_storage_0: { condition: service_healthy }

# Each sequencer and the indexer run a Logos Storage node of their own, with its own data and no
# access to their keys. The nodes form a private network: `logos_storage_0` starts it, the others
# bootstrap from it, and none joins a public preset. Their APIs are reachable on the compose network
# only.
x-logos-storage: &logos_storage
image: ${LEZ_COMPOSE_LOGOS_STORAGE_IMAGE:-lez/logos_storage}
pull_policy: never
environment:
LOGOS_STORAGE_BOOTSTRAP_API: http://logos_storage_0:8080
depends_on:
logos_storage_0: { condition: service_healthy }

x-sequencer-environment: &sequencer_environment
SEQUENCER_CONFIG: /etc/sequencer_service/sequencer_config.json
Expand Down Expand Up @@ -67,6 +80,7 @@ services:
SEQUENCER_CREATE_CHANNEL: "true"
# Names the node in its traces, as the `sequencer` label does in metrics and logs.
OTEL_RESOURCE_ATTRIBUTES: service.instance.id=sequencer_0
SEQUENCER_LOGOS_STORAGE_API_URL: http://logos_storage_0:8080/
ports:
- "${LEZ_COMPOSE_SEQ_0_RPC_PORT:-3040}:3040"
- "${LEZ_COMPOSE_SEQ_0_METRICS_PORT:-9000}:9000"
Expand All @@ -82,8 +96,10 @@ services:
environment:
<<: *follower_environment
OTEL_RESOURCE_ATTRIBUTES: service.instance.id=sequencer_1
SEQUENCER_LOGOS_STORAGE_API_URL: http://logos_storage_1:8080/
depends_on:
sequencer_service_0: { condition: service_healthy }
logos_storage_1: { condition: service_healthy }
ports:
- "${LEZ_COMPOSE_SEQ_1_RPC_PORT:-3041}:3040"
- "${LEZ_COMPOSE_SEQ_1_METRICS_PORT:-9001}:9000"
Expand All @@ -99,8 +115,10 @@ services:
environment:
<<: *follower_environment
OTEL_RESOURCE_ATTRIBUTES: service.instance.id=sequencer_2
SEQUENCER_LOGOS_STORAGE_API_URL: http://logos_storage_2:8080/
depends_on:
sequencer_service_0: { condition: service_healthy }
logos_storage_2: { condition: service_healthy }
ports:
- "${LEZ_COMPOSE_SEQ_2_RPC_PORT:-3042}:3040"
- "${LEZ_COMPOSE_SEQ_2_METRICS_PORT:-9002}:9000"
Expand All @@ -116,8 +134,10 @@ services:
environment:
<<: *follower_environment
OTEL_RESOURCE_ATTRIBUTES: service.instance.id=sequencer_3
SEQUENCER_LOGOS_STORAGE_API_URL: http://logos_storage_3:8080/
depends_on:
sequencer_service_0: { condition: service_healthy }
logos_storage_3: { condition: service_healthy }
ports:
- "${LEZ_COMPOSE_SEQ_3_RPC_PORT:-3043}:3040"
- "${LEZ_COMPOSE_SEQ_3_METRICS_PORT:-9003}:9000"
Expand All @@ -126,6 +146,40 @@ services:
- ${LEZ_COMPOSE_SEQ_3_KEY_FILE:-./lez/configs/docker-all-in-one/devnet/seq-3/channel_signing_key}:/run/secrets/channel_signing_key:ro
- sequencer_data_3:/var/lib/sequencer_service

logos_storage_0:
image: ${LEZ_COMPOSE_LOGOS_STORAGE_IMAGE:-lez/logos_storage}
# Only this node builds the image; the others run what it got.
build:
context: .
dockerfile: lez/docker/logos-storage.Dockerfile
container_name: logos_storage_0
volumes:
- logos_storage_data_0:/var/lib/logos_storage

logos_storage_1:
<<: *logos_storage
container_name: logos_storage_1
volumes:
- logos_storage_data_1:/var/lib/logos_storage

logos_storage_2:
<<: *logos_storage
container_name: logos_storage_2
volumes:
- logos_storage_data_2:/var/lib/logos_storage

logos_storage_3:
<<: *logos_storage
container_name: logos_storage_3
volumes:
- logos_storage_data_3:/var/lib/logos_storage

logos_storage_indexer:
<<: *logos_storage
container_name: logos_storage_indexer
volumes:
- logos_storage_data_indexer:/var/lib/logos_storage

indexer_service:
image: ${LEZ_COMPOSE_INDEXER_IMAGE:-lez/indexer_service}
build:
Expand All @@ -136,6 +190,7 @@ services:
container_name: indexer_service
depends_on:
logos-blockchain-node-0: { condition: service_healthy }
logos_storage_indexer: { condition: service_healthy }
ports:
- "${LEZ_COMPOSE_INDEXER_RPC_PORT:-8779}:8779"
volumes:
Expand Down Expand Up @@ -246,6 +301,11 @@ volumes:
sequencer_data_2:
sequencer_data_3:
indexer_data:
logos_storage_data_0:
logos_storage_data_1:
logos_storage_data_2:
logos_storage_data_3:
logos_storage_data_indexer:
prometheus_data:
loki_data:
tempo_data:
Expand Down
Loading