Skip to main content

Introduction

Overview​

Cardano Rosetta Java is a lightweight Java implementation of the Rosetta API for the Cardano blockchain. This implementation follows the Rosetta API specification and is compatible with the Rosetta CLI, while including specific extensions to accommodate Cardano's unique features.

Architecture​

The Cardano Rosetta Java implementation consists of four key components:

  • Cardano Node: A full Cardano node processing and validating blockchain data
  • Cardano Submit API: An API for transaction submission to the Cardano network
  • Indexer: A Yaci-Store based indexer that stores blockchain data in PostgreSQL
  • Rosetta API: The implementation of the Mesh (formerly Rosetta) API specification

System Requirements​

As Yaci-Store is relatively lightweight compared to other chain indexers, the system requirements are:

  • 4 CPU Cores
  • 32GB RAM
  • Storage:
    • 1TB (with pruning disabled - default)
    • 400GB (with pruning enabled)

Better hardware resources will improve indexer and node performance, resulting in faster chain synchronization.

Getting Started​

The simplest way to run Cardano Rosetta Java is using Docker. You can either:

  • Build from source
  • Use pre-built images from the Cardano Foundation DockerHub repository
  • Deploy using Docker Compose

Detailed installation and configuration instructions are available in the Getting Started with Docker section of this documentation.