Fixed #

• UDX large payload stalls — Bumped dart_udx to 2.0.3 which fixes control-only stream packets (WindowUpdate) consuming sequence numbers, causing permanent receiver stalls on payloads >60KB.

Fixed #

• AutoNAT v2 go-libp2p interop — Client and server now use varint-length-prefixed (delimited) message framing, matching go-libp2p's pbio.NewDelimitedReader/Writer. Previously raw protobuf bytes were written without length prefixes, causing Message_Msg.notSet parse errors when communicating with go-libp2p AutoNAT v2 servers.
• AutoNAT v2 probe spam — AmbientAutoNATv2 now checks for available peers before attempting a probe, avoiding noisy Exception: no valid peers for autonat v2 errors with full stack traces every 5 seconds during startup.
• AutoNAT v2 backoff — When no AutoNAT v2 peers are available, probes now use exponential backoff (10s, 20s, 40s, 60s cap) instead of retrying at the fixed retry interval.
• AutoNAT v2 log levels — Probe errors downgraded from severe (with stack trace) to warning; no-peers condition logged at fine level.

Added #

• AutoNATv2.hasPeers getter to check peer availability without throwing exceptions.
• Initial UNKNOWN reachability event emitted on the no-peers path so AutoRelay can start even without AutoNAT v2 peers.

Added #

• WebRTC protocol definition in multiaddr parser

Fixed #

• Yamux session metrics observer null-safety for remotePeer access
• Yamux stream close/reset handling improvements
• UDXSessionConn crash when constructor fails before registration
• Self-dial attempt now logged instead of silently returning
• Test reliability improvements across 15 test files (timeouts, resource cleanup)

Added #

• Go-libp2p interoperability — Full cross-language compatibility with go-libp2p nodes
  • Echo server/client interop tests (TCP and UDX)
  • GossipSub interop tests (both directions)
  • Kademlia DHT interop tests with /pk/ namespace support
  • ADD_PROVIDER/GET_PROVIDERS interop
  • Circuit Relay v2 interop tests
  • Identify push interop test (Go → Dart)
  • UDX transport support in Go peer binary
• Circuit Relay v2 — Full relay implementation with e2e relayed handshakes
  • Connection reuse to prevent duplicate relay connections
  • Parallel dialing support
  • Relay address de-duplication
  • relayServers configuration setting
• AmbientAutoNATv2 — NAT detection with Circuit Relay v2 integration
• AutoRelay — Automatic relay discovery, including CGNAT support
• Hole Punching — NAT traversal with Docker-based integration test framework
• Half-close — Added half-close semantics to the stream stack
• Happy Eyeballs — Capability-aware connection establishment
• Typed exceptions — IdentifyTimeoutException for graceful timeout handling
• Yamux maxFrameSize configuration with large bidirectional transfer stress tests
• Bidirectional relay data transfer tests (mock + e2e integration)
• mDNS — Bug fixes, updates, and working examples

Changed (Breaking) #

• Noise protocol — Spec compliance changes for go-libp2p interoperability
• Yamux — Spec compliance fixes for go-libp2p interoperability (fire-and-forget write responses)
• Multistream — Buffering changes for go-libp2p interoperability
• Identify — Fixes for signed peer record registration and identify push
• DHT — DHTMode.client fixes, /pk/ namespace support

Fixed #

• Noise handshake failure from multistream leftover byte loss
• UDX transport deadlock and connection lifecycle issues
• UDX transport killing long-lived yamux connections
• Yamux zombie sessions — close on keepalive ping send failure
• Yamux read loop blocking
• Concurrent read race condition
• Concurrent upgrade race condition on parallel circuit dials
• MAC authentication errors on large message transfers
• Stream deadline handling
• Relay latching bug — skip identify for circuit-relay connections
• Relay latching — remove reservations when peers disconnect
• AutoRelay not starting RelayFinder behind CGNAT
• Graceful terminal state transitions
• Stale connection handling with default ConnectionManager

Changed #

• Updated the Quickstart example in the README. The original example was referencing outdated APIs and would not compile.

Added #

• Initial changelog documentation

Added #

• Comprehensive documentation in /doc directory
• Architecture overview and component documentation
• Configuration guide with flexible options system
• Transport layer documentation (TCP and UDX)
• Security protocol documentation (Noise)
• Multiplexing documentation (Yamux)
• Protocol documentation (Ping, Identify, etc.)
• Peerstore management documentation
• Event bus system documentation
• Resource manager documentation
• Cookbook with practical examples
• Getting started guide with step-by-step instructions
• README.md with project overview and quick start guide
• MIT LICENSE file

Changed #

• Improved project structure and organization
• Enhanced documentation coverage across all components
• Better code examples and usage patterns

Fixed #

• Documentation links and cross-references
• Code examples in documentation

Contributing #

When contributing to this project, please update this changelog by adding a new entry under the [Unreleased] section. Follow the existing format and include:

• Added: for new features
• Changed: for changes in existing functionality
• Deprecated: for soon-to-be removed features
• Removed: for now removed features
• Fixed: for any bug fixes
• Security: in case of vulnerabilities

Release Process #

1. Update version in pubspec.yaml
2. Add new changelog entry under [Unreleased]
3. Move [Unreleased] content to new version section
4. Update release date
5. Tag the release in git