tapimo 0.14.0 → 0.15.0

package/dist/internal/index.d.ts

@@ -8,7 +8,7 @@ export * as Errors from './Errors.js';
 export * as Exchange from './exchange/index.js';
 export * as Fees from './Fees.js';
 export * as Fetch from './Fetch.js';
-export * as Funding from './funding/index.js';
+export * as Routes from './routes/index.js';
 export * as Id from './Id.js';
 export * as Idempotency from './Idempotency.js';
 export * as Log from './Log.js';
@@ -18,6 +18,7 @@ export * as OpenApi from './OpenApi.js';
 export * as Path from './Path.js';
 export * as Provider from './Provider.js';
 export * as RateLimit from './RateLimit.js';
+export * as Rewards from './rewards/index.js';
 export * as Response from './Response.js';
 export * as RpcSchema from './RpcSchema.js';
 export * as Schema from './Schema.js';
@@ -26,6 +27,7 @@ export * as Tidx from './Tidx.js';
 export * as Timing from './Timing.js';
 export * as Ttl from './Ttl.js';
 export * as Value from './Value.js';
+export * as VercelOidc from './VercelOidc.js';
 export * as VerifiedTokens from './VerifiedTokens.js';
 export * as Viem from './Viem.js';
 export * as WebhookDestination from './WebhookDestination.js';

package/dist/internal/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/internal/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/internal/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAA;AAC3C,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA"}

package/dist/internal/index.js

@@ -8,7 +8,7 @@ export * as Errors from './Errors.js';
 export * as Exchange from './exchange/index.js';
 export * as Fees from './Fees.js';
 export * as Fetch from './Fetch.js';
-export * as Funding from './funding/index.js';
+export * as Routes from './routes/index.js';
 export * as Id from './Id.js';
 export * as Idempotency from './Idempotency.js';
 export * as Log from './Log.js';
@@ -18,6 +18,7 @@ export * as OpenApi from './OpenApi.js';
 export * as Path from './Path.js';
 export * as Provider from './Provider.js';
 export * as RateLimit from './RateLimit.js';
+export * as Rewards from './rewards/index.js';
 export * as Response from './Response.js';
 export * as RpcSchema from './RpcSchema.js';
 export * as Schema from './Schema.js';
@@ -26,6 +27,7 @@ export * as Tidx from './Tidx.js';
 export * as Timing from './Timing.js';
 export * as Ttl from './Ttl.js';
 export * as Value from './Value.js';
+export * as VercelOidc from './VercelOidc.js';
 export * as VerifiedTokens from './VerifiedTokens.js';
 export * as Viem from './Viem.js';
 export * as WebhookDestination from './WebhookDestination.js';

package/dist/internal/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/internal/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/internal/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAA;AAC3C,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA"}

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

@@ -0,0 +1,88 @@
+import { type Address } from 'viem';
+import type * as Db from '../../db/Db.js';
+import * as RewardAccounts from '../../db/tables/rewardAccounts.js';
+import type * as Tidx from '../Tidx.js';
+import type * as Campaigns from './Campaigns.js';
+/** Stored and replayed values of one projected balance. */
+export type Comparison = {
+    /** Value a fresh historical replay produces. */
+    expected: string;
+    /** Value currently persisted in `reward_accounts`. */
+    stored: string;
+};
+/** One registered recipient whose stored projection differs from its replay. */
+export type Discrepancy = {
+    /** Principal permanently allocated against campaign caps. */
+    allocatedPrincipalAssets: Comparison;
+    /** Attributable public EarnShare balance. */
+    publicEarnShares: Comparison;
+    /** Qualified EarnShare balance. */
+    qualifiedEarnShares: Comparison;
+    /** Registered recipient. */
+    recipient: Address;
+};
+/** Result of comparing one campaign's stored projections against replayed history. */
+export type Report = {
+    /** Total principal allocated across every stored and every replayed account. */
+    allocatedPrincipalAssets: Comparison;
+    /** Campaign identity and the cursor the replay was bounded to. */
+    campaign: {
+        /** Chain containing the vault. */
+        chainId: number;
+        /** Last event applied by the delivered projection. */
+        eventCursor: Campaigns.EventCursor;
+        /** Whether the campaign is paused. */
+        paused: boolean;
+        /** Per-user principal cap in base-asset units. */
+        perUserPrincipalCapAssets: string;
+        /** Campaign-wide principal cap in base-asset units. */
+        totalPrincipalCapAssets: string;
+        /** EarnVault address. */
+        vaultAddress: Address;
+    };
+    /** Accounts whose stored balances differ from replay without an allocation shortfall. */
+    drift: readonly Discrepancy[];
+    /** Accounts whose replay allocates more principal than is stored: deposits the projection never applied. */
+    missingDeposits: readonly Discrepancy[];
+    /** Stored account count. */
+    storedAccounts: number;
+    /** Eligible registrations for the campaign. */
+    registrations: number;
+    /** Registered recipients without a stored account; the next run replays them. */
+    unprojected: readonly Address[];
+};
+/**
+ * Replays every eligible registration's deposit and EarnShare history through
+ * the campaign's committed cursor and compares it with the stored projections.
+ */
+export declare function audit(options: audit.Options): Promise<Report>;
+export declare namespace audit {
+    /** Campaign selector and data sources. */
+    type Options = {
+        /** Chain containing the vault. */
+        chainId: number;
+        /** Authoritative Postgres connection. */
+        db: Db.Db;
+        /** TIDX client for the campaign chain. */
+        tidx: Tidx.Client;
+        /** EarnVault address. */
+        vaultAddress: string;
+    };
+}
+/**
+ * Clears deposit-derived state for the given recipients so the next reward run
+ * replays their history through the registration reconciliation path.
+ */
+export declare function reset(options: reset.Options): Promise<number>;
+export declare namespace reset {
+    /** Recipients to rebuild on the next run. */
+    type Options = RewardAccounts.resetPrincipal.Options & {
+        /** Authoritative Postgres connection. */
+        db: Db.Db;
+    };
+}
+/** The campaign cannot be audited in its current state. */
+export declare class AuditError extends Error {
+    name: string;
+}
+//# sourceMappingURL=Audit.d.ts.map

