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

package/build/seatName.js

@@ -0,0 +1,136 @@
+// Copyright (c) 2025-2026 zkLicensing project developers
+// SPDX-License-Identifier: BUSL-1.1
+/**
+ * seatName.ts
+ *
+ * Human-readable device names for the device-binding slot list
+ * ("Silent Otter", "Curious Panda"). Meant for the SDK UI so a buyer
+ * looking at their bound-devices panel sees "the laptop I left in the
+ * office" instead of an opaque device commitment.
+ *
+ * The name is purely cosmetic — the on-chain circuit never gates on it,
+ * verifyOffline never inspects it, and unbind targets `slotIndex`, not
+ * name. It exists solely so the SDK's device-manager UI has something
+ * readable to render next to each slot.
+ *
+ * Names are NOT persisted on-chain and NOT persisted off-chain either —
+ * `seatNameFor` derives the label deterministically from three on-chain
+ * fields (`licenseHash`, `slotIndex`, `boundAtSlot`), so every viewer of
+ * the same license computes the same name for a given occupied slot with
+ * no naming sidecar and no stored state.
+ *
+ * The wordlists are intentionally boring: no scary animals, no negative
+ * adjectives, no cultural landmines, no words with awkward secondary
+ * meanings. Order and word choice are stable — changing them shifts every
+ * slot's name on the next mint, which would be jarring for users looking
+ * at their device list.
+ */
+// 250 friendly adjectives. Short, common, unambiguously positive or
+// neutral. Ordering is alphabetical for maintainability — the derivation
+// is index-based so order does not affect behavior.
+const ADJECTIVES = [
+    'Agile', 'Alert', 'Amber', 'Ample', 'Ancient', 'Apricot', 'Arctic', 'Ashen',
+    'Aspen', 'Autumn', 'Azure', 'Balmy', 'Bashful', 'Beaming', 'Beige', 'Bold',
+    'Bouncy', 'Brave', 'Breezy', 'Bright', 'Brisk', 'Bronze', 'Bubbly', 'Busy',
+    'Calm', 'Candid', 'Cedar', 'Cheery', 'Chic', 'Chipper', 'Chunky', 'Classic',
+    'Clean', 'Clever', 'Cloudy', 'Clumsy', 'Coastal', 'Comet', 'Cool', 'Copper',
+    'Coral', 'Cosmic', 'Cosy', 'Crafty', 'Creamy', 'Crimson', 'Crisp', 'Cuddly',
+    'Curious', 'Daisy', 'Dandy', 'Dapper', 'Daring', 'Dawn', 'Deft', 'Delta',
+    'Devout', 'Dewy', 'Diamond', 'Doughty', 'Dreamy', 'Dusky', 'Dusty', 'Eager',
+    'Earnest', 'Earthy', 'Easy', 'Ebony', 'Elder', 'Elm', 'Ember', 'Emerald',
+    'Epic', 'Fabled', 'Faint', 'Fair', 'Fancy', 'Fearless', 'Feisty', 'Fern',
+    'Fiery', 'Fine', 'Firm', 'Flaxen', 'Fleet', 'Floral', 'Fluffy', 'Foggy',
+    'Fond', 'Forest', 'Frank', 'Freckled', 'Friendly', 'Frosty', 'Frugal', 'Furry',
+    'Fuzzy', 'Gallant', 'Genial', 'Gentle', 'Gilded', 'Ginger', 'Glad', 'Glassy',
+    'Gleaming', 'Glossy', 'Glowing', 'Golden', 'Graceful', 'Grand', 'Grassy',
+    'Green', 'Handy', 'Happy', 'Hardy', 'Hazel', 'Hearty', 'Helpful', 'Honest',
+    'Humble', 'Icy', 'Indigo', 'Inky', 'Iron', 'Ivory', 'Jade', 'Jaunty', 'Jazzy',
+    'Jolly', 'Jovial', 'Joyful', 'Juniper', 'Keen', 'Kind', 'Lanky', 'Lark',
+    'Lavender', 'Lazy', 'Leaf', 'Lilac', 'Limber', 'Lively', 'Lofty', 'Loyal',
+    'Lucky', 'Lush', 'Marble', 'Matte', 'Meadow', 'Mellow', 'Merry', 'Mighty',
+    'Milky', 'Mindful', 'Minty', 'Misty', 'Modest', 'Mossy', 'Nautical', 'Nectar',
+    'Nifty', 'Nimble', 'Noble', 'Nutmeg', 'Oaken', 'Ochre', 'Olive', 'Onyx',
+    'Opal', 'Orange', 'Orchid', 'Pale', 'Patient', 'Peachy', 'Pearl', 'Pebble',
+    'Perky', 'Piney', 'Placid', 'Playful', 'Plucky', 'Plum', 'Plush', 'Polar',
+    'Polite', 'Prairie', 'Proud', 'Prudent', 'Punchy', 'Purple', 'Quaint', 'Quick',
+    'Quiet', 'Radiant', 'Rainy', 'Rapid', 'Rare', 'Ready', 'Ripe', 'River',
+    'Rocky', 'Rosy', 'Royal', 'Ruby', 'Rugged', 'Rustic', 'Saffron', 'Sage',
+    'Sandy', 'Sapphire', 'Scarlet', 'Serene', 'Shady', 'Sharp', 'Shy', 'Silent',
+    'Silken', 'Silky', 'Silver', 'Sincere', 'Sleek', 'Sleepy', 'Slender', 'Small',
+    'Smart', 'Smiling', 'Snowy', 'Solar', 'Solid', 'Sonic', 'Soulful', 'Speedy',
+    'Spirited', 'Splendid', 'Sprightly', 'Spry', 'Starry', 'Steady', 'Stellar',
+    'Sterling', 'Stormy', 'Stout', 'Sunny', 'Sunset', 'Swift', 'Tangy', 'Teal',
+    'Tender', 'Thankful', 'Thoughtful', 'Thrifty', 'Tidy', 'Timber', 'Tiny',
+    'Topaz', 'Tranquil', 'Trusty', 'Turquoise', 'Twilight', 'Upright', 'Valiant',
+    'Velvet', 'Verdant', 'Violet', 'Vivid', 'Warm', 'Whimsical', 'Willow',
+    'Windy', 'Winsome', 'Wise', 'Witty', 'Woodland', 'Woolly', 'Zealous', 'Zesty',
+];
+// 250 friendly animals. Common, recognisable, unambiguously non-threatening
+// (no predators-of-humans, no venomous ones, no polarising taxidermy). Two-
+// word species (mountain goat, sea otter) are collapsed to the base name so
+// the final "Adjective Animal" reads cleanly. Ordering is alphabetical.
+const ANIMALS = [
+    'Alpaca', 'Anteater', 'Antelope', 'Ape', 'Armadillo', 'Auk', 'Aurochs',
+    'Axolotl', 'Baboon', 'Badger', 'Barnacle', 'Bat', 'Beagle', 'Bear', 'Beaver',
+    'Bee', 'Beetle', 'Bison', 'Blackbird', 'Bluebird', 'Boar', 'Bobcat', 'Bonobo',
+    'Booby', 'Buffalo', 'Bulldog', 'Bullfinch', 'Bumblebee', 'Butterfly', 'Camel',
+    'Capybara', 'Cardinal', 'Caribou', 'Cassowary', 'Cat', 'Caterpillar',
+    'Catfish', 'Chameleon', 'Chamois', 'Cheetah', 'Chickadee', 'Chinchilla',
+    'Chipmunk', 'Clam', 'Clownfish', 'Coati', 'Cobra', 'Cockatoo', 'Codfish',
+    'Colt', 'Condor', 'Coot', 'Cormorant', 'Corgi', 'Cougar', 'Cow', 'Coyote',
+    'Crab', 'Crane', 'Cricket', 'Crow', 'Cub', 'Cuckoo', 'Curlew', 'Deer',
+    'Dingo', 'Dolphin', 'Donkey', 'Dormouse', 'Dove', 'Dragonfly', 'Drake',
+    'Duck', 'Duckling', 'Eagle', 'Echidna', 'Eel', 'Egret', 'Elephant', 'Elk',
+    'Emu', 'Falcon', 'Fawn', 'Ferret', 'Finch', 'Firefly', 'Fish', 'Flamingo',
+    'Fox', 'Frog', 'Gecko', 'Gerbil', 'Gibbon', 'Giraffe', 'Gnu', 'Goat',
+    'Godwit', 'Goldfinch', 'Goldfish', 'Goose', 'Gorilla', 'Grebe', 'Griffon',
+    'Grouse', 'Guanaco', 'Guineafowl', 'Gull', 'Guppy', 'Hamster', 'Hare',
+    'Harrier', 'Hawk', 'Hedgehog', 'Heron', 'Herring', 'Hippo', 'Hoatzin',
+    'Hoopoe', 'Hornbill', 'Horse', 'Hound', 'Hummingbird', 'Ibex', 'Ibis',
+    'Iguana', 'Impala', 'Jackal', 'Jackrabbit', 'Jaguar', 'Jay', 'Jellyfish',
+    'Kakapo', 'Kangaroo', 'Kestrel', 'Kingfisher', 'Kinkajou', 'Kite', 'Kitten',
+    'Kiwi', 'Koala', 'Kookaburra', 'Ladybug', 'Lamb', 'Lapwing', 'Lark',
+    'Lemming', 'Lemur', 'Leopard', 'Lion', 'Lizard', 'Llama', 'Lobster',
+    'Lorikeet', 'Loris', 'Lynx', 'Macaque', 'Macaw', 'Magpie', 'Mallard',
+    'Manatee', 'Mandrill', 'Mantis', 'Marmoset', 'Marmot', 'Marten', 'Meerkat',
+    'Mink', 'Minnow', 'Mole', 'Mongoose', 'Monkey', 'Moose', 'Moth', 'Mouse',
+    'Mule', 'Muntjac', 'Muskrat', 'Narwhal', 'Newt', 'Nightingale', 'Numbat',
+    'Nuthatch', 'Ocelot', 'Octopus', 'Okapi', 'Opossum', 'Orangutan', 'Oriole',
+    'Ostrich', 'Otter', 'Owl', 'Ox', 'Oyster', 'Panda', 'Pangolin', 'Panther',
+    'Parakeet', 'Parrot', 'Partridge', 'Peacock', 'Pelican', 'Penguin', 'Perch',
+    'Pheasant', 'Pig', 'Pigeon', 'Piglet', 'Pika', 'Pipit', 'Platypus', 'Plover',
+    'Pointer', 'Polecat', 'Pony', 'Porcupine', 'Porpoise', 'Possum', 'Prawn',
+    'Ptarmigan', 'Puffin', 'Puma', 'Pup', 'Puppy', 'Quail', 'Quokka', 'Rabbit',
+    'Raccoon', 'Ram', 'Rat', 'Raven', 'Reindeer', 'Rhino', 'Roadrunner', 'Robin',
+    'Rook', 'Salamander', 'Salmon', 'Sandpiper', 'Sardine', 'Scallop', 'Seahorse',
+    'Seal', 'Serval', 'Shrew', 'Shrimp', 'Skunk', 'Sloth', 'Snail', 'Snake',
+    'Snipe', 'Sparrow', 'Spider', 'Squid', 'Squirrel', 'Starling', 'Stoat',
+    'Stork', 'Sturgeon', 'Swallow', 'Swan', 'Tamarin', 'Tanager', 'Tapir',
+    'Tarsier', 'Teal', 'Tern', 'Terrier', 'Thrush', 'Tiger', 'Toad', 'Toucan',
+    'Trout', 'Tuna', 'Turkey', 'Turtle', 'Vole', 'Wagtail', 'Walrus', 'Wapiti',
+    'Warbler', 'Wasp', 'Weasel', 'Whale', 'Whippet', 'Wolf', 'Wolverine',
+    'Wombat', 'Woodchuck', 'Woodpecker', 'Wren', 'Yak', 'Zebra',
+];
+// Total combinations = ADJECTIVES.length * ANIMALS.length. Exposed for
+// diagnostics and for tests that want to assert the name space is large
+// enough to cover the expected ceiling of licenses × cap.
+export const SEAT_NAME_COMBINATIONS = ADJECTIVES.length * ANIMALS.length;
+// FNV-1a — a fast, non-cryptographic 32-bit hash. Uniform enough over 250
+// buckets that the modulo bias (~1 in 17M) is invisible in practice. Not
+// used for security; just to derive a stable pair of small indices from
+// the seat's on-chain identity fields.
+function fnv1a(s, seed) {
+    let h = seed >>> 0;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return h >>> 0;
+}
+export function seatNameFor(input) {
+    const key = `${input.licenseHash}|${input.slotIndex}|${input.boundAtSlot}`;
+    const adj = ADJECTIVES[fnv1a(key, 0x811c9dc5) % ADJECTIVES.length];
+    const animal = ANIMALS[fnv1a(key, 0xdeadbeef) % ANIMALS.length];
+    return `${adj} ${animal}`;
+}
+//# sourceMappingURL=seatName.js.map

package/build/seatName.js.map

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

package/build/slotConstants.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Slot math of the licensing contract (90 s per slot after the Mesa
+ * upgrade), as plain numbers. No o1js: the package root imports these, and
+ * o1js is an optional peer dependency (README, Publishing to npm).
+ * contractInterface re-exports them.
+ */
+export declare const MONTHLY_SLOTS_N = 28800;
+export declare const ONE_YEAR_SLOTS_N = 350640;
+export declare const FIVE_YEAR_SLOTS_N = 1753200;
+export declare const PERPETUAL_SLOTS_N = 350640000;
+export declare const REFUND_WINDOW_N = 13440;
+export declare const GRACE_PERIOD_N = 6720;
+export declare const MS_PER_SLOT_N = 90000;
+export declare const SLOTS_PER_DAY_N = 960;
+//# sourceMappingURL=slotConstants.d.ts.map

package/build/slotConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slotConstants.d.ts","sourceRoot":"","sources":["../src/slotConstants.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,eAAO,MAAM,eAAe,QAAY,CAAC;AACzC,eAAO,MAAM,gBAAgB,SAAY,CAAC;AAC1C,eAAO,MAAM,iBAAiB,UAAa,CAAC;AAC5C,eAAO,MAAM,iBAAiB,YAAe,CAAC;AAC9C,eAAO,MAAM,eAAe,QAAY,CAAC;AACzC,eAAO,MAAM,cAAc,OAAY,CAAC;AACxC,eAAO,MAAM,aAAa,QAAc,CAAC;AACzC,eAAO,MAAM,eAAe,MAAS,CAAC"}

