chore: migrate hedera local node to solo (#1668) by BartoszSolkaBD · Pull Request #1675 · hashgraph/hedera-smart-contracts

BartoszSolkaBD · 2026-05-05T11:57:08Z

Description:

This PR migrates the repository from Hedera Local Node to Hiero Solo

Related issue(s):

Fixes #1668

Checklist

Documented (Code comments, README, etc.)
Tested (unit, integration, etc.)

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

swirlds-automation · 2026-05-05T11:57:24Z

✅ Snyk checks have passed. No issues have been found so far.

Status	Scan Engine	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues
✅	Licenses	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

github-actions · 2026-05-05T12:04:40Z

Test Results

133 tests ±0 131 ✅ ±0 8m 40s ⏱️ + 4m 54s
42 suites ±0 2 💤 ±0
8 files ±0 0 ❌ ±0

Results for commit ee3e58e. ± Comparison against base commit affbd3f.

This pull request removes 1 and adds 1 tests. Note that renamed tests count towards both.

should NOT be able to aggregate 200 calls to processLongInputTx ‑ Multicall Test Suite payable calls with large input should NOT be able to aggregate 200 calls to processLongInputTx

should NOT be able to aggregate 500 calls to processLongInputTx ‑ Multicall Test Suite payable calls with large input should NOT be able to aggregate 500 calls to processLongInputTx

♻️ This comment has been updated with latest results.

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

…description (#1668) Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

#1668) Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

#1668) Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

jasuwienas · 2026-05-08T10:53:05Z

The reason why we need port 50211 is the fact that we ignore our own configuration from local.env. If you use correct ports in Helper.buildSdkClient like I did here:
29270d0 (just use the values from .env, not hardcoded...)
it will work:
https://github.com/hashgraph/hedera-smart-contracts/actions/runs/25550325681?pr=1682

without the need to run port-forwarding at all. I think we should do this, because:
a) pipelines will be cleaner then,
b) we will use the values from .env, which is something I think we just should do. We build sdk client with: client.fromName(process.env.NETWORK_NAME) instead of usin client.forNetwork({process.env.NETWORK_URL: process.env.NETWORK_NODE}) and we ignore mirrornodeUrl entirely.

I think alignment of the environment variables is a good idea. I think we should discuss which way we want to go (my personal opinion - let's do both custom network and predefined networks based on env combination. I'm not sure if it should be part of this PR. I think the action plan could be:

Leave this PR as it is (with port forwarding)

When Solo SDK and @hiero-ledger/sdk are aligned in terms of local network port - refactor CI to remove port forwarding

Refactor env variables usage to provide more flexibility for the users

@jasuwienas please let me know what you think

Yes, that would be ok too, but it just feels strange to me that our application doesn’t allow configuring ports or using something other than 50211 for local instances. I would prefer to simply change Client.fromName to Client.forNetwork when we create SDK client, so users have more flexibility.

But it’s probably not even part of this PR, especially when we have 2 approaches to choose from right now...

jasuwienas

LGTM, just one sugggestion, let me know what you think

rbarker-dev · 2026-05-13T13:35:35Z

This should be converted to a workflow_call trigger under .github/workflows/zxc-setup-solo-stack.yaml we try to avoid adding in-line actions if we can.

rbarker-dev · 2026-05-13T13:37:13Z

I would convert this to a bash script that can be used in-line as needed. Refactor to .github/workflows/support/scripts/solo-kubectl-port-forward.sh

rbarker-dev · 2026-05-13T13:47:49Z

        id: slither
        with:
-          node-version: 20
+          node-version: 22


Suggested change

node-version: 22

node-version: 24

rbarker-dev · 2026-05-13T13:48:20Z

+      - name: Use Node.js [22]
        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
        with:
-          node-version: 20
+          node-version: 22


Suggested change

- name: Use Node.js [22]

uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0

with:

node-version: 20

node-version: 22

- name: Use Node.js [24]

uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0

with:

node-version: 24

rbarker-dev · 2026-05-13T13:48:42Z

-        timeout-minutes: 5
+      - name: Deploy local Hiero network (Solo / Kind)
+        id: solo_stack
+        uses: ./.github/actions/setup-solo-stack


Suggested change

uses: ./.github/actions/setup-solo-stack

uses: ./.github/workflows/zxc-setup-solo-stack.yaml

rbarker-dev · 2026-05-13T13:49:15Z

+      - name: Solo kubectl port forwards (50211 / 8545)
+        uses: ./.github/actions/solo-kubectl-port-forward
+        with:
+          namespace: ${{ steps.solo_stack.outputs.namespace }}


Suggested change

- name: Solo kubectl port forwards (50211 / 8545)

uses: ./.github/actions/solo-kubectl-port-forward

with:

namespace: ${{ steps.solo_stack.outputs.namespace }}

- name: Solo kubectl port forwards (50211 / 8545)

run: |

./.github/workflows/support/scripts/solo-kubectl-port-forward.sh ${{ steps.solo_stack.outputs.namespace }}

rbarker-dev · 2026-05-13T13:49:38Z

+    DEBUG_API_ENABLED: "true"
+ws:
+  config:
+    DEBUG_API_ENABLED: "true"


Suggested change

DEBUG_API_ENABLED: "true"

DEBUG_API_ENABLED: "true"

… upgrade(#1668) Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

rbarker-dev

Small changes for consistency across workflow definitions.

rbarker-dev · 2026-05-14T12:39:41Z

+  {
+    echo "deployment_name=${SOLO_DEPLOYMENT}"
+    echo "namespace=${SOLO_NS}"
+  } >>"$GITHUB_OUTPUT"


Suggested change

} >>"$GITHUB_OUTPUT"

} >>"${GITHUB_OUTPUT}"

