@arcium-hq/client 0.6.5 → 0.7.0

package/build/index.d.ts

@@ -456,7 +456,7 @@ type Arcium = {
     "address": "Arcj82pX7HxYKLR92qvgZUAd7vGS1k4hQvAFcPATFdEQ";
     "metadata": {
         "name": "arcium";
-        "version": "0.6.5";
+        "version": "0.7.0";
         "spec": "0.1.0";
         "description": "The Arcium program";
     };
@@ -2711,6 +2711,29 @@ type Arcium = {
                         ];
                     };
                 },
+                {
+                    "name": "clusterAcc";
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    67,
+                                    108,
+                                    117,
+                                    115,
+                                    116,
+                                    101,
+                                    114
+                                ];
+                            },
+                            {
+                                "kind": "arg";
+                                "path": "clusterOffset";
+                            }
+                        ];
+                    };
+                },
                 {
                     "name": "executingPool";
                     "writable": true;
@@ -2799,6 +2822,17 @@ type Arcium = {
                 {
                     "name": "callbackTransactionIndex";
                     "type": "u8";
+                },
+                {
+                    "name": "blsSig";
+                    "type": {
+                        "option": {
+                            "array": [
+                                "u8",
+                                64
+                            ];
+                        };
+                    };
                 }
             ];
         },
@@ -3890,6 +3924,17 @@ type Arcium = {
                         ];
                     };
                 },
+                {
+                    "name": "addressLookupTable";
+                    "docs": [
+                        "Seeds are checked in the CPI to LUT program, so no need to check them here."
+                    ];
+                    "writable": true;
+                },
+                {
+                    "name": "lutProgram";
+                    "address": "AddressLookupTab1e1111111111111111111111111";
+                },
                 {
                     "name": "compDefAcc";
                     "writable": true;
@@ -4004,6 +4049,11 @@ type Arcium = {
                 224
             ];
             "accounts": [
+                {
+                    "name": "authority";
+                    "writable": true;
+                    "signer": true;
+                },
                 {
                     "name": "payer";
                     "writable": true;
@@ -4800,6 +4850,17 @@ type Arcium = {
                         ];
                     };
                 },
+                {
+                    "name": "addressLookupTable";
+                    "docs": [
+                        "Seeds are checked in the CPI to LUT program, so no need to check them here."
+                    ];
+                    "writable": true;
+                },
+                {
+                    "name": "lutProgram";
+                    "address": "AddressLookupTab1e1111111111111111111111111";
+                },
                 {
                     "name": "clock";
                     "writable": true;
@@ -4855,6 +4916,10 @@ type Arcium = {
                 {
                     "name": "keyRecoveryInitOffset";
                     "type": "u64";
+                },
+                {
+                    "name": "recentOffset";
+                    "type": "u64";
                 }
             ];
         },
@@ -5159,91 +5224,6 @@ type Arcium = {
                 }
             ];
         },
-        {
-            "name": "leaveMxe";
-            "discriminator": [
-                225,
-                222,
-                68,
-                9,
-                96,
-                160,
-                126,
-                211
-            ];
-            "accounts": [
-                {
-                    "name": "authority";
-                    "writable": true;
-                    "signer": true;
-                },
-                {
-                    "name": "clusterAcc";
-                    "writable": true;
-                    "pda": {
-                        "seeds": [
-                            {
-                                "kind": "const";
-                                "value": [
-                                    67,
-                                    108,
-                                    117,
-                                    115,
-                                    116,
-                                    101,
-                                    114
-                                ];
-                            },
-                            {
-                                "kind": "arg";
-                                "path": "id";
-                            }
-                        ];
-                    };
-                },
-                {
-                    "name": "mxe";
-                    "writable": true;
-                    "pda": {
-                        "seeds": [
-                            {
-                                "kind": "const";
-                                "value": [
-                                    77,
-                                    88,
-                                    69,
-                                    65,
-                                    99,
-                                    99,
-                                    111,
-                                    117,
-                                    110,
-                                    116
-                                ];
-                            },
-                            {
-                                "kind": "arg";
-                                "path": "mxeProgram";
-                            }
-                        ];
-                    };
-                },
-                {
-                    "name": "systemProgram";
-                    "address": "11111111111111111111111111111111";
-                }
-            ];
-            "args": [
-                {
-                    "name": "clusterOffset";
-                    "type": "u32";
-                },
-                {
-                    "name": "mxeProgram";
-                    "type": "pubkey";
-                }
-            ];
-        },
         {
             "name": "proposeFee";
             "discriminator": [
@@ -5548,8 +5528,9 @@ type Arcium = {
                                 ];
                             },
                             {
-                                "kind": "arg";
-                                "path": "cluster_index.map_or(mxe.cluster.ok_or(ArciumError :: ClusterNotSet) ? , | i |\nmxe.fallback_clusters [i as usize])";
+                                "kind": "account";
+                                "path": "mxe.cluster.ok_or(ArciumError :: ClusterNotSet) ? ";
+                                "account": "mxeAccount";
                             },
                             {
                                 "kind": "arg";
@@ -5603,8 +5584,9 @@ type Arcium = {
                                 ];
                             },
                             {
-                                "kind": "arg";
-                                "path": "cluster_index.map_or(mxe.cluster.ok_or(ArciumError :: ClusterNotSet) ? , | i |\nmxe.fallback_clusters [i as usize])";
+                                "kind": "account";
+                                "path": "mxe.cluster.ok_or(ArciumError :: ClusterNotSet) ? ";
+                                "account": "mxeAccount";
                             }
                         ];
                     };
