@playmos/sdk 0.3.10 → 0.3.12

package/dist/server.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 var crypto = require('crypto');
+var viem = require('viem');
 
 // src/webhooks.ts
 
@@ -14,6 +15,11 @@ var PlaymosError = class extends Error {
     Object.setPrototypeOf(this, new.target.prototype);
   }
 };
+var ApiError = class extends PlaymosError {
+  constructor(message, detail) {
+    super("api_error", message, detail);
+  }
+};
 
 // src/webhooks.ts
 var WebhookSignatureError = class extends PlaymosError {
@@ -56,6 +62,117 @@ function verifyWebhook(rawBody, signatureHeader, secret, opts = {}) {
   }
   return JSON.parse(body);
 }
+var toBytes32 = (s) => viem.keccak256(viem.toBytes(s));
+
+// src/hasEntered.ts
+var hasEnteredAbi = [
+  {
+    type: "function",
+    name: "hasEntered",
+    stateMutability: "view",
+    inputs: [
+      { name: "roundId", type: "bytes32" },
+      { name: "identity", type: "bytes32" }
+    ],
+    outputs: [{ type: "bool" }]
+  }
+];
+var HAS_ENTERED_DEFAULT_TIMEOUT_MS = 8e3;
+async function hasEntered(args) {
+  const rpcUrl = typeof args.rpcUrl === "string" ? args.rpcUrl.trim() : "";
+  if (!rpcUrl) {
+    throw new ApiError('hasEntered requires a non-empty "rpcUrl" (server-side only \u2014 no wallet provider)');
+  }
+  if (!args.prizePool || !/^0x[0-9a-fA-F]{40}$/.test(args.prizePool)) {
+    throw new ApiError("hasEntered requires prizePool as a 0x-prefixed 20-byte address");
+  }
+  if (!args.roundKey?.trim() || !args.identity?.trim()) {
+    throw new ApiError("hasEntered requires non-empty roundKey and identity (plain strings, same as enterRound)");
+  }
+  const roundKey = args.roundKey.trim();
+  const identity = args.identity.trim();
+  if (/^0x[0-9a-fA-F]{64}$/.test(roundKey) || /^0x[0-9a-fA-F]{64}$/.test(identity)) {
+    throw new ApiError(
+      "hasEntered requires plain-string roundKey/identity (not 0x+64 hex). Pre-hashed pins diverge from enterRound and from service GET /entered. Pass the same plain pins used at enter.",
+      { prizePool: args.prizePool, roundKey }
+    );
+  }
+  const data = viem.encodeFunctionData({
+    abi: hasEnteredAbi,
+    functionName: "hasEntered",
+    args: [toBytes32(roundKey), toBytes32(identity)]
+  });
+  const timeoutMs = typeof args.timeoutMs === "number" && Number.isFinite(args.timeoutMs) && args.timeoutMs > 0 ? args.timeoutMs : HAS_ENTERED_DEFAULT_TIMEOUT_MS;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  const onExternalAbort = () => controller.abort();
+  if (args.signal) {
+    if (args.signal.aborted) controller.abort();
+    else args.signal.addEventListener("abort", onExternalAbort, { once: true });
+  }
+  let res;
+  try {
+    res = await fetch(rpcUrl, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: 1,
+        method: "eth_call",
+        params: [{ to: args.prizePool, data }, "latest"]
+      }),
+      signal: controller.signal
+    });
+  } catch (e) {
+    const msg = e.message ?? String(e);
+    const aborted = controller.signal.aborted || e.name === "AbortError" || /abort/i.test(msg);
+    throw new ApiError(
+      aborted ? `hasEntered RPC timed out after ${timeoutMs}ms (or was aborted)` : `hasEntered RPC request failed: ${msg}`,
+      { prizePool: args.prizePool, roundKey }
+    );
+  } finally {
+    clearTimeout(timer);
+    if (args.signal) args.signal.removeEventListener("abort", onExternalAbort);
+  }
+  if (!res.ok) {
+    throw new ApiError(`hasEntered RPC HTTP ${res.status}`, {
+      prizePool: args.prizePool,
+      roundKey
+    });
+  }
+  let json;
+  try {
+    json = await res.json();
+  } catch (e) {
+    throw new ApiError(`hasEntered RPC response not JSON: ${e.message}`);
+  }
+  if (json.error || json.result == null || json.result === "") {
+    throw new ApiError(
+      `hasEntered eth_call failed: ${json.error?.message ?? `HTTP ${res.status}`}`,
+      { prizePool: args.prizePool, roundKey }
+    );
+  }
+  if (json.result === "0x" || json.result === "0x0") {
+    throw new ApiError(
+      `hasEntered eth_call returned empty data for pool ${args.prizePool} \u2014 wrong address or no contract code`,
+      { prizePool: args.prizePool, roundKey }
+    );
+  }
+  try {
+    return viem.decodeFunctionResult({
+      abi: hasEnteredAbi,
+      functionName: "hasEntered",
+      data: json.result
+    });
+  } catch (e) {
+    throw new ApiError(
+      `hasEntered eth_call result malformed: ${e.message}`,
+      { prizePool: args.prizePool, roundKey }
+    );
+  }
+}
 
 exports.WebhookSignatureError = WebhookSignatureError;