package/build/slotConstants.js

@@ -0,0 +1,17 @@
+// Copyright (c) 2025-2026 zkLicensing project developers
+// SPDX-License-Identifier: BUSL-1.1
+/**
+ * Slot math of the licensing contract (90 s per slot after the Mesa
+ * upgrade), as plain numbers. No o1js: the package root imports these, and
+ * o1js is an optional peer dependency (README, Publishing to npm).
+ * contractInterface re-exports them.
+ */
+export const MONTHLY_SLOTS_N = 28_800; // 30 days × 24 × 40
+export const ONE_YEAR_SLOTS_N = 350_640; // 365.25 days × 24 × 40 (Julian year)
+export const FIVE_YEAR_SLOTS_N = 1_753_200; // 5 × ONE_YEAR_SLOTS_N
+export const PERPETUAL_SLOTS_N = 350_640_000; // 1000 × ONE_YEAR_SLOTS_N ("perpetual — until vendor sunset")
+export const REFUND_WINDOW_N = 13_440;
+export const GRACE_PERIOD_N = 6_720;
+export const MS_PER_SLOT_N = 90_000; // Mesa slot duration in ms
+export const SLOTS_PER_DAY_N = 960; // 86_400_000 / MS_PER_SLOT_N
+//# sourceMappingURL=slotConstants.js.map

