# buzz | Block Open Source | Knowledge Base | Instagit

A hive mind communication platform

GitHub Stars: 9.1k

Repository: https://github.com/block/buzz

---

## Articles

### [WebSocket Connection Lifecycle and Cleanup Process for the Buzz Relay: A Deep Dive](/block/buzz/websocket-connection-lifecycle-cleanup-buzz-relay)

Explore the Buzz relay's WebSocket connection lifecycle and cleanup process. Discover its semaphore admission control, NIP-42 auth, concurrent Tokio loops, and cancellation token cleanup for reliable resource management.

- Tags: deep-dive
- Published: 2026-08-29

### [How Buzz Handles NIP-17 Gift Wraps and NIP-44 Encrypted DMs in Nostr](/block/buzz/nip-17-gift-wraps-nip-44-encrypted-dms-buzz-handling)

Learn how Buzz handles NIP-17 gift wraps with ephemeral-key signed events and NIP-44 encryption for private payloads. Explore its approach to Nostr DMs.

- Tags: internals
- Published: 2026-08-29

### [How Buzz Implements Postgres Monthly Range Partitioning for High-Traffic Event Data](/block/buzz/postgres-monthly-range-partitioning-strategy-buzz)

Learn how Buzz implements Postgres monthly range partitioning with Rust validation for efficient, high-volume event log data management.

- Tags: deep-dive
- Published: 2026-08-29

### [How Buzz Controls Concurrency with Connection and Handler Semaphores](/block/buzz/connection-semaphore-handler-semaphore-limits-buzz)

Learn how Buzz controls concurrency with connection and handler semaphores. Discover how these Tokio semaphores prevent back-pressure and maintain performance by capping WebSocket sockets and limiting concurrent event processing.

- Tags: internals
- Published: 2026-08-29

### [How Buzz Implements Blossom Media Uploads with S3/MinIO Storage](/block/buzz/blossom-media-upload-s3-storage-system-buzz)

Learn how Buzz implements Blossom media uploads using S3/MinIO storage. Discover the Nostr kind 24242 authorization and SHA-256 content binding for secure, tenant-aware asset management.

- Tags: how-to-guide
- Published: 2026-08-29

### [How to Add a Custom Event Kind to the Buzz Nostr System](/block/buzz/add-new-custom-event-kind-buzz-system)

Learn how to add a custom event kind to the Buzz Nostr system. Discover the steps to declare constants, register kinds, and update validation for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-29

### [SSRF Protections for Outbound Webhook Calls in Buzz: Security Architecture and Implementation](/block/buzz/ssrf-protections-outbound-webhook-calls-buzz)

Learn how Buzz secures outbound webhook calls against SSRF attacks. Discover protections like IP resolution, private network blocking, and disabling redirects.

- Tags: architecture
- Published: 2026-08-29

### [How to Configure Rate Limiting Tiers for Humans and Agents in Buzz](/block/buzz/configure-rate-limiting-tiers-humans-agents-buzz)

Learn to configure rate limiting tiers for humans and agents in Buzz. Master Buzz's three-tiered model for effective control-plane caps, policy defaults, and user overrides.

- Tags: how-to-guide
- Published: 2026-08-29

### [How Workflow Triggers and evalexpr Condition Evaluation Work in Buzz](/block/buzz/workflow-triggers-evalexpr-condition-evaluation-buzz)

Learn how Buzz workflow triggers and evalexpr condition evaluation work. Understand variable mapping, timeouts, and limits for robust conditional step execution in your YAML workflows.

- Tags: internals
- Published: 2026-08-29

### [Understanding Local-Echo Deduplication Using the local_event_ids Cache in Buzz](/block/buzz/local-echo-deduplication-local-event-ids-cache-buzz)

Learn about local-echo deduplication in Buzz. Discover how the local_event_ids cache prevents duplicate event delivery by filtering Redis echoes before clients receive them.

- Tags: deep-dive
- Published: 2026-08-29

### [How to Implement NIP-98 HTTP Authentication for REST Endpoints in Buzz](/block/buzz/implement-nip-98-http-authentication-rest-endpoints-buzz)

Learn to implement NIP-98 HTTP authentication for REST endpoints in Buzz. Secure your API with Nostr event verification and extract caller public keys efficiently.

- Tags: how-to-guide
- Published: 2026-08-29

### [How Buzz Prevents Private Channel Leaks Through Strict Channel Access Control](/block/buzz/buzz-channel-access-control-private-channel-leaks)

Buzz prevents private channel leaks with strict channel access control. Learn how tenant-scoped checks and multi-layer validation ensure your data stays secure.

- Tags: deep-dive
- Published: 2026-08-29

### [Architecture of the Huddle Audio WebSocket Opus Relay in Buzz](/block/buzz/huddle-audio-websocket-opus-relay-architecture-buzz)

Explore the Huddle audio WebSocket Opus relay architecture in Buzz. Understand its three-layer design: WebSocket entry, audio room manager, and wire protocol for efficient real-time audio.

- Tags: architecture
- Published: 2026-08-29

### [How the ACP Agent Harness Connects Relay Events to AI Subprocesses in Buzz](/block/buzz/acp-agent-harness-relay-events-ai-subprocesses-buzz)

Discover how the ACP agent harness connects relay events to AI subprocesses in Buzz. Learn about its JSON-RPC capabilities, NDJSON protocol, and real-time steering features.

- Tags: internals
- Published: 2026-08-29

### [How to Configure Docker Compose for Block Buzz Production VPS Deployment](/block/buzz/configure-docker-compose-block-buzz-production-vps)

Deploy Block Buzz to production on your VPS using Docker Compose. Configure persistent storage and environment-based settings for a robust relay service with Postgres, Redis, and MinIO.

- Tags: how-to-guide
- Published: 2026-08-29

### [How to Register Event Kind Numbers and Integrate Them into the Buzz Ingest Pipeline](/block/buzz/register-event-kind-numbers-ingest-pipeline-buzz)

Learn how to register event kind numbers and integrate them into the Buzz ingest pipeline. Discover the process for validating and handling new event kinds.

- Tags: how-to-guide
- Published: 2026-08-29

### [How to Debug Slow Client Disconnections and the Grace Limit Mechanism in Buzz](/block/buzz/debug-slow-client-disconnections-grace-limit-buzz)

Debug slow client disconnections in Buzz by understanding the grace limit mechanism. Learn how Buzz detects and handles back-pressure and ensures graceful shutdowns.

- Tags: how-to-guide
- Published: 2026-08-29

### [How Buzz Implements a Hash-Chain Audit Log for Tamper-Evident Records](/block/buzz/hash-chain-audit-log-tamper-evident-records-buzz)

Learn how Buzz's hash-chain audit log creates tamper-evident records. Each entry uses SHA256 hashes to link to its predecessor, ensuring data integrity.

- Tags: internals
- Published: 2026-08-29

### [Redis Pub/Sub System for Presence and Typing Indicators in Buzz: Architecture and Implementation](/block/buzz/redis-pub-sub-presence-typing-indicators-buzz)

Discover how Buzz uses Redis Pub/Sub for real-time presence and typing indicators. Learn about the architecture and implementation of this ephemeral notification system.

- Tags: architecture
- Published: 2026-08-29

### [How Buzz Integrates Postgres FTS Full-Text Search: A Complete Technical Guide](/block/buzz/postgres-fts-full-text-search-integration-buzz)

Learn how Buzz integrates Postgres FTS full-text search using generated tsvector columns, GIN indexes, and triggers for fast, relevance-ranked search over Nostr events.

- Tags: deep-dive
- Published: 2026-08-29

### [How to Implement a Custom Workflow Action in Buzz's YAML Automation Engine](/block/buzz/implement-custom-workflow-action-buzz-yaml-automation)

Learn to implement a custom workflow action in Buzz's YAML automation engine. Extend ActionDef, add execution, and Buzz automatically exposes your new capability via JSON schema.

- Tags: how-to-guide
- Published: 2026-08-29

### [How Buzz Achieves Multi-Community Tenant Isolation: Database, Relay, and Client Architecture](/block/buzz/buzz-multi-community-tenant-isolation)

Discover how Buzz ensures multi community tenant isolation through database, relay, and client architecture. Learn how community_id guarantees data separation across all layers.

- Tags: architecture
- Published: 2026-08-29

### [How the Buzz Relay Implements Its Three-Tier Subscription Fan-Out System](/block/buzz/three-tier-subscription-fan-out-system-buzz-relay)

Discover the Buzz relay's three-tier subscription fan-out system. Learn how it uses WebSockets, Redis Pub/Sub, and async side effects for scalable, low-latency event delivery across distributed instances.

- Tags: architecture
- Published: 2026-08-29

### [How NIP-42 WebSocket Authentication Works in Block Buzz: A Complete Technical Guide](/block/buzz/nip-42-websocket-authentication-block-buzz)

Learn how NIP-42 WebSocket authentication works in Block Buzz. Discover the challenge-response flow, Schnorr signatures, and host-binding for secure relay access.

- Tags: deep-dive
- Published: 2026-08-29

### [Complete Guide to Buzz Workflow Action Types: 7 Supported Actions Explained](/block/buzz/what-action-types-are-supported-by-buzz-workflows)

Explore Buzz workflow action types and understand the 7 supported actions like send_message, set_channel_topic, and request_approval. Optimize your automations today.

- Tags: deep-dive
- Published: 2026-08-28

### [How the Buzz Workflow Engine Works: Architecture and Execution Flow](/block/buzz/how-does-the-buzz-workflow-engine-work)

Discover how the Buzz workflow engine works. Explore its four-layer architecture including core, trigger handler, execution engine, and side-effect sink for efficient automation.

- Tags: architecture
- Published: 2026-08-28

### [How Buzz Manages Approval Tokens: Secure Workflow Gates Explained](/block/buzz/how-are-approval-tokens-managed-in-buzz)

Learn how Buzz manages approval tokens securely. Discover its workflow gates using UUIDv4, SHA-256 hashing, and signed Nostr events for grants and denies.

- Tags: deep-dive
- Published: 2026-08-28

### [Access Control Mechanism in Buzz: NIP-42 Authentication and Scope-Based Authorization](/block/buzz/what-is-the-access-control-mechanism-in-buzz)

Discover Buzz's NIP-42 authentication and scope-based authorization. Learn how Buzz uses a token-less access control system for secure communication.

- Tags: how-to-guide
- Published: 2026-08-28

### [How Buzz Ensures Security with Schnorr Signatures: A Deep Dive into the BIP-340 Implementation](/block/buzz/how-does-buzz-ensure-security-with-schnorr-signatures)

Buzz secures events, commits, and handshakes with BIP-340 Schnorr signatures. Discover its unforgeable authentication and x-only public key verification pipeline.

- Tags: deep-dive
- Published: 2026-08-28

### [How Buzz Implements Its Subscription System: A Deep Dive into the Relay Registry](/block/buzz/how-is-the-subscription-system-implemented-in-buzz)

Discover how Buzz implements its subscription system using a thread-safe lock-free registry and DashMap indexes for efficient Nostr event fan-out to WebSocket connections.

- Tags: deep-dive
- Published: 2026-08-28

### [What Is the Event Pipeline in Buzz? Transport-Neutral Ingest Architecture Explained](/block/buzz/what-is-the-event-pipeline-in-buzz)

Discover the Buzz event pipeline, a transport-neutral ingest system. Learn how it unifies Nostr event processing with verification, validation, and scoping before persistence and broadcasting.

- Tags: internals
- Published: 2026-08-28

### [How Buzz Implements NIP-98 Authentication for HTTP Endpoints](/block/buzz/how-does-buzz-implement-nip-98-authentication-for-http-endpoints)

Learn how Buzz implements NIP-98 authentication for HTTP endpoints by embedding signed Nostr events in the Authorization header for secure server verification.

- Tags: how-to-guide
- Published: 2026-08-28

### [How Buzz Handles NIP-42 Authentication Over WebSockets](/block/buzz/how-does-buzz-handle-nip-42-authentication-over-websockets)

Discover how Buzz handles NIP-42 authentication over WebSockets using a challenge-response handshake with signed AUTH events. Learn about the client and relay's roles.

- Tags: how-to-guide
- Published: 2026-08-28

### [Complete Guide to Rust Crates in the Buzz Monorepo](/block/buzz/what-are-the-different-rust-crates-in-the-buzz-monorepo)

Discover the 29 Rust crates within the Buzz monorepo. Learn how this Cargo workspace streamlines builds and manages dependencies for efficient development.

- Tags: deep-dive
- Published: 2026-08-28

### [How Buzz Stores Media Files: S3-Compatible Object Storage with Content Hashing](/block/buzz/how-are-media-files-stored-in-buzz)

Discover how Buzz stores media files using S3-compatible object storage and content hashing. Learn about efficient storage and access control.

- Tags: architecture
- Published: 2026-08-28

### [How Buzz Uses Redis for Pub/Sub: Architecture and Implementation Guide](/block/buzz/how-does-buzz-use-redis-for-pub-sub)

Discover how Buzz leverages Redis Pub/Sub for real-time messaging. Explore its architecture, implementation, and features like presence tracking and rate limiting.

- Tags: architecture
- Published: 2026-08-28

### [What Is the Role of PostgreSQL in Buzz? Architecture and Implementation Guide](/block/buzz/what-is-the-role-of-postgres-in-buzz)

Discover how PostgreSQL powers Buzz Nostr relay. Learn its architecture and implementation for persisting events, metadata, and logs with transactional consistency.

- Tags: architecture
- Published: 2026-08-28

### [How Buzz Uses Axum for Its WebSocket Server: A Deep Dive into the Relay Implementation](/block/buzz/how-does-buzz-use-axum-for-its-websocket-server)

Explore how Buzz implements its Nostr relay server using Axum. Discover its use of WebSocketUpgrade, Router API, and middleware for CORS and authentication in the buzz-relay crate.

- Tags: deep-dive
- Published: 2026-08-28

### [What Is the Buzz Relay Architecture? A Technical Deep Dive into block/buzz](/block/buzz/what-is-the-buzz-relay-architecture)

Explore the Buzz relay architecture, a modular Nostr relay implementation supporting NIP-29. Learn about its WebSocket and HTTP APIs for media, Git, and webhooks.

- Tags: deep-dive
- Published: 2026-08-28

### [How AI Agents and Humans Collaborate in Buzz: A Technical Deep Dive](/block/buzz/how-do-ai-agents-and-humans-collaborate-in-buzz)

Explore how AI agents and humans collaborate seamlessly in Buzz, a unified Nostr relay. Learn about shared event signing, channel participation, and tool execution with identical auth and audit.

- Tags: deep-dive
- Published: 2026-08-28

### [What Is the Nostr Protocol Used for in Buzz? A Technical Deep Dive](/block/buzz/what-is-nostr-protocol-used-for-in-buzz)

Discover how Buzz uses the Nostr protocol for secure, federated communication. Learn about cryptographically signed events for data, authentication, and AI agent interactions.

- Tags: deep-dive
- Published: 2026-08-28

### [How to Self-Host Buzz: A Complete Guide to Deploying Your Nostr Workspace](/block/buzz/how-to-self-host-buzz)

Learn how to self-host Buzz, the Nostr workspace, with our complete guide. Deploy Buzz Relay using Docker Compose or bootstrap a dev environment with Hermit.

- Tags: how-to-guide
- Published: 2026-08-28

### [How Template Variables and Custom Functions Work in Buzz Workflow Definitions](/block/buzz/buzz-workflow-template-variables-custom-functions)

Learn how Buzz workflow definitions use template variables and custom Rust functions for dynamic data injection and conditional step execution with the evalexpr library.

- Tags: internals
- Published: 2026-08-27

### [Buzz Workflow Action Types: A Complete Guide to Automation Steps](/block/buzz/buzz-workflow-action-types-functionalities)

Explore Buzz workflow action types like SendMessage, CallWebhook, and RequestApproval to automate tasks and streamline your development process within the block/buzz repository.

- Tags: how-to-guide
- Published: 2026-08-27

### [Buzz Workflow Engine Trigger Types: Complete Guide to Event-Driven Automation](/block/buzz/buzz-workflow-engine-trigger-types)

Explore Buzz workflow engine trigger types: message_posted, reaction_added, diff_posted, schedule, and webhook. Automate tasks with event-driven workflows.

- Tags: deep-dive
- Published: 2026-08-27

### [How Buzz Handles Multi-Community Mode and Data Isolation for FTS Queries](/block/buzz/buzz-multi-community-mode-fts-query-isolation)

Learn how Buzz ensures data isolation for FTS queries in multi-community mode. Buzz scopes queries to specific community identifiers at the PostgreSQL level, preventing data leaks.

- Tags: deep-dive
- Published: 2026-08-27

### [How Buzz Implements Full‑Text Search with Postgres FTS and GIN Indexes](/block/buzz/buzz-full-text-search-postgres-fts-gin-indexes)

Buzz implements full-text search with Postgres FTS and GIN indexes. Learn how Buzz stores tsvector values, uses GIN indexing, and queries with websearch_to_tsquery for efficient search.

- Tags: deep-dive
- Published: 2026-08-27

### [How Buzz's Database Schema Handles Event Storage, Channel Management, and Workflow Execution](/block/buzz/buzz-database-schema-event-storage-channel-workflow)

Explore Buzz's PostgreSQL database schema for efficient event storage, secure channel management with UUIDs, and robust workflow execution using normalized tables for idempotency and tenant isolation.

- Tags: architecture
- Published: 2026-08-27

### [Buzz Authentication Scopes: Complete Guide to Permissions and Access Control](/block/buzz/buzz-authentication-scopes-usage)

Explore Buzz's 16 granular authentication scopes controlling access to messages, channels, users, and more. Understand permissions and access control in this complete guide.

- Tags: api-reference
- Published: 2026-08-27

### [How Buzz Implements NIP-98 HTTP Authentication: Event Signing and Verification](/block/buzz/buzz-nip-98-http-authentication-mechanism)

Learn how Buzz implements NIP-98 HTTP authentication with event signing and verification. Discover the secure method for Nostr client requests to relays.

- Tags: deep-dive
- Published: 2026-08-27

### [How Buzz Implements NIP-42 WebSocket Authentication: A Rust Deep Dive](/block/buzz/buzz-nip-42-websocket-authentication-implementation)

Discover how Buzz implements NIP-42 WebSocket authentication using Rust. Explore the three-stage handshake across buzz-auth, buzz-ws-client, and buzz-relay crates for secure connections.

- Tags: deep-dive
- Published: 2026-08-27

### [Buzz Custom Event Kinds: Complete Guide to Nostr Event Types](/block/buzz/buzz-custom-event-kinds-list-description)

Explore Buzz's extensive Nostr custom event kinds for reactions, messaging, AI jobs, and more. Discover our complete guide to event types and enhance your Nostr experience.

- Tags: deep-dive
- Published: 2026-08-27

### [Nostr Kind Ranges and Meanings in Buzz: Complete Technical Reference](/block/buzz/nostr-kind-ranges-meanings-buzz)

Explore Nostr kind ranges and meanings in Buzz. Understand how these ranges define storage, replacement, and access control with our technical reference.

- Tags: technical-reference
- Published: 2026-08-27

### [NIP-01 Wire Format for Nostr Events in Buzz: Implementation Guide](/block/buzz/nip-01-wire-format-nostr-events-buzz)

Explore the NIP-01 wire format for Nostr events in Buzz. Learn how Buzz implements this standard JSON structure for seamless data exchange over WebSockets and HTTP. Get the technical details now.

- Tags: implementation-guide
- Published: 2026-08-27

### [How buzz-workflow Enables YAML-as-Code Automation in Buzz](/block/buzz/buzz-workflow-yaml-as-code-automation)

Learn how buzz-workflow enables YAML-as-code automation in Buzz. Execute YAML workflows as immutable Nostr events with conditional logic and webhooks.

- Tags: how-to-guide
- Published: 2026-08-27

### [Buzz-Auth Functionalities: Handling NIP-42, NIP-98, API Tokens, and Rate Limiting](/block/buzz/buzz-auth-nip-42-nip-98-api-tokens-rate-limiting)

Explore buzz-auth functionalities for Nostr relays. Learn how it handles NIP-42, NIP-98, API tokens, and rate limiting to secure your operations.

- Tags: deep-dive
- Published: 2026-08-27

### [How buzz-core Verifies Nostr Events and Matches Filters Without I/O](/block/buzz/buzz-core-nostr-types-verification-filter-matching-no-io)

Discover how buzz-core verifies Nostr events and matches filters using pure Rust in-memory functions, eliminating I/O for faster processing. Learn about cryptographic validation and struct comparisons.

- Tags: internals
- Published: 2026-08-27

### [Crate Dependency Hierarchy in Buzz: How buzz-core Anchors the Workspace](/block/buzz/buzz-crate-dependency-hierarchy-buzz-core)

Explore the Buzz crate dependency hierarchy starting with buzz-core. Understand how this foundational crate anchors the entire workspace and its shared logic.

- Tags: internals
- Published: 2026-08-27

### [What Is the Single Source of Truth in Buzz's System Design and How Does State Flow Through the Event Store](/block/buzz/buzz-system-design-single-source-of-truth-event-store)

Discover Buzz's single source of truth: the relay. Learn how state flows through the event store, ensuring data integrity before distribution to subscribers and search indexes.

- Tags: architecture
- Published: 2026-08-27

### [How Buzz Leverages Redis for Real-Time Presence and Typing Indicators](/block/buzz/buzz-redis-presence-typing-indicators)

Discover how Buzz uses Redis for real-time presence and typing indicators. Learn about sub-second updates and ephemeral states for enhanced user experience.

- Tags: how-to-guide
- Published: 2026-08-27

### [Database Technologies Buzz Uses for Events, Channels, and Workflow Data](/block/buzz/buzz-database-technologies-event-storage)

Discover how Buzz uses PostgreSQL for durable event, channel, and workflow data storage and Redis for real-time pub/sub and state coordination.

- Tags: architecture
- Published: 2026-08-27

### [How Buzz Relay (buzz-relay) Handles NIP-42 Authentication, Event Pipelines, and HTTP Bridging](/block/buzz/buzz-relay-authentication-event-pipeline-http-bridge)

Discover how Buzz relay manages NIP-42 authentication, event pipelines, and HTTP bridging. Learn about its efficient cryptographic verification and ingestion process.

