Skip to content

piotr-iohk/ikar

Repository files navigation

Ikar

A helper web-app and cli to test cardano-wallet.

Quick start

wget https://raw.githubusercontent.com/piotr-iohk/ikar/master/docker-compose.yml
NETWORK=mainnet docker-compose up

This immediately spins up:

  • cardano-node connected to mainnet
  • cardano-wallet on port 8090
  • ikar web-app on port 4444

Visit http://localhost:4444/, click Connect and play around!

ℹ️ With Ikar you can also connect to preview and preprod testnets. See Cardano Book for more information on environments.

Setup

If you already have cardano-wallet and cardano-node set up on your machine, you can connect Ikar to the stack as follows:

Via docker

Get latest release:

docker run --network=host --rm piotrstachyra/icarus:latest

Or play with current master branch:

docker run --network=host --rm piotrstachyra/icarus:master

or

From repository
  1. Have ruby.
  2. 👇
git clone https://github.com/piotr-iohk/ikar.git
cd ikar
bundle config set without 'development test'
bundle install
ruby app.rb

or

From repository with `nix`

Nix development shell provides required ruby and app depenencies. This command starts app:

nix develop -c ruby app.rb

Good! now visit http://localhost:4444/, click Connect and play around!

Releases

Releases have the same versions as cardano-wallet and should be compatible with them.

Developer Notes

Updating Gemfile requires regenerating Gemfile.lock and gemset.nix:

bundle lock
nix run nixpkgs#bundix