Purpose of activity?
I've used Github for quite some time, I'm no expert of course, but since I got into web2 hacking many moons ago, then in the past few years (as of May 2024) web3, I've been using it mainly for security research, a few python scripts, and early web3 learning (at the moment with Cyfrin's Updraft learning platform, go check it out here).
But, more recently I was hoping to build more of a portfolio whilst learning and stumbled across the video by Nader. Since decentralisation is thrown around frequently, even though it is relevant and has meaning; I thought I would steer more towards that with my own projects and see how it goes.
Getting setup
I already have WSL2 setup on my Windows laptop, and the VS Code editor installed - including the plugin to connect to WSL and the Radicle plugin. So, I'll only need to follow the setup of the Radicle repo from here.
Installation as per the instructions from the guide:
curl -sSf https://radicle.xyz/install | sh
Output:
Welcome to Radicle
Detecting operating system...
Downloading https://files.radicle.xyz/releases/latest/radicle-x86_64-unknown-linux-musl.tar.xz...
Downloading https://files.radicle.xyz/releases/latest/radicle-x86_64-unknown-linux-musl.tar.xz.sig...
Verifying radicle-x86_64-unknown-linux-musl.tar.xz...
Good "file" signature for cloudhead with ED25519 key SHA256:iTDjRHSIaoL8dpHbQ0mv+y0IQqPufGl2hQwk4TbXFlw
Installing Radicle into /home/pxng0lin/.radicle...
Configuring path variable in ~/.bashrc...
✓ Radicle 1.0.0-rc.9 was installed successfully.
Before running Radicle for the first time,
run `source ~/.bashrc` or open a new terminal.
Then, create your Radicle key pair with `rad auth`.
As per the instructions, we need to execute the commands in my .bashrc file by calling source. This basically re-reads the file which is only read upon start-up of Bash. Alternatively, we could open a new terminal window too.
source ~/.bashrc
Ok so now to check that it was successful by running the version command.
rad --version
Output:
rad 1.0.0-rc.9 (d56d619f)
Great! I'm good so far.
Next is creating a Radicle identity aka Radicle DID (Decentralised Identifier). This is a cryptographic key pair, since we're on the network, which is used to identify and authenticate me/my node. Public is for the network and everyone can see, private, as indicated, is only used for authentication of my node, signing of code and other artifacts, and shouldn't be shared publicly.
rad auth
Output:
Initializing your radicle 👾 identity
✓ Enter your alias: rxdicle-1
✓ Enter a passphrase: [REDACTED *]
✓ Creating your Ed25519 keypair...
✓ Your Radicle DID is did:key:[REDACTED]. This identifies your device. Run `rad self` to show it at all times.
✓ You're all set.
✗ Hint: install ssh-agent to have it fill in your passphrase for you when signing.
To create a Radicle repository, run `rad init` from a Git repository with at least one commit.
To clone a repository, run `rad clone <rid>`. For example, `rad clone rad:z3gqcJUoA1n9HaHKufZs5FCSGazv5` clones the Radicle 'heartwood' repository.
To get a list of all commands, run `rad`.
NB: I didn't use ssh-agent, we will revisit this later.
Your Radicle DID is similar to your Node ID (NID), the difference is the former is formatted as a Decentralized Identifier, while the latter is just the encoded public key. Share your Radicle DID freely with collaborators.
You can check your rad details by running a few commands, reference below, I used the rad self to check mine
Alias rxdicle-1
DID did:key:z6Mkg3Tu7aGDn3pLrshRiaCFLQJwEHyFKTCwYFoKDHts1YV2
└╴Node ID (NID) [REDACTED]
SSH not running
├╴Key (hash) [REDACTED]
└╴Key (full) [REDACTED]
Home /home/pxng0lin/.radicle
├╴Config /home/pxng0lin/.radicle/config.json
├╴Storage /home/pxng0lin/.radicle/storage
├╴Keys /home/pxng0lin/.radicle/keys
└╴Node /home/pxng0lin/.radicle/node
Many of the other items you see in the rad self output can be viewed individually. Wondering about your alias? A quick rad self --alias has you covered. Need to pinpoint your Radicle home folder? rad self --home is your friend. And for your config file location, just hit up rad self --config.
If you’re ever feeling lost, rad self --help will lay out all your options.
NB: I'm in the habit of redacting information, even if it's said to be ok for the public, call me over-cautious, I guess.
Node On?
A quick check on my node status, I expect it to be off since its my first install.
rad node status
Output:
Node is stopped.
To start it, run `rad node start`.
As expected it's not running, so we will fire it up with the provided command
rad node start
Output:
✓ Passphrase:
✓ Node started (841691)
To stay in sync with the network, leave the node running in the background.
To learn more, run `rad node --help`.
For extra commands, and to find out how to stop the node use rad node --help
Starting a new project
Moving to the Youtube video by Nader, we will now initiate a new repo, we will be using the tutorial from Updraft as my project, Fund Me. The only difference will be the replacement of Github for Radicle, everything else should be the same.
mkdir rad-foundry-fund-me-23
we then change directory into the project folder and initiate the Radicle project.
Because I'm creating a brand new project, we need to ensure have a git repo ready, so I'll initialise a git repo first, then the Radicle repo afterwards.
git init
Output:
hint: Using 'master' as the name for the initial branch. This default branch name
hint: is subject to change. To configure the initial branch name to use in all
hint: of your new repositories, which will suppress this warning, call:
hint:
hint: git config --global init.defaultBranch <name>
hint:
hint: Names commonly chosen instead of 'master' are 'main', 'trunk' and
hint: 'development'. The just-created branch can be renamed via this command:
hint:
hint: git branch -m <name>
Initialized empty Git repository in /home/pxng0lin/web3/projects/radicle_xyz/rad-foundry-fund-me/.git/
The Radicle repo requires at least 1 commit to be done, so I'll create a README.md file and commit this. I changed the initial branch name to 'main', this was only due to preference and not a requirement.
git branch -m main
touch README.md
git add README.md
git status
Output:
On branch main
No commits yet
Changes to be committed:
(use "git rm --cached <file>..." to unstage)
new file: README.md
We will commit this using the command git commit. It will ask for a comment to be added for the commit, then press ctrl+o to save, followed by ctrl+x, and we are good; now I'm ready to initialise the Radicle repo.
Output:
[main (root-commit) 9ff86ae] Creation of README.md file only
1 file changed, 0 insertions(+), 0 deletions(-)
create mode 100644 README.md
Initialising the new Radicle repo.
rad init
TIP: to clear any entered commands and returned outputs from your terminal, use eitherctrl+l(ell) or typeclear, I like to clean up the screen from time-to-time.
So now we need to enter some information about the new project for the repo.
✓ Name foundry-fund-me
✓ Description A tutorial project in the Foundry 101 course on Cyfrin to learn how to professionally deploy code, master the art of creating fantastic tests, and gain insights into advanced debugging techniques.
✓ Default branch main
✓ Visibility public
✓ Passphrase:
✓ Unsealing key...
✓ Repository foundry-fund-me created.
Your Repository ID (RID) is rad:z43pr3L72n8wT74KSHcty9fEY5JaL.
You can show it any time by running `rad .` from this directory.
◢ Upload done for rad:[REDACTED] to [REDACTED] : signal: 9 (SIGKILL)✓ Repository successfully synced to [REDACTED]
◢ Uploading rad:[REDACTED] to [REDACTED] Compressing objects: 100% (8/8)✓ Repository successfully synced to [REDACTED]
✓ Repository successfully synced to 2 node(s).
Your repository has been synced to the network and is now discoverable by peers.
View it in your browser at:
https://app.radicle.xyz/nodes/seed.radicle.garden/rad:z43pr3L72n8wT74KSHcty9fEY5JaL
To push changes, run `git push`.
And we're off!
So the setup is done, and I'm ready to begin the development stage. this will be the follow along as per the course. I'll end it here for today, and begin a new article as I complete the stages of the course as not to make this too long of a post.
