Repository navigation
Releases
v0.5.0-beta2-unsigned-tier2
v0.5.0-beta1 — testnet-beta pilot
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 | bashOr clone + run:
gh repo clone CitrateNetwork/citrate-labs
bash citrate-labs/scripts/install.shThe 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)
gh release download v0.5.0-beta1 --repo CitrateNetwork/citrate-chain --pattern '*windows*'- Unzip to a directory on
%PATH%(e.g.%USERPROFILE%\.citrate\bin). - Copy a testnet-beta config to
%USERPROFILE%\.citrate\node.tomlor pass--config. 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.mdfor 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 unifiedcitrate-nodefor 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