project-cpu-mcp 0.10.0 → 0.12.0

package/dist/services/trade-eviction.service.js

@@ -0,0 +1,101 @@
+import { parseEventLogs } from 'viem';
+import { preparePaidAction } from './paid-action.js';
+import { AppContract } from './paid-action.types.js';
+import { EVICTION_TX_LABEL } from './trade-eviction.constants.js';
+import { enrichEvictionRevert, hubNotInMapMessage, lotAlreadyEvictedMessage, lotDeliveringMessage, lotNotLiveMessage, notHubOwnerMessage, selfEvictionMessage, } from './trade-eviction.utils.js';
+import { lotStateFromChain } from './trade.helpers.js';
+import { LotState } from '../api/types.js';
+import { TRADE_ABI } from '../contracts/trade.abi.js';
+import { sameAddress } from '../randomness/request.utils.js';
+/**
+ * A hub owner ending one foreign Open lot on their own hub. Eviction is the narrowest write in Trade: it
+ * takes the shelf back and nothing else — no route, no escrow, no transfer — so this service holds no
+ * transport, allowance or delivery dependency at all, and the lot's units stay the seller's and stay
+ * escrowed until the seller ships them home themselves.
+ */
+export class LotEvictionService {
+    wallet;
+    appConfig;
+    tradeClient;
+    contracts;
+    mapReader;
+    logger;
+    constructor(options) {
+        this.wallet = options.wallet;
+        this.appConfig = options.appConfig;
+        this.tradeClient = options.tradeClient;
+        this.contracts = options.contracts;
+        this.mapReader = options.mapReader;
+        this.logger = options.logger;
+    }
+    async evictLot(input) {
+        const action = await preparePaidAction({ appConfig: this.appConfig, wallet: this.wallet });
+        const trade = action.requireContract(AppContract.Trade, 'cannot evict a lot');
+        const caller = action.wallet.getAddress();
+        const lotId = BigInt(input.lotId);
+        const lot = await this.tradeClient.getLot({ trade, lotId });
+        this.assertForeignOpenLot(input.lotId, lot, caller);
+        await this.assertHubOwner(input.lotId, lot, caller);
+        this.logger.info('evicting lot', {
+            lotId: input.lotId,
+            hub: lot.hub.toString(),
+            network: action.config.network,
+        });
+        const confirmed = await this.submit(trade, lotId, input.lotId);
+        const evicted = parseEventLogs({ abi: TRADE_ABI, eventName: 'LotEvicted', logs: confirmed.logs }).find((event) => sameAddress(event.address, trade));
+        if (evicted === undefined) {
+            throw new Error(`The eviction of lot ${input.lotId} confirmed but Trade emitted no LotEvicted event; the lot's ` +
+                `state is unproven. Re-read it with cpu_get_lot before acting on it.`);
+        }
+        return {
+            lotId: evicted.args.lotId.toString(),
+            hubTokenId: lot.hub.toString(),
+            sellerAddress: evicted.args.seller,
+            resourceId: lot.resource,
+            remaining: evicted.args.remaining.toString(),
+            state: LotState.Evicted,
+            txHash: confirmed.txHash,
+            status: confirmed.status,
+            blockNumber: confirmed.blockNumber,
+        };
+    }
+    assertForeignOpenLot(lotId, lot, caller) {
+        const state = lotStateFromChain(lot.state);
+        const hubTokenId = lot.hub.toString();
+        if (state === null) {
+            throw new Error(lotNotLiveMessage(lotId));
+        }
+        if (state === LotState.Delivering) {
+            throw new Error(lotDeliveringMessage(lotId, hubTokenId));
+        }
+        if (state === LotState.Evicted) {
+            throw new Error(lotAlreadyEvictedMessage(lotId, hubTokenId));
+        }
+        if (sameAddress(lot.seller, caller)) {
+            throw new Error(selfEvictionMessage(lotId));
+        }
+    }
+    // The local snapshot is refreshed first: eviction is admitted on ownership, and a cached hub that has
+    // since changed hands would let the call through to a guaranteed on-chain refusal.
+    async assertHubOwner(lotId, lot, caller) {
+        await this.mapReader.refresh();
+        const hubTokenId = lot.hub.toString();
+        const hub = await this.mapReader.readRevealCell(hubTokenId);
+        if (hub === null) {
+            throw new Error(hubNotInMapMessage(lotId, hubTokenId));
+        }
+        if (!sameAddress(hub.owner, caller)) {
+            throw new Error(notHubOwnerMessage(lotId, hubTokenId, hub.owner));
+        }
+    }
+    async submit(trade, lotId, label) {
+        try {
+            const txHash = await this.tradeClient.evict({ trade, lotId });
+            return await this.contracts.confirm(txHash, `${EVICTION_TX_LABEL} ${label}`);
+        }
+        catch (error) {
+            throw enrichEvictionRevert(error, label);
+        }
+    }
+}
+//# sourceMappingURL=trade-eviction.service.js.map

