tapimo 0.14.0 → 0.15.1

package/dist/internal/rewards/Campaigns.js

@@ -0,0 +1,531 @@
+import { concatHex, encodeAbiParameters, getAddress, keccak256, parseAbiParameters, stringToBytes, zeroAddress, } from 'viem';
+import * as z from 'zod/mini';
+import * as Schema from '../Schema.js';
+const maximumUint256 = (1n << 256n) - 1n;
+// EarnVault permits at most one basis point of conversion-floor loss. Funding at least 10,001 raw
+// EarnShare units makes the loss of less than one raw unit strictly smaller than that bound.
+const minimumSettlementFundingEarnShares = 10001n;
+// Keeps the exact provider batch comfortably inside the signer's 28M gas envelope.
+const maximumFundingLegs = 8;
+const leafParameters = parseAbiParameters('uint256,address,bytes32,address,uint256');
+const basisPoints = z
+    .number()
+    .check(z.int(), z.nonnegative(), z.lte(10_000), z.describe('Annual rate in basis points, where 10,000 is 100%.'), z.meta({ examples: [700] }));
+const positiveBasisPoints = basisPoints.check(z.positive(), z.describe('Positive annual rate in basis points, where 10,000 is 100%.'));
+const uint256 = Schema.DecimalString.check(z.refine((value) => BigInt(value) <= maximumUint256, { error: 'value exceeds uint256' }), z.describe('Unsigned 256-bit integer encoded as a decimal string.'));
+const nonzeroAddress = Schema.Address.check(z.refine((address) => address !== zeroAddress, { error: 'address must be nonzero' }), z.describe('Nonzero Tempo account or contract address.'));
+/** Zod schemas for Earn reward campaigns. */
+export var schema;
+(function (schema) {
+    const AnnualRate = z
+        .union([
+        z.strictObject({ bps: positiveBasisPoints }).check(z.describe('Fixed annual target rate.')),
+        z
+            .strictObject({
+            maxBps: basisPoints,
+            minBps: basisPoints,
+            morphoVault: nonzeroAddress,
+            staleAfterSeconds: z
+                .number()
+                .check(z.int(), z.positive(), z.describe('Maximum age in seconds of a reusable Morpho rate observation.'), z.meta({ examples: [3_600] })),
+        })
+            .check(z.refine((rate) => rate.minBps <= rate.maxBps, {
+            error: 'Morpho minBps must not exceed maxBps',
+        }), z.describe('Base Morpho vault rate source with configured safety bounds.')),
+    ])
+        .check(z.describe('Fixed annual rate or bounded Base Morpho vault rate source.'), z.meta({ examples: [{ bps: 500 }] }));
+    const FundingLeg = z
+        .union([
+        z
+            .strictObject({
+            upToAnnualRate: z
+                .strictObject({ bps: positiveBasisPoints })
+                .check(z.describe('Cumulative annual target funded through this leg.')),
+            wallet: nonzeroAddress,
+        })
+            .check(z.describe('Funding wallet responsible up to one cumulative annual rate.')),
+        z
+            .strictObject({
+            remainder: z
+                .literal(true)
+                .check(z.describe('Marks the final wallet as responsible for the remaining target.'), z.meta({ examples: [true] })),
+            wallet: nonzeroAddress,
+        })
+            .check(z.describe('Final funding wallet responsible for the remaining target yield.')),
+    ])
+        .check(z.describe('One ordered target-yield funding-waterfall leg.'));
+    /** Target-yield configuration for one vault. */
+    schema.TargetYield = z
+        .strictObject({
+        annualRate: AnnualRate,
+        endTimestamp: z
+            .number()
+            .check(z.int(), z.positive(), z.describe('Exclusive Unix timestamp when target-yield funding ends.'), z.meta({ examples: [1_788_195_600] })),
+        funding: z.array(FundingLeg).check(z.minLength(1), z.maxLength(maximumFundingLegs), z.describe('Ordered funding waterfall ending in exactly one remainder wallet.'), z.meta({
+            examples: [[{ remainder: true, wallet: '0x5000000000000000000000000000000000000005' }]],
+        })),
+        intervalSeconds: z
+            .number()
+            .check(z.int(), z.gte(60), z.lte(300), z.describe('Target-yield accounting interval in seconds.'), z.meta({ examples: [300] })),
+        startTimestamp: z
+            .number()
+            .check(z.int(), z.nonnegative(), z.describe('Inclusive Unix timestamp when target-yield funding starts.'), z.meta({ examples: [1_788_192_000] })),
+    })
+        .check(z.describe('Target-yield configuration for one verified Earn vault.'));
+    /** Automatic cumulative-payout schedule for one boost campaign. */
+    const PayoutSchedule = z
+        .strictObject({
+        intervalSeconds: z
+            .number()
+            .check(z.int(), z.positive(), z.describe('Interval between automatic boost payouts, in seconds.'), z.meta({ examples: [86_400] })),
+        startTimestamp: z
+            .number()
+            .check(z.int(), z.nonnegative(), z.describe('Unix timestamp after which the next settlement triggers the first payout.'), z.meta({ examples: [1_788_220_800] })),
+    })
+        .check(z.describe('Automatic boost payout schedule.'));
+    /** Registered-depositor boost configuration for one vault. */
+    schema.BoostRewards = z
+        .strictObject({
+        enabled: z
+            .optional(z.boolean())
+            .check(z.describe('Whether new depositor boost rewards accrue during the configured schedule.'), z.meta({ examples: [true] })),
+        endTimestamp: z
+            .number()
+            .check(z.int(), z.positive(), z.describe('Exclusive Unix timestamp when boost rewards end.'), z.meta({ examples: [1_788_195_600] })),
+        excludedAddresses: z
+            .array(nonzeroAddress)
+            .check(z.describe('Additional public holders excluded from boost rewards.'), z.meta({ examples: [[]] })),
+        funding: z.strictObject({ wallet: nonzeroAddress }).check(z.describe('Wallet funding EarnShare boost settlements.'), z.meta({
+            examples: [{ wallet: '0x5000000000000000000000000000000000000005' }],
+        })),
+        intervalSeconds: z
+            .number()
+            .check(z.int(), z.gte(60), z.lte(300), z.describe('Boost-reward accounting interval in seconds.'), z.meta({ examples: [300] })),
+        payoutSchedule: z
+            .optional(PayoutSchedule)
+            .check(z.describe('Optional schedule for automatically pushing accumulated boost rewards.')),
+        perUserPrincipalCapAssets: uint256.check(z.describe('Maximum qualifying principal per registered wallet in base-asset units.'), z.meta({ examples: ['25000000000'] })),
+        startTimestamp: z
+            .number()
+            .check(z.int(), z.nonnegative(), z.describe('Inclusive Unix timestamp when boost rewards start.'), z.meta({ examples: [1_788_192_000] })),
+        targetAnnualRateBps: positiveBasisPoints.check(z.describe('Target total annual rate for qualified principal, in basis points.')),
+        totalPrincipalCapAssets: uint256.check(z.describe('Campaign-wide qualifying principal cap in base-asset units.'), z.meta({ examples: ['10000000000000'] })),
+        treasury: nonzeroAddress.check(z.describe('Immutable recipient of unclaimed EarnShare returned by the distributor.')),
+    })
+        .check(z.describe('Registered-depositor EarnShare boost configuration for one vault.'));
+    /** Complete rewards configuration for one verified Earn vault. */
+    schema.Config = z
+        .strictObject({
+        boostRewards: z
+            .optional(schema.BoostRewards)
+            .check(z.describe('Optional registered-depositor EarnShare boost configuration.')),
+        targetYield: z
+            .optional(schema.TargetYield)
+            .check(z.describe('Optional target-yield funding configuration.')),
+    })
+        .check(z.refine((config) => Boolean(config.boostRewards || config.targetYield), {
+        error: 'targetYield or boostRewards is required',
+    }), z.refine((config) => !config.targetYield ||
+        !config.boostRewards ||
+        config.targetYield.intervalSeconds === config.boostRewards.intervalSeconds, { error: 'targetYield and boostRewards must use one intervalSeconds value' }), z.refine((config) => !config.targetYield ||
+        !config.boostRewards ||
+        Math.abs(config.targetYield.startTimestamp - config.boostRewards.startTimestamp) %
+            config.targetYield.intervalSeconds ===
+            0, { error: 'targetYield and boostRewards schedules must share one interval grid' }), z.refine((config) => !config.targetYield ||
+        (config.targetYield.endTimestamp - config.targetYield.startTimestamp >=
+            config.targetYield.intervalSeconds &&
+            config.targetYield.funding.filter((leg) => 'remainder' in leg).length === 1 &&
+            config.targetYield.funding.every((leg, index) => !('remainder' in leg) || index === config.targetYield.funding.length - 1) &&
+            config.targetYield.funding.every((leg, index, funding) => {
+                if ('remainder' in leg || index === 0)
+                    return true;
+                const previous = funding[index - 1];
+                return ('upToAnnualRate' in previous && leg.upToAnnualRate.bps > previous.upToAnnualRate.bps);
+            }) &&
+            new Set(config.targetYield.funding.map((leg) => leg.wallet)).size ===
+                config.targetYield.funding.length), { error: 'targetYield schedule or funding waterfall is invalid' }), z.refine((config) => !config.boostRewards ||
+        (config.boostRewards.endTimestamp - config.boostRewards.startTimestamp >=
+            config.boostRewards.intervalSeconds &&
+            BigInt(config.boostRewards.perUserPrincipalCapAssets) > 0n &&
+            BigInt(config.boostRewards.perUserPrincipalCapAssets) <=
+                BigInt(config.boostRewards.totalPrincipalCapAssets) &&
+            new Set(config.boostRewards.excludedAddresses).size ===
+                config.boostRewards.excludedAddresses.length), { error: 'boostRewards schedule or principal caps are invalid' }), z.refine((config) => {
+        const boost = config.boostRewards;
+        const payout = boost?.payoutSchedule;
+        return (!boost ||
+            !payout ||
+            (payout.intervalSeconds > boost.intervalSeconds &&
+                payout.startTimestamp > boost.startTimestamp &&
+                payout.startTimestamp <= boost.endTimestamp));
+    }, { error: 'boostRewards payoutSchedule must be slower than its accounting interval' }), z.describe('Complete reward configuration for one verified Earn vault.'));
+})(schema || (schema = {}));
+/** Returns the single accounting interval shared by the configured capabilities. */
+export function intervalSeconds(config) {
+    return config.targetYield?.intervalSeconds ?? config.boostRewards.intervalSeconds;
+}
+/** Returns the final complete accounting boundary, excluding a trailing partial interval. */
+export function finalBoundary(config) {
+    return Math.max(...[config.targetYield, config.boostRewards]
+        .filter((schedule) => schedule !== undefined)
+        .map((schedule) => schedule.startTimestamp +
+        Math.floor((schedule.endTimestamp - schedule.startTimestamp) / schedule.intervalSeconds) *
+            schedule.intervalSeconds));
+}
+/** Returns whether a completed accounting range overlaps one schedule's complete intervals. */
+export function overlapsCompleteIntervals(schedule, options) {
+    const final = schedule.startTimestamp +
+        Math.floor((schedule.endTimestamp - schedule.startTimestamp) / schedule.intervalSeconds) *
+            schedule.intervalSeconds;
+    return options.endsAt > schedule.startTimestamp && options.startsAfter < final;
+}
+/** Returns whether one completed run should automatically push accumulated boost rewards. */
+export function shouldPushPayout(boost, options) {
+    const payout = boost.payoutSchedule;
+    if (!payout)
+        return true;
+    const final = finalBoundary({ boostRewards: boost });
+    if (options.startsAfter < final && options.endsAt >= final)
+        return true;
+    // Later campaign runs retry recipients whose forced final transfer was temporarily unavailable.
+    if (options.startsAfter >= final)
+        return true;
+    if (options.endsAt < payout.startTimestamp)
+        return false;
+    const previous = options.startsAfter < payout.startTimestamp
+        ? -1
+        : Math.floor((options.startsAfter - payout.startTimestamp) / payout.intervalSeconds);
+    const current = Math.floor((options.endsAt - payout.startTimestamp) / payout.intervalSeconds);
+    return current > previous;
+}
+/** Converts base assets into EarnShare at the fee-inclusive vault NAV, rounding down. */
+export function assetsToEarnShares(options) {
+    if (options.assets < 0n)
+        throw new Error('assets must be nonnegative');
+    requirePositiveVaultQuote(options);
+    return (options.assets * options.totalEarnShares) / options.totalAssets;
+}
+/** Converts EarnShare into the assets needed at the fee-inclusive vault NAV, rounding up. */
+export function earnSharesToAssets(options) {
+    if (options.earnShares < 0n)
+        throw new Error('EarnShare must be nonnegative');
+    requirePositiveVaultQuote(options);
+    if (options.earnShares === 0n)
+        return 0n;
+    return ((options.earnShares * options.totalAssets + options.totalEarnShares - 1n) /
+        options.totalEarnShares);
+}
+/** Returns the inventory mint needed to fund a missing liability without coarse conversion loss. */
+export function settlementFundingEarnShares(missingEarnShares) {
+    if (missingEarnShares < 0n)
+        throw new Error('missing EarnShare must be nonnegative');
+    if (missingEarnShares === 0n)
+        return 0n;
+    return missingEarnShares < minimumSettlementFundingEarnShares
+        ? minimumSettlementFundingEarnShares
+        : missingEarnShares;
+}
+function requirePositiveVaultQuote(options) {
+    if (options.totalAssets <= 0n || options.totalEarnShares <= 0n)
+        throw new Error('vault quote requires positive assets and fee-inclusive EarnShare supply');
+}
+/** Removes explicit contributions from one interval's measured exchange-rate growth. */
+export function organicGrowth(options) {
+    const change = organicChange(options);
+    return change > 0n ? change : 0n;
+}
+/** Removes explicit contributions from signed exchange-rate changes, retaining losses for interval aggregation. */
+export function organicChange(options) {
+    if (options.openingAssets === 0n && options.openingEarnShareSupply === 0n)
+        return 0n;
+    if (options.openingAssets <= 0n ||
+        options.openingEarnShareSupply <= 0n ||
+        options.openingValuePerEarnShare <= 0n)
+        throw new Error('opening target-yield state must be positive');
+    const gross = (options.openingAssets *
+        (options.closingValuePerEarnShare - options.openingValuePerEarnShare)) /
+        options.openingValuePerEarnShare;
+    const contributed = options.contributions.reduce((sum, contribution) => {
+        if (contribution.earnShareSupply <= 0n)
+            throw new Error('contribution EarnShare supply must be positive');
+        return (sum + (contribution.assets * options.openingEarnShareSupply) / contribution.earnShareSupply);
+    }, 0n);
+    return gross - contributed;
+}
+/** Allocates an interval's target shortfall using principal held between EarnShare supply changes. */
+export function targetFunding(options) {
+    // Boundary blocks can change NAV without adding elapsed principal exposure.
+    const change = options.periods.reduce((sum, period) => sum + organicChange(period), 0n);
+    const growthAssets = change > 0n ? change : 0n;
+    const principalAssetSeconds = options.periods.reduce((sum, period) => {
+        if (!Number.isSafeInteger(period.elapsedSeconds) || period.elapsedSeconds < 0)
+            throw new Error('target-yield period duration must be a nonnegative integer');
+        return sum + period.openingAssets * BigInt(period.elapsedSeconds);
+    }, 0n);
+    let funded = 0n;
+    const remainders = [];
+    const assets = options.funding.map((leg, index) => {
+        const annualRateBps = 'remainder' in leg
+            ? options.annualRateBps
+            : Math.min(options.annualRateBps, leg.upToAnnualRate.bps);
+        // Asset-seconds preserve sub-unit principal exposure without rounding an average balance.
+        const accrued = accrue({
+            annualRateBps,
+            elapsedSeconds: 1,
+            principalAssets: principalAssetSeconds,
+            remainder: options.remainders[index] ?? 0n,
+        });
+        remainders.push(accrued.remainder);
+        const amount = accrued.amount > growthAssets + funded ? accrued.amount - growthAssets - funded : 0n;
+        funded += amount;
+        return amount;
+    });
+    return { assets, remainders };
+}
+/** Annualizes contribution-adjusted asset growth as a simple ACT/365 rate. */
+export function annualRateBps(options) {
+    if (!Number.isSafeInteger(options.elapsedSeconds) || options.elapsedSeconds <= 0)
+        throw new Error('elapsed seconds must be positive');
+    if (options.growthAssets < 0n)
+        throw new Error('growth assets must be nonnegative');
+    if (options.principalAssets < 0n)
+        throw new Error('principal assets must be nonnegative');
+    if (options.principalAssets === 0n)
+        return 0;
+    const rate = (options.growthAssets * 10000n * 365n * 24n * 60n * 60n) /
+        (options.principalAssets * BigInt(options.elapsedSeconds));
+    if (rate > BigInt(Number.MAX_SAFE_INTEGER))
+        throw new Error('annual rate exceeds safe range');
+    return Number(rate);
+}
+/** Resolves the effective base and incremental boost rates for one interval. */
+export function rewardRates(options) {
+    for (const rate of [
+        options.boostTargetRateBps,
+        options.organicRateBps,
+        options.targetRateBps ?? 0,
+    ])
+        if (!Number.isSafeInteger(rate) || rate < 0)
+            throw new Error('reward rate is invalid');
+    const baseRateBps = Math.max(options.organicRateBps, options.targetRateBps ?? 0);
+    return {
+        baseRateBps,
+        boostRateBps: Math.max(options.boostTargetRateBps - baseRateBps, 0),
+    };
+}
+/** Returns a stable identity for the complete eligibility snapshot. */
+export function eligibilityVersion(entries) {
+    return keccak256(stringToBytes(JSON.stringify(entries.map((entry) => [
+        entry.walletAddress.toLowerCase(),
+        entry.registrationOrder,
+        entry.latestRegisteredAt,
+    ]))));
+}
+/** Returns a stable identity for the effective reward exclusion set. */
+export function exclusionVersion(addresses) {
+    return keccak256(stringToBytes(JSON.stringify([...new Set(addresses.map((address) => address.toLowerCase()))].sort())));
+}
+/** Narrows stored run evidence to resumable calculation state. */
+export function isRunCheckpointEvidence(evidence) {
+    return evidence?.kind === 'checkpoint';
+}
+/** Restores funding amounts only when their saved principal accounting is safe to submit. */
+export function targetFundingAssets(evidence) {
+    const assets = (evidence.targetFundingAssets ?? []).map(BigInt);
+    // Legacy evidence can contain inflated spot-principal amounts, including on a signed retry.
+    if (assets.some((amount) => amount > 0n) && evidence.targetPrincipalMethod !== 'time-weighted:v1')
+        throw new Error('Stored target-yield funding requires principal accounting review.');
+    return assets;
+}
+/** Removes active recipient calculation and payout state after a run is durably delivered. */
+export function compactEvidence(evidence) {
+    const compacted = {
+        ...evidence,
+        closingAccounts: [],
+        intervals: evidence.intervals.map((interval) => ({ ...interval, assetRewards: {} })),
+        payoutRecipients: [],
+        settlementRecipientAddresses: [],
+    };
+    return compacted;
+}
+/** Returns the next interval boundary relative to a schedule origin. */
+export function nextBoundary(options) {
+    if (!Number.isSafeInteger(options.intervalSeconds) || options.intervalSeconds <= 0)
+        throw new Error('intervalSeconds is invalid');
+    if (!Number.isSafeInteger(options.origin) || options.origin < 0)
+        throw new Error('origin is invalid');
+    if (!Number.isSafeInteger(options.timestamp) || options.timestamp < options.origin)
+        throw new Error('timestamp is invalid');
+    return (options.origin +
+        (Math.floor((options.timestamp - options.origin) / options.intervalSeconds) + 1) *
+            options.intervalSeconds);
+}
+/** Calculates simple ACT/365 reward assets and the carried division remainder. */
+export function accrue(options) {
+    const denominator = 10000n * 365n * 24n * 60n * 60n;
+    const numerator = options.principalAssets * BigInt(options.annualRateBps) * BigInt(options.elapsedSeconds) +
+        options.remainder;
+    return { amount: numerator / denominator, remainder: numerator % denominator };
+}
+/** Allocates every minted EarnShare unit by deterministic largest remainder. */
+export function allocate(options) {
+    const rewards = [...options.rewards]
+        .filter((reward) => reward.assets > 0n)
+        .sort((left, right) => left.recipient.toLowerCase().localeCompare(right.recipient.toLowerCase()));
+    const total = rewards.reduce((sum, reward) => sum + reward.assets, 0n);
+    if (total === 0n) {
+        if (options.earnShares !== 0n)
+            throw new Error('cannot allocate shares without rewards');
+        return new Map();
+    }
+    const rows = rewards.map((reward) => {
+        const numerator = reward.assets * options.earnShares;
+        return { amount: numerator / total, recipient: reward.recipient, remainder: numerator % total };
+    });
+    let remaining = options.earnShares - rows.reduce((sum, row) => sum + row.amount, 0n);
+    rows.sort((left, right) => Number(right.remainder > left.remainder) - Number(right.remainder < left.remainder) ||
+        left.recipient.toLowerCase().localeCompare(right.recipient.toLowerCase()));
+    for (const row of rows) {
+        if (remaining === 0n)
+            break;
+        row.amount += 1n;
+        remaining -= 1n;
+    }
+    return new Map(rows.map((row) => [row.recipient, row.amount]));
+}
+/** Whether an unpaid EarnShare balance meets its base-asset payout floor. */
+export function meetsPayoutMinimum(options) {
+    const unpaid = options.cumulativeEntitlement - options.cumulativePaid;
+    if (unpaid <= 0n)
+        return false;
+    if (options.minimumAssets < 0n)
+        throw new Error('minimum assets must be nonnegative');
+    if (options.totalAssets < 0n || options.totalEarnShares <= 0n)
+        throw new Error('payout valuation requires nonnegative assets and positive EarnShare supply');
+    return unpaid * options.totalAssets >= options.minimumAssets * options.totalEarnShares;
+}
+/** Builds an OpenZeppelin StandardMerkleTree-compatible cumulative statement. */
+export function buildStatement(options) {
+    if (options.entitlements.length === 0)
+        throw new Error('statement requires an entitlement');
+    const entries = options.entitlements
+        .map((entry) => ({
+        cumulativeAmount: BigInt(entry.cumulativeAmount).toString(),
+        leaf: '',
+        recipient: getAddress(entry.recipient),
+    }))
+        .sort((left, right) => left.recipient.toLowerCase().localeCompare(right.recipient.toLowerCase()));
+    let totalEntitlement = 0n;
+    for (const [index, entry] of entries.entries()) {
+        const cumulativeAmount = BigInt(entry.cumulativeAmount);
+        if (cumulativeAmount <= 0n || cumulativeAmount > maximumUint256)
+            throw new Error(`invalid entitlement for ${entry.recipient}`);
+        if (index > 0 && entry.recipient === entries[index - 1].recipient)
+            throw new Error(`duplicate recipient ${entry.recipient}`);
+        totalEntitlement += cumulativeAmount;
+        entry.leaf = rewardLeaf({ ...options, cumulativeAmount, recipient: entry.recipient });
+    }
+    if (totalEntitlement > maximumUint256)
+        throw new Error('total entitlement exceeds uint256');
+    const tree = makeTree(entries.map((entry) => entry.leaf));
+    const payload = {
+        campaignId: options.campaignId,
+        chainId: options.chainId,
+        distributor: getAddress(options.distributor),
+        entries,
+        root: tree.nodes[0],
+        schemaVersion: 2,
+        totalEntitlement: totalEntitlement.toString(),
+    };
+    return { ...payload, statementHash: keccak256(stringToBytes(JSON.stringify(payload))) };
+}
+/** Splits a cumulative statement into contiguous multiproof payout batches. */
+export function buildPayoutBatches(statement, options) {
+    if (!Number.isSafeInteger(options.maximumSize) || options.maximumSize <= 0)
+        throw new Error('maximumSize must be a positive integer');
+    const entries = statement.entries.flatMap((entry, index) => !options.recipients || options.recipients.has(entry.recipient.toLowerCase())
+        ? [{ entry, index }]
+        : []);
+    const leaves = statement.entries.map((entry) => entry.leaf);
+    const tree = makeTree(leaves);
+    const byPosition = new Map(tree.positions.map((position, index) => [position, index]));
+    const result = [];
+    for (let offset = 0; offset < entries.length; offset += options.maximumSize) {
+        const selected = entries.slice(offset, offset + options.maximumSize);
+        const positions = selected
+            .map(({ index }) => tree.positions[index])
+            .sort((left, right) => right - left);
+        const original = [...positions];
+        const stack = [...positions];
+        const multiproof = [];
+        const proofFlags = [];
+        while (stack.length > 0 && stack[0] > 0) {
+            const current = stack.shift();
+            const sibling = current % 2 === 0 ? current - 1 : current + 1;
+            const parent = Math.floor((current - 1) / 2);
+            if (sibling === stack[0]) {
+                proofFlags.push(true);
+                stack.shift();
+            }
+            else {
+                proofFlags.push(false);
+                multiproof.push(tree.nodes[sibling]);
+            }
+            stack.push(parent);
+        }
+        const ordered = original.map((position) => statement.entries[byPosition.get(position)]);
+        result.push({
+            cumulativeAmounts: ordered.map((entry) => entry.cumulativeAmount),
+            multiproof,
+            proofFlags,
+            recipients: ordered.map((entry) => entry.recipient),
+        });
+    }
+    return result;
+}
+/** Rebuilds one individual recovery proof from the current cumulative statement. */
+export function buildProof(statement, recipient) {
+    const index = statement.entries.findIndex((entry) => entry.recipient.toLowerCase() === recipient.toLowerCase());
+    if (index < 0)
+        return undefined;
+    return treeProof(makeTree(statement.entries.map((entry) => entry.leaf)), index);
+}
+/** Computes the distributor's domain-separated standard leaf. */
+export function rewardLeaf(options) {
+    return keccak256(keccak256(encodeAbiParameters(leafParameters, [
+        BigInt(options.chainId),
+        getAddress(options.distributor),
+        options.campaignId,
+        getAddress(options.recipient),
+        options.cumulativeAmount,
+    ]), 'bytes'));
+}
+function makeTree(leaves) {
+    const sorted = leaves
+        .map((hash, index) => ({ hash, index }))
+        .sort((left, right) => left.hash.toLowerCase().localeCompare(right.hash.toLowerCase()));
+    const nodes = Array.from({ length: 2 * leaves.length - 1 });
+    const positions = Array.from({ length: leaves.length });
+    for (const [index, leaf] of sorted.entries()) {
+        const position = nodes.length - 1 - index;
+        nodes[position] = leaf.hash;
+        positions[leaf.index] = position;
+    }
+    for (let index = nodes.length - 1 - leaves.length; index >= 0; index -= 1)
+        nodes[index] = nodeHash(nodes[2 * index + 1], nodes[2 * index + 2]);
+    return { nodes, positions };
+}
+function nodeHash(left, right) {
+    return keccak256(concatHex(left.toLowerCase() < right.toLowerCase() ? [left, right] : [right, left]));
+}
+function treeProof(tree, leafIndex) {
+    const result = [];
+    let index = tree.positions[leafIndex];
+    while (index > 0) {
+        const sibling = index % 2 === 0 ? index - 1 : index + 1;
+        result.push(tree.nodes[sibling]);
+        index = Math.floor((index - 1) / 2);
+    }
+    return result;
+}
+//# sourceMappingURL=Campaigns.js.map

