AD+CARD

Open protocol · Draft 0.1

Advertising should begin with what you ask for.

Ad+Card is a user-owned format for declared intent. You write a goal. Outfitters can offer useful support. A truthful receipt records what happened—without turning your life into targeting data.

See how it works Read the draft

Declaration

adcard/0.1

A goal I chose

Run a 5K without stopping by October.

Category
Move
Visibility
Private
Identity
Fresh key
Written, held, and signed by the person

A card is useful even when it never leaves your device.

00 / Premise

The old model watches, predicts, and interrupts.

This model listens, equips, and proves.

01 / Protocol

Declared intent in.
Useful support back.

One small public vocabulary lets wallets, instruments, and markets interoperate without sharing a private behavioral profile.

  1. 01

    Declaration

    You state the goal.

    The card contains only what you chose to declare, signed with a fresh key by default.

  2. 02

    Offer

    An outfitter equips progress.

    Goods, funding, access, or a disclosed module can support the goal. Commercial offers are funded first.

  3. 03

    Receipt

    The moment settles truthfully.

    A receipt names the narrow claim, its assurance class, and nothing from the raw evidence stream.

02 / Objects

Three objects.
One honest chain.

All objects are versioned JSON. The format is deliberately smaller than the products that implement it.

Inspect the JSON Schema

Declaration

The Ad+Card

A person-authored goal, optional baseline, visibility choice, expiry, and signature. Real identity is not a protocol field.

View example JSON

Offer

The outfitter’s response

What is supplied, which disclosed module is involved, what assurance can settle, when it expires, and how a reward is funded.

View example JSON

Receipt

The settlement truth

Completed, stopped, or inconclusive. Each phase carries a human-readable claim and an assurance class that cannot be inflated later.

View example JSON

03 / Trust

The receipt says exactly what happened—and never more.

A useful protocol must preserve uncertainty. Self-attestation is honest. Inconclusive evidence is honest. Pretending either is device-verified is not.

Class What it means Commercial settlement
Verified Fresh, capability-specific evidence established the claim. Yes
Corroborated Evidence supports the claim but cannot fully establish it. Only when explicitly accepted
Self-attested The person said so. Human, visible, and first-class. No
Inconclusive Evidence was gathered, but the claim was not established. No

04 / Privacy boundary

Raw reality stays with the person.

Protocol objects reject the material that could reconstruct a private life.

  • Coordinates
  • Health samples
  • Images or private hashes
  • Answer choices
  • Motion streams

Only a narrow, human-readable claim crosses the boundary. Health-derived values never enter eligibility or commerce.

05 / Implement

Build one role.
Interoperate with the rest.

The format exists so one company does not have to own the card, the instrument, and the market.

A

Card wallet

Create, hold, export, and delete Declarations. Private cards remain fully conforming.

B

Instrument

Execute disclosed modules and issue Receipts that preserve evidence boundaries and assurance.

C

Market

Match Declarations to funded Offers and settle only the receipt classes the person accepted.

Zero dependencies · Static site · Machine-readable draft

Start by trying to break the boundary.

Clone the source, run the conformance checks, add an adversarial test vector, or implement a wallet that never contacts a server.

npm run serve
npm test
npm run check

The proposition

Do not advertise at people.
Equip what they chose to do.

Ad+Card is still a draft. The next proof is an independent implementation that can say “no,” stop honestly, and keep raw reality private.

Review the specification Open a Declaration