@kehtus/proportion-sdk 0.4.2 → 1.1.0

package/dist/indexer.js

@@ -21,8 +21,24 @@ export class IndexerModule {
     static MAIN_VAULT_CONFIG_FIELDS = `id vaultAddress factoryAddress owner pendingOwner relayer paused protocolFeeReceiver feeMultiplier subscriptionFeeMultiplier dailyDdDiscountBps minBuilderShares builderLeverage protocolFeeBps minAccountSize maxAccountSize minDrawdownBps maxDrawdownBps maxUtilizationBps maxSingleAccountBps hypeForSpot maxCap createdAt updatedAt`;
     static FACTORY_CONFIG_FIELDS = `id factoryAddress vaultAddress owner pendingOwner createdAt updatedAt`;
     static CONFIG_CHANGE_FIELDS = `id contractAddress contractType field oldValue newValue blockNumber timestamp txHash`;
-    static VAULT_DAY_DATA_FIELDS = `id date dayNumber evmBalance totalAllocated totalAssets totalShares sharePrice dailyDeposits dailyWithdrawals dailyNetLpFlow dailyActivationFees dailyActivationFeesToVault dailyProfitShares dailyCancelledProfit dailySubscriptionFees dailyProtocolFeesRouted dailyHypercoreFees dailyRescuedFunds dailyAccountReturnAmount dailyAccountPrincipalReturned dailyAccountGains dailyAccountLosses dailyPerformancePnl totalAccountsActivated totalAccountsActive totalAccountsClosed accountsActivatedToday accountsClosedToday navChange24h sharePriceChange24h return24hBps paused updatedAt`;
+    static VAULT_DAY_DATA_FIELDS = `id date dayNumber evmBalance totalAllocated totalAssets totalShares sharePrice dailyDeposits dailyWithdrawals dailyNetLpFlow dailyActivationFees dailyActivationFeesToVault dailyProfitShares dailyCancelledProfit dailySubscriptionFees dailyProtocolFeesRouted dailyHypercoreFees dailyRescuedFunds dailyAccountReturnAmount dailyAccountPrincipalReturned dailyAccountGains dailyAccountLosses dailyPerformancePnl dailyClosedAccountNetPnl cumulativeRealizedPnl totalAccountsActivated totalAccountsActive totalAccountsClosed accountsActivatedToday accountsClosedToday navChange24h sharePriceChange24h return24hBps realizedReturn24hBps paused updatedAt`;
     static LP_DAY_DATA_FIELDS = `id lp { id } date dayNumber shares sharesValue dailyDeposits dailyWithdrawals depositCount withdrawCount`;
+    // ── Challenge / B-book field sets (envio-unified schema) ──
+    static CHALLENGE_FIELDS = `id trader { id } builder { id address } payer vaultAddress allocation6 initialBalance6 phase failReason currentPhase reduceOnly totalPhases targetProfitBps finalTargetProfitBps drawdownBps dailyDrawdownEnabled tradingDaysEnabled profitableDaysRequired maxLeverageBps maxNotional6 maxOpenPositions minHoldBlocks freeBalance6 realizedPnl6 totalTradingFees6 equity6 highWaterMark6 dayStartEquity6 profitableDaysCount positionCount openPositionCount liquidationCount tradeCount totalVolume6 challengeFee6 builderAmount6 quoteHash quoteNonce quoteDeadline totalPayoutGross6 payoutCount promotedFundedAccount { id } activationFeePaid6 activatedAt challengeExpiry passedAt paperFundedAt failedAt closedAt promotedAt createdAt updatedAt`;
+    static CHALLENGE_BUILDER_FIELDS = `id address balance6 pendingPayouts6 delinquentSince isDelinquent activeChallengeExposure6 passedExposure6 paperFundedExposure6 queuedPayoutExposure6 pendingPassedAccounts pendingPayoutCount quoteEpoch totalFeesCollected6 totalDeposited6 totalWithdrawn6 totalInstantPaid6 totalQueuedPaid6 totalActivationFeesDebited6 challengesSold challengesPassed challengesPromoted registeredAt updatedAt`;
+    static CHALLENGE_POSITION_FIELDS = `id challenge { id } positionId market isLong status entryPrice marginOpen6 notionalOpen6 marginCurrent6 notionalCurrent6 cumulativeReducedNotional6 realizedPnl6 openFee6 closeFee6 exitPrice stopLossPrice takeProfitPrice exitOrderExecutedKind exitOrderTriggerPrice exitOrderRiskPrice exitOrderExecutedAt openedAtBlock openTx closeTx openedAt closedAt updatedAt`;
+    static CHALLENGE_TRADE_FIELDS = `id challenge { id } positionId kind market isLong margin6 notional6 price pnl6 fee6 freeBalanceAfter6 blockNumber timestamp txHash`;
+    static CHALLENGE_CHECKPOINT_FIELDS = `id challenge { id } kind equity6 highWaterMark6 dayStartEquity6 profitableDaysCount blockNumber timestamp txHash`;
+    static CHALLENGE_PAYOUT_FIELDS = `id challenge { id } trader { id } builderAddress requestedGross6 instantPaid6 queuedGross6 queuedPaid6 queueId fullyPaid requestedAt blockNumber txHash`;
+    static CHALLENGE_QUEUE_ENTRY_FIELDS = `id queueId challenge { id } builder { id } payoutId traderAddress originalGross6 remainingGross6 paidGross6 fullyPaid queuedAt lastPaidAt updatedAt`;
+    static CHALLENGE_DAY_DATA_FIELDS = `id date dayNumber challengesSold challengesPassed challengesPaperFunded challengesPromoted challengesFailed challengesClosed dailyChallengeFees6 dailyBuilderFees6 dailyPayoutGross6 dailyTradingVolume6 dailyTradingFees6 tradeCount updatedAt`;
+    static TRADER_FIELDS = `id challengesBought challengesPassed challengesPaperFunded challengesPromoted challengesFailed totalChallengeFeesPaid6 totalChallengePayoutGross6 firstSeenAt lastActionAt updatedAt`;
+    static JOURNEY_EVENT_FIELDS = `id trader { id } builderAddress kind challenge { id } fundedAccount { id } amount6 blockNumber timestamp txHash`;
+    static FOUNDER_PARTICIPANT_FIELDS = `id wallet firstSeenAt firstQualifiedAt firstQualifiedWeek founderRank founderTier founderBoostBps boostActive totalRawPoints totalFinalPoints totalPenaltyPoints challengePoints fundedPoints lpPoints spendPoints performancePoints lastActionAt updatedAt`;
+    static FOUNDER_WALLET_WEEK_FIELDS = `id wallet weekStart weekEnd rawSpendPoints rawPerformancePoints rawLpPoints rawPenaltyPoints finalSpendPoints finalPerformancePoints finalLpPoints finalPenaltyPoints totalFinalPoints liquidationCount breachCount founderTier founderBoostBps maturityBps updatedAt`;
+    static FOUNDER_POINT_EVENT_FIELDS = `id wallet weekStart source kind category rawPoints adjustedPoints finalPoints penaltyPoints maturityBps founderBoostBps qualityBps saturationBps walletMultiplierBps weeklyBoostBps amount accountSize relatedAccount builder txHash blockNumber timestamp`;
+    static FOUNDER_MULTIPLIER_FIELDS = `id wallet passExpiresAt activeFundedAccounts payoutBps payoutExpiresAt updatedAt`;
+    static FOUNDER_WEEKLY_BOOST_FIELDS = `id weekStart kind targetKind boostBps lpNeedBps utilizationBps updatedAt`;
     async getCachedProtocol() {
         if (this.cachedProtocol !== undefined)
             return this.cachedProtocol;
@@ -87,40 +103,40 @@ export class IndexerModule {
     async getVault(vaultAddress) {
         const resolved = await this.resolveVaultAddress(vaultAddress);
         if (!resolved) {
-            const data = await this.query(`
-        query { Vault(order_by: { updatedAt: desc }, limit: 1) { ${IndexerModule.VAULT_FIELDS} } }
+            const data = await this.query(`
+        query { Vault(order_by: { updatedAt: desc }, limit: 1) { ${IndexerModule.VAULT_FIELDS} } }
       `);
             return data.Vault[0] ?? null;
         }
-        const data = await this.query(`
-      query($id: String!) { Vault(where: { id: { _eq: $id } }) { ${IndexerModule.VAULT_FIELDS} } }
+        const data = await this.query(`
+      query($id: String!) { Vault(where: { id: { _eq: $id } }) { ${IndexerModule.VAULT_FIELDS} } }
     `, { id: resolved });
         return data.Vault[0] ?? null;
     }
     // ── LP ────────────────────────────────────────────
     async getLP(address) {
-        const data = await this.query(`
-      query($id: String!) { LiquidityProvider(where: { id: { _ilike: $id } }) { id shares totalDeposited totalWithdrawn depositCount withdrawCount lastActionAt } }
+        const data = await this.query(`
+      query($id: String!) { LiquidityProvider(where: { id: { _ilike: $id } }) { id shares totalDeposited totalWithdrawn depositCount withdrawCount lastActionAt } }
     `, { id: address });
         return data.LiquidityProvider[0] ?? null;
     }
     async getLPDeposits(address, p) {
-        const data = await this.query(`
-      query($lp: String!, $limit: Int, $offset: Int) {
-        VaultDeposit(where: { lp_id: { _ilike: $lp } }, order_by: { timestamp: desc }, limit: $limit, offset: $offset) {
-          id lp { id } amount sharesReceived timestamp txHash
-        }
-      }
+        const data = await this.query(`
+      query($lp: String!, $limit: Int, $offset: Int) {
+        VaultDeposit(where: { lp_id: { _ilike: $lp } }, order_by: { timestamp: desc }, limit: $limit, offset: $offset) {
+          id lp { id } amount sharesReceived timestamp txHash
+        }
+      }
     `, { lp: address, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
         return data.VaultDeposit;
     }
     async getLPWithdrawals(address, p) {
-        const data = await this.query(`
-      query($lp: String!, $limit: Int, $offset: Int) {
-        VaultWithdrawal(where: { lp_id: { _ilike: $lp } }, order_by: { timestamp: desc }, limit: $limit, offset: $offset) {
-          id lp { id } amount sharesBurned timestamp txHash
-        }
-      }
+        const data = await this.query(`
+      query($lp: String!, $limit: Int, $offset: Int) {
+        VaultWithdrawal(where: { lp_id: { _ilike: $lp } }, order_by: { timestamp: desc }, limit: $limit, offset: $offset) {
+          id lp { id } amount sharesBurned timestamp txHash
+        }
+      }
     `, { lp: address, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
         return data.VaultWithdrawal;
     }
@@ -128,80 +144,80 @@ export class IndexerModule {
     async getBuilder(address, vaultAddress) {
         const resolved = await this.resolveVaultAddress(vaultAddress);
         if (!resolved) {
-            const data = await this.query(`
-        query($address: String!) {
-          Builder(where: { address: { _ilike: $address } }) { ${IndexerModule.BUILDER_FIELDS} }
-        }
+            const data = await this.query(`
+        query($address: String!) {
+          Builder(where: { address: { _ilike: $address } }) { ${IndexerModule.BUILDER_FIELDS} }
+        }
       `, { address });
             return data.Builder[0] ?? null;
         }
-        const data = await this.query(`
-      query($address: String!, $vaultAddress: String) {
-        Builder(where: { address: { _ilike: $address } vaultAddress: { _ilike: $vaultAddress } }) { ${IndexerModule.BUILDER_FIELDS} }
-      }
+        const data = await this.query(`
+      query($address: String!, $vaultAddress: String) {
+        Builder(where: { address: { _ilike: $address } vaultAddress: { _ilike: $vaultAddress } }) { ${IndexerModule.BUILDER_FIELDS} }
+      }
     `, { address, vaultAddress: resolved });
         return data.Builder[0] ?? null;
     }
     async getDelegates(builder, vaultAddress) {
         const resolved = await this.resolveVaultAddress(vaultAddress);
         if (!resolved) {
-            const data = await this.query(`
-        query($builder: String!) {
-          Delegate(where: { builderAddress: { _ilike: $builder } }) { ${IndexerModule.DELEGATE_FIELDS} }
-        }
+            const data = await this.query(`
+        query($builder: String!) {
+          Delegate(where: { builderAddress: { _ilike: $builder } }) { ${IndexerModule.DELEGATE_FIELDS} }
+        }
       `, { builder });
             return data.Delegate;
         }
-        const data = await this.query(`
-      query($builder: String!, $vaultAddress: String) {
-        Delegate(where: { builderAddress: { _ilike: $builder } vaultAddress: { _ilike: $vaultAddress } }) { ${IndexerModule.DELEGATE_FIELDS} }
-      }
+        const data = await this.query(`
+      query($builder: String!, $vaultAddress: String) {
+        Delegate(where: { builderAddress: { _ilike: $builder } vaultAddress: { _ilike: $vaultAddress } }) { ${IndexerModule.DELEGATE_FIELDS} }
+      }
     `, { builder, vaultAddress: resolved });
         return data.Delegate;
     }
     // ── ACCOUNTS ──────────────────────────────────────
     async getAccount(address) {
-        const data = await this.query(`
-      query($id: String!) { FundedAccount(where: { id: { _ilike: $id } }) { ${IndexerModule.ACCOUNT_FIELDS} } }
+        const data = await this.query(`
+      query($id: String!) { FundedAccount(where: { id: { _ilike: $id } }) { ${IndexerModule.ACCOUNT_FIELDS} } }
     `, { id: address });
         return data.FundedAccount[0] ?? null;
     }
     async getAccountsByOwner(owner, p) {
-        const data = await this.query(`
-      query($owner: String!, $limit: Int, $offset: Int) {
-        FundedAccount(where: { owner: { _ilike: $owner } }, order_by: { createdAt: desc }, limit: $limit, offset: $offset) { ${IndexerModule.ACCOUNT_FIELDS} }
-      }
+        const data = await this.query(`
+      query($owner: String!, $limit: Int, $offset: Int) {
+        FundedAccount(where: { owner: { _ilike: $owner } }, order_by: { createdAt: desc }, limit: $limit, offset: $offset) { ${IndexerModule.ACCOUNT_FIELDS} }
+      }
     `, { owner: owner, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
         return data.FundedAccount;
     }
     async getAccountsByBuilder(builder, vaultAddress, p) {
         const resolved = await this.resolveVaultAddress(vaultAddress);
         if (!resolved) {
-            const data = await this.query(`
-        query($builder: String!, $limit: Int, $offset: Int) {
-          FundedAccount(
-            where: { builder: { address: { _ilike: $builder } } },
-            order_by: { createdAt: desc }, limit: $limit, offset: $offset
-          ) { ${IndexerModule.ACCOUNT_FIELDS} }
-        }
+            const data = await this.query(`
+        query($builder: String!, $limit: Int, $offset: Int) {
+          FundedAccount(
+            where: { builder: { address: { _ilike: $builder } } },
+            order_by: { createdAt: desc }, limit: $limit, offset: $offset
+          ) { ${IndexerModule.ACCOUNT_FIELDS} }
+        }
       `, { builder, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
             return data.FundedAccount;
         }
-        const data = await this.query(`
-      query($builder: String!, $vaultAddress: String, $limit: Int, $offset: Int) {
-        FundedAccount(
-          where: { builder: { address: { _ilike: $builder } vaultAddress: { _ilike: $vaultAddress } } },
-          order_by: { createdAt: desc }, limit: $limit, offset: $offset
-        ) { ${IndexerModule.ACCOUNT_FIELDS} }
-      }
+        const data = await this.query(`
+      query($builder: String!, $vaultAddress: String, $limit: Int, $offset: Int) {
+        FundedAccount(
+          where: { builder: { address: { _ilike: $builder } vaultAddress: { _ilike: $vaultAddress } } },
+          order_by: { createdAt: desc }, limit: $limit, offset: $offset
+        ) { ${IndexerModule.ACCOUNT_FIELDS} }
+      }
     `, { builder, vaultAddress: resolved, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
         return data.FundedAccount;
     }
     async getAccountsByState(state, p) {
-        const data = await this.query(`
-      query($state: accountstate!, $limit: Int, $offset: Int) {
-        FundedAccount(where: { state: { _eq: $state } }, order_by: { updatedAt: desc }, limit: $limit, offset: $offset) { ${IndexerModule.ACCOUNT_FIELDS} }
-      }
+        const data = await this.query(`
+      query($state: accountstate!, $limit: Int, $offset: Int) {
+        FundedAccount(where: { state: { _eq: $state } }, order_by: { updatedAt: desc }, limit: $limit, offset: $offset) { ${IndexerModule.ACCOUNT_FIELDS} }
+      }
     `, { state, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
         return data.FundedAccount;
     }
@@ -209,10 +225,10 @@ export class IndexerModule {
         const all = [];
         let offset = 0;
         while (true) {
-            const data = await this.query(`
-        query($states: [accountstate!]!, $limit: Int!, $offset: Int!) {
-          FundedAccount(where: { state: { _in: $states } }, order_by: { updatedAt: desc }, limit: $limit, offset: $offset) { ${IndexerModule.ACCOUNT_FIELDS} }
-        }
+            const data = await this.query(`
+        query($states: [accountstate!]!, $limit: Int!, $offset: Int!) {
+          FundedAccount(where: { state: { _in: $states } }, order_by: { updatedAt: desc }, limit: $limit, offset: $offset) { ${IndexerModule.ACCOUNT_FIELDS} }
+        }
       `, { states, limit: IndexerModule.PAGE_SIZE, offset });
             all.push(...data.FundedAccount);
             if (data.FundedAccount.length < IndexerModule.PAGE_SIZE)
@@ -225,10 +241,10 @@ export class IndexerModule {
         const all = [];
         let offset = 0;
         while (true) {
-            const data = await this.query(`
-        query($since: numeric!, $limit: Int!, $offset: Int!) {
-          FundedAccount(where: { updatedAt: { _gt: $since } }, order_by: { updatedAt: asc }, limit: $limit, offset: $offset) { ${IndexerModule.ACCOUNT_FIELDS} }
-        }
+            const data = await this.query(`
+        query($since: numeric!, $limit: Int!, $offset: Int!) {
+          FundedAccount(where: { updatedAt: { _gt: $since } }, order_by: { updatedAt: asc }, limit: $limit, offset: $offset) { ${IndexerModule.ACCOUNT_FIELDS} }
+        }
       `, { since, limit: IndexerModule.PAGE_SIZE, offset });
             all.push(...data.FundedAccount);
             if (data.FundedAccount.length < IndexerModule.PAGE_SIZE)
@@ -239,59 +255,59 @@ export class IndexerModule {
     }
     // ── HISTORY ───────────────────────────────────────
     async getCheckpoints(account, p) {
-        const data = await this.query(`
-      query($account: String!, $limit: Int, $offset: Int) {
-        Checkpoint(where: { account_id: { _ilike: $account } }, order_by: { dayNumber: desc }, limit: $limit, offset: $offset) {
-          id dayNumber accountValue previousValue profitable profitableDaysCount timestamp
-        }
-      }
+        const data = await this.query(`
+      query($account: String!, $limit: Int, $offset: Int) {
+        Checkpoint(where: { account_id: { _ilike: $account } }, order_by: { dayNumber: desc }, limit: $limit, offset: $offset) {
+          id dayNumber accountValue previousValue profitable profitableDaysCount timestamp
+        }
+      }
     `, { account: account, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
         return data.Checkpoint;
     }
     async getWithdrawals(account, p) {
-        const data = await this.query(`
-      query($account: String!, $limit: Int, $offset: Int) {
-        ProfitWithdrawal(where: { account_id: { _ilike: $account } }, order_by: { requestedAt: desc }, limit: $limit, offset: $offset) {
-          id profit ownerAmount vaultAmount protocolAmount status requestedAt claimedAt cancelledAt
-        }
-      }
+        const data = await this.query(`
+      query($account: String!, $limit: Int, $offset: Int) {
+        ProfitWithdrawal(where: { account_id: { _ilike: $account } }, order_by: { requestedAt: desc }, limit: $limit, offset: $offset) {
+          id profit ownerAmount vaultAmount protocolAmount status requestedAt claimedAt cancelledAt
+        }
+      }
     `, { account: account, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
         return data.ProfitWithdrawal;
     }
     async getSubscriptionPayments(account, p) {
-        const data = await this.query(`
-      query($account: String!, $limit: Int, $offset: Int) {
-        SubscriptionPayment(where: { account_id: { _ilike: $account } }, order_by: { timestamp: desc }, limit: $limit, offset: $offset) {
-          id amount paidUntil timestamp
-        }
-      }
+        const data = await this.query(`
+      query($account: String!, $limit: Int, $offset: Int) {
+        SubscriptionPayment(where: { account_id: { _ilike: $account } }, order_by: { timestamp: desc }, limit: $limit, offset: $offset) {
+          id amount paidUntil timestamp
+        }
+      }
     `, { account: account, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
         return data.SubscriptionPayment;
     }
     async getEvents(account, p) {
-        const data = await this.query(`
-      query($account: String!, $limit: Int, $offset: Int) {
-        AccountEvent(where: { account_id: { _ilike: $account } }, order_by: { blockNumber: desc }, limit: $limit, offset: $offset) {
-          id eventType data timestamp blockNumber txHash
-        }
-      }
+        const data = await this.query(`
+      query($account: String!, $limit: Int, $offset: Int) {
+        AccountEvent(where: { account_id: { _ilike: $account } }, order_by: { blockNumber: desc }, limit: $limit, offset: $offset) {
+          id eventType data timestamp blockNumber txHash
+        }
+      }
     `, { account: account, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
         return data.AccountEvent;
     }
     async getEventsByType(type, limit) {
-        const data = await this.query(`
-      query($type: String!, $limit: Int) {
-        AccountEvent(where: { eventType: { _eq: $type } }, order_by: { blockNumber: desc }, limit: $limit) {
-          id eventType data timestamp blockNumber txHash
-        }
-      }
+        const data = await this.query(`
+      query($type: String!, $limit: Int) {
+        AccountEvent(where: { eventType: { _eq: $type } }, order_by: { blockNumber: desc }, limit: $limit) {
+          id eventType data timestamp blockNumber txHash
+        }
+      }
     `, { type, limit: limit ?? 50 });
         return data.AccountEvent;
     }
     // ── PROTOCOL CONFIG ─────────────────────────────
     async getProtocolConfig() {
-        const data = await this.query(`{
-      ProtocolConfig { id vaultAddress factoryAddress updatedAt }
+        const data = await this.query(`{
+      ProtocolConfig { id vaultAddress factoryAddress updatedAt }
     }`);
         return data.ProtocolConfig[0] ?? null;
     }
@@ -299,26 +315,26 @@ export class IndexerModule {
     async getMainVaultConfig(vaultAddress) {
         const resolved = await this.resolveVaultAddress(vaultAddress);
         if (!resolved) {
-            const data = await this.query(`
-        query { MainVaultConfig(order_by: { updatedAt: desc }, limit: 1) { ${IndexerModule.MAIN_VAULT_CONFIG_FIELDS} } }
+            const data = await this.query(`
+        query { MainVaultConfig(order_by: { updatedAt: desc }, limit: 1) { ${IndexerModule.MAIN_VAULT_CONFIG_FIELDS} } }
       `);
             return data.MainVaultConfig[0] ?? null;
         }
-        const data = await this.query(`
-      query($id: String!) { MainVaultConfig(where: { id: { _eq: $id } }) { ${IndexerModule.MAIN_VAULT_CONFIG_FIELDS} } }
+        const data = await this.query(`
+      query($id: String!) { MainVaultConfig(where: { id: { _eq: $id } }) { ${IndexerModule.MAIN_VAULT_CONFIG_FIELDS} } }
     `, { id: resolved });
         return data.MainVaultConfig[0] ?? null;
     }
     async getFactoryConfig(factoryAddress) {
         const resolved = await this.resolveFactoryAddress(factoryAddress);
         if (!resolved) {
-            const data = await this.query(`
-        query { FactoryConfig(order_by: { updatedAt: desc }, limit: 1) { ${IndexerModule.FACTORY_CONFIG_FIELDS} } }
+            const data = await this.query(`
+        query { FactoryConfig(order_by: { updatedAt: desc }, limit: 1) { ${IndexerModule.FACTORY_CONFIG_FIELDS} } }
       `);
             return data.FactoryConfig[0] ?? null;
         }
-        const data = await this.query(`
-      query($id: String!) { FactoryConfig(where: { id: { _eq: $id } }) { ${IndexerModule.FACTORY_CONFIG_FIELDS} } }
+        const data = await this.query(`
+      query($id: String!) { FactoryConfig(where: { id: { _eq: $id } }) { ${IndexerModule.FACTORY_CONFIG_FIELDS} } }
     `, { id: resolved });
         return data.FactoryConfig[0] ?? null;
     }
@@ -347,51 +363,51 @@ export class IndexerModule {
         const whereBlock = whereClauses.length > 0
             ? `where: { ${whereClauses.join(" ")} }`
             : "";
-        const data = await this.query(`
-      query(${variableDefs.join(", ")}) {
-        ConfigChange(
-          ${whereBlock}
-          order_by: [{ timestamp: desc }, { blockNumber: desc }]
-          limit: $limit
-          offset: $offset
-        ) { ${IndexerModule.CONFIG_CHANGE_FIELDS} }
-      }
+        const data = await this.query(`
+      query(${variableDefs.join(", ")}) {
+        ConfigChange(
+          ${whereBlock}
+          order_by: [{ timestamp: desc }, { blockNumber: desc }]
+          limit: $limit
+          offset: $offset
+        ) { ${IndexerModule.CONFIG_CHANGE_FIELDS} }
+      }
     `, variables);
         return data.ConfigChange;
     }
     async getVaultDayData(vaultAddress, p) {
         const resolved = await this.resolveVaultAddress(vaultAddress);
         if (!resolved) {
-            const data = await this.query(`
-        query($limit: Int, $offset: Int) {
-          VaultDayData(order_by: [{ date: desc }, { updatedAt: desc }], limit: $limit, offset: $offset) {
-            ${IndexerModule.VAULT_DAY_DATA_FIELDS}
-          }
-        }
+            const data = await this.query(`
+        query($limit: Int, $offset: Int) {
+          VaultDayData(order_by: [{ date: desc }, { updatedAt: desc }], limit: $limit, offset: $offset) {
+            ${IndexerModule.VAULT_DAY_DATA_FIELDS}
+          }
+        }
       `, { limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
             return data.VaultDayData;
         }
-        const data = await this.query(`
-      query($vaultAddress: String!, $limit: Int, $offset: Int) {
-        VaultDayData(
-          where: { id: { _ilike: $vaultAddress } }
-          order_by: [{ date: desc }, { updatedAt: desc }]
-          limit: $limit, offset: $offset
-        ) { ${IndexerModule.VAULT_DAY_DATA_FIELDS} }
-      }
+        const data = await this.query(`
+      query($vaultAddress: String!, $limit: Int, $offset: Int) {
+        VaultDayData(
+          where: { id: { _ilike: $vaultAddress } }
+          order_by: [{ date: desc }, { updatedAt: desc }]
+          limit: $limit, offset: $offset
+        ) { ${IndexerModule.VAULT_DAY_DATA_FIELDS} }
+      }
     `, { vaultAddress: `${resolved}-%`, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
         return data.VaultDayData;
     }
     async getLPDayData(address, p) {
-        const data = await this.query(`
-      query($lp: String!, $limit: Int, $offset: Int) {
-        LiquidityProviderDayData(
-          where: { lp_id: { _ilike: $lp } }
-          order_by: [{ date: desc }, { dayNumber: desc }]
-          limit: $limit
-          offset: $offset
-        ) { ${IndexerModule.LP_DAY_DATA_FIELDS} }
-      }
+        const data = await this.query(`
+      query($lp: String!, $limit: Int, $offset: Int) {
+        LiquidityProviderDayData(
+          where: { lp_id: { _ilike: $lp } }
+          order_by: [{ date: desc }, { dayNumber: desc }]
+          limit: $limit
+          offset: $offset
+        ) { ${IndexerModule.LP_DAY_DATA_FIELDS} }
+      }
     `, {
             lp: address,
             limit: p?.limit ?? 50,
@@ -402,18 +418,198 @@ export class IndexerModule {
     async getAllowedPerps(vaultAddress) {
         const resolved = await this.resolveVaultAddress(vaultAddress);
         if (!resolved) {
-            const data = await this.query(`
-        query { AllowedPerp(where: { allowed: { _eq: true } }) { id vaultAddress perpIndex allowed } }
+            const data = await this.query(`
+        query { AllowedPerp(where: { allowed: { _eq: true } }) { id vaultAddress perpIndex allowed } }
       `);
             return data.AllowedPerp;
         }
-        const data = await this.query(`
-      query($vaultAddress: String) {
-        AllowedPerp(where: { allowed: { _eq: true } vaultAddress: { _ilike: $vaultAddress } }) { id vaultAddress perpIndex allowed }
-      }
+        const data = await this.query(`
+      query($vaultAddress: String) {
+        AllowedPerp(where: { allowed: { _eq: true } vaultAddress: { _ilike: $vaultAddress } }) { id vaultAddress perpIndex allowed }
+      }
     `, { vaultAddress: resolved });
         return data.AllowedPerp;
     }
+    // ── CHALLENGE / B-BOOK (envio-unified) ────────────
+    async getChallenge(address) {
+        const data = await this.query(`
+      query($id: String!) { Challenge(where: { id: { _ilike: $id } }) { ${IndexerModule.CHALLENGE_FIELDS} } }
+    `, { id: address });
+        return data.Challenge[0] ?? null;
+    }
+    async getChallengesByTrader(trader, p) {
+        const data = await this.query(`
+      query($trader: String!, $limit: Int, $offset: Int) {
+        Challenge(where: { trader_id: { _ilike: $trader } }, order_by: { createdAt: desc }, limit: $limit, offset: $offset) { ${IndexerModule.CHALLENGE_FIELDS} }
+      }
+    `, { trader, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.Challenge;
+    }
+    async getChallengesByBuilder(builder, p) {
+        const data = await this.query(`
+      query($builder: String!, $limit: Int, $offset: Int) {
+        Challenge(where: { builder_id: { _ilike: $builder } }, order_by: { createdAt: desc }, limit: $limit, offset: $offset) { ${IndexerModule.CHALLENGE_FIELDS} }
+      }
+    `, { builder, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.Challenge;
+    }
+    async getChallengesByPhase(phase, p) {
+        const data = await this.query(`
+      query($phase: challengephase!, $limit: Int, $offset: Int) {
+        Challenge(where: { phase: { _eq: $phase } }, order_by: { updatedAt: desc }, limit: $limit, offset: $offset) { ${IndexerModule.CHALLENGE_FIELDS} }
+      }
+    `, { phase, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.Challenge;
+    }
+    async getChallengeBuilder(address) {
+        const data = await this.query(`
+      query($id: String!) { ChallengeBuilder(where: { id: { _ilike: $id } }) { ${IndexerModule.CHALLENGE_BUILDER_FIELDS} } }
+    `, { id: address });
+        return data.ChallengeBuilder[0] ?? null;
+    }
+    async getChallengePositions(challenge, p) {
+        const openFilter = p?.openOnly ? `status: { _eq: Open }` : "";
+        const data = await this.query(`
+      query($challenge: String!, $limit: Int, $offset: Int) {
+        ChallengePosition(where: { challenge_id: { _ilike: $challenge } ${openFilter} }, order_by: { openedAt: desc }, limit: $limit, offset: $offset) { ${IndexerModule.CHALLENGE_POSITION_FIELDS} }
+      }
+    `, { challenge, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.ChallengePosition;
+    }
+    async getChallengeTrades(challenge, p) {
+        const data = await this.query(`
+      query($challenge: String!, $limit: Int, $offset: Int) {
+        ChallengeTrade(where: { challenge_id: { _ilike: $challenge } }, order_by: { timestamp: desc }, limit: $limit, offset: $offset) { ${IndexerModule.CHALLENGE_TRADE_FIELDS} }
+      }
+    `, { challenge, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.ChallengeTrade;
+    }
+    async getChallengeCheckpoints(challenge, p) {
+        const data = await this.query(`
+      query($challenge: String!, $limit: Int, $offset: Int) {
+        ChallengeCheckpoint(where: { challenge_id: { _ilike: $challenge } }, order_by: { timestamp: desc }, limit: $limit, offset: $offset) { ${IndexerModule.CHALLENGE_CHECKPOINT_FIELDS} }
+      }
+    `, { challenge, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.ChallengeCheckpoint;
+    }
+    async getChallengePayouts(filter, p) {
+        const clauses = [];
+        const variableDefs = ["$limit: Int", "$offset: Int"];
+        const variables = { limit: p?.limit ?? 50, offset: p?.offset ?? 0 };
+        if (filter.challenge) {
+            variableDefs.push("$challenge: String!");
+            clauses.push("challenge_id: { _ilike: $challenge }");
+            variables.challenge = filter.challenge;
+        }
+        if (filter.trader) {
+            variableDefs.push("$trader: String!");
+            clauses.push("trader_id: { _ilike: $trader }");
+            variables.trader = filter.trader;
+        }
+        if (filter.builder) {
+            variableDefs.push("$builder: String!");
+            clauses.push("builderAddress: { _ilike: $builder }");
+            variables.builder = filter.builder;
+        }
+        const whereBlock = clauses.length > 0 ? `where: { ${clauses.join(" ")} }` : "";
+        const data = await this.query(`
+      query(${variableDefs.join(", ")}) {
+        ChallengePayout(${whereBlock} order_by: { requestedAt: desc }, limit: $limit, offset: $offset) { ${IndexerModule.CHALLENGE_PAYOUT_FIELDS} }
+      }
+    `, variables);
+        return data.ChallengePayout;
+    }
+    /** Live FIFO payout queue of a builder (unpaid entries, oldest first). */
+    async getPayoutQueue(builder, p) {
+        const data = await this.query(`
+      query($builder: String!, $limit: Int, $offset: Int) {
+        ChallengePayoutQueueEntry(where: { builder_id: { _ilike: $builder } fullyPaid: { _eq: false } }, order_by: { queueId: asc }, limit: $limit, offset: $offset) { ${IndexerModule.CHALLENGE_QUEUE_ENTRY_FIELDS} }
+      }
+    `, { builder, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.ChallengePayoutQueueEntry;
+    }
+    async getChallengeDayData(p) {
+        const data = await this.query(`
+      query($limit: Int, $offset: Int) {
+        ChallengeDayData(order_by: { date: desc }, limit: $limit, offset: $offset) { ${IndexerModule.CHALLENGE_DAY_DATA_FIELDS} }
+      }
+    `, { limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.ChallengeDayData;
+    }
+    // ── BRIDGE / JOURNEY ──────────────────────────────
+    async getTrader(address) {
+        const data = await this.query(`
+      query($id: String!) { Trader(where: { id: { _ilike: $id } }) { ${IndexerModule.TRADER_FIELDS} } }
+    `, { id: address });
+        return data.Trader[0] ?? null;
+    }
+    /** Cross-system timeline (challenge ↔ funded) of a trader, newest first. */
+    async getTraderJourney(trader, p) {
+        const data = await this.query(`
+      query($trader: String!, $limit: Int, $offset: Int) {
+        JourneyEvent(where: { trader_id: { _ilike: $trader } }, order_by: { timestamp: desc }, limit: $limit, offset: $offset) { ${IndexerModule.JOURNEY_EVENT_FIELDS} }
+      }
+    `, { trader, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.JourneyEvent;
+    }
+    // ── FOUNDER POINTS ────────────────────────────────
+    async getFounderParticipant(wallet) {
+        const data = await this.query(`
+      query($id: String!) { FounderParticipant(where: { id: { _ilike: $id } }) { ${IndexerModule.FOUNDER_PARTICIPANT_FIELDS} } }
+    `, { id: wallet });
+        return data.FounderParticipant[0] ?? null;
+    }
+    /** Lifetime leaderboard by total final points. */
+    async getFounderLeaderboard(p) {
+        const data = await this.query(`
+      query($limit: Int, $offset: Int) {
+        FounderParticipant(order_by: { totalFinalPoints: desc }, limit: $limit, offset: $offset) { ${IndexerModule.FOUNDER_PARTICIPANT_FIELDS} }
+      }
+    `, { limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.FounderParticipant;
+    }
+    /** Weekly leaderboard for one epoch week (weekStart = unix seconds of the week boundary). */
+    async getFounderWeeklyLeaderboard(weekStart, p) {
+        const data = await this.query(`
+      query($weekStart: numeric!, $limit: Int, $offset: Int) {
+        FounderWalletWeek(where: { weekStart: { _eq: $weekStart } }, order_by: { totalFinalPoints: desc }, limit: $limit, offset: $offset) { ${IndexerModule.FOUNDER_WALLET_WEEK_FIELDS} }
+      }
+    `, { weekStart, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.FounderWalletWeek;
+    }
+    async getFounderWalletWeeks(wallet, p) {
+        const data = await this.query(`
+      query($wallet: String!, $limit: Int, $offset: Int) {
+        FounderWalletWeek(where: { wallet: { _ilike: $wallet } }, order_by: { weekStart: desc }, limit: $limit, offset: $offset) { ${IndexerModule.FOUNDER_WALLET_WEEK_FIELDS} }
+      }
+    `, { wallet, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.FounderWalletWeek;
+    }
+    /** Canonical append-only point journal of a wallet, newest first. */
+    async getFounderPointEvents(wallet, p) {
+        const data = await this.query(`
+      query($wallet: String!, $limit: Int, $offset: Int) {
+        FounderPointEvent(where: { wallet: { _ilike: $wallet } }, order_by: { timestamp: desc }, limit: $limit, offset: $offset) { ${IndexerModule.FOUNDER_POINT_EVENT_FIELDS} }
+      }
+    `, { wallet, limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.FounderPointEvent;
+    }
+    /** Active skill multipliers (pass/activation/realization) of a wallet. */
+    async getFounderMultiplier(wallet) {
+        const data = await this.query(`
+      query($id: String!) { FounderMultiplier(where: { id: { _ilike: $id } }) { ${IndexerModule.FOUNDER_MULTIPLIER_FIELDS} } }
+    `, { id: wallet });
+        return data.FounderMultiplier[0] ?? null;
+    }
+    /** Weekly rotating boost entries (deterministic calendar), newest first. */
+    async getFounderWeeklyBoosts(p) {
+        const data = await this.query(`
+      query($limit: Int, $offset: Int) {
+        FounderWeeklyBoost(order_by: { weekStart: desc }, limit: $limit, offset: $offset) { ${IndexerModule.FOUNDER_WEEKLY_BOOST_FIELDS} }
+      }
+    `, { limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.FounderWeeklyBoost;
+    }
     // ── SUBSCRIPTIONS (Hasura graphql-transport-ws) ───
     ensureWs() {
         const WebSocketCtor = (this.transports.webSocketCtor ?? globalThis.WebSocket);
@@ -493,6 +689,14 @@ export class IndexerModule {
     subscribeAllowedPerps(cb) {
         return this.subscribe(`subscription { AllowedPerp(where: { allowed: { _eq: true } }) { id vaultAddress perpIndex allowed } }`, undefined, (data) => cb(data.AllowedPerp));
     }
+    subscribeChallenge(address, cb) {
+        return this.subscribe(`subscription($id: String!) { Challenge(where: { id: { _ilike: $id } }) { ${IndexerModule.CHALLENGE_FIELDS} } }`, { id: address }, (data) => { if (data.Challenge[0])
+            cb(data.Challenge[0]); });
+    }
+    /** Live view of a builder's unpaid FIFO payout queue. */
+    subscribePayoutQueue(builder, cb) {
+        return this.subscribe(`subscription($builder: String!) { ChallengePayoutQueueEntry(where: { builder_id: { _ilike: $builder } fullyPaid: { _eq: false } }, order_by: { queueId: asc }) { ${IndexerModule.CHALLENGE_QUEUE_ENTRY_FIELDS} } }`, { builder }, (data) => cb(data.ChallengePayoutQueueEntry));
+    }
     disconnect() {
         if (this.reconnectTimer) {
             clearTimeout(this.reconnectTimer);