package/dist/internal/rewards/Campaigns.js.map

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

package/dist/internal/rewards/Credits.d.ts

@@ -0,0 +1,76 @@
+import { type Address } from 'viem';
+import type * as Db from '../../db/Db.js';
+/** One requested manual credit. */
+export type Credit = {
+    /** Base-asset reward units to add to pending rewards. */
+    assets: bigint;
+    /** Registered recipient. */
+    recipient: Address;
+};
+/** Requested credit annotated with whether it can be applied. */
+export type Line = Credit & {
+    /**
+     * `pending` has a stored account and no credit under this reference yet; `applied` was already
+     * credited under this reference; `missing_account` has no `reward_accounts` row to receive it.
+     */
+    status: 'applied' | 'missing_account' | 'pending';
+};
+/** Result of examining one credit batch against the campaign's stored state. */
+export type Report = {
+    /** Credits already applied under this reference; replaying them is a no-op. */
+    appliedAssets: bigint;
+    /** Why `ready` is false, for operator output. */
+    blockers: readonly string[];
+    /** Latest run phase, or null when the campaign never ran. */
+    latestRunPhase: string | null;
+    /** Requested credits with their per-recipient status. */
+    lines: readonly Line[];
+    /** Recipients without a stored reward account. */
+    missing: readonly Address[];
+    /** Whether the campaign is paused; settlement must not commit while credits are written. */
+    paused: boolean;
+    /** Credits that would be written by `apply`. */
+    pendingAssets: bigint;
+    /** Whether `apply` would proceed: paused, no run in flight, and no missing accounts. */
+    ready: boolean;
+};
+/** Examines a credit batch without writing anything. */
+export declare function review(options: review.Options): Promise<Report>;
+export declare namespace review {
+    /** Campaign identity and the credit batch to examine. */
+    type Options = {
+        /** Chain containing the vault. */
+        chainId: number;
+        /** Requested credits. */
+        credits: readonly Credit[];
+        /** Database owning the campaign. */
+        db: Db.Db;
+        /** Batch reference that makes the credits run-once. */
+        reference: string;
+        /** EarnVault address. */
+        vaultAddress: string;
+    };
+}
+/**
+ * Writes every pending credit into `pending_reward_assets`. Refuses unless `review` reports the
+ * campaign ready, because a settlement commit replaces `reward_accounts` wholesale.
+ */
+export declare function apply(options: apply.Options): Promise<apply.Result>;
+export declare namespace apply {
+    /** Same inputs as `review`. */
+    type Options = review.Options;
+    /** Counts of what this call wrote versus found already written. */
+    type Result = {
+        /** Recipients credited by this call. */
+        credited: number;
+        /** Base-asset units written by this call. */
+        creditedAssets: bigint;
+        /** Recipients already credited under this reference before this call. */
+        replayed: number;
+    };
+}
+/** Thrown when a credit batch cannot be examined or applied. */
+export declare class CreditsError extends Error {
+    name: string;
+}
+//# sourceMappingURL=Credits.d.ts.map