@render-foundation/utils 0.0.231 → 0.0.232-beta.0

package/lib/cjs/client/dispersed.js

@@ -0,0 +1,123 @@
+"use strict";
+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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dispersedClient = exports.DispersedConflictError = void 0;
+const logger_1 = require("../logger");
+const node_fetch_1 = __importDefault(require("node-fetch"));
+/**
+ * Dispersed Token Burn API client (M2M OAuth2 client_credentials).
+ *
+ * Thin transport only: it mints/caches the bearer token and posts the two burn
+ * endpoints (claim, settle). It does NOT price RENDER, sum obligations, or do
+ * any burn math — the consumer owns that (incl. the `settled_amount == Σ
+ * obligation amounts` invariant). Amounts are passed through as decimal strings.
+ *
+ * Contract: see docs/dispersed-burn.md. Authoritative spec at
+ * `{apiBaseUrl}/openapi.json` (tag "Burn Ledger").
+ */
+// Both scopes, space-delimited, requested on every token mint.
+const SCOPES = 'burn_ledger_claims.create.all burn_ledger_settlements.create.all';
+// Re-mint a little before the token actually expires.
+const TOKEN_REFRESH_MARGIN_MS = 60000;
+/**
+ * Thrown on a 409 from settle: the claim is missing/expired/released/already
+ * settled, an obligation mismatch, an amount mismatch, or a tx_signature reused
+ * with a different payload. Nothing was written. Do NOT re-burn — reconcile.
+ */
+class DispersedConflictError extends Error {
+    constructor(body) {
+        super(`dispersed 409 conflict: ${body}`);
+        this.body = body;
+        this.status = 409;
+        this.name = 'DispersedConflictError';
+    }
+}
+exports.DispersedConflictError = DispersedConflictError;
+const dispersedClient = (cfg, fetchImpl = node_fetch_1.default) => {
+    let cached;
+    const mintToken = () => __awaiter(void 0, void 0, void 0, function* () {
+        const res = yield fetchImpl(`${cfg.authBaseUrl}/token`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                grant_type: 'client_credentials',
+                client_id: cfg.clientId,
+                client_secret: cfg.clientSecret,
+                scope: SCOPES,
+            }),
+        });
+        if (res.status !== 200) {
+            throw new Error(`dispersed token mint failed. code: ${res.status} body: ${JSON.stringify(yield res.text())}`);
+        }
+        const json = (yield res.json());
+        cached = {
+            token: json.access_token,
+            expiresAt: Date.now() + json.expires_in * 1000,
+        };
+        return cached.token;
+    });
+    const getToken = () => __awaiter(void 0, void 0, void 0, function* () {
+        if (cached && Date.now() < cached.expiresAt - TOKEN_REFRESH_MARGIN_MS) {
+            return cached.token;
+        }
+        return mintToken();
+    });
+    // POST with bearer; one transparent re-mint+retry on 401 (a dropped daily run
+    // is expensive, so it's worth recovering from a token that died mid-flight).
+    const authedPost = (path, body) => __awaiter(void 0, void 0, void 0, function* () {
+        const doPost = (token) => fetchImpl(`${cfg.apiBaseUrl}${path}`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${token}`,
+            },
+            body: JSON.stringify(body),
+        });
+        let res = yield doPost(yield getToken());
+        if (res.status === 401) {
+            cached = undefined;
+            res = yield doPost(yield mintToken());
+        }
+        return res;
+    });
+    return {
+        claim({ from, to, limit }, log = logger_1.consoleLogger) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const res = yield authedPost('/v1/burn-ledger-claims', Object.assign({ executor_id: cfg.executorId, from: from.toISOString(), to: to.toISOString() }, (limit !== undefined ? { limit } : {})));
+                if (res.status !== 201) {
+                    throw new Error(`dispersed claim failed. code: ${res.status} body: ${JSON.stringify(yield res.text())}`);
+                }
+                const result = (yield res.json());
+                log.info(`dispersed claim ${result.claim.uuid}: ${result.claimed_count} obligations, expires ${result.claim.claim_expires_at}`);
+                return result;
+            });
+        },
+        settle(req, log = logger_1.consoleLogger) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const res = yield authedPost('/v1/burn-ledger-settlements', req);
+                if (res.status === 409) {
+                    throw new DispersedConflictError(yield res.text());
+                }
+                if (res.status !== 201 && res.status !== 200) {
+                    throw new Error(`dispersed settle failed. code: ${res.status} body: ${JSON.stringify(yield res.text())}`);
+                }
+                const result = (yield res.json());
+                log.info(`dispersed settle ${result.settlement.uuid} for tx ${req.tx_signature} (replay=${result.idempotent_replay})`);
+                return result;
+            });
+        },
+    };
+};
+exports.dispersedClient = dispersedClient;
+//# sourceMappingURL=dispersed.js.map

package/lib/cjs/client/dispersed.js.map

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

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

@@ -35,7 +35,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.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_ADJUSTMENT_TABLE = exports.NETWORK_REVENUE_TABLE = exports.BRIDGE_TRANSFER_TABLE = exports.BURN_TABLE = exports.JOB_TABLE = exports.JOB_ID_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");
@@ -47,21 +47,19 @@ exports.MANUAL_BURN_TABLE = 'manual_burn';
 exports.ENTITY_TABLE = 'entity';
 exports.SOL_TRANSFER_TABLE = 'sol_transfer1';
 exports.LIABILITY_TABLE = 'liability';
-exports.LIABILITY_ADJUSTMENT_TABLE = 'liability_adjustment';
-exports.LIABILITY_ADJUSTMENT_BATCH_TABLE = 'liability_adjustment_batch';
 exports.JOB_ID_TABLE = 'job_id';
 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_ADJUSTMENT_TABLE = 'burn_adjustment';
 exports.ENTITY_EPOCH_INFO_TABLE = 'entity_epoch_info';
 exports.POLYGON_UPGRADE_TABLE = 'polygon_upgrade';
 exports.CURRENT_USER_GRANT_SPEND_TABLE = 'current_user_grant_spend';
 exports.USER_GRANT_SPEND_TABLE = 'user_grant_spend';
 exports.GRANT_BURN_ID_TABLE = 'grant_burn_id';
 exports.GRANT_BURN_TABLE = 'grant_burn';
+exports.DISPERSED_SETTLEMENT_TABLE = 'dispersed_settlement';
 BigInt.prototype.toJSON = function () {
     return this.toString();
 };
@@ -358,11 +356,7 @@ const pgClient = (config) => {
                     sig: solTx,
                     executedAt,
                 }, log);
-                // sol_transfer1 already has UNIQUE(sol_tx_id, from_entity_id,
-                // to_entity_id, symbol). Without ON CONFLICT a retry of the record step
-                // throws a unique violation and wedges the BullMQ job; make it an
-                // idempotent no-op and re-fetch the existing id instead.
-                let transferRow = yield db
+                const { id } = yield db
                     .insertInto(exports.SOL_TRANSFER_TABLE)
                     .values({
                     id: dbId,
@@ -373,23 +367,9 @@ const pgClient = (config) => {
                     symbol,
                     amount_payed: amountPayed,
                 })
-                    .onConflict((oc) => oc
-                    .columns(['sol_tx_id', 'from_entity_id', 'to_entity_id', 'symbol'])
-                    .doNothing())
                     .returning((eb) => ['id as id'])
-                    .executeTakeFirst();
-                if (!transferRow) {
-                    log.warn(`sol_transfer for sol_tx_id ${solTxId} ${fromEntityId}->${toEntityId} ${symbol} already exists; reusing existing id (idempotent retry)`);
-                    transferRow = yield db
-                        .selectFrom(exports.SOL_TRANSFER_TABLE)
-                        .select((eb) => ['id as id'])
-                        .where('sol_tx_id', '=', solTxId)
-                        .where('from_entity_id', '=', fromEntityId)
-                        .where('to_entity_id', '=', toEntityId)
-                        .where('symbol', '=', symbol)
-                        .executeTakeFirstOrThrow();
-                }
-                transferId = BigInt(transferRow.id);
+                    .executeTakeFirstOrThrow();
+                transferId = BigInt(id);
             }
             ids.push({ transferId, liabilityId });
         }
@@ -711,36 +691,9 @@ const pgClient = (config) => {
                     }
                     return b.as('x');
                 }, (join) => join.onRef('y.sol_key', '=', 'x.sol_key'))
-                    // Standing per-wallet/channel corrections (migration 36). NO epoch filter — an adjustment is
-                    // a permanent delta on outstanding, not tied to a payout window; payments net it via `payed`.
-                    .fullJoin((eb) => {
-                    let b = eb
-                        .selectFrom(exports.LIABILITY_ADJUSTMENT_TABLE)
-                        .select(({ fn }) => fn.sum(`amount_adjustment`).as('adj'))
-                        .innerJoin(exports.ENTITY_TABLE, `${exports.LIABILITY_ADJUSTMENT_TABLE}.entity_id`, 'entity.id')
-                        .select(['entity.sol_key'])
-                        .groupBy('entity.sol_key');
-                    if (f.banned) {
-                        b = b.where('entity.banned', '=', true);
-                    }
-                    else {
-                        b = b.where('entity.banned', '=', false);
-                    }
-                    if (f.channels && f.channels.length > 0) {
-                        b = b.where((eb) => eb.or(f.channels.map((c) => eb('liability_adjustment.channel', '=', c))));
-                    }
-                    else {
-                        b = b.where((eb) => eb.or([
-                            eb('liability_adjustment.channel', '=', 'node_operator'),
-                            eb('liability_adjustment.channel', '=', 'availability'),
-                        ]));
-                    }
-                    return b.as('a');
-                }, (join) => join.on((0, kysely_1.sql) `"a"."sol_key" = coalesce("y"."sol_key", "x"."sol_key")`))
                     .select(({ fn }) => [
-                    fn.coalesce('y.sol_key', 'x.sol_key', 'a.sol_key').as('sol_key'),
-                    (0, kysely_1.sql) `${fn.coalesce(`x.due`, (0, kysely_1.sql) `0`)} +
-              ${fn.coalesce(`a.adj`, (0, kysely_1.sql) `0`)} -
+                    fn.coalesce('y.sol_key', 'x.sol_key').as('sol_key'),
+                    (0, kysely_1.sql) `${fn.coalesce(`x.due`, (0, kysely_1.sql) `0`)} -
               ${fn.coalesce(`y.payed`, (0, kysely_1.sql) `0`)}`.as('out'),
                 ])
                     .as('z'))