rbarker-dev · 2026-05-14T12:40:00Z

+  --deployment "$SOLO_DEPLOYMENT" \
+  --namespace "$SOLO_NS"


Suggested change

--deployment "$SOLO_DEPLOYMENT" \

--namespace "$SOLO_NS"

--deployment "${SOLO_DEPLOYMENT}" \

--namespace "${SOLO_NS}"

rbarker-dev · 2026-05-14T12:41:16Z

+kubectl get svc haproxy-node1-svc -n "$NS"
+kubectl port-forward -n "$NS" svc/haproxy-node1-svc 50211:50211 &
+echo "Forwarding svc/haproxy-node1-svc → localhost:50211 (consensus gRPC for local-node)"
+
+if kubectl get svc mirror-1-web3 -n "$NS" &>/dev/null; then
+  kubectl port-forward -n "$NS" svc/mirror-1-web3 8545:80 &
+  echo "Forwarding svc/mirror-1-web3 → localhost:8545 (mirror Web3)"
+else
+  echo "::warning::svc/mirror-1-web3 not found in $NS; skipping 8545 forward"
+fi


Suggested change

kubectl get svc haproxy-node1-svc -n "$NS"

kubectl port-forward -n "$NS" svc/haproxy-node1-svc 50211:50211 &

echo "Forwarding svc/haproxy-node1-svc → localhost:50211 (consensus gRPC for local-node)"

if kubectl get svc mirror-1-web3 -n "$NS" &>/dev/null; then

kubectl port-forward -n "$NS" svc/mirror-1-web3 8545:80 &

echo "Forwarding svc/mirror-1-web3 → localhost:8545 (mirror Web3)"

else

echo "::warning::svc/mirror-1-web3 not found in $NS; skipping 8545 forward"

fi

kubectl get svc haproxy-node1-svc -n "${NS}"

kubectl port-forward -n "${NS}" svc/haproxy-node1-svc 50211:50211 &

echo "Forwarding svc/haproxy-node1-svc → localhost:50211 (consensus gRPC for local-node)"

if kubectl get svc mirror-1-web3 -n "${NS}" &>/dev/null; then

kubectl port-forward -n "${NS}" svc/mirror-1-web3 8545:80 &

echo "Forwarding svc/mirror-1-web3 → localhost:8545 (mirror Web3)"

else

echo "::warning::svc/mirror-1-web3 not found in ${NS}; skipping 8545 forward"

fi

rbarker-dev · 2026-05-14T12:41:46Z

