project-cpu-mcp 0.9.1 → 0.11.1

package/dist/services/lot-return.service.js

@@ -0,0 +1,151 @@
+import { decodeDeliveryScheduled, settleTransitFees } from './delivery.helpers.js';
+import { assertFeeWithinCeiling, assertReturnRoute, assertReturnableLot, assertRouteStartsAtHub, assertWholeRemainder, decodeReturnedUnits, describeCapacityRefusal, describeLotReturnRevert, parseFeeCeilingWei, returnBranchOf, } from './lot-return.utils.js';
+import { preparePaidAction } from './paid-action.js';
+import { AppContract } from './paid-action.types.js';
+import { LotReturnBranch, } from './types.js';
+import { assessDestinationCapacity } from './warehouse.utils.js';
+import { toProjectionConfig } from '../map/reader.utils.js';
+import { configuredStorageCap, usesHubShelf } from '../map/storage.utils.js';
+import { cpuFromWei } from '../utils/format.utils.js';
+/**
+ * One seller intent — send a lot's whole unsold remainder home — over the two contract branches that can
+ * carry it: `cancel` for an Open lot, `reclaim` for an Evicted one. Both are priced by `Trade.quoteReturn`
+ * and both carry the ceiling the seller passes in, never a figure this service picked for them: the route is
+ * re-priced on-chain to decide, and a fee that outgrew the seller's ceiling refuses before anything is spent.
+ */
+export class LotReturnService {
+    wallet;
+    appConfig;
+    allowance;
+    contracts;
+    tradeClient;
+    mapReader;
+    logger;
+    constructor(options) {
+        this.wallet = options.wallet;
+        this.appConfig = options.appConfig;
+        this.allowance = options.allowance;
+        this.contracts = options.contracts;
+        this.tradeClient = options.tradeClient;
+        this.mapReader = options.mapReader;
+        this.logger = options.logger;
+    }
+    async quoteReturn(input) {
+        const prepared = await this.prepare(input);
+        const quote = await this.quoteOnChain(prepared);
+        const capacity = await this.assessDestination(prepared, quote.amount);
+        return this.toQuoteView(prepared, quote, capacity);
+    }
+    async returnLot(input) {
+        const maxFee = parseFeeCeilingWei(input.maxTransitFeeWei, input.lotId);
+        const prepared = await this.prepare(input);
+        const { action, trade, lot, state, lotId, returnTokenIds } = prepared;
+        const transport = action.requireContract(AppContract.Transport, 'cannot route goods');
+        const quote = await this.quoteOnChain(prepared);
+        assertWholeRemainder(quote.amount, lot.remaining, input.lotId);
+        assertFeeWithinCeiling(quote.transitFee, maxFee, input.lotId);
+        const capacity = await this.assessDestination(prepared, quote.amount);
+        if (!capacity.fits) {
+            throw new Error(describeCapacityRefusal(capacity, prepared.destinationTokenId, input.lotId));
+        }
+        const branch = returnBranchOf(state);
+        // The price decides whether an allowance is needed at all; the ceiling only decides how much it caps.
+        // Keying this on the ceiling would send an unbounded approve for a route that costs nothing.
+        const approveTxHash = quote.transitFee === 0n
+            ? null
+            : await this.allowance.ensureAllowance(action.requireContract(AppContract.CpuToken, 'cannot pay for transit'), transport, maxFee);
+        this.logger.info('returning lot', {
+            lotId: input.lotId,
+            branch,
+            maxFeeWei: maxFee.toString(),
+            quotedFeeWei: quote.transitFee.toString(),
+            amount: quote.amount.toString(),
+        });
+        let confirmed;
+        try {
+            const txHash = branch === LotReturnBranch.Reclaimed
+                ? await this.tradeClient.reclaim({ trade, lotId, returnTokenIds, maxFee })
+                : await this.tradeClient.cancel({ trade, lotId, returnTokenIds, maxFee });
+            confirmed = await this.contracts.confirm(txHash, `Return lot ${input.lotId}`);
+        }
+        catch (error) {
+            throw describeLotReturnRevert(error, branch);
+        }
+        const scheduled = decodeDeliveryScheduled(confirmed.logs, transport);
+        const transit = settleTransitFees(confirmed.logs, transport, quote.transitFee);
+        const returned = decodeReturnedUnits(confirmed.logs, trade, quote.amount, this.logger);
+        return {
+            lotId: input.lotId,
+            originalState: state,
+            branch,
+            hubTokenId: lot.hub.toString(),
+            resourceId: lot.resource,
+            returned: returned.toString(),
+            transitPaid: cpuFromWei(transit.transitPaid.toString()),
+            transitDiscount: cpuFromWei(transit.transitDiscount.toString()),
+            destinationTokenId: scheduled.targetId.toString(),
+            deliveryId: scheduled.deliveryId.toString(),
+            arrivalAt: Number(scheduled.arrivalAt),
+            approveTxHash,
+            txHash: confirmed.txHash,
+            status: confirmed.status,
+            blockNumber: confirmed.blockNumber,
+        };
+    }
+    async prepare(input) {
+        const action = await preparePaidAction({ appConfig: this.appConfig, wallet: this.wallet });
+        const trade = action.requireContract(AppContract.Trade, 'cannot return a lot');
+        assertReturnRoute(input.chain);
+        const seller = action.wallet.getAddress();
+        const lotId = BigInt(input.lotId);
+        const lot = await this.tradeClient.getLot({ trade, lotId });
+        const state = assertReturnableLot(lot, seller, input.lotId);
+        assertRouteStartsAtHub(input.chain, lot.hub, input.lotId);
+        return {
+            action,
+            trade,
+            lot,
+            state,
+            seller,
+            lotId,
+            returnTokenIds: input.chain.map((tokenId) => BigInt(tokenId)),
+            destinationTokenId: String(input.chain[input.chain.length - 1]),
+        };
+    }
+    async quoteOnChain(prepared) {
+        return this.tradeClient.quoteReturn({
+            trade: prepared.trade,
+            lotId: prepared.lotId,
+            returnTokenIds: prepared.returnTokenIds,
+            seller: prepared.seller,
+        });
+    }
+    async assessDestination(prepared, required) {
+        await this.mapReader.refresh();
+        const cell = await this.mapReader.readRevealCell(prepared.destinationTokenId);
+        if (cell === null) {
+            throw new Error(`Cell ${prepared.destinationTokenId} is not in the world map, so the room it has for the ` +
+                `remainder cannot be checked. Nothing was sent — retry shortly, or route the return to a ` +
+                `revealed cell of your own.`);
+        }
+        const projection = toProjectionConfig(prepared.action.config);
+        const emptyStorageCap = configuredStorageCap(prepared.lot.resource, usesHubShelf(cell.building, cell.ready, projection), projection);
+        return assessDestinationCapacity(cell, prepared.lot.resource, required, emptyStorageCap);
+    }
+    toQuoteView(prepared, quote, capacity) {
+        return {
+            lotId: prepared.lotId.toString(),
+            hubTokenId: prepared.lot.hub.toString(),
+            resourceId: prepared.lot.resource,
+            amount: quote.amount.toString(),
+            destinationTokenId: prepared.destinationTokenId,
+            maxTransitFee: cpuFromWei(quote.transitFee.toString()),
+            maxTransitFeeWei: quote.transitFee.toString(),
+            transitDiscount: cpuFromWei(quote.transitDiscount.toString()),
+            totalDistance: Number(quote.totalDistance),
+            arrivalAt: Number(quote.arrivalAt),
+            capacity,
+        };
+    }
+}
+//# sourceMappingURL=lot-return.service.js.map

package/dist/services/lot-return.service.js.map

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

package/dist/services/lot-return.types.d.ts

@@ -0,0 +1,19 @@
+import type { IAllowanceService, IAppConfig, ITradeClient, LotReturnInput, LotReturnQuote, LotReturnQuoteInput, LotReturnResult } from './types.js';
+import type { ILogger } from '../logger/types.js';
+import type { RevealCellReader } from '../map/types.js';
+import type { IContractClient, WalletProvider } from '../wallet/types.js';
+export interface LotReturnServiceOptions {
+    wallet: WalletProvider;
+    appConfig: IAppConfig;
+    allowance: IAllowanceService;
+    contracts: IContractClient;
+    tradeClient: ITradeClient;
+    mapReader: RevealCellReader;
+    logger: ILogger;
+}
+/** One player intent — send a lot's whole remainder home — quoted and then settled. */
+export interface ILotReturnService {
+    quoteReturn(input: LotReturnQuoteInput): Promise<LotReturnQuote>;
+    returnLot(input: LotReturnInput): Promise<LotReturnResult>;
+}
+//# sourceMappingURL=lot-return.types.d.ts.map

package/dist/services/lot-return.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-return.types.d.ts","sourceRoot":"","sources":["../../src/services/lot-return.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE1E,MAAM,WAAW,uBAAuB;IACpC,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,UAAU,CAAC;IACtB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,SAAS,EAAE,eAAe,CAAC;IAC3B,WAAW,EAAE,YAAY,CAAC;IAC1B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,uFAAuF;AACvF,MAAM,WAAW,iBAAiB;IAC9B,WAAW,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACjE,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC9D"}

