Skip to content

docs(conformance): add Nevermined payment example catalog - #86

Open
aaitor wants to merge 1 commit into
ards-project:mainfrom
aaitor:add-nevermined-payment-example
Open

docs(conformance): add Nevermined payment example catalog#86
aaitor wants to merge 1 commit into
ards-project:mainfrom
aaitor:add-nevermined-payment-example

Conversation

@aaitor

@aaitor aaitor commented Aug 31, 2026

Copy link
Copy Markdown

Why this matters

Payment / monetization signaling on ARD entries is an open question (#20). This adds a small, worked, conformant example so the discussion has something concrete to point at: how a publisher can carry pay-per-call terms on an entry as additive JSON-LD extension terms (§3.4), keeping them filterable (§5.3.1) with no change to the ARD entry model or conformance.

What this adds

conformance/examples/nevermined/nevermined-catalog.json — 3 curated entries:

  • Legal Document Analyzer — x402 pay-per-call, USDC on Base (eip155:8453), with a pre-construct accepts hint and a schema:Offer price mirror.
  • Financial Report Summarizer — card rail, settled off-chain (stripe), price / currency / network only.
  • Open Weather Lookup — free; carries no payment terms (payment is optional / additive).

Payment terms use a pay: extension namespace bound in each entry's @context; the free entry shows the mechanism is opt-in. The scalar terms (pay:protocol / pay:price / pay:currency / pay:network) are the intended filter dimensions; pay:accepts is an advisory, x402-scoped pre-construct hint (the live 402 stays authoritative).

Conformance

Passes the official tool with strict JSON-Schema checking (pip install jsonschema), 0 errors / 0 warnings:

./bin/conformance-test manifest examples/nevermined/nevermined-catalog.json
# CONFORMANCE STATUS: PASS — 3/3 entries validate against ArdEntry

Notes

  • The pay: vocabulary shape is offered for discussion on Spec proposal: access and monetization signaling in ARD entries #20, not as a normative claim; the example validates regardless, because these are additive extension terms (§3.4, additionalProperties: true).
  • Nevermined publishes a live, conformance-passing /.well-known/ard.json carrying equivalent terms today (nevermined-io/nvm-monorepo#3079).

A small conformant ARD catalog under conformance/examples/nevermined/
demonstrating payment signaling on entries: x402 pay-per-call in USDC on
Base, off-chain card settlement, and a free agent (payment optional).
Passes the official conformance tool with 0 errors. Companion to the
entry-level payment-signaling discussion in ards-project#20.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant