Kindlingfor peopleThe protocol siteThe specificationThe libraryThe Circular
KindlingAn open protocol for finding people
PreambleThe handshake

The consent handshake, clickable · §5.2

Try it as Hollis.

Hollis Grant is invented. He builds a Kindling client for rural libraries. The Kindling maintainers would like to list him in Client Builders, one of the project’s planned Pools. Here, you are Hollis. Nothing is sent anywhere.

Hollis isn’t in Client Builders yet. On the Pools page he appears in Spec Readers and Toward a Working Group; saying yes here would add him to Client Builders too.

Art. IThe request

The request, as Hollis receives it.

From Kindling, on behalf of the Kindling maintainersExpires Oct 11, 3:00 PM UTC · 13 days left

The Kindling maintainers would like to add you to Client Builders.

  1. 1

    What it’s for

    Developers building Kindling clients, readers, hosts and tools, in any stack. For trading notes, reviewing each other’s conformance, and finding a second pair of eyes before a release. Not for recruiting or selling.

  2. 2

    Who curates it

    Kindling maintainers josh@intellibotique.com Signed in with OAuth

    with Imani Brooks, co-curator Signed in with OAuth

  3. 3

    What it’s about

    building open-source

  4. 4

    Who can see it

    Public. Anyone can find this Pool and read who is listed.

  5. 5

    How you leave

    Any time, from any message. It takes effect within sixty seconds.

Your answer

Not signed yet. 13 days left.

A no is remembered, and the maintainers can’t ask again unless you let them. Say nothing and this request expires after 14 days.

handshake_id hs-kindling-client-builders-hollis-demo

Art. IIThe log

What happened, in order.

Every step, with the exact message the protocol would send.

  1. requestThe Pool sent a handshake request.
The exact JSON messages

handshake-request · Sep 28, 9:00 AM UTC

{
  "schema_version": "0.1",
  "type": "handshake-request",
  "handshake_id": "hs-kindling-client-builders-hollis-demo",
  "pool": {
    "url": "https://kindling.foundation/pools/client-builders.json",
    "name": "Client Builders",
    "charter": "Developers building Kindling clients, readers, hosts and tools, in any stack. For trading notes, reviewing each other’s conformance, and finding a second pair of eyes before a release. Not for recruiting or selling.",
    "curator_identity": "josh@intellibotique.com",
    "curator_verification": "oauth",
    "intent_tags": [
      "building",
      "open-source"
    ],
    "visibility": "public"
  },
  "profile_url": "https://hollis-grant.example",
  "sent_at": "2026-09-27T15:00:00Z",
  "expires_at": "2026-10-11T15:00:00Z",
  "accept_url": "https://kindling.foundation/handshake/hs-kindling-client-builders-hollis-demo/accept",
  "decline_url": "https://kindling.foundation/handshake/hs-kindling-client-builders-hollis-demo/decline"
}
Art. IIIThe rules

What the rules are doing.

  1. §5.2

    Yes lists you, with a record.

    On accept, the Pool parses the page in full, caches the structured profile and lists it. The entry carries a consent_proof pointing at this handshake.

  2. §5.2

    No is remembered.

    On decline, the URL is recorded as declined for this Pool and the same curator may not submit it again without the owner’s permission.

  3. §5.3

    Leaving is one message.

    A withdrawal message removes you. The spec allows at most sixty seconds; this demo takes less than one.

  4. §5.5

    Rules can answer for you, never silently.

    Hollis has no auto-accept rules. If he had one for building Pools with an OAuth curator, it could say yes for him, and he would get a notice he could undo.