package/build/slotConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slotConstants.js","sourceRoot":"","sources":["../src/slotConstants.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,oCAAoC;AAEpC;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAM,MAAM,CAAC,CAAM,oBAAoB;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAAK,OAAO,CAAC,CAAK,sCAAsC;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAI,SAAS,CAAC,CAAG,uBAAuB;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAI,WAAW,CAAC,CAAC,8DAA8D;AAC7G,MAAM,CAAC,MAAM,eAAe,GAAM,MAAM,CAAC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAO,KAAK,CAAC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAQ,MAAM,CAAC,CAAI,2BAA2B;AACxE,MAAM,CAAC,MAAM,eAAe,GAAM,GAAG,CAAC,CAAO,6BAA6B"}

package/build/statsClient.d.ts

@@ -1,16 +1,17 @@
 /**
  * statsClient.ts
  *
- * Browser-safe HTTP client for the vendor-facing keeper endpoints that back
+ * Browser-safe HTTP client for the vendor-facing backend endpoints that back
  * the dashboard: GET /stats, GET /transactions, and GET /apps/vendor/:addr.
  *
- * Types mirror the keeper's response shapes so a dashboard implementation
+ * Types mirror the backend's response shapes so a dashboard implementation
  * (this repo's zklicensing.com dashboard or a third-party one) doesn't have
  * to re-derive them. New optional fields on the server should be added here
- * as `?:` so older clients still typecheck against a newer keeper.
+ * as `?:` so older clients still typecheck against a newer backend.
  */
 import type { CountryBreakdown } from './countryStats.js';
