buzzkit 0.1.0__tar.gz → 0.1.1__tar.gz

{buzzkit-0.1.0 → buzzkit-0.1.1}/Cargo.lock

@@ -168,7 +168,7 @@ dependencies = [
 
 [[package]]
 name = "buzzkit"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "base64",
  "buzz-core",

{buzzkit-0.1.0 → buzzkit-0.1.1}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "buzzkit"
-version = "0.1.0"
+version = "0.1.1"
 edition = "2021"
 publish = false
 description = "PyO3 bindings over Block's Buzz zero-I/O crates (buzz-core / buzz-sdk)"

{buzzkit-0.1.0 → buzzkit-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: buzzkit
-Version: 0.1.0
+Version: 0.1.1
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License

{buzzkit-0.1.0 → buzzkit-0.1.1}/examples/claim_invite.py

@@ -1,6 +1,6 @@
 """Redeem a relay invite so the agent becomes a community member.
 
-    BUZZ_RELAY_URL=wss://... python examples/claim_invite.py <invite_url_or_code>
+BUZZ_RELAY_URL=wss://... python examples/claim_invite.py <invite_url_or_code>
 """
 
 from __future__ import annotations

{buzzkit-0.1.0 → buzzkit-0.1.1}/examples/list_channels.py

@@ -1,6 +1,6 @@
 """List channels (kind 39000 metadata) visible to the agent.
 
-    BUZZ_RELAY_URL=wss://... python examples/list_channels.py
+BUZZ_RELAY_URL=wss://... python examples/list_channels.py
 """
 
 from __future__ import annotations

{buzzkit-0.1.0 → buzzkit-0.1.1}/examples/offline_sign.py

@@ -1,6 +1,6 @@
 """Offline proof — no relay. keygen -> sign a Buzz message -> verify -> tamper check.
 
-    python examples/offline_sign.py
+python examples/offline_sign.py
 """
 
 from __future__ import annotations

{buzzkit-0.1.0 → buzzkit-0.1.1}/examples/send_message.py

@@ -1,6 +1,6 @@
 """Post a message to a channel via the HTTP bridge.
 
-    BUZZ_RELAY_URL=wss://... python examples/send_message.py <channel-uuid> ["message"]
+BUZZ_RELAY_URL=wss://... python examples/send_message.py <channel-uuid> ["message"]
 """
 
 from __future__ import annotations

{buzzkit-0.1.0 → buzzkit-0.1.1}/examples/set_profile.py

@@ -1,6 +1,6 @@
 """Publish the agent's profile (kind 0) so it shows a display name in Buzz.
 
-    BUZZ_RELAY_URL=wss://... python examples/set_profile.py ["Display Name"]
+BUZZ_RELAY_URL=wss://... python examples/set_profile.py ["Display Name"]
 """
 
 from __future__ import annotations

{buzzkit-0.1.0 → buzzkit-0.1.1}/examples/subscribe.py

@@ -1,6 +1,6 @@
 """Real-time inbound: subscribe to a channel over the WebSocket and print messages.
 
-    BUZZ_RELAY_URL=wss://... python examples/subscribe.py <channel-uuid>
+BUZZ_RELAY_URL=wss://... python examples/subscribe.py <channel-uuid>
 """
 
 from __future__ import annotations

{buzzkit-0.1.0 → buzzkit-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "buzzkit"
-version = "0.1.0"
+version = "0.1.1"
 description = "Python bindings + async client for Block's Buzz (Nostr) protocol, backed by Rust buzz-core/buzz-sdk"
 readme = "README.md"
 requires-python = ">=3.12"

{buzzkit-0.1.0 → buzzkit-0.1.1}/python/buzzkit/__init__.py

@@ -10,6 +10,7 @@ This is an independent, unofficial project — not affiliated with Block, Inc.
 from __future__ import annotations
 
 from ._native import (
+    KIND_ADD_MEMBER,
     KIND_AUTH,
     KIND_HTTP_AUTH,
     KIND_PRESENCE_UPDATE,
@@ -17,6 +18,7 @@ from ._native import (
     KIND_STREAM_MESSAGE,
     KIND_STREAM_MESSAGE_V2,
     build_auth_event,
+    build_join_channel_event,
     build_message_event,
     build_profile_event,
     generate_keypair,
@@ -26,9 +28,10 @@ from ._native import (
 )
 from .client import BuzzClient
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 
 __all__ = [
+    "KIND_ADD_MEMBER",
     "KIND_AUTH",
     "KIND_HTTP_AUTH",
     "KIND_PRESENCE_UPDATE",
@@ -37,6 +40,7 @@ __all__ = [
     "KIND_STREAM_MESSAGE_V2",
     "BuzzClient",
     "build_auth_event",
+    "build_join_channel_event",
     "build_message_event",
     "build_profile_event",
     "generate_keypair",

{buzzkit-0.1.0 → buzzkit-0.1.1}/python/buzzkit/_native.pyi

@@ -21,6 +21,9 @@ def build_profile_event(
 ) -> str:
     """Build + sign a profile event (kind 0); returns NIP-01 event JSON."""
 
+def build_join_channel_event(secret: str, channel_id: str) -> str:
+    """Build + sign a NIP-29 channel self-join event (kind 9000, role=bot)."""
+
 def build_auth_event(secret: str, challenge: str, relay_url: str) -> str:
     """Build + sign a NIP-42 AUTH event (kind 22242); returns event JSON."""
 
@@ -36,3 +39,4 @@ KIND_PRESENCE_UPDATE: int
 KIND_AUTH: int
 KIND_HTTP_AUTH: int
 KIND_STREAM_MESSAGE_V2: int
+KIND_ADD_MEMBER: int

{buzzkit-0.1.0 → buzzkit-0.1.1}/python/buzzkit/client.py

@@ -108,6 +108,17 @@ class BuzzClient:
         )
         return await self.post_event(ev)
 
+    async def join_channel(self, channel_id: str) -> dict:
+        """Self-add as a bot member of a channel (NIP-29 kind 9000).
+
+        Published over the WebSocket — NIP-29 management events are not accepted
+        on the HTTP bridge — so :meth:`connect` must be called first. Required
+        for the identity's messages to reach other channel members and for it to
+        appear in mention autocomplete.
+        """
+        ev = _native.build_join_channel_event(self._secret, channel_id)
+        return await self.publish(ev)
+
     async def query(self, filters: list[dict]) -> list[dict]:
         """Run a NIP-01 REQ over the HTTP bridge; returns a list of events."""
         url = f"{self._http}/query"

{buzzkit-0.1.0 → buzzkit-0.1.1}/src/lib.rs

@@ -140,6 +140,26 @@ fn build_profile_event(
     Ok(event.as_json())
 }
 
+/// Build and sign a NIP-29 channel self-join event (kind 9000, role=bot).
+/// The signer adds itself (`p` = own pubkey) to `channel_id`'s member list.
+#[pyfunction]
+fn build_join_channel_event(secret: &str, channel_id: &str) -> PyResult<String> {
+    let keys = keys_from_secret(secret)?;
+    let cid = Uuid::parse_str(channel_id)
+        .map_err(|e| PyValueError::new_err(format!("channel_id must be a UUID: {e}")))?;
+    let pubkey_hex = keys.public_key().to_hex();
+    // The `p` tag references the signer itself (self-join), so we must opt into
+    // self-tagging — nostr's EventBuilder strips author-matching `p` tags by
+    // default, which the relay would then reject as "missing p tag".
+    let builder = buzz_sdk::build_add_member(cid, &pubkey_hex, Some(buzz_sdk::MemberRole::Bot))
+        .map_err(|e| PyValueError::new_err(format!("build_add_member: {e}")))?
+        .allow_self_tagging();
+    let event = builder
+        .sign_with_keys(&keys)
+        .map_err(|e| PyValueError::new_err(format!("sign: {e}")))?;
+    Ok(event.as_json())
+}
+
 #[pymodule]
 fn _native(m: &Bound<'_, PyModule>) -> PyResult<()> {
     m.add_function(wrap_pyfunction!(generate_keypair, m)?)?;
@@ -149,6 +169,7 @@ fn _native(m: &Bound<'_, PyModule>) -> PyResult<()> {
     m.add_function(wrap_pyfunction!(sign_nip98, m)?)?;
     m.add_function(wrap_pyfunction!(verify_event, m)?)?;
     m.add_function(wrap_pyfunction!(build_profile_event, m)?)?;
+    m.add_function(wrap_pyfunction!(build_join_channel_event, m)?)?;
 
     // Buzz event kinds (subset — mirrors buzz-core/src/kind.rs).
     m.add("KIND_REACTION", 7u16)?;
@@ -157,5 +178,6 @@ fn _native(m: &Bound<'_, PyModule>) -> PyResult<()> {
     m.add("KIND_AUTH", 22242u16)?;
     m.add("KIND_HTTP_AUTH", 27235u16)?;
     m.add("KIND_STREAM_MESSAGE_V2", 40002u16)?;
+    m.add("KIND_ADD_MEMBER", 9000u16)?;
     Ok(())
 }

{buzzkit-0.1.0 → buzzkit-0.1.1}/tests/test_signing.py

@@ -59,8 +59,17 @@ def test_nip98_header_shape():
 
 def test_auth_event_is_kind_22242():
     nsec, _, _ = buzzkit.generate_keypair()
-    event = json.loads(
-        buzzkit.build_auth_event(nsec, "challenge-123", "wss://relay.example")
-    )
+    event = json.loads(buzzkit.build_auth_event(nsec, "challenge-123", "wss://relay.example"))
     assert event["kind"] == buzzkit.KIND_AUTH == 22242
     assert ["challenge", "challenge-123"] in event["tags"]
+
+
+def test_join_channel_event_keeps_self_p_tag():
+    nsec, _, pk_hex = buzzkit.generate_keypair()
+    event = json.loads(buzzkit.build_join_channel_event(nsec, str(uuid.uuid4())))
+    assert event["kind"] == buzzkit.KIND_ADD_MEMBER == 9000
+    # The `p` tag references the signer itself; it must survive nostr's self-tag
+    # stripping (allow_self_tagging) or the relay rejects the join as "missing p tag".
+    assert ["p", pk_hex] in event["tags"]
+    assert ["role", "bot"] in event["tags"]
+    assert any(t[0] == "h" for t in event["tags"])