project-cpu-mcp 0.7.1

package/dist/services/mining.service.js

@@ -0,0 +1,249 @@
+import { isAddress, parseEventLogs } from 'viem';
+import { MAX_APPROVE_AMOUNT } from './allowance.constants.js';
+import { decodeBurnedCpu, feeWeiOf } from './burn.utils.js';
+import { ModeCostKind, } from './types.js';
+import { BuildingKind } from '../api/types.js';
+import { CELL_ABI } from '../contracts/cell.abi.js';
+import { modeCost } from '../map/mode.utils.js';
+import { toSettleConfig } from '../map/reader.utils.js';
+import { cellProcessProgress } from '../map/settle.utils.js';
+import { CellProcessKind } from '../map/types.js';
+import { cpuFromWei, formatUnixSeconds, resourceLabel } from '../utils/format.utils.js';
+export class MiningService {
+    wallet;
+    appConfig;
+    allowance;
+    cellClient;
+    contracts;
+    mapReader;
+    logger;
+    constructor(options) {
+        this.wallet = options.wallet;
+        this.appConfig = options.appConfig;
+        this.allowance = options.allowance;
+        this.cellClient = options.cellClient;
+        this.contracts = options.contracts;
+        this.mapReader = options.mapReader;
+        this.logger = options.logger;
+    }
+    async getStatus(tokenId) {
+        await this.mapReader.refresh();
+        const state = await this.mapReader.readRevealCell(tokenId);
+        if (state === null) {
+            throw new Error(`Cell ${tokenId} is not in the current map.`);
+        }
+        const process = state.process;
+        if (process === null || process.kind !== CellProcessKind.Mining) {
+            return {
+                tokenId,
+                active: false,
+                serverTime: this.mapReader.getServerTime(),
+                targetResourceId: null,
+                yieldPerCycle: null,
+                durationSec: null,
+                startAt: null,
+                batches: 0,
+                claimedBatches: 0,
+                completedBatches: 0,
+                claimableBatches: 0,
+                isFinished: false,
+                endsAtSec: null,
+                nextBatchAtSec: null,
+                claimable: '0',
+                depositRemaining: '0',
+                stalled: false,
+                warehouseUsed: null,
+                warehouseCap: null,
+            };
+        }
+        const resource = state.resources.find((r) => r.resourceId === process.resource) ?? null;
+        const deposit = resource?.deposit ?? '0';
+        const storage = resource?.storage ?? null;
+        const serverTime = this.mapReader.getServerTime();
+        const config = await this.appConfig.load();
+        const { progress, settlement } = cellProcessProgress(state, process, serverTime, toSettleConfig(config));
+        return {
+            tokenId,
+            active: true,
+            serverTime,
+            targetResourceId: process.resource,
+            yieldPerCycle: process.yieldPerCycle,
+            durationSec: process.durationSec,
+            startAt: process.startAt,
+            batches: process.batches,
+            claimedBatches: process.claimedBatches,
+            ...progress,
+            claimable: settlement.minedUnits.toString(),
+            depositRemaining: deposit,
+            stalled: process.stalled,
+            warehouseUsed: storage?.used ?? null,
+            warehouseCap: storage?.cap ?? null,
+        };
+    }
+    async claim(tokenId) {
+        const config = await this.appConfig.load();
+        const wallet = this.wallet.get();
+        if (config.chainId !== wallet.getChainId()) {
+            throw new Error(`Chain mismatch: the chain config is chainId ${config.chainId} but the wallet is on ${wallet.getChainId()}. Check NETWORK.`);
+        }
+        const cell = config.contracts.cell;
+        if (!isAddress(cell, { strict: false })) {
+            throw new Error(`Cell contract is not configured for network ${config.network}; cannot claim.`);
+        }
+        this.logger.info('claiming mined resources', { tokenId });
+        const txHash = await this.cellClient.claim({ cell, tokenId: BigInt(tokenId) });
+        const confirmed = await this.contracts.confirm(txHash, 'Mining claim');
+        const mined = this.decodeMined(confirmed.logs, cell);
+        return {
+            tokenId,
+            claimedBatches: mined?.claimedBatches ?? null,
+            resourceId: mined?.resource ?? null,
+            claimedAmount: (mined?.amount ?? 0n).toString(),
+            txHash: confirmed.txHash,
+            status: confirmed.status,
+            blockNumber: confirmed.blockNumber,
+        };
+    }
+    async startMining(input) {
+        const config = await this.appConfig.load();
+        const wallet = this.wallet.get();
+        if (config.chainId !== wallet.getChainId()) {
+            throw new Error(`Chain mismatch: the chain config is chainId ${config.chainId} but the wallet is on ${wallet.getChainId()}. Check NETWORK.`);
+        }
+        const cell = config.contracts.cell;
+        if (!isAddress(cell, { strict: false })) {
+            throw new Error(`Cell contract is not configured for network ${config.network}; cannot start mining.`);
+        }
+        await this.mapReader.refresh();
+        const state = await this.mapReader.readRevealCell(input.tokenId);
+        const { target, view } = this.resolveMiningTarget(config, state, input, wallet.getAddress());
+        const tokenId = BigInt(input.tokenId);
+        const priced = await this.priceContext(config, cell, tokenId, view, state?.building?.modeResource ?? null);
+        const cost = modeCost(priced.view, priced.mode, target);
+        const approveTxHash = await this.approveFee(config, cell, cost);
+        this.logger.info('starting mining', {
+            tokenId: input.tokenId,
+            target,
+            batches: input.batches,
+            switchCost: cost,
+            switchCostExact: priced.exact,
+        });
+        const txHash = await this.cellClient.startMining({ cell, tokenId, target, batches: input.batches });
+        const confirmed = await this.contracts.confirm(txHash, 'Start mining');
+        const started = this.decodeStarted(confirmed.logs, cell);
+        return {
+            tokenId: input.tokenId,
+            targetResourceId: target,
+            yieldPerCycle: started?.yieldPerCycle ?? null,
+            batches: started?.batches ?? null,
+            durationSec: started?.durationSec ?? null,
+            modeSwitch: this.chargeOf(config, cost, priced.exact, confirmed.logs),
+            approveTxHash,
+            txHash: confirmed.txHash,
+            status: confirmed.status,
+            blockNumber: confirmed.blockNumber,
+        };
+    }
+    async priceContext(config, cell, tokenId, mapView, mapMode) {
+        try {
+            const chain = await this.cellClient.readCellView(cell, tokenId);
+            const view = config.buildings.find((b) => b.onChainId === chain.buildingType) ?? null;
+            return { mode: chain.modeResource === 0 ? null : chain.modeResource, view, exact: true };
+        }
+        catch (error) {
+            this.logger.warn('could not read the cell mode on-chain — pricing the switch off the map', {
+                tokenId: tokenId.toString(),
+                error,
+            });
+            return { mode: mapMode, view: mapView, exact: false };
+        }
+    }
+    async approveFee(config, cell, cost) {
+        if (cost.kind === ModeCostKind.Free) {
+            return null;
+        }
+        const cpuToken = config.contracts.cpuToken;
+        if (!isAddress(cpuToken, { strict: false })) {
+            throw new Error(`$CPU token is not configured for network ${config.network}; cannot pay to switch.`);
+        }
+        const needed = cost.kind === ModeCostKind.Paid ? feeWeiOf(cost) : MAX_APPROVE_AMOUNT;
+        return this.allowance.ensureAllowance(cpuToken, cell, needed);
+    }
+    chargeOf(config, cost, exact, logs) {
+        const cpuToken = config.contracts.cpuToken;
+        if (!isAddress(cpuToken, { strict: false })) {
+            return { cost, exact, burnedCpu: null };
+        }
+        const burned = decodeBurnedCpu(logs, cpuToken, this.wallet.get().getAddress());
+        return { cost, exact, burnedCpu: cpuFromWei(burned.toString()) };
+    }
+    resolveMiningTarget(config, state, input, address) {
+        if (state === null) {
+            throw new Error(`Cell ${input.tokenId} is not in the current map; reveal it or wait for the map to sync.`);
+        }
+        if (state.owner.toLowerCase() !== address.toLowerCase()) {
+            throw new Error(`You do not own cell ${input.tokenId} (owner ${state.owner}); only the owner can mine.`);
+        }
+        if (state.building === null) {
+            throw new Error(`Cell ${input.tokenId} has no building; build an extractor first, then start mining.`);
+        }
+        const view = config.buildings.find((b) => b.type === state.building?.type) ?? null;
+        if (view === null || view.kind !== BuildingKind.Extractor) {
+            const name = view?.name ?? state.building.type;
+            throw new Error(`The ${name} on cell ${input.tokenId} is not an extractor and cannot mine — crafters run cpu_craft.`);
+        }
+        const buildFinishAt = state.building.buildFinishAt;
+        if (buildFinishAt !== null && state.ready === false) {
+            throw new Error(`The ${view.name} on cell ${input.tokenId} is still under construction (ready ` +
+                `${formatUnixSeconds(buildFinishAt)}); start mining once it finishes.`);
+        }
+        if (state.process !== null) {
+            throw new Error(`Cell ${input.tokenId} has an active ${state.process.kind} process; ` +
+                `claim or finish it before starting (or switching) mining.`);
+        }
+        const target = this.pickTarget(view, input.targetResourceId, config);
+        const deposit = state.resources.find((r) => r.resourceId === target)?.deposit ?? '0';
+        if (BigInt(deposit) === 0n) {
+            throw new Error(`Cell ${input.tokenId} has no ${resourceLabel(config.resources, target)} deposit to mine ` +
+                `(it may be depleted or was never revealed here).`);
+        }
+        return { target, view };
+    }
+    pickTarget(view, requested, config) {
+        const minable = view.minableResources;
+        const mines = () => minable.map((id) => resourceLabel(config.resources, id)).join(', ');
+        if (requested === null) {
+            const [sole, ...rest] = minable;
+            if (sole !== undefined && rest.length === 0) {
+                return sole;
+            }
+            throw new Error(`The ${view.name} mines several resources (${mines()}); pass targetResourceId to pick one.`);
+        }
+        if (!minable.includes(requested)) {
+            throw new Error(`The ${view.name} cannot mine ${resourceLabel(config.resources, requested)}; it mines: ${mines()}.`);
+        }
+        return requested;
+    }
+    decodeMined(logs, cell) {
+        const events = parseEventLogs({ abi: CELL_ABI, eventName: 'ResourceMined', logs });
+        const event = events.find((e) => e.address.toLowerCase() === cell.toLowerCase());
+        if (event === undefined) {
+            return null;
+        }
+        return { resource: event.args.resource, amount: event.args.amount, claimedBatches: event.args.claimedBatches };
+    }
+    decodeStarted(logs, cell) {
+        const events = parseEventLogs({ abi: CELL_ABI, eventName: 'MiningStarted', logs });
+        const event = events.find((e) => e.address.toLowerCase() === cell.toLowerCase());
+        if (event === undefined) {
+            return null;
+        }
+        return {
+            resource: event.args.resource,
+            durationSec: event.args.durationSec,
+            yieldPerCycle: Number(event.args.yieldPerCycle),
+            batches: event.args.batches,
+        };
+    }
+}
+//# sourceMappingURL=mining.service.js.map