@@ -761,59 +714,6 @@ const pgClient = (config) => {
                 return out;
             });
         },
-        addLiabilityAdjustments(batch, rows, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
-                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).
-                    const b = yield trx
-                        .insertInto(exports.LIABILITY_ADJUSTMENT_BATCH_TABLE)
-                        .values({
-                        label: batch.label,
-                        description: batch.description,
-                        created_by: batch.createdBy,
-                    })
-                        .onConflict((oc) => oc.column('label').doUpdateSet({
-                        description: batch.description,
-                        created_by: batch.createdBy,
-                    }))
-                        .returning('id')
-                        .executeTakeFirstOrThrow();
-                    const batchId = BigInt(b.id);
-                    let inserted = 0;
-                    let skipped = 0;
-                    let net = BigInt(0);
-                    let positive = BigInt(0);
-                    let negative = BigInt(0);
-                    for (const r of rows) {
-                        const entityId = yield getOrInsertEntity(trx, { solKey: r.solKey }, log);
-                        const res = yield trx
-                            .insertInto(exports.LIABILITY_ADJUSTMENT_TABLE)
-                            .values({
-                            entity_id: entityId,
-                            channel: r.channel,
-                            amount_adjustment: r.amountAdjustment,
-                            batch_id: batchId,
-                        })
-                            // unique (entity_id, channel, batch_id) → a re-run of the same batch is a no-op
-                            .onConflict((oc) => oc.columns(['entity_id', 'channel', 'batch_id']).doNothing())
-                            .executeTakeFirst();
-                        if (((_a = res.numInsertedOrUpdatedRows) !== null && _a !== void 0 ? _a : BigInt(0)) > BigInt(0))
-                            inserted++;
-                        else
-                            skipped++;
-                        net += r.amountAdjustment;
-                        if (r.amountAdjustment > BigInt(0))
-                            positive += r.amountAdjustment;
-                        else
-                            negative += r.amountAdjustment;
-                    }
-                    log.info(`liability_adjustment batch '${batch.label}' (id ${batchId}): ` +
-                        `inserted ${inserted}, skipped ${skipped}, net ${net} (+${positive} / ${negative})`);
-                    return { batchId, inserted, skipped, net, positive, negative };
-                }));
-            });
-        },
         fetchNodeOperatorEpoch(epochId, log = logger_1.consoleLogger) {
             var _a;
             return __awaiter(this, void 0, void 0, function* () {
@@ -1124,7 +1024,7 @@ const pgClient = (config) => {
                 let buyBurnId;
                 let grantBurnId;
                 if (p.buyBurn) {
-                    const { burned, usdcSpent, eurToUsdc, renderToUsdc, quoteAmt, tags, jobBurnAdjustmentId, txBurnAdjustmentId, toBurn, fromEscrowCredit, } = p.buyBurn;
+                    const { burned, usdcSpent, eurToUsdc, renderToUsdc, quoteAmt, tags, burnAdjustmentId, toBurn, } = p.buyBurn;
                     let pricedAt = p.buyBurn.pricedAt;
                     if (!pricedAt) {
                         const jobs = yield fetchJobs1(trx.trx, { ids: p.jobs.map((j) => String(j.id)) }, log);
@@ -1143,30 +1043,17 @@ const pgClient = (config) => {
                         quote_amt: quoteAmt,
                         burned: burned,
                         tags: tags.join(','),
-                        job_burn_adjustment_id: jobBurnAdjustmentId,
-                        tx_burn_adjustment_id: txBurnAdjustmentId,
+                        burn_adjustment_id: burnAdjustmentId,
                         to_burn: toBurn,
-                        from_escrow_credit: fromEscrowCredit !== null && fromEscrowCredit !== void 0 ? fromEscrowCredit : 0,
                     };
                     log.debug(`inserting burn ${JSON.stringify(v)}`);
-                    // Idempotent on sol_tx_id (uniq_burn_sol_tx_id, migration 27): a retry of
-                    // the record step for the same on-chain burn is a safe no-op. On conflict
-                    // executeTakeFirst() returns undefined, so re-fetch the existing id.
-                    let burnRow = yield trx.trx
+                    const { id } = yield trx.trx
                         .insertInto(exports.BURN_TABLE)
                         .values(v)
-                        .onConflict((oc) => oc.column('sol_tx_id').doNothing())
+                        //.onConflict((oc) => oc.column('sol_tx').doNothing())
                         .returning((eb) => ['id as id'])
-                        .executeTakeFirst();
-                    if (!burnRow) {
-                        log.warn(`burn for sol_tx_id ${solTxId} already exists; reusing existing id (idempotent retry)`);
-                        burnRow = yield trx.trx
-                            .selectFrom(exports.BURN_TABLE)
-                            .select((eb) => ['id as id'])
-                            .where('sol_tx_id', '=', solTxId)
-                            .executeTakeFirstOrThrow();
-                    }
-                    buyBurnId = Number(burnRow.id);
+                        .executeTakeFirstOrThrow();
+                    buyBurnId = Number(id);
                 }
                 if (p.grantBurn) {
                     const { burned, tags } = p.grantBurn;
@@ -1176,22 +1063,12 @@ const pgClient = (config) => {
                         tags: tags === null || tags === void 0 ? void 0 : tags.join(','),
                     };
                     log.debug(`inserting grant burn ${JSON.stringify(v)}`);
-                    // Idempotent on sol_tx_id (uniq_grant_burn_sol_tx_id, migration 27).
-                    let grantBurnRow = yield trx.trx
+                    const { id } = yield trx.trx
                         .insertInto(exports.GRANT_BURN_TABLE)
                         .values(v)
-                        .onConflict((oc) => oc.column('sol_tx_id').doNothing())
                         .returning((eb) => ['id as id'])
-                        .executeTakeFirst();
-                    if (!grantBurnRow) {
-                        log.warn(`grant_burn for sol_tx_id ${solTxId} already exists; reusing existing id (idempotent retry)`);
-                        grantBurnRow = yield trx.trx
-                            .selectFrom(exports.GRANT_BURN_TABLE)
-                            .select((eb) => ['id as id'])
-                            .where('sol_tx_id', '=', solTxId)
-                            .executeTakeFirstOrThrow();
-                    }
-                    grantBurnId = Number(grantBurnRow.id);
+                        .executeTakeFirstOrThrow();
+                    grantBurnId = Number(id);
                 }
                 const burnId = buyBurnId;
                 const grantId = grantBurnId !== null && grantBurnId !== void 0 ? grantBurnId : buyBurnId;
@@ -1710,6 +1587,73 @@ const pgClient = (config) => {
                 }));
             });
         },
