Add basic RPC example with client and node scripts

README.md

@@ -595,6 +595,10 @@ sn list-swarms --seconds 5
 See [`examples/`](./examples).
 
 ```bash
+# smallest RPC example
+python examples/basic_rpc/node.py
+python examples/basic_rpc/client.py
+
 # two nodes, one delegates to the other
 python examples/isolated_agents/agent_alpha.py
 python examples/isolated_agents/agent_beta.py

examples/README.md

@@ -56,8 +56,8 @@ sn list-swarms
 ## 1. Basic node RPC
 
 ```bash
-python example_node.py
-python example_client.py
+python basic_rpc/node.py
+python basic_rpc/client.py
 ```
 
 A node exposes `sum`. A client calls it.

example_client.py → examples/basic_rpc/client.py

@@ -5,7 +5,7 @@
 
 async def main() -> None:
     result = await Client("127.0.0.1", 9999).call("sum", 1, 2)
-    print(f"Received: {result}")
+    print(f"sum(1, 2) = {result}")
 
 
 if __name__ == "__main__":

examples/basic_rpc/node.py

@@ -0,0 +1,12 @@
+from synapse_p2p import Node
+
+node = Node(name="calculator", port=9999)
+
+
+@node.endpoint("sum", description="Add two numbers")
+async def sum_endpoint(a: int, b: int) -> int:
+    return a + b
+
+
+if __name__ == "__main__":
+    node.run()

pyproject.toml

@@ -67,5 +67,5 @@ asyncio_mode = "auto"
 testpaths = ["synapse_p2p/tests"]
 
 [tool.pyrefly]
-project-includes = ["synapse_p2p", "examples", "example_client.py", "example_node.py"]
+project-includes = ["synapse_p2p", "examples"]
 project-excludes = ["**/__pycache__", ".venv", ".ruff_cache", ".pytest_cache"]