Skip to content

Commit a1b4023

Browse files
authored
Merge pull request #1490 from o1-labs/dw/instruction-to-join-devnet
Website: add a "Join devnet" CTA button and section
2 parents bff4b5b + 454be0f commit a1b4023

File tree

6 files changed

+97
-2
lines changed

6 files changed

+97
-2
lines changed

CHANGELOG.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
2929
- **Frontend**: revamping the Docker image, and provide a better support and
3030
documentation for the different configuration.
3131
([#1473](https://github.com/o1-labs/mina-rust/pull/1473))
32+
- **Website**: add "Join devnet" page with instructions for community members to
33+
join the devnet program and test the Rust node implementation
34+
([#1425](https://github.com/o1-labs/mina-rust/issues/1425))
3235

3336
### Changed
3437

website/docs/node-operators/archive-node.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Run Archive Node
1+
# Run an archive node
22

33
This guide is intended for setting up archive nodes on **Mina Devnet** only. Do
44
not use this guide for Mina Mainnet until necessary security audits are

website/docs/node-operators/block-producer.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Run Block Producing Node
1+
# Run a block producer
22

33
This guide is intended for setting up block producer nodes on **Mina Devnet**
44
only. Do not use this guide for Mina Mainnet until necessary security audits are
Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
sidebar_position: 2
3+
title: Join devnet
4+
description:
5+
Join the Mina Protocol devnet program and start testing the Rust node
6+
implementation
7+
slug: /node-operators/join-devnet
8+
---
9+
10+
# Join devnet
11+
12+
The Mina Protocol devnet is an existing testing network where OCaml nodes are
13+
currently running. Community members can join this network with the Rust node
14+
implementation to test interoperability and contribute to improving the Rust
15+
node implementation. By joining devnet, you'll gain experience with the Mina
16+
Rust node while helping validate the Rust implementation.
17+
18+
## Getting started
19+
20+
Follow these steps to join the devnet program:
21+
22+
### 1. Join the Discord
23+
24+
Connect with the Mina community and devnet participants:
25+
26+
- **Channel**: #devnet
27+
- **Invite link**: https://discord.gg/minaprotocol
28+
29+
We recommend introducing yourself in the channel and joining the testing
30+
channels:
31+
32+
- #rust-node-testing
33+
- #rust-node-questions-and-feedback
34+
35+
### 2. Obtain devnet test tokens
36+
37+
Get test tokens to start participating in the network:
38+
39+
- **Faucet**: https://faucet.minaprotocol.com/
40+
41+
The faucet provides tokens for general testing purposes.
42+
43+
### 3. Set up your node
44+
45+
Install and configure your Mina Rust node:
46+
47+
- Follow the [Getting Started guide](getting-started) to install your node
48+
- Refer to [Node Operations](block-producer) for configuration options
49+
- Visit the official documentation: https://docs.minaprotocol.com/
50+
51+
### 4. Block producer testing (optional)
52+
53+
If you want to test block production and need a larger amount of devnet test
54+
tokens:
55+
56+
Contact the devnet coordinators on Discord:
57+
58+
- **CrisF**: Discord ID `412482228359266328`
59+
- **JohnR**: Discord ID `686750097660444716`
60+
61+
They can provide additional tokens and guidance for block producer testing.
62+
63+
## Next steps
64+
65+
Once you've joined the devnet:
66+
67+
1. Set up your node following the [Block Producer guide](block-producer)
68+
2. Set up the [node dashboard](../developers/frontend/node-dashboard) to monitor
69+
the next blocks you will produce, your node's state, and performance metrics
70+
3. Share feedback and report issues in the testing channels
71+
4. Participate in testing activities and network experiments
72+
5. Stay updated: The o1Labs team makes regular updates to the node. Check for
73+
updates frequently and keep your node up to date
74+
75+
## Getting help
76+
77+
If you encounter any issues or have questions:
78+
79+
- Ask in the #devnet channel on Discord
80+
- Check the #rust-node-questions-and-feedback channel for known issues
81+
- Visit the [GitHub repository](https://github.com/o1-labs/mina-rust) to report
82+
bugs
83+
- Review the [Node Management guide](node-management) for troubleshooting tips
84+
85+
Welcome to the Mina devnet community!

website/sidebars.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ const sidebars: SidebarsConfig = {
2020
label: 'Getting Started',
2121
items: [
2222
'node-operators/getting-started',
23+
'node-operators/join-devnet',
2324
],
2425
},
2526
{

website/src/pages/index.tsx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -108,6 +108,12 @@ function HomepageHeader() {
108108
<path d="M8.59 16.59L13.17 12L8.59 7.41L10 6L16 12L10 18L8.59 16.59Z"/>
109109
</svg>
110110
</Link>
111+
<Link className={styles.btnSecondary} to="/docs/node-operators/join-devnet">
112+
Join Devnet
113+
<svg viewBox="0 0 24 24" width="16" height="16" fill="currentColor">
114+
<path d="M8.59 16.59L13.17 12L8.59 7.41L10 6L16 12L10 18L8.59 16.59Z"/>
115+
</svg>
116+
</Link>
111117
</div>
112118
</div>
113119
</div>

0 commit comments

Comments
 (0)