@playmos/sdk 0.3.7 → 0.3.9

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, 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';
+import { N as Network, P as PlaymosConfig, W as WebhookEvent, R as RoundOpenInput, a as RoundState, b as RoundSettleInput, S as SettleRoundResult, c as RoundCancelInput, C as CancelRoundResult, A as ActiveSeriesRound, d as PrizeBalance, e as WithdrawResult, f as AgentWallet, g as AgentFundResult, T as TransferResult, E as EscrowHoldInput, h as EscrowHoldResult, i as EscrowResolveResult, M as MarketplaceListInput, L as Listing, j as MarketplaceSaleResult, k as MarketplaceGetResult, l as PayInput, m as Payment, n as EnterRoundInput, o as TransferReconcile, p as WaitOptions, q as TransferInput, r as TransferConfirmOptions, V as VerifyResult, s as PayoutRule } from './errors-BMlWHsMb.cjs';
+export { t as ActiveForSeriesResult, u as AgentEconomyConfig, v as AlreadyEnteredError, w as ApiError, x as AuthError, y as ConfigError, z as ContractConfig, B as Eip1193Provider, G as GasConfig, D as GasMode, I as InsufficientGasError, F as InvalidAmountError, H as ListingStatus, J as MarketplaceItem, K as MarketplaceSale, O as MissingFieldError, Q as NothingToWithdrawError, U as PaymentFailedError, X as PaymentStatus, Y as PlaymosError, Z as PlaymosErrorCode, _ as RetryOptions, $ as RoundStatus, a0 as WalletConfig, a1 as WalletConnectionError, a2 as WalletConnector, a3 as WalletTimeoutError, a4 as WebhookEventType } from './errors-BMlWHsMb.cjs';
 
 /**
  * Environment resolution + the canonical address book.
@@ -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: {
@@ -477,13 +510,14 @@ declare class Playmos {
         settle: (input: RoundSettleInput) => Promise<SettleRoundResult>;
         /**
          * Cancel an open/locked round (operator sk_ only). Refunds entrants' escrowed ~90%
-         * and frees the series latch. May return `status: "cancelling"` (HTTP 202) until
-         * chain Cancelled(4) reconciles — poll `rounds.get` or re-call cancel (#346).
+         * and frees the series latch (#346 / #376).
+         *
+         * **Default is submit-only:** may return `status: "cancelling"` after broadcast —
+         * that is **not** success. Only `status: "cancelled"` means the chain is terminal.
+         * Pass `{ confirm: true }` to poll until cancelled or timeout (honest `cancelling`
+         * if still pending — never invents terminal success).
          */
-        cancel: (input: {
-            roundId: string;
-            gameId?: string;
-        }) => Promise<CancelRoundResult>;
+        cancel: (input: RoundCancelInput) => Promise<CancelRoundResult>;
         get: (input: {
             roundId: string;
         }) => Promise<RoundState>;
@@ -606,6 +640,14 @@ declare class Playmos {
      */
     private readonly mockPayments;
     constructor(config: PlaymosConfig);
+    /**
+     * Wallet timeout policy (#462 / PR #463 residual).
+     * - connectTimeoutMs → eth_requestAccounts only
+     * - machine RPCs → 20s default
+     * - wallet_sendCalls → unbounded (0) — never short-time a payment sheet
+     */
+    private walletTimeoutPolicy;
+    private walletProvider;
     /** Connect the player's wallet and return their address. */
     connect(): Promise<`0x${string}`>;
     /**
@@ -848,4 +890,4 @@ declare function ulid(seedTime?: number): string;
 /** `${prefix}_${ulid()}` — e.g. `pay_01J…`, `entry_01J…`, `idem_01J…`. */
 declare function prefixedId(prefix: string): string;
 
-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 };
+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, RoundCancelInput, 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, 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';
+import { N as Network, P as PlaymosConfig, W as WebhookEvent, R as RoundOpenInput, a as RoundState, b as RoundSettleInput, S as SettleRoundResult, c as RoundCancelInput, C as CancelRoundResult, A as ActiveSeriesRound, d as PrizeBalance, e as WithdrawResult, f as AgentWallet, g as AgentFundResult, T as TransferResult, E as EscrowHoldInput, h as EscrowHoldResult, i as EscrowResolveResult, M as MarketplaceListInput, L as Listing, j as MarketplaceSaleResult, k as MarketplaceGetResult, l as PayInput, m as Payment, n as EnterRoundInput, o as TransferReconcile, p as WaitOptions, q as TransferInput, r as TransferConfirmOptions, V as VerifyResult, s as PayoutRule } from './errors-BMlWHsMb.js';
+export { t as ActiveForSeriesResult, u as AgentEconomyConfig, v as AlreadyEnteredError, w as ApiError, x as AuthError, y as ConfigError, z as ContractConfig, B as Eip1193Provider, G as GasConfig, D as GasMode, I as InsufficientGasError, F as InvalidAmountError, H as ListingStatus, J as MarketplaceItem, K as MarketplaceSale, O as MissingFieldError, Q as NothingToWithdrawError, U as PaymentFailedError, X as PaymentStatus, Y as PlaymosError, Z as PlaymosErrorCode, _ as RetryOptions, $ as RoundStatus, a0 as WalletConfig, a1 as WalletConnectionError, a2 as WalletConnector, a3 as WalletTimeoutError, a4 as WebhookEventType } from './errors-BMlWHsMb.js';
 
 /**
  * Environment resolution + the canonical address book.
@@ -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: {
@@ -477,13 +510,14 @@ declare class Playmos {
         settle: (input: RoundSettleInput) => Promise<SettleRoundResult>;
         /**
          * Cancel an open/locked round (operator sk_ only). Refunds entrants' escrowed ~90%
-         * and frees the series latch. May return `status: "cancelling"` (HTTP 202) until
-         * chain Cancelled(4) reconciles — poll `rounds.get` or re-call cancel (#346).
+         * and frees the series latch (#346 / #376).
+         *
+         * **Default is submit-only:** may return `status: "cancelling"` after broadcast —
+         * that is **not** success. Only `status: "cancelled"` means the chain is terminal.
+         * Pass `{ confirm: true }` to poll until cancelled or timeout (honest `cancelling`
+         * if still pending — never invents terminal success).
          */
-        cancel: (input: {
-            roundId: string;
-            gameId?: string;
-        }) => Promise<CancelRoundResult>;
+        cancel: (input: RoundCancelInput) => Promise<CancelRoundResult>;
         get: (input: {
             roundId: string;
         }) => Promise<RoundState>;
@@ -606,6 +640,14 @@ declare class Playmos {
      */
     private readonly mockPayments;
     constructor(config: PlaymosConfig);
+    /**
+     * Wallet timeout policy (#462 / PR #463 residual).
+     * - connectTimeoutMs → eth_requestAccounts only
+     * - machine RPCs → 20s default
+     * - wallet_sendCalls → unbounded (0) — never short-time a payment sheet
+     */
+    private walletTimeoutPolicy;
+    private walletProvider;
     /** Connect the player's wallet and return their address. */
     connect(): Promise<`0x${string}`>;
     /**
@@ -848,4 +890,4 @@ declare function ulid(seedTime?: number): string;
 /** `${prefix}_${ulid()}` — e.g. `pay_01J…`, `entry_01J…`, `idem_01J…`. */
 declare function prefixedId(prefix: string): string;
 
-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 };
+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, RoundCancelInput, 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 };