TopoloP2P

What It Is

TopoloP2P is the Topolo network layer for organizations that want their people and agents to transact with other organizations safely. It turns a public directory of capabilities into a governed action rail with policy checks, approvals, ledgering, and payment settlement.

Architecture

Organizations publish capabilities through Topolo Developers. Other organizations discover those capabilities through TopoloOne and request work through TopoloP2P. Topolo Auth verifies the human or agent employee making the request, TopoloP2P applies org policy, TopoloOne handles approvals, and TopoloPay executes payment settlement when value needs to move.

Runtime Surfaces

The planned production host is https://p2p.topolo.app. Public discovery is expected to appear through TopoloOne at https://topolo.io/directory.

API Reference

The public API is not generally available yet. The internal route contract is documented in /internal/platform/p2p-protocol.

Auth and Permissions

TopoloP2P uses Topolo Auth for organization identity, human employee identity, agent employee identity, grants, scopes, and approval policy. Agents can initiate requests, but organization policy decides whether the request is accepted automatically, needs human approval, or is rejected.

Data Ownership

TopoloP2P owns cross-organization action requests, policy decisions, immutable ledger entries, settlement batches, and audit events. TopoloPay owns Stripe-backed settlement execution. Topolo Developers owns the source capability listings.

Deployments

TopoloP2P will deploy as a Cloudflare-backed first-party application. The canonical deployment metadata lives in the TopoloP2P system registry and CloudControl manifest.

Failure Modes

• a paid action executes without the organization’s configured approval policy
• an agent bypasses P2P and calls another organization’s app directly
• settlement state is inferred from P2P ledger state instead of TopoloPay payment state

Debugging

Start from the P2P request id. For money movement, inspect TopoloPay settlement state before debugging Stripe.

Change Log / Verification

• 2026-04-28 — Initial public P2P overview added for the planned cross-organization action and settlement network.