+exports.enterPathToBytes32 = toBytes32;
+exports.hasEntered = hasEntered;
 exports.verifyWebhook = verifyWebhook;

package/dist/server.d.cts

@@ -1,4 +1,5 @@
-import { Z as PlaymosError, W as WebhookEvent } from './errors-Chizbb96.cjs';
+import { a2 as PlaymosError, W as WebhookEvent } from './errors-CYKgt2VU.cjs';
+export { ad as enterPathToBytes32 } from './errors-CYKgt2VU.cjs';
 
 /**
  * Webhook signature verification (spec §6.2) — server-side only.
@@ -23,4 +24,27 @@ declare function verifyWebhook(rawBody: string | Buffer, signatureHeader: string
     toleranceSeconds?: number;
 }): WebhookEvent;
 
-export { WebhookSignatureError, verifyWebhook };
+interface HasEnteredArgs {
+    prizePool: `0x${string}`;
+    /** Same plain string pin as enterRound roundKey / body roundId. */
+    roundKey: string;
+    /** Same plain string pin as enterRound identity. */
+    identity: string;
+    /** Required JSON-RPC URL for eth_call (server-owned). */
+    rpcUrl: string;
+    /**
+     * Optional deadline for the RPC fetch (ms). Default 8000.
+     * On timeout throws ApiError (never returns false).
+     */
+    timeoutMs?: number;
+    /** Optional AbortSignal; combined with timeoutMs when both set. */
+    signal?: AbortSignal;
+}
+/**
+ * On-chain hasEntered for admit-to-session from a game backend.
+ * @returns true only when the chain read succeeds and returns true.
+ * @throws ApiError when eth_call fails, times out, or response is malformed.
+ */
+declare function hasEntered(args: HasEnteredArgs): Promise<boolean>;
+
+export { type HasEnteredArgs, WebhookSignatureError, hasEntered, verifyWebhook };

package/dist/server.d.ts

@@ -1,4 +1,5 @@
-import { Z as PlaymosError, W as WebhookEvent } from './errors-Chizbb96.js';
+import { a2 as PlaymosError, W as WebhookEvent } from './errors-CYKgt2VU.js';
+export { ad as enterPathToBytes32 } from './errors-CYKgt2VU.js';
 
 /**
  * Webhook signature verification (spec §6.2) — server-side only.
@@ -23,4 +24,27 @@ declare function verifyWebhook(rawBody: string | Buffer, signatureHeader: string
     toleranceSeconds?: number;
 }): WebhookEvent;
 
-export { WebhookSignatureError, verifyWebhook };
+interface HasEnteredArgs {
+    prizePool: `0x${string}`;
+    /** Same plain string pin as enterRound roundKey / body roundId. */
+    roundKey: string;
+    /** Same plain string pin as enterRound identity. */
+    identity: string;
+    /** Required JSON-RPC URL for eth_call (server-owned). */
+    rpcUrl: string;
+    /**
+     * Optional deadline for the RPC fetch (ms). Default 8000.
+     * On timeout throws ApiError (never returns false).
+     */
+    timeoutMs?: number;
+    /** Optional AbortSignal; combined with timeoutMs when both set. */
+    signal?: AbortSignal;
+}
+/**
+ * On-chain hasEntered for admit-to-session from a game backend.
+ * @returns true only when the chain read succeeds and returns true.
+ * @throws ApiError when eth_call fails, times out, or response is malformed.
+ */
+declare function hasEntered(args: HasEnteredArgs): Promise<boolean>;
+
+export { type HasEnteredArgs, WebhookSignatureError, hasEntered, verifyWebhook };

package/dist/server.js

@@ -1,5 +1,7 @@
-import { PlaymosError } from './chunk-UZECDT6F.js';
+import { PlaymosError, ApiError, toBytes32 } from './chunk-2CW4U5YB.js';
+export { toBytes32 as enterPathToBytes32 } from './chunk-2CW4U5YB.js';
 import { timingSafeEqual, createHmac } from 'crypto';
