Start here

Quickstart (sandbox)

Local product loop only. Simulated-owner clearance is enabled when SANDBOX_SIMULATED_OWNER=true and environment mode is test. It mints real NTKA warrants and grants from a sandbox simulated-owner path; that is not the live passkey owner ceremony. For SDARC architecture, read SDARC and the patent.

  1. Run make setup && make up (see the repo README for local bootstrap).
  2. Register at https://zerogrant.io/register, or sign in at https://app.zerogrant.io/login with a Supabase email OTP.
  3. Create a ClearanceIntent with your secret test key (response includes client_secret)
  4. Mount the Element with @zerogrant/browser + publishable key, or call simulate-approve / Element session approve
  5. Confirm webhook delivery and a usage ledger row with billable=false
create_clearance_intent.sh
curl -sS -X POST https://api.zerogrant.io/v1/clearance-intents \
  -H "Authorization: Bearer $ZEROGRANT_SECRET_KEY" \
  -H "content-type: application/json" \
  -d '{"customer_reference":"demo_user","purpose":"sandbox_clearance"}'

# response.data.client_secret -> Element / @zerogrant/browser
# Use your dashboard secret + publishable keys (never commit them).
# SDK docs: /sdks