@@ -5627,8 +5609,9 @@ type Arcium = {
                                 ];
                             },
                             {
-                                "kind": "arg";
-                                "path": "cluster_index.map_or(mxe.cluster.ok_or(ArciumError :: ClusterNotSet) ? , | i |\nmxe.fallback_clusters [i as usize])";
+                                "kind": "account";
+                                "path": "mxe.cluster.ok_or(ArciumError :: ClusterNotSet) ? ";
+                                "account": "mxeAccount";
                             }
                         ];
                     };
@@ -5699,8 +5682,9 @@ type Arcium = {
                                 ];
                             },
                             {
-                                "kind": "arg";
-                                "path": "cluster_index.map_or(mxe.cluster.ok_or(ArciumError :: ClusterNotSet) ? , | i |\nmxe.fallback_clusters [i as usize])";
+                                "kind": "account";
+                                "path": "mxe.cluster.ok_or(ArciumError :: ClusterNotSet) ? ";
+                                "account": "mxeAccount";
                             }
                         ];
                     };
@@ -5764,12 +5748,6 @@ type Arcium = {
                     "name": "computationDefinitionOffset";
                     "type": "u32";
                 },
-                {
-                    "name": "clusterIndex";
-                    "type": {
-                        "option": "u16";
-                    };
-                },
                 {
                     "name": "args";
                     "type": {
@@ -5782,12 +5760,6 @@ type Arcium = {
                     "name": "mxeProgram";
                     "type": "pubkey";
                 },
-                {
-                    "name": "callbackUrl";
-                    "type": {
-                        "option": "string";
-                    };
-                },
                 {
                     "name": "customCallbackInstructions";
                     "type": {
@@ -6178,16 +6150,16 @@ type Arcium = {
             ];
         },
         {
-            "name": "reclaimFailureRent";
+            "name": "reclaimFailureRentIdempotent";
             "discriminator": [
-                159,
-                99,
-                116,
-                180,
-                42,
-                9,
-                202,
-                219
+                138,
+                13,
+                253,
+                191,
+                226,
+                239,
+                246,
+                10
             ];
             "accounts": [
                 {
@@ -6195,51 +6167,19 @@ type Arcium = {
                     "writable": true;
                     "signer": true;
                 },
+                {
+                    "name": "recipient";
+                    "docs": [
+                        "failure PDA"
+                    ];
+                    "writable": true;
+                },
                 {
                     "name": "failureAcc";
+                    "docs": [
+                        "the checks and close by hand in the instruction handler."
+                    ];
                     "writable": true;
-                    "pda": {
-                        "seeds": [
-                            {
-                                "kind": "const";
-                                "value": [
-                                    70,
-                                    97,
-                                    105,
-                                    108,
-                                    117,
-                                    114,
-                                    101,
-                                    67,
-                                    108,
-                                    97,
-                                    105,
-                                    109,
-                                    65,
-                                    99,
-                                    99,
-                                    111,
-                                    117,
-                                    110,
-                                    116,
-                                    72,
-                                    101,
-                                    97,
-                                    100,
-                                    101,
-                                    114
-                                ];
-                            },
-                            {
-                                "kind": "arg";
-                                "path": "mxeProgram";
-                            },
-                            {
-                                "kind": "arg";
-                                "path": "compOffset";
-                            }
-                        ];
-                    };
                 }
             ];
             "args": [
@@ -8335,6 +8275,19 @@ type Arcium = {
                 186
             ];
         },
+        {
+            "name": "keyRecoveryEvent";
+            "discriminator": [
+                83,
+                147,
+                226,
+                153,
+                39,
+                242,
+                109,
+                254
+            ];
+        },
         {
             "name": "queueComputationEvent";
             "discriminator": [
@@ -8475,6 +8428,11 @@ type Arcium = {
             "name": "invalidCallbackIndex";
             "msg": "Invalid callback transaction index";
         },
+        {
+            "code": 6212;
+            "name": "multiTxCallbacksDisabled";
+            "msg": "Multi-transaction callbacks disabled";
+        },
         {
             "code": 6300;
             "name": "computationDefinitionNotCompleted";
@@ -8794,6 +8752,11 @@ type Arcium = {
             "code": 6715;
             "name": "arithmeticOverflow";
             "msg": "Arithmetic overflow";
+        },
+        {
+            "code": 6716;
+            "name": "mxeInRecoveryState";
+            "msg": "MXE is in recovery state, cannot queue new computations";
         }
     ];
     "types": [
@@ -9614,20 +9577,6 @@ type Arcium = {
                             };
                         };
                     },
-                    {
-                        "name": "clusterIndex";
-                        "docs": [
-                            "The MXE's cluster to be used for execution.",
-                            "",
-                            "# Notes",
-                            "",
-                            "- [None] represents the default cluster,",
-                            "- [Some] specifies the index of the fallback cluster."
-                        ];
-                        "type": {
-                            "option": "u16";
-                        };
-                    },
                     {
                         "name": "arguments";
                         "type": {
@@ -9636,12 +9585,6 @@ type Arcium = {
                             };
                         };
                     },
-                    {
-                        "name": "callbackUrl";
-                        "type": {
-                            "option": "string";
-                        };
-                    },
                     {
                         "name": "customCallbackInstructions";
                         "type": {
@@ -9964,6 +9907,16 @@ type Arcium = {
                                 };
                             }
                         ];
+                    },
+                    {
+                        "name": "keyRecoveryFailure";
+                        "fields": [
+                            {
+                                "defined": {
+                                    "name": "keyRecoveryFailureReason";
+                                };
+                            }
+                        ];
                     }
                 ];
             };
@@ -10121,6 +10074,58 @@ type Arcium = {
                 ];
             };
         },
+        {
+            "name": "keyRecoveryEvent";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "computationOffset";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "mxeProgramId";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "backupMxeProgramId";
+                        "type": "pubkey";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "keyRecoveryFailureReason";
+            "type": {
+                "kind": "enum";
+                "variants": [
+                    {
+                        "name": "keysDigestMismatch";
+                    },
+                    {
+                        "name": "x25519PubkeyMismatch";
+                    },
+                    {
+                        "name": "ed25519VerifyingKeyMismatch";
+                    },
+                    {
+                        "name": "elGamalPubkeyMismatch";
+                    },
+                    {
+                        "name": "tooManyCorruptPeers";
+                    },
+                    {
+                        "name": "serialization";
+                    },
+                    {
+                        "name": "noPubkeysSet";
+                    },
+                    {
+                        "name": "accountNotFound";
+                    }
+                ];
+            };
+        },
         {
             "name": "largeExecPool";
             "serialization": "bytemuckunsafe";
@@ -10394,24 +10399,8 @@ type Arcium = {
                         };
                     },
                     {
-                        "name": "fallbackClusters";
-                        "docs": [
-                            "Fallback clusters that can execute this MXE as an alternative to the",
-                            "[MXEAccount::cluster]. There can be a maximum of [MAX_FALLBACK_CLUSTERS]",
-                            "fallback clusters."
-                        ];
-                        "type": {
-                            "vec": "u32";
-                        };
-                    },
-                    {
-                        "name": "rejectedClusters";
-                        "docs": [
-                            "The clusters that have rejected this MXE."
-                        ];
-                        "type": {
-                            "vec": "u32";
-                        };
+                        "name": "lutOffsetSlot";
+                        "type": "u64";
                     },
                     {
                         "name": "computationDefinitions";
@@ -11655,6 +11644,11 @@ type MempoolAccount = anchor.IdlTypes<Arcium>['tinyMempool'] | anchor.IdlTypes<A
  * - Large: 100 parallel computations
  */
 type ExecutingPoolAccount = anchor.IdlTypes<Arcium>['tinyExecPool'] | anchor.IdlTypes<Arcium>['smallExecPool'] | anchor.IdlTypes<Arcium>['mediumExecPool'] | anchor.IdlTypes<Arcium>['largeExecPool'];
+/**
+ * IDL-generated type for circuit source location.
+ * Discriminated union with variants: local, onChain, offChain.
+ */
+type CircuitSource = anchor.IdlTypes<Arcium>['circuitSource'];
 /**
  * Fetches and decodes the mempool account info for any mempool account size.
  * @param provider - The Anchor provider to use for fetching accounts.
@@ -11715,6 +11709,18 @@ declare function getMXEPublicKey(provider: AnchorProvider, mxeProgramId: anchor.
  * @returns The MXE's arcis ed25519 verifying key as a Uint8Array, or null if not set.
  */
 declare function getMXEArcisEd25519VerifyingKey(provider: AnchorProvider, mxeProgramId: anchor.web3.PublicKey): Promise<Uint8Array | null>;
+/**
+ * Represents the current state of a circuit's on-chain presence.
+ * @internal Used by `uploadCircuit` - most users don't need this directly.
+ */
+type CircuitState = 'OnchainPending' | 'OnchainFinalized' | 'Offchain';
+/**
+ * Determines the current state of a circuit based on its on-chain configuration.
+ * @internal Called internally by `uploadCircuit` - most users don't need this directly.
+ * @param circuitSource - The circuitSource field from ComputationDefinitionAccount.
+ * @returns The current state of the circuit.
+ */
+declare function getCircuitState(circuitSource: CircuitSource): CircuitState;
 /**
  * Uploads a circuit to the blockchain, splitting it into multiple accounts if necessary.
  * @param provider - The Anchor provider to use for transactions.
@@ -11785,15 +11791,15 @@ declare function initKeyRecoveryExecution(provider: AnchorProvider, originalMxeP
 declare function submitKeyRecoveryShare(provider: AnchorProvider, originalMxeProgramId: anchor.web3.PublicKey, backupMxeProgramId: anchor.web3.PublicKey, nodeOffset: number, peerIndex: number, share: number[][] | Uint8Array[]): Promise<string>;
 /**
  * Finalizes key recovery execution after the submission threshold is met.
- * This queues the key_recovery_final MPC computation on the backup cluster.
+ * This queues the key_recovery_finalize MPC computation on the backup cluster.
  * @param provider - The Anchor provider to use for transactions.
  * @param originalMxeProgramId - The public key of the original MXE program being recovered.
  * @param backupMxeProgramId - The public key of the backup MXE program.
  * @param clusterOffset - The cluster offset where the backup MXE is deployed.
- * @param keyRecoveryFinalOffset - The computation offset for the key_recovery_final computation.
+ * @param keyRecoveryFinalizeOffset - The computation offset for the key_recovery_finalize computation.
  * @returns The transaction signature.
  */
-declare function finalizeKeyRecoveryExecution(provider: AnchorProvider, originalMxeProgramId: anchor.web3.PublicKey, backupMxeProgramId: anchor.web3.PublicKey, clusterOffset: number, keyRecoveryFinalOffset: anchor.BN): Promise<string>;
+declare function finalizeKeyRecoveryExecution(provider: AnchorProvider, originalMxeProgramId: anchor.web3.PublicKey, backupMxeProgramId: anchor.web3.PublicKey, clusterOffset: number, keyRecoveryFinalizeOffset: anchor.BN): Promise<string>;
 /**
  * Initializes an MXE (part 1). Due to Solana's 10KB per-instruction allocation limit,
  * this only partially allocates recovery_cluster_acc.
@@ -11816,7 +11822,7 @@ declare function initMxePart1(provider: AnchorProvider, mxeProgramId: anchor.web
  * @param mxeAuthority - Optional authority for the MXE (defaults to provider.publicKey).
  * @returns The transaction signature.
  */
-declare function initMxePart2(provider: AnchorProvider, clusterOffset: number, mxeProgramId: anchor.web3.PublicKey, recoveryPeers: number[], keygenOffset: anchor.BN, keyRecoveryInitOffset: anchor.BN, mxeAuthority?: anchor.web3.PublicKey): Promise<string>;
+declare function initMxePart2(provider: AnchorProvider, clusterOffset: number, mxeProgramId: anchor.web3.PublicKey, recoveryPeers: number[], keygenOffset: anchor.BN, keyRecoveryInitOffset: anchor.BN, lutOffset: anchor.BN, mxeAuthority?: anchor.web3.PublicKey): Promise<string>;
 
 /**
  * Structure representing the local Arcium environment variables required for local development or testing.
@@ -11919,6 +11925,20 @@ declare function getRecoveryClusterAccAddress(mxeProgramId: PublicKey): PublicKe
  * @returns The derived MXE recovery account public key.
  */
 declare function getMxeRecoveryAccAddress(backupMxeProgramId: PublicKey, originalMxeProgramId: PublicKey): PublicKey;
+/**
+ * Derives the raw circuit account address for a given computation definition and index.
+ * @param compDefPubkey - The public key of the computation definition account.
+ * @param rawCircuitIndex - The index of the raw circuit account (0-based).
+ * @returns The derived raw circuit account public key.
+ */
+declare function getRawCircuitAccAddress(compDefPubkey: PublicKey, rawCircuitIndex: number): PublicKey;
+/**
+ * Derives the address lookup table address for an MXE program.
+ * @param mxeProgramId - The public key of the MXE program.
+ * @param lutOffset - The index of the lookup table, to be fetched from the mxe account.
+ * @returns The derived address lookup table public key.
+ */
+declare function getLookupTableAddress(mxeProgramId: PublicKey, lutOffset: anchor.BN): PublicKey;
 
-export { ARCIUM_ADDR, ARCIUM_IDL, Aes128Cipher, Aes192Cipher, Aes256Cipher, ArcisModule, ArcisType, ArcisValueField, CSplRescueCipher, CURVE25519_BASE_FIELD, CURVE25519_SCALAR_FIELD, CURVE25519_SCALAR_FIELD_MODULUS, IntegerInfo, Matrix, RescueCipher, RescueDesc, RescuePrimeHash, arcisEd25519, awaitComputationFinalization, buildFinalizeCompDefTx, createPacker, deserializeLE, finalizeKeyRecoveryExecution, generateRandomFieldElem, getArciumAccountBaseSeed, getArciumEnv, getArciumProgram, getArciumProgramId, getArxNodeAccAddress, getClockAccAddress, getClusterAccAddress, getCompDefAccAddress, getCompDefAccOffset, getComputationAccAddress, getComputationsInMempool, getExecutingPoolAccAddress, getExecutingPoolAccInfo, getFeePoolAccAddress, getMXEAccAddress, getMXEArcisEd25519VerifyingKey, getMXEPublicKey, getMempoolAccAddress, getMempoolAccInfo, getMempoolPriorityFeeStats, getMxeRecoveryAccAddress, getRecoveryClusterAccAddress, initKeyRecoveryExecution, initMxePart1, initMxePart2, isNullRef, positiveModulo, queueKeyRecoveryInit, randMatrix, recoverMxe, serializeLE, sha256, submitKeyRecoveryShare, toVec, uploadCircuit };
-export type { Arcium as ArciumIdlType, ArciumLocalEnv, ComputationErrorType, ComputationReference, ExecutingPoolAccount, FieldInfo, FpField, MempoolAccount, MempoolPriorityFeeStats, Packer };
+export { ARCIUM_ADDR, ARCIUM_IDL, Aes128Cipher, Aes192Cipher, Aes256Cipher, ArcisModule, ArcisType, ArcisValueField, CSplRescueCipher, CURVE25519_BASE_FIELD, CURVE25519_SCALAR_FIELD, CURVE25519_SCALAR_FIELD_MODULUS, IntegerInfo, Matrix, RescueCipher, RescueDesc, RescuePrimeHash, arcisEd25519, awaitComputationFinalization, buildFinalizeCompDefTx, createPacker, deserializeLE, finalizeKeyRecoveryExecution, generateRandomFieldElem, getArciumAccountBaseSeed, getArciumEnv, getArciumProgram, getArciumProgramId, getArxNodeAccAddress, getCircuitState, getClockAccAddress, getClusterAccAddress, getCompDefAccAddress, getCompDefAccOffset, getComputationAccAddress, getComputationsInMempool, getExecutingPoolAccAddress, getExecutingPoolAccInfo, getFeePoolAccAddress, getLookupTableAddress, getMXEAccAddress, getMXEArcisEd25519VerifyingKey, getMXEPublicKey, getMempoolAccAddress, getMempoolAccInfo, getMempoolPriorityFeeStats, getMxeRecoveryAccAddress, getRawCircuitAccAddress, getRecoveryClusterAccAddress, initKeyRecoveryExecution, initMxePart1, initMxePart2, isNullRef, positiveModulo, queueKeyRecoveryInit, randMatrix, recoverMxe, serializeLE, sha256, submitKeyRecoveryShare, toVec, uploadCircuit };
+export type { Arcium as ArciumIdlType, ArciumLocalEnv, CircuitSource, CircuitState, ComputationErrorType, ComputationReference, ExecutingPoolAccount, FieldInfo, FpField, MempoolAccount, MempoolPriorityFeeStats, Packer };