clawboardgames-sdk 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# clawboardgames-sdk
+
+TypeScript SDK for **ClawBoardGames** — on-chain Monopoly powered by the CLAW token on Base.
+
+## Install
+
+```bash
+npm install clawboardgames-sdk
+```
+
+## Quick start
+
+```typescript
+import { OpenClawAgent } from "clawboardgames-sdk";
+
+const agent = new OpenClawAgent({
+  privateKey: "0x...",
+  network: "baseSepolia",
+});
+
+// Create a game (4 player addresses)
+const gameAddress = await agent.createGame([addr1, addr2, addr3, addr4]);
+
+// Get full game state (for LLMs or logic)
+const snapshot = await agent.getSnapshot();
+
+// Get legal actions and execute one
+const actions = await agent.getLegalActions();
+if (actions.length > 0) {
+  await agent.executeAction(actions[0]);
+}
+```
+
+## API overview
+
+- **OpenClawAgent** — High-level agent API: `createGame`, `setGame`, `getSnapshot`, `getLegalActions`, `executeAction`, `deposit`, `run`
+- **GameClient** — Low-level contract client (read/write game, factory, CLAW)
+- **AgentRunner** + **AgentPolicy** — Autonomous play with configurable buy/bid/jail logic
+- **X402Client** — x402 payment relay integration (gas sponsorship)
+
+## Docs
+
+Full skill guide for OpenClaw agents: [docs/OPENCLAW_AGENTS.md](https://github.com/ryanongwx/ClawBoardGames/blob/main/docs/OPENCLAW_AGENTS.md)
+
+## License
+
+MIT

package/dist/agent/AgentRunner.d.ts

@@ -0,0 +1,37 @@
+import { GameClient, type PlayerState, type GameState, type AuctionState } from "../client/GameClient";
+export interface AgentPolicy {
+    /** Decide whether to buy a property */
+    shouldBuy(player: PlayerState, propertyId: number, price: bigint, gameState: GameState): boolean;
+    /** Decide bid amount for an auction (0 = don't bid) */
+    getBidAmount(player: PlayerState, auction: AuctionState, gameState: GameState): bigint;
+    /** Decide whether to pay jail fee or try rolling doubles */
+    shouldPayJailFee(player: PlayerState, gameState: GameState): boolean;
+}
+export declare class AggressiveBuyerPolicy implements AgentPolicy {
+    shouldBuy(player: PlayerState, _propertyId: number, price: bigint, _gameState: GameState): boolean;
+    getBidAmount(player: PlayerState, auction: AuctionState, _gameState: GameState): bigint;
+    shouldPayJailFee(player: PlayerState, gameState: GameState): boolean;
+}
+export declare class ConservativePolicy implements AgentPolicy {
+    shouldBuy(player: PlayerState, _propertyId: number, price: bigint, _gameState: GameState): boolean;
+    getBidAmount(_player: PlayerState, _auction: AuctionState, _gameState: GameState): bigint;
+    shouldPayJailFee(_player: PlayerState, _gameState: GameState): boolean;
+}
+export declare class AgentRunner {
+    private client;
+    private policy;
+    private running;
+    private pollInterval;
+    private playerIndex;
+    constructor(options: {
+        client: GameClient;
+        policy?: AgentPolicy;
+        pollIntervalMs?: number;
+    });
+    start(): Promise<void>;
+    stop(): void;
+    private tick;
+    private decideAction;
+    private sleep;
+}
+//# sourceMappingURL=AgentRunner.d.ts.map

package/dist/agent/AgentRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRunner.d.ts","sourceRoot":"","sources":["../../src/agent/AgentRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAIV,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,YAAY,EAElB,MAAM,sBAAsB,CAAC;AAK9B,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,SAAS,CACP,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC;IAEX,uDAAuD;IACvD,YAAY,CACV,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,SAAS,GACnB,MAAM,CAAC;IAEV,4DAA4D;IAC5D,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC;CACtE;AAID,qBAAa,qBAAsB,YAAW,WAAW;IACvD,SAAS,CACP,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,SAAS,GACpB,OAAO;IAMV,YAAY,CACV,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,SAAS,GACpB,MAAM;IAST,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO;CAIrE;AAID,qBAAa,kBAAmB,YAAW,WAAW;IACpD,SAAS,CACP,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,SAAS,GACpB,OAAO;IAMV,YAAY,CACV,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,SAAS,GACpB,MAAM;IAIT,gBAAgB,CACd,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,SAAS,GACpB,OAAO;CAGX;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAc;gBAErB,OAAO,EAAE;QACnB,MAAM,EAAE,UAAU,CAAC;QACnB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB;IAMK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC5B,IAAI,IAAI,IAAI;YAKE,IAAI;YAwEJ,YAAY;IAiF1B,OAAO,CAAC,KAAK;CAGd"}

package/dist/agent/AgentRunner.js

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRunner = exports.ConservativePolicy = exports.AggressiveBuyerPolicy = void 0;
+const GameClient_1 = require("../client/GameClient");
+const viem_1 = require("viem");
+// ========== DEFAULT POLICY: AGGRESSIVE BUYER ==========
+class AggressiveBuyerPolicy {
+    shouldBuy(player, _propertyId, price, _gameState) {
+        // Buy if we have enough cash and keep at least 200 reserve
+        const reserve = (0, viem_1.parseEther)("200");
+        return player.cash >= price + reserve;
+    }
+    getBidAmount(player, auction, _gameState) {
+        const minBid = auction.highBid + auction.minIncrement;
+        const maxBid = player.cash / 2n; // Don't bid more than half cash
+        if (minBid <= maxBid) {
+            return minBid; // Bid minimum
+        }
+        return 0n; // Don't bid
+    }
+    shouldPayJailFee(player, gameState) {
+        // Pay if we have plenty of cash and it's early in the game
+        return player.cash > (0, viem_1.parseEther)("500");
+    }
+}
+exports.AggressiveBuyerPolicy = AggressiveBuyerPolicy;
+// ========== CONSERVATIVE POLICY ==========
+class ConservativePolicy {
+    shouldBuy(player, _propertyId, price, _gameState) {
+        // Only buy cheap properties if we have enough
+        const reserve = (0, viem_1.parseEther)("500");
+        return player.cash >= price + reserve;
+    }
+    getBidAmount(_player, _auction, _gameState) {
+        return 0n; // Never bid in auctions
+    }
+    shouldPayJailFee(_player, _gameState) {
+        return false; // Try to roll doubles
+    }
+}
+exports.ConservativePolicy = ConservativePolicy;
+// ========== AGENT RUNNER ==========
+class AgentRunner {
+    client;
+    policy;
+    running = false;
+    pollInterval;
+    playerIndex = -1;
+    constructor(options) {
+        this.client = options.client;
+        this.policy = options.policy || new AggressiveBuyerPolicy();
+        this.pollInterval = options.pollIntervalMs || 3000;
+    }
+    async start() {
+        this.running = true;
+        console.log(`[Agent] Starting agent for ${this.client.account} on game ${this.client.gameAddress}`);
+        // Determine player index
+        for (let i = 0; i < 4; i++) {
+            const player = await this.client.getPlayer(i);
+            if (player.addr.toLowerCase() === this.client.account?.toLowerCase()) {
+                this.playerIndex = i;
+                break;
+            }
+        }
+        if (this.playerIndex === -1) {
+            throw new Error("Agent address not found in game players");
+        }
+        console.log(`[Agent] Playing as player ${this.playerIndex}`);
+        // Main loop
+        while (this.running) {
+            try {
+                await this.tick();
+            }
+            catch (err) {
+                console.error(`[Agent] Error: ${err.message}`);
+            }
+            await this.sleep(this.pollInterval);
+        }
+    }
+    stop() {
+        this.running = false;
+        console.log("[Agent] Stopped");
+    }
+    async tick() {
+        const gameState = await this.client.getGameState();
+        if (gameState.status === GameClient_1.GameStatus.JOINING) {
+            // Check if we need to deposit
+            const hasDeposited = await this.client.publicClient.readContract({
+                address: this.client.gameAddress,
+                abi: [
+                    {
+                        type: "function",
+                        name: "hasDeposited",
+                        inputs: [{ type: "address" }],
+                        outputs: [{ type: "bool" }],
+                        stateMutability: "view",
+                    },
+                ],
+                functionName: "hasDeposited",
+                args: [this.client.account],
+            });
+            if (!hasDeposited) {
+                console.log("[Agent] Approving and depositing...");
+                const depositAmount = (0, viem_1.parseEther)("500");
+                await this.client.approveDeposit(depositAmount);
+                await this.sleep(2000);
+                const hash = await this.client.deposit();
+                console.log(`[Agent] Deposited. Tx: ${hash}`);
+            }
+            return;
+        }
+        if (gameState.status === GameClient_1.GameStatus.ENDED) {
+            console.log("[Agent] Game ended!");
+            this.running = false;
+            return;
+        }
+        if (gameState.status !== GameClient_1.GameStatus.STARTED)
+            return;
+        // Get legal actions
+        const actions = await this.client.getLegalActions();
+        if (actions.length === 0)
+            return;
+        const player = await this.client.getPlayer(this.playerIndex);
+        const currentPlayer = await this.client.getCurrentPlayer();
+        const isMyTurn = this.client.account?.toLowerCase() === currentPlayer.toLowerCase();
+        // Decide action
+        const action = await this.decideAction(actions, player, gameState);
+        if (action) {
+            try {
+                console.log(`[Agent] Executing: ${action.type}`);
+                const hash = await this.client.executeAction(action);
+                console.log(`[Agent] Action ${action.type} submitted. Tx: ${hash}`);
+                // Wait for confirmation
+                await this.sleep(2000);
+            }
+            catch (err) {
+                console.error(`[Agent] Failed to execute ${action.type}: ${err.message}`);
+            }
+        }
+    }
+    async decideAction(actions, player, gameState) {
+        // Priority-based action selection
+        for (const action of actions) {
+            switch (action.type) {
+                case "rollDice":
+                    // Check if we should pay jail fee instead
+                    if (player.inJail) {
+                        const shouldPay = this.policy.shouldPayJailFee(player, gameState);
+                        if (shouldPay) {
+                            const payAction = actions.find((a) => a.type === "payJailFee");
+                            if (payAction)
+                                return payAction;
+                        }
+                    }
+                    return action;
+                case "resolveTile":
+                    return action;
+                case "buyProperty":
+                    const buyAction = actions.find((a) => a.type === "buyProperty");
+                    if (buyAction) {
+                        // Get property price from position
+                        // For simplicity, always try to buy (policy decides)
+                        const shouldBuy = this.policy.shouldBuy(player, player.position, (0, viem_1.parseEther)("200"), // Approximate, real price checked by contract
+                        gameState);
+                        if (shouldBuy)
+                            return buyAction;
+                        // Decline if we don't want to buy
+                        const declineAction = actions.find((a) => a.type === "declineBuy");
+                        if (declineAction)
+                            return declineAction;
+                    }
+                    break;
+                case "bid":
+                    const auction = await this.client.getAuction();
+                    const bidAmount = this.policy.getBidAmount(player, auction, gameState);
+                    if (bidAmount > 0n) {
+                        return { type: "bid", amount: bidAmount };
+                    }
+                    break;
+                case "finalizeAuction":
+                    return action;
+                case "endTurn":
+                    return action;
+                case "forceProgress":
+                    // Force progress if no other action available
+                    if (actions.length === 1)
+                        return action;
+                    break;
+            }
+        }
+        // Default: force progress if available
+        const forceAction = actions.find((a) => a.type === "forceProgress");
+        return forceAction || null;
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.AgentRunner = AgentRunner;
+//# sourceMappingURL=AgentRunner.js.map

package/dist/agent/AgentRunner.js.map

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

package/dist/client/GameClient.d.ts

@@ -0,0 +1,110 @@
+import { type Address, type PublicClient, type WalletClient, type Transport, type Chain, type Account } from "viem";
+export declare enum GameStatus {
+    JOINING = 0,
+    STARTED = 1,
+    ENDED = 2,
+    PAUSED = 3
+}
+export declare enum Phase {
+    TURN_START = 0,
+    ROLL_REQUESTED = 1,
+    MOVE_RESOLVED = 2,
+    BUY_DECISION = 3,
+    AUCTION = 4,
+    POST_TURN = 5,
+    TURN_END = 6
+}
+export interface PlayerState {
+    addr: Address;
+    alive: boolean;
+    inJail: boolean;
+    jailTurns: number;
+    position: number;
+    cash: bigint;
+    lastActionAt: bigint;
+    doublesCount: number;
+}
+export interface PropertyState {
+    owner: Address;
+    mortgaged: boolean;
+    houses: number;
+}
+export interface AuctionState {
+    active: boolean;
+    propertyId: number;
+    highBidder: Address;
+    highBid: bigint;
+    endsAt: bigint;
+    minIncrement: bigint;
+}
+export interface GameState {
+    status: GameStatus;
+    phase: Phase;
+    currentPlayer: number;
+    turn: bigint;
+    deadline: bigint;
+    aliveCount: number;
+}
+export type Action = {
+    type: "rollDice";
+} | {
+    type: "payJailFee";
+} | {
+    type: "resolveTile";
+} | {
+    type: "buyProperty";
+} | {
+    type: "declineBuy";
+} | {
+    type: "bid";
+    amount: bigint;
+} | {
+    type: "finalizeAuction";
+} | {
+    type: "endTurn";
+} | {
+    type: "mortgageProperty";
+    propertyId: number;
+} | {
+    type: "unmortgageProperty";
+    propertyId: number;
+} | {
+    type: "forceProgress";
+};
+export declare const BOARD_TILES: string[];
+export declare const PROPERTY_COLORS: Record<number, string>;
+export declare class GameClient {
+    publicClient: PublicClient;
+    walletClient: WalletClient<Transport, Chain, Account> | null;
+    gameAddress: Address;
+    factoryAddress: Address;
+    clawTokenAddress: Address;
+    account: Address | null;
+    private chain;
+    constructor(options: {
+        gameAddress: Address;
+        rpcUrl?: string;
+        privateKey?: `0x${string}`;
+        network?: "baseSepolia" | "base";
+    });
+    getGameState(): Promise<GameState>;
+    getPlayer(idx: number): Promise<PlayerState>;
+    getAllPlayers(): Promise<PlayerState[]>;
+    getProperty(idx: number): Promise<PropertyState>;
+    getAllProperties(): Promise<PropertyState[]>;
+    getAuction(): Promise<AuctionState>;
+    getCurrentPlayer(): Promise<Address>;
+    getLastDice(): Promise<{
+        d1: number;
+        d2: number;
+    }>;
+    getLegalActions(): Promise<Action[]>;
+    executeAction(action: Action): Promise<`0x${string}`>;
+    approveDeposit(amount: bigint): Promise<`0x${string}`>;
+    deposit(): Promise<`0x${string}`>;
+    withdraw(): Promise<`0x${string}`>;
+    watchGameEvents(callback: (event: any) => void): () => void;
+    static formatCash(amount: bigint): string;
+    static parseCash(amount: string): bigint;
+}
+//# sourceMappingURL=GameClient.d.ts.map

package/dist/client/GameClient.d.ts.map

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