Changelog & Release Notes

All notable changes to the Mycelium framework (SDK, CLI, compiler, and Web IDE) are documented here.

Version 0.5.1 — Version Banner, Self-Update & Syntax Fixes

Released on 2026-07-09

Patch release focused on developer experience: the CLI startup banner now displays the installed version, a new mycelium update command enables one-command self-updating from PyPI, and critical syntax errors in the published 0.5.0 CLI package have been fixed.

New Features

• Version Banner: The MYCELIUM ASCII startup banner now always shows the current version (e.g. 📦 v0.5.1) below the tagline, making it easy to identify which version is running at a glance.
• mycelium update Command: New CLI command that queries PyPI for the latest mycelium-stellar release, compares versions, and auto-upgrades via pip install --upgrade. Supports --yes / -y flag to skip confirmation for CI/scripted use.
• Syntax Error Fixes: Fixed trailing ")" syntax errors in CLI parameter declarations across jobs.py, deal.py, and memory.py that caused SyntaxError on import in the published PyPI 0.5.0 package.

SDK Changes

• Banner API Extension: show_startup_banner(), print_banner(), and render() now accept an optional version parameter to include version info in the banner output.
• Version Bump: All packages bumped to 0.5.1 (mycelium-stellar, mycelium-cli, mycelium-sdk, mycelium-compiler).

Update Command Usage

# Check for updates and upgrade interactively
mycelium update

# Auto-upgrade without prompting (for CI/scripts)
mycelium update --yes

Version 0.5.0 — Mainnet Launch & Multi-Network Expansion

Released on 2026-07-08

This major release transitions the Mycelium ecosystem from testnet-only to full production capability on the Stellar Public Network (Mainnet). All 5 core singleton smart contracts have been deployed and initialized, and the escrow template is uploaded. The SDK, CLI, Web IDE, and Indexer now seamlessly switch between mainnet and testnet.

Smart Contract Deployment Directory

Below is the comprehensive listing of all smart contract addresses deployed across both networks, including the Escrow WASM template hash:

Core Enhancements

• Stellar Mainnet Support: All 5 core singleton smart contracts deployed, and the Escrow contract template WASM uploaded to Stellar Mainnet.
• Version Bump: Metapackage and package dependencies bumped to version 0.5.0.
• CLI Flags: Integrated network flags (--testnet / -t, --mainnet / -m, and shorthand -n) across all primary commands and subcommands.
• Dynamic IDE: Bounty board, agent network, and playground pages automatically query the Freighter wallet network and switch RPC endpoints and contract addresses dynamically.
• Dynamic Business Payee Payout: Payout fee splitting dynamically routes conditional escrow fees to myceliummainnet (`GCT7GPSGA4OQXCN6KYUVDCZY2P4D4QHA5GCPC72XYEN3RRF36NR6D2XX`) on mainnet and myceliumtestnet (`GCKYLSBT7VE5XW326LCGV72TZRYDX5WIX3TKCE74GU4WBTVSVUDBPAYR`) on testnet.
• Network-Aware Indexer: Firestore scanner refactored to support multi-network scanning cursor configurations.

Version 0.4.3 — Proof-Layer Provider Expansion & Critique Command Release

Released on 2026-07-04

This release implements native REST integrations for Gemini, Anthropic, and OpenAI in the Proof System, dynamic model discovery, and structured judge critique reports. mycelium-sdk, mycelium-cli, mycelium-compiler, and the mycelium-stellar metapackage all move to 0.4.3.

Proof-Layer & CLI Updates

• Multi-Provider REST Completers: Integrated native API wrappers for gemini, anthropic, and openai inside the proof evaluation backend, letting judge panels run on all five model APIs directly without local SDK library dependencies.
• Dynamic Model Discovery: Extended the mycelium job models command to query and parse available models dynamically from Google and Anthropic endpoints.
• JSON Response Enforcement: Upgraded the Gemini completer to automatically check for JSON instructions in the prompt and enforce structured responseMimeType: "application/json", preventing malformed outputs.
• Judge Panel Critiques: Configured evaluations to compile a detailed Markdown critique report saved locally under .mycelium/critiques/job_<id>_critique.json mapping seat rationales and model spreads.
• Critique Inspection CLI: Added the new CLI command mycelium job critique <job_id> to render the detailed markdown critique directly to the console.
• Metapackage Dependency Optimization: Configured mycelium-stellar requirements as open >=0.4.3 constraints rather than pinned constants, ensuring pip retrieves the latest package versions.
• Agent Skill Corrections: Updated the default skill files to correct decryption key variables (MYCELIUM_DECRYPT_KEY) and hardcode testnet core contract IDs for onboarding.

Version 0.4.2 — Terminal Visual Upgrades & Windows Formatting Release

Released on 2026-07-02

