Skip to content

Foedus Blockchain v0.4

Choose a tag to compare

View all tags
@github-actions github-actions released this 01 Dec 03:54
· 21 commits to foedus since this release
v0.4
820b919

Foedus Blockchain v0.4.0 — Release Notes

Release v0.4.0 Production Ready

🎉 Production Ready Release

Foedus v0.4.0 is our first production-ready release, delivering immutable contract infrastructure for government bodies and enterprises. This version provides a stable, secure platform for managing legally binding agreements with full audit trails.

✨ What's New

Production-Grade Error Handling

All core functions now return proper errors instead of terminating execution. This enables graceful degradation and better integration with upstream services.

  • NewBlockChain() and ContinueBlockChain() return typed errors
  • Custom error types: ErrBlockchainExists, ErrBlockchainNotFound
  • Consistent error wrapping throughout the codebase

Health Check System

Built-in health monitoring for container orchestration:

# CLI health check
./foedus --health

# HTTP endpoint
curl http://localhost:3000/health
# {"status":"ok"}
  • Docker HEALTHCHECK integration
  • Kubernetes-ready liveness probes
  • Graceful shutdown with configurable timeout

Contract Cancellation

Securely cancel active contracts and recover undistributed funds:

POST /blockchain/cancelcontract
{
  "contract_id": "...",
  "creator": "creator_address"
}
  • Authorization verification for contract parties
  • Automatic fund recovery to originating wallet
  • Immutable cancellation records on-chain

Enhanced Stability

  • Graceful shutdown handling with SIGINT/SIGTERM
  • Concurrent resource cleanup with timeout protection
  • Improved database connection management

🔧 Improvements

  • API: Health endpoint added at /health
  • CLI: --health flag for container health checks
  • Docker: Multi-stage build with non-root user
  • Network: Better peer connection error handling
  • Logging: Structured log output with context tags

📊 Test Coverage

Module Coverage
merkle 100%
wallet 89%
database 86%
blockchain 28%
cli 25%

🚀 Upgrade Guide

From v0.3.x

  1. Pull the latest image:

    docker pull codila125/foedus-blockchain:0.4.0

  2. Stop existing container:

    docker stop foedus

  3. Start with new version:

    docker run -d \
  --name foedus \
  -p 3000:3000 \
  -v foedus-data:/app/data \
  codila125/foedus-blockchain:0.4.0

Note: Blockchain data is backward compatible. No migration required.

📦 Installation

Docker (Recommended)

docker pull codila125/foedus-blockchain:0.4.0
docker run -d -p 3000:3000 --name foedus codila125/foedus-blockchain:0.4.0

From Source

git clone https://github.com/codila125/foedus-blockchain.git
cd foedus-blockchain
git checkout v0.4.0
go build -o foedus

🔗 Links

Foedus v0.4.0 — Immutable Contracts for Government & Enterprise

Assets 2
Loading