application public internal Verified 2026-04-28

TopoloP2P

Cross-organization capability network for agent-mediated business actions, approvals, immutable micro-ledgering, and TopoloPay-managed settlement.

Documentation Map

What It Is

Cross-organization capability network for agent-mediated business actions, approvals, immutable micro-ledgering, and TopoloPay-managed settlement.

Generated first-party Topolo platform application scaffold for Topolo.

Audience: business Tenancy: organization Portfolio: platform

This scaffold includes CloudControl metadata, TopoloDocs system coverage, and a Topolo app conformance workflow.

Architecture

Owners: platform, commerce-platform, ai-platform

Source repos: PlatformApplications/TopoloP2P, PlatformApplications/TopoloDocs

Dependencies: topolo-auth, topolo-developers, topolo-agent, topolo-pay, topolo-notify, topolo-one, applications-packages

Repo shape

  • PlatformApplications/TopoloP2P/README.md
  • PlatformApplications/TopoloP2P/index.html
  • PlatformApplications/TopoloP2P/migrations/
  • PlatformApplications/TopoloP2P/package-lock.json
  • PlatformApplications/TopoloP2P/package.json
  • PlatformApplications/TopoloP2P/src/
  • PlatformApplications/TopoloP2P/topolo.cloudcontrol.json
  • PlatformApplications/TopoloP2P/tsconfig.json
  • PlatformApplications/TopoloP2P/vite.config.ts
  • PlatformApplications/TopoloP2P/wrangler.toml
  • PlatformApplications/TopoloDocs/astro.config.mjs
  • PlatformApplications/TopoloDocs/functions/
  • PlatformApplications/TopoloDocs/package-lock.json
  • PlatformApplications/TopoloDocs/package.json
  • PlatformApplications/TopoloDocs/public/
  • PlatformApplications/TopoloDocs/scripts/
  • PlatformApplications/TopoloDocs/src/
  • PlatformApplications/TopoloDocs/templates/
  • PlatformApplications/TopoloDocs/topolo.cloudcontrol.json
  • PlatformApplications/TopoloDocs/tsconfig.json

Runtime Surfaces

Hosts:

https://p2p.topolo.app
topolo-p2p

Config: PlatformApplications/TopoloP2P/wrangler.toml

Main: src/worker.ts

Routes: p2p.topolo.app

API Reference

Coverage: curated

Source: PlatformApplications/TopoloDocs/src/content/internal/apps/topolo-p2p.mdx

Source exists in repo: yes

TopoloP2P owns the cross-organization action rail, connection policy, immutable value ledger, holds, settlement batches, and audit state. Capability publishing remains in Topolo Developers, identity and grants remain in Auth, agent execution enters through Topolo Agent, Stripe settlement is submitted to TopoloPay, and human approvals surface in TopoloOne Actions.

App API page: /reference/apps/topolo-p2p

This system currently relies on a curated or README-derived contract surface instead of a source-controlled OpenAPI spec.

Auth and Permissions

Depends on Topolo Auth: yes

Service IDs:

srv_topolo_p2p

API key scopes

actions.invoke

Invoke permitted cross-organization TopoloP2P actions

Resource pattern: none

actions.request

Request TopoloP2P actions

Resource pattern: none

actions.respond

Respond to TopoloP2P actions

Resource pattern: none

capabilities.publish

Publish approved capabilities into TopoloP2P

Resource pattern: none

connections.write

Create or manage TopoloP2P connections

Resource pattern: none

directory.read

Read public TopoloP2P directory capabilities

Resource pattern: none

ledger.read

Read TopoloP2P ledger entries

Resource pattern: none

policy.manage

Manage TopoloP2P approval and spend policies

Resource pattern: none

policy.read

Read TopoloP2P policies

Resource pattern: none

policy.write

Write TopoloP2P policies

Resource pattern: none

settlements.approve

Approve TopoloP2P settlement creation

Resource pattern: none

settlements.write

Create TopoloP2P settlement batches

Resource pattern: none

Service permissions

actions:invoke, actions:request, actions:respond, capabilities:publish, connections:write, directory:read, ledger:read, policy:manage, policy:read, policy:write, settlements:approve, settlements:write

Data Ownership

d1

Binding: DB

Target: 9f9c6157-f816-4c46-9f26-84aadb76ce4f

Environment: default

Source: PlatformApplications/TopoloP2P/wrangler.toml

Queues / Cron / Workflows

Queue bindings:

No queue bindings were detected.

Cron triggers

No cron triggers were detected.

Workflow signals

No explicit queue/workflow script or cron signal was discovered.

Environment Variables and Bindings

Environment variables:

AUTH_BASE_URL SERVICE_ID

All wrangler bindings

  • DB (d1) -> 9f9c6157-f816-4c46-9f26-84aadb76ce4f

Deployments

Deployment environments: default only or not declared

Routes: p2p.topolo.app

Observability enabled: yes

Wrangler surfaces

  • PlatformApplications/TopoloP2P/wrangler.toml -> topolo-p2p (assets dist)

Build and deploy commands

  • build — PlatformApplications/TopoloP2P/package.json :: vite build
  • preview — PlatformApplications/TopoloP2P/package.json :: vite preview --host 0.0.0.0
  • deploy — PlatformApplications/TopoloP2P/package.json :: npm run build && wrangler deploy
  • build — PlatformApplications/TopoloDocs/package.json :: astro build && node ./scripts/write-manifest.mjs && node ./scripts/write-security-assurance-report.mjs
  • build:production — PlatformApplications/TopoloDocs/package.json :: npm run security-gate:production && npm run build
  • build:publication — PlatformApplications/TopoloDocs/package.json :: npm run security-gate:publication && npm run build
  • deploy — PlatformApplications/TopoloDocs/package.json :: npm run build && node ./scripts/deploy-pages.mjs
  • deploy:gated — PlatformApplications/TopoloDocs/package.json :: npm run build:production && node ./scripts/deploy-pages.mjs
  • preview — PlatformApplications/TopoloDocs/package.json :: astro preview

Failure Modes

No default failure-mode heuristics are currently flagged for this system.

Debugging Runbooks

Start with these entrypoints:

  • PlatformApplications/TopoloP2P/wrangler.toml
  • PlatformApplications/TopoloDocs/src/content/internal/apps/topolo-p2p.mdx
  • PlatformApplications/TopoloP2P/README.md
  • PlatformApplications/TopoloP2P/package.json
  • PlatformApplications/TopoloDocs/package.json

Change Log / Verification

Lifecycle: internal

Last verified: 2026-04-28

Any code change to this system is expected to update the canonical docs in PlatformApplications/TopoloDocs and refresh the verification date.