@the-situation/indexer 0.17.0 → 0.18.0

package/README.md

@@ -27,15 +27,23 @@ Events will begin appearing within ~15 seconds.
 
 | Variable | Required | Default | Description |
 |----------|----------|---------|-------------|
-| `VOYAGER_API_KEY` | Yes | — | Voyager explorer API key |
+| `VOYAGER_API_KEY` | Yes* | — | Single Voyager explorer API key |
+| `VOYAGER_API_KEYS` | Yes* | — | Comma/whitespace-separated Voyager API key pool for redundancy |
 | `ADMIN_API_KEY` | Yes | — | Bearer token for `/admin/*` endpoints |
 | `DB_PATH` | No | `./data/indexer.db` | SQLite database file path |
 | `PORT` | No | `3000` | HTTP server port |
-| `STARKNET_RPC_URL` | No | `https://api.cartridge.gg/x/starknet/sepolia` | Starknet RPC endpoint |
+| `STARKNET_NETWORK` | No | `sepolia` | Network default set (`sepolia` or `mainnet`) |
+| `STARKNET_RPC_URL` | No | network default | Starknet RPC endpoint |
+| `VOYAGER_API_BASE_URL` | No | network default | Voyager API base URL |
 | `EVENT_POLL_INTERVAL_MS` | No | `15000` | Event polling interval (ms) |
 | `STATE_POLL_INTERVAL_MS` | No | `30000` | Market state refresh interval (ms) |
 | `POSITION_POLL_INTERVAL_MS` | No | `60000` | Position refresh interval (ms) |
 
+`VOYAGER_API_KEY` or `VOYAGER_API_KEYS` must be set. When multiple keys are
+configured, the indexer rotates across them. A key that receives a Voyager
+429/503 response is cooled down independently, and requests continue through
+the remaining keys until every key is cooling down.
+
 ## API Reference
 
 ### Public Endpoints