+SOLO_VERSION="${SOLO_VERSION:?SOLO_VERSION is required}"
+
+normalize_version() {
+  printf '%s' "$1" | sed 's/^v//'


Suggested change

printf '%s' "$1" | sed 's/^v//'

printf '%s' "${1}" | sed 's/^v//'

rbarker-dev · 2026-05-14T12:42:15Z

+if [[ "$(normalize_version "$INITIAL_NETWORK_TAG")" != "$(normalize_version "$TARGET_NETWORK_TAG")" ]]; then
+  npx @hashgraph/solo@${SOLO_VERSION} consensus network upgrade \
+    --deployment "$DEPLOYMENT" \
+    --upgrade-version "$(normalize_version "$TARGET_NETWORK_TAG")" \
+    --dev \
+    --force
+fi


Suggested change

if [[ "$(normalize_version "$INITIAL_NETWORK_TAG")" != "$(normalize_version "$TARGET_NETWORK_TAG")" ]]; then

npx @hashgraph/solo@${SOLO_VERSION} consensus network upgrade \

--deployment "$DEPLOYMENT" \

--upgrade-version "$(normalize_version "$TARGET_NETWORK_TAG")" \

--dev \

--force

fi

if [[ "$(normalize_version "${INITIAL_NETWORK_TAG}")" != "$(normalize_version "${TARGET_NETWORK_TAG}")" ]]; then

npx @hashgraph/solo@${SOLO_VERSION} consensus network upgrade \

--deployment "${DEPLOYMENT}" \

--upgrade-version "$(normalize_version "${TARGET_NETWORK_TAG}")" \

--dev \

--force

fi

rbarker-dev · 2026-05-14T12:42:45Z

+if [[ "$(normalize_version "$INITIAL_MIRROR_TAG")" != "$(normalize_version "$TARGET_MIRROR_TAG")" ]]; then
+  npx @hashgraph/solo@${SOLO_VERSION} mirror node upgrade \
+    --deployment "$DEPLOYMENT" \
+    --mirror-node-version "$TARGET_MIRROR_TAG" \
+    --values-file .github/mirror-node-values.yaml \
+    --enable-ingress \
+    --pinger \
+    --force-port-forward
+fi


Suggested change

if [[ "$(normalize_version "$INITIAL_MIRROR_TAG")" != "$(normalize_version "$TARGET_MIRROR_TAG")" ]]; then

npx @hashgraph/solo@${SOLO_VERSION} mirror node upgrade \

--deployment "$DEPLOYMENT" \

--mirror-node-version "$TARGET_MIRROR_TAG" \

--values-file .github/mirror-node-values.yaml \

--enable-ingress \

--pinger \

--force-port-forward

fi

if [[ "$(normalize_version "${INITIAL_MIRROR_TAG}")" != "$(normalize_version "${TARGET_MIRROR_TAG}")" ]]; then

npx @hashgraph/solo@${SOLO_VERSION} mirror node upgrade \

--deployment "${DEPLOYMENT}" \

--mirror-node-version "${TARGET_MIRROR_TAG}" \

--values-file .github/mirror-node-values.yaml \

--enable-ingress \

--pinger \

--force-port-forward

fi

rbarker-dev · 2026-05-14T12:43:17Z

+if [[ "$(normalize_version "$INITIAL_RELAY_TAG")" != "$(normalize_version "$TARGET_RELAY_TAG")" ]]; then
+  npx @hashgraph/solo@${SOLO_VERSION} relay node upgrade \
+    --deployment "$DEPLOYMENT" \
+    --relay-release "$TARGET_RELAY_TAG" \
+    --node-aliases "node1" \
+    --values-file .github/relay-values.yaml \
+    --force-port-forward
+fi


Suggested change

if [[ "$(normalize_version "$INITIAL_RELAY_TAG")" != "$(normalize_version "$TARGET_RELAY_TAG")" ]]; then

npx @hashgraph/solo@${SOLO_VERSION} relay node upgrade \

--deployment "$DEPLOYMENT" \

--relay-release "$TARGET_RELAY_TAG" \

--node-aliases "node1" \

--values-file .github/relay-values.yaml \

--force-port-forward

fi

if [[ "$(normalize_version "${INITIAL_RELAY_TAG}")" != "$(normalize_version "${TARGET_RELAY_TAG}")" ]]; then

npx @hashgraph/solo@${SOLO_VERSION} relay node upgrade \

--deployment "${DEPLOYMENT}" \

--relay-release "${TARGET_RELAY_TAG}" \

--node-aliases "node1" \

--values-file .github/relay-values.yaml \

--force-port-forward

fi

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

rbarker-dev · 2026-05-15T12:27:44Z

        required: false
        default: '@post-migration'
+      soloVersion:
+        description: 'npm version for @hashgraph/solo (Falcon one-shot on Kind)'


This description is a little confusing. I would prefer to see it as "Version of @hiero-ledger/solo for Falcon one-shot".

Also, we should switch to the hiero-ledger version of solo from npm as we are working on only publishing from that org in the near-ish future.

Neither of these comments prevent this PR from closing and can be addressed in a future issue.

chore: migrate hedera local node to solo (#1668)

38dbfbe

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

BartoszSolkaBD added this to the 0.12.0 milestone May 5, 2026

BartoszSolkaBD self-assigned this May 5, 2026

BartoszSolkaBD added dependencies Pull requests that update a dependency file github_actions Pull requests that update GitHub Actions code process Build, test and deployment-process related tasks labels May 5, 2026

BartoszSolkaBD added 20 commits May 5, 2026 14:25

chore: updated node version in workflows using solo (#1668)

2082e9e

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

chore: added node-aliases variable to relayNode (#1668)

9360233

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

debug: added debug step to get relay pod logs (#1668)

7fca801

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

debug: added debug step to get relay pod logs (#1668)

ed5112b

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

debug: added debug step to get relay pod logs (#1668)

3eb4a12

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

debug: added custom namespace to solo falcon deploy (#1668)

96f8b97

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

debug: added force-port-forward flag (#1668)

9a0462c

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

debug: removed external-address parameter (#1668)

3a20706

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

debug: added force-port-forward for relay (#1668)

9f2abc0

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

debug: cleanup of debug scripts and unncessary parameters (#1668)

a1f9234

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

debug: added namespace definition (#1668)

a66a630

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

chore: updated solo version (#1668)

08ac25e

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

chore: added node-aliases to consensus node (#1668)

dd7c686

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

debug: add more diagnostics to localize the root issue (#1668)

9cc5e2e

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

chore: downgraded mirror node version (#1668)

5b19c19

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

chore: downgraded mirror node version (#1668)

04bf278

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

chore: downgraded mirror node version (#1668)

e428a71

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

chore: migrate hedera local node to solo (#1668)

e9a8837

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

chore: migrate hedera local node to solo (#1668)

6f2cd2a

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

docs: updated workflows_documentation file with new upgrade strategy …

d741c7d

…description (#1668) Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

BartoszSolkaBD marked this pull request as ready for review May 7, 2026 08:24

BartoszSolkaBD requested a review from a team as a code owner May 7, 2026 08:24

BartoszSolkaBD requested review from a team as code owners May 7, 2026 08:24

BartoszSolkaBD requested review from andrewb1269 and leninmehedy May 7, 2026 08:24

BartoszSolkaBD added 5 commits May 7, 2026 10:47

chore: migrate hedera local node to solo (#1668)

791c5da

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

chore: removed unused script (#1668)

c981e30

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

docs: documentation update (#1668)

f9e0c62

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

chore: fixed package.json comma issue (#1668)

3e832c8

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

chore: enabled debug api in relay; regenerated opcodeLoggerBesuResults (

759bcaf

#1668) Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

BartoszSolkaBD mentioned this pull request May 7, 2026

chore: use solo instead of localnode (#5060) #1666

Closed

2 tasks

BartoszSolkaBD added 3 commits May 8, 2026 08:13

chore: forwarded ports required for SDK (#1668)

0ce3412

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

chore: fixed opcodeLogger tests; added verification after solo startup (

f105e3c

#1668) Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

chore: removed timeout-minutes from composite action (#1668)

86d9d15

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

jasuwienas reviewed May 8, 2026

View reviewed changes

jasuwienas previously approved these changes May 8, 2026

View reviewed changes

natanasow previously approved these changes May 11, 2026

View reviewed changes

simzzz previously approved these changes May 12, 2026

View reviewed changes

PavelSBorisov previously approved these changes May 12, 2026

View reviewed changes

rbarker-dev requested changes May 13, 2026

View reviewed changes

chore: review remarks - removal of composite actions and node version…

c34cbfc

… upgrade(#1668) Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

BartoszSolkaBD dismissed stale reviews from PavelSBorisov, simzzz, natanasow, and jasuwienas via c34cbfc May 14, 2026 08:35

simzzz requested a review from rbarker-dev May 14, 2026 12:11

rbarker-dev requested changes May 14, 2026

View reviewed changes

chore: review remarks (#1668)

ee3e58e

Signed-off-by: Bartosz Solka <bartosz.solka@blockydevs.com>

rbarker-dev approved these changes May 15, 2026

View reviewed changes

simzzz approved these changes May 15, 2026

View reviewed changes

	uses: ./.github/actions/setup-solo-stack
	uses: ./.github/workflows/zxc-setup-solo-stack.yaml

	printf '%s' "$1" \| sed 's/^v//'
	printf '%s' "${1}" \| sed 's/^v//'

Conversation

BartoszSolkaBD commented May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

swirlds-automation commented May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Snyk checks have passed. No issues have been found so far.

Uh oh!

github-actions Bot commented May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Test Results

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jasuwienas left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rbarker-dev left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

BartoszSolkaBD commented May 5, 2026 •

edited

Loading

swirlds-automation commented May 5, 2026 •

edited

Loading

github-actions Bot commented May 5, 2026 •

edited

Loading