Nockchain

https://github.com/zorp-corp/nockchain
Admin
Nockchain is a ZK-Proof of Work blockchain combining sound money incentives with data availability,...
Tokens:122,754
Snippets:1,768
Trust Score:6.9
Update:5 months ago
Show doc for...
Tokens:
Raw
### Initialize and Build NockApp Project

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockup/README.md

Quick start guide for initializing a NockApp project. It involves creating a directory, defining a nockapp.toml manifest, updating the toolchain, initializing the project, building it, and running it.

```shell
mkdir arcadia-work
cd arcadia-work

cat > nockapp.toml <<'TOML'
[package]
name = "arcadia"
version = "0.1.0"
description = "Example app"
template = "basic"

[dependencies]
"urbit/bits" = "@k409"
TOML

nockup update
nockup project init
nockup project build arcadia
nockup project run arcadia
```

--------------------------------

### Install Nockchain

Source: https://github.com/zorp-corp/nockchain/blob/master/README.md

Installs the Nockchain software after completing the initial setup and build steps. Ensure your `$PATH` is updated.

```bash
make install-nockchain
export PATH="$HOME/.cargo/bin:$PATH"
```

--------------------------------

### Install Foundry

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/README.md

Installs Foundry, a smart contract development toolkit. Ensure Foundry is in your PATH.

```bash
curl -L https://foundry.paradigm.xyz | bash
~/.foundry/bin/foundryup
```

--------------------------------

### Install Nockchain and Tools

Source: https://context7.com/zorp-corp/nockchain/llms.txt

Installs system dependencies, clones the repository, and builds the Hoon compiler, wallet, and node. Ensure Rust toolchain is installed.

```bash
sudo apt update
sudo apt install clang llvm-dev libclang-dev make protobuf-compiler

git clone https://github.com/zorp-corp/nockchain.git && cd nockchain

cp .env_example .env

echo 'vm.overcommit_memory=1' | sudo tee /etc/sysctl.d/99-overcommit.conf
sudo sysctl --system

make install-hoonc
export PATH="$HOME/.cargo/bin:$PATH"

make install-nockchain-wallet

make install-nockchain
```

--------------------------------

### Nockchain Wallet CLI Examples

Source: https://context7.com/zorp-corp/nockchain/llms.txt

Examples of using the nockchain-wallet command-line interface to interact with Nockchain nodes.

```APIDOC
## Nockchain Wallet CLI Examples

### Use custom public endpoint

```bash
nockchain-wallet \
  --client public \
  --public-grpc-server-addr https://public-node.example.com \
  list-notes
```

### Use private API on localhost

```bash
nockchain-wallet --client private list-notes
```

### Use private API with custom port

```bash
nockchain-wallet \
  --client private \
  --private-grpc-server-port 6000 \
  list-notes
```
```

--------------------------------

### Run gRPC Server Listener

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockup/templates/grpc/README.md

Starts the gRPC server listener binary. Ensure you are in the project's directory.

```sh
cd {{project_name}}
cargo run --release --bin listen
```

--------------------------------

### Install Hoon Compiler (hoonc)

Source: https://github.com/zorp-corp/nockchain/blob/master/README.md

Installs the Hoon compiler (`hoonc`) using `make`. Ensure your `$PATH` is updated to include the Cargo bin directory.

```bash
make install-hoonc
export PATH="$HOME/.cargo/bin:$PATH"
```

--------------------------------

### Source Environment File

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/contracts/DEPLOYMENT.md

Loads environment variables from a pre-configured file. Examples are provided for different network configurations.

```bash
source environments/devnet.example
# or
source environments/base-sepolia.example
```

--------------------------------

### Install Development Packages (Linux)

Source: https://github.com/zorp-corp/nockchain/blob/master/README.md

Installs necessary development packages on Arch Linux for building the Tracy profiler client. Ensure these or equivalent packages are installed on your system.

```bash
pacman -Syu --noconfirm && pacman -S --noconfirm --needed freetype2 debuginfod wayland dbus libxkbcommon libglvnd meson cmake git wayland-protocols nodejs
```

--------------------------------

### Install Development Tools

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/contracts/DEPLOYMENT.md

