0.12.0-beta5

Yaci DevKit 0.12.0-beta5

0.12.0-beta5 release is focused on Cardano node 11.0.1 / PV11 support, Yano-backed devnet startup, CIP-30 wallet tooling, packaged examples, MCP integration, and Yaci Viewer improvements.

Highlights

1. PV11 / Cardano Node 11.0.1 Support

This release updates DevKit defaults for protocol version 11 and Cardano node 11.0.1.

It also adds Yano-backed startup modes to make PV11 devnet bootstrapping fast while keeping protocol parameter updates valid.

2. Yano-backed Node Modes

Yano is a lightweight Cardano devnet node added in this release to help DevKit bootstrap and run PV11-compatible local networks quickly.

Companion Mode (Default)

In companion mode, Yano bootstraps the devnet before handing over to the Haskell node.

It starts the network in the past, submits the required protocol parameter governance action for Plutus cost models, advances the chain until the update is enacted, and then fast-forwards back to wall-clock time before handover.

This avoids requiring users to wait for two epoch transitions before updated protocol parameters are available.
This flow is needed because Cardano node 11.0.1 validates cost model lengths, so patching extra cost model entries directly into genesis is no longer viable.

Yano-only Mode

In Yano-only mode, Yano runs as the devnet node directly. There is no handover to the Haskell node.
Yaci Store syncs directly from Yano, which gives a lightweight and fast local devnet mode for application and SDK testing.

Use Yano-only mode when you do not need a running Haskell node process.

Docs: https://devkit.yaci.xyz/yano-node-modes

3. CIP-30 Wallet API and Wallet UI

This release adds a local CIP-30-compatible wallet API and wallet UI for dApp testing.

• Wallet page: http://localhost:10000/wallet
• Wallet SDK: http://localhost:10000/wallet-sdk.js
• Injected wallet: window.cardano.yacidevkit

The info command now also shows Wallet SDK / CIP-30 links.

Docs: https://devkit.yaci.xyz/cip30-wallet

4. Packaged Examples

The examples/ folder is now included in both zip distributions:

• Docker zip distribution
• Native yaci-cli zip distribution

Included examples:

• meshjs-mint-nft: MeshJS NFT minting with CIP-30 wallet signing
• wallet-demo: CIP-30 wallet connection and transfer demo
• evolution-sdk: Evolution SDK payment and Plutus V2/V3 examples
• sutra-elixir: Sutra Elixir transaction examples

5. MCP Server Support

Adds MCP server integration for tools such as Claude Code.

Docs: https://devkit.yaci.xyz/mcp-integration

6. Yaci Viewer Improvements

This release includes multiple Yaci Viewer updates:

• Explorer enhancements
• Block details UI improvements
• Dark/light mode toggle
• Transaction list improvements
• Block list improvements
• AdaPot loading fix

7. Transaction evaluation mode

Yaci Store now uses the scalus transaction evaluator by default. Ogmios is no longer started just for transaction evaluation in the default setup, which keeps the devnet lighter and avoids requiring Ogmios for normal Yaci Store usage.

If Ogmios is enabled and running, DevKit automatically switches Yaci Store transaction evaluation to ogmios mode and routes evaluation through Yaci Store’s transaction evaluator endpoint. The active mode is printed during startup.

To use Ogmios-backed evaluation, enable Ogmios or Kupomios.

Compatibility Notes

Ogmios / Kupo PV11 Workaround

PV11-compatible Ogmios and Kupo binaries for Cardano node 11.0.1 are currently sourced from IntersectMBO as a temporary workaround.

Current versions:

• Ogmios v6.14.0.2
• Kupo v2.11.0.1

These PV11-compatible builds are currently available only as Linux x86_64 binaries.

Docker behavior:

• Linux x86_64 Docker hosts: supported
• Apple Silicon Docker Desktop: expected to work through x86_64 emulation
• Native Linux arm64 Docker hosts: may fail unless x86_64 binfmt/qemu emulation is configured

Once upstream arm64-compatible binaries are available, this workaround can be removed.

