Yaci Store Zip Distribution (JARs)

Filename: yaci-store-<version>.zip

Includes:

yaci-store.jar
yaci-store-ledger-state.jar
Config files (application.properties)

Pre-requisites

Java 21 or Java 24 (Recommended)

You can use sdkman to install Java 21 or 24.


sdk install java 24.0.1-tem
sdk use java 24.0.1-tem

Check if JAVA_HOME env variable is set correctly:


echo $JAVA_HOME

Edit Config

Edit application.properties to set the Cardano network and Database connection settings
Check the following properties and update them accordingly


store.cardano.host=preview-node.world.dev.cardano.org
store.cardano.port=30002
store.cardano.protocol-magic=2


spring.datasource.url=jdbc:postgresql://localhost:5432/yaci_indexer?currentSchema=preview
spring.datasource.username=user
spring.datasource.password=password

Usage

To run Yaci Store (without ledger-state):


./bin/start.sh

To enable ledger-state calculation with all other on-chain data:


./bin/start.sh ledger-state

To run Ledger State App only:


./bin/start-ledger-state.sh

If ledger state is enabled, verify the log message to ensure that ledger-state calculation is active

While running Yaci Store with ledger-state calculation enabled, you may see logs similar to the example below, indicating that address balance calculation is active — which is required for ledger-state calculation.


 # of blocks written: 100, Time taken: 25 ms
Block No: 4746  , Era: Shelley
### Starting account balance calculation upto block: 4846 ###
 	Total Stake Address Balance records 0, Time taken to save: 0
 	Time taken to delete stake address balance history: 0
### Total balance processing and saving time 1 ###

 # of blocks written: 100, Time taken: 28 ms
 Block No: 4846  , Era: Shelley
### Starting account balance calculation upto block: 4946 ###
 	Total Stake Address Balance records 0, Time taken to save: 0
 	Time taken to delete stake address balance history: 0
### Total balance processing and saving time 1 ###

Apply Optional Indexes

After the initial sync is complete:


./bin/yaci-cli.sh

This launches the Admin CLI (yaci-store-admin-cli.jar). At the CLI prompt:


yaci-store> apply-indexes