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

package/build/agentVendor.js

@@ -0,0 +1,306 @@
+// Copyright (c) 2025-2026 zkLicensing project developers
+// SPDX-License-Identifier: BUSL-1.1
+/**
+ * agentVendor.ts — part of `zklicensing/agent/actions`
+ *
+ * A vendor run by an AI agent: the agent's key is the vendor wallet (it
+ * receives the payments and signs for the app), acting for its owner.
+ *
+ *   acceptVendorTerms   the Vendor Terms and legal details, under a standing
+ *                       consent covering vendor-terms (recorded as given by
+ *                       the agent)
+ *   registerApp         deploys the app's contract (paying the registration
+ *                       fee; the consent covers its withdrawal waiver) and
+ *                       lists it
+ *   setPrices           changes the tier prices on chain
+ *   updateListing       edits the listing (re-reviewed on mainnet)
+ *   updateDetails       changes the legal details on every app
+ *   status, feeStatement, trustManifest
+ *
+ * Every step checks the owner's policy (allowed actions, networks, targets,
+ * per-action and daily caps); paying steps return a signed action record.
+ * What an agent cannot do: host files on the vendor's own website (the
+ * trust manifest, and on mainnet the vendor's buy, renew and refund pages).
+ */
+import { AgentError } from './agent.js';
+import { checkActionPolicy, consentFor, } from './agentActions.js';
+import { signActionRecord, policyHash } from './agentRecord.js';
+/** Registration fee per network (MINA), as the keeper charges it; plus 1 MINA account creation and the transaction fee. */
+export const REGISTRATION_FEE_MINA = { devnet: 10, mainnet: 1200 };
+const VENDOR_TC_ORIGIN = 'https://zklicensing.com';
+/** The vendor acceptance text the wallet signs (the keeper derives the same). */
+export function vendorAcceptanceMessage(f) {
+    return [
+        'I accept the zkLicensing Vendor Terms of Service.',
+        '',
+        `Document: ${f.terms.title}`,
+        `Version: ${f.terms.version}`,
+        `Published: ${VENDOR_TC_ORIGIN}${f.terms.archiveUrl}`,
+        `Fingerprint: ${f.terms.documentHash}`,
+        '',
+        `Legal entity: ${f.legalName}`,
+        `Country: ${f.country}`,
+        f.vatId.length > 0 ? `VAT: ${f.vatId}` : 'VAT: (not registered)',
+        `Billing address: ${f.billingHash}`,
+        '',
+        `Signed by wallet: ${f.vendorAddress}`,
+        `Accepted at (UTC): ${f.acceptedAt}`,
+    ].join('\n');
+}
+/** "sha256:<hex>" of the billing address in the keeper's fixed key order. */
+export async function billingHash(a) {
+    const canonical = JSON.stringify({ line1: a.line1, line2: a.line2 ?? '', city: a.city, postalCode: a.postalCode });
+    const d = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(canonical));
+    return 'sha256:' + [...new Uint8Array(d)].map(b => b.toString(16).padStart(2, '0')).join('');
+}
+export function createVendorAgent(opts) {
+    const base = opts.keeperUrl.replace(/\/+$/, '');
+    const f = opts.fetcher ?? fetch;
+    const net = opts.network;
+    const w = opts.wallet;
+    const site = opts.siteUrl ?? (net === 'mainnet' ? 'https://zklicensing.com' : 'https://dev.zklicensing.com');
+    let permits = null;
+    // The wallet sign-in (VendorSession) the vendor endpoints need: the same one the permits client makes.
+    const session = async () => (await (permits ??= import('./permitsClient.js').then(m => m.createPermitsClient({ keeperUrl: opts.keeperUrl, network: net, wallet: w, fetcher: opts.fetcher })))).signIn();
+    async function call(method, path, body, auth = false) {
+        const headers = { Accept: 'application/json' };
+        if (body !== undefined)
+            headers['Content-Type'] = 'application/json';
+        if (auth)
+            headers.Authorization = `VendorSession ${await session()}`;
+        const r = await f(base + path, { method, headers, body: body === undefined ? undefined : JSON.stringify(body) });
+        const text = await r.text();
+        let j = null;
+        try {
+            j = text ? JSON.parse(text) : null;
+        }
+        catch {
+            j = text;
+        }
+        if (!r.ok)
+            throw new AgentError(j?.error ?? `HTTP ${r.status}`, j?.code ?? (r.status === 404 ? 'NOT_FOUND' : 'HTTP_ERROR'), r.status, r.status >= 500);
+        return j;
+    }
+    /** The owner's standing consent covering vendor-terms (fails closed, as for buyers). */
+    const vendorConsent = () => consentFor({
+        requiresConsent: ['vendor-terms'], agentMayConsent: true, approvalUrl: `${site}/register.html`, network: net,
+    }, w.address, opts.consent, { keeperUrl: opts.keeperUrl, fetcher: opts.fetcher });
+    const toMinaNano = (m) => BigInt(Math.round(m * 1e9));
+    async function record(action, a) {
+        try {
+            const actionRecord = await signActionRecord(w, {
+                network: net, action, target: a.target, reference: a.reference, summary: a.summary,
+                amounts: { total: a.totalNano.toString(), toRecipient: a.totalNano.toString(), toPlatform: a.totalNano.toString(), recipient: 'zkLicensing platform' },
+                txHash: a.txHash, receipt: null, policySha256: await policyHash(opts.policy),
+                consent: a.consent.givenBy === 'agent' ? { givenBy: 'agent', statementSha256: a.consent.statementSha256, kinds: [...a.consent.kinds] } : { givenBy: 'none' },
+                at: new Date().toISOString(),
+            });
+            return { actionRecord, warnings: [] };
+        }
+        catch (e) {
+            return { warnings: [`The action record could not be signed (${e?.message ?? e}).`] };
+        }
+    }
+    /** Refuses an App ID this wallet can't register on this network (taken, or its prefix reserved by another vendor). */
+    async function appIdFree(appId) {
+        const r = await (opts.fetcher ?? fetch)(`${opts.keeperUrl.replace(/\/+$/, '')}/apps/${encodeURIComponent(appId)}?network=${net}&vendor=${encodeURIComponent(w.address)}`);
+        const b = await r.json().catch(() => null);
+        if (r.status === 409)
+            throw new AgentError(b?.error ?? `App ID prefix of "${appId}" is reserved by another vendor`, 'APP_ID_PREFIX_RESERVED', 409, false);
+        if (r.ok)
+            throw new AgentError(`App ID "${appId}" is already registered on ${net}`, 'APP_ID_TAKEN', 409, false);
+        if (r.status === 404 && b?.ownedBy && b.ownedBy !== w.address)
+            throw new AgentError(`App ID "${appId}" belongs to another vendor`, 'APP_ID_TAKEN', 409, false);
+        if (r.status !== 404)
+            throw new AgentError(b?.error ?? `Could not check App ID "${appId}" (${r.status})`, 'UPSTREAM_UNAVAILABLE', r.status, true);
+    }
+    return {
+        address: w.address,
+        /** The Vendor Terms and legal details, signed by the agent key for its owner. */
+        async acceptVendorTerms(legal, terms) {
+            checkActionPolicy(opts.policy, { action: 'accept-vendor-terms', network: net });
+            await vendorConsent();
+            const acceptedAt = new Date().toISOString();
+            const signedMessage = vendorAcceptanceMessage({
+                vendorAddress: w.address, terms, legalName: legal.legalName, country: legal.country, vatId: legal.vatId,
+                billingHash: await billingHash(legal.billingAddress), acceptedAt,
+            });
+            const signature = await w.signMessage(signedMessage);
+            return call('POST', '/vendors/accept', {
+                vendorAddress: w.address, network: net, tcVersion: terms.version, tcDocumentHash: terms.documentHash, acceptedAt,
+                signature, signedMessage, legal, agentConsent: opts.consent,
+            });
+        },
+        /** Review status on this network, the terms accepted and the tax ID check. */
+        status: () => call('GET', `/vendors/${w.address}/tos?network=${net}`, undefined, true),
+        /** Changes the legal details on every app the vendor owns. */
+        async updateDetails(legal) {
+            checkActionPolicy(opts.policy, { action: 'update-vendor-details', network: net });
+            return call('PATCH', `/vendors/${w.address}/legal`, { payload: legal }, true);
+        },
+        /**
+         * Deploys the app's contract (the agent wallet pays the registration fee:
+         * the owner's policy caps it, the standing consent covers its withdrawal
+         * waiver) and lists it. The legal details are the ones signed in
+         * acceptVendorTerms (changed with updateDetails), never given per app.
+         */
+        async registerApp(listing) {
+            const feeNano = toMinaNano(REGISTRATION_FEE_MINA[net] + 1);
+            checkActionPolicy(opts.policy, { action: 'register-app', network: net, amountNano: feeNano }, opts.ledger);
+            const consent = await vendorConsent();
+            const p = listing.prices;
+            if (![p.monthly, p.yearly, p.fiveYear, p.perpetual].some(x => x > 0))
+                throw new AgentError('At least one tier needs a price above 0', 'INVALID_REQUEST', 0, false);
+            if (!/^https:\/\//.test(listing.website))
+                throw new AgentError('website must be an https:// URL (it is written into the contract)', 'INVALID_REQUEST', 0, false);
+            await appIdFree(listing.appId); // before anything is signed or paid: the listing can't then be refused for it
+            const appSig = await w.signMessage(listing.appId);
+            await session(); // sign in before paying: the listing step needs it
+            const { proveDeploy } = await import('./deployClient.js');
+            const proved = await proveDeploy({
+                keeperUrl: opts.keeperUrl, senderPublicKey: w.address, vendorAddress: w.address,
+                priceMonthlyMina: p.monthly, priceYearlyMina: p.yearly, priceFiveYearMina: p.fiveYear, pricePerpetualMina: p.perpetual,
+                deviceCap: listing.deviceCap ?? 0, website: listing.website, network: net, fetcher: opts.fetcher,
+            });
+            const waiverAt = new Date().toISOString();
+            const txHash = await w.signAndSendTransaction(proved.provenTxJson);
+            opts.ledger?.record(feeNano);
+            const warnings = [];
+            await call('POST', '/apps', {
+                appId: listing.appId, name: listing.name, description: listing.description, longDescription: listing.longDescription ?? '',
+                category: listing.category, website: listing.website, zkAppAddress: proved.zkAppAddress, vendorAddress: w.address,
+                priceMonthlyMina: p.monthly, priceYearlyMina: p.yearly, priceFiveYearMina: p.fiveYear, pricePerpetualMina: p.perpetual,
+                deviceCap: listing.deviceCap ?? 0, txHash, verificationKeyHash: proved.verificationKeyHash,
+                tags: listing.tags ?? [], contactEmail: listing.contactEmail ?? '', supportEmail: listing.supportEmail,
+                showInMarketplace: listing.showInMarketplace !== false,
+                ...(listing.buyUrl ? { buyUrl: listing.buyUrl } : {}), ...(listing.renewUrl ? { renewUrl: listing.renewUrl } : {}),
+                ...(listing.refundUrl ? { refundUrl: listing.refundUrl } : {}),
+                ...(listing.termsOfServiceUrl ? { termsOfServiceUrl: listing.termsOfServiceUrl } : {}),
+                ...(listing.privacyPolicyUrl ? { privacyPolicyUrl: listing.privacyPolicyUrl } : {}),
+                ...(listing.refundPolicyUrl ? { refundPolicyUrl: listing.refundPolicyUrl } : {}),
+                deployFeeWaiverAcceptedAt: waiverAt, network: net, signature: appSig,
+                // The waiver is the agent's, under the owner's consent: the keeper records it as such.
+                ...(consent.givenBy === 'agent' ? { agentConsent: opts.consent } : {}),
+            }, true).catch(e => {
+                // The contract is deployed and paid for: never throw past this point; say how to finish.
+                warnings.push(`The contract is deployed (${proved.zkAppAddress}) but the listing was not recorded (${e.message}). Finish it from the dashboard with this address.`);
+            });
+            const rec = await record('register-app', { target: proved.zkAppAddress, reference: listing.appId, summary: `Register ${listing.name} (${listing.appId}) on ${net}`, totalNano: feeNano, txHash, consent });
+            return {
+                appId: listing.appId, zkAppAddress: proved.zkAppAddress, verificationKeyHash: proved.verificationKeyHash, txHash,
+                warnings: [...warnings, ...rec.warnings], ...(rec.actionRecord ? { actionRecord: rec.actionRecord } : {}),
+                next: [
+                    `Host the trust manifest: trustManifest('${listing.appId}') gives the file for ${listing.website.replace(/\/+$/, '')}/.well-known/zklicensing/${proved.zkAppAddress}.json`,
+                    net === 'mainnet' ? 'Mainnet listings are reviewed before they appear; buy, renew and refund pages on your own site are required.' : 'Devnet listings appear once the deployment is seen on chain.',
+                ],
+            };
+        },
+        /** Changes the tier prices on chain (and the listing's copy). */
+        async setPrices(appId, prices) {
+            const r = await call('GET', `/apps/${encodeURIComponent(appId)}?network=${net}`);
+            const zkAppAddress = r.app?.deployments?.[net]?.zkAppAddress;
+            if (r.app?.vendorAddress && r.app.vendorAddress !== w.address)
+                throw new AgentError(`${appId} belongs to another vendor wallet`, 'FORBIDDEN', 403, false);
+            if (!zkAppAddress)
+                throw new AgentError(`${appId} has no ${net} deployment`, 'NOT_FOUND', 404, false);
+            checkActionPolicy(opts.policy, { action: 'set-prices', network: net, target: zkAppAddress, amountNano: 0n });
+            const proved = await call('POST', '/prove/setPrice', {
+                vendorAddress: w.address, zkAppAddress, network: net,
+                priceMonthlyMina: prices.monthly, priceYearlyMina: prices.yearly, priceFiveYearMina: prices.fiveYear, pricePerpetualMina: prices.perpetual,
+            });
+            const txHash = await w.signAndSendTransaction(proved.provenTxJson);
+            const warnings = [];
+            // The listing's cached prices (the chain is the source of truth; the keeper reconciles).
+            await call('PUT', `/apps/${encodeURIComponent(appId)}`, {
+                vendorAddress: w.address, signature: await w.signMessage(appId),
+                payload: { priceMonthlyMina: prices.monthly, priceYearlyMina: prices.yearly, priceFiveYearMina: prices.fiveYear, pricePerpetualMina: prices.perpetual },
+            }, true).catch(e => warnings.push(`Prices are set on chain; the listing will catch up (${e.message}).`));
+            const rec = await record('set-prices', { target: zkAppAddress, reference: appId, summary: `Set prices of ${appId} on ${net}`, totalNano: 0n, txHash, consent: { givenBy: 'none' } });
+            return { appId, zkAppAddress, txHash, warnings: [...warnings, ...rec.warnings], ...(rec.actionRecord ? { actionRecord: rec.actionRecord } : {}) };
+        },
+        /**
+         * Takes the app's next redeploy step: it moves to a new contract account
+         * with every license carried over. The first call pauses its sales and
+         * answers `draining` (call again after readyAt); the agent key then signs
+         * the retirement, and the agent wallet sends and pays for each step:
+         * before a hard fork the retirement alone (`retired`, the new account
+         * follows after the fork); otherwise the new account's deployment (1 MINA
+         * account creation + fee).
+         */
+        async redeployApp(appId) {
+            const r = await call('GET', `/apps/${encodeURIComponent(appId)}?network=${net}`);
+            const zkAppAddress = r.app?.deployments?.[net]?.zkAppAddress;
+            if (r.app?.vendorAddress && r.app.vendorAddress !== w.address)
+                throw new AgentError(`${appId} belongs to another vendor wallet`, 'FORBIDDEN', 403, false);
+            if (!zkAppAddress)
+                throw new AgentError(`${appId} has no ${net} deployment`, 'NOT_FOUND', 404, false);
+            checkActionPolicy(opts.policy, { action: 'redeploy-app', network: net, target: zkAppAddress, amountNano: toMinaNano(1.1) }, opts.ledger);
+            const d = await import('./deployClient.js');
+            let retireSignature;
+            for (let round = 0; round < 3; round++) {
+                const { nonce } = await d.getVendorRedeployChallenge({ keeperUrl: opts.keeperUrl, appId, network: net, fetcher: opts.fetcher });
+                const signature = await w.signMessage(nonce);
+                const res = await d.proveVendorRedeploy({ keeperUrl: opts.keeperUrl, appId, nonce, signature, senderPublicKey: w.address, retireSignature, fetcher: opts.fetcher });
+                if ('status' in res && res.status === 'draining')
+                    return { appId, status: 'draining', readyAt: res.readyAt, expiresAt: res.expiresAt, next: 'Sales are paused while in-flight proofs land: call redeploy_app again after readyAt.' };
+                if ('status' in res && res.status === 'sign-retire') {
+                    retireSignature = await w.signFields(res.retireMessage);
+                    continue;
+                }
+                if (!('provenTxJson' in res))
+                    break;
+                const txHash = await w.signAndSendTransaction(res.provenTxJson);
+                await d.registerVendorRedeploy({ keeperUrl: opts.keeperUrl, appId, redeployId: res.redeployId, txHash, fetcher: opts.fetcher });
+                if (res.step === 'retire') {
+                    opts.ledger?.record(toMinaNano(0.1));
+                    return { appId, status: 'retired', txHash, next: 'Retired ahead of the hard fork: call redeploy_app again after the fork to deploy the new account.' };
+                }
+                opts.ledger?.record(toMinaNano(1.1));
+                return { appId, status: 'deployed', zkAppAddress: res.zkAppAddress, txHash, next: 'The listing moves to the new address once it is seen on chain; host the trust manifest for it (trustManifest).' };
+            }
+            throw new AgentError('The keeper did not accept the retire signature', 'HTTP_ERROR', 0, false);
+        },
+        /** Calls off this vendor's redeploy before the app is retired on chain (sales resume). */
+        async cancelRedeploy(appId) {
+            const d = await import('./deployClient.js');
+            const { nonce } = await d.getVendorRedeployChallenge({ keeperUrl: opts.keeperUrl, appId, network: net, fetcher: opts.fetcher });
+            return d.cancelVendorRedeploy({ keeperUrl: opts.keeperUrl, appId, nonce, signature: await w.signMessage(nonce), fetcher: opts.fetcher });
+        },
+        /** Edits the listing (name, descriptions, category, tags, emails, page links); mainnet edits are re-reviewed. */
+        async updateListing(appId, payload, visibility) {
+            checkActionPolicy(opts.policy, { action: 'update-listing', network: net });
+            return call('PUT', `/apps/${encodeURIComponent(appId)}`, {
+                vendorAddress: w.address, signature: await w.signMessage(appId), payload,
+                ...(visibility ? { network: net, status: visibility } : {}),
+            }, true);
+        },
+        /**
+         * What forced retirements left in escrow on this vendor's retired
+         * contracts (Vendor Terms §8.7): per contract, the purchases whose funds
+         * stay there, their buyers and the total.
+         */
+        stranded: () => call('GET', `/vendors/${w.address}/stranded?network=${net}`, undefined, true),
+        /** The platform's monthly fee statement for this vendor (month YYYY-MM). */
+        feeStatement: (month) => call('GET', `/vendors/${w.address}/fee-statements?network=${net}&month=${encodeURIComponent(month)}`, undefined, true).then(r => r.statement),
+        /**
+         * The platform-signed trust manifest the vendor hosts on its website, at
+         * /.well-known/zklicensing/<address>.json for every generation address.
+         * An agent can't upload it: give the files to the owner.
+         */
+        async trustManifest(appId) {
+            const r = await f(`${base}/apps/${encodeURIComponent(appId)}?network=${net}`, { headers: { Accept: 'application/json' } });
+            if (!r.ok)
+                throw new AgentError(`No manifest for ${appId} on ${net} (HTTP ${r.status})`, r.status === 404 ? 'NOT_FOUND' : 'HTTP_ERROR', r.status, false);
+            // The same bytes the dashboard's "Download manifest" saves: the signed generation list (and the public listing).
+            const content = await r.text();
+            const j = JSON.parse(content);
+            const gens = j.generations ?? [];
+            const website = j.app?.website ?? null;
+            return {
+                content,
+                files: gens.map(g => ({ path: `/.well-known/zklicensing/${g.zkAppAddress}.json`, url: website ? `${website.replace(/\/+$/, '')}/.well-known/zklicensing/${g.zkAppAddress}.json` : null })),
+            };
+        },
+    };
+}
+//# sourceMappingURL=agentVendor.js.map

package/build/agentVendor.js.map

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

package/build/appsLookup.d.ts

@@ -0,0 +1,14 @@
+export type LookupableDeployment = {
+    zkAppAddress: string;
+    deploymentHistory?: Array<{
+        zkAppAddress: string;
+    }>;
+};
+export type LookupableApp = {
+    deployments: {
+        devnet?: LookupableDeployment;
+        mainnet?: LookupableDeployment;
+    };
+};
+export declare function findAppByAnyAddress<T extends LookupableApp>(apps: readonly T[], zkAppAddress: string): T | undefined;
+//# sourceMappingURL=appsLookup.d.ts.map

package/build/appsLookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appsLookup.d.ts","sourceRoot":"","sources":["../src/appsLookup.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD,CAAC;AAKF,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE;QACX,MAAM,CAAC,EAAG,oBAAoB,CAAC;QAC/B,OAAO,CAAC,EAAE,oBAAoB,CAAC;KAChC,CAAC;CACH,CAAC;AAMF,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,aAAa,EACzD,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,YAAY,EAAE,MAAM,GACnB,CAAC,GAAG,SAAS,CAOf"}

package/build/appsLookup.js

@@ -0,0 +1,12 @@
+// Copyright (c) 2025-2026 zkLicensing project developers
+// SPDX-License-Identifier: BUSL-1.1
+// Return the first app whose devnet OR mainnet deployment matches (current
+// live address or any retired generation in deploymentHistory). Under the
+// backend-routing design a buyer who pinned an original devnet address stays
+// resolvable across N mainnet promotions and any number of retired gens.
+export function findAppByAnyAddress(apps, zkAppAddress) {
+    const matches = (d) => !!d && (d.zkAppAddress === zkAppAddress ||
+        (d.deploymentHistory ?? []).some(h => h.zkAppAddress === zkAppAddress));
+    return apps.find(a => matches(a.deployments.devnet) || matches(a.deployments.mainnet));
+}
+//# sourceMappingURL=appsLookup.js.map

package/build/appsLookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appsLookup.js","sourceRoot":"","sources":["../src/appsLookup.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,oCAAoC;AAgCpC,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CACjC,IAAkB,EAClB,YAAoB;IAEpB,MAAM,OAAO,GAAG,CAAC,CAAwB,EAAW,EAAE,CACpD,CAAC,CAAC,CAAC,IAAI,CACL,CAAC,CAAC,YAAY,KAAK,YAAY;QAC/B,CAAC,CAAC,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,YAAY,CAAC,CACvE,CAAC;IACJ,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AACzF,CAAC"}

package/build/archiveBootstrap.d.ts

@@ -1,6 +1,6 @@
 export declare const SYNC_CHUNK_SLOTS = 10000;
 export declare const MAX_LOOKBACK_SLOTS = 525600;
-export type Tier = 'monthly' | 'yearly' | 'fiveYear';
+export type Tier = 'monthly' | 'yearly' | 'fiveYear' | 'perpetual';
 export type NormalizedEvent = {
     kind: 'licenseIssued';
     slot: number;
@@ -8,6 +8,8 @@ export type NormalizedEvent = {
     amount: bigint;
     issuedSlot: number;
     expirySlot: number;
+    buyerAddress: string;
+    cap: number;
 } | {
     kind: 'licenseIssuedNoEscrow';
     slot: number;
@@ -15,17 +17,21 @@ export type NormalizedEvent = {
     amount: bigint;
     issuedSlot: number;
     expirySlot: number;
+    buyerAddress: string;
+    cap: number;
 } | {
     kind: 'licenseRenewed';
     slot: number;
     licenseHash: string;
     newExpiry: number;
 } | {
-    kind: 'licenseMigrated';
+    kind: 'appCreated';
     slot: number;
-    licenseHash: string;
-    expirySlot: number;
-    ancestorGen: number;
+    predecessor: string | null;
+} | {
+    kind: 'appRetired';
+    slot: number;
+    licensesRoot: string;
 } | {
     kind: 'refundIssued';
     slot: number;
@@ -34,12 +40,32 @@ export type NormalizedEvent = {
     kind: 'fundsReleased';
     slot: number;
     licenseHash: string;
+} | {
+    kind: 'deviceBound';
+    slot: number;
+    licenseHash: string;
+    slotIndex: number;
+    deviceCommitment: string;
+    boundAtSlot: number;
+} | {
+    kind: 'deviceUnbound';
+    slot: number;
+    licenseHash: string;
+    slotIndex: number;
+    freedAtSlot: number;
 } | {
     kind: 'priceUpdated';
     slot: number;
     priceMonthly: bigint;
     priceYearly: bigint;
     priceFiveYear: bigint;
+    pricePerpetual: bigint;
+} | {
+    kind: 'licenseTransferred';
+    slot: number;
+    from: string;
+    to: string;
+    wallet: string;
 };
 export declare function tierFromExpiryDelta(slots: number): Tier | null;
 export type FetchRange = {

package/build/archiveBootstrap.d.ts.map

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