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.

30360

Agent definition

30361

Escrow descriptor

7300

Swap request

7301

Transition

7302

Evidence

30362

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.