Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/blinklabs-io/cardano-compose-stacks
Docker compose files for Cardano blockchain services
https://github.com/blinklabs-io/cardano-compose-stacks
cardano cardano-db-sync cardano-node docker-compose
Last synced: about 1 month ago
JSON representation
Docker compose files for Cardano blockchain services
- Host: GitHub
- URL: https://github.com/blinklabs-io/cardano-compose-stacks
- Owner: blinklabs-io
- License: mit
- Created: 2023-09-12T15:05:50.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-16T14:34:54.000Z (about 1 month ago)
- Last Synced: 2024-11-16T15:28:12.541Z (about 1 month ago)
- Topics: cardano, cardano-db-sync, cardano-node, docker-compose
- Homepage:
- Size: 62.5 KB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# compose-stacks
This docker-compose setup provides a comprehensive environment for running Cardano related services. Below is a brief overview of the services and instructions on how to operate them.
## Services
- **cardano-node**: This is the main Cardano node service. It connects to the Cardano network specified by the NETWORK environment variable. By default, it connects to the `mainnet`.
- **cardano-node-api**: This service is responsible for interfacing with local Cardano node. It depends on the cardano-node service to be healthy before starting.
- **bursa**: This service is programatic wallet. It runs without any persistence.
- **ogmios**: This service is a lightweight bridge interface for cardano-node. It provides an HTTP / WebSocket API that enables applications to interact with a local cardano-node via JSON+RPC-2.0. It depends on the cardano-node service to be healthy before starting.
- **tx-submit-api**: This service is responsible for submitting transactions to the Cardano network. It depends on the cardano-node service to be healthy before starting.
- **cardano-db-sync**: This service syncs the Cardano blockchain data to a PostgreSQL database. It depends on both the cardano-node and postgres services to be healthy before starting.
- **postgres**: This is the PostgreSQL database service used by the cardano-db-sync service to store the Cardano blockchain data.
## How to Start Services
Because each service has defined dependency that means starting a service will also start it's dependencies.
### Using Profiles in Docker Compose
With profiles, you can selectively start services based on different needs or environments.
Below are examples of how to use profiles in this setup.
### Start Just the Cardano Node
To start only the `cardano-node` service, which is part of the `node` profile, run:
```bash
docker compose --profile node up
```
### Start Cardano Node and cardano-node-api
To start both the `cardano-node` and `cardano-node-api` use `node-api` profile, run:
```bash
docker compose --profile node-api up
```
### Start Cardano Node and tx-submit-api
To start both the `cardano-node` and `tx-submit-api` use `tx-submit-api` profile, run:
```bash
docker compose --profile tx-submit-api up
```
### Start Cardano Node and db-sync
To start both the `cardano-node` and `cardano-db-sync` use `db-sync` profile, run:
```bash
docker compose --profile db-sync up
```
### Start All Services in Detached Mode
To start all services defined in the `docker-compose.yml` file in detached mode, run:
docker compose up -d
This command will start all services (e.g., `cardano-node`, `tx-submit-api`, `cardano-db-sync`, and `postgres`) in the background, regardless of profiles.
If you need to stop the services later, use:
docker compose down
This will stop and remove all the services started with `docker compose up`.
If you've started specific services using profiles and want to stop them, you can specify the same profiles in the `down` command.
### How to Use Bursa
To start just the `bursa` service, which is part of the `bursa` profile, run:
```bash
docker compose --profile bursa up
```
**Access Swagger UI:**
Open your web browser and navigate to the Swagger UI:
**Execute a Create Request using Swagger UI:**
In the Swagger UI, find the section for creating a new wallet.
Click on the `Get` `/api/v1/wallet/create` operation.
Choose `Try it out`.
Click `Execute`.
This will send a create request to Bursa, and you should receive a JSON response with the details of the newly created wallet.
Store the mnemonic in a safe place. If you want to restore the wallet, you will need the mnemonic. If you lose the mnemonic, you will lose access to the wallet.
### How to Use Bluefin
To start just the `bluefin` service, which is part of the `bluefin` profile, run:
```bash
docker compose --profile bluefin up
```
to start the `bluefin-inspector` service, which is part of the `bluefin-inspector` profile, run:
```bash
docker compose --profile bluefin-inspector up
```
to start both the `bluefin` and `bluefin-inspector` services, use `bluefin` and `bluefin-inspector` profile, run:
```bash
docker compose --profile bluefin --profile bluefin-inspector up
```
to see the seed phrase of the wallet created by bluefin, run:
```bash
docker exec bluefin-inspector cat /data/seed.txt
```
Bluefin-inspector is a service that will allow you to see the seed phrase of the wallet created by bluefin.
Seed phrase will be stored and managed on the local filesystem of the Docker host.
The bluefin-inspector is setup to run for an 1h. After that, it will stop automatically.
You can restart it by running the command below.
```bash
docker compose --profile bluefin-inspector up -d --force-recreate
```