+        insertDispersedOutbox(p, log = logger_1.consoleLogger) {
+            var _a, _b;
+            return __awaiter(this, void 0, void 0, function* () {
+                const res = yield db
+                    .insertInto(exports.DISPERSED_SETTLEMENT_TABLE)
+                    .values({
+                    tx_signature: p.txSignature,
+                    claim_uuid: p.claimUuid,
+                    obligation_uuids: p.obligationUuids,
+                    settled_amount: p.settledAmount,
+                    burned_amount: p.burnedAmount,
+                    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,
+                })
+                    .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* () {
+                yield db
+                    .updateTable(exports.DISPERSED_SETTLEMENT_TABLE)
+                    .set({ settled_at: new Date(), idempotent_replay: p.idempotentReplay })
+                    .where('tx_signature', '=', txSignature)
+                    .execute();
+                log.debug(`dispersed settled tx ${txSignature}`);
+            });
+        },
+        getUnsettledDispersed(log = logger_1.consoleLogger) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const rows = yield db
+                    .selectFrom(exports.DISPERSED_SETTLEMENT_TABLE)
+                    .selectAll()
+                    .where('settled_at', 'is', null)
+                    .execute();
+                log.debug(`dispersed outbox: ${rows.length} unsettled`);
+                return rows.map((r) => {
+                    var _a;
+                    return ({
+                        txSignature: r.tx_signature,
+                        claimUuid: r.claim_uuid,
+                        obligationUuids: r.obligation_uuids,
+                        settledAmount: r.settled_amount,
+                        burnedAmount: r.burned_amount,
+                        executedAt: r.executed_at,
+                        eurRender: (_a = r.eur_render) !== null && _a !== void 0 ? _a : 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)
+                            : undefined,
+                    });
+                });
+            });
+        },
+        voidDispersedOutbox(txSignature, log = logger_1.consoleLogger) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const res = yield db
+                    .deleteFrom(exports.DISPERSED_SETTLEMENT_TABLE)
+                    .where('tx_signature', '=', txSignature)
+                    // Never delete a row we already settled — void only applies to pending (un-landed) rows.
+                    .where('settled_at', 'is', null)
+                    .executeTakeFirst();
+                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* () {
                 return yield fetchJobs1(db.trx, f, log);
@@ -1779,90 +1723,46 @@ const pgClient = (config) => {
                 }));
             });
         },
