Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
33 commits
Select commit Hold shift + click to select a range
7634a43
feat : add docs
JayWebtech Sep 16, 2025
4abe864
fix: changed document command for adding clients
KcPele Oct 3, 2025
9b0cf44
Merge pull request #54 from KcPele/juno-add-command
emperorsixpacks Oct 5, 2025
70e7bb8
Merge pull request #49 from thebuidl-grid/docs
emperorsixpacks Oct 5, 2025
8d33331
Merge branch 'main' into base-docs
emperorsixpacks Oct 5, 2025
05f944b
fix: updater path
emperorsixpacks Oct 6, 2025
38de4f4
Merge pull request #56 from thebuidl-grid/fix/updater
emperorsixpacks Oct 6, 2025
95be412
fix: installer
emperorsixpacks Oct 6, 2025
4b780e2
chore: merge PR #55 from thebuidl-grid/base-docs
sprtd Oct 6, 2025
9afb1e2
Revert "feat : docs"
JayWebtech Oct 6, 2025
59a5f09
Merge pull request #57 from thebuidl-grid/revert-55-base-docs
JayWebtech Oct 6, 2025
0250951
feat : documentation
JayWebtech Oct 6, 2025
362b581
chore: merge PR #59 from thebuidl-grid/documentation
sprtd Oct 6, 2025
facbfb6
feat: implement dynamic monitor with validator support and adaptive l…
OtowoSamuel Oct 6, 2025
2ad2573
Merge pull request #60 from thebuidl-grid/feat/monitor
emperorsixpacks Oct 7, 2025
7d55167
fix: client tests
emperorsixpacks Oct 7, 2025
ace8e75
fix: pipline
emperorsixpacks Oct 7, 2025
875ca17
chore : responsiveness
JayWebtech Oct 8, 2025
04d176c
feat : dark mode
JayWebtech Oct 8, 2025
1828e33
chore: merge PR #62 from thebuidl-grid/darkmode_responsiveness
sprtd Oct 8, 2025
afa9887
fix: update path
emperorsixpacks Oct 10, 2025
9557bca
Merge pull request #63 from thebuidl-grid/fix/validator
emperorsixpacks Oct 10, 2025
fca7e60
feat: added updater to install.sh
emperorsixpacks Oct 10, 2025
40c5f32
Merge pull request #64 from thebuidl-grid/feat/installer
emperorsixpacks Oct 10, 2025
551a5e0
fix: config path
emperorsixpacks Oct 10, 2025
4405318
Merge branch 'main' of https://github.com/thebuidl-grid/starknode-kit…
emperorsixpacks Oct 10, 2025
95d6bd3
Merge pull request #65 from thebuidl-grid/feat/installer
emperorsixpacks Oct 10, 2025
7f7fb66
Update install.sh
emperorsixpacks Oct 10, 2025
8d732c8
fix: installer
emperorsixpacks Oct 10, 2025
0858ce1
Merge branch 'main' of https://github.com/thebuidl-grid/starknode-kit…
emperorsixpacks Oct 10, 2025
bd48d78
Merge pull request #66 from thebuidl-grid/feat/installer
emperorsixpacks Oct 10, 2025
1785e92
fix reth get version
emperorsixpacks Nov 21, 2025
11dbf6a
fix: monitor
emperorsixpacks Nov 21, 2025
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
2 changes: 1 addition & 1 deletion .github/workflows/go.yml
Original file line number Diff line number Diff line change
Expand Up @@ -24,4 +24,4 @@ jobs:
run: go build ./...

- name: Test
run: go test ./...
run: cd pkg && go test ./...
42 changes: 42 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -10,3 +10,45 @@ starknode-kit.exe
*.exe
*.so
*.dylib

# Node.js dependencies
node_modules/
npm-debug.log*
yarn-debug.log*
yarn-error.log*
package-lock.json
yarn.lock

# Documentation build outputs
docs/_book/
docs/.gitbook/
docs/dist/
docs/build/

# Next.js build outputs
docs/.next/
docs/out/
docs/next-env.d.ts
.next/
out/
next-env.d.ts

# IDE and editor files
.vscode/
.idea/
*.swp
*.swo
*~

# OS generated files
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes
ehthumbs.db
Thumbs.db

# Temporary files
*.tmp
*.temp
36 changes: 19 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
1. Download and run the installation script:

```bash
/bin/bash -c "$(curl -sSL https://raw.githubusercontent.com/thebuidl-grid/starknode-kit/main/install.sh)"
/bin/bash -c "$(curl -sSL https://raw.githubusercontent.com/thebuidl-grid/starknode-kit/main/install.sh)"
```