Downloads

Docker distribution:

• yaci-devkit-0.12.0-beta5.zip

Native CLI distributions:

• yaci-cli-0.12.0-beta5-linux-X64.zip
• yaci-cli-0.12.0-beta5-macos-ARM64.zip

What's Changed

• Chore: use env in devkit.sh shebang by @euonymos in #132
• [Yaci-Viewer] - UI fix and enhancement by @wistkeylab in #135
• Switch all scripts to portable shebangs by @Quantumplation in #138
• feat: CIP-30 wallet API, wallet UI by @satran004 in #136
• Revert " feat: CIP-30 wallet API, wallet UI" by @satran004 in #142
• feat: CIP30 Wallet API + Wallet UI by @satran004 in #143
• Viewer explorer enhancements by @satran004 in #137
• Remove Wallet link from navigation bar by @satran004 in #144
• Wrong amount parsing when /balance endpoint is enabled by @satran004 in #145
• feat: add MCP server for Claude Code integration by @Quantumplation in #146
• [Yaci Viewer] - update block details UI by @wistkeylab in #141
• chore: upgrade Spring Boot 3.5.11, Yaci 0.4.0 and improve MCP logging by @satran004 in #147
• [Yaci Viewer] Toggle Dark/Light Mode by @wistkeylab in #149
• [Yaci Viewer] - Improve Transaction List by @wistkeylab in #151
• [Yaci Viewer] - Block List Improvement by @wistkeylab in #156
• [Yaci Viewer] - Can't load current AdaPot by @wistkeylab in #159
• [Yaci Viewer] - Fix Typo, Subscription Leak & Block Size Display by @wistkeylab in #163
• Sutra SDK e2e Test by @piyushthapa in #165
• Add Yano-backed node modes and protocol v11 devkit defaults by @satran004 in #166
• Fix yano-only Store readiness and native Docker builds by @satran004 in #168
• Feat/pr 162 merge branch by @satran004 in #169
• Enhance devnet info output by @satran004 in #170
• fix(npm): Update child process to inherit environment variables by @rober-m in #172
• Fix npm publishing CI and native wallet signing by @satran004 in #173
• Package examples and update PV11 companion binary handling by @satran004 in #174

New Contributors

• @euonymos made their first contribution in #132
• @Quantumplation made their first contribution in #138
• @piyushthapa made their first contribution in #165
• @rober-m made their first contribution in #172

Full Changelog: v0.11.0-beta1...v0.12.0-beta5

v0.11.0-beta1

🚀 Yaci DevKit v0.11.0-beta1

✨ What's New

⏱️ Sub-second Block Times (New)

• Ultra-fast development with 100ms/200ms blocks
• 📖 Learn more

🔄 Rollback Testing (New)

• Simulate chain reorganizations and network partitions
• Consensus-based and database snapshot rollbacks
• 📖 Rollback Testing Guide

🔧 Improvements

• Updated Yaci Viewer with Rewards (AdaPot) and Governance data pages
• Updated components: Cardano Node 10.5.0, Yaci Store 2.0.0-beta3, Ogmios 6.13.0, Kupo 2.11.0

⚠️ Known Issues

• Plutus V2 may fail with Lucid Evolution for default configuration (workaround available)

🚀 Quick Start

# Sub-second blocks (100ms)
yaci-cli> create-node --block-time 0.1 --slot-length 0.1 -o --start

# Rollback testing
yaci-cli> create-node --enable-multi-node --block-time 2 -o --start

yaci-cli> create-forks
yaci-cli> tip
yaci-cli> topup addr_test1.... 
yaci-cli> join-forks

What's Changed

• Add rollback simulation support via DB snapshot and TCP proxy-based fork creation in Yaci CLI + Improve APIs with Swagger annotations by @satran004 in #128
• Fix 105 by @satran004 in #123
• Refactor cluster start time calculation logic for millisecond block by @satran004 in #129
• Node-10.5.0 & Switch to JSON-based configuration and update dependencies + Ogmios, Kupo, Yaci Store upgrade by @satran004 in #119
• Feat/viewer AdaPot, Gov state, epoch stake pages by @satran004 in #118
• Update Yaci Store version, fix yaci-store jar download handling, rollback enhancements by @satran004 in #130

