@cypher-zk/sdk 0.4.0 → 0.5.0

package/src/idl/cypher.json

@@ -9,6 +9,9 @@
   "instructions": [
     {
       "name": "admin_claim_remaining",
+      "docs": [
+        "Admin claims remaining unclaimed funds once the claim and refund deadlines have passed."
+      ],
       "discriminator": [
         226,
         176,
@@ -107,14 +110,92 @@
           "writable": true
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         }
       ],
       "args": []
     },
+    {
+      "name": "admin_override_resolution",
+      "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": "global_state",
+          "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": "outcome_value",
+          "type": "u8"
+        }
+      ]
+    },
     {
       "name": "cancel_market",
+      "docs": [
+        "Cancel a market and return bond to creator (only if no bets placed)."
+      ],
       "discriminator": [
         205,
         121,
@@ -221,14 +302,16 @@
           "writable": true
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         }
       ],
       "args": []
     },
     {
       "name": "claim_payout_multi",
+      "docs": [
+        "Queue MPC computation to verify and pay out a winning MultiOutcome position."
+      ],
       "discriminator": [
         183,
         30,
@@ -407,8 +490,7 @@
           "writable": true
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         }
       ],
       "args": [
@@ -420,6 +502,9 @@
     },
     {
       "name": "claim_payout_yesno",
+      "docs": [
+        "Queue MPC computation to verify and pay out a winning YesNo position."
+      ],
       "discriminator": [
         224,
         84,
@@ -598,8 +683,7 @@
           "writable": true
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         }
       ],
       "args": [
@@ -611,6 +695,9 @@
     },
     {
       "name": "claim_refund_multi",
+      "docs": [
+        "Queue MPC computation to refund a bet on an unresolved MultiOutcome market."
+      ],
       "discriminator": [
         186,
         255,
@@ -789,8 +876,7 @@
           "writable": true
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         }
       ],
       "args": [
@@ -802,6 +888,9 @@
     },
     {
       "name": "claim_refund_yesno",
+      "docs": [
+        "Queue MPC computation to refund a bet on an unresolved YesNo market."
+      ],
       "discriminator": [
         250,
         69,
@@ -980,8 +1069,7 @@
           "writable": true
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         }
       ],
       "args": [
@@ -993,6 +1081,9 @@
     },
     {
       "name": "compute_multi_payout_callback",
+      "docs": [
+        "Callback that transfers the computed payout to the winning bettor."
+      ],
       "discriminator": [
         242,
         12,
@@ -1044,8 +1135,7 @@
           "writable": true
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         },
         {
           "name": "system_program",
@@ -1075,6 +1165,9 @@
     },
     {
       "name": "compute_multi_refund_callback",
+      "docs": [
+        "Callback that transfers the computed refund to the bettor."
+      ],
       "discriminator": [
         164,
         49,
@@ -1126,8 +1219,7 @@
           "writable": true
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         },
         {
           "name": "system_program",
@@ -1157,6 +1249,9 @@
     },
     {
       "name": "compute_yesno_payout_callback",
+      "docs": [
+        "Callback that transfers the computed payout to the winning bettor."
+      ],
       "discriminator": [
         154,
         174,
@@ -1208,8 +1303,7 @@
           "writable": true
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         },
         {
           "name": "system_program",
@@ -1239,6 +1333,9 @@
     },
     {
       "name": "compute_yesno_refund_callback",
+      "docs": [
+        "Callback that transfers the computed refund to the bettor."
+      ],
       "discriminator": [
         87,
         6,
@@ -1290,8 +1387,7 @@
           "writable": true
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         },
         {
           "name": "system_program",
@@ -1321,6 +1417,9 @@
     },
     {
       "name": "create_market",
+      "docs": [
+        "Create a new YesNo prediction market (creator pays the bond, sets close time and challenge period)."
+      ],
       "discriminator": [
         103,
         226,
@@ -1455,8 +1554,7 @@
           "name": "accepted_mint"
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         },
         {
           "name": "system_program",
@@ -1475,11 +1573,18 @@
         {
           "name": "category",
           "type": "u8"
+        },
+        {
+          "name": "challenge_period",
+          "type": "i64"
         }
       ]
     },
     {
       "name": "create_market_multi",
+      "docs": [
+        "Create a new MultiOutcome prediction market with 2-4 outcomes."
+      ],
       "discriminator": [
         35,
         185,
@@ -1614,8 +1719,7 @@
           "name": "accepted_mint"
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         },
         {
           "name": "system_program",
@@ -1638,11 +1742,112 @@
         {
           "name": "num_outcomes",
           "type": "u8"
+        },
+        {
+          "name": "challenge_period",
+          "type": "i64"
         }
       ]
     },
+    {
+      "name": "finalize_resolution",
+      "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": "flag_resolution",
+      "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": "init_payout_multi_comp_def",
+      "docs": [
+        "Register the compute_multi_payout Arcium computation definition."
+      ],
       "discriminator": [
         155,
         138,
@@ -1688,6 +1893,9 @@
     },
     {
       "name": "init_payout_yesno_comp_def",
+      "docs": [
+        "Register the compute_yesno_payout Arcium computation definition."
+      ],
       "discriminator": [
         104,
         87,
@@ -1733,6 +1941,9 @@
     },
     {
       "name": "init_place_bet_multi_comp_def",
+      "docs": [
+        "Register the place_private_bet_multi Arcium computation definition."
+      ],
       "discriminator": [
         2,
         251,
@@ -1778,6 +1989,9 @@
     },
     {
       "name": "init_place_bet_yesno_comp_def",
+      "docs": [
+        "Register the place_private_bet_yesno Arcium computation definition."
+      ],
       "discriminator": [
         160,
         105,
@@ -1823,6 +2037,9 @@
     },
     {
       "name": "init_refund_multi_comp_def",
+      "docs": [
+        "Register the compute_multi_refund Arcium computation definition."
+      ],
       "discriminator": [
         166,
         248,
@@ -1868,6 +2085,9 @@
     },
     {
       "name": "init_refund_yesno_comp_def",
+      "docs": [
+        "Register the compute_yesno_refund Arcium computation definition."
+      ],
       "discriminator": [
         114,
         168,
@@ -1913,6 +2133,9 @@
     },
     {
       "name": "init_reveal_multi_comp_def",
+      "docs": [
+        "Register the reveal_market_outcome_multi Arcium computation definition."
+      ],
       "discriminator": [
         174,
         143,
@@ -1958,6 +2181,9 @@
     },
     {
       "name": "init_reveal_yesno_comp_def",
+      "docs": [
+        "Register the reveal_market_outcome_yesno Arcium computation definition."
+      ],
       "discriminator": [
         185,
         221,
@@ -2003,6 +2229,9 @@
     },
     {
       "name": "initialize",
+      "docs": [
+        "Initialize the global protocol state: fee rates, treasury, accepted mint, and admin."
+      ],
       "discriminator": [
         175,
         175,
@@ -2069,6 +2298,9 @@
     },
     {
       "name": "place_private_bet_multi",
+      "docs": [
+        "Queue an encrypted multi-outcome bet for MPC processing."
+      ],
       "discriminator": [
         43,
         95,
@@ -2276,8 +2508,7 @@
           }
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         }
       ],
       "args": [
@@ -2324,6 +2555,9 @@
     },
     {
       "name": "place_private_bet_multi_callback",
+      "docs": [
+        "Callback that applies the MPC-computed pool totals and entry odds for a MultiOutcome bet."
+      ],
       "discriminator": [
         81,
         0,
@@ -2387,6 +2621,9 @@
     },
     {
       "name": "place_private_bet_yesno",
+      "docs": [
+        "Queue an encrypted YES/NO bet for MPC processing."
+      ],
       "discriminator": [
         14,
         226,
@@ -2594,8 +2831,7 @@
           }
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         }
       ],
       "args": [
@@ -2642,6 +2878,9 @@
     },
     {
       "name": "place_private_bet_yesno_callback",
+      "docs": [
+        "Callback that applies the MPC-computed pool totals and entry odds for a YesNo bet."
+      ],
       "discriminator": [
         1,
         193,
@@ -2705,6 +2944,9 @@
     },
     {
       "name": "resolve_market_multi",
+      "docs": [
+        "Queue MPC computation to reveal the multi-outcome winner and pools."
+      ],
       "discriminator": [
         237,
         84,
@@ -2835,6 +3077,9 @@
     },
     {
       "name": "resolve_market_yesno",
+      "docs": [
+        "Queue MPC computation to reveal the YES/NO outcome and pools."
+      ],
       "discriminator": [
         191,
         1,
@@ -2965,6 +3210,9 @@
     },
     {
       "name": "reveal_market_outcome_multi_callback",
+      "docs": [
+        "Callback that writes the revealed outcome, pools, and payout ratio; market enters the challenge window."
+      ],
       "discriminator": [
         114,
         103,
@@ -3024,6 +3272,9 @@
     },
     {
       "name": "reveal_market_outcome_yesno_callback",
+      "docs": [
+        "Callback that writes the revealed outcome, pools, and payout ratio; market enters the challenge window."
+      ],
       "discriminator": [
         92,
         112,
@@ -3083,6 +3334,9 @@
     },
     {
       "name": "update_accepted_mint",
+      "docs": [
+        "Update the protocol's accepted mint and treasury (admin only)."
+      ],
       "discriminator": [
         6,
         166,
@@ -3139,6 +3393,9 @@
     },
     {
       "name": "withdraw_creator_funds",
+      "docs": [
+        "Withdraw creator bond and accumulated LP fees after the market is resolved."
+      ],
       "discriminator": [
         135,
         166,
@@ -3245,8 +3502,7 @@
           "writable": true
         },
         {
-          "name": "token_program",
-          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+          "name": "token_program"
         }
       ],
       "args": []
@@ -3372,6 +3628,19 @@
         124
       ]
     },
+    {
+      "name": "MarketFinalizedEvent",
+      "discriminator": [
+        141,
+        216,
+        158,
+        192,
+        60,
+        222,
+        155,
+        232
+      ]
+    },
     {
       "name": "MarketResolvedEvent",
       "discriminator": [
@@ -3410,6 +3679,32 @@
         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": [
@@ -3592,6 +3887,36 @@
       "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": [
@@ -4594,6 +4919,27 @@
             "name": "refund_deadline",
             "type": "i64"
           },
+          {
+            "name": "challenge_period",
+            "docs": [
+              "Configurable dispute window (24-48h), set at creation"
+            ],
+            "type": "i64"
+          },
+          {
+            "name": "challenge_deadline",
+            "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"
@@ -4657,6 +5003,26 @@
         ]
       }
     },
+    {
+      "name": "MarketFinalizedEvent",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "market",
+            "type": "pubkey"
+          },
+          {
+            "name": "outcome",
+            "type": "u8"
+          },
+          {
+            "name": "payout_ratio",
+            "type": "u64"
+          }
+        ]
+      }
+    },
     {
       "name": "MarketResolvedEvent",
       "type": {
@@ -5055,6 +5421,50 @@
         ]
       }
     },
+    {
+      "name": "ResolutionFlaggedEvent",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "market",
+            "type": "pubkey"
+          },
+          {
+            "name": "flagged_by",
+            "type": "pubkey"
+          }
+        ]
+      }
+    },
+    {
+      "name": "ResolutionOverriddenEvent",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "market",
+            "type": "pubkey"
+          },
+          {
+            "name": "old_outcome",
+            "type": "u8"
+          },
+          {
+            "name": "new_outcome",
+            "type": "u8"
+          },
+          {
+            "name": "new_payout_ratio",
+            "type": "u64"
+          },
+          {
+            "name": "admin",
+            "type": "pubkey"
+          }
+        ]
+      }
+    },
     {
       "name": "RevealMarketOutcomeMultiOutput",
       "docs": [