+import { encodeFunctionData, decodeFunctionResult } from 'viem';
 
 var WebhookSignatureError = class extends PlaymosError {
   constructor(message) {
@@ -41,5 +43,111 @@ function verifyWebhook(rawBody, signatureHeader, secret, opts = {}) {
   }
   return JSON.parse(body);
 }
+var hasEnteredAbi = [
+  {
+    type: "function",
+    name: "hasEntered",
+    stateMutability: "view",
+    inputs: [
+      { name: "roundId", type: "bytes32" },
+      { name: "identity", type: "bytes32" }
+    ],
+    outputs: [{ type: "bool" }]
+  }
+];
+var HAS_ENTERED_DEFAULT_TIMEOUT_MS = 8e3;
+async function hasEntered(args) {
+  const rpcUrl = typeof args.rpcUrl === "string" ? args.rpcUrl.trim() : "";
+  if (!rpcUrl) {
+    throw new ApiError('hasEntered requires a non-empty "rpcUrl" (server-side only \u2014 no wallet provider)');
+  }
+  if (!args.prizePool || !/^0x[0-9a-fA-F]{40}$/.test(args.prizePool)) {
+    throw new ApiError("hasEntered requires prizePool as a 0x-prefixed 20-byte address");
+  }
+  if (!args.roundKey?.trim() || !args.identity?.trim()) {
+    throw new ApiError("hasEntered requires non-empty roundKey and identity (plain strings, same as enterRound)");
+  }
+  const roundKey = args.roundKey.trim();
+  const identity = args.identity.trim();
+  if (/^0x[0-9a-fA-F]{64}$/.test(roundKey) || /^0x[0-9a-fA-F]{64}$/.test(identity)) {
+    throw new ApiError(
+      "hasEntered requires plain-string roundKey/identity (not 0x+64 hex). Pre-hashed pins diverge from enterRound and from service GET /entered. Pass the same plain pins used at enter.",
+      { prizePool: args.prizePool, roundKey }
+    );
+  }
+  const data = encodeFunctionData({
+    abi: hasEnteredAbi,
+    functionName: "hasEntered",
+    args: [toBytes32(roundKey), toBytes32(identity)]
+  });
+  const timeoutMs = typeof args.timeoutMs === "number" && Number.isFinite(args.timeoutMs) && args.timeoutMs > 0 ? args.timeoutMs : HAS_ENTERED_DEFAULT_TIMEOUT_MS;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  const onExternalAbort = () => controller.abort();
+  if (args.signal) {
+    if (args.signal.aborted) controller.abort();
+    else args.signal.addEventListener("abort", onExternalAbort, { once: true });
+  }
+  let res;
+  try {
+    res = await fetch(rpcUrl, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: 1,
+        method: "eth_call",
+        params: [{ to: args.prizePool, data }, "latest"]
+      }),
+      signal: controller.signal
+    });
+  } catch (e) {
+    const msg = e.message ?? String(e);
+    const aborted = controller.signal.aborted || e.name === "AbortError" || /abort/i.test(msg);
+    throw new ApiError(
+      aborted ? `hasEntered RPC timed out after ${timeoutMs}ms (or was aborted)` : `hasEntered RPC request failed: ${msg}`,
+      { prizePool: args.prizePool, roundKey }
+    );
+  } finally {
+    clearTimeout(timer);
+    if (args.signal) args.signal.removeEventListener("abort", onExternalAbort);
+  }
+  if (!res.ok) {
+    throw new ApiError(`hasEntered RPC HTTP ${res.status}`, {
+      prizePool: args.prizePool,
+      roundKey
+    });
+  }
+  let json;
+  try {
+    json = await res.json();
+  } catch (e) {
+    throw new ApiError(`hasEntered RPC response not JSON: ${e.message}`);
+  }
+  if (json.error || json.result == null || json.result === "") {
+    throw new ApiError(
+      `hasEntered eth_call failed: ${json.error?.message ?? `HTTP ${res.status}`}`,
+      { prizePool: args.prizePool, roundKey }
+    );
+  }
+  if (json.result === "0x" || json.result === "0x0") {
+    throw new ApiError(
+      `hasEntered eth_call returned empty data for pool ${args.prizePool} \u2014 wrong address or no contract code`,
+      { prizePool: args.prizePool, roundKey }
+    );
+  }
+  try {
+    return decodeFunctionResult({
+      abi: hasEnteredAbi,
+      functionName: "hasEntered",
+      data: json.result
+    });
+  } catch (e) {
+    throw new ApiError(
+      `hasEntered eth_call result malformed: ${e.message}`,
+      { prizePool: args.prizePool, roundKey }
+    );
+  }
+}
 
