feat: add epoch 1 override configuration

0xCatalyst · 0xCatalyst · commit 8897568b6aa8 · 2026-01-04T06:55:24.000+02:00
diff --git a/config.yaml b/config.yaml
@@ -289,13 +289,38 @@ networks:
         events:
           - event: LoanSelfRepaid(address indexed user, address indexed vault, address debtAsset, address collateralAsset, uint256 amount)
 
-      # PartnerNFT - registered from NFTPartnershipRegistry.PartnershipAdded
+      # PartnerNFT - registered from NFTPartnershipRegistry.PartnershipAdded (for dynamic registration)
       - name: PartnerNFT
         abi_file_path: abis/helpers/ERC721.json
         handler: src/handlers/nft.ts
         events:
           - event: Transfer(address indexed from, address indexed to, uint256 indexed tokenId)
 
+      # Static NFT collections (bootstrapped - tracked from start)
+      - name: The10kSquad
+        abi_file_path: abis/helpers/ERC721.json
+        address: 0x818030837e8350ba63e64d7dc01a547fa73c8279
+        start_block: 0
+        handler: src/handlers/nft.ts
+        events:
+          - event: Transfer(address indexed from, address indexed to, uint256 indexed tokenId)
+
+      - name: Overnads
+        abi_file_path: abis/helpers/ERC721.json
+        address: 0xfb5ba4061f5c50b1daa6c067bb2dfb0a8ebf6a8d
+        start_block: 0
+        handler: src/handlers/nft.ts
+        events:
+          - event: Transfer(address indexed from, address indexed to, uint256 indexed tokenId)
+
+      - name: SolveilPass
+        abi_file_path: abis/helpers/ERC721.json
+        address: 0x8255dacd8a45f4abe6dc821e6f7f3c92a8e22fbb
+        start_block: 0
+        handler: src/handlers/nft.ts
+        events:
+          - event: Transfer(address indexed from, address indexed to, uint256 indexed tokenId)
+
       # NonfungiblePositionManager - registered from LeaderboardConfig.LPPoolConfigured
       - name: NonfungiblePositionManager
         abi_file_path: abis/uniswap/NonfungiblePositionManager.json
diff --git a/src/__tests__/config-events.test.ts b/src/__tests__/config-events.test.ts
@@ -3,6 +3,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { test } from 'node:test';
 