- Tags: deep-dive
- Published: 2026-08-27

### [What Programming Languages Are Used for Buzz's Relay, Desktop, and Mobile Clients?](/block/buzz/buzz-programming-languages-relay-desktop-mobile)

Discover the programming languages powering Buzz's relay (Rust), desktop (Rust/TypeScript/React), and mobile (Dart/Flutter) clients. Learn about the tech stack behind this communication platform.

- Tags: internals
- Published: 2026-08-27

### [How Nostr Events and Kind Integers Power Buzz's Architecture](/block/buzz/nostr-events-kind-integers-buzz-architecture)

Discover how Nostr events and kind integers form Buzz's core architecture, enabling efficient operation routing through its relay system. Learn more about this innovative approach.

- Tags: architecture
- Published: 2026-08-27

### [How to Self-Host a Nostr Relay for Collaborative AI and Human Agents with Buzz](/block/buzz/how-to-self-host-nostr-relay-buzz)

Self host a Nostr relay with Buzz for seamless AI and human collaboration. This guide shows you how to set up the core messaging backbone using PostgreSQL and WebSocket endpoints.

- Tags: how-to-guide
- Published: 2026-08-27

### [How the Buzz Tauri Desktop Application Switches Between Communities](/block/buzz/how-does-the-tauri-desktop-application-manage-switching-between-communities)

Learn how the Buzz Tauri desktop app switches communities using React keys for clean UI unmounting, storage persistence, and backend state reset. Ensure seamless community isolation.

- Tags: internals
- Published: 2026-08-26

### [How to Write End-to-End Tests for Multi-Agent Interactions in Buzz](/block/buzz/how-to-write-end-to-end-tests-for-multi-agent-interactions-in-buzz)

Learn to write end-to-end tests for multi-agent interactions in Buzz using TestHarness. Orchestrate agents and test Nostr event exchanges with ease.

- Tags: how-to-guide
- Published: 2026-08-26

### [How the Huddle WebSocket Facilitates Opus Voice Communication in Buzz](/block/buzz/how-does-the-huddle-websocket-facilitate-opus-voice-communication)

Discover how the Buzz huddle WebSocket streams real-time Opus voice using a custom binary protocol for efficient audio communication. Learn more today.

- Tags: internals
- Published: 2026-08-26

### [Buzz Mesh Architecture for Shared AI Compute: How block/buzz Enables Community-Scale Distributed AI](/block/buzz/what-is-the-architecture-of-the-buzz-mesh-for-shared-ai-compute)

Discover the Buzz Mesh architecture for shared AI compute. Learn how block/buzz uses a three-layer system to create community-scale distributed AI, accessible via OpenAI-compatible endpoints.

- Tags: architecture
- Published: 2026-08-26

### [How Agent Personas and Teams Are Managed in the Buzz System](/block/buzz/how-are-agent-personas-and-teams-managed-within-the-buzz-system)

Discover how Buzz manages agent personas as Nostr kind 30175 events and teams as kind 30178 catalog entries. Learn about membership resolution and data persistence in the Tauri backend.

- Tags: internals
- Published: 2026-08-26

### [Rate Limiting Policies and Enforcement Mechanisms in Buzz: Architecture vs. Implementation](/block/buzz/what-are-the-rate-limiting-policies-and-enforcement-mechanisms-in-buzz)

Explore Buzz's rate limiting architecture and enforcement. Understand how its permissive stub impacts runtime security and learn about potential implementations.

- Tags: architecture
- Published: 2026-08-26

### [Troubleshooting WebSocket Connection Errors in Buzz Relay: A Complete Diagnostic Guide](/block/buzz/troubleshooting-steps-for-websocket-connection-errors-in-buzz-relay)

Resolve Buzz Relay WebSocket connection errors with this diagnostic guide. Learn about connection limits, auth timeouts, and back-pressure to ensure stable relay connections.

- Tags: how-to-guide
- Published: 2026-08-26

### [How to Configure TLS and At-Rest Encryption for Buzz Security](/block/buzz/how-do-you-configure-tls-and-at-rest-encryption-for-buzz-security)

Learn to configure TLS and at-rest encryption for Buzz security. Enable TLS through the Helm chart and leverage cloud-provider encryption for at-rest data.

- Tags: how-to-guide
- Published: 2026-08-26

### [Essential Environment Variables for Deploying Buzz in Production](/block/buzz/what-environment-variables-are-essential-for-deploying-buzz-in-a-production-environment)

Discover essential environment variables for Buzz production deployment. Learn about BUZZ_PRIVATE_KEY, BUZZ_RELAY_URL, BUZZ_AUTH_TAG, BUZZ_DB_URL, BUZZ_REDIS_URL, and BUZZ_PUSH_* variables to secure and optimize your Buzz appli...

- Tags: best-practices
- Published: 2026-08-26

### [How the Buzz Git Hosting Backend Processes NIP-34 Patches](/block/buzz/how-does-the-buzz-git-hosting-backend-process-nip-34-patches)

Discover how the Buzz git hosting backend processes NIP-34 patches. Learn about event ingestion, validation, storage, ref-state updates, and Smart-HTTP Git transport.

- Tags: internals
- Published: 2026-08-26

### [NIP-29 Channel Group Extensions in Buzz: Technical Specifications](/block/buzz/what-are-the-technical-specifications-for-nip-29-channel-group-extensions-in-buzz)

Explore NIP-29 channel group extensions in Buzz. Understand technical specifications, event kinds 39000-39003, and admin commands 9000-9007 for channel identifiers and membership.

- Tags: technical-specifications
- Published: 2026-08-26

### [Buzz-CLI Agent-First Interface: Complete Guide to Managing Nostr Agents](/block/buzz/what-is-the-functionality-and-usage-of-the-buzz-cli-agent-first-interface)

Master the Buzz-CLI agent-first interface for Nostr agents. Manage AI identities programmatically using Clap, environment variables, and flags. Supports JSON and compact output.

- Tags: how-to-guide
- Published: 2026-08-26

### [How Buzz Uses Redis Pub/Sub Mechanisms for Real-Time Presence and Typing Indicators](/block/buzz/how-do-redis-pub-sub-mechanisms-handle-presence-and-typing-indicators-in-buzz)

Discover how Buzz leverages Redis Pub/Sub for real-time presence and typing indicators. Learn about hash keys for durable presence and ephemeral topics for instant messaging.

- Tags: deep-dive
- Published: 2026-08-26

### [Event Storage Design in the buzz-db Module: How Buzz Persists Nostr Events](/block/buzz/what-is-the-event-storage-design-within-the-buzz-db-module)

Explore Buzz's event storage design in buzz-db. Learn how Nostr events are persisted in PostgreSQL with selective rules, single-row inserts, and soft-delete semantics for multi-tenant relays.

- Tags: internals
- Published: 2026-08-26

### [How Buzz Configures Postgres Full-Text Search for Permission-Aware Searching](/block/buzz/how-is-postgres-full-text-search-configured-for-permission-aware-searching-in-buzz)

Learn how Buzz configures Postgres Full-Text Search with permission-aware filtering. Discover how CommunityId ensures secure, scoped search results directly in your SQL WHERE clause.

- Tags: how-to-guide
- Published: 2026-08-26

### [How the Blossom Protocol Handles Media Uploads in Buzz: A Complete Technical Guide](/block/buzz/describe-the-blossom-protocol-s-media-upload-process)

Learn how the Blossom protocol secures media uploads in Buzz using cryptographically authenticated requests and dedicated processing pipelines after Nostr auth verification. Get the technical details.

- Tags: deep-dive
- Published: 2026-08-26

### [How the Buzz Workflow Engine Evaluates Conditions in YAML Files](/block/buzz/how-does-the-buzz-workflow-engine-evaluate-conditions-defined-in-yaml-files)

Learn how the Buzz workflow engine evaluates YAML conditions using Rust and the evalexpr crate. Discover how it determines action execution based on event data and custom functions.

- Tags: deep-dive
- Published: 2026-08-26

### [ACP Harness Architecture in Buzz: Connecting AI Agents via Agent-Client-Protocol](/block/buzz/what-is-the-architecture-of-the-acp-harness-for-connecting-ai-agents-in-buzz)

Explore the ACP harness architecture in Buzz, a three-layer bridge managing AI agent subprocesses and JSON-RPC communication for seamless agent connection and lifecycle management.

- Tags: architecture
- Published: 2026-08-26

### [How the Hash-Chain Audit Log Is Structured and Implemented in buzz-audit](/block/buzz/how-is-the-hash-chain-audit-log-structured-and-implemented-in-the-buzz-audit-component)

Discover how the hash-chain audit log is structured and implemented in buzz-audit. Learn about SHA-256 digests and cryptographic integrity for tamper detection in the Buzz relay.

- Tags: internals
- Published: 2026-08-26

### [End-to-End Implementation of NIP‑42 Schnorr Authentication in Buzz](/block/buzz/explain-the-end-to-end-implementation-of-nip-42-schnorr-authentication-in-buzz)

Explore Buzz's end-to-end NIP-42 Schnorr authentication. Learn how Buzz uses challenge-response, signed events, and signature verification for secure relay connections.

- Tags: deep-dive
- Published: 2026-08-26

### [Which Nostr NIP Standards Are Implemented by the Buzz Relay?](/block/buzz/which-nostr-nip-standards-are-implemented-by-the-buzz-relay)

Discover which Nostr NIP standards the Buzz relay supports. Buzz implements over 20 NIPs including NIP-01, NIP-04, NIP-44, NIP-29, and NIP-98 for core protocol, messaging, and auth.

- Tags: api-reference
- Published: 2026-08-26

### [How Community Isolation Functions in a Multi-Tenant Buzz Deployment](/block/buzz/how-does-community-isolation-function-in-a-multi-tenant-buzz-deployment)

Learn how community isolation in Buzz protects tenant data with composite keys, SQLite stores, rate limits, and counters. Prevent cross-tenant leaks in your multi-tenant deployment.

- Tags: architecture
- Published: 2026-08-26

### [Security Measures for Outbound Webhook Calls in Buzz: 9 Layers of Defense Explained](/block/buzz/buzz-webhook-security-outbound-calls)

Discover Buzz's 9 layers of defense for secure outbound webhook calls. Learn about trigger validation, authorization, SSRF prevention, and runtime safeguards.

- Tags: deep-dive
- Published: 2026-08-25

### [How Buzz Maintains Audit Log Integrity Using Per-Community Hash Chains](/block/buzz/buzz-audit-log-integrity-hash-chains)

Buzz secures audit logs with per-community hash chains. Each entry links to the previous hash, cryptographically verifying data integrity and detecting unauthorized changes.

- Tags: architecture
- Published: 2026-08-25

### [How Buzz Prevents Server-Side Request Forgery (SSRF) in Workflow Executions](/block/buzz/buzz-ssrf-vulnerability-protection)

Discover how Buzz prevents SSRF vulnerabilities in workflow executions. Learn how Buzz resolves hostnames, filters private IPs, and pins addresses to stop DNS rebinding attacks.

- Tags: how-to-guide
- Published: 2026-08-25

### [How Buzz Enforces Rate Limiting: Configuration and Implementation Guide](/block/buzz/buzz-rate-limiting-enforcement-configuration)

Learn how Buzz enforces rate limiting using a Redis-backed fixed-window counter. Discover configuration options and implementation details for per-community isolation.

- Tags: how-to-guide
- Published: 2026-08-25

### [What Authentication Methods Does Buzz Support for WebSocket and REST APIs?](/block/buzz/buzz-authentication-websocket-rest-apis)

Buzz supports NIP-42 challenge-response for WebSockets, NIP-98 signed events for REST APIs, and static bearer tokens. Secure your API connections effectively.

- Tags: api-reference
- Published: 2026-08-25

### [Buzz Workflow Infinite Loop Prevention: Depth Limits, Cycle Detection, and Timeouts](/block/buzz/buzz-workflow-preventing-infinite-loops)

Prevent Buzz workflow infinite loops with depth limits, cycle detection, and timeouts. Ensure task completion and avoid resource exhaustion in your block buzz repository.

- Tags: internals
- Published: 2026-08-25

### [How Buzz Manages Concurrency and Capacity Limits in Its Workflow Engine](/block/buzz/buzz-workflow-concurrency-capacity-limits)

Learn how Buzz manages concurrency and capacity limits in its workflow engine using tokio sync Semaphore, tokio time timeout, and moka sync Cache to prevent resource exhaustion.

- Tags: internals
- Published: 2026-08-25

### [How Conditions Are Evaluated in Buzz Workflows: Custom Functions and Expression Engine](/block/buzz/buzz-workflow-condition-evaluation-custom-functions)

Discover how Buzz workflows evaluate conditions using evalexpr and custom string functions. Learn about trigger and step data context for precise logic.

- Tags: deep-dive
- Published: 2026-08-25

### [How Template Variables Are Resolved in Buzz Workflows](/block/buzz/buzz-workflow-template-variable-resolution)

Discover how Buzz resolves template variables synchronously using a sandboxed executor. Learn about expression parsing, context lookups, and filter application for efficient workflow actions.

- Tags: internals
- Published: 2026-08-25

### [Complete List of Buzz Workflows Triggers and Actions](/block/buzz/buzz-workflow-triggers-actions)

Explore all Buzz workflow triggers and actions including MessagePosted, ReactionAdded, SendMessage, and CallWebhook. Optimize your workflows with the complete list.

- Tags: api-reference
- Published: 2026-08-25

### [How Buzz Stores and Executes Workflows Defined in YAML](/block/buzz/buzz-workflow-engine-yaml-execution)

Discover how Buzz stores YAML workflows as Nostr events and executes them using a semaphore-governed engine for efficient conditional step evaluation and side effect dispatch.

- Tags: internals
- Published: 2026-08-25

### [Historical Query Limits in Buzz: Client Budgets and Relay Constraints Explained](/block/buzz/buzz-historical-query-limits)

Understand historical query limits in Buzz. Learn about client budgets of 10,000 events and relay constraints to optimize your data retrieval.

- Tags: deep-dive
- Published: 2026-08-25

### [How Buzz Enforces Channel Access Controls in Its Nostr Relay](/block/buzz/buzz-subscription-channel-access-control)

Buzz enforces channel access controls with SubscriptionScope, restricting WebSocket subscriptions to global events or specific channel UUIDs for secure event fan-out and to prevent cross-channel leakage.

- Tags: internals
- Published: 2026-08-25

### [How the Buzz Subscription System Optimizes Nostr Event Delivery Through Targeted In-Memory Indexes](/block/buzz/buzz-subscription-system-event-delivery-optimization)

Discover how the Buzz subscription system optimizes Nostr event delivery using five specialized in-memory indexes for O(1) lookups, eliminating slow linear scans and boosting fan-out performance.

- Tags: performance
- Published: 2026-08-25

### [How Buzz Manages Slow Clients in WebSocket Connections: Back‑Pressure Protection Explained](/block/buzz/buzz-managing-slow-clients-websocket)

Learn how Buzz protects server memory from slow WebSocket clients using back pressure. Discover automatic connection termination to safeguard your application.

- Tags: deep-dive
- Published: 2026-08-25

### [How the Buzz Event Pipeline Handles Incoming Nostr Messages: A 7-Stage Breakdown](/block/buzz/buzz-event-pipeline-handling-nostr-messages)

Explore the 7 stages of the Buzz event pipeline handling incoming Nostr messages. Learn how Buzz ensures signature authenticity, isolation, and efficient delivery using PostgreSQL and Redis.

- Tags: deep-dive
- Published: 2026-08-25

### [How to Add a New Event Kind in Buzz: A Complete Implementation Guide](/block/buzz/buzz-adding-new-event-kind-process)

Learn how to add a new event kind in Buzz. This guide covers registering constants, updating ALL_KINDS, adding assertions, and extending validation logic for seamless implementation.

- Tags: how-to-guide
- Published: 2026-08-25

### [How Nostr Event Kinds Are Classified in Buzz: Standard, Replaceable, and Ephemeral Events](/block/buzz/buzz-nostr-event-kind-classification)

Discover how Buzz classifies Nostr event kinds: standard, replaceable, and ephemeral. Learn about persistence rules enforced at compile time.

- Tags: internals
- Published: 2026-08-25

### [What Is the Role of buzz-core in the Block Buzz Project?](/block/buzz/buzz-core-role-in-project)

Discover the role of buzz-core in the Block Buzz project. Learn how this zero-IO foundation provides essential data structures and cryptographic verification for all other project components.

- Tags: deep-dive
- Published: 2026-08-25

### [How Buzz Uses Event Kinds for Feature Management in the Nostr Protocol](/block/buzz/buzz-event-kinds-feature-management)

Discover how Buzz leverages event kinds for robust feature management within the Nostr protocol. Learn about centralized event type governance and access control strategies.

- Tags: how-to-guide
- Published: 2026-08-25

### [How to Set Up Buzz as a Self-Hostable Nostr Relay: Complete Deployment Guide](/block/buzz/how-to-set-up-buzz-self-hostable-nostr-relay)

Set up Buzz, a self-hostable Nostr relay in Rust. Deploy your own relay using PostgreSQL and Redis with this complete guide. Start hosting Nostr events today.

- Tags: how-to-guide
- Published: 2026-08-25

### [How Buzz Enforces Global Relay-Wide Connection Limits Using a Tokio Semaphore](/block/buzz/how-does-the-connection-semaphore-enforce-global-relay-wide-connection-limits)

Buzz enforces global relay connection limits using a Tokio semaphore. Learn how this single semaphore in AppState caps concurrent WebSocket connections and rejects new clients once the max limit is hit.

- Tags: internals
- Published: 2026-08-24

### [How the Approval Gate Workflow Action Suspends Execution Pending Human Authorization in Buzz](/block/buzz/how-does-the-approval-gate-workflow-action-suspend-execution-pending-human-authorization)

Discover how the Buzz approval gate workflow action suspends execution pending human authorization. Learn about its current implementation and future capabilities.

- Tags: deep-dive
- Published: 2026-08-24

### [How NIP-50 Search Filters Route Requests to Postgres FTS via the /query Endpoint in Buzz](/block/buzz/how-does-the-nip-50-search-filter-route-requests-to-postgres-fts-via-the-query-endpoint)

Learn how Buzz routes NIP-50 search requests via the /query endpoint to Postgres FTS. Discover optimized PostgreSQL queries for efficient event retrieval.

- Tags: internals
- Published: 2026-08-24

### [How the Monthly Partition Manager in buzz-db Prevents DDL Injection](/block/buzz/how-does-the-monthly-partition-manager-in-buzz-db-prevent-ddl-injection)

Learn how buzz-db's monthly partition manager stops DDL injection. Discover its strict allow-list, suffix validation, and date format verification for secure SQL.

- Tags: internals
- Published: 2026-08-24

### [How Ephemeral Nostr Events (Kinds 20000-29999) Bypass Database Storage and Search Indexing in Buzz](/block/buzz/how-do-ephemeral-nostr-events-bypass-db-storage-and-search-indexing)

Discover how ephemeral Nostr events (kinds 20000-29999) in Buzz bypass PostgreSQL storage and search indexing, using only Redis pub/sub and WebSockets for efficient real-time communication.

- Tags: internals
- Published: 2026-08-24

### [How Buzz Relay Implements Slow Client Detection and Disconnection Policies](/block/buzz/how-does-the-relay-implement-slow-client-detection-and-disconnection-policies)

Learn how Buzz detects slow clients by tracking WebSocket backpressure and disconnects them after a configurable grace limit of buffer-full events. Explore the block/buzz repository.

- Tags: internals
- Published: 2026-08-24

### [How Buzz's Feed Query System Resolves Mentions and Activity for Needs-Action Views](/block/buzz/how-does-the-feed-query-system-resolve-mentions-and-activity-for-a-user-s-needs-action-view)

Discover how Buzz's feed query system merges mentions, actionable events, and activity queries to create a user's needs-action view, filtered by Nostr event kinds.

- Tags: internals
- Published: 2026-08-24

### [How the Buzz Desktop App Switches Communities Without Requiring a Page Reload](/block/buzz/how-does-the-desktop-app-switch-communities-without-requiring-a-page-reload)

Discover how the Buzz desktop app remounts React components to switch communities instantly without page reloads. Learn the technical details behind this seamless user experience.

- Tags: internals
- Published: 2026-08-24

### [How the Buzz SSRF Protection Module Blocks Private IP Ranges in Webhooks](/block/buzz/how-does-the-ssrf-protect-module-prevent-ssrf-attacks-by-blocking-private-ip-ranges-in-webhooks)

Discover how Buzz's SSRF protection module blocks private IP ranges in webhooks. Learn how it validates hostnames and prevents SSRF attacks for secure webhook integration.

- Tags: internals
- Published: 2026-08-24

### [How Dev-Only Key Derivation Works for Testing in Buzz Without Production Authentication](/block/buzz/how-does-dev-only-key-derivation-work-for-testing-without-production-authentication)

Learn how Buzz uses dev-only key derivation for secure local testing. Generate crypto keys without production authentication, streamlining your development workflow.

- Tags: internals
- Published: 2026-08-24

### [How the Blossom Media Upload Endpoint Handles Multipart Blobs and SHA‑256 Verification](/block/buzz/how-does-the-blossom-media-upload-endpoint-handle-multipart-blobs-and-sha256-verification)

Learn how the Blossom media upload endpoint in block/buzz secures multipart blobs with SHA256 verification, streaming video and processing images for robust data integrity.

- Tags: how-to-guide
- Published: 2026-08-24

### [How Buzz's Huddle Audio Subsystem Forwards Opus Frames Between Peers Without an SFU](/block/buzz/how-does-the-huddle-audio-subsystem-forward-opus-frames-between-peers-without-an-sfu)

Discover how Buzz's huddle audio subsystem forwards Opus frames directly between peers. Learn how it bypasses SFUs by treating frames as opaque blobs and prepending sender IDs for efficient peer-to-peer communication.

- Tags: internals
- Published: 2026-08-24

### [How Buzz Relay Enforces Channel Membership Access Control Before Subscription Registration](/block/buzz/how-does-the-relay-enforce-channel-membership-access-control-before-subscription-registration)

Learn how Buzz Relay enforces channel membership access control with NIP-42 authentication before subscription registration, validating filters against public keys and scoping to community tenants.

- Tags: internals
- Published: 2026-08-24