Installs necessary development tools including Foundry (forge, cast), Tenderly CLI, and contract dependencies like forge-std and OpenZeppelin.

```bash
cd crates/bridge/contracts
make install
```

--------------------------------

### Install Nockup via Script

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockup/README.md

Installs Nockup using a curl script. Ensure prerequisites like git, Rust toolchain, and gpg are installed.

```shell
curl -fsSL https://raw.githubusercontent.com/nockchain/nockchain/refs/heads/master/crates/nockup/install.sh | bash
```

--------------------------------

### Install Nockchain Wallet

Source: https://github.com/zorp-corp/nockchain/blob/master/README.md

Installs the Nockchain wallet after setup and build commands. Update your `$PATH` to include the Cargo bin directory.

```bash
make install-nockchain-wallet
export PATH="$HOME/.cargo/bin:$PATH"
```

--------------------------------

### Launch Bridge Node

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/docs/node-runbook.md

Use this command to launch the bridge node. Specify the configuration file path. The `--new` flag resets state, and `--start` sends a %start signal on boot.

```bash
cargo run -p bridge -- --config-path /abs/path/to/bridge-conf.toml
```

--------------------------------

### BaseBridge::submit_deposit Example

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/docs/signatures.md

Example of building a `DepositSubmission` and calling `submit_deposit` with canonical proposal fields, nonce, and raw signatures.

```rust
let deposit_submission = DepositSubmission::new(canonical_proposal_fields, assigned_nonce);
BaseBridge::submit_deposit(deposit_submission, eth_sigs);

```

--------------------------------

### Install Debian/Ubuntu Dependencies

Source: https://github.com/zorp-corp/nockchain/blob/master/README.md

Installs essential dependencies for running Nockchain on Debian/Ubuntu systems. Ensure you have `rustup` installed first.

```bash
sudo apt update
sudo apt install clang llvm-dev libclang-dev make protobuf-compiler
```

--------------------------------

### Setup Nockchain Fakenet

Source: https://github.com/zorp-corp/nockchain/blob/master/README.md

Instructions for setting up a Nockchain testnet (fakenet) on your local machine. This involves creating separate directories for hub and node instances and copying the `.env` file.

```bash
# Create directories for each instance
mkdir fakenet-hub fakenet-node

# Copy .env to each directory
cp .env fakenet-hub/
cp .env fakenet-node/
```

--------------------------------

### Deploy Bridge Contracts on Base Sepolia

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/contracts/environments/base-sepolia-testnet-accounts.md

Navigate to the contracts directory and copy the example environment file. Edit the .env file with your specific values before running the deployment command. The 'make deploy' command automatically loads the .env file if it exists.

```bash
cd crates/bridge/contracts
cp environments/base-sepolia.example .env
#edit .env values
make deploy
```

--------------------------------

### Nockapp.toml Manifest Example

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockup/README.md

Example of a nockapp.toml file, defining package metadata, template selection, and dependencies. Supports various version specifiers for dependencies.

```toml
[package]
name = "arcadia"
version = "0.1.0"
description = "My app"
authors = ["you"]
license = "MIT"
template = "basic"
# optional template pin
# template_commit = "<git-commit>"

[dependencies]
"urbit/bits" = "@k409"
"nockchain/zose" = "latest"
```

--------------------------------

### NockIR to LLVM IR Mapping Examples

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockvm/docs/llvm.md

Examples illustrating the translation of NockIR sequences to LLVM IR. These demonstrate how NockIR instructions are represented as builder sequences for LLVM IR.

```nockir
ir[s t [6 b c d]]
```

```nockir
ir[1 1 b]; br0[ir[s t c] ir[s t d]]
```

```nockir
ir[0 t [7 b c]]
```

```nockir
ir[0 1 b]; sub; ir[0 t c]
```

```nockir
ir[1 1 [7 b c]]
```

```nockir
puh[1]; ir[0 1 b]; sav[0]; sub; ir[0 1 c]; reo[0]; pop
```

```nockir
ir[0 t [8 b c]]
```

```nockir
ir[1 1 b]; ext; ir[0 t c]
```

```nockir
ir[1 1 [8 b c]]
```

