Fix: Initialize health_data in Swarm.__init__ instead of set_resource_manager

The health_data attribute was only being initialized in set_resource_manager,
but it needs to be available immediately after Swarm creation for tests and
other code that accesses it before set_resource_manager is called.

Author: acul71

.github/workflows/tox.yml

@@ -18,7 +18,7 @@ jobs:
     strategy:
       matrix:
         python: ["3.10", "3.11", "3.12", "3.13"]
-        toxenv: [core, interop, lint, wheel, demos]
+        toxenv: [core, demos, interop, lint, utils, wheel]
         include:
           - python: "3.10"
             toxenv: docs
@@ -81,7 +81,7 @@ jobs:
           if [[ "${{ matrix.toxenv }}" == 'docs' ]]; then
             export TOXENV=docs
           else
-            export TOXENV=py${{ matrix.python }}-${{ matrix.toxenv }}
+            export TOXENV=$(echo "py${{ matrix.python }}-${{ matrix.toxenv }}" | tr -d '.')
           fi
           # Set PATH for nim commands during tox
           if [[ "${{ matrix.toxenv }}" == 'interop' ]]; then
@@ -95,7 +95,7 @@ jobs:
     strategy:
       matrix:
         python-version: ["3.11", "3.12", "3.13"]
-        toxenv: [core, wheel]
+        toxenv: [core, demos, utils, wheel]
       fail-fast: false
     steps:
       - uses: actions/checkout@v4

FUNDING.json

@@ -0,0 +1,7 @@
+{
+  "drips": {
+    "filecoin": {
+      "ownedBy": "0x856c29E91eb30b8D9154a74a543dcC8D970D5D15"
+    }
+  }
+}

Filecoin_Retro_PGF.md

