diff --git a/LICENSE b/LICENSE
index a18e37fd..118d4e62 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,6 +1,6 @@
MIT License
-Copyright (c) 2023 BloxBean
+Copyright (c) 2025 BloxBean
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
diff --git a/README.md b/README.md
index 0ad92528..642ad7ec 100644
--- a/README.md
+++ b/README.md
@@ -1,336 +1,285 @@
-
A set of development tools for building on Cardano by creating a local devnet.
-
-
-# What's Yaci DevKit
-
-Say goodbye to lengthy iterations and hello to lightning-fast feedback loops. With **Yaci DevKit**, developers can accelerate
-their progress by leveraging a custom Cardano devnet that can be created and destroyed in a matter of seconds.
-
-Powered by the user-friendly **Yaci CLI**, the devnet can be easily reset with a single command. This means you can iterate,
-experiment, and refine your code without any hassle.
-
-Tailor your devnet to suit your specific needs using the flexible configuration options available through the CLI. While
-the default devnet is optimized for speed, with a 1-second block time, 1-second slot, and 500 slots per epoch, you have the
-freedom to customize these parameters. For instance, if you're focusing on stake registration, delegation, and reward withdrawal
-transactions, creating a devnet with 30-second slots allows you to test these operations within a timeframe of 120-150 seconds.
-
-But Yaci DevKit goes beyond just providing a devnet. It equips you with a lightweight chain indexer called **"Yaci Store"** and
-a user-friendly browser-based viewer called **"Yaci Viewer"**. Seamlessly integrated into the DevKit, these components empower
-you to build and submit transactions effortlessly.
-
-Yaci DevKit also includes [Ogmios](https://ogmios.dev/) and [Kupo](https://cardanosolutions.github.io/kupo/). Both Ogmios
-and Kupo are optional and can be activated by enabling a specific flag. Thus, if your client SDK supports either Ogmios or Kupo,
-you can utilize them to submit transactions to your local cluster.
-
-Deploying Yaci DevKit is a breeze with the Docker Compose package, making setup and configuration a hassle-free experience.
-Manage the entire process using simple commands such as "**start**," "**stop**," and "**reset**," giving you full control over your development
-environment.
-
-Yaci DevKit's chain indexer exposes required Blockfrost compatible API endpoints, enabling seamless integration with client SDKs like
-**Cardano Client Lib (Java)** or [**Mesh SDK**](https://meshjs.dev/). With the ability to effortlessly build and submit transactions to the Devnet through the
-Blockfrost provider, your development possibilities are boundless.
-
-# Components
-
-Yaci DevKit docker-compose has following components
-
-1. [Yaci CLI](./applications/cli) - A CLI to create/manage a local cluster and other utilities
-2. [Yaci Store](https://github.com/bloxbean/yaci-store) - A lightweight indexer with H2 DB
-3. [Yaci Viewer](./applications/viewer) - A minimal blockchain data viewer for developers
-4. Cardano Node
-5. Ogmios (Optional)
-6. Kupo (Optional)
-
-Yaci DevKit provides API endpoints that can be used in your off-chain code (e.g., a Java app, MeshJS app) to post transactions to your local cluster.
-
-# Urls
-
-**Yaci Viewer** : http://localhost:5173 (Browser)
-
-**Yaci Store Swagger UI** : http://localhost:8080/swagger-ui.html (Browser)
-
-**Yaci Store Api URL** : http://localhost:8080/api/v1/
-(Can be used in a Java app with Cardano Client Lib's Blockfrost backend or [Javascript app with MeshJS + Blockfrost provider](https://github.com/MeshJS/examples/blob/main/mesh/yaci-send-lovelace.ts) as it exposes required BF compatible minimum apis for tx building and submission)
-
-**Ogmios Url (Optional)** : ws://localhost:1337
-
-**Kupo Url (Optional)** : http://localhost:1442
-
-### Node Ports
-**n2n port** : localhost:3001
-
-**n2c port for remote client (socat)** : localhost:3333
-
-# Components
-- [Yaci CLI](./applications/cli)
-- [Yaci Viewer](./applications/viewer)
-- [Yaci Store](https://github.com/bloxbean/yaci-store)
-- [Cardano Node](https://cardano.org/)
-- [Ogmios](https://ogmios.dev/)
-- [Kupo](https://cardanosolutions.github.io/kupo/)
-
-**Note:** Includes Cardano Node binaries for both amd64 and arm64. arm64 binary is from [Armada Alliance](https://github.com/armada-alliance/cardano-node-binaries)
- (Include both amd64 and arm64 binaries)
-
-# Documentation
-
-Check the [Yaci DevKit Documentation site](https://devkit.yaci.xyz/) for more details.
-
-You can also check [Mesh SDK](https://meshjs.dev/yaci/getting-started) for tooling to interact with Yaci DevKit.
-
-# How to Run
-
-## Pre-requisites
-
-- Docker Compose
+
Complete Cardano development environment with instant local devnet
-## Get Yaci DevKit
+[](https://github.com/bloxbean/yaci-devkit/releases)
+[](https://hub.docker.com/r/bloxbean/yaci-cli)
+[](https://www.npmjs.com/package/@bloxbean/yaci-devkit)
+[](https://github.com/bloxbean/yaci-devkit/releases)
+[](LICENSE)
-### Download the latest zip from release section
-
-Download the latest zip from [release section](https://github.com/bloxbean/yaci-devkit/releases) and unzip it.
-
-## DevKit Script
-You can find `devkit.sh` script under the `bin` folder. This script is used to manage the DevKit containers and Yaci CLI.
-
-```shell
-Options:
- start Start the DevKit containers and CLI.
- stop Stop the DevKit containers.
- cli Query the Cardano node in the DevKit container using cardano-cli.
- ssh Establish an SSH connection to the DevKit container.
- info Display information about the Dev Node.
- version Display the version of the DevKit.
- help Display this help message.
-
-```
+
-## To start the DevKit docker compose
+## ๐ What is Yaci DevKit?
-To start the DevKit containers and yaci-cli.
+**Yaci DevKit** is a comprehensive Cardano development toolkit that provides developers with a complete local blockchain environment. Create, customize, and manage your own Cardano devnet in seconds, enabling rapid development and testing of DApps, smart contracts, and blockchain integrations.
-```shell
-./bin/devkit.sh start
-```
+### โจ Key Features
-**Note:** If you have some **ports** already in use, please make sure the mentioned ports in ```config/env``` file are free.
-You can also change the ports in ```config/env``` file. Any changes to ```env``` file will be applied when you restart the docker compose.
+- **โก Instant Devnet Creation** - Launch a complete Cardano network in seconds
+- **๐๏ธ Flexible Configuration** - Customize block times, epochs, eras, and network parameters
+- **๐ Rollback Testing** - Advanced rollback simulation for robust application testing *(New in v0.11.0-beta1)*
+- **โฑ๏ธ Sub-second Block Times** - Support for ultra-fast development with sub-second block times. e.g; 100ms, 200ms *(New in v0.11.0-beta1)*
+- **๐ Multi-node Support** - Enable multiple nodes specifically for rollback testing scenarios
+- **๐ Built-in Indexer** - Integrated Yaci Store with Blockfrost-compatible APIs
+- **๐ฏ Developer Tools** - Browser-based viewer, CLI management, and extensive APIs
+- **๐ SDK Integration** - Seamless integration with popular Cardano SDKs (Mesh, CCL, Lucid Evolution)
-## Update config/env file to fund test accounts (Optional)
+## ๐๏ธ Architecture
-Update ```env``` file to include your test Cardano addresses to automatically topup Ada.
+### Standard Single-node Setup (Default)
+For most development scenarios, Yaci DevKit runs a single Cardano node:
```
-topup_addresses=:,
+โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
+โ Yaci Viewer โ โ Your DApp โ โ Yaci CLI โ
+โ (Web UI) โ โ (Frontend) โ โ (Management) โ
+โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
+ โ โ โ
+ โโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโ
+ โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+โ API Layer โ
+โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โ
+โ โ Yaci Store โ โ Ogmios โ โ Kupo โ โ
+โ โ (Indexer) โ โ (Optional) โ โ (Optional) โ โ
+โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+ โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+โ Single Cardano Node โ
+โ โโโโโโโโโโโโโโโโโโโโโโโ โ
+โ โ Node 1 โ โ
+โ โ (Producer) โ โ
+โ โโโโโโโโโโโโโโโโโโโโโโโ โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
-**Example**
+### Multi-node Setup (Rollback Testing Only)
+When `--enable-multi-node` is used, DevKit creates a 3-node cluster for rollback testing:
```
-topup_addresses=addr_test1qzlwg5c3mpr0cz5td0rvr5rvcgf02al05cqgd2wzv7pud6chpzk4elx4jh2f7xtftjrdxddr88wg6sfszu8r3gktpjtqrr00q9:20000,addr_test1qqwpl7h3g84mhr36wpetk904p7fchx2vst0z696lxk8ujsjyruqwmlsm344gfux3nsj6njyzj3ppvrqtt36cp9xyydzqzumz82:10000
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+โ Multi-node Cluster โ
+โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โ
+โ โ Node 1 โ โ Node 2 โ โ Node 3 โ โ
+โ โ (Producer) โ โ (Producer) โ โ (Producer) โ โ
+โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
-**Important:** After updating env file, you need to restart the docker compose using ```devkit.sh stop``` and ```devkit.sh start``` options.
+## ๐ Current Releases
-**Note:** You can also use the ``topup`` command in Yaci CLI to fund your test addresses later.
+๐ **Latest Stable Release**: **[v0.10.6](https://github.com/bloxbean/yaci-devkit/releases/tag/v0.10.6)**
-## Enable Ogmios and Kupo Support (Optional)
-Yaci DevKit bundles both Ogmios and Kupo. However, Kupo is not enabled by default. To activate both Ogmios and Kupo support,
-set `ogmios_enabled` & `kupo_enabled` flag in `env` file to true. Alternatively, you can enable both Ogmios & Kupo support using ``enable-kupomios`` command in Yaci CLI.
+๐งช **Latest Beta Release**: **[v0.11.0-beta1](https://github.com/bloxbean/yaci-devkit/releases/tag/v0.11.0-beta1)**
-## To stop DevKit
+## ๐ฆ Components
-Use `devkit.sh` script to stop the DevKit containers.
+| Component | Description | Default Port |
+|-----------|-------------|--------------------------------------|
+| **[Yaci CLI](./applications/cli)** | Command-line interface for devnet management | - |
+| **[Yaci Store](https://github.com/bloxbean/yaci-store)** | Lightweight indexer with Blockfrost-compatible APIs | 8080 |
+| **[Yaci Viewer](./applications/viewer)** | Web-based blockchain explorer for developers | 5173 |
+| **Cardano Node** | Official Cardano node (supports both amd64/arm64) | 3001 (n2n), 3333 (n2c through socat) |
+| **[Ogmios](https://ogmios.dev/)** | WebSocket API for Cardano (optional) | 1337 |
+| **[Kupo](https://cardanosolutions.github.io/kupo/)** | Chain indexer focusing on patterns (optional) | 1442 |
-```shell
-./bin/devkit.sh stop
-```
+## ๐ฏ Quick Start
-## Yaci CLI - Few Key Commands
+### Prerequisites
-This section explains a few key commands specific to Yaci CLI.
+- **Docker** and **Docker Compose** for Docker based distribution
-### Create a default devnet
+### Installation
-```
-yaci-cli:>create-node
-```
-To overwrite data or reset the existing default devnet, use the "-o" flag.
-Use --start flag to start the devnet after creation.
+Yaci DevKit offers multiple distribution options to fit your development workflow:
-```
-yaci-cli:>create-node -o
-or,
-yaci-cli:>create-node -o --start
-```
+#### Option 1: Docker Zip Distribution
+#### Option 2: Yaci CLI Zip Distribution (Non-Docker)
+#### Option 3: NPM Distribution (CI/CD Ready)
-**Known Issue:** Yaci DevKit uses a share folder to store the data on host machine. In some setup, this causes issue due to permission.
-If you face similar issue and not able to start the devnet, you can remove ``volumes`` section from ``docker-compose.yml`` file and restart the docker compose.
-It should work fine and create the devnet data in the docker container itself. Please check this [issue](https://github.com/bloxbean/yaci-devkit/issues/11) for more details.
-#### Create a default devnet node with Conway Era
+#### Option 1: Docker Zip Distribution
-By default, Yaci DevKit creates a devnet with **Babbage** era. If you want to create a devnet with **Conway** era, use the following command.
+Download and unzip the latest docker distribution.
+```bash
+#
+# Start DevKit
+./bin/devkit.sh start
```
-yaci-cli:>create-node -o --era conway
-```
-
-#### Create a devnet with custom slots per epoch
-To create devnet with a custom slots per epoch (By default 500 slots/epoch)
-**For example:** Create and start a devnet with 30 slots per epoch
+#### Option 2: Yaci CLI Zip Distribution (Non-Docker)
+Download and unzip the latest Yaci CLI distribution.
+```bash
+# Start Yaci CLI and download components
+./yaci-cli
```
-yaci-cli> create-node -o -e 30 --start
-
-```
-
-Now, you should be in the "devnet" context. To start the devnet, use the "start" command.
+#### Option 3: NPM Distribution (CI/CD Ready)
+๐ **Perfect for CI/CD pipelines and automated testing:**
+```bash
+# Global installation
+npm install -g @bloxbean/yaci-devkit
+yaci-devkit up --enable-yaci-store
+or
+yaci-devkit up --enable-kupomios
```
-devnet:default>start
-```
-
-**Note** Now, with Yaci Viewer, you can conveniently check the devnet's data right from the browser. Simply open the following URL
-in your browser to access the Yaci Viewer.
-http://localhost:5173
+**CI Integration Examples:**
+- โ **GitHub Actions** - Automated testing with DevKit
-### To reset cluster's data
+[๐ **CI Integration Guide**](https://devkit.yaci.xyz/ci-integration) | [๐ **Sample CI Project**](https://github.com/bloxbean/devkit-npm-ci-test)
-If your devnet gets stuck or you simply want to reset the data and restart with the same configuration, simply use the command "reset".
-It will restore your devnet to its initial state, allowing you to continue your development seamlessly.
+### Start Your First Devnet
-```
-devnet:default>reset
+```bash
+# Create and start a single-node devnet (default)
+yaci-cli> create-node -o --start
```
-### To stop
+๐ **That's it!** Your devnet is now running with:
+- **Yaci Viewer**: http://localhost:5173
+- **API Docs**: http://localhost:8080/swagger-ui/index.html
+- **Yaci Store API**: http://localhost:8080/api/v1/
-```
-devnet:default>stop
-```
+ (Can be used in a Java app with Cardano Client Lib's Blockfrost backend or [Javascript app with MeshJS + Blockfrost provider](https://github.com/MeshJS/examples/blob/main/mesh/yaci-send-lovelace.ts) as it exposes required BF compatible minimum apis for tx building and submission)
+- **Yaci Store Swagger UI**: http://localhost:8080/swagger-ui/index.html
+- **Ogmios Url (Optional)**: http://localhost:1337
-### To fund a new address
+**(Optional) If you enabled Kupo**
+- **Kupo Url (Optional)**: http://localhost:1442
-Easily fund your test account with ADA using the "topup" command.
+### Node Ports
+- **n2n port**: localhost:3001
+- **n2c port for remote client (socat)**: localhost:3333
-```shell
-devnet:default> topup
-```
+## ๐๏ธ Configuration Options
-### To check utxos at an address
+### Standard Development
+```bash
+# Default single-node setup (1 second blocks)
+yaci-cli> create-node -o --start
-```shell
-devnet:default> utxos
+# High-speed development (200ms blocks) - New in v0.11.0-beta1
+yaci-cli> create-node --block-time 0.2 --slot-length 0.2 -o --start
```
-### To get default addresses
+### Rollback Testing (Multi-node)
+```bash
+# Enable multi-node ONLY for rollback testing
+yaci-cli> create-node --enable-multi-node --block-time 2 -o --start
-```shell
-devnet:default> default-addresses
-```
+# Simulate network partition for rollback testing
+devnet:default> create-forks
-### To check devnet and url info
+# Submit transactions during fork...
+devnet:default> topup addr_test1... 1000
-```shell
-devnet:default> info
+# Trigger consensus-based rollback
+devnet:default> join-forks
```
-For more details about **Yaci CLI**, please check https://yaci-cli.bloxbean.com .
+> **Note**: Multi-node setup is specifically designed for rollback testing scenarios. For regular development, use the standard single-node setup which is faster and uses fewer resources.
-### Default Pool Id
+## ๐ง Development Workflow
-If you are testing pool delegation and reward withdrawal transaction in your application, you can use the following pool id
-which is already registered in the devnet.
+### 1. Fund Test Addresses
+```bash
+# Auto-fund addresses on startup (config/env)
+topup_addresses=addr_test1...:20000,addr_test1...:10000
-**pool1wvqhvyrgwch4jq9aa84hc8q4kzvyq2z3xr6mpafkqmx9wce39zy**
+# Or fund manually
+devnet:default> topup addr_test1qzx... 50000
-## Query Devnet's Cardano Node using cardano-cli
-
-DevKit script has a wrapper script to query the Cardano node running in the devnet. You can use this script to query the Cardano node like
-you usually do with cardano-cli command line tool. You don't need to install cardano-cli in your local machine or use protocol magic number in the command.
-
-**For example:**
-
-To query protocol parameters, you can use `cli` option with devkit script.
-
-```shell
-./bin/devkit.sh cli query protocol-parameters
+# Use default test addresses (always available)
+devnet:default> default-addresses
```
-### Videos
+### 2. Monitor Network State
+```bash
+# Check current tip
+devnet:default> tip
-#### 1. Yaci Viewer with Local Devnet and Cardano Client Lib Demo
+# View UTXOs at address
+devnet:default> utxos addr_test1...
-[](https://www.youtube.com/watch?v=rfwTuKXtqzg)
-
-#### 2. Test Aiken Smart Contract Using Java Offchain Code with Yaci DevKit
+# Get network info
+devnet:default> info
+```
-[](https://www.youtube.com/watch?v=PTnSc85t0Nk)
+### 3. Reset and Iterate
+```bash
+# Quick reset without losing configuration
+devnet:default> reset
-# Build From Source
-The Yaci DevKit comprises two main applications: Yaci CLI and Yaci Viewer. You can build these applications from source.
+# Full cleanup -- Docker distribution only
+./bin/devkit.sh stop
+./bin/devkit.sh start
+```
-The other components such as Yaci Store, Cardano Node, Ogmios, and Kupo are downloaded from their respective sources during the Docker build.
+## ๐ Documentation
-Both Yaci CLI and Yaci Viewer are located under the applications folder.
+| Resource | Description |
+|----------|-------------|
+| **[Official Documentation](https://devkit.yaci.xyz/)** | Complete guides |
+| **[Rollback Testing Guide](https://devkit.yaci.xyz/rollback-testing)** | Advanced rollback simulation |
+| **[Mesh SDK Integration](https://meshjs.dev/yaci/getting-started)** | JavaScript/TypeScript development |
+| **[CLI Commands Reference](https://devkit.yaci.xyz/commands)** | Available commands |
-## Build using Earthly
-This is the simplest way to build all components and create Docker images. You need to have [Earthly](https://earthly.dev/) installed on your machine.
+## ๐ฌ Video Tutorials
-### Pre-requisites
-- [Earthly](https://earthly.dev/get-earthly)
-- [Docker](https://www.docker.com/)
+| Tutorial | Description |
+|----------|-------------|
+| [](https://www.youtube.com/watch?v=rfwTuKXtqzg) | **Yaci Viewer with Local Devnet and Cardano Client Lib Demo** |
+| [](https://www.youtube.com/watch?v=PTnSc85t0Nk) | **Test Aiken Smart Contract Using Java Offchain Code** |
-### Build Docker Images using Earthly (For Local Development)
-- Clone the repository.
-- Edit the **version** file to update the `tag`. For a development build, you can use **dev** as the tag.
-- This tag will be used to tag the Docker images and also in the docker-compose.yml file.
-- Run the following Earthly command to build the Docker images:
+## ๐ ๏ธ Development
-```shell
+### Build from Source
+```bash
+# Using Earthly (recommended)
earthly --arg-file-path=config/version +build
-```
-This will build the Yaci DevKit Docker image from `application/cli` and the Yaci Viewer Docker image from `application/viewer`.
-
-### Run DevKit using the built images
-
-Once the images are built, you can run the DevKit using ``bin/devkit.sh`` script.
-
-### Build Docker Images using Earthly (GitHub Action)
-For GitHub Actions, we have a workflow file that builds the Docker images and pushes them to DockerHub.
-
-## Build Yaci CLI and Yaci Viewer separately
+# Manual build yaci-cli and yaci-viewer
+cd applications/cli && ./gradlew clean build
+cd applications/viewer && npm install && npm run build
+```
-Both Yaci CLI and Yaci Viewer can also be built separately using Java and NodeJS.
+### Requirements
+- **Java 21** (for Yaci CLI)
+- **Node.js** (for Yaci Viewer)
+- **Earthly** (for unified builds)
-### Yaci CLI
-#### Pre-requisites
-- Java 21
-- Gradle
+## ๐ค Community & Support
-Go to `applications/cli` folder and run the following command to build Yaci CLI.
+- **๐ [GitHub Discussions](https://github.com/bloxbean/yaci-devkit/discussions)** - Questions and ideas
+- **๐ [GitHub Issues](https://github.com/bloxbean/yaci-devkit/issues)** - Bug reports and feature requests
+- **๐ฌ [Discord Server](https://discord.gg/JtQ54MSw6p)** - Real-time community support
+- **๐ [Documentation](https://devkit.yaci.xyz/)** - Comprehensive guides
-```shell
-./gradlew clean build
-```
+## ๐ Why Choose Yaci DevKit?
-### Yaci Viewer
+| Traditional Development | With Yaci DevKit |
+|------------------------|-------------------|
+| โณ Wait for testnet transactions | โก Instant local transactions |
+| ๐ Depend on external testnets | ๐ Fully controlled environment |
+| ๐ Slow iteration cycles | ๐ Rapid development loops |
+| ๐ Manual rollback testing | ๐ฏ Automated rollback scenarios |
-Yaci Viewer is a Sveltejs application. Check this [README](applications/viewer/README.md) for more details.
+## ๐ License
+This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
-# Any questions, ideas or issues?
+---
-- Create a Github [Discussion](https://github.com/bloxbean/yaci-devkit/discussions)
-- Create a Github [Issue](https://github.com/bloxbean/yaci-devkit/issues)
-- [Discord Server](https://discord.gg/JtQ54MSw6p)
+
+**โญ Star this repo if Yaci DevKit helps accelerate your Cardano development!**
+[Documentation](https://devkit.yaci.xyz/) โข [Discord](https://discord.gg/JtQ54MSw6p)
+
+ Complete Cardano development environment with instant local devnet
+
+
+ Launch, customize, and manage your own Cardano blockchain in seconds.
+ Build DApps, test smart contracts, and integrate with popular SDKs using a lightning-fast local devnet.
+
+
+
+
+ Get Started
+
+
+ ๐ Documentation
+
+
+
+
+
+
โก
+
Instant Setup
+
+
+
๐
+
Built-in Indexer
+
+
+
๐
+
Rollback Testing
+
+
+
+
+
+
+
+
+
+
+
+ {/* Live Demo Section */}
+
+
+
+
๐ See Yaci DevKit in Action
+
Watch common yaci-cli commands execute in real-time
+
+
+
+ {/* Terminal 1: create-node */}
+
+
+
+
+
+
+
+
create-node
+
+
+
+ cli:>
+ create-node -o --start
+
+
+
Creating local devnet...
+
โ Node started on port 3001
+
โ Yaci Store on port 8080
+
โ Viewer on port 5173
+
โ Ogmios on port 1337
+
โ Kupo on port 1442
+
+
+
+
+ {/* Terminal 2: topup */}
+
+
+
+
+
+
+
+
topup
+
+
+
+ cli:>
+ topup addr_test1...90xn5f 6777
+
+
+
โ Transaction submitted successfully
+
โ Waiting for tx to be included in block...
+
โ Tx: d4f2a8b9c3e1...
+
+
+
+
+ {/* Terminal 3: tip */}
+
+
+
+
+
+
+
+
tip
+
+
+
+ cli:>
+ tip
+
+
+
Block#: 1242
+
Slot#: 1242
+
Hash: 8f7e6d5c...
+
+
+
+
+ {/* Terminal 4: utxos */}
+
+
+
+
+
+
+
+
utxos
+
+
+
+ cli:>
+ utxos addr_test1...90xn5f
+
+
+
1. d4f2a8b9... #0 6777โณ
+
2. d4f2a8b9... #1 1โณ
+
+
+
+
+
+
+
+ {/* Features Section */}
+
+
+
โจ Key Features
+
+
+
+
โก
+
Lightning Fast
+
Create and destroy a complete Cardano devnet in seconds. Sub-second block times supported (100ms, 200ms, etc.) with full configurability (default 1s).
+
+
+
+
๐๏ธ
+
Flexible Configuration
+
Customize block times, epochs, and network parameters to match your testing needs.
+
+
+
+
๐
+
Built-in Indexer
+
Integrated Yaci Store with Blockfrost-compatible APIs for seamless SDK integration.
+
+
+
+
๐
+
Multi-Distribution
+
Docker, ZIP, and NPM distributions. Perfect for local development and CI/CD pipelines.
+
+
+
+
๐
+
SDK Ready
+
Works seamlessly with Mesh.js, Cardano Client Lib, Lucid Evolution, and more.
+
+
+
+
๐
+
Rollback Testing
+
Advanced rollback simulation with consensus-based testing for robust application development.
+
+
+
+
+
+ {/* Distributions Section */}
+
+
+
๐ฏ Choose Your Distribution
+
Select the distribution that best fits your workflow
+
+
+
+
+
+
+ ๐ณ
+
+
+
+
Docker Distribution
+
+ Complete solution with all components. Perfect for local development with Docker Compose setup.
+
+
+ โ All-in-one
+ โ Easy setup
+
+
+
+ Getting Started โ
+
+
+
+
+
+
+
+
+ ๐ฆ
+
+
Non-Docker
+
+
+
ZIP Distribution
+
+ Standalone ZIP with Yaci CLI. Download and manage components directly without Docker.
+
+
+ โ No containers
+ โ Direct control
+
+
+
+ Getting Started โ
+
+
+
+
+
+
+
+
+
+
+
CI/CD Ready
+
+
+
NPM Distribution
+
+ NPM package perfect for automated testing, GitHub Actions, and continuous integration.
+
+
+ โ Auto testing
+ โ CI/CD native
+
+
+
+ Getting Started โ
+
+
+
+
+
+
+
+ {/* What's New Section */}
+
+
+
๐ฅ What's New in v0.11.0-beta1
+
+
+ ๐
+
+ Rollback Testing
+
Consensus-based rollback simulation
+
+
+
+ โฑ๏ธ
+
+ Sub-second Block Times
+
Support for 100ms, 200ms blocks and any custom interval (default 1s)