package/dist/services/lot-return.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lot-return.types.js.map

package/dist/services/lot-return.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-return.types.js","sourceRoot":"","sources":["../../src/services/lot-return.types.ts"],"names":[],"mappings":""}

package/dist/services/lot-return.utils.d.ts

@@ -0,0 +1,33 @@
+import { type Address, type Log } from 'viem';
+import { LotReturnBranch, type DestinationCapacityView, type OnChainLot } from './types.js';
+import { LotState } from '../api/types.js';
+import type { ILogger } from '../logger/types.js';
+export declare function assertReturnRoute(chain: Array<number>): void;
+/**
+ * The chain is the arbiter of what a lot is: the projection can lag an eviction or a sell-out by a block,
+ * and a return sent against a stale state is a spend that reverts.
+ */
+export declare function assertReturnableLot(lot: OnChainLot, seller: Address, lotId: string): LotState;
+export declare function assertRouteStartsAtHub(chain: Array<number>, hub: bigint, lotId: string): void;
+/** A lot return is all-or-nothing; a quote for anything but the current remainder is a partial return. */
+export declare function assertWholeRemainder(quoted: bigint, remaining: bigint, lotId: string): void;
+/** The ceiling travels as wei precisely so nothing rounds it; a figure that is not whole wei is not a ceiling. */
+export declare function parseFeeCeilingWei(maxTransitFeeWei: string, lotId: string): bigint;
+/**
+ * The client half of the fee promise. Only the source hub's rate is pinned on-chain, at the figure recorded
+ * when the lot was listed, so any later waypoint can raise its own between the quote and this call. The
+ * ceiling itself does travel with the transaction and caps the whole route total there, but that backstop
+ * only fires once gas is committed: refusing here — before the allowance, before the transaction — is what
+ * makes a stale ceiling cost a re-quote instead of a reverted spend.
+ */
+export declare function assertFeeWithinCeiling(quotedWei: bigint, ceilingWei: bigint, lotId: string): void;
+export declare function returnBranchOf(state: LotState): LotReturnBranch;
+export declare function describeCapacityRefusal(capacity: DestinationCapacityView, destinationTokenId: string, lotId: string): string;
+export declare function describeLotReturnRevert(error: unknown, branch: LotReturnBranch): unknown;
+/**
+ * Both branches close the lot with the same lifecycle event. When a receipt carries none — a contract that
+ * settles a reclaim silently — the quote the contract itself just priced is the only honest figure left, and
+ * refusing to answer would report a settled return as a failure.
+ */
+export declare function decodeReturnedUnits(logs: Array<Log>, trade: Address, quoted: bigint, logger: ILogger): bigint;
+//# sourceMappingURL=lot-return.utils.d.ts.map

package/dist/services/lot-return.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-return.utils.d.ts","sourceRoot":"","sources":["../../src/services/lot-return.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAKpF,OAAO,EAAE,eAAe,EAAE,KAAK,uBAAuB,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAMlD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAc5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAiB7F;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQ7F;AAED,0GAA0G;AAC1G,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQ3F;AAED,kHAAkH;AAClH,wBAAgB,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAoBlF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAWjG;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,eAAe,CAE/D;AAED,wBAAgB,uBAAuB,CACnC,QAAQ,EAAE,uBAAuB,EACjC,kBAAkB,EAAE,MAAM,EAC1B,KAAK,EAAE,MAAM,GACd,MAAM,CAQR;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAWxF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAU7G"}

package/dist/services/lot-return.utils.js

@@ -0,0 +1,128 @@
+import { maxUint256, parseEventLogs } from 'viem';
+import { LOT_RETURN_REVERT_NAMES, LOT_RETURN_REVERT_REASONS } from './lot-return.constants.js';
+import { decodeKnownRevert } from './revert-decode.utils.js';
+import { lotStateFromChain } from './trade.helpers.js';
+import { LotReturnBranch } from './types.js';
+import { LotState } from '../api/types.js';
+import { TRADE_ABI } from '../contracts/trade.abi.js';
+import { TRANSPORT_ABI } from '../contracts/transport.abi.js';
+import { cpuFromWei } from '../utils/format.utils.js';
+import { WEI_STRING_PATTERN } from '../utils/wei.constants.js';
+const RETURN_ERROR_ABI = [...TRADE_ABI, ...TRANSPORT_ABI];
+export function assertReturnRoute(chain) {
+    if (chain.length < 2) {
+        throw new Error('A lot return needs the full route home: [hub, ...waypoints, your destination cell]. ' +
+            'Give at least the hub and one cell of your own.');
+    }
+    const seen = new Set();
+    for (const tokenId of chain) {
+        if (seen.has(tokenId)) {
+            throw new Error(`The route visits cell ${tokenId} twice; a lot return travels each cell once.`);
+        }
+        seen.add(tokenId);
+    }
+}
+/**
+ * The chain is the arbiter of what a lot is: the projection can lag an eviction or a sell-out by a block,
+ * and a return sent against a stale state is a spend that reverts.
+ */
+export function assertReturnableLot(lot, seller, lotId) {
+    const state = lotStateFromChain(lot.state);
+    if (state === null) {
+        throw new Error(`Lot ${lotId} is closed: it was sold out, already returned, or never existed. Nothing is left to send home.`);
+    }
+    if (lot.seller.toLowerCase() !== seller.toLowerCase()) {
+        throw new Error(`Lot ${lotId} is not yours — it belongs to ${lot.seller}. Only its seller can return it.`);
+    }
+    if (state !== LotState.Open && state !== LotState.Evicted) {
+        throw new Error(`Lot ${lotId} is ${state}: its escrow is still delivering to the hub. Finalize that delivery first — ` +
+            `only an open or an evicted lot can be sent home.`);
+    }
+    return state;
+}
+export function assertRouteStartsAtHub(chain, hub, lotId) {
+    const start = chain[0];
+    if (BigInt(start) !== hub) {
+        throw new Error(`The route must start at the lot's hub: lot ${lotId} sits on cell ${hub.toString()}, but the route ` +
+            `starts at ${String(start)}.`);
+    }
+}
+/** A lot return is all-or-nothing; a quote for anything but the current remainder is a partial return. */
+export function assertWholeRemainder(quoted, remaining, lotId) {
+    if (quoted !== remaining) {
+        throw new Error(`The return quote for lot ${lotId} covers ${quoted.toString()} units but the lot holds ` +
+            `${remaining.toString()}. A lot return always moves the whole remainder, so nothing was sent — ` +
+            `re-read the lot and quote it again.`);
+    }
+}
+/** The ceiling travels as wei precisely so nothing rounds it; a figure that is not whole wei is not a ceiling. */
+export function parseFeeCeilingWei(maxTransitFeeWei, lotId) {
+    if (!WEI_STRING_PATTERN.test(maxTransitFeeWei)) {
+        throw new Error(`The fee ceiling for lot ${lotId} must be a whole number of wei, but it reads ` +
+            `"${maxTransitFeeWei}". Quote the return with cpu_quote_lot_return and pass the ` +
+            `maxTransitFeeWei it answers with, unchanged — that field is already wei, not $CPU.`);
+    }
+    const ceiling = BigInt(maxTransitFeeWei);
+    // A padded ceiling is the way an agent tries to switch the guard off, and it cannot be encoded as the
+    // uint256 the contract takes: refusing it here keeps that failure off the allowance and off the chain.
+    if (ceiling > maxUint256) {
+        throw new Error(`The fee ceiling for lot ${lotId} reads ${maxTransitFeeWei} wei, past the uint256 maximum the ` +
+            `contract can hold, so nothing was approved and nothing was sent. The ceiling is a guard, not ` +
+            `a switch to turn off — quote the return with cpu_quote_lot_return and pass the ` +
+            `maxTransitFeeWei it answers with, unchanged.`);
+    }
+    return ceiling;
+}
+/**
+ * The client half of the fee promise. Only the source hub's rate is pinned on-chain, at the figure recorded
+ * when the lot was listed, so any later waypoint can raise its own between the quote and this call. The
+ * ceiling itself does travel with the transaction and caps the whole route total there, but that backstop
+ * only fires once gas is committed: refusing here — before the allowance, before the transaction — is what
+ * makes a stale ceiling cost a re-quote instead of a reverted spend.
+ */
+export function assertFeeWithinCeiling(quotedWei, ceilingWei, lotId) {
+    if (quotedWei <= ceilingWei) {
+        return;
+    }
+    throw new Error(`Returning lot ${lotId} now costs ${cpuFromWei(quotedWei.toString())} $CPU in transit ` +
+        `(${quotedWei.toString()} wei), above the ${cpuFromWei(ceilingWei.toString())} $CPU ceiling you ` +
+        `passed (${ceilingWei.toString()} wei): a fee on the route moved since that quote. Nothing was ` +
+        `approved and nothing was sent. Quote the return again with cpu_quote_lot_return and send it ` +
+        `straight away with the maxTransitFeeWei it answers with, or route around the cell that raised its rate.`);
+}
+export function returnBranchOf(state) {
+    return state === LotState.Evicted ? LotReturnBranch.Reclaimed : LotReturnBranch.Cancelled;
+}
+export function describeCapacityRefusal(capacity, destinationTokenId, lotId) {
+    const free = capacity.free ?? '0';
+    return (`Cell ${destinationTokenId} cannot take the whole remainder of lot ${lotId}: it needs room for ` +
+        `${capacity.required} units and only ${free} are free (what it already holds and everything reserved on ` +
+        `it are counted). Nothing was approved and nothing was sent. Free the space, or pick another destination ` +
+        `you own, then quote the return again.`);
+}
+export function describeLotReturnRevert(error, branch) {
+    const decoded = decodeKnownRevert(error, RETURN_ERROR_ABI, LOT_RETURN_REVERT_NAMES);
+    if (decoded === null) {
+        return error;
+    }
+    return new Error(`This lot return did not go through: ${LOT_RETURN_REVERT_REASONS[decoded.name]}. ` +
+        `The ${branch === LotReturnBranch.Reclaimed ? 'reclaim' : 'cancel'} was refused on-chain, so the lot ` +
+        `and its units are untouched.`, { cause: error });
+}
+/**
+ * Both branches close the lot with the same lifecycle event. When a receipt carries none — a contract that
+ * settles a reclaim silently — the quote the contract itself just priced is the only honest figure left, and
+ * refusing to answer would report a settled return as a failure.
+ */
+export function decodeReturnedUnits(logs, trade, quoted, logger) {
+    const events = parseEventLogs({ abi: TRADE_ABI, eventName: 'LotCancelled', logs });
+    const event = events.find((e) => e.address.toLowerCase() === trade.toLowerCase());
+    if (event === undefined) {
+        logger.warn('lot return confirmed without a lifecycle event; reporting the quoted remainder', {
+            quoted: quoted.toString(),
+        });
+        return quoted;
+    }
+    return event.args.returned;
+}
+//# sourceMappingURL=lot-return.utils.js.map

package/dist/services/lot-return.utils.js.map

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

package/dist/services/lot-terms.constants.d.ts

@@ -0,0 +1,4 @@
+export declare const WHOLE_UNITS_PATTERN: RegExp;
+export declare const LIVE_LOT_COUNT_NOTE = "delivering, open and evicted lots all count";
+export declare const EVICTED_BLOCK_NOTE: string;
+//# sourceMappingURL=lot-terms.constants.d.ts.map

package/dist/services/lot-terms.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-terms.constants.d.ts","sourceRoot":"","sources":["../../src/services/lot-terms.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,QAAU,CAAC;AAE3C,eAAO,MAAM,mBAAmB,gDAAgD,CAAC;AAEjF,eAAO,MAAM,kBAAkB,QAEqC,CAAC"}

package/dist/services/lot-terms.constants.js

@@ -0,0 +1,5 @@
+export const WHOLE_UNITS_PATTERN = /^\d+$/;
+export const LIVE_LOT_COUNT_NOTE = 'delivering, open and evicted lots all count';
+export const EVICTED_BLOCK_NOTE = 'an evicted lot keeps its per-seller slot until its remainder is on the way home, and it blocks every ' +
+    'resource on that hub while it waits; other hubs are unaffected';
+//# sourceMappingURL=lot-terms.constants.js.map

package/dist/services/lot-terms.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-terms.constants.js","sourceRoot":"","sources":["../../src/services/lot-terms.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAE3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,6CAA6C,CAAC;AAEjF,MAAM,CAAC,MAAM,kBAAkB,GAC3B,uGAAuG;IACvG,gEAAgE,CAAC"}

package/dist/services/lot-terms.helpers.d.ts

