@playmos/sdk 0.3.4 → 0.3.5

package/dist/{errors-B_AqyZQE.d.cts → errors-CdVzHuhY.d.cts}

@@ -486,6 +486,11 @@ interface RoundState {
     roundId: string;
     gameId: string;
     roundKey: string;
+    /**
+     * Series latch key for the 60/30/10 flywheel (#351). Required for
+     * `rounds.activeForSeries` under mock — open must persist it (not discard).
+     */
+    seriesKey?: string;
     status: RoundStatus;
     entryAmount: string;
     /** Payable pool in USD from chain after reconcile; **`null` until reconciled** (never a fabricated "0.00"). Issue #42. */
@@ -505,6 +510,28 @@ interface RoundState {
      */
     prizePoolAddress?: `0x${string}` | null;
 }
+/**
+ * Active series latch from `GET /v1/series/:seriesKey/active` (#351).
+ * `null` from `activeForSeries` is a **proof of free**, not a failed probe.
+ */
+interface ActiveSeriesRound {
+    roundId: string | null;
+    roundKey: string | null;
+    roundIdHash: `0x${string}`;
+    status: RoundStatus | "opening" | "cancelling";
+    /** null if unreconciled — never fabricate 0 */
+    entrants: number | null;
+    /** null unless Locked/Settled */
+    pool: string | null;
+    openTxHash?: string | null;
+    cancelTxHash?: string | null;
+    prizePoolAddress: `0x${string}`;
+}
+interface ActiveForSeriesResult {
+    series: string;
+    via: "chain" | "cache";
+    active: ActiveSeriesRound | null;
+}
 /** Result of `playmos.rounds.cancel` — may be async 202 cancelling (#346). */
 interface CancelRoundResult {
     roundId: string;
@@ -623,4 +650,4 @@ declare class NothingToWithdrawError extends PlaymosError {
     constructor(detail?: Record<string, unknown>);
 }
 
-export { type WebhookEventType as $, type AgentWallet as A, type MarketplaceItem as B, type CancelRoundResult as C, type MarketplaceSale as D, type EscrowHoldInput as E, MissingFieldError as F, type GasConfig as G, NothingToWithdrawError as H, InsufficientGasError as I, PaymentFailedError as J, type PaymentStatus as K, type Listing as L, type MarketplaceListInput as M, type Network as N, PlaymosError as O, type PlaymosConfig as P, type PlaymosErrorCode as Q, type RoundOpenInput as R, type SettleRoundResult as S, type TransferResult as T, type RetryOptions as U, type VerifyResult as V, type WebhookEvent as W, type RoundStatus as X, type WalletConfig as Y, WalletConnectionError as Z, type WalletConnector as _, type RoundState as a, type RoundSettleInput as b, type PrizeBalance as c, type WithdrawResult as d, type AgentFundResult as e, type EscrowHoldResult as f, type EscrowResolveResult as g, type MarketplaceSaleResult as h, type MarketplaceGetResult as i, type PayInput as j, type Payment as k, type EnterRoundInput as l, type TransferReconcile as m, type WaitOptions as n, type TransferInput as o, type TransferConfirmOptions as p, type PayoutRule as q, type AgentEconomyConfig as r, ApiError as s, AuthError as t, ConfigError as u, type ContractConfig as v, type Eip1193Provider as w, type GasMode as x, InvalidAmountError as y, type ListingStatus as z };
+export { WalletConnectionError as $, type ActiveSeriesRound as A, InvalidAmountError as B, type CancelRoundResult as C, type ListingStatus as D, type EscrowHoldInput as E, type MarketplaceItem as F, type GasConfig as G, type MarketplaceSale as H, InsufficientGasError as I, MissingFieldError as J, NothingToWithdrawError as K, type Listing as L, type MarketplaceListInput as M, type Network as N, PaymentFailedError as O, type PlaymosConfig as P, type PaymentStatus as Q, type RoundOpenInput as R, type SettleRoundResult as S, type TransferResult as T, PlaymosError as U, type VerifyResult as V, type WebhookEvent as W, type PlaymosErrorCode as X, type RetryOptions as Y, type RoundStatus as Z, type WalletConfig as _, type RoundState as a, type WalletConnector as a0, type WebhookEventType as a1, type RoundSettleInput as b, type PrizeBalance as c, type WithdrawResult as d, type AgentWallet as e, type AgentFundResult as f, type EscrowHoldResult as g, type EscrowResolveResult as h, type MarketplaceSaleResult as i, type MarketplaceGetResult as j, type PayInput as k, type Payment as l, type EnterRoundInput as m, type TransferReconcile as n, type WaitOptions as o, type TransferInput as p, type TransferConfirmOptions as q, type PayoutRule as r, type ActiveForSeriesResult as s, type AgentEconomyConfig as t, ApiError as u, AuthError as v, ConfigError as w, type ContractConfig as x, type Eip1193Provider as y, type GasMode as z };

package/dist/{errors-B_AqyZQE.d.ts → errors-CdVzHuhY.d.ts}

@@ -486,6 +486,11 @@ interface RoundState {
     roundId: string;
     gameId: string;
     roundKey: string;
+    /**
+     * Series latch key for the 60/30/10 flywheel (#351). Required for
+     * `rounds.activeForSeries` under mock — open must persist it (not discard).
+     */
+    seriesKey?: string;
     status: RoundStatus;
     entryAmount: string;
     /** Payable pool in USD from chain after reconcile; **`null` until reconciled** (never a fabricated "0.00"). Issue #42. */
@@ -505,6 +510,28 @@ interface RoundState {
      */
     prizePoolAddress?: `0x${string}` | null;
 }
+/**
+ * Active series latch from `GET /v1/series/:seriesKey/active` (#351).
+ * `null` from `activeForSeries` is a **proof of free**, not a failed probe.
+ */
+interface ActiveSeriesRound {
+    roundId: string | null;
+    roundKey: string | null;
+    roundIdHash: `0x${string}`;
+    status: RoundStatus | "opening" | "cancelling";
+    /** null if unreconciled — never fabricate 0 */
+    entrants: number | null;
+    /** null unless Locked/Settled */
+    pool: string | null;
+    openTxHash?: string | null;
+    cancelTxHash?: string | null;
+    prizePoolAddress: `0x${string}`;
+}
+interface ActiveForSeriesResult {
+    series: string;
+    via: "chain" | "cache";
+    active: ActiveSeriesRound | null;
+}
 /** Result of `playmos.rounds.cancel` — may be async 202 cancelling (#346). */
 interface CancelRoundResult {
     roundId: string;
@@ -623,4 +650,4 @@ declare class NothingToWithdrawError extends PlaymosError {
     constructor(detail?: Record<string, unknown>);
 }
 
-export { type WebhookEventType as $, type AgentWallet as A, type MarketplaceItem as B, type CancelRoundResult as C, type MarketplaceSale as D, type EscrowHoldInput as E, MissingFieldError as F, type GasConfig as G, NothingToWithdrawError as H, InsufficientGasError as I, PaymentFailedError as J, type PaymentStatus as K, type Listing as L, type MarketplaceListInput as M, type Network as N, PlaymosError as O, type PlaymosConfig as P, type PlaymosErrorCode as Q, type RoundOpenInput as R, type SettleRoundResult as S, type TransferResult as T, type RetryOptions as U, type VerifyResult as V, type WebhookEvent as W, type RoundStatus as X, type WalletConfig as Y, WalletConnectionError as Z, type WalletConnector as _, type RoundState as a, type RoundSettleInput as b, type PrizeBalance as c, type WithdrawResult as d, type AgentFundResult as e, type EscrowHoldResult as f, type EscrowResolveResult as g, type MarketplaceSaleResult as h, type MarketplaceGetResult as i, type PayInput as j, type Payment as k, type EnterRoundInput as l, type TransferReconcile as m, type WaitOptions as n, type TransferInput as o, type TransferConfirmOptions as p, type PayoutRule as q, type AgentEconomyConfig as r, ApiError as s, AuthError as t, ConfigError as u, type ContractConfig as v, type Eip1193Provider as w, type GasMode as x, InvalidAmountError as y, type ListingStatus as z };
+export { WalletConnectionError as $, type ActiveSeriesRound as A, InvalidAmountError as B, type CancelRoundResult as C, type ListingStatus as D, type EscrowHoldInput as E, type MarketplaceItem as F, type GasConfig as G, type MarketplaceSale as H, InsufficientGasError as I, MissingFieldError as J, NothingToWithdrawError as K, type Listing as L, type MarketplaceListInput as M, type Network as N, PaymentFailedError as O, type PlaymosConfig as P, type PaymentStatus as Q, type RoundOpenInput as R, type SettleRoundResult as S, type TransferResult as T, PlaymosError as U, type VerifyResult as V, type WebhookEvent as W, type PlaymosErrorCode as X, type RetryOptions as Y, type RoundStatus as Z, type WalletConfig as _, type RoundState as a, type WalletConnector as a0, type WebhookEventType as a1, type RoundSettleInput as b, type PrizeBalance as c, type WithdrawResult as d, type AgentWallet as e, type AgentFundResult as f, type EscrowHoldResult as g, type EscrowResolveResult as h, type MarketplaceSaleResult as i, type MarketplaceGetResult as j, type PayInput as k, type Payment as l, type EnterRoundInput as m, type TransferReconcile as n, type WaitOptions as o, type TransferInput as p, type TransferConfirmOptions as q, type PayoutRule as r, type ActiveForSeriesResult as s, type AgentEconomyConfig as t, ApiError as u, AuthError as v, ConfigError as w, type ContractConfig as x, type Eip1193Provider as y, type GasMode as z };

package/dist/index.cjs

@@ -1005,6 +1005,8 @@ var Playmos = class {
             roundId: input.roundId,
             gameId: input.gameId,
             roundKey,
+            // #351 — must persist seriesKey so activeForSeries mock is authoritative
+            seriesKey: input.seriesKey ?? input.gameId,
             status: "open",
             entryAmount: input.entryAmount,
             pool: null,
@@ -1201,6 +1203,58 @@ var Playmos = class {
         );
         return round;
       },
+      /**
+       * Authoritative series latch (#351) — `null` means **proven free**.
+       * `GET /v1/series/:seriesKey/active?gameId=…` — not a candidate probe.
+       */
+      activeForSeries: async (input) => {
+        requireField(input?.seriesKey, "seriesKey");
+        requireField(input?.gameId, "gameId");
+        if (this.config.mock) {
+          for (const r of this.mockRounds.values()) {
+            if (r.gameId !== input.gameId) continue;
+            const sk = r.seriesKey ?? r.gameId;
+            if (sk !== input.seriesKey) continue;
+            if (r.status === "open" || r.status === "locked" || r.status === "opening" || r.status === "cancelling") {
+              return {
+                roundId: r.roundId,
+                roundKey: r.roundKey,
+                roundIdHash: "0x" + "m".repeat(64),
+                status: r.status,
+                entrants: r.entrants,
+                pool: r.pool,
+                openTxHash: r.openTxHash ?? null,
+                cancelTxHash: r.cancelTxHash ?? null,
+                prizePoolAddress: r.prizePoolAddress ?? "0x0000000000000000000000000000000000000002"
+              };
+            }
+          }
+          return null;
+        }
+        const body = await this.http.get(
+          `/series/${encodeURIComponent(input.seriesKey)}/active?gameId=${encodeURIComponent(input.gameId)}`
+        );
+        if (body == null || typeof body !== "object") {
+          throw new ApiError("activeForSeries: malformed response (expected object body)", {
+            code: "invalid_response",
+            status: 502
+          });
+        }
+        if (!("active" in body)) {
+          throw new ApiError("activeForSeries: malformed response (missing active field)", {
+            code: "invalid_response",
+            status: 502
+          });
+        }
+        if (body.active === null) return null;
+        if (body.active == null || typeof body.active !== "object") {
+          throw new ApiError("activeForSeries: malformed response (active must be object or null)", {
+            code: "invalid_response",
+            status: 502
+          });
+        }
+        return body.active;
+      },
       /**
        * Read a wallet's **claimable** prize balance for a round (issue #41).
        * Prefers the service chain read (`GET /v1/rounds/:id/prize?wallet=`); falls

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { N as Network, P as PlaymosConfig, W as WebhookEvent, R as RoundOpenInput, a as RoundState, b as RoundSettleInput, S as SettleRoundResult, C as CancelRoundResult, c as PrizeBalance, d as WithdrawResult, A as AgentWallet, e as AgentFundResult, T as TransferResult, E as EscrowHoldInput, f as EscrowHoldResult, g as EscrowResolveResult, M as MarketplaceListInput, L as Listing, h as MarketplaceSaleResult, i as MarketplaceGetResult, j as PayInput, k as Payment, l as EnterRoundInput, m as TransferReconcile, n as WaitOptions, o as TransferInput, p as TransferConfirmOptions, V as VerifyResult, q as PayoutRule } from './errors-B_AqyZQE.cjs';
-export { r as AgentEconomyConfig, s as ApiError, t as AuthError, u as ConfigError, v as ContractConfig, w as Eip1193Provider, G as GasConfig, x as GasMode, I as InsufficientGasError, y as InvalidAmountError, z as ListingStatus, B as MarketplaceItem, D as MarketplaceSale, F as MissingFieldError, H as NothingToWithdrawError, J as PaymentFailedError, K as PaymentStatus, O as PlaymosError, Q as PlaymosErrorCode, U as RetryOptions, X as RoundStatus, Y as WalletConfig, Z as WalletConnectionError, _ as WalletConnector, $ as WebhookEventType } from './errors-B_AqyZQE.cjs';
+import { N as Network, P as PlaymosConfig, W as WebhookEvent, R as RoundOpenInput, a as RoundState, b as RoundSettleInput, S as SettleRoundResult, C as CancelRoundResult, A as ActiveSeriesRound, c as PrizeBalance, d as WithdrawResult, e as AgentWallet, f as AgentFundResult, T as TransferResult, E as EscrowHoldInput, g as EscrowHoldResult, h as EscrowResolveResult, M as MarketplaceListInput, L as Listing, i as MarketplaceSaleResult, j as MarketplaceGetResult, k as PayInput, l as Payment, m as EnterRoundInput, n as TransferReconcile, o as WaitOptions, p as TransferInput, q as TransferConfirmOptions, V as VerifyResult, r as PayoutRule } from './errors-CdVzHuhY.cjs';
+export { s as ActiveForSeriesResult, t as AgentEconomyConfig, u as ApiError, v as AuthError, w as ConfigError, x as ContractConfig, y as Eip1193Provider, G as GasConfig, z as GasMode, I as InsufficientGasError, B as InvalidAmountError, D as ListingStatus, F as MarketplaceItem, H as MarketplaceSale, J as MissingFieldError, K as NothingToWithdrawError, O as PaymentFailedError, Q as PaymentStatus, U as PlaymosError, X as PlaymosErrorCode, Y as RetryOptions, Z as RoundStatus, _ as WalletConfig, $ as WalletConnectionError, a0 as WalletConnector, a1 as WebhookEventType } from './errors-CdVzHuhY.cjs';
 
 /**
  * Environment resolution + the canonical address book.
@@ -487,6 +487,14 @@ declare class Playmos {
         get: (input: {
             roundId: string;
         }) => Promise<RoundState>;
+        /**
+         * Authoritative series latch (#351) — `null` means **proven free**.
+         * `GET /v1/series/:seriesKey/active?gameId=…` — not a candidate probe.
+         */
+        activeForSeries: (input: {
+            seriesKey: string;
+            gameId: string;
+        }) => Promise<ActiveSeriesRound | null>;
         /**
          * Read a wallet's **claimable** prize balance for a round (issue #41).
          * Prefers the service chain read (`GET /v1/rounds/:id/prize?wallet=`); falls
@@ -840,4 +848,4 @@ declare function ulid(seedTime?: number): string;
 /** `${prefix}_${ulid()}` — e.g. `pay_01J…`, `entry_01J…`, `idem_01J…`. */
 declare function prefixedId(prefix: string): string;
 
-export { AgentFundResult, AgentWallet, type Authorization, CHAIN_ID, CancelRoundResult, type CreatePaymentRequirementInput, DEFAULT_API_BASE_URL, EnterRoundInput, EscrowHoldInput, EscrowHoldResult, EscrowResolveResult, Listing, MICRO_PER_USDC, MarketplaceGetResult, MarketplaceListInput, MarketplaceSaleResult, Network, PayInput, Payment, type PaymentRequirement, PayoutError, PayoutRule, PayoutRule as PayoutRuleCompute, Playmos, PlaymosConfig, PrizeBalance, RoundOpenInput, RoundSettleInput, RoundState, SettleRoundResult, type SettlementAsset, TransferConfirmOptions, TransferInput, TransferReconcile, TransferResult, USDC_ADDRESS, USDC_DECIMALS, VerifyResult, WaitOptions, type WalletSignatureAuthorization, WebhookEvent, WithdrawResult, type X402ChallengeInput, type X402ChallengeResult, type X402FulfillAuthorization, type X402PayInput, type X402PayloadAuthorization, type X402PayloadMode, type X402PaymentRequired, type X402SettleResult, clientRuntimeSignals, computeIapSplit, computePayout, computePoolSplit, createPaymentRequirement, createX402Challenge, decodePaymentHeader, encodePaymentHeader, formatMicroToUsd, isClientRuntime, isWalletSignatureAuthorization, isX402PayloadAuthorization, networkToCaip2, parsePaymentRequirement, parseUsdToMicro, prefixedId, previewEscrowFee, previewIapSplit, previewMarketplaceSplit, previewPoolSplit, previewTransferSplit, resolveEnv, serializePaymentRequirement, toX402PaymentRequired, ulid, validateX402ChallengeInput };
+export { ActiveSeriesRound, AgentFundResult, AgentWallet, type Authorization, CHAIN_ID, CancelRoundResult, type CreatePaymentRequirementInput, DEFAULT_API_BASE_URL, EnterRoundInput, EscrowHoldInput, EscrowHoldResult, EscrowResolveResult, Listing, MICRO_PER_USDC, MarketplaceGetResult, MarketplaceListInput, MarketplaceSaleResult, Network, PayInput, Payment, type PaymentRequirement, PayoutError, PayoutRule, PayoutRule as PayoutRuleCompute, Playmos, PlaymosConfig, PrizeBalance, RoundOpenInput, RoundSettleInput, RoundState, SettleRoundResult, type SettlementAsset, TransferConfirmOptions, TransferInput, TransferReconcile, TransferResult, USDC_ADDRESS, USDC_DECIMALS, VerifyResult, WaitOptions, type WalletSignatureAuthorization, WebhookEvent, WithdrawResult, type X402ChallengeInput, type X402ChallengeResult, type X402FulfillAuthorization, type X402PayInput, type X402PayloadAuthorization, type X402PayloadMode, type X402PaymentRequired, type X402SettleResult, clientRuntimeSignals, computeIapSplit, computePayout, computePoolSplit, createPaymentRequirement, createX402Challenge, decodePaymentHeader, encodePaymentHeader, formatMicroToUsd, isClientRuntime, isWalletSignatureAuthorization, isX402PayloadAuthorization, networkToCaip2, parsePaymentRequirement, parseUsdToMicro, prefixedId, previewEscrowFee, previewIapSplit, previewMarketplaceSplit, previewPoolSplit, previewTransferSplit, resolveEnv, serializePaymentRequirement, toX402PaymentRequired, ulid, validateX402ChallengeInput };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { N as Network, P as PlaymosConfig, W as WebhookEvent, R as RoundOpenInput, a as RoundState, b as RoundSettleInput, S as SettleRoundResult, C as CancelRoundResult, c as PrizeBalance, d as WithdrawResult, A as AgentWallet, e as AgentFundResult, T as TransferResult, E as EscrowHoldInput, f as EscrowHoldResult, g as EscrowResolveResult, M as MarketplaceListInput, L as Listing, h as MarketplaceSaleResult, i as MarketplaceGetResult, j as PayInput, k as Payment, l as EnterRoundInput, m as TransferReconcile, n as WaitOptions, o as TransferInput, p as TransferConfirmOptions, V as VerifyResult, q as PayoutRule } from './errors-B_AqyZQE.js';
-export { r as AgentEconomyConfig, s as ApiError, t as AuthError, u as ConfigError, v as ContractConfig, w as Eip1193Provider, G as GasConfig, x as GasMode, I as InsufficientGasError, y as InvalidAmountError, z as ListingStatus, B as MarketplaceItem, D as MarketplaceSale, F as MissingFieldError, H as NothingToWithdrawError, J as PaymentFailedError, K as PaymentStatus, O as PlaymosError, Q as PlaymosErrorCode, U as RetryOptions, X as RoundStatus, Y as WalletConfig, Z as WalletConnectionError, _ as WalletConnector, $ as WebhookEventType } from './errors-B_AqyZQE.js';
+import { N as Network, P as PlaymosConfig, W as WebhookEvent, R as RoundOpenInput, a as RoundState, b as RoundSettleInput, S as SettleRoundResult, C as CancelRoundResult, A as ActiveSeriesRound, c as PrizeBalance, d as WithdrawResult, e as AgentWallet, f as AgentFundResult, T as TransferResult, E as EscrowHoldInput, g as EscrowHoldResult, h as EscrowResolveResult, M as MarketplaceListInput, L as Listing, i as MarketplaceSaleResult, j as MarketplaceGetResult, k as PayInput, l as Payment, m as EnterRoundInput, n as TransferReconcile, o as WaitOptions, p as TransferInput, q as TransferConfirmOptions, V as VerifyResult, r as PayoutRule } from './errors-CdVzHuhY.js';
+export { s as ActiveForSeriesResult, t as AgentEconomyConfig, u as ApiError, v as AuthError, w as ConfigError, x as ContractConfig, y as Eip1193Provider, G as GasConfig, z as GasMode, I as InsufficientGasError, B as InvalidAmountError, D as ListingStatus, F as MarketplaceItem, H as MarketplaceSale, J as MissingFieldError, K as NothingToWithdrawError, O as PaymentFailedError, Q as PaymentStatus, U as PlaymosError, X as PlaymosErrorCode, Y as RetryOptions, Z as RoundStatus, _ as WalletConfig, $ as WalletConnectionError, a0 as WalletConnector, a1 as WebhookEventType } from './errors-CdVzHuhY.js';
 
 /**
  * Environment resolution + the canonical address book.
@@ -487,6 +487,14 @@ declare class Playmos {
         get: (input: {
             roundId: string;
         }) => Promise<RoundState>;
+        /**
+         * Authoritative series latch (#351) — `null` means **proven free**.
+         * `GET /v1/series/:seriesKey/active?gameId=…` — not a candidate probe.
+         */
+        activeForSeries: (input: {
+            seriesKey: string;
+            gameId: string;
+        }) => Promise<ActiveSeriesRound | null>;
         /**
          * Read a wallet's **claimable** prize balance for a round (issue #41).
          * Prefers the service chain read (`GET /v1/rounds/:id/prize?wallet=`); falls
@@ -840,4 +848,4 @@ declare function ulid(seedTime?: number): string;
 /** `${prefix}_${ulid()}` — e.g. `pay_01J…`, `entry_01J…`, `idem_01J…`. */
 declare function prefixedId(prefix: string): string;
 
-export { AgentFundResult, AgentWallet, type Authorization, CHAIN_ID, CancelRoundResult, type CreatePaymentRequirementInput, DEFAULT_API_BASE_URL, EnterRoundInput, EscrowHoldInput, EscrowHoldResult, EscrowResolveResult, Listing, MICRO_PER_USDC, MarketplaceGetResult, MarketplaceListInput, MarketplaceSaleResult, Network, PayInput, Payment, type PaymentRequirement, PayoutError, PayoutRule, PayoutRule as PayoutRuleCompute, Playmos, PlaymosConfig, PrizeBalance, RoundOpenInput, RoundSettleInput, RoundState, SettleRoundResult, type SettlementAsset, TransferConfirmOptions, TransferInput, TransferReconcile, TransferResult, USDC_ADDRESS, USDC_DECIMALS, VerifyResult, WaitOptions, type WalletSignatureAuthorization, WebhookEvent, WithdrawResult, type X402ChallengeInput, type X402ChallengeResult, type X402FulfillAuthorization, type X402PayInput, type X402PayloadAuthorization, type X402PayloadMode, type X402PaymentRequired, type X402SettleResult, clientRuntimeSignals, computeIapSplit, computePayout, computePoolSplit, createPaymentRequirement, createX402Challenge, decodePaymentHeader, encodePaymentHeader, formatMicroToUsd, isClientRuntime, isWalletSignatureAuthorization, isX402PayloadAuthorization, networkToCaip2, parsePaymentRequirement, parseUsdToMicro, prefixedId, previewEscrowFee, previewIapSplit, previewMarketplaceSplit, previewPoolSplit, previewTransferSplit, resolveEnv, serializePaymentRequirement, toX402PaymentRequired, ulid, validateX402ChallengeInput };
+export { ActiveSeriesRound, AgentFundResult, AgentWallet, type Authorization, CHAIN_ID, CancelRoundResult, type CreatePaymentRequirementInput, DEFAULT_API_BASE_URL, EnterRoundInput, EscrowHoldInput, EscrowHoldResult, EscrowResolveResult, Listing, MICRO_PER_USDC, MarketplaceGetResult, MarketplaceListInput, MarketplaceSaleResult, Network, PayInput, Payment, type PaymentRequirement, PayoutError, PayoutRule, PayoutRule as PayoutRuleCompute, Playmos, PlaymosConfig, PrizeBalance, RoundOpenInput, RoundSettleInput, RoundState, SettleRoundResult, type SettlementAsset, TransferConfirmOptions, TransferInput, TransferReconcile, TransferResult, USDC_ADDRESS, USDC_DECIMALS, VerifyResult, WaitOptions, type WalletSignatureAuthorization, WebhookEvent, WithdrawResult, type X402ChallengeInput, type X402ChallengeResult, type X402FulfillAuthorization, type X402PayInput, type X402PayloadAuthorization, type X402PayloadMode, type X402PaymentRequired, type X402SettleResult, clientRuntimeSignals, computeIapSplit, computePayout, computePoolSplit, createPaymentRequirement, createX402Challenge, decodePaymentHeader, encodePaymentHeader, formatMicroToUsd, isClientRuntime, isWalletSignatureAuthorization, isX402PayloadAuthorization, networkToCaip2, parsePaymentRequirement, parseUsdToMicro, prefixedId, previewEscrowFee, previewIapSplit, previewMarketplaceSplit, previewPoolSplit, previewTransferSplit, resolveEnv, serializePaymentRequirement, toX402PaymentRequired, ulid, validateX402ChallengeInput };

package/dist/index.js

@@ -935,6 +935,8 @@ var Playmos = class {
             roundId: input.roundId,
             gameId: input.gameId,
             roundKey,
+            // #351 — must persist seriesKey so activeForSeries mock is authoritative
+            seriesKey: input.seriesKey ?? input.gameId,
             status: "open",
             entryAmount: input.entryAmount,
             pool: null,
@@ -1131,6 +1133,58 @@ var Playmos = class {
         );
         return round;
       },
+      /**
+       * Authoritative series latch (#351) — `null` means **proven free**.
+       * `GET /v1/series/:seriesKey/active?gameId=…` — not a candidate probe.
+       */
+      activeForSeries: async (input) => {
+        requireField(input?.seriesKey, "seriesKey");
+        requireField(input?.gameId, "gameId");
+        if (this.config.mock) {
+          for (const r of this.mockRounds.values()) {
+            if (r.gameId !== input.gameId) continue;
+            const sk = r.seriesKey ?? r.gameId;
+            if (sk !== input.seriesKey) continue;
+            if (r.status === "open" || r.status === "locked" || r.status === "opening" || r.status === "cancelling") {
+              return {
+                roundId: r.roundId,
+                roundKey: r.roundKey,
+                roundIdHash: "0x" + "m".repeat(64),
+                status: r.status,
+                entrants: r.entrants,
+                pool: r.pool,
+                openTxHash: r.openTxHash ?? null,
+                cancelTxHash: r.cancelTxHash ?? null,
+                prizePoolAddress: r.prizePoolAddress ?? "0x0000000000000000000000000000000000000002"
+              };
+            }
+          }
+          return null;
+        }
+        const body = await this.http.get(
+          `/series/${encodeURIComponent(input.seriesKey)}/active?gameId=${encodeURIComponent(input.gameId)}`
+        );
+        if (body == null || typeof body !== "object") {
+          throw new ApiError("activeForSeries: malformed response (expected object body)", {
+            code: "invalid_response",
+            status: 502
+          });
+        }
+        if (!("active" in body)) {
+          throw new ApiError("activeForSeries: malformed response (missing active field)", {
+            code: "invalid_response",
+            status: 502
+          });
+        }
+        if (body.active === null) return null;
+        if (body.active == null || typeof body.active !== "object") {
+          throw new ApiError("activeForSeries: malformed response (active must be object or null)", {
+            code: "invalid_response",
+            status: 502
+          });
+        }
+        return body.active;
+      },
       /**
        * Read a wallet's **claimable** prize balance for a round (issue #41).
        * Prefers the service chain read (`GET /v1/rounds/:id/prize?wallet=`); falls

package/dist/server.d.cts

@@ -1,4 +1,4 @@
-import { O as PlaymosError, W as WebhookEvent } from './errors-B_AqyZQE.cjs';
+import { U as PlaymosError, W as WebhookEvent } from './errors-CdVzHuhY.cjs';
 
 /**
  * Webhook signature verification (spec §6.2) — server-side only.

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-import { O as PlaymosError, W as WebhookEvent } from './errors-B_AqyZQE.js';
+import { U as PlaymosError, W as WebhookEvent } from './errors-CdVzHuhY.js';
 
 /**
  * Webhook signature verification (spec §6.2) — server-side only.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@playmos/sdk",
-  "version": "0.3.4",
-  "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.",
+  "version": "0.3.5",
+  "description": "Playmos SDK \u2014 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,
   "type": "module",