@@ -222,14 +230,14 @@ The indexer is configured for [Fly.io](https://fly.io) with a persistent volume
 ```bash
 cd packages/indexer
 
-# Create the app (first time only)
+# Create the Sepolia app (first time only)
 fly apps create situation-indexer
 
 # Create a persistent volume for the database
 fly volumes create indexer_data --region iad --size 1
 
 # Set secrets
-fly secrets set VOYAGER_API_KEY=your-key ADMIN_API_KEY=your-key
+fly secrets set VOYAGER_API_KEYS=key-1,key-2,key-3 ADMIN_API_KEY=your-key
 
 # Deploy (uses Dockerfile.indexer at repo root)
 fly deploy
@@ -238,6 +246,37 @@ fly deploy
 curl https://situation-indexer.fly.dev/health
 ```
 
+### Mainnet Deployment
+
+Mainnet uses a separate Fly app and volume so the production database starts
+fresh and cannot mix Sepolia cursor state with mainnet events.
+
+```bash
+cd packages/indexer
+
+# Create the mainnet app (first time only)
+fly apps create situation-indexer-mainnet
+
+# Create the mainnet database volume
+fly volumes create indexer_mainnet_data --app situation-indexer-mainnet --region iad --size 1
+
+# Set secrets on the mainnet app
+fly secrets set --app situation-indexer-mainnet VOYAGER_API_KEYS=key-1,key-2,key-3 ADMIN_API_KEY=your-key
+
+# Deploy with mainnet RPC and Voyager API endpoints
+fly deploy --config fly.mainnet.toml
+
+# Verify
+curl https://situation-indexer-mainnet.fly.dev/health
+```
+
+`fly.mainnet.toml` is configured with:
+
+- `STARKNET_NETWORK=mainnet`
+- `STARKNET_RPC_URL=https://api.cartridge.gg/x/starknet/mainnet`
+- `VOYAGER_API_BASE_URL=https://api.voyager.online/beta`
+- Persistent volume `indexer_mainnet_data` mounted at `/data`
+
 The `fly.toml` is pre-configured with:
 - `shared-cpu-1x` / 512MB RAM
 - Persistent volume mounted at `/data`

package/dist/aggregator/cohort.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Cohort retention builder.
+ *
+ * For each (cohort_week, week_offset, domain_slug, entity_type) tuple, count
+ * the users from the cohort that were active during that week.
+ *
+ * `domain_slug = 'all'` is the un-segmented total. Per-domain rows are also
+ * emitted for every domain a cohort member touched.
+ *
+ * "Active" definitions:
+ *  - trader: had >= 1 trade event in the week
+ *  - lp:     had >= 1 deposit or withdraw event in the week
+ *
+ * The week index is the ISO Monday (UTC). week_offset 0 is the cohort week
+ * itself; offsets > 0 are subsequent weeks.
+ */
+import { type AggEventRow } from './sources';
+import { type MarketDomainMap } from './domains';
+import type { LPLifetimeRow, TraderLifetimeRow } from './lifetime';
+export interface CohortRetentionRow {
+    readonly cohort_week: string;
+    readonly week_offset: number;
+    readonly domain_slug: string;
+    readonly entity_type: 'trader' | 'lp';
+    readonly cohort_size: number;
+    readonly retained: number;
+}
+export declare function buildCohortRetention(events: readonly AggEventRow[], traderLifetime: readonly TraderLifetimeRow[], lpLifetime: readonly LPLifetimeRow[], marketDomains: MarketDomainMap): readonly CohortRetentionRow[];
+export declare function writeCohortRetention(pg: import('bun').SQL, rows: readonly CohortRetentionRow[]): Promise<void>;
+//# sourceMappingURL=cohort.d.ts.map

package/dist/aggregator/cohort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cohort.d.ts","sourceRoot":"","sources":["../../src/aggregator/cohort.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACL,KAAK,WAAW,EAIjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,WAAW,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAoBD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,cAAc,EAAE,SAAS,iBAAiB,EAAE,EAC5C,UAAU,EAAE,SAAS,aAAa,EAAE,EACpC,aAAa,EAAE,eAAe,GAC7B,SAAS,kBAAkB,EAAE,CAqH/B;AAED,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,OAAO,KAAK,EAAE,GAAG,EACrB,IAAI,EAAE,SAAS,kBAAkB,EAAE,GAClC,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/aggregator/cohort.js

@@ -0,0 +1,153 @@
+/**
+ * Cohort retention builder.
+ *
+ * For each (cohort_week, week_offset, domain_slug, entity_type) tuple, count
+ * the users from the cohort that were active during that week.
+ *
+ * `domain_slug = 'all'` is the un-segmented total. Per-domain rows are also
+ * emitted for every domain a cohort member touched.
+ *
+ * "Active" definitions:
+ *  - trader: had >= 1 trade event in the week
+ *  - lp:     had >= 1 deposit or withdraw event in the week
+ *
+ * The week index is the ISO Monday (UTC). week_offset 0 is the cohort week
+ * itself; offsets > 0 are subsequent weeks.
+ */
+import { LIQUIDITY_ADD_TYPES, LIQUIDITY_REMOVE_TYPES, TRADE_EVENT_TYPES, } from './sources';
+import { primaryDomainOf } from './domains';
+function isoWeekStart(ts) {
+    const d = new Date(ts * 1000);
+    const day = d.getUTCDay();
+    const diff = day === 0 ? -6 : 1 - day;
+    const monday = new Date(d.getTime());
+    monday.setUTCDate(d.getUTCDate() + diff);
+    const yyyy = monday.getUTCFullYear();
+    const mm = String(monday.getUTCMonth() + 1).padStart(2, '0');
+    const dd = String(monday.getUTCDate()).padStart(2, '0');
+    return `${yyyy}-${mm}-${dd}`;
+}
+function weekDiff(cohortWeekStr, eventWeekStr) {
+    const cohort = Date.parse(`${cohortWeekStr}T00:00:00Z`);
+    const eventW = Date.parse(`${eventWeekStr}T00:00:00Z`);
+    return Math.floor((eventW - cohort) / (7 * 24 * 60 * 60 * 1000));
+}
+export function buildCohortRetention(events, traderLifetime, lpLifetime, marketDomains) {
+    const traderCohort = new Map();
+    for (const t of traderLifetime) {
+        if (t.cohort_week)
+            traderCohort.set(t.trader, t.cohort_week);
+    }
+    const lpCohort = new Map();
+    for (const l of lpLifetime) {
+        if (l.cohort_week)
+            lpCohort.set(l.provider, l.cohort_week);
+    }
+    const activity = new Map();
+    activity.set('trader', new Map());
+    activity.set('lp', new Map());
+    function record(entityType, domain, cohortWeek, weekOffset, user) {
+        const byEntity = activity.get(entityType);
+        let byDomain = byEntity.get(domain);
+        if (!byDomain) {
+            byDomain = new Map();
+            byEntity.set(domain, byDomain);
+        }
+        let byCohort = byDomain.get(cohortWeek);
+        if (!byCohort) {
+            byCohort = new Map();
+            byDomain.set(cohortWeek, byCohort);
+        }
+        let byOffset = byCohort.get(weekOffset);
+        if (!byOffset) {
+            byOffset = new Set();
+            byCohort.set(weekOffset, byOffset);
+        }
+        byOffset.add(user);
+    }
+    for (const event of events) {
+        if (!event.trader)
+            continue;
+        const eventWeek = isoWeekStart(event.timestamp);
+        const domain = primaryDomainOf(marketDomains, event.market_address);
+        const isTrade = TRADE_EVENT_TYPES.has(event.event_type);
+        const isLPEvent = LIQUIDITY_ADD_TYPES.has(event.event_type) ||
+            LIQUIDITY_REMOVE_TYPES.has(event.event_type);
+        if (isTrade) {
+            const cohort = traderCohort.get(event.trader);
+            if (cohort) {
+                const offset = weekDiff(cohort, eventWeek);
+                if (offset >= 0) {
+                    record('trader', 'all', cohort, offset, event.trader);
+                    record('trader', domain, cohort, offset, event.trader);
+                }
+            }
+        }
+        if (isLPEvent) {
+            const cohort = lpCohort.get(event.trader);
+            if (cohort) {
+                const offset = weekDiff(cohort, eventWeek);
+                if (offset >= 0) {
+                    record('lp', 'all', cohort, offset, event.trader);
+                    record('lp', domain, cohort, offset, event.trader);
+                }
+            }
+        }
+    }
+    // Cohort sizes: count distinct users per (entity_type, domain, cohort_week).
+    // For 'all' it's the count from lifetime tables. For per-domain, it's the
+    // number of cohort members whose activity ever touched that domain
+    // (= the size of week_offset=0 PLUS any user whose first activity in the
+    //  domain happened later — which we approximate by union over all offsets).
+    const out = [];
+    for (const entityType of ['trader', 'lp']) {
+        const byEntity = activity.get(entityType);
+        // Build cohort-level totals for the 'all' bucket from lifetime tables.
+        const cohortTotalAll = new Map();
+        const lifetimeRows = entityType === 'trader' ? traderLifetime : lpLifetime;
+        for (const row of lifetimeRows) {
+            const cw = row.cohort_week;
+            if (!cw)
+                continue;
+            cohortTotalAll.set(cw, (cohortTotalAll.get(cw) ?? 0) + 1);
+        }
+        for (const [domain, byDomain] of byEntity) {
+            for (const [cohortWeek, byCohort] of byDomain) {
+                // Cohort size = union of all users seen in this domain for this cohort.
+                const allUsers = new Set();
+                for (const users of byCohort.values()) {
+                    for (const u of users)
+                        allUsers.add(u);
+                }
+                const cohortSize = domain === 'all' ? (cohortTotalAll.get(cohortWeek) ?? allUsers.size) : allUsers.size;
+                for (const [weekOffset, users] of byCohort) {
+                    out.push({
+                        cohort_week: cohortWeek,
+                        week_offset: weekOffset,
+                        domain_slug: domain,
+                        entity_type: entityType,
+                        cohort_size: cohortSize,
+                        retained: users.size,
+                    });
+                }
+            }
+        }
+    }
+    return out;
+}
+export async function writeCohortRetention(pg, rows) {
+    await pg.begin(async (tx) => {
+        await tx `TRUNCATE TABLE cohort_retention`;
+        for (const r of rows) {
+            await tx `
+        INSERT INTO cohort_retention
+          (cohort_week, week_offset, domain_slug, entity_type,
+           cohort_size, retained, updated_at)
+        VALUES
+          (${r.cohort_week}, ${r.week_offset}, ${r.domain_slug}, ${r.entity_type},
+           ${r.cohort_size}, ${r.retained}, now())
+      `;
+        }
+    });
+}
+//# sourceMappingURL=cohort.js.map

package/dist/aggregator/cohort.js.map

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

package/dist/aggregator/daily.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Daily fact table builders.
+ *
+ * Pure in-memory aggregation — input: events + positions + market→domain map.
+ * Output: arrays of rows ready to bulk-insert into Postgres.
+ *
+ * Approach: full recompute per cycle. With ~100k events this is sub-second.
+ * Switch to incremental if event count grows past ~10M.
+ */
+import { type AggEventRow } from './sources';
+import { type MarketDomainMap } from './domains';
+export interface DailyTraderStatRow {
+    readonly date: string;
+    readonly trader: string;
+    readonly domain_slug: string;
+    readonly trade_count: number;
+    readonly buy_count: number;
+    readonly sell_count: number;
+    readonly volume_collateral: number;
+    readonly markets_traded: number;
+}
+export interface DailyLPStatRow {
+    readonly date: string;
+    readonly provider: string;
+    readonly domain_slug: string;
+    readonly deposit_count: number;
+    readonly withdraw_count: number;
+    readonly deposited: number;
+    readonly withdrawn: number;
+    readonly markets_active: number;
+}
+export interface DailyMarketStatRow {
+    readonly date: string;
+    readonly market_address: string;
+    readonly trade_count: number;
+    readonly unique_traders: number;
+    readonly volume_collateral: number;
+    readonly liquidity_added: number;
+    readonly liquidity_removed: number;
+    readonly unique_lps: number;
+}
+export interface DailyDomainStatRow {
+    readonly date: string;
+    readonly domain_slug: string;
+    readonly trade_count: number;
+    readonly unique_traders: number;
+    readonly unique_lps: number;
+    readonly volume_collateral: number;
+    readonly liquidity_net: number;
+    readonly active_markets: number;
+}
+export interface DailyPlatformStatRow {
+    readonly date: string;
+    readonly trade_count: number;
+    readonly unique_traders: number;
+    readonly unique_lps: number;
+    readonly new_traders: number;
+    readonly new_lps: number;
+    readonly volume_collateral: number;
+    readonly liquidity_net: number;
+    readonly active_markets: number;
+}
+export interface DailyAggregates {
+    readonly trader: readonly DailyTraderStatRow[];
+    readonly lp: readonly DailyLPStatRow[];
+    readonly market: readonly DailyMarketStatRow[];
+    readonly domain: readonly DailyDomainStatRow[];
+    readonly platform: readonly DailyPlatformStatRow[];
+}
+export declare function buildDailyAggregates(events: readonly AggEventRow[], marketDomains: MarketDomainMap): DailyAggregates;
+//# sourceMappingURL=daily.d.ts.map

package/dist/aggregator/daily.d.ts.map

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

package/dist/aggregator/daily.js

@@ -0,0 +1,249 @@
+/**
+ * Daily fact table builders.
+ *
+ * Pure in-memory aggregation — input: events + positions + market→domain map.
+ * Output: arrays of rows ready to bulk-insert into Postgres.
+ *
+ * Approach: full recompute per cycle. With ~100k events this is sub-second.
+ * Switch to incremental if event count grows past ~10M.
+ */
+import { LIQUIDITY_ADD_TYPES, LIQUIDITY_REMOVE_TYPES, TRADE_EVENT_TYPES, parseCollateralAmount, } from './sources';
+import { primaryDomainOf } from './domains';
+function dateOf(ts) {
+    const d = new Date(ts * 1000);
+    const yyyy = d.getUTCFullYear();
+    const mm = String(d.getUTCMonth() + 1).padStart(2, '0');
+    const dd = String(d.getUTCDate()).padStart(2, '0');
+    return `${yyyy}-${mm}-${dd}`;
+}
+export function buildDailyAggregates(events, marketDomains) {
+    // Keys for nested maps
+    const traderBuckets = new Map(); // key: date|trader|domain
+    const lpBuckets = new Map(); // key: date|provider|domain
+    const marketBuckets = new Map(); // key: date|market_address
+    const domainBuckets = new Map(); // key: date|domain
+    const platformBuckets = new Map(); // key: date
+    // First-seen trackers for new_traders / new_lps
+    const traderFirstDate = new Map();
+    const lpFirstDate = new Map();
+    for (const event of events) {
+        const date = dateOf(event.timestamp);
+        const domain = primaryDomainOf(marketDomains, event.market_address);
+        const isTrade = TRADE_EVENT_TYPES.has(event.event_type);
+        const isLiqAdd = LIQUIDITY_ADD_TYPES.has(event.event_type);
+        const isLiqRemove = LIQUIDITY_REMOVE_TYPES.has(event.event_type);
+        const collateral = parseCollateralAmount(event.collateral_posted);
+        const isSell = (event.is_position_sell ?? 0) === 1;
+        // ── platform (date) ──
+        let platform = platformBuckets.get(date);
+        if (!platform) {
+            platform = {
+                trade_count: 0,
+                traders: new Set(),
+                lps: new Set(),
+                volume_collateral: 0,
+                liquidity_added: 0,
+                liquidity_removed: 0,
+                markets: new Set(),
+            };
+            platformBuckets.set(date, platform);
+        }
+        platform.markets.add(event.market_address);
+        // ── domain (date|domain) ──
+        const domainKey = `${date}|${domain}`;
+        let domainBucket = domainBuckets.get(domainKey);
+        if (!domainBucket) {
+            domainBucket = {
+                trade_count: 0,
+                traders: new Set(),
+                lps: new Set(),
+                volume_collateral: 0,
+                liquidity_added: 0,
+                liquidity_removed: 0,
+                markets: new Set(),
+            };
+            domainBuckets.set(domainKey, domainBucket);
+        }
+        domainBucket.markets.add(event.market_address);
+        // ── market (date|market) ──
+        const marketKey = `${date}|${event.market_address}`;
+        let marketBucket = marketBuckets.get(marketKey);
+        if (!marketBucket) {
+            marketBucket = {
+                trade_count: 0,
+                traders: new Set(),
+                lps: new Set(),
+                volume_collateral: 0,
+                liquidity_added: 0,
+                liquidity_removed: 0,
+            };
+            marketBuckets.set(marketKey, marketBucket);
+        }
+        if (isTrade && event.trader) {
+            const trader = event.trader;
+            platform.trade_count += 1;
+            platform.traders.add(trader);
+            platform.volume_collateral += collateral;
+            domainBucket.trade_count += 1;
+            domainBucket.traders.add(trader);
+            domainBucket.volume_collateral += collateral;
+            marketBucket.trade_count += 1;
+            marketBucket.traders.add(trader);
+            marketBucket.volume_collateral += collateral;
+            const traderKey = `${date}|${trader}|${domain}`;
+            let traderBucket = traderBuckets.get(traderKey);
+            if (!traderBucket) {
+                traderBucket = {
+                    trade_count: 0,
+                    buy_count: 0,
+                    sell_count: 0,
+                    volume_collateral: 0,
+                    markets: new Set(),
+                };
+                traderBuckets.set(traderKey, traderBucket);
+            }
+            traderBucket.trade_count += 1;
+            if (isSell) {
+                traderBucket.sell_count += 1;
+            }
+            else {
+                traderBucket.buy_count += 1;
+            }
+            traderBucket.volume_collateral += collateral;
+            traderBucket.markets.add(event.market_address);
+            // first-seen trader date
+            const prev = traderFirstDate.get(trader);
+            if (!prev || date < prev) {
+                traderFirstDate.set(trader, date);
+            }
+        }
+        if ((isLiqAdd || isLiqRemove) && event.trader) {
+            const provider = event.trader;
+            platform.lps.add(provider);
+            domainBucket.lps.add(provider);
+            marketBucket.lps.add(provider);
+            const lpKey = `${date}|${provider}|${domain}`;
+            let lpBucket = lpBuckets.get(lpKey);
+            if (!lpBucket) {
+                lpBucket = {
+                    deposit_count: 0,
+                    withdraw_count: 0,
+                    deposited: 0,
+                    withdrawn: 0,
+                    markets: new Set(),
+                };
+                lpBuckets.set(lpKey, lpBucket);
+            }
+            lpBucket.markets.add(event.market_address);
+            if (isLiqAdd) {
+                lpBucket.deposit_count += 1;
+                lpBucket.deposited += collateral;
+                marketBucket.liquidity_added += collateral;
+                domainBucket.liquidity_added += collateral;
+                platform.liquidity_added += collateral;
+            }
+            else {
+                lpBucket.withdraw_count += 1;
+                lpBucket.withdrawn += collateral;
+                marketBucket.liquidity_removed += collateral;
+                domainBucket.liquidity_removed += collateral;
+                platform.liquidity_removed += collateral;
+            }
+            const prev = lpFirstDate.get(provider);
+            if (!prev || date < prev) {
+                lpFirstDate.set(provider, date);
+            }
+        }
+    }
+    // ── Materialize ──
+    const trader = [];
+    for (const [key, b] of traderBuckets) {
+        const [date, traderId, domain_slug] = key.split('|');
+        if (!date || !traderId || !domain_slug)
+            continue;
+        trader.push({
+            date,
+            trader: traderId,
+            domain_slug,
+            trade_count: b.trade_count,
+            buy_count: b.buy_count,
+            sell_count: b.sell_count,
+            volume_collateral: b.volume_collateral,
+            markets_traded: b.markets.size,
+        });
+    }
+    const lp = [];
+    for (const [key, b] of lpBuckets) {
+        const [date, provider, domain_slug] = key.split('|');
+        if (!date || !provider || !domain_slug)
+            continue;
+        lp.push({
+            date,
+            provider,
+            domain_slug,
+            deposit_count: b.deposit_count,
+            withdraw_count: b.withdraw_count,
+            deposited: b.deposited,
+            withdrawn: b.withdrawn,
+            markets_active: b.markets.size,
+        });
+    }
+    const market = [];
+    for (const [key, b] of marketBuckets) {
+        const [date, market_address] = key.split('|');
+        if (!date || !market_address)
+            continue;
+        market.push({
+            date,
+            market_address,
+            trade_count: b.trade_count,
+            unique_traders: b.traders.size,
+            volume_collateral: b.volume_collateral,
+            liquidity_added: b.liquidity_added,
+            liquidity_removed: b.liquidity_removed,
+            unique_lps: b.lps.size,
+        });
+    }
+    const domain = [];
+    for (const [key, b] of domainBuckets) {
+        const [date, domain_slug] = key.split('|');
+        if (!date || !domain_slug)
+            continue;
+        domain.push({
+            date,
+            domain_slug,
+            trade_count: b.trade_count,
+            unique_traders: b.traders.size,
+            unique_lps: b.lps.size,
+            volume_collateral: b.volume_collateral,
+            liquidity_net: b.liquidity_added - b.liquidity_removed,
+            active_markets: b.markets.size,
+        });
+    }
+    const platform = [];
+    for (const [date, b] of platformBuckets) {
+        let new_traders = 0;
+        for (const [, firstDate] of traderFirstDate) {
+            if (firstDate === date)
+                new_traders += 1;
+        }
+        let new_lps = 0;
+        for (const [, firstDate] of lpFirstDate) {
+            if (firstDate === date)
+                new_lps += 1;
+        }
+        platform.push({
+            date,
+            trade_count: b.trade_count,
+            unique_traders: b.traders.size,
+            unique_lps: b.lps.size,
+            new_traders,
+            new_lps,
+            volume_collateral: b.volume_collateral,
+            liquidity_net: b.liquidity_added - b.liquidity_removed,
+            active_markets: b.markets.size,
+        });
+    }
+    return { trader, lp, market, domain, platform };
+}
+//# sourceMappingURL=daily.js.map

package/dist/aggregator/daily.js.map

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

package/dist/aggregator/domains.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Market → primary domain map, fetched once per aggregator cycle.
+ *
+ * Returned as a plain Map<marketAddress, primaryDomainSlug>. Markets without
+ * any domain assignment fall back to 'other' so every event has a domain to
+ * attribute to.
+ */
+import type { SQL } from 'bun';
+export type MarketDomainMap = ReadonlyMap<string, string>;
+/** All primary-domain rows. */
+export declare function loadMarketPrimaryDomains(pg: SQL): Promise<MarketDomainMap>;
+/** Lookup with `'other'` fallback. */
+export declare function primaryDomainOf(map: MarketDomainMap, marketAddress: string): string;
+/**
+ * Returns all (market, slug) pairs — useful for "user touched N domains"
+ * style metrics. A market may be tagged with multiple domains; this returns
+ * every assignment.
+ */
+export declare function loadAllMarketDomains(pg: SQL): Promise<ReadonlyMap<string, ReadonlySet<string>>>;
+//# sourceMappingURL=domains.d.ts.map

package/dist/aggregator/domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../src/aggregator/domains.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE/B,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE1D,+BAA+B;AAC/B,wBAAsB,wBAAwB,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC,CAYhF;AAED,sCAAsC;AACtC,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,GAAG,GACN,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAenD"}