package/dist/services/trade-eviction.service.js.map

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

package/dist/services/trade-eviction.types.d.ts

@@ -0,0 +1,30 @@
+import type { Hash } from 'viem';
+import type { EvictLotInput, EvictLotResult, EvictLotParams, GetLotParams, IAppConfig, OnChainLot } from './types.js';
+import type { ILogger } from '../logger/types.js';
+import type { RevealCellReader } from '../map/types.js';
+import type { ConfirmedTx, WalletProvider } from '../wallet/types.js';
+/**
+ * Deliberately narrower than `ITradeClient`: eviction must never be able to reach `buy`, `cancel`,
+ * `reclaim` or `createLot`, and a service that cannot name them cannot move a unit of anyone's goods.
+ */
+export interface ILotEvictionClient {
+    getLot(params: GetLotParams): Promise<OnChainLot>;
+    evict(params: EvictLotParams): Promise<Hash>;
+}
+/** The receipt half of the contract client; eviction sends only through `ILotEvictionClient`. */
+export interface ILotEvictionConfirmer {
+    confirm(txHash: Hash, revertLabel: string): Promise<ConfirmedTx>;
+}
+export interface LotEvictionServiceOptions {
+    wallet: WalletProvider;
+    appConfig: IAppConfig;
+    tradeClient: ILotEvictionClient;
+    contracts: ILotEvictionConfirmer;
+    mapReader: RevealCellReader;
+    logger: ILogger;
+}
+/** One hub owner ending one foreign Open lot — implemented by LotEvictionService. */
+export interface ILotEviction {
+    evictLot(input: EvictLotInput): Promise<EvictLotResult>;
+}
+//# sourceMappingURL=trade-eviction.types.d.ts.map

package/dist/services/trade-eviction.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade-eviction.types.d.ts","sourceRoot":"","sources":["../../src/services/trade-eviction.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClD,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,iGAAiG;AACjG,MAAM,WAAW,qBAAqB;IAClC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,yBAAyB;IACtC,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,UAAU,CAAC;IACtB,WAAW,EAAE,kBAAkB,CAAC;IAChC,SAAS,EAAE,qBAAqB,CAAC;IACjC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,qFAAqF;AACrF,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC3D"}

package/dist/services/trade-eviction.types.js

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

package/dist/services/trade-eviction.types.js.map

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

package/dist/services/trade-eviction.utils.d.ts

@@ -0,0 +1,9 @@
+export declare function lotNotLiveMessage(lotId: string): string;
+export declare function lotDeliveringMessage(lotId: string, hubTokenId: string): string;
+export declare function lotAlreadyEvictedMessage(lotId: string, hubTokenId: string): string;
+export declare function selfEvictionMessage(lotId: string): string;
+export declare function hubNotInMapMessage(lotId: string, hubTokenId: string): string;
+export declare function notHubOwnerMessage(lotId: string, hubTokenId: string, owner: string): string;
+/** Names the on-chain refusal in the agent's own vocabulary; an undecoded revert travels unchanged. */
+export declare function enrichEvictionRevert(error: unknown, lotId: string): unknown;
+//# sourceMappingURL=trade-eviction.utils.d.ts.map

package/dist/services/trade-eviction.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade-eviction.utils.d.ts","sourceRoot":"","sources":["../../src/services/trade-eviction.utils.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAM9E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAKlF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK3F;AAED,uGAAuG;AACvG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAS3E"}

package/dist/services/trade-eviction.utils.js