package/dist/internal/rewards/Audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Audit.d.ts","sourceRoot":"","sources":["../../../src/internal/rewards/Audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,MAAM,CAAA;AAE/C,OAAO,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,cAAc,MAAM,mCAAmC,CAAA;AAGnE,OAAO,KAAK,KAAK,IAAI,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAIhD,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAAG;IACvB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;IAChB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG;IACxB,6DAA6D;IAC7D,wBAAwB,EAAE,UAAU,CAAA;IACpC,6CAA6C;IAC7C,gBAAgB,EAAE,UAAU,CAAA;IAC5B,mCAAmC;IACnC,mBAAmB,EAAE,UAAU,CAAA;IAC/B,4BAA4B;IAC5B,SAAS,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,sFAAsF;AACtF,MAAM,MAAM,MAAM,GAAG;IACnB,gFAAgF;IAChF,wBAAwB,EAAE,UAAU,CAAA;IACpC,kEAAkE;IAClE,QAAQ,EAAE;QACR,kCAAkC;QAClC,OAAO,EAAE,MAAM,CAAA;QACf,sDAAsD;QACtD,WAAW,EAAE,SAAS,CAAC,WAAW,CAAA;QAClC,sCAAsC;QACtC,MAAM,EAAE,OAAO,CAAA;QACf,kDAAkD;QAClD,yBAAyB,EAAE,MAAM,CAAA;QACjC,uDAAuD;QACvD,uBAAuB,EAAE,MAAM,CAAA;QAC/B,yBAAyB;QACzB,YAAY,EAAE,OAAO,CAAA;KACtB,CAAA;IACD,yFAAyF;IACzF,KAAK,EAAE,SAAS,WAAW,EAAE,CAAA;IAC7B,4GAA4G;IAC5G,eAAe,EAAE,SAAS,WAAW,EAAE,CAAA;IACvC,4BAA4B;IAC5B,cAAc,EAAE,MAAM,CAAA;IACtB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAA;IACrB,iFAAiF;IACjF,WAAW,EAAE,SAAS,OAAO,EAAE,CAAA;CAChC,CAAA;AAED;;;GAGG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA0FnE;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,0CAA0C;IAC1C,KAAK,OAAO,GAAG;QACb,kCAAkC;QAClC,OAAO,EAAE,MAAM,CAAA;QACf,yCAAyC;QACzC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAA;QACT,0CAA0C;QAC1C,IAAI,EAAE,IAAI,CAAC,MAAM,CAAA;QACjB,yBAAyB;QACzB,YAAY,EAAE,MAAM,CAAA;KACrB,CAAA;CACF;AAED;;;GAGG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnE;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,6CAA6C;IAC7C,KAAK,OAAO,GAAG,cAAc,CAAC,cAAc,CAAC,OAAO,GAAG;QACrD,yCAAyC;QACzC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAA;KACV,CAAA;CACF;AAyCD,2DAA2D;AAC3D,qBAAa,UAAW,SAAQ,KAAK;IAC1B,IAAI,SAAqB;CACnC"}

package/dist/internal/rewards/Audit.js