Full Changelog: v0.10.6...v0.11.0-beta1

v0.10.6

Overview

This is the stable release of 0.10.6, following the 0.10.6-beta. No new features or fixes have been introduced since the beta.

For the complete list of features, bug fixes, and enhancements introduced in 0.10.6-beta, see the beta release notes:
Yaci DevKit 0.10.6-beta Release Notes

v0.10.6-beta

Fixes

• Lucid Evolution Plutus V3 issue with Blockfrost provider (Yaci Store's Blockfrost-compatible endpoints) #120
• Yaci Store 2.0.0-beta1

Note: Non-Docker Version (NPM, Yaci CLI Zip Distribution)

• As this version includes an update to Yaci Store, you need to remove any existing ~/.yaci-cli/ directory first.

Known Limitation:

• The non-Docker Linux version works on Ubuntu 22.04 or later and macOS 14 (Arm64) or later

NPM Distribution

To install the latest beta of yaci-devkit

sudo npm install -g @bloxbean/yaci-devkit@beta

Supported on Linux (Ubuntu 22.04 and later) and macOS 14 (Arm64) or later

Docker Zip Distribution

• Download yaci-devkit-0.10.6-beta.zip or use CURL-based installation by passing the version number.

More info on how to use Yaci Devkit check https://devkit.yaci.xyz

v0.10.5

What's Changed

• New admin endpoint to create node with different configurations #110
• Fix start time format in shelley genesis
• Upgrade Ogmios to 6.11.2 by @satran004 in #112
• Added missing fields in Yaci Store's latest epoch endpoint (Only available in DevKit Docker distribution)

Full Changelog: v0.10.2...v0.10.5

v0.10.2

Key Highlights

• Upgrade Component Versions:

  • Node: 10.1.4
  • Ogmios: 6.11.0
  • Kupo: 2.10.0

• Configuration Updates:

  • Default Configuration and parameter values have been adjusted to mainnet settings following the Plomin Hard Fork.
    • Protocol Version: 10.2
    • Cost Models: Updated

• New NPM Distribution (Beta):

  • Supported on Linux x86 and Mac OS ARM
  • More details can be found at: https://devkit.yaci.xyz/yaci_cli_npm_distr

For other changes in version 0.10.2, please refer to the release notes of 0.10.x preview releases.

What's Changed

• Provide instructions to remove quarantine on Mac OS by @abailly in #97
• Update node (10.1.4), Ogmios (6.11.0), Kupo (2.10.0) and protocol version (10.2) by @satran004 in #103
• fix: #99 Interrupt download gracefully on ctrl+c by @satran004 in #104

New Contributors

• @abailly made their first contribution in #97

Full Changelog: v0.10.0-preview5...v0.10.2

v0.10.1

Bump version for next release

v0.10.0-preview5

What's Changed

• Yaci Viewer with non docker Yaci CLI by @satran004 in #95
• #90 New admin endpoint to get genesis hash by @satran004 in #92
• Kill any previously running processes before starting yaci-cli. by @satran004 in #96

Full Changelog: v0.10.0-preview4...v0.10.0-preview5

v0.10.0-preview4

What's Changed

• feat: add some lucid evolution infos about time management by @Proxiweb in #80
• Update configurations for GraalVM compatibility by @satran004 in #82
• update docs by @jinglescode in #84
• initial NPM layout by @SebastienGllmt in #85
• Update Cardano Node version to 10.1.3 / Cost model update by @satran004 in #83
• Changes in default genesis files for Dolos compatibility by @satran004 in #88
• [NPM] "up" command to create-node, start and tail in one step by @satran004 in #89

New Contributors

• @SebastienGllmt made their first contribution in #85

Full Changelog: v0.10.0-preview2...v0.10.0-preview4

rel-cli-0.10.0-preview3-dev1

Update version for a dev build