@bsv/wallet-toolbox 2.1.25 → 3.0.0-alpha.0

package/out/src/storage/schema/v7Cutover.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runV7Cutover = runV7Cutover;
+exports.rollbackV7Cutover = rollbackV7Cutover;
+const v7Backfill_knex_1 = require("./v7Backfill.knex");
+const v7Backfill_runner_1 = require("./v7Backfill.runner");
+/**
+ * §3 Step 6 of PROD_REQ_V7_TS.md — destructive cutover.
+ *
+ * Renames the legacy `transactions`, `proven_tx_reqs`, and `proven_txs` tables
+ * to `*_legacy`, swaps the V7 `transactions_v7` table in as the new
+ * canonical `transactions`, and remaps every FK value in `outputs`,
+ * `commissions`, and `tx_labels_map` so that downstream storage methods
+ * continue to read consistent rows.
+ *
+ * Not registered as a Knex migration because applying it changes the meaning
+ * of table names that legacy storage methods still address. Run it only when
+ * the calling application is ready to use the V7 storage path.
+ *
+ * Safe to call:
+ *  - on a populated DB that has not yet been cutover (performs full migration)
+ *  - on a fresh DB (renames empty tables to match the post-cutover layout)
+ *  - twice in a row (second call is a no-op via the `transactions_legacy`
+ *    presence guard)
+ *
+ * The function is intentionally not wrapped in a Knex transaction: on SQLite
+ * we need to toggle the per-connection `legacy_alter_table` pragma between
+ * statements, which is incompatible with the deferred-commit semantics
+ * Knex uses inside `knex.transaction`.
+ */
+async function runV7Cutover(knex) {
+    var _a, _b;
+    const dbtype = await determineDBType(knex);
+    const isSqlite = dbtype === 'SQLite';
+    // Idempotency guard.
+    if (await hasTable(knex, 'transactions_legacy'))
+        return;
+    // Ensure backfill has populated transactions_v7 / actions before remapping.
+    const txCount = await knex('transactions').count({ c: '*' }).first();
+    const v7Count = await knex('transactions_v7').count({ c: '*' }).first();
+    const hasLegacyData = ((_a = txCount === null || txCount === void 0 ? void 0 : txCount.c) !== null && _a !== void 0 ? _a : 0) > 0;
+    const v7Populated = ((_b = v7Count === null || v7Count === void 0 ? void 0 : v7Count.c) !== null && _b !== void 0 ? _b : 0) > 0;
+    if (hasLegacyData && !v7Populated) {
+        const driver = new v7Backfill_knex_1.V7KnexBackfillDriver(knex);
+        await (0, v7Backfill_runner_1.runV7Backfill)(driver);
+    }
+    // Build mappings legacy.transactionId -> { v7Id, actionId }.
+    const txMapRows = hasLegacyData
+        ? await knex('transactions as t')
+            .join('transactions_v7 as v', 'v.txid', 't.txid')
+            .select(knex.ref('t.transactionId').as('legacyId'), knex.ref('v.transactionId').as('v7Id'))
+        : [];
+    const actionMapRows = hasLegacyData
+        ? await knex('transactions as t')
+            .join('transactions_v7 as v', 'v.txid', 't.txid')
+            .join('actions as a', function joinAction() {
+            this.on('a.userId', '=', 't.userId').andOn('a.transactionId', '=', 'v.transactionId');
+        })
+            .select(knex.ref('t.transactionId').as('legacyId'), knex.ref('a.actionId').as('actionId'))
+        : [];
+    const legacyToV7 = new Map(txMapRows.map(r => [r.legacyId, r.v7Id]));
+    const legacyToAction = new Map(actionMapRows.map(r => [r.legacyId, r.actionId]));
+    await disableFks(knex, isSqlite);
+    try {
+        // Remap downstream FK values with a temporary offset to dodge collisions
+        // with the existing legacy keyspace during partial updates.
+        const OFFSET = 1000000000;
+        for (const [legacy, v7] of legacyToV7) {
+            const shifted = v7 + OFFSET;
+            await knex('outputs').where({ transactionId: legacy }).update({ transactionId: shifted });
+            await knex('outputs').where({ spentBy: legacy }).update({ spentBy: shifted });
+            await knex('commissions').where({ transactionId: legacy }).update({ transactionId: shifted });
+        }
+        await knex('outputs').where('transactionId', '>=', OFFSET).update({
+            transactionId: knex.raw('?? - ?', ['transactionId', OFFSET])
+        });
+        await knex('outputs').where('spentBy', '>=', OFFSET).update({
+            spentBy: knex.raw('?? - ?', ['spentBy', OFFSET])
+        });
+        await knex('commissions').where('transactionId', '>=', OFFSET).update({
+            transactionId: knex.raw('?? - ?', ['transactionId', OFFSET])
+        });
+        for (const [legacy, actionId] of legacyToAction) {
+            const shifted = actionId + OFFSET;
+            await knex('tx_labels_map').where({ transactionId: legacy }).update({ transactionId: shifted });
+        }
+        await knex('tx_labels_map').where('transactionId', '>=', OFFSET).update({
+            transactionId: knex.raw('?? - ?', ['transactionId', OFFSET])
+        });
+        // legacy_alter_table = ON suppresses SQLite's automatic FK rewrite on
+        // RENAME. We want it ON for the legacy-table renames (so that outputs /
+        // commissions / tx_labels_map FKs keep pointing at the bare string
+        // "transactions" and resolve to the new table after the swap) and OFF
+        // for the V7 rename (so that tx_audit / actions FKs that originally
+        // targeted `transactions_v7` follow the rename to `transactions`).
+        if (isSqlite)
+            await knex.raw('PRAGMA legacy_alter_table = ON');
+        await knex.schema.renameTable('transactions', 'transactions_legacy');
+        await knex.schema.renameTable('proven_tx_reqs', 'proven_tx_reqs_legacy');
+        await knex.schema.renameTable('proven_txs', 'proven_txs_legacy');
+        if (isSqlite)
+            await knex.raw('PRAGMA legacy_alter_table = OFF');
+        await knex.schema.renameTable('transactions_v7', 'transactions');
+        await rebuildTxLabelsMap(knex, dbtype);
+    }
+    finally {
+        await enableFks(knex, isSqlite);
+    }
+}
+/**
+ * Inverse of `runV7Cutover` for test rollback. Renames `*_legacy` tables back
+ * to their canonical names and swaps `transactions` back to `transactions_v7`.
+ * Does not reverse the FK value remap — call this only when the cutover was
+ * applied to seed data that the test no longer needs.
+ */
+async function rollbackV7Cutover(knex) {
+    const dbtype = await determineDBType(knex);
+    const isSqlite = dbtype === 'SQLite';
+    await disableFks(knex, isSqlite);
+    try {
+        if (isSqlite)
+            await knex.raw('PRAGMA legacy_alter_table = ON');
+        if (await hasTable(knex, 'transactions')) {
+            await knex.schema.renameTable('transactions', 'transactions_v7');
+        }
+        if (await hasTable(knex, 'transactions_legacy')) {
+            await knex.schema.renameTable('transactions_legacy', 'transactions');
+        }
+        if (await hasTable(knex, 'proven_tx_reqs_legacy')) {
+            await knex.schema.renameTable('proven_tx_reqs_legacy', 'proven_tx_reqs');
+        }
+        if (await hasTable(knex, 'proven_txs_legacy')) {
+            await knex.schema.renameTable('proven_txs_legacy', 'proven_txs');
+        }
+        if (isSqlite)
+            await knex.raw('PRAGMA legacy_alter_table = OFF');
+    }
+    finally {
+        await enableFks(knex, isSqlite);
+    }
+}
+async function determineDBType(knex) {
+    var _a, _b, _c;
+    // Avoid pulling KnexMigrations' determineDBType to keep this module
+    // free of cyclic imports.
+    try {
+        const r = await knex.raw("SELECT 'MySQL' AS database_type FROM dual");
+        const dbtype = (_c = (Array.isArray(r) ? r[0] : (_b = (_a = r.rows) === null || _a === void 0 ? void 0 : _a[0]) !== null && _b !== void 0 ? _b : r[0])) === null || _c === void 0 ? void 0 : _c.database_type;
+        if (dbtype === 'MySQL')
+            return 'MySQL';
+    }
+    catch (e) {
+        // fallthrough — SQLite has no `dual` table
+    }
+    try {
+        await knex.raw('SELECT 1');
+        return 'SQLite';
+    }
+    catch (e) {
+        throw new Error('Unsupported database engine for V7 cutover');
+    }
+}
+async function hasTable(knex, name) {
+    return await knex.schema.hasTable(name);
+}
+async function disableFks(knex, isSqlite) {
+    if (isSqlite) {
+        await knex.raw('PRAGMA foreign_keys = OFF');
+    }
+    else {
+        await knex.raw('SET FOREIGN_KEY_CHECKS=0');
+    }
+}
+async function enableFks(knex, isSqlite) {
+    if (isSqlite) {
+        await knex.raw('PRAGMA foreign_keys = ON');
+    }
+    else {
+        await knex.raw('SET FOREIGN_KEY_CHECKS=1');
+    }
+}
+async function rebuildTxLabelsMap(knex, dbtype) {
+    var _a, _b;
+    if (dbtype === 'SQLite') {
+        await knex.schema.createTable('tx_labels_map_new', table => {
+            table.timestamp('created_at', { precision: 3 }).defaultTo(knex.fn.now()).notNullable();
+            table.timestamp('updated_at', { precision: 3 }).defaultTo(knex.fn.now()).notNullable();
+            table.integer('txLabelId').unsigned().references('txLabelId').inTable('tx_labels').notNullable();
+            table.integer('transactionId').unsigned().references('actionId').inTable('actions').notNullable();
+            table.boolean('isDeleted').notNullable().defaultTo(false);
+            table.unique(['txLabelId', 'transactionId']);
+        });
+        await knex.raw('INSERT INTO tx_labels_map_new (created_at, updated_at, txLabelId, transactionId, isDeleted) ' +
+            'SELECT created_at, updated_at, txLabelId, transactionId, isDeleted FROM tx_labels_map');
+        await knex.schema.dropTable('tx_labels_map');
+        await knex.schema.renameTable('tx_labels_map_new', 'tx_labels_map');
+        await knex.schema.alterTable('tx_labels_map', table => {
+            table.index('transactionId');
+            table.index(['transactionId', 'isDeleted'], 'idx_tx_labels_map_tx_deleted');
+        });
+    }
+    else {
+        const dbRow = (await knex.raw('SELECT DATABASE() AS d'))[0];
+        const dbName = Array.isArray(dbRow) ? (_a = dbRow[0]) === null || _a === void 0 ? void 0 : _a.d : dbRow === null || dbRow === void 0 ? void 0 : dbRow.d;
+        const fkRows = await knex('information_schema.KEY_COLUMN_USAGE')
+            .select('CONSTRAINT_NAME')
+            .where({
+            TABLE_SCHEMA: dbName,
+            TABLE_NAME: 'tx_labels_map',
+            COLUMN_NAME: 'transactionId'
+        })
+            .whereNotNull('REFERENCED_TABLE_NAME');
+        for (const row of fkRows !== null && fkRows !== void 0 ? fkRows : []) {
+            const constraintName = (_b = row.CONSTRAINT_NAME) !== null && _b !== void 0 ? _b : row.constraint_name;
+            if (constraintName != null) {
+                await knex.raw('ALTER TABLE tx_labels_map DROP FOREIGN KEY `' + constraintName + '`');
+            }
+        }
+        await knex.raw('ALTER TABLE tx_labels_map ADD CONSTRAINT fk_tx_labels_map_action ' +
+            'FOREIGN KEY (transactionId) REFERENCES actions(actionId)');
+    }
+}
+//# sourceMappingURL=v7Cutover.js.map

