project-cpu-mcp 0.10.0 → 0.12.0

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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"}

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

@@ -0,0 +1,25 @@
+import type { IAppConfig, ITradeClient, LotTermsInput, LotTermsResult } from './types.js';
+import type { ILogger } from '../logger/types.js';
+import type { WalletProvider } from '../wallet/types.js';
+export interface LotTermsServiceOptions {
+    appConfig: IAppConfig;
+    wallet: WalletProvider;
+    tradeClient: ITradeClient;
+    logger: ILogger;
+}
+/** One proposed listing, in the units the seller asked in. */
+export interface ListingPreflightInput {
+    hubTokenId: string;
+    resourceId: number;
+    value: string;
+    pricePerUnit: string;
+    /** Null means "lock in whatever the hub charges right now", so there is no tolerance to check. */
+    maxSaleFeePercent: number | null;
+}
+/** Reads the live listing terms and refuses a listing the contract already refuses. */
+export interface ILotTerms {
+    getLotTerms(input: LotTermsInput): Promise<LotTermsResult>;
+    /** Throws a domain error on the first violated rule, in the contract's own order. */
+    assertListingAllowed(input: ListingPreflightInput): Promise<LotTermsResult>;
+}
+//# sourceMappingURL=lot-terms.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lot-terms.types.d.ts","sourceRoot":"","sources":["../../src/services/lot-terms.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACnC,SAAS,EAAE,UAAU,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,YAAY,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,kGAAkG;IAClG,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,uFAAuF;AACvF,MAAM,WAAW,SAAS;IACtB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3D,qFAAqF;IACrF,oBAAoB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC/E"}

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

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

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

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

package/dist/services/reveal-revert.utils.d.ts

@@ -1,4 +1,5 @@
 export declare function isRevealAlreadyPending(error: unknown): boolean;
 export declare function withRevealInFlightPhrase(error: unknown, tokenId: string): unknown;
 export declare function withRevealRequestPhrase(error: unknown, tokenId: string): unknown;
+export declare function withRevealQuotePhrase(error: unknown): unknown;
 //# sourceMappingURL=reveal-revert.utils.d.ts.map

package/dist/services/reveal-revert.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reveal-revert.utils.d.ts","sourceRoot":"","sources":["../../src/services/reveal-revert.utils.ts"],"names":[],"mappings":"AAmFA,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG9D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAMjF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAMhF"}
+{"version":3,"file":"reveal-revert.utils.d.ts","sourceRoot":"","sources":["../../src/services/reveal-revert.utils.ts"],"names":[],"mappings":"AAsGA,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG9D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAMjF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAMhF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM7D"}

package/dist/services/reveal-revert.utils.js

