Concepts

Learn about Bondy, what is it, what problems does it solve, how it works and how it compares with the alternatives. Explore Bondy's key features and architecture.

WAMP

The protocol most components use to talk to Bondy Connect: routed RPC and Publish/Subscribe over one session.

WAMP Overview

Every WAMP concept page, in reading order.

What is WAMP?

The protocol in one page: what it gives you and what it replaces.

Introduction

Roles, peers and the router, and how a session is established.

Communication Patterns

The two patterns, RPC and Pub/Sub, that together cover request-response and event distribution.

Routed RPC

The Caller/Callee request-response pattern: registering, calling and routing a procedure.

Publish/Subscribe

The Publisher/Subscriber event pattern: topics, subscriptions and publications.

Connections and Sessions

What a WAMP session is and how it relates to transports, realms and authentication.

Security

How a session authenticates and what it is then authorized to do.

Naming

Designing procedure and topic URIs, beyond the bare syntax rules.

Beyond the Basics

What the advanced profile adds once the two patterns are working.

Advanced RPC

Progressive results, call cancellation, shared registrations and invocation policies.

Advanced Pub/Sub

Pattern-based subscriptions, event retention and subscriber allow/deny lists.

The Bondy Connect SDK

How Bondy's Erlang/Elixir client is built: a supervised connection, one API across transports, reconnect and replay, isolated handlers, and errors that say whether to retry.

Realms & Security

Once RPC and Pub/Sub are working, the next thing to understand: the domain your sessions attach to, and how they authenticate.

Realms

Realms are authentication, authorization, routing and administrative domains that act as namespaces.

Same Sign-on

Do you need to provide users access to multiple realms? Learn about same sign-on realms.

Single Sign-on

Learn how to enable Single Sign-on on multiple realms.

OIDC Authentication

Learn how to authenticate users via external Identity Providers using OpenID Connect.

Listeners & Services

Services you enable on a Bondy node.

WAMP HTTP Transports (Longpoll & SSE)

Learn how to use HTTP long-polling and Server-Sent Events transports for WAMP sessions.

MCP Gateway

Expose a realm's procedures and topics to AI agents as MCP tools and resources.

HTTP/REST API Gateway

Route incoming HTTP/REST requests to WAMP procedures or external APIs using declarative JSON specifications.

HTTP Connector

Bridge WAMP RPC calls to upstream HTTP/REST services with automatic auth, retries, and error mapping.

Broker Bridge

Re-publish WAMP events to Kafka, AWS SNS, Mailgun, or SendGrid.

Mail

Outbound email through operator-declared relays, kept off the routing path.

Scaling & Availability

Concepts for once you're running Bondy Connect for real: clustering, edge deployments, and cross-node routing.

Clustering

How Bondy Connect forms a cluster.

Registry Routing (RIB)

How Bondy Connect scales cross-node call and event routing without replicating every registration to every node.

Bondy Edge (Bridge Relay)

Link one Bondy Connect node, as a client, to a remote router — sharing a subset of a realm without joining its cluster.

Convergence

What "converged" means precisely, how a replica catches up, and how Bondy Connect detects and repairs a replica that is genuinely behind.

Per-Origin Prefix Closure

How Bondy Connect guarantees each node applies every origin's operations as an unbroken prefix, and repairs truncated history on rejoin.

Data & Observability

What a node does with data it no longer needs, and what it reports about itself while it runs.

Node Lifecycle and Durability

What a node does from boot to shutdown, what "ready" means, and why an acknowledged write survives a crash.

Deletion and Reclamation

How Bondy safely reclaims space for deleted replicated data.

Telemetry

Metrics and W3C distributed tracing: propagation, span seats, minting and OTLP export.

Alarms

Conditions that are true now, a verified catalogue, and the runbook that says what may be done about each.

Background

Optional reading: the reasoning and terminology behind Bondy and WAMP. Not required to build your first client.

Why Bondy

Learn about the need for a unified application networking platform for distributed application development.

What is Bondy

A high-level description of Bondy, its key features and the key benefits it delivers.

What is an Application Network

Learn about application networks, their characteristics and benefits, and how Bondy is implementing them.

How does Bondy work

A high-level description that explains how Bondy works.

How is Bondy different

Learn about Bondy's unique set of features and how it compares to alternative solutions.

Features

Dive into a more detailed description of Bondy's features.

Architecture

Dive into a description of Bondy's architecture and the rationale behind its characteristics.