### [How Redis Pub/Sub Facilitates Fan-Out for Cross-Node Event Distribution in Buzz](/block/buzz/how-does-redis-pub-sub-facilitate-fan-out-for-cross-node-event-distribution)

Discover how Redis pub/sub enables efficient fan-out for cross-node event distribution in Buzz, achieving horizontal scalability with low latency. Learn more today.

- Tags: deep-dive
- Published: 2026-08-24

### [How Buzz Nostr Relay Uses PostgreSQL Full-Text Search with a Generated `search_tsv` Column](/block/buzz/how-is-postgres-full-text-search-utilized-through-the-search-tsv-generated-column)

Buzz Nostr Relay leverages PostgreSQL full-text search with a generated search_tsv column to efficiently index and query event data, powering NIP-50 search.

- Tags: deep-dive
- Published: 2026-08-24

### [How buzz-acp Bridges Relay Events to AI Agents via ACP/JSON-RPC: A Deep Dive into the Buzz Agent Harness](/block/buzz/how-does-buzz-acp-bridge-relay-events-to-ai-agents-via-acp-json-rpc)

Learn how buzz-acp connects Nostr relay events to AI agents using ACP/JSON-RPC over STDIO. Discover the Buzz Agent Harness and unlock new possibilities.

- Tags: deep-dive
- Published: 2026-08-24

### [How the Buzz Workflow Engine Evaluates YAML Triggers Using `evalexpr`](/block/buzz/how-does-the-workflow-engine-evaluate-yaml-triggers-using-evalexpr)

Discover how the Buzz workflow engine evaluates YAML triggers using evalexpr. Learn about context building and sandboxed boolean evaluation for trigger conditions.

- Tags: internals
- Published: 2026-08-24

### [How Buzz Audit Log Hash Chains Ensure Tamper‑Evidence](/block/buzz/how-does-the-hash-chain-audit-log-in-buzz-audit-ensure-tamper-evident-logging)

Discover how buzz audit log hash chains ensure tamper-evident logging. Buzz-audit uses SHA-256 hashes to cryptographically bind log entries, preventing unauthorized modifications.

- Tags: internals
- Published: 2026-08-24

### [How Multi-Community Mode Achieves Tenant Data Isolation on Shared Infrastructure in Buzz](/block/buzz/how-does-multi-community-mode-achieve-tenant-data-isolation-on-shared-infrastructure)

Learn how Buzz's multi-community mode isolates tenant data on shared infrastructure. Discover how unique community identifiers secure network requests, runtime state, and storage.

- Tags: deep-dive
- Published: 2026-08-24

### [How NIP-42 Authentication Works in WebSocket Connections for the Buzz Relay](/block/buzz/how-is-nip-42-authentication-handled-during-websocket-connections-in-block-buzz)

Learn how NIP-42 authentication secures WebSocket connections in block/buzz. Discover the challenge/response protocol and signed kind 22242 events for Nostr messaging.

- Tags: deep-dive
- Published: 2026-08-24

### [Three-Tier Fan-Out in SubscriptionRegistry: How Buzz Delivers Nostr Events in Sub-Linear Time](/block/buzz/what-is-the-implementation-of-three-tier-fan-out-in-subscriptionregistry)

Discover how Buzz's SubscriptionRegistry implements three-tier fan-out using in-memory indexes to efficiently route Nostr events to clients in sub-linear time.

- Tags: deep-dive
- Published: 2026-08-24

### [How the block/buzz Event Pipeline Processes Nostr Events: A Deep Dive into Relay Architecture](/block/buzz/how-does-the-block-buzz-event-pipeline-process-nostr-events)

Discover how the block/buzz event pipeline processes Nostr events. Learn about signature validation, access scope resolution, Postgres persistence, and fan-out to subscribers.

- Tags: deep-dive
- Published: 2026-08-24

### [Member Roles in the Block/Buzz Channel Hierarchy: A Complete Technical Guide](/block/buzz/channel-member-roles-block-buzz)

Explore member roles in the block/buzz channel hierarchy. Understand owner, admin, member, guest, and bot permissions enforced by PostgreSQL, Rust, and TypeScript.

- Tags: deep-dive
- Published: 2026-08-23

### [Understanding the Channel Type Hierarchy in Block Buzz: Stream, Forum, DM, and Workflow](/block/buzz/channel-type-hierarchy-block-buzz)

Explore the channel type hierarchy in Block Buzz: Stream, Forum, DM, and Workflow. Understand how these conversation spaces are organized and exposed to developers via the Buzz SDK.

- Tags: deep-dive
- Published: 2026-08-23

### [How NIP-98 HTTP Authentication Works on HTTP Bridge Endpoints in block/buzz](/block/buzz/nip-98-http-auth-bridge-endpoints-block-buzz)

Understand NIP-98 HTTP authentication in block/buzz. Securely protect bridge endpoints using Nostr signed events and Redis for replay attack prevention. Learn how it works.

- Tags: deep-dive
- Published: 2026-08-23

### [How Block/Buzz Uses the `ON CONFLICT DO NOTHING` Pattern for Event Idempotency](/block/buzz/on-conflict-do-nothing-event-idempotency-block-buzz)

Learn how Block/Buzz uses ON CONFLICT DO NOTHING for event idempotency. This pattern ensures atomic, race-free deduplication by ignoring duplicate inserts and detecting first-time ingestions.

- Tags: best-practices
- Published: 2026-08-23

### [How the Connection Semaphore Limits Concurrent Connections in block/buzz](/block/buzz/connection-semaphore-concurrent-connections-block-buzz)

Discover how the block/buzz connection semaphore limits concurrent WebSocket connections. Learn how it enforces caps and rejects new requests to maintain stability.

- Tags: internals
- Published: 2026-08-23

### [Understanding Approval Gate Limitations in the Block Buzz Workflow Engine](/block/buzz/workflow-engine-approval-gate-limitations-block-buzz)

Discover approval gate limitations in the Block Buzz workflow engine. Learn why workflows fail due to unimplemented stubs and how the engine handles suspension tokens.

- Tags: deep-dive
- Published: 2026-08-23

### [How Local-Echo Deduplication Works for Redis Round-Trip Events in block/buzz](/block/buzz/local-echo-deduplication-redis-round-trip-block-buzz)

Learn how block/buzz implements local-echo deduplication for Redis round-trip events using a time-bounded HashMap in Rust to prevent duplicate processing and ensure efficient event handling.

- Tags: internals
- Published: 2026-08-23

### [How the Presence Heartbeat System Works with Redis TTL in block/buzz](/block/buzz/presence-heartbeat-redis-ttl-block-buzz)

Discover how the block/buzz presence system leverages Redis TTL with a 60-second heartbeat. Learn how it determines user status and handles disconnects efficiently.

- Tags: internals
- Published: 2026-08-23

### [Postgres FTS Privacy-Sensitive Kind Exclusions in block/buzz](/block/buzz/postgres-fts-privacy-sensitive-kind-exclusions-block-buzz)

Learn how block/buzz protects Nostr event privacy with Postgres FTS exclusions. Discover AUTHOR_ONLY_KINDS and P_GATED_KINDS to prevent sensitive data leaks.

- Tags: deep-dive
- Published: 2026-08-23

### [How Block Buzz Handles and Disconnects WebSocket Slow Clients](/block/buzz/websocket-slow-client-handling-block-buzz)

Learn how Block Buzz's WebSocketManager detects and disconnects slow clients using bounded send queues, write timeouts, and graceful shutdown to prevent resource exhaustion.

- Tags: performance
- Published: 2026-08-23

### [How Workflow Engine Template Variable Resolution Works in Block Buzz](/block/buzz/workflow-engine-template-variable-resolution-block-buzz)

Discover how the Block Buzz workflow engine resolves template variables using trigger context and step outputs. Learn about optional filters for dynamic string interpolation.

- Tags: internals
- Published: 2026-08-23

### [Security Measures That Protect Against SSRF Attacks in block/buzz](/block/buzz/ssrf-attack-prevention-block-buzz)

Learn how block/buzz uses IP validation DNS pinning and other measures to effectively prevent Server-Side Request Forgery SSRF attacks. Secure your applications today.

- Tags: best-practices
- Published: 2026-08-23

### [How the REQ Handler Enforces Channel Access Control Before Subscription Registration in block/buzz](/block/buzz/req-handler-channel-access-control-block-buzz)

Discover how the REQ handler in block/buzz enforces channel access control before subscription registration. Learn about authentication, NIP-01 filters, caching, and token restrictions.

- Tags: internals
- Published: 2026-08-23

### [How the Huddle Audio WebSocket Relay Manages Room State in Block Buzz](/block/buzz/huddle-audio-websocket-relay-room-state-block-buzz)

Discover how the huddle audio WebSocket relay in block/buzz manages room state using AudioRoomManager and AdmissionGuard for real-time audio frame broadcasting.

- Tags: internals
- Published: 2026-08-23

### [What Are Ephemeral Event Kinds in block/buzz? Processing, Ranges, and Implementation](/block/buzz/ephemeral-event-kinds-processing-block-buzz)

Discover ephemeral event kinds in block/buzz. Learn how these Redis Pub/Sub events bypass Postgres for real-time fan-out processing.

- Tags: deep-dive
- Published: 2026-08-23

### [How Block Buzz Implements Postgres FTS Integration: Generated Columns and Community-Scoped Querying](/block/buzz/postgres-fts-integration-full-text-search-block-buzz)

Discover how Block Buzz integrates Postgres FTS using generated columns and GIN indexing. Learn about community-scoped querying and secure full-text search.

- Tags: internals
- Published: 2026-08-23

### [How the ACP Agent Harness Batches Events in block/buzz](/block/buzz/acp-agent-harness-batch-events-block-buzz)

Learn how the ACP agent in block/buzz harnesses batch events, consolidating relay events into single JSON-RPC calls for improved throughput and reduced round-trips.

- Tags: internals
- Published: 2026-08-23

### [ACP Agent Harness Architecture in Block Buzz: A Deep Dive into the Nostr-First Runtime](/block/buzz/acp-agent-harness-architecture-block-buzz)

Explore the ACP agent harness architecture in block/buzz. This Nostr-first Rust runtime seamlessly connects AI agents to Buzz relays with modular components for authentication, pooling, routing, and telemetry.

- Tags: architecture
- Published: 2026-08-23

### [Block Buzz Event Pipeline: From Ingestion to Fan-Out Delivery](/block/buzz/event-pipeline-ingestion-fan-out-block-buzz)

Explore the block/buzz event pipeline, efficiently ingesting Nostr events via WebSocket or HTTP and delivering them to subscribers using Redis Pub/Sub and WebSockets.

- Tags: internals
- Published: 2026-08-23

### [How Redis Pub/Sub Fan-Out Works Across Multiple Buzz Relay Nodes](/block/buzz/redis-pub-sub-fan-out-multiple-relays-block-buzz)

Discover how Redis Pub/Sub fan-out distributes Nostr events across Buzz relay nodes. Learn about topic subscriptions and local broadcast channels for efficient WebSocket client communication.

- Tags: internals
- Published: 2026-08-23

### [How the YAML Workflow Engine Evaluates Triggers and Conditions in block/buzz](/block/buzz/yaml-workflow-engine-trigger-condition-evaluation-block-buzz)

Discover how the block/buzz YAML workflow engine evaluates triggers and conditions. Learn about Nostr event kind matching, emoji filters, and expression evaluations for authorized runs.

- Tags: deep-dive
- Published: 2026-08-23

### [How the Hash-Chain Audit Log Is Constructed and Verified in block/buzz](/block/buzz/hash-chain-audit-log-construction-verification-block-buzz)

Learn how the hash-chain audit log is constructed and verified in block/buzz. Discover its tamper-evident design using SHA-256 and deterministic serialization for distributed tenants.

- Tags: internals
- Published: 2026-08-23

### [Postgres Monthly Range Partitioning Strategy in Block Buzz: Implementation Guide](/block/buzz/postgres-monthly-range-partitioning-block-buzz)

Implement Postgres monthly range partitioning in Block Buzz. Learn how to automatically divide event data by month using native PostgreSQL and Rust for efficient lifecycle management.

- Tags: how-to-guide
- Published: 2026-08-23

### [Understanding the Three-Tier Subscription Fan-Out System in block/buzz](/block/buzz/three-tier-subscription-fan-out-block-buzz)

Discover block/buzz's three-tier subscription fan-out system for efficient local, community, and global event delivery. Optimize your real-time data flow.

- Tags: deep-dive
- Published: 2026-08-23

### [How the resolve_host Function in block/buzz Handles Multi-Community Tenants](/block/buzz/resolve-host-function-multi-community-block-buzz)

Learn how the resolve_host function in block/buzz supports multi-tenant deployments by mapping Host headers to community IDs with a fail-closed security policy.

- Tags: internals
- Published: 2026-08-23

### [Multi-Community Tenant Scoping Model in Block/Buzz](/block/buzz/multi-community-tenant-scoping-model-block-buzz)

Understand the multi-community tenant scoping model in Block/Buzz. Learn how it isolates workspaces using community_id for secure data partitioning across database, Redis, and runtime layers.

- Tags: architecture
- Published: 2026-08-23

### [How NIP-42 Authentication Works in Block Buzz: A Complete Technical Guide](/block/buzz/nip-42-authentication-flow-block-buzz)

Understand NIP-42 authentication in Block Buzz. Learn how clients prove identity with signed challenges for secure relay access. A complete technical guide.

- Tags: deep-dive
- Published: 2026-08-23

### [How Buzz Manages Authentication with NIP-42 and NIP-98 in Nostr](/block/buzz/buzz-authentication-nip-42-nip-98)

Discover how Buzz secures its relays with NIP-42 and NIP-98 authentication. Learn about kind 22242 and 27235 events for robust WebSocket and HTTP endpoint protection.

- Tags: how-to-guide
- Published: 2026-08-22

### [How Community Binding in Buzz Connections Works: Architecture Guide](/block/buzz/buzz-community-binding-connection-handling)

Discover how Buzz connections use community binding for strict tenancy isolation. Learn about UUID resolution and the CommunityConnectionRegistry for secure event scoping.

- Tags: architecture
- Published: 2026-08-22

### [How Buzz Handles the WebSocket Connection Lifecycle: A Step-by-Step Guide](/block/buzz/buzz-websocket-connection-lifecycle-sequence)

Explore the 7-stage WebSocket connection lifecycle in Buzz. Learn how Buzz handles TCP/WebSocket connections, authentication, event publishing, and graceful disconnection for robust communication.

- Tags: how-to-guide
- Published: 2026-08-22

### [Key Constants for Buzz Relay Handlers: Configuration Limits and Protocol Values](/block/buzz/buzz-relay-handlers-key-constants)

Discover key constants for Buzz relay handlers including subscription limits, event sizes, and lease durations. Optimize your relay configuration with essential protocol values.

- Tags: configuration-limits
- Published: 2026-08-22

### [What Nostr NIP-01 Wire Protocol Messages Does Buzz Support?](/block/buzz/buzz-nostr-nip-01-wire-protocol-messages)

Discover the Nostr NIP-01 wire protocol messages Buzz supports. Explore full WebSocket implementation including EVENT REQ CLOSE AUTH and their relay responses.

- Tags: api-reference
- Published: 2026-08-22

### [Where to Find Buzz Custom Kind Constants in the Block Nostr Implementation](/block/buzz/buzz-custom-kind-constants-location)

Find Buzz custom kind constants in crates/buzz-core/src/kind.rs. This file centralizes event kinds for the relay, agents, and client code in the Block Nostr implementation.

- Tags: internals
- Published: 2026-08-22

### [Buzz Custom Event Kinds: A Complete Guide to the Nostr Event Registry](/block/buzz/buzz-custom-event-kinds-descriptions)

Explore the Buzz custom event kinds and discover how this Nostr extension revolutionizes presence, automation, and notifications. Learn more about the comprehensive event registry.

- Tags: guide
- Published: 2026-08-22

### [How Nostr Kind Ranges Are Organized in Buzz: A Complete Guide](/block/buzz/buzz-nostr-kind-ranges)

Explore Nostr kind ranges in Buzz. Understand NIP-01, NIP-33, ephemeral events, and Buzz-specific protocols for efficient Nostr event management. Learn more now.

- Tags: how-to-guide
- Published: 2026-08-22

### [How the Buzz Event Kind Field Controls Dispatching and Access Control](/block/buzz/buzz-event-kind-field-dispatching)

Discover how the Buzz event kind field controls dispatching and access control in Nostr relays. Understand its role in routing and storage semantics.

- Tags: internals
- Published: 2026-08-22

### [Buzz Event Structure: How Block/Buzz Implements Nostr NIP-01 Events](/block/buzz/buzz-event-structure-nostr-nip-01)

Explore the Buzz event structure, a Nostr NIP-01 standard extended for channels, streams, profiles, and more. Understand how block/buzz implements custom event kinds.

- Tags: deep-dive
- Published: 2026-08-22

### [How Buzz Implements Tenancy in Multi-Community Mode: A Deep Dive](/block/buzz/buzz-tenancy-multi-community-mode)

Explore how Buzz implements tenancy in multi-community mode. Discover data isolation, agent runtime scoping, and state management for seamless community operation. Read the deep dive now.

- Tags: deep-dive
- Published: 2026-08-22

### [How Buzz Handles Cross-Subsystem Coordination with Redis Pub/Sub](/block/buzz/buzz-cross-subsystem-coordination)

Discover how Buzz manages cross-subsystem coordination for event fan-out, presence tracking, and more using Redis Pub/Sub. Learn about its PubSubManager for efficient message brokering.

- Tags: how-to-guide
- Published: 2026-08-22

### [The Buzz Relay Architectural Principle: Why the Relay Is the Workspace](/block/buzz/buzz-architectural-principle-relay)

Discover Buzz's core architectural principle: the relay is the workspace. Learn how signed Nostr-style events centralize all activity, making the relay the immutable source of truth.

- Tags: architecture
- Published: 2026-08-22

### [Agent-Facing Crates in Buzz: Architecture, Functions, and Usage](/block/buzz/buzz-agent-facing-crates-functions)

Explore Buzz's six agent-facing crates: buzz-cli, buzz-agent, buzz-acp, buzz-dev-mcp, buzz-persona, and buzz-workflow. Learn how they connect AI agents to Nostr relays, manage multi-step workflows, and aid interactive development.

- Tags: architecture
- Published: 2026-08-22

### [How Buzz Relay Crates Are Structured: Core Architecture and Responsibilities](/block/buzz/buzz-relay-crates-structure-responsibilities)

Explore the Buzz relay crates structure, from the core buzz-relay crate for WebSocket/HTTP to the buzz-pair-relay for device pairing. Understand internal modules for event ingestion and push delivery.

- Tags: architecture
- Published: 2026-08-22

### [What Is the buzz-core Crate? Foundation of the Buzz Nostr Relay](/block/buzz/buzz-core-crate-purpose)

Discover the buzz-core crate, the zero-I/O Rust foundation for the Buzz Nostr relay. It provides essential types for events, crypto verification, and filters.

- Tags: internals
- Published: 2026-08-22

### [Understanding the Crate Dependency Hierarchy in Buzz: Full Rust Workspace Guide](/block/buzz/buzz-crate-dependency-hierarchy)

Explore the crate dependency hierarchy in Buzz, a Rust workspace. Learn how buzz-core, infra crates, buzz-relay, and binaries form the stack.

- Tags: deep-dive
- Published: 2026-08-22

### [Backing Infrastructure Buzz Requires: PostgreSQL, Redis, MinIO, and More](/block/buzz/buzz-backing-infrastructure-requirements)

Discover the essential backing infrastructure for the block/buzz Nostr platform including PostgreSQL, Redis, and MinIO. Learn about its Docker Compose and Helm deployments.

- Tags: architecture
- Published: 2026-08-22

### [What Is the Axum-Based Relay Server in Buzz? Architecture and Implementation Guide](/block/buzz/buzz-relay-server-role)

Discover the Axum-based relay server in Buzz, the unified networking core for real-time Nostr events via WebSockets and HTTP bridges for agents. Learn its architecture and implementation.

- Tags: architecture
- Published: 2026-08-22

### [How Buzz Clients Interact with the Relay: WebSocket and Nostr Protocol Guide](/block/buzz/buzz-client-relay-interaction)

Learn how Buzz clients connect to relays using WebSockets and the Nostr protocol. Discover NIP-42 authentication and NIP-29 event handling with the buzz-ws-client crate.

- Tags: how-to-guide
- Published: 2026-08-22

### [Core Components of the Buzz Architecture: A Deep Dive into the Nostr-Based Platform](/block/buzz/buzz-architecture-core-components)

Explore the core components of the Buzz architecture, a modular Rust monorepo. Discover its Nostr-first event protocol, WebSocket relays, and AI agent surfaces within dedicated crates.

- Tags: deep-dive
- Published: 2026-08-22

### [How Buzz Uses the Nostr Protocol: Relay, SDK, and Authentication Explained](/block/buzz/how-buzz-uses-nostr-protocol)

Discover how Buzz leverages the Nostr protocol for its full-stack application. Learn about its relay, SDK, and authentication methods using NIP standards.

- Tags: deep-dive
- Published: 2026-08-22

### [Buzz Architecture Overview: A Deep Dive into the Nostr-Based Team Communication Platform](/block/buzz/buzz-architecture-overview)

Explore the Buzz architecture, a Nostr-based team communication platform. Discover its Rust relay, modular design, and event processing pipeline for secure, self-hosted messaging.

- Tags: architecture
- Published: 2026-08-22

### [How to Set Up a Buzz Self-Hosted Workspace: Complete Step-by-Step Guide](/block/buzz/how-to-set-up-buzz-self-hosted-workspace)

Set up your Buzz self-hosted workspace quickly. Follow our step-by-step guide to clone the repository, configure Docker, and launch your collaborative environment in minutes. Get started today.

- Tags: how-to-guide
- Published: 2026-08-22

### [How Buzz Detects Slow Clients and Performs Graceful Disconnects](/block/buzz/slow-client-detection-and-graceful-disconnect)

Learn how Buzz detects slow clients and gracefully disconnects using buffer pressure and heartbeat monitoring. Discover its coordinated shutdown with CancellationToken for clean WebSocket closures.

- Tags: internals
- Published: 2026-08-21

### [How Buzz Materializes the Thread Reply Counter: PostgreSQL and Rust Implementation](/block/buzz/thread-reply-counter-materialization)

Discover how Buzz materializes the thread reply counter using PostgreSQL and Rust. Learn about transactional updates to the thread_metadata view for real-time accuracy.

- Tags: internals
- Published: 2026-08-21

### [Rate Limiting Design Targets vs Current Implementation in Buzz: A Complete Technical Breakdown](/block/buzz/rate-limiting-design-targets-vs-current-implementation)

Explore Buzz's rate limiting design targets versus its current implementation. Understand why production limits are missing despite strict policies.

- Tags: deep-dive
- Published: 2026-08-21

### [Buzz SSRF Protection and Input Validation: Inside the block/buzz Security Model](/block/buzz/security-model-ssrf-protection-and-input-validation)

Discover Buzz's SSRF protection and input validation. Learn how Buzz secures your application with IP resolution, private IP filtering, and strict URL parsing.

- Tags: internals
- Published: 2026-08-21

### [How Workflow Approval Gates and Suspended Execution Work in Buzz](/block/buzz/workflow-approval-gates-and-suspended-execution)

Learn how Buzz workflow approval gates suspend execution and persist decisions in the workflow_approvals table until authorized users approve or deny via Tauri commands.

- Tags: internals
- Published: 2026-08-21

### [ACP Agent Harness Architecture and Message Queuing in Buzz](/block/buzz/acp-agent-harness-architecture-and-message-queuing)

Explore the ACP Agent Harness architecture and message queuing in block/buzz. Discover how EventQueue, AgentPool, and Relay Bridge manage Nostr events, ensure sequential processing, and route responses with retries and deduplic...

- Tags: architecture
- Published: 2026-08-21

### [How Git Smart HTTP Backend Is Integrated with Buzz: Architecture Deep Dive](/block/buzz/git-smart-http-backend-integration)

Explore how Buzz integrates the Git Smart HTTP backend using S3-compatible object storage and atomic CAS operations for efficient repository management.

- Tags: architecture
- Published: 2026-08-21

### [How the Blossom Media Upload and Storage Pipeline Works in Buzz](/block/buzz/blossom-media-upload-and-storage-pipeline)

Discover how the Blossom media pipeline in Buzz handles uploads securely, stores content-addressably in S3, and serves files via tenant-scoped URLs. Learn about the authentication and storage process.

- Tags: internals
- Published: 2026-08-21

### [How Buzz Implements the Huddle Audio WebSocket Opus Relay: Real-Time Voice Architecture Explained](/block/buzz/huddle-audio-websocket-opus-relay-implementation)

Explore Buzz's Huddle audio WebSocket Opus relay implementation. Discover real-time voice architecture with low-latency Opus encoding, binary framing, and NetEq jitter buffer.

- Tags: architecture
- Published: 2026-08-21

### [How Buzz Achieves Community Multi-Tenancy Isolation in Shared Infrastructure](/block/buzz/community-multi-tenancy-isolation-in-shared-infrastructure)

Discover how Buzz ensures community multi-tenancy isolation in shared infrastructure by treating community IDs as first-class tenant keys across the entire stack.

- Tags: architecture
- Published: 2026-08-21

### [NIP-98 HTTP Authentication for REST Endpoints in Buzz: Secure Single-Key API Access](/block/buzz/nip-98-http-authentication-for-rest-endpoints)

Explore NIP-98 HTTP authentication in Buzz for secure REST endpoint access. Learn how Buzz uses signed Nostr events for API authentication, enhancing security and eliminating API keys.

- Tags: deep-dive
- Published: 2026-08-21

### [How Buzz Verifies Audit Log Hash-Chain Integrity: A Deep Dive into the Verification Algorithm](/block/buzz/audit-log-hash-chain-integrity-verification)

Buzz verifies audit log hash-chain integrity by recomputing SHA-256 hashes and validating prev_hash links. Discover how Buzz detects tampering and sequence breaks in this deep dive.

- Tags: deep-dive
- Published: 2026-08-21

### [How Buzz Implements Presence Tracking Using Redis SET EX](/block/buzz/presence-tracking-with-redis-set-ex)

Discover how Buzz implements presence tracking with Redis SET EX. Learn to efficiently manage user status and expirations for real-time applications.

- Tags: deep-dive
- Published: 2026-08-21

### [WebSocket Connection Lifecycle and Heartbeat Protocol in Buzz](/block/buzz/websocket-connection-lifecycle-and-heartbeat-protocol)

Explore the Buzz WebSocket connection lifecycle: slot acquisition, NIP-42 auth, and three loops. Learn how heartbeat protocol ensures stability by terminating missed PONG responses after 3 intervals.

- Tags: deep-dive
- Published: 2026-08-21

### [How to Register Custom Event Kinds (40000-49999 Range) in Buzz](/block/buzz/custom-event-kind-registration-40000-49999-range)

Learn to register custom event kinds in Buzz's 40000-49999 range. Follow our guide to declare, append, and wire your event handlers for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-21

### [How Channel Membership and Access Control Are Enforced in Buzz](/block/buzz/channel-membership-and-access-control-enforcement)

Discover how Buzz enforces channel membership and access control using visibility rules, channel types, and a robust MemberRole system with numeric permission levels for secure operations.

- Tags: internals
- Published: 2026-08-21

### [How the Event Pipeline Processes Incoming Events in Buzz](/block/buzz/how-event-pipeline-processes-incoming-events)

Learn how the Buzz event pipeline processes Nostr events via WebSockets, from authentication and validation to real-time or persistent data handling.

- Tags: internals
- Published: 2026-08-21

### [How to Build YAML Workflows with Trigger Conditions in Buzz](/block/buzz/building-yaml-workflows-with-trigger-conditions)

Learn how to build YAML workflows with trigger conditions in Buzz. Discover how Buzz parses YAML, validates definitions, and executes workflows using Nostr events and evalexpr.

- Tags: how-to-guide
- Published: 2026-08-21

### [Redis Pub/Sub Architecture for Deploying Buzz Relays Across Multiple Nodes](/block/buzz/redis-pub-sub-architecture-for-multi-node-relay-deployment)

Explore the Redis Pub/Sub architecture for Buzz relays. Learn how it enables horizontal scalability and instant event synchronization across multiple nodes for your block/buzz repository.

- Tags: architecture
- Published: 2026-08-21

### [How Buzz Uses Postgres for Full-Text Search Indexing of Events](/block/buzz/how-postgres-full-text-search-indexes-events)

Discover how Buzz employs Postgres TSVECTOR and TSQUERY with GIN indexes for efficient, community-scoped full-text search of Nostr events.

- Tags: deep-dive
- Published: 2026-08-21

### [How the Three-Tier Subscription Fan-Out System Works in Buzz](/block/buzz/understanding-three-tier-subscription-fan-out-system)

Explore the Buzz three-tier subscription fan-out system architecture. Learn how it scales real-time events using Redis Pub/Sub and Postgres for efficient data delivery and access control.

- Tags: architecture
- Published: 2026-08-21

### [How NIP-42 Schnorr Authentication Works in the Buzz Relay](/block/buzz/how-nip-42-schnorr-authentication-works-in-buzz)

Explore NIP-42 Schnorr authentication in Buzz Relay. Learn how clients sign events and relays verify signatures in memory for secure, private interactions without data persistence.

- Tags: deep-dive
- Published: 2026-08-21

### [How buzz-db Handles Idempotent Event Deduplication and TOCTOU-Safe Role Enforcement](/block/buzz/buzz-db-idempotent-dedup-role-enforcement)

Learn how buzz-db ensures idempotent event deduplication using PostgreSQL unique constraints and achieves TOCTOU-safe role enforcement with single-transaction database operations and row-level locks.

- Tags: internals
- Published: 2026-08-20

### [How Ephemeral Events Bypass DB Storage and Audit Logging in Buzz: A Deep Dive](/block/buzz/buzz-ephemeral-events-bypass-db-audit)

Discover how ephemeral events in Buzz bypass DB storage and audit logging using a three-layer classification system. Learn how events short-circuit persistence before writes occur.

- Tags: deep-dive
- Published: 2026-08-20

### [How Buzz Guarantees Single-Writer Exclusivity for the Audit Log Even During Panics](/block/buzz/buzz-audit-log-single-writer-exclusivity)

Discover how Buzz ensures single-writer exclusivity for its audit log, even during panics, using async workers, PostgreSQL locks, and robust shutdown.

- Tags: internals
- Published: 2026-08-20

### [How the Buzz ACP Pool Manages Agent Subprocesses for @mention Events](/block/buzz/buzz-acp-pool-agent-management)

Discover how the Buzz ACP pool efficiently manages agent subprocesses for @mention events using lazy creation, event queuing, and control signals. Learn about this block/buzz repository feature.

- Tags: internals
- Published: 2026-08-20

### [Monthly Range Partitioning in Buzz: How the partition.rs Module Manages PostgreSQL Partitions](/block/buzz/buzz-partition-rs-monthly-range-partitioning)

Learn how Buzz's partition.rs module creates monthly PostgreSQL partitions for time-series data. Optimize query performance and manage table growth effectively.

- Tags: deep-dive
- Published: 2026-08-20

### [WebSocket Connection Lifecycle in Buzz: A Complete Technical Guide](/block/buzz/buzz-websocket-connection-lifecycle)

Explore the WebSocket connection lifecycle in Buzz. Learn about NIP-42 authentication, timeout error handling, and typed message parsing for Nostr relays.

- Tags: deep-dive
- Published: 2026-08-20

### [Channel Types and Member Roles in Buzz: Access Control Explained](/block/buzz/buzz-channel-types-member-roles-access-control)

Understand Buzz channel types and member roles for robust access control. Learn how Buzz uses a two-attribute channel model and hierarchical member roles with numeric permissions to manage access effectively.

- Tags: deep-dive
- Published: 2026-08-20

### [How the buzz-acp Agent Harness Bridges Buzz WebSocket Events to ACP/JSON-RPC](/block/buzz/buzz-acp-agent-harness-integration)

Discover how the buzz-acp agent harness bridges Buzz WebSocket events to ACP/JSON-RPC. Learn about HarnessRelay and AcpClient for seamless AI agent communication. Explore block/buzz.

- Tags: internals
- Published: 2026-08-20

### [How Postgres Full-Text Search Functions in Buzz: Rust Implementation Explained](/block/buzz/postgres-full-text-search-buzz)

Discover how Buzz implements Postgres full-text search with a generated tsvector column and GIN index for real-time search without background jobs. Learn the Rust implementation.

- Tags: deep-dive
- Published: 2026-08-20

### [Redis Pub/Sub Event Fan-Out Architecture in Buzz: How Block Scales Real-Time Nostr Events](/block/buzz/redis-pubsub-architecture-buzz-event-fan-out)

Discover how Buzz leverages Redis Pub/Sub for efficient Nostr event fan-out. Learn about its architecture for horizontal scaling with sharded topics and async workers.

- Tags: architecture
- Published: 2026-08-20

### [How the Three-Tier SubscriptionRegistry Fan-Out System Works in Buzz](/block/buzz/subscriptionregistry-fan-out-system-buzz)

Discover how Buzz's three-tier SubscriptionRegistry fan-out system enables scalable real-time event delivery using in-process registries Redis pub/sub and persistent store queries.

- Tags: internals
- Published: 2026-08-20

### [How Buzz Processes Incoming Nostr Events: A 10-Stage Pipeline Breakdown](/block/buzz/how-buzz-event-pipeline-processes-nostr-events)

Explore the 10-stage Buzz event pipeline processing incoming Nostr events. Learn how Buzz validates, authenticates, persists, and fans out events to subscribers.

- Tags: internals
- Published: 2026-08-20

### [Thread Counter Implementation in Buzz: How Reply and Descendant Tracking Works](/block/buzz/buzz-thread-counter-reply-descendant-tracking)

Learn how Buzz implements thread counters for reply and descendant tracking using atomic PostgreSQL transactions. Discover efficient update mechanisms for thread metadata.

- Tags: internals
- Published: 2026-08-08

### [How Channels, Threads, and DMs Are Modeled in Buzz: NIP-29 Data Structures Explained](/block/buzz/buzz-data-model-channels-threads-dms)

Understand Buzz's data structures for channels, threads, and DMs. Learn how NIP-29 group primitives model these essential communication features, with ChannelRecord as the container.

- Tags: deep-dive
- Published: 2026-08-08

### [How to Debug WebSocket Connection Issues with Buzz: A Complete Guide](/block/buzz/debug-websocket-connection-issues-buzz)

Debug WebSocket connection issues with Buzz. Inspect TCP handshake, WsClientError, NIP-42 authentication, and client timeout settings for effective troubleshooting.

- Tags: how-to-guide
- Published: 2026-08-08

### [Postgres FTS Search Indexing in Buzz: Native PostgreSQL Architecture](/block/buzz/buzz-postgres-fts-search-indexing-architecture)

Discover Buzz's native Postgres FTS search indexing architecture. It uses a TSVECTOR column and GIN index in the events table for efficient, community-scoped search without external services.

- Tags: architecture
- Published: 2026-08-08

### [NIP-29 Group Chat Implementation in Buzz Channels: A Technical Deep Dive](/block/buzz/nip-29-group-chat-buzz-channels)

Explore the technical NIP-29 group chat implementation in Buzz channels. Discover how Buzz utilizes the 'h' tag for universal group identification across event kinds 39000-39003 and kind 9.

- Tags: deep-dive
- Published: 2026-08-08

### [How Git Smart HTTP Hosting Is Integrated with Buzz: Object-Storage Architecture Explained](/block/buzz/buzz-git-smart-http-hosting-integration)

Discover how Buzz integrates Git Smart HTTP hosting using S3-compatible object storage and atomic CAS operations for efficient, lock-free concurrent repository writes.

- Tags: architecture
- Published: 2026-08-08

### [Architecture and State Management of the Buzz Mobile Flutter App: Riverpod, Hooks, and Feature-Scoped State](/block/buzz/buzz-mobile-flutter-app-architecture-state-management)

Explore the Buzz mobile Flutter app's architecture. Learn how Riverpod, Hooks, and feature-scoped state create a reactive UI driven by providers.

- Tags: architecture
- Published: 2026-08-08

### [How Community Switching and Module-Level Singleton Reset Works in the Buzz Desktop App](/block/buzz/buzz-desktop-app-community-switching-singleton-reset)

Discover how Buzz desktop app clears in-memory state between Nostr communities using dynamic React keys and explicit resets for singletons like WebSockets and caches.

- Tags: internals
- Published: 2026-08-08

### [How Buzz Implements SSRF Protection in Workflow Webhooks: A Code‑Level Analysis](/block/buzz/buzz-workflow-webhooks-ssrf-protection)

Discover how Buzz implements SSRF protection in workflow webhooks. Learn about IP validation, connection pinning, and disabled redirects for enhanced security.

- Tags: deep-dive
- Published: 2026-08-08

### [Production Deployment Configuration for the Buzz Relay: A Complete Guide](/block/buzz/buzz-relay-production-deployment-config)

Deploy the Buzz relay to production with this complete guide. Learn how to configure the Helm chart for Kubernetes, integrating PostgreSQL, Redis, MinIO, and autoscaling.

- Tags: how-to-guide
- Published: 2026-08-08

### [How Buzz Handles Presence and Typing Indicators with Redis](/block/buzz/buzz-presence-typing-indicators-redis)

Learn how Buzz uses Redis SET keys and Pub/Sub for real-time presence and typing indicators, ensuring low-latency status updates.

- Tags: how-to-guide
- Published: 2026-08-08

### [How Media Upload Works Using the Blossom Protocol in Buzz](/block/buzz/buzz-media-upload-blossom-protocol)

Learn how Buzz uses the Blossom protocol for secure media uploads. Discover SHA-256 hash validation Nostr tokens S3 storage and dual-pipeline architecture for efficient file handling.

- Tags: how-to-guide
- Published: 2026-08-08

### [Audit Log Hash-Chain Implementation for Tamper-Evidence in Buzz](/block/buzz/buzz-audit-log-hash-chain-tamper-evidence)

Discover Buzz's audit log hash-chain implementation for tamper-evidence. Detect unauthorized modifications immediately using SHA-256 hashing of canonical JSON and normalized timestamps.

- Tags: internals
- Published: 2026-08-08

### [How to Run E2E Tests Against a Local Buzz Relay: Complete Setup Guide](/block/buzz/run-e2e-tests-local-buzz-relay)

Learn to run E2E tests against a local Buzz relay. This guide covers building binaries, starting the relay, and executing tests with clear setup instructions.

- Tags: how-to-guide
- Published: 2026-08-08

### [buzz-cli vs buzz-test-client: Understanding the Two Client Binaries in Buzz](/block/buzz/buzz-cli-vs-buzz-test-client)

Discover the key differences between buzz-cli and buzz-test-client. Understand their distinct roles in Buzz for agent interaction and system validation.

- Tags: deep-dive
- Published: 2026-08-08

### [How the ACP Harness Bridges Buzz Events to AI Agents: Architecture and Implementation](/block/buzz/acp-harness-buzz-events-ai-agents)

Discover how the ACP harness bridges Buzz events to AI agents by converting Nostr events into JSON-RPC prompts. Learn about its architecture and implementation for efficient AI integration.

- Tags: architecture
- Published: 2026-08-08

### [How to Create Custom Workflow Actions in buzz-workflow](/block/buzz/create-custom-workflow-actions-buzz-workflow)

Learn to create custom workflow actions in buzz-workflow by modifying schema.rs, executor.rs, and action_sink.rs. Extend buzz-workflow functionality with this technical guide.

- Tags: how-to-guide
- Published: 2026-08-08

### [How Buzz Implements Multi-Tenant and Community Isolation](/block/buzz/buzz-multi-tenant-community-isolation)

Discover how Buzz implements bulletproof multi-tenant isolation by using the community identifier as a mandatory tenant key across all layers, ensuring strict data boundaries.

- Tags: internals
- Published: 2026-08-08

### [Redis Pub/Sub Architecture for Real-Time Fan-Out in Buzz](/block/buzz/redis-pub-sub-fan-out-architecture-buzz)

Explore the Redis Pub/Sub architecture for real-time fan-out in Buzz. Learn how Buzz uses Redis for efficient Nostr event distribution across relay pods and WebSocket delivery.

- Tags: architecture
- Published: 2026-08-08

### [How NIP-42 Authentication Works in the Buzz Relay](/block/buzz/nip-42-authentication-buzz)

Discover how NIP-42 authentication works in Buzz. Learn about the challenge-response protocol, client signing, and relay verification for secure connections.

- Tags: deep-dive
- Published: 2026-08-08

### [How to Add a New Event Kind to the Buzz Relay: A 10-Step Implementation Guide](/block/buzz/add-new-event-kind-buzz-relay)

Learn to add a new event kind to the Buzz relay with this 10 step guide. Implement handlers, register kinds, and validate changes to enhance your system.

- Tags: how-to-guide
- Published: 2026-08-08

### [How Buzz Handles Channel-Scoped vs Global Subscriptions](/block/buzz/buzz-subscription-handling-channel-global)

Learn how Buzz manages channel-scoped and global subscriptions with separate index structures, preventing event leakage via the fan_out_scoped method.

- Tags: internals
- Published: 2026-08-08

### [Ephemeral vs Regular Stored Events in Buzz: Understanding Nostr Kind Ranges 20000–29999](/block/buzz/ephemeral-vs-stored-events-buzz)

Learn the difference between ephemeral (20000-29999) and regular stored events in Buzz Nostr. Understand how each is handled for efficient data management and retrieval.

- Tags: deep-dive
- Published: 2026-08-08

### [How Buzz-Relay Processes Incoming Nostr Events: The 10-Stage Event Pipeline](/block/buzz/how-buzz-relay-processes-nostr-events)

Discover how Buzz-Relay processes incoming Nostr events through its 10-stage pipeline. Learn about signature validation, authorization, persistence, and fan-out.

- Tags: internals
- Published: 2026-08-08

### [Roadmap for Future Development of Block/Buzz: Vision Documents and Strategic Pillars](/block/buzz/block-buzz-future-development-roadmap)

Explore the Block/Buzz development roadmap detailing sovereign communities, AI agents, and more. Discover our Nostr-first approach and modular Rust architecture.

- Tags: roadmap
- Published: 2026-08-07

### [How Block/Buzz Handles Background Jobs: Tokio Task Patterns and Architecture](/block/buzz/block-buzz-background-jobs-handling)

Discover how Block/Buzz manages background jobs using Tokio task patterns. Learn about its architecture for handling WebSocket relays, cron schedules, and maintenance sweeps efficiently.

- Tags: architecture
- Published: 2026-08-07

### [Best Practices for Developing with Block/Buzz: A Complete Guide for Contributors](/block/buzz/block-buzz-development-best-practices)

Master block/buzz development with this guide. Learn best practices for contributors: Hermit toolchain, DCO commits, avoiding unsafe blocks, and running CI locally for smoother contributions.

- Tags: best-practices
- Published: 2026-08-07

### [How the block/buzz Repository is Structured: A Rust Monorepo Deep Dive](/block/buzz/block-buzz-code-structure)

Explore the crate-centric Rust monorepo structure of the block/buzz repository. Discover how independent service crates are orchestrated by a central relay crate for WebSocket and HTTP APIs.

- Tags: deep-dive
- Published: 2026-08-07

### [Block/Buzz Use Cases: Real-Time Collaboration, AI Agents, and Decentralized Version Control](/block/buzz/block-buzz-common-use-cases)

Explore block/buzz use cases: real-time collaboration, AI agents, and decentralized Git. Discover how Nostr-first platform enhances team messaging and workflows.

- Tags: use-cases
- Published: 2026-08-07

### [How to Deploy Block Buzz: Docker Compose and Kubernetes Guide](/block/buzz/deploy-block-buzz)

Deploy Block Buzz easily with Docker Compose for single-node setups or Kubernetes via Helm. Get started with PostgreSQL, Redis, and S3 storage today.

- Tags: how-to-guide
- Published: 2026-08-07

### [Performance Considerations for block/buzz: Rate Limiting, Caching, and Async Optimization](/block/buzz/block-buzz-performance-considerations)

Explore block/buzz performance: Discover how Redis rate limiting, async optimization, and caching boost throughput. Learn best practices for your high-performance applications.

- Tags: performance
- Published: 2026-08-07

