MCPcopy Index your code
hub / github.com/NethermindEth/Catalyst

github.com/NethermindEth/Catalyst @v1.41.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.41.0 ↗ · + Follow
1,250 symbols 3,362 edges 181 files 129 documented · 10%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

GitHub License Docker Stars Docker Pulls Docker Image Size (tag)

Catalyst: A Taiko Stack preconfer sidecar

Engineered with ❤️ at Nethermind

Features

  • Validator registration to the preconfirmation registry at initial setup
  • Lookahead submissions and disputes.
  • Dispute against preconfirmations made by other validators.
  • ✅ Execution of the main preconfirmation duties, which include:
  • ✅ Checking the lookahead to determine if it's the validator’s turn to preconfirm.
  • ✅ Constructing L2 blocks using the Taiko mempool.
  • ✅ Publishing the L2 block to a preconfirmation P2P network.
  • ✅ Syncing the local Taiko head with the latest preconfirmation state.
  • ✅ Posting L2 blocks through the L1 mempool

Docker image

Use the pre-built image

docker pull nethswitchboard/catalyst-node:latest

The image is built with this Github Action.

Build the image locally

docker build -t node .

Git hooks

Hooks require additional dependencies:

 cargo install typos-cli cargo-sort cargo-deny

License

MIT. The license is also applied to all commits made before the license introduced.

Would like to contribute?

see Contributing.

Extension points exported contracts — how you extend this code

Clock (Interface)
(no doc) [6 implementers]
common/src/l1/slot_clock.rs
ProposalIdFetcher (Interface)
Trait for fetching proposal_id for a given block_id [2 implementers]
shasta/src/node/last_safe_l2_block_finder/binary_search_last_block.rs
PreconfOperator (Interface)
(no doc) [4 implementers]
pacaya/src/l1/traits.rs
L1BridgeHandlerOps (Interface)
(no doc) [1 implementers]
realtime/src/l1/execution_layer.rs
ELTrait (Interface)
Execution layer trait. Enables additional features to the execution layer, specific for permissionless or whitelist impl [3 …
common/src/l1/traits/el_trait.rs
BlockAdvancer (Interface)
(no doc) [2 implementers]
shasta/src/node/proposal_manager/block_advancer.rs
WhitelistProvider (Interface)
(no doc) [1 implementers]
pacaya/src/l1/traits.rs
L2BridgeHandlerOps (Interface)
(no doc) [1 implementers]
realtime/src/l2/execution_layer.rs

Core symbols most depended-on inside this repo

len
called by 54
shasta/src/node/proposal_manager/proposal_queue.rs
push
called by 45
shasta/src/node/proposal_manager/proposal_queue.rs
cancel_on_critical_error
called by 42
common/src/utils/cancellation_token.rs
make_builder
called by 41
shasta/src/node/proposal_manager/proposal_builder.rs
create_proposal
called by 31
shasta/src/node/proposal_manager/proposal_builder.rs
make_draft_block
called by 28
shasta/src/node/proposal_manager/proposal_builder.rs
add_l2_draft_block
called by 26
shasta/src/node/proposal_manager/proposal_builder.rs
chain_error
called by 23
common/src/shared/execution_layer.rs

Shape

Method 747
Function 313
Class 160
Enum 15
Interface 15

Languages

Rust93%
Python7%

Modules by API surface

shasta/src/node/proposal_manager/proposal_builder.rs89 symbols
common/src/l1/slot_clock.rs54 symbols
e2e_tests/utils.py43 symbols
shasta/src/node/proposal_manager/mod.rs35 symbols
pacaya/src/node/operator/tests.rs35 symbols
common/src/batch_builder/core.rs34 symbols
common/src/metrics/mod.rs27 symbols
realtime/src/node/proposal_manager/batch_builder.rs25 symbols
shasta/src/l1/execution_layer.rs23 symbols
realtime/src/node/proposal_manager/bridge_handler.rs22 symbols
common/src/shared/transaction_monitor.rs22 symbols
common/src/shared/execution_layer.rs22 symbols

Datastores touched

(mysql)Database · 1 repos
urcDatabase · 1 repos

For agents

$ claude mcp add Catalyst \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact