972c0f9b89
Adds a one-shot operational tx that re-shapes any operator wallet to
{5 AP3X collateral candidate, working remainder} so subsequent Plutus
script-spends (Claim/Submit/Accept/Reclaim/RetireAdvert) find a UTxO
that satisfies lucid's setCollateral=5_000_000n default coin selector.
Symptom this addresses: open-webui mainnet supplier wallet held 8 UTxOs
max 2.40 AP3X, every Accept tx failed at lucid .complete() with the
"wallet must hold a pure-ADA UTxO ≥ 5 ADA" error path. Same fragmentation
risk on the other 4 mainnet operator wallets (one big UTxO surrounded by
dust — first script-spend consumes the big one and leaves nothing usable
as collateral).
Phase 1 — new tx:consolidate-wallet CLI (supplier + buyer):
- planConsolidate.ts — pure planner; supports consolidate (N>1 → 2),
split (1 → 2), and already-healthy skip.
- consolidateWallet.ts — live builder; presetWalletInputs pins all
UTxOs, two pay.ToAddress outputs (collateral + working).
- runConsolidateWallet.ts — orchestration (build + submit + awaitTx).
- supplier/src/cli/consolidate-wallet.ts + buyer mirror.
- monitor-wallets.ts — add supplier-tts@vector-marketplace (was
misclassified as 3rd-party).
Phase 2 — defensive pre-check in the 5 script-spend builders:
- assertCollateralCandidate(utxos) fires at the top of
buildSpendOpenOrClaimedTx (Claim/Submit), buildLiveTxForAccept,
buildLiveTxForReclaim, buildLiveTxForRetireAdvert. Throws a
TxConstructionError("collateral_required") pointing at
tx:consolidate-wallet instead of waiting for lucid's deep failure.
Tests: 12 new passing (planConsolidate edge cases + assert helper).
Pre-existing lucid 0.4.30 WASM "unreachable" failures in tx-*-live.test.ts
fixtures are unchanged.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
96 lines
3.0 KiB
TypeScript
96 lines
3.0 KiB
TypeScript
/**
|
|
* tx-consolidate-wallet.test.ts — pure unit tests for the consolidate
|
|
* planner. Drives planConsolidate directly without lucid / WASM.
|
|
*/
|
|
|
|
import { describe, it, expect } from "vitest";
|
|
import {
|
|
planConsolidate,
|
|
DEFAULT_COLLATERAL_LOVELACE,
|
|
DEFAULT_FEE_RESERVE,
|
|
type UtxoLike,
|
|
} from "../../packages/shared/src/tx/wallet/planConsolidate.js";
|
|
|
|
function u(lovelace: bigint): UtxoLike {
|
|
return { assets: { lovelace } };
|
|
}
|
|
|
|
describe("planConsolidate", () => {
|
|
it("consolidates a fragmented wallet (8 UTxOs, max 2.4 AP3X)", () => {
|
|
const utxos: UtxoLike[] = [
|
|
u(2_400_750n),
|
|
u(1_679_301n),
|
|
u(1_679_301n),
|
|
u(1_679_301n),
|
|
u(1_679_301n),
|
|
u(1_679_301n),
|
|
u(1_679_301n),
|
|
u(1_679_301n),
|
|
];
|
|
const total = utxos.reduce((s, x) => s + x.assets.lovelace, 0n);
|
|
|
|
const plan = planConsolidate(utxos);
|
|
|
|
expect(plan.reason).toBe("consolidate");
|
|
expect(plan.alreadyHealthy).toBe(false);
|
|
expect(plan.inputCount).toBe(8);
|
|
expect(plan.totalLovelaceIn).toBe(total);
|
|
expect(plan.collateralOutput).toBe(DEFAULT_COLLATERAL_LOVELACE);
|
|
expect(plan.workingOutput).toBe(
|
|
total - DEFAULT_COLLATERAL_LOVELACE - DEFAULT_FEE_RESERVE,
|
|
);
|
|
});
|
|
|
|
it("splits a single large UTxO into 2 outputs", () => {
|
|
const utxos = [u(17_500_000n)];
|
|
const plan = planConsolidate(utxos);
|
|
|
|
expect(plan.reason).toBe("split");
|
|
expect(plan.alreadyHealthy).toBe(false);
|
|
expect(plan.inputCount).toBe(1);
|
|
expect(plan.collateralOutput).toBe(DEFAULT_COLLATERAL_LOVELACE);
|
|
expect(plan.workingOutput).toBe(
|
|
17_500_000n - DEFAULT_COLLATERAL_LOVELACE - DEFAULT_FEE_RESERVE,
|
|
);
|
|
});
|
|
|
|
it("skips a wallet already in {collateral, working} shape", () => {
|
|
const utxos = [u(5_000_000n), u(8_650_000n)];
|
|
const plan = planConsolidate(utxos);
|
|
|
|
expect(plan.reason).toBe("already-healthy");
|
|
expect(plan.alreadyHealthy).toBe(true);
|
|
expect(plan.collateralOutput).toBe(5_000_000n);
|
|
expect(plan.workingOutput).toBe(8_650_000n);
|
|
});
|
|
|
|
it("consolidates a 2-UTxO wallet where the smaller is below collateral threshold", () => {
|
|
// Both fit budget but smaller (3 AP3X) is below 5 AP3X — needs reshape.
|
|
const utxos = [u(3_000_000n), u(15_000_000n)];
|
|
const plan = planConsolidate(utxos);
|
|
|
|
expect(plan.reason).toBe("consolidate");
|
|
expect(plan.alreadyHealthy).toBe(false);
|
|
expect(plan.inputCount).toBe(2);
|
|
});
|
|
|
|
it("throws on 0 UTxOs", () => {
|
|
expect(() => planConsolidate([])).toThrow(/no UTxOs/i);
|
|
});
|
|
|
|
it("throws on balance below threshold", () => {
|
|
// 4 AP3X total — under 5 + 2 + 1 = 8 AP3X required minimum.
|
|
const utxos = [u(2_000_000n), u(2_000_000n)];
|
|
expect(() => planConsolidate(utxos)).toThrow(/balance too low/i);
|
|
});
|
|
|
|
it("respects custom collateralLovelace", () => {
|
|
const utxos = [u(20_000_000n)];
|
|
const plan = planConsolidate(utxos, 10_000_000n);
|
|
|
|
expect(plan.reason).toBe("split");
|
|
expect(plan.collateralOutput).toBe(10_000_000n);
|
|
expect(plan.workingOutput).toBe(20_000_000n - 10_000_000n - DEFAULT_FEE_RESERVE);
|
|
});
|
|
});
|