### [How Block/Buzz Handles Concurrency: Async Rust Architecture Explained](/block/buzz/block-buzz-concurrency-handling)

Discover how block/buzz handles concurrency using Tokio, semaphores, Redis rate limiters, and atomic flags for scalable Nostr relay and agent systems. Learn about its async Rust architecture.

- Tags: deep-dive
- Published: 2026-08-07

### [Release Strategy for Block Buzz: Desktop, Relay, and Mobile Workflows](/block/buzz/block-buzz-release-strategy)

Explore the Block Buzz release strategy for Desktop, Relay, and Mobile. Learn about independent release lanes, deterministic versioning, and automated artifact publishing.

- Tags: release-strategy
- Published: 2026-08-07

### [How to Integrate Block Buzz with Other Systems: WebSocket, HTTP, and SDK Methods](/block/buzz/integrate-block-buzz-with-other-systems)

Integrate Block Buzz with other systems using WebSocket, HTTP, or the Rust SDK. Seamlessly connect external services, automation scripts, and AI agents to Nostr functionality.

- Tags: how-to-guide
- Published: 2026-08-07

### [block/buzz API Reference: Complete Guide to WebSocket and HTTP Endpoints](/block/buzz/block-buzz-exposed-apis)

Explore the block/buzz API Reference. Discover NIP-29 WebSocket and NIP-98 HTTP endpoints for Nostr events, publishing, querying, and more. A complete guide to block/buzz APIs.

- Tags: api-reference
- Published: 2026-08-07

### [How Block/Buzz Handles Security: Nostr-Based Authentication and Zero-Trust Architecture](/block/buzz/block-buzz-security-handling)

Discover how Block/Buzz secures its platform with Nostr authentication and a zero-trust architecture. Learn about NIP-42, NIP-98, Schnorr signatures, and replay protection for robust API and relay security.

- Tags: deep-dive
- Published: 2026-08-07

### [Contribution Guide for block/buzz: Setup, Standards, and Workflow](/block/buzz/block-buzz-contribution-guide)

Contribute to block/buzz with our guide. Learn DCO signing, Conventional Commits, and local CI setup using just ci for Rust components. Improve code quality today.

- Tags: contribution-guide
- Published: 2026-08-07

### [How Configuration Settings Are Managed in block/buzz: Environment Variables, Compile-Time Defaults, and CLI Precedence](/block/buzz/block-buzz-configuration-management)

Discover how block/buzz manages configuration with environment variables, compile-time defaults, and CLI flags. Understand precedence rules for seamless setup.

- Tags: how-to-guide
- Published: 2026-08-07

### [Dependencies for Building block/buzz: A Complete Setup Guide](/block/buzz/block-buzz-build-dependencies)

Discover the essential dependencies for building block/buzz including Rust, Node.js, Hermit, PostgreSQL, and Redis. Get your development environment set up quickly.

- Tags: how-to-guide
- Published: 2026-08-07

### [How to Set Up a Development Environment for block/buzz: Complete Setup Guide](/block/buzz/block-buzz-development-environment-setup)

Set up your block/buzz development environment quickly. Clone the repo, activate Hermit, run just setup, and launch with just dev to start building on Nostr and Tauri.

- Tags: getting-started
- Published: 2026-08-07

### [Main Features Offered by block/buzz: A Self-Hostable Nostr Collaboration Platform](/block/buzz/block-buzz-main-features)

Discover block/buzz, the self-hostable Nostr collaboration platform. Unify human and AI agent workflows with desktop, mobile, and CLI interfaces. Learn more today.

- Tags: getting-started
- Published: 2026-08-07

### [How Block/Buzz Handles Data Storage: Multi-Tenant PostgreSQL with S3 and Redis](/block/buzz/block-buzz-data-storage)

Discover how Block/Buzz handles data storage using multi-tenant PostgreSQL, S3 object storage for media, and Redis for real-time messaging. Learn about its robust architecture.

- Tags: architecture
- Published: 2026-08-07

### [What Programming Languages Are Used in Block/Buzz?](/block/buzz/block-buzz-programming-languages)

Discover the programming languages behind Block/Buzz. Explore Rust for backend, TypeScript for interfaces, Dart for mobile, and Shell for automation in this polyglot project.

- Tags: getting-started
- Published: 2026-08-07

### [How the Architecture of block/buzz Is Documented: A Complete Guide](/block/buzz/block-buzz-architecture-documentation)

Discover how block/buzz architecture is documented in ARChITECTURE.md. Understand Rust workspace structure, component interactions, and event-first design for your next project.

- Tags: architecture
- Published: 2026-08-07

### [How to Perform Code Reviews for Block Buzz Contributions](/block/buzz/how-to-perform-code-reviews-block-buzz-contributions)

Learn how to perform code reviews for Block Buzz contributions. Ensure architectural correctness, safety, and documentation with our guide.

- Tags: how-to-guide
- Published: 2026-08-06

### [Block Buzz Development Tools: Complete Setup Guide for the Multi-Language Workspace](/block/buzz/recommended-tools-block-buzz-development)

Master Block Buzz development with our setup guide. Learn to configure Rust, Node, pnpm, Just, and Docker Compose for a seamless multi-language workspace.

- Tags: getting-started
- Published: 2026-08-06

### [How to Get Support for Block Buzz Development: Official Channels and Resources](/block/buzz/how-to-get-support-block-buzz-development)

Need support for Block Buzz development? Explore official channels from documentation and Discord to GitHub issues. Find the right resources for your needs.

- Tags: how-to-guide
- Published: 2026-08-06

### [Block Buzz Architectural Decisions: Inside the Nostr-First Communication Platform](/block/buzz/architectural-decisions-block-buzz)

Discover the Nostr-first architectural decisions powering Block Buzz. Learn how this relay-centric platform ensures secure, modular, and auditable communication via signed Nostr events.

- Tags: architecture
- Published: 2026-08-06

### [How to Update Block Buzz to the Latest Version: Desktop, Mobile, CLI, and Relay Guide](/block/buzz/how-to-update-block-buzz-latest-version)

Learn how to update Block Buzz to the latest version across desktop mobile CLI and relay. Follow our easy guide for seamless upgrades.

- Tags: how-to-guide
- Published: 2026-08-06

### [Common Block Buzz Error Messages and How to Fix Them](/block/buzz/common-error-messages-block-buzz-fixes)

Troubleshoot common Block Buzz errors. Learn to fix React context, Nostr protocol, and keychain issues with practical solutions.

- Tags: how-to-guide
- Published: 2026-08-06

### [How to Access the Block Buzz API: WebSocket and HTTP Bridge Methods](/block/buzz/how-to-access-block-buzz-api)

Learn how to access the Block Buzz API using WebSocket and HTTP bridge methods. Explore NIP-29 and NIP-98 for seamless integration with Nostr.

- Tags: api-reference
- Published: 2026-08-06

### [Block Buzz License: Understanding the Apache 2.0 Terms](/block/buzz/licensing-information-block-buzz)

Understand Apache 2.0 terms for Block Buzz license. Use, modify, and distribute freely while retaining notice and attribution. Get the details now.

- Tags: license
- Published: 2026-08-06

### [How to Manage Dependencies in Block Buzz: A Complete Polyglot Workspace Guide](/block/buzz/how-to-manage-dependencies-block-buzz)

Master dependency management in Block Buzz with this polyglot workspace guide. Learn how to orchestrate Rust, JS/TS, and Dart dependencies for deterministic builds.

- Tags: how-to-guide
- Published: 2026-08-06

### [Security Best Practices for Developing with Block Buzz: Authentication, Authorization, and Audit Logging](/block/buzz/security-best-practices-developing-block-buzz)

Learn Block Buzz security best practices: NIP-42 auth, NIP-98 signed events, channel auth, and audit logging for secure Nostr relays. Protect your self-hosted relay now.

- Tags: best-practices
- Published: 2026-08-06

### [How to Deploy Block Buzz to Production: Docker Compose and Kubernetes Guide](/block/buzz/how-to-deploy-block-buzz-to-production)

Deploy Block Buzz to production with Docker Compose or Kubernetes. Learn how to set up your PostgreSQL, Redis, and S3 storage for a seamless launch.

- Tags: how-to-guide
- Published: 2026-08-06

### [Performance Considerations for Block Buzz Developers: Optimizing Nostr Relay Throughput](/block/buzz/performance-considerations-block-buzz-developers)

Block Buzz developers optimize Nostr relay throughput by scoping Redis Pub/Sub, filtering event kinds, and avoiding media buffering for sub-millisecond latency.

- Tags: performance
- Published: 2026-08-06

### [How to Integrate Block Buzz with Other Systems: A Complete Guide to Nostr Protocol Connectivity](/block/buzz/how-to-integrate-block-buzz-with-other-systems)

Integrate Block Buzz with other systems using WebSocket relay, HTTP API, Rust SDK, or CLI. Seamlessly publish and consume Nostr events with this comprehensive guide.

- Tags: how-to-guide
- Published: 2026-08-06

### [What Programming Languages Are Used in Block Buzz? A Complete Technical Stack Analysis](/block/buzz/programming-languages-used-block-buzz)

Discover the programming languages powering Block Buzz: Rust for backend, TypeScript for UIs, Dart for mobile, and Shell for automation. Learn about its polyglot architecture.

- Tags: technical-stack-analysis
- Published: 2026-08-06

### [How to Set Up a CI/CD Pipeline for Block Buzz: GitHub Actions, Rust & Flutter Guide](/block/buzz/how-to-set-up-ci-cd-pipeline-block-buzz)

Set up a CI/CD pipeline for Block Buzz. Learn how to use GitHub Actions with Rust and Flutter to automate linting, testing, and builds for your project.

- Tags: how-to-guide
- Published: 2026-08-06

### [Main Modules and Components of Block Buzz: A Complete Architecture Guide](/block/buzz/main-modules-components-block-buzz)

Explore the main modules and components of Block Buzz, a Rust monorepo. Discover its architecture from buzz-core to buzz-relay for a Nostr-based team communication platform.

- Tags: architecture
- Published: 2026-08-06

### [How to Debug Issues in Block Buzz: A Complete Troubleshooting Guide](/block/buzz/how-to-debug-issues-block-buzz)

Debug Block Buzz issues effectively. Capture verbose logs using RUST_LOG and trace failures through event pipelines, database writes, and pub/sub layers with built-in metrics. Your complete troubleshooting guide.

- Tags: how-to-guide
- Published: 2026-08-06

### [Understanding the Project Structure of Block Buzz: A Rust Workspace Deep Dive](/block/buzz/project-structure-block-buzz)

Explore the Rust workspace project structure of Block Buzz. Discover how its crates and multi-platform clients organize the codebase for efficient development.

- Tags: deep-dive
- Published: 2026-08-06

### [How to Build the Block Buzz Project from Source: A Complete Guide](/block/buzz/how-to-build-block-buzz-from-source)

Build the Block Buzz project from source with this step-by-step guide. Learn to clone the repo, set up dependencies, compile Rust code, and launch the stack.

- Tags: how-to-guide
- Published: 2026-08-06

### [Block Buzz Code Style Guide: Automated Rust Standards and Safety Policies](/block/buzz/code-style-guide-block-buzz)

Discover the Block Buzz code style guide, featuring automated Rust standards with rustfmt and Clippy, ensuring robust error handling and logging, all enforced by CI.

- Tags: best-practices
- Published: 2026-08-06

### [How to Contribute to the Block Buzz Project: Complete Contributor Guide](/block/buzz/how-to-contribute-block-buzz-project)

Learn how to contribute to the Block Buzz project. Follow our guide to set up your environment, run tests, and submit your first Pull Request.

- Tags: how-to-guide
- Published: 2026-08-06

### [How to Run Unit Tests in Block Buzz: A Complete Guide](/block/buzz/how-to-run-unit-tests-block-buzz)

Learn how to run unit tests in Block Buzz using the simple command `just test-unit`. Execute the fast infrastructure-free test suite with cargo-nextest or the legacy script.

- Tags: how-to-guide
- Published: 2026-08-06

### [Core Dependencies for Block Buzz Development: The Complete Rust Stack](/block/buzz/block-buzz-core-dependencies-development)

Explore the core Rust stack for Block Buzz development including Tokio, Axum, SQLx, Redis, and Nostr libraries. Centralized dependencies ensure consistency across crates.

- Tags: deep-dive
- Published: 2026-08-06

### [How to Set Up a Local Development Environment for Block Buzz: Complete Guide](/block/buzz/how-to-set-up-local-development-environment-block-buzz)

Quickly set up your Block Buzz local development environment. Clone the repo, activate Hermit, run setup and build, then launch dev for relay and desktop app.

- Tags: how-to-guide
- Published: 2026-08-06

### [How the Buzz Relay Handles Connection Limits, Slow Clients, and Handler Semaphores](/block/buzz/how-does-the-relay-handle-connection-limits-slow-clients-and-handler-semaphores)

Discover how the Buzz relay uses a three-tier resource protection strategy to manage connection limits, slow clients, and handler semaphores, preventing resource exhaustion.

- Tags: internals
- Published: 2026-08-05

### [NIP-42 WebSocket Auth vs NIP-98 HTTP Auth in Buzz: What's the Difference?](/block/buzz/whats-the-difference-between-nip-42-websocket-auth-and-nip-98-http-auth)

Explore the key differences between NIP-42 WebSocket authentication and NIP-98 HTTP authentication in Buzz. Understand how each secures your connections and requests.

- Tags: deep-dive
- Published: 2026-08-05

### [How to Deploy Buzz for Production Using Docker Compose](/block/buzz/how-do-i-deploy-buzz-for-production-using-docker-compose)

Deploy Buzz for production using Docker Compose. Clone the block/buzz repo, configure env vars, build the Docker image, and run docker compose up -d to launch your relay with essential services.

- Tags: how-to-guide
- Published: 2026-08-05

### [Buzz E2E Test Suite Architecture: How `buzz-test-client` Enables End-to-End Testing](/block/buzz/whats-the-architecture-of-the-e2e-test-suite-with-buzz-test-client)

Explore the Buzz E2E test suite architecture. Learn how buzz-test-client drives black-box integration tests against a live relay with WebSocket.

- Tags: architecture
- Published: 2026-08-05

### [How the Buzz Relay Enforces Access Control Before Registering Subscriptions](/block/buzz/how-does-the-relay-enforce-access-control-before-registering-subscriptions)

Discover how the Buzz relay enforces access control by verifying NIP-42 authentication, resolving tenancy, and validating permissions before registering subscriptions. Learn more now.

- Tags: how-to-guide
- Published: 2026-08-05

### [Flutter Mobile vs. Tauri Desktop Architecture in the Buzz Codebase](/block/buzz/what-are-the-architectural-differences-between-the-flutter-mobile-app-and-tauri-desktop-app)

Explore Flutter mobile vs Tauri desktop architecture in Buzz. Discover how Buzz splits UI and crypto logic differently for distinct trust boundaries and state management.

- Tags: architecture
- Published: 2026-08-05

### [How Nostr Git Hosting Works in Buzz: NIP-34 Patches and Repository Announcements Explained](/block/buzz/how-is-nostr-git-hosting-implemented-nip-34-patches-and-repo-announcements)

Explore decentralized Git hosting on Nostr with Buzz and NIP-34. Learn how parameterized replaceable events enable repository announcements, ref-state tracking, and patch workflows for efficient code management.

- Tags: deep-dive
- Published: 2026-08-05

### [How the Buzz Desktop App Handles Community Switching With React Key‑Based Remounting](/block/buzz/how-does-the-desktop-app-handle-community-switching-with-react-key-based-remounting)

Learn how the Buzz desktop app uses React key-based remounting for seamless community switching. Discover instant UI rebuilds for a smoother user experience.

- Tags: deep-dive
- Published: 2026-08-05

### [Buzz Huddle Audio WebSocket Implementation: Real-Time Voice Architecture Explained](/block/buzz/whats-the-huddle-audio-websocket-implementation-for-real-time-voice)

Explore the Buzz huddle audio WebSocket implementation for real-time voice. Discover how it efficiently relays and decodes peer audio using Opus and Tauri.

- Tags: architecture
- Published: 2026-08-05

### [How the Buzz Audit Hash-Chain Log Maintains Tamper Evidence: A Deep Dive into Cryptographic Integrity](/block/buzz/how-does-the-buzz-audit-hash-chain-log-maintain-tamper-evidence)

Discover how the buzz audit hash-chain log ensures tamper evidence. Learn about cryptographic chaining, tenant binding, and SHA-256 hashes for integrity.

- Tags: deep-dive
- Published: 2026-08-05

### [How to Build and Use buzz‑cli for Agent‑First JSON‑In/JSON‑Out Operations](/block/buzz/how-do-i-build-and-use-buzz-cli-for-agent-first-json-in-json-out-operations)

Learn to build and use buzz-cli for agent-first JSON in/JSON out operations. This CLI tool communicates with Buzz relay via Nostr-style signed HTTP requests, outputting raw JSON.

- Tags: how-to-guide
- Published: 2026-08-05

### [How Blossom Media Storage Works in Buzz for Uploads and Retrieval](/block/buzz/how-does-blossom-media-storage-work-in-buzz-media-for-uploads-and-retrieval)

Explore how Blossom media storage in Buzz handles uploads and retrieval. Discover its S3-backed content-addressable storage, Nostr-signed authentication, and streaming upload capabilities.

- Tags: deep-dive
- Published: 2026-08-05

### [Why Buzz Does Not Enforce Rate Limiting Despite Having a RateLimiter Trait](/block/buzz/why-doesnt-buzz-currently-implement-rate-limiting-despite-the-ratelimiter-trait)

Learn why Buzz doesn't enforce rate limiting by default even with its RateLimiter trait. Discover the opt-in approach and its implications for your applications.

- Tags: internals
- Published: 2026-08-05

### [Buzz Webhook Workflow Security Model: SSRF Protection and Trigger Authentication Explained](/block/buzz/whats-the-security-model-for-workflow-webhook-triggers-and-ssrf-protection)

Learn about Buzz's robust webhook workflow security model, including SSRF protection and trigger authentication. Secure your workflows with advanced access controls and filtering.

- Tags: deep-dive
- Published: 2026-08-05

### [How the buzz-acp Agent Harness Bridges Nostr Events to AI Agents via ACP](/block/buzz/how-does-the-buzz-acp-agent-harness-bridge-nostr-events-to-ai-agents-via-acp)

Learn how the buzz-acp harness bridges Nostr events to AI agents using ACP. Discover how this unlocks decentralized AI workflows on the Nostr network for your applications.

- Tags: deep-dive
- Published: 2026-08-05

### [How Channels Are Scoped Using h Tags vs d Tags in NIP-29](/block/buzz/how-are-channels-scoped-using-h-tags-versus-d-tags-in-nip-29)

Understand how h tags scope message events and d tags define channels in NIP-29 group messaging. Learn about channel scoping in block/buzz.

- Tags: deep-dive
- Published: 2026-08-05

### [How Postgres Full-Text Search Works in Buzz with the `search_tsv` Generated Column](/block/buzz/how-does-postgres-full-text-search-work-in-buzz-with-the-search_tsv-generated-column)

Learn how Postgres full-text search works in Buzz using the search_tsv generated column for efficient real-time event content indexing and privacy exclusion.

- Tags: deep-dive
- Published: 2026-08-05

### [buzz-workflow YAML Automation Engine Architecture: A Deep Dive into the Block/Buzz Rust Implementation](/block/buzz/whats-the-architecture-of-the-buzz-workflow-yaml-automation-engine)

Explore the buzz-workflow YAML automation engine architecture. Discover its four-layer design separating YAML parsing from execution, ensuring security and reliability.

- Tags: architecture
- Published: 2026-08-05

### [How Buzz Implements Presence Tracking and Typing Indicators with Redis](/block/buzz/how-does-buzz-implement-presence-tracking-and-typing-indicators-with-redis)

Discover how Buzz uses Redis SET keys for presence tracking and Pub/Sub channels for typing indicators. Learn about the buzz-pubsub crate in this technical deep dive.

- Tags: how-to-guide
- Published: 2026-08-05

### [How the Three-Tier Subscription Fan-Out System Works in Buzz](/block/buzz/how-does-the-three-tier-subscription-fan-out-system-work-in-buzz)

Explore Buzz's three-tier subscription fan-out system. Learn how it uses WebSockets, Redis, and PostgreSQL for low-latency, guaranteed event delivery across distributed pods.

- Tags: architecture
- Published: 2026-08-05

### [How to Add a Custom Event Kind to the Buzz Relay: A Complete 10-Step Guide](/block/buzz/how-do-i-add-a-new-custom-event-kind-to-the-buzz-relay)

Learn to add a custom event kind to the Buzz relay with this 10 step guide. Define constants, update helpers, implement logic, and test your changes.

- Tags: how-to-guide
- Published: 2026-08-05

### [How NIP-42 WebSocket Authentication Works in the Buzz Relay](/block/buzz/how-does-the-nip-42-websocket-authentication-flow-work-in-the-buzz-relay)

Understand NIP-42 WebSocket authentication in Buzz relay. Learn how the challenge response protocol and signed kind 22242 events secure your connection.

- Tags: deep-dive
- Published: 2026-08-05

### [Ephemeral Events vs Regular Stored Events in Buzz: The Complete Technical Guide](/block/buzz/whats-the-difference-between-ephemeral-events-20000-29999-and-regular-stored-events-in-buzz)

Understand the key differences between ephemeral events and regular stored events in Buzz. Learn how each type is handled technically and when to use them.

- Tags: deep-dive
- Published: 2026-08-05

### [How Buzz Implements Multi-Tenant Community Isolation Across Shared Infrastructure](/block/buzz/how-does-buzz-implement-multi-tenant-community-isolation-across-shared-infrastructure)

Learn how Buzz implements multi-tenant community isolation across shared infrastructure using composite database keys, community-scoped contexts, and per-tenant resource gates.

- Tags: architecture
- Published: 2026-08-05

### [How the Buzz Relay Implements NIP-17 Gift Wraps for Private DM Encryption](/block/buzz/how-does-buzz-relay-implement-nip-17-gift-wraps-for-dm-encryption)

Discover how the Buzz relay uses NIP-17 gift wraps for secure private DM encryption. Learn about its unique routing and search exclusion methods for enhanced privacy.

- Tags: deep-dive
- Published: 2026-08-04