@@ -0,0 +1,11 @@
+export declare function parseListedValue(value: string): bigint | null;
+export declare function evictedPendingMessage(count: number, hubTokenId: string): string;
+export declare function invalidValueMessage(value: string): string;
+export declare function invalidPriceMessage(pricePerUnit: string): string;
+export declare function priceBelowFloorMessage(pricePerUnit: string, floor: string): string;
+export declare function emptyWindowMessage(hubTokenId: string, resourceId: number, min: string, max: string): string;
+export declare function belowMinimumMessage(value: string, min: string, hubTokenId: string, resourceId: number): string;
+export declare function aboveMaximumMessage(value: string, max: string, hubTokenId: string, resourceId: number): string;
+export declare function sellerLotLimitMessage(count: number, limit: number, hubTokenId: string, resourceId: number): string;
+export declare function saleFeeToleranceMessage(livePercent: number, tolerancePercent: number, hubTokenId: string): string;
+//# sourceMappingURL=lot-terms.helpers.d.ts.map

package/dist/services/lot-terms.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-terms.helpers.d.ts","sourceRoot":"","sources":["../../src/services/lot-terms.helpers.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAM/E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKlF;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAM3G;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK9G;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK9G;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAKlH;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAKjH"}

package/dist/services/lot-terms.helpers.js

@@ -0,0 +1,45 @@
+import { EVICTED_BLOCK_NOTE, LIVE_LOT_COUNT_NOTE, WHOLE_UNITS_PATTERN } from './lot-terms.constants.js';
+export function parseListedValue(value) {
+    if (!WHOLE_UNITS_PATTERN.test(value)) {
+        return null;
+    }
+    const units = BigInt(value);
+    return units > 0n ? units : null;
+}
+export function evictedPendingMessage(count, hubTokenId) {
+    return (`You still owe ${count} evicted lot return${count === 1 ? '' : 's'} on hub ${hubTokenId}, so this hub ` +
+        `refuses every new lot of yours. Schedule the return of each evicted remainder there — ` +
+        `${EVICTED_BLOCK_NOTE}.`);
+}
+export function invalidValueMessage(value) {
+    return `A lot needs a positive whole number of units; "${value}" is not one.`;
+}
+export function invalidPriceMessage(pricePerUnit) {
+    return `An asking price must be a positive $CPU amount per unit; "${pricePerUnit}" is not one.`;
+}
+export function priceBelowFloorMessage(pricePerUnit, floor) {
+    return (`Asking ${pricePerUnit} $CPU per unit is below the live floor of ${floor} $CPU per unit. ` +
+        `Ask ${floor} or more.`);
+}
+export function emptyWindowMessage(hubTokenId, resourceId, min, max) {
+    return (`Hub ${hubTokenId} has no listing window for resource #${resourceId} right now: its live minimum is ` +
+        `${min} units and its live maximum is ${max} units, so no amount fits. List on another hub, or wait ` +
+        `for this hub's storage for that resource to change.`);
+}
+export function belowMinimumMessage(value, min, hubTokenId, resourceId) {
+    return (`A lot of ${value} units is below the live minimum of ${min} units for resource #${resourceId} on hub ` +
+        `${hubTokenId}. List at least ${min} units, or pick a hub with a lower minimum.`);
+}
+export function aboveMaximumMessage(value, max, hubTokenId, resourceId) {
+    return (`A lot of ${value} units is above the live maximum of ${max} units for resource #${resourceId} on hub ` +
+        `${hubTokenId}. List at most ${max} units, and sell the rest in a later lot or on another hub.`);
+}
+export function sellerLotLimitMessage(count, limit, hubTokenId, resourceId) {
+    return (`You already hold ${count} of ${limit} live lots for resource #${resourceId} on hub ${hubTokenId} — ` +
+        `${LIVE_LOT_COUNT_NOTE}. Wait for one to sell out, or return one remainder home, before listing another.`);
+}
+export function saleFeeToleranceMessage(livePercent, tolerancePercent, hubTokenId) {
+    return (`Hub ${hubTokenId} charges ${livePercent}% sale fee, above your tolerance of ${tolerancePercent}%. ` +
+        `Raise maxSaleFeePercent to ${livePercent} or more, or list on a cheaper hub.`);
+}
+//# sourceMappingURL=lot-terms.helpers.js.map