-        createTxBurnAdjustment(trx, p, log = logger_1.consoleLogger) {
+        getBurnAdjustments(trx, ps, 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.
-                const row = yield trx.trx
-                    .insertInto(exports.TX_BURN_ADJUSTMENT_TABLE)
-                    .values({
-                    sol_tx_id: p.solTxId,
-                    surplus_render: p.surplusRender,
-                    description: p.description,
-                })
-                    .onConflict((oc) => oc.column('sol_tx_id').doNothing())
-                    .returning('id')
-                    .executeTakeFirst();
-                if (!row) {
-                    log.info(`tx_burn_adjustment for sol_tx ${p.solTxId} already exists — skipped`);
-                    return undefined;
+                if (ps.toFill) {
+                    const q = trx.trx
+                        .selectFrom(exports.BURN_ADJUSTMENT_TABLE)
+                        .selectAll(exports.BURN_ADJUSTMENT_TABLE)
+                        .innerJoin(exports.JOB_TABLE, `${exports.JOB_TABLE}.id`, `${exports.BURN_ADJUSTMENT_TABLE}.job_id`)
+                        .select([`${exports.JOB_TABLE}.completed_at`, `${exports.JOB_TABLE}.render_amt`])
+                        .leftJoin(exports.BURN_TABLE, `${exports.BURN_TABLE}.burn_adjustment_id`, `${exports.BURN_ADJUSTMENT_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.BURN_ADJUSTMENT_TABLE}.id`,
+                        `${exports.JOB_TABLE}.completed_at`,
+                        `${exports.JOB_TABLE}.render_amt`,
+                    ])
+                        .havingRef((0, kysely_1.sql) `SUM(COALESCE("burn"."to_burn", 0)) - SUM(COALESCE("burn"."burned", 0))`, '<', `${exports.BURN_ADJUSTMENT_TABLE}.down_adj_to_burn`);
+                    log.info(`getBurnAdjustments ${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),
+                        },
+                    }));
                 }
-                log.info(`created tx_burn_adjustment ${row.id}: ${p.surplusRender} RENDER surplus (sol_tx ${p.solTxId})`);
-                return Number(row.id);
-            });
-        },
-        getJobBurnAdjustments(trx, ps, log = logger_1.consoleLogger) {
-            return __awaiter(this, void 0, void 0, function* () {
-                if (!ps.toFill)
-                    return [];
-                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`)
-                    .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_credit`, lit(0)))
-                        .as('tot_from_escrow'),
-                ])
-                    .groupBy(`${exports.TX_BURN_ADJUSTMENT_TABLE}.id`);
-                log.info(`getTxBurnAdjustments ${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),
-                    surplusRender: Number(r.surplus_render),
-                    consumed: Number(r.tot_from_escrow),
-                }))
-                    .filter((a) => a.consumed < a.surplusRender);
+                return [];
             });
         },
         insertPolygonUpgrade(db, p, log = logger_1.consoleLogger) {