```nockir
puh[1]; ir[0 1 b]; sav[0]; ext; ir[0 1 c]; reo[0]; pop
```

```nockir
ir[0 0 [9 b c]]
```

```nockir
ir[0 1 c]; sub; axe[b]; lnt
```

```nockir
ir[0 1 [9 b c]]
```

```nockir
puh[1]; ir[0 1 c]; sub; axe[b]; lnk; pop
```

```nockir
ir[1 1 [9 b c]]
```

```nockir
puh[2]; sav[1]; ir[0 1 c]; sub; axe[b]; lnk; reo[1]; pop
```

```nockir
ir[0 0 [10 [b c] d]]
```

```nockir
puh[1]; ir[1 1 d]; put[0]; ir[0 1 c]; reo[0]; edt[b]; pop; don
```

```nockir
ir[0 1 [10 [b c] d]]
```

```nockir
puh[1]; ir[1 1 d]; put[0]; ir[0 1 c]; reo[0]; edt[b]; pop;
```

```nockir
ir[1 1 [10 [b c] d]]
```

```nockir
puh[2]; sav[1]; ir[0 1 d]; put[0]; reo[1]; ir[0 1 c]; reo[0];edt[b]; pop
```

```nockir
ir[s t [11 [b c] d]]
```

```nockir
ir[1 1 b]; hnd[b]; ir[s t d]
```

```nockir
ir[s t [11 b c]]
```

```nockir
hns[b]; ir[s t c]
```

```nockir
ir[0 0 [12 b c]]
```

```nockir
puh[1]; ir[1 1 b]; put[0]; ir[0 1 c]; cel[0]; spy; pop; don
```

```nockir
ir[s 1 [12 b c]
```

```nockir
puh[1]; ir[1 1 b]; put[0]; ir[s 1 c]; cel[0]; spy; pop
```

--------------------------------

### Install and Use Hoon Compiler (hoonc)

Source: https://context7.com/zorp-corp/nockchain/llms.txt

Commands for installing the Hoon compiler and compiling Hoon source files into Nock JAM binaries.

```bash
# Install hoonc
make install-hoonc

# Basic compilation (entrypoint + source directory)
hoonc main.hoon hoon
# Output: out.jam

# Compile arbitrary Hoon file
hoonc --arbitrary hoon/trivial.hoon hoon

# Fresh build (ignore cache)
hoonc --new hoon/apps/dumbnet/outer.hoon hoon

# Run ad-hoc Hoon generator
cargo run --release -p hoon -- <path-to-generator.hoon>

# Rebuild minimal bootstrap JAM
cargo run --release -p hoonc -- hoon/apps/hoonc/hoonc.hoon hoon
mv out.jam crates/hoonc/bootstrap/hoonc.jam

# Generate prewarmed bootstrap
cargo run --release -p hoonc --bin prewarm -- \
  --output crates/hoonc/bootstrap/hoonc-prewarm.jam
```

--------------------------------

### Combine Logging Configurations

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockapp/README.md

Combine `RUST_LOG` for specific module tracing and `MINIMAL_LOG_FORMAT` for compact output. This example sets the kernel to trace level and enables the minimal format.

```bash
# Combine environment variables
RUST_LOG="nockapp::kernel=trace" MINIMAL_LOG_FORMAT=true <nockapp-based-binary> <args>
```

--------------------------------

### Capture Early Balance Fixture

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockchain-types/jams/README.md

Command to capture the early balance JAM fixture by running the `dump_balance_peek` example. This requires a running nockapp-grpc instance and a public key.

```bash
cargo run -p nockapp-grpc --example dump_balance_peek -- \
  http://127.0.0.1:50051 \
  <PUBKEY_B58> \
  /tmp
```

--------------------------------

### Run nockchain-api with Flags

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockchain-api/README.md

Use this command to start the nockchain-api binary with necessary flags for public gRPC exposure. Ensure you provide standard Nockchain CLI flags along with the public gRPC bind address.

```bash
cargo run --release --bin nockchain-api -- <flags>
```

--------------------------------

### Build Nockup from Source

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockup/README.md

Builds Nockup from its source code. This requires cloning the repository and using cargo to install the nockup crate.

