zklicensing 0.1.0-beta.2 → 0.1.0-beta.21

package/build/permitDescribe.js

@@ -0,0 +1,324 @@
+// Copyright (c) 2025-2026 zkLicensing project developers
+// SPDX-License-Identifier: BUSL-1.1
+/**
+ * permitDescribe.ts — `zklicensing/permits/describe`
+ *
+ * What a zkPermits field signature means, in words. Wallets show these
+ * messages as a list of numbers, and most carry only a hash of the details
+ * (the permit, the fees, the keys). So the description is built the other
+ * way round: from the request's details, the message is rebuilt and must
+ * equal the numbers about to be signed — only then is the summary
+ * `verified`. Show it before asking the wallet, with the fingerprint (how
+ * many numbers, and how the last one ends) for comparing with the wallet's
+ * screen.
+ */
+import { Bool, Field, PublicKey, UInt32, UInt64 } from 'o1js';
+import { PERMIT_TAGS, PERMIT_NETWORK, acceptMessage, applyMessage, approveMessage, authorityKeys, authorityKeysHash, grantMessage, DEFAULT_DECISION_WINDOW, DEFAULT_MIN_PROCESSING_FEE, initMessage, networkField, packApplicationTerms, packFees, packPolicy, rejectMessage, retireMessage, rotateMessage, setFeesMessage, statusMessage, surrenderMessage, payoutMessage, payoutCancelMessage, rekeyMessage, unpackApplicationTerms, unpackFees, withdrawMessage, } from './permitMessages.js';
+import { recordToApplication, recordToLeaf } from './permitRegistryRebuild.js';
+import { minaUnit } from './units.js';
+import { EMPTY_ROOT } from './contractInterface.js';
+const TAG_KIND = new Map(Object.entries(PERMIT_TAGS).map(([k, v]) => [v.toString(), k]));
+const NET_NAME = new Map(Object.entries(PERMIT_NETWORK).map(([k, v]) => [v.toString(), k]));
+const NO_EXPIRY = 4294967295;
+export function fingerprint(fields) {
+    const last = fields[fields.length - 1] ?? '';
+    return `${fields.length} numbers, the last ending …${last.slice(-6)}`;
+}
+// Devnet fees are tMINA (test MINA, no value).
+const mina = (nano, network) => {
+    const s = BigInt(nano).toString().padStart(10, '0');
+    return `${s.slice(0, -9)}.${s.slice(-9)}`.replace(/\.?0+$/, '') + ' ' + minaUnit(network ?? 'mainnet');
+};
+const short = (s) => (s.length > 14 ? `${s.slice(0, 6)}…${s.slice(-6)}` : s);
+function scopeText(scope, ctx) {
+    const v = BigInt(scope);
+    const bits = [];
+    for (let i = 0; i < 254; i++)
+        if ((v >> BigInt(i)) & 1n)
+            bits.push(i);
+    return bits.length ? bits.map(b => ctx.scopeLabel?.(b) ?? `activity ${b}`).join(', ') : 'none';
+}
+const slotText = (slot, ctx) => (slot >= NO_EXPIRY ? 'no expiry' : ctx.slotLabel?.(slot) ?? `slot ${slot}`);
+const windowText = (slots) => `${Math.round(slots / 960)} days after the application`;
+function applicationFacts(a, ctx, network) {
+    return [
+        ['Activities', scopeText(a.scope, ctx)],
+        ['Valid', `${slotText(a.validFrom, ctx)} – ${slotText(a.expirySlot, ctx)}`],
+        ['Document hash', short(a.docHash)],
+        ['Kind', a.baseSeq === 0 ? 'new permit' : 'renewal or change'],
+        ['Fee in escrow', mina(a.fee, network)],
+        ['Decision deadline', slotText(a.deadline, ctx)],
+    ];
+}
+function leafFacts(prefix, r, ctx) {
+    return [
+        [`${prefix}activities`, scopeText(r.scope, ctx)],
+        [`${prefix}valid`, `${slotText(r.validFrom, ctx)} – ${slotText(r.expirySlot, ctx)}`],
+        [`${prefix}document hash`, short(r.docHash)],
+    ];
+}
+/** The message's tag, network and registry (readable from the numbers themselves). */
+function header(fields) {
+    const kind = TAG_KIND.get(fields[0] ?? '') ?? null;
+    const network = NET_NAME.get(fields[1] ?? '') ?? null;
+    let registry = null;
+    try {
+        registry = PublicKey.fromFields([Field(fields[2]), Field(fields[3])]).toBase58();
+    }
+    catch { /* not a key */ }
+    return { kind, network, registry };
+}
+const same = (a, b) => a.length === b.length && a.every((f, i) => f.toString() === b[i]);
+/**
+ * Describes an authority request (the keeper's RequestView: kind, message
+ * and its details) and checks that the details give exactly `message`.
+ */
+export function describeRequest(q, ctx = {}) {
+    const fields = q.message;
+    const h = header(fields);
+    const base = { kind: q.kind, network: h.network, registry: h.registry, fingerprint: fingerprint(fields) };
+    const fail = (title, problem, facts = []) => ({ ...base, title, facts, verified: false, problem });
+    if (!h.network)
+        return fail('Unknown message', 'The message names no zkPermits network.');
+    if (h.registry !== q.registry)
+        return fail('Unknown message', 'The message is for another registry than the request says.');
+    const net = networkField(h.network);
+    const reg = PublicKey.fromBase58(q.registry);
+    const epoch = UInt32.from(fields[4] ?? 0);
+    const nonce = UInt32.from(fields[5] ?? 0);
+    let expected;
+    let title;
+    let facts = [];
+    try {
+        switch (q.kind) {
+            case 'grant': {
+                if (!q.oldLeaf || !q.newLeaf)
+                    return fail('Grant', 'The request has no permit details.');
+                expected = grantMessage({ network: net, registry: reg, epoch, oldLeaf: recordToLeaf(q.oldLeaf), newLeaf: recordToLeaf(q.newLeaf) });
+                const isNew = q.oldLeaf.seq === 0 && !q.oldLeaf.holderKey;
+                title = isNew ? `Approve a new permit for ${short(q.newLeaf.holderKey)}` : `Approve a change to permit ${short(q.newLeaf.subject)}`;
+                facts = [
+                    ['Permit', short(q.newLeaf.subject)],
+                    ['Holder key', q.newLeaf.holderKey],
+                    ...leafFacts('', q.newLeaf, ctx),
+                    ...(isNew ? [] : leafFacts('Before: ', q.oldLeaf, ctx)),
+                    ...(q.fee ? [['Fee the holder pays', mina(q.fee, h.network)]] : []),
+                ];
+                break;
+            }
+            case 'suspend':
+            case 'reinstate':
+            case 'revoke': {
+                if (!q.oldLeaf)
+                    return fail(q.kind, 'The request has no permit details.');
+                expected = statusMessage(q.kind, { network: net, registry: reg, epoch, leaf: recordToLeaf(q.oldLeaf), reasonCode: Field(q.reasonCode ?? 0) });
+                title = `${q.kind === 'suspend' ? 'Suspend' : q.kind === 'reinstate' ? 'Reinstate' : 'Revoke (final)'} permit ${short(q.oldLeaf.subject)}`;
+                facts = [['Permit', short(q.oldLeaf.subject)], ['Holder key', q.oldLeaf.holderKey], ['Activities', scopeText(q.oldLeaf.scope, ctx)], ['Reason code', String(q.reasonCode ?? 0)]];
+                break;
+            }
+            case 'setFees': {
+                if (!q.newFeesPacked || !q.newAppTermsPacked)
+                    return fail('Change fees', 'The request has no fees.');
+                expected = setFeesMessage({ network: net, registry: reg, epoch, actionNonce: nonce, newFeesPacked: Field(q.newFeesPacked), newAppTermsPacked: Field(q.newAppTermsPacked) });
+                const f = unpackFees(Field(q.newFeesPacked));
+                const t = unpackApplicationTerms(Field(q.newAppTermsPacked));
+                title = 'Change the registry\'s fees';
+                facts = [
+                    ['Permit fee', mina(f.grantFee.toBigInt(), h.network)], ['Renewal fee', mina(f.renewalFee.toBigInt(), h.network)], ['Minimum', mina(f.minFee.toBigInt(), h.network)],
+                    ['Processing fee (kept on rejection or withdrawal)', mina(t.processingFee.toBigInt(), h.network)],
+                    ['Decision deadline', windowText(Number(t.decisionWindow.toString()))],
+                ];
+                break;
+            }
+            case 'approveApplication':
+            case 'rejectApplication': {
+                if (!q.application)
+                    return fail('Application', 'The request has no application.');
+                const app = recordToApplication(q.application);
+                const reject = q.kind === 'rejectApplication';
+                expected = reject
+                    ? rejectMessage({ network: net, registry: reg, epoch, application: app, reasonCode: Field(q.reasonCode ?? 0) })
+                    : approveMessage({ network: net, registry: reg, epoch, application: app });
+                const kept = BigInt(q.application.processingFee);
+                title = reject
+                    ? `Reject the application of ${short(q.application.holderKey)}`
+                    : `Approve the application of ${short(q.application.holderKey)} (permit active at once)`;
+                facts = [
+                    ['Applicant key', q.application.holderKey],
+                    ...applicationFacts(q.application, ctx, h.network),
+                    ...(reject
+                        ? [['Kept (processing fee)', mina(kept, h.network)], ['Refunded to the payer', mina(BigInt(q.application.fee) - kept, h.network)], ['Reason code', String(q.reasonCode ?? 0)]]
+                        : [['Paid out from escrow', mina(q.application.fee, h.network)]]),
+                ];
+                break;
+            }
+            case 'rotate': {
+                if (!q.newKeys || !q.newThreshold)
+                    return fail('Rotate keys', 'The request has no new keys.');
+                const newKeysHash = authorityKeysHash(authorityKeys(q.newKeys.map(k => PublicKey.fromBase58(k)), q.newThreshold));
+                expected = rotateMessage({ network: net, registry: reg, epoch, actionNonce: nonce, newKeysHash });
+                title = 'Replace the authority keys';
+                facts = [...q.newKeys.map((k, i) => [`New key ${i + 1}`, k]), ['Signatures needed', `${q.newThreshold} of ${q.newKeys.length}`]];
+                break;
+            }
+            case 'payout': {
+                if (!q.newPayout)
+                    return fail('Change the payout address', 'The request has no address.');
+                expected = payoutMessage({ network: net, registry: reg, epoch, actionNonce: nonce, payout: PublicKey.fromBase58(q.newPayout) });
+                title = 'Change the payout address (after 48 hours)';
+                facts = [['New payout address', q.newPayout], ['Takes effect', '48 hours after it lands; until then fees go to the current address, and the keys can cancel it']];
+                break;
+            }
+            case 'payoutCancel': {
+                expected = payoutCancelMessage({ network: net, registry: reg, epoch, actionNonce: nonce });
+                title = 'Cancel the pending payout address change';
+                facts = q.newPayout ? [['Cancelled address', q.newPayout]] : [];
+                break;
+            }
+            case 'retire': {
+                const root = fields[6];
+                if (root === undefined || fields[7] === undefined || fields[8] === undefined)
+                    return fail('Retire the registry', 'The message names no permits root or successor.');
+                let successor;
+                try {
+                    successor = PublicKey.fromFields([Field(fields[7]), Field(fields[8])]);
+                }
+                catch {
+                    return fail('Retire the registry', 'The successor in the message is not a valid address.');
+                }
+                expected = retireMessage({ network: net, registry: reg, epoch, actionNonce: nonce, permitsRoot: Field(root), successor });
+                title = 'Retire the registry for a redeploy (final)';
+                facts = [
+                    ['Effect', 'no more changes here: no grants, renewals, status changes, applications or surrenders'],
+                    ['Permits', 'carry over, all at once and unchanged, to the new registry below: only it can start from them'],
+                    ['New registry', successor.toBase58()],
+                    ['Frozen permits root', root],
+                ];
+                break;
+            }
+            case 'init': {
+                const r = ctx.registry;
+                if (!r)
+                    return fail('Deploy registry', 'The registry\'s configuration is needed to check this message.');
+                const keysHash = authorityKeysHash(authorityKeys(r.keys.map(k => PublicKey.fromBase58(k)), r.threshold));
+                const policyPacked = packPolicy({ gracePeriod: UInt32.from(r.policy.gracePeriod), maxTerm: UInt32.from(r.policy.maxTerm), singleKeySuspend: Bool(r.policy.singleKeySuspend), holderSigRequired: Bool(r.policy.holderSigRequired) });
+                const feesPacked = packFees({ grantFee: UInt64.from(r.fees.grantFee), renewalFee: UInt64.from(r.fees.renewalFee), minFee: UInt64.from(r.fees.minFee) });
+                const processingFee = r.fees.processingFee ?? DEFAULT_MIN_PROCESSING_FEE.toString();
+                const decisionWindow = r.decisionWindow ?? Number(DEFAULT_DECISION_WINDOW.toBigint());
+                const appTermsPacked = packApplicationTerms({
+                    processingFee: UInt64.from(processingFee), minProcessingFee: UInt64.from(r.fees.minProcessingFee ?? DEFAULT_MIN_PROCESSING_FEE.toString()), decisionWindow: UInt32.from(decisionWindow),
+                });
+                expected = initMessage({
+                    network: net, registry: reg, keysHash, policyPacked, feesPacked, appTermsPacked, metadataHash: Field(r.metadataHash), payout: PublicKey.fromBase58(r.payout),
+                    forkActivationSlot: UInt32.from(r.forkActivationSlot ?? 0),
+                    predecessor: r.predecessor ? PublicKey.fromBase58(r.predecessor) : PublicKey.empty(),
+                    initialPermitsRoot: Field(r.initialPermitsRoot ?? EMPTY_ROOT.toString()),
+                });
+                title = r.predecessor
+                    ? `Redeploy the registry (generation ${r.generation ?? 2}, replacing ${short(r.predecessor)})`
+                    : 'Set up the registry (keys, rules and fees)';
+                facts = [
+                    ...(r.predecessor ? [['Replaces', r.predecessor], ['Permits', `starts with all permits of the replaced registry, as they are when it retires (permits root ${short(r.initialPermitsRoot ?? '')})`]] : []),
+                    ...r.keys.map((k, i) => [`Key ${i + 1}`, k]),
+                    ['Signatures needed', `${r.threshold} of ${r.keys.length}`],
+                    ['Permit fee', mina(r.fees.grantFee, h.network)], ['Renewal fee', mina(r.fees.renewalFee, h.network)],
+                    ['Processing fee (kept on rejection or withdrawal)', mina(processingFee, h.network)],
+                    ['Decision deadline', windowText(decisionWindow)],
+                    ['Fees paid to', r.payout],
+                    ['Suspension', r.policy.singleKeySuspend ? 'any one key' : 'same as other actions'],
+                ];
+                break;
+            }
+            default:
+                return fail('Unknown request', `Unknown request kind ${q.kind}.`);
+        }
+    }
+    catch (e) {
+        return fail('Unreadable request', e?.message ?? String(e));
+    }
+    facts.unshift(['Registry', q.registry], ['Network', h.network]);
+    if (!same(expected, fields))
+        return { ...base, title, facts, verified: false, problem: 'The numbers to sign do not match these details. Do not sign.' };
+    return { ...base, title, facts, verified: true };
+}
+/** The holder accepting a permit and its fee (acceptMessage). */
+export function describeAccept(a, ctx = {}) {
+    const expected = acceptMessage({ network: networkField(a.network), registry: PublicKey.fromBase58(a.registry), newLeaf: recordToLeaf(a.newLeaf), fee: UInt64.from(a.fee) });
+    const ok = same(expected, a.fields);
+    return {
+        kind: 'accept', title: `Accept permit ${short(a.newLeaf.subject)} and pay ${mina(a.fee, a.network)}`,
+        facts: [['Registry', a.registry], ['Network', a.network], ...leafFacts('', a.newLeaf, ctx), ['Fee', mina(a.fee, a.network)]],
+        network: a.network, registry: a.registry, verified: ok, ...(ok ? {} : { problem: 'The numbers to sign do not match these details. Do not sign.' }),
+        fingerprint: fingerprint(a.fields),
+    };
+}
+/**
+ * The holder moving a permit to a new key (rekeyMessage): signed by the
+ * current key and the new one. Same terms, a new subject; the old one closes.
+ */
+export function describeRekey(a, ctx = {}) {
+    const expected = rekeyMessage({ network: networkField(a.network), registry: PublicKey.fromBase58(a.registry), leaf: recordToLeaf(a.leaf), newSubject: Field(a.newSubject), newHolderKey: PublicKey.fromBase58(a.newHolderKey) });
+    const ok = same(expected, a.fields);
+    return {
+        kind: 'rekey', title: `Move permit ${short(a.leaf.subject)} to the key ${short(a.newHolderKey)}`,
+        facts: [['Registry', a.registry], ['Network', a.network], ['New holder key', a.newHolderKey], ['Activities', scopeText(a.leaf.scope, ctx)], ['Effect', 'the same permit under the new key; this one closes (moved)']],
+        network: a.network, registry: a.registry, verified: ok, ...(ok ? {} : { problem: 'The numbers to sign do not match these details. Do not sign.' }),
+        fingerprint: fingerprint(a.fields),
+    };
+}
+/** The holder giving up a permit (surrenderMessage). */
+export function describeSurrender(a, ctx = {}) {
+    const expected = surrenderMessage({ network: networkField(a.network), registry: PublicKey.fromBase58(a.registry), leaf: recordToLeaf(a.leaf) });
+    const ok = same(expected, a.fields);
+    return {
+        kind: 'surrender', title: `Give up permit ${short(a.leaf.subject)} (final)`,
+        facts: [['Registry', a.registry], ['Network', a.network], ['Activities', scopeText(a.leaf.scope, ctx)]],
+        network: a.network, registry: a.registry, verified: ok, ...(ok ? {} : { problem: 'The numbers to sign do not match these details. Do not sign.' }),
+        fingerprint: fingerprint(a.fields),
+    };
+}
+/**
+ * The holder's application (applyMessage): the terms and the fee put in
+ * escrow. `application.payer` and `deadline` aren't part of what the holder
+ * signs (the sender pays; the contract sets the deadline).
+ */
+export function describeApply(a, ctx = {}) {
+    const expected = applyMessage({ network: networkField(a.network), registry: PublicKey.fromBase58(a.registry), application: recordToApplication(a.application) });
+    const ok = same(expected, a.fields);
+    const kept = BigInt(a.application.processingFee);
+    return {
+        kind: 'apply', title: `Apply for a permit and put ${mina(a.application.fee, a.network)} in escrow`,
+        facts: [
+            ['Registry', a.registry], ['Network', a.network],
+            ['Activities', scopeText(a.application.scope, ctx)],
+            ['Valid', `${slotText(a.application.validFrom, ctx)} – ${slotText(a.application.expirySlot, ctx)}`],
+            ['Document hash', short(a.application.docHash)],
+            ['Fee in escrow', mina(a.application.fee, a.network)],
+            ['If approved', 'the permit is active at once and the fee is paid'],
+            ['If rejected or withdrawn', `${mina(kept, a.network)} processing fee kept, ${mina(BigInt(a.application.fee) - kept, a.network)} refunded`],
+            ['If no decision by the deadline', 'full refund'],
+        ],
+        network: a.network, registry: a.registry, verified: ok, ...(ok ? {} : { problem: 'The numbers to sign do not match these details. Do not sign.' }),
+        fingerprint: fingerprint(a.fields),
+    };
+}
+/** The holder withdrawing an application (withdrawMessage). */
+export function describeWithdraw(a, ctx = {}) {
+    const expected = withdrawMessage({ network: networkField(a.network), registry: PublicKey.fromBase58(a.registry), application: recordToApplication(a.application) });
+    const ok = same(expected, a.fields);
+    const kept = BigInt(a.application.processingFee);
+    return {
+        kind: 'withdraw', title: 'Withdraw the application',
+        facts: [
+            ['Registry', a.registry], ['Network', a.network], ['Activities', scopeText(a.application.scope, ctx)],
+            ['Kept (processing fee)', mina(kept, a.network)], ['Refunded to the payer', mina(BigInt(a.application.fee) - kept, a.network)],
+        ],
+        network: a.network, registry: a.registry, verified: ok, ...(ok ? {} : { problem: 'The numbers to sign do not match these details. Do not sign.' }),
+        fingerprint: fingerprint(a.fields),
+    };
+}
+/** What any zkPermits field message is, from the numbers alone (kind, network, registry); details need describeRequest. */
+export function identifyPermitMessage(fields) {
+    return { ...header(fields), fingerprint: fingerprint(fields) };
+}
+//# sourceMappingURL=permitDescribe.js.map