package/out/src/storage/schema/v7Cutover.js.map

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

package/out/src/storage/schema/v7CutoverIdb.d.ts

@@ -0,0 +1,26 @@
+import { IDBPDatabase } from 'idb';
+import { StorageIdbSchema } from './StorageIdbSchema';
+/**
+ * V7 IDB-side cutover.
+ *
+ * IndexedDB has no `RENAME STORE` primitive, and store creation/deletion is
+ * only permitted during a version-upgrade transaction. The cutover therefore:
+ *
+ *   1. Re-opens the database at a higher version, supplying an `upgrade`
+ *      callback that does the rename via copy-and-delete on the upgrade trx.
+ *   2. For each table that needs renaming:
+ *        a. Read every row from the source store.
+ *        b. Create the destination store with the same indexes.
+ *        c. Write rows into the destination store.
+ *        d. Delete the source store.
+ *   3. Returns the upgraded database handle (caller is responsible for
+ *      closing it).
+ *
+ * Safe to call twice — the second call sees the post-cutover layout, skips
+ * the rename block, and returns without error.
+ *
+ * `targetVersion` defaults to 2; bump it if the caller already operates on a
+ * higher schema version.
+ */
+export declare function runV7IdbCutover(dbName: string, targetVersion?: number): Promise<IDBPDatabase<StorageIdbSchema>>;
+//# sourceMappingURL=v7CutoverIdb.d.ts.map

