Skip to content

feat: [hedera-crosschain-bridge] Case B – Custom HTS Token Bridging Implementation and Testing #3809

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 62 commits into from
Jun 12, 2025
Merged

feat: [hedera-crosschain-bridge] Case B – Custom HTS Token Bridging Implementation and Testing #3809

merged 62 commits into from
Jun 12, 2025

Conversation

natanasow
Copy link
Contributor

@natanasow natanasow commented May 30, 2025 •
edited by quiet-node
Loading

Description:

To enable the June 2025 production rollout of cross-chain capabilities, we are implementing a LayerZero-based bridge for custom Hedera tokens (HTS) to and from Sepolia. This ticket covers the implementation of Case B, which focuses on the design, deployment, and testing of cross-network functionality for arbitrary HTS tokens, enabling broader asset support in the Hedera ecosystem.

This work validates that the bridging solution is flexible and reusable for new HTS tokens in production. Clear documentation and robust testing are critical, as this implementation will serve as a reference pattern for future HTS asset integrations.

Acceptance Criteria:

  • HTS Connector deployed on Hedera
  • OFT deployed on Sepolia
  • Deployment scripts added in scripts/deployment/:
    • Scripts are standalone and executed via npx hardhat run
    • Use .env for private keys, RPCs, and token configuration
    • Scripts include descriptive inline comments
  • Integration tests written in test/deployment/:
    • Tests programmatically deploy contracts before each test run
    • No reliance on pre-generated .env-based addresses
    • Validate bidirectional bridging behavior (HTS ⇄ ERC20)
  • README section updated for custom HTS token bridging:
    • Deployment instructions for HTS tokens and adapters
  • Code and scripts follow consistent structure and naming conventions
  • Code is well-documented and suitable for future developer handoff or audit

Proposed Solution:

  1. Create and deploy ERC20 on Sepolia
  2. Create and deploy HTS Connector on Hedera
  3. Develop modular, well-documented deployment scripts in a dedicated folder
  4. Implement dynamic, isolated test cases that simulate HTS bridging scenarios
  5. Extend the project README with instructions and configuration examples specific to HTS bridging

Related issue(s):

Fixes #3802
Fixes #3799

Notes for reviewer:

Checklist

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

quiet-node and others added 10 commits May 29, 2025 09:32
@quiet-node
feat: hardhat init ----
2511aa9 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>

chore: removed chainId config definition in Hardhat config

Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>

fix: updated .env.example to correct configs

Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>

chore: cleaned up README.md

Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>

chore: cleaned up folder structure

Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>

feat: added network configs

Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>

build(deps): installed deps

Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
feat: added neccessary contracts
084042f 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
chore: added block explorer env config
4174f85 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
feat: added helpers scripts
3bae69f 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
feat: added deploy-whbar scripts
2ac2d1f 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
feat: added deploy-erc scripts
d2cc001 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
feat: added deployment scripts for OFTAdapter
ce30915 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
docs: added comprehensive guidelines to deployments script folder
7baa589 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
chore: added placeholder for interactions and validation script folders
7396a6e 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@natanasow
chore: add contracts and deployment scripts
7164390 
Signed-off-by: nikolay <n.atanasow94@gmail.com>
@natanasow natanasow self-assigned this May 30, 2025
@natanasow natanasow added the enhancement New feature or request label May 30, 2025
@natanasow natanasow added this to the 0.69.0 milestone May 30, 2025
@lfdt-bot
Copy link

lfdt-bot commented May 30, 2025 •
edited
Loading

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

✅ security/snyk check is complete. No issues have been found. (View Details)

✅ license/snyk check is complete. No issues have been found. (View Details)