package/dist/services/lot-terms.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-terms.helpers.js","sourceRoot":"","sources":["../../src/services/lot-terms.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAExG,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC1C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,UAAkB;IACnE,OAAO,CACH,iBAAiB,KAAK,sBAAsB,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,UAAU,gBAAgB;QACvG,wFAAwF;QACxF,GAAG,kBAAkB,GAAG,CAC3B,CAAC;AACN,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC7C,OAAO,kDAAkD,KAAK,eAAe,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACpD,OAAO,6DAA6D,YAAY,eAAe,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,YAAoB,EAAE,KAAa;IACtE,OAAO,CACH,UAAU,YAAY,6CAA6C,KAAK,kBAAkB;QAC1F,OAAO,KAAK,WAAW,CAC1B,CAAC;AACN,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,UAAkB,EAAE,GAAW,EAAE,GAAW;IAC/F,OAAO,CACH,OAAO,UAAU,wCAAwC,UAAU,kCAAkC;QACrG,GAAG,GAAG,kCAAkC,GAAG,0DAA0D;QACrG,qDAAqD,CACxD,CAAC;AACN,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,GAAW,EAAE,UAAkB,EAAE,UAAkB;IAClG,OAAO,CACH,YAAY,KAAK,uCAAuC,GAAG,wBAAwB,UAAU,UAAU;QACvG,GAAG,UAAU,mBAAmB,GAAG,6CAA6C,CACnF,CAAC;AACN,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,GAAW,EAAE,UAAkB,EAAE,UAAkB;IAClG,OAAO,CACH,YAAY,KAAK,uCAAuC,GAAG,wBAAwB,UAAU,UAAU;QACvG,GAAG,UAAU,kBAAkB,GAAG,6DAA6D,CAClG,CAAC;AACN,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,KAAa,EAAE,UAAkB,EAAE,UAAkB;IACtG,OAAO,CACH,oBAAoB,KAAK,OAAO,KAAK,4BAA4B,UAAU,WAAW,UAAU,KAAK;QACrG,GAAG,mBAAmB,mFAAmF,CAC5G,CAAC;AACN,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAmB,EAAE,gBAAwB,EAAE,UAAkB;IACrG,OAAO,CACH,OAAO,UAAU,YAAY,WAAW,uCAAuC,gBAAgB,KAAK;QACpG,8BAA8B,WAAW,qCAAqC,CACjF,CAAC;AACN,CAAC"}

package/dist/services/lot-terms.service.d.ts

@@ -0,0 +1,20 @@
+import type { ILotTerms, ListingPreflightInput, LotTermsServiceOptions } from './lot-terms.types.js';
+import { type LotTermsInput, type LotTermsResult } from './types.js';
+/**
+ * The listing terms of one hub and resource, and the gate `cpu_create_lot` passes through. The window is
+ * read from the contract's own bound views and never worked out from the configured shares, and every
+ * deterministic refusal happens here — before the allowance and before the transaction — so a listing the
+ * contract already refuses never costs the seller an approval or gas.
+ */
+export declare class LotTermsService implements ILotTerms {
+    private readonly appConfig;
+    private readonly wallet;
+    private readonly tradeClient;
+    private readonly logger;
+    constructor(options: LotTermsServiceOptions);
+    getLotTerms(input: LotTermsInput): Promise<LotTermsResult>;
+    assertListingAllowed(input: ListingPreflightInput): Promise<LotTermsResult>;
+    private readLiveTerms;
+    private parsePrice;
+}
+//# sourceMappingURL=lot-terms.service.d.ts.map

package/dist/services/lot-terms.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-terms.service.d.ts","sourceRoot":"","sources":["../../src/services/lot-terms.service.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAGrG,OAAO,EAIH,KAAK,aAAa,EAClB,KAAK,cAAc,EAEtB,MAAM,YAAY,CAAC;AAYpB;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,EAAE,sBAAsB;IAOrC,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAI1D,oBAAoB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;YA2CnE,aAAa;IAkD3B,OAAO,CAAC,UAAU;CAQrB"}

package/dist/services/lot-terms.service.js

