OPEN SOURCE · APACHE-2.0 · IN DEVELOPMENT

The auctioneer for the machine economy.

walras is an x402 facilitator and Bazaar for Stellar. Agents discover paid APIs, read their terms, and pay per request — no accounts, no API keys. Settled on-chain in seconds, for fractions of a cent.

P Q
walras · settlement terminal
01 Mechanism

HTTP 402, finally in use.

1
Request.

An agent calls a paid endpoint. The server answers 402 with machine-readable terms: price, asset, recipient.

2
Authorize.

The agent signs a Soroban auth entry approving exactly that payment — that call, that amount, that recipient — valid for about a minute.

3
Settle.

walras verifies the signature, sponsors the network fee, submits on-chain. The resource comes back with a receipt.

No account. No API key. No card on file. The request is the relationship.

02 Market

Paid endpoints exist. Agents can't find them.

Stellar already settles x402 payments for a fraction of a cent. What it lacks is a marketplace: a place where an agent with a job and a budget can find a service it has never seen, read its terms, and pay it — without a developer wiring the integration first. walras is that layer.

Facilitator
Verify. Settle. Never custody.

walras submits your signed authorization and pays the network fee itself. Funds move from buyer to seller — never through walras. Any SEP-41 asset; USDC by default.

Bazaar
Listings earned, not registered.

A service is cataloged automatically the first time it's paid. No signup form, no spam directory: forged metadata is dropped at the trust boundary, and nobody can overwrite another seller's listing.

Agent-native
Two MCP tools. Zero integration.

search_resources finds services in natural language; paid_call runs the 402 → sign → retry loop. Every rejection returns a machine-readable reason an agent can act on.

Self-hostable
Fork it. Run it. It's yours.

Apache-2.0, no strong copyleft in the dependency tree. pnpm install && pnpm build, then one node command makes you a facilitator. Listings interoperate with the wider x402 Bazaar ecosystem — no walled garden.

03 Interface

From docs to a paid, discoverable endpoint in under an hour.

app.use(paymentMiddleware({ facilitator: "http://127.0.0.1:4021" }));
app.get("/quote",
priced("$0.001", bazaarResourceServerExtension({
description: "Mid-market FX quotes",
params: { pair: "Base/quote pair, e.g. XLM/USDC" },
})),
handler
);
// listed in the Bazaar on first settlement — nothing else to do
Snippets abbreviated — the repo README is canonical.
04 Ledger
Settlement fee, measured on testnet
~5 s
Finality
USDC
First-class via the Stellar Asset Contract
0 XLM
In fees, when settlement is fee-bumped
05 Operations

Built in the open.

Every claim on this page maps to a transcript, a transaction hash, or a fact file in the repository — docs/FACTS.md and docs/EVIDENCE.md. Conformance is tested by pointing unmodified stock x402 clients at walras, on the reasoning that a facilitator that needs a special client isn't one.

Now — testnet
exact scheme
automatic cataloging
catalog browsing and baseline search
conformance against stock clients
Next
natural-language ranking with public evals
the upto metered scheme, specified and contributed upstream
MCP discovery server
Then
third-party security audit → mainnet
Star on GitHub Open the ledger Read the docs