@playmos/sdk 0.3.11 → 0.3.13

package/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to `@playmos/sdk`. This project adheres to [Semantic Version
 
 ## Unreleased
 
+## [0.3.13] — 2026-09-11
+
+### Docs
+- Same-studio key rule (`payment not found`). `payoutAddress` at mint or `POST /v1/studio/payout`. Browser `pay()` + MetaMask catch. Webhook register: `POST /v1/webhook_endpoints` (no signing secret in the response).
+- npm README + package description name the live prepare → sign → register path (**flat 1%**). Types include `bytecode` / `unsignedTx`.
+
+## [0.3.12] — 2026-08-27
+
+### Added
+- **Operator-signed epoch settlement (E1b / sdk#664 / PR #670):** `epochs.getAttestation`, `epochs.executeSettlement`, `epochs.settlementTypedData`. Service `POST`/`GET` `/v1/epochs/:epochId/attestation`. GET is a public board (any authenticated key). POST is `sk_` + studio-gated. Amounts stay micro-USDC strings. Refs #664.
+
+### Notes
+- Hub CI installs from npm, not the monorepo. This tag is what E1c (hub auto-pin before broadcast) consumes.
+
 ## [0.3.11] — 2026-08-09
 
 ### Added

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Playmos Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,7 +2,7 @@
 
 **🧪 Beta — Playmos SDK.** Runs on Base Sepolia **testnet**. The value-movement primitives (escrow / marketplace / transfer) are proven on-chain but **not yet production-hardened**, and nothing is on mainnet. Build and integrate freely against the sandbox; don't route real user funds yet.
 
-Stablecoin payments for games on Base. One SDK for in-app purchases (1%), skill-game prize-pool entries (10%, 60/30/10), and **in-game economies** (player · NPC · agent commerce via `transfer()`). USD in, USDC on-chain — no crypto UX for your players.
+Stablecoin payments for games on Base. **One default path:** `pay()` → `verify()` → a real `pay_…` id with status `confirmed` (1% Playmos — you keep 99%). No game required. Contests, economies, and timers are **optional**. Skill contests are **flat 1%** on **your** pool. If `rounds.open` is refused, that is expected until you prepare → sign → register your own contest pool. USD in, USDC on-chain — no crypto UX for your players.
 
 **Changelog:** see [`CHANGELOG.md`](./CHANGELOG.md) (shipped in the npm tarball from the next publish). **Breaking in 0.3.8:** player-wallet `enterRound` requires `identity` — no silent invent.
 
@@ -25,9 +25,9 @@ The sandbox API also sends CORS headers so browser `pay()` / `enterRound()` work
 
 The public sandbox key `pk_test_playmos_sandbox` runs against a real Playmos test service on Base Sepolia. **You don't need a wallet:** on a `pk_test` key with no `wallet` configured, the SDK routes to a server-settle path where Playmos signs and submits the on-chain transaction for you. You still get a real, confirmed `txHash` — just signed by the service. No wallet, no gas, no crypto.
 
-The key comes wired to two demo games: `game_sandbox_iap` (IAP) and `game_sandbox_skill` (prize pool).
+The public key is wired to `game_sandbox_iap`. Skill entry (`game_sandbox_skill`) is an optional later path — not the first-hour default.
 
-### In-app purchase — `pay()`
+### In-app purchase — `pay()` (the front door)
 
 <!-- snippet:pay -->
 ```ts
@@ -38,15 +38,22 @@ import { Playmos } from "@playmos/sdk";
 const playmos = new Playmos({ apiKey: "pk_test_playmos_sandbox" });
 
 const payment = await playmos.pay({
-  gameId: "game_sandbox_iap", // public sandbox IAP game — include it (this key spans IAP + skill)
+  gameId: "game_sandbox_iap", // required for the public sandbox key
   amount: "0.99",             // USD string — sandbox server-settle cap $1.00/request
   sku: "gems_500",            // your product id
-  playerId: "player_abc",     // your opaque user id
+  playerId: "player_" + Date.now(),
 });
 
-payment.id;     // "pay_…"     — real, server-issued (ULID)
-payment.status; // "confirmed" — real, on Base Sepolia
-payment.txHash; // 0x…         — open on sepolia.basescan.org/tx/{txHash}
+let result = await playmos.verify(payment.id);
+let tries = 30;
+while (result.status !== "confirmed" && tries !== 0) {
+  await new Promise((r) => setTimeout(r, 500));
+  result = await playmos.verify(payment.id);
+  tries -= 1;
+}
+
+console.log({ id: payment.id, status: result.status, tx: payment.txHash });
+// You won: pay_… + confirmed on Base Sepolia
 ```
 
 ### Verify before you grant
@@ -68,7 +75,7 @@ if (result.status === "confirmed") {
 }
 ```
 
-### Skill-game entry — `enterRound()`
+### Optional later — skill-game entry (`enterRound()`)
 
 ```ts
 const entry = await playmos.enterRound({
@@ -77,9 +84,21 @@ const entry = await playmos.enterRound({
   amount: "1.00",         // grows this round's pool
   playerId: "player_abc",
 });
-// entry.status === "confirmed"; entry.split is the on-chain 60/30/10 breakdown
+// entry.status === "confirmed". Public sandbox skill is a shared Playmos pool — not your contest.
+// Your 1% contest is live only after you register your own pool (next section).
 ```
 
+### Your own contest pool — `epochs.preparePool` (you sign)
+
+`@playmos/sdk` **0.3.13** ships `epochs.preparePool` with `bytecode` / `unsignedTx` on the typed response. It calls the live API. Playmos sets `broadcast: false` and does **not** send the transaction.
+
+1. Fund your studio wallet on Base Sepolia (ETH + test USDC). Playmos has no faucet — use [Coinbase's faucet docs](https://docs.cdp.coinbase.com/faucets/introduction/welcome).
+2. Call `epochs.preparePool({ studioWallet })` or `POST /v1/epochs/pools/prepare`. Use `feeSink` from that response (`0xD84c190085aa59c48a9B478Ea333D50B8DF4aD42`).
+3. Sign `unsignedTx` in your wallet and send it.
+4. `epochs.registerPool` with `walletProof`, then open / enter **your** game — not the shared sandbox game.
+
+Full steps: https://playmos-docs-public.vercel.app/docs#studio-pool-prepare
+
 ### Move USDC between wallets — `transfer()`
 
 The base value-movement primitive: move USDC from one wallet to another with a configurable per-call fee. The **game logic is the authority** — you already decided the move is valid — so this is a direct, unconditional push (reach for `escrow`/`marketplace` when a trust boundary needs fair exchange). Settled through the on-chain `PlaymosTransfer` contract; the split is verifiable on BaseScan.
@@ -280,8 +299,8 @@ The escrow/marketplace resolve endpoints (release/refund/confirm) return a deter
 
 ## Docs
 
-Full developer docs (install, IAP `pay()`, skill `enterRound()`, agents, webhooks, REST) — **public, no login**:
+Full developer docs (install, IAP `pay()`, skill `enterRound()`, your own contest pool, agents, webhooks, REST) — **public, no login**:
 
-**https://playmos-docs-public.vercel.app/docs**
+**https://playmos-docs-public.vercel.app/docs** · contest pool: **https://playmos-docs-public.vercel.app/docs#studio-pool-prepare**
 
 That is the third-party / stranger surface while we stress-test. Production **`playmos.io/docs`** comes after Founder promote (gate still holds for production only).

package/dist/{chunk-35WJANW4.js → chunk-TZFGZNXV.js}

@@ -1,4 +1,4 @@
-import { numberToHex, keccak256, toBytes, encodeFunctionData } from 'viem';
+import { keccak256, toHex, numberToHex, encodeFunctionData, toBytes, getAddress } from 'viem';
 
 // src/errors.ts
 var PlaymosError = class extends Error {
@@ -81,6 +81,12 @@ var NothingToWithdrawError = class extends PlaymosError {
     );
   }
 };
+function seriesToBytes32(series) {
+  const s = series.trim();
+  if (/^0x[0-9a-fA-F]{64}$/.test(s)) return s.toLowerCase();
+  return keccak256(toHex(s));
+}
+var identityToBytes32 = seriesToBytes32;
 
 // src/chain/abis.ts
 var erc20Abi = [
@@ -219,6 +225,174 @@ async function assertEnoughGas(provider, from, minWei) {
   }
 }
 
+// src/chain/epochPrizePoolAbi.ts
+var epochPrizePoolViewAbi = [
+  {
+    type: "function",
+    name: "currentEpochId",
+    stateMutability: "view",
+    inputs: [{ name: "series", type: "bytes32" }],
+    outputs: [{ type: "uint256" }]
+  },
+  {
+    type: "function",
+    name: "epochIdAt",
+    stateMutability: "view",
+    inputs: [
+      { name: "series", type: "bytes32" },
+      { name: "timestamp", type: "uint256" }
+    ],
+    outputs: [{ type: "uint256" }]
+  },
+  {
+    type: "function",
+    name: "epochPool",
+    stateMutability: "view",
+    inputs: [
+      { name: "series", type: "bytes32" },
+      { name: "epochId", type: "uint256" }
+    ],
+    outputs: [{ type: "uint256" }]
+  },
+  {
+    type: "function",
+    name: "epochOutgoingSeed",
+    stateMutability: "view",
+    inputs: [
+      { name: "series", type: "bytes32" },
+      { name: "epochId", type: "uint256" }
+    ],
+    outputs: [{ type: "uint256" }]
+  },
+  {
+    type: "function",
+    name: "epochIncomingSeed",
+    stateMutability: "view",
+    inputs: [
+      { name: "series", type: "bytes32" },
+      { name: "epochId", type: "uint256" }
+    ],
+    outputs: [{ type: "uint256" }]
+  },
+  {
+    type: "function",
+    name: "epochEntryCount",
+    stateMutability: "view",
+    inputs: [
+      { name: "series", type: "bytes32" },
+      { name: "epochId", type: "uint256" }
+    ],
+    outputs: [{ type: "uint256" }]
+  },
+  {
+    type: "function",
+    name: "getSeries",
+    stateMutability: "view",
+    inputs: [{ name: "series", type: "bytes32" }],
+    outputs: [
+      { name: "created", type: "bool" },
+      { name: "genesis", type: "uint256" },
+      { name: "epochDuration", type: "uint256" },
+      { name: "entry", type: "uint256" },
+      { name: "feeBps", type: "uint16" },
+      { name: "poolBps", type: "uint16" },
+      { name: "seedBps", type: "uint16" }
+    ]
+  },
+  {
+    type: "function",
+    name: "getEpoch",
+    stateMutability: "view",
+    inputs: [
+      { name: "series", type: "bytes32" },
+      { name: "epochId", type: "uint256" }
+    ],
+    outputs: [
+      { name: "pool", type: "uint256" },
+      { name: "outgoingSeed", type: "uint256" },
+      { name: "incomingSeed", type: "uint256" },
+      { name: "entryCount_", type: "uint256" },
+      { name: "terminal", type: "uint8" }
+    ]
+  },
+  {
+    type: "function",
+    name: "entryCount",
+    stateMutability: "view",
+    inputs: [
+      { name: "series", type: "bytes32" },
+      { name: "epochId", type: "uint256" },
+      { name: "identity", type: "bytes32" }
+    ],
+    outputs: [{ type: "uint256" }]
+  },
+  {
+    type: "function",
+    name: "claimableRefund",
+    stateMutability: "view",
+    inputs: [
+      { name: "series", type: "bytes32" },
+      { name: "epochId", type: "uint256" },
+      { name: "payer", type: "address" }
+    ],
+    outputs: [{ type: "uint256" }]
+  },
+  {
+    type: "function",
+    name: "withdrawable",
+    stateMutability: "view",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: [{ type: "uint256" }]
+  }
+];
+var epochPrizePoolEnterAbi = [
+  {
+    type: "function",
+    name: "enter",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "series", type: "bytes32" },
+      { name: "identity", type: "bytes32" }
+    ],
+    outputs: []
+  }
+];
+var epochPrizePoolRefundAbi = [
+  {
+    type: "function",
+    name: "claimRefund",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "series", type: "bytes32" },
+      { name: "epochId", type: "uint256" },
+      { name: "payer", type: "address" }
+    ],
+    outputs: [{ name: "amount", type: "uint256" }]
+  },
+  {
+    type: "function",
+    name: "withdraw",
+    stateMutability: "nonpayable",
+    inputs: [],
+    outputs: []
+  }
+];
+var epochPrizePoolExecuteSettlementAbi = [
+  {
+    type: "function",
+    name: "executeSignedSettlement",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "series", type: "bytes32" },
+      { name: "epochId", type: "uint256" },
+      { name: "winners", type: "address[]" },
+      { name: "amounts", type: "uint256[]" },
+      { name: "signature", type: "bytes" }
+    ],
+    outputs: []
+  }
+];
+
 // src/chain/calls.ts
 var toBytes32 = (s) => keccak256(toBytes(s));
 function buildIapCalls(args) {
@@ -251,5 +425,21 @@ function buildWithdrawCall(prizePool) {
   });
   return { to: prizePool, data };
 }
+function buildEpochExecuteSettlementCall(args) {
+  return {
+    to: args.epochPrizePool,
+    data: encodeFunctionData({
+      abi: epochPrizePoolExecuteSettlementAbi,
+      functionName: "executeSignedSettlement",
+      args: [
+        seriesToBytes32(args.series),
+        args.epochId,
+        args.winners.map((w) => getAddress(w.toLowerCase())),
+        args.amounts,
+        args.signature
+      ]
+    })
+  };
+}
 
-export { AlreadyEnteredError, ApiError, AuthError, ConfigError, InsufficientGasError, InvalidAmountError, MissingFieldError, NothingToWithdrawError, PaymentFailedError, PlaymosError, WalletConnectionError, WalletTimeoutError, assertEnoughGas, buildEntryCalls, buildIapCalls, buildWithdrawCall, prizePoolAbi, sendCalls, toBytes32, waitForCalls };
+export { AlreadyEnteredError, ApiError, AuthError, ConfigError, InsufficientGasError, InvalidAmountError, MissingFieldError, NothingToWithdrawError, PaymentFailedError, PlaymosError, WalletConnectionError, WalletTimeoutError, assertEnoughGas, buildEntryCalls, buildEpochExecuteSettlementCall, buildIapCalls, buildWithdrawCall, encodeApprove, epochPrizePoolEnterAbi, epochPrizePoolRefundAbi, epochPrizePoolViewAbi, identityToBytes32, prizePoolAbi, sendCalls, seriesToBytes32, toBytes32, waitForCalls };

package/dist/{errors-Dpeesyop.d.cts → errors-CYKgt2VU.d.cts}

@@ -46,6 +46,8 @@ interface ContractConfig {
     usdc?: `0x${string}`;
     playmosPay?: `0x${string}`;
     prizePool?: `0x${string}`;
+    /** EpochPrizePool (rolling-epoch reads — sdk#629). Live PrizePool stays on prizePool. */
+    epochPrizePool?: `0x${string}`;
 }
 /**
  * @deprecated Unused — agent routes are enabled server-side (SERVICE_MASTER_SECRET +
@@ -404,7 +406,7 @@ interface Payment {
     /** `pay_…` (IAP) or `entry_…` (prize-pool) — ULID, server-issued, unique. */
     id: string;
     status: PaymentStatus;
-    /** "iap" (1% external) or "entry" (60/30/10 prize-pool). */
+    /** "iap" (1% external) or "entry" (prize-pool; `split` is a first-party 60/30/10 projection). */
     kind: "iap" | "entry";
     /**
      * Requested amount (USD string). For prize-pool **server-settle**, this may
@@ -423,12 +425,13 @@ interface Payment {
     chainAmountMicro?: string;
     /**
      * First-party **60/30/10 projection** (pool/seed/rake USD strings) for prize-pool
-     * entries — bookkeeping preview, **not** a chain-derived settlement observation
-     * (sdk#514). Numbers come from SDK constants (`POOL_BPS`/`SEED_BPS`/`RAKE_BPS`),
-     * not from reading the deployed pool’s constructor bps. On-chain, entry only
-     * takes the fee off the top; pool/seed split at **lock**; payable pot also
-     * includes inherited seedBank — so `split.pool` is **not** “what this round pays.”
-     * Reconcile money with {@link Payment.chainAmount} / pool `getRound`.
+     * entries — bookkeeping preview, **not** a studio 60/30/9+1% split and **not** a
+     * chain-derived settlement observation (sdk#514). Numbers come from SDK constants
+     * (`POOL_BPS`/`SEED_BPS`/`RAKE_BPS`), not from reading the deployed pool’s
+     * constructor bps. On-chain, entry only takes the fee off the top; pool/seed
+     * split at **lock**; payable pot also includes inherited seedBank — so
+     * `split.pool` is **not** “what this round pays.” Reconcile money with
+     * {@link Payment.chainAmount} / pool `getRound`.
      * Field name kept for compatibility (no rename in V1).
      */
     split?: {
@@ -637,6 +640,22 @@ interface CancelRoundResult {
     status: "cancelling" | "cancelled";
     round?: RoundState;
 }
+/** L34 / sdk#610 — a win is funded only after the push tx, else claimable. */
+type PayoutNoticeStatus = "funded" | "claimable";
+interface PayoutNotice {
+    roundId: string;
+    wallet: `0x${string}`;
+    amountMicro: string;
+    status: PayoutNoticeStatus;
+    /** Present only when status === "funded". */
+    txHash?: `0x${string}`;
+    reason?: string;
+}
+interface PayoutNoticesResult {
+    roundId?: string;
+    status?: string;
+    notices: PayoutNotice[];
+}
 /** What `rounds.prize({ … })` returns — claimable pull-payment balance (issue #41). */
 interface PrizeBalance {
     roundId: string;
@@ -707,6 +726,43 @@ interface SettleRoundResult {
     status: "settled" | "settling";
 }
 
+/**
+ * EIP-5792 batch primitives — ported from the proven game-hub `payEntryOnchain`
+ * path (`OnchainEntry.ts`). One `wallet_sendCalls` sends `approve` + the settling
+ * call as ONE atomic confirmation; the paymaster sponsors gas when configured.
+ * The player sees a single Apple-Pay-style sheet.
+ */
+
+interface Call {
+    to: `0x${string}`;
+    data: `0x${string}`;
+}
+type OnchainStatus = "PENDING" | "CONFIRMED" | "FAILED";
+
+/**
+ * Calldata builders. IAP / PrizePool entry stay on `toBytes32` (keccak of
+ * UTF-8 via toBytes) because live paid entries were written with it.
+ * Epoch execute uses `seriesToBytes32` — hex-shaped series must not drift.
+ */
+
+/** The server derives these identically (keccak256 of UTF-8 bytes) so the
+ *  off-chain record and the on-chain call line up. */
+declare const toBytes32: (s: string) => `0x${string}`;
+interface EpochExecuteSettlementCallArgs {
+    epochPrizePool: `0x${string}`;
+    series: string;
+    epochId: bigint;
+    winners: `0x${string}`[];
+    amounts: bigint[];
+    signature: `0x${string}`;
+}
+/**
+ * EpochPrizePool.executeSignedSettlement — permissionless relay of an
+ * operator-signed podium (sdk#664 E1b). Series hashed with seriesToBytes32
+ * (not this file's toBytes32) so hex-shaped series cannot drift from the chain.
+ */
+declare function buildEpochExecuteSettlementCall(args: EpochExecuteSettlementCallArgs): Call;
+
 /**
  * Typed, actionable errors — the Stripe bar (spec §11).
  *
@@ -778,4 +834,4 @@ declare class NothingToWithdrawError extends PlaymosError {
     constructor(detail?: Record<string, unknown>);
 }
 
-export { type RetryOptions as $, type ActiveSeriesRound as A, type ContractConfig as B, type CancelRoundResult as C, type Eip1193Provider as D, type EscrowHoldInput as E, type GasMode as F, type GasConfig as G, InvalidAmountError as H, InsufficientGasError as I, type ListingStatus as J, type MarketplaceItem as K, type Listing as L, type MarketplaceListInput as M, type Network as N, type MarketplaceSale as O, type PlaymosConfig as P, MissingFieldError as Q, type RoundOpenInput as R, type SettleRoundResult as S, type TransferResult as T, NothingToWithdrawError as U, type VerifyResult as V, type WebhookEvent as W, PaymentFailedError as X, type PaymentStatus as Y, PlaymosError as Z, type PlaymosErrorCode as _, type RoundState as a, type RoundGetVia as a0, type RoundStatus as a1, type WalletConfig as a2, WalletConnectionError as a3, type WalletConnector as a4, WalletTimeoutError as a5, type WebhookEventType as a6, type RoundSettleInput as b, type RoundCancelInput as c, type RoundGetResult as d, type PrizeBalance as e, type WithdrawResult as f, type AgentWallet as g, type AgentFundResult as h, type EscrowHoldResult as i, type EscrowResolveResult as j, type MarketplaceSaleResult as k, type MarketplaceGetResult as l, type PayInput as m, type Payment as n, type EnterRoundInput as o, type TransferReconcile as p, type WaitOptions as q, type TransferInput as r, type TransferConfirmOptions as s, type PayoutRule as t, type ActiveForSeriesResult as u, type AgentEconomyConfig as v, AlreadyEnteredError as w, ApiError as x, AuthError as y, ConfigError as z };
+export { type PaymentStatus as $, type ActiveSeriesRound as A, AuthError as B, type Call as C, ConfigError as D, type EscrowHoldInput as E, type ContractConfig as F, type Eip1193Provider as G, type GasConfig as H, type GasMode as I, InsufficientGasError as J, InvalidAmountError as K, type Listing as L, type MarketplaceListInput as M, type Network as N, type OnchainStatus as O, type PlaymosConfig as P, type ListingStatus as Q, type RoundOpenInput as R, type SettleRoundResult as S, type TransferResult as T, type MarketplaceItem as U, type VerifyResult as V, type WebhookEvent as W, type MarketplaceSale as X, MissingFieldError as Y, NothingToWithdrawError as Z, PaymentFailedError as _, type RoundState as a, type PayoutNotice as a0, type PayoutNoticeStatus as a1, PlaymosError as a2, type PlaymosErrorCode as a3, type RetryOptions as a4, type RoundGetVia as a5, type RoundStatus as a6, type WalletConfig as a7, WalletConnectionError as a8, type WalletConnector as a9, WalletTimeoutError as aa, type WebhookEventType as ab, buildEpochExecuteSettlementCall as ac, toBytes32 as ad, type RoundSettleInput as b, type RoundCancelInput as c, type CancelRoundResult as d, type RoundGetResult as e, type PayoutNoticesResult as f, type PrizeBalance as g, type WithdrawResult as h, type AgentWallet as i, type AgentFundResult as j, type EscrowHoldResult as k, type EscrowResolveResult as l, type MarketplaceSaleResult as m, type MarketplaceGetResult as n, type PayInput as o, type Payment as p, type EnterRoundInput as q, type TransferReconcile as r, type WaitOptions as s, type TransferInput as t, type TransferConfirmOptions as u, type PayoutRule as v, type ActiveForSeriesResult as w, type AgentEconomyConfig as x, AlreadyEnteredError as y, ApiError as z };

package/dist/{errors-Dpeesyop.d.ts → errors-CYKgt2VU.d.ts}

@@ -46,6 +46,8 @@ interface ContractConfig {
     usdc?: `0x${string}`;
     playmosPay?: `0x${string}`;
     prizePool?: `0x${string}`;
+    /** EpochPrizePool (rolling-epoch reads — sdk#629). Live PrizePool stays on prizePool. */
+    epochPrizePool?: `0x${string}`;
 }
 /**
  * @deprecated Unused — agent routes are enabled server-side (SERVICE_MASTER_SECRET +
@@ -404,7 +406,7 @@ interface Payment {
     /** `pay_…` (IAP) or `entry_…` (prize-pool) — ULID, server-issued, unique. */
     id: string;
     status: PaymentStatus;
-    /** "iap" (1% external) or "entry" (60/30/10 prize-pool). */
+    /** "iap" (1% external) or "entry" (prize-pool; `split` is a first-party 60/30/10 projection). */
     kind: "iap" | "entry";
     /**
      * Requested amount (USD string). For prize-pool **server-settle**, this may
@@ -423,12 +425,13 @@ interface Payment {
     chainAmountMicro?: string;
     /**
      * First-party **60/30/10 projection** (pool/seed/rake USD strings) for prize-pool
-     * entries — bookkeeping preview, **not** a chain-derived settlement observation
-     * (sdk#514). Numbers come from SDK constants (`POOL_BPS`/`SEED_BPS`/`RAKE_BPS`),
-     * not from reading the deployed pool’s constructor bps. On-chain, entry only
-     * takes the fee off the top; pool/seed split at **lock**; payable pot also
-     * includes inherited seedBank — so `split.pool` is **not** “what this round pays.”
-     * Reconcile money with {@link Payment.chainAmount} / pool `getRound`.
+     * entries — bookkeeping preview, **not** a studio 60/30/9+1% split and **not** a
+     * chain-derived settlement observation (sdk#514). Numbers come from SDK constants
+     * (`POOL_BPS`/`SEED_BPS`/`RAKE_BPS`), not from reading the deployed pool’s
+     * constructor bps. On-chain, entry only takes the fee off the top; pool/seed
+     * split at **lock**; payable pot also includes inherited seedBank — so
+     * `split.pool` is **not** “what this round pays.” Reconcile money with
+     * {@link Payment.chainAmount} / pool `getRound`.
      * Field name kept for compatibility (no rename in V1).
      */
     split?: {
@@ -637,6 +640,22 @@ interface CancelRoundResult {
     status: "cancelling" | "cancelled";
     round?: RoundState;
 }
+/** L34 / sdk#610 — a win is funded only after the push tx, else claimable. */
+type PayoutNoticeStatus = "funded" | "claimable";
+interface PayoutNotice {
+    roundId: string;
+    wallet: `0x${string}`;
+    amountMicro: string;
+    status: PayoutNoticeStatus;
+    /** Present only when status === "funded". */
+    txHash?: `0x${string}`;
+    reason?: string;
+}
+interface PayoutNoticesResult {
+    roundId?: string;
+    status?: string;
+    notices: PayoutNotice[];
+}
 /** What `rounds.prize({ … })` returns — claimable pull-payment balance (issue #41). */
 interface PrizeBalance {
     roundId: string;
@@ -707,6 +726,43 @@ interface SettleRoundResult {
     status: "settled" | "settling";
 }
 
+/**
+ * EIP-5792 batch primitives — ported from the proven game-hub `payEntryOnchain`
+ * path (`OnchainEntry.ts`). One `wallet_sendCalls` sends `approve` + the settling
+ * call as ONE atomic confirmation; the paymaster sponsors gas when configured.
+ * The player sees a single Apple-Pay-style sheet.
+ */
+
+interface Call {
+    to: `0x${string}`;
+    data: `0x${string}`;
+}
+type OnchainStatus = "PENDING" | "CONFIRMED" | "FAILED";
+
+/**
+ * Calldata builders. IAP / PrizePool entry stay on `toBytes32` (keccak of
+ * UTF-8 via toBytes) because live paid entries were written with it.
+ * Epoch execute uses `seriesToBytes32` — hex-shaped series must not drift.
+ */
+
+/** The server derives these identically (keccak256 of UTF-8 bytes) so the
+ *  off-chain record and the on-chain call line up. */
+declare const toBytes32: (s: string) => `0x${string}`;
+interface EpochExecuteSettlementCallArgs {
+    epochPrizePool: `0x${string}`;
+    series: string;
+    epochId: bigint;
+    winners: `0x${string}`[];
+    amounts: bigint[];
+    signature: `0x${string}`;
+}
+/**
+ * EpochPrizePool.executeSignedSettlement — permissionless relay of an
+ * operator-signed podium (sdk#664 E1b). Series hashed with seriesToBytes32
+ * (not this file's toBytes32) so hex-shaped series cannot drift from the chain.
+ */
+declare function buildEpochExecuteSettlementCall(args: EpochExecuteSettlementCallArgs): Call;
+
 /**
  * Typed, actionable errors — the Stripe bar (spec §11).
  *
@@ -778,4 +834,4 @@ declare class NothingToWithdrawError extends PlaymosError {
     constructor(detail?: Record<string, unknown>);
 }
 
-export { type RetryOptions as $, type ActiveSeriesRound as A, type ContractConfig as B, type CancelRoundResult as C, type Eip1193Provider as D, type EscrowHoldInput as E, type GasMode as F, type GasConfig as G, InvalidAmountError as H, InsufficientGasError as I, type ListingStatus as J, type MarketplaceItem as K, type Listing as L, type MarketplaceListInput as M, type Network as N, type MarketplaceSale as O, type PlaymosConfig as P, MissingFieldError as Q, type RoundOpenInput as R, type SettleRoundResult as S, type TransferResult as T, NothingToWithdrawError as U, type VerifyResult as V, type WebhookEvent as W, PaymentFailedError as X, type PaymentStatus as Y, PlaymosError as Z, type PlaymosErrorCode as _, type RoundState as a, type RoundGetVia as a0, type RoundStatus as a1, type WalletConfig as a2, WalletConnectionError as a3, type WalletConnector as a4, WalletTimeoutError as a5, type WebhookEventType as a6, type RoundSettleInput as b, type RoundCancelInput as c, type RoundGetResult as d, type PrizeBalance as e, type WithdrawResult as f, type AgentWallet as g, type AgentFundResult as h, type EscrowHoldResult as i, type EscrowResolveResult as j, type MarketplaceSaleResult as k, type MarketplaceGetResult as l, type PayInput as m, type Payment as n, type EnterRoundInput as o, type TransferReconcile as p, type WaitOptions as q, type TransferInput as r, type TransferConfirmOptions as s, type PayoutRule as t, type ActiveForSeriesResult as u, type AgentEconomyConfig as v, AlreadyEnteredError as w, ApiError as x, AuthError as y, ConfigError as z };
+export { type PaymentStatus as $, type ActiveSeriesRound as A, AuthError as B, type Call as C, ConfigError as D, type EscrowHoldInput as E, type ContractConfig as F, type Eip1193Provider as G, type GasConfig as H, type GasMode as I, InsufficientGasError as J, InvalidAmountError as K, type Listing as L, type MarketplaceListInput as M, type Network as N, type OnchainStatus as O, type PlaymosConfig as P, type ListingStatus as Q, type RoundOpenInput as R, type SettleRoundResult as S, type TransferResult as T, type MarketplaceItem as U, type VerifyResult as V, type WebhookEvent as W, type MarketplaceSale as X, MissingFieldError as Y, NothingToWithdrawError as Z, PaymentFailedError as _, type RoundState as a, type PayoutNotice as a0, type PayoutNoticeStatus as a1, PlaymosError as a2, type PlaymosErrorCode as a3, type RetryOptions as a4, type RoundGetVia as a5, type RoundStatus as a6, type WalletConfig as a7, WalletConnectionError as a8, type WalletConnector as a9, WalletTimeoutError as aa, type WebhookEventType as ab, buildEpochExecuteSettlementCall as ac, toBytes32 as ad, type RoundSettleInput as b, type RoundCancelInput as c, type CancelRoundResult as d, type RoundGetResult as e, type PayoutNoticesResult as f, type PrizeBalance as g, type WithdrawResult as h, type AgentWallet as i, type AgentFundResult as j, type EscrowHoldResult as k, type EscrowResolveResult as l, type MarketplaceSaleResult as m, type MarketplaceGetResult as n, type PayInput as o, type Payment as p, type EnterRoundInput as q, type TransferReconcile as r, type WaitOptions as s, type TransferInput as t, type TransferConfirmOptions as u, type PayoutRule as v, type ActiveForSeriesResult as w, type AgentEconomyConfig as x, AlreadyEnteredError as y, ApiError as z };