```shell
git clone https://github.com/nockchain/nockchain.git
cd nockchain
cargo install --path crates/nockup --locked
```

--------------------------------

### Build and Run Bridge Node

Source: https://context7.com/zorp-corp/nockchain/llms.txt

Commands to build, configure, and run the bridge node. Use --start to unfreeze a stopped node or --new to wipe on-disk state.

```bash
make assets/bridge.jam
make -C crates/bridge/contracts install
cargo build --profile release --bin bridge
cp crates/bridge/bridge-conf.example.toml ~/.nockapp/bridge/bridge-conf.toml
./bridge -c ~/.nockapp/bridge/bridge-conf.toml
```

```bash
./bridge -c bridge_config_path --start
```

```bash
./bridge -c bridge_config_path --new
```

--------------------------------

### Build NockVM Library

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockvm/DEVELOPERS.md

Use this command to build the NockVM library crate. Ensure Rust is installed and navigate to the correct directory.

```bash
cd crates/nockvm/rust/nockvm
cargo build
```

--------------------------------

### Build Bridge Runtime

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/README.md

Builds the bridge runtime binary. This command installs contract dependencies and compiles the code.

```bash
make assets/bridge.jam
make -C crates/bridge/contracts install  # installs or updates foundry and downloads contract dependencies
cargo build --profile release --bin bridge
```

--------------------------------

### Compile Hoon to Nock

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockapp/README.md

Use the `hoonc` command-line tool to compile Hoon source files to Nock. Ensure `hoonc` is installed first.

```bash
make install-hoonc
hoonc hoon/apps/dumbnet/outer.hoon hoon
```

--------------------------------

### Create and Manipulate Big Integers in Rust

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockvm/rust/ibig/README.md

Demonstrates creating UBig and IBig integers using macros and parsing strings. Shows basic arithmetic operations, exponentiation, and radix conversion. Includes an example of modular arithmetic with ModuloRing.

```rust
use ibig::{ibig, modular::ModuloRing, ubig, UBig};

let a = ubig!(12345678);
let b = ubig!(0x10ff);
let c = ibig!(-azz base 36);
let d: UBig = "15033211231241234523452345345787".parse()?;
let e = 2 * &b + 1;
let f = a * b.pow(10);

assert_eq!(e, ubig!(0x21ff));
assert_eq!(c.to_string(), "-14255");
assert_eq!(f.in_radix(16).to_string(), "1589bda8effbfc495d8d73c83d8b27f94954e");
assert_eq!(format!("hello {:#x}", d % ubig!(0xabcd1234134132451345)), "hello 0x1a7e7c487267d2658a93");

let ring = ModuloRing::new(&ubig!(10000));
let x = ring.from(12345);
let y = ring.from(55443);
assert_eq!(format!("{}", x - y), "6902 (mod 10000)");
```

--------------------------------

### Run Nockchain Miner

Source: https://github.com/zorp-corp/nockchain/blob/master/README.md

Starts a Nockchain node with mining enabled. Ensure you are in the `nockchain` directory and have a clean working directory. Mining will target the `MINING_PKH` set in `.env`.

```bash
./scripts/run_nockchain_miner.sh
```

--------------------------------

### Build Arbitrary Hoon File with `--arbitrary`

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/hoonc/README.md

Compiles an arbitrary Hoon file using the `--arbitrary` flag. The `--new` flag can be used to bypass the build cache. This example first creates a directory and a simple Hoon file.

```bash
# Create a directory for your Hoon files
mkdir hoon

# Create a simple Hoon file
echo '%trivial' > hoon/trivial.hoon

# Build the Hoon file (exclude --new if you want to use the build cache)
hoonc --new --arbitrary hoon/trivial.hoon hoon
```

--------------------------------

### Test Upgrade on Fork

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/contracts/DEPLOYMENT.md

Spawn a Tenderly fork, set environment variables for the fork's RPC URL and deployment path, then run 'make upgrade' and subsequent validation/testing.

```bash
tenderly fork spawn --network base-sepolia
export TENDERLY_RPC_URL="<fork-rpc-url>"
export DEPLOYMENTS_PATH="deployments/fork-test.json"
make upgrade
make validate
make integration-test
```

