@playmos/sdk 0.3.8 → 0.3.9

package/dist/index.cjs

@@ -265,6 +265,112 @@ function validateMetadata(metadata) {
   return out;
 }
 
+// src/payout.ts
+var PayoutError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.code = "payout_invalid";
+    this.name = "PayoutError";
+  }
+};
+var ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
+var BPS = 10000n;
+function requireAddress(w, i) {
+  if (!ADDRESS_RE.test(w)) {
+    throw new PayoutError(`ranking[${i}] must be a 0x-prefixed 20-byte address, got: ${JSON.stringify(w)}`);
+  }
+  return w.toLowerCase();
+}
+function parseUsdToMicroLoose(amount) {
+  if (typeof amount !== "string" || !/^\d+(\.\d{1,6})?$/.test(amount.trim())) {
+    throw new PayoutError(`invalid USD amount: ${JSON.stringify(amount)}`);
+  }
+  const [wholeRaw, frac = ""] = amount.trim().split(".");
+  const whole = wholeRaw ?? "0";
+  const fracPadded = (frac + "000000").slice(0, 6);
+  const micro = BigInt(whole) * 1000000n + BigInt(fracPadded);
+  if (micro <= 0n) throw new PayoutError(`amount must be > 0, got: ${JSON.stringify(amount)}`);
+  return micro;
+}
+function computePayout(pool, ranking, rule) {
+  if (typeof pool !== "bigint" || pool <= 0n) {
+    throw new PayoutError(`pool must be a positive bigint (micro-USDC), got: ${String(pool)}`);
+  }
+  if (!Array.isArray(ranking) || ranking.length === 0) {
+    throw new PayoutError("ranking must be a non-empty array of wallets (best-first)");
+  }
+  const wallets = ranking.map((w, i) => requireAddress(w, i));
+  const seen = /* @__PURE__ */ new Set();
+  for (const w of wallets) {
+    if (seen.has(w)) throw new PayoutError(`duplicate wallet in ranking: ${w}`);
+    seen.add(w);
+  }
+  if (rule.kind === "winner-take-all") {
+    return [{ wallet: wallets[0], amount: pool }];
+  }
+  if (rule.kind === "top-n") {
+    const splits = rule.splitsBps;
+    if (!Array.isArray(splits) || splits.length === 0) {
+      throw new PayoutError("top-n splitsBps must be a non-empty array");
+    }
+    if (splits.length > wallets.length) {
+      throw new PayoutError(
+        `top-n needs ${splits.length} ranked wallets but ranking only has ${wallets.length}`
+      );
+    }
+    let sumBps = 0;
+    for (const b of splits) {
+      if (!Number.isInteger(b) || b <= 0 || b > 1e4) {
+        throw new PayoutError(`each splitsBps entry must be an integer in (0, 10000], got: ${b}`);
+      }
+      sumBps += b;
+    }
+    if (sumBps !== 1e4) {
+      throw new PayoutError(`splitsBps must sum to 10000, got ${sumBps}`);
+    }
+    const out = [];
+    let allocated = 0n;
+    for (let i = 0; i < splits.length; i++) {
+      const amt = pool * BigInt(splits[i]) / BPS;
+      out.push({ wallet: wallets[i], amount: amt });
+      allocated += amt;
+    }
+    const remainder = pool - allocated;
+    if (remainder < 0n) throw new PayoutError("internal: allocated more than pool");
+    out[0] = { wallet: out[0].wallet, amount: out[0].amount + remainder };
+    const filtered = out.filter((x) => x.amount > 0n);
+    if (filtered.length === 0) throw new PayoutError("payout produced no positive amounts");
+    const total = filtered.reduce((s, x) => s + x.amount, 0n);
+    if (total !== pool) throw new PayoutError(`internal: sum ${total} != pool ${pool}`);
+    return filtered;
+  }
+  if (rule.kind === "custom") {
+    const amounts = rule.amounts;
+    if (!Array.isArray(amounts) || amounts.length === 0) {
+      throw new PayoutError("custom amounts must be a non-empty array of USD strings");
+    }
+    if (amounts.length > wallets.length) {
+      throw new PayoutError(
+        `custom amounts has ${amounts.length} entries but ranking only has ${wallets.length}`
+      );
+    }
+    const out = [];
+    let total = 0n;
+    for (let i = 0; i < amounts.length; i++) {
+      const amt = parseUsdToMicroLoose(amounts[i]);
+      out.push({ wallet: wallets[i], amount: amt });
+      total += amt;
+    }
+    if (total !== pool) {
+      throw new PayoutError(
+        `custom amounts sum to ${total} micro-USDC but pool is ${pool} \u2014 must match exactly`
+      );
+    }
+    return out;
+  }
+  throw new PayoutError(`unknown payout rule kind: ${JSON.stringify(rule.kind)}`);
+}
+
 // src/http.ts
 function resolveRetry(retry) {
   const off = { maxRetries: 0, baseDelayMs: 500, maxDelayMs: 2e4 };
@@ -788,12 +894,12 @@ function mockVerifyResult(payment) {
 }
 
 // src/x402.ts
-var ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
-function requireAddress(value, field) {
+var ADDRESS_RE2 = /^0x[0-9a-fA-F]{40}$/;
+function requireAddress2(value, field) {
   if (typeof value !== "string" || value.trim() === "") {
     throw new MissingFieldError(field);
   }
-  if (!ADDRESS_RE.test(value)) {
+  if (!ADDRESS_RE2.test(value)) {
     throw new ConfigError(`${field} must be a 0x-prefixed 20-byte address, got: ${JSON.stringify(value)}`, {
       field,
       value
@@ -863,7 +969,7 @@ function createX402Challenge(requirement, extras) {
   if (typeof requirement.id !== "string" || !requirement.id.startsWith("preq_")) {
     throw new ConfigError('PaymentRequirement.id must be a "preq_\u2026" string', { id: requirement.id });
   }
-  requireAddress(requirement.payTo, "payTo");
+  requireAddress2(requirement.payTo, "payTo");
   parseUsdToMicro(requirement.amount);
   const feeBps = extras?.feeBps ?? 0;
   if (!Number.isInteger(feeBps) || feeBps < 0 || feeBps > 1e4) {
@@ -873,7 +979,7 @@ function createX402Challenge(requirement, extras) {
     );
   }
   const feeSink = extras?.feeSink ?? null;
-  if (feeBps > 0 && feeSink) requireAddress(feeSink, "feeSink");
+  if (feeBps > 0 && feeSink) requireAddress2(feeSink, "feeSink");
   const paymentRequired = toX402PaymentRequired(requirement, { feeBps, feeSink });
   return {
     status: 402,
@@ -901,7 +1007,7 @@ function validateX402ChallengeInput(input) {
       { field: "url" }
     );
   }
-  const payTo = requireAddress(input.payTo, "payTo");
+  const payTo = requireAddress2(input.payTo, "payTo");
   parseUsdToMicro(input.amount);
   const intent = input.intent ?? "transfer";
   if (intent !== "transfer" && intent !== "marketplace.buy") {
@@ -917,7 +1023,7 @@ function validateX402ChallengeInput(input) {
       { feeBps: input.feeBps }
     );
   }
-  const feeSink = input.feeSink === void 0 ? void 0 : requireAddress(input.feeSink, "feeSink");
+  const feeSink = input.feeSink === void 0 ? void 0 : requireAddress2(input.feeSink, "feeSink");
   return {
     payTo,
     amount: input.amount,
@@ -931,7 +1037,7 @@ function validateX402ChallengeInput(input) {
 }
 
 // src/client.ts
-var ADDRESS_RE2 = /^0x[0-9a-fA-F]{40}$/;
+var ADDRESS_RE3 = /^0x[0-9a-fA-F]{40}$/;
 function mapAlreadyEntered(e) {
   const msg = e instanceof Error ? e.message : typeof e === "object" && e && "message" in e ? String(e.message) : String(e);
   const detail = e instanceof PaymentFailedError || e instanceof ApiError ? e.detail : void 0;
@@ -979,7 +1085,7 @@ function requireAddressField(value, field) {
   if (typeof value !== "string" || value.trim() === "") {
     throw new MissingFieldError(field);
   }
-  if (!ADDRESS_RE2.test(value)) {
+  if (!ADDRESS_RE3.test(value)) {
     throw new ConfigError(
       `${field} must be a 0x-prefixed 20-byte wallet address (Phase 1a transfers settle server-held wallets), got: ${JSON.stringify(value)}`,
       { field, value }
@@ -1167,11 +1273,22 @@ var Playmos = class {
      *   rounds.settle({ ranking }) → contract pays winners.
      *
      * Operator txs are signed by the Playmos service (OPERATOR_ROLE key).
+     *
+     * Offline `mock: true`: settle applies the stored payout rule and the 60/30/10
+     * pool leg across entries (#490). No series seed bank — mock pool is a floor,
+     * not a forecast of a live series with inherited seed.
      */
     /** Offline mock store for rounds.open/lock/settle/get when `mock: true` (3-game dogfood). */
     this.mockRounds = /* @__PURE__ */ new Map();
     /** Mock withdrawable credits after settle — key `${roundId}:${walletLower}` (#240 offline prize). */
     this.mockWithdrawable = /* @__PURE__ */ new Map();
+    /**
+     * Mock pot after per-entry rake (PrizePool escrowed sum) — keyed by roundId (#490).
+     * Payable pool at lock = pot × POOL_BPS / (POOL_BPS + SEED_BPS); inherited seed = 0 offline.
+     */
+    this.mockPotMicro = /* @__PURE__ */ new Map();
+    /** Persisted settle winners for re-settle replay (#490 C2) — never re-invent pool-to-everyone. */
+    this.mockSettleWinners = /* @__PURE__ */ new Map();
     this.rounds = {
       open: async (input) => {
         if (!this.config.mock) this.assertSecretKey("playmos.rounds.open");
@@ -1210,6 +1327,8 @@ var Playmos = class {
             prizePoolAddress: this.config.contracts?.prizePool ?? "0x0000000000000000000000000000000000000002"
           };
           this.mockRounds.set(input.roundId, round);
+          this.mockPotMicro.set(input.roundId, 0n);
+          this.mockSettleWinners.delete(input.roundId);
           return round;
         }
         const body = await this.http.post(
@@ -1242,11 +1361,12 @@ var Playmos = class {
               code: "conflict"
             });
           }
+          const payableMicro = this.mockPayablePoolMicro(existing);
+          const poolUsd = payableMicro > 0n ? formatMicroToUsd(payableMicro) : existing.pool ?? existing.entryAmount;
           const locked = {
             ...existing,
             status: "locked",
-            // Mock payable pool ≈ 60% of entry × max(1, entrants) for shape only — not money truth.
-            pool: existing.pool ?? existing.entryAmount,
+            pool: poolUsd,
             entrants: existing.entrants ?? 0,
             lockTxHash: MOCK_TX
           };
@@ -1269,14 +1389,15 @@ var Playmos = class {
             throw new ApiError(`unknown round: ${input.roundId}`, { status: 404, code: "not_found" });
           }
           if (existing.status === "settled" && existing.settleTxHash) {
+            const stored = this.mockSettleWinners.get(input.roundId);
             return {
               roundId: input.roundId,
               txHash: existing.settleTxHash,
               poolPaid: existing.pool ?? "0",
-              winners: "winners" in input.results ? input.results.winners : input.results.ranking.map((wallet) => ({
+              winners: stored ?? ("winners" in input.results ? input.results.winners : input.results.ranking.map((wallet) => ({
                 wallet,
-                amount: existing.pool ?? existing.entryAmount
-              })),
+                amount: "0"
+              }))),
               status: "settled"
             };
           }
@@ -1286,13 +1407,45 @@ var Playmos = class {
               code: "conflict"
             });
           }
-          const winners = "winners" in input.results ? input.results.winners : input.results.ranking.map((wallet, i) => ({
-            wallet,
-            // Winner-take-all mock shape when ranking only.
-            amount: i === 0 ? existing.pool ?? existing.entryAmount : "0"
-          }));
+          const payableMicro = existing.pool != null ? this.parseUsdToMicroLoose(existing.pool) : this.mockPayablePoolMicro(existing);
+          const poolPaid = payableMicro > 0n ? formatMicroToUsd(payableMicro) : existing.pool ?? existing.entryAmount;
+          let rows;
+          if ("winners" in input.results) {
+            rows = input.results.winners.map((w) => {
+              let micro;
+              try {
+                micro = this.parseUsdToMicroLoose(String(w.amount ?? "0"));
+              } catch (e) {
+                this.mockPayoutApiError(e);
+              }
+              return {
+                wallet: w.wallet,
+                amount: formatMicroToUsd(micro),
+                micro
+              };
+            });
+          } else {
+            if (payableMicro <= 0n) {
+              rows = [];
+            } else {
+              try {
+                const computed = computePayout(
+                  payableMicro,
+                  input.results.ranking,
+                  existing.payout
+                );
+                rows = computed.map((c) => ({
+                  wallet: c.wallet,
+                  amount: formatMicroToUsd(c.amount),
+                  micro: c.amount
+                }));
+              } catch (e) {
+                this.mockPayoutApiError(e);
+              }
+            }
+          }
+          const winners = rows.map(({ wallet, amount }) => ({ wallet, amount }));
           const settleTxHash = MOCK_TX;
-          const poolPaid = existing.pool ?? existing.entryAmount;
           const settled = {
             ...existing,
             status: "settled",
@@ -1300,18 +1453,11 @@ var Playmos = class {
             pool: poolPaid
           };
           this.mockRounds.set(input.roundId, settled);
-          for (const w of winners) {
-            const wAddr = String(w.wallet).toLowerCase();
-            let micro = 0n;
-            try {
-              micro = validateAmount(String(w.amount ?? "0"));
-            } catch {
-              micro = 0n;
-            }
-            if (micro > 0n) {
-              const k = `${input.roundId}:${wAddr}`;
-              this.mockWithdrawable.set(k, (this.mockWithdrawable.get(k) ?? 0n) + micro);
-            }
+          this.mockSettleWinners.set(input.roundId, winners);
+          for (const w of rows) {
+            if (w.micro <= 0n) continue;
+            const k = `${input.roundId}:${w.wallet.toLowerCase()}`;
+            this.mockWithdrawable.set(k, (this.mockWithdrawable.get(k) ?? 0n) + w.micro);
           }
           return {
             roundId: input.roundId,
@@ -1403,9 +1549,12 @@ var Playmos = class {
             ...existing,
             status: "cancelled",
             cancelTxHash: MOCK_TX,
-            pool: null
+            pool: null,
+            entrants: 0
           };
           this.mockRounds.set(input.roundId, cancelled);
+          this.mockPotMicro.set(input.roundId, 0n);
+          this.mockSettleWinners.delete(input.roundId);
           return {
             roundId: input.roundId,
             txHash: MOCK_TX,
@@ -1930,6 +2079,69 @@ var Playmos = class {
       }
     }
   }
+  /**
+   * Resolve mock round by roundId **or** roundKey (kit `entryProvider` keys by roundKey, #490 C3).
+   */
+  findMockRound(idOrKey) {
+    const direct = this.mockRounds.get(idOrKey);
+    if (direct) return direct;
+    for (const r of this.mockRounds.values()) {
+      if (r.roundId === idOrKey || r.roundKey === idOrKey) return r;
+    }
+    return void 0;
+  }
+  /**
+   * 6dp USD → micro for mock winner amounts (#490 C1). Must not use 2dp `validateAmount`
+   * (would zero 0.135 from top-n 30% of $0.45).
+   */
+  parseUsdToMicroLoose(amount) {
+    if (typeof amount !== "string" || !/^\d+(\.\d{1,6})?$/.test(amount.trim())) {
+      throw new PayoutError(`invalid USD amount: ${JSON.stringify(amount)}`);
+    }
+    const [wholeRaw, frac = ""] = amount.trim().split(".");
+    const whole = wholeRaw ?? "0";
+    const fracPadded = (frac + "000000").slice(0, 6);
+    const micro = BigInt(whole) * 1000000n + BigInt(fracPadded);
+    if (micro < 0n) throw new PayoutError(`amount must be >= 0, got: ${JSON.stringify(amount)}`);
+    return micro;
+  }
+  /** Live-shaped 400 for mock payout validation (C5) — never leak raw PayoutError. */
+  mockPayoutApiError(e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    throw new ApiError(msg, { status: 400, code: "payout_invalid" });
+  }
+  /**
+   * Accumulate one mock entry into the pot (chain parity: rake off top, then lock split).
+   * No-op when no matching open/locked round — never 404 (C4).
+   */
+  mockAccumulateEntry(idOrKey, amountMicro) {
+    const round = this.findMockRound(idOrKey);
+    if (!round) return;
+    if (round.status !== "open" && round.status !== "locked") return;
+    const rake = amountMicro * BigInt(RAKE_BPS) / 10000n;
+    const escrowed = amountMicro - rake;
+    const pot = (this.mockPotMicro.get(round.roundId) ?? 0n) + escrowed;
+    this.mockPotMicro.set(round.roundId, pot);
+    const entrants = (round.entrants ?? 0) + 1;
+    const updated = { ...round, entrants };
+    this.mockRounds.set(round.roundId, updated);
+  }
+  /**
+   * Payable pool micro for mock lock/settle.
+   * With recorded entries: pot × POOL/(POOL+SEED) (seed bank = 0 offline).
+   * Zero entries: fall back to entryAmount micro (C4 — preserves existing suite).
+   */
+  mockPayablePoolMicro(round) {
+    const pot = this.mockPotMicro.get(round.roundId) ?? 0n;
+    if (pot > 0n) {
+      return pot * BigInt(POOL_BPS) / BigInt(POOL_BPS + SEED_BPS);
+    }
+    try {
+      return this.parseUsdToMicroLoose(round.entryAmount);
+    } catch {
+      return 0n;
+    }
+  }
   /**
    * Wallet timeout policy (#462 / PR #463 residual).
    * - connectTimeoutMs → eth_requestAccounts only
@@ -2078,6 +2290,7 @@ var Playmos = class {
     const metadata = validateMetadata(input.metadata);
     const idempotencyKey = input.idempotencyKey ?? prefixedId("idem");
     if (this.config.mock) {
+      this.mockAccumulateEntry(input.roundId, amountMicro);
       return this.rememberMock(
         mockEntryPayment({
           amountMicro,
@@ -2498,112 +2711,6 @@ function previewPoolSplit(amount) {
   };
 }
 
-// src/payout.ts
-var PayoutError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.code = "payout_invalid";
-    this.name = "PayoutError";
-  }
-};
-var ADDRESS_RE3 = /^0x[0-9a-fA-F]{40}$/;
-var BPS = 10000n;
-function requireAddress2(w, i) {
-  if (!ADDRESS_RE3.test(w)) {
-    throw new PayoutError(`ranking[${i}] must be a 0x-prefixed 20-byte address, got: ${JSON.stringify(w)}`);
-  }
-  return w.toLowerCase();
-}
-function parseUsdToMicroLoose(amount) {
-  if (typeof amount !== "string" || !/^\d+(\.\d{1,6})?$/.test(amount.trim())) {
-    throw new PayoutError(`invalid USD amount: ${JSON.stringify(amount)}`);
-  }
-  const [wholeRaw, frac = ""] = amount.trim().split(".");
-  const whole = wholeRaw ?? "0";
-  const fracPadded = (frac + "000000").slice(0, 6);
-  const micro = BigInt(whole) * 1000000n + BigInt(fracPadded);
-  if (micro <= 0n) throw new PayoutError(`amount must be > 0, got: ${JSON.stringify(amount)}`);
-  return micro;
-}
-function computePayout(pool, ranking, rule) {
-  if (typeof pool !== "bigint" || pool <= 0n) {
-    throw new PayoutError(`pool must be a positive bigint (micro-USDC), got: ${String(pool)}`);
-  }
-  if (!Array.isArray(ranking) || ranking.length === 0) {
-    throw new PayoutError("ranking must be a non-empty array of wallets (best-first)");
-  }
-  const wallets = ranking.map((w, i) => requireAddress2(w, i));
-  const seen = /* @__PURE__ */ new Set();
-  for (const w of wallets) {
-    if (seen.has(w)) throw new PayoutError(`duplicate wallet in ranking: ${w}`);
-    seen.add(w);
-  }
-  if (rule.kind === "winner-take-all") {
-    return [{ wallet: wallets[0], amount: pool }];
-  }
-  if (rule.kind === "top-n") {
-    const splits = rule.splitsBps;
-    if (!Array.isArray(splits) || splits.length === 0) {
-      throw new PayoutError("top-n splitsBps must be a non-empty array");
-    }
-    if (splits.length > wallets.length) {
-      throw new PayoutError(
-        `top-n needs ${splits.length} ranked wallets but ranking only has ${wallets.length}`
-      );
-    }
-    let sumBps = 0;
-    for (const b of splits) {
-      if (!Number.isInteger(b) || b <= 0 || b > 1e4) {
-        throw new PayoutError(`each splitsBps entry must be an integer in (0, 10000], got: ${b}`);
-      }
-      sumBps += b;
-    }
-    if (sumBps !== 1e4) {
-      throw new PayoutError(`splitsBps must sum to 10000, got ${sumBps}`);
-    }
-    const out = [];
-    let allocated = 0n;
-    for (let i = 0; i < splits.length; i++) {
-      const amt = pool * BigInt(splits[i]) / BPS;
-      out.push({ wallet: wallets[i], amount: amt });
-      allocated += amt;
-    }
-    const remainder = pool - allocated;
-    if (remainder < 0n) throw new PayoutError("internal: allocated more than pool");
-    out[0] = { wallet: out[0].wallet, amount: out[0].amount + remainder };
-    const filtered = out.filter((x) => x.amount > 0n);
-    if (filtered.length === 0) throw new PayoutError("payout produced no positive amounts");
-    const total = filtered.reduce((s, x) => s + x.amount, 0n);
-    if (total !== pool) throw new PayoutError(`internal: sum ${total} != pool ${pool}`);
-    return filtered;
-  }
-  if (rule.kind === "custom") {
-    const amounts = rule.amounts;
-    if (!Array.isArray(amounts) || amounts.length === 0) {
-      throw new PayoutError("custom amounts must be a non-empty array of USD strings");
-    }
-    if (amounts.length > wallets.length) {
-      throw new PayoutError(
-        `custom amounts has ${amounts.length} entries but ranking only has ${wallets.length}`
-      );
-    }
-    const out = [];
-    let total = 0n;
-    for (let i = 0; i < amounts.length; i++) {
-      const amt = parseUsdToMicroLoose(amounts[i]);
-      out.push({ wallet: wallets[i], amount: amt });
-      total += amt;
-    }
-    if (total !== pool) {
-      throw new PayoutError(
-        `custom amounts sum to ${total} micro-USDC but pool is ${pool} \u2014 must match exactly`
-      );
-    }
-    return out;
-  }
-  throw new PayoutError(`unknown payout rule kind: ${JSON.stringify(rule.kind)}`);
-}
-
 // src/settlement.ts
 var ADDRESS_RE4 = /^0x[0-9a-fA-F]{40}$/;
 var DEFAULT_TTL_MS = 15 * 60 * 1e3;

package/dist/index.d.cts

@@ -463,11 +463,44 @@ declare class Playmos {
      *   rounds.settle({ ranking }) → contract pays winners.
      *
      * Operator txs are signed by the Playmos service (OPERATOR_ROLE key).
+     *
+     * Offline `mock: true`: settle applies the stored payout rule and the 60/30/10
+     * pool leg across entries (#490). No series seed bank — mock pool is a floor,
+     * not a forecast of a live series with inherited seed.
      */
     /** Offline mock store for rounds.open/lock/settle/get when `mock: true` (3-game dogfood). */
     private readonly mockRounds;
     /** Mock withdrawable credits after settle — key `${roundId}:${walletLower}` (#240 offline prize). */
     private readonly mockWithdrawable;
+    /**
+     * Mock pot after per-entry rake (PrizePool escrowed sum) — keyed by roundId (#490).
+     * Payable pool at lock = pot × POOL_BPS / (POOL_BPS + SEED_BPS); inherited seed = 0 offline.
+     */
+    private readonly mockPotMicro;
+    /** Persisted settle winners for re-settle replay (#490 C2) — never re-invent pool-to-everyone. */
+    private readonly mockSettleWinners;
+    /**
+     * Resolve mock round by roundId **or** roundKey (kit `entryProvider` keys by roundKey, #490 C3).
+     */
+    private findMockRound;
+    /**
+     * 6dp USD → micro for mock winner amounts (#490 C1). Must not use 2dp `validateAmount`
+     * (would zero 0.135 from top-n 30% of $0.45).
+     */
+    private parseUsdToMicroLoose;
+    /** Live-shaped 400 for mock payout validation (C5) — never leak raw PayoutError. */
+    private mockPayoutApiError;
+    /**
+     * Accumulate one mock entry into the pot (chain parity: rake off top, then lock split).
+     * No-op when no matching open/locked round — never 404 (C4).
+     */
+    private mockAccumulateEntry;
+    /**
+     * Payable pool micro for mock lock/settle.
+     * With recorded entries: pot × POOL/(POOL+SEED) (seed bank = 0 offline).
+     * Zero entries: fall back to entryAmount micro (C4 — preserves existing suite).
+     */
+    private mockPayablePoolMicro;
     readonly rounds: {
         open: (input: RoundOpenInput) => Promise<RoundState>;
         lock: (input: {

package/dist/index.d.ts

@@ -463,11 +463,44 @@ declare class Playmos {
      *   rounds.settle({ ranking }) → contract pays winners.
      *
      * Operator txs are signed by the Playmos service (OPERATOR_ROLE key).
+     *
+     * Offline `mock: true`: settle applies the stored payout rule and the 60/30/10
+     * pool leg across entries (#490). No series seed bank — mock pool is a floor,
+     * not a forecast of a live series with inherited seed.
      */
     /** Offline mock store for rounds.open/lock/settle/get when `mock: true` (3-game dogfood). */
     private readonly mockRounds;
     /** Mock withdrawable credits after settle — key `${roundId}:${walletLower}` (#240 offline prize). */
     private readonly mockWithdrawable;
+    /**
+     * Mock pot after per-entry rake (PrizePool escrowed sum) — keyed by roundId (#490).
+     * Payable pool at lock = pot × POOL_BPS / (POOL_BPS + SEED_BPS); inherited seed = 0 offline.
+     */
+    private readonly mockPotMicro;
+    /** Persisted settle winners for re-settle replay (#490 C2) — never re-invent pool-to-everyone. */
+    private readonly mockSettleWinners;
+    /**
+     * Resolve mock round by roundId **or** roundKey (kit `entryProvider` keys by roundKey, #490 C3).
+     */
+    private findMockRound;
+    /**
+     * 6dp USD → micro for mock winner amounts (#490 C1). Must not use 2dp `validateAmount`
+     * (would zero 0.135 from top-n 30% of $0.45).
+     */
+    private parseUsdToMicroLoose;
+    /** Live-shaped 400 for mock payout validation (C5) — never leak raw PayoutError. */
+    private mockPayoutApiError;
+    /**
+     * Accumulate one mock entry into the pot (chain parity: rake off top, then lock split).
+     * No-op when no matching open/locked round — never 404 (C4).
+     */
+    private mockAccumulateEntry;
+    /**
+     * Payable pool micro for mock lock/settle.
+     * With recorded entries: pot × POOL/(POOL+SEED) (seed bank = 0 offline).
+     * Zero entries: fall back to entryAmount micro (C4 — preserves existing suite).
+     */
+    private mockPayablePoolMicro;
     readonly rounds: {
         open: (input: RoundOpenInput) => Promise<RoundState>;
         lock: (input: {

package/dist/index.js

@@ -181,6 +181,112 @@ function validateMetadata(metadata) {
   return out;
 }
 
+// src/payout.ts
+var PayoutError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.code = "payout_invalid";
+    this.name = "PayoutError";
+  }
+};
+var ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
+var BPS = 10000n;
+function requireAddress(w, i) {
+  if (!ADDRESS_RE.test(w)) {
+    throw new PayoutError(`ranking[${i}] must be a 0x-prefixed 20-byte address, got: ${JSON.stringify(w)}`);
+  }
+  return w.toLowerCase();
+}
+function parseUsdToMicroLoose(amount) {
+  if (typeof amount !== "string" || !/^\d+(\.\d{1,6})?$/.test(amount.trim())) {
+    throw new PayoutError(`invalid USD amount: ${JSON.stringify(amount)}`);
+  }
+  const [wholeRaw, frac = ""] = amount.trim().split(".");
+  const whole = wholeRaw ?? "0";
+  const fracPadded = (frac + "000000").slice(0, 6);
+  const micro = BigInt(whole) * 1000000n + BigInt(fracPadded);
+  if (micro <= 0n) throw new PayoutError(`amount must be > 0, got: ${JSON.stringify(amount)}`);
+  return micro;
+}
+function computePayout(pool, ranking, rule) {
+  if (typeof pool !== "bigint" || pool <= 0n) {
+    throw new PayoutError(`pool must be a positive bigint (micro-USDC), got: ${String(pool)}`);
+  }
+  if (!Array.isArray(ranking) || ranking.length === 0) {
+    throw new PayoutError("ranking must be a non-empty array of wallets (best-first)");
+  }
+  const wallets = ranking.map((w, i) => requireAddress(w, i));
+  const seen = /* @__PURE__ */ new Set();
+  for (const w of wallets) {
+    if (seen.has(w)) throw new PayoutError(`duplicate wallet in ranking: ${w}`);
+    seen.add(w);
+  }
+  if (rule.kind === "winner-take-all") {
+    return [{ wallet: wallets[0], amount: pool }];
+  }
+  if (rule.kind === "top-n") {
+    const splits = rule.splitsBps;
+    if (!Array.isArray(splits) || splits.length === 0) {
+      throw new PayoutError("top-n splitsBps must be a non-empty array");
+    }
+    if (splits.length > wallets.length) {
+      throw new PayoutError(
+        `top-n needs ${splits.length} ranked wallets but ranking only has ${wallets.length}`
+      );
+    }
+    let sumBps = 0;
+    for (const b of splits) {
+      if (!Number.isInteger(b) || b <= 0 || b > 1e4) {
+        throw new PayoutError(`each splitsBps entry must be an integer in (0, 10000], got: ${b}`);
+      }
+      sumBps += b;
+    }
+    if (sumBps !== 1e4) {
+      throw new PayoutError(`splitsBps must sum to 10000, got ${sumBps}`);
+    }
+    const out = [];
+    let allocated = 0n;
+    for (let i = 0; i < splits.length; i++) {
+      const amt = pool * BigInt(splits[i]) / BPS;
+      out.push({ wallet: wallets[i], amount: amt });
+      allocated += amt;
+    }
+    const remainder = pool - allocated;
+    if (remainder < 0n) throw new PayoutError("internal: allocated more than pool");
+    out[0] = { wallet: out[0].wallet, amount: out[0].amount + remainder };
+    const filtered = out.filter((x) => x.amount > 0n);
+    if (filtered.length === 0) throw new PayoutError("payout produced no positive amounts");
+    const total = filtered.reduce((s, x) => s + x.amount, 0n);
+    if (total !== pool) throw new PayoutError(`internal: sum ${total} != pool ${pool}`);
+    return filtered;
+  }
+  if (rule.kind === "custom") {
+    const amounts = rule.amounts;
+    if (!Array.isArray(amounts) || amounts.length === 0) {
+      throw new PayoutError("custom amounts must be a non-empty array of USD strings");
+    }
+    if (amounts.length > wallets.length) {
+      throw new PayoutError(
+        `custom amounts has ${amounts.length} entries but ranking only has ${wallets.length}`
+      );
+    }
+    const out = [];
+    let total = 0n;
+    for (let i = 0; i < amounts.length; i++) {
+      const amt = parseUsdToMicroLoose(amounts[i]);
+      out.push({ wallet: wallets[i], amount: amt });
+      total += amt;
+    }
+    if (total !== pool) {
+      throw new PayoutError(
+        `custom amounts sum to ${total} micro-USDC but pool is ${pool} \u2014 must match exactly`
+      );
+    }
+    return out;
+  }
+  throw new PayoutError(`unknown payout rule kind: ${JSON.stringify(rule.kind)}`);
+}
+
 // src/http.ts
 function resolveRetry(retry) {
   const off = { maxRetries: 0, baseDelayMs: 500, maxDelayMs: 2e4 };
@@ -704,12 +810,12 @@ function mockVerifyResult(payment) {
 }
 
 // src/x402.ts
-var ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
-function requireAddress(value, field) {
+var ADDRESS_RE2 = /^0x[0-9a-fA-F]{40}$/;
+function requireAddress2(value, field) {
   if (typeof value !== "string" || value.trim() === "") {
     throw new MissingFieldError(field);
   }
-  if (!ADDRESS_RE.test(value)) {
+  if (!ADDRESS_RE2.test(value)) {
     throw new ConfigError(`${field} must be a 0x-prefixed 20-byte address, got: ${JSON.stringify(value)}`, {
       field,
       value
@@ -779,7 +885,7 @@ function createX402Challenge(requirement, extras) {
   if (typeof requirement.id !== "string" || !requirement.id.startsWith("preq_")) {
     throw new ConfigError('PaymentRequirement.id must be a "preq_\u2026" string', { id: requirement.id });
   }
-  requireAddress(requirement.payTo, "payTo");
+  requireAddress2(requirement.payTo, "payTo");
   parseUsdToMicro(requirement.amount);
   const feeBps = extras?.feeBps ?? 0;
   if (!Number.isInteger(feeBps) || feeBps < 0 || feeBps > 1e4) {
@@ -789,7 +895,7 @@ function createX402Challenge(requirement, extras) {
     );
   }
   const feeSink = extras?.feeSink ?? null;
-  if (feeBps > 0 && feeSink) requireAddress(feeSink, "feeSink");
+  if (feeBps > 0 && feeSink) requireAddress2(feeSink, "feeSink");
   const paymentRequired = toX402PaymentRequired(requirement, { feeBps, feeSink });
   return {
     status: 402,
@@ -817,7 +923,7 @@ function validateX402ChallengeInput(input) {
       { field: "url" }
     );
   }
-  const payTo = requireAddress(input.payTo, "payTo");
+  const payTo = requireAddress2(input.payTo, "payTo");
   parseUsdToMicro(input.amount);
   const intent = input.intent ?? "transfer";
   if (intent !== "transfer" && intent !== "marketplace.buy") {
@@ -833,7 +939,7 @@ function validateX402ChallengeInput(input) {
       { feeBps: input.feeBps }
     );
   }
-  const feeSink = input.feeSink === void 0 ? void 0 : requireAddress(input.feeSink, "feeSink");
+  const feeSink = input.feeSink === void 0 ? void 0 : requireAddress2(input.feeSink, "feeSink");
   return {
     payTo,
     amount: input.amount,
@@ -847,7 +953,7 @@ function validateX402ChallengeInput(input) {
 }
 
 // src/client.ts
-var ADDRESS_RE2 = /^0x[0-9a-fA-F]{40}$/;
+var ADDRESS_RE3 = /^0x[0-9a-fA-F]{40}$/;
 function mapAlreadyEntered(e) {
   const msg = e instanceof Error ? e.message : typeof e === "object" && e && "message" in e ? String(e.message) : String(e);
   const detail = e instanceof PaymentFailedError || e instanceof ApiError ? e.detail : void 0;
@@ -895,7 +1001,7 @@ function requireAddressField(value, field) {
   if (typeof value !== "string" || value.trim() === "") {
     throw new MissingFieldError(field);
   }
-  if (!ADDRESS_RE2.test(value)) {
+  if (!ADDRESS_RE3.test(value)) {
     throw new ConfigError(
       `${field} must be a 0x-prefixed 20-byte wallet address (Phase 1a transfers settle server-held wallets), got: ${JSON.stringify(value)}`,
       { field, value }
@@ -1083,11 +1189,22 @@ var Playmos = class {
      *   rounds.settle({ ranking }) → contract pays winners.
      *
      * Operator txs are signed by the Playmos service (OPERATOR_ROLE key).
+     *
+     * Offline `mock: true`: settle applies the stored payout rule and the 60/30/10
+     * pool leg across entries (#490). No series seed bank — mock pool is a floor,
+     * not a forecast of a live series with inherited seed.
      */
     /** Offline mock store for rounds.open/lock/settle/get when `mock: true` (3-game dogfood). */
     this.mockRounds = /* @__PURE__ */ new Map();
     /** Mock withdrawable credits after settle — key `${roundId}:${walletLower}` (#240 offline prize). */
     this.mockWithdrawable = /* @__PURE__ */ new Map();
+    /**
+     * Mock pot after per-entry rake (PrizePool escrowed sum) — keyed by roundId (#490).
+     * Payable pool at lock = pot × POOL_BPS / (POOL_BPS + SEED_BPS); inherited seed = 0 offline.
+     */
+    this.mockPotMicro = /* @__PURE__ */ new Map();
+    /** Persisted settle winners for re-settle replay (#490 C2) — never re-invent pool-to-everyone. */
+    this.mockSettleWinners = /* @__PURE__ */ new Map();
     this.rounds = {
       open: async (input) => {
         if (!this.config.mock) this.assertSecretKey("playmos.rounds.open");
@@ -1126,6 +1243,8 @@ var Playmos = class {
             prizePoolAddress: this.config.contracts?.prizePool ?? "0x0000000000000000000000000000000000000002"
           };
           this.mockRounds.set(input.roundId, round);
+          this.mockPotMicro.set(input.roundId, 0n);
+          this.mockSettleWinners.delete(input.roundId);
           return round;
         }
         const body = await this.http.post(
@@ -1158,11 +1277,12 @@ var Playmos = class {
               code: "conflict"
             });
           }
+          const payableMicro = this.mockPayablePoolMicro(existing);
+          const poolUsd = payableMicro > 0n ? formatMicroToUsd(payableMicro) : existing.pool ?? existing.entryAmount;
           const locked = {
             ...existing,
             status: "locked",
-            // Mock payable pool ≈ 60% of entry × max(1, entrants) for shape only — not money truth.
-            pool: existing.pool ?? existing.entryAmount,
+            pool: poolUsd,
             entrants: existing.entrants ?? 0,
             lockTxHash: MOCK_TX
           };
@@ -1185,14 +1305,15 @@ var Playmos = class {
             throw new ApiError(`unknown round: ${input.roundId}`, { status: 404, code: "not_found" });
           }
           if (existing.status === "settled" && existing.settleTxHash) {
+            const stored = this.mockSettleWinners.get(input.roundId);
             return {
               roundId: input.roundId,
               txHash: existing.settleTxHash,
               poolPaid: existing.pool ?? "0",
-              winners: "winners" in input.results ? input.results.winners : input.results.ranking.map((wallet) => ({
+              winners: stored ?? ("winners" in input.results ? input.results.winners : input.results.ranking.map((wallet) => ({
                 wallet,
-                amount: existing.pool ?? existing.entryAmount
-              })),
+                amount: "0"
+              }))),
               status: "settled"
             };
           }
@@ -1202,13 +1323,45 @@ var Playmos = class {
               code: "conflict"
             });
           }
-          const winners = "winners" in input.results ? input.results.winners : input.results.ranking.map((wallet, i) => ({
-            wallet,
-            // Winner-take-all mock shape when ranking only.
-            amount: i === 0 ? existing.pool ?? existing.entryAmount : "0"
-          }));
+          const payableMicro = existing.pool != null ? this.parseUsdToMicroLoose(existing.pool) : this.mockPayablePoolMicro(existing);
+          const poolPaid = payableMicro > 0n ? formatMicroToUsd(payableMicro) : existing.pool ?? existing.entryAmount;
+          let rows;
+          if ("winners" in input.results) {
+            rows = input.results.winners.map((w) => {
+              let micro;
+              try {
+                micro = this.parseUsdToMicroLoose(String(w.amount ?? "0"));
+              } catch (e) {
+                this.mockPayoutApiError(e);
+              }
+              return {
+                wallet: w.wallet,
+                amount: formatMicroToUsd(micro),
+                micro
+              };
+            });
+          } else {
+            if (payableMicro <= 0n) {
+              rows = [];
+            } else {
+              try {
+                const computed = computePayout(
+                  payableMicro,
+                  input.results.ranking,
+                  existing.payout
+                );
+                rows = computed.map((c) => ({
+                  wallet: c.wallet,
+                  amount: formatMicroToUsd(c.amount),
+                  micro: c.amount
+                }));
+              } catch (e) {
+                this.mockPayoutApiError(e);
+              }
+            }
+          }
+          const winners = rows.map(({ wallet, amount }) => ({ wallet, amount }));
           const settleTxHash = MOCK_TX;
-          const poolPaid = existing.pool ?? existing.entryAmount;
           const settled = {
             ...existing,
             status: "settled",
@@ -1216,18 +1369,11 @@ var Playmos = class {
             pool: poolPaid
           };
           this.mockRounds.set(input.roundId, settled);
-          for (const w of winners) {
-            const wAddr = String(w.wallet).toLowerCase();
-            let micro = 0n;
-            try {
-              micro = validateAmount(String(w.amount ?? "0"));
-            } catch {
-              micro = 0n;
-            }
-            if (micro > 0n) {
-              const k = `${input.roundId}:${wAddr}`;
-              this.mockWithdrawable.set(k, (this.mockWithdrawable.get(k) ?? 0n) + micro);
-            }
+          this.mockSettleWinners.set(input.roundId, winners);
+          for (const w of rows) {
+            if (w.micro <= 0n) continue;
+            const k = `${input.roundId}:${w.wallet.toLowerCase()}`;
+            this.mockWithdrawable.set(k, (this.mockWithdrawable.get(k) ?? 0n) + w.micro);
           }
           return {
             roundId: input.roundId,
@@ -1319,9 +1465,12 @@ var Playmos = class {
             ...existing,
             status: "cancelled",
             cancelTxHash: MOCK_TX,
-            pool: null
+            pool: null,
+            entrants: 0
           };
           this.mockRounds.set(input.roundId, cancelled);
+          this.mockPotMicro.set(input.roundId, 0n);
+          this.mockSettleWinners.delete(input.roundId);
           return {
             roundId: input.roundId,
             txHash: MOCK_TX,
@@ -1846,6 +1995,69 @@ var Playmos = class {
       }
     }
   }
+  /**
+   * Resolve mock round by roundId **or** roundKey (kit `entryProvider` keys by roundKey, #490 C3).
+   */
+  findMockRound(idOrKey) {
+    const direct = this.mockRounds.get(idOrKey);
+    if (direct) return direct;
+    for (const r of this.mockRounds.values()) {
+      if (r.roundId === idOrKey || r.roundKey === idOrKey) return r;
+    }
+    return void 0;
+  }
+  /**
+   * 6dp USD → micro for mock winner amounts (#490 C1). Must not use 2dp `validateAmount`
+   * (would zero 0.135 from top-n 30% of $0.45).
+   */
+  parseUsdToMicroLoose(amount) {
+    if (typeof amount !== "string" || !/^\d+(\.\d{1,6})?$/.test(amount.trim())) {
+      throw new PayoutError(`invalid USD amount: ${JSON.stringify(amount)}`);
+    }
+    const [wholeRaw, frac = ""] = amount.trim().split(".");
+    const whole = wholeRaw ?? "0";
+    const fracPadded = (frac + "000000").slice(0, 6);
+    const micro = BigInt(whole) * 1000000n + BigInt(fracPadded);
+    if (micro < 0n) throw new PayoutError(`amount must be >= 0, got: ${JSON.stringify(amount)}`);
+    return micro;
+  }
+  /** Live-shaped 400 for mock payout validation (C5) — never leak raw PayoutError. */
+  mockPayoutApiError(e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    throw new ApiError(msg, { status: 400, code: "payout_invalid" });
+  }
+  /**
+   * Accumulate one mock entry into the pot (chain parity: rake off top, then lock split).
+   * No-op when no matching open/locked round — never 404 (C4).
+   */
+  mockAccumulateEntry(idOrKey, amountMicro) {
+    const round = this.findMockRound(idOrKey);
+    if (!round) return;
+    if (round.status !== "open" && round.status !== "locked") return;
+    const rake = amountMicro * BigInt(RAKE_BPS) / 10000n;
+    const escrowed = amountMicro - rake;
+    const pot = (this.mockPotMicro.get(round.roundId) ?? 0n) + escrowed;
+    this.mockPotMicro.set(round.roundId, pot);
+    const entrants = (round.entrants ?? 0) + 1;
+    const updated = { ...round, entrants };
+    this.mockRounds.set(round.roundId, updated);
+  }
+  /**
+   * Payable pool micro for mock lock/settle.
+   * With recorded entries: pot × POOL/(POOL+SEED) (seed bank = 0 offline).
+   * Zero entries: fall back to entryAmount micro (C4 — preserves existing suite).
+   */
+  mockPayablePoolMicro(round) {
+    const pot = this.mockPotMicro.get(round.roundId) ?? 0n;
+    if (pot > 0n) {
+      return pot * BigInt(POOL_BPS) / BigInt(POOL_BPS + SEED_BPS);
+    }
+    try {
+      return this.parseUsdToMicroLoose(round.entryAmount);
+    } catch {
+      return 0n;
+    }
+  }
   /**
    * Wallet timeout policy (#462 / PR #463 residual).
    * - connectTimeoutMs → eth_requestAccounts only
@@ -1994,6 +2206,7 @@ var Playmos = class {
     const metadata = validateMetadata(input.metadata);
     const idempotencyKey = input.idempotencyKey ?? prefixedId("idem");
     if (this.config.mock) {
+      this.mockAccumulateEntry(input.roundId, amountMicro);
       return this.rememberMock(
         mockEntryPayment({
           amountMicro,
@@ -2414,112 +2627,6 @@ function previewPoolSplit(amount) {
   };
 }
 
-// src/payout.ts
-var PayoutError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.code = "payout_invalid";
-    this.name = "PayoutError";
-  }
-};
-var ADDRESS_RE3 = /^0x[0-9a-fA-F]{40}$/;
-var BPS = 10000n;
-function requireAddress2(w, i) {
-  if (!ADDRESS_RE3.test(w)) {
-    throw new PayoutError(`ranking[${i}] must be a 0x-prefixed 20-byte address, got: ${JSON.stringify(w)}`);
-  }
-  return w.toLowerCase();
-}
-function parseUsdToMicroLoose(amount) {
-  if (typeof amount !== "string" || !/^\d+(\.\d{1,6})?$/.test(amount.trim())) {
-    throw new PayoutError(`invalid USD amount: ${JSON.stringify(amount)}`);
-  }
-  const [wholeRaw, frac = ""] = amount.trim().split(".");
-  const whole = wholeRaw ?? "0";
-  const fracPadded = (frac + "000000").slice(0, 6);
-  const micro = BigInt(whole) * 1000000n + BigInt(fracPadded);
-  if (micro <= 0n) throw new PayoutError(`amount must be > 0, got: ${JSON.stringify(amount)}`);
-  return micro;
-}
-function computePayout(pool, ranking, rule) {
-  if (typeof pool !== "bigint" || pool <= 0n) {
-    throw new PayoutError(`pool must be a positive bigint (micro-USDC), got: ${String(pool)}`);
-  }
-  if (!Array.isArray(ranking) || ranking.length === 0) {
-    throw new PayoutError("ranking must be a non-empty array of wallets (best-first)");
-  }
-  const wallets = ranking.map((w, i) => requireAddress2(w, i));
-  const seen = /* @__PURE__ */ new Set();
-  for (const w of wallets) {
-    if (seen.has(w)) throw new PayoutError(`duplicate wallet in ranking: ${w}`);
-    seen.add(w);
-  }
-  if (rule.kind === "winner-take-all") {
-    return [{ wallet: wallets[0], amount: pool }];
-  }
-  if (rule.kind === "top-n") {
-    const splits = rule.splitsBps;
-    if (!Array.isArray(splits) || splits.length === 0) {
-      throw new PayoutError("top-n splitsBps must be a non-empty array");
-    }
-    if (splits.length > wallets.length) {
-      throw new PayoutError(
-        `top-n needs ${splits.length} ranked wallets but ranking only has ${wallets.length}`
-      );
-    }
-    let sumBps = 0;
-    for (const b of splits) {
-      if (!Number.isInteger(b) || b <= 0 || b > 1e4) {
-        throw new PayoutError(`each splitsBps entry must be an integer in (0, 10000], got: ${b}`);
-      }
-      sumBps += b;
-    }
-    if (sumBps !== 1e4) {
-      throw new PayoutError(`splitsBps must sum to 10000, got ${sumBps}`);
-    }
-    const out = [];
-    let allocated = 0n;
-    for (let i = 0; i < splits.length; i++) {
-      const amt = pool * BigInt(splits[i]) / BPS;
-      out.push({ wallet: wallets[i], amount: amt });
-      allocated += amt;
-    }
-    const remainder = pool - allocated;
-    if (remainder < 0n) throw new PayoutError("internal: allocated more than pool");
-    out[0] = { wallet: out[0].wallet, amount: out[0].amount + remainder };
-    const filtered = out.filter((x) => x.amount > 0n);
-    if (filtered.length === 0) throw new PayoutError("payout produced no positive amounts");
-    const total = filtered.reduce((s, x) => s + x.amount, 0n);
-    if (total !== pool) throw new PayoutError(`internal: sum ${total} != pool ${pool}`);
-    return filtered;
-  }
-  if (rule.kind === "custom") {
-    const amounts = rule.amounts;
-    if (!Array.isArray(amounts) || amounts.length === 0) {
-      throw new PayoutError("custom amounts must be a non-empty array of USD strings");
-    }
-    if (amounts.length > wallets.length) {
-      throw new PayoutError(
-        `custom amounts has ${amounts.length} entries but ranking only has ${wallets.length}`
-      );
-    }
-    const out = [];
-    let total = 0n;
-    for (let i = 0; i < amounts.length; i++) {
-      const amt = parseUsdToMicroLoose(amounts[i]);
-      out.push({ wallet: wallets[i], amount: amt });
-      total += amt;
-    }
-    if (total !== pool) {
-      throw new PayoutError(
-        `custom amounts sum to ${total} micro-USDC but pool is ${pool} \u2014 must match exactly`
-      );
-    }
-    return out;
-  }
-  throw new PayoutError(`unknown payout rule kind: ${JSON.stringify(rule.kind)}`);
-}
-
 // src/settlement.ts
 var ADDRESS_RE4 = /^0x[0-9a-fA-F]{40}$/;
 var DEFAULT_TTL_MS = 15 * 60 * 1e3;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playmos/sdk",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "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,