Getting started

System Installation

Set up your environment to build, deploy, and manage verifiable hackathon judging on Solana.

— Installation and environment configuration workflow.

Prerequisites

Before installing JudgeNod, ensure your development machine meets the minimum requirements:

Node.js 18.x or higher
NPM or PNPM package manager
Solana Tool Suite (for on-chain interactions)
A modern terminal (zsh, bash, or PowerShell)

Install Solana Tool Suite

If you don't have the Solana tools installed, run the following command to download the stable release:

sh -c "$(curl -sSfL https://release.solana.com/stable/install)"

Verify the installation by checking your Solana version:

solana --version

Install JudgeNod Core

Install the JudgeNod CLI globally to access the scoring and deployment management tools from any directory.

npm install -g @judgenod/cli

Configure Local Wallet

JudgeNod uses your local Solana configuration to sign transactions. Ensure you have a valid keypair and some testnet SOL.

solana-keygen new --no-passphrase solana airdrop 2

If you're deploying to Mainnet, you won't be able to use the airdrop command. Ensure your wallet has sufficient SOL for contract deployment and state management.

Environment Variables

For advanced dashboard integrations, create a `.env` file in your project root with the following keys:

.env

SOLANA_RPC_URL=https://api.mainnet-beta.solana.com JUDGENOD_ADMIN_KEY=your-admin-wallet-pubkey DATABASE_URL=mongodb+srv://...

Last updated: April 16, 2026

Edit this page on GitHub &nearr;