package/out/src/storage/schema/v7CutoverIdb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v7CutoverIdb.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/v7CutoverIdb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA2B,MAAM,KAAK,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,aAAa,SAAI,GAChB,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAyDzC"}

package/out/src/storage/schema/v7CutoverIdb.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runV7IdbCutover = runV7IdbCutover;
+const idb_1 = require("idb");
+/**
+ * V7 IDB-side cutover.
+ *
+ * IndexedDB has no `RENAME STORE` primitive, and store creation/deletion is
+ * only permitted during a version-upgrade transaction. The cutover therefore:
+ *
+ *   1. Re-opens the database at a higher version, supplying an `upgrade`
+ *      callback that does the rename via copy-and-delete on the upgrade trx.
+ *   2. For each table that needs renaming:
+ *        a. Read every row from the source store.
+ *        b. Create the destination store with the same indexes.
+ *        c. Write rows into the destination store.
+ *        d. Delete the source store.
+ *   3. Returns the upgraded database handle (caller is responsible for
+ *      closing it).
+ *
+ * Safe to call twice — the second call sees the post-cutover layout, skips
+ * the rename block, and returns without error.
+ *
+ * `targetVersion` defaults to 2; bump it if the caller already operates on a
+ * higher schema version.
+ */
+async function runV7IdbCutover(dbName, targetVersion = 2) {
+    return await (0, idb_1.openDB)(dbName, targetVersion, {
+        async upgrade(db, oldVersion, _newVersion, trx) {
+            if (oldVersion >= 2)
+                return;
+            if (!db.objectStoreNames.contains('transactions_v7'))
+                return;
+            await renameStore(db, trx, 'transactions', 'transactions_legacy', store => {
+                store.createIndex('userId', 'userId');
+                store.createIndex('status', 'status');
+                store.createIndex('status_userId', ['status', 'userId']);
+                store.createIndex('provenTxId', 'provenTxId');
+                store.createIndex('reference', 'reference', { unique: true });
+            });
+            await renameStore(db, trx, 'proven_tx_reqs', 'proven_tx_reqs_legacy', store => {
+                store.createIndex('provenTxId', 'provenTxId');
+                store.createIndex('txid', 'txid', { unique: true });
+                store.createIndex('status', 'status');
+                store.createIndex('batch', 'batch');
+            });
+            await renameStore(db, trx, 'proven_txs', 'proven_txs_legacy', store => {
+                store.createIndex('txid', 'txid', { unique: true });
+            });
+            await renameStore(db, trx, 'transactions_v7', 'transactions', store => {
+                store.createIndex('txid', 'txid', { unique: true });
+                store.createIndex('processing', 'processing');
+                store.createIndex('batch', 'batch');
+                store.createIndex('idempotencyKey', 'idempotencyKey', { unique: true });
+            });
+        }
+    });
+}
+async function renameStore(db, trx, fromName, toName, applyIndexes) {
+    if (!db.objectStoreNames.contains(fromName))
+        return;
+    if (db.objectStoreNames.contains(toName)) {
+        // Target already exists — assume a prior partial cutover. Drop the source
+        // and continue rather than fail; the application is expected to verify
+        // post-cutover state via its own smoke tests before resuming traffic.
+        db.deleteObjectStore(fromName);
+        return;
+    }
+    const sourceStore = trx.objectStore(fromName);
+    const sourceKeyPath = sourceStore.keyPath;
+    const sourceAutoIncrement = sourceStore.autoIncrement;
+    const rows = await sourceStore.getAll();
+    const keys = await sourceStore.getAllKeys();
+    db.deleteObjectStore(fromName);
+    const dest = db.createObjectStore(toName, {
+        keyPath: sourceKeyPath !== null && sourceKeyPath !== void 0 ? sourceKeyPath : undefined,
+        autoIncrement: sourceAutoIncrement
+    });
+    applyIndexes(dest);
+    const destStore = trx.objectStore(toName);
+    for (let i = 0; i < rows.length; i++) {
+        if (sourceAutoIncrement || sourceKeyPath != null) {
+            await destStore.put(rows[i]);
+        }
+        else {
+            await destStore.put(rows[i], keys[i]);
+        }
+    }
+}
+//# sourceMappingURL=v7CutoverIdb.js.map