--------------------------------

### NockIR `get` Instruction

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockvm/docs/llvm.md

The `get` instruction loads a noun from a specified frame slot into the result register.

```nockir
get[0]
```

--------------------------------

### Install and Update Nockup CLI

Source: https://context7.com/zorp-corp/nockchain/llms.txt

Commands to install and update the Nockup CLI tool for managing NockApp development environments.

```bash
# Install via script
curl -fsSL https://raw.githubusercontent.com/nockchain/nockchain/refs/heads/master/crates/nockup/install.sh | bash

# Install from source
git clone https://github.com/nockchain/nockchain.git
cd nockchain
cargo install --path crates/nockup --locked

# Initialize/refresh local toolchain cache
nockup update

# Show current versions and channel
nockup

# Manage release channels
nockup channel show
nockup channel set stable  # or: nightly

# Clear caches
nockup cache clear --all
nockup cache clear --git --packages
```

--------------------------------

### List All Deployments

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/contracts/DEPLOYMENT.md

Display all deployment files found in the 'deployments/' directory.

```bash
make list-deployments
```

--------------------------------

### Build Project with Nockup

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockup/templates/grpc/README.md

Compiles Hoon apps and generates binary jams. Run this from the workspace directory containing `nockapp.toml`.

```sh
nockup project build {{project_name}}
```

--------------------------------

### Deploy Contracts with Make

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/contracts/DEPLOYMENT.md

Use this command for standard contract deployment. It handles validation, building, deployment, and saving addresses. Ensure required environment variables are set.

```bash
make deploy
```

--------------------------------

### Run Nockchain Bridge Node

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/README.md

Starts the Nockchain bridge node. Use --start to unfreeze stopped nodes and --new to wipe kernel state.

```bash
./bridge  -c bridge_config_path
```

--------------------------------

### Run Nockchain Explorer TUI (Fail Fast)

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockchain-explorer-tui/README.md

Configure the TUI to exit immediately if the initial connection to the server fails. Use the --fail-fast flag for strict startup behavior.

```bash
cargo run --release -p nockchain-explorer-tui -- --fail-fast
```

--------------------------------

### Build Rust Project and Compile Hoon

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockup/templates/repl/README.md

Build the Rust project and compile the Hoon application from the project directory.

```sh
cargo build --release
hoonc hoon/app/app.hoon
```

--------------------------------

### Spawn Fork and Execute Upgrade

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/contracts/UPGRADE_GUIDE.md

This bash script spawns a Tenderly fork, sets necessary environment variables, and executes the upgrade process. Ensure you have the correct RPC URL, owner key, and deployment manifest path.

```bash
cd crates/bridge/contracts

# 1) Spawn fork and set env
tenderly fork spawn --network base-sepolia --project bridge-contracts
export TENDERLY_RPC_URL="<fork-rpc-url>"
export INBOX_PRIVATE_KEY="<owner-key>"
export DEPLOYMENTS_PATH="deployments/fork-test.json"

# 2) Execute upgrade (interactive prompt expects: yes)
make upgrade

# 3) Validate and run integration script
make validate DEPLOYMENTS_PATH=deployments/fork-test.json
make integration-test DEPLOYMENTS_PATH=deployments/fork-test.json
```

--------------------------------

### Upgrade Production Contracts

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/contracts/DEPLOYMENT.md

Set the correct DEPLOYMENTS_PATH for the production network and execute the 'make upgrade' command.

```bash
export DEPLOYMENTS_PATH="deployments/base-sepolia.json"
make upgrade
```

--------------------------------

### Manage Hoon Package Dependencies with Nockup

Source: https://context7.com/zorp-corp/nockchain/llms.txt

Commands for adding, installing, listing, removing, and updating Hoon package dependencies.

```bash
# Add a dependency
nockup package add urbit/bits --version @k409

# Install all dependencies from manifest
nockup package install

# List installed packages
nockup package list

# Remove a dependency
nockup package remove urbit/bits

# Update all dependencies
nockup package update

# Version spec formats:
# @k414              - Kelvin version
# @commit:abc123     - Git commit
# @tag:v1.2.3        - Git tag
# @branch:main       - Git branch
# ^1.2.0             - Semver requirement
# latest             - Latest release
```

