Install structsd

intent

install the structsd chain binary on your machine. use this when structsd is not found on your PATH, when setting up a new machine, or when you need to update to a specific version. two paths: download a prebuilt release binary (fastest, no Go toolchain required) or build from source via the Makefile (required for unreleased branches or local development). after either path, structsd version will print the chain version.

inputs

• os/arch: your machine's operating system and CPU architecture (linux amd64, macos arm64, macos intel amd64, windows amd64, etc.)
• go 1.23+ (path B only): required if building from source. the Makefile enforces REQUIRE_GO_VERSION = 1.23. newer minor versions (1.24, 1.25) are supported.
• git (path B only): to clone the structsd repo from github.
• network access: required to download release binaries or clone the repo.
• disk space: ~200mb for Go 1.23+, ~150mb for structsd binary and build artifacts.
• shell access: bash or zsh. PATH modification required for both paths.
• sudo access (path A and B): required to install into /usr/local/bin (path A) or to replace /usr/local/go (path B). path B can skip sudo by installing to ~/go/bin.

procedure

path a: prebuilt release binary (recommended)

step 1: select os/arch and version

inputs: github release page at https://github.com/playstructs/structsd/releases, desired version (e.g. v0.17.0).

go to the latest release. identify the asset matching your os/arch:

• linux amd64: structsd_X.Y.Z_linux_amd64.tar.gz
• macos apple silicon: structsd_X.Y.Z_darwin_arm64.tar.gz
• macos intel: structsd_X.Y.Z_darwin_amd64.tar.gz
• windows amd64: structsd_X.Y.Z_windows_amd64.zip

if asset names differ (GoReleaser layouts evolve), copy the download url directly from the release page.

output: version string (e.g. v0.17.0) and download url.

step 2: download and extract

inputs: version, os/arch, download url from step 1.

VERSION=v0.17.0
# linux amd64 example:
curl -L -o structsd.tar.gz \
  "https://github.com/playstructs/structsd/releases/download/${VERSION}/structsd_$(echo ${VERSION#v})_linux_amd64.tar.gz"
# macos apple silicon example:
curl -L -o structsd.tar.gz \
  "https://github.com/playstructs/structsd/releases/download/${VERSION}/structsd_$(echo ${VERSION#v})_darwin_arm64.tar.gz"

tar -xzf structsd.tar.gz

output: extracted structsd binary in current directory, structsd.tar.gz archive file.

step 3: install to PATH

inputs: extracted structsd binary from step 2.

sudo install -m 0755 structsd /usr/local/bin/structsd
rm structsd.tar.gz structsd

output: structsd installed at /usr/local/bin/structsd, temp files cleaned up.

step 4: verify installation

inputs: none.

structsd version

output: version string printed (e.g. structsd v0.17.0 ...).

---

path b: build from source (makefile)

step 1: install or upgrade go 1.23+

inputs: current go version (check with go version), target go version (1.23.6 or newer 1.x).

if go is already installed and >= 1.23, skip to step 2.

linux amd64

GO_VER=1.23.6
wget https://go.dev/dl/go${GO_VER}.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go${GO_VER}.linux-amd64.tar.gz
rm go${GO_VER}.linux-amd64.tar.gz

if an older go was installed via package manager (apt, yum), remove it first:

sudo apt remove -y golang-go

macos apple silicon

GO_VER=1.23.6
curl -OL https://go.dev/dl/go${GO_VER}.darwin-arm64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go${GO_VER}.darwin-arm64.tar.gz
rm go${GO_VER}.darwin-arm64.tar.gz

alternatively: brew install go@1.23.

macos intel amd64

GO_VER=1.23.6
curl -OL https://go.dev/dl/go${GO_VER}.darwin-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go${GO_VER}.darwin-amd64.tar.gz
rm go${GO_VER}.darwin-amd64.tar.gz

alternatively: brew install go@1.23.

output: go 1.23+ installed at /usr/local/go.

step 1b: configure PATH

inputs: shell config file (~/.profile on linux, ~/.zshrc on macos).

append to your shell config:

export PATH=$PATH:/usr/local/go/bin:~/go/bin

reload the shell:

source ~/.profile   # linux
# or
source ~/.zshrc     # macos

