Releases: bloxbean/yaci-devkit
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.zipor 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
- Default Configuration and parameter values have been adjusted to mainnet settings following the Plomin Hard Fork.
-
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
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
v0.10.0-preview2
This preview release introduces Yaci Store's native binary support for both Docker and non-Docker distributions, along with added support for an external PostgreSQL database for the default indexer.
What's Changed
- [Non-Docker] Yaci Store native image / Ogmios 6.9.0 - by @satran004 in PR #77
- External PostgreSQL Support - by @satran004 in PR #79
Details
1. Native Yaci Store in Non-Docker Distribution
The non-Docker distribution of Yaci CLI now supports Yaci Store's native binary, providing faster startup times and lower memory usage.
To use Yaci DevKit's non-Docker distribution:
- Download the platform-specific
yaci-cli-*.zip. - Run
yaci-cli. - Use the
downloadcommand to download required components.
For more details about the non-Docker distribution, refer to the documentation.
2. External PostgreSQL Database Support for Yaci Store (Indexer)
Yaci DevKit's default indexer uses an embedded H2 database. Now, you can also configure an external PostgreSQL database.
For Non-Docker Distribution:
Edit config/application.properties and uncomment the following properties to set PostgreSQL database details:
yaci.store.db.url=jdbc:postgresql://<dbhost>:<dbport>/<dbname>?currentSchema=<schema_name>
yaci.store.db.username=user
yaci.store.db.password=password
For Docker Distribution:
Edit config/env and uncomment the following properties:
yaci_store_db_url=jdbc:postgresql://<dbhost>:<dbport>/<dbname>?currentSchema=<schema_name>
yaci_store_db_username=user
yaci_store_db_password=password
After editing the configuration, restart the DevKit container using the start command.
Note: For Docker setups, if the PostgreSQL database is on the same host as the DevKit container, use the correct hostname (e.g., host.docker.internal on macOS or 172.17.0.1 on Linux) instead of localhost.
Useful Commands for PostgreSQL Configuration
-
Schema Drop Command: When using commands like
resetorcreate-node -o, the existing indexer database is removed. If PostgreSQL encounters issues dropping the schema, useyaci-store-drop-db. If this command doesn’t resolve the issue, you may need to drop the schema manually. -
Checking Yaci Store Indexer Status: For local devnet setups with PostgreSQL, monitor the Yaci Store indexer using the
yaci-store-logscommand. If startup fails due to a non-empty database, manually clean the database.
For non-Docker setups, you can directly check the Yaci Store log files in ~/.yaci-cli/components/store/logs/yaci-store.log.
Full Changelog: v0.10.0-preview1...v0.10.0-preview2