@@ -0,0 +1,38 @@
+import { EVICTION_REVERT_REASONS, EVICTION_SLOT_NOTE, LOT_RETURN_TOOL } from './trade-eviction.constants.js';
+export function lotNotLiveMessage(lotId) {
+    return (`The Trade contract holds no live lot ${lotId}: it sold out, was cancelled, or its remainder has already ` +
+        `gone home. There is nothing to evict.`);
+}
+export function lotDeliveringMessage(lotId, hubTokenId) {
+    return (`Lot ${lotId} is still delivering into Hub ${hubTokenId} — its escrow has not arrived yet. Only an open lot ` +
+        `can be evicted, and eviction never finalizes a delivery on the seller's behalf. Wait for the escrow to ` +
+        `land (the seller finalizes it), re-read the lot with cpu_get_lot, and evict once it is open.`);
+}
+export function lotAlreadyEvictedMessage(lotId, hubTokenId) {
+    return (`Lot ${lotId} on Hub ${hubTokenId} is already evicted, so evicting it again would change nothing. ` +
+        `${EVICTION_SLOT_NOTE} Only the seller can move those units, with a lot return (${LOT_RETURN_TOOL}).`);
+}
+export function selfEvictionMessage(lotId) {
+    return (`Lot ${lotId} is your own lot, and eviction only ever ends someone else's. To take your own remainder off ` +
+        `the shelf and ship it home, use a lot return (${LOT_RETURN_TOOL}) with the route you want it to travel.`);
+}
+export function hubNotInMapMessage(lotId, hubTokenId) {
+    return (`Hub ${hubTokenId}, which carries lot ${lotId}, is not in the current map, so your ownership of it cannot ` +
+        `be verified. Only the hub owner may evict a lot from it.`);
+}
+export function notHubOwnerMessage(lotId, hubTokenId, owner) {
+    return (`Only the hub owner can evict a lot from Hub ${hubTokenId} (owner ${owner}), and lot ${lotId} sits there. ` +
+        `Eviction is a hub owner's control over their own storage, never a way to reach another player's goods.`);
+}
+/** Names the on-chain refusal in the agent's own vocabulary; an undecoded revert travels unchanged. */
+export function enrichEvictionRevert(error, lotId) {
+    if (!(error instanceof Error)) {
+        return error;
+    }
+    const match = EVICTION_REVERT_REASONS.find((entry) => error.message.includes(entry.name));
+    if (match === undefined) {
+        return error;
+    }
+    return new Error(`${error.message} — lot ${lotId} was not evicted: ${match.reason}.`, { cause: error });
+}
+//# sourceMappingURL=trade-eviction.utils.js.map

package/dist/services/trade-eviction.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade-eviction.utils.js","sourceRoot":"","sources":["../../src/services/trade-eviction.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAE7G,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC3C,OAAO,CACH,wCAAwC,KAAK,6DAA6D;QAC1G,uCAAuC,CAC1C,CAAC;AACN,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,UAAkB;IAClE,OAAO,CACH,OAAO,KAAK,iCAAiC,UAAU,sDAAsD;QAC7G,yGAAyG;QACzG,8FAA8F,CACjG,CAAC;AACN,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAa,EAAE,UAAkB;IACtE,OAAO,CACH,OAAO,KAAK,WAAW,UAAU,kEAAkE;QACnG,GAAG,kBAAkB,6DAA6D,eAAe,IAAI,CACxG,CAAC;AACN,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC7C,OAAO,CACH,OAAO,KAAK,+FAA+F;QAC3G,iDAAiD,eAAe,yCAAyC,CAC5G,CAAC;AACN,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,UAAkB;IAChE,OAAO,CACH,OAAO,UAAU,uBAAuB,KAAK,8DAA8D;QAC3G,0DAA0D,CAC7D,CAAC;AACN,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,UAAkB,EAAE,KAAa;IAC/E,OAAO,CACH,+CAA+C,UAAU,WAAW,KAAK,cAAc,KAAK,eAAe;QAC3G,wGAAwG,CAC3G,CAAC;AACN,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,KAAa;IAC9D,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1F,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC,OAAO,UAAU,KAAK,qBAAqB,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5G,CAAC"}

package/dist/services/trade-rules.service.d.ts

@@ -0,0 +1,15 @@
+import type { ITradeRules, LotListingRulesView, TradeRulesServiceOptions } from './types.js';
+/**
+ * The listing rules live only on the deployed Trade contract — the game API's config projects the fee
+ * parameters, not the lot window. Reading them is therefore a chain call, and the rulebook read that
+ * carries them must survive a chain it cannot reach: an unavailable answer is null, never a guess.
+ */
+export declare class TradeRulesService implements ITradeRules {
+    private readonly appConfig;
+    private readonly wallet;
+    private readonly tradeClient;
+    private readonly logger;
+    constructor(options: TradeRulesServiceOptions);
+    loadLotListingRules(): Promise<LotListingRulesView | null>;
+}
+//# sourceMappingURL=trade-rules.service.d.ts.map

