@render-foundation/utils 0.0.234-beta.0 → 0.0.235

package/lib/cjs/client/pg/v2Client.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -35,7 +45,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pgClient = exports.batchFinishedAtMedian = exports.DISPERSED_SETTLEMENT_TABLE = exports.GRANT_BURN_TABLE = exports.GRANT_BURN_ID_TABLE = exports.USER_GRANT_SPEND_TABLE = exports.CURRENT_USER_GRANT_SPEND_TABLE = exports.POLYGON_UPGRADE_TABLE = exports.ENTITY_EPOCH_INFO_TABLE = exports.TX_BURN_ADJUSTMENT_TABLE = exports.JOB_BURN_ADJUSTMENT_TABLE = exports.NETWORK_REVENUE_TABLE = exports.BRIDGE_TRANSFER_TABLE = exports.BURN_TABLE = exports.JOB_TABLE = exports.JOB_ID_TABLE = exports.LIABILITY_ADJUSTMENT_BATCH_TABLE = exports.LIABILITY_ADJUSTMENT_TABLE = exports.LIABILITY_TABLE = exports.SOL_TRANSFER_TABLE = exports.ENTITY_TABLE = exports.MANUAL_BURN_TABLE = exports.EPOCH_TABLE = exports.SOL_TX_TABLE = void 0;
+exports.pgClient = exports.batchFinishedAtMedian = exports.DISPERSED_SETTLEMENT_TABLE = exports.GRANT_BURN_TABLE = exports.GRANT_BURN_ID_TABLE = exports.USER_GRANT_SPEND_TABLE = exports.CURRENT_USER_GRANT_SPEND_TABLE = exports.POLYGON_UPGRADE_TABLE = exports.ENTITY_EPOCH_INFO_TABLE = exports.BURN_CORRECTION_TABLE = exports.NETWORK_REVENUE_TABLE = exports.BRIDGE_TRANSFER_TABLE = exports.BURN_TABLE = exports.JOB_TABLE = exports.JOB_ID_TABLE = exports.LIABILITY_ADJUSTMENT_BATCH_TABLE = exports.LIABILITY_ADJUSTMENT_TABLE = exports.LIABILITY_TABLE = exports.SOL_TRANSFER_TABLE = exports.ENTITY_TABLE = exports.MANUAL_BURN_TABLE = exports.EPOCH_TABLE = exports.SOL_TX_TABLE = void 0;
 const kysely_1 = require("kysely");
 const logger_1 = require("../../logger");
 const pg_1 = require("pg");
@@ -54,8 +64,7 @@ exports.JOB_TABLE = 'job';
 exports.BURN_TABLE = 'burn';
 exports.BRIDGE_TRANSFER_TABLE = 'bridge_transfer';
 exports.NETWORK_REVENUE_TABLE = 'network_revenue';
-exports.JOB_BURN_ADJUSTMENT_TABLE = 'job_burn_adjustment';
-exports.TX_BURN_ADJUSTMENT_TABLE = 'tx_burn_adjustment';
+exports.BURN_CORRECTION_TABLE = 'burn_correction';
 exports.ENTITY_EPOCH_INFO_TABLE = 'entity_epoch_info';
 exports.POLYGON_UPGRADE_TABLE = 'polygon_upgrade';
 exports.CURRENT_USER_GRANT_SPEND_TABLE = 'current_user_grant_spend';
