finally an actionable testnet guide for
@ritualfnd
this is not a perfect oneshot guide you just copy paste in and win - but it’s a real one that actually works & explains the process
let's start with the DEV setup & how not to get stuck 👇
1/ installing Windows Terminal
- you paste commands here to run your app
- install from Microsoft Store -> Windows Terminal
- you could use default PowerShell, but it's pretty buggy
──────────
2/ install Node.js.
- it let's the computer run JavaScript apps
- download the LTS version
nodejs.org/en/download
open windows terminal
type
node -v
then type
npm -v
if you see versions, you're good
──────────
3/ install Git
- lets you download code repos from GitHub (like ritual skills)
-
git-scm.com/install/windows
check in windows terminal again by typing
git --version
──────────
4/ install Codex (from ChatGpt website)
- install Codex CLI
- CLI = AI coding agent we use inside the terminal
- use this command inside terminal
npm install -g @openai/codex
then check version with
codex --version
──────────
5/ you will need to install Metamask
- since it's a testnet I recommend using a new wallet
- you'll also have to use your pivate keys to deploy contracts and that's a bit unsafe with a wallet holding real assets
add Ritual Network to MM
RPC:
rpc.ritualfoundation.org
Chain ID: 1979
Currency: RITUAL
don't forget to get tokens from faucet
- you generate access codes from Ritual Discord 🫧ritdrip channel
──────────
6/ install GitBash (you should have this installed automatically after you installed Git)
- Linux-like terminal needed for Foundry install
- we'll need Foundry for smart contracts
──────────
7/ install Foundry using Git Bash NOT Terminal!
- it is the tool for compiling, testing, and deploying smart contracts
- don't use CTRL V, use right click paste
- in gitbash paste this command
curl -L
foundry.paradigm.xyz | bash
source ~/.bashrc
foundryup
go back to Windows Terminal again, check Foundry
type
forge --version
if it fails use this command & replace your user
$env:PATH = ";C:\Users\YOUR_USER\.foundry\bin"
──────────
8/ quick stop - if you did everything well until now you should be able to run the following commands
node -v
npm -v
git --version
codex --version
forge --version
if all work, your setup is ready
──────────
9/ create your project folder
-go to Windows Terminal and type
mkdir ritual-app
cd ritual-app
──────────
10/ in the same terminal, install Ritual skills - type
New-Item -ItemType Directory -Force .codex\skills
git clone
github.com/ritual-foundation… .codex\skills\ritual-dapp-skills
this puts skills inside your project
now start Codex (still in the same folder)
- simply type in
codex
after codex opens type in this
Read the file .codex/skills/ritual-dapp-skills/skills/ritual/SKILL.md and follow its instructions.
Wallet: 0xYOUR_FUNDED_WALLET_ADDRESS
Description:
write your app idea here
──────────
DISCLAIMER
this guide is for Windows users
we’re working on a testnet → use a separate wallet (no real funds)
you will handle private keys locally → never share them
expect some friction, that’s part of the process
this guide won’t be perfect, but it will get you in the right direction
debugging using ChatGPT is part of the process
this thread only covers setup how to get started
in the next one, I’ll show:
→ how to use Ritual skills properly
→ how to go from idea → working app
→ how to send your first on-chain tx
ONWARD!