+// Disable bootstrap in tests
+process.env.ENVIO_DISABLE_BOOTSTRAP = 'true';
+
 import { POOL_CONFIGURATOR_ID, POOL_ID, ZERO_ADDRESS } from '../helpers/constants';
 import {
   VIEM_ATOKEN_ADDRESS,
diff --git a/src/__tests__/leaderboard-handlers.test.ts b/src/__tests__/leaderboard-handlers.test.ts
@@ -7,6 +7,7 @@ import { installViemMock } from './viem-mock';
 
 process.env.ENVIO_DISABLE_EXTERNAL_CALLS = 'true';
 process.env.ENVIO_DISABLE_ETH_CALLS = 'true';
+process.env.ENVIO_DISABLE_BOOTSTRAP = 'true';
 
 const ADDRESSES = {
   epochManager: '0x000000000000000000000000000000000000c001',
diff --git a/src/__tests__/leaderboard-keeper.test.ts b/src/__tests__/leaderboard-keeper.test.ts
@@ -2,6 +2,7 @@ import assert from 'node:assert/strict';
 import fs from 'node:fs';
 import path from 'node:path';
 import { test } from 'node:test';
+import { LEADERBOARD_START_BLOCK } from '../helpers/constants';
 
 process.env.ENVIO_DISABLE_EXTERNAL_CALLS = 'true';
 process.env.ENVIO_DISABLE_ETH_CALLS = 'true';
@@ -71,7 +72,7 @@ test('keeper events update leaderboard state and ownership', async () => {
   mockDb = mockDb.entities.LeaderboardEpoch.set({
     id: '1',
     epochNumber: 1n,
-    startBlock: 1n,
+    startBlock: BigInt(LEADERBOARD_START_BLOCK),
     startTime: 0,
     endBlock: undefined,
     endTime: undefined,
@@ -167,7 +168,7 @@ test('keeper events update leaderboard state and ownership', async () => {
     user: ADDRESSES.user,
     votingPower: 1000n * 10n ** 18n,
     timestamp: 100n,
-    ...eventData(10, 100, ADDRESSES.keeper),
+    ...eventData(LEADERBOARD_START_BLOCK + 10, 100, ADDRESSES.keeper),
   });
   mockDb = await TestHelpers.LeaderboardKeeper.VotingPowerSynced.processEvent({
     event: vpSynced,
@@ -179,7 +180,7 @@ test('keeper events update leaderboard state and ownership', async () => {
     collection: ADDRESSES.collection,
     balance: 1n,
     timestamp: 101n,
-    ...eventData(10, 101, ADDRESSES.keeper),
+    ...eventData(LEADERBOARD_START_BLOCK + 10, 101, ADDRESSES.keeper),
   });
   mockDb = await TestHelpers.LeaderboardKeeper.NFTBalanceSynced.processEvent({
     event: nftSynced,
@@ -193,7 +194,7 @@ test('keeper events update leaderboard state and ownership', async () => {
   const settle = TestHelpers.LeaderboardKeeper.UserSettled.createMockEvent({
     user: ADDRESSES.user,
     timestamp: 86400n,
-    ...eventData(11, 86400, ADDRESSES.keeper),
+    ...eventData(LEADERBOARD_START_BLOCK + 11, 86400, ADDRESSES.keeper),
   });
   mockDb = await TestHelpers.LeaderboardKeeper.UserSettled.processEvent({
     event: settle,
diff --git a/src/__tests__/leaderboard.e2e.test.ts b/src/__tests__/leaderboard.e2e.test.ts
@@ -15,6 +15,7 @@ const UNIT = 10n ** 6n;
 
 process.env.ENVIO_DISABLE_EXTERNAL_CALLS = 'true';
 process.env.ENVIO_DISABLE_ETH_CALLS = 'true';
+process.env.ENVIO_DISABLE_BOOTSTRAP = 'true';
 
 const ADDRESSES = {
   user: '0x0000000000000000000000000000000000000001',
diff --git a/src/__tests__/lp-coverage.test.ts b/src/__tests__/lp-coverage.test.ts
@@ -1,6 +1,8 @@
 import assert from 'node:assert/strict';
 import { test } from 'node:test';
 
+process.env.ENVIO_DISABLE_BOOTSTRAP = 'true';
+
 import { AUSD_ADDRESS } from '../helpers/constants';
 import {
   getOrCreateLPPoolState,
diff --git a/src/__tests__/lp-events.test.ts b/src/__tests__/lp-events.test.ts
@@ -8,6 +8,7 @@ import { installViemMock, setLPPositionOverride } from './viem-mock';
 
 process.env.ENVIO_DISABLE_EXTERNAL_CALLS = 'true';
 process.env.ENVIO_DISABLE_ETH_CALLS = 'true';
+process.env.ENVIO_DISABLE_BOOTSTRAP = 'true';
 installViemMock();
 
 const TOKEN_ID = 1n;
diff --git a/src/__tests__/shared-accrual.test.ts b/src/__tests__/shared-accrual.test.ts
@@ -3,6 +3,8 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { test } from 'node:test';
 
+process.env.ENVIO_DISABLE_BOOTSTRAP = 'true';
+
 import { LEADERBOARD_START_BLOCK } from '../helpers/constants';
 import { createDefaultReserve } from '../helpers/entityHelpers';
 import { accruePointsForUserReserve, syncUserReservePointsBaseline } from '../handlers/shared';
diff --git a/src/__tests__/shared-external.test.ts b/src/__tests__/shared-external.test.ts
@@ -3,6 +3,8 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { test } from 'node:test';
 
+process.env.ENVIO_DISABLE_BOOTSTRAP = 'true';
+
 import { LEADERBOARD_START_BLOCK } from '../helpers/constants';
 import { createDefaultReserve } from '../helpers/entityHelpers';
 import { settlePointsForUser } from '../handlers/shared';
diff --git a/src/__tests__/shared-utils.test.ts b/src/__tests__/shared-utils.test.ts
@@ -1,6 +1,9 @@
 import assert from 'node:assert/strict';
 import { test } from 'node:test';
 
+// Disable bootstrap in tests to use default config values
+process.env.ENVIO_DISABLE_BOOTSTRAP = 'true';
+
 import {
   AUSD_ADDRESS,
   DUST_LOCK_START_BLOCK,
diff --git a/src/handlers/leaderboard.ts b/src/handlers/leaderboard.ts
@@ -20,25 +20,32 @@ import {
   updateLifetimePoints,
 } from './shared';
 import { getTestnetBonusBps } from '../helpers/testnetTiers';
-import { normalizeAddress } from '../helpers/constants';
+import {
+  normalizeAddress,
+  EPOCH_1_START_TIME_OVERRIDE,
+  BOOTSTRAP_CONFIG,
+} from '../helpers/constants';
 import { readPoolFee } from '../helpers/viem';
 import './lp';
 
 async function getOrInitLeaderboardConfig(context: handlerContext, timestamp: number) {
   let config = await context.LeaderboardConfig.get('global');
   if (!config) {
+    // Use bootstrap config if epoch 1 override is set and not disabled via env var
+    const useBootstrap =
+      EPOCH_1_START_TIME_OVERRIDE > 0 && process.env.ENVIO_DISABLE_BOOTSTRAP !== 'true';
     config = {
       id: 'global',
-      depositRateBps: 0n,
-      borrowRateBps: 0n,
-      vpRateBps: 0n,
-      lpRateBps: 0n,
-      supplyDailyBonus: 0,
-      borrowDailyBonus: 0,
-      repayDailyBonus: 0,
-      withdrawDailyBonus: 0,
-      cooldownSeconds: 0,
-      minDailyBonusUsd: 0,
+      depositRateBps: useBootstrap ? BOOTSTRAP_CONFIG.depositRateBps : 0n,
+      borrowRateBps: useBootstrap ? BOOTSTRAP_CONFIG.borrowRateBps : 0n,
+      vpRateBps: useBootstrap ? BOOTSTRAP_CONFIG.vpRateBps : 0n,
+      lpRateBps: useBootstrap ? BOOTSTRAP_CONFIG.lpRateBps : 0n,
+      supplyDailyBonus: useBootstrap ? BOOTSTRAP_CONFIG.supplyDailyBonus : 0,
+      borrowDailyBonus: useBootstrap ? BOOTSTRAP_CONFIG.borrowDailyBonus : 0,
+      repayDailyBonus: useBootstrap ? BOOTSTRAP_CONFIG.repayDailyBonus : 0,
+      withdrawDailyBonus: useBootstrap ? BOOTSTRAP_CONFIG.withdrawDailyBonus : 0,
+      cooldownSeconds: useBootstrap ? BOOTSTRAP_CONFIG.cooldownSeconds : 0,
+      minDailyBonusUsd: useBootstrap ? BOOTSTRAP_CONFIG.minDailyBonusUsd : 0,
       lastUpdate: timestamp,
     };
     context.LeaderboardConfig.set(config);
@@ -59,9 +66,18 @@ EpochManager.EpochStart.handler(async ({ event, context }) => {
   );
   const epochNumber = event.params.epochNumber;
   const epochId = epochNumber.toString();
-  const scheduledStartTime = Number(event.params.startTime);
   const currentTimestamp = Number(event.block.timestamp);
 
+  // If epoch 1 override is set and this is epoch 1, use the override timestamp instead
+  // (unless bootstrap is disabled via env var for testing)
+  const useOverride =
+    epochNumber === 1n &&
+    EPOCH_1_START_TIME_OVERRIDE > 0 &&
+    process.env.ENVIO_DISABLE_BOOTSTRAP !== 'true';
+  const scheduledStartTime = useOverride
+    ? EPOCH_1_START_TIME_OVERRIDE
+    : Number(event.params.startTime);
+
   const existingEpoch = await context.LeaderboardEpoch.get(epochId);
   const shouldSetStartBlock = scheduledStartTime > 0 && scheduledStartTime <= currentTimestamp;
   const startBlock =
@@ -71,6 +87,13 @@ EpochManager.EpochStart.handler(async ({ event, context }) => {
         ? BigInt(event.block.number)
         : 0n;
 
+  // Never overwrite scheduledStartTime for an active epoch
+  // This is a defensive measure - altering start time of an active epoch would corrupt point calculations
+  // Note: this also protects bootstrap's start time since bootstrap sets isActive: true
+  const finalScheduledStartTime = existingEpoch?.isActive
+    ? existingEpoch.scheduledStartTime
+    : scheduledStartTime;
+
   context.LeaderboardEpoch.set({
     ...(existingEpoch ?? {
       id: epochId,
@@ -84,7 +107,7 @@ EpochManager.EpochStart.handler(async ({ event, context }) => {
       scheduledStartTime: 0,
       scheduledEndTime: 0,
     }),
-    scheduledStartTime,
+    scheduledStartTime: finalScheduledStartTime,
     startBlock,
   });
 
diff --git a/src/handlers/nft.ts b/src/handlers/nft.ts
diff --git a/src/handlers/shared.ts b/src/handlers/shared.ts
diff --git a/src/helpers/constants.ts b/src/helpers/constants.ts
