TopoloP2P

Documentation Map

• Application hub
• Application API surface
• Machine system JSON
• Machine application JSON
• applications/topolo-p2p

What It Is

Cross-organization capability network for human and agent 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.

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:

API key scopes

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

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 :: env VITE_TOPOLO_AUTH_URL=https://auth.topolo.app VITE_TOPOLO_SERVICE_ID=srv_topolo_p2p vite build
• build:staging — PlatformApplications/TopoloP2P/package.json :: env VITE_TOPOLO_AUTH_URL=https://auth.stg.topolo.us VITE_TOPOLO_SERVICE_ID=srv_topolo_p2p vite build
• preview — PlatformApplications/TopoloP2P/package.json :: vite preview --host 0.0.0.0
• deploy — PlatformApplications/TopoloP2P/package.json :: npm run build && wrangler deploy
• deploy:staging — PlatformApplications/TopoloP2P/package.json :: npm run build:staging && env -u CLOUDFLARE_API_TOKEN CLOUDFLARE_ACCOUNT_ID=4f4e1c69a3830946f9fea7b1eb7531ac wrangler deploy --config wrangler.staging.toml
• 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:staging — PlatformApplications/TopoloDocs/package.json :: npm run build && DOCS_DEPLOY_ENVIRONMENT=staging 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-29

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