Skip to content

Releases

v0.5.0-beta2-unsigned-tier2

Pre-release

Choose a tag to compare

v0.5.0-beta1 — testnet-beta pilot

Choose a tag to compare

@SaulBuilds SaulBuilds released this 24 May 20:16

Citrate testnet-beta — pilot release (v0.5.0-beta1)

First public binary release of the citrate-chain node for partner onboarding.
Chain ID 40204 (testnet-beta). RPC: https://rpc.citrate.ai.

One-command install (Linux + macOS, for CitrateNetwork org members)

gh auth login   # once, if you haven't
gh api repos/CitrateNetwork/citrate-labs/contents/scripts/install.sh --jq .content | base64 -d | bash

Or clone + run:

gh repo clone CitrateNetwork/citrate-labs
bash citrate-labs/scripts/install.sh

The installer detects OS/arch, verifies SHA-256 via the gh CLI, writes
~/.citrate/node.toml with the baked-in bootnodes (boot{1,2,3}.citrate.ai),
and installs a systemd user service (Linux) or launchd agent (macOS).

Windows install (manual until Tier-2 .msi)

  1. gh release download v0.5.0-beta1 --repo CitrateNetwork/citrate-chain --pattern '*windows*'
  2. Unzip to a directory on %PATH% (e.g. %USERPROFILE%\.citrate\bin).
  3. Copy a testnet-beta config to %USERPROFILE%\.citrate\node.toml or pass --config.
  4. citrate-node.exe

PowerShell installer + Tier-2 .msi ships in v0.5.0-beta2.

Platforms — all 5 targets live ✅

Target Status Notes
x86_64-unknown-linux-gnu ✅ Native build on ubuntu-22.04 in CI with vendored OpenSSL. GLIBC ≥ 2.35 (Ubuntu 22.04+, Debian 12+, RHEL 9+).
aarch64-unknown-linux-gnu ✅ cross-rs build via qemu on boot-1 (DO does not currently offer ARM droplets in this account). GLIBC ≥ 2.30 (Ubuntu 20.04+/Debian 11+).
x86_64-apple-darwin ✅ Full set (node, cli, wallet, faucet) from CI. Unsigned — right-click → Open on first launch.
aarch64-apple-darwin ✅ Full set. Unsigned.
x86_64-pc-windows-msvc ✅ Full set as .zip. Built with vendored OpenSSL via Strawberry Perl in CI. SmartScreen may warn — More info → Run anyway.

All four CI-built archives are signed with cosign (keyless OIDC); see the
.pem + .sig sidecars next to each archive. The aarch64-linux build is
unsigned because it was produced out-of-band (manual cross-build); a CI
matrix entry is tracked for v0.5.0-beta2.

Notes

  • This is a pilot release — no audit, no commercial SLA. See
    citrate-labs/RELEASE_CEREMONY_HANDOFF.md for provenance.
  • All four x86_64-linux/aarch64-darwin/x86_64-darwin/windows archives now
    ship the full binary set (node + cli + wallet + faucet). aarch64-linux
    ships only the unified citrate-node for this release — auxiliary
    Linux ARM binaries land in beta2 when the cross-build adds them.
  • Tier-2 packaging (.dmg / .msi / .deb / .AppImage) ships in v0.5.0-beta2.

Recent commits

d5a0eba fix(release): force openssl-sys vendored across the build graph
4f79f6c feat(node): auto-load ~/.citrate/node.toml when no --config given
a8e9335 ceremony: deploy 39 contracts to testnet-beta chain 40204
2448a25 chore(domain): citrate.network → citrate.ai (correct TLD)
255a3a2 fix(release): Cross.toml pre-installs libssl-dev for cross x86_64-linux
eb1ef55 fix(release): cross-build x86_64-linux in debian:bullseye for portable GLIBC
75ac5b8 fix(release): pin Linux build to ubuntu-22.04 for GLIBC 2.35 compat
136b349 fix(release): include citrate-node binary in tarball (bin name was 'citrate')
497d350 fix(release): cosign step shell syntax — nullglob instead of bad redirect
d37072b fix(release): drop aarch64-unknown-linux-gnu (no openssl on default runner)

Full Changelog: https://github.com/CitrateNetwork/citrate-chain/commits/v0.5.0-beta1