Skip to content

Release v0.4.3

Choose a tag to compare

View all tags
@github-actions github-actions released this 01 Jul 16:30
v0.4.3
b1e64a1

Orisun v0.4.3

Orisun v0.4.3

Highlights

  • Adds a native FoundationDB backend, exposed through cmd/orisun-fdb and embedded/foundationdb.
  • Marks the FoundationDB backend as beta/pre-release in the docs so storage behavior and operational contracts can still change if needed.
  • Adds YugabyteDB dialect support for the PostgreSQL-compatible backend path.
  • Expands Command Context Consistency documentation around event scopes, carried state, idempotent retries, indexing, projections, storage backends, and deployment.
  • Aligns ledger and client examples around event-scoped account identity: AccountOpened event ids are the account identity, and later events use scopes.accountOpenedId.

FoundationDB

  • Implements FoundationDB persistence, criteria reads, consistency checks, subscriptions, native locking, guard locks, size-limit checks, and backend configuration.
  • Requires ready covering indexes for FoundationDB criteria reads and CCC checks, returning FAILED_PRECONDITION instead of scanning a whole boundary.
  • Adds per-boundary ordering and workload tests, including gRPC ledger coverage and backend scaling tests.
  • Adds local/container FDB tooling through scripts/fdb_local_docker.sh and scripts/fdb_test_container.sh.

Storage And Runtime

  • Adds ORISUN_BACKEND=foundationdb support and FoundationDB config tests.
  • Adds the FDB-only server entry point.
  • Preserves backend status and scope-event checkpoint behavior across backend paths.
  • Hardens FoundationDB conflict, index, lock, and size-limit semantics.
  • Adds CI and release workflow updates for the new backend/tooling surface.

Documentation

  • Refreshes the project docs with multi-language API examples, comparison material, internals, deployment, troubleshooting, observability, storage-backend, indexing, event-scopes, schema-evolution, idempotency, and projection-rebuild guidance.
  • Reworks the ledger tutorial into a double-entry transfer flow with scoped account identity and explicit root/scope indexes.
  • Updates Go and Node client README examples to match the scoped-account pattern.
  • Documents FoundationDB topology guidance and beta status.

Verification

  • go test ./...
  • bun run build in docs/

Installation

Linux

# All-backends binary for amd64
curl -L https://github.com/oexza/Orisun/releases/download/v0.4.3/orisun-linux-amd64 -o orisun
chmod +x orisun

# All-backends binary for arm64
curl -L https://github.com/oexza/Orisun/releases/download/v0.4.3/orisun-linux-arm64 -o orisun
chmod +x orisun

# PostgreSQL-only binary
curl -L https://github.com/oexza/Orisun/releases/download/v0.4.3/orisun-pg-linux-amd64 -o orisun-pg
chmod +x orisun-pg

# SQLite-only binary
curl -L https://github.com/oexza/Orisun/releases/download/v0.4.3/orisun-sqlite-linux-amd64 -o orisun-sqlite
chmod +x orisun-sqlite

# FoundationDB-only binary (Linux only; requires the FoundationDB
# client library installed: foundationdb-clients 7.3.x)
curl -L https://github.com/oexza/Orisun/releases/download/v0.4.3/orisun-fdb-linux-amd64 -o orisun-fdb
chmod +x orisun-fdb

macOS

# All-backends binary for amd64
curl -L https://github.com/oexza/Orisun/releases/download/v0.4.3/orisun-darwin-amd64 -o orisun
chmod +x orisun

# All-backends binary for arm64 (Apple Silicon)
curl -L https://github.com/oexza/Orisun/releases/download/v0.4.3/orisun-darwin-arm64 -o orisun
chmod +x orisun

Windows

Download the appropriate binary from the assets below.

Docker

docker pull orexza/orisun:0.4.3
docker pull orexza/orisun:0.4.3-pg
docker pull orexza/orisun:0.4.3-sqlite

Channel tags are also available: latest, pg, and sqlite.

Assets 19
Loading