@scuro/sdk 0.1.0-beta.1

package/dist/coordinator.d.ts

@@ -0,0 +1,108 @@
+import type { Address, Hex } from "viem";
+import { createContractHelpers } from "./contracts";
+import type { CreateScuroClientOptions, ScuroContractHelpers, ScuroCoordinatorHelpers } from "./internal/types";
+export interface PokerInitialDealProof {
+    deckCommitment: Hex;
+    handNonce: Hex;
+    handCommitments: readonly [Hex, Hex];
+    encryptionKeyCommitments: readonly [Hex, Hex];
+    ciphertextRefs: readonly [Hex, Hex];
+    proof: Hex;
+}
+export interface PokerDrawProof {
+    player: Address;
+    newCommitment: Hex;
+    newEncryptionKeyCommitment: Hex;
+    newCiphertextRef: Hex;
+    proof: Hex;
+}
+export interface PokerShowdownProof {
+    winnerAddr: Address;
+    isTie: boolean;
+    proof: Hex;
+}
+export interface PokerProofProvider {
+    provideInitialDeal(snapshot: Awaited<ReturnType<ReturnType<typeof createContractHelpers>["inspect"]["pokerGame"]>>): Promise<PokerInitialDealProof>;
+    provideDraw(snapshot: Awaited<ReturnType<ReturnType<typeof createContractHelpers>["inspect"]["pokerGame"]>> & {
+        player: Address;
+        playerIndex: 0 | 1;
+    }): Promise<PokerDrawProof>;
+    provideShowdown(snapshot: Awaited<ReturnType<ReturnType<typeof createContractHelpers>["inspect"]["pokerGame"]>>): Promise<PokerShowdownProof>;
+}
+export interface BlackjackInitialDealProof {
+    deckCommitment: Hex;
+    handNonce: Hex;
+    playerStateCommitment: Hex;
+    dealerStateCommitment: Hex;
+    playerCiphertextRef: Hex;
+    dealerCiphertextRef: Hex;
+    dealerVisibleValue: bigint;
+    handCount: number;
+    activeHandIndex: number;
+    payout: bigint;
+    immediateResultCode: number;
+    handValues: readonly [bigint, bigint, bigint, bigint];
+    handStatuses: readonly [number, number, number, number];
+    allowedActionMasks: readonly [number, number, number, number];
+    softMask: bigint;
+    proof: Hex;
+}
+export interface BlackjackActionProof {
+    kind: "action";
+    args: {
+        newPlayerStateCommitment: Hex;
+        dealerStateCommitment: Hex;
+        playerCiphertextRef: Hex;
+        dealerCiphertextRef: Hex;
+        dealerVisibleValue: bigint;
+        handCount: number;
+        activeHandIndex: number;
+        nextPhase: number;
+        handValues: readonly [bigint, bigint, bigint, bigint];
+        handStatuses: readonly [number, number, number, number];
+        allowedActionMasks: readonly [number, number, number, number];
+        softMask: bigint;
+        proof: Hex;
+    };
+}
+export interface BlackjackShowdownProof {
+    kind: "showdown";
+    args: {
+        playerStateCommitment: Hex;
+        dealerStateCommitment: Hex;
+        payout: bigint;
+        dealerFinalValue: bigint;
+        handCount: number;
+        activeHandIndex: number;
+        handStatuses: readonly [number, number, number, number];
+        proof: Hex;
+    };
+}
+export interface BlackjackProofProvider {
+    provideInitialDeal(snapshot: Awaited<ReturnType<ReturnType<typeof createContractHelpers>["inspect"]["blackjackSession"]>>): Promise<BlackjackInitialDealProof>;
+    provideNext(snapshot: Awaited<ReturnType<ReturnType<typeof createContractHelpers>["inspect"]["blackjackSession"]>>): Promise<BlackjackActionProof | BlackjackShowdownProof>;
+}
+export interface CoordinatorStepResult {
+    status: "submitted" | "idle";
+    action: string;
+    txHash?: Hex;
+}
+export declare function createPokerCoordinator(args: {
+    contracts: ScuroContractHelpers;
+    mode: "pvp" | "tournament";
+    proofProvider: PokerProofProvider;
+    resolvePlayers?: (gameId: bigint) => Promise<readonly [Address, Address]>;
+}): {
+    snapshot: (gameId: bigint) => Promise<any>;
+    step: (gameId: bigint) => Promise<CoordinatorStepResult>;
+    runUntilIdle: (gameId: bigint, maxSteps?: number) => Promise<CoordinatorStepResult[]>;
+};
+export declare function createBlackjackCoordinator(args: {
+    contracts: ScuroContractHelpers;
+    proofProvider: BlackjackProofProvider;
+}): {
+    snapshot: (sessionId: bigint) => Promise<any>;
+    step: (sessionId: bigint) => Promise<CoordinatorStepResult>;
+    runUntilIdle: (sessionId: bigint, maxSteps?: number) => Promise<CoordinatorStepResult[]>;
+};
+export declare function createCoordinatorHelpers(options: CreateScuroClientOptions): ScuroCoordinatorHelpers;