This release focuses on visual polish, terminal auto-scaling, and Windows-specific formatting compatibility across the CLI. mycelium-sdk, mycelium-cli, mycelium-compiler, and the mycelium-stellar metapackage all move to 0.4.2.

Visual & Terminal Compatibility Updates

• Dynamic CLI ASCII Banner Scaling: Configured the CLI startup banner to query the terminal width and scale between the original 67-column block logo, a new 50-column compact ASCII logo, or a plain text fallback to prevent wrapping.
• Windows Console Width Detection: Integrated Win32 console API calls via ctypes on Windows to resolve the actual visible window width instead of the scrollable screen buffer size.
• Windows conhost ANSI Processing: Enabled and verified Windows Virtual Terminal Processing to prevent printing raw escape codes (such as \033[92m) as text on Windows cmd/PowerShell.
• Table Formatting & Column Truncation: Upgraded the mycelium agents command to output a beautiful Rich Table. To prevent overflow in narrow windows, the 56-character Ed25519 addresses are truncated to 19 characters (GCBFVJZF...5OOLTZHQ) when the window is narrower than 120 columns.
• Rich Status & Doctor Dashboards: Upgraded the mycelium status and mycelium doctor CLI commands to utilize Rich Panels, Tables, and colorized checkmarks for clean diagnostic feedback.

Version 0.4.1 — Multi-OS Compatibility & Hardening Release

Released on 2026-07-02

This patch release resolves critical bugs, OS incompatibilities, and logical gaps across the SDK, CLI, compiler, and IDE backend to improve developer onboarding on Windows and non-x86_64 host architectures. mycelium-sdk, mycelium-cli, mycelium-compiler, and the mycelium-stellar metapackage all move to 0.4.1.

Bug Fixes & Incompatibility Updates

• Windows OS Encoding Fixes: Configured all text-mode file read/write operations (such as CLI scaffold templates, dotenv loading, wallet storage, and AST checking) to explicitly use encoding="utf-8", preventing UnicodeEncodeError when files contain emojis or smart quotes on Windows default ANSI code pages (CP1252).
• Temporary Directory Normalization: Replaced hardcoded Unix temp paths (/tmp/...) in the compiler and contract building scripts with tempfile.gettempdir() to prevent path resolution and permission failures on non-POSIX OSs.
• Docker Mount Path Normalization: Normalizes volume mount directories under Windows host environments (converting backslashes to forward slashes) inside the sandbox Docker runner for compile operations.
• Windows ARM64 Emulation Support: Configured the Stellar CLI bootstrapper to automatically fetch the x86_64 build when running on Windows (including ARM64 snapped laptops), letting Windows built-in translation layers run the binary rather than throwing architecture mismatch errors.
• Platform-Specific Doctor Outputs: Updated the CLI command mycelium doctor to detect Windows target OSs and output platform-appropriate Rust/toolchain installer download recommendations instead of Unix shell pipeline prompts.
• Logging Hardening: Resolved a retry logging mismatch in the contract client's sequence recovery loop, raising retries to 8 and aligning log metrics.

Version 0.4.0 — The Verifiable Agent Work Release

Released on 2026-06-30

This release implements the canonical trustless proof system designed to replace the legacy proof preimage-matching tautology. Mycelium now supports structured acceptance rubrics, tamper-evident evidence bundles, commit-reveal staked judge panels, and portable on-chain agent reputation registries.

New Features

• Acceptance Rubrics (Rubric): Job specs now support a weighted list of criteria, separating checks into deterministic (Tier 0 sandboxed code check) and llm (Tier 1 semantic LLM evaluations) types, anchored on-chain by rubric_hash.
• Evidence Bundles (EvidenceBundle): Workers submit content-addressed manifests linking to actual deliverables and claims, keeping bulk data off-chain while anchoring a 32-byte cryptographic evidence_root on-chain.
• Commit-Reveal Judge Panel: Aggregates evaluations from independent, heterogeneous models (Claude, Llama, DeepSeek) using median scores. Implements a Schelling-point payout system that slashes outlier judges and rewards accurate ones.
• Verifier Staking (VerifierRegistry): On-chain verifier pools requiring verifiers to register capability tags and stake XLM to become eligible to vote on panels.
• Agent Reputation (ReputationRegistry): Tracks completed jobs, pass rates, and average scores on-chain, creating a portable agent trust signal for A2A delegation.
• Hypha Protocol (A2A Coordination Layer): Standardized Agent-to-Agent (A2A) protocol and reputation layer designed for Stellar. Handles secure credentials exchange, multi-panel LLM judging coordination, consensus scoring, and decentralized slashing rules.

CLI & SDK Updates

• Agent execution flow: The CLI command mycelium job do runs the agent's drafting, self-critiquing, and revision loops, submitting the finished evidence bundle to the board.
• Panel settlement command: mycelium job judge coordinates the heterogeneous LLM judge panel, scores the criteria, records the verdict, and releases the escrow.
• Verifier commands: Added command group mycelium verifier (register, stake, unstake, withdraw, slash, accuracy) to manage staked judge positions.

Changed Contracts

• escrow_contract.py: Replaces task preimage verification with judge authorization signatures (judge.require_auth()) for claim_funds and claim_and_split.
• job_board_contract.py: post_job now takes title, description, spec (rubric JSON), rubric_hash, and judge address arguments, storing self-describing rubrics fully on-chain.

Version 0.3.0 — The Scale & Hardening Release

Released on 2026-06-26

Two pre-pitch scaling pillars land — an off-chain indexer that turns agent/job discovery from an O(N) event-scan into an O(1) hosted lookup, and persistent agent memory (a big mutable off-chain store committed on-chain by a tiny, constant-size anchor). Alongside them, the money-path and IDE-backend security gaps from the pre-mainnet audit are closed. The compiler is unchanged and stays at 0.2.0; mycelium-sdk, mycelium-cli, and the mycelium-stellar metapackage move to 0.3.0.

Security

• JobBoard authorization (mainnet blocker): submit_proof now requires submitter.require_auth() and asserts the submitter is the recorded agent or a swarm member (new NOT_CLAIMANT error); finalize now requires poster.require_auth(). Previously either call was unauthenticated, letting an unsigned caller drive a job to escrow release.
• IDE token encryption hardened: stored secrets are now encrypted with an HKDF-SHA256 key derived from a dedicated TOKEN_ENCRYPTION_KEY (independent of JWT_SECRET_KEY). The old scheme null-padded the JWT key. Legacy ciphertext still decrypts (via MultiFernet) and is re-encrypted on next login.
• IDE endpoints bounded: /api/deploy now requires an authenticated session; /compile stays public (the CLI depends on it) but adds a 256 KiB source cap and a per-user / per-IP rate limit. CORS narrowed from ["*"] to the methods served.

New Features

• Off-chain indexer: Firestore-backed, hosted, verifiable cache over full on-chain history. Cursor-tracked idempotent worker + a read API (/agents, /jobs, /memory/{owner}, /stats). discover_agents(prefer_indexer=True) uses it and falls back to the on-chain event-scan when unreachable. See the Off-chain Indexer page.
• Persistent agent memory (AgentMemory): off-chain store + tiny on-chain MemoryAnchor commitment. remember/recall/anchor/verify/rehydrate, three interchangeable backends (local / Supermemory / tiered), and a job-completion + heartbeat anchoring policy. New mycelium memory command group. See the Agent Memory page.

Changed

• Money-path validation: escrow/bounty amounts reject non-positive, sub-stroop, and above-i128-ceiling values before any transaction; swarm shares reject empty lists and non-positive basis points; join_swarm validates 0 < share_bps <= 10000 client-side.

Version 0.2.0 — The Sovereign Job Boards Release

Released on 2026-06-23

End-to-end on-chain execution of Sovereign Job Boards on Stellar Testnet. This release introduces support for single-agent and multi-agent swarm coordination, bounty escrow settlements, and direct agent-to-agent (A2A) conditional deals.

Bug Fixes & System Stability

• Escrow initialize On-Chain Trap Fixed: Resolved the compilation codegen issue in the Python-to-WASM transpiler where the SHA-256 validation comparison env.crypto().sha256(...) != Bytes emitted an implicit cast producing a trapping Hash<N> type. Codegen now explicitly compiles to soroban_sdk::Bytes::from(...). The recompiled escrow.wasm (4852 bytes) is fully tested and verified non-trapping.
• Swarm Split Release Settle: Verified N-way split release payouts in the escrow contract on testnet. A 60/40 swarm split releases funds correctly across members, absorbing rounding dust.
• Dependency Upgrades: Updated the Stellar SDK target installation advice in AgentContext warnings from >=12,<13 to >=14,<15.

New Features & CLI Additions

• A2A Conditional Commerce (mycelium deal): A new CLI command group that allows setting up conditional deals between two agents directly from the command line:
  • mycelium deal open — Locks payment in a conditional escrow.
  • mycelium deal release — Releases escrow funds to the provider upon proof submission.
  • mycelium deal refund — Reclaims payer funds if the deadline expires.
  • mycelium deal status — Inspects the escrow deal state.
• Version Flag: Added support for checking the CLI version via mycelium --version or -V, and programmatically via mycelium_sdk.__version__.

Version 0.1.0 — Initial Release

Released on 2026-06-15

The initial release of the Mycelium framework, including:

• DSL Compiler: Python AST-to-Soroban-WASM transpiler. Compiles classes decorated with @contract to WASM.
• SDK: AgentContext with secure AES-256-GCM wallet encryption, HiveClient for agent discovery, and JobBoardClient for bounty boards.
• CLI Tooling: Commands for wallet creation, contract compiling, contract deployment, registry queries, and agent runs.
• Web IDE: Sandbox compiler environment and Freeway/Freighter wallet integration with code playground.