package/dist/services/mining.service.js.map

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

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

@@ -0,0 +1,3 @@
+import type { Address } from 'viem';
+export declare const SEADROP_ADDRESS: Address;
+//# sourceMappingURL=mint.constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mint.constants.d.ts","sourceRoot":"","sources":["../../src/services/mint.constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAIpC,eAAO,MAAM,eAAe,EAAE,OAAsD,CAAC"}

package/dist/services/mint.constants.js

@@ -0,0 +1,4 @@
+// Canonical OpenSea SeaDrop 1.0 router — same address across the supported chains. Mints are sent
+// here keyed by the `land` contract; it calls back into the NFT to issue the cells.
+export const SEADROP_ADDRESS = '0x00005EA00Ac477B1030CE78506496e8C2dE24bf5';
+//# sourceMappingURL=mint.constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mint.constants.js","sourceRoot":"","sources":["../../src/services/mint.constants.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,oFAAoF;AACpF,MAAM,CAAC,MAAM,eAAe,GAAY,4CAA4C,CAAC"}

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

@@ -0,0 +1,14 @@
+import { type IMintService, type MintInput, type MintQuote, type MintResult, type MintServiceOptions } from './types.js';
+export declare class MintService implements IMintService {
+    private readonly wallet;
+    private readonly appConfig;
+    private readonly logger;
+    constructor(options: MintServiceOptions);
+    quote(input: MintInput): Promise<MintQuote>;
+    mint(input: MintInput): Promise<MintResult>;
+    private prepare;
+    private readPublicDrop;
+    private resolveFeeRecipient;
+    private assertChain;
+}
+//# sourceMappingURL=mint.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mint.service.d.ts","sourceRoot":"","sources":["../../src/services/mint.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,kBAAkB,EAG1B,MAAM,YAAY,CAAC;AAOpB,qBAAa,WAAY,YAAW,YAAY;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,EAAE,kBAAkB;IAMjC,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAc3C,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;YAmCnC,OAAO;YAmCP,cAAc;YAiBd,mBAAmB;IAejC,OAAO,CAAC,WAAW;CAOtB"}

