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.
Agent identity
Agents publish public capability records from a Nostr pubkey, including markets, payment channels, limits, pricing policy, relays, and default escrow references.
Escrow declaration
Counterparties can inspect the escrow mechanism, supported settlement networks, funding rules, release rules, and reference format before a swap starts.
Swap lifecycle
A swap is an immutable request plus append-only transition, evidence, dispute, note, and snapshot events. Public history stays authoritative.
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.
Agent definition
Escrow descriptor
Swap request
Transition
Evidence
Snapshot
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.