### [How buzz-dev-mcp Enables Secure Developer Tool Integration for AI Agents](/block/buzz/what-is-the-role-of-buzz-dev-mcp-for-developer-tool-integration)

Discover how buzz-dev-mcp secures developer tool integration for AI agents. It acts as a bridge, granting isolated access to shell commands and workflows without full system exposure.

- Tags: how-to-guide
- Published: 2026-08-04

### [How the Buzz Push Gateway Implements NIP-PL Push Lease Delivery](/block/buzz/how-does-buzz-push-gateway-implement-nip-pl-push-lease-delivery)

Discover how the Buzz push gateway uses a dual-service architecture with buzz-relay and buzz-push-gateway to implement NIP-PL push lease delivery via APNs.

- Tags: internals
- Published: 2026-08-04

### [How buzz-audit Implements Hash-Chain Audit Logs for Tamper-Evident Event Tracking](/block/buzz/how-does-buzz-audit-implement-the-hash-chain-audit-log)

Discover how buzz-audit uses hash-chain audit logs with SHA-256 and PostgreSQL for tamper-evident event tracking. Learn about secure, verifiable logging.

- Tags: how-to-guide
- Published: 2026-08-04

### [NIP-42 WebSocket Authentication Flows in the Buzz Relay: Complete Implementation Guide](/block/buzz/what-are-the-nip-42-authentication-flows-used-by-buzz-relay)

Implement NIP-42 WebSocket authentication for the Buzz relay. Secure your Nostr client with this complete guide to the cryptographic challenge response protocol.

- Tags: how-to-guide
- Published: 2026-08-04

### [How to Implement the resetCommunityState Pattern for Clearing Module-Level Singletons on Community Switch in Buzz](/block/buzz/what-is-the-resetcommunitystate-pattern-for-clearing-singletons)

Learn the Buzz resetCommunityState pattern to clear module-level singletons when switching Nostr communities. Prevent stale data and cross-community state leakage.

- Tags: deep-dive
- Published: 2026-08-04

### [Thread Counter Materialization Pattern in Buzz: How `reply_count` and `descendant_count` Work](/block/buzz/what-is-the-thread-counter-materialization-pattern)

Understand Buzz's thread counter materialization pattern. Learn how reply_count and descendant_count are efficiently managed in the thread_metadata table using atomic transactions.

- Tags: internals
- Published: 2026-08-04

### [How Blossom Protocol Integration Works in buzz-media for Media Storage](/block/buzz/how-does-blossom-protocol-integration-work-in-buzz-media-for-media-storage)

Learn how Blossom protocol integration works in buzz-media for media storage. It secures uploads/downloads via Nostr events and uses S3-compatible storage with sidecar metadata for access control.

- Tags: deep-dive
- Published: 2026-08-04

### [How buzz-workflow YAML Condition Evaluation Works with evalexpr](/block/buzz/what-is-the-buzz-workflow-yaml-condition-evaluation-system-based-on-evalexpr)

Explore buzz-workflow YAML condition evaluation powered by evalexpr. Learn how it maps trigger variables and step outputs into a flat context with custom helpers and safety timeouts for robust workflow logic.

- Tags: deep-dive
- Published: 2026-08-04

### [How the buzz-search Crate Implements PostgreSQL Full-Text Search](/block/buzz/how-does-buzz-search-crate-implement-full-text-search-with-postgres-fts)

Learn how the buzz-search crate leverages PostgreSQL FTS with websearch_to_tsquery and to_tsvector for relevance-ranked search and prefix matching.

- Tags: internals
- Published: 2026-08-04

### [How buzz-pubsub Powers Presence Tracking and Typing Indicators in Buzz](/block/buzz/what-is-the-role-of-buzz-pubsub-for-presence-and-typing-indicators)

Discover how buzz pubsub leverages Redis for real-time presence tracking and typing indicators in the Buzz Nostr implementation. Learn about its role in distributed relay pods.

- Tags: deep-dive
- Published: 2026-08-04

### [How Buzz Implements NIP‑34 Git Repository Hosting and Patch Events](/block/buzz/how-does-buzz-implement-nip-34-git-repository-hosting-and-patch-events)

Discover how Buzz implements NIP-34 Git repository hosting and patch events. Learn about its event-driven approach for repository announcements, manifests, and patches with policy enforcement.

- Tags: internals
- Published: 2026-08-04

### [How the buzz-acp Harness Integrates with External Agent Runtimes Like Goose and Claude Code](/block/buzz/what-is-the-relationship-between-buzz-acp-harness-and-external-agent-runtimes)

Discover how the buzz-acp harness bridges Buzz with external agent runtimes like Goose and Claude Code. Learn about standardized ACP integration for seamless AI tool connectivity.

- Tags: how-to-guide
- Published: 2026-08-04

### [buzz-relay WebSocket Server Architecture and Event Processing Pipeline](/block/buzz/what-is-the-architecture-of-buzz-relay-websocket-server-and-its-event-processing-pipeline)

Explore the buzz-relay WebSocket server architecture running on Axum. Understand its eight-stage event processing pipeline including validation, signature verification, rate limiting, PostgreSQL persistence, and Redis pub/sub f...

- Tags: architecture
- Published: 2026-08-04

### [How Buzz Relay Implements NIP-29 Group-Based Access Control](/block/buzz/how-does-buzz-relay-implement-nip-29-group-based-access-control)

Learn how Buzz relay implements NIP-29 group-based access control by verifying event tags against membership tables and public visibility flags for secure access.

- Tags: deep-dive
- Published: 2026-08-04

### [How Buzz Handles Agent Identity and Authentication Through ACP: A Complete Technical Guide](/block/buzz/how-does-buzz-handle-agent-identity-and-authentication-through-acp)

Discover how Buzz handles agent identity and authentication via ACP. Learn about Nostr keypairs, NIP-OA auth tags, and presence-based relay verification for secure agent startup.

- Tags: technical-guide
- Published: 2026-08-04

### [How Buzz Implements Channel Window Overlays for Pagination](/block/buzz/buzz-relay-channel-window-overlays-pagination-implementation)

Learn how Buzz uses relay-signed overlay events thread summary and window bounds to implement authenticated pagination metadata and thread statistics for channel window queries.

- Tags: deep-dive
- Published: 2026-08-03

### [How the Buzz Moderation Command System Works: Nostr Kinds 9040–9044 Explained](/block/buzz/buzz-moderation-command-system-kinds-9040-9044-ban-execution)

Discover how the Buzz moderation command system uses Nostr kinds 9040-9044 to execute community bans, unbans, and timeouts directly on relays. Learn about efficient content moderation.

- Tags: internals
- Published: 2026-08-03

### [How the NIP-IA Identity Archival System Works in Buzz: A Complete Technical Guide](/block/buzz/how-does-nip-ia-identity-archival-system-work-buzz)

Discover how Buzz's NIP-IA identity archival system preserves Nostr event history by relaying retired public keys through signed requests and delta announcements.

- Tags: deep-dive
- Published: 2026-08-03

### [How the DM Visibility System (Kind 30622) Works in Buzz and How Direct Messages Are Hidden](/block/buzz/dm-visibility-system-kind-30622-buzz-hide-dms)

Discover how Buzz's DM visibility system (kind 30622) secures private messages using relay-signed snapshots gated by your pubkey. Learn how DMs are hidden effectively.

- Tags: internals
- Published: 2026-08-03

### [How NIP-MP Groups Repositories in Buzz: Multi-Repo Projects Explained](/block/buzz/how-does-nip-mp-multi-repo-projects-group-repositories-buzz)

Discover how NIP-MP groups repositories in Buzz using Nostr kind 30621 events and a tags for cross-owner collections without altering repository announcements.

- Tags: deep-dive
- Published: 2026-08-03

### [Buzz Workflow Webhook Triggers and Authentication: Complete Technical Guide](/block/buzz/buzz-workflow-webhook-triggers-authentication)

Learn how Buzz workflow webhook triggers start workflows using POST requests authenticated with a UUID v4 secret in the X-Webhook-Secret header or query parameter.

- Tags: deep-dive
- Published: 2026-08-03

### [How Buzz Relay Implements Rate Limiting and Admission Control: A Deep Dive into the Source Code](/block/buzz/buzz-relay-rate-limiting-admission-control-implementation)

Explore how Buzz relay uses Redis fixed-window counters and layered checks for rate limiting and admission control, protecting its Nostr relay from abuse. Dive into the source code.

- Tags: deep-dive
- Published: 2026-08-03

### [NIP-RS Read State Protocol for Cross-Device Sync in Buzz: A Technical Deep Dive](/block/buzz/what-is-nip-rs-read-state-protocol-cross-device-sync-buzz)

Explore the NIP-RS read state protocol for Buzz cross-device sync. Learn how timestamp blobs in Nostr kind 30078 events enable seamless synchronization of read positions across your devices.

- Tags: deep-dive
- Published: 2026-08-03

### [How the NIP-43 Relay Membership System Works in Buzz: Snapshots, Deltas, and Access Control](/block/buzz/how-does-nip-43-relay-membership-system-work-buzz)

Explore Buzz's NIP-43 relay membership system. Learn about snapshots, deltas, and access control in this three-layer architecture. Understand how Buzz manages membership effectively.

- Tags: deep-dive
- Published: 2026-08-03

### [Understanding Shared-Gated Kinds and the Author-Only-Unless-Shared Read Model in Buzz](/block/buzz/shared-gated-kinds-author-only-unless-shared-read-model-buzz)

Explore Buzz's author-only-unless-shared read model and shared-gated kinds. Learn how to make your events community-visible with shared tags.

- Tags: deep-dive
- Published: 2026-08-03

### [How Buzz Relay Implements NIP-50 Full-Text Search with PostgreSQL](/block/buzz/buzz-relay-nip-50-full-text-search-postgresql)

Discover how Buzz relay implements NIP-50 full-text search with PostgreSQL. Learn about server-side tokenization, ranking, prefix matching, and community isolation.

- Tags: how-to-guide
- Published: 2026-08-03

### [How Buzz’s Hash-Chain Audit Log System Tracks Events and Detects Tampering](/block/buzz/buzz-hash-chain-audit-log-system-event-tracking)

Discover Buzz's hash-chain audit log system. Learn how it creates tamper-evident records of events using SHA-256 hash chaining for secure tracking and detection.

- Tags: how-to-guide
- Published: 2026-08-03

### [How Huddles (Audio/Video) Work with WebRTC in Buzz: Events, Signaling, and Peer Connections](/block/buzz/how-do-huddles-webrtc-work-buzz-events-emitted)

Discover how Buzz uses Nostr signaling and WebRTC for audio/video huddles. Learn about peer connections, event signaling, and media transport in the block/buzz repository.

- Tags: deep-dive
- Published: 2026-08-03

### [What Is the NIP-AP Agent Persona System and How Are Personas Shared in Buzz?](/block/buzz/what-is-nip-ap-agent-persona-system-buzz-persona-sharing)

Explore the NIP-AP agent persona system in Buzz. Learn how AI agent blueprints are defined as Nostr events and shared using the public shared tag for visibility and control.

- Tags: deep-dive
- Published: 2026-08-03

### [How the Buzz Relay Implements NIP-42 Authentication with Schnorr Signatures](/block/buzz/buzz-relay-nip-42-authentication-schnorr-signatures)

Discover how the Buzz relay implements NIP-42 authentication using Schnorr signatures. Learn about the three-phase cryptographic flow: challenge generation, client response, and relay verification.

- Tags: internals
- Published: 2026-08-03

### [Ephemeral Event Kinds and Redis Pub/Sub Presence/Typing Management in Buzz](/block/buzz/ephemeral-event-kinds-redis-pub-sub-presence-typing-buzz)

Discover ephemeral event kinds in Buzz Nostr and how Redis pub/sub handles real-time presence and typing status for enhanced user experience. Learn more about this innovative approach.

- Tags: deep-dive
- Published: 2026-08-03

### [How the Blossom Media Upload and Storage System Works in Buzz: A Complete Technical Guide](/block/buzz/how-does-blossom-media-upload-storage-system-work-buzz)

Explore how Buzz's Blossom media system works. Learn about Nostr authentication, S3 storage, and efficient media serving. A complete technical guide.

- Tags: deep-dive
- Published: 2026-08-03

### [NIP-AE (Agent Engrams) and Persistent Memory for AI Agents in Buzz: A Complete Guide](/block/buzz/what-is-nip-ae-agent-engrams-buzz-persistent-memory)

Explore NIP-AE agent engrams and how Buzz implements persistent memory using Nostr events. Learn to store encrypted agent memories securely.

- Tags: deep-dive
- Published: 2026-08-03

### [How the Buzz Workflow Engine Handles Triggers, Approvals, and Execution States](/block/buzz/buzz-workflow-engine-triggers-approvals-execution-states)

Discover how the Buzz workflow engine manages triggers, approvals, and execution states. Learn how it pauses at approval gates and resumes seamlessly with secure tokens.

- Tags: internals
- Published: 2026-08-03

### [What Are P-Gated Kinds in Buzz and How Is Pubkey-Based Access Enforced?](/block/buzz/what-are-p-gated-kinds-buzz-pubkey-access-enforcement)

Discover p-gated kinds in Buzz, a curated subset of Nostr events. Learn how relays enforce pubkey-based access for privacy-sensitive data using the #p tag.

- Tags: deep-dive
- Published: 2026-08-03

### [How Agents Accept and Complete Jobs in Buzz: The Managed Agents Lifecycle](/block/buzz/how-do-agents-accept-and-complete-jobs-in-buzz)

Learn how Buzz agents accept jobs by spawning child processes and complete them automatically when the JobHandle is dropped during shutdown. Discover the managed agents lifecycle.

- Tags: internals
- Published: 2026-08-03

### [Agent Job Protocol (Kinds 43001–43006) in Buzz: Complete Guide to Nostr-Based AI Workflows](/block/buzz/what-is-agent-job-protocol-kinds-43001-43006-in-buzz)

Master the Agent Job Protocol (kinds 43001-43006) in Buzz. This guide explains Nostr-based AI workflows for secure, private asynchronous task management, replacing NIP-90.

- Tags: deep-dive
- Published: 2026-08-03

### [How NIP-29 Group Management Works in the Buzz Relay: A Technical Deep Dive](/block/buzz/how-does-nip-29-group-management-work-in-buzz-relay)

Explore NIP-29 group management in the Buzz relay. Learn how Nostr events and channel-scoped storage enable secure, discoverable group functionality.

- Tags: deep-dive
- Published: 2026-08-03

### [Buzz Production Deployment Topology with Docker Compose: Postgres, Redis, and MinIO](/block/buzz/buzz-production-deployment-topology-docker-compose-postgres-redis-minio)

Deploy Buzz in production using Docker Compose with Postgres Redis and MinIO. This guide details a single node topology with persistent volumes and environment configuration for efficient operation.

- Tags: production-deployment
- Published: 2026-08-02

### [How Buzz Routes NIP-50 Search Filters to Postgres FTS vs. Memory Filters](/block/buzz/buzz-relay-route-nip-50-filters-postgres-fts-vs-memory)

Learn how Buzz routes NIP-50 search filters. Discover when it uses Postgres FTS for search fields and memory filters for standard queries. Optimize your search.

- Tags: internals
- Published: 2026-08-02

### [How the Buzz Relay Applies PostgreSQL Schema Migrations on Startup](/block/buzz/buzz-relay-migration-system-apply-postgres-schema-changes-startup)

Discover how the Buzz relay seamlessly applies PostgreSQL schema migrations on startup using sqlx migrate. Learn about atomic execution and least-privilege roles.

- Tags: internals
- Published: 2026-08-02

### [How the Buzz Desktop App Manages and Resets Module-Level Singletons on Community Boundary Changes](/block/buzz/buzz-desktop-app-manage-reset-singletons-community-boundary-changes)

Learn how the Buzz desktop app resets module-level singletons on community boundary changes with the resetCommunityState function, ensuring isolated runtime environments.

- Tags: internals
- Published: 2026-08-02

### [How to Implement a New NIP Specification in the Buzz Relay: A Complete Developer Guide](/block/buzz/implement-new-nip-specification-buzz-relay)

Learn how to implement a new NIP specification in the Buzz relay with this complete developer guide. Follow our straightforward pipeline for seamless integration and enhanced functionality.

- Tags: how-to-guide
- Published: 2026-08-02

### [Buzz Multi-Node Relay Mesh Architecture for Distributed Fan-Out Explained](/block/buzz/buzz-multi-node-relay-mesh-architecture-distributed-fan-out)

Discover Buzz's multi-node relay mesh architecture for distributed fan-out. Learn how it uses Redis discovery and iroh transport for efficient event distribution across Kubernetes nodes.

- Tags: architecture
- Published: 2026-08-02

### [How the Buzz Desktop App Implements Zoom Using rem Units Instead of px Values](/block/buzz/buzz-desktop-app-zoom-rem-units-vs-hardcoded-px)

Discover how the Buzz desktop app uses rem units for scalable UI zoom, adapting dynamically without hardcoded px values to maintain layout integrity. Learn the implementation details.

- Tags: deep-dive
- Published: 2026-08-02

### [How to Register a Custom Nostr Event Handler in the Buzz Relay Pipeline](/block/buzz/register-custom-nostr-event-handler-buzz-relay-pipeline)

Learn to register a custom Nostr event handler in the Buzz relay. Define a new event kind, implement an async handler, and insert it into the HandlerRegistry for streamlined processing.

- Tags: how-to-guide
- Published: 2026-08-02

### [Postgres Event Schema in Buzz: How Replaceable and Parameterized Events Are Indexed](/block/buzz/buzz-postgres-event-schema-replaceable-parameterized-events-indexed)

Discover the Postgres event schema in Buzz. Learn how replaceable and parameterized events are indexed for efficient O(log N) lookups and tenant isolation.

- Tags: deep-dive
- Published: 2026-08-02

### [How NIP-98 HTTP Auth Tokens Work with Rate Limiting on the Buzz Relay](/block/buzz/nip-98-http-auth-tokens-rate-limiting-buzz-relay)

Learn how NIP-98 HTTP auth tokens on Buzz relay ensure authenticated identity and enable effective rate limiting using principal public keys for secure access control.

- Tags: deep-dive
- Published: 2026-08-02

### [How the Agent-First Buzz-CLI Provides JSON In/JSON Out for LLM Tool Integration](/block/buzz/agent-first-buzz-cli-json-in-out-llm-tool-integration)

Integrate LLM tools seamlessly with buzz-cli's JSON in/JSON out. Learn how its machine-readable output, structured errors, and distinct exit codes simplify complex workflows.

- Tags: how-to-guide
- Published: 2026-08-02

### [How Buzz Handles Community Switching via React Key Remounting in Tauri](/block/buzz/buzz-tauri-desktop-app-community-switching-react-key-remounting)

Learn how Buzz's Tauri app handles community switching with React key remounting. Discover how it isolates communities and clears state for a seamless user experience.

- Tags: internals
- Published: 2026-08-02

### [NIP-34 Git Hosting Implementation in Buzz: Repository, Patch, and Status Events Explained](/block/buzz/buzz-nip-34-git-hosting-implementation-patches-repos-status-events)

Explore NIP-34 Git hosting in Buzz. Understand how replaceable Nostr events manage repositories, patches, and status updates. Learn about SDKs, relay validation, and Smart-HTTP.

- Tags: deep-dive
- Published: 2026-08-02

### [How the Buzz Relay Implements NIP-29 Group Chat: Channel Metadata, Membership, and Moderation Explained](/block/buzz/buzz-relay-nip-29-group-chat-channel-metadata-membership-moderation)

Learn how the Buzz relay implements NIP-29 group chat. Discover channel metadata, membership, and moderation strategies using Nostr events and specific event kinds.

- Tags: deep-dive
- Published: 2026-08-02

### [How Buzz Channels and Threads Are Scoped with NIP-29 h Tags Versus Legacy e Tags](/block/buzz/buzz-channels-threads-scoped-nip-29-h-tags-vs-legacy-e-tags)

Discover how Buzz NIP-29 h tags scope channels and legacy e tags scope threads. Understand Buzz's approach to event linking and channel boundaries.

- Tags: internals
- Published: 2026-08-02

### [How the Hash-Chain Audit Log Ensures Tamper-Evident Event Tracking in Buzz](/block/buzz/hash-chain-audit-log-tamper-evident-event-tracking-buzz)

Discover how Buzz's hash-chain audit log ensures tamper-evident event tracking by cryptographically linking every event, making modifications instantly detectable. Learn more.

- Tags: internals
- Published: 2026-08-02

### [How Blossom Media Storage Handles Uploads, Thumbnails, and Frame‑Anchored Comments in Buzz](/block/buzz/blossom-media-storage-uploads-thumbnails-frame-anchored-comments-buzz)

Discover how Blossom media storage handles uploads, thumbnails, and frame anchored comments in Buzz. Learn about BUD-01/02 compatibility, Nostr event tags, and SHA-256 hashes.

- Tags: internals
- Published: 2026-08-02

### [How Buzz Implements Postgres Full‑Text Search for NIP‑50 Search Filters](/block/buzz/postgres-full-text-search-buzz-nip-50-filters)

Learn how Buzz uses Postgres full-text search with TSVECTOR and GIN indexes for efficient NIP-50 search filters. Discover real-time, community-scoped search without background indexers.

- Tags: deep-dive
- Published: 2026-08-02

### [How Buzz's YAML Workflow Engine Evaluates `if:` Conditions with evalexpr and Triggers Actions](/block/buzz/buzz-yaml-workflow-engine-evaluate-conditions-evalexpr-trigger-actions)

Discover how Buzz's YAML workflow engine uses evalexpr to evaluate if conditions, leveraging custom functions and timeouts to trigger actions based on context.

- Tags: internals
- Published: 2026-08-02

### [How the ACP Agent Harness Bridges Nostr Events to AI Agents via JSON-RPC in Buzz](/block/buzz/acp-agent-bridge-nostr-events-ai-agents-json-rpc-buzz)

Learn how the ACP agent harness bridges Nostr events to AI agents using JSON-RPC in Buzz. Discover how it converts Nostr events to AI agent commands and transforms responses back for the relay layer.

- Tags: how-to-guide
- Published: 2026-08-02

### [How Redis Pub/Sub Handles Real-Time Presence and Typing Indicators in Buzz for Multi-Node Fan-Out](/block/buzz/redis-pubsub-realtime-presence-typing-indicators-buzz-multi-node-fan-out)

