@colin999n9/gworld-agent 0.1.0-alpha.0

package/dist/config.js

@@ -0,0 +1,184 @@
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { getAddress } from 'viem';
+import { AgentError } from './errors.js';
+import { atomicWritePrivateFile } from './fs.js';
+import { getDeployment } from './generated/deployments.js';
+import { parseBigInt, stringifyJson } from './json.js';
+export const ALL_ACTIONS = [
+    'checkin',
+    'claim',
+    'move',
+    'attack',
+    'reinforce',
+    'continueFragmentResolution',
+    'requestMarket',
+    'finalizeMarket',
+    'bet',
+    'settleMarket',
+    'claimMarket',
+];
+export const DEFAULT_ALLOWED_ACTIONS = [
+    'checkin',
+    'claim',
+    'move',
+    'reinforce',
+    'continueFragmentResolution',
+    'finalizeMarket',
+    'settleMarket',
+    'claimMarket',
+];
+export function gworldHome() {
+    return resolve(process.env.GWORLD_HOME ?? join(homedir(), '.gworld'));
+}
+export function configPath(profile = 'default') {
+    assertProfile(profile);
+    return join(gworldHome(), 'profiles', profile, 'config.json');
+}
+function assertProfile(profile) {
+    if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/.test(profile)) {
+        throw new AgentError('config_invalid', 'Profile must contain only letters, numbers, underscore, and hyphen');
+    }
+}
+function localNetwork() {
+    const deployment = getDeployment(31_337);
+    if (!deployment)
+        throw new AgentError('config_invalid', 'Generated local deployment is missing');
+    return {
+        name: 'local',
+        chainId: deployment.chainId,
+        rpcUrl: 'http://127.0.0.1:8545',
+        indexerUrl: 'http://127.0.0.1:42069',
+        routerAddress: deployment.router.address,
+        confirmations: deployment.confirmations,
+    };
+}
+export function networkPreset(name) {
+    switch (name) {
+        case 'local': return localNetwork();
+        case 'testnet': {
+            const deployment = getDeployment(7_771_625);
+            if (!deployment)
+                throw new AgentError('config_invalid', 'Generated Gravity Testnet deployment is missing');
+            return {
+                name: 'testnet',
+                chainId: deployment.chainId,
+                rpcUrl: 'https://testnet-rpc.gravity.xyz',
+                indexerUrl: 'https://gworld-indexer.gravity.xyz',
+                routerAddress: deployment.router.address,
+                confirmations: deployment.confirmations,
+            };
+        }
+        default: return null;
+    }
+}
+export function defaultConfig(profile = 'default') {
+    assertProfile(profile);
+    const root = join(gworldHome(), 'profiles', profile);
+    return {
+        version: 1,
+        profile,
+        network: localNetwork(),
+        wallet: { keystorePath: join(root, 'wallet.json') },
+        runner: {
+            agentId: null,
+            mapRadius: 8,
+            pollIntervalMs: 5_000,
+            actionTtlMs: 30_000,
+            indexingTimeoutMs: 15_000,
+        },
+        policy: {
+            maxApPerRoundCap: 600n,
+            maxGBetPerAction: 0n,
+            maxGSpendPerDay: 0n,
+            maxTransactionsPerRound: 3,
+            allowedAgentIds: [],
+            allowedActions: [...DEFAULT_ALLOWED_ACTIONS],
+            autoExecuteRisk: 'low',
+        },
+        auditPath: join(root, 'audit.jsonl'),
+        statePath: join(root, 'state.json'),
+    };
+}
+function parseUrl(value, label) {
+    try {
+        const url = new URL(String(value));
+        if (url.protocol !== 'http:' && url.protocol !== 'https:')
+            throw new Error();
+        return url.toString().replace(/\/$/, '');
+    }
+    catch {
+        throw new AgentError('config_invalid', `${label} must be an http(s) URL`);
+    }
+}
+export function parseConfig(value) {
+    const wire = value;
+    try {
+        assertProfile(wire.profile);
+        if (wire.version !== 1)
+            throw new Error('version must be 1');
+        if (!Number.isSafeInteger(wire.network.chainId) || wire.network.chainId <= 0)
+            throw new Error('invalid chain id');
+        if (!Number.isInteger(wire.network.confirmations) || wire.network.confirmations < 0)
+            throw new Error('invalid confirmations');
+        if (!Number.isInteger(wire.runner.mapRadius) || wire.runner.mapRadius < 1 || wire.runner.mapRadius > 50) {
+            throw new Error('map radius must be 1..50');
+        }
+        if (!Number.isInteger(wire.runner.pollIntervalMs) || wire.runner.pollIntervalMs < 250)
+            throw new Error('poll interval too low');
+        if (!Number.isInteger(wire.runner.actionTtlMs) || wire.runner.actionTtlMs < 1_000)
+            throw new Error('action ttl too low');
+        if (!Number.isInteger(wire.runner.indexingTimeoutMs) || wire.runner.indexingTimeoutMs < 1_000) {
+            throw new Error('indexing timeout too low');
+        }
+        if (!Number.isInteger(wire.policy.maxTransactionsPerRound) || wire.policy.maxTransactionsPerRound < 0) {
+            throw new Error('invalid transaction limit');
+        }
+        if (!['low', 'medium', 'high'].includes(wire.policy.autoExecuteRisk))
+            throw new Error('invalid risk');
+        if (!wire.policy.allowedActions.every((action) => ALL_ACTIONS.includes(action)))
+            throw new Error('invalid action');
+        const routerAddress = getAddress(wire.network.routerAddress).toLowerCase();
+        return {
+            ...wire,
+            network: {
+                ...wire.network,
+                rpcUrl: parseUrl(wire.network.rpcUrl, 'RPC URL'),
+                indexerUrl: parseUrl(wire.network.indexerUrl, 'Indexer URL'),
+                routerAddress,
+            },
+            runner: { ...wire.runner, agentId: wire.runner.agentId == null ? null : parseBigInt(wire.runner.agentId, 'agentId') },
+            policy: {
+                ...wire.policy,
+                maxApPerRoundCap: parseBigInt(wire.policy.maxApPerRoundCap, 'maxApPerRoundCap'),
+                maxGBetPerAction: parseBigInt(wire.policy.maxGBetPerAction, 'maxGBetPerAction'),
+                maxGSpendPerDay: parseBigInt(wire.policy.maxGSpendPerDay, 'maxGSpendPerDay'),
+                allowedAgentIds: wire.policy.allowedAgentIds.map((id) => parseBigInt(id, 'allowedAgentId')),
+            },
+        };
+    }
+    catch (error) {
+        if (error instanceof AgentError)
+            throw error;
+        throw new AgentError('config_invalid', `Invalid Agent config: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export async function loadConfig(profile = 'default') {
+    const path = configPath(profile);
+    try {
+        return parseConfig(JSON.parse(await readFile(path, 'utf8')));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return defaultConfig(profile);
+        if (error instanceof AgentError)
+            throw error;
+        throw new AgentError('config_invalid', `Cannot load config ${path}`, error);
+    }
+}
+export async function saveConfig(config) {
+    const validated = parseConfig(JSON.parse(stringifyJson(config)));
+    await atomicWritePrivateFile(configPath(validated.profile), `${stringifyJson(validated, 2)}\n`);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/data/indexer-client.d.ts

@@ -0,0 +1,34 @@
+import type { Address, AgentSummary, FragmentView, IndexerSync, MarketView, TileView } from '../domain.js';
+export declare class AgentIndexerClient {
+    private readonly baseUrl;
+    private readonly fetcher;
+    private readonly pollIntervalMs;
+    private readonly sleep;
+    private readonly requestTimeoutMs;
+    constructor(baseUrl: string, fetcher?: typeof fetch, pollIntervalMs?: number, sleep?: (milliseconds: number) => Promise<void>, requestTimeoutMs?: number);
+    private get;
+    status(): Promise<IndexerSync>;
+    waitForBlock(blockNumber: bigint, timeoutMs: number): Promise<IndexerSync>;
+    walletAgents(wallet: Address): Promise<AgentSummary[]>;
+    getAgent(agentId: bigint): Promise<AgentSummary>;
+    world(center: {
+        q: number;
+        r: number;
+    }, radius: number): Promise<{
+        round: bigint;
+        asOfBlock: bigint;
+        sync: IndexerSync;
+        agents: AgentSummary[];
+        tiles: TileView[];
+        fragments: FragmentView[];
+    }>;
+    markets(wallet: Address, limit?: number): Promise<MarketView[]>;
+    market(marketId: bigint, wallet: Address): Promise<MarketView>;
+    marketRequest(round: bigint): Promise<{
+        round: bigint;
+        targetBlock: bigint | null;
+        marketId: bigint | null;
+        state: 'available' | 'too_late' | 'waiting' | 'finalizable' | 'expired' | 'opened';
+        updatedAtBlock: bigint;
+    }>;
+}

package/dist/data/indexer-client.js

@@ -0,0 +1,172 @@
+import { AgentError } from '../errors.js';
+import { parseBigInt } from '../json.js';
+function agent(value) {
+    return {
+        id: parseBigInt(value.id, 'agent id'),
+        owner: value.owner.toLowerCase(),
+        lifecycle: value.lifecycle,
+        position: value.position,
+        territoryCount: parseBigInt(value.territoryCount, 'territory count'),
+        pendingRequest: value.pendingRequest
+            ? { ...value.pendingRequest, rng: value.pendingRequest.rng.toLowerCase(), targetBlock: parseBigInt(value.pendingRequest.targetBlock) }
+            : null,
+    };
+}
+function market(value) {
+    return {
+        id: parseBigInt(value.marketId, 'market id'),
+        sourceAddress: value.sourceAddress.toLowerCase(),
+        writeState: value.writeState,
+        currentRound: parseBigInt(value.currentRound),
+        asOfBlock: parseBigInt(value.asOfBlock),
+        tileKey: parseBigInt(value.tileKey),
+        openRound: parseBigInt(value.openRound),
+        closeRound: parseBigInt(value.closeRound),
+        settleRound: parseBigInt(value.settleRound),
+        status: value.status,
+        totalPoolG: parseBigInt(value.totalPoolG),
+        options: value.options.map((option) => ({
+            index: parseBigInt(option.index),
+            agentId: option.agentId == null ? null : parseBigInt(option.agentId),
+            poolG: parseBigInt(option.poolG),
+        })),
+        winningOption: value.winningOption == null ? null : parseBigInt(value.winningOption),
+        winningPoolG: parseBigInt(value.winningPoolG),
+        finalOwnerAgentId: value.finalOwnerAgentId == null ? null : parseBigInt(value.finalOwnerAgentId),
+        refundable: value.refundable,
+        apRewardCap: parseBigInt(value.apRewardCap),
+        walletPosition: value.walletPosition
+            ? {
+                agentId: parseBigInt(value.walletPosition.agentId),
+                optionIndex: parseBigInt(value.walletPosition.optionIndex),
+                stakeG: parseBigInt(value.walletPosition.stakeG),
+                claimed: value.walletPosition.claimed,
+                payoutG: parseBigInt(value.walletPosition.payoutG),
+                claimedApRewardCap: parseBigInt(value.walletPosition.claimedApRewardCap),
+            }
+            : null,
+    };
+}
+export class AgentIndexerClient {
+    baseUrl;
+    fetcher;
+    pollIntervalMs;
+    sleep;
+    requestTimeoutMs;
+    constructor(baseUrl, fetcher = fetch, pollIntervalMs = 500, sleep = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds)), requestTimeoutMs = 10_000) {
+        this.baseUrl = baseUrl;
+        this.fetcher = fetcher;
+        this.pollIntervalMs = pollIntervalMs;
+        this.sleep = sleep;
+        this.requestTimeoutMs = requestTimeoutMs;
+    }
+    async get(path, query = {}) {
+        const url = new URL(path.replace(/^\/+/, ''), `${this.baseUrl.replace(/\/$/, '')}/`);
+        for (const [name, value] of Object.entries(query))
+            if (value != null)
+                url.searchParams.set(name, String(value));
+        let response;
+        try {
+            response = await this.fetcher.call(globalThis, url, { signal: AbortSignal.timeout(this.requestTimeoutMs) });
+        }
+        catch (error) {
+            throw new AgentError('indexer_unavailable', `Indexer request failed: ${url.pathname}`, error);
+        }
+        if (response.status === 404)
+            throw new AgentError('agent_missing', `Indexer resource not found: ${url.pathname}`);
+        if (!response.ok)
+            throw new AgentError('indexer_unavailable', `Indexer returned HTTP ${response.status}: ${url.pathname}`);
+        const envelope = (await response.json());
+        if (!envelope || !('data' in envelope) || !/^(0|[1-9]\d*)$/.test(String(envelope.asOfBlock))) {
+            throw new AgentError('indexer_unavailable', `Indexer returned an invalid envelope: ${url.pathname}`);
+        }
+        return envelope;
+    }
+    async status() {
+        const { data } = await this.get('/v1/status');
+        return {
+            state: data.state,
+            indexedBlock: parseBigInt(data.indexedBlock),
+            finalizedBlock: parseBigInt(data.finalizedBlock),
+            chainHeadBlock: parseBigInt(data.chainHeadBlock),
+        };
+    }
+    async waitForBlock(blockNumber, timeoutMs) {
+        const startedAt = Date.now();
+        while (true) {
+            const status = await this.status();
+            if (status.state === 'rebuilding')
+                throw new AgentError('indexer_lagging', 'Indexer is rebuilding');
+            if (status.indexedBlock > status.chainHeadBlock) {
+                throw new AgentError('indexer_lagging', 'Indexer cursor is ahead of the current chain head');
+            }
+            if (status.indexedBlock >= blockNumber)
+                return status;
+            if (Date.now() - startedAt >= timeoutMs) {
+                throw new AgentError('indexer_lagging', `Indexer did not reach block ${blockNumber} within ${timeoutMs}ms`);
+            }
+            await this.sleep(this.pollIntervalMs);
+        }
+    }
+    async walletAgents(wallet) {
+        const { data } = await this.get(`/v1/wallets/${wallet}/agents`);
+        return data.map(agent);
+    }
+    async getAgent(agentId) {
+        const { data } = await this.get(`/v1/agents/${agentId}`);
+        return agent(data);
+    }
+    async world(center, radius) {
+        const { data, asOfBlock } = await this.get('/v1/world', { q: center.q, r: center.r, radius });
+        const indexedBlock = parseBigInt(data.sync.indexedBlock);
+        if (indexedBlock !== parseBigInt(asOfBlock))
+            throw new AgentError('indexer_lagging', 'World snapshot has mismatched asOfBlock');
+        return {
+            round: parseBigInt(data.round),
+            asOfBlock: indexedBlock,
+            sync: {
+                state: data.sync.state,
+                indexedBlock,
+                finalizedBlock: parseBigInt(data.sync.finalizedBlock),
+                chainHeadBlock: parseBigInt(data.sync.chainHeadBlock),
+            },
+            agents: data.agents.map(agent),
+            tiles: data.tiles.map((tile) => ({
+                ...tile,
+                key: parseBigInt(tile.key),
+                ownerAgentId: tile.ownerAgentId == null ? null : parseBigInt(tile.ownerAgentId),
+                lastReinforceRound: parseBigInt(tile.lastReinforceRound),
+            })),
+            fragments: data.fragmentResolutions.map((fragment) => ({
+                ...fragment,
+                agentId: parseBigInt(fragment.agentId),
+                jobId: parseBigInt(fragment.jobId),
+                cursor: parseBigInt(fragment.cursor),
+                sourceRound: parseBigInt(fragment.sourceRound),
+                sourceTileCount: parseBigInt(fragment.sourceTileCount),
+                classifiedDrops: parseBigInt(fragment.classifiedDrops),
+                droppedCount: parseBigInt(fragment.droppedCount),
+                updatedAtBlock: parseBigInt(fragment.updatedAtBlock),
+            })),
+        };
+    }
+    async markets(wallet, limit = 20) {
+        const { data } = await this.get('/v1/markets', { limit });
+        return Promise.all(data.map((item) => this.market(parseBigInt(item.marketId), wallet)));
+    }
+    async market(marketId, wallet) {
+        const { data } = await this.get(`/v1/markets/${marketId}`, { wallet });
+        return market(data);
+    }
+    async marketRequest(round) {
+        const { data } = await this.get(`/v1/market-requests/${round}`);
+        return {
+            round: parseBigInt(data.round),
+            targetBlock: data.targetBlock == null ? null : parseBigInt(data.targetBlock),
+            marketId: data.marketId == null ? null : parseBigInt(data.marketId),
+            state: data.state,
+            updatedAtBlock: parseBigInt(data.updatedAtBlock),
+        };
+    }
+}
+//# sourceMappingURL=indexer-client.js.map

package/dist/data/indexer-client.js.map

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

package/dist/data/rpc-reader.d.ts

@@ -0,0 +1,69 @@
+import type { Abi } from 'viem';
+import type { Address, AgentActionState } from '../domain.js';
+type ReadRequest = {
+    address: Address;
+    abi: Abi;
+    functionName: string;
+    args?: readonly unknown[];
+    blockNumber?: bigint;
+};
+export type RunnerPublicClient = {
+    getChainId(): Promise<number>;
+    getBlock(): Promise<{
+        number: bigint;
+        timestamp: bigint;
+    }>;
+    getBalance(args: {
+        address: Address;
+    }): Promise<bigint>;
+    readContract(args: ReadRequest): Promise<unknown>;
+    multicall(args: {
+        contracts: readonly ReadRequest[];
+        allowFailure: false;
+        blockNumber?: bigint;
+    }): Promise<readonly unknown[]>;
+};
+export type WalletAsset = {
+    gToken: Address | null;
+    mode: 'native' | 'erc20';
+    decimals: number;
+    balance: bigint;
+};
+export type MarketPayment = WalletAsset & {
+    market: Address;
+    escrow: Address;
+    allowance: bigint;
+};
+export type StrongTile = {
+    key: bigint;
+    ownerAgentId: bigint | null;
+    storedDefense: number;
+    lastReinforceRound: bigint;
+    activated: boolean;
+};
+export type CurrentModules = {
+    registry: Address;
+    ledger: Address;
+    world: Address;
+    market: Address;
+    escrow: Address;
+};
+export declare class AgentRpcReader {
+    private readonly client;
+    readonly chainId: number;
+    readonly router: Address;
+    constructor(client: RunnerPublicClient, chainId: number, router: Address);
+    assertNetwork(): Promise<void>;
+    block(): Promise<{
+        number: bigint;
+        timestamp: bigint;
+    }>;
+    private many;
+    modules(blockNumber?: bigint): Promise<CurrentModules>;
+    agent(agentId: bigint): Promise<AgentActionState>;
+    tile(tileKey: bigint): Promise<StrongTile>;
+    private assetAt;
+    walletAsset(wallet: Address): Promise<WalletAsset>;
+    marketPayment(marketId: bigint, wallet: Address): Promise<MarketPayment>;
+}
+export {};

package/dist/data/rpc-reader.js

@@ -0,0 +1,163 @@
+import { AgentError } from '../errors.js';
+import { contractAbis } from '../generated/abis.js';
+import { protocolConfig } from '../generated/protocol.js';
+function address(value) {
+    if (typeof value !== 'string' || !/^0x[0-9a-fA-F]{40}$/.test(value)) {
+        throw new AgentError('rpc_unavailable', `Contract returned an invalid address: ${String(value)}`);
+    }
+    return value.toLowerCase();
+}
+function tuple(value, name, index) {
+    return Array.isArray(value) ? value[index] : value[name];
+}
+function coord(value) {
+    return { q: Number(tuple(value, 'q', 0)), r: Number(tuple(value, 'r', 1)) };
+}
+export class AgentRpcReader {
+    client;
+    chainId;
+    router;
+    constructor(client, chainId, router) {
+        this.client = client;
+        this.chainId = chainId;
+        this.router = router;
+    }
+    async assertNetwork() {
+        let actual;
+        try {
+            actual = await this.client.getChainId();
+        }
+        catch (error) {
+            throw new AgentError('rpc_unavailable', 'Unable to read RPC chain id', error);
+        }
+        if (actual !== this.chainId)
+            throw new AgentError('wrong_chain', `RPC chain ${actual} does not match configured chain ${this.chainId}`);
+    }
+    async block() {
+        try {
+            return await this.client.getBlock();
+        }
+        catch (error) {
+            throw new AgentError('rpc_unavailable', 'Unable to read the current block', error);
+        }
+    }
+    async many(requests, blockNumber) {
+        try {
+            return await this.client.multicall({ contracts: requests, allowFailure: false, blockNumber });
+        }
+        catch (error) {
+            const message = error instanceof Error ? `${error.name} ${error.message}` : String(error);
+            if (!message.includes('ChainDoesNotSupportContract') && !message.includes('multicall3'))
+                throw error;
+            return Promise.all(requests.map((request) => this.client.readContract({ ...request, blockNumber })));
+        }
+    }
+    async modules(blockNumber) {
+        const names = ['agentRegistry', 'apLedger', 'worldCore', 'predictionMarket', 'marketEscrow'];
+        const values = await this.many(names.map((functionName) => ({ address: this.router, abi: contractAbis.router, functionName })), blockNumber);
+        return {
+            registry: address(values[0]),
+            ledger: address(values[1]),
+            world: address(values[2]),
+            market: address(values[3]),
+            escrow: address(values[4]),
+        };
+    }
+    async agent(agentId) {
+        try {
+            const block = await this.client.getBlock();
+            const modules = await this.modules(block.number);
+            const [ownerValue, activeValue] = await this.many([
+                { address: modules.registry, abi: contractAbis.registry, functionName: 'ownerOf', args: [agentId] },
+                { address: modules.registry, abi: contractAbis.registry, functionName: 'isActive', args: [agentId] },
+            ], block.number);
+            const active = Boolean(activeValue);
+            const values = await this.many([
+                { address: modules.ledger, abi: contractAbis.ledger, functionName: 'balanceOf', args: [agentId] },
+                { address: modules.ledger, abi: contractAbis.ledger, functionName: 'spentThisRound', args: [agentId] },
+                { address: modules.ledger, abi: contractAbis.ledger, functionName: 'lastCheckinAt', args: [agentId] },
+                { address: modules.world, abi: contractAbis.world, functionName: 'actionNonce', args: [agentId] },
+                { address: modules.world, abi: contractAbis.world, functionName: 'fragmentResolutionOf', args: [agentId] },
+                ...(active
+                    ? [{ address: modules.registry, abi: contractAbis.registry, functionName: 'positionOf', args: [agentId] }]
+                    : []),
+            ], block.number);
+            const fragment = values[4];
+            return {
+                blockNumber: block.number,
+                blockTimestamp: block.timestamp,
+                currentRound: block.number / protocolConfig.turnBlocks,
+                owner: address(ownerValue),
+                active,
+                position: active ? coord(values[5]) : null,
+                apBalanceCap: BigInt(values[0]),
+                spentThisRoundCap: BigInt(values[1]),
+                lastCheckinAt: BigInt(values[2]),
+                actionNonce: BigInt(values[3]),
+                fragment: {
+                    jobId: BigInt(tuple(fragment, 'jobId', 0)),
+                    phase: BigInt(tuple(fragment, 'phase', 1)),
+                    cursor: BigInt(tuple(fragment, 'cursor', 2)),
+                    sourceRound: BigInt(tuple(fragment, 'sourceRound', 3)),
+                    sourceTileCount: BigInt(tuple(fragment, 'sourceTileCount', 4)),
+                    classifiedDrops: BigInt(tuple(fragment, 'classifiedDrops', 5)),
+                },
+            };
+        }
+        catch (error) {
+            if (error instanceof AgentError)
+                throw error;
+            throw new AgentError('rpc_unavailable', `Unable to read Agent ${agentId}`, error);
+        }
+    }
+    async tile(tileKey) {
+        const block = await this.client.getBlock();
+        const modules = await this.modules(block.number);
+        const value = await this.client.readContract({
+            address: modules.world,
+            abi: contractAbis.world,
+            functionName: 'tileOf',
+            args: [tileKey],
+            blockNumber: block.number,
+        });
+        const owner = BigInt(tuple(value, 'owner', 0));
+        return {
+            key: tileKey,
+            ownerAgentId: owner === 0n ? null : owner,
+            storedDefense: Number(tuple(value, 'defense', 1)),
+            lastReinforceRound: BigInt(tuple(value, 'lastReinforceRound', 2)),
+            activated: Boolean(tuple(value, 'activated', 3)),
+        };
+    }
+    async assetAt(escrow, wallet) {
+        const token = address(await this.client.readContract({ address: escrow, abi: contractAbis.escrow, functionName: 'G_TOKEN' }));
+        if (token === '0x0000000000000000000000000000000000000000') {
+            return { gToken: null, mode: 'native', decimals: 18, balance: await this.client.getBalance({ address: wallet }) };
+        }
+        const [balance, decimals] = await this.many([
+            { address: token, abi: contractAbis.erc20, functionName: 'balanceOf', args: [wallet] },
+            { address: token, abi: contractAbis.erc20, functionName: 'decimals' },
+        ]);
+        return { gToken: token, mode: 'erc20', decimals: Number(decimals), balance: BigInt(balance) };
+    }
+    async walletAsset(wallet) {
+        const { escrow } = await this.modules();
+        return this.assetAt(escrow, wallet);
+    }
+    async marketPayment(marketId, wallet) {
+        const { market } = await this.modules();
+        const state = await this.client.readContract({ address: market, abi: contractAbis.market, functionName: 'marketOf', args: [marketId] });
+        const escrow = address(tuple(state, 'escrow', 1));
+        const asset = await this.assetAt(escrow, wallet);
+        const allowance = asset.mode === 'erc20'
+            ? BigInt(await this.client.readContract({
+                address: asset.gToken,
+                abi: contractAbis.erc20,
+                functionName: 'allowance',
+                args: [wallet, escrow],
+            }))
+            : 0n;
+        return { ...asset, market, escrow, allowance };
+    }
+}
+//# sourceMappingURL=rpc-reader.js.map