project-cpu-mcp 0.7.1

package/dist/randomness/types.d.ts

@@ -0,0 +1,181 @@
+import type { Address, Hash, Hex } from 'viem';
+import { z } from 'zod';
+import type { IRevealRequestsReader, RandomnessDescriptor, RandomnessKind } from '../api/types.js';
+import type { ILogger } from '../logger/types.js';
+import type { IAppConfig } from '../services/types.js';
+import type { IContractClient, WalletProvider } from '../wallet/types.js';
+export interface PushRandomness {
+    kind: RandomnessKind.ENTROPY;
+    source: Address;
+    quoteFee(): Promise<bigint>;
+}
+export interface SelfServiceRandomness {
+    kind: RandomnessKind.DRAND;
+    source: Address;
+    clock: BeaconRoundClock;
+    beacon: IBeaconClient;
+    quoteRequestFee(): Promise<bigint>;
+    readRequest(requestId: bigint): Promise<AdapterRequestView>;
+    findOpenRequest(owner: Address, tokenId: string): Promise<OpenRequestMatch | null>;
+    findRetiredSourceRequest(owner: Address, tokenId: string): Promise<OpenRequestMatch | null>;
+    fulfill(input: FulfillmentInput): Promise<FulfillmentResult>;
+}
+export type RandomnessStrategy = PushRandomness | SelfServiceRandomness;
+export interface IRandomnessStrategyFactory {
+    create(descriptor: RandomnessDescriptor, cell: Address): Promise<RandomnessStrategy>;
+}
+export interface PushRandomnessOptions {
+    source: Address;
+    contracts: IContractClient;
+    logger: ILogger;
+}
+export interface SelfServiceRandomnessOptions {
+    source: Address;
+    clock: BeaconRoundClock;
+    beacon: IBeaconClient;
+    contracts: IContractClient;
+    wallet: WalletProvider;
+    revealRequests: IRevealRequestsReader;
+    logger: ILogger;
+}
+export interface RandomnessStrategyFactoryOptions {
+    contracts: IContractClient;
+    wallet: WalletProvider;
+    revealRequests: IRevealRequestsReader;
+    logger: ILogger;
+}
+export declare enum AdapterRequestState {
+    OPEN = "open",
+    CLOSED = "closed"
+}
+export interface AdapterRequestView {
+    state: AdapterRequestState;
+    requestId: bigint;
+    consumer: Address;
+    round: bigint;
+}
+export interface OpenRequestRow {
+    requestId: bigint;
+    source: Address;
+    tokenId: string;
+    requestedAt: number | null;
+}
+export interface OpenRequestMatch extends OpenRequestRow {
+    serverTime: number;
+}
+export interface FulfillmentInput {
+    requestId: bigint;
+    round: bigint;
+    signature: Hex;
+}
+export interface FulfillmentSent {
+    state: AdapterRequestState.OPEN;
+    requestId: bigint;
+    round: bigint;
+    txHash: Hash;
+}
+export interface FulfillmentAlreadyDone {
+    state: AdapterRequestState.CLOSED;
+    requestId: bigint;
+    round: bigint;
+    reason: string;
+}
+export type FulfillmentResult = FulfillmentSent | FulfillmentAlreadyDone;
+export declare enum AdapterErrorName {
+    UNKNOWN_REQUEST = "UnknownRequest",
+    ROUND_MISMATCH = "RoundMismatch",
+    MALFORMED_SIGNATURE = "MalformedSignature",
+    SIGNATURE_DOES_NOT_VERIFY = "SignatureDoesNotVerify",
+    INSUFFICIENT_CALLBACK_GAS = "InsufficientCallbackGas",
+    INSUFFICIENT_FEE = "InsufficientFee"
+}
+export interface AdapterFailure {
+    name: AdapterErrorName;
+    message: string;
+    alreadyFulfilled: boolean;
+}
+export declare enum BeaconRoundOutcome {
+    SIGNED = "signed",
+    NOT_RELEASED = "not_released",
+    MALFORMED = "malformed"
+}
+export interface BeaconRoundSigned {
+    outcome: BeaconRoundOutcome.SIGNED;
+    round: bigint;
+    signature: Hex;
+}
+export interface BeaconRoundNotReleased {
+    outcome: BeaconRoundOutcome.NOT_RELEASED;
+    round: bigint;
+    reason: string;
+}
+export interface BeaconRoundMalformed {
+    outcome: BeaconRoundOutcome.MALFORMED;
+    round: bigint;
+    reason: string;
+}
+export type BeaconRoundResult = BeaconRoundSigned | BeaconRoundNotReleased | BeaconRoundMalformed;
+export interface IBeaconClient {
+    signatureOf(round: bigint): Promise<BeaconRoundResult>;
+}
+export interface BeaconClientOptions {
+    baseUrl: string;
+    logger: ILogger;
+}
+export declare const beaconRoundSchema: z.ZodObject<{
+    round: z.ZodNumber;
+    signature: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    round: number;
+    signature: string;
+}, {
+    round: number;
+    signature: string;
+}>;
+export interface BeaconRoundClock {
+    genesis: number;
+    period: number;
+}
+export interface IFulfilmentClaims {
+    claim(source: Address, requestId: bigint): boolean;
+    release(source: Address, requestId: bigint): void;
+    has(source: Address, requestId: bigint): boolean;
+}
+export interface RequestBackoff {
+    failures: number;
+    nextAttemptAt: number;
+}
+export interface ISelfServiceRandomnessResolver {
+    resolve(): Promise<SelfServiceRandomness | null>;
+}
+export interface SelfServiceRandomnessResolverOptions {
+    appConfig: IAppConfig;
+    randomness: IRandomnessStrategyFactory;
+    logger: ILogger;
+}
+export interface RevealFulfillerOptions {
+    randomness: ISelfServiceRandomnessResolver;
+    revealRequests: IRevealRequestsReader;
+    contracts: IContractClient;
+    wallet: WalletProvider;
+    claims: IFulfilmentClaims;
+    logger: ILogger;
+}
+export interface RevealFulfilmentHandle {
+    stop(): void;
+}
+export interface RevealFulfillerFactoryOptions {
+    appConfig: IAppConfig;
+    randomness: IRandomnessStrategyFactory;
+    revealRequests: IRevealRequestsReader;
+    contracts: IContractClient;
+    wallet: WalletProvider;
+    claims: IFulfilmentClaims;
+    logger: ILogger;
+}
+export interface BeaconWaitPlan {
+    releaseAt: number;
+    budgetMs: number;
+    retryDelayMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/randomness/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACnG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,gBAAgB,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC5D,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACnF,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC5F,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAChE;AAED,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,qBAAqB,CAAC;AAExE,MAAM,WAAW,0BAA0B;IACvC,MAAM,CAAC,UAAU,EAAE,oBAAoB,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACxF;AAED,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,gBAAgB,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,qBAAqB,CAAC;IACtC,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gCAAgC;IAC7C,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,qBAAqB,CAAC;IACtC,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,oBAAY,mBAAmB;IAC3B,IAAI,SAAS;IACb,MAAM,WAAW;CACpB;AAED,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACpD,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,GAAG,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,mBAAmB,CAAC,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,mBAAmB,CAAC,MAAM,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,sBAAsB,CAAC;AAEzE,oBAAY,gBAAgB;IACxB,eAAe,mBAAmB;IAClC,cAAc,kBAAkB;IAChC,mBAAmB,uBAAuB;IAC1C,yBAAyB,2BAA2B;IACpD,yBAAyB,4BAA4B;IACrD,gBAAgB,oBAAoB;CACvC;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;CAC7B;AAED,oBAAY,kBAAkB;IAC1B,MAAM,WAAW;IACjB,YAAY,iBAAiB;IAC7B,SAAS,cAAc;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,GAAG,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,kBAAkB,CAAC,YAAY,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AAElG,MAAM,WAAW,aAAa;IAC1B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACnD,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CACpD;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,8BAA8B;IAC3C,OAAO,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,oCAAoC;IACjD,SAAS,EAAE,UAAU,CAAC;IACtB,UAAU,EAAE,0BAA0B,CAAC;IACvC,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACnC,UAAU,EAAE,8BAA8B,CAAC;IAC3C,cAAc,EAAE,qBAAqB,CAAC;IACtC,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACnC,IAAI,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,6BAA6B;IAC1C,SAAS,EAAE,UAAU,CAAC;IACtB,UAAU,EAAE,0BAA0B,CAAC;IACvC,cAAc,EAAE,qBAAqB,CAAC;IACtC,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACxB"}

package/dist/randomness/types.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export var AdapterRequestState;
+(function (AdapterRequestState) {
+    AdapterRequestState["OPEN"] = "open";
+    AdapterRequestState["CLOSED"] = "closed";
+})(AdapterRequestState || (AdapterRequestState = {}));
+export var AdapterErrorName;
+(function (AdapterErrorName) {
+    AdapterErrorName["UNKNOWN_REQUEST"] = "UnknownRequest";
+    AdapterErrorName["ROUND_MISMATCH"] = "RoundMismatch";
+    AdapterErrorName["MALFORMED_SIGNATURE"] = "MalformedSignature";
+    AdapterErrorName["SIGNATURE_DOES_NOT_VERIFY"] = "SignatureDoesNotVerify";
+    AdapterErrorName["INSUFFICIENT_CALLBACK_GAS"] = "InsufficientCallbackGas";
+    AdapterErrorName["INSUFFICIENT_FEE"] = "InsufficientFee";
+})(AdapterErrorName || (AdapterErrorName = {}));
+export var BeaconRoundOutcome;
+(function (BeaconRoundOutcome) {
+    BeaconRoundOutcome["SIGNED"] = "signed";
+    BeaconRoundOutcome["NOT_RELEASED"] = "not_released";
+    BeaconRoundOutcome["MALFORMED"] = "malformed";
+})(BeaconRoundOutcome || (BeaconRoundOutcome = {}));
+export const beaconRoundSchema = z.object({
+    round: z.number().int().nonnegative(),
+    signature: z.string(),
+});
+//# sourceMappingURL=types.js.map

package/dist/randomness/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/randomness/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsDxB,MAAM,CAAN,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC3B,oCAAa,CAAA;IACb,wCAAiB,CAAA;AACrB,CAAC,EAHW,mBAAmB,KAAnB,mBAAmB,QAG9B;AA0CD,MAAM,CAAN,IAAY,gBAOX;AAPD,WAAY,gBAAgB;IACxB,sDAAkC,CAAA;IAClC,oDAAgC,CAAA;IAChC,8DAA0C,CAAA;IAC1C,wEAAoD,CAAA;IACpD,yEAAqD,CAAA;IACrD,wDAAoC,CAAA;AACxC,CAAC,EAPW,gBAAgB,KAAhB,gBAAgB,QAO3B;AAQD,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC1B,uCAAiB,CAAA;IACjB,mDAA6B,CAAA;IAC7B,6CAAuB,CAAA;AAC3B,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B;AA+BD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import type { AppContext } from './types.js';
+export declare function createServer(context: AppContext): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAoDA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAiI7C,wBAAsB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrE"}

package/dist/server.js

@@ -0,0 +1,185 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import pkg from '../package.json' with { type: 'json' };
+import { registerGetBalanceTool } from './tools/account/get-balance/get-balance.js';
+import { registerAuthenticateTool } from './tools/authenticate.js';
+import { registerBuildTool } from './tools/build/build.js';
+import { registerDemolishTool } from './tools/build/demolish.js';
+import { registerGetGameConfigTool } from './tools/config/get-game-config/get-game-config.js';
+import { registerClaimCraftTool } from './tools/craft/claim/claim-craft.js';
+import { registerCraftTool } from './tools/craft/craft.js';
+import { registerGetCraftStatusTool } from './tools/craft/get-status/get-craft-status.js';
+import { registerListRecipesTool } from './tools/craft/list-recipes/list-recipes.js';
+import { registerGetAttentionTool } from './tools/map/attention/attention.js';
+import { registerGetCellTool } from './tools/map/get-cell/get-cell.js';
+import { registerGetChangesTool } from './tools/map/get-changes/get-changes.js';
+import { registerGetMapTool } from './tools/map/get-map/get-map.js';
+import { registerClaimMiningTool } from './tools/mining/claim/claim-mining.js';
+import { registerGetMiningStatusTool } from './tools/mining/get-status/get-mining-status.js';
+import { registerStartMiningTool } from './tools/mining/start/start-mining.js';
+import { registerMintCellTool } from './tools/mint/mint-cell.js';
+import { registerQuoteMintTool } from './tools/mint/quote/quote-mint.js';
+import { registerFulfillRevealTool } from './tools/reveal/fulfill-reveal.js';
+import { registerRevealTool } from './tools/reveal/reveal.js';
+import { registerQuoteSwapTool } from './tools/swap/quote/quote-swap.js';
+import { registerSwapTool } from './tools/swap/swap.js';
+import { registerCreateSyndicateTool } from './tools/syndicate/create/create-syndicate.js';
+import { registerGetSyndicateTool } from './tools/syndicate/get/get-syndicate.js';
+import { registerJoinSyndicateTool } from './tools/syndicate/join/join-syndicate.js';
+import { registerLeaveSyndicateTool } from './tools/syndicate/leave/leave-syndicate.js';
+import { registerListSyndicatesTool } from './tools/syndicate/list/list-syndicates.js';
+import { registerGetSyndicateMembershipTool } from './tools/syndicate/membership/get-membership.js';
+import { registerSetSyndicateParamsTool } from './tools/syndicate/set-params/set-syndicate-params.js';
+import { registerTransferSyndicateManagerTool } from './tools/syndicate/transfer-manager/transfer-syndicate-manager.js';
+import { registerBuyLotTool } from './tools/trade/buy-lot/buy-lot.js';
+import { registerCancelLotTool } from './tools/trade/cancel-lot/cancel-lot.js';
+import { registerCreateLotTool } from './tools/trade/create-lot/create-lot.js';
+import { registerGetLotTool } from './tools/trade/get-lot/get-lot.js';
+import { registerListLotsTool } from './tools/trade/list-lots/list-lots.js';
+import { registerListMyLotsTool } from './tools/trade/list-mine/list-my-lots.js';
+import { registerGetMarketsTool } from './tools/trade/markets/get-markets.js';
+import { registerQuoteBuyTool } from './tools/trade/quote-buy/quote-buy.js';
+import { registerSetSaleFeeTool } from './tools/trade/set-sale-fee/set-sale-fee.js';
+import { registerFinalizeDeliveryTool } from './tools/transport/finalize/finalize-delivery.js';
+import { registerGetTransportStatusTool } from './tools/transport/get-status/get-transport-status.js';
+import { registerListMyTransportsTool } from './tools/transport/list-mine/list-my-transports.js';
+import { registerRouteNetworkTool } from './tools/transport/network/route-network.js';
+import { registerNextHopsTool } from './tools/transport/next-hops/next-hops.js';
+import { registerQuoteTransportTool } from './tools/transport/quote/quote-transport.js';
+import { registerTransportTool } from './tools/transport/transport.js';
+import { registerWithdrawTool } from './tools/withdraw/withdraw.js';
+import { createBackendVersionGate } from './version/backend-version.js';
+import { createPackageVersionGate } from './version/package-version.js';
+import { createGuardedRegistrar } from './version/tool-guard.js';
+const SERVER_INSTRUCTIONS = [
+    'MCP server for Project CPU (blockchain game on EVM).',
+    'Call `cpu_authenticate` to create a session: in the default EVM mode it signs in via SIWE locally;',
+    'in AGW mode it starts a Device Authorization flow.',
+    'Read the static rulebook once with `cpu_get_game_config` — resource catalog, the building catalog (each',
+    "building's kind, cost, and what it mines or crafts), reveal cost, recipes, and contract addresses.",
+    'The world is a finite sphere of 48,990 land cells identified only by tokenId (1..48990) — there are no',
+    'coordinates; adjacency comes from each cell’s `neighbors` list, and you plan routes yourself. The routing',
+    'loop: PLAN once over `cpu_route_network` (the full waypoint road map — nodes, legal hops, fees, gaps),',
+    'EXECUTE leg by leg re-checking the current position with the cheap `cpu_next_hops` (the world changes',
+    'while goods travel), and VERIFY every chain with `cpu_quote_transport` before spending. Foreign cells are',
+    'never waypoints: a belt of foreign land wider than your hop reach with no hubs is a wall — goods stop at',
+    'the border until you bridge it (a border Hub + a landing point, buying land across, or a detour).',
+    'The world map is loaded at startup and kept current in the background; read it with `cpu_get_map`',
+    '(situational awareness), `cpu_get_cell` (inspect one cell), `cpu_get_changes` (react to other players since a',
+    'given version), and `cpu_get_attention` (your owner-scoped to-do list of stalled/near-full/finished/depleted/',
+    'unbuilt cells + deliveries ready to finalize). You only observe updates when you call these — there is no push.',
+    'Act on a cell you own with `cpu_reveal`, which surfaces its resource deposits on-chain.',
+    'Place a building with `cpu_build` (paid in $CPU, auto-settled on-chain) — an extractor mines a raw deposit, a',
+    'crafter runs a recipe, the Hub routes transport/trade. Building takes time and is not usable until it',
+    'finishes. Once an extractor is ready, start it with `cpu_start_mining` (pick the target resource, or omit it',
+    'for a single-resource extractor, and say how many cycles to run); it then yields a fixed amount of the raw',
+    'resource each cycle — read progress with `cpu_get_mining_status` and bank matured cycles with',
+    '`cpu_claim_mining`. Mining and crafting are both bounded jobs: you book the cycles up front, the job ends',
+    'itself once it has run them (mining also ends early if the deposit runs dry), and there is no cancel — so',
+    'size the run to how long you want that cell committed. A cell runs one job at a time; claiming a finished',
+    'job frees the slot.',
+    'Every resource has a per-cell warehouse with a storage cap. Claims settle in whole cycles, so production',
+    'stalls as soon as the room drops below one whole cycle of output — before the box reads full — and stays',
+    'stalled until you offload it (transport, sell, craft, or withdraw). Stalling burns time, not the schedule:',
+    'the booked cycles survive, the waiting does not. A null cap means uncapped.',
+    '`cpu_get_mining_status`/`cpu_get_craft_status` report the stall; `cpu_get_attention` lists every stalled,',
+    'near-full or finished cell at once.',
+    'Move resources between cells with `cpu_transport` (read `cpu_route_network`, chain waypoints yourself, then preview',
+    'cost with `cpu_quote_transport`) — one on-chain',
+    'move that debits the source, pays the $CPU transit fee for any foreign Hub on the route, and escrows a',
+    'time-delayed delivery. Track deliveries with `cpu_get_transport_status` / `cpu_list_my_transports`; a delivery is',
+    'credited to the target only after it arrives and you call `cpu_finalize_delivery`.',
+    'Refine and forge resources with `cpu_craft` — discover recipes via `cpu_list_recipes` (each shows its',
+    '`costCpu`; a recipe with a non-zero cost auto-approves and settles the $CPU on-chain, the rest are free);',
+    'read progress with `cpu_get_craft_status` and bank matured batches with `cpu_claim_craft`.',
+    'Cash out a cell’s wCPU to the on-chain $CPU token (1:1) with `cpu_withdraw` — one in flight at a time; re-run',
+    'with the same args to finish an interrupted one, and withdraw before selling a cell since wCPU travels',
+    'with it.',
+    'Acquire land cells on the primary market with `cpu_mint_cell` — it mints new cells straight from the',
+    'collection’s OpenSea SeaDrop public drop, paid in native ETH (preview the ETH cost first with `cpu_quote_mint`).',
+    'For the secondary market — buying or selling existing cells — use OpenSea listings off-server: open the',
+    'collection by its `land` contract address from `cpu_get_game_config`',
+    '(https://opensea.io/assets/<chain>/<land>; testnet chains live on testnets.opensea.io). For $CPU itself',
+    'there is no external venue — buy and sell it in-game with `cpu_swap` (below).',
+    'Trade at Hubs: survey the marketplace with `cpu_get_markets` then `cpu_list_lots`, inspect one with `cpu_get_lot`,',
+    'and act with `cpu_create_lot` (list goods), `cpu_buy_lot` (preview cost first with `cpu_quote_buy`), and `cpu_cancel_lot`.',
+    'Each settles on-chain in a single tx and routes its goods through Transport, so they land only after you',
+    '`cpu_finalize_delivery` on the returned deliveryId once it arrives; track your lots with `cpu_list_my_lots`.',
+    'A hub owner takes a per-resource sale fee (a share of each sale, carved out of the seller proceeds — the buyer',
+    'is unaffected); set your own hub rates with `cpu_set_sale_fee` and read others’ live rates in `cpu_get_markets`',
+    'and `cpu_get_cell`. The hub settles its live rate on every sale; when listing, set the highest rate you accept',
+    'with `cpu_create_lot`’s `maxSaleFeePercent` (or omit it to lock in the live rate). If the hub later raises the',
+    'rate above your tolerance the lot freezes — buys revert until it drops back — and `cpu_cancel_lot` is fee-free.',
+    'Join a syndicate to earn same-syndicate discounts on trade and transit: browse with `cpu_list_syndicates`,',
+    'inspect one with `cpu_get_syndicate`, and check any address’s membership with `cpu_get_syndicate_membership`.',
+    '`cpu_join_syndicate` and `cpu_leave_syndicate` manage your own membership (leaving is gated by an exit',
+    'cooldown reported at join time); `cpu_create_syndicate` founds your own (you auto-join), and its manager',
+    'tunes it with `cpu_set_syndicate_params` or hands the role off with `cpu_transfer_syndicate_manager`.',
+    'Check spendable $CPU and gas with `cpu_get_balance` before any paid action.',
+    'A `cpu_withdraw` mints $CPU against an off-chain signature; if it is interrupted, re-run it with the same args',
+    'to finish the pending one rather than starting a second.',
+    'Swap between native ETH and $CPU on the token pool with `cpu_swap` (preview first with `cpu_quote_swap`);',
+    '`sell: "ETH"` buys $CPU and `sell: "CPU"` sells it — the trade auto-settles on-chain.',
+].join(' ');
+// Takes the registrar rather than the server so a tool registered the plain way is a compile error
+// here, not a tool that silently answers past the version gates.
+function registerTools(registrar, context) {
+    registerAuthenticateTool(registrar, context);
+    registerGetGameConfigTool(registrar, context);
+    registerGetMapTool(registrar, context);
+    registerGetCellTool(registrar, context);
+    registerGetChangesTool(registrar, context);
+    registerGetAttentionTool(registrar, context);
+    registerRevealTool(registrar, context);
+    registerFulfillRevealTool(registrar, context);
+    registerBuildTool(registrar, context);
+    registerDemolishTool(registrar, context);
+    registerListRecipesTool(registrar, context);
+    registerCraftTool(registrar, context);
+    registerGetCraftStatusTool(registrar, context);
+    registerClaimCraftTool(registrar, context);
+    registerStartMiningTool(registrar, context);
+    registerGetMiningStatusTool(registrar, context);
+    registerClaimMiningTool(registrar, context);
+    registerRouteNetworkTool(registrar, context);
+    registerNextHopsTool(registrar, context);
+    registerQuoteTransportTool(registrar, context);
+    registerTransportTool(registrar, context);
+    registerListMyTransportsTool(registrar, context);
+    registerGetTransportStatusTool(registrar, context);
+    registerFinalizeDeliveryTool(registrar, context);
+    registerGetMarketsTool(registrar, context);
+    registerListLotsTool(registrar, context);
+    registerGetLotTool(registrar, context);
+    registerListMyLotsTool(registrar, context);
+    registerQuoteBuyTool(registrar, context);
+    registerCreateLotTool(registrar, context);
+    registerBuyLotTool(registrar, context);
+    registerCancelLotTool(registrar, context);
+    registerSetSaleFeeTool(registrar, context);
+    registerListSyndicatesTool(registrar, context);
+    registerGetSyndicateTool(registrar, context);
+    registerGetSyndicateMembershipTool(registrar, context);
+    registerJoinSyndicateTool(registrar, context);
+    registerLeaveSyndicateTool(registrar, context);
+    registerCreateSyndicateTool(registrar, context);
+    registerSetSyndicateParamsTool(registrar, context);
+    registerTransferSyndicateManagerTool(registrar, context);
+    registerQuoteSwapTool(registrar, context);
+    registerSwapTool(registrar, context);
+    registerQuoteMintTool(registrar, context);
+    registerMintCellTool(registrar, context);
+    registerGetBalanceTool(registrar, context);
+    registerWithdrawTool(registrar, context);
+}
+export async function createServer(context) {
+    const server = new McpServer({ name: pkg.name, version: pkg.version }, { instructions: SERVER_INSTRUCTIONS });
+    const gates = [
+        createPackageVersionGate(context.packageVersion),
+        createBackendVersionGate(context.backendVersion),
+    ];
+    registerTools(createGuardedRegistrar(server, gates), context);
+    const stdio = new StdioServerTransport();
+    await server.connect(stdio);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

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

@@ -0,0 +1,2 @@
+export declare const MAX_APPROVE_AMOUNT: bigint;
+//# sourceMappingURL=allowance.constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"allowance.constants.d.ts","sourceRoot":"","sources":["../../src/services/allowance.constants.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,kBAAkB,QAAa,CAAC"}

package/dist/services/allowance.constants.js

@@ -0,0 +1,5 @@
+import { maxUint256 } from 'viem';
+// Approve an unbounded allowance the first time, so subsequent spends find sufficient allowance and skip
+// the (gas-costing) approve transaction.
+export const MAX_APPROVE_AMOUNT = maxUint256;
+//# sourceMappingURL=allowance.constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"allowance.constants.js","sourceRoot":"","sources":["../../src/services/allowance.constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,yGAAyG;AACzG,yCAAyC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC"}

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

@@ -0,0 +1,13 @@
+import { type Address, type Hash } from 'viem';
+import type { AllowanceServiceOptions, IAllowanceService } from './types.js';
+/**
+ * Manages ERC-20 spending allowances for the wallet. Shared by every action that spends a token through
+ * a contract (reveal, build, transport, trade, …) so the approve logic lives in one place.
+ */
+export declare class AllowanceService implements IAllowanceService {
+    private readonly wallet;
+    private readonly logger;
+    constructor(options: AllowanceServiceOptions);
+    ensureAllowance(token: Address, spender: Address, needed: bigint): Promise<Hash | null>;
+}
+//# sourceMappingURL=allowance.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"allowance.service.d.ts","sourceRoot":"","sources":["../../src/services/allowance.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AAGnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAK7E;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,EAAE,uBAAuB;IAOtC,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;CAiChG"}

package/dist/services/allowance.service.js

@@ -0,0 +1,48 @@
+import { encodeFunctionData } from 'viem';
+import { MAX_APPROVE_AMOUNT } from './allowance.constants.js';
+import { ERC20_ABI } from '../contracts/erc20.abi.js';
+import { TxStatus } from '../wallet/types.js';
+/**
+ * Manages ERC-20 spending allowances for the wallet. Shared by every action that spends a token through
+ * a contract (reveal, build, transport, trade, …) so the approve logic lives in one place.
+ */
+export class AllowanceService {
+    wallet;
+    logger;
+    constructor(options) {
+        this.wallet = options.wallet;
+        this.logger = options.logger;
+    }
+    // Ensure `spender` can pull at least `needed` of `token` from the wallet. Approves an unbounded amount
+    // once when the current allowance is short; returns the approve tx hash, or null if none was needed.
+    async ensureAllowance(token, spender, needed) {
+        const wallet = this.wallet.get();
+        const allowance = (await wallet.readContract({
+            address: token,
+            abi: ERC20_ABI,
+            functionName: 'allowance',
+            args: [wallet.getAddress(), spender],
+        }));
+        if (allowance >= needed) {
+            this.logger.info('allowance already sufficient — skipping approve', {
+                token,
+                spender,
+                allowance: allowance.toString(),
+            });
+            return null;
+        }
+        const data = encodeFunctionData({
+            abi: ERC20_ABI,
+            functionName: 'approve',
+            args: [spender, MAX_APPROVE_AMOUNT],
+        });
+        this.logger.info('approving max allowance once', { token, spender });
+        const hash = await wallet.sendTransaction({ to: token, data, value: null, gas: null });
+        const receipt = await wallet.waitForReceipt(hash);
+        if (receipt.status === TxStatus.Reverted) {
+            throw new Error(`Approve transaction reverted on-chain (tx ${hash}).`);
+        }
+        return hash;
+    }
+}
+//# sourceMappingURL=allowance.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"allowance.service.js","sourceRoot":"","sources":["../../src/services/allowance.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA2B,MAAM,MAAM,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAuB,MAAM,oBAAoB,CAAC;AAEnE;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACR,MAAM,CAAiB;IACvB,MAAM,CAAU;IAEjC,YAAY,OAAgC;QACxC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjC,CAAC;IAED,uGAAuG;IACvG,qGAAqG;IACrG,KAAK,CAAC,eAAe,CAAC,KAAc,EAAE,OAAgB,EAAE,MAAc;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAEjC,MAAM,SAAS,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC;YACzC,OAAO,EAAE,KAAK;YACd,GAAG,EAAE,SAAS;YACd,YAAY,EAAE,WAAW;YACzB,IAAI,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC;SACvC,CAAC,CAAW,CAAC;QAEd,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iDAAiD,EAAE;gBAChE,KAAK;gBACL,OAAO;gBACP,SAAS,EAAE,SAAS,CAAC,QAAQ,EAAE;aAClC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,IAAI,GAAG,kBAAkB,CAAC;YAC5B,GAAG,EAAE,SAAS;YACd,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE,CAAC,OAAO,EAAE,kBAAkB,CAAC;SACtC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QACvF,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAElD,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,6CAA6C,IAAI,IAAI,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ"}

package/dist/services/app-config.constants.d.ts

@@ -0,0 +1,2 @@
+export declare const STALE_STAND_CONFIG_HINT = "this stand's config is older than the client";
+//# sourceMappingURL=app-config.constants.d.ts.map

package/dist/services/app-config.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.constants.d.ts","sourceRoot":"","sources":["../../src/services/app-config.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,iDAAiD,CAAC"}

package/dist/services/app-config.constants.js

@@ -0,0 +1,2 @@
+export const STALE_STAND_CONFIG_HINT = "this stand's config is older than the client";
+//# sourceMappingURL=app-config.constants.js.map

package/dist/services/app-config.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.constants.js","sourceRoot":"","sources":["../../src/services/app-config.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,8CAA8C,CAAC"}

package/dist/services/app-config.service.d.ts

@@ -0,0 +1,12 @@
+import type { AppConfig, AppConfigServiceOptions, IAppConfig } from './types.js';
+export declare class AppConfigService implements IAppConfig {
+    private readonly api;
+    private readonly network;
+    private readonly logger;
+    private cached;
+    constructor(options: AppConfigServiceOptions);
+    load(): Promise<AppConfig>;
+    replace(config: AppConfig): void;
+    fetch(): Promise<AppConfig>;
+}
+//# sourceMappingURL=app-config.service.d.ts.map

package/dist/services/app-config.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.service.d.ts","sourceRoot":"","sources":["../../src/services/app-config.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAOjF,qBAAa,gBAAiB,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,MAAM,CAA0B;gBAE5B,OAAO,EAAE,uBAAuB;IAMtC,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC;IAchC,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAI1B,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC;CAoDpC"}

package/dist/services/app-config.service.js

@@ -0,0 +1,78 @@
+import { normalizeOptionalAddress, parseRandomnessDescriptor, toModeSwitchView } from './app-config.utils.js';
+import { appConfigResponseSchema, HttpStatus } from '../api/types.js';
+import { bpToPercent } from '../utils/format.utils.js';
+export class AppConfigService {
+    api;
+    network;
+    logger;
+    cached = null;
+    constructor(options) {
+        this.api = options.api;
+        this.network = options.network;
+        this.logger = options.logger;
+    }
+    async load() {
+        if (this.cached !== null) {
+            return this.cached;
+        }
+        const config = await this.fetch();
+        if (this.cached !== null) {
+            return this.cached;
+        }
+        this.replace(config);
+        return config;
+    }
+    replace(config) {
+        this.cached = config;
+    }
+    async fetch() {
+        this.logger.info('loading chain config', { network: this.network });
+        const { status, data } = await this.api.request(`/api/v1/config?network=${this.network}`);
+        if (status !== HttpStatus.Ok) {
+            throw new Error(`Failed to load chain config (HTTP ${status}) for network ${this.network}.`);
+        }
+        appConfigResponseSchema.parse(data);
+        // Addresses ship empty until their contracts are deployed; each paid action validates the address it
+        // needs (`isAddress`) before sending, so read-only tools keep working before a deployment lands.
+        const config = {
+            network: this.network,
+            chainId: data.chainId,
+            contracts: {
+                land: data.contracts.land,
+                cpuToken: data.contracts.cpuToken,
+                cpuHook: data.contracts.cpuHook,
+                cell: data.contracts.cell,
+                cellLens: data.contracts.cellLens,
+                transport: data.contracts.transport,
+                trade: data.contracts.trade,
+                syndicate: normalizeOptionalAddress(data.contracts.syndicate),
+            },
+            randomness: parseRandomnessDescriptor(data.randomness),
+            resources: data.resources ?? {},
+            recipes: data.recipes ?? [],
+            // Default demolishCost so a client running against an older API (no demolish field) degrades to a
+            // free/no-op demolish pre-check rather than crashing on `undefined.cpu`; the chain stays the arbiter.
+            buildings: (data.buildings ?? []).map((b) => ({
+                ...b,
+                demolishCost: b.demolishCost ?? { cpu: '0', inputs: [] },
+                modeSwitch: toModeSwitchView(b.modeSwitchCost),
+                recipeOpexCpu: b.recipeOpexCpu ?? null,
+            })),
+            reveal: data.reveal ?? { firstFree: true, reRevealCost: '0' },
+            transport: {
+                moveRadius: data.transport.moveRadius,
+                hubRadius: data.transport.hubRadius,
+                moveTimePerCellSec: data.transport.moveTimePerCellSec,
+                moveFeeFloors: data.transport.moveFeeFloors,
+            },
+            trade: {
+                saleBurnPercent: data.trade?.saleBurnPercent ?? 0,
+                maxSaleFeePercent: bpToPercent(data.trade?.maxSaleFeeBp ?? 0),
+            },
+            storage: { hubStorageMultiplier: data.storage.hubStorageMultiplier },
+        };
+        this.logger.info('chain config loaded', { chainId: config.chainId });
+        return config;
+    }
+}
+//# sourceMappingURL=app-config.service.js.map