2. Or download the script first and then run it:
Expand Down Expand Up @@ -53,6 +53,7 @@ After installation, verify that `starknode-kit` is working:
```bash
starknode-kit --help
```

#### Generate Config file

```bash
Expand All @@ -70,7 +71,6 @@ rm -rf ~/.config/starknode-kit

> **Note**: This will not remove any of the client data (e.g., blockchain data). The data is stored in the locations specified in your `~/.starknode-kit/starknode.yml` file.


---

## 📘 Available Commands
Expand Down Expand Up @@ -98,20 +98,20 @@ rm -rf ~/.config/starknode-kit
#### Add a client pair (consensus + execution)

```bash
starknode-kit add --consensus_client lighthouse --execution_client geth
starknode-kit add --consensus-client lighthouse --execution-client geth
```

#### Add a Starknet client

```bash
starknode-kit add --starknet_client juno
starknode-kit add --starknet-client juno
```

#### Remove a configured client

```bash
starknode-kit remove --consensus_client lighthouse
starknode-kit remove --starknet_client juno
starknode-kit remove --consensus-client lighthouse
starknode-kit remove --starknet-client juno
```

#### Change network
Expand Down Expand Up @@ -163,11 +163,13 @@ starknode-kit run lighthouse
Manage the Starknet validator client.

- **Get validator status:**

```bash
starknode-kit validator status
```

- **Get validator version:**

```bash
starknode-kit validator --version
```
Expand Down Expand Up @@ -197,33 +199,33 @@ starknode-kit help add

Make sure the following are installed on your system before using or building `starknode-kit`:

* **Go**: Version **1.24 or later**
- **Go**: Version **1.24 or later**
Install from: [https://go.dev/dl/](https://go.dev/dl/)

* **Rust**: Recommended for building Starknet clients (e.g., Juno)
- **Rust**: Recommended for building Starknet clients (e.g., Juno)
Install with:

```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```

* **Make**: Required to build certain clients and scripts
- **Make**: Required to build certain clients and scripts
Install via package manager:

* Ubuntu/Debian: `sudo apt install make`
* macOS (with Homebrew): `brew install make`
* Windows (WSL): included or `sudo apt install make`
- Ubuntu/Debian: `sudo apt install make`
- macOS (with Homebrew): `brew install make`
- Windows (WSL): included or `sudo apt install make`

### 🖥️ Hardware Requirements

See this [Rocket Pool Hardware Guide](https://docs.rocketpool.net/guides/node/hardware.html) for a detailed breakdown of node hardware requirements.

* **CPU**: Node operation doesn't require heavy CPU power. The BG Client has run well on both i3 and i5 models of the ASUS NUC 13 PRO. Be cautious if using Celeron processors, as they may have limitations.
* **RAM**: At least **32 GB** is recommended for good performance with overhead.
* **Storage (SSD)**: The most critical component. Use a **2 TB+ NVMe SSD** with:
- **CPU**: Node operation doesn't require heavy CPU power. The BG Client has run well on both i3 and i5 models of the ASUS NUC 13 PRO. Be cautious if using Celeron processors, as they may have limitations.
- **RAM**: At least **32 GB** is recommended for good performance with overhead.
- **Storage (SSD)**: The most critical component. Use a **2 TB+ NVMe SSD** with:

* A **DRAM cache**
* **No Quad-Level Cell (QLC)** NAND architecture
- A **DRAM cache**
- **No Quad-Level Cell (QLC)** NAND architecture
See this [SSD List Gist](https://gist.github.com/bkase/fab02c5b3c404e9ef8e5c2071ac1558c) for tested options.

---
Expand Down
5 changes: 2 additions & 3 deletions cli/commands/configCommand/newConfigCommand.go
Original file line number Diff line number Diff line change
Expand Up @@ -206,9 +206,8 @@ func installClients(starknetNode, validator bool, consensusClient, executionClie
if starknetNode {
err := options.Installer.InstallClient(types.ClientJuno)
if errors.Is(err, pkg.ErrClientIsInstalled) {
fmt.Println(utils.Yellow(fmt.Sprintf("🤔 Client Juno is already installed. Skipping.")))
} else {

fmt.Println(utils.Yellow("🤔 Client Juno is already installed. Skipping."))
} else if err != nil {
fmt.Println(utils.Red(fmt.Sprintf("❌ Could not install client Juno: %v", err)))
return
}
Expand Down
36 changes: 0 additions & 36 deletions docs/.gitignore

This file was deleted.

Loading