Developer on Solo

Using Solo with Hiero JavaScript SDK

Mon, 01 Jan 0001 00:00:00 +0000

Overview

The Hiero JavaScript SDK lets you build and test applications on the Hiero network using JavaScript or TypeScript. This guide walks you through launching a local Solo network, creating a funded test account, connecting the SDK, and running example scripts to submit your first transaction.

Prerequisites

Before proceeding, ensure you have completed the following:

System Readiness:
- Your local environment meets all hardware and software requirements, including Docker, kubectl, and Solo.

Using Solo with EVM Tools

Mon, 01 Jan 0001 00:00:00 +0000

Overview

Hiero is EVM-compatible. The Hiero JSON-RPC relay exposes a standard Ethereum JSON-RPC interface on your local Solo network, letting you use familiar EVM tools without modification.

This guide walks you through:

Launching a Solo network with the JSON-RPC relay enabled.
Retrieving ECDSA accounts for EVM tooling.
Creating and configuring a Hardhat project against the relay.
Deploying and interacting with a Solidity contract.
Verifying transactions via the Explorer and Mirror Node.
Configuring ethers.js and MetaMask.

Prerequisites

Before proceeding, ensure you have completed the following:

Attach JVM Debugger and Retrieve Logs

Mon, 01 Jan 0001 00:00:00 +0000

Overview

This guide covers three debugging workflows:

Retrieve logs from a running consensus node using k9s or the Solo CLI
Attach a JVM debugger in IntelliJ IDEA to a running or restarting node
Save and restore network state files to replay scenarios across sessions

Prerequisites

Before proceeding, ensure you have completed the following:

System Readiness — your local environment meets all hardware and software requirements.
Quickstart — you have a running Solo cluster and are familiar with the basic Solo workflow.

You will also need:

Using Solo

Mon, 01 Jan 0001 00:00:00 +0000

Community Contributions

Mon, 01 Jan 0001 00:00:00 +0000

How to Contribute to Solo

This document describes how to set up a local development environment and contribute to the Solo project.

Prerequisites

Node.js (use the version specified in the repository, if applicable)
npm
Docker or Podman
Kubernetes (local cluster such as kind, k3d, or equivalent)
task (Taskfile runner)
Git
K9s (optional)

Initial setup

Clone the repository:

git clone https://github.com/hiero-ledger/solo.git
cd solo

Install dependencies:

Solo CI Workflow

Mon, 01 Jan 0001 00:00:00 +0000

Overview

This guide walks you through integrating Solo into a GitHub Actions CI pipeline - covering runner requirements, tool installation, and automated network deployment. Each step installs dependencies directly in the workflow, since CI runners are fresh environments with no pre-installed tools.

Prerequisites

Before proceeding, ensure you have completed the following:

System Readiness — your local environment meets all hardware and software requirements.
Quickstart — you are familiar with the basic Solo workflow and the solo one-shot single deploy command.

This guide assumes you are integrating Solo into a GitHub Actions workflow where each runner is a fresh environment. The steps below install all required tools directly inside the workflow rather than relying on pre-installed dependencies.