package/dist/services/trade-rules.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade-rules.service.d.ts","sourceRoot":"","sources":["../../src/services/trade-rules.service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA4B,WAAW,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAMvH;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACjD,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,wBAAwB;IAOvC,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;CAqBnE"}

package/dist/services/trade-rules.service.js

@@ -0,0 +1,45 @@
+import { formatEther } from 'viem';
+import { preparePaidAction } from './paid-action.js';
+import { AppContract } from './paid-action.types.js';
+import { errorMessage } from '../utils/error.utils.js';
+import { bpToPercent } from '../utils/format.utils.js';
+/**
+ * The listing rules live only on the deployed Trade contract — the game API's config projects the fee
+ * parameters, not the lot window. Reading them is therefore a chain call, and the rulebook read that
+ * carries them must survive a chain it cannot reach: an unavailable answer is null, never a guess.
+ */
+export class TradeRulesService {
+    appConfig;
+    wallet;
+    tradeClient;
+    logger;
+    constructor(options) {
+        this.appConfig = options.appConfig;
+        this.wallet = options.wallet;
+        this.tradeClient = options.tradeClient;
+        this.logger = options.logger;
+    }
+    async loadLotListingRules() {
+        if (!this.wallet.isReady()) {
+            return null;
+        }
+        try {
+            const action = await preparePaidAction({ appConfig: this.appConfig, wallet: this.wallet });
+            const trade = action.requireContract(AppContract.Trade, 'cannot read the lot listing rules');
+            const config = await this.tradeClient.getConfig({ trade });
+            return {
+                minLotSharePercent: bpToPercent(config.minLotShareBp),
+                maxLotSharePercent: bpToPercent(config.maxLotShareBp),
+                minUncappedLotValue: config.minUncappedLotValue.toString(),
+                maxUncappedLotValue: config.maxUncappedLotValue.toString(),
+                maxLotsPerSellerHubResource: config.maxLotsPerSellerResource,
+                minPricePerUnit: formatEther(config.minPricePerUnit),
+            };
+        }
+        catch (error) {
+            this.logger.warn('could not read the lot listing rules', { error: errorMessage(error) });
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=trade-rules.service.js.map

package/dist/services/trade-rules.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade-rules.service.js","sourceRoot":"","sources":["../../src/services/trade-rules.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IACT,SAAS,CAAa;IACtB,MAAM,CAAiB;IACvB,WAAW,CAAe;IAC1B,MAAM,CAAU;IAEjC,YAAY,OAAiC;QACzC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,mBAAmB;QACrB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3F,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,CAAC,WAAW,CAAC,KAAK,EAAE,mCAAmC,CAAC,CAAC;YAC7F,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3D,OAAO;gBACH,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC;gBACrD,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC;gBACrD,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE;gBAC1D,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE;gBAC1D,2BAA2B,EAAE,MAAM,CAAC,wBAAwB;gBAC5D,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,eAAe,CAAC;aACvD,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzF,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;CACJ"}

package/dist/services/trade.client.d.ts

@@ -1,5 +1,5 @@
 import { type Hash } from 'viem';
-import type { BuyLotParams, BuyQuoteResult, CancelLotParams, CreateLotParams, GetSaleFeeParams, ITradeClient, QuoteBuyParams, QuoteSaleParams, SaleQuoteResult, SetSaleFeeParams, TradeClientOptions } from './types.js';
+import type { BuyLotParams, BuyQuoteResult, CancelLotParams, CreateLotParams, EvictLotParams, GetLotParams, GetLotsParams, GetSaleFeeParams, GetTradeConfigParams, ITradeClient, LotBoundParams, OnChainLot, OnChainTradeConfig, QuoteBuyParams, QuoteReturnParams, QuoteSaleParams, ReclaimLotParams, ReturnQuoteResult, SaleQuoteResult, SellerEvictedCountParams, SellerLotCountParams, SetSaleFeeParams, TradeClientOptions } from './types.js';
 export declare class TradeClient implements ITradeClient {
     private readonly contracts;
     private readonly logger;
@@ -7,8 +7,18 @@ export declare class TradeClient implements ITradeClient {
     createLot(params: CreateLotParams): Promise<Hash>;
     buy(params: BuyLotParams): Promise<Hash>;
     cancel(params: CancelLotParams): Promise<Hash>;
+    reclaim(params: ReclaimLotParams): Promise<Hash>;
+    evict(params: EvictLotParams): Promise<Hash>;
     setSaleFee(params: SetSaleFeeParams): Promise<Hash>;
     getSaleFee(params: GetSaleFeeParams): Promise<number>;
+    getLot(params: GetLotParams): Promise<OnChainLot>;
+    getLots(params: GetLotsParams): Promise<Array<OnChainLot>>;
+    getConfig(params: GetTradeConfigParams): Promise<OnChainTradeConfig>;
+    getMinLotValue(params: LotBoundParams): Promise<bigint>;
+    getMaxLotValue(params: LotBoundParams): Promise<bigint>;
+    getSellerLotCount(params: SellerLotCountParams): Promise<bigint>;
+    getSellerEvictedCount(params: SellerEvictedCountParams): Promise<bigint>;
+    quoteReturn(params: QuoteReturnParams): Promise<ReturnQuoteResult>;
     quoteSale(params: QuoteSaleParams): Promise<SaleQuoteResult>;
     quoteBuy(params: QuoteBuyParams): Promise<BuyQuoteResult>;
 }

package/dist/services/trade.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trade.client.d.ts","sourceRoot":"","sources":["../../src/services/trade.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AAGrD,OAAO,KAAK,EACR,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EACrB,MAAM,YAAY,CAAC;AAKpB,qBAAa,WAAY,YAAW,YAAY;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,EAAE,kBAAkB;IAKjC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjD,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAexC,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9C,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAenD,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAUrD,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAa5D,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;CAYlE"}
+{"version":3,"file":"trade.client.d.ts","sourceRoot":"","sources":["../../src/services/trade.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AAGrD,OAAO,KAAK,EACR,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EACrB,MAAM,YAAY,CAAC;AAKpB,qBAAa,WAAY,YAAW,YAAY;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,EAAE,kBAAkB;IAKjC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjD,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAexC,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9C,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAchD,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAenD,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAUrD,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IASjD,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAS1D,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IASpE,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IASvD,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IASvD,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAShE,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC;IASxE,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAalE,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAa5D,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;CAYlE"}

package/dist/services/trade.client.js

@@ -51,6 +51,24 @@ export class TradeClient {
         });
         return this.contracts.send({ to: params.trade, data, value: null, gas: null }, TRADE_ABI);
     }
+    async reclaim(params) {
+        const data = encodeFunctionData({
+            abi: TRADE_ABI,
+            functionName: 'reclaim',
+            args: [params.lotId, params.returnTokenIds, params.maxFee],
+        });
+        this.logger.info('submitting reclaim lot', {
+            trade: params.trade,
+            lotId: params.lotId.toString(),
+            maxFeeWei: params.maxFee.toString(),
+        });
+        return this.contracts.send({ to: params.trade, data, value: null, gas: null }, TRADE_ABI);
+    }
+    async evict(params) {
+        const data = encodeFunctionData({ abi: TRADE_ABI, functionName: 'evict', args: [params.lotId] });
+        this.logger.info('submitting evict lot', { trade: params.trade, lotId: params.lotId.toString() });
+        return this.contracts.send({ to: params.trade, data, value: null, gas: null }, TRADE_ABI);
+    }
     async setSaleFee(params) {
         const data = encodeFunctionData({
             abi: TRADE_ABI,
@@ -74,6 +92,75 @@ export class TradeClient {
         });
         return Number(feeBp);
     }
+    async getLot(params) {
+        return this.contracts.read({
+            address: params.trade,
+            abi: TRADE_ABI,
+            functionName: 'getLot',
+            args: [params.lotId],
+        });
+    }
+    async getLots(params) {
+        return this.contracts.read({
+            address: params.trade,
+            abi: TRADE_ABI,
+            functionName: 'getLots',
+            args: [params.lotIds],
+        });
+    }
+    async getConfig(params) {
+        return this.contracts.read({
+            address: params.trade,
+            abi: TRADE_ABI,
+            functionName: 'getConfig',
+            args: [],
+        });
+    }
+    async getMinLotValue(params) {
+        return this.contracts.read({
+            address: params.trade,
+            abi: TRADE_ABI,
+            functionName: 'getMinLotValue',
+            args: [params.hub, params.res],
+        });
+    }
+    async getMaxLotValue(params) {
+        return this.contracts.read({
+            address: params.trade,
+            abi: TRADE_ABI,
+            functionName: 'getMaxLotValue',
+            args: [params.hub, params.res],
+        });
+    }
+    async getSellerLotCount(params) {
+        return this.contracts.read({
+            address: params.trade,
+            abi: TRADE_ABI,
+            functionName: 'getSellerLotCount',
+            args: [params.seller, params.hub, params.res],
+        });
+    }
+    async getSellerEvictedCount(params) {
+        return this.contracts.read({
+            address: params.trade,
+            abi: TRADE_ABI,
+            functionName: 'getSellerEvictedCount',
+            args: [params.seller, params.hub],
+        });
+    }
+    async quoteReturn(params) {
+        try {
+            return await this.contracts.read({
+                address: params.trade,
+                abi: TRADE_ABI,
+                functionName: 'quoteReturn',
+                args: [params.lotId, params.returnTokenIds, params.seller],
+            });
+        }
+        catch (error) {
+            throw namedQuoteRevert(error);
+        }
+    }
     async quoteSale(params) {
         try {
             return await this.contracts.read({

package/dist/services/trade.client.js.map

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

package/dist/services/trade.constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The buy-quote revert map ships as agent-facing prose, so it is pinned here rather than inlined in the
+ * helper: `src/__tests__/tool-registry.test.ts` scans it for the vocabulary the surface must never use.
+ */
+export declare const QUOTE_REVERT_REASONS: ReadonlyArray<{
+    name: string;
+    reason: string;
+}>;
+//# sourceMappingURL=trade.constants.d.ts.map

package/dist/services/trade.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade.constants.d.ts","sourceRoot":"","sources":["../../src/services/trade.constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAwBhF,CAAC"}

package/dist/services/trade.constants.js

@@ -0,0 +1,28 @@
+/**
+ * The buy-quote revert map ships as agent-facing prose, so it is pinned here rather than inlined in the
+ * helper: `src/__tests__/tool-registry.test.ts` scans it for the vocabulary the surface must never use.
+ */
+export const QUOTE_REVERT_REASONS = [
+    { name: 'LotNotOpen', reason: 'the lot is closed — sold out, still delivering, or cancelled' },
+    { name: 'ExceedsRemaining', reason: "the amount exceeds the lot's remaining units" },
+    { name: 'InvalidValue', reason: 'the buy amount must be greater than zero' },
+    {
+        name: 'SaleFeeExceedsMax',
+        reason: "the lot is frozen: the hub's live sale fee now exceeds the seller's tolerance, so the buy reverts " +
+            'until the hub lowers the rate (or the seller sends the remainder home)',
+    },
+    { name: 'WrongHub', reason: "the route must start at the lot's hub" },
+    { name: 'NotDestOwner', reason: 'the destination cell (route end) must be one you own' },
+    { name: 'PathTooShort', reason: 'the route needs at least the hub and your destination cell' },
+    {
+        name: 'NotEligibleWaypoint',
+        reason: 'a waypoint on the route is not eligible — a hub on the path cannot serve as a live node right now ' +
+            '(temporarily unroutable, not frozen)',
+    },
+    { name: 'HopOutOfRange', reason: "a hop on the route is longer than transport's reach" },
+    { name: 'NotWaypointOwner', reason: 'a non-hub waypoint on the route is not owned by you' },
+    { name: 'DegenerateWaypoint', reason: 'the route repeats a waypoint' },
+    { name: 'NotRevealed', reason: 'a cell on the route (or the hub) is not revealed yet' },
+    { name: 'BelowMinAmount', reason: "the amount is below transport's minimum" },
+];
+//# sourceMappingURL=trade.constants.js.map

package/dist/services/trade.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade.constants.js","sourceRoot":"","sources":["../../src/services/trade.constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAoD;IACjF,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,8DAA8D,EAAE;IAC9F,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,8CAA8C,EAAE;IACpF,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,0CAA0C,EAAE;IAC5E;QACI,IAAI,EAAE,mBAAmB;QACzB,MAAM,EACF,oGAAoG;YACpG,wEAAwE;KAC/E;IACD,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,uCAAuC,EAAE;IACrE,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,sDAAsD,EAAE;IACxF,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,4DAA4D,EAAE;IAC9F;QACI,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EACF,oGAAoG;YACpG,sCAAsC;KAC7C;IACD,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,qDAAqD,EAAE;IACxF,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,qDAAqD,EAAE;IAC3F,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,8BAA8B,EAAE;IACtE,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,sDAAsD,EAAE;IACvF,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,yCAAyC,EAAE;CAChF,CAAC"}

package/dist/services/trade.helpers.d.ts

@@ -1,5 +1,13 @@
-import type { ApiLotView, ApiMarketIndex, ApiMarketResourceSummary, LotView, MarketIndex, MarketResourceSummary } from '../api/types.js';
+import { type ApiLotView, type ApiMarketIndex, type ApiMarketResourceSummary, type LotView, type MarketIndex, type MarketResourceSummary, LotState } from '../api/types.js';
+import { OnChainLotState } from '../contracts/trade.types.js';
 export declare function namedQuoteRevert(error: unknown): unknown;
+/**
+ * The two boundaries name the lifecycle differently and neither is a superset of the other: the contract
+ * deletes a lot once it is sold out, cancelled or reclaimed, so its terminal ordinal is the empty slot,
+ * while the projection keeps naming which terminal state it reached.
+ */
+export declare function lotStateFromChain(state: OnChainLotState): LotState | null;
+export declare function lotStateToChain(state: LotState): OnChainLotState;
 export declare function toLotView(lot: ApiLotView): LotView;
 export declare function toMarketIndex(index: ApiMarketIndex): MarketIndex;
 export declare function toMarketResourceSummary(row: ApiMarketResourceSummary): MarketResourceSummary;

package/dist/services/trade.helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trade.helpers.d.ts","sourceRoot":"","sources":["../../src/services/trade.helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,UAAU,EACV,cAAc,EACd,wBAAwB,EACxB,OAAO,EACP,WAAW,EACX,qBAAqB,EACxB,MAAM,iBAAiB,CAAC;AAQzB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMxD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAiBlD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CAKhE;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,wBAAwB,GAAG,qBAAqB,CAa5F;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWnE;AA0BD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAW5D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAW5D"}
+{"version":3,"file":"trade.helpers.d.ts","sourceRoot":"","sources":["../../src/services/trade.helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,QAAQ,EACX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAO9D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMxD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,QAAQ,GAAG,IAAI,CAWzE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,eAAe,CAYhE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAkBlD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CAKhE;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,wBAAwB,GAAG,qBAAqB,CAa5F;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYnE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAW5D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAW5D"}

package/dist/services/trade.helpers.js

@@ -1,4 +1,7 @@
+import { QUOTE_REVERT_REASONS } from './trade.constants.js';
+import { LotState, } from '../api/types.js';
 import { TRADE_ABI } from '../contracts/trade.abi.js';
+import { OnChainLotState } from '../contracts/trade.types.js';
 import { TRANSPORT_ABI } from '../contracts/transport.abi.js';
 import { bpToPercent } from '../utils/format.utils.js';
 import { describeRevert } from '../wallet/revert.utils.js';
@@ -10,6 +13,36 @@ export function namedQuoteRevert(error) {
     }
     return new Error(`Quote reverted: ${revert}`, { cause: error });
 }
+/**
+ * The two boundaries name the lifecycle differently and neither is a superset of the other: the contract
+ * deletes a lot once it is sold out, cancelled or reclaimed, so its terminal ordinal is the empty slot,
+ * while the projection keeps naming which terminal state it reached.
+ */
+export function lotStateFromChain(state) {
+    switch (state) {
+        case OnChainLotState.Delivering:
+            return LotState.Delivering;
+        case OnChainLotState.Open:
+            return LotState.Open;
+        case OnChainLotState.Evicted:
+            return LotState.Evicted;
+        case OnChainLotState.None:
+            return null;
+    }
+}
+export function lotStateToChain(state) {
+    switch (state) {
+        case LotState.Delivering:
+            return OnChainLotState.Delivering;
+        case LotState.Open:
+            return OnChainLotState.Open;
+        case LotState.Evicted:
+            return OnChainLotState.Evicted;
+        case LotState.Sold:
+        case LotState.Cancelled:
+            return OnChainLotState.None;
+    }
+}
 export function toLotView(lot) {
     return {
         id: lot.id,
@@ -21,7 +54,8 @@ export function toLotView(lot) {
         pricePerUnit: lot.pricePerUnit,
         saleFeePercent: bpToPercent(lot.saleFeeBp),
         maxSaleFeePercent: bpToPercent(lot.maxSaleFeeBp),
-        frozen: lot.saleFeeBp > lot.maxSaleFeeBp,
+        // Only an Open lot can freeze: freezing means a buy would revert, and nothing else is buyable.
+        frozen: lot.state === LotState.Open && lot.saleFeeBp > lot.maxSaleFeeBp,
         state: lot.state,
         distanceFromAnchor: lot.distanceFromAnchor,
         createdAt: lot.createdAt,
@@ -43,8 +77,8 @@ export function toMarketResourceSummary(row) {
         minPricePerUnit: row.minPricePerUnit,
         incomingLots: row.incomingLots,
         incomingRemaining: row.incomingRemaining,
-        frozenLots: row.frozenLots ?? null,
-        frozenRemaining: row.frozenRemaining ?? null,
+        frozenLots: row.frozenLots,
+        frozenRemaining: row.frozenRemaining,
         distanceFromAnchor: row.distanceFromAnchor,
     };
 }
@@ -52,33 +86,12 @@ export function enrichSaleFeeToleranceError(error) {
     if (error instanceof Error && error.message.includes('SaleFeeExceedsMax')) {
         return new Error(`${error.message} — the hub's live sale fee now exceeds your tolerance (maxSaleFeePercent), which ` +
             `would list an already-frozen lot (buys revert until the hub lowers the rate to the tolerance or ` +
-            `below, though cancel stays fee-free). Re-read the hub's current rate (cpu_get_cell or ` +
+            `below; a lot return owes no sale fee, but still pays transit for the route home). Re-read the ` +
+            `hub's current rate (cpu_get_cell or ` +
             `cpu_get_markets), then retry with a higher maxSaleFeePercent, or omit it to accept the current rate.`, { cause: error });
     }
     return error;
 }
-const QUOTE_REVERT_REASONS = [
-    { name: 'LotNotOpen', reason: 'the lot is closed — sold out, still delivering, or cancelled' },
-    { name: 'ExceedsRemaining', reason: "the amount exceeds the lot's remaining units" },
-    { name: 'InvalidValue', reason: 'the buy amount must be greater than zero' },
-    {
-        name: 'SaleFeeExceedsMax',
-        reason: "the lot is frozen: the hub's live sale fee now exceeds the seller's tolerance, so the buy reverts " +
-            'until the hub lowers the rate (or the seller cancels, fee-free)',
-    },
-    { name: 'WrongHub', reason: "the route must start at the lot's hub" },
-    { name: 'NotDestOwner', reason: 'the destination cell (route end) must be one you own' },
-    { name: 'PathTooShort', reason: 'the route needs at least the hub and your destination cell' },
-    {
-        name: 'NotEligibleWaypoint',
-        reason: 'a waypoint on the route is not eligible — a foreign frozen hub blocks the path',
-    },
-    { name: 'HopOutOfRange', reason: "a hop on the route is longer than transport's reach" },
-    { name: 'NotWaypointOwner', reason: 'a non-hub waypoint on the route is not owned by you' },
-    { name: 'DegenerateWaypoint', reason: 'the route repeats a waypoint' },
-    { name: 'NotRevealed', reason: 'a cell on the route (or the hub) is not revealed yet' },
-    { name: 'BelowMinAmount', reason: "the amount is below transport's minimum" },
-];
 export function enrichBuyQuoteRevert(error) {
     if (!(error instanceof Error) || !error.message.includes('Quote reverted:')) {
         return error;
@@ -93,7 +106,7 @@ export function enrichFrozenBuyError(error) {
         return new Error(`${error.message} — this lot is frozen: the hub's live sale fee now exceeds the seller's tolerance ` +
             `(maxSaleFeePercent), so the buy reverts. Wait for the hub owner to lower the rate to the tolerance ` +
             `or below (re-check with cpu_get_lot or cpu_get_markets), or pick another lot; the seller can ` +
-            `cancel the lot fee-free at any time.`, { cause: error });
+            `send the remainder home at any time, paying no sale fee but still paying transit for the route.`, { cause: error });
     }
     return error;
 }