From 0dde0d03e963ec34978939342e8bf33011e55fdf Mon Sep 17 00:00:00 2001 From: Til Jordan Date: Sat, 9 Aug 2025 17:59:34 +0000 Subject: [PATCH 1/3] scaffold: per-chain structure (cardano/, evm/, solana/, aptos/) for LayerZero components --- src/aptos/README.md | 3 +++ src/cardano/README.md | 5 +++++ src/evm/README.md | 4 ++++ src/solana/README.md | 3 +++ 4 files changed, 15 insertions(+) create mode 100644 src/aptos/README.md create mode 100644 src/cardano/README.md create mode 100644 src/evm/README.md create mode 100644 src/solana/README.md diff --git a/src/aptos/README.md b/src/aptos/README.md new file mode 100644 index 0000000..b2ec8e0 --- /dev/null +++ b/src/aptos/README.md @@ -0,0 +1,3 @@ +Aptos LayerZero components + +- Placeholder for Aptos-specific implementation and tooling. diff --git a/src/cardano/README.md b/src/cardano/README.md new file mode 100644 index 0000000..b790573 --- /dev/null +++ b/src/cardano/README.md @@ -0,0 +1,5 @@ +Cardano LayerZero (v2) components + +- Deployment scripts target the local Cardano chain from LZeroAnalytics/cardano-package (Ogmios tx-submission). +- Contracts and off-chain components (DVN/Executor) to be added here. +- Follow LayerZero-Labs/LayerZero-v2 for protocol reference. diff --git a/src/evm/README.md b/src/evm/README.md new file mode 100644 index 0000000..f94f40c --- /dev/null +++ b/src/evm/README.md @@ -0,0 +1,4 @@ +EVM LayerZero components + +- Keep existing EVM deployment flows here. +- Align tooling and docs with the per-chain structure. diff --git a/src/solana/README.md b/src/solana/README.md new file mode 100644 index 0000000..2ad2b49 --- /dev/null +++ b/src/solana/README.md @@ -0,0 +1,3 @@ +Solana LayerZero components + +- Placeholder for Solana-specific implementation and tooling. From 6111d09fd90134ccb1c6f714640d3de097be2678 Mon Sep 17 00:00:00 2001 From: Til Jordan Date: Sat, 9 Aug 2025 17:59:52 +0000 Subject: [PATCH 2/3] docs: document per-chain structure in README --- README.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index eefbc64..eba7b5a 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,13 @@ This package does the following: 3. Spin up an Executor off-chain component for each specified connection ## Get started +### Repository structure +- src/ + - cardano/ + - evm/ + - solana/ + - aptos/ + ### Prerequisites @@ -96,4 +103,4 @@ For issues, feature requests, or contributions, please open an issue or submit a [docker-installation]: https://docs.docker.com/get-docker/ [kurtosis-cli-installation]: https://docs.kurtosis.com/install [kurtosis-repo]: https://github.com/kurtosis-tech/kurtosis -[package-reference]: https://docs.kurtosis.com/advanced-concepts/packages \ No newline at end of file +[package-reference]: https://docs.kurtosis.com/advanced-concepts/packages From 5c054bde541fb767c7081d7881d8c4fb6abc39d3 Mon Sep 17 00:00:00 2001 From: Til Jordan Date: Sat, 9 Aug 2025 18:01:20 +0000 Subject: [PATCH 3/3] docs(cardano): add instructions to test against local Cardano devnet (Ogmios + explorer) --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index eba7b5a..e4dcc0a 100644 --- a/README.md +++ b/README.md @@ -19,6 +19,12 @@ This package does the following: ### Prerequisites +### Cardano local testing +To test Cardano LayerZero components against a local chain: +- First run the local Cardano devnet from LZeroAnalytics/cardano-package and note the Ogmios mapped port and explorer URL. +- Use Ogmios tx-submission (ws://127.0.0.1:<mapped_port>) for transaction submission and queries. +- Kupo, Yaci Store, and Yaci Viewer will index and display blocks/txs for verification. + 1. [Install Docker & start the Docker Daemon if you haven't done so already][docker-installation] 2. [Install the Kurtosis CLI, or upgrade it to the latest version if it's already installed][kurtosis-cli-installation] 3. Deploy at least two LayerZero compatible forked networks with funded accounts on each chain and reliable RPC access. These networks need to be remote networks and cannot be running on localhost. (See [Coming Soon](#coming-soon) section)