bazaar extension and passes the
cataloging rules, Rail402 catalogs the paid HTTP endpoint or MCP tool, and buyers can
find it with filters or natural-language search.
It is built on the unmodified @x402/stellar 2.27.0 scheme
and speaks x402 version 2 on the wire, so stock x402 clients and servers work with it without changes.
The code is Apache-2.0.
What it does
Facilitator
/supported, /verify and /settle for the exact scheme on stellar:testnet. It pays the network fee
and is never the source of the payment. stellar:pubnet can be configured but has not been exercised end
to end.Bazaar catalog
Resources are cataloged only after a payment to them settles, and each listing is bound to the
payTo
that received the payment.Discovery API
GET /discovery/resources with type, payTo, network and extension filters, stable offset paging and a
public version history for each listing.Search
GET /discovery/search: BM25F and local embeddings fused with RRF, hard filters, constraints read from
the query text, and signed cursors.Where to start
Pay a Rail402 seller
A stock
@x402/fetch buyer on the Stellar testnet.Sell through Rail402
A stock
@x402/express seller that uses the hosted testnet facilitator and its Bazaar.Run your own
Build the container image and run it with Postgres.
Install from source
Clone, install and verify the repository.