feat: Q4 commitments (#283)

Author: richard-ramos

content/p2p/ift/2025q4-nimlibp2p-c-bindings.md

@@ -0,0 +1,105 @@
+---
+
+title: nim-libp2p c-bindings  
+tags:  
+  - "2025q4"  
+  - "p2p"  
+  - "ift"  
+draft: false  
+description: Provide c-bindings for nim-libp2p  
+
+---
+
+`vac:p2p:ift:2025q4-nimlibp2p-cbindings`
+
+Expose nim-libp2p functionality via a c static library, enabling external projects (e.g. logoscore) to integrate without depending on nim toolchains. Implementation may leverage [nim-ffi](https://github.com/waku-org/nim-ffi) and/or [nim-library-template](https://github.com/logos-co/nim-library-template/) as well as previous learnings from building libwaku to simplify binding generation and library packaging.
+
+## Description
+
+Deliver a minimal set of c-bindings around nim-libp2p core. The bindings should cover basic node lifecycle, peer connectivity, and stream i/o. This enables downstream projects like logoscore to embed libp2p functionality directly. Stretch goals include exposing Gossipsub and custom protocol support, which may be deferred to 2026q1.
+
+## Task List
+
+### Core Bindings
+
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-cbindings:core`  
+* owner:  
+* status: not started  
+* start-date:  
+* end-date:  
+
+#### description
+Implement and test c-bindings for core nim-libp2p functionality. Exported functions must include:  
+- switch builder  
+- start/stop node 
+- access node peer's information (addresses, peerId) 
+- connect/disconnect peer  
+- dial peer on protocol  
+- read/write stream  
+- close stream  
+
+#### Deliverables
+- Static c library build artifact  
+- Header file exposing ffi-safe api  
+- Integration tests demonstrating basic usage
+- Documentation
+
+---
+
+### kademlia
+
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-cbindings:kademlia`  
+* owner:  
+* status:  
+* start-date:  
+* end-date:  
+
+#### description
+Extend c-bindings to expose Kademlia functionality. This task depends on `vac:p2p:ift:2025q4-nimlibp2p-kad-dht`.
+Exported functions must include:  
+- Bootstrap
+- Find Node / Put Value / Get Value / Set Providers / Get Providers 
+- Discovery
+
+#### deliverables
+- Updated c header + library with kademlia api  
+- Tests verifying kademlia behavior via ffi
+- Documentation
+
+---
+
+### gossipsub
+
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-cbindings:gossipsub`  
+* owner:  
+* status:  
+* start-date:  
+* end-date:  
+
+#### description
+Extend c-bindings to expose Gossipsub Functionality. Exported functions must include:  
+- start/stop gossipsub  
+- publish/subscribe  
+- add/remove validators  
+
+#### deliverables
+- Updated c header + library with gossipsub api  
+- Tests verifying pub/sub behavior via ffi
+- Documentation
+
+
+### Custom Protocols
+
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-cbindings:custom-protocols`  
+* owner:  
+* status:  
+* start-date:  
+* end-date:  
+
+#### Description
+Provide FFI to register and handle custom protocols from c, enabling downstream applications to define custom behaviors.
+
+#### Deliverables
+- FFI API for custom protocol registration  
+- Example implementation + tests
+- Documentation

content/p2p/ift/2025q4-nimlibp2p-ipv6.md

@@ -0,0 +1,69 @@
+---
+
+title: nim-libp2p IPv6 support
+tags:
+  - "2025q4"
+  - "p2p"
+  - "ift"
+draft: false
+description: add first-class IPv6 support across transports
+
+---
+
+`vac:p2p:ift:2025q4-nimlibp2p-ipv6`
+
+Enable IPv6 support
+
+## Description
+
+Enable IPv6 in nim-libp2p end-to-end so users of the library can run dual-stack when needed. Scope covers transports (tcp/quic), address handling (multiaddr, identify),  and ci/test infra. 
+
+## Task List
+
+### Core transports (tcp/quic)
+
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-ipv6:transport`
+* owner:
+* status: not started
+* start-date:
+* end-date:
+
+#### Description
+Add IPv6 listen/dial for tcp and quic. Might require changes in chronos
+
+#### Deliverables
+- nodes can listen on /ip6 and accept inbound requests
+- dialer can dial /ip6 addresses
+
+
+### addresses & identity
+
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-ipv6:addresses`
+* owner:
+* status: not started
+* start-date:
+* end-date:
+
+#### Description
+Add IPv6 support in the switch when specifying listening multiaddresses containing ip6 component. 
+Ensure ip6 addresses are advertised in identify.
+Implement measures to handle duplicated IPs in peerstore/addresses being listened to (i.e 192.0.2.42 vs 2001:db8::1234). 
+
+#### Deliverables
+- Identify advertises correct /ip6 addrs; observed addrs tracked per transport
+
+
+### Testing, Interop & CI
+
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-ipv6:testing`
+* owner:
+* status: not started
+* start-date:
+* end-date:
+
+#### Description
+Ensure IPv6 support and ensure there are no regressions in IPv4 support. Add test units demonstrating the support, and check that interop against other implementations is achieved
+
+#### Deliverables
+- Test units focusing on IPv6
+- Interop tests against other implementations that support IPv6

content/p2p/ift/2025q4-nimlibp2p-kademlia.md

@@ -0,0 +1,104 @@
+---
+
+title: Kademlia DHT
+tags:
+  - "2025q4"
+  - "p2p"
+  - "ift"
+draft: false
+description: Implement Kademlia DHT
+
+---
+
+`vac:p2p:ift:2025q4-nimlibp2p-kad-dht`
+
+Implement Kademlia Distributed Hash Table in nim-libp2p, based on the [libp2p specification](https://github.com/libp2p/specs/blob/master/kad-dht/) as an additional discovery mechanism.
+This commitment involves two main objectives: implementing nim-kademlia-dht, integrating this in nim-libp2p and making sure there is interoperability with other libp2p implementations.
+This deliverable continues the work started in 2025q2
+
+## Task List
+
+### Routing table and RPC Protocol
+
+* fully qualified name: `vac:p2p:ift:2025q2-nimlibp2p-kad-dht:routing-and-rpc`
+* owner:
+* status: 50%
+* start-date: 2025-04-08
+* end-date:
+
+#### Description
+Implement Kademlia’s XOR-based routing table with bucket management. Define RPC messages (`PING`, `SET_VALUE`, `GET_VALUE`, `SET_PROVIDERS`, `GET_PROVIDERS`, `FIND_NODE`) for node communication.
+
+#### Deliverables
+
+
+
+### Bootstrapping & Lookup Mechanism
+
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-kad-dht:bootstraping-and-lookup`
+* owner:
+* status: 35%
+* start-date: 2025-05-05
+* end-date:
+
+#### Description
+Enable nodes to join the network via bootstrap peers. Implement iterative lookup for efficient key
+discovery and retrieval 
+
+#### Deliverables
+
+
+
+### Network Maintenance & Node Management
+
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-kad-dht:network-maintenance-node-management`
+* owner:
+* status: not started
+* start-date:
+* end-date:
+
+#### Description
+Handle bucket refresh, node eviction, and periodic pings to maintain an active routing table. 
+Implement bucket splitting and adaptive refresh strategies.
+
+#### Deliverables
+
+
+
+### Data Storage & Replication
+
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-kad-dht:data-storage`
+* owner:
+* status: started
+* start-date: 2025-07-28
+* end-date:
+
+#### Description
+Implement the logic for `SET_VALUE` and `SET_PROVIDERS`. Store key-value pairs with expiration and replication mechanisms. 
+Ensure values persist despite churn, using periodic re-publication and redundancy strategies
+
+#### Deliverables
+
+
+### Data Retrieval
+
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-kad-dht:data-retrieval`
+* owner:
+* status: not started
+* start-date: 2025-07-28
+* end-date:
+
+#### Description
+Implement the logic for `GET_VALUE` and `GET_PROVIDERS`. Implement validation and quorum mechanisms for queries
+
+#### Deliverables
+
+### Discovery
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-kad-dht:discovery`
+* owner:
+* status: 15%
+* start-date: 2025-07-20
+* end-date:
+
+#### Description
+Extend nim-libp2p discovery mechanism by providing a discovery interface that will use Kademlia DHT to advertise nodes and find peers

content/p2p/ift/2025q4-nimlibp2p-maintenance.md

@@ -0,0 +1,69 @@
+---
+
+title: Nim-libp2p maintenance
+tags:
+  - "2025q4"
+  - "p2p"
+  - "ift"
+draft: false
+description: Maintain nim-libp2p through improvements, bug fixes, and user support
+
+---
+
+`vac:p2p:ift:2025q4-nimlibp2p-maintenance`
+
+Maintain nim-libp2p through improvements, bug fixes, and user support
+
+## Description
+
+Continue supporting and maintaining the nim-libp2p repository through ongoing improvements, refactoring, and bug fixes.
+This includes a range of ad-hoc tasks critical to sustaining code quality, overall stability, correct functionality,
+and performance of the project.
+Additionally, it provides a platform for addressing small developer requests,
+ensuring that nim-libp2p remains functional and usable for its primary users — Nimbus and Waku — helping to meet their evolving needs."
+
+## Task List
+
+### Maintenance
+
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-maintenance:maintenance`
+* owner: rramos
+* status: not started
+* start-date: 2025/10/01
+* end-date: 2025/12/31
+
+#### Description
+Maintain [nim-libp2p](https://github.com/vacp2p/nim-libp2p) repository via improvements, refactors and bug fixes.
+
+#### Deliverables
+- [[Deliverable] Maintenance 2025Q4](TODO)
+
+
+### Gossipsub Interop tests
+
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-maintenance:gossipsub-interop-tests`
+* owner: 
+* status: not started
+* start-date: 2025/10/01
+* end-date: 2025/12/31
+
+#### Description
+Integrate libp2p test plans' [GossipSub interop tests](https://github.com/libp2p/test-plans/tree/master/gossipsub-interop) as part of the CI tests executed on each PR 
+
+#### Deliverables
+- New github workflow: `Interoperability Tests / Run GossipSub interoperability tests`
+
+
+### Fix flaky tests
+
+* fully qualified name: `vac:p2p:ift:2025q4-nimlibp2p-maintenance:flaky-tests`
+* owner: 
+* status: not started
+* start-date: 2025/10/01
+* end-date: 2025/12/31
+
+#### Description
+Continue to systematically track flaky tests using CI logs and failure reports, 
+and fix root causes where reproducible (e.g. race conditions, timeouts, dependency order)
+
+#### Deliverables