@@ -0,0 +1,134 @@
+import { getAddress } from 'viem';
+import * as RewardAccounts from '../../db/tables/rewardAccounts.js';
+import * as RewardCampaigns from '../../db/tables/rewardCampaigns.js';
+import * as RewardEligibilityAssociations from '../../db/tables/rewardEligibilityAssociations.js';
+import * as Events from './Events.js';
+import * as Projection from './Projection.js';
+/**
+ * Replays every eligible registration's deposit and EarnShare history through
+ * the campaign's committed cursor and compares it with the stored projections.
+ */
+export async function audit(options) {
+    const { db, tidx } = options;
+    const campaign = await RewardCampaigns.get(db, options);
+    if (!campaign)
+        throw new AuditError('Reward campaign not found.');
+    const boost = campaign.config.boostRewards;
+    if (!boost)
+        throw new AuditError('Reward campaign has no boost rewards to audit.');
+    if (!campaign.eventCursor)
+        throw new AuditError('Reward campaign has not delivered a run yet.');
+    const eventCursor = campaign.eventCursor;
+    const eligible = await allEligible(db, campaign);
+    const registrations = eligible.map((entry) => ({
+        recipient: getAddress(entry.walletAddress),
+        registeredAt: entry.latestRegisteredAt,
+        registrationOrder: BigInt(entry.registrationOrder),
+    }));
+    const stored = await RewardAccounts.list(db, campaign);
+    const storedByRecipient = new Map(stored.map((account) => [account.recipient.toLowerCase(), account]));
+    // Replay from an empty projection so every registration is rebuilt from history. Exclusions are
+    // skipped: they only remove protocol contracts, which cannot register as eligible wallets.
+    const replayed = registrations.length === 0
+        ? []
+        : (await Projection.reconcilePages({
+            accounts: [],
+            eligible: registrations,
+            excluded: [],
+            pages: () => boundedPages(Events.accountEventPages(tidx, {
+                accounts: registrations.map((entry) => entry.recipient),
+                earnShare: campaign.earnShareAddress,
+                earnVault: campaign.vaultAddress,
+                throughBlock: eventCursor.blockNumber,
+            }), eventCursor),
+            perUserPrincipalCapAssets: BigInt(boost.perUserPrincipalCapAssets),
+            principalAllocationOrder: 'deposit',
+            totalPrincipalCapAssets: BigInt(boost.totalPrincipalCapAssets),
+        })).accounts;
+    const missingDeposits = [];
+    const drift = [];
+    const unprojected = [];
+    for (const account of replayed) {
+        const record = storedByRecipient.get(account.recipient.toLowerCase());
+        if (!record) {
+            unprojected.push(account.recipient);
+            continue;
+        }
+        const discrepancy = {
+            allocatedPrincipalAssets: compare(record.allocatedPrincipalAssets, account.allocatedPrincipalAssets),
+            publicEarnShares: compare(record.publicEarnShares, account.publicEarnShares),
+            qualifiedEarnShares: compare(record.qualifiedEarnShares, account.qualifiedEarnShares),
+            recipient: account.recipient,
+        };
+        if (account.allocatedPrincipalAssets > BigInt(record.allocatedPrincipalAssets))
+            missingDeposits.push(discrepancy);
+        else if (discrepancy.allocatedPrincipalAssets.expected !==
+            discrepancy.allocatedPrincipalAssets.stored ||
+            discrepancy.publicEarnShares.expected !== discrepancy.publicEarnShares.stored ||
+            discrepancy.qualifiedEarnShares.expected !== discrepancy.qualifiedEarnShares.stored)
+            drift.push(discrepancy);
+    }
+    return {
+        allocatedPrincipalAssets: compare(stored.reduce((sum, account) => sum + BigInt(account.allocatedPrincipalAssets), 0n), replayed.reduce((sum, account) => sum + account.allocatedPrincipalAssets, 0n)),
+        campaign: {
+            chainId: campaign.chainId,
+            eventCursor,
+            paused: campaign.paused,
+            perUserPrincipalCapAssets: boost.perUserPrincipalCapAssets,
+            totalPrincipalCapAssets: boost.totalPrincipalCapAssets,
+            vaultAddress: campaign.vaultAddress,
+        },
+        drift,
+        missingDeposits,
+        registrations: registrations.length,
+        storedAccounts: stored.length,
+        unprojected,
+    };
+}
+/**
+ * Clears deposit-derived state for the given recipients so the next reward run
+ * replays their history through the registration reconciliation path.
+ */
+export async function reset(options) {
+    return RewardAccounts.resetPrincipal(options.db, options);
+}
+/** Drops events past the committed cursor; pages are block-bounded, the cursor is log-bounded. */
+async function* boundedPages(pages, cursor) {
+    for await (const page of pages) {
+        const events = page.filter((event) => compareCursors(event.cursor, cursor) <= 0);
+        if (events.length > 0)
+            yield { events };
+    }
+}
+async function allEligible(db, campaign) {
+    const records = [];
+    let cursor;
+    do {
+        const page = await RewardEligibilityAssociations.list(db, {
+            chainId: campaign.chainId,
+            ...(cursor ? { cursor } : {}),
+            limit: 1_000,
+            vaultAddress: campaign.vaultAddress,
+        });
+        records.push(...page.data);
+        cursor = page.nextCursor ?? undefined;
+    } while (cursor);
+    return records;
+}
+function compare(stored, expected) {
+    return { expected: expected.toString(), stored: stored.toString() };
+}
+function compareCursors(left, right) {
+    if (left.blockNumber !== right.blockNumber)
+        return left.blockNumber < right.blockNumber ? -1 : 1;
+    if (left.transactionIndex !== right.transactionIndex)
+        return left.transactionIndex < right.transactionIndex ? -1 : 1;
+    if (left.logIndex !== right.logIndex)
+        return left.logIndex < right.logIndex ? -1 : 1;
+    return 0;
+}
+/** The campaign cannot be audited in its current state. */
+export class AuditError extends Error {
+    name = 'Audit.AuditError';
+}
+//# sourceMappingURL=Audit.js.map

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

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