project-cpu-mcp 0.7.1

package/dist/randomness/factory.js

@@ -0,0 +1,66 @@
+import { isAddress, zeroAddress } from 'viem';
+import { BeaconClient } from './beacon.client.js';
+import { DrandRandomnessStrategy } from './drand.strategy.js';
+import { PushRandomnessStrategy } from './push.strategy.js';
+import { RandomnessKind } from '../api/types.js';
+import { CELL_ABI } from '../contracts/cell.abi.js';
+export class RandomnessStrategyFactory {
+    contracts;
+    wallet;
+    revealRequests;
+    logger;
+    constructor(options) {
+        this.contracts = options.contracts;
+        this.wallet = options.wallet;
+        this.revealRequests = options.revealRequests;
+        this.logger = options.logger;
+    }
+    async create(descriptor, cell) {
+        switch (descriptor.kind) {
+            case RandomnessKind.ENTROPY: {
+                const source = await this.resolveSource(descriptor, cell);
+                return new PushRandomnessStrategy({ source, contracts: this.contracts, logger: this.logger });
+            }
+            case RandomnessKind.DRAND: {
+                const source = await this.resolveSource(descriptor, cell);
+                return new DrandRandomnessStrategy({
+                    source,
+                    clock: { genesis: descriptor.genesis, period: descriptor.period },
+                    beacon: new BeaconClient({ baseUrl: descriptor.beaconApi, logger: this.logger.child('beacon') }),
+                    contracts: this.contracts,
+                    wallet: this.wallet,
+                    revealRequests: this.revealRequests,
+                    logger: this.logger,
+                });
+            }
+            default: {
+                const unsupported = descriptor;
+                throw new Error(`GET /api/v1/config serves a randomness descriptor this client build has no strategy for: ` +
+                    `${JSON.stringify(unsupported)}.`);
+            }
+        }
+    }
+    async resolveSource(descriptor, cell) {
+        const configured = descriptor.adapter.trim();
+        if (configured.length > 0) {
+            if (!isAddress(configured, { strict: false })) {
+                throw new Error(`GET /api/v1/config serves randomness adapter "${configured}", which is not an address.`);
+            }
+            this.logger.info('using the configured randomness source', { source: configured, kind: descriptor.kind });
+            return configured;
+        }
+        const onChain = await this.contracts.read({
+            address: cell,
+            abi: CELL_ABI,
+            functionName: 'randomnessSource',
+            args: [],
+        });
+        if (onChain === zeroAddress || !isAddress(onChain, { strict: false })) {
+            throw new Error(`GET /api/v1/config serves no randomness adapter address and Cell ${cell} has no randomness ` +
+                `source set on this deployment; reveal is unavailable.`);
+        }
+        this.logger.info('read the randomness source off the cell', { cell, source: onChain, kind: descriptor.kind });
+        return onChain;
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/randomness/factory.js.map

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

package/dist/randomness/fulfiller.d.ts

@@ -0,0 +1,19 @@
+import { type RevealFulfillerOptions } from './types.js';
+export declare class RevealFulfiller {
+    private readonly randomness;
+    private readonly revealRequests;
+    private readonly contracts;
+    private readonly wallet;
+    private readonly claims;
+    private readonly logger;
+    private readonly backoff;
+    private timer;
+    private sweeping;
+    constructor(options: RevealFulfillerOptions);
+    start(): void;
+    stop(): void;
+    private sweep;
+    private settle;
+    private defer;
+}
+//# sourceMappingURL=fulfiller.d.ts.map

package/dist/randomness/fulfiller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulfiller.d.ts","sourceRoot":"","sources":["../../src/randomness/fulfiller.ts"],"names":[],"mappings":"AAGA,OAAO,EAOH,KAAK,sBAAsB,EAE9B,MAAM,YAAY,CAAC;AAMpB,qBAAa,eAAe;IACxB,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,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,sBAAsB;IAS3C,KAAK,IAAI,IAAI;IAWb,IAAI,IAAI,IAAI;YAOE,KAAK;YAuCL,MAAM;IA8DpB,OAAO,CAAC,KAAK;CAYhB"}

package/dist/randomness/fulfiller.factory.d.ts

@@ -0,0 +1,5 @@
+import { RevealFulfiller } from './fulfiller.js';
+import type { RevealFulfilmentHandle, RevealFulfillerFactoryOptions } from './types.js';
+export declare function createRevealFulfiller(options: RevealFulfillerFactoryOptions): Promise<RevealFulfiller | null>;
+export declare function startRevealFulfilment(options: RevealFulfillerFactoryOptions): RevealFulfilmentHandle;
+//# sourceMappingURL=fulfiller.factory.d.ts.map

package/dist/randomness/fulfiller.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulfiller.factory.d.ts","sourceRoot":"","sources":["../../src/randomness/fulfiller.factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAGxF,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAkBnH;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,6BAA6B,GAAG,sBAAsB,CAoCpG"}

package/dist/randomness/fulfiller.factory.js

@@ -0,0 +1,58 @@
+import { FULFILMENT_SWEEP_INTERVAL_MS } from './constants.js';
+import { RevealFulfiller } from './fulfiller.js';
+import { SelfServiceRandomnessResolver } from './self-service.resolver.js';
+import { errorMessage } from '../utils/error.utils.js';
+export async function createRevealFulfiller(options) {
+    const randomness = new SelfServiceRandomnessResolver({
+        appConfig: options.appConfig,
+        randomness: options.randomness,
+        logger: options.logger,
+    });
+    if ((await randomness.resolve()) === null) {
+        return null;
+    }
+    return new RevealFulfiller({
+        randomness,
+        revealRequests: options.revealRequests,
+        contracts: options.contracts,
+        wallet: options.wallet,
+        claims: options.claims,
+        logger: options.logger,
+    });
+}
+export function startRevealFulfilment(options) {
+    let fulfiller = null;
+    let retry = null;
+    let stopped = false;
+    const attempt = () => {
+        void createRevealFulfiller(options)
+            .then((built) => {
+            if (stopped) {
+                return;
+            }
+            fulfiller = built;
+            built?.start();
+        })
+            .catch((error) => {
+            options.logger.warn('background reveal fulfilment has nothing to run on yet, retrying', {
+                error: errorMessage(error),
+                retryInMs: FULFILMENT_SWEEP_INTERVAL_MS,
+            });
+            if (!stopped) {
+                retry = setTimeout(attempt, FULFILMENT_SWEEP_INTERVAL_MS);
+            }
+        });
+    };
+    attempt();
+    return {
+        stop() {
+            stopped = true;
+            if (retry !== null) {
+                clearTimeout(retry);
+                retry = null;
+            }
+            fulfiller?.stop();
+        },
+    };
+}
+//# sourceMappingURL=fulfiller.factory.js.map

package/dist/randomness/fulfiller.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulfiller.factory.js","sourceRoot":"","sources":["../../src/randomness/fulfiller.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAE3E,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAsC;IAC9E,MAAM,UAAU,GAAG,IAAI,6BAA6B,CAAC;QACjD,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;KACzB,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,eAAe,CAAC;QACvB,UAAU;QACV,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;KACzB,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAsC;IACxE,IAAI,SAAS,GAA2B,IAAI,CAAC;IAC7C,IAAI,KAAK,GAAyC,IAAI,CAAC;IACvD,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,OAAO,GAAG,GAAS,EAAE;QACvB,KAAK,qBAAqB,CAAC,OAAO,CAAC;aAC9B,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YACZ,IAAI,OAAO,EAAE,CAAC;gBACV,OAAO;YACX,CAAC;YACD,SAAS,GAAG,KAAK,CAAC;YAClB,KAAK,EAAE,KAAK,EAAE,CAAC;QACnB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACtB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,kEAAkE,EAAE;gBACpF,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC;gBAC1B,SAAS,EAAE,4BAA4B;aAC1C,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAC;YAC9D,CAAC;QACL,CAAC,CAAC,CAAC;IACX,CAAC,CAAC;IACF,OAAO,EAAE,CAAC;IAEV,OAAO;QACH,IAAI;YACA,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,KAAK,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,SAAS,EAAE,IAAI,EAAE,CAAC;QACtB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/randomness/fulfiller.js

@@ -0,0 +1,148 @@
+import { backoffDelayMs } from './backoff.utils.js';
+import { FULFILMENT_REVERT_LABEL, FULFILMENT_SWEEP_INTERVAL_MS } from './constants.js';
+import { fulfilmentKey, sameAddress, toOpenRequestRow } from './request.utils.js';
+import { AdapterRequestState, BeaconRoundOutcome, } from './types.js';
+import { errorMessage } from '../utils/error.utils.js';
+export class RevealFulfiller {
+    randomness;
+    revealRequests;
+    contracts;
+    wallet;
+    claims;
+    logger;
+    backoff = new Map();
+    timer = null;
+    sweeping = false;
+    constructor(options) {
+        this.randomness = options.randomness;
+        this.revealRequests = options.revealRequests;
+        this.contracts = options.contracts;
+        this.wallet = options.wallet;
+        this.claims = options.claims;
+        this.logger = options.logger;
+    }
+    start() {
+        if (this.timer !== null) {
+            return;
+        }
+        this.logger.info('starting background reveal fulfilment', {
+            intervalMs: FULFILMENT_SWEEP_INTERVAL_MS,
+        });
+        this.timer = setInterval(() => void this.sweep(), FULFILMENT_SWEEP_INTERVAL_MS);
+        void this.sweep();
+    }
+    stop() {
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    async sweep() {
+        if (this.sweeping) {
+            this.logger.debug('the previous reveal sweep is still running, skipping this tick');
+            return;
+        }
+        if (!this.wallet.isReady()) {
+            this.logger.debug('no wallet yet, so there is no owner to sweep reveal requests for');
+            return;
+        }
+        this.sweeping = true;
+        try {
+            const owner = this.wallet.get().getAddress();
+            const view = await this.revealRequests.listOpenRequests(owner);
+            if (view.requests.length === 0) {
+                return;
+            }
+            const strategy = await this.randomness.resolve();
+            if (strategy === null) {
+                return;
+            }
+            for (const request of view.requests) {
+                const row = toOpenRequestRow(request);
+                if (row === null) {
+                    continue;
+                }
+                await this.settle(strategy, row);
+            }
+        }
+        catch (error) {
+            this.logger.warn('the background reveal sweep could not get through this tick', {
+                error: errorMessage(error),
+            });
+        }
+        finally {
+            this.sweeping = false;
+        }
+    }
+    async settle(strategy, row) {
+        if (!sameAddress(row.source, strategy.source)) {
+            this.logger.debug('leaving a reveal request opened at a retired randomness source alone', {
+                requestId: row.requestId.toString(),
+                tokenId: row.tokenId,
+                source: row.source,
+                current: strategy.source,
+            });
+            return;
+        }
+        const key = fulfilmentKey(row.source, row.requestId);
+        const waiting = this.backoff.get(key);
+        if (waiting !== undefined && Date.now() < waiting.nextAttemptAt) {
+            return;
+        }
+        if (!this.claims.claim(row.source, row.requestId)) {
+            this.logger.debug('another caller is already settling this reveal request', {
+                requestId: row.requestId.toString(),
+                tokenId: row.tokenId,
+            });
+            return;
+        }
+        try {
+            const view = await strategy.readRequest(row.requestId);
+            if (view.state === AdapterRequestState.CLOSED) {
+                this.backoff.delete(key);
+                return;
+            }
+            const answer = await strategy.beacon.signatureOf(view.round);
+            if (answer.outcome !== BeaconRoundOutcome.SIGNED) {
+                this.defer(key, row, answer.reason);
+                return;
+            }
+            const sent = await strategy.fulfill({
+                requestId: row.requestId,
+                round: view.round,
+                signature: answer.signature,
+            });
+            if (sent.state === AdapterRequestState.CLOSED) {
+                this.backoff.delete(key);
+                return;
+            }
+            const confirmed = await this.contracts.confirm(sent.txHash, FULFILMENT_REVERT_LABEL);
+            this.backoff.delete(key);
+            this.logger.info('settled an open reveal request in the background', {
+                requestId: row.requestId.toString(),
+                tokenId: row.tokenId,
+                round: view.round.toString(),
+                txHash: confirmed.txHash,
+            });
+        }
+        catch (error) {
+            this.defer(key, row, errorMessage(error));
+        }
+        finally {
+            this.claims.release(row.source, row.requestId);
+        }
+    }
+    defer(key, row, reason) {
+        const failures = (this.backoff.get(key)?.failures ?? 0) + 1;
+        const delayMs = backoffDelayMs(failures);
+        this.backoff.set(key, { failures, nextAttemptAt: Date.now() + delayMs });
+        this.logger.warn('a background reveal fulfilment did not go through', {
+            requestId: row.requestId.toString(),
+            tokenId: row.tokenId,
+            failures,
+            retryInMs: delayMs,
+            reason,
+        });
+    }
+}
+//# sourceMappingURL=fulfiller.js.map

package/dist/randomness/fulfiller.js.map

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

package/dist/randomness/push.strategy.d.ts

@@ -0,0 +1,12 @@
+import type { Address } from 'viem';
+import type { PushRandomness, PushRandomnessOptions } from './types.js';
+import { RandomnessKind } from '../api/types.js';
+export declare class PushRandomnessStrategy implements PushRandomness {
+    readonly kind: RandomnessKind.ENTROPY;
+    readonly source: Address;
+    private readonly contracts;
+    private readonly logger;
+    constructor(options: PushRandomnessOptions);
+    quoteFee(): Promise<bigint>;
+}
+//# sourceMappingURL=push.strategy.d.ts.map

package/dist/randomness/push.strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.strategy.d.ts","sourceRoot":"","sources":["../../src/randomness/push.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKjD,qBAAa,sBAAuB,YAAW,cAAc;IACzD,SAAgB,IAAI,EAAE,cAAc,CAAC,OAAO,CAA0B;IACtE,SAAgB,MAAM,EAAE,OAAO,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,EAAE,qBAAqB;IAMpC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;CAUpC"}

package/dist/randomness/push.strategy.js

@@ -0,0 +1,24 @@
+import { RandomnessKind } from '../api/types.js';
+import { RANDOMNESS_SOURCE_ABI } from '../contracts/randomness-source.abi.js';
+export class PushRandomnessStrategy {
+    kind = RandomnessKind.ENTROPY;
+    source;
+    contracts;
+    logger;
+    constructor(options) {
+        this.source = options.source;
+        this.contracts = options.contracts;
+        this.logger = options.logger;
+    }
+    async quoteFee() {
+        const fee = await this.contracts.read({
+            address: this.source,
+            abi: RANDOMNESS_SOURCE_ABI,
+            functionName: 'quoteFee',
+            args: [],
+        });
+        this.logger.info('quoted randomness fee', { source: this.source, kind: this.kind, feeWei: fee.toString() });
+        return fee;
+    }
+}
+//# sourceMappingURL=push.strategy.js.map

package/dist/randomness/push.strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.strategy.js","sourceRoot":"","sources":["../../src/randomness/push.strategy.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAI9E,MAAM,OAAO,sBAAsB;IACf,IAAI,GAA2B,cAAc,CAAC,OAAO,CAAC;IACtD,MAAM,CAAU;IACf,SAAS,CAAkB;IAC3B,MAAM,CAAU;IAEjC,YAAY,OAA8B;QACtC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,QAAQ;QACV,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAS;YAC1C,OAAO,EAAE,IAAI,CAAC,MAAM;YACpB,GAAG,EAAE,qBAAqB;YAC1B,YAAY,EAAE,UAAU;YACxB,IAAI,EAAE,EAAE;SACX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC5G,OAAO,GAAG,CAAC;IACf,CAAC;CACJ"}

package/dist/randomness/request.utils.d.ts

@@ -0,0 +1,10 @@
+import type { OpenRequestRow } from './types.js';
+import type { OpenRevealRequestView } from '../api/types.js';
+export declare function sameAddress(left: string, right: string): boolean;
+export declare function sameTokenId(left: string, right: string): boolean;
+export declare function fulfilmentKey(source: string, requestId: bigint): string;
+export declare function parseRequestId(value: string): bigint | null;
+export declare function toOpenRequestRow(request: OpenRevealRequestView): OpenRequestRow | null;
+export declare function pickOpenRequest(requests: ReadonlyArray<OpenRevealRequestView>, source: string, tokenId: string): OpenRequestRow | null;
+export declare function pickRetiredSourceRequest(requests: ReadonlyArray<OpenRevealRequestView>, source: string, tokenId: string): OpenRequestRow | null;
+//# sourceMappingURL=request.utils.d.ts.map

package/dist/randomness/request.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.utils.d.ts","sourceRoot":"","sources":["../../src/randomness/request.utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAI7D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAOhE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,GAAG,IAAI,CAWtF;AAoBD,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,EAC9C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAChB,cAAc,GAAG,IAAI,CAEvB;AAED,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,EAC9C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAChB,cAAc,GAAG,IAAI,CAEvB"}

package/dist/randomness/request.utils.js

@@ -0,0 +1,52 @@
+import { getAddress, isAddress } from 'viem';
+const DECIMAL = /^\d+$/;
+export function sameAddress(left, right) {
+    return left.trim().toLowerCase() === right.trim().toLowerCase();
+}
+export function sameTokenId(left, right) {
+    const a = left.trim();
+    const b = right.trim();
+    if (a === b) {
+        return true;
+    }
+    return DECIMAL.test(a) && DECIMAL.test(b) && BigInt(a) === BigInt(b);
+}
+export function fulfilmentKey(source, requestId) {
+    return `${source.trim().toLowerCase()}:${requestId.toString()}`;
+}
+export function parseRequestId(value) {
+    const trimmed = value.trim();
+    return DECIMAL.test(trimmed) ? BigInt(trimmed) : null;
+}
+export function toOpenRequestRow(request) {
+    const requestId = parseRequestId(request.requestId);
+    if (requestId === null || !isAddress(request.source, { strict: false })) {
+        return null;
+    }
+    return {
+        requestId,
+        source: getAddress(request.source),
+        tokenId: request.tokenId,
+        requestedAt: request.requestedAt,
+    };
+}
+function pickNewestRequest(requests, tokenId, accepts) {
+    let picked = null;
+    for (const request of requests) {
+        if (!sameTokenId(request.tokenId, tokenId) || !accepts(request.source)) {
+            continue;
+        }
+        const row = toOpenRequestRow(request);
+        if (row !== null && (picked === null || row.requestId > picked.requestId)) {
+            picked = row;
+        }
+    }
+    return picked;
+}
+export function pickOpenRequest(requests, source, tokenId) {
+    return pickNewestRequest(requests, tokenId, (candidate) => sameAddress(candidate, source));
+}
+export function pickRetiredSourceRequest(requests, source, tokenId) {
+    return pickNewestRequest(requests, tokenId, (candidate) => !sameAddress(candidate, source));
+}
+//# sourceMappingURL=request.utils.js.map

package/dist/randomness/request.utils.js.map

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

package/dist/randomness/round.utils.d.ts

@@ -0,0 +1,5 @@
+import type { BeaconRoundClock, BeaconWaitPlan } from './types.js';
+export declare function roundReleaseAt(clock: BeaconRoundClock, round: bigint): number;
+export declare function beaconWaitBudgetMs(releaseAt: number, nowSec: number): number;
+export declare function planBeaconWait(clock: BeaconRoundClock, round: bigint, nowSec: number): BeaconWaitPlan;
+//# sourceMappingURL=round.utils.d.ts.map

package/dist/randomness/round.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round.utils.d.ts","sourceRoot":"","sources":["../../src/randomness/round.utils.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAOrG"}

package/dist/randomness/round.utils.js

@@ -0,0 +1,17 @@
+import { BEACON_RETRY_INTERVAL_MS, BEACON_WAIT_BUDGET_FACTOR, BEACON_WAIT_CEILING_MS, MS_PER_SECOND, } from './constants.js';
+export function roundReleaseAt(clock, round) {
+    return clock.genesis + Number(round - 1n) * clock.period;
+}
+export function beaconWaitBudgetMs(releaseAt, nowSec) {
+    const untilRelease = BEACON_WAIT_BUDGET_FACTOR * (releaseAt - nowSec) * MS_PER_SECOND;
+    return Math.min(Math.max(untilRelease, BEACON_RETRY_INTERVAL_MS), BEACON_WAIT_CEILING_MS);
+}
+export function planBeaconWait(clock, round, nowSec) {
+    const releaseAt = roundReleaseAt(clock, round);
+    return {
+        releaseAt,
+        budgetMs: beaconWaitBudgetMs(releaseAt, nowSec),
+        retryDelayMs: BEACON_RETRY_INTERVAL_MS,
+    };
+}
+//# sourceMappingURL=round.utils.js.map

package/dist/randomness/round.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"round.utils.js","sourceRoot":"","sources":["../../src/randomness/round.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,aAAa,GAChB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,UAAU,cAAc,CAAC,KAAuB,EAAE,KAAa;IACjE,OAAO,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,MAAc;IAChE,MAAM,YAAY,GAAG,yBAAyB,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,aAAa,CAAC;IACtF,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,wBAAwB,CAAC,EAAE,sBAAsB,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAuB,EAAE,KAAa,EAAE,MAAc;IACjF,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO;QACH,SAAS;QACT,QAAQ,EAAE,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC;QAC/C,YAAY,EAAE,wBAAwB;KACzC,CAAC;AACN,CAAC"}

package/dist/randomness/self-service.resolver.d.ts

@@ -0,0 +1,9 @@
+import type { ISelfServiceRandomnessResolver, SelfServiceRandomness, SelfServiceRandomnessResolverOptions } from './types.js';
+export declare class SelfServiceRandomnessResolver implements ISelfServiceRandomnessResolver {
+    private readonly appConfig;
+    private readonly randomness;
+    private readonly logger;
+    constructor(options: SelfServiceRandomnessResolverOptions);
+    resolve(): Promise<SelfServiceRandomness | null>;
+}
+//# sourceMappingURL=self-service.resolver.d.ts.map

package/dist/randomness/self-service.resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-service.resolver.d.ts","sourceRoot":"","sources":["../../src/randomness/self-service.resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAER,8BAA8B,EAC9B,qBAAqB,EACrB,oCAAoC,EACvC,MAAM,YAAY,CAAC;AAKpB,qBAAa,6BAA8B,YAAW,8BAA8B;IAChF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,EAAE,oCAAoC;IAMnD,OAAO,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;CAmBzD"}

package/dist/randomness/self-service.resolver.js

@@ -0,0 +1,29 @@
+import { isAddress } from 'viem';
+import { RandomnessKind } from '../api/types.js';
+export class SelfServiceRandomnessResolver {
+    appConfig;
+    randomness;
+    logger;
+    constructor(options) {
+        this.appConfig = options.appConfig;
+        this.randomness = options.randomness;
+        this.logger = options.logger;
+    }
+    async resolve() {
+        const config = await this.appConfig.load();
+        const cell = config.contracts.cell;
+        if (!isAddress(cell, { strict: false })) {
+            throw new Error(`Cell contract is not configured for network ${config.network}; background reveal fulfilment cannot run.`);
+        }
+        const strategy = await this.randomness.create(config.randomness, cell);
+        if (strategy.kind !== RandomnessKind.DRAND) {
+            this.logger.info('reveals on this chain are settled by the randomness source itself, so nothing is swept', {
+                kind: strategy.kind,
+                source: strategy.source,
+            });
+            return null;
+        }
+        return strategy;
+    }
+}
+//# sourceMappingURL=self-service.resolver.js.map

package/dist/randomness/self-service.resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-service.resolver.js","sourceRoot":"","sources":["../../src/randomness/self-service.resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAQjC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,OAAO,6BAA6B;IACrB,SAAS,CAAa;IACtB,UAAU,CAA6B;IACvC,MAAM,CAAU;IAEjC,YAAY,OAA6C;QACrD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,OAAO;QACT,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACX,+CAA+C,MAAM,CAAC,OAAO,4CAA4C,CAC5G,CAAC;QACN,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACvE,IAAI,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC,KAAK,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wFAAwF,EAAE;gBACvG,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;aAC1B,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;CACJ"}