package/build/permitDescribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permitDescribe.js","sourceRoot":"","sources":["../src/permitDescribe.ts"],"names":[],"mappings":"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"}

package/build/permitInterface.d.ts

@@ -0,0 +1,85 @@
+import { PayoutChangedEvent, PayoutProposedEvent, PlatformChangedEvent } from './contractInterface.js';
+export { PayoutChangedEvent, PayoutProposedEvent, PlatformChangedEvent };
+export declare const PermitGrantedEvent: any;
+export type PermitGrantedEvent = any;
+export declare const PermitStatusEvent: any;
+export type PermitStatusEvent = any;
+export declare const FeesUpdatedEvent: any;
+export type FeesUpdatedEvent = any;
+export declare const AuthorityRotatedEvent: any;
+export type AuthorityRotatedEvent = any;
+/**
+ * The registry was initialized; `permitsRoot` is the tree it starts with (its
+ * predecessor's frozen permits on a redeploy) and `predecessor` the retired
+ * registry it continues (PublicKey.empty() for a first generation), so a
+ * registry's lineage can be rebuilt from chain events alone.
+ */
+export declare const RegistryCreatedEvent: any;
+/** The registry was retired for a redeploy: its permits are frozen at `permitsRoot`, and only `successor` can start from them. */
+/**
+ * `byPlatform`: retired by the platform key (retireByPlatform), not the
+ * authority's keys; `forced`: with application fees still in escrow, which
+ * stay on the retired registry.
+ */
+export declare const RegistryRetiredEvent: any;
+export type RegistryCreatedEvent = any;
+export declare const ApplicationFiledEvent: any;
+export type ApplicationFiledEvent = any;
+/** A permit moved to a new holder key: `leaf` is the new one (its old leaf is closed as MOVED, in a permitStatusChanged event). */
+export declare const PermitMovedEvent: any;
+export type PermitMovedEvent = any;
+export declare const ApplicationSettledEvent: any;
+export type ApplicationSettledEvent = any;
+/** On-chain state layout (appState index → field), for direct account reads. */
+export declare const PERMIT_REGISTRY_STATE: {
+    readonly permitsRoot: 0;
+    readonly authorityKeysHash: 1;
+    readonly authorityEpoch: 2;
+    readonly actionNonce: 3;
+    readonly policyPacked: 4;
+    readonly feesPacked: 5;
+    readonly payoutX: 6;
+    readonly payoutIsOdd: 7;
+    readonly version: 8;
+    readonly ancestorsRoot: 9;
+    readonly forkActivationSlot: 10;
+    readonly metadataHash: 11;
+    readonly networkId: 12;
+    readonly escrowRoot: 13;
+    readonly appTermsPacked: 14;
+    readonly filingCount: 15;
+    readonly successorX: 16;
+    readonly successorIsOdd: 17;
+    readonly pendingPayoutX: 18;
+    readonly pendingPayoutIsOdd: 19;
+    readonly pendingPayoutSlot: 20;
+    readonly platformX: 21;
+    readonly platformIsOdd: 22;
+    readonly treasuryX: 23;
+    readonly treasuryIsOdd: 24;
+    readonly platformEpoch: 25;
+    /** Set by a platform retire: the key set the successor must keep (0 after the authority's own retire). */
+    readonly frozenKeysHash: 26;
+};
+/** Source version of the PermitRegistry circuit, set at initialize. */
+export declare const PERMIT_REGISTRY_VERSION = 1;
+/**
+ * Canonical PermitRegistry verification-key hashes by generation (the
+ * platform address is compiled in). Append-only, like CANONICAL_VK_HASHES:
+ * add a row for a new circuit release, never delete one. The keeper refuses
+ * to prove with a circuit whose hash isn't the current row, and the
+ * vkDrift test catches an unintended change.
+ */
+export declare const CANONICAL_PERMIT_VK_HASHES: Readonly<Record<number, string>>;
+export declare const CURRENT_PERMIT_GENERATION: number;
+export declare const CANONICAL_PERMIT_VK_HASH: string;
+/** Verification-key hash of the PermitProof holder-proof ZkProgram. */
+export declare const CANONICAL_PERMIT_PROOF_VK_HASH: string;
+/**
+ * Events-only view of a PermitRegistry: `new PermitRegistryEvents(address)
+ * .fetchEvents(from?)` decodes a registry's events (archive node or local
+ * chain) without the private circuit source. Event names and shapes match
+ * PermitRegistry exactly, so the type indices agree.
+ */
+export declare const PermitRegistryEvents: any;
+//# sourceMappingURL=permitInterface.d.ts.map

