@antseed/node 0.2.152 → 0.2.153

package/dist/payments/free-tier-delegation.d.ts

@@ -0,0 +1,65 @@
+import { type TypedDataDomain, type TypedDataField } from 'ethers';
+/**
+ * A staker's consent to let one buyer use its seller-pool stake for staked
+ * free-tier allowances. Signed with EIP-712 by the staker; the buyer sends it
+ * to sellers in the `x-antseed-free-tier-delegations` request header.
+ *
+ * The signature names the buyer, so a seller only honours it on that buyer's
+ * own authenticated connection: anyone who sees it cannot reuse it.
+ */
+export interface FreeTierDelegation {
+    staker: string;
+    buyer: string;
+    /** Unix seconds after which the delegation no longer counts. */
+    expiresAt: number;
+    signature: string;
+}
+export declare const FREE_TIER_DELEGATIONS_HEADER = "x-antseed-free-tier-delegations";
+/** Most delegations a buyer sends and a seller honours per request. */
+export declare const MAX_FREE_TIER_DELEGATIONS = 8;
+/** Default lifetime offered when signing a delegation. */
+export declare const DEFAULT_FREE_TIER_DELEGATION_DAYS = 90;
+export declare const FREE_TIER_DELEGATION_TYPES: Record<string, TypedDataField[]>;
+export declare function makeFreeTierDelegationDomain(chainId: number): TypedDataDomain;
+/** The typed-data payload a staker's wallet signs. */
+export declare function freeTierDelegationMessage(delegation: Omit<FreeTierDelegation, 'signature'>): Record<string, unknown>;
+/** Whether `delegation` is signed by its staker on `chainId`. Does not check expiry or the buyer. */
+export declare function isFreeTierDelegationSigned(delegation: FreeTierDelegation, chainId: number): boolean;
+/** A delegation that passed signature checks: who staked, and until when it counts. */
+export interface VerifiedFreeTierDelegation {
+    staker: string;
+    expiresAt: number;
+}
+/**
+ * Delegations to `buyer` that are signed and unexpired, with lower-case
+ * stakers, one per staker (latest expiry), at most `MAX_FREE_TIER_DELEGATIONS`.
+ */
+export declare function verifyFreeTierDelegations(delegations: readonly FreeTierDelegation[], buyer: string, chainId: number, nowMs?: number): VerifiedFreeTierDelegation[];
+/**
+ * Header value for `delegations`: comma-separated `staker:expiresAt:signature`.
+ * The buyer is implied by the connection, so it is not sent.
+ */
+export declare function encodeFreeTierDelegationsHeader(delegations: readonly FreeTierDelegation[]): string;
+/** Parse a header from `buyer`'s connection. Malformed entries are skipped. */
+export declare function decodeFreeTierDelegationsHeader(value: string | undefined, buyer: string): FreeTierDelegation[];
+/** Prefix of a shareable delegation code, so a pasted code is recognisable. */
+export declare const FREE_TIER_DELEGATION_CODE_PREFIX = "antseed-free-tier-";
+/**
+ * A copy-pasteable code for `delegation`, for a staker to hand to a buyer:
+ * the prefix plus base64url of staker (20 bytes), buyer (20), expiresAt (u64)
+ * and signature (65).
+ */
+export declare function encodeFreeTierDelegationCode(delegation: FreeTierDelegation): string;
+/** Parse a code from `encodeFreeTierDelegationCode`. Throws on anything malformed; does not check the signature. */
+export declare function decodeFreeTierDelegationCode(code: string): FreeTierDelegation;
+/**
+ * Decode a pasted code and check it is a usable delegation to `buyer` on
+ * `chainId`. Throws an error a buyer can act on otherwise.
+ */
+export declare function acceptFreeTierDelegationCode(code: string, buyer: string, chainId: number, nowMs?: number): FreeTierDelegation;
+/**
+ * `delegations` with `delegation` added, replacing the same staker's earlier
+ * delegation to the same buyer. Throws when that buyer already has the most.
+ */
+export declare function withFreeTierDelegation(delegations: readonly FreeTierDelegation[], delegation: FreeTierDelegation): FreeTierDelegation[];
+//# sourceMappingURL=free-tier-delegation.d.ts.map

package/dist/payments/free-tier-delegation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"free-tier-delegation.d.ts","sourceRoot":"","sources":["../../src/payments/free-tier-delegation.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,QAAQ,CAAC;AAEhB;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,4BAA4B,oCAAoC,CAAC;AAC9E,uEAAuE;AACvE,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,0DAA0D;AAC1D,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAEpD,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAMvE,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAE7E;AAED,sDAAsD;AACtD,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMpH;AAED,qGAAqG;AACrG,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAYnG;AAED,uFAAuF;AACvF,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,SAAS,kBAAkB,EAAE,EAC1C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,SAAa,GACjB,0BAA0B,EAAE,CAU9B;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,CAKlG;AAED,+EAA+E;AAC/E,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAU9G;AAED,+EAA+E;AAC/E,eAAO,MAAM,gCAAgC,uBAAuB,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAQnF;AAED,oHAAoH;AACpH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAkB7E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,kBAAkB,CAQjI;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,EAAE,UAAU,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAOvI"}