output: PATH updated, Go toolchain and GOPATH/bin on PATH.

step 1c: verify go installation

inputs: none.

go version

output: version >= go1.23.x, matching your os/arch (e.g. go version go1.23.6 linux/amd64).

step 2: clone repo and build

inputs: git, network access, go 1.23+, PATH configured from step 1b.

git clone https://github.com/playstructs/structsd.git
cd structsd
make install

the Makefile runs go install -mod=readonly ./cmd/structsd, embedding version, commit hash, and build tags via ldflags.

output: structsd binary installed at ~/go/bin/structsd.

alternative: use make build to write to ./build/structsd without installing to GOPATH.

step 2b: cross-compile (optional)

inputs: go 1.23+, structsd repo cloned.

if you need binaries for other platforms:

make build-linux-amd64
make build-linux-arm64
make build-darwin-amd64
make build-darwin-arm64
make build-windows-amd64
# or all at once:
make build-all

output: binaries written to ./build/ directory.

step 3: verify installation

inputs: none.

structsd version

output: version string printed (e.g. structsd v0.17.0 ...).

step 4: update structsd

inputs: structsd repo already cloned, git, network access.

cd structsd
git fetch --tags
git checkout v0.17.0   # or: git pull origin main
make install

output: updated structsd binary at ~/go/bin/structsd (overwrites previous binary).

---

optional: local devnet with ignite

step 1: install ignite cli (one-time)

inputs: network access, curl.

curl https://get.ignite.com/cli! | bash
ignite version

output: ignite CLI installed and available on PATH.

step 2: run local chain

inputs: ignite installed, structsd repo cloned, go 1.23+.

in the structsd directory:

make serve              # ignite chain serve
make serve-reset        # ignite chain serve --reset-once
make serve-reset-verbose

output: local chain running on localhost (port and endpoint printed by ignite).

note: ignite is only required for local development. for mainnet/testnet use, a structsd binary from path A or B is sufficient.

---

decision points

use path a (prebuilt release) if:

• you want the fastest install with no toolchain setup.
• you are on a machine without Go installed and do not plan to develop structsd.
• you need a stable, tagged release (v0.17.0, etc.).

use path b (build from source) if:

• you need a branch that has not been tagged yet (e.g. main, develop).
• you are developing structsd locally or patching the codebase.
• your os/arch is not covered by prebuilt releases (e.g. linux arm64 for raspberry pi).
• you want to customize build flags (e.g. LEDGER_ENABLED=false).

skip ignite (optional devnet) if:

• you are only using structsd as a client to connect to mainnet or testnet.
• you do not plan to run a local chain for development.

path A install to /usr/local/bin vs path B install to ~/go/bin:

• /usr/local/bin (path A): system-wide, requires sudo, shared across users.
• ~/go/bin (path B): user-local, no sudo needed, recommended for development machines.

skip go installation (path B) if:

• go version already prints >= go1.23.x.
• your go is < 1.23, the Makefile will fail at check_version step.

---

output contract

path A success:

• structsd binary present at /usr/local/bin/structsd (world-readable, executable).
• command -v structsd returns /usr/local/bin/structsd.
• structsd version prints version string without error (exit code 0).

path B success:

• structsd binary present at ~/go/bin/structsd (user-readable, executable).
• command -v structsd returns ~/go/bin/structsd or absolute path.
• structsd version prints version string without error (exit code 0).
• go version prints go1.23.x or newer.

cross-compile (optional, path B):

• binaries present in ./build/ directory named structsd-linux-amd64, structsd-darwin-arm64, etc.

local devnet (optional):

• ignite version prints ignite CLI version without error.
• make serve starts the chain and prints endpoint (e.g. localhost:26657).

---

outcome signal

• structsd version returns a version string (e.g. structsd v0.17.0 commit abc123...). no "command not found" error.
• command -v structsd returns the full path to the binary (e.g. /usr/local/bin/structsd or /home/user/go/bin/structsd).
• you can run structsd from any directory without specifying the full path.
• go version prints go1.23.x or newer (if path B was used).
• (optional) make serve starts a local chain and prints a listening address (if ignite was installed).
• any subsequent structsd skills or commands execute without "command not found" errors.

---

credits: original skill by abstrct on clawhub. enriched for implexa quality standards.