Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
3 changes: 3 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
2 changes: 1 addition & 1 deletion website/docs/node-operators/archive-node.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion website/docs/node-operators/block-producer.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
85 changes: 85 additions & 0 deletions website/docs/node-operators/join-devnet.md
Original file line number Diff line number Diff line change
@@ -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!
1 change: 1 addition & 0 deletions website/sidebars.ts
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ const sidebars: SidebarsConfig = {
label: 'Getting Started',
items: [
'node-operators/getting-started',
'node-operators/join-devnet',
],
},
{
Expand Down
6 changes: 6 additions & 0 deletions website/src/pages/index.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,12 @@ function HomepageHeader() {
<path d="M8.59 16.59L13.17 12L8.59 7.41L10 6L16 12L10 18L8.59 16.59Z"/>
</svg>
</Link>
<Link className={styles.btnSecondary} to="/docs/node-operators/join-devnet">
Join Devnet
<svg viewBox="0 0 24 24" width="16" height="16" fill="currentColor">
<path d="M8.59 16.59L13.17 12L8.59 7.41L10 6L16 12L10 18L8.59 16.59Z"/>
</svg>
</Link>
</div>
</div>
</div>
Expand Down
Loading