@arcium-hq/client 0.6.5 → 0.6.6

package/README.md

@@ -180,7 +180,7 @@ await uploadCircuit(
   "your_circuit_name",
   program.programId,
   rawCircuit,
-  true // use raw circuit
+  true // enable logging
 );
 ```
 

package/build/index.cjs

@@ -1809,7 +1809,7 @@ function createPacker(fields, typeName = 'Packer') {
 var address = "Arcj82pX7HxYKLR92qvgZUAd7vGS1k4hQvAFcPATFdEQ";
 var metadata = {
 	name: "arcium",
-	version: "0.6.5",
+	version: "0.6.6",
 	spec: "0.1.0",
 	description: "The Arcium program"
 };
@@ -4065,6 +4065,29 @@ var instructions = [
 					]
 				}
 			},
+			{
+				name: "cluster_acc",
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								67,
+								108,
+								117,
+								115,
+								116,
+								101,
+								114
+							]
+						},
+						{
+							kind: "arg",
+							path: "cluster_offset"
+						}
+					]
+				}
+			},
 			{
 				name: "executing_pool",
 				writable: true,
@@ -4153,6 +4176,17 @@ var instructions = [
 			{
 				name: "callback_transaction_index",
 				type: "u8"
+			},
+			{
+				name: "bls_sig",
+				type: {
+					option: {
+						array: [
+							"u8",
+							64
+						]
+					}
+				}
 			}
 		]
 	},
@@ -5244,6 +5278,17 @@ var instructions = [
 					]
 				}
 			},
+			{
+				name: "address_lookup_table",
+				docs: [
+					"Seeds are checked in the CPI to LUT program, so no need to check them here."
+				],
+				writable: true
+			},
+			{
+				name: "lut_program",
+				address: "AddressLookupTab1e1111111111111111111111111"
+			},
 			{
 				name: "comp_def_acc",
 				writable: true,
@@ -5358,6 +5403,11 @@ var instructions = [
 			224
 		],
 		accounts: [
+			{
+				name: "authority",
+				writable: true,
+				signer: true
+			},
 			{
 				name: "payer",
 				writable: true,
@@ -6155,6 +6205,17 @@ var instructions = [
 					]
 				}
 			},
+			{
+				name: "address_lookup_table",
+				docs: [
+					"Seeds are checked in the CPI to LUT program, so no need to check them here."
+				],
+				writable: true
+			},
+			{
+				name: "lut_program",
+				address: "AddressLookupTab1e1111111111111111111111111"
+			},
 			{
 				name: "clock",
 				writable: true,
@@ -7137,12 +7198,6 @@ var instructions = [
 				name: "mxe_program",
 				type: "pubkey"
 			},
-			{
-				name: "callback_url",
-				type: {
-					option: "string"
-				}
-			},
 			{
 				name: "custom_callback_instructions",
 				type: {
@@ -7533,16 +7588,16 @@ var instructions = [
 		]
 	},
 	{
-		name: "reclaim_failure_rent",
+		name: "reclaim_failure_rent_idempotent",
 		discriminator: [
-			159,
-			99,
-			116,
-			180,
-			42,
-			9,
-			202,
-			219
+			138,
+			13,
+			253,
+			191,
+			226,
+			239,
+			246,
+			10
 		],
 		accounts: [
 			{
@@ -7550,51 +7605,19 @@ var instructions = [
 				writable: true,
 				signer: true
 			},
+			{
+				name: "recipient",
+				docs: [
+					"failure PDA"
+				],
+				writable: true
+			},
 			{
 				name: "failure_acc",
-				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: "mxe_program"
-						},
-						{
-							kind: "arg",
-							path: "comp_offset"
-						}
-					]
-				}
+				docs: [
+					"the checks and close by hand in the instruction handler."
+				],
+				writable: true
 			}
 		],
 		args: [
@@ -9691,6 +9714,19 @@ var events = [
 			186
 		]
 	},
+	{
+		name: "KeyRecoveryEvent",
+		discriminator: [
+			83,
+			147,
+			226,
+			153,
+			39,
+			242,
+			109,
+			254
+		]
+	},
 	{
 		name: "QueueComputationEvent",
 		discriminator: [
@@ -9831,6 +9867,11 @@ var errors = [
 		name: "InvalidCallbackIndex",
 		msg: "Invalid callback transaction index"
 	},
+	{
+		code: 6212,
+		name: "MultiTxCallbacksDisabled",
+		msg: "Multi-transaction callbacks disabled"
+	},
 	{
 		code: 6300,
 		name: "ComputationDefinitionNotCompleted",
@@ -10150,6 +10191,11 @@ var errors = [
 		code: 6715,
 		name: "ArithmeticOverflow",
 		msg: "Arithmetic overflow"
+	},
+	{
+		code: 6716,
+		name: "MxeInRecoveryState",
+		msg: "MXE is in recovery state, cannot queue new computations"
 	}
 ];
 var types = [
@@ -10992,12 +11038,6 @@ var types = [
 						}
 					}
 				},
-				{
-					name: "callback_url",
-					type: {
-						option: "string"
-					}
-				},
 				{
 					name: "custom_callback_instructions",
 					type: {
@@ -11477,6 +11517,26 @@ var types = [
 			]
 		}
 	},
+	{
+		name: "KeyRecoveryEvent",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "computation_offset",
+					type: "u64"
+				},
+				{
+					name: "mxe_program_id",
+					type: "pubkey"
+				},
+				{
+					name: "backup_mxe_program_id",
+					type: "pubkey"
+				}
+			]
+		}
+	},
 	{
 		name: "LargeExecPool",
 		serialization: "bytemuckunsafe",
@@ -13055,6 +13115,11 @@ const RECOVERY_CLUSTER_ACC_SEED = 'RecoveryClusterAccount';
  * @constant {string}
  */
 const MXE_RECOVERY_ACC_SEED = 'MxeRecoveryAccount';
+/**
+ * Seed for ComputationDefinitionRaw PDA
+ * @constant {string}
+ */
+const RAW_CIRCUIT_ACC_SEED = 'ComputationDefinitionRaw';
 /**
  * Maximum number of bytes that can be reallocated per instruction.
  * @constant {number}
@@ -13214,6 +13279,32 @@ function getMxeRecoveryAccAddress(backupMxeProgramId, originalMxeProgramId) {
     ];
     return generateArciumPDAFrom(seeds)[0];
 }
+/**
+ * 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.
+ */
+function getRawCircuitAccAddress(compDefPubkey, rawCircuitIndex) {
+    const seeds = [
+        Buffer.from(RAW_CIRCUIT_ACC_SEED),
+        compDefPubkey.toBuffer(),
+        Buffer.from([rawCircuitIndex]),
+    ];
+    return generateArciumPDAFrom(seeds)[0];
+}
+/**
+ * Derives the address lookup table address for an MXE program.
+ * @param mxeProgramId - The public key of the MXE program.
+ * @param lutIndex - The index of the lookup table (defaults to 0).
+ * @returns The derived address lookup table public key.
+ */
+function getLookupTableAddress(mxeProgramId, lutIndex = 0) {
+    const mxeAccount = getMXEAccAddress(mxeProgramId);
+    const lutIndexBuffer = new anchor__namespace.BN(lutIndex).toArrayLike(Buffer, 'le', 8);
+    const seeds = [mxeAccount.toBuffer(), lutIndexBuffer];
+    return web3_js.PublicKey.findProgramAddressSync(seeds, web3_js.AddressLookupTableProgram.programId)[0];
+}
 /**
  * Generates a program-derived address (PDA) from the provided seeds and the Arcium program ID.
  * @param seeds - An array of Buffer seeds used for PDA derivation.
@@ -13466,6 +13557,21 @@ async function getMXEPublicKey(provider, mxeProgramId) {
 async function getMXEArcisEd25519VerifyingKey(provider, mxeProgramId) {
     return getMXEUtilityKey(provider, mxeProgramId, 'ed25519VerifyingKey');
 }
+/**
+ * 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.
+ */
+function getCircuitState(circuitSource) {
+    if (!('onChain' in circuitSource) || !circuitSource.onChain) {
+        return 'Offchain';
+    }
+    if (circuitSource.onChain[0].isCompleted) {
+        return 'OnchainFinalized';
+    }
+    return 'OnchainPending';
+}
 /**
  * Uploads a circuit to the blockchain, splitting it into multiple accounts if necessary.
  * @param provider - The Anchor provider to use for transactions.
@@ -13477,10 +13583,17 @@ async function getMXEArcisEd25519VerifyingKey(provider, mxeProgramId) {
  * @returns An array of transaction signatures for all upload and finalize transactions.
  */
 async function uploadCircuit(provider, circuitName, mxeProgramId, rawCircuit, logging = true, chunkSize = 500) {
-    // 9 = 8-byte discriminator + 1-byte bump for ComputationDefinitionRaw account
-    const numAccs = Math.ceil(rawCircuit.length / (MAX_ACCOUNT_SIZE - 9));
     const compDefAccInfo = getCompDefAccInfo(circuitName, mxeProgramId);
     const program = getArciumProgram(provider);
+    const compDefAcc = await program.account.computationDefinitionAccount.fetch(compDefAccInfo.pubkey);
+    // Type assertion at boundary where Anchor's fetch() returns the account data
+    const state = getCircuitState(compDefAcc.circuitSource);
+    if (state !== 'OnchainPending') {
+        optionalLog(logging, `Circuit ${circuitName} skipped: ${state}`);
+        return [];
+    }
+    // 9 = 8-byte discriminator + 1-byte bump for ComputationDefinitionRaw account
+    const numAccs = Math.ceil(rawCircuit.length / (MAX_ACCOUNT_SIZE - 9));
     const sigs = [];
     const uploadPromises = [];
     for (let i = 0; i < numAccs; i++) {
@@ -13523,15 +13636,26 @@ async function buildFinalizeCompDefTx(provider, compDefOffset, mxeProgramId) {
         .transaction();
 }
 async function uploadToCircuitAcc(provider, program, rawCircuitPart, rawCircuitIndex, compDefAccInfo, mxeProgramId, shouldLog = true, chunkSize = 500) {
+    const rawCircuitPda = getRawCircuitAccAddress(compDefAccInfo.pubkey, rawCircuitIndex);
+    const existingAcc = await provider.connection.getAccountInfo(rawCircuitPda);
+    // Skip entirely if account exists with correct size (pre-seeded at genesis or already uploaded)
+    // Account layout: 8-byte discriminator + 1-byte bump + circuit data
+    const requiredAccountSize = rawCircuitPart.length + 9;
+    if (existingAcc !== null && existingAcc.data.length >= requiredAccountSize) {
+        optionalLog(shouldLog, `Raw circuit acc ${rawCircuitIndex} already exists with sufficient size, skipping`);
+        return [];
+    }
     const sigs = [];
-    const initTx = await program.methods
-        .initRawCircuitAcc(compDefAccInfo.offset, mxeProgramId, rawCircuitIndex)
-        .accounts({
-        signer: provider.publicKey,
-    })
-        .rpc();
-    optionalLog(shouldLog, `Initiated raw circuit acc with raw circuit index ${rawCircuitIndex}`);
-    sigs.push(initTx);
+    if (existingAcc === null) {
+        const initTx = await program.methods
+            .initRawCircuitAcc(compDefAccInfo.offset, mxeProgramId, rawCircuitIndex)
+            .accounts({
+            signer: provider.publicKey,
+        })
+            .rpc();
+        optionalLog(shouldLog, `Initiated raw circuit acc with raw circuit index ${rawCircuitIndex}`);
+        sigs.push(initTx);
+    }
     if (rawCircuitPart.length > MAX_REALLOC_PER_IX) {
         // We only need to add size if the init didn't already make us big enough
         const nonAsyncTxCount = Math.ceil(rawCircuitPart.length / (MAX_REALLOC_PER_IX * MAX_EMBIGGEN_IX_PER_TX));
@@ -13556,8 +13680,10 @@ async function uploadToCircuitAcc(provider, program, rawCircuitPart, rawCircuitI
     const blockInfo = await provider.connection.getLatestBlockhash();
     for (let i = 0; i < remainingTxCount; i += chunkSize) {
         optionalLog(shouldLog, `Sending chunk ${i / chunkSize + 1} of ${Math.ceil(remainingTxCount / chunkSize)}`);
-        const chunkPromises = []; // Array to hold promises for the current chunk
-        const currentChunkSize = Math.min(chunkSize, remainingTxCount - i); // Handle the last chunk
+        // Array to hold promises for the current chunk
+        const chunkPromises = [];
+        // Handle the last chunk
+        const currentChunkSize = Math.min(chunkSize, remainingTxCount - i);
         for (let j = 0; j < currentChunkSize; j++) {
             const offset = MAX_UPLOAD_PER_TX_BYTES * (i + j);
             // eslint-disable-next-line no-await-in-loop
@@ -13567,7 +13693,8 @@ async function uploadToCircuitAcc(provider, program, rawCircuitPart, rawCircuitI
         // Wait for the current chunk to complete before proceeding
         // eslint-disable-next-line no-await-in-loop
         const chunkResults = await Promise.all(chunkPromises);
-        remainingTxs.push(...chunkResults); // Add the results of the current chunk to the main array
+        // Add the results of the current chunk to the main array
+        remainingTxs.push(...chunkResults);
         optionalLog(shouldLog, `Done sending chunk ${i / chunkSize + 1} of ${Math.ceil(remainingTxCount / chunkSize)}`);
     }
     return sigs.concat(remainingTxs);
@@ -13817,6 +13944,7 @@ async function initMxePart2(provider, clusterOffset, mxeProgramId, recoveryPeers
         mxeProgram: mxeProgramId,
         poolAccount: getFeePoolAccAddress(),
         mxeAuthority: mxeAuthority ?? provider.publicKey,
+        addressLookupTable: getLookupTableAddress(mxeProgramId),
     })
         .transaction();
     return signAndSendWithBlockhash(provider, tx, await provider.connection.getLatestBlockhash({ commitment: 'confirmed' }));
@@ -13913,6 +14041,7 @@ exports.getArciumEnv = getArciumEnv;
 exports.getArciumProgram = getArciumProgram;
 exports.getArciumProgramId = getArciumProgramId;
 exports.getArxNodeAccAddress = getArxNodeAccAddress;
+exports.getCircuitState = getCircuitState;
 exports.getClockAccAddress = getClockAccAddress;
 exports.getClusterAccAddress = getClusterAccAddress;
 exports.getCompDefAccAddress = getCompDefAccAddress;
@@ -13922,6 +14051,7 @@ exports.getComputationsInMempool = getComputationsInMempool;
 exports.getExecutingPoolAccAddress = getExecutingPoolAccAddress;
 exports.getExecutingPoolAccInfo = getExecutingPoolAccInfo;
 exports.getFeePoolAccAddress = getFeePoolAccAddress;
+exports.getLookupTableAddress = getLookupTableAddress;
 exports.getMXEAccAddress = getMXEAccAddress;
 exports.getMXEArcisEd25519VerifyingKey = getMXEArcisEd25519VerifyingKey;
 exports.getMXEPublicKey = getMXEPublicKey;
@@ -13929,6 +14059,7 @@ exports.getMempoolAccAddress = getMempoolAccAddress;
 exports.getMempoolAccInfo = getMempoolAccInfo;
 exports.getMempoolPriorityFeeStats = getMempoolPriorityFeeStats;
 exports.getMxeRecoveryAccAddress = getMxeRecoveryAccAddress;
+exports.getRawCircuitAccAddress = getRawCircuitAccAddress;
 exports.getRecoveryClusterAccAddress = getRecoveryClusterAccAddress;
 exports.initKeyRecoveryExecution = initKeyRecoveryExecution;
 exports.initMxePart1 = initMxePart1;

package/build/index.d.ts

@@ -456,7 +456,7 @@ type Arcium = {
     "address": "Arcj82pX7HxYKLR92qvgZUAd7vGS1k4hQvAFcPATFdEQ";
     "metadata": {
         "name": "arcium";
-        "version": "0.6.5";
+        "version": "0.6.6";
         "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;
@@ -5782,12 +5843,6 @@ type Arcium = {
                     "name": "mxeProgram";
                     "type": "pubkey";
                 },
-                {
-                    "name": "callbackUrl";
-                    "type": {
-                        "option": "string";
-                    };
-                },
                 {
                     "name": "customCallbackInstructions";
                     "type": {
@@ -6178,16 +6233,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 +6250,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 +8358,19 @@ type Arcium = {
                 186
             ];
         },
+        {
+            "name": "keyRecoveryEvent";
+            "discriminator": [
+                83,
+                147,
+                226,
+                153,
+                39,
+                242,
+                109,
+                254
+            ];
+        },
         {
             "name": "queueComputationEvent";
             "discriminator": [
@@ -8475,6 +8511,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 +8835,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": [
@@ -9636,12 +9682,6 @@ type Arcium = {
                             };
                         };
                     },
-                    {
-                        "name": "callbackUrl";
-                        "type": {
-                            "option": "string";
-                        };
-                    },
                     {
                         "name": "customCallbackInstructions";
                         "type": {
@@ -10121,6 +10161,26 @@ type Arcium = {
                 ];
             };
         },
+        {
+            "name": "keyRecoveryEvent";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "computationOffset";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "mxeProgramId";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "backupMxeProgramId";
+                        "type": "pubkey";
+                    }
+                ];
+            };
+        },
         {
             "name": "largeExecPool";
             "serialization": "bytemuckunsafe";
@@ -11655,6 +11715,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 +11780,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.
@@ -11919,6 +11996,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 lutIndex - The index of the lookup table (defaults to 0).
+ * @returns The derived address lookup table public key.
+ */
+declare function getLookupTableAddress(mxeProgramId: PublicKey, lutIndex?: number): 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 };

package/build/index.mjs

@@ -8,7 +8,7 @@ import { Program, EventManager } from '@coral-xyz/anchor';
 import { randomBytes as randomBytes$1 } from '@noble/hashes/utils';
 import { twistedEdwards } from '@noble/curves/abstract/edwards';
 import fs from 'fs';
-import { PublicKey } from '@solana/web3.js';
+import { PublicKey, AddressLookupTableProgram } from '@solana/web3.js';
 
 /**
  * Scalar field prime modulus for Curve25519: 2^252 + 27742317777372353535851937790883648493
@@ -1790,7 +1790,7 @@ function createPacker(fields, typeName = 'Packer') {
 var address = "Arcj82pX7HxYKLR92qvgZUAd7vGS1k4hQvAFcPATFdEQ";
 var metadata = {
 	name: "arcium",
-	version: "0.6.5",
+	version: "0.6.6",
 	spec: "0.1.0",
 	description: "The Arcium program"
 };
@@ -4046,6 +4046,29 @@ var instructions = [
 					]
 				}
 			},
+			{
+				name: "cluster_acc",
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								67,
+								108,
+								117,
+								115,
+								116,
+								101,
+								114
+							]
+						},
+						{
+							kind: "arg",
+							path: "cluster_offset"
+						}
+					]
+				}
+			},
 			{
 				name: "executing_pool",
 				writable: true,
@@ -4134,6 +4157,17 @@ var instructions = [
 			{
 				name: "callback_transaction_index",
 				type: "u8"
+			},
+			{
+				name: "bls_sig",
+				type: {
+					option: {
+						array: [
+							"u8",
+							64
+						]
+					}
+				}
 			}
 		]
 	},
@@ -5225,6 +5259,17 @@ var instructions = [
 					]
 				}
 			},
+			{
+				name: "address_lookup_table",
+				docs: [
+					"Seeds are checked in the CPI to LUT program, so no need to check them here."
+				],
+				writable: true
+			},
+			{
+				name: "lut_program",
+				address: "AddressLookupTab1e1111111111111111111111111"
+			},
 			{
 				name: "comp_def_acc",
 				writable: true,
@@ -5339,6 +5384,11 @@ var instructions = [
 			224
 		],
 		accounts: [
+			{
+				name: "authority",
+				writable: true,
+				signer: true
+			},
 			{
 				name: "payer",
 				writable: true,
@@ -6136,6 +6186,17 @@ var instructions = [
 					]
 				}
 			},
+			{
+				name: "address_lookup_table",
+				docs: [
+					"Seeds are checked in the CPI to LUT program, so no need to check them here."
+				],
+				writable: true
+			},
+			{
+				name: "lut_program",
+				address: "AddressLookupTab1e1111111111111111111111111"
+			},
 			{
 				name: "clock",
 				writable: true,
@@ -7118,12 +7179,6 @@ var instructions = [
 				name: "mxe_program",
 				type: "pubkey"
 			},
-			{
-				name: "callback_url",
-				type: {
-					option: "string"
-				}
-			},
 			{
 				name: "custom_callback_instructions",
 				type: {
@@ -7514,16 +7569,16 @@ var instructions = [
 		]
 	},
 	{
-		name: "reclaim_failure_rent",
+		name: "reclaim_failure_rent_idempotent",
 		discriminator: [
-			159,
-			99,
-			116,
-			180,
-			42,
-			9,
-			202,
-			219
+			138,
+			13,
+			253,
+			191,
+			226,
+			239,
+			246,
+			10
 		],
 		accounts: [
 			{
@@ -7531,51 +7586,19 @@ var instructions = [
 				writable: true,
 				signer: true
 			},
+			{
+				name: "recipient",
+				docs: [
+					"failure PDA"
+				],
+				writable: true
+			},
 			{
 				name: "failure_acc",
-				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: "mxe_program"
-						},
-						{
-							kind: "arg",
-							path: "comp_offset"
-						}
-					]
-				}
+				docs: [
+					"the checks and close by hand in the instruction handler."
+				],
+				writable: true
 			}
 		],
 		args: [
@@ -9672,6 +9695,19 @@ var events = [
 			186
 		]
 	},
+	{
+		name: "KeyRecoveryEvent",
+		discriminator: [
+			83,
+			147,
+			226,
+			153,
+			39,
+			242,
+			109,
+			254
+		]
+	},
 	{
 		name: "QueueComputationEvent",
 		discriminator: [
@@ -9812,6 +9848,11 @@ var errors = [
 		name: "InvalidCallbackIndex",
 		msg: "Invalid callback transaction index"
 	},
+	{
+		code: 6212,
+		name: "MultiTxCallbacksDisabled",
+		msg: "Multi-transaction callbacks disabled"
+	},
 	{
 		code: 6300,
 		name: "ComputationDefinitionNotCompleted",
@@ -10131,6 +10172,11 @@ var errors = [
 		code: 6715,
 		name: "ArithmeticOverflow",
 		msg: "Arithmetic overflow"
+	},
+	{
+		code: 6716,
+		name: "MxeInRecoveryState",
+		msg: "MXE is in recovery state, cannot queue new computations"
 	}
 ];
 var types = [
@@ -10973,12 +11019,6 @@ var types = [
 						}
 					}
 				},
-				{
-					name: "callback_url",
-					type: {
-						option: "string"
-					}
-				},
 				{
 					name: "custom_callback_instructions",
 					type: {
@@ -11458,6 +11498,26 @@ var types = [
 			]
 		}
 	},
+	{
+		name: "KeyRecoveryEvent",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "computation_offset",
+					type: "u64"
+				},
+				{
+					name: "mxe_program_id",
+					type: "pubkey"
+				},
+				{
+					name: "backup_mxe_program_id",
+					type: "pubkey"
+				}
+			]
+		}
+	},
 	{
 		name: "LargeExecPool",
 		serialization: "bytemuckunsafe",
@@ -13036,6 +13096,11 @@ const RECOVERY_CLUSTER_ACC_SEED = 'RecoveryClusterAccount';
  * @constant {string}
  */
 const MXE_RECOVERY_ACC_SEED = 'MxeRecoveryAccount';
+/**
+ * Seed for ComputationDefinitionRaw PDA
+ * @constant {string}
+ */
+const RAW_CIRCUIT_ACC_SEED = 'ComputationDefinitionRaw';
 /**
  * Maximum number of bytes that can be reallocated per instruction.
  * @constant {number}
@@ -13195,6 +13260,32 @@ function getMxeRecoveryAccAddress(backupMxeProgramId, originalMxeProgramId) {
     ];
     return generateArciumPDAFrom(seeds)[0];
 }
+/**
+ * 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.
+ */
+function getRawCircuitAccAddress(compDefPubkey, rawCircuitIndex) {
+    const seeds = [
+        Buffer.from(RAW_CIRCUIT_ACC_SEED),
+        compDefPubkey.toBuffer(),
+        Buffer.from([rawCircuitIndex]),
+    ];
+    return generateArciumPDAFrom(seeds)[0];
+}
+/**
+ * Derives the address lookup table address for an MXE program.
+ * @param mxeProgramId - The public key of the MXE program.
+ * @param lutIndex - The index of the lookup table (defaults to 0).
+ * @returns The derived address lookup table public key.
+ */
+function getLookupTableAddress(mxeProgramId, lutIndex = 0) {
+    const mxeAccount = getMXEAccAddress(mxeProgramId);
+    const lutIndexBuffer = new anchor.BN(lutIndex).toArrayLike(Buffer, 'le', 8);
+    const seeds = [mxeAccount.toBuffer(), lutIndexBuffer];
+    return PublicKey.findProgramAddressSync(seeds, AddressLookupTableProgram.programId)[0];
+}
 /**
  * Generates a program-derived address (PDA) from the provided seeds and the Arcium program ID.
  * @param seeds - An array of Buffer seeds used for PDA derivation.
@@ -13447,6 +13538,21 @@ async function getMXEPublicKey(provider, mxeProgramId) {
 async function getMXEArcisEd25519VerifyingKey(provider, mxeProgramId) {
     return getMXEUtilityKey(provider, mxeProgramId, 'ed25519VerifyingKey');
 }
+/**
+ * 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.
+ */
+function getCircuitState(circuitSource) {
+    if (!('onChain' in circuitSource) || !circuitSource.onChain) {
+        return 'Offchain';
+    }
+    if (circuitSource.onChain[0].isCompleted) {
+        return 'OnchainFinalized';
+    }
+    return 'OnchainPending';
+}
 /**
  * Uploads a circuit to the blockchain, splitting it into multiple accounts if necessary.
  * @param provider - The Anchor provider to use for transactions.
@@ -13458,10 +13564,17 @@ async function getMXEArcisEd25519VerifyingKey(provider, mxeProgramId) {
  * @returns An array of transaction signatures for all upload and finalize transactions.
  */
 async function uploadCircuit(provider, circuitName, mxeProgramId, rawCircuit, logging = true, chunkSize = 500) {
-    // 9 = 8-byte discriminator + 1-byte bump for ComputationDefinitionRaw account
-    const numAccs = Math.ceil(rawCircuit.length / (MAX_ACCOUNT_SIZE - 9));
     const compDefAccInfo = getCompDefAccInfo(circuitName, mxeProgramId);
     const program = getArciumProgram(provider);
+    const compDefAcc = await program.account.computationDefinitionAccount.fetch(compDefAccInfo.pubkey);
+    // Type assertion at boundary where Anchor's fetch() returns the account data
+    const state = getCircuitState(compDefAcc.circuitSource);
+    if (state !== 'OnchainPending') {
+        optionalLog(logging, `Circuit ${circuitName} skipped: ${state}`);
+        return [];
+    }
+    // 9 = 8-byte discriminator + 1-byte bump for ComputationDefinitionRaw account
+    const numAccs = Math.ceil(rawCircuit.length / (MAX_ACCOUNT_SIZE - 9));
     const sigs = [];
     const uploadPromises = [];
     for (let i = 0; i < numAccs; i++) {
@@ -13504,15 +13617,26 @@ async function buildFinalizeCompDefTx(provider, compDefOffset, mxeProgramId) {
         .transaction();
 }
 async function uploadToCircuitAcc(provider, program, rawCircuitPart, rawCircuitIndex, compDefAccInfo, mxeProgramId, shouldLog = true, chunkSize = 500) {
+    const rawCircuitPda = getRawCircuitAccAddress(compDefAccInfo.pubkey, rawCircuitIndex);
+    const existingAcc = await provider.connection.getAccountInfo(rawCircuitPda);
+    // Skip entirely if account exists with correct size (pre-seeded at genesis or already uploaded)
+    // Account layout: 8-byte discriminator + 1-byte bump + circuit data
+    const requiredAccountSize = rawCircuitPart.length + 9;
+    if (existingAcc !== null && existingAcc.data.length >= requiredAccountSize) {
+        optionalLog(shouldLog, `Raw circuit acc ${rawCircuitIndex} already exists with sufficient size, skipping`);
+        return [];
+    }
     const sigs = [];
-    const initTx = await program.methods
-        .initRawCircuitAcc(compDefAccInfo.offset, mxeProgramId, rawCircuitIndex)
-        .accounts({
-        signer: provider.publicKey,
-    })
-        .rpc();
-    optionalLog(shouldLog, `Initiated raw circuit acc with raw circuit index ${rawCircuitIndex}`);
-    sigs.push(initTx);
+    if (existingAcc === null) {
+        const initTx = await program.methods
+            .initRawCircuitAcc(compDefAccInfo.offset, mxeProgramId, rawCircuitIndex)
+            .accounts({
+            signer: provider.publicKey,
+        })
+            .rpc();
+        optionalLog(shouldLog, `Initiated raw circuit acc with raw circuit index ${rawCircuitIndex}`);
+        sigs.push(initTx);
+    }
     if (rawCircuitPart.length > MAX_REALLOC_PER_IX) {
         // We only need to add size if the init didn't already make us big enough
         const nonAsyncTxCount = Math.ceil(rawCircuitPart.length / (MAX_REALLOC_PER_IX * MAX_EMBIGGEN_IX_PER_TX));
@@ -13537,8 +13661,10 @@ async function uploadToCircuitAcc(provider, program, rawCircuitPart, rawCircuitI
     const blockInfo = await provider.connection.getLatestBlockhash();
     for (let i = 0; i < remainingTxCount; i += chunkSize) {
         optionalLog(shouldLog, `Sending chunk ${i / chunkSize + 1} of ${Math.ceil(remainingTxCount / chunkSize)}`);
-        const chunkPromises = []; // Array to hold promises for the current chunk
-        const currentChunkSize = Math.min(chunkSize, remainingTxCount - i); // Handle the last chunk
+        // Array to hold promises for the current chunk
+        const chunkPromises = [];
+        // Handle the last chunk
+        const currentChunkSize = Math.min(chunkSize, remainingTxCount - i);
         for (let j = 0; j < currentChunkSize; j++) {
             const offset = MAX_UPLOAD_PER_TX_BYTES * (i + j);
             // eslint-disable-next-line no-await-in-loop
@@ -13548,7 +13674,8 @@ async function uploadToCircuitAcc(provider, program, rawCircuitPart, rawCircuitI
         // Wait for the current chunk to complete before proceeding
         // eslint-disable-next-line no-await-in-loop
         const chunkResults = await Promise.all(chunkPromises);
-        remainingTxs.push(...chunkResults); // Add the results of the current chunk to the main array
+        // Add the results of the current chunk to the main array
+        remainingTxs.push(...chunkResults);
         optionalLog(shouldLog, `Done sending chunk ${i / chunkSize + 1} of ${Math.ceil(remainingTxCount / chunkSize)}`);
     }
     return sigs.concat(remainingTxs);
@@ -13798,6 +13925,7 @@ async function initMxePart2(provider, clusterOffset, mxeProgramId, recoveryPeers
         mxeProgram: mxeProgramId,
         poolAccount: getFeePoolAccAddress(),
         mxeAuthority: mxeAuthority ?? provider.publicKey,
+        addressLookupTable: getLookupTableAddress(mxeProgramId),
     })
         .transaction();
     return signAndSendWithBlockhash(provider, tx, await provider.connection.getLatestBlockhash({ commitment: 'confirmed' }));
@@ -13861,4 +13989,4 @@ async function awaitEvent(eventListener, eventName, eventCheck, commitment = 'co
     return { event: foundEvent[0], sig: foundEvent[1] };
 }
 
-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 { 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcium-hq/client",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "description": "Client SDK for interacting with encrypted Solana programs",
   "author": "Arcium",
   "license": "GPL-3.0-only",