package/build/permitInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permitInterface.d.ts","sourceRoot":"","sources":["../src/permitInterface.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACvG,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,CAAC;AAEzE,eAAO,MAAM,kBAAkB,EAAE,GAK/B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAErC,eAAO,MAAM,iBAAiB,EAAE,GAG9B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAEpC,eAAO,MAAM,gBAAgB,EAAE,GAA+E,CAAC;AAC/G,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEnC,eAAO,MAAM,qBAAqB,EAAE,GAAgD,CAAC;AACrF,MAAM,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,GAAgH,CAAC;AACpJ,kIAAkI;AAClI;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,GAA+G,CAAC;AACnJ,MAAM,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAGvC,eAAO,MAAM,qBAAqB,EAAE,GAA0C,CAAC;AAC/E,MAAM,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAExC,mIAAmI;AACnI,eAAO,MAAM,gBAAgB,EAAE,GAAqD,CAAC;AACrF,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEnC,eAAO,MAAM,uBAAuB,EAAE,GAMpC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAG1C,gFAAgF;AAChF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BhC,0GAA0G;;CAElG,CAAC;AAEX,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvE,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,MAAU,CAAC;AAEnD,eAAO,MAAM,wBAAwB,EAAE,MAA8D,CAAC;AAEtG,uEAAuE;AACvE,eAAO,MAAM,8BAA8B,EAAE,MAAwF,CAAC;AAEtI;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,GAelC,CAAC"}