-export type Tier = 'monthly' | 'yearly' | 'fiveYear';
+import type { FiatRateSnapshot } from './licenseRecord.js';
+export type Tier = 'monthly' | 'yearly' | 'fiveYear' | 'perpetual';
 export type AppRecord = {
     appId: string;
     name: string;
@@ -18,12 +19,13 @@ export type AppRecord = {
     longDescription?: string;
     category: string;
     website: string;
-    zkAppAddress: string;
+    zkAppAddress?: string;
     vendorAddress: string;
     priceMonthlyMina: number;
     priceYearlyMina: number;
     priceFiveYearMina: number;
-    txHash: string;
+    pricePerpetualMina: number;
+    txHash?: string;
     verificationKeyHash?: string;
     logo?: string;
     iconUrl?: string;
@@ -31,13 +33,40 @@ export type AppRecord = {
     contactEmail?: string;
     supportEmail?: string;
     country?: string;
-    status?: 'pending' | 'active' | 'inactive' | 'rejected';
+    status?: 'pending' | 'active' | 'inactive' | 'rejected' | 'not-deployed';
     rejectionReason?: string;
     createdAt: string;
     approvedAt?: string;
+    network?: 'devnet' | 'mainnet';
+    alsoOnNetworks?: ('devnet' | 'mainnet')[];
+    firstEventSlot?: number;
+    lastSyncedSlot?: number;
+    onChainVersion?: number;
+    deploymentHistory?: unknown[];
     pendingEdit?: Partial<AppRecord> & {
         editedAt: string;
     };
+    statusHistory?: {
+        status: string;
+        at: string;
+        actor: string;
+        note?: string;
+    }[];
+    legalName?: string;
+    billingAddress?: {
+        line1: string;
+        line2?: string;
+        city: string;
+        postalCode: string;
+    };
+    invoiceEmail?: string;
+    vatId?: string;
+    companyRegistrationRegistry?: string;
+    companyRegistrationNumber?: string;
+    termsOfServiceUrl?: string;
+    privacyPolicyUrl?: string;
+    refundPolicyUrl?: string;
+    registrationFeeMina?: number;
 };
 export type VendorStatsResponse = {
     apps: AppRecord[];
@@ -45,6 +74,7 @@ export type VendorStatsResponse = {
     totalLicenses: number;
     totalRevenueMina: number;
     pendingRevenueMina?: number;
+    refundedRevenueMina?: number;
     renewalRate: number | null;
     monthlyRevenueMina: {
         month: string;
@@ -54,6 +84,7 @@ export type VendorStatsResponse = {
         monthly: number;
         yearly: number;
         fiveYear: number;
+        perpetual: number;
     };
     deltas: {
         revenuePct: number | null;
@@ -64,10 +95,21 @@ export type Transaction = {
     type: 'purchase' | 'renewal' | 'release' | 'refund';
     appId: string;
     appName: string;
+    vendorAddress?: string;
     tier: Tier | null;
     amountMina: number;
     txHash: string;
     date: string;
+    buyerCountry?: string;
+    buyerZip?: string;
+    ipCountry?: string | null;
+    fiatSnapshot?: FiatRateSnapshot;
+    waiverGivenBy?: {
+        agent: string;
+        owner: string;
+        statementSha256: string;
+        issuedAt: string;
+    };
 };
 export type TransactionsResponse = {
     transactions: Transaction[];
@@ -78,19 +120,31 @@ export type VendorAppsResponse = {
 export declare function fetchVendorStats(opts: {
     keeperUrl: string;
     vendorAddress: string;
+    network: 'devnet' | 'mainnet';
+    adminToken?: string;
+    vendorSessionToken?: string;
+    tzOffsetMinutes?: number;
     fetcher?: typeof fetch;
     signal?: AbortSignal;
 }): Promise<VendorStatsResponse | null>;
 export declare function fetchTransactions(opts: {
     keeperUrl: string;
     vendorAddress: string;
+    network: 'devnet' | 'mainnet';
+    adminToken?: string;
+    vendorSessionToken?: string;
     days?: number;
+    from?: string;
+    to?: string;
     fetcher?: typeof fetch;
     signal?: AbortSignal;
 }): Promise<TransactionsResponse | null>;
 export declare function fetchVendorApps(opts: {
     keeperUrl: string;
     vendorAddress: string;
+    adminToken?: string;
+    vendorSessionToken?: string;
+    network?: 'devnet' | 'mainnet';
     fetcher?: typeof fetch;
     signal?: AbortSignal;
 }): Promise<VendorAppsResponse | null>;

package/build/statsClient.d.ts.map

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

package/build/statsClient.js

@@ -1,26 +1,65 @@
 // Copyright (c) 2025-2026 zkLicensing project developers
-// All rights reserved.
+// SPDX-License-Identifier: BUSL-1.1
 function baseUrl(url) {
     return url.replace(/\/+$/, '');
 }
+// Admin __all mode: pass `adminToken` and omit `vendorAddress` (or pass '__all').
+// Fetches aggregate over every registered app. Server gates with Bearer auth.
+// tzOffsetMinutes: signed minutes east of UTC — shifts tax-year cutovers on the
+// countryBreakdown so a UK vendor's 2026 doesn't include a Dec 31 23:30 PST
+// purchase. Default omitted → UTC bucketing preserved for existing callers.
 export async function fetchVendorStats(opts) {
     const fetcher = opts.fetcher ?? fetch;
-    const resp = await fetcher(`${baseUrl(opts.keeperUrl)}/stats?vendor=${encodeURIComponent(opts.vendorAddress)}`, { signal: opts.signal });
+    const headers = {};
+    if (opts.adminToken)
+        headers.Authorization = `Bearer ${opts.adminToken}`;
+    else if (opts.vendorSessionToken)
+        headers.Authorization = `VendorSession ${opts.vendorSessionToken}`;
+    const tzQ = typeof opts.tzOffsetMinutes === 'number' ? `&tz=${opts.tzOffsetMinutes}` : '';
+    const resp = await fetcher(`${baseUrl(opts.keeperUrl)}/stats?vendor=${encodeURIComponent(opts.vendorAddress)}&network=${opts.network}${tzQ}`, { signal: opts.signal, headers });
     if (!resp.ok)
         return null;
     return await resp.json();
 }
 export async function fetchTransactions(opts) {
     const fetcher = opts.fetcher ?? fetch;
-    const days = opts.days ?? 30;
-    const resp = await fetcher(`${baseUrl(opts.keeperUrl)}/transactions?vendor=${encodeURIComponent(opts.vendorAddress)}&days=${days}`, { signal: opts.signal });
+    const headers = {};
+    if (opts.adminToken)
+        headers.Authorization = `Bearer ${opts.adminToken}`;
+    else if (opts.vendorSessionToken)
+        headers.Authorization = `VendorSession ${opts.vendorSessionToken}`;
+    const qs = new URLSearchParams({ vendor: opts.vendorAddress, network: opts.network });
+    if (opts.from && opts.to) {
+        qs.set('from', opts.from);
+        qs.set('to', opts.to);
+    }
+    else {
+        qs.set('days', String(opts.days ?? 30));
+    }
+    const resp = await fetcher(`${baseUrl(opts.keeperUrl)}/transactions?${qs.toString()}`, { signal: opts.signal, headers });
     if (!resp.ok)
         return null;
     return await resp.json();
 }
+// Admin all-apps mode: pass `adminToken` and set `vendorAddress` to '__all'.
+// Hits GET /apps (no auth needed today; the admin overload just uses a
+// different URL) so vendors visiting their own dashboard still hit the same
+// per-vendor endpoint.
 export async function fetchVendorApps(opts) {
     const fetcher = opts.fetcher ?? fetch;
-    const resp = await fetcher(`${baseUrl(opts.keeperUrl)}/apps/vendor/${encodeURIComponent(opts.vendorAddress)}`, { signal: opts.signal });
+    const headers = {};
+    if (opts.adminToken)
+        headers.Authorization = `Bearer ${opts.adminToken}`;
+    else if (opts.vendorSessionToken)
+        headers.Authorization = `VendorSession ${opts.vendorSessionToken}`;
+    const isAdminAll = opts.adminToken && opts.vendorAddress === '__all';
+    if (!isAdminAll && !opts.network) {
+        throw new Error("fetchVendorApps: `network` is required for the per-vendor path");
+    }
+    const url = isAdminAll
+        ? `${baseUrl(opts.keeperUrl)}/apps?all=1`
+        : `${baseUrl(opts.keeperUrl)}/apps/vendor/${encodeURIComponent(opts.vendorAddress)}?network=${opts.network}`;
+    const resp = await fetcher(url, { signal: opts.signal, headers });
     if (!resp.ok)
         return null;
     return await resp.json();

package/build/statsClient.js.map

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

package/build/successorChain.d.ts

@@ -0,0 +1,35 @@
+import { type ZkappAccount } from './chainHead.js';
+/** Where a contract kind keeps its lineage in state. */
+export type LineageLayout = {
+    /** Contract name for error messages. */
+    name: string;
+    /** State index and value that mark the contract retired. */
+    retiredAt: number;
+    retiredValue: string;
+    /** The tree root a retirement freezes, and where a successor keeps the root it started from. */
+    rootAt: number;
+    ancestorsRootAt: number;
+    successorXAt: number;
+    successorIsOddAt: number;
+};
+export declare const LICENSING_LINEAGE: LineageLayout;
+/** A retired registry's authority-keys hash is RETIRED_KEYS_HASH (1). */
+export declare const PERMIT_LINEAGE: LineageLayout;
+export declare const MAX_LINEAGE_HOPS = 32;
+/**
+ * Follows `start`'s successors to the current contract. Returns it with
+ * its account (`found: false` when `start` isn't on chain). Throws when a
+ * named successor is deployed but isn't a published release (`canonicalVks`)
+ * or didn't start from the frozen root.
+ */
+export declare function currentOnChain(args: {
+    start: string;
+    layout: LineageLayout;
+    canonicalVks: readonly string[];
+    graphqlUrl: string;
+    fetcher?: typeof fetch;
+}): Promise<{
+    address: string;
+    account: ZkappAccount;
+}>;
+//# sourceMappingURL=successorChain.d.ts.map

package/build/successorChain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"successorChain.d.ts","sourceRoot":"","sources":["../src/successorChain.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAIrE,wDAAwD;AACxD,MAAM,MAAM,aAAa,GAAG;IAC1B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gGAAgG;IAChG,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,aAK/B,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,cAAc,EAAE,aAK5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAsBtD"}

package/build/successorChain.js

@@ -0,0 +1,69 @@
+// Copyright (c) 2025-2026 zkLicensing project developers
+// SPDX-License-Identifier: BUSL-1.1
+/**
+ * successorChain.ts — the current contract of a lineage (licensing app
+ * generations, permit registry generations), from chain state alone.
+ *
+ * A retired contract names its successor in its state (its retirement,
+ * which the vendor or authority signed, stored it), and the successor's
+ * initialization checked on chain that the predecessor named it. Each hop
+ * here also checks the successor runs a published release and started
+ * from the predecessor's frozen root. A successor not deployed yet
+ * (between retirement and deployment, e.g. across a hard fork) leaves the
+ * retired contract current.
+ */
+import { Field, PublicKey } from 'o1js';
+import { readZkappAccount } from './chainHead.js';
+import { LICENSING_APP_STATE } from './contractInterface.js';
+import { PERMIT_REGISTRY_STATE } from './permitInterface.js';
+export const LICENSING_LINEAGE = {
+    name: 'LicensingApp',
+    retiredAt: LICENSING_APP_STATE.retired, retiredValue: '1',
+    rootAt: LICENSING_APP_STATE.licensesRoot, ancestorsRootAt: LICENSING_APP_STATE.ancestorsRoot,
+    successorXAt: LICENSING_APP_STATE.successorX, successorIsOddAt: LICENSING_APP_STATE.successorIsOdd,
+};
+/** A retired registry's authority-keys hash is RETIRED_KEYS_HASH (1). */
+export const PERMIT_LINEAGE = {
+    name: 'PermitRegistry',
+    retiredAt: PERMIT_REGISTRY_STATE.authorityKeysHash, retiredValue: '1',
+    rootAt: PERMIT_REGISTRY_STATE.permitsRoot, ancestorsRootAt: PERMIT_REGISTRY_STATE.ancestorsRoot,
+    successorXAt: PERMIT_REGISTRY_STATE.successorX, successorIsOddAt: PERMIT_REGISTRY_STATE.successorIsOdd,
+};
+export const MAX_LINEAGE_HOPS = 32;
+/**
+ * Follows `start`'s successors to the current contract. Returns it with
+ * its account (`found: false` when `start` isn't on chain). Throws when a
+ * named successor is deployed but isn't a published release (`canonicalVks`)
+ * or didn't start from the frozen root.
+ */
+export async function currentOnChain(args) {
+    const { layout: l } = args;
+    const read = (address) => readZkappAccount({ address, graphqlUrl: args.graphqlUrl, fetcher: args.fetcher });
+    let address = args.start;
+    let account = await read(address);
+    for (let hop = 0; hop < MAX_LINEAGE_HOPS; hop++) {
+        const st = account.appState;
+        if (!account.found || !st || st[l.retiredAt] !== l.retiredValue)
+            return { address, account };
+        let next;
+        try {
+            next = PublicKey.fromFields([Field(st[l.successorXAt]), Field(st[l.successorIsOddAt])]).toBase58();
+        }
+        catch {
+            return { address, account };
+        }
+        const succ = await read(next);
+        if (!succ.found || !succ.appState)
+            return { address, account }; // not deployed yet
+        if (!succ.vkHash || !args.canonicalVks.includes(succ.vkHash)) {
+            throw new Error(`The successor ${next} of ${address} is not a published ${l.name} release`);
+        }
+        if (succ.appState[l.ancestorsRootAt] !== st[l.rootAt]) {
+            throw new Error(`The successor ${next} of ${address} did not start from its frozen root`);
+        }
+        address = next;
+        account = succ;
+    }
+    throw new Error(`${l.name} lineage of ${args.start} is longer than ${MAX_LINEAGE_HOPS} generations`);
+}
+//# sourceMappingURL=successorChain.js.map

package/build/successorChain.js.map

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

package/build/taxId.d.ts

@@ -0,0 +1,44 @@
+/**
+ * taxId.ts — `zklicensing/tax-id`
+ *
+ * Vendor tax identifiers: every vendor must have one. This module checks
+ * the format (and, where the scheme has one, the check digit) for the
+ * vendor's country, offline. EU VAT numbers are additionally looked up in
+ * VIES by the keeper; this module only says which numbers go to VIES.
+ *
+ *   checkTaxId('FI', 'FI 1234 5678')  → { ok, scheme: 'eu-vat', normalized: 'FI12345678', vies: { countryCode: 'FI', number: '12345678' } }
+ *   checkTaxId('NO', '974 760 673 MVA') → { ok, scheme: 'no-mva', normalized: 'NO974760673MVA' }
+ *   checkTaxId('BR', '…')              → { ok, scheme: 'other', review: true }   (no known format: admin review)
+ *
+ * Pure and browser-safe: the site uses it for live form feedback.
+ */
+export type TaxIdScheme = 'eu-vat' | 'gb-vat' | 'no-mva' | 'ch-uid' | 'au-abn' | 'nz-gst' | 'ca-bn' | 'us-ein' | 'jp-invoice' | 'in-gstin' | 'sg-gst' | 'other';
+export type TaxIdResult = {
+    ok: true;
+    scheme: TaxIdScheme;
+    /** Canonical form to store and show. */
+    normalized: string;
+    /** EU numbers only: what to look up in VIES (Greece is `EL`, Northern Ireland `XI`). */
+    vies?: {
+        countryCode: string;
+        number: string;
+    };
+    /** True when the country has no known format: accepted for an admin to review. */
+    review?: boolean;
+} | {
+    ok: false;
+    scheme: TaxIdScheme;
+    error: string;
+    example?: string;
+};
+/** True for the 27 EU member states (ISO codes; Greece is GR here). */
+export declare function isEuCountry(country: string): boolean;
+/** An example of the expected format for `country`, for form placeholders. */
+export declare function taxIdExample(country: string): string;
+/**
+ * Checks `taxId` for a vendor in `country` (ISO 3166-1 alpha-2): the format
+ * and, where the scheme has one, the check digit. Spaces, dots and dashes
+ * are ignored; letters are upper-cased.
+ */
+export declare function checkTaxId(country: string, taxId: string): TaxIdResult;
+//# sourceMappingURL=taxId.d.ts.map

package/build/taxId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxId.d.ts","sourceRoot":"","sources":["../src/taxId.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,WAAW,GACnB,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GACzE,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE9D,MAAM,MAAM,WAAW,GACnB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,WAAW,CAAC;IACpB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,IAAI,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,kFAAkF;IAClF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAiCxE,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQpD;AAsDD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAuFtE"}