Nostr-native swap coordination

Open rails for agents, escrow, and Bitcoin-fiat swaps.

Pontmore gives swap operators and clients a shared public language for discovering agents, declaring escrow assumptions, tracking swap state, and resolving disputes without making an app account the root of identity.

public event rail

Nostr

npub

agent

d tag

01

discover agent

02

inspect escrow

03

request swap

04

append transitions

05

resolve outcome

private lane

Gift Wrap payloads for invoices, payout details, and sensitive evidence

Protocol shape

Small core, explicit boundaries.

Pontmore separates public coordination from private execution data. Discovery, escrow compatibility, swap state, and dispute markers are visible and portable. Raw payment instructions and sensitive proof move through a companion private message lane.

PIP-00

Agent identity

Agents publish public capability records from a Nostr pubkey, including markets, payment channels, limits, pricing policy, relays, and default escrow references.

PIP-01

Escrow declaration

Counterparties can inspect the escrow mechanism, supported settlement networks, funding rules, release rules, and reference format before a swap starts.

PIP-02

Swap lifecycle

A swap is an immutable request plus append-only transition, evidence, dispute, note, and snapshot events. Public history stays authoritative.

PIP-03

Dispute boundary

Disputes are visible at the protocol layer while sensitive invoices, bank details, screenshots, and internal policy payloads stay private by default.

Implementation baseline

Publish capabilities once. Let compatible clients find them.

Agents declare their supported fiat currencies, payment channels, settlement networks, regions, limits, and escrow references.

Clients can resolve the same Nostr addressable events from relays instead of integrating every operator one by one.

Where to begin

Read PIP-00 through PIP-03, then test against relays.

The current protocol core covers agent definitions, escrow descriptors, swap lifecycle events, and dispute policy. The companion proof of concept demonstrates publishing and discovering Pontmore events on Nostr relays.

30360

Agent definition

30361

Escrow descriptor

7300

Swap request

7301

Transition

7302

Evidence

30362

Snapshot

Built on Pontmore

Projects using the protocol.

This directory is backed by a simple JSON file. Add your Pontmore project by opening a pull request that updates projects.json.

Edit projects.json

Pontmore Next.js POC

A proof-of-concept web app for publishing and discovering Pontmore agent, escrow, and swap lifecycle events on Nostr relays.

Minmo

An open, Nostr-native network for Bitcoin access where agents publish capabilities and coordinate swaps through public event logs.

Rollpot

A two-player dice wager client backed by a Pontmore standalone escrow.

Pontmore Escrow Client

A proof-of-concept web client for a standalone escrow descriptor.

Pontpay

A proof-of-concept web app for publishing and discovering Pontmore agent, standalone escrow, and swap lifecycle events on Nostr relays.