@natanasow natanasow changed the title chore: add contracts and deployment scripts feat: [hedera-crosschain-bridge] Case B – Custom HTS Token Bridging Implementation and Testing May 30, 2025
quiet-node added 3 commits May 30, 2025 11:44
@quiet-node
test: added test for deploy-erc20.ts script
7f053b6 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
test: added test for deploy-whbar.ts scrip
aebaeea 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
test: added test for deploy-oft-adaoter.ts scrip
47b8fdc 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node quiet-node force-pushed the 3801-hedera-crosschain-bridge-case-a-whbar-bridging-implementation-and-testing branch from 547a460 to 0caec04 Compare May 30, 2025 20:38
quiet-node added 5 commits May 30, 2025 15:39
@quiet-node
fix: cleaned up tests for deployment scripts
4af8811 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
chore: renamed shared methods
9f1277f 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
feat: added set peer oftAdapter script
e8f79d1 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
Revert "feat: added set peer oftAdapter script"
6ca8aaa 
This reverts commit 06b9c2b.
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
chore: removed unnecessary files
f942bae 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node quiet-node force-pushed the 3801-hedera-crosschain-bridge-case-a-whbar-bridging-implementation-and-testing branch from 0caec04 to f942bae Compare May 30, 2025 20:39
quiet-node and others added 5 commits May 30, 2025 15:46
@quiet-node
chore: updated deployContractOnNetwork
aef8927 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
fix: fixed failed test
6d5f768 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@natanasow
Merge branch '3801-hedera-crosschain-bridge-case-a-whbar-bridging-imp…
194b7aa 
…lementation-and-testing' into 3802-case-b-custom-hts-bridging
@quiet-node
test: added e2e test
cc92f57 
Signed-off-by: Quiet Node <logan@quiet-node.dev>
@natanasow
chore: add tests
9b2c4ac 
Signed-off-by: nikolay <n.atanasow94@gmail.com>
quiet-node and others added 4 commits June 5, 2025 09:34
@quiet-node
chore: fixed typo and utils
b687cba 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@quiet-node
chore: updated logging layout
eef56f0 
Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
@natanasow
Merge remote-tracking branch 'origin/3801-hedera-crosschain-bridge-ca…
3936c66 
…se-a-whbar-bridging-implementation-and-testing' into 3801-hedera-crosschain-bridge-case-a-whbar-bridging-implementation-and-testing
@natanasow
Merge branch '3801-hedera-crosschain-bridge-case-a-whbar-bridging-imp…
bd93f8e 
…lementation-and-testing' into 3802-case-b-custom-hts-bridging
@natanasow natanasow marked this pull request as ready for review June 6, 2025 06:42
@natanasow natanasow requested review from a team as code owners June 6, 2025 06:42
@natanasow natanasow requested a review from simzzz June 6, 2025 06:42
natanasow added 2 commits June 6, 2025 11:43
@natanasow
chore: fix typo
70f59a8 
Signed-off-by: nikolay <n.atanasow94@gmail.com>
@natanasow
chore: revert file
14af596 
Signed-off-by: nikolay <n.atanasow94@gmail.com>
quiet-node
quiet-node requested changes Jun 6, 2025
View reviewed changes
Base automatically changed from 3801-hedera-crosschain-bridge-case-a-whbar-bridging-implementation-and-testing to main June 6, 2025 22:35
natanasow added 2 commits June 9, 2025 09:53
@natanasow
Merge branch 'main' into 3802-case-b-custom-hts-bridging
f09c4e4 
# Conflicts:
#	tools/hedera-crosschain-bridge/.env.example
#	tools/hedera-crosschain-bridge/package.json
#	tools/hedera-crosschain-bridge/scripts/deployments/README.md
#	tools/hedera-crosschain-bridge/test/bridging-e2e/whbar/whbar-e2e-hedera-sepolia.spec.ts
#	tools/hedera-crosschain-bridge/test/utils/helpers.ts
@natanasow
chore: resolve comments
cbe3a99 
Signed-off-by: nikolay <n.atanasow94@gmail.com>
@github-actions GitHub Actions
Copy link

github-actions bot commented Jun 9, 2025 •
edited
Loading

Test Results

 20 files   -  2  251 suites   - 44   31m 22s ⏱️ - 4m 47s
649 tests ± 0  644 ✅ + 1  5 💤 ±0  0 ❌  - 1 
665 runs   - 80  660 ✅  - 77  5 💤 ±0  0 ❌  - 3 

Results for commit f34ac0c. ± Comparison against base commit 28e210e.

♻️ This comment has been updated with latest results.

@natanasow natanasow requested a review from quiet-node June 9, 2025 09:55
@natanasow
chore: add update associations script
6717d8c 
Signed-off-by: nikolay <n.atanasow94@gmail.com>
quiet-node
quiet-node reviewed Jun 10, 2025
View reviewed changes
@natanasow
chore: resolve comments
f34ac0c 
Signed-off-by: nikolay <n.atanasow94@gmail.com>
@natanasow natanasow requested review from simzzz and quiet-node June 11, 2025 06:03
@natanasow natanasow merged commit bd078cf into main Jun 12, 2025
67 of 69 checks passed
@natanasow natanasow deleted the 3802-case-b-custom-hts-bridging branch June 12, 2025 06:51
mwb-al pushed a commit to mwb-al/hiero-json-rpc-relay that referenced this pull request Jun 23, 2025
@natanasow @quiet-node @mwb-al
feat: [hedera-crosschain-bridge] Case B – Custom HTS Token Bridging I…
6efa0a5 
…mplementation and Testing (hiero-ledger#3809)

Signed-off-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
Signed-off-by: nikolay <n.atanasow94@gmail.com>
Signed-off-by: Quiet Node <logan@quiet-node.dev>
Co-authored-by: Logan Nguyen <logan.nguyen@swirldslabs.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@simzzz simzzz simzzz approved these changes

@quiet-node quiet-node quiet-node approved these changes

Assignees

@natanasow natanasow

Labels
enhancement New feature or request
Projects
None yet
Milestone
0.69.0
4 participants
@natanasow @lfdt-bot @simzzz @quiet-node