IDAC Testnet Quickstart

Table of Contents

1. Prerequisites
2. Usage
3. Troubleshooting
4. License

Prerequisites

To run this quickstart, ensure the following dependencies are installed:

• Docker and Docker Compose v2 or higher
• Node.js (v18+) or Yarn

⚠️ Note: On macOS or Windows, allocate at least 4 GB of RAM to Docker (or 6 GB if running privacy examples).
See Docker for Mac or Docker Desktop under the “Resources” section.

⚠️ Note: Tested on Windows 10 Build 19045, WSL2, and Docker Desktop.
On Windows, use WSL2 kernels ≥ 5.15x. You may use either Docker Desktop or docker-engine with the compose plugin inside WSL2.

Usage

Generate the Docker Compose files and network configuration using:

npx idac-testnet

This launches the interactive setup utility:

              ___
 █████ ██████████     █████████     █████████      █████████  ██████████ ███████████ █████  █████ ███████████ 
▒▒███ ▒▒███▒▒▒▒███   ███▒▒▒▒▒███   ███▒▒▒▒▒███    ███▒▒▒▒▒███▒▒███▒▒▒▒▒█▒█▒▒▒███▒▒▒█▒▒███  ▒▒███ ▒▒███▒▒▒▒▒███
 ▒███  ▒███   ▒▒███ ▒███    ▒███  ███     ▒▒▒    ▒███    ▒▒▒  ▒███  █ ▒ ▒   ▒███  ▒  ▒███   ▒███  ▒███    ▒███
 ▒███  ▒███    ▒███ ▒███████████ ▒███            ▒▒█████████  ▒██████       ▒███     ▒███   ▒███  ▒██████████ 
 ▒███  ▒███    ▒███ ▒███▒▒▒▒▒███ ▒███             ▒▒▒▒▒▒▒▒███ ▒███▒▒█       ▒███     ▒███   ▒███  ▒███▒▒▒▒▒▒  
 ▒███  ▒███    ███  ▒███    ▒███ ▒▒███     ███    ███    ▒███ ▒███ ▒   █    ▒███     ▒███   ▒███  ▒███        
 █████ ██████████   █████   █████ ▒▒█████████    ▒▒█████████  ██████████    █████    ▒▒████████   █████       
▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒   ▒▒▒▒▒   ▒▒▒▒▒   ▒▒▒▒▒▒▒▒▒      ▒▒▒▒▒▒▒▒▒  ▒▒▒▒▒▒▒▒▒▒    ▒▒▒▒▒      ▒▒▒▒▒▒▒▒   ▒▒▒▒▒        

Welcome to the IDAC Testnet Setup utility. This tool helps you quickly generate local IDAC blockchain networks for development using Hyperledger Besu, GoQuorum, and Tessera.

Which Ethereum client would you like to run? Default: [1]
  1. Hyperledger Besu
  2. GoQuorum
  ...
  Do you wish to enable support for private transactions? [Y/n]
  ...
  Do you wish to enable logging with Loki, Splunk, or ELK? Default: [1]
  ...
  Where should we create the config files? Default: ./idac-testnet

Once complete, your artifacts will be created at:

./idac-testnet

Change directory into the generated folder:

cd idac-testnet

CLI Options

You can skip the interactive prompts by passing arguments directly:

npx idac-testnet --clientType besu --outputPath ./idac-testnet --monitoring loki --privacy true

| Option | Description | |--------|--------------| | --clientType | Selects besu or goquorum (required) | | --privacy | Enables Tessera private transactions | | --outputPath | Target directory for artifacts | | --monitoring | Enables loki, elk, or splunk logging (default: loki) |

Starting the Network

To start the containers:

docker compose up -d

Follow the network-specific README for details:

1. Hyperledger Besu
2. GoQuorum

Troubleshooting

Besu — “Permission denied” for volumes

If you encounter:

java.io.IOException: Permission denied

The besu container runs as user 1000.
Fix by mapping your host user ID in the Docker Compose file:

user: "${UID:-1000}:${GID:-1000}"

Tessera image not found on macOS (platform mismatch)

You might see:

failed to solve: quorumengineering/tessera:23.4.0: no match for platform in manifest

Modify the FROM statement in idac-testnet/config/tessera/Dockerfile to:

FROM --platform=linux/amd64 quorumengineering/tessera:${TESSERA_VERSION}

Cleanup and Rebuild

If a build fails or network state becomes inconsistent:

docker compose down -v
docker system prune -f
npx idac-testnet

License

Licensed under the Apache License 2.0.
See LICENSE for full terms.

Copyright © 2025 DIGITAS PLT

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
in compliance with the License. You may obtain a copy of the License at:

   http://www.apache.org/licenses/LICENSE-2.0

IDAC Testnet — Build. Test. Verify. Scale.