@@ -0,0 +1,132 @@
+# py-libp2p
+
+<h1 align="center">
+  <a href="https://libp2p.io/"><img width="250" src="https://github.com/libp2p/py-libp2p/blob/main/assets/py-libp2p-logo.png?raw=true" alt="py-libp2p hex logo" /></a>
+</h1>
+
+<p align="center">
+  <a href="https://filecoin.drips.network/app/projects/github/libp2p/py-libp2p" target="_blank">
+    <img src="https://filecoin.drips.network/api/embed/project/https%3A%2F%2Fgithub.com%2Flibp2p%2Fpy-libp2p/support.png?background=light&style=drips&text=Support&stat=support"
+         alt="Support py-libp2p on drips.network" height="36">
+  </a>
+</p>
+
+<h3 align="center">The Python implementation of the libp2p networking stack.</h3>
+
+> py-libp2p has moved beyond its experimental roots and is progressing toward production readiness. Core modules are stable, with active work on performance, protocol coverage, and interop with other libp2p implementations. We welcome contributions and real-world usage feedback.
+
+## Maintainers
+
+Maintained by [@pacrob](https://github.com/pacrob), [@seetadev](https://github.com/seetadev), and [@dhuseby](https://github.com/dhuseby).
+
+Questions or ideas?
+Start a discussion: https://github.com/libp2p/py-libp2p/discussions
+Join the Discord: https://discord.gg/d92MEugb (#py-libp2p)
+
+## Feature Breakdown
+
+✅ Stable · 🛠️ In Progress · 🌱 Prototype · ❌ Not Yet Implemented
+
+### Transports
+
+| Transport                          | Status |                                  Source                                   |
+| ---------------------------------- | :----: | :-----------------------------------------------------------------------: |
+| `libp2p-tcp`                       |   ✅   | https://github.com/libp2p/py-libp2p/blob/main/libp2p/transport/tcp/tcp.py |
+| `libp2p-quic`                      |   ✅   |    https://github.com/libp2p/py-libp2p/tree/main/libp2p/transport/quic    |
+| `libp2p-websocket`                 |   ✅   | https://github.com/libp2p/py-libp2p/tree/main/libp2p/transport/websocket  |
+| `libp2p-webrtc-browser-to-server`  |   🌱   |                                     —                                     |
+| `libp2p-webrtc-private-to-private` |   🌱   |                                     —                                     |
+
+### NAT Traversal
+
+| NAT Traversal             | Status |                                Source                                 |
+| ------------------------- | :----: | :-------------------------------------------------------------------: |
+| `libp2p-circuit-relay-v2` |   ✅   | https://github.com/libp2p/py-libp2p/tree/main/libp2p/relay/circuit_v2 |
+| `libp2p-autonat`          |   ✅   |   https://github.com/libp2p/py-libp2p/tree/main/libp2p/host/autonat   |
+| `libp2p-hole-punching`    |   ✅   | https://github.com/libp2p/py-libp2p/tree/main/libp2p/relay/circuit_v2 |
+
+### Secure Communication
+
+| Secure Channel | Status |                               Source                                |
+| -------------- | :----: | :-----------------------------------------------------------------: |
+| `libp2p-noise` |   ✅   | https://github.com/libp2p/py-libp2p/tree/main/libp2p/security/noise |
+| `libp2p-tls`   |   ✅   |                                  —                                  |
+
+### Discovery
+
+| Discovery        | Status |                                   Source                                   |
+| ---------------- | :----: | :------------------------------------------------------------------------: |
+| `bootstrap`      |   ✅   |  https://github.com/libp2p/py-libp2p/tree/main/libp2p/discovery/bootstrap  |
+| `random-walk`    |   ✅   | https://github.com/libp2p/py-libp2p/tree/main/libp2p/discovery/random_walk |
+| `mdns-discovery` |   ✅   |    https://github.com/libp2p/py-libp2p/tree/main/libp2p/discovery/mdns     |
+| `rendezvous`     |   ✅   | https://github.com/libp2p/py-libp2p/tree/main/libp2p/discovery/rendezvous  |
+
+### Peer Routing
+
+| Peer Routing     | Status |                            Source                            |
+| ---------------- | :----: | :----------------------------------------------------------: |
+| `libp2p-kad-dht` |   ✅   | https://github.com/libp2p/py-libp2p/tree/main/libp2p/kad_dht |
+
+### Publish/Subscribe
+
+| PubSub             | Status |                                  Source                                  |
+| ------------------ | :----: | :----------------------------------------------------------------------: |
+| `libp2p-floodsub`  |   ✅   | https://github.com/libp2p/py-libp2p/blob/main/libp2p/pubsub/floodsub.py  |
+| `libp2p-gossipsub` |   ✅   | https://github.com/libp2p/py-libp2p/blob/main/libp2p/pubsub/gossipsub.py |
+
+### Stream Muxers
+
+| Muxer          | Status |                                 Source                                  |
+| -------------- | :----: | :---------------------------------------------------------------------: |
+| `libp2p-yamux` |   ✅   | https://github.com/libp2p/py-libp2p/tree/main/libp2p/stream_muxer/yamux |
+| `libp2p-mplex` |   ✅   | https://github.com/libp2p/py-libp2p/tree/main/libp2p/stream_muxer/mplex |
+
+### Storage
+
+| **Storage**         | **Status** |
+| ------------------- | :--------: |
+| **`libp2p-record`** |     ✅     |
+
+### General Purpose Utilities & Datatypes
+
+| **Utility/Datatype**  | **Status** |                                          **Source**                                          |
+| --------------------- | :--------: | :------------------------------------------------------------------------------------------: |
+| **`libp2p-ping`**     |     ✅     |         [source](https://github.com/libp2p/py-libp2p/blob/main/libp2p/host/ping.py)          |
+| **`libp2p-peer`**     |     ✅     |             [source](https://github.com/libp2p/py-libp2p/tree/main/libp2p/peer)              |
+| **`libp2p-identify`** |     ✅     | [source](https://github.com/libp2p/py-libp2p/blob/main/libp2p/identity/identify/identify.py) |
+
+## Explanation of Basic Two Node Communication
+
+### Core Concepts
+
+_(non-normative, useful for team notes, not a reference)_
+
+Several components of the libp2p stack take part when establishing a connection between two nodes:
+
+1. **Host**: a node in the libp2p network.
+1. **Connection**: the layer 3 connection between two nodes in a libp2p network.
+1. **Transport**: the component that creates a _Connection_, e.g. TCP, UDP, QUIC, etc.
+1. **Streams**: an abstraction on top of a _Connection_ representing parallel conversations about different matters, each of which is identified by a protocol ID. Multiple streams are layered on top of a _Connection_ via the _Multiplexer_.
+1. **Multiplexer**: a component that is responsible for wrapping messages sent on a stream with an envelope that identifies the stream they pertain to, normally via an ID. The multiplexer on the other unwraps the message and routes it internally based on the stream identification.
+1. **Secure channel**: optionally establishes a secure, encrypted, and authenticated channel over the _Connection_.
+1. **Upgrader**: a component that takes a raw layer 3 connection returned by the _Transport_, and performs the security and multiplexing negotiation to set up a secure, multiplexed channel on top of which _Streams_ can be opened.
+
+### Communication between two hosts X and Y
+
+_(non-normative, useful for team notes, not a reference)_
+
+**Initiate the connection**: A host is simply a node in the libp2p network that is able to communicate with other nodes in the network. In order for X and Y to communicate with one another, one of the hosts must initiate the connection. Let's say that X is going to initiate the connection. X will first open a connection to Y. This connection is where all of the actual communication will take place.
+
+**Communication over one connection with multiple protocols**: X and Y can communicate over the same connection using different protocols and the multiplexer will appropriately route messages for a given protocol to a particular handler function for that protocol, which allows for each host to handle different protocols with separate functions. Furthermore, we can use multiple streams for a given protocol that allow for the same protocol and same underlying connection to be used for communication about separate topics between nodes X and Y.
+
+**Why use multiple streams?**: The purpose of using the same connection for multiple streams to communicate over is to avoid the overhead of having multiple connections between X and Y. In order for X and Y to differentiate between messages on different streams and different protocols, a multiplexer is used to encode the messages when a message will be sent and decode a message when a message is received. The multiplexer encodes the message by adding a header to the beginning of any message to be sent that contains the stream id (along with some other info). Then, the message is sent across the raw connection and the receiving host will use its multiplexer to decode the message, i.e. determine which stream id the message should be routed to.
+
+## Support
+
+If py-libp2p has been useful to your project or organization, please consider supporting ongoing development:
+
+<p>
+    <a href="https://filecoin.drips.network/app/projects/github/libp2p/py-libp2p" target="_blank">
+    <img src="https://filecoin.drips.network/api/embed/project/https%3A%2F%2Fgithub.com%2Flibp2p%2Fpy-libp2p/support.png?background=light&style=drips&text=project&stat=support" height="32" alt="Support py-libp2p on drips.network">
+    </a>
+</p>

Makefile

@@ -46,7 +46,7 @@ typecheck:
 	pre-commit run mypy-local --all-files && pre-commit run pyrefly-local --all-files
 
 test:
-	python -m pytest tests -n auto --timeout=1200
+	python -m pytest tests -n auto
 
 pr: clean fix lint typecheck test
 
@@ -62,7 +62,10 @@ PB = libp2p/crypto/pb/crypto.proto \
 	libp2p/relay/circuit_v2/pb/circuit.proto \
 	libp2p/relay/circuit_v2/pb/dcutr.proto \
 	libp2p/kad_dht/pb/kademlia.proto \
-	libp2p/discovery/rendezvous/pb/rendezvous.proto
+	libp2p/discovery/rendezvous/pb/rendezvous.proto \
+	libp2p/bitswap/pb/bitswap.proto \
+	libp2p/bitswap/pb/dag_pb.proto \
+	libp2p/bitswap/pb/unixfs.proto
 
 PY = $(PB:.proto=_pb2.py)
 PYI = $(PB:.proto=_pb2.pyi)

README.md

@@ -11,6 +11,7 @@
 [![Python versions](https://img.shields.io/pypi/pyversions/libp2p.svg)](https://pypi.python.org/pypi/libp2p)
 [![Build Status](https://img.shields.io/github/actions/workflow/status/libp2p/py-libp2p/tox.yml?branch=main&label=build%20status)](https://github.com/libp2p/py-libp2p/actions/workflows/tox.yml)
 [![Docs build](https://readthedocs.org/projects/py-libp2p/badge/?version=latest)](http://py-libp2p.readthedocs.io/en/latest/?badge=latest)
+<a href="https://filecoin.drips.network/app/projects/github/libp2p/py-libp2p" target="_blank"><img src="https://filecoin.drips.network/api/embed/project/https%3A%2F%2Fgithub.com%2Flibp2p%2Fpy-libp2p/support.png?background=light&style=drips&text=project&stat=support" alt="Support py-libp2p on drips.network" height="32"></a>
 
 > py-libp2p has moved beyond its experimental roots and is steadily progressing toward production readiness. The core features are stable, and we’re focused on refining performance, expanding protocol support, and ensuring smooth interop with other libp2p implementations. We welcome contributions and real-world usage feedback to help us reach full production maturity.
 
@@ -55,7 +56,7 @@ ______________________________________________________________________
 | **Secure Communication** | **Status** |                                  **Source**                                   |
 | ------------------------ | :--------: | :---------------------------------------------------------------------------: |
 | **`libp2p-noise`**       |     ✅     | [source](https://github.com/libp2p/py-libp2p/tree/main/libp2p/security/noise) |
-| **`libp2p-tls`**         |     🌱     |                                                                               |
+| **`libp2p-tls`**         |     ✅     |                                                                               |
 
 ______________________________________________________________________
 
@@ -100,7 +101,7 @@ ______________________________________________________________________
 
 | **Storage**         | **Status** |
 | ------------------- | :--------: |
-| **`libp2p-record`** |     🌱     |
+| **`libp2p-record`** |     ✅     |
 
 ______________________________________________________________________
 

docs/conf.py

@@ -18,7 +18,7 @@
 import os
 import sys
 
-sys.path.insert(0, os.path.abspath('..'))
+sys.path.insert(0, os.path.abspath(".."))
 from unittest.mock import MagicMock
 
 try:
@@ -50,6 +50,21 @@
     "sphinx_rtd_theme",
 ]
 
+# Configure Python domain to prefer canonical imports
+# This helps resolve ambiguous references like ResourceManager
+python_use_unqualified_type_names = False
+
+# Configure autodoc to prefer specific imports for ambiguous references
+autodoc_type_aliases = {
+    "ResourceManager": "libp2p.rcmgr.ResourceManager",
+}
+
+# Suppress specific warnings about ambiguous cross-references
+# Since ResourceManager is intentionally re-exported, both locations are valid
+suppress_warnings = [
+    "ref.python",  # Suppress ambiguous cross-reference warnings
+]
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
 
@@ -291,7 +306,12 @@
 ]
 
 # Prevent autodoc from trying to import module from tests.factories
-autodoc_mock_imports = ["tests.factories"]
+autodoc_mock_imports = [
+    "tests.factories",
+    # Mocked ONLY for Sphinx/autodoc: this module does not exist in the codebase
+    # but some doc tools may try to import it. No real code references this import.
+    "libp2p.relay.circuit_v2.lib"
+]
 
 # Documents to append as an appendix to all manuals.
 # texinfo_appendices = []

docs/contributing.rst

@@ -261,6 +261,7 @@ To add a new example (e.g., identify):
                "echo-demo=examples.echo.echo:main",
                "ping-demo=examples.ping.ping:main",
                "identify-demo=examples.identify.identify:main",
+               "circuit-relay-demo=examples.circuit_relay.relay_example:main"
            ],
        }