From 1c06260a9632f545036dee9c90c0aaf65bdc6039 Mon Sep 17 00:00:00 2001 From: Danny Willems Date: Wed, 1 Oct 2025 18:14:06 +0200 Subject: [PATCH 1/2] Website: add a "Join devnet" CTA button and section --- website/docs/node-operators/archive-node.md | 2 +- website/docs/node-operators/block-producer.md | 2 +- website/docs/node-operators/join-devnet.md | 85 +++++++++++++++++++ website/sidebars.ts | 1 + website/src/pages/index.tsx | 6 ++ 5 files changed, 94 insertions(+), 2 deletions(-) create mode 100644 website/docs/node-operators/join-devnet.md diff --git a/website/docs/node-operators/archive-node.md b/website/docs/node-operators/archive-node.md index 196336b4d6..a97fbbe02b 100644 --- a/website/docs/node-operators/archive-node.md +++ b/website/docs/node-operators/archive-node.md @@ -1,4 +1,4 @@ -# Run Archive Node +# Run an archive node This guide is intended for setting up archive nodes on **Mina Devnet** only. Do not use this guide for Mina Mainnet until necessary security audits are diff --git a/website/docs/node-operators/block-producer.md b/website/docs/node-operators/block-producer.md index 66e931f6b8..72f00a79d2 100644 --- a/website/docs/node-operators/block-producer.md +++ b/website/docs/node-operators/block-producer.md @@ -1,4 +1,4 @@ -# Run Block Producing Node +# Run a block producer This guide is intended for setting up block producer nodes on **Mina Devnet** only. Do not use this guide for Mina Mainnet until necessary security audits are diff --git a/website/docs/node-operators/join-devnet.md b/website/docs/node-operators/join-devnet.md new file mode 100644 index 0000000000..efdc3d96f3 --- /dev/null +++ b/website/docs/node-operators/join-devnet.md @@ -0,0 +1,85 @@ +--- +sidebar_position: 2 +title: Join devnet +description: + Join the Mina Protocol devnet program and start testing the Rust node + implementation +slug: /node-operators/join-devnet +--- + +# Join devnet + +The Mina Protocol devnet is an existing testing network where OCaml nodes are +currently running. Community members can join this network with the Rust node +implementation to test interoperability and contribute to improving the Rust +node implementation. By joining devnet, you'll gain experience with the Mina +Rust node while helping validate the Rust implementation. + +## Getting started + +Follow these steps to join the devnet program: + +### 1. Join the Discord + +Connect with the Mina community and devnet participants: + +- **Channel**: #devnet +- **Invite link**: https://discord.gg/minaprotocol + +We recommend introducing yourself in the channel and joining the testing +channels: + +- #rust-node-testing +- #rust-node-questions-and-feedback + +### 2. Obtain devnet test tokens + +Get test tokens to start participating in the network: + +- **Faucet**: https://faucet.minaprotocol.com/ + +The faucet provides tokens for general testing purposes. + +### 3. Set up your node + +Install and configure your Mina Rust node: + +- Follow the [Getting Started guide](getting-started) to install your node +- Refer to [Node Operations](block-producer) for configuration options +- Visit the official documentation: https://docs.minaprotocol.com/ + +### 4. Block producer testing (optional) + +If you want to test block production and need a larger amount of devnet test +tokens: + +Contact the devnet coordinators on Discord: + +- **CrisF**: Discord ID `412482228359266328` +- **JohnR**: Discord ID `686750097660444716` + +They can provide additional tokens and guidance for block producer testing. + +## Next steps + +Once you've joined the devnet: + +1. Set up your node following the [Block Producer guide](block-producer) +2. Set up the [node dashboard](../developers/frontend/node-dashboard) to monitor + the next blocks you will produce, your node's state, and performance metrics +3. Share feedback and report issues in the testing channels +4. Participate in testing activities and network experiments +5. Stay updated: The o1Labs team makes regular updates to the node. Check for + updates frequently and keep your node up to date + +## Getting help + +If you encounter any issues or have questions: + +- Ask in the #devnet channel on Discord +- Check the #rust-node-questions-and-feedback channel for known issues +- Visit the [GitHub repository](https://github.com/o1-labs/mina-rust) to report + bugs +- Review the [Node Management guide](node-management) for troubleshooting tips + +Welcome to the Mina devnet community! diff --git a/website/sidebars.ts b/website/sidebars.ts index d535f6b6d4..8fa0ea969b 100644 --- a/website/sidebars.ts +++ b/website/sidebars.ts @@ -20,6 +20,7 @@ const sidebars: SidebarsConfig = { label: 'Getting Started', items: [ 'node-operators/getting-started', + 'node-operators/join-devnet', ], }, { diff --git a/website/src/pages/index.tsx b/website/src/pages/index.tsx index f0887e12c6..52c9002c2a 100644 --- a/website/src/pages/index.tsx +++ b/website/src/pages/index.tsx @@ -108,6 +108,12 @@ function HomepageHeader() { + + Join Devnet + + + + From 454be0f7d163290610267d3d0f082967e4740df5 Mon Sep 17 00:00:00 2001 From: Danny Willems Date: Wed, 1 Oct 2025 18:21:13 +0200 Subject: [PATCH 2/2] CHANGELOG: add entry for patch 1425 --- CHANGELOG.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 278fbf6983..7e7025b259 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -29,6 +29,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - **Frontend**: revamping the Docker image, and provide a better support and documentation for the different configuration. ([#1473](https://github.com/o1-labs/mina-rust/pull/1473)) +- **Website**: add "Join devnet" page with instructions for community members to + join the devnet program and test the Rust node implementation + ([#1425](https://github.com/o1-labs/mina-rust/issues/1425)) ### Changed