@@ -96,7 +105,7 @@ const pgClient = (config) => {
     const db = new kysely_1.Kysely({
         dialect,
     });
-    const getOrInsertEntity = (db, p, log = logger_1.consoleLogger) => __awaiter(void 0, void 0, void 0, function* () {
+    const getOrInsertEntity = (db_1, p_1, ...args_1) => __awaiter(void 0, [db_1, p_1, ...args_1], void 0, function* (db, p, log = logger_1.consoleLogger) {
         const res = (yield db
             .selectFrom(exports.ENTITY_TABLE)
             .select('id')
@@ -117,7 +126,7 @@ const pgClient = (config) => {
         log.debug(`inserted entity ${id}`);
         return id;
     });
-    const getOrInsertTx = (db, p, log = logger_1.consoleLogger) => __awaiter(void 0, void 0, void 0, function* () {
+    const getOrInsertTx = (db_1, p_1, ...args_1) => __awaiter(void 0, [db_1, p_1, ...args_1], void 0, function* (db, p, log = logger_1.consoleLogger) {
         const res = yield db
             .selectFrom(exports.SOL_TX_TABLE)
             .select('id')
@@ -139,7 +148,7 @@ const pgClient = (config) => {
         log.debug(`inserted tx ${id}`);
         return id;
     });
-    const getOrInsertEpoch = (db, p, log = logger_1.consoleLogger) => __awaiter(void 0, void 0, void 0, function* () {
+    const getOrInsertEpoch = (db_1, p_1, ...args_1) => __awaiter(void 0, [db_1, p_1, ...args_1], void 0, function* (db, p, log = logger_1.consoleLogger) {
         const res = yield db
             .selectFrom(exports.EPOCH_TABLE)
             .select('id')
@@ -167,7 +176,7 @@ const pgClient = (config) => {
         log.debug(`inserted epoch ${id}`);
         return id;
     });
-    const getCurrentUserGrantSpend = (db, p, log = logger_1.consoleLogger) => __awaiter(void 0, void 0, void 0, function* () {
+    const getCurrentUserGrantSpend = (db_1, p_1, ...args_1) => __awaiter(void 0, [db_1, p_1, ...args_1], void 0, function* (db, p, log = logger_1.consoleLogger) {
         var _a;
         const res = yield db
             .selectFrom(exports.CURRENT_USER_GRANT_SPEND_TABLE)
@@ -197,7 +206,7 @@ const pgClient = (config) => {
             .executeTakeFirst());
         log.info(`set ${res.numUpdatedRows} rows. channel: ${p.channel}, ui: ${p.uiEpochId} -> totalRndr ${totalRndr} `);
     });
-    const fetchJobs1 = (db, f, log = logger_1.consoleLogger) => __awaiter(void 0, void 0, void 0, function* () {
+    const fetchJobs1 = (db_1, f_1, ...args_1) => __awaiter(void 0, [db_1, f_1, ...args_1], void 0, function* (db, f, log = logger_1.consoleLogger) {
         let q = db.selectFrom('job').selectAll();
         //.where('job.burn_id', 'is not', null)
         if (f.completedAtAfter) {
@@ -227,7 +236,7 @@ const pgClient = (config) => {
             insertedAt: r.inserted_at,
         }));
     });
-    const fetchJobs2 = (db, f, log = logger_1.consoleLogger) => __awaiter(void 0, void 0, void 0, function* () {
+    const fetchJobs2 = (db_1, f_1, ...args_1) => __awaiter(void 0, [db_1, f_1, ...args_1], void 0, function* (db, f, log = logger_1.consoleLogger) {
         let q = db.selectFrom('job').selectAll();
         //.where('job.burn_id', 'is not', null)
         if (f.completedAtAfter) {
@@ -261,7 +270,7 @@ const pgClient = (config) => {
             });
         });
     });
-    const createBridgeTransfers = (db, bts, log = logger_1.consoleLogger) => __awaiter(void 0, void 0, void 0, function* () {
+    const createBridgeTransfers = (db_1, bts_1, ...args_1) => __awaiter(void 0, [db_1, bts_1, ...args_1], void 0, function* (db, bts, log = logger_1.consoleLogger) {
         const sequenceNumbers = [];
         const dbEpochIds = [];
         for (const bt of bts) {
@@ -305,7 +314,7 @@ const pgClient = (config) => {
         }
         return { sequenceNumbers: sequenceNumbers };
     });
-    const createPayments = (db, ps, log = logger_1.consoleLogger) => __awaiter(void 0, void 0, void 0, function* () {
+    const createPayments = (db_1, ps_1, ...args_1) => __awaiter(void 0, [db_1, ps_1, ...args_1], void 0, function* (db, ps, log = logger_1.consoleLogger) {
         const ids = [];
         const epochDbIds = [];
         for (const p of ps) {
@@ -402,18 +411,18 @@ const pgClient = (config) => {
             rollback: () => { },
             trx: db,
         },
-        startTransaction(log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        startTransaction() {
+            return __awaiter(this, arguments, void 0, function* (log = logger_1.consoleLogger) {
                 return (0, base_2.begin)(db, log);
             });
         },
-        createPayments(db, ps, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        createPayments(db_1, ps_1) {
+            return __awaiter(this, arguments, void 0, function* (db, ps, log = logger_1.consoleLogger) {
                 return createPayments(db.trx, ps, log);
             });
         },
-        fetchTransfers(db, f, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        fetchTransfers(db_1, f_1) {
+            return __awaiter(this, arguments, void 0, function* (db, f, log = logger_1.consoleLogger) {
                 let lastId = undefined;
                 if (f.cursor) {
                     lastId = atob(f.cursor);
@@ -469,8 +478,8 @@ const pgClient = (config) => {
                 };
             });
         },
-        fetchEpochs(db, f, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        fetchEpochs(db_1, f_1) {
+            return __awaiter(this, arguments, void 0, function* (db, f, log = logger_1.consoleLogger) {
                 let q = db.trx.selectFrom(exports.EPOCH_TABLE).selectAll();
                 if (f.channels) {
                     q = q.where('channel', 'in', f.channels);
@@ -493,9 +502,9 @@ const pgClient = (config) => {
                 }));
             });
         },
-        fetchLiabilities(db, f, log = logger_1.consoleLogger) {
-            var _a;
-            return __awaiter(this, void 0, void 0, function* () {
+        fetchLiabilities(db_1, f_1) {
+            return __awaiter(this, arguments, void 0, function* (db, f, log = logger_1.consoleLogger) {
+                var _a;
                 let offset = 0;
                 let orderBy = (_a = f.orderBy) !== null && _a !== void 0 ? _a : 'epoch.ui,liability.id';
                 if (f.cursor) {
@@ -562,8 +571,8 @@ const pgClient = (config) => {
                 };
             });
         },
-        getLiabilitiesAndTransfers(f, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        getLiabilitiesAndTransfers(f_1) {
+            return __awaiter(this, arguments, void 0, function* (f, log = logger_1.consoleLogger) {
                 let lq = db
                     .selectFrom(exports.LIABILITY_TABLE)
                     .selectAll()
@@ -624,9 +633,9 @@ const pgClient = (config) => {
                 return { transfers, liabilities, epochs: Object.values(epochs) };
             });
         },
-        getOutstanding(f, log = logger_1.consoleLogger) {
-            var _a, _b, _c, _d, _e;
-            return __awaiter(this, void 0, void 0, function* () {
+        getOutstanding(f_1) {
+            return __awaiter(this, arguments, void 0, function* (f, log = logger_1.consoleLogger) {
+                var _a, _b, _c, _d, _e;
                 log.info(`getting outstanding balances for ${(_a = f.channels) !== null && _a !== void 0 ? _a : '(no channels specified)'} epoch: ${(_b = f.startEpochId.id) !== null && _b !== void 0 ? _b : '(no epoch specified)'}`);
                 let epochUi;
                 let epochEndTime;
@@ -762,8 +771,8 @@ const pgClient = (config) => {
                 return out;
             });
         },
-        addLiabilityAdjustments(batch, rows, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        addLiabilityAdjustments(batch_1, rows_1) {
+            return __awaiter(this, arguments, void 0, function* (batch, rows, log = logger_1.consoleLogger) {
                 return yield db.transaction().execute((trx) => __awaiter(this, void 0, void 0, function* () {
                     var _a;
                     // Upsert the batch by its label (idempotent re-runs; label is the run identity).
@@ -815,9 +824,9 @@ const pgClient = (config) => {
                 }));
             });
         },
-        fetchNodeOperatorEpoch(epochId, log = logger_1.consoleLogger) {
-            var _a;
-            return __awaiter(this, void 0, void 0, function* () {
+        fetchNodeOperatorEpoch(epochId_1) {
+            return __awaiter(this, arguments, void 0, function* (epochId, log = logger_1.consoleLogger) {
+                var _a;
                 const q = db
                     .selectFrom(exports.JOB_ID_TABLE)
                     .innerJoin(exports.EPOCH_TABLE, 'epoch.id', 'job_id.epoch_id')
@@ -867,14 +876,14 @@ const pgClient = (config) => {
                 };
             });
         },
-        insertEpoch(db, epoch, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        insertEpoch(db_1, epoch_1) {
+            return __awaiter(this, arguments, void 0, function* (db, epoch, log = logger_1.consoleLogger) {
                 yield getOrInsertEpoch(db.trx, Object.assign(Object.assign({}, epoch), { uiEpochId: epoch.ui }), log);
             });
         },
-        getEpoch(f, log = logger_1.consoleLogger) {
-            var _a;
-            return __awaiter(this, void 0, void 0, function* () {
+        getEpoch(f_1) {
+            return __awaiter(this, arguments, void 0, function* (f, log = logger_1.consoleLogger) {
+                var _a;
                 const now = new Date(Date.now());
                 try {
                     let q = db
@@ -912,9 +921,9 @@ const pgClient = (config) => {
                 }
             });
         },
-        getLatestNodeOperatorEpoch(f, log = logger_1.consoleLogger) {
-            var _a;
-            return __awaiter(this, void 0, void 0, function* () {
+        getLatestNodeOperatorEpoch(f_1) {
+            return __awaiter(this, arguments, void 0, function* (f, log = logger_1.consoleLogger) {
+                var _a;
                 const now = new Date(Date.now());
                 try {
                     let q = db
@@ -954,8 +963,8 @@ const pgClient = (config) => {
                 }
             });
         },
-        saveNodeOperatorEpoch(epochId, liabilities, jobIds, totalRndr, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        saveNodeOperatorEpoch(epochId_1, liabilities_1, jobIds_1, totalRndr_1) {
+            return __awaiter(this, arguments, void 0, function* (epochId, liabilities, jobIds, totalRndr, log = logger_1.consoleLogger) {
                 yield db
                     .transaction()
                     .setIsolationLevel('repeatable read')
@@ -991,8 +1000,8 @@ const pgClient = (config) => {
                 return;
             });
         },
-        produceBurnedJobs(jobs, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        produceBurnedJobs(jobs_1) {
+            return __awaiter(this, arguments, void 0, function* (jobs, log = logger_1.consoleLogger) {
                 yield db.transaction().execute((trx) => __awaiter(this, void 0, void 0, function* () {
                     var _a;
                     let num = BigInt(0);
@@ -1015,9 +1024,9 @@ const pgClient = (config) => {
                 }));
             });
         },
-        markJobsBurntWithGrant(db, p, log = logger_1.consoleLogger) {
-            var _a;
-            return __awaiter(this, void 0, void 0, function* () {
+        markJobsBurntWithGrant(db_1, p_1) {
+            return __awaiter(this, arguments, void 0, function* (db, p, log = logger_1.consoleLogger) {
+                var _a;
                 const solTxId = yield getOrInsertTx(db.trx, { sig: p.tx.sig, executedAt: p.tx.executedAt }, log);
                 const { id } = yield db.trx
                     .insertInto(exports.GRANT_BURN_TABLE)
@@ -1048,9 +1057,9 @@ const pgClient = (config) => {
                 return;
             });
         },
-        insertGrantSpend(db, p, log = logger_1.consoleLogger) {
-            var _a, _b, _c;
-            return __awaiter(this, void 0, void 0, function* () {
+        insertGrantSpend(db_1, p_1) {
+            return __awaiter(this, arguments, void 0, function* (db, p, log = logger_1.consoleLogger) {
+                var _a, _b, _c;
                 const existing = yield getCurrentUserGrantSpend(db.trx, { userId: p.userId }, log);
                 const diff = {
                     render_spent: ((_a = existing === null || existing === void 0 ? void 0 : existing.renderSpent) !== null && _a !== void 0 ? _a : BigInt(0)) + p.renderSpentDelta,
@@ -1115,9 +1124,9 @@ const pgClient = (config) => {
                 }
             });
         },
-        markJobsBurnt(trx, p, log = logger_1.consoleLogger) {
-            var _a, _b;
-            return __awaiter(this, void 0, void 0, function* () {
+        markJobsBurnt(trx_1, p_1) {
+            return __awaiter(this, arguments, void 0, function* (trx, p, log = logger_1.consoleLogger) {
+                var _a, _b;
                 if (!p.buyBurn && !p.grantBurn) {
                     throw new Error('no buyBurn or grantBurn');
                 }
@@ -1125,7 +1134,7 @@ const pgClient = (config) => {
                 let buyBurnId;
                 let grantBurnId;
                 if (p.buyBurn) {
-                    const { burned, usdcSpent, eurToUsdc, renderToUsdc, quoteAmt, tags, jobBurnAdjustmentId, txBurnAdjustmentId, toBurn, fromEscrowUsdc, } = p.buyBurn;
+                    const { burned, usdcSpent, eurToUsdc, renderToUsdc, quoteAmt, tags, downCorrectionId, escrowCorrectionId, toBurn, fromEscrowUsdc, } = p.buyBurn;
                     let pricedAt = p.buyBurn.pricedAt;
                     if (!pricedAt) {
                         const jobs = yield fetchJobs1(trx.trx, { ids: p.jobs.map((j) => String(j.id)) }, log);
@@ -1144,8 +1153,8 @@ const pgClient = (config) => {
                         quote_amt: quoteAmt,
                         burned: burned,
                         tags: tags.join(','),
-                        job_burn_adjustment_id: jobBurnAdjustmentId,
-                        tx_burn_adjustment_id: txBurnAdjustmentId,
+                        down_correction_id: downCorrectionId,
+                        escrow_correction_id: escrowCorrectionId,
                         to_burn: toBurn,
                         from_escrow_usdc: fromEscrowUsdc !== null && fromEscrowUsdc !== void 0 ? fromEscrowUsdc : 0,
                     };
@@ -1218,8 +1227,8 @@ const pgClient = (config) => {
                 return { grantBurnId, buyBurnId };
             });
         },
-        markJobsBurned(trx, p, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        markJobsBurned(trx_1, p_1) {
+            return __awaiter(this, arguments, void 0, function* (trx, p, log = logger_1.consoleLogger) {
                 let { markedAt, solTx } = p;
                 let res = yield trx.trx
                     .updateTable(exports.BURN_TABLE)
@@ -1243,8 +1252,8 @@ const pgClient = (config) => {
                 }
             });
         },
-        consumeAndLockBurnJobs(limit, lowerRndrThreshold, upperRndrThreshold, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        consumeAndLockBurnJobs(limit_1, lowerRndrThreshold_1, upperRndrThreshold_1) {
+            return __awaiter(this, arguments, void 0, function* (limit, lowerRndrThreshold, upperRndrThreshold, log = logger_1.consoleLogger) {
                 const trx = yield (0, base_2.begin)(db, log);
                 const q = trx.trx
                     .selectFrom(trx.trx
@@ -1351,9 +1360,9 @@ const pgClient = (config) => {
                 };
             });
         },
-        incrBuyBurnMetrics(log = logger_1.consoleLogger) {
-            var _a;
-            return __awaiter(this, void 0, void 0, function* () {
+        incrBuyBurnMetrics() {
+            return __awaiter(this, arguments, void 0, function* (log = logger_1.consoleLogger) {
+                var _a;
                 const res = yield db
                     .selectFrom(exports.JOB_TABLE)
                     .select('inserted_at')
@@ -1370,9 +1379,9 @@ const pgClient = (config) => {
                 };
             });
         },
-        fetchBurns(db, f, log = logger_1.consoleLogger) {
-            var _a, _b;
-            return __awaiter(this, void 0, void 0, function* () {
+        fetchBurns(db_1, f_1) {
+            return __awaiter(this, arguments, void 0, function* (db, f, log = logger_1.consoleLogger) {
+                var _a, _b;
                 let q = db.trx
                     .selectFrom('burn')
                     .selectAll('burn')
@@ -1441,9 +1450,9 @@ const pgClient = (config) => {
                 return burns;
             });
         },
-        fetchBurnsAndGrants(db, f, log = logger_1.consoleLogger) {
-            var _a, _b;
-            return __awaiter(this, void 0, void 0, function* () {
+        fetchBurnsAndGrants(db_1, f_1) {
+            return __awaiter(this, arguments, void 0, function* (db, f, log = logger_1.consoleLogger) {
+                var _a, _b;
                 // Build a unified query to get all transactions with both buy burns and grant burns
                 let baseQuery = db.trx
                     .selectFrom('sol_tx')
@@ -1581,13 +1590,13 @@ const pgClient = (config) => {
                 return groupedBurns;
             });
         },
-        createBridgeTransfers(db, bts, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        createBridgeTransfers(db_1, bts_1) {
+            return __awaiter(this, arguments, void 0, function* (db, bts, log = logger_1.consoleLogger) {
                 return createBridgeTransfers(db.trx, bts, log);
             });
         },
-        getBridgeTransfers({ solKey, page, }, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        getBridgeTransfers(_a) {
+            return __awaiter(this, arguments, void 0, function* ({ solKey, page, }, log = logger_1.consoleLogger) {
                 let q = db
                     .selectFrom(exports.BRIDGE_TRANSFER_TABLE)
                     .innerJoin(exports.EPOCH_TABLE, 'epoch.id', 'bridge_transfer.epoch_id')
@@ -1664,8 +1673,8 @@ const pgClient = (config) => {
             });
         },
         getTotalBurned(db) {
-            var _a, _b;
             return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b;
                 const total = yield db.trx
                     .selectFrom('burn')
                     .select(({ fn }) => fn.sum('burned').as('total_burned'))
@@ -1673,8 +1682,8 @@ const pgClient = (config) => {
                 return BigInt((_b = (_a = total[0]) === null || _a === void 0 ? void 0 : _a.total_burned) !== null && _b !== void 0 ? _b : 0);
             });
         },
-        insertBurn(p, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        insertBurn(p_1) {
+            return __awaiter(this, arguments, void 0, function* (p, log = logger_1.consoleLogger) {
                 yield db.transaction().execute((trx) => __awaiter(this, void 0, void 0, function* () {
                     var _a;
                     const solTxId = yield getOrInsertTx(trx, { sig: p.solTx, executedAt: p.executedAt }, log);
@@ -1711,9 +1720,9 @@ const pgClient = (config) => {
                 }));
             });
         },
-        insertDispersedOutbox(p, log = logger_1.consoleLogger) {
-            var _a, _b;
-            return __awaiter(this, void 0, void 0, function* () {
+        insertDispersedOutbox(p_1) {
+            return __awaiter(this, arguments, void 0, function* (p, log = logger_1.consoleLogger) {
+                var _a, _b, _c;
                 const res = yield db
                     .insertInto(exports.DISPERSED_SETTLEMENT_TABLE)
                     .values({
@@ -1725,14 +1734,15 @@ const pgClient = (config) => {
                     executed_at: p.executedAt,
                     eur_render: (_a = p.eurRender) !== null && _a !== void 0 ? _a : null,
                     last_valid_block_height: (_b = p.lastValidBlockHeight) !== null && _b !== void 0 ? _b : null,
+                    usdc_spent: (_c = p.usdcSpent) !== null && _c !== void 0 ? _c : null,
                 })
                     .onConflict((oc) => oc.column('tx_signature').doNothing())
                     .executeTakeFirst();
                 log.debug(`dispersed outbox tx ${p.txSignature}: ${res.numInsertedOrUpdatedRows} row(s)`);
             });
         },
-        markDispersedSettled(txSignature, p, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        markDispersedSettled(txSignature_1, p_1) {
+            return __awaiter(this, arguments, void 0, function* (txSignature, p, log = logger_1.consoleLogger) {
                 yield db
                     .updateTable(exports.DISPERSED_SETTLEMENT_TABLE)
                     .set({ settled_at: new Date(), idempotent_replay: p.idempotentReplay })
@@ -1741,8 +1751,8 @@ const pgClient = (config) => {
                 log.debug(`dispersed settled tx ${txSignature}`);
             });
         },
-        getUnsettledDispersed(log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        getUnsettledDispersed() {
+            return __awaiter(this, arguments, void 0, function* (log = logger_1.consoleLogger) {
                 const rows = yield db
                     .selectFrom(exports.DISPERSED_SETTLEMENT_TABLE)
                     .selectAll()
@@ -1750,7 +1760,7 @@ const pgClient = (config) => {
                     .execute();
                 log.debug(`dispersed outbox: ${rows.length} unsettled`);
                 return rows.map((r) => {
-                    var _a;
+                    var _a, _b;
                     return ({
                         txSignature: r.tx_signature,
                         claimUuid: r.claim_uuid,
@@ -1759,6 +1769,7 @@ const pgClient = (config) => {
                         burnedAmount: r.burned_amount,
                         executedAt: r.executed_at,
                         eurRender: (_a = r.eur_render) !== null && _a !== void 0 ? _a : undefined,
+                        usdcSpent: (_b = r.usdc_spent) !== null && _b !== void 0 ? _b : undefined,
                         // int8 comes back as a string from pg; block heights are well within JS safe-integer range.
                         lastValidBlockHeight: r.last_valid_block_height != null
                             ? Number(r.last_valid_block_height)
@@ -1767,8 +1778,8 @@ const pgClient = (config) => {
                 });
             });
         },
-        voidDispersedOutbox(txSignature, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        voidDispersedOutbox(txSignature_1) {
+            return __awaiter(this, arguments, void 0, function* (txSignature, log = logger_1.consoleLogger) {
                 const res = yield db
                     .deleteFrom(exports.DISPERSED_SETTLEMENT_TABLE)
                     .where('tx_signature', '=', txSignature)
@@ -1778,18 +1789,91 @@ const pgClient = (config) => {
                 log.debug(`dispersed outbox void tx ${txSignature}: ${res.numDeletedRows} row(s)`);
             });
         },
-        fetchJobs(db, f, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        fetchDispersedSettlements(f_1) {
+            return __awaiter(this, arguments, void 0, function* (f, _log = logger_1.consoleLogger) {
+                var _a;
+                let q = db
+                    .selectFrom(exports.DISPERSED_SETTLEMENT_TABLE)
+                    // Settled burns only — pending (un-landed) outbox rows aren't real, completed burns.
+                    .where('settled_at', 'is not', null);
+                if (f.settledAfter)
+                    q = q.where('settled_at', '>=', f.settledAfter);
+                if (f.settledBefore)
+                    q = q.where('settled_at', '<', f.settledBefore);
+                const rows = yield q
+                    .select([
+                    'tx_signature',
+                    'claim_uuid',
+                    'obligation_uuids',
+                    'settled_amount',
+                    'burned_amount',
+                    'usdc_spent',
+                    'eur_render',
+                    'executed_at',
+                    'settled_at',
+                ])
+                    .orderBy('settled_at', 'desc')
+                    .limit((_a = f.limit) !== null && _a !== void 0 ? _a : 500)
+                    .execute();
+                return rows.map((r) => {
+                    var _a, _b;
+                    return ({
+                        txSignature: r.tx_signature,
+                        claimUuid: r.claim_uuid,
+                        obligationUuids: r.obligation_uuids,
+                        settledAmount: r.settled_amount,
+                        burnedAmount: r.burned_amount,
+                        usdcSpent: (_a = r.usdc_spent) !== null && _a !== void 0 ? _a : null,
+                        eurRender: (_b = r.eur_render) !== null && _b !== void 0 ? _b : null,
+                        executedAt: r.executed_at,
+                        settledAt: r.settled_at,
+                    });
+                });
+            });
+        },
+        fetchDispersedMonthlyStats(f_1) {
+            return __awaiter(this, arguments, void 0, function* (f, _log = logger_1.consoleLogger) {
+                let q = db
+                    .selectFrom(exports.DISPERSED_SETTLEMENT_TABLE)
+                    .where('settled_at', 'is not', null);
+                if (f.settledAfter)
+                    q = q.where('settled_at', '>=', f.settledAfter);
+                if (f.settledBefore)
+                    q = q.where('settled_at', '<', f.settledBefore);
+                const rows = yield q
+                    .select([
+                    // Bucket by UTC calendar month of settlement.
+                    (0, kysely_1.sql) `date_trunc('month', settled_at at time zone 'UTC')`.as('month'),
+                    (0, kysely_1.sql) `coalesce(sum(settled_amount), 0)::text`.as('settled_eur'),
+                    // usdc_spent is NULL for pre-migration-39 burns; sum() skips NULLs so they simply don't count.
+                    (0, kysely_1.sql) `coalesce(sum(usdc_spent), 0)::text`.as('usdc_spent'),
+                    (0, kysely_1.sql) `coalesce(sum(burned_amount), 0)::text`.as('render_burned'),
+                    (0, kysely_1.sql) `count(*)::text`.as('burn_count'),
+                ])
+                    .groupBy('month')
+                    .orderBy('month', 'asc')
+                    .execute();
+                return rows.map((r) => ({
+                    month: r.month,
+                    settledEur: r.settled_eur,
+                    usdcSpent: r.usdc_spent,
+                    renderBurned: r.render_burned,
+                    burnCount: Number(r.burn_count),
+                }));
+            });
+        },
+        fetchJobs(db_1, f_1) {
+            return __awaiter(this, arguments, void 0, function* (db, f, log = logger_1.consoleLogger) {
                 return yield fetchJobs1(db.trx, f, log);
             });
         },
-        fetchJobsWithGrantValues(db, f, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        fetchJobsWithGrantValues(db_1, f_1) {
+            return __awaiter(this, arguments, void 0, function* (db, f, log = logger_1.consoleLogger) {
                 return yield fetchJobs2(db.trx, f, log);
             });
         },
-        fetchLiabilityEpochs(db, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        fetchLiabilityEpochs(db_1) {
+            return __awaiter(this, arguments, void 0, function* (db, log = logger_1.consoleLogger) {
                 const q = db.trx
                     .selectFrom(exports.LIABILITY_TABLE)
                     .select(({ fn }) => [
@@ -1847,94 +1931,83 @@ const pgClient = (config) => {
                 }));
             });
         },
-        createTxBurnAdjustment(trx, p, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
-                // Idempotent per sol_tx_id (unique) — a re-run for the same bad tx is a no-op.
+        createBurnCorrection(trx_1, p_1) {
+            return __awaiter(this, arguments, void 0, function* (trx, p, log = logger_1.consoleLogger) {
+                // Anchor + unit invariants are also DB CHECKs; validate here for a clearer error.
+                if ((p.jobId == null) === (p.solTxId == null))
+                    throw new Error('burn_correction needs exactly one anchor (jobId XOR solTxId)');
+                if (p.kind === 'down_adjust' && p.amountRender == null)
+                    throw new Error('down_adjust needs amountRender');
+                if (p.kind === 'escrow_credit' && p.amountUsdc == null)
+                    throw new Error('escrow_credit needs amountUsdc');
+                // Idempotent per (anchor, kind) — a re-run for the same bad job/tx is a no-op.
                 const row = yield trx.trx
-                    .insertInto(exports.TX_BURN_ADJUSTMENT_TABLE)
+                    .insertInto(exports.BURN_CORRECTION_TABLE)
                     .values({
+                    kind: p.kind,
+                    job_id: p.jobId,
                     sol_tx_id: p.solTxId,
-                    surplus_usdc: p.surplusUsdc,
+                    amount_render: p.amountRender,
+                    amount_usdc: p.amountUsdc,
                     description: p.description,
                 })
-                    .onConflict((oc) => oc.column('sol_tx_id').doNothing())
+                    .onConflict((oc) => oc.doNothing())
                     .returning('id')
                     .executeTakeFirst();
                 if (!row) {
-                    log.info(`tx_burn_adjustment for sol_tx ${p.solTxId} already exists — skipped`);
+                    log.info(`burn_correction ${p.kind} for ${p.jobId != null ? `job ${p.jobId}` : `sol_tx ${p.solTxId}`} already exists — skipped`);
                     return undefined;
                 }
-                log.info(`created tx_burn_adjustment ${row.id}: ${p.surplusUsdc} USDC over-spent (sol_tx ${p.solTxId})`);
+                log.info(`created burn_correction ${row.id} (${p.kind}, ${p.jobId != null ? `job ${p.jobId}` : `sol_tx ${p.solTxId}`}): ${p.kind === 'down_adjust' ? `${p.amountRender} RENDER` : `${p.amountUsdc} USDC`}`);
                 return Number(row.id);
             });
         },
-        getJobBurnAdjustments(trx, ps, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        getBurnCorrections(trx_1, ps_1) {
+            return __awaiter(this, arguments, void 0, function* (trx, ps, log = logger_1.consoleLogger) {
                 if (!ps.toFill)
                     return [];
+                // fill column depends on kind: down_adjust consumes (to_burn - burned); escrow_credit consumes
+                // from_escrow_usdc. Each links via its own burn FK so one burn can carry one of each.
+                const linkCol = ps.kind === 'down_adjust' ? 'down_correction_id' : 'escrow_correction_id';
                 const q = trx.trx
-                    .selectFrom(exports.JOB_BURN_ADJUSTMENT_TABLE)
-                    .selectAll(exports.JOB_BURN_ADJUSTMENT_TABLE)
-                    .innerJoin(exports.JOB_TABLE, `${exports.JOB_TABLE}.id`, `${exports.JOB_BURN_ADJUSTMENT_TABLE}.job_id`)
-                    .select([`${exports.JOB_TABLE}.completed_at`, `${exports.JOB_TABLE}.render_amt`])
-                    .leftJoin(exports.BURN_TABLE, `${exports.BURN_TABLE}.job_burn_adjustment_id`, `${exports.JOB_BURN_ADJUSTMENT_TABLE}.id`)
+                    .selectFrom(exports.BURN_CORRECTION_TABLE)
+                    .selectAll(exports.BURN_CORRECTION_TABLE)
+                    .leftJoin(exports.BURN_TABLE, `${exports.BURN_TABLE}.${linkCol}`, `${exports.BURN_CORRECTION_TABLE}.id`)
                     .select(({ fn, lit }) => [
                     fn.sum(fn.coalesce(`${exports.BURN_TABLE}.to_burn`, lit(0))).as('tot_to_burn'),
                     fn.sum(fn.coalesce(`${exports.BURN_TABLE}.burned`, lit(0))).as('tot_burned'),
-                ])
-                    .groupBy([
-                    `${exports.JOB_BURN_ADJUSTMENT_TABLE}.id`,
-                    `${exports.JOB_TABLE}.completed_at`,
-                    `${exports.JOB_TABLE}.render_amt`,
-                ]);
-                log.info(`getJobBurnAdjustments ${q.compile().sql}`);
-                const res = yield q.execute();
-                return res
-                    .map((r) => ({
-                    id: Number(r.id),
-                    createdAt: r.created_at,
-                    jobId: Number(r.job_id),
-                    downAdjRndrUsed: Number(r.down_adj_rndr_used),
-                    downAdjToBurn: Number(r.down_adj_to_burn),
-                    adjusted: Number(r.tot_to_burn) - Number(r.tot_burned),
-                    job: {
-                        id: Number(r.job_id),
-                        completedAt: r.completed_at,
-                        rndrUsed: BigInt(r.render_amt),
-                    },
-                }))
-                    .filter((a) => a.adjusted < a.downAdjToBurn);
-            });
-        },
-        getTxBurnAdjustments(trx, ps, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
-                if (!ps.toFill)
-                    return [];
-                const q = trx.trx
-                    .selectFrom(exports.TX_BURN_ADJUSTMENT_TABLE)
-                    .selectAll(exports.TX_BURN_ADJUSTMENT_TABLE)
-                    .leftJoin(exports.BURN_TABLE, `${exports.BURN_TABLE}.tx_burn_adjustment_id`, `${exports.TX_BURN_ADJUSTMENT_TABLE}.id`)
-                    .select(({ fn, lit }) => [
                     fn
                         .sum(fn.coalesce(`${exports.BURN_TABLE}.from_escrow_usdc`, lit(0)))
                         .as('tot_from_escrow'),
                 ])
-                    .groupBy(`${exports.TX_BURN_ADJUSTMENT_TABLE}.id`);
-                log.info(`getTxBurnAdjustments ${q.compile().sql}`);
+                    .where(`${exports.BURN_CORRECTION_TABLE}.kind`, '=', ps.kind)
+                    .groupBy(`${exports.BURN_CORRECTION_TABLE}.id`)
+                    .orderBy(`${exports.BURN_CORRECTION_TABLE}.created_at`, 'asc');
+                log.info(`getBurnCorrections(${ps.kind}) ${q.compile().sql}`);
                 const res = yield q.execute();
                 return res
                     .map((r) => ({
                     id: Number(r.id),
                     createdAt: r.created_at,
-                    solTxId: Number(r.sol_tx_id),
-                    surplusUsdc: Number(r.surplus_usdc),
-                    consumed: Number(r.tot_from_escrow),
+                    jobId: r.job_id != null ? Number(r.job_id) : undefined,
+                    solTxId: r.sol_tx_id != null ? Number(r.sol_tx_id) : undefined,
+                    kind: r.kind,
+                    amountRender: r.amount_render != null ? Number(r.amount_render) : undefined,
+                    amountUsdc: r.amount_usdc != null ? Number(r.amount_usdc) : undefined,
+                    consumed: ps.kind === 'down_adjust'
+                        ? Number(r.tot_to_burn) - Number(r.tot_burned)
+                        : Number(r.tot_from_escrow),
                 }))
-                    .filter((a) => a.consumed < a.surplusUsdc);
+                    .filter((c) => {
+                    var _a, _b;
+                    return c.kind === 'down_adjust'
+                        ? c.consumed < ((_a = c.amountRender) !== null && _a !== void 0 ? _a : 0)
+                        : c.consumed < ((_b = c.amountUsdc) !== null && _b !== void 0 ? _b : 0);
+                });
             });
         },
-        insertPolygonUpgrade(db, p, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        insertPolygonUpgrade(db_1, p_1) {
+            return __awaiter(this, arguments, void 0, function* (db, p, log = logger_1.consoleLogger) {
                 const solTxId = yield getOrInsertTx(db.trx, {
                     sig: p.solTx.sig,
                     executedAt: p.solTx.executedAt,
@@ -1952,8 +2025,8 @@ const pgClient = (config) => {
                 return;
             });
         },
-        fetchPolygonUpgrades(db, f, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        fetchPolygonUpgrades(db_1, f_1) {
+            return __awaiter(this, arguments, void 0, function* (db, f, log = logger_1.consoleLogger) {
                 let query = db.trx
                     .selectFrom('polygon_upgrade')
                     .selectAll('polygon_upgrade')
@@ -1979,13 +2052,13 @@ const pgClient = (config) => {
                 }));
             });
         },
-        getCurrentUserGrantSpend(db, f, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        getCurrentUserGrantSpend(db_1, f_1) {
+            return __awaiter(this, arguments, void 0, function* (db, f, log = logger_1.consoleLogger) {
                 return yield getCurrentUserGrantSpend(db.trx, f, log);
             });
         },
-        deleteAll(log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        deleteAll() {
+            return __awaiter(this, arguments, void 0, function* (log = logger_1.consoleLogger) {
                 if (config.database.includes('render')) {
                     throw new Error('cannot nuke from deployed database. call from tests only');
                 }
@@ -2031,8 +2104,8 @@ const pgClient = (config) => {
                 }
             });
         },
-        checkPaymentsForDate(targetDate, channel = 'both', log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        checkPaymentsForDate(targetDate_1) {
+            return __awaiter(this, arguments, void 0, function* (targetDate, channel = 'both', log = logger_1.consoleLogger) {
                 const startOfDay = new Date(targetDate);
                 startOfDay.setHours(0, 0, 0, 0);
                 const endOfDay = new Date(targetDate);
@@ -2083,8 +2156,8 @@ const pgClient = (config) => {
                 }
             });
         },
-        checkEpochProcessed(epochId, channel, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        checkEpochProcessed(epochId_1, channel_1) {
+            return __awaiter(this, arguments, void 0, function* (epochId, channel, log = logger_1.consoleLogger) {
                 try {
                     const result = yield db
                         .selectFrom('epoch')
@@ -2104,8 +2177,8 @@ const pgClient = (config) => {
                 }
             });
         },
-        checkRecentPaymentActivity(lookbackHours = 2, channel = 'both', log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
+        checkRecentPaymentActivity() {
+            return __awaiter(this, arguments, void 0, function* (lookbackHours = 2, channel = 'both', log = logger_1.consoleLogger) {
                 const lookbackTime = new Date(Date.now() - lookbackHours * 60 * 60 * 1000);
                 const now = new Date();
                 try {