Learn how Buzz leverages Redis Pub/Sub for real-time presence and typing indicators in multi-node fan-out. Discover its low-latency backbone architecture.

- Tags: deep-dive
- Published: 2026-08-02

### [How Buzz Implements Multi-Community Tenant Isolation and Derives Community from Request Host](/block/buzz/buzz-multi-community-tenant-isolation-architecture-derive-community-request-host)

Discover how Buzz implements multi community tenant isolation using the Host header for database schemas, Redis namespaces, and rate limits. Learn Buzz architecture.

- Tags: architecture
- Published: 2026-08-02

### [How NIP-42 Authentication Works in the Buzz WebSocket Relay for Community Isolation](/block/buzz/how-nip-42-authentication-works-buzz-websocket-relay-community-isolation)

Learn how NIP-42 authentication secures Buzz WebSocket relays for community isolation. Discover cryptographic challenge-response and host verification to prevent credential replay.

- Tags: deep-dive
- Published: 2026-08-02

### [How Buzz Implements the Nostr Event Kind System and Handles Custom Kind Registration](/block/buzz/how-buzz-implements-nostr-event-kind-system-adding-custom-kind)

Explore how Buzz implements the Nostr event kind system using centralized u32 constants and helper functions. Learn the process for adding custom kinds with compile-time validation.

- Tags: internals
- Published: 2026-08-02

### [How the Push Notification Gateway Integrates with the Block/Buzz Relay](/block/buzz/how-does-push-notification-gateway-integrate-relay)

Discover how the Block/Buzz relay integrates with the push notification gateway using background tasks to enqueue and deliver wake records via HTTP POST requests.

- Tags: how-to-guide
- Published: 2026-08-01

### [What is the `buzz-relay-mesh` Crate for Multi-Relay Deployments?](/block/buzz/what-is-buzz-relay-mesh-crate-multi-relay-deployments)

Discover the buzz-relay-mesh crate for secure, high-performance QUIC mesh networking. Connect multiple Buzz relays for scalable, distributed Nostr communities.

- Tags: deep-dive
- Published: 2026-08-01

### [How Dev-Only Key Derivation Works for Testing in Buzz: A Deep Dive into the Source Code](/block/buzz/how-does-dev-only-key-derivation-work-testing)

Explore Buzz's dev-only key derivation for testing. Discover its SHA-256 hashing and HKDF-SHA-256 stretching pipeline, isolated from production. Learn how it works in this source code deep dive.

- Tags: deep-dive
- Published: 2026-08-01

### [What Shell and File-Edit Tools Does buzz-dev-mcp Provide to Agents?](/block/buzz/what-shell-file-edit-tools-buzz-dev-mcp-provide-agents)

Explore buzz-dev-mcp's shell and file-edit tools: shell, read_file, and str_replace. Agents gain powerful command execution and controlled code modification capabilities. Learn more.

- Tags: internals
- Published: 2026-08-01

### [How NIP-98 HTTP Auth Verifies Schnorr-Signed Requests in Buzz](/block/buzz/how-does-nip-98-http-auth-verify-schnorr-signed-requests)

Learn how NIP-98 HTTP Auth in Buzz verifies Schnorr-signed requests via an 8-step stateless pipeline including signature verification and timestamp checks for secure authentication.

- Tags: deep-dive
- Published: 2026-08-01

### [NIP-01 WebSocket Message Types and Frame Size Limits in the Buzz Relay](/block/buzz/what-are-nip-01-websocket-message-types-frame-size-limits)

Understand NIP-01 WebSocket message types and Buzz's 64 KB frame size limit for efficient client-relay communication. Learn key details for Nostr protocol.

- Tags: api-reference
- Published: 2026-08-01

### [Events Database Schema and Monthly Partitioning in Block's Buzz](/block/buzz/what-is-database-schema-events-monthly-partitioning-work)

Explore the Buzz events database schema and monthly partitioning strategy. Learn how this design ensures fast writes and efficient time-range queries for Nostr events.

- Tags: internals
- Published: 2026-08-01

### [How Buzz Secures Workflow Webhooks Against SSRF Attacks: Defense in Depth](/block/buzz/how-are-workflow-webhooks-secured-against-ssrf-attacks)

Buzz secures workflow webhooks against SSRF attacks with IP validation, client pinning, and disabled redirects. Learn how Buzz defends against SSRF threats.

- Tags: deep-dive
- Published: 2026-08-01

### [Custom Event Kind Ranges (40000-49999) Used by Buzz: Complete Reference](/block/buzz/what-are-custom-event-kind-ranges-used-by-buzz)

Discover the custom event kind ranges 40000-49999 used by Buzz for stream messaging, agent jobs, workflows, and system administration. Avoid NIP collisions with this central reference.

- Tags: api-reference
- Published: 2026-08-01

### [How Connection and Handler Semaphores Limit Concurrent Load on the Buzz Relay](/block/buzz/how-do-connection-handler-semaphores-limit-concurrent-load-relay)

Learn how Buzz relay's connection and handler semaphores limit concurrent load by rejecting excess requests, preventing resource exhaustion and ensuring stability.

- Tags: performance
- Published: 2026-08-01

### [Why Rate Limiting Is Not Enforced in Buzz Despite the RateLimiter Trait](/block/buzz/why-is-rate-limiting-not-enforced-despite-ratelimiter-trait-existence)

Discover why rate limiting is not enforced in Buzz despite the RateLimiter trait. Learn how no-op placeholders and stubs leave request paths unrestricted.

- Tags: internals
- Published: 2026-08-01

### [How NIP-34 Git Hosting Works on the Buzz Relay](/block/buzz/how-does-nip-34-git-hosting-work-relay)

Discover how NIP-34 Git hosting works within the Buzz relay. Learn about parameterized replaceable events for repository announcements, manifest tracking, and patch-centric workflows without direct pushes.

- Tags: internals
- Published: 2026-08-01

### [How buzz-acp Bridges Nostr @mentions to AI Agents via ACP](/block/buzz/how-does-buzz-acp-bridge-nostr-mentions-ai-agents-acp)

Learn how buzz-acp bridges Nostr @mentions to AI agents. It filters mentions, strips tokens, and routes content via ACP as a tagged prompt for seamless AI integration.

- Tags: how-to-guide
- Published: 2026-08-01

### [Huddle Audio WebSocket Protocol in Buzz: How Opus Frames Are Relayed](/block/buzz/what-is-huddle-audio-websocket-protocol-opus-frames-relayed)

Explore Buzz's huddle audio WebSocket protocol. Learn how raw Opus frames are relayed opaquely with an 8-byte header to all participants, no server transcoding needed.

- Tags: deep-dive
- Published: 2026-08-01

### [How Blossom Media Upload Works in Buzz: Architecture and Implementation](/block/buzz/how-does-blossom-media-upload-work-buzz-media)

Discover how Blossom media upload works in Buzz. Explore its dual-pipeline architecture, S3 storage, SHA-256 validation, and Nostr tokens for secure, community-scoped content.

- Tags: architecture
- Published: 2026-08-01

### [How the Buzz-Audit Hash-Chain Ensures Tamper-Evident Logging](/block/buzz/how-does-buzz-audit-hash-chain-ensure-tamper-evident-logging)

Learn how the buzz-audit hash-chain ensures tamper-evident logging. Discover cryptographic linking with SHA-256 hashes for immutable and verifiable community audit trails.

- Tags: internals
- Published: 2026-08-01

### [How the Postgres FTS Search Index Works in Buzz-Search](/block/buzz/how-does-postgres-fts-search-index-work-buzz-search)

Learn how Buzz-Search leverages Postgres FTS and GIN indexes with a TSVECTOR column for lightning-fast, synchronized full-text search on event content. Optimize your searches today.

- Tags: internals
- Published: 2026-08-01

### [How Buzz-PubSub Handles Presence Tracking and Typing Indicators via Redis](/block/buzz/how-does-buzz-pubsub-handle-presence-tracking-typing-indicators-redis)

Discover how Buzz-PubSub leverages Redis for efficient presence tracking and real-time typing indicators. Learn about expiring keys and ephemeral pub/sub channels for enhanced communication.

- Tags: deep-dive
- Published: 2026-08-01

### [How SubscriptionRegistry Fans Out Events to Connected Clients in block/buzz](/block/buzz/how-does-subscriptionregistry-fan-out-events-connected-clients-efficiently)

Discover how SubscriptionRegistry efficiently fans out Nostr events to connected clients using O(1) lookups and lock-free DashMaps for unparalleled performance. Optimize your application today.

- Tags: internals
- Published: 2026-08-01

### [How Buzz Implements Multi-Community Tenant Isolation in Shared Infrastructure](/block/buzz/how-does-buzz-implement-multi-community-tenant-isolation-shared-infrastructure)

Buzz ensures multi-community tenant isolation on shared infrastructure by enforcing a community_id predicate on all data operations for complete separation.

- Tags: architecture
- Published: 2026-08-01

### [Buzz Workflow Triggers and Actions: Complete YAML Automation Guide](/block/buzz/what-workflow-triggers-actions-supported-buzz-workflow-yaml-engine)

Discover the buzz-workflow YAML engine's triggers and actions. Automate messages, webhooks, reactions, and more with our comprehensive guide to declarative workflows.

- Tags: how-to-guide
- Published: 2026-08-01

### [How Buzz Implements Channel Membership Access Control and Tenant Isolation](/block/buzz/how-does-buzz-implement-channel-membership-access-control-tenant-isolation)

Learn how Buzz secures channel membership and isolates tenants using Nostr signed roles and database scoping. Discover the technical details of this robust access control system.

- Tags: internals
- Published: 2026-08-01

### [NIP-42 Authentication Flow in Buzz Relay: Challenge-Response Verification Explained](/block/buzz/what-is-nip-42-authentication-flow-relay-verify-client-signatures)

Understand the NIP-42 authentication flow in Buzz Relay. Discover how the challenge-response mechanism verifies client signatures using Nostr private keys and Schnorr signatures for secure connections.

- Tags: deep-dive
- Published: 2026-08-01

### [How the Buzz Relay Handles the Event Pipeline from WebSocket Submission to Storage](/block/buzz/how-does-buzz-relay-handle-event-pipeline-websocket-submission-storage)

Discover how the Buzz relay manages its event pipeline from WebSocket submission to storage. Learn about signature validation, authorization, thread resolution, and persistence to Postgres.

- Tags: internals
- Published: 2026-08-01

### [How the Buzz Relay Manages Subscriptions and Event Fan-Out to WebSocket Clients](/block/buzz/buzz-relay-subscription-management-event-fan-out-websocket)

Discover how the Buzz relay efficiently manages subscriptions and event fan-out to WebSocket clients using lock-free indexes for O(1) lookups and runtime access validation.

- Tags: internals
- Published: 2026-07-31

### [Testing Infrastructure in buzz-test-client for End-to-End and Integration Tests](/block/buzz/buzz-test-client-e2e-integration-testing-infrastructure)

Explore the testing infrastructure in buzz-test-client for end-to-end and integration tests. Drive full-stack tests against a live Buzz relay with this NIP-01 WebSocket client.

- Tags: how-to-guide
- Published: 2026-07-31

### [How Buzz Implements Invite Tokens and Relay Membership Management](/block/buzz/buzz-invite-tokens-relay-membership-management)

Learn how Buzz implements invite tokens and relay membership management using HMAC-signed tokens and PostgreSQL for secure, community-scoped access control.

- Tags: internals
- Published: 2026-07-31

### [Buzz Desktop App Architecture: How Tauri, React 19, and Relay Communication Work Together](/block/buzz/buzz-desktop-app-architecture-tauri-react19-relay-communication)

Explore the Buzz desktop app architecture. Discover how Tauri, React 19, and RelayClient manage secure WebSocket communication with Nostr relays, NIP-42 auth, rate-limiting, and auto-reconnect.

- Tags: architecture
- Published: 2026-07-31

### [How Buzz Implements Moderation Features: Ban, Mute, and Content Filtering Architecture](/block/buzz/buzz-moderation-features-ban-mute-content-filtering)

Explore Buzz's moderation architecture for ban mute and content filtering Discover how PostgreSQL WebSocket and NIP-43 commands ensure real-time enforcement with tenant isolation

- Tags: architecture
- Published: 2026-07-31

### [Buzz Webhook System for Workflow Triggers and Event Notifications](/block/buzz/buzz-webhook-system-workflow-triggers-event-notifications)

Discover how Buzz's webhook system triggers workflows and sends event notifications using unique URLs, secret validation, and Nostr kind 9 messages.

- Tags: how-to-guide
- Published: 2026-07-31

### [How Buzz Handles Message Reactions and Threading with NIP-25 and NIP-10](/block/buzz/buzz-message-reactions-threading-nip25-nip10)

Buzz handles Nostr message reactions with NIP-25 kind 7 events and threading with NIP-10 hierarchical e tags. Learn how Buzz structures conversations across the network.

- Tags: deep-dive
- Published: 2026-07-31

### [Understanding Buzz's Multi-Tenant Relay Architecture and Community Isolation](/block/buzz/buzz-multi-tenant-relay-architecture-community-isolation)

Explore Buzz's multi-tenant relay architecture and how community isolation works. Learn about Host header resolution, PostgreSQL RLS, and NIP-98 token stamping for secure boundaries.

- Tags: deep-dive
- Published: 2026-07-31

### [How buzz-cli Enables Agent-First Command-Line Interactions in the Buzz Ecosystem](/block/buzz/buzz-cli-tool-agent-first-cli-interactions)

Discover how buzz-cli enables agent-first command-line interactions in the Buzz ecosystem. Interact with relays via Nostr events using a unified protocol, no separate APIs needed.

- Tags: how-to-guide
- Published: 2026-07-31

### [Buzz Git Integration: Authentication and Commit Signing with Nostr](/block/buzz/buzz-git-integration-features-git-sign-nostr-git-credential-nostr)

Explore Buzz Git integration with git-credential-nostr and git-sign-nostr. Securely authenticate and sign commits without passwords or PGP keys on Buzz relays.

- Tags: how-to-guide
- Published: 2026-07-31

### [How Buzz Implements Channel-Based Messaging Using NIP-29 Group Semantics](/block/buzz/buzz-channel-messaging-nip29-group-semantics)

Discover how Buzz implements channel-based messaging using NIP-29 group semantics. Learn about standardized event kinds and cryptographically signed membership for secure access control.

- Tags: internals
- Published: 2026-07-31

### [How Buzz Stores Collaborative Canvases Using KIND_CANVAS 40100](/block/buzz/buzz-canvas-system-kind-canvas-40100-storage)

Discover how Buzz stores collaborative canvases with KIND_CANVAS 40100. Learn about replaceable events, unique d tag identifiers, and shared tag gating for multi-user access.

- Tags: internals
- Published: 2026-07-31

### [How Buzz Implements Rate Limiting and Admission Control in Its Nostr Relay](/block/buzz/buzz-relay-rate-limiting-admission-control)

Discover how Buzz protects its Nostr relay with layered rate limiting using Redis and connection-level admission control. Learn about its fail-closed design.

- Tags: internals
- Published: 2026-07-31

### [Buzz Media Storage Capabilities via Blossom S3 in the buzz-media Crate](/block/buzz/buzz-media-storage-blossom-s3-buzz-media)

Discover Buzz's media storage capabilities using Blossom S3 in the buzz-media crate. Learn about tenant-aware wrappers, streaming uploads, range requests, and metadata isolation.

- Tags: deep-dive
- Published: 2026-07-31

### [How Buzz Implements Hash-Chain Audit Logging in buzz-audit](/block/buzz/buzz-hash-chain-audit-logging-buzz-audit)

Discover how Buzz implements hash-chain audit logging in buzz-audit using secure PostgreSQL advisory locks and SHA-256 hashing for immutable, cryptographically linked audit trails.

- Tags: internals
- Published: 2026-07-31

### [What Is the ACP Agent Harness in buzz-acp? Bridging Nostr Events to AI Agents](/block/buzz/acp-agent-harness-buzz-acp-nostr-ai-agents)

Discover the ACP agent harness in buzz-acp. This Rust process bridges Nostr events to AI agents, allowing AI like Goose or Claude to join Nostr channels as signed participants.

- Tags: deep-dive
- Published: 2026-07-31

### [How Buzz Implements Postgres Full-Text Search for NIP-50: A Technical Deep Dive](/block/buzz/buzz-postgres-full-text-search-nip50)

Learn how Buzz uses Postgres full-text search and the buzz-search crate to implement NIP-50 search with efficient TSVECTOR columns and GIN indexing for community and channel filtering.

- Tags: deep-dive
- Published: 2026-07-31

### [How Buzz Supports NIP-42, NIP-98, and API Token Authentication](/block/buzz/buzz-authentication-methods-nip42-nip98-api-tokens)

Buzz supports NIP-42 WebSocket, NIP-98 HTTP signed event headers, and API tokens for secure authentication. Simplify your Nostr app integrations.

- Tags: how-to-guide
- Published: 2026-07-31

### [How Buzz Implements User Presence Tracking with Redis Pub/Sub](/block/buzz/buzz-presence-tracking-typing-indicators-redis)

Discover how Buzz implements user presence tracking and typing indicators using Redis Pub/Sub. Learn about heartbeats, TTLs, and efficient connection pooling for real-time status updates.

- Tags: deep-dive
- Published: 2026-07-31

### [How the Buzz Workflow Automation System Executes YAML-Defined Workflows](/block/buzz/buzz-workflow-automation-yaml-workflows)

Discover how the Buzz workflow automation system executes YAML. Learn about its four-stage pipeline: parsing validation serialization trigger matching and sequential step execution for robust automations.

- Tags: internals
- Published: 2026-07-31

### [How Buzz Handles Nostr Event Kind Registration and Dispatching in buzz-core](/block/buzz/buzz-event-kind-registration-dispatching-buzz-core)

Discover how Buzz manages Nostr event kind registration and dispatching in buzz-core. Learn about type-safe event handling using compile-time constants and pattern matching.

- Tags: internals
- Published: 2026-07-31

### [How Buzz Implements Agent-to-Human Collaboration Using Nostr](/block/buzz/how-buzz-implements-agent-human-collaboration-nostr)

Discover how Buzz enables agent-to-human collaboration via Nostr. Learn how it converts interactions into ACP JSON-RPC calls for AI agents and back into Nostr events for real-time chat.

- Tags: how-to-guide
- Published: 2026-07-31

### [How to Run Integration Tests Against the Buzz Relay](/block/buzz/what-is-process-for-running-integration-tests-against-buzz-relay)

Learn how to run integration tests against the Buzz relay. Activate Hermit, build binaries, start a live relay, and invoke the test suite with `just test` or `just test-integration`.

- Tags: how-to-guide
- Published: 2026-07-30

### [How Agent Personas Are Defined and Loaded Within buzz-persona: The Complete Technical Guide](/block/buzz/how-are-agent-personas-defined-and-loaded-in-buzz-persona)

Learn how agent personas are defined and loaded in buzz-persona. Discover the `.persona.md` file structure and safe resolution pipeline for ACP runtime.

- Tags: deep-dive
- Published: 2026-07-30

### [How Webhook Workflows Are Triggered from Nostr Events in Buzz](/block/buzz/how-are-webhook-workflows-triggered-from-nostr-events-in-buzz)

Discover how Buzz triggers webhook workflows from Nostr events. Learn how external clients authenticate and execute steps via an async task runner for seamless integrations.

- Tags: how-to-guide
- Published: 2026-07-30

### [How Buzz Implements a Tamper-Evident Hash-Chain Audit Log](/block/buzz/how-does-hash-chain-audit-log-in-buzz-ensure-tamper-evidence)

Discover how Buzz's hash-chain audit log inherently ensures tamper evidence. Learn about cryptographic linking and sequence numbers for secure, verifiable data integrity in the block/buzz repository.

- Tags: internals
- Published: 2026-07-30

### [How Agents Establish Connections via the Agent Communication Protocol (ACP) in Buzz](/block/buzz/how-do-agents-establish-connections-via-agent-communication-protocol-acp)

Discover how agents establish connections using the Agent Communication Protocol ACP in Buzz. Learn the four-phase handshake process for seamless communication and active session management.

- Tags: how-to-guide
- Published: 2026-07-30

### [How Redis Pub/Sub Facilitates Real-Time Fan-Out to Connected Clients in Buzz](/block/buzz/how-does-redis-pubsub-facilitate-real-time-fan-out-to-connected-clients-in-buzz)

Discover how Redis Pub/Sub enables real-time fan-out of Nostr events to thousands of clients in Buzz. Learn about dynamic topics and Tokio broadcast channels for efficient distribution.

- Tags: deep-dive
- Published: 2026-07-30

### [Buzz Event Kind Numbering Scheme: How to Add New Event Types](/block/buzz/what-is-event-kind-numbering-scheme-in-buzz-and-how-to-add-new-kinds)

Learn the Buzz event kind numbering scheme and how to add new event types. Understand event kind ranges for storage, persistence, and relay behavior in block/buzz.

- Tags: how-to-guide
- Published: 2026-07-30

### [How NIP‑29 Group‑Based Channel Scoping Works in Buzz: Architecture and Implementation](/block/buzz/how-does-nip-29-group-based-channel-scoping-work-in-buzz)

Explore NIP-29 group-based channel scoping in Buzz. Learn how immutable h tags and signed membership events cryptographically isolate channels and secure your operations.

- Tags: architecture
- Published: 2026-07-30

### [How Agents Use the ACP Protocol to Interact with Buzz Events: A Technical Guide](/block/buzz/how-buzz-agents-use-acp-protocol-interact-events)

Learn how agents use the ACP protocol with Buzz events for seamless Nostr ecosystem participation. Discover JSON-over-STDIO communication via acp_read and acp_write.

- Tags: how-to-guide
- Published: 2026-07-28

### [How the Buzz Relay Implements Its Rate Limiting Gate: Redis-Backed Admission Control](/block/buzz/buzz-relay-rate-limiting-gate-implementation)

Discover how the Buzz relay implements its rate limiting gate using Redis-backed admission control and atomic Lua scripts for efficient HTTP and WebSocket request management.

- Tags: internals
- Published: 2026-07-28

### [How buzz-dev-mCP Provides Shell and File Tools in Block/Buzz](/block/buzz/buzz-dev-mcp-server-shell-file-tools)