@@ -0,0 +1,119 @@
+import { formatEther, parseEther } from 'viem';
+import { aboveMaximumMessage, belowMinimumMessage, emptyWindowMessage, evictedPendingMessage, invalidPriceMessage, invalidValueMessage, parseListedValue, priceBelowFloorMessage, saleFeeToleranceMessage, sellerLotLimitMessage, } from './lot-terms.helpers.js';
+import { preparePaidAction } from './paid-action.js';
+import { AppContract } from './paid-action.types.js';
+import { LotListingBlocker, } from './types.js';
+import { bpToPercent } from '../utils/format.utils.js';
+/**
+ * The listing terms of one hub and resource, and the gate `cpu_create_lot` passes through. The window is
+ * read from the contract's own bound views and never worked out from the configured shares, and every
+ * deterministic refusal happens here — before the allowance and before the transaction — so a listing the
+ * contract already refuses never costs the seller an approval or gas.
+ */
+export class LotTermsService {
+    appConfig;
+    wallet;
+    tradeClient;
+    logger;
+    constructor(options) {
+        this.appConfig = options.appConfig;
+        this.wallet = options.wallet;
+        this.tradeClient = options.tradeClient;
+        this.logger = options.logger;
+    }
+    async getLotTerms(input) {
+        return (await this.readLiveTerms(input.hubTokenId, input.resourceId)).terms;
+    }
+    async assertListingAllowed(input) {
+        const { terms, config, trade, hub } = await this.readLiveTerms(input.hubTokenId, input.resourceId);
+        const { hubTokenId, resourceId } = input;
+        if (terms.outstandingEvictedCount > 0) {
+            throw new Error(evictedPendingMessage(terms.outstandingEvictedCount, hubTokenId));
+        }
+        const value = parseListedValue(input.value);
+        if (value === null) {
+            throw new Error(invalidValueMessage(input.value));
+        }
+        const price = this.parsePrice(input.pricePerUnit);
+        if (price === null) {
+            throw new Error(invalidPriceMessage(input.pricePerUnit));
+        }
+        if (price < config.minPricePerUnit) {
+            throw new Error(priceBelowFloorMessage(input.pricePerUnit, formatEther(config.minPricePerUnit)));
+        }
+        if (terms.blockers.includes(LotListingBlocker.EmptyWindow)) {
+            throw new Error(emptyWindowMessage(hubTokenId, resourceId, terms.effectiveMin, terms.effectiveMax));
+        }
+        if (value < BigInt(terms.effectiveMin)) {
+            throw new Error(belowMinimumMessage(input.value, terms.effectiveMin, hubTokenId, resourceId));
+        }
+        if (value > BigInt(terms.effectiveMax)) {
+            throw new Error(aboveMaximumMessage(input.value, terms.effectiveMax, hubTokenId, resourceId));
+        }
+        if (terms.blockers.includes(LotListingBlocker.SellerLotLimit)) {
+            throw new Error(sellerLotLimitMessage(terms.sellerLotCount, terms.sellerLotLimit, hubTokenId, resourceId));
+        }
+        if (input.maxSaleFeePercent !== null) {
+            const livePercent = bpToPercent(await this.tradeClient.getSaleFee({ trade, hub, res: resourceId }));
+            if (livePercent > input.maxSaleFeePercent) {
+                throw new Error(saleFeeToleranceMessage(livePercent, input.maxSaleFeePercent, hubTokenId));
+            }
+        }
+        return terms;
+    }
+    async readLiveTerms(hubTokenId, resourceId) {
+        const action = await preparePaidAction({ appConfig: this.appConfig, wallet: this.wallet });
+        const trade = action.requireContract(AppContract.Trade, 'cannot read the lot listing terms');
+        const seller = action.wallet.getAddress();
+        const hub = BigInt(hubTokenId);
+        const evicted = await this.tradeClient.getSellerEvictedCount({ trade, seller, hub });
+        const config = await this.tradeClient.getConfig({ trade });
+        const min = await this.tradeClient.getMinLotValue({ trade, hub, res: resourceId });
+        const max = await this.tradeClient.getMaxLotValue({ trade, hub, res: resourceId });
+        const lotCount = await this.tradeClient.getSellerLotCount({ trade, seller, hub, res: resourceId });
+        const blockers = [];
+        if (evicted > 0n) {
+            blockers.push(LotListingBlocker.EvictedPending);
+        }
+        if (max === 0n || min > max) {
+            blockers.push(LotListingBlocker.EmptyWindow);
+        }
+        if (lotCount >= BigInt(config.maxLotsPerSellerResource)) {
+            blockers.push(LotListingBlocker.SellerLotLimit);
+        }
+        this.logger.info('read lot terms', {
+            hubTokenId,
+            resourceId,
+            effectiveMin: min.toString(),
+            effectiveMax: max.toString(),
+            blockers,
+        });
+        return {
+            trade,
+            hub,
+            config,
+            terms: {
+                hubTokenId,
+                resourceId,
+                sellerAddress: seller,
+                effectiveMin: min.toString(),
+                effectiveMax: max.toString(),
+                sellerLotCount: Number(lotCount),
+                sellerLotLimit: config.maxLotsPerSellerResource,
+                outstandingEvictedCount: Number(evicted),
+                canList: blockers.length === 0,
+                blockers,
+            },
+        };
+    }
+    parsePrice(pricePerUnit) {
+        try {
+            const wei = parseEther(pricePerUnit);
+            return wei > 0n ? wei : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=lot-terms.service.js.map

package/dist/services/lot-terms.service.js.map

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