@@ -9,6 +9,11 @@ function messageFor(name, args, tokenId) {
             return (`The reveal price moved between the quote and the send: cell ${tokenId} required ` +
                 `${String(args[0] ?? 'more')} wei and this transaction carried ${String(args[1] ?? 'less')}. ` +
                 `Nothing was spent — reveal cell ${tokenId} again and it prices the reveal afresh.`);
+        case CellRevertName.REVEAL_SERVICE_FEES_EXCEED_BUDGET:
+            return (`The configured reveal budget is ${String(args[0] ?? 'unknown')} wei, but the live randomness ` +
+                `fee and metadata publication charge need ${String(args[1] ?? 'more')} wei together. The service ` +
+                `fees cannot be paid on top of the budget, so no reveal can be quoted or requested until the ` +
+                `budget or fees change. Nothing was spent.`);
         case CellRevertName.REVEAL_PAYMENT_NOT_CONFIGURED:
             return (`This deployment has put no price on a reveal yet — neither the ETH leg nor the $CPU leg — so ` +
                 `no cell can be revealed on it. Nothing was spent and cell ${tokenId} is untouched.`);
@@ -19,6 +24,14 @@ function messageFor(name, args, tokenId) {
             return (`The reveal's ETH contribution could not be delivered, so the whole request was undone: ` +
                 `nothing was spent and cell ${tokenId} is untouched. This is a fault of the deployment, not ` +
                 `of your wallet — retry later.`);
+        case CellRevertName.METADATA_PUBLISHER_NOT_CONFIGURED:
+            return (`This deployment charges for Land metadata publication but has no metadata publisher configured, ` +
+                `so it refuses every reveal. Nothing was spent and cell ${tokenId} is untouched. Retrying cannot ` +
+                `fix this deployment configuration.`);
+        case CellRevertName.PUBLISHER_DELIVERY_FAILED:
+            return (`The Land metadata publication charge could not be delivered to the metadata publisher, so the ` +
+                `whole request was undone: nothing was spent and cell ${tokenId} is untouched. This is a fault ` +
+                `of the deployment, not of your wallet.`);
         case CellRevertName.REFUND_FAILED:
             return (`The reveal carried more ETH than it cost and the change could not be returned, so the whole ` +
                 `request was undone: nothing was spent and cell ${tokenId} is untouched. A wallet that ` +
@@ -72,4 +85,11 @@ export function withRevealRequestPhrase(error, tokenId) {
     }
     return new Error(messageFor(decoded.name, decoded.args, tokenId), { cause: error });
 }
+export function withRevealQuotePhrase(error) {
+    const decoded = decodeKnownRevert(error, CELL_ABI, CELL_REVERT_NAMES);
+    if (decoded === null) {
+        return withAdapterPhrase(error);
+    }
+    return new Error(messageFor(decoded.name, decoded.args, 'before the request'), { cause: error });
+}
 //# sourceMappingURL=reveal-revert.utils.js.map

package/dist/services/reveal-revert.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"reveal-revert.utils.js","sourceRoot":"","sources":["../../src/services/reveal-revert.utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reveal-revert.utils.js","sourceRoot":"","sources":["../../src/services/reveal-revert.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,MAAM,iBAAiB,GAAkC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AAEvF,SAAS,UAAU,CAAC,IAAoB,EAAE,IAA4B,EAAE,OAAe;IACnF,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,cAAc,CAAC,2BAA2B;YAC3C,OAAO,CACH,+DAA+D,OAAO,YAAY;gBAClF,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,qCAAqC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI;gBAC9F,mCAAmC,OAAO,yCAAyC,CACtF,CAAC;QACN,KAAK,cAAc,CAAC,iCAAiC;YACjD,OAAO,CACH,mCAAmC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,gCAAgC;gBAC/F,4CAA4C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,6BAA6B;gBAClG,8FAA8F;gBAC9F,2CAA2C,CAC9C,CAAC;QACN,KAAK,cAAc,CAAC,6BAA6B;YAC7C,OAAO,CACH,+FAA+F;gBAC/F,6DAA6D,OAAO,gBAAgB,CACvF,CAAC;QACN,KAAK,cAAc,CAAC,0BAA0B;YAC1C,OAAO,CACH,+FAA+F;gBAC/F,8BAA8B,OAAO,gBAAgB,CACxD,CAAC;QACN,KAAK,cAAc,CAAC,oBAAoB;YACpC,OAAO,CACH,yFAAyF;gBACzF,8BAA8B,OAAO,wDAAwD;gBAC7F,+BAA+B,CAClC,CAAC;QACN,KAAK,cAAc,CAAC,iCAAiC;YACjD,OAAO,CACH,kGAAkG;gBAClG,0DAA0D,OAAO,iCAAiC;gBAClG,oCAAoC,CACvC,CAAC;QACN,KAAK,cAAc,CAAC,yBAAyB;YACzC,OAAO,CACH,gGAAgG;gBAChG,wDAAwD,OAAO,iCAAiC;gBAChG,wCAAwC,CAC3C,CAAC;QACN,KAAK,cAAc,CAAC,aAAa;YAC7B,OAAO,CACH,8FAA8F;gBAC9F,kDAAkD,OAAO,+BAA+B;gBACxF,6CAA6C,CAChD,CAAC;QACN,KAAK,cAAc,CAAC,qBAAqB;YACrC,OAAO,CACH,+FAA+F;gBAC/F,sBAAsB,OAAO,gBAAgB,CAChD,CAAC;QACN,KAAK,cAAc,CAAC,oBAAoB;YACpC,OAAO,CACH,QAAQ,OAAO,gFAAgF;gBAC/F,qBAAqB,CACxB,CAAC;QACN,KAAK,cAAc,CAAC,qBAAqB;YACrC,OAAO,CACH,QAAQ,OAAO,+EAA+E;gBAC9F,mCAAmC,CACtC,CAAC;QACN,KAAK,cAAc,CAAC,sBAAsB;YACtC,OAAO,CACH,QAAQ,OAAO,6EAA6E;gBAC5F,iGAAiG;gBACjG,iEAAiE,OAAO,sBAAsB;gBAC9F,oCAAoC,OAAO,+CAA+C;gBAC1F,gGAAgG;gBAChG,4BAA4B,CAC/B,CAAC;QACN,KAAK,cAAc,CAAC,gBAAgB;YAChC,OAAO,CACH,QAAQ,OAAO,gFAAgF;gBAC/F,+FAA+F;gBAC/F,8FAA8F;gBAC9F,kBAAkB,OAAO,qEAAqE;gBAC9F,oDAAoD,OAAO,mCAAmC,CACjG,CAAC;QACN,KAAK,cAAc,CAAC,sBAAsB;YACtC,OAAO,CACH,QAAQ,OAAO,gFAAgF;gBAC/F,kDAAkD,CACrD,CAAC;QACN,KAAK,cAAc,CAAC,wBAAwB;YACxC,OAAO,CACH,gDAAgD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,iBAAiB;gBAC7F,8FAA8F;gBAC9F,oBAAoB,OAAO,SAAS,CACvC,CAAC;IACV,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACjD,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACtE,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,CAAC,sBAAsB,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc,EAAE,OAAe;IACpE,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACtE,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB,EAAE,CAAC;QACvE,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,gBAAgB,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3G,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc,EAAE,OAAe;IACnE,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACtE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAChD,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACtE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,oBAAoB,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AACrG,CAAC"}

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

@@ -1,4 +1,4 @@
-export declare const REVEAL_FEE_BUFFER_BPS = 2500n;
+export declare const REVEAL_PAYMENT_BUFFER_BPS = 1000n;
 export declare const REVEAL_POLL_TIMEOUT_MS = 45000;
 export declare const REVEAL_POLL_INTERVAL_MS = 3000;
 export declare const REVEAL_PRIME_ATTEMPTS = 3;

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

@@ -1 +1 @@
-{"version":3,"file":"reveal.constants.d.ts","sourceRoot":"","sources":["../../src/services/reveal.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAE7C,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,eAAO,MAAM,wBAAwB,OAA0B,CAAC"}
+{"version":3,"file":"reveal.constants.d.ts","sourceRoot":"","sources":["../../src/services/reveal.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAE7C,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,eAAO,MAAM,wBAAwB,OAA0B,CAAC"}

package/dist/services/reveal.constants.js

@@ -1,4 +1,4 @@
-export const REVEAL_FEE_BUFFER_BPS = 2500n;
+export const REVEAL_PAYMENT_BUFFER_BPS = 1000n;
 export const REVEAL_POLL_TIMEOUT_MS = 45_000;
 export const REVEAL_POLL_INTERVAL_MS = 3_000;
 export const REVEAL_PRIME_ATTEMPTS = 3;

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

@@ -1 +1 @@
-{"version":3,"file":"reveal.constants.js","sourceRoot":"","sources":["../../src/services/reveal.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAM,CAAC;AAE5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAE7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAuB,CAAC"}
+{"version":3,"file":"reveal.constants.js","sourceRoot":"","sources":["../../src/services/reveal.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAM,CAAC;AAEhD,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAE7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAuB,CAAC"}

package/dist/services/reveal.service.d.ts

@@ -28,11 +28,12 @@ export declare class RevealService {
     private pendingAtRetiredSource;
     private pendingButUnlisted;
     /**
-     * Every reveal is paid for, first one included, and only the Cell knows the price: the chain config
-     * carries the two gameplay legs but not the live randomness fee, so a value rebuilt from it underpays.
-     * Either leg may be zero — a zero burn needs no approval, and a zero contribution is not a free reveal.
+     * Every reveal is paid for, first one included, and only the Cell knows the price: the served config omits
+     * live service-fee split and validates that it fits inside the configured ETH budget. A zero burn needs no
+     * approval; service fees can consume the whole ETH budget without making the reveal free.
      */
     private fundReveal;
+    private readCpuBalance;
     private prepareRevealRequest;
     private sendRevealRequest;
     private pollFulfillment;

package/dist/services/reveal.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reveal.service.d.ts","sourceRoot":"","sources":["../../src/services/reveal.service.ts"],"names":[],"mappings":"AAYA,OAAO,EAUH,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAI5B,MAAM,YAAY,CAAC;AAqBpB,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,EAAE,oBAAoB;IAYnC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAkDtC,uBAAuB;YAiCvB,8BAA8B;YA4C9B,iBAAiB;YAsBjB,aAAa;YA0Db,eAAe;YAmDf,YAAY;IAmB1B,OAAO,CAAC,YAAY;YAQN,YAAY;YAeZ,SAAS;YAQT,QAAQ;IAyBtB,OAAO,CAAC,OAAO;YAiBD,UAAU;IAmBxB,OAAO,CAAC,UAAU;YAoBJ,+BAA+B;IAU7C,OAAO,CAAC,sBAAsB;IAqC9B,OAAO,CAAC,kBAAkB;IA6B1B;;;;OAIG;YACW,UAAU;YAgBV,oBAAoB;YAmBpB,iBAAiB;YAKjB,eAAe;CAYhC"}
+{"version":3,"file":"reveal.service.d.ts","sourceRoot":"","sources":["../../src/services/reveal.service.ts"],"names":[],"mappings":"AAYA,OAAO,EAUH,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAI5B,MAAM,YAAY,CAAC;AAsBpB,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,EAAE,oBAAoB;IAYnC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAkDtC,uBAAuB;YAiCvB,8BAA8B;YA4C9B,iBAAiB;YAsBjB,aAAa;YA0Db,eAAe;YAmDf,YAAY;IAmB1B,OAAO,CAAC,YAAY;YAQN,YAAY;YAeZ,SAAS;YAQT,QAAQ;IAyBtB,OAAO,CAAC,OAAO;YAiBD,UAAU;IAmBxB,OAAO,CAAC,UAAU;YAoBJ,+BAA+B;IAU7C,OAAO,CAAC,sBAAsB;IAqC9B,OAAO,CAAC,kBAAkB;IA6B1B;;;;OAIG;YACW,UAAU;YAqBV,cAAc;YAoBd,oBAAoB;YAmBpB,iBAAiB;YAKjB,eAAe;CAYhC"}