-export { WebhookSignatureError, verifyWebhook };
+export { WebhookSignatureError, hasEntered, verifyWebhook };

package/package.json

@@ -1,17 +1,12 @@
 {
   "name": "@playmos/sdk",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "description": "Playmos SDK — stablecoin payments for games on Base. One SDK for IAP (1%), skill-game prize-pool entries (10%, 60/30/10), and agent economies. USD in, USDC on-chain, no crypto UX for players.",
   "license": "UNLICENSED",
   "private": false,
-  "homepage": "https://playmos-docs-public.vercel.app/docs",
+  "homepage": "https://playmos-docs-public.vercel.app/",
   "bugs": {
-    "url": "https://playmos-docs-public.vercel.app/docs"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/playmos-labs/playmos-sdk.git",
-    "directory": "sdk"
+    "url": "https://playmos-docs-public.vercel.app/"
   },
   "publishConfig": {
     "access": "public"
@@ -38,6 +33,7 @@
     "dist",
     "!dist/**/*.map",
     "README.md",
+    "CHANGELOG.md",
     "package.json"
   ],
   "scripts": {
@@ -50,13 +46,13 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "viem": "^2.21.0"
+    "viem": "^2.55.11"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
+    "@types/node": "^26.1.2",
     "tsup": "^8.3.0",
     "typescript": "^5.6.0",
-    "vitest": "^2.1.0"
+    "vitest": "^3.2.6"
   },
   "engines": {
     "node": ">=18 <25"

package/dist/chunk-UZECDT6F.js

@@ -1,83 +0,0 @@
-// src/errors.ts
-var PlaymosError = class extends Error {
-  constructor(code, message, detail) {
-    super(message);
-    this.name = new.target.name;
-    this.code = code;
-    this.detail = detail;
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var InvalidAmountError = class extends PlaymosError {
-  constructor(amount) {
-    super(
-      "invalid_amount",
-      `Invalid amount: ${JSON.stringify(amount)}. Provide a positive USD decimal string with at most 2 decimals, e.g. "4.99".`,
-      { amount }
-    );
-  }
-};
-var MissingFieldError = class extends PlaymosError {
-  constructor(field) {
-    super("missing_field", `Missing required field: "${field}".`, { field });
-  }
-};
-var InsufficientGasError = class extends PlaymosError {
-  constructor(detail) {
-    super(
-      "insufficient_gas",
-      `The player's wallet has too little ETH to pay gas. Ask them to add a little ETH, or switch to gas.mode: "sponsored".`,
-      detail
-    );
-  }
-};
-var WalletConnectionError = class extends PlaymosError {
-  constructor(message = "Could not connect the player's wallet.", detail) {
-    super("wallet_connection", message, detail);
-  }
-};
-var WalletTimeoutError = class extends PlaymosError {
-  constructor(message = "The wallet did not respond in time. Ask the player to approve the prompt, or retry.", detail) {
-    super("wallet_timeout", message, detail);
-  }
-};
-var PaymentFailedError = class extends PlaymosError {
-  constructor(message = "The on-chain payment did not complete.", detail) {
-    super("payment_failed", message, detail);
-  }
-};
-var AlreadyEnteredError = class extends PlaymosError {
-  constructor(detail) {
-    super(
-      "already_entered",
-      "This identity already entered this round on-chain. For pay-per-play, pass a unique identity per attempt (not just the wallet address).",
-      detail
-    );
-  }
-};
-var AuthError = class extends PlaymosError {
-  constructor(message = "Invalid or missing API key.", detail) {
-    super("auth", message, detail);
-  }
-};
-var ApiError = class extends PlaymosError {
-  constructor(message, detail) {
-    super("api_error", message, detail);
-  }
-};
-var ConfigError = class extends PlaymosError {
-  constructor(message, detail) {
-    super("config", message, detail);
-  }
-};
-var NothingToWithdrawError = class extends PlaymosError {
-  constructor(detail) {
-    super(
-      "nothing_to_withdraw",
-      "Nothing to withdraw \u2014 this wallet has no credited prize balance on this PrizePool (round not settled for them, or already claimed).",
-      detail
-    );
-  }
-};
-
-export { AlreadyEnteredError, ApiError, AuthError, ConfigError, InsufficientGasError, InvalidAmountError, MissingFieldError, NothingToWithdrawError, PaymentFailedError, PlaymosError, WalletConnectionError, WalletTimeoutError };