From a25fb968fa0f60fa61b776aaf7656ef6efc5a96f Mon Sep 17 00:00:00 2001 From: Jamie Pine Date: Wed, 9 Jul 2025 20:55:29 -0700 Subject: [PATCH] Revise IROH migration design document to reflect updated implementation order - Adjusted the implementation order based on feedback from Iroh founders, prioritizing endpoint migration and pairing protocol development. - Clarified the steps for transitioning from libp2p to Iroh, emphasizing the importance of establishing a functional endpoint before proceeding with other protocols. - Enhanced the documentation to provide a clearer roadmap for the migration process, ensuring better alignment with project goals and user needs. --- .../networking/IROH_MIGRATION_DESIGN.md | 22 ++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/core-new/src/services/networking/IROH_MIGRATION_DESIGN.md b/core-new/src/services/networking/IROH_MIGRATION_DESIGN.md index 668ae1f45..5cea5dde2 100644 --- a/core-new/src/services/networking/IROH_MIGRATION_DESIGN.md +++ b/core-new/src/services/networking/IROH_MIGRATION_DESIGN.md @@ -181,12 +181,24 @@ pub struct NetworkingConfig { - Test coverage: Maintain >80% - User feedback: Improved reliability scores -## Implementation Order +## Implementation Order (per Iroh founder feedback) -1. **Core Module**: Replace NetworkingService with Iroh -2. **Protocols**: Update pairing, file transfer, messaging -3. **Tests**: Update all integration tests -4. **Documentation**: Update networking docs +1. **Endpoint Migration** (Priority 1) + - Replace libp2p Swarm with iroh::Endpoint + - This is the foundation - get this working first + +2. **Pairing Protocol as Custom Iroh Protocol** (Priority 2) + - Express the full pairing flow as an Iroh protocol + - This will exercise the entire Iroh API surface area + - Once this works, everything else is downhill + +3. **Remaining Protocols** + - File transfer (straightforward after pairing works) + - Messaging (simple stream-based) + +4. **Tests & Documentation** + - Update integration tests + - Update networking docs ## Conclusion