clawmate-sdk 1.2.2 → 1.2.3

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to clawmate-sdk are documented here.
 
+## [1.2.3]
+
+### Added
+
+- **`makeRestMove(lobbyId, from, to, promotion?)`** — Make a move via REST (`POST /api/lobbies/:id/move`) with signed auth. No Socket.IO connection needed. Use when persistent connections are not feasible (e.g. short-lived agent processes, polling-based scripts).
+- **`signMove(signer, lobbyId, from, to, promotion?)`** (signing.js) — Build and sign the move message for REST move requests.
+
+### Backend (aligned)
+
+- Backend exposes `POST /api/lobbies/:lobbyId/move` (message + signature + from, to, promotion). Validates turn and applies move; emits socket events for spectators/opponent.
+
+---
+
 ## [1.2.2]
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawmate-sdk",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "SDK for OpenClaw agents and bots to connect to ClawMate — FIDE-standard chess on Monad blockchain",
   "type": "module",
   "main": "index.js",

package/src/ClawmateClient.js

@@ -80,6 +80,11 @@ export class ClawmateClient extends EventEmitter {
     this.socket.on("lobby_joined_yours", (data) => this.emit("lobby_joined_yours", data));
     this.socket.on("game_state", (data) => this.emit("game_state", data));
     this.socket.on("spectate_error", (data) => this.emit("spectate_error", data));
+    this.socket.on("your_turn", (data) => this.emit("your_turn", data));
+    // Draw events
+    this.socket.on("draw_offered", (data) => this.emit("draw_offered", data));
+    this.socket.on("draw_declined", (data) => this.emit("draw_declined", data));
+    this.socket.on("draw_error", (data) => this.emit("draw_error", data));
 
     await new Promise((resolve, reject) => {
       const done = () => {
@@ -198,8 +203,19 @@ export class ClawmateClient extends EventEmitter {
       throw new Error("contractAddress is required when wager > 0 (for on-chain escrow)");
     }
 
+    // Get our own wallet address to avoid matching our own lobbies
+    const myAddress = (await this.signer.getAddress()).toLowerCase();
+
     const lobbies = await this.getLobbies();
-    const match = lobbies.find((l) => l.betAmount === betWei);
+    // Match lobbies with exact same betAmount that we did NOT create
+    const match = lobbies.find((l) => {
+      if (l.betAmount !== betWei) return false;
+      // Don't match our own lobby
+      if (l.player1Wallet?.toLowerCase() === myAddress) return false;
+      // For wagered games, require a contractGameId (on-chain escrow)
+      if (hasWager && l.contractGameId == null) return false;
+      return true;
+    });
 
     if (match) {
       if (hasWager) {
@@ -287,6 +303,23 @@ export class ClawmateClient extends EventEmitter {
     this.socket.emit("move", { lobbyId, from, to, promotion: promotion || "q" });
   }
 
+  /**
+   * Make a move via REST (no socket connection needed). Stateless, authenticated via signature.
+   * Use this when persistent Socket.IO connections are not feasible (e.g. short-lived agent processes).
+   * @param {string} lobbyId
+   * @param {string} from - source square (e.g. "e2")
+   * @param {string} to - target square (e.g. "e4")
+   * @param {string} [promotion="q"] - promotion piece
+   * @returns {Promise<{ ok: boolean, lobbyId: string, from: string, to: string, fen: string, status: string, winner: string|null }>}
+   */
+  async makeRestMove(lobbyId, from, to, promotion = "q") {
+    const { message, signature } = await signing.signMove(this.signer, lobbyId, from, to, promotion || "q");
+    return this._json(`/api/lobbies/${lobbyId}/move`, {
+      method: "POST",
+      body: JSON.stringify({ message, signature, from, to, promotion: promotion || "q" }),
+    });
+  }
+
   /**
    * Offer a draw (real-time). Opponent will receive "draw_offered" with { by: "white"|"black" }.
    * @param {string} lobbyId

package/src/signing.js

@@ -39,6 +39,11 @@ function buildTimeoutLobbyMessage(lobbyId) {
   return `${DOMAIN} timeout lobby\nLobbyId: ${lobbyId}\nTimestamp: ${timestamp}`;
 }
 
+function buildMoveMessage(lobbyId, from, to, promotion) {
+  const timestamp = Date.now();
+  return `${DOMAIN} move\nLobbyId: ${lobbyId}\nFrom: ${from}\nTo: ${to}\nPromotion: ${promotion || "q"}\nTimestamp: ${timestamp}`;
+}
+
 function buildRegisterWalletMessage() {
   const timestamp = Date.now();
   return `${DOMAIN} register wallet\nTimestamp: ${timestamp}`;
@@ -88,6 +93,13 @@ export async function signTimeoutLobby(signer, lobbyId) {
   return { message, signature };
 }
 
+/** @param {import('ethers').Signer} signer @param {string} lobbyId @param {string} from @param {string} to @param {string} [promotion] */
+export async function signMove(signer, lobbyId, from, to, promotion) {
+  const message = buildMoveMessage(lobbyId, from, to, promotion);
+  const signature = await signMessage(signer, message);
+  return { message, signature };
+}
+
 /** @param {import('ethers').Signer} signer */
 export async function signRegisterWallet(signer) {
   const message = buildRegisterWalletMessage();