package/out/src/storage/schema/v7CutoverIdb.js.map

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

package/out/src/storage/schema/v7Fsm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v7Fsm.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/v7Fsm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AA+BhC,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,GAAG,CAAC,gBAAgB,EAC1B,EAAE,EAAE,GAAG,CAAC,gBAAgB,GACvB,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,GAAG,CAAC,gBAAgB,EAC1B,EAAE,EAAE,GAAG,CAAC,gBAAgB,GACvB,mBAAmB,CAMrB;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,IAAK,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,SAAS,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAElH;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAE,CAAC,EAAE,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAEvE;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAE,CAAC,EAAE,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAEtE"}
+{"version":3,"file":"v7Fsm.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/v7Fsm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AA+ChC,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,GAAG,CAAC,gBAAgB,EAC1B,EAAE,EAAE,GAAG,CAAC,gBAAgB,GACvB,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,GAAG,CAAC,gBAAgB,EAC1B,EAAE,EAAE,GAAG,CAAC,gBAAgB,GACvB,mBAAmB,CAMrB;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,IAAK,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,SAAS,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAElH;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAE,CAAC,EAAE,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAEvE;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAE,CAAC,EAAE,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAEtE"}

package/out/src/storage/schema/v7Fsm.js

@@ -52,20 +52,36 @@ const sdk = __importStar(require("../../sdk"));
  * provider acknowledged) are enforced at the call site.
  */
 const TRANSITIONS = {
-    queued: ['sending', 'sent', 'nosend', 'frozen', 'nonfinal', 'invalid'],
+    // `queued -> doubleSpend`: a tx queued locally may be reported as a
+    // double-spend by the network before our first send attempt (e.g. another
+    // wallet broadcast the same outpoint first). See V7_STORAGE_METHOD_WIRING §4
+    // legacy mapping `* -> doubleSpend (rejection)`.
+    queued: ['sending', 'sent', 'nosend', 'frozen', 'nonfinal', 'invalid', 'doubleSpend'],
     sending: ['sent', 'seen', 'seen_multi', 'invalid', 'doubleSpend', 'frozen', 'queued'],
     sent: ['seen', 'seen_multi', 'unconfirmed', 'proven', 'invalid', 'doubleSpend', 'frozen', 'sending'],
-    seen: ['seen_multi', 'unconfirmed', 'proven', 'invalid', 'doubleSpend', 'reorging', 'frozen'],
-    seen_multi: ['unconfirmed', 'proven', 'invalid', 'doubleSpend', 'reorging', 'frozen'],
-    unconfirmed: ['proven', 'invalid', 'reorging', 'frozen', 'seen', 'seen_multi'],
+    // `seen -> sending`: provider re-acknowledgment lost; legacy mapping
+    // `* -> sending (serviceError retry)` from V7_STORAGE_METHOD_WIRING §4.
+    seen: ['seen_multi', 'unconfirmed', 'proven', 'invalid', 'doubleSpend', 'reorging', 'frozen', 'sending'],
+    // `seen_multi -> sending`: same retry semantics as `seen -> sending`.
+    seen_multi: ['unconfirmed', 'proven', 'invalid', 'doubleSpend', 'reorging', 'frozen', 'sending'],
+    // `unconfirmed -> doubleSpend`: a provider's proof candidate may be retracted
+    // when a competing tx is mined. `unconfirmed -> sending`: candidate failed
+    // chaintracks validation, restart broadcast attempts. Both per §4.
+    unconfirmed: ['proven', 'invalid', 'reorging', 'frozen', 'seen', 'seen_multi', 'doubleSpend', 'sending'],
     proven: ['reorging'],
     reorging: ['proven', 'seen', 'seen_multi', 'unconfirmed', 'invalid', 'doubleSpend', 'frozen'],
     invalid: ['unfail'],
     doubleSpend: ['unfail'],
     unfail: ['queued', 'sending', 'sent', 'seen', 'seen_multi', 'unconfirmed', 'proven', 'invalid', 'doubleSpend'],
     frozen: ['queued', 'sending', 'sent', 'seen', 'seen_multi', 'unconfirmed', 'invalid', 'doubleSpend'],
-    nosend: ['queued', 'sent', 'seen', 'invalid', 'frozen'],
-    nonfinal: ['queued', 'sending', 'sent', 'invalid', 'frozen']
+    // `nosend -> sending`: operator (or processAction promotion) moves a
+    // never-broadcast tx into the active broadcast pipeline. `nosend ->
+    // doubleSpend`: an externally-broadcast nosend tx may be reported as a
+    // double-spend. Both per §4 legacy mapping.
+    nosend: ['queued', 'sending', 'sent', 'seen', 'invalid', 'doubleSpend', 'frozen'],
+    // `nonfinal -> doubleSpend`: a live-nLockTime tx may be replaced by a
+    // confirmed competing tx and reported as a double-spend.
+    nonfinal: ['queued', 'sending', 'sent', 'invalid', 'doubleSpend', 'frozen']
 };
 /**
  * Returns true when `from -> to` is a permitted V7 processing transition.

package/out/src/storage/schema/v7Fsm.js.map

@@ -1 +1 @@
-{"version":3,"file":"v7Fsm.js","sourceRoot":"","sources":["../../../../src/storage/schema/v7Fsm.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,kEAMC;AAMD,oEASC;AAGD,0DAEC;AAOD,sDAEC;AAGD,oDAEC;AAjFD,+CAAgC;AAEhC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,GAAyD;IACxE,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC;IACtE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACrF,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,CAAC;IACpG,IAAI,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,CAAC;IAC7F,UAAU,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,CAAC;IACrF,WAAW,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC;IAC9E,MAAM,EAAE,CAAC,UAAU,CAAC;IACpB,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC;IAC7F,OAAO,EAAE,CAAC,QAAQ,CAAC;IACnB,WAAW,EAAE,CAAC,QAAQ,CAAC;IACvB,MAAM,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,CAAC;IAC9G,MAAM,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,CAAC;IACpG,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC;IACvD,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC;CAC7D,CAAA;AAOD;;;;GAIG;AACH,SAAgB,2BAA2B,CACzC,IAA0B,EAC1B,EAAwB;IAExB,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IAC5B,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;AACvC,CAAC;AAED;;;GAGG;AACH,SAAgB,4BAA4B,CAC1C,IAA0B,EAC1B,EAAwB;IAExB,IAAI,2BAA2B,CAAC,IAAI,EAAE,EAAE,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;IAC9D,OAAO;QACL,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,sBAAsB,IAAI,OAAO,EAAE,iBAAiB,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KAC3F,CAAA;AACH,CAAC;AAED,kEAAkE;AAClE,SAAgB,uBAAuB;IACrC,OAAO,WAAW,CAAA;AACpB,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CAAE,CAAuB;IAC5D,OAAO,GAAG,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AAClD,CAAC;AAED,0EAA0E;AAC1E,SAAgB,oBAAoB,CAAE,CAAuB;IAC3D,OAAO,GAAG,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AACjD,CAAC"}
+{"version":3,"file":"v7Fsm.js","sourceRoot":"","sources":["../../../../src/storage/schema/v7Fsm.ts"],"names":[],"mappings":"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"}