--------------------------------

### Clone Nockchain Repository

Source: https://github.com/zorp-corp/nockchain/blob/master/README.md

Clones the Nockchain repository from GitHub and navigates into the project directory. This is the first step after installing `rustup`.

```bash
git clone https://github.com/zorp-corp/nockchain.git && cd nockchain
```

--------------------------------

### Import Master Public Key

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockchain-wallet/README.md

Imports a master public key from an exported file, typically used for watch-only setups.

```bash
nockchain-wallet import-master-pubkey keys.export
```

--------------------------------

### Typical V0 Notes Migration Workflow

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockchain-wallet/README.md

This sequence outlines the steps for migrating legacy v0 notes, including updating the wallet, importing seeds, setting the active master address, running the migration sweep, and submitting the generated transactions.

```bash
# 1. Pull the latest wallet code
git pull origin master

# 2. Rebuild the wallet jams and binary
make install-nockchain-wallet

# 3. Import the legacy seed if you have not already done so
nockchain-wallet import-keys \
  --seedphrase "your legacy seed phrase here" \
  --version 0

# 4. Confirm the legacy master address is present
nockchain-wallet list-master-addresses

# 5. Switch the active master to the legacy v0 master key that owns the signer tree
nockchain-wallet set-active-master-address <legacy-v0-master-address>

# 6. Run the migration sweep into your v1 P2PKH destination
nockchain-wallet migrate-v0-notes --destination <v1-p2pkh-b58>

# 7. Submit each saved transaction shown in the migration summary
nockchain-wallet send-tx <path-to-tx-file>
```

--------------------------------

### Run Nockchain Node

Source: https://github.com/zorp-corp/nockchain/blob/master/README.md

Starts a Nockchain node without mining capabilities. Ensure you are in the `nockchain` directory and have a clean working directory.

```bash
./scripts/run_nockchain_node.sh
```

--------------------------------

### Nockup Project Management Commands

Source: https://context7.com/zorp-corp/nockchain/llms.txt

Commands for initializing, building, and running NockApp projects using Nockup.

```bash
# Initialize project from manifest
nockup project init
# Creates: my-app/ directory with template files

# Build Rust binary and Hoon kernels
nockup project build my-app

# Run the application
nockup project run my-app

# Available templates: basic, grpc, http-server, http-static, repl
```

--------------------------------

### Nockup Dependency Management Commands

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockup/README.md

Commands for managing Hoon dependencies within a project. Includes adding, installing, listing, and removing packages.

```shell
nockup package add urbit/bits --version @k409
nockup package install
nockup package list
nockup package remove urbit/bits
```

--------------------------------

### Build and Run NockApp with nockup

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockup/templates/basic/README.md

Use these nockup commands to build and run your NockApp from the workspace directory.

```sh
nockup project build {{project_name}}
```

```sh
nockup project run {{project_name}}
```

--------------------------------

### List Deployments

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/contracts/DEPLOYMENT.md

Lists all current deployment files. Set HISTORY=1 to include historical backups with their proxy addresses.

```bash
make list-deployments
```

```bash
make list-deployments HISTORY=1
```

--------------------------------

### Authenticate Tenderly CLI

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/contracts/DEPLOYMENT.md

Logs into the Tenderly CLI and links your local environment to a specific Tenderly project. This is a one-time setup per machine.

```bash
tenderly login
tenderly project link <your-account>/<your-project>
```

--------------------------------

### Hoon Build Runes for Compilation

Source: https://context7.com/zorp-corp/nockchain/llms.txt

Examples of ford-style build runes used within Hoon source files for managing dependencies and loading code.

```hoon
::  Load from /lib directory
/+  library-name

::  Load from /sur directory (discouraged in NockApps)
/-  structure-name

::  Load from specified path (requires %hoon mark)
/=  my-file  /path/to/file

::  Load via mark (presumptively %hoon or %jock)
/*  my-data  %hoon  /path/to/file

::  Load and kick precomputed nock from /dat
/#  precomputed  /dat/constraints

::  Version pinning (ignored)
/?  1
```

--------------------------------