package/build/permitInterface.js

@@ -0,0 +1,121 @@
+// Copyright (c) 2025-2026 zkLicensing project developers
+// SPDX-License-Identifier: BUSL-1.1
+/**
+ * permitInterface.ts — `zklicensing/permits/interface`
+ *
+ * Public interface of the PermitRegistry contract: event shapes, state
+ * layout indices and the canonical verification-key hashes. Enough to
+ * decode events and rebuild a registry's tree without the private circuit
+ * source (same split as contractInterface.ts for licensing).
+ */
+import { Bool, Field, PublicKey, SmartContract, Struct, UInt32, UInt64 } from 'o1js';
+import { Application, PermitLeaf } from './permitMessages.js';
+import { PayoutChangedEvent, PayoutProposedEvent, PlatformChangedEvent } from './contractInterface.js';
+export { PayoutChangedEvent, PayoutProposedEvent, PlatformChangedEvent };
+export const PermitGrantedEvent = Struct({
+    leaf: PermitLeaf,
+    fee: UInt64,
+    payer: PublicKey,
+    isNew: Field, // 1 = first grant for this subject, 0 = renewal / change
+});
+export const PermitStatusEvent = Struct({
+    leaf: PermitLeaf, // the leaf after the change
+    reasonCode: Field, // authority's reason code; 0 for surrender
+});
+export const FeesUpdatedEvent = Struct({ feesPacked: Field, appTermsPacked: Field, actionNonce: UInt32 });
+export const AuthorityRotatedEvent = Struct({ keysHash: Field, epoch: UInt32 });
+/**
+ * The registry was initialized; `permitsRoot` is the tree it starts with (its
+ * predecessor's frozen permits on a redeploy) and `predecessor` the retired
+ * registry it continues (PublicKey.empty() for a first generation), so a
+ * registry's lineage can be rebuilt from chain events alone.
+ */
+export const RegistryCreatedEvent = Struct({ keysHash: Field, network: Field, payout: PublicKey, permitsRoot: Field, predecessor: PublicKey });
+/** The registry was retired for a redeploy: its permits are frozen at `permitsRoot`, and only `successor` can start from them. */
+/**
+ * `byPlatform`: retired by the platform key (retireByPlatform), not the
+ * authority's keys; `forced`: with application fees still in escrow, which
+ * stay on the retired registry.
+ */
+export const RegistryRetiredEvent = Struct({ permitsRoot: Field, actionNonce: UInt32, successor: PublicKey, byPlatform: Bool, forced: Bool });
+// Application escrow.
+export const ApplicationFiledEvent = Struct({ application: Application });
+/** A permit moved to a new holder key: `leaf` is the new one (its old leaf is closed as MOVED, in a permitStatusChanged event). */
+export const PermitMovedEvent = Struct({ oldSubject: Field, leaf: PermitLeaf });
+export const ApplicationSettledEvent = Struct({
+    subject: Field,
+    applicationHash: Field,
+    outcome: Field, // APPLICATION_OUTCOME: 1 approved, 2 rejected, 3 withdrawn, 4 reclaimed, 5 cancelled by the platform
+    kept: UInt64, // paid out to the authority and the platform (98/2)
+    refunded: UInt64, // returned to the payer
+});
+/** On-chain state layout (appState index → field), for direct account reads. */
+export const PERMIT_REGISTRY_STATE = {
+    permitsRoot: 0,
+    authorityKeysHash: 1,
+    authorityEpoch: 2,
+    actionNonce: 3,
+    policyPacked: 4,
+    feesPacked: 5,
+    payoutX: 6,
+    payoutIsOdd: 7,
+    version: 8,
+    ancestorsRoot: 9,
+    forkActivationSlot: 10,
+    metadataHash: 11,
+    networkId: 12,
+    escrowRoot: 13,
+    appTermsPacked: 14,
+    filingCount: 15,
+    successorX: 16,
+    successorIsOdd: 17,
+    pendingPayoutX: 18,
+    pendingPayoutIsOdd: 19,
+    pendingPayoutSlot: 20,
+    platformX: 21,
+    platformIsOdd: 22,
+    treasuryX: 23,
+    treasuryIsOdd: 24,
+    platformEpoch: 25,
+    /** Set by a platform retire: the key set the successor must keep (0 after the authority's own retire). */
+    frozenKeysHash: 26,
+};
+/** Source version of the PermitRegistry circuit, set at initialize. */
+export const PERMIT_REGISTRY_VERSION = 1;
+/**
+ * Canonical PermitRegistry verification-key hashes by generation (the
+ * platform address is compiled in). Append-only, like CANONICAL_VK_HASHES:
+ * add a row for a new circuit release, never delete one. The keeper refuses
+ * to prove with a circuit whose hash isn't the current row, and the
+ * vkDrift test catches an unintended change.
+ */
+export const CANONICAL_PERMIT_VK_HASHES = {
+    1: '27337945734556665205684717094424577317630618958452630976255659397562153215921',
+};
+export const CURRENT_PERMIT_GENERATION = 1;
+export const CANONICAL_PERMIT_VK_HASH = CANONICAL_PERMIT_VK_HASHES[CURRENT_PERMIT_GENERATION];
+/** Verification-key hash of the PermitProof holder-proof ZkProgram. */
+export const CANONICAL_PERMIT_PROOF_VK_HASH = '17966873603167039790277974846902264570097359740655050143055465189220786366055';
+/**
+ * Events-only view of a PermitRegistry: `new PermitRegistryEvents(address)
+ * .fetchEvents(from?)` decodes a registry's events (archive node or local
+ * chain) without the private circuit source. Event names and shapes match
+ * PermitRegistry exactly, so the type indices agree.
+ */
+export const PermitRegistryEvents = class PermitRegistryEvents extends SmartContract {
+    events = {
+        registryCreated: RegistryCreatedEvent,
+        permitGranted: PermitGrantedEvent,
+        permitStatusChanged: PermitStatusEvent,
+        feesUpdated: FeesUpdatedEvent,
+        authorityRotated: AuthorityRotatedEvent,
+        applicationFiled: ApplicationFiledEvent,
+        applicationSettled: ApplicationSettledEvent,
+        registryRetired: RegistryRetiredEvent,
+        permitMoved: PermitMovedEvent,
+        payoutProposed: PayoutProposedEvent,
+        payoutChanged: PayoutChangedEvent,
+        platformChanged: PlatformChangedEvent,
+    };
+};
+//# sourceMappingURL=permitInterface.js.map

package/build/permitInterface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permitInterface.js","sourceRoot":"","sources":["../src/permitInterface.ts"],"names":[],"mappings":"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"}