package/dist/services/mint.service.js

@@ -0,0 +1,118 @@
+import { encodeFunctionData, formatEther, isAddress, zeroAddress } from 'viem';
+import { SEADROP_ADDRESS } from './mint.constants.js';
+import { SEADROP_ABI } from '../contracts/seadrop.abi.js';
+import { errorMessage } from '../utils/error.utils.js';
+import { formatUnixSeconds } from '../utils/format.utils.js';
+import { TxStatus } from '../wallet/types.js';
+export class MintService {
+    wallet;
+    appConfig;
+    logger;
+    constructor(options) {
+        this.wallet = options.wallet;
+        this.appConfig = options.appConfig;
+        this.logger = options.logger;
+    }
+    async quote(input) {
+        const { land, drop, quantity, totalWei } = await this.prepare(input);
+        return {
+            land,
+            quantity,
+            mintPrice: formatEther(drop.mintPrice),
+            total: formatEther(totalWei),
+            feeBps: drop.feeBps,
+            startTime: drop.startTime,
+            endTime: drop.endTime,
+            maxTotalMintableByWallet: drop.maxTotalMintableByWallet,
+        };
+    }
+    async mint(input) {
+        const { config, wallet, land, quantity, totalWei } = await this.prepare(input);
+        const feeRecipient = await this.resolveFeeRecipient(wallet, land);
+        // SeaDrop mints to msg.sender when minterIfNotPayer is the zero address.
+        const data = encodeFunctionData({
+            abi: SEADROP_ABI,
+            functionName: 'mintPublic',
+            args: [land, feeRecipient, zeroAddress, BigInt(quantity)],
+        });
+        this.logger.info('submitting mint', {
+            land,
+            quantity,
+            totalWei: totalWei.toString(),
+            network: config.network,
+        });
+        const txHash = await wallet.sendTransaction({ to: SEADROP_ADDRESS, data, value: totalWei, gas: null });
+        const receipt = await wallet.waitForReceipt(txHash);
+        if (receipt.status === TxStatus.Reverted) {
+            throw new Error(`Mint reverted on-chain (tx ${txHash}). The public drop terms may have changed — re-quote and retry.`);
+        }
+        return {
+            land,
+            quantity,
+            total: formatEther(totalWei),
+            txHash,
+            status: receipt.status,
+            blockNumber: receipt.blockNumber.toString(),
+        };
+    }
+    async prepare(input) {
+        const config = await this.appConfig.load();
+        const wallet = this.wallet.get();
+        this.assertChain(config.chainId, wallet.getChainId());
+        const land = config.contracts.land;
+        if (!isAddress(land, { strict: false })) {
+            throw new Error(`Land contract is not configured for network ${config.network}; cannot mint.`);
+        }
+        const quantity = Number(input.quantity);
+        const drop = await this.readPublicDrop(wallet, land);
+        const now = Math.floor(Date.now() / 1000);
+        if (now < drop.startTime) {
+            throw new Error(`The land public drop has not started yet (opens at ${formatUnixSeconds(drop.startTime)}).`);
+        }
+        if (drop.endTime !== 0 && now > drop.endTime) {
+            throw new Error(`The land public drop has ended (closed at ${formatUnixSeconds(drop.endTime)}).`);
+        }
+        if (drop.mintPrice === 0n && drop.startTime === 0 && drop.endTime === 0) {
+            throw new Error('No active land public drop found for the configured land contract.');
+        }
+        if (quantity > drop.maxTotalMintableByWallet) {
+            throw new Error(`Quantity ${quantity} exceeds the per-wallet mint limit of ${drop.maxTotalMintableByWallet} for this drop.`);
+        }
+        const totalWei = BigInt(quantity) * drop.mintPrice;
+        return { config, wallet, land: land, drop, quantity, totalWei };
+    }
+    async readPublicDrop(wallet, land) {
+        let raw;
+        try {
+            raw = (await wallet.readContract({
+                address: SEADROP_ADDRESS,
+                abi: SEADROP_ABI,
+                functionName: 'getPublicDrop',
+                args: [land],
+            }));
+        }
+        catch (error) {
+            throw new Error(`Could not read the land public drop from SeaDrop — the drop may not be initialized: ${errorMessage(error)}`);
+        }
+        return raw;
+    }
+    async resolveFeeRecipient(wallet, land) {
+        const recipients = (await wallet.readContract({
+            address: SEADROP_ADDRESS,
+            abi: SEADROP_ABI,
+            functionName: 'getAllowedFeeRecipients',
+            args: [land],
+        }));
+        const [feeRecipient] = recipients;
+        if (feeRecipient === undefined) {
+            throw new Error('The land public drop has no allowed fee recipient configured; cannot mint.');
+        }
+        return feeRecipient;
+    }
+    assertChain(configChainId, walletChainId) {
+        if (configChainId !== walletChainId) {
+            throw new Error(`Wallet chain ${walletChainId} does not match the configured network chain ${configChainId}.`);
+        }
+    }
+}
+//# sourceMappingURL=mint.service.js.map

