chore: prepare 1.3.0 release (#513)

Author: matiwinnetou

.env.IntegrationTest

@@ -140,4 +140,10 @@ DB_POSTGRES_JIT=off
 DB_POSTGRES_BGWRITER_LRU_MAXPAGES=50
 DB_POSTGRES_BGWRITER_DELAY=500ms
 
-SYNC_GRACE_SLOTS_COUNT=100
+SYNC_GRACE_SLOTS_COUNT=100
+
+## When set to true, the parsing / processing blockchain data even if an error occurs.
+CONTINUE_PARSING_ON_ERROR=false
+
+## Indexer sync starts after node is at tip. Set false for offline mode.
+SYNC=false

.env.docker-compose

@@ -1,6 +1,6 @@
 ## Main variables
 API_SPRING_PROFILES_ACTIVE=online
-LOG=INFO
+LOG=ERROR
 NETWORK=mainnet
 # mainnet, preprod, preview, devkit
 PROTOCOL_MAGIC=764824073
@@ -34,7 +34,7 @@ CARDANO_CONFIG=./config/node/${NETWORK}
 
 ## Mithril
 MITHRIL_SYNC=true
-MITHRIL_VERSION=2517.1
+MITHRIL_VERSION=2524.0
 SNAPSHOT_DIGEST=latest
 # if not set standard values will be used
 AGGREGATOR_ENDPOINT=
@@ -99,4 +99,10 @@ SYNC_GRACE_SLOTS_COUNT=100
 ## Monitoring variables
 PROMETHEUS_PORT=9090
 GRAFANA_PORT=3000
-POSTGRESQL_EXPORTER_PORT=9187
+POSTGRESQL_EXPORTER_PORT=9187
+
+## When set to true, the parsing / processing blockchain data even if an error occurs.
+CONTINUE_PARSING_ON_ERROR=true
+
+## Indexer sync starts after node is at tip. Set false for offline mode.
+SYNC=true

.env.docker-compose-preprod

@@ -30,11 +30,11 @@ NODE_SUBMIT_API_PORT=8090
 CARDANO_NODE_DIR=/opt/rosetta-java-preprod/node_data
 CARDANO_NODE_SOCKET_PATH=${CARDANO_NODE_DIR}/node.socket
 CARDANO_NODE_DB=${CARDANO_NODE_DIR}/db
-CARDANO_CONFIG=./config/${NETWORK}
+CARDANO_CONFIG=./config/node/${NETWORK}
 
 ## Mithril
 MITHRIL_SYNC=true
-MITHRIL_VERSION=2517.1
+MITHRIL_VERSION=2524.0
 SNAPSHOT_DIGEST=latest
 # if not set standard values will be used
 AGGREGATOR_ENDPOINT=
@@ -96,6 +96,12 @@ API_DB_LEAK_CONNECTIONS_WARNING_MS=60000
 
 SYNC_GRACE_SLOTS_COUNT=100
 
+## When set to true, the parsing / processing blockchain data even if an error occurs.
+CONTINUE_PARSING_ON_ERROR=false
+
+## Indexer sync starts after node is at tip. Set false for offline mode.
+SYNC=true
+
 ## Monitoring variables
 PROMETHEUS_PORT=9090
 GRAFANA_PORT=3000

.env.h2

@@ -95,4 +95,10 @@ DB_POSTGRES_BGWRITER_DELAY=500ms
 # Path to local cardano node socket (Yaci DevKit)
 CARDANO_NODE_SOCKET_PATH=${HOME}/.yaci-cli/local-clusters/default/node/node.sock
 
-SYNC_GRACE_SLOTS_COUNT=100
+SYNC_GRACE_SLOTS_COUNT=100
+
+## When set to true, the parsing / processing blockchain data even if an error occurs.
+CONTINUE_PARSING_ON_ERROR=false
+
+## Indexer sync starts after node is at tip. Set false for offline mode.
+SYNC=false

.env.h2-testdata

@@ -96,4 +96,10 @@ DB_POSTGRES_BGWRITER_DELAY=500ms
 # Path to local cardano node socket (Yaci DevKit)
 CARDANO_NODE_SOCKET_PATH=${HOME}/.yaci-cli/local-clusters/default/node/node.sock
 
-SYNC_GRACE_SLOTS_COUNT=100
+SYNC_GRACE_SLOTS_COUNT=100
+
+## When set to true, the parsing / processing blockchain data even if an error occurs.
+CONTINUE_PARSING_ON_ERROR=false
+
+## Indexer sync starts after node is at tip. Set false for offline mode.
+SYNC=false

CLAUDE.md

@@ -0,0 +1,67 @@
+Rosetta-Java Cardano Application — Development Guide (Context Window For AI Agents)
+
+✅ Overview
+
+This project is a Java implementation of the Rosetta specification, adapted from Coinbase’s original mesh. It targets the Cardano blockchain and is optimized for performance, scalability, and testability.
+
+⸻
+
+🛠️ Technologies & Standards
+•	Java 24 – Latest LTS features leveraged.
+•	Lombok – For reducing boilerplate (e.g., getters, constructors).
+•	Hibernate + JOOQ – A hybrid approach planned:
+•	Hibernate for standard ORM tasks.
+•	JOOQ for complex SQL operations.
+•	Hibernate for standard ORM needs.
+•	JOOQ for high-performance, complex SQL queries.
+•	Flywheel – Used for event-sourced state and domain logic.
+•	OpenAPI (api.yaml) – Contract-first approach:
+•	Edit src/main/resources/rosetta-specifications-1.4.15/api.yaml for API changes.
+•	Code generation tools automatically create request/response classes.
+•	No Spring RestControllers – All endpoints are generated from OpenAPI spec; avoid manually annotating endpoints.
+•	JUnit 5 with @Nested tests – Organize tests into logical groups.
+•	AssertJ – Preferred assertion framework for fluent and expressive assertions.
+
+⸻
+
+📋 Step-by-Step Context Window / Discovery
+
+1. Rosetta API Specification
+   •	Maintained in:
+   src/main/resources/rosetta-specifications-1.4.15/api.yaml
+   •	❗ All endpoints and models are generated, do not manually modify controller classes.
+
+2. Code Generation
+   •	Triggered via build tools (Gradle/Maven).
+   •	Output includes:
+   •	DTOs
+   •	Server interfaces
+   •	Clients
+   •	Ensures OpenAPI remains the single source of truth.
+
+3. Persistence Layer
+   •	Hibernate handles standard CRUD and entity management.
+   •	JOOQ will be used for:
+   •	Bulk operations
+   •	Deep filtering
+   •	Custom joins / window functions
+   •	Both work seamlessly alongside Flywheel event sourcing.
+
+4. Domain Logic with Flywheel
+   •	Domain state transitions are event-driven.
+   •	Promotes traceability and immutability.
+
+5. Testing Strategy
+   •	JUnit 5 with @Nested classes to:
+   •	Separate concerns within test files.
+   •	Improve readability and scope clarity.
+   •	AssertJ provides fluent API for:
+   •	Clean, expressive assertions.
+   •	Better failure messages than vanilla JUnit or Hamcrest.
+
+⸻
+
+📎 Notes
+•	Avoid using @RestController or manual API layer.
+•	All changes to API contract must be made in api.yaml.
+•	Lombok annotations (@Value, @Builder, @Getter, etc.) are preferred to minimize boilerplate.

README.md

@@ -5,6 +5,7 @@
 
 ## What the project is about?
 
+
 This repository provides a lightweight java implementation of the [Rosetta API](https://github.com/coinbase/mesh-specifications). It uses [Yaci-Store](https://github.com/bloxbean/yaci-store) as an indexer
 to fetch the data from a Cardano node.
 
@@ -99,15 +100,15 @@ For every Release we provide pre-built docker images stored in the DockerHub Rep
 To start it use the following command:
 
 ```bash
-    docker run --name rosetta -v {CUSTOM_MOUNT_PATH}:/node --env-file ./docker/.env.dockerfile --env-file ./docker/.env.docker-profile-mid-level -p 8082:8082 --shm-size=4g -d cardanofoundation/cardano-rosetta-java:1.2.10
+    docker run --name rosetta -v {CUSTOM_MOUNT_PATH}:/node --env-file ./docker/.env.dockerfile --env-file ./docker/.env.docker-profile-mid-level -p 8082:8082 --shm-size=4g -d cardanofoundation/cardano-rosetta-java:1.3.0
 ```
 
 Changes to the configuration can be made by adjusting the `docker/.env.dockerfile` file. For more information on the environment variables, please refer to the [documentation](https://cardano-foundation.github.io/cardano-rosetta-java/docs/install-and-deploy/env-vars).
 
 If you want to use the `cardano-submit-api` you can additionally expose port `8090`. It can then be used to submit raw cbor transaction (API documentation here: [Link](https://input-output-hk.github.io/cardano-rest/submit-api/))
 
 ```bash
-    docker run --name rosetta -v {CUSTOM_MOUNT_PATH}:/node --env-file ./docker/.env.dockerfile --env-file ./docker/.env.docker-profile-mid-level -p 8090:8090 -p 8082:8082 --shm-size=4g -d cardanofoundation/cardano-rosetta-java:1.2.10
+    docker run --name rosetta -v {CUSTOM_MOUNT_PATH}:/node --env-file ./docker/.env.dockerfile --env-file ./docker/.env.docker-profile-mid-level -p 8090:8090 -p 8082:8082 --shm-size=4g -d cardanofoundation/cardano-rosetta-java:1.3.0
 ```
 
 ### Docker compose

api/mvnw

@@ -275,6 +275,7 @@
                                 <sourceFolder>src/gen/java/main</sourceFolder>
                                 <useJakartaEe>true</useJakartaEe>
                                 <skipValidateSpec>true</skipValidateSpec>
+                                <useEnumCaseInsensitive>true</useEnumCaseInsensitive>
                                 <interfaceOnly>true</interfaceOnly>
                                 <!--suppress UnresolvedMavenProperty -->
                                 <additionalModelTypeAnnotations>@lombok.Builder @lombok.NoArgsConstructor

api/pom.xml

@@ -23,6 +23,7 @@
 @SpringBootApplication
 @EntityScan({
     "org.cardanofoundation.rosetta.api.account.model.entity",
+    "org.cardanofoundation.rosetta.api.error.model.entity",
     "org.cardanofoundation.rosetta.api.block.model.entity",
     "org.cardanofoundation.rosetta.api.construction.model.entity",
     "org.cardanofoundation.rosetta.api.network.model.entity",