Discover how buzz-dev-mcp, a lightweight MCP server, offers secure shell and file tools via a side-car binary. Learn about its sandboxed access, editing, and search utilities for isolated process management.

- Tags: how-to-guide
- Published: 2026-07-28

### [Hash-Chain Audit Log Implementation in buzz-audit: A Tamper-Evident Deep Dive](/block/buzz/buzz-audit-hash-chain-audit-log-implementation)

Explore the hash-chain audit log implementation in buzz-audit. Learn how this tamper-evident log uses SHA-256 and PostgreSQL to secure your community event data.

- Tags: deep-dive
- Published: 2026-07-28

### [How to Write a Playwright Screenshot Test for the Buzz Desktop App](/block/buzz/how-write-playwright-screenshot-test-buzz-desktop-app)

Learn how to write a Playwright screenshot test for the Buzz desktop app. Integrate a mock bridge, navigate views, and capture screenshots efficiently for robust testing.

- Tags: how-to-guide
- Published: 2026-07-28

### [Architecture of Git Smart HTTP Hosting in Buzz Relay: A Stateless Object-Store Design](/block/buzz/buzz-relay-git-smart-http-hosting-architecture)

Explore Buzz Relay's stateless Git Smart HTTP hosting architecture. Discover how it uses S3-compatible storage for on-demand repos, Postgres for registries, and a layered router for policy enforcement.

- Tags: architecture
- Published: 2026-07-28

### [How Buzz Relay Handles NIP-29 Group-Based Channel Permissions](/block/buzz/buzz-relay-nip-29-group-based-channel-permissions)

Learn how Buzz relay enforces NIP-29 group-based channel permissions. Discover how event signatures are validated and group UUIDs are extracted for scoped operations.

- Tags: deep-dive
- Published: 2026-07-28

### [How to Add a New CLI Subcommand to buzz-cli: The Complete Developer Guide](/block/buzz/add-new-cli-subcommand-buzz-cli-process)

Learn how to add a new CLI subcommand to buzz-cli. Follow this developer guide to extend the Cmd enum, create argument structs, and wire handlers into the async dispatcher.

- Tags: how-to-guide
- Published: 2026-07-28

### [How Buzz Desktop Handles Community Switching Without Page Reload](/block/buzz/buzz-desktop-app-community-switching-no-reload)

Discover how the Buzz desktop app achieves seamless community switching without page reloads. Learn about the unique communityKey and manual singleton reset for clean state isolation.

- Tags: internals
- Published: 2026-07-28

### [How to Run Desktop E2E Tests with the Mock Tauri Bridge in Buzz](/block/buzz/how-run-buzz-desktop-e2e-tests-mock-tauri-bridge)

Learn to run desktop E2E tests in Buzz using the mock Tauri bridge. Emulate native APIs in a browser for efficient testing of file uploads, notifications, and media flows.

- Tags: how-to-guide
- Published: 2026-07-28

### [ACP Harness Architecture in buzz-acp: How Block's AI Agent Bridge Works](/block/buzz/buzz-acp-harness-architecture)

Explore the ACP harness architecture in buzz-acp. Learn how this Rust bridge manages AI agents, JSON-RPC communication, WebSocket connections, and the turn lifecycle with timeouts and crash recovery.

- Tags: architecture
- Published: 2026-07-28

### [How the Buzz Relay Implements NIP-50 Search Filters for Full-Text Event Queries](/block/buzz/buzz-relay-nip-50-search-filters-implementation)

Discover how the Buzz relay uses NIP-50 search filters to power efficient full-text event queries via the buzz-search crate and PostgreSQL.

- Tags: internals
- Published: 2026-07-28

### [How Channel Scoping Works with `h` Tags vs `e` Tags in Buzz](/block/buzz/buzz-channel-scoping-h-tags-vs-e-tags)

Understand channel scoping in Buzz. Learn how h tags declare channel membership while e tags reference events without changing it.

- Tags: deep-dive
- Published: 2026-07-28

### [How the Buzz Media Upload System Works with Blossom/S3 Storage](/block/buzz/buzz-media-upload-system-blossom-s3-storage)

Discover how the Buzz media upload system uses Blossom/S3 storage to process uploads and generate secure SHA-256 URLs for embedding in Nostr events.

- Tags: internals
- Published: 2026-07-28

### [Buzz Workflow Engine Architecture: How It Uses Evalexpr for Conditional Logic](/block/buzz/buzz-workflow-engine-architecture-evalexpr-conditions)

Explore the Buzz workflow engine architecture leveraging Evalexpr for conditional logic. Discover how it safely executes conditions with a HashMapContext, timeouts, and size limits. Learn more about block/buzz.

- Tags: architecture
- Published: 2026-07-28

### [How to Add a New Event Kind to the Buzz Relay: A Complete 10-Step Guide](/block/buzz/how-add-new-event-kind-buzz-relay)

Learn to add a new event kind to the Buzz relay with this 10-step guide. Master constant registration, helper updates, and validation for seamless integration. Get started now!

- Tags: how-to-guide
- Published: 2026-07-28

### [How the buzz-search Crate Implements PostgreSQL Full-Text Search](/block/buzz/buzz-search-crate-postgres-full-text-search-implementation)

Discover how the buzz-search crate leverages PostgreSQL full-text search with websearch_to_tsquery and custom tokenization to offer efficient boolean matching and type-ahead suggestions while ensuring multi-tenant isolation.

- Tags: how-to-guide
- Published: 2026-07-28

### [How Agents Authenticate and Obtain Identity in Buzz: Regular Agents vs Bot Accounts Explained](/block/buzz/how-buzz-agents-authenticate-identity-vs-bot-accounts)

Discover how agents authenticate in Buzz using Nostr NIP-42. Learn the key difference between regular agents and bot accounts regarding private key management.

- Tags: deep-dive
- Published: 2026-07-28

### [Redis Pub/Sub Architecture for Real-Time Fan-Out in Buzz: A Technical Deep Dive](/block/buzz/buzz-redis-pub-sub-architecture-real-time-fan-out)

Explore Buzz's Redis Pub/Sub architecture for real-time fan-out. Learn how Nostr events are pushed to clients via reference-counted subscriptions.

- Tags: deep-dive
- Published: 2026-07-28

### [How the Buzz WebSocket Relay Authenticates Clients Using NIP-42: Complete Protocol Guide](/block/buzz/buzz-websocket-relay-nip-42-client-authentication)

Learn how the Buzz WebSocket relay uses NIP-42 to authenticate clients with cryptographic challenges and signed Nostr events. Understand the complete protocol for secure connections.

- Tags: deep-dive
- Published: 2026-07-28

### [Buzz Event Kind Numbers: Channel Reactions (Kind 7) and Thread Metadata (Kind 39005)](/block/buzz/buzz-event-kind-numbers-channel-metadata-reactions-threads)

Discover Buzz event kind numbers for channel reactions (Kind 7) and thread metadata (Kind 39005). Find these constants centralized in block/buzz crate for easy access.

- Tags: internals
- Published: 2026-07-28

### [How Buzz Handles Multi-Tenant Community Isolation in Shared Postgres and Redis](/block/buzz/how-buzz-handle-multi-tenant-community-isolation-shared-postgres-redis)

Buzz ensures multi-tenant community isolation in shared Postgres and Redis by scoping database rows to community_id and namespacing Redis keys with tenant UUID for complete logical separation.

- Tags: deep-dive
- Published: 2026-07-28

### [How Buzz's NIP-34 Git Hosting Backend Stores Repositories and Serves Git Smart HTTP](/block/buzz/nip-34-git-hosting-backend-usage)

Discover how Buzz's NIP-34 backend stores Git repositories in PostgreSQL and serves Smart HTTP requests by translating them into content-addressed blob fetches.

- Tags: internals
- Published: 2026-07-27

### [How Buzz Enforces Per-Pubkey Rate Limiting in Its Authentication Module](/block/buzz/buzz-auth-rate-limiting-per-pubkey)

Discover how Buzz enforces per-pubkey rate limiting in its authentication module using Redis and Lua scripts. Learn about its layered architecture for robust security.

- Tags: how-to-guide
- Published: 2026-07-27

### [How NIP-29 Group Chats (Channels) Use h-Tags vs e-Tags in Buzz](/block/buzz/nip-29-group-chats-h-tags-e-tags-buzz)

Discover how Buzz uses h-tags and e-tags for NIP-29 group chats. Learn how thread-scoped events and replies reference channel UUIDs and root events for indirect membership.

- Tags: deep-dive
- Published: 2026-07-27

### [Module-Level Singletons That Require Explicit Resetting on Buzz Community Changes](/block/buzz/buzz-module-singletons-reset-community-change)

Discover which module-level singletons require explicit resetting on Buzz community changes to prevent data leakage and privacy violations. Learn more now.

- Tags: internals
- Published: 2026-07-27

### [How to Implement Zoom Functionality Using rem Units in a Tauri 2 Desktop App](/block/buzz/tauri-2-desktop-app-zoom-rem-units)

Learn how the Buzz desktop app implements zoom using rem units in Tauri 2. Scale text proportionally without affecting layout coordinates by adjusting root font size.

- Tags: how-to-guide
- Published: 2026-07-27

### [How the Hash-Chain Audit Log in Buzz-Audit Provides Tamper-Evident Logging](/block/buzz/buzz-audit-hash-chain-tamper-evident-logging)

Discover how Buzz Audits hash-chain log ensures tamper-evident logging. Learn how cryptographic linking and sequence numbers prevent record alteration for ultimate data integrity.

- Tags: internals
- Published: 2026-07-27

### [How Full-Text Search Integration Works with Postgres FTS in Buzz-Search](/block/buzz/full-text-search-postgres-fts-buzz-search)

Discover how Buzz Search integrates Postgres FTS for efficient community-scoped full-text search. Learn about TSVECTOR, TSQUERY, GIN indexes, and eliminate external services.

- Tags: deep-dive
- Published: 2026-07-27

### [How the Postgres Event Store (buzz-db) Persists and Indexes Nostr Events](/block/buzz/postgres-event-store-persistence-indexing-buzz)

Discover how buzz-db persists and indexes Nostr events using atomic upserts, metadata extraction, and specialized GIN indexes for high-throughput relay queries in Postgres.

- Tags: internals
- Published: 2026-07-27

### [How buzz-acp Bridges Nostr Events to AI Agent Protocols: A Technical Deep Dive](/block/buzz/acp-harness-nostr-ai-agent-protocols)

Discover how buzz-acp seamlessly bridges Nostr events to AI agent protocols. This technical deep dive explains the bidirectional translation process for enhanced agent communication.

- Tags: deep-dive
- Published: 2026-07-27

### [Understanding the buzz-cli JSON Interface for Programmatic Agent Integration](/block/buzz/buzz-cli-json-interface-agent-integration)

Integrate agents programmatically using the buzz-cli JSON interface. This guide explains structured output, bidirectional JSON payloads, and error reporting for seamless integration.

- Tags: api-reference
- Published: 2026-07-27

### [How KIND_WORKFLOW Events Are Processed in Buzz: The Complete Lifecycle Guide](/block/buzz/buzz-workflow-event-processing-triggers)

Understand how KIND_WORKFLOW events are processed in Buzz. Learn about their lifecycle, triggers, and the three-stage pipeline from ingestion to async execution.

- Tags: deep-dive
- Published: 2026-07-27

### [How Redis Pub/Sub Enables Real-Time Event Fan-Out Across Connections in Buzz](/block/buzz/redis-pub-sub-event-fan-out-buzz)

Discover how Buzz uses Redis Pub/Sub for real-time event fan-out. Instantly broadcast Nostr events to thousands of WebSocket clients, bypassing database bottlenecks and dynamically managing subscriptions.

- Tags: how-to-guide
- Published: 2026-07-27

### [NIP-42 WebSocket Authentication Implementation in the Buzz Relay](/block/buzz/nip-42-authentication-buzz-websocket)

Learn how Buzz relay implements NIP-42 WebSocket authentication via crypto challenge response. Discover how clients sign kind 22242 events to secure Nostr messages.

- Tags: how-to-guide
- Published: 2026-07-27

### [How Buzz's Multi-Tenant Relay Architecture Handles Community Scoping](/block/buzz/buzz-multi-tenant-relay-community-scoping)

Discover how Buzz's multi-tenant relay architecture uses Host headers and TenantContext to enforce strict community scoping and tenant isolation at compile time for the block/buzz repository.

- Tags: architecture
- Published: 2026-07-27

### [How to Add a New Custom Nostr Event Kind in Buzz and Implement Its Handler](/block/buzz/how-to-add-custom-nostr-event-kind-buzz)

Learn to add a custom Nostr event kind in Buzz. Declare constants, register metrics and predicates, and implement handlers for side effects in your relay.

- Tags: how-to-guide
- Published: 2026-07-27

### [How the Buzz Relay Manages Concurrent Connections: 7 Production-Ready Mechanisms](/block/buzz/how-does-the-buzz-relay-manage-concurrent-connections-effectively)

Discover how the Buzz relay manages thousands of concurrent Nostr WebSocket connections using Tokio semaphores, back-pressure, control channels, and registries. Learn production-ready techniques for stability.

- Tags: internals
- Published: 2026-07-26

### [Buzz NIP-34 Git Integration: Technical Implementation and Architecture](/block/buzz/what-is-the-buzz-implementation-of-nip-34-git-integration)

Explore Buzz's NIP-34 Git integration. See how Git repos become Nostr entities via replaceable event kinds, SDK builders, and a Smart-HTTP layer resolving on-chain NIP-34 state.

- Tags: architecture
- Published: 2026-07-26

### [How Buzz Handles Parameterized Replaceable Nostr Events: NIP-33 Implementation Guide](/block/buzz/how-does-buzz-handle-parameterized-replaceable-nostr-events)

Learn how Buzz handles parameterized replaceable Nostr events using PostgreSQL locks, soft-deletes, and deterministic logic to prevent race conditions and stale writes. Dive into NIP-33 implementation.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Buzz Handles Replaceable Nostr Events: NIP-16 and NIP-33 Implementation](/block/buzz/how-does-buzz-handle-replaceable-nostr-events)

Learn how Buzz implements NIP-16 and NIP-33 to handle replaceable Nostr events efficiently. Discover atomic operations, advisory locks, and deterministic logic to prevent race conditions.

- Tags: deep-dive
- Published: 2026-07-26

### [How to Interact with the Buzz Relay Using buzz-cli: A Developer's Guide](/block/buzz/how-can-developers-interact-with-the-buzz-relay-using-buzz-cli)

Developers interact with the Buzz relay using buzz-cli by configuring environment variables and submitting Nostr events over HTTP with NIP-98 authentication. Learn how to get started.

- Tags: how-to-guide
- Published: 2026-07-26

### [Maximum Subscription Limits in the Buzz Relay: A Technical Deep Dive](/block/buzz/what-are-the-maximum-subscription-limits-in-the-buzz-relay)

Discover maximum subscription limits in the Buzz relay. Learn about concurrent subscriptions, historical event query caps, and WebSocket frame size limits for effective integration.

- Tags: deep-dive
- Published: 2026-07-26

### [Maximum Frame Size Limits in the Buzz Relay: Configuration and Enforcement](/block/buzz/what-are-the-maximum-frame-size-limits-in-the-buzz-relay)

Discover the maximum frame size limits in the Buzz relay. Learn how to configure and enforce the 262KB cap using max_frame_bytes for secure WebSocket connections.

- Tags: deep-dive
- Published: 2026-07-26

### [How Buzz Implements Rate Limiting for Its Relay: Redis and Sliding Window Architecture](/block/buzz/how-does-buzz-implement-rate-limiting-for-its-relay)

Buzz implements relay rate limiting with Redis fixed-window and in-process sliding-window counters. Discover how this dual-layer architecture ensures efficient control for media uploads and observer frames.

- Tags: how-to-guide
- Published: 2026-07-26

### [Buzz Subscription Registry: How Sub-Linear Fan-Out Works in the Nostr Relay](/block/buzz/what-is-the-buzz-subscription-registry-and-how-does-fan-out-work)

Understand the Buzz subscription registry and sub-linear fan-out in Nostr relays. Learn how DashMap indexes enable O(1) lookups and efficient event distribution.

- Tags: deep-dive
- Published: 2026-07-26

### [How Buzz Implements Channel and DM Scoping with "h" Tags](/block/buzz/how-does-buzz-implement-channel-and-dm-scoping-with-h-tags)

Learn how Buzz uses Nostr h tags to scope public channels and private DMs. Discover how channel UUIDs in events ensure correct relay filtering for isolated conversations.

- Tags: internals
- Published: 2026-07-26

### [How Buzz Handles Media Downloads Using Blossom and S3: A Complete Technical Guide](/block/buzz/how-does-buzz-handle-media-downloads-using-blossom-s3)

Learn how Buzz streams media downloads from S3 using Blossom. This guide details efficient, memory-free downloads with HTTP range requests and S3 error mapping.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Buzz Handles Media Uploads Using Blossom/S3: Content-Addressed Storage in Rust](/block/buzz/how-does-buzz-handle-media-uploads-using-blossom-s3)

Learn how Buzz handles media uploads with Blossom/S3. Discover its content-addressed storage in Rust, featuring authentication, rate limiting, and concurrency controls for secure and efficient binary blob streaming to S3.

- Tags: how-to-guide
- Published: 2026-07-26

### [What Is the ACP Harness in Buzz? Connecting AI Agents to Nostr Events](/block/buzz/what-is-the-acp-harness-in-buzz-and-its-connection-to-ai-agents)

Discover the ACP harness in Buzz GitHub repository. Learn how it connects AI agents to Nostr events for seamless communication and response exchange.

- Tags: deep-dive
- Published: 2026-07-26

### [How Buzz's Audit Log Tracks Events Using Hash Chains](/block/buzz/how-does-buzzs-audit-log-track-events-using-hash-chains)

Discover how Buzz's audit log uses SHA-256 hash chains to implement a secure, tamper-evident event tracking system in the block buzz repository.

- Tags: internals
- Published: 2026-07-26

### [How Buzz Implements Full-Text Search with PostgreSQL: Native tsvector and GIN Index Architecture](/block/buzz/how-is-full-text-search-implemented-in-buzz-using-postgres)

Buzz implements full-text search in PostgreSQL using native tsvector and GIN index architecture. Discover how Buzz efficiently queries this setup.

- Tags: architecture
- Published: 2026-07-26

### [How Buzz Uses Redis Pub/Sub for Real-Time Typing Indicators](/block/buzz/how-does-buzz-use-redis-pub-sub-for-typing-indicators)

Learn how Buzz leverages Redis pub/sub for real-time typing indicators. Discover millisecond-latency broadcasts without database persistence for instant user feedback.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Buzz Uses Redis Pub/Sub for Presence Indicators: TTL-Based State Management](/block/buzz/how-does-buzz-use-redis-pub-sub-for-presence-indicators)

Learn how Buzz uses Redis TTL keys for real-time presence indicators. Discover efficient state management without traditional Pub/Sub channels.

- Tags: deep-dive
- Published: 2026-07-26

### [How the Buzz Workflow Engine Processes YAML Automation Files](/block/buzz/how-does-the-buzz-workflow-engine-process-yaml-automation-files)

Learn how the Buzz workflow engine processes YAML automation files via a four-stage pipeline including parsing validation canonicalisation trigger matching and sandboxed execution. Optimize your workflows today.

- Tags: internals
- Published: 2026-07-26

### [Custom Event Kinds Defined and Used by Buzz: Complete Protocol Reference](/block/buzz/what-are-the-custom-event-kinds-defined-and-used-by-buzz)

Discover Buzz's custom event kinds extending Nostr. Explore a comprehensive reference for ephemeral presence, agent personas, workflow states, and moderation commands. Optimize your Nostr development.

- Tags: api-reference
- Published: 2026-07-26

### [How Buzz Achieves Multi-Tenant Community Isolation](/block/buzz/how-does-buzz-achieve-multi-tenant-community-isolation)

Discover how Buzz ensures multi-tenant community isolation with mandatory tenant keys across its stack, securing your data from database to runtime.

- Tags: architecture
- Published: 2026-07-26

### [How NIP‑42 Authentication Is Implemented in the Buzz Relay](/block/buzz/how-is-nip-42-authentication-implemented-in-the-buzz-relay)

Discover how Buzz relay implements NIP-42 authentication. Learn about the challenge-response flow, event validation, and connection state transitions to secure your relay.

- Tags: internals
- Published: 2026-07-26

### [WebSocket Connection Lifecycle in Buzz: NIP-42 Authentication Flow Explained](/block/buzz/what-is-the-websocket-connection-lifecycle-in-buzz)

Explore the WebSocket connection lifecycle in Buzz, detailing seven stages from TCP establishment to graceful shutdown. Understand NIP-42 authentication and strict timeouts for reliable connections.

- Tags: deep-dive
- Published: 2026-07-26

### [How Buzz Nostr Relay Handles Event Persistence: PostgreSQL Storage, TTL Management, and Query Filtering](/block/buzz/how-does-buzz-nostr-relay-handle-event-persistence)

Discover how Buzz Nostr relay achieves efficient event persistence using PostgreSQL storage, TTL management, and advanced query filtering. Learn about its automated retention policies.

- Tags: internals
- Published: 2026-07-26

### [E2E Test Client Implementation Pattern in Buzz: Architecture and Usage](/block/buzz/what-is-e2e-test-client-implementation-pattern-buzz)

Discover the E2E test client implementation pattern in Buzz. Learn how Buzz's `buzz-test-client` crate simplifies Nostr protocol details for deterministic integration testing.

- Tags: architecture
- Published: 2026-07-24

### [NIP-34 Implementation for Git Hosting Within Buzz: Technical Architecture and Event Flow](/block/buzz/what-is-nip-34-implementation-git-hosting)

Explore the NIP-34 implementation for Git hosting in Buzz. Discover how Git operations map to Nostr events and enable full-stack Git functionality with standard client compatibility.

- Tags: architecture
- Published: 2026-07-24

### [How the Buzz Desktop App Switches Communities Without a Full Page Reload](/block/buzz/how-does-buzz-desktop-app-implement-community-switching-no-reload)

Discover how the Buzz desktop app switches communities seamlessly using Reacts key-based remount. Learn to recreate components without a full page reload for a better user experience.

- Tags: internals
- Published: 2026-07-24