@cypher-zk/sdk 0.4.0 → 0.5.0

package/dist/{client-hOLBWshA.d.ts → client-B0EueahJ.d.ts}

@@ -62,6 +62,25 @@ interface RefundClaimedEvent {
     user: PublicKey;
     refundAmount: bigint;
 }
+/** v0.2+: a bettor flagged the just-revealed resolution during the challenge window. */
+interface ResolutionFlaggedEvent {
+    market: PublicKey;
+    flaggedBy: PublicKey;
+}
+/** v0.2+: the challenge window elapsed undisputed and the market moved to RESOLVED. */
+interface MarketFinalizedEvent {
+    market: PublicKey;
+    outcome: number;
+    payoutRatio: bigint;
+}
+/** v0.2+: admin override on a disputed resolution. */
+interface ResolutionOverriddenEvent {
+    market: PublicKey;
+    oldOutcome: number;
+    newOutcome: number;
+    newPayoutRatio: bigint;
+    admin: PublicKey;
+}
 /** Discriminated union of every Cypher program event. */
 type CypherEvent = {
     name: "MarketCreatedEvent";
@@ -84,6 +103,15 @@ type CypherEvent = {
 } | {
     name: "RefundClaimedEvent";
     data: RefundClaimedEvent;
+} | {
+    name: "ResolutionFlaggedEvent";
+    data: ResolutionFlaggedEvent;
+} | {
+    name: "MarketFinalizedEvent";
+    data: MarketFinalizedEvent;
+} | {
+    name: "ResolutionOverriddenEvent";
+    data: ResolutionOverriddenEvent;
 };
 /** The set of all event names the Cypher program emits. */
 type CypherEventName = CypherEvent["name"];
@@ -167,6 +195,16 @@ declare const DEFAULT_CLAIM_PERIOD_SECS: number;
  * on unresolved markets. After this elapses, the admin may sweep.
  */
 declare const DEFAULT_REFUND_PERIOD_SECS: number;
+/**
+ * Minimum challenge / dispute window per market (seconds). Set at create-time;
+ * the contract rejects any `challenge_period` below this floor.
+ */
+declare const MIN_CHALLENGE_PERIOD_SECS: number;
+/**
+ * Maximum challenge / dispute window per market (seconds). Set at create-time;
+ * the contract rejects any `challenge_period` above this ceiling.
+ */
+declare const MAX_CHALLENGE_PERIOD_SECS: number;
 /** Maximum protocol fee rate (basis points). 1% absolute ceiling. */
 declare const MAX_PROTOCOL_FEE_BPS = 100;
 /** Maximum LP fee rate (basis points). 5% absolute ceiling. */
@@ -175,12 +213,21 @@ declare const MAX_LP_FEE_BPS = 500;
 declare const BPS_DENOMINATOR = 10000n;
 /** Fixed-point scale on `Market.payout_ratio` and `entry_odds`. */
 declare const ODDS_SCALE = 1000000000n;
-/** Lifecycle states for a market. */
+/**
+ * Lifecycle states for a market.
+ *
+ * `PendingResolution` (v0.2+): the reveal callback ran and outcome/pools are
+ * now plaintext on the Market account, but the market is still in the
+ * challenge window. `claim_deadline` / `refund_deadline` are NOT set yet
+ * — `finalize_resolution` (anyone, after window) or
+ * `admin_override_resolution` (admin, when disputed) flips to `Resolved`.
+ */
 declare const MarketState: {
     readonly Active: 0;
     readonly Closed: 1;
     readonly Resolved: 2;
     readonly Unresolved: 3;
+    readonly PendingResolution: 4;
 };
 type MarketStateValue = (typeof MarketState)[keyof typeof MarketState];
 /** Market type: simple YES/NO vs 2–4 outcome. */
@@ -226,6 +273,9 @@ type Cypher = {
     "instructions": [
         {
             "name": "adminClaimRemaining";
+            "docs": [
+                "Admin claims remaining unclaimed funds once the claim and refund deadlines have passed."
+            ];
             "discriminator": [
                 226,
                 176,
@@ -325,13 +375,91 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 }
             ];
             "args": [];
         },
+        {
+            "name": "adminOverrideResolution";
+            "docs": [
+                "Admin override of a disputed resolution with a corrected outcome and recomputed payout ratio."
+            ];
+            "discriminator": [
+                47,
+                117,
+                40,
+                129,
+                108,
+                28,
+                219,
+                96
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "signer": true;
+                },
+                {
+                    "name": "globalState";
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    103,
+                                    108,
+                                    111,
+                                    98,
+                                    97,
+                                    108,
+                                    95,
+                                    115,
+                                    116,
+                                    97,
+                                    116,
+                                    101
+                                ];
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "market";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    109,
+                                    97,
+                                    114,
+                                    107,
+                                    101,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "market.market_id";
+                                "account": "market";
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [
+                {
+                    "name": "outcomeValue";
+                    "type": "u8";
+                }
+            ];
+        },
         {
             "name": "cancelMarket";
+            "docs": [
+                "Cancel a market and return bond to creator (only if no bets placed)."
+            ];
             "discriminator": [
                 205,
                 121,
@@ -439,13 +567,15 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 }
             ];
             "args": [];
         },
         {
             "name": "claimPayoutMulti";
+            "docs": [
+                "Queue MPC computation to verify and pay out a winning MultiOutcome position."
+            ];
             "discriminator": [
                 183,
                 30,
@@ -625,7 +755,6 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 }
             ];
             "args": [
@@ -637,6 +766,9 @@ type Cypher = {
         },
         {
             "name": "claimPayoutYesno";
+            "docs": [
+                "Queue MPC computation to verify and pay out a winning YesNo position."
+            ];
             "discriminator": [
                 224,
                 84,
@@ -816,7 +948,6 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 }
             ];
             "args": [
@@ -828,6 +959,9 @@ type Cypher = {
         },
         {
             "name": "claimRefundMulti";
+            "docs": [
+                "Queue MPC computation to refund a bet on an unresolved MultiOutcome market."
+            ];
             "discriminator": [
                 186,
                 255,
@@ -1007,7 +1141,6 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 }
             ];
             "args": [
@@ -1019,6 +1152,9 @@ type Cypher = {
         },
         {
             "name": "claimRefundYesno";
+            "docs": [
+                "Queue MPC computation to refund a bet on an unresolved YesNo market."
+            ];
             "discriminator": [
                 250,
                 69,
@@ -1198,7 +1334,6 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 }
             ];
             "args": [
@@ -1210,6 +1345,9 @@ type Cypher = {
         },
         {
             "name": "computeMultiPayoutCallback";
+            "docs": [
+                "Callback that transfers the computed payout to the winning bettor."
+            ];
             "discriminator": [
                 242,
                 12,
@@ -1262,7 +1400,6 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 },
                 {
                     "name": "systemProgram";
@@ -1292,6 +1429,9 @@ type Cypher = {
         },
         {
             "name": "computeMultiRefundCallback";
+            "docs": [
+                "Callback that transfers the computed refund to the bettor."
+            ];
             "discriminator": [
                 164,
                 49,
@@ -1344,7 +1484,6 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 },
                 {
                     "name": "systemProgram";
@@ -1374,6 +1513,9 @@ type Cypher = {
         },
         {
             "name": "computeYesnoPayoutCallback";
+            "docs": [
+                "Callback that transfers the computed payout to the winning bettor."
+            ];
             "discriminator": [
                 154,
                 174,
@@ -1426,7 +1568,6 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 },
                 {
                     "name": "systemProgram";
@@ -1456,6 +1597,9 @@ type Cypher = {
         },
         {
             "name": "computeYesnoRefundCallback";
+            "docs": [
+                "Callback that transfers the computed refund to the bettor."
+            ];
             "discriminator": [
                 87,
                 6,
@@ -1508,7 +1652,6 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 },
                 {
                     "name": "systemProgram";
@@ -1538,6 +1681,9 @@ type Cypher = {
         },
         {
             "name": "createMarket";
+            "docs": [
+                "Create a new YesNo prediction market (creator pays the bond, sets close time and challenge period)."
+            ];
             "discriminator": [
                 103,
                 226,
@@ -1673,7 +1819,6 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 },
                 {
                     "name": "systemProgram";
@@ -1692,11 +1837,18 @@ type Cypher = {
                 {
                     "name": "category";
                     "type": "u8";
+                },
+                {
+                    "name": "challengePeriod";
+                    "type": "i64";
                 }
             ];
         },
         {
             "name": "createMarketMulti";
+            "docs": [
+                "Create a new MultiOutcome prediction market with 2-4 outcomes."
+            ];
             "discriminator": [
                 35,
                 185,
@@ -1832,7 +1984,6 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 },
                 {
                     "name": "systemProgram";
@@ -1855,11 +2006,112 @@ type Cypher = {
                 {
                     "name": "numOutcomes";
                     "type": "u8";
+                },
+                {
+                    "name": "challengePeriod";
+                    "type": "i64";
                 }
             ];
         },
+        {
+            "name": "finalizeResolution";
+            "docs": [
+                "Finalize a pending resolution once the challenge window has passed undisputed."
+            ];
+            "discriminator": [
+                191,
+                74,
+                94,
+                214,
+                45,
+                150,
+                152,
+                125
+            ];
+            "accounts": [
+                {
+                    "name": "caller";
+                    "signer": true;
+                },
+                {
+                    "name": "market";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    109,
+                                    97,
+                                    114,
+                                    107,
+                                    101,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "market.market_id";
+                                "account": "market";
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "flagResolution";
+            "docs": [
+                "Flag a pending resolution as disputed during the challenge window."
+            ];
+            "discriminator": [
+                144,
+                21,
+                165,
+                219,
+                56,
+                125,
+                121,
+                138
+            ];
+            "accounts": [
+                {
+                    "name": "flagger";
+                    "signer": true;
+                },
+                {
+                    "name": "market";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    109,
+                                    97,
+                                    114,
+                                    107,
+                                    101,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "market.market_id";
+                                "account": "market";
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [];
+        },
         {
             "name": "initPayoutMultiCompDef";
+            "docs": [
+                "Register the compute_multi_payout Arcium computation definition."
+            ];
             "discriminator": [
                 155,
                 138,
@@ -1905,6 +2157,9 @@ type Cypher = {
         },
         {
             "name": "initPayoutYesnoCompDef";
+            "docs": [
+                "Register the compute_yesno_payout Arcium computation definition."
+            ];
             "discriminator": [
                 104,
                 87,
@@ -1950,6 +2205,9 @@ type Cypher = {
         },
         {
             "name": "initPlaceBetMultiCompDef";
+            "docs": [
+                "Register the place_private_bet_multi Arcium computation definition."
+            ];
             "discriminator": [
                 2,
                 251,
@@ -1995,6 +2253,9 @@ type Cypher = {
         },
         {
             "name": "initPlaceBetYesnoCompDef";
+            "docs": [
+                "Register the place_private_bet_yesno Arcium computation definition."
+            ];
             "discriminator": [
                 160,
                 105,
@@ -2040,6 +2301,9 @@ type Cypher = {
         },
         {
             "name": "initRefundMultiCompDef";
+            "docs": [
+                "Register the compute_multi_refund Arcium computation definition."
+            ];
             "discriminator": [
                 166,
                 248,
@@ -2085,6 +2349,9 @@ type Cypher = {
         },
         {
             "name": "initRefundYesnoCompDef";
+            "docs": [
+                "Register the compute_yesno_refund Arcium computation definition."
+            ];
             "discriminator": [
                 114,
                 168,
@@ -2130,6 +2397,9 @@ type Cypher = {
         },
         {
             "name": "initRevealMultiCompDef";
+            "docs": [
+                "Register the reveal_market_outcome_multi Arcium computation definition."
+            ];
             "discriminator": [
                 174,
                 143,
@@ -2175,6 +2445,9 @@ type Cypher = {
         },
         {
             "name": "initRevealYesnoCompDef";
+            "docs": [
+                "Register the reveal_market_outcome_yesno Arcium computation definition."
+            ];
             "discriminator": [
                 185,
                 221,
@@ -2220,6 +2493,9 @@ type Cypher = {
         },
         {
             "name": "initialize";
+            "docs": [
+                "Initialize the global protocol state: fee rates, treasury, accepted mint, and admin."
+            ];
             "discriminator": [
                 175,
                 175,
@@ -2286,6 +2562,9 @@ type Cypher = {
         },
         {
             "name": "placePrivateBetMulti";
+            "docs": [
+                "Queue an encrypted multi-outcome bet for MPC processing."
+            ];
             "discriminator": [
                 43,
                 95,
@@ -2494,7 +2773,6 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 }
             ];
             "args": [
@@ -2541,6 +2819,9 @@ type Cypher = {
         },
         {
             "name": "placePrivateBetMultiCallback";
+            "docs": [
+                "Callback that applies the MPC-computed pool totals and entry odds for a MultiOutcome bet."
+            ];
             "discriminator": [
                 81,
                 0,
@@ -2604,6 +2885,9 @@ type Cypher = {
         },
         {
             "name": "placePrivateBetYesno";
+            "docs": [
+                "Queue an encrypted YES/NO bet for MPC processing."
+            ];
             "discriminator": [
                 14,
                 226,
@@ -2812,7 +3096,6 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 }
             ];
             "args": [
@@ -2859,6 +3142,9 @@ type Cypher = {
         },
         {
             "name": "placePrivateBetYesnoCallback";
+            "docs": [
+                "Callback that applies the MPC-computed pool totals and entry odds for a YesNo bet."
+            ];
             "discriminator": [
                 1,
                 193,
@@ -2922,6 +3208,9 @@ type Cypher = {
         },
         {
             "name": "resolveMarketMulti";
+            "docs": [
+                "Queue MPC computation to reveal the multi-outcome winner and pools."
+            ];
             "discriminator": [
                 237,
                 84,
@@ -3052,6 +3341,9 @@ type Cypher = {
         },
         {
             "name": "resolveMarketYesno";
+            "docs": [
+                "Queue MPC computation to reveal the YES/NO outcome and pools."
+            ];
             "discriminator": [
                 191,
                 1,
@@ -3182,6 +3474,9 @@ type Cypher = {
         },
         {
             "name": "revealMarketOutcomeMultiCallback";
+            "docs": [
+                "Callback that writes the revealed outcome, pools, and payout ratio; market enters the challenge window."
+            ];
             "discriminator": [
                 114,
                 103,
@@ -3241,6 +3536,9 @@ type Cypher = {
         },
         {
             "name": "revealMarketOutcomeYesnoCallback";
+            "docs": [
+                "Callback that writes the revealed outcome, pools, and payout ratio; market enters the challenge window."
+            ];
             "discriminator": [
                 92,
                 112,
@@ -3300,6 +3598,9 @@ type Cypher = {
         },
         {
             "name": "updateAcceptedMint";
+            "docs": [
+                "Update the protocol's accepted mint and treasury (admin only)."
+            ];
             "discriminator": [
                 6,
                 166,
@@ -3356,6 +3657,9 @@ type Cypher = {
         },
         {
             "name": "withdrawCreatorFunds";
+            "docs": [
+                "Withdraw creator bond and accumulated LP fees after the market is resolved."
+            ];
             "discriminator": [
                 135,
                 166,
@@ -3463,7 +3767,6 @@ type Cypher = {
                 },
                 {
                     "name": "tokenProgram";
-                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
                 }
             ];
             "args": [];
@@ -3589,6 +3892,19 @@ type Cypher = {
                 124
             ];
         },
+        {
+            "name": "marketFinalizedEvent";
+            "discriminator": [
+                141,
+                216,
+                158,
+                192,
+                60,
+                222,
+                155,
+                232
+            ];
+        },
         {
             "name": "marketResolvedEvent";
             "discriminator": [
@@ -3627,6 +3943,32 @@ type Cypher = {
                 154,
                 233
             ];
+        },
+        {
+            "name": "resolutionFlaggedEvent";
+            "discriminator": [
+                159,
+                214,
+                98,
+                62,
+                158,
+                28,
+                21,
+                84
+            ];
+        },
+        {
+            "name": "resolutionOverriddenEvent";
+            "discriminator": [
+                133,
+                175,
+                170,
+                160,
+                47,
+                76,
+                128,
+                87
+            ];
         }
     ];
     "errors": [
@@ -3809,6 +4151,36 @@ type Cypher = {
             "code": 6035;
             "name": "invalidCategory";
             "msg": "Invalid category — must be 0-6";
+        },
+        {
+            "code": 6036;
+            "name": "invalidChallengePeriod";
+            "msg": "Challenge period must be between 24 and 48 hours";
+        },
+        {
+            "code": 6037;
+            "name": "notPendingResolution";
+            "msg": "Market is not pending resolution";
+        },
+        {
+            "code": 6038;
+            "name": "challengePeriodNotElapsed";
+            "msg": "Challenge period has not elapsed yet";
+        },
+        {
+            "code": 6039;
+            "name": "challengePeriodElapsed";
+            "msg": "Challenge period has already elapsed";
+        },
+        {
+            "code": 6040;
+            "name": "marketDisputed";
+            "msg": "Market resolution is disputed — admin must override";
+        },
+        {
+            "code": 6041;
+            "name": "marketNotDisputed";
+            "msg": "Market resolution is not disputed";
         }
     ];
     "types": [
@@ -4811,6 +5183,27 @@ type Cypher = {
                         "name": "refundDeadline";
                         "type": "i64";
                     },
+                    {
+                        "name": "challengePeriod";
+                        "docs": [
+                            "Configurable dispute window (24-48h), set at creation"
+                        ];
+                        "type": "i64";
+                    },
+                    {
+                        "name": "challengeDeadline";
+                        "docs": [
+                            "resolution_time + challenge_period — set by the reveal callback"
+                        ];
+                        "type": "i64";
+                    },
+                    {
+                        "name": "disputed";
+                        "docs": [
+                            "Set true by flag_resolution; blocks finalize_resolution until admin overrides"
+                        ];
+                        "type": "bool";
+                    },
                     {
                         "name": "bump";
                         "type": "u8";
@@ -4874,6 +5267,26 @@ type Cypher = {
                 ];
             };
         },
+        {
+            "name": "marketFinalizedEvent";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "market";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "outcome";
+                        "type": "u8";
+                    },
+                    {
+                        "name": "payoutRatio";
+                        "type": "u64";
+                    }
+                ];
+            };
+        },
         {
             "name": "marketResolvedEvent";
             "type": {
@@ -5272,6 +5685,50 @@ type Cypher = {
                 ];
             };
         },
+        {
+            "name": "resolutionFlaggedEvent";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "market";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "flaggedBy";
+                        "type": "pubkey";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "resolutionOverriddenEvent";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "market";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "oldOutcome";
+                        "type": "u8";
+                    },
+                    {
+                        "name": "newOutcome";
+                        "type": "u8";
+                    },
+                    {
+                        "name": "newPayoutRatio";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "admin";
+                        "type": "pubkey";
+                    }
+                ];
+            };
+        },
         {
             "name": "revealMarketOutcomeMultiOutput";
             "docs": [
@@ -5593,6 +6050,12 @@ interface MarketAccount {
     resolutionDeadline: bigint;
     claimDeadline: bigint;
     refundDeadline: bigint;
+    /** Configurable dispute window (24–48h), set at create time. (v0.2+) */
+    challengePeriod: bigint;
+    /** `resolution_time + challenge_period` — set by the reveal callback. (v0.2+) */
+    challengeDeadline: bigint;
+    /** Set true by `flag_resolution`; blocks `finalize_resolution`. (v0.2+) */
+    disputed: boolean;
     bump: number;
     vaultBump: number;
 }
@@ -5809,6 +6272,13 @@ interface CreateMarketParams {
      * before building this instruction.
      */
     expectedMarketId: bigint | number;
+    /**
+     * v0.2+: configurable dispute window length in seconds.
+     * Must be within [`MIN_CHALLENGE_PERIOD_SECS`, `MAX_CHALLENGE_PERIOD_SECS`]
+     * (24h–48h). After the reveal callback, the market sits in
+     * `PendingResolution` for this long, during which anyone can flag.
+     */
+    challengePeriod: bigint | number;
 }
 /**
  * Build a `create_market` instruction (YesNo).
@@ -5912,6 +6382,41 @@ declare function claimRefundYesnoIx(client: CypherClient, params: ClaimParams):
 /** `claim_refund_multi` — refund on a multi market that never resolved. */
 declare function claimRefundMultiIx(client: CypherClient, params: ClaimParams): Promise<TransactionInstruction>;
 
+interface FlagResolutionParams {
+    /** The user flagging the resolution (signer). Permissionless. */
+    flagger: PublicKey;
+    marketId: bigint | number;
+}
+/** `flag_resolution` — anyone can flag a pending resolution during the window. */
+declare function flagResolutionIx(client: CypherClient, params: FlagResolutionParams): Promise<TransactionInstruction>;
+interface FinalizeResolutionParams {
+    /** The user calling finalize (signer). Permissionless. */
+    caller: PublicKey;
+    marketId: bigint | number;
+}
+/**
+ * `finalize_resolution` — anyone can call once the challenge window has
+ * elapsed undisputed. Flips the market from `PendingResolution` → `Resolved`
+ * and sets the `claim_deadline` / `refund_deadline`.
+ */
+declare function finalizeResolutionIx(client: CypherClient, params: FinalizeResolutionParams): Promise<TransactionInstruction>;
+interface AdminOverrideResolutionParams {
+    /** Admin signer — must match `GlobalState.admin`. */
+    admin: PublicKey;
+    marketId: bigint | number;
+    /**
+     * Corrected outcome. YesNo: 0 or 1. Multi: in `[0, numOutcomes)`.
+     * Recomputes `payout_ratio` from the on-chain revealed pools.
+     */
+    outcomeValue: number;
+}
+/**
+ * `admin_override_resolution` — admin-only escape hatch for disputed markets.
+ * Recomputes payout_ratio from already-revealed plaintext pools and flips
+ * the market to `Resolved` (no Arcium computation involved).
+ */
+declare function adminOverrideResolutionIx(client: CypherClient, params: AdminOverrideResolutionParams): Promise<TransactionInstruction>;
+
 /** Outcome returned by `awaitComputation`. */
 interface ComputationResult {
     /** Always `"finalized"` on success (we throw otherwise). */
@@ -6019,13 +6524,16 @@ interface CreateMarketResult {
     market: MarketAccount | null;
 }
 /** Create a YES/NO market end-to-end. */
-declare function createMarketAction(client: CypherClient, inputs: Omit<CreateMarketParams, "expectedMarketId" | "acceptedMint"> & {
+declare function createMarketAction(client: CypherClient, inputs: Omit<CreateMarketParams, "expectedMarketId" | "acceptedMint" | "challengePeriod"> & {
     acceptedMint?: PublicKey;
+    /** v0.2+: defaults to MIN_CHALLENGE_PERIOD_SECS (24h) if omitted. */
+    challengePeriod?: bigint | number;
     onProgress?: ProgressCallback;
 }): Promise<CreateMarketResult>;
 /** Create a multi-outcome market (2–4 outcomes) end-to-end. */
-declare function createMarketMultiAction(client: CypherClient, inputs: Omit<CreateMarketMultiParams, "expectedMarketId" | "acceptedMint"> & {
+declare function createMarketMultiAction(client: CypherClient, inputs: Omit<CreateMarketMultiParams, "expectedMarketId" | "acceptedMint" | "challengePeriod"> & {
     acceptedMint?: PublicKey;
+    challengePeriod?: bigint | number;
     onProgress?: ProgressCallback;
 }): Promise<CreateMarketResult>;
 /** Cancel a market that has no bets. Returns the post-cancel `Market`. */
@@ -6199,6 +6707,43 @@ declare function claimPayoutAction(client: CypherClient, inputs: ClaimInputs): P
 /** Claim refund (any bettor on a market that never resolved). */
 declare function claimRefundAction(client: CypherClient, inputs: ClaimInputs): Promise<ClaimResult>;
 
+interface FlagResolutionInputs {
+    flagger: PublicKey;
+    marketId: bigint | number;
+    onProgress?: ProgressCallback;
+}
+interface FinalizeResolutionInputs {
+    caller: PublicKey;
+    marketId: bigint | number;
+    onProgress?: ProgressCallback;
+}
+interface AdminOverrideResolutionInputs {
+    admin: PublicKey;
+    marketId: bigint | number;
+    outcomeValue: number;
+    onProgress?: ProgressCallback;
+}
+interface ResolutionActionResult {
+    signature: string;
+    market: MarketAccount | null;
+}
+/**
+ * Flag a pending resolution as disputed during the challenge window.
+ * Permissionless — anyone can flag.
+ */
+declare function flagResolutionAction(client: CypherClient, inputs: FlagResolutionInputs): Promise<ResolutionActionResult>;
+/**
+ * Finalize a pending resolution after the challenge window has elapsed
+ * undisputed. Permissionless — anyone can call.
+ */
+declare function finalizeResolutionAction(client: CypherClient, inputs: FinalizeResolutionInputs): Promise<ResolutionActionResult>;
+/**
+ * Admin override of a disputed resolution. Recomputes `payout_ratio` from
+ * the already-revealed plaintext pools using the same formula as the
+ * reveal circuits.
+ */
+declare function adminOverrideResolutionAction(client: CypherClient, inputs: AdminOverrideResolutionInputs): Promise<ResolutionActionResult>;
+
 /** Callback signature for all per-event subscription helpers. */
 type EventCallback<T> = (data: T, raw: CypherEvent) => void;
 /** Options shared by all subscription helpers. */
@@ -6259,6 +6804,12 @@ declare function onCreatorWithdrawn(connection: Connection, callback: EventCallb
 declare function onPayoutClaimed(connection: Connection, callback: EventCallback<PayoutClaimedEvent>, opts?: SubscribeOptions): EventSubscription;
 /** Subscribe to `RefundClaimedEvent` emissions. */
 declare function onRefundClaimed(connection: Connection, callback: EventCallback<RefundClaimedEvent>, opts?: SubscribeOptions): EventSubscription;
+/** v0.2+: subscribe to `ResolutionFlaggedEvent`. */
+declare function onResolutionFlagged(connection: Connection, callback: EventCallback<ResolutionFlaggedEvent>, opts?: SubscribeOptions): EventSubscription;
+/** v0.2+: subscribe to `MarketFinalizedEvent`. */
+declare function onMarketFinalized(connection: Connection, callback: EventCallback<MarketFinalizedEvent>, opts?: SubscribeOptions): EventSubscription;
+/** v0.2+: subscribe to `ResolutionOverriddenEvent`. */
+declare function onResolutionOverridden(connection: Connection, callback: EventCallback<ResolutionOverriddenEvent>, opts?: SubscribeOptions): EventSubscription;
 interface PollEventsOptions {
     /** Only return events from signatures after this one (exclusive). */
     afterSignature?: string;
@@ -6379,12 +6930,15 @@ declare class CypherClient {
      */
     readonly actions: {
         /** Create a YES/NO market. Fetches GlobalState for marketId + mint automatically. */
-        createMarket: (inputs: Omit<CreateMarketParams, "expectedMarketId" | "acceptedMint"> & {
+        createMarket: (inputs: Omit<CreateMarketParams, "expectedMarketId" | "acceptedMint" | "challengePeriod"> & {
             acceptedMint?: PublicKey;
+            /** v0.2+: defaults to MIN_CHALLENGE_PERIOD_SECS (24h) if omitted. */
+            challengePeriod?: bigint | number;
         }) => Promise<CreateMarketResult>;
         /** Create a multi-outcome market (2–4 outcomes). */
-        createMarketMulti: (inputs: Omit<CreateMarketMultiParams, "expectedMarketId" | "acceptedMint"> & {
+        createMarketMulti: (inputs: Omit<CreateMarketMultiParams, "expectedMarketId" | "acceptedMint" | "challengePeriod"> & {
             acceptedMint?: PublicKey;
+            challengePeriod?: bigint | number;
         }) => Promise<CreateMarketResult>;
         /** Cancel a market with zero bets. Returns bond to creator. */
         cancelMarket: (inputs: Omit<CancelMarketParams, "acceptedMint"> & {
@@ -6407,6 +6961,12 @@ declare class CypherClient {
         claimPayout: (inputs: ClaimInputs) => Promise<ClaimResult>;
         /** Claim refund on an unresolved market past its deadline. */
         claimRefund: (inputs: ClaimInputs) => Promise<ClaimResult>;
+        /** v0.2+: flag a pending resolution as disputed (permissionless). */
+        flagResolution: (inputs: FlagResolutionInputs) => Promise<ResolutionActionResult>;
+        /** v0.2+: finalize a pending resolution after the challenge window elapses undisputed (permissionless). */
+        finalizeResolution: (inputs: FinalizeResolutionInputs) => Promise<ResolutionActionResult>;
+        /** v0.2+: admin override on a disputed market. */
+        adminOverrideResolution: (inputs: AdminOverrideResolutionInputs) => Promise<ResolutionActionResult>;
     };
     /**
      * Event subscription helpers. Subscribe via WebSocket (`onLogs`) or
@@ -6477,7 +7037,13 @@ declare class CypherClient {
         refundYesnoIx: (params: ClaimParams) => Promise<TransactionInstruction>;
         refundMultiIx: (params: ClaimParams) => Promise<TransactionInstruction>;
     };
+    /** v0.2+: dispute / challenge-window instruction builders. */
+    readonly resolutionIx: {
+        flagIx: (params: FlagResolutionParams) => Promise<TransactionInstruction>;
+        finalizeIx: (params: FinalizeResolutionParams) => Promise<TransactionInstruction>;
+        adminOverrideIx: (params: AdminOverrideResolutionParams) => Promise<TransactionInstruction>;
+    };
     constructor(opts: CypherClientOptions);
 }
 
-export { MIN_OUTCOMES_MULTI as $, ACCOUNT_DISCRIMINATOR_SIZE as A, BPS_DENOMINATOR as B, CypherClient as C, type CypherClientOptions as D, type EncryptedPositionAccount as E, type CypherEventName as F, type GlobalStateAccount as G, DEFAULT_CLAIM_PERIOD_SECS as H, DEFAULT_REFUND_PERIOD_SECS as I, DEFAULT_RESOLUTION_WINDOW_SECS as J, type EventCallback as K, type EventSubscription as L, type MarketAccount as M, INIT_COMP_DEF_INSTRUCTIONS as N, type InitCompDefMethodName as O, type PlaceBetResult as P, type InitCompDefParams as Q, type ResolveMarketResult as R, type SubscribeOptions as S, type InitializeParams as T, KNOWN_MINTS as U, type LpPositionAccount as V, MAX_LP_FEE_BPS as W, MAX_OUTCOMES_MULTI as X, MAX_PROTOCOL_FEE_BPS as Y, MAX_QUESTION_BYTES as Z, MIN_BET_USDC as _, type CancelMarketParams as a, onMarketResolved as a$, type MarketCancelledEvent as a0, MarketCategory as a1, type MarketCategoryValue as a2, type MarketCreatedEvent as a3, type MarketResolvedEvent as a4, MarketState as a5, type MarketStateValue as a6, MarketType as a7, type MarketTypeValue as a8, ODDS_SCALE as a9, createCipher as aA, createMarketAction as aB, createMarketIx as aC, createMarketMultiAction as aD, createMarketMultiIx as aE, createUserKeypair as aF, deriveSharedSecret as aG, fetchAllMarkets as aH, fetchGlobalState as aI, fetchLpPosition as aJ, fetchLpPositionsByProvider as aK, fetchMarket as aL, fetchMarketsByCreator as aM, fetchMarketsByState as aN, fetchMxePublicKey as aO, fetchPosition as aP, fetchPositionsForMarket as aQ, fetchUserPositions as aR, freshNonce as aS, initCompDefIx as aT, initializeIx as aU, keypairToWallet as aV, leBytesToBigInt as aW, onBetPlaced as aX, onCreatorWithdrawn as aY, onMarketCancelled as aZ, onMarketCreated as a_, PROGRAM_ID as aa, type PayoutClaimedEvent as ab, type PlacePrivateBetParams as ac, type PollEventsOptions as ad, type PolledEvent as ae, type ProgressCallback as af, type RefundClaimedEvent as ag, type ResolveMarketParams as ah, type SendIxOptions as ai, type UpdateAcceptedMintParams as aj, type UserCryptoKeypair as ak, type Wallet as al, type WithdrawCreatorFundsParams as am, adminClaimRemainingIx as an, awaitComputation as ao, buildAllInitCompDefIx as ap, cancelMarketAction as aq, cancelMarketIx as ar, claimPayoutAction as as, claimPayoutMultiIx as at, claimPayoutYesnoIx as au, claimRefundAction as av, claimRefundMultiIx as aw, claimRefundYesnoIx as ax, compDefOffsetBytes as ay, compDefOffsetU32 as az, type ClaimResult as b, onPayoutClaimed as b0, onRefundClaimed as b1, parseLogs as b2, parseLogsFor as b3, placeBetAction as b4, placePrivateBetMultiIx as b5, placePrivateBetYesnoIx as b6, pollEvents as b7, randomComputationOffset as b8, readonlyWallet as b9, resolveMarketAction as ba, resolveMarketMultiIx as bb, resolveMarketYesnoIx as bc, sendIx as bd, sendIxAndAwaitArcium as be, subscribeAll as bf, subscribeEvent as bg, updateAcceptedMintIx as bh, withdrawCreatorFundsAction as bi, withdrawCreatorFundsIx as bj, type ClaimInputs as c, type CreateMarketResult as d, type CreateMarketParams as e, type PlaceBetInputs as f, type ResolveMarketInputs as g, type CypherEvent as h, type Cypher as i, type CircuitName as j, ALL_CIRCUITS as k, ALL_EVENT_NAMES as l, type ActionProgressEvent as m, type ActionStage as n, type AdminClaimRemainingParams as o, type AwaitComputationOptions as p, type BetPlacedEvent as q, CIRCUITS as r, CLUSTERS as s, CREATOR_BOND as t, type ClaimParams as u, type ClusterConfig as v, type ClusterName as w, type ComputationResult as x, type CreateMarketMultiParams as y, type CreatorWithdrawnEvent as z };
+export { KNOWN_MINTS as $, type AdminOverrideResolutionInputs as A, BPS_DENOMINATOR as B, CypherClient as C, type ClusterName as D, type EncryptedPositionAccount as E, type FinalizeResolutionInputs as F, type GlobalStateAccount as G, type ComputationResult as H, type CreateMarketMultiParams as I, type CreatorWithdrawnEvent as J, type CypherClientOptions as K, type CypherEventName as L, type MarketAccount as M, DEFAULT_CLAIM_PERIOD_SECS as N, DEFAULT_REFUND_PERIOD_SECS as O, type PlaceBetResult as P, DEFAULT_RESOLUTION_WINDOW_SECS as Q, type ResolutionActionResult as R, type SubscribeOptions as S, type EventCallback as T, type EventSubscription as U, type FinalizeResolutionParams as V, type FlagResolutionParams as W, INIT_COMP_DEF_INSTRUCTIONS as X, type InitCompDefMethodName as Y, type InitCompDefParams as Z, type InitializeParams as _, type CancelMarketParams as a, fetchMarketsByState as a$, type LpPositionAccount as a0, MAX_CHALLENGE_PERIOD_SECS as a1, MAX_LP_FEE_BPS as a2, MAX_OUTCOMES_MULTI as a3, MAX_PROTOCOL_FEE_BPS as a4, MAX_QUESTION_BYTES as a5, MIN_BET_USDC as a6, MIN_CHALLENGE_PERIOD_SECS as a7, MIN_OUTCOMES_MULTI as a8, type MarketCancelledEvent as a9, adminOverrideResolutionAction as aA, adminOverrideResolutionIx as aB, awaitComputation as aC, buildAllInitCompDefIx as aD, cancelMarketAction as aE, cancelMarketIx as aF, claimPayoutAction as aG, claimPayoutMultiIx as aH, claimPayoutYesnoIx as aI, claimRefundAction as aJ, claimRefundMultiIx as aK, claimRefundYesnoIx as aL, compDefOffsetBytes as aM, compDefOffsetU32 as aN, createCipher as aO, createMarketAction as aP, createMarketIx as aQ, createMarketMultiAction as aR, createMarketMultiIx as aS, createUserKeypair as aT, deriveSharedSecret as aU, fetchAllMarkets as aV, fetchGlobalState as aW, fetchLpPosition as aX, fetchLpPositionsByProvider as aY, fetchMarket as aZ, fetchMarketsByCreator as a_, MarketCategory as aa, type MarketCategoryValue as ab, type MarketCreatedEvent as ac, type MarketFinalizedEvent as ad, type MarketResolvedEvent as ae, MarketState as af, type MarketStateValue as ag, MarketType as ah, type MarketTypeValue as ai, ODDS_SCALE as aj, PROGRAM_ID as ak, type PayoutClaimedEvent as al, type PlacePrivateBetParams as am, type PollEventsOptions as an, type PolledEvent as ao, type ProgressCallback as ap, type RefundClaimedEvent as aq, type ResolutionFlaggedEvent as ar, type ResolutionOverriddenEvent as as, type ResolveMarketParams as at, type SendIxOptions as au, type UpdateAcceptedMintParams as av, type UserCryptoKeypair as aw, type Wallet as ax, type WithdrawCreatorFundsParams as ay, adminClaimRemainingIx as az, type ClaimResult as b, fetchMxePublicKey as b0, fetchPosition as b1, fetchPositionsForMarket as b2, fetchUserPositions as b3, finalizeResolutionAction as b4, finalizeResolutionIx as b5, flagResolutionAction as b6, flagResolutionIx as b7, freshNonce as b8, initCompDefIx as b9, subscribeAll as bA, subscribeEvent as bB, updateAcceptedMintIx as bC, withdrawCreatorFundsAction as bD, withdrawCreatorFundsIx as bE, initializeIx as ba, keypairToWallet as bb, leBytesToBigInt as bc, onBetPlaced as bd, onCreatorWithdrawn as be, onMarketCancelled as bf, onMarketCreated as bg, onMarketFinalized as bh, onMarketResolved as bi, onPayoutClaimed as bj, onRefundClaimed as bk, onResolutionFlagged as bl, onResolutionOverridden as bm, parseLogs as bn, parseLogsFor as bo, placeBetAction as bp, placePrivateBetMultiIx as bq, placePrivateBetYesnoIx as br, pollEvents as bs, randomComputationOffset as bt, readonlyWallet as bu, resolveMarketAction as bv, resolveMarketMultiIx as bw, resolveMarketYesnoIx as bx, sendIx as by, sendIxAndAwaitArcium as bz, type ClaimInputs as c, type CreateMarketResult as d, type CreateMarketParams as e, type FlagResolutionInputs as f, type PlaceBetInputs as g, type ResolveMarketResult as h, type ResolveMarketInputs as i, type CypherEvent as j, type Cypher as k, type CircuitName as l, ACCOUNT_DISCRIMINATOR_SIZE as m, ALL_CIRCUITS as n, ALL_EVENT_NAMES as o, type ActionProgressEvent as p, type ActionStage as q, type AdminClaimRemainingParams as r, type AdminOverrideResolutionParams as s, type AwaitComputationOptions as t, type BetPlacedEvent as u, CIRCUITS as v, CLUSTERS as w, CREATOR_BOND as x, type ClaimParams as y, type ClusterConfig as z };