package/dist/payments/free-tier-delegation.js

@@ -0,0 +1,145 @@
+import { concat, decodeBase64, encodeBase64, getAddress, hexlify, isAddress, toBeHex, verifyTypedData, } from 'ethers';
+export const FREE_TIER_DELEGATIONS_HEADER = 'x-antseed-free-tier-delegations';
+/** Most delegations a buyer sends and a seller honours per request. */
+export const MAX_FREE_TIER_DELEGATIONS = 8;
+/** Default lifetime offered when signing a delegation. */
+export const DEFAULT_FREE_TIER_DELEGATION_DAYS = 90;
+export const FREE_TIER_DELEGATION_TYPES = {
+    FreeTierDelegation: [
+        { name: 'staker', type: 'address' },
+        { name: 'buyer', type: 'address' },
+        { name: 'expiresAt', type: 'uint64' },
+    ],
+};
+export function makeFreeTierDelegationDomain(chainId) {
+    return { name: 'AntseedFreeTier', version: '1', chainId };
+}
+/** The typed-data payload a staker's wallet signs. */
+export function freeTierDelegationMessage(delegation) {
+    return {
+        staker: getAddress(delegation.staker),
+        buyer: getAddress(delegation.buyer),
+        expiresAt: delegation.expiresAt,
+    };
+}
+/** Whether `delegation` is signed by its staker on `chainId`. Does not check expiry or the buyer. */
+export function isFreeTierDelegationSigned(delegation, chainId) {
+    try {
+        const recovered = verifyTypedData(makeFreeTierDelegationDomain(chainId), FREE_TIER_DELEGATION_TYPES, freeTierDelegationMessage(delegation), delegation.signature);
+        return recovered.toLowerCase() === delegation.staker.toLowerCase();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Delegations to `buyer` that are signed and unexpired, with lower-case
+ * stakers, one per staker (latest expiry), at most `MAX_FREE_TIER_DELEGATIONS`.
+ */
+export function verifyFreeTierDelegations(delegations, buyer, chainId, nowMs = Date.now()) {
+    const verified = new Map();
+    for (const delegation of delegations.slice(0, MAX_FREE_TIER_DELEGATIONS)) {
+        if (delegation.buyer.toLowerCase() !== buyer.toLowerCase())
+            continue;
+        if (delegation.expiresAt * 1000 <= nowMs)
+            continue;
+        if (!isFreeTierDelegationSigned(delegation, chainId))
+            continue;
+        const staker = delegation.staker.toLowerCase();
+        verified.set(staker, Math.max(verified.get(staker) ?? 0, delegation.expiresAt));
+    }
+    return [...verified].map(([staker, expiresAt]) => ({ staker, expiresAt }));
+}
+/**
+ * Header value for `delegations`: comma-separated `staker:expiresAt:signature`.
+ * The buyer is implied by the connection, so it is not sent.
+ */
+export function encodeFreeTierDelegationsHeader(delegations) {
+    return delegations
+        .slice(0, MAX_FREE_TIER_DELEGATIONS)
+        .map((delegation) => `${delegation.staker.toLowerCase()}:${delegation.expiresAt}:${delegation.signature.toLowerCase()}`)
+        .join(',');
+}
+/** Parse a header from `buyer`'s connection. Malformed entries are skipped. */
+export function decodeFreeTierDelegationsHeader(value, buyer) {
+    if (!value)
+        return [];
+    const delegations = [];
+    for (const entry of value.split(',').slice(0, MAX_FREE_TIER_DELEGATIONS)) {
+        const [staker, expiresAt, signature] = entry.trim().split(':');
+        if (!staker || !isAddress(staker) || !expiresAt || !/^\d{1,12}$/.test(expiresAt))
+            continue;
+        if (!signature || !/^0x[0-9a-fA-F]{130}$/.test(signature))
+            continue;
+        delegations.push({ staker, buyer, expiresAt: Number(expiresAt), signature });
+    }
+    return delegations;
+}
+/** Prefix of a shareable delegation code, so a pasted code is recognisable. */
+export const FREE_TIER_DELEGATION_CODE_PREFIX = 'antseed-free-tier-';
+/**
+ * A copy-pasteable code for `delegation`, for a staker to hand to a buyer:
+ * the prefix plus base64url of staker (20 bytes), buyer (20), expiresAt (u64)
+ * and signature (65).
+ */
+export function encodeFreeTierDelegationCode(delegation) {
+    const bytes = concat([
+        getAddress(delegation.staker),
+        getAddress(delegation.buyer),
+        toBeHex(delegation.expiresAt, 8),
+        delegation.signature,
+    ]);
+    return FREE_TIER_DELEGATION_CODE_PREFIX + encodeBase64(bytes).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}
+/** Parse a code from `encodeFreeTierDelegationCode`. Throws on anything malformed; does not check the signature. */
+export function decodeFreeTierDelegationCode(code) {
+    const trimmed = code.trim();
+    if (!trimmed.startsWith(FREE_TIER_DELEGATION_CODE_PREFIX))
+        throw new Error('Not a free-tier code: it should start with ' + FREE_TIER_DELEGATION_CODE_PREFIX);
+    const body = trimmed.slice(FREE_TIER_DELEGATION_CODE_PREFIX.length);
+    if (!/^[A-Za-z0-9_-]+$/.test(body))
+        throw new Error('Free-tier code is malformed');
+    let bytes;
+    try {
+        bytes = decodeBase64(body.replace(/-/g, '+').replace(/_/g, '/') + '='.repeat((4 - (body.length % 4)) % 4));
+    }
+    catch {
+        throw new Error('Free-tier code is malformed');
+    }
+    if (bytes.length !== 113)
+        throw new Error('Free-tier code is incomplete');
+    return {
+        staker: getAddress(hexlify(bytes.slice(0, 20))),
+        buyer: getAddress(hexlify(bytes.slice(20, 40))),
+        expiresAt: Number(BigInt(hexlify(bytes.slice(40, 48)))),
+        signature: hexlify(bytes.slice(48)),
+    };
+}
+/**
+ * Decode a pasted code and check it is a usable delegation to `buyer` on
+ * `chainId`. Throws an error a buyer can act on otherwise.
+ */
+export function acceptFreeTierDelegationCode(code, buyer, chainId, nowMs = Date.now()) {
+    const delegation = decodeFreeTierDelegationCode(code);
+    if (delegation.buyer.toLowerCase() !== buyer.toLowerCase()) {
+        throw new Error(`This code is for buyer ${delegation.buyer}, not ${getAddress(buyer)}. Ask the staker for a code for your buyer address.`);
+    }
+    if (delegation.expiresAt * 1000 <= nowMs)
+        throw new Error('This code has expired. Ask the staker for a new one.');
+    if (!isFreeTierDelegationSigned(delegation, chainId))
+        throw new Error('This code is not signed by its staker on this network.');
+    return delegation;
+}
+/**
+ * `delegations` with `delegation` added, replacing the same staker's earlier
+ * delegation to the same buyer. Throws when that buyer already has the most.
+ */
+export function withFreeTierDelegation(delegations, delegation) {
+    const sameBuyer = (entry) => entry.buyer.toLowerCase() === delegation.buyer.toLowerCase();
+    const kept = delegations.filter((entry) => !(sameBuyer(entry) && entry.staker.toLowerCase() === delegation.staker.toLowerCase()));
+    if (kept.filter(sameBuyer).length >= MAX_FREE_TIER_DELEGATIONS) {
+        throw new Error(`This buyer already has ${MAX_FREE_TIER_DELEGATIONS} stakers; remove one first.`);
+    }
+    return [...kept, delegation];
+}
+//# sourceMappingURL=free-tier-delegation.js.map

package/dist/payments/free-tier-delegation.js.map

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

package/dist/payments/free-tier-program.d.ts

@@ -0,0 +1,97 @@
+/** One staked tier. `minPower` is in ANTS-epochs (whole ANTS × epochs of lock remaining). */
+export interface FreeTierStakeTier {
+    minPower: number;
+    /** Multiplier on the base allowance, or `'unlimited'`. */
+    multiplier: number | 'unlimited';
+}
+export interface FreeTierBaseLimits {
+    maxRequestsPerAddress: number | null;
+    maxRequestsPerIp: number | null;
+    windowMs: number;
+    /**
+     * Only buyers whose stake reaches a tier are served; the base limits are
+     * then just the unit the tier multipliers apply to.
+     */
+    stakersOnly?: boolean;
+}
+export interface FreeTierProgram {
+    base: FreeTierBaseLimits;
+    stakeTiers: FreeTierStakeTier[];
+}
+/** Epochs in one year of lock; tiers are documented as "ANTS locked for a year". */
+export declare const FREE_TIER_EPOCHS_PER_YEAR = 52;
+/**
+ * Network default: 10k / 50k / 200k ANTS locked for a year earn 5×, 20× and
+ * unlimited free usage on the seller they are staked on.
+ */
+export declare const DEFAULT_FREE_TIER_STAKE_TIERS: readonly FreeTierStakeTier[];
+/**
+ * Response header a seller sets, to `FREE_TIER_SERVED_COVERED`, on a request
+ * to a priced service that the service's free allowance covered: the buyer
+ * owes nothing for it. A buyer that ignores it pays the listed price.
+ */
+export declare const FREE_TIER_SERVED_HEADER = "x-antseed-free-tier";
+export declare const FREE_TIER_SERVED_COVERED = "covered";
+export declare const MAX_FREE_TIER_STAKE_TIERS = 4;
+export declare const MAX_FREE_TIER_MULTIPLIER = 10000;
+/** Capability scope of a service's own program: `m` + the first 8 hex of keccak256(serviceId). */
+export declare function freeTierServiceScope(serviceId: string): string;
+/** Throws when `tiers` is not a valid program: increasing power, increasing multipliers, unlimited last. */
+export declare function validateFreeTierStakeTiers(tiers: readonly FreeTierStakeTier[], label?: string): void;
+/** Highest tier `power` (raw on-chain power: ANTS wei × epochs) qualifies for, or null. */
+export declare function freeTierStakeTierForPower(tiers: readonly FreeTierStakeTier[], power: bigint): FreeTierStakeTier | null;
+/** Raw on-chain power (ANTS wei × epochs) as whole ANTS-epochs. */
+export declare function powerToAntsEpochs(power: bigint): number;
+/**
+ * Capability strings advertising `program` in peer metadata: the seller-wide
+ * program, or `serviceId`'s own program when given.
+ */
+export declare function encodeFreeTierCapabilities(program: FreeTierProgram, serviceId?: string, options?: {
+    sellerWideTiers?: readonly FreeTierStakeTier[];
+}): string[];
+/**
+ * Read a seller's free-tier program from its advertised capabilities: the
+ * program `serviceId` is served under when given (its own, else the
+ * seller-wide one), otherwise the seller-wide program. Returns null when there
+ * is none or its strings are malformed.
+ */
+export declare function parseFreeTierProgram(capabilities: readonly string[] | undefined, serviceId?: string): FreeTierProgram | null;
+/** A service's advertised prices, as the free tier classifies them. */
+export interface FreeTierServicePrices {
+    inputUsdPerMillion?: number | null;
+    outputUsdPerMillion?: number | null;
+    cachedInputUsdPerMillion?: number | null;
+    maxImageUsdPerImage?: number | null;
+    /** Unit-billing models by API protocol (images, video, per-request fees). */
+    unitBillingModels?: Record<string, {
+        components?: ReadonlyArray<{
+            priceUsd: number;
+        }>;
+    } | undefined> | null;
+}
+/**
+ * Whether a service charges anything, the way the seller decides it: any
+ * token price, image price or priced unit-billing component makes it paid.
+ */
+export declare function isPricedService(prices: FreeTierServicePrices): boolean;
+/**
+ * The program a buyer of `serviceId` is served under: on a free service its
+ * own or the seller-wide one, on a priced service only its own free allowance.
+ * Paid video is never covered (it is paid through one-off channels), so it has none.
+ */
+export declare function freeTierProgramForService(capabilities: readonly string[] | undefined, serviceId: string, priced: boolean, options?: {
+    video?: boolean;
+}): FreeTierProgram | null;
+/**
+ * Only `serviceId`'s own program, never the seller-wide fallback. A priced
+ * service's free allowance is always its own program, so this is the one to
+ * read for a paid service.
+ */
+export declare function parseServiceFreeTierProgram(capabilities: readonly string[] | undefined, serviceId: string): FreeTierProgram | null;
+/**
+ * A free-tier program passed on as JSON (by a buyer's catalog), validated the
+ * same way as advertised capabilities. Returns null when it is not one.
+ */
+export declare function normalizeFreeTierProgram(value: unknown): FreeTierProgram | null;
+export * from './free-tier-stake.js';
+//# sourceMappingURL=free-tier-program.d.ts.map

package/dist/payments/free-tier-program.d.ts.map

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

package/dist/payments/free-tier-program.js

@@ -0,0 +1,267 @@
+/**
+ * Staked free-tier program: how much more free usage a seller grants buyers
+ * who lock ANTS in that seller's pool.
+ *
+ * Tiers are measured in staking power, the same quantity the seller pool uses
+ * for rewards: ANTS amount × epochs of lock remaining (one epoch is a week).
+ * Power is zero until a position activates and shrinks as the lock runs down,
+ * so a tier rewards long commitments over short-lived stake.
+ *
+ * Sellers advertise the program in their signed peer metadata as capability
+ * strings, so buyers and indexers can read it without a metadata version bump:
+ *
+ *   free-tier.v1.base[.a<perAddress>][.i<perIp>].w<windowMs>[.s1][.t1]
+ *   free-tier.v1.tier.p<minPower>.x<multiplier>                   (x0 = unlimited)
+ *
+ * A service with its own program advertises the same strings scoped by
+ * `m<first 8 hex of keccak256(serviceId)>` after the version, e.g.
+ * `free-tier.v1.m1a2b3c4d.base.a10.w86400000.s1`. Services without one fall
+ * back to the unscoped, seller-wide program.
+ *
+ * `s1` marks a stakers-only program. `t1` on a scoped base means the program
+ * uses the seller-wide tiers, so it costs one capability string, not five.
+ *
+ * On a priced service, its own program is a free allowance: requests it covers
+ * are free, the rest are paid. The seller-wide program covers free services only.
+ */
+import { id } from 'ethers';
+/** Epochs in one year of lock; tiers are documented as "ANTS locked for a year". */
+export const FREE_TIER_EPOCHS_PER_YEAR = 52;
+/**
+ * Network default: 10k / 50k / 200k ANTS locked for a year earn 5×, 20× and
+ * unlimited free usage on the seller they are staked on.
+ */
+export const DEFAULT_FREE_TIER_STAKE_TIERS = Object.freeze([
+    { minPower: 10_000 * FREE_TIER_EPOCHS_PER_YEAR, multiplier: 5 },
+    { minPower: 50_000 * FREE_TIER_EPOCHS_PER_YEAR, multiplier: 20 },
+    { minPower: 200_000 * FREE_TIER_EPOCHS_PER_YEAR, multiplier: 'unlimited' },
+]);
+/**
+ * Response header a seller sets, to `FREE_TIER_SERVED_COVERED`, on a request
+ * to a priced service that the service's free allowance covered: the buyer
+ * owes nothing for it. A buyer that ignores it pays the listed price.
+ */
+export const FREE_TIER_SERVED_HEADER = 'x-antseed-free-tier';
+export const FREE_TIER_SERVED_COVERED = 'covered';
+export const MAX_FREE_TIER_STAKE_TIERS = 4;
+export const MAX_FREE_TIER_MULTIPLIER = 10_000;
+const CAPABILITY_PREFIX = 'free-tier.v1.';
+const ANTS_WEI = 10n ** 18n;
+const SCOPE_PATTERN = /^m[0-9a-f]{8}$/;
+/** Capability scope of a service's own program: `m` + the first 8 hex of keccak256(serviceId). */
+export function freeTierServiceScope(serviceId) {
+    return `m${id(serviceId).slice(2, 10)}`;
+}
+/** Throws when `tiers` is not a valid program: increasing power, increasing multipliers, unlimited last. */
+export function validateFreeTierStakeTiers(tiers, label = 'freeTier.stakeTiers') {
+    if (tiers.length > MAX_FREE_TIER_STAKE_TIERS) {
+        throw new Error(`${label} accepts at most ${MAX_FREE_TIER_STAKE_TIERS} tiers`);
+    }
+    let previousPower = 0;
+    // A first tier may be 1x: on a stakers-only program it grants the base limits.
+    let previousMultiplier = 0;
+    let sawUnlimited = false;
+    tiers.forEach((tier, index) => {
+        const at = `${label}[${index}]`;
+        if (!Number.isSafeInteger(tier.minPower) || tier.minPower < 1) {
+            throw new Error(`${at}.minPower must be a positive safe integer`);
+        }
+        if (tier.minPower <= previousPower) {
+            throw new Error(`${at}.minPower must be greater than the previous tier`);
+        }
+        if (sawUnlimited) {
+            throw new Error(`${at} follows an unlimited tier`);
+        }
+        if (tier.multiplier === 'unlimited') {
+            sawUnlimited = true;
+        }
+        else if (!Number.isSafeInteger(tier.multiplier)
+            || tier.multiplier <= previousMultiplier
+            || tier.multiplier > MAX_FREE_TIER_MULTIPLIER) {
+            throw new Error(`${at}.multiplier must be an integer above the previous tier (minimum 1, maximum ${MAX_FREE_TIER_MULTIPLIER}) or "unlimited"`);
+        }
+        else {
+            previousMultiplier = tier.multiplier;
+        }
+        previousPower = tier.minPower;
+    });
+}
+/** Highest tier `power` (raw on-chain power: ANTS wei × epochs) qualifies for, or null. */
+export function freeTierStakeTierForPower(tiers, power) {
+    let match = null;
+    for (const tier of tiers) {
+        if (power >= BigInt(tier.minPower) * ANTS_WEI)
+            match = tier;
+    }
+    return match;
+}
+/** Raw on-chain power (ANTS wei × epochs) as whole ANTS-epochs. */
+export function powerToAntsEpochs(power) {
+    const whole = power / ANTS_WEI;
+    return whole > BigInt(Number.MAX_SAFE_INTEGER) ? Number.MAX_SAFE_INTEGER : Number(whole);
+}
+/**
+ * Capability strings advertising `program` in peer metadata: the seller-wide
+ * program, or `serviceId`'s own program when given.
+ */
+export function encodeFreeTierCapabilities(program, serviceId, options = {}) {
+    const { base } = program;
+    const inheritTiers = serviceId !== undefined
+        && options.sellerWideTiers !== undefined
+        && program.stakeTiers.length > 0
+        && sameStakeTiers(program.stakeTiers, options.sellerWideTiers);
+    const prefix = serviceId === undefined ? CAPABILITY_PREFIX : `${CAPABILITY_PREFIX}${freeTierServiceScope(serviceId)}.`;
+    const baseParts = [
+        `${prefix}base`,
+        ...(base.maxRequestsPerAddress !== null ? [`a${base.maxRequestsPerAddress}`] : []),
+        ...(base.maxRequestsPerIp !== null ? [`i${base.maxRequestsPerIp}`] : []),
+        `w${base.windowMs}`,
+        ...(base.stakersOnly ? ['s1'] : []),
+        ...(inheritTiers ? ['t1'] : []),
+    ];
+    return [
+        baseParts.join('.'),
+        ...(inheritTiers ? [] : program.stakeTiers).map((tier) => `${prefix}tier.p${tier.minPower}.x${tier.multiplier === 'unlimited' ? 0 : tier.multiplier}`),
+    ];
+}
+/**
+ * Read a seller's free-tier program from its advertised capabilities: the
+ * program `serviceId` is served under when given (its own, else the
+ * seller-wide one), otherwise the seller-wide program. Returns null when there
+ * is none or its strings are malformed.
+ */
+export function parseFreeTierProgram(capabilities, serviceId) {
+    if (!capabilities)
+        return null;
+    if (serviceId !== undefined) {
+        const scope = freeTierServiceScope(serviceId);
+        if (capabilities.some((capability) => capability.startsWith(`${CAPABILITY_PREFIX}${scope}.`))) {
+            return parseScopedFreeTierProgram(capabilities, scope);
+        }
+    }
+    return parseScopedFreeTierProgram(capabilities, null);
+}
+/**
+ * Whether a service charges anything, the way the seller decides it: any
+ * token price, image price or priced unit-billing component makes it paid.
+ */
+export function isPricedService(prices) {
+    const positive = (value) => typeof value === 'number' && value > 0;
+    if (positive(prices.inputUsdPerMillion) || positive(prices.outputUsdPerMillion)
+        || positive(prices.cachedInputUsdPerMillion) || positive(prices.maxImageUsdPerImage))
+        return true;
+    return Object.values(prices.unitBillingModels ?? {}).some((model) => (model?.components ?? []).some((component) => !(component.priceUsd <= 0)));
+}
+/**
+ * The program a buyer of `serviceId` is served under: on a free service its
+ * own or the seller-wide one, on a priced service only its own free allowance.
+ * Paid video is never covered (it is paid through one-off channels), so it has none.
+ */
+export function freeTierProgramForService(capabilities, serviceId, priced, options = {}) {
+    if (!priced)
+        return parseFreeTierProgram(capabilities, serviceId);
+    return options.video ? null : parseServiceFreeTierProgram(capabilities, serviceId);
+}
+/**
+ * Only `serviceId`'s own program, never the seller-wide fallback. A priced
+ * service's free allowance is always its own program, so this is the one to
+ * read for a paid service.
+ */
+export function parseServiceFreeTierProgram(capabilities, serviceId) {
+    if (!capabilities)
+        return null;
+    const scope = freeTierServiceScope(serviceId);
+    if (!capabilities.some((capability) => capability.startsWith(`${CAPABILITY_PREFIX}${scope}.`)))
+        return null;
+    return parseScopedFreeTierProgram(capabilities, scope);
+}
+function sameStakeTiers(a, b) {
+    return a.length === b.length && a.every((tier, index) => tier.minPower === b[index].minPower && tier.multiplier === b[index].multiplier);
+}
+function parseScopedFreeTierProgram(capabilities, scope) {
+    let base = null;
+    let inheritTiers = false;
+    const stakeTiers = [];
+    for (const capability of capabilities) {
+        if (!capability.startsWith(CAPABILITY_PREFIX))
+            continue;
+        const parts = capability.split('.');
+        const capabilityScope = SCOPE_PATTERN.test(parts[2] ?? '') ? parts[2] : null;
+        if (capabilityScope !== scope)
+            continue;
+        const [kind, ...fields] = parts.slice(capabilityScope === null ? 2 : 3);
+        const values = new Map();
+        for (const field of fields) {
+            const match = /^([a-z])(\d{1,16})$/.exec(field);
+            if (!match)
+                return null;
+            const value = Number(match[2]);
+            if (!Number.isSafeInteger(value))
+                return null;
+            values.set(match[1], value);
+        }
+        if (kind === 'base') {
+            const windowMs = values.get('w');
+            if (windowMs === undefined || windowMs < 1_000)
+                return null;
+            base = {
+                maxRequestsPerAddress: values.get('a') ?? null,
+                maxRequestsPerIp: values.get('i') ?? null,
+                windowMs,
+                ...(values.get('s') === 1 ? { stakersOnly: true } : {}),
+            };
+            inheritTiers = scope !== null && values.get('t') === 1;
+        }
+        else if (kind === 'tier') {
+            const minPower = values.get('p');
+            const multiplier = values.get('x');
+            if (minPower === undefined || multiplier === undefined)
+                return null;
+            stakeTiers.push({ minPower, multiplier: multiplier === 0 ? 'unlimited' : multiplier });
+        }
+    }
+    if (!base)
+        return null;
+    if (inheritTiers) {
+        const sellerWide = parseScopedFreeTierProgram(capabilities, null);
+        if (!sellerWide)
+            return null;
+        stakeTiers.push(...sellerWide.stakeTiers);
+    }
+    stakeTiers.sort((a, b) => a.minPower - b.minPower);
+    try {
+        validateFreeTierStakeTiers(stakeTiers);
+    }
+    catch {
+        return null;
+    }
+    return { base, stakeTiers };
+}
+/**
+ * A free-tier program passed on as JSON (by a buyer's catalog), validated the
+ * same way as advertised capabilities. Returns null when it is not one.
+ */
+export function normalizeFreeTierProgram(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    const { base, stakeTiers } = value;
+    if (!base || typeof base !== 'object' || !Array.isArray(stakeTiers))
+        return null;
+    const limits = base;
+    const count = (field) => field === null || field === undefined ? null : Number.isSafeInteger(field) && field >= 0 ? field : undefined;
+    const maxRequestsPerAddress = count(limits.maxRequestsPerAddress);
+    const maxRequestsPerIp = count(limits.maxRequestsPerIp);
+    const windowMs = count(limits.windowMs);
+    if (maxRequestsPerAddress === undefined || maxRequestsPerIp === undefined || !windowMs)
+        return null;
+    const tiers = stakeTiers.map((tier) => tier);
+    if (tiers.some((tier) => !tier || typeof tier.minPower !== 'number' || (tier.multiplier !== 'unlimited' && typeof tier.multiplier !== 'number')))
+        return null;
+    return parseFreeTierProgram(encodeFreeTierCapabilities({
+        base: { maxRequestsPerAddress, maxRequestsPerIp, windowMs, ...(limits.stakersOnly === true ? { stakersOnly: true } : {}) },
+        stakeTiers: tiers,
+    }));
+}
+// Stake projections (browser-safe, no ethers): also at `@antseed/node/free-tier-stake`.
+export * from './free-tier-stake.js';
+//# sourceMappingURL=free-tier-program.js.map

package/dist/payments/free-tier-program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"free-tier-program.js","sourceRoot":"","sources":["../../src/payments/free-tier-program.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AA0B5B,oFAAoF;AACpF,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAiC,MAAM,CAAC,MAAM,CAAC;IACvF,EAAE,QAAQ,EAAE,MAAM,GAAG,yBAAyB,EAAE,UAAU,EAAE,CAAC,EAAE;IAC/D,EAAE,QAAQ,EAAE,MAAM,GAAG,yBAAyB,EAAE,UAAU,EAAE,EAAE,EAAE;IAChE,EAAE,QAAQ,EAAE,OAAO,GAAG,yBAAyB,EAAE,UAAU,EAAE,WAAW,EAAE;CAC3E,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAC7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAElD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAE/C,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAC1C,MAAM,QAAQ,GAAG,GAAG,IAAI,GAAG,CAAC;AAC5B,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAEvC,kGAAkG;AAClG,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED,4GAA4G;AAC5G,MAAM,UAAU,0BAA0B,CAAC,KAAmC,EAAE,KAAK,GAAG,qBAAqB;IAC3G,IAAI,KAAK,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,yBAAyB,QAAQ,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,+EAA+E;IAC/E,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAC3B,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,MAAM,EAAE,GAAG,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,2CAA2C,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,IAAI,aAAa,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,kDAAkD,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,4BAA4B,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,KAAK,WAAW,EAAE,CAAC;YACpC,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,IACL,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC;eACnC,IAAI,CAAC,UAAU,IAAI,kBAAkB;eACrC,IAAI,CAAC,UAAU,GAAG,wBAAwB,EAC7C,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,8EAA8E,wBAAwB,kBAAkB,CAAC,CAAC;QACjJ,CAAC;aAAM,CAAC;YACN,kBAAkB,GAAG,IAAI,CAAC,UAAU,CAAC;QACvC,CAAC;QACD,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,yBAAyB,CACvC,KAAmC,EACnC,KAAa;IAEb,IAAI,KAAK,GAA6B,IAAI,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,QAAQ;YAAE,KAAK,GAAG,IAAI,CAAC;IAC9D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC/B,OAAO,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAwB,EACxB,SAAkB,EAClB,UAA8D,EAAE;IAEhE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,MAAM,YAAY,GAAG,SAAS,KAAK,SAAS;WACvC,OAAO,CAAC,eAAe,KAAK,SAAS;WACrC,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;WAC7B,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,iBAAiB,GAAG,oBAAoB,CAAC,SAAS,CAAC,GAAG,CAAC;IACvH,MAAM,SAAS,GAAG;QAChB,GAAG,MAAM,MAAM;QACf,GAAG,CAAC,IAAI,CAAC,qBAAqB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,GAAG,CAAC,IAAI,CAAC,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,IAAI,IAAI,CAAC,QAAQ,EAAE;QACnB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;IACF,OAAO;QACL,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;QACnB,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACvD,GAAG,MAAM,SAAS,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;KAC/F,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,YAA2C,EAC3C,SAAkB;IAElB,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,iBAAiB,GAAG,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;YAC9F,OAAO,0BAA0B,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,0BAA0B,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;AACxD,CAAC;AAYD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAA6B;IAC3D,MAAM,QAAQ,GAAG,CAAC,KAAgC,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,CAAC;IAC9F,IAAI,QAAQ,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,mBAAmB,CAAC;WAC1E,QAAQ,CAAC,MAAM,CAAC,wBAAwB,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,mBAAmB,CAAC;QAAE,OAAO,IAAI,CAAC;IACpG,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAClE,CAAC,KAAK,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,YAA2C,EAC3C,SAAiB,EACjB,MAAe,EACf,UAA+B,EAAE;IAEjC,IAAI,CAAC,MAAM;QAAE,OAAO,oBAAoB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAClE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,2BAA2B,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AACrF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,YAA2C,EAC3C,SAAiB;IAEjB,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,KAAK,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,iBAAiB,GAAG,KAAK,GAAG,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5G,OAAO,0BAA0B,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,cAAc,CAAC,CAA+B,EAAE,CAA+B;IACtF,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACtD,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,KAAK,CAAE,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,CAAC,KAAK,CAAE,CAAC,UAAU,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,0BAA0B,CAAC,YAA+B,EAAE,KAAoB;IACvF,IAAI,IAAI,GAA8B,IAAI,CAAC;IAC3C,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,MAAM,UAAU,GAAwB,EAAE,CAAC;IAC3C,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,iBAAiB,CAAC;YAAE,SAAS;QACxD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,eAAe,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9E,IAAI,eAAe,KAAK,KAAK;YAAE,SAAS;QACxC,MAAM,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACxB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC9C,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,GAAG,KAAK;gBAAE,OAAO,IAAI,CAAC;YAC5D,IAAI,GAAG;gBACL,qBAAqB,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI;gBAC9C,gBAAgB,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI;gBACzC,QAAQ;gBACR,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD,CAAC;YACF,YAAY,GAAG,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzD,CAAC;aAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,QAAQ,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YACpE,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IACD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,UAAU,GAAG,0BAA0B,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAC7B,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;IACD,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC;QACH,0BAA0B,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,KAAwD,CAAC;IACtF,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACjF,MAAM,MAAM,GAAG,IAA+B,CAAC;IAC/C,MAAM,KAAK,GAAG,CAAC,KAAc,EAA6B,EAAE,CAC1D,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAK,KAAgB,IAAI,CAAC,CAAC,CAAC,CAAC,KAAe,CAAC,CAAC,CAAC,SAAS,CAAC;IACrI,MAAM,qBAAqB,GAAG,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAClE,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,qBAAqB,KAAK,SAAS,IAAI,gBAAgB,KAAK,SAAS,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IACpG,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAkC,CAAC,CAAC;IAC3E,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,KAAK,WAAW,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9J,OAAO,oBAAoB,CAAC,0BAA0B,CAAC;QACrD,IAAI,EAAE,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;QAC1H,UAAU,EAAE,KAA4B;KACzC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,wFAAwF;AACxF,cAAc,sBAAsB,CAAC"}