### Create Transaction (Multisig)

Source: https://context7.com/zorp-corp/nockchain/llms.txt

Creates a transaction destined for a 2-of-3 multisignature address. Ensure the addresses provided are valid public keys for the multisig setup.

```bash
nockchain-wallet create-tx \
  --recipient '{"kind":"multisig","threshold":2,"addresses":["<pkh-a>","<pkh-b>","<pkh-c>"],"amount":9000}'
```

--------------------------------

### Nock to NockIR Code Generation: Function Calls

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockvm/docs/llvm.md

These examples show the NockIR code generated for function call patterns in Nock. They involve stack manipulation and jumps.

```NockIR
puh[1]; ir[1 1 [b c]]; put[0]; ir[0 1 d]; cel[0]; pop; don
```

```NockIR
puh[1]; ir[1 1 [b c]]; put[0]; ir[s 1 d]; cel[0]; pop
```

```NockIR
puh[1]; ir[1 1 c]; put[0]; ir[0 1 b]; cel[0]; pop; noc; lnt
```

```NockIR
puh[2]; ir[1 1 c]; put[1]; ir[0 1 b]; cel[1]; noc; lnk; pop
```

```NockIR
puh[2]; ir[1 1 c]; put[1]; ir[1 1 b]; cel[1]; sav[1]; noc; lnk; reo[1]; pop
```

--------------------------------

### Create Transaction (Manual Selection and Fee)

Source: https://context7.com/zorp-corp/nockchain/llms.txt

Creates a transaction with manual note selection using names and an explicitly defined fee. Use `[first1 last1],[first2 last2]` to specify notes.

```bash
nockchain-wallet create-tx \
  --names "[first1 last1],[first2 last2]" \
  --recipient '{"kind":"p2pkh","address":"<p2pkh-b58>","amount":10000}' \
  --fee 10
```

--------------------------------

### Create Transaction (Simple)

Source: https://context7.com/zorp-corp/nockchain/llms.txt

Creates a transaction with automatic note selection and fee computation. This is the simplest way to send funds.

```bash
nockchain-wallet create-tx \
  --recipient '{"kind":"p2pkh","address":"<p2pkh-b58>","amount":10000}'
```

--------------------------------

### Manual V0 Fan-In Transaction Creation

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockchain-wallet/README.md

Create a transaction by manually specifying legacy v0 inputs using the `--names` argument. This requires all selected notes to be v0 and a `--refund-pkh` to be provided. Mixed v0/v1 manual sets are rejected.

```bash
nockchain-wallet create-tx \
  --names "[first1 last1],[first2 last2]" \
  --recipient '{"kind":"p2pkh","address":"<v1-p2pkh-b58>","amount":10000}' \
  --refund-pkh <v1-p2pkh-b58>
```

--------------------------------

### Nock to NockIR Code Generation: Atom Operations

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/nockvm/docs/llvm.md

These examples illustrate NockIR code generation for operations involving atoms (numbers) in Nock, such as direct values, arithmetic, and comparisons.

```NockIR
axe[b]; don
```

```NockIR
axe[b]
```

```NockIR
con[x]; don
```

```NockIR
con[x]; don
```

```NockIR
ir[0 1 b]; clq; don
```

```NockIR
ir[s 1 b]; clq
```

```NockIR
ir[0 1 b]; inc; don
```

```NockIR
ir[s 1 b]; inc;
```

```NockIR
puh[1]; ir[1 1 b]; put[0]; ir[0 1 c]; eqq[0]; pop; don
```

```NockIR
puh[1]; ir[1 1 b]; put[0]; ir[s 1 c]; eqq[0]; pop
```

--------------------------------

### Perform Contract Upgrade with Make

Source: https://github.com/zorp-corp/nockchain/blob/master/crates/bridge/contracts/DEPLOYMENT.md

Execute the contract upgrade process using the 'make upgrade' command. Ensure the INBOX_PRIVATE_KEY is set and the DEPLOYMENTS_PATH is correct if not using the default.

```bash
# Set INBOX_PRIVATE_KEY in .env (must be owner)
# Set DEPLOYMENTS_PATH if not using deployments.json
make upgrade
```
Tokens:
Raw