package/dist/services/mint.service.js.map

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

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

@@ -0,0 +1,20 @@
+import { type FulfillRevealInput, type RevealFulfilmentReport, type RevealFulfilmentServiceOptions, type SelfServiceRevealRequests } from './types.js';
+export declare class RevealFulfilmentService {
+    private readonly wallet;
+    private readonly appConfig;
+    private readonly randomness;
+    private readonly revealRequests;
+    private readonly contracts;
+    private readonly claims;
+    private readonly logger;
+    constructor(options: RevealFulfilmentServiceOptions);
+    openRequests(owner: string): Promise<SelfServiceRevealRequests | null>;
+    fulfill(input: FulfillRevealInput): Promise<RevealFulfilmentReport>;
+    private targetsOf;
+    private namedTarget;
+    private settle;
+    private beaconReason;
+    private readBack;
+    private entry;
+}
+//# sourceMappingURL=reveal-fulfilment.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reveal-fulfilment.service.d.ts","sourceRoot":"","sources":["../../src/services/reveal-fulfilment.service.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,kBAAkB,EAIvB,KAAK,sBAAsB,EAC3B,KAAK,8BAA8B,EAEnC,KAAK,yBAAyB,EACjC,MAAM,YAAY,CAAC;AAiBpB,qBAAa,uBAAuB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;IAC5D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,EAAE,8BAA8B;IAU7C,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IAetE,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAkC3D,SAAS;IAoCvB,OAAO,CAAC,WAAW;YA8BL,MAAM;IAoFpB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,KAAK;CAiBhB"}

package/dist/services/reveal-fulfilment.service.js

@@ -0,0 +1,184 @@
+import { getAddress, isAddress } from 'viem';
+import { RevealFulfilmentOutcome, } from './types.js';
+import { FULFILMENT_REVERT_LABEL } from '../randomness/constants.js';
+import { parseRequestId, sameAddress, sameTokenId, toOpenRequestRow } from '../randomness/request.utils.js';
+import { AdapterRequestState, BeaconRoundOutcome, } from '../randomness/types.js';
+import { errorMessage } from '../utils/error.utils.js';
+export class RevealFulfilmentService {
+    wallet;
+    appConfig;
+    randomness;
+    revealRequests;
+    contracts;
+    claims;
+    logger;
+    constructor(options) {
+        this.wallet = options.wallet;
+        this.appConfig = options.appConfig;
+        this.randomness = options.randomness;
+        this.revealRequests = options.revealRequests;
+        this.contracts = options.contracts;
+        this.claims = options.claims;
+        this.logger = options.logger;
+    }
+    async openRequests(owner) {
+        const strategy = await this.randomness.resolve();
+        if (strategy === null) {
+            return null;
+        }
+        const view = await this.revealRequests.listOpenRequests(owner);
+        this.logger.debug('read the open reveal requests behind the attention list', {
+            owner,
+            source: strategy.source,
+            open: view.requests.length,
+        });
+        return { currentSource: strategy.source, serverTime: view.serverTime, requests: view.requests };
+    }
+    async fulfill(input) {
+        const config = await this.appConfig.load();
+        const wallet = this.wallet.get();
+        if (config.chainId !== wallet.getChainId()) {
+            throw new Error(`Chain mismatch: the chain config is chainId ${config.chainId} but the wallet is on ${wallet.getChainId()}. Check NETWORK.`);
+        }
+        const strategy = await this.randomness.resolve();
+        if (strategy === null) {
+            throw new Error(`Reveals on network ${config.network} are delivered by the randomness source itself, so there ` +
+                `is nothing here for you to settle by hand. Request a reveal with reveal and read the draw ` +
+                `with get_cell once it lands.`);
+        }
+        const owner = wallet.getAddress();
+        const targets = await this.targetsOf(input, owner, strategy);
+        this.logger.info('settling open reveal requests on request', {
+            owner,
+            source: strategy.source,
+            targets: targets.length,
+        });
+        const requests = [];
+        for (const target of targets) {
+            requests.push(await this.settle(strategy, target));
+        }
+        return { owner, source: strategy.source, requests };
+    }
+    async targetsOf(input, owner, strategy) {
+        if (input.requestId !== null || input.source !== null) {
+            return [this.namedTarget(input)];
+        }
+        const named = input.tokenIds !== null && input.tokenIds.length > 0 ? input.tokenIds : null;
+        const view = await this.revealRequests.listOpenRequests(owner);
+        const targets = [];
+        for (const request of view.requests) {
+            const row = toOpenRequestRow(request);
+            if (row === null) {
+                this.logger.warn('the game API listed an open reveal request this client cannot read', {
+                    requestId: request.requestId,
+                    source: request.source,
+                    tokenId: request.tokenId,
+                });
+                continue;
+            }
+            if (named !== null && !named.some((tokenId) => sameTokenId(tokenId, row.tokenId))) {
+                continue;
+            }
+            targets.push({ requestId: row.requestId, source: row.source, tokenId: row.tokenId });
+        }
+        this.logger.debug('picked the reveal requests to settle', {
+            source: strategy.source,
+            open: view.requests.length,
+            picked: targets.length,
+        });
+        return targets;
+    }
+    namedTarget(input) {
+        if (input.requestId === null || input.source === null) {
+            throw new Error('Settling a reveal request the game API does not list takes both halves of the pair: the ' +
+                'request id and the address of the randomness source it was opened at. Pass them together.');
+        }
+        if (input.tokenIds !== null && input.tokenIds.length > 0) {
+            throw new Error('Name either the cells to settle or one request by id and source, not both: a request named ' +
+                'by id is settled without asking the game API which cell it belongs to.');
+        }
+        const requestId = parseRequestId(input.requestId);
+        if (requestId === null) {
+            throw new Error(`Reveal request id "${input.requestId}" is not a whole number — pass the id exactly as the ` +
+                `reveal that opened it reported it.`);
+        }
+        if (!isAddress(input.source, { strict: false })) {
+            throw new Error(`"${input.source}" is not an address — pass the randomness source the reveal that opened the ` +
+                `request reported.`);
+        }
+        return { requestId, source: getAddress(input.source), tokenId: null };
+    }
+    async settle(strategy, target) {
+        if (!sameAddress(target.source, strategy.source)) {
+            return this.entry(target, RevealFulfilmentOutcome.RetiredSource, null, null, `This request was opened at randomness source ${target.source}, while the chain config now ` +
+                `reveals through ${strategy.source}. A cell takes its draw only from the source its own ` +
+                `request names, so a fulfilment sent through the current one would revert; nothing was sent.`);
+        }
+        if (!this.claims.claim(target.source, target.requestId)) {
+            return this.entry(target, RevealFulfilmentOutcome.Busy, null, null, `This client is already settling this request, so this call sent no fulfilment of its own. ` +
+                this.readBack(target));
+        }
+        let round = null;
+        try {
+            const view = await strategy.readRequest(target.requestId);
+            if (view.state === AdapterRequestState.CLOSED) {
+                return this.entry(target, RevealFulfilmentOutcome.AlreadyDone, null, null, `The randomness source no longer holds this request — it is already settled. ` +
+                    this.readBack(target));
+            }
+            round = view.round;
+            const answer = await strategy.beacon.signatureOf(round);
+            if (answer.outcome !== BeaconRoundOutcome.SIGNED) {
+                return this.entry(target, RevealFulfilmentOutcome.NotReady, round, null, this.beaconReason(answer));
+            }
+            const sent = await strategy.fulfill({ requestId: target.requestId, round, signature: answer.signature });
+            if (sent.state === AdapterRequestState.CLOSED) {
+                return this.entry(target, RevealFulfilmentOutcome.AlreadyDone, round, null, `${sent.reason} ${this.readBack(target)}`);
+            }
+            const confirmed = await this.contracts.confirm(sent.txHash, FULFILMENT_REVERT_LABEL);
+            this.logger.info('settled an open reveal request', {
+                requestId: target.requestId.toString(),
+                tokenId: target.tokenId,
+                round: round.toString(),
+                txHash: confirmed.txHash,
+            });
+            return this.entry(target, RevealFulfilmentOutcome.Settled, round, confirmed.txHash, `The draw of round ${round} is delivered on-chain. ${this.readBack(target)}`);
+        }
+        catch (error) {
+            this.logger.warn('a reveal fulfilment did not go through', {
+                requestId: target.requestId.toString(),
+                tokenId: target.tokenId,
+                round: round?.toString() ?? null,
+                error: errorMessage(error),
+            });
+            return this.entry(target, RevealFulfilmentOutcome.Failed, round, null, errorMessage(error));
+        }
+        finally {
+            this.claims.release(target.source, target.requestId);
+        }
+    }
+    beaconReason(answer) {
+        const round = answer.round.toString();
+        if (answer.outcome === BeaconRoundOutcome.MALFORMED) {
+            return `The beacon answered for round ${round} in a shape this client cannot fulfil with (${answer.reason}).`;
+        }
+        return (`Round ${round} is not published yet (${answer.reason}), so there is no draw to deliver. The ` +
+            `request stays open — call fulfill_reveal again in a few seconds.`);
+    }
+    readBack(target) {
+        return target.tokenId === null
+            ? 'Read the draw with get_cell on the cell that opened it.'
+            : `Read the draw with get_cell ${target.tokenId}.`;
+    }
+    entry(target, outcome, round, fulfillTxHash, note) {
+        return {
+            requestId: target.requestId.toString(),
+            source: target.source,
+            tokenId: target.tokenId,
+            outcome,
+            round: round === null ? null : round.toString(),
+            fulfillTxHash,
+            note,
+        };
+    }
+}
+//# sourceMappingURL=reveal-fulfilment.service.js.map