@zcomb/programs-sdk 1.1.0 → 1.3.0

package/dist/futarchy/client.d.ts

@@ -189,6 +189,7 @@ export declare class FutarchyClient {
                 "signer": true;
             }, {
                 "name": "moderator";
+                "writable": true;
                 "pda": {
                     "seeds": [{
                         "kind": "const";
@@ -253,6 +254,7 @@ export declare class FutarchyClient {
             signer: true;
         } | {
             name: "moderator";
+            writable: true;
             pda: {
                 "seeds": [{
                     "kind": "const";
@@ -484,6 +486,26 @@ export declare class FutarchyClient {
             address: "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
         }>;
     }>;
+    /**
+     * Pre-creates all conditional token ATAs for a user before launching a proposal.
+     *
+     * This is REQUIRED for proposals with 3+ options to avoid exceeding Solana's
+     * max instruction trace length limit (64 instructions). The vault's deposit CPI
+     * creates ATAs on-the-fly, each requiring 5 inner instructions. For 4 options:
+     * 8 ATAs × 5 = 40 extra instructions, pushing the total over 64.
+     *
+     * Pre-creating ATAs eliminates this overhead, reducing the trace to ~32 instructions.
+     *
+     * @param creator - The user who will receive conditional tokens
+     * @param proposalPda - The proposal PDA (must be initialized but not launched)
+     * @returns Transaction signature
+     */
+    ensureConditionalATAs(creator: PublicKey, proposalPda: PublicKey): Promise<string>;
+    /**
+     * Internal helper to create conditional ATAs given mint arrays.
+     * Used by both ensureConditionalATAs and launchProposal to avoid redundant fetches.
+     */
+    private _createConditionalATAs;
     finalizeProposal(signer: PublicKey, proposalPda: PublicKey, options?: TxOptions): Promise<{
         builder: import("@coral-xyz/anchor/dist/cjs/program/namespace/methods").MethodsBuilder<Futarchy, {
             name: "finalizeProposal";
@@ -647,12 +669,43 @@ export declare class FutarchyClient {
             name: "systemProgram";
             address: "11111111111111111111111111111111";
         }>;
+        numOptions: number;
+    }>;
+    /**
+     * Creates an Address Lookup Table for redemption operations.
+     * Required for proposals with 3+ options to avoid exceeding transaction size limits.
+     *
+     * @param creator - The user redeeming (creator of proposal or liquidity provider)
+     * @param proposalPda - The proposal PDA
+     * @returns ALT address
+     */
+    createRedemptionALT(creator: PublicKey, proposalPda: PublicKey): Promise<{
+        altAddress: PublicKey;
+    }>;
+    /**
+     * Builds a versioned transaction for redeeming liquidity with ALT.
+     * Required for proposals with 3+ options to avoid exceeding transaction size limits.
+     *
+     * @param creator - The user redeeming
+     * @param proposalPda - The proposal PDA
+     * @param altAddress - Optional ALT address (will be created if not provided for 3+ options)
+     * @returns Unsigned versioned transaction, ALT address, and number of options
+     */
+    redeemLiquidityVersioned(creator: PublicKey, proposalPda: PublicKey, altAddress?: PublicKey): Promise<{
+        versionedTx: VersionedTransaction;
+        altAddress: PublicKey;
+        numOptions: number;
     }>;
+    /**
+     * Helper to send a signed versioned transaction.
+     */
+    sendVersionedTransaction(signedTx: VersionedTransaction): Promise<string>;
     createProposalALT(creator: PublicKey, moderatorPda: PublicKey, numOptions?: number): Promise<{
         altAddress: PublicKey;
     }>;
     fetchALT(altAddress: PublicKey): Promise<AddressLookupTableAccount>;
     buildVersionedTx(payer: PublicKey, instructions: TransactionInstruction[], altAddress: PublicKey): Promise<VersionedTransaction>;
+    buildVersionedTxWithALT(payer: PublicKey, instructions: TransactionInstruction[], alt: AddressLookupTableAccount, blockhash: string): VersionedTransaction;
     deriveMintCreateKeyPDA(daoPda: PublicKey, name: string): [PublicKey, number];
     private fetchSquadsProgramConfig;
     private deriveMultisigPda;
@@ -1086,302 +1139,4 @@ export declare class FutarchyClient {
         daoPda: PublicKey;
         moderatorPda: PublicKey;
     }>;
-    createProposal(creator: PublicKey, moderatorPda: PublicKey, proposalParams: ProposalParams, baseAmount: BN | number, quoteAmount: BN | number, numOptions?: number, metadata?: string, options?: TxOptions): Promise<{
-        altAddress: PublicKey;
-        proposalPda: PublicKey;
-        proposalId: number;
-        vaultPda: PublicKey;
-        pools: PublicKey[];
-        condBaseMints: PublicKey[];
-        condQuoteMints: PublicKey[];
-        initializeBuilder: import("@coral-xyz/anchor/dist/cjs/program/namespace/methods").MethodsBuilder<Futarchy, {
-            name: "initializeProposal";
-            discriminator: [50, 73, 156, 98, 129, 149, 21, 158];
-            accounts: [{
-                "name": "creator";
-                "writable": true;
-                "signer": true;
-            }, {
-                "name": "moderator";
-                "pda": {
-                    "seeds": [{
-                        "kind": "const";
-                        "value": [109, 111, 100, 101, 114, 97, 116, 111, 114];
-                    }, {
-                        "kind": "account";
-                        "path": "moderator.name";
-                        "account": "moderatorAccount";
-                    }];
-                };
-            }, {
-                "name": "proposal";
-                "writable": true;
-                "pda": {
-                    "seeds": [{
-                        "kind": "const";
-                        "value": [112, 114, 111, 112, 111, 115, 97, 108];
-                    }, {
-                        "kind": "account";
-                        "path": "moderator";
-                    }, {
-                        "kind": "account";
-                        "path": "moderator.proposal_id_counter";
-                        "account": "moderatorAccount";
-                    }];
-                };
-            }, {
-                "name": "systemProgram";
-                "address": "11111111111111111111111111111111";
-            }, {
-                "name": "vaultProgram";
-                "address": "VLTEetGyPKtffi1u3Jr8btWATv33NeDyUuRsPENFPTU";
-            }, {
-                "name": "ammProgram";
-                "address": "AMMSgtnttAKx5Ad2Y1socKJ3CcQYCB2ctg8U2SAHcVEx";
-            }, {
-                "name": "tokenProgram";
-                "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
-            }, {
-                "name": "associatedTokenProgram";
-                "address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
-            }];
-            args: [{
-                "name": "proposalParams";
-                "type": {
-                    "defined": {
-                        "name": "proposalParams";
-                    };
-                };
-            }, {
-                "name": "metadata";
-                "type": {
-                    "option": "string";
-                };
-            }];
-            returns: "u16";
-        } & {
-            name: "initializeProposal";
-        }, {
-            name: "creator";
-            writable: true;
-            signer: true;
-        } | {
-            name: "moderator";
-            pda: {
-                "seeds": [{
-                    "kind": "const";
-                    "value": [109, 111, 100, 101, 114, 97, 116, 111, 114];
-                }, {
-                    "kind": "account";
-                    "path": "moderator.name";
-                    "account": "moderatorAccount";
-                }];
-            };
-        } | {
-            name: "proposal";
-            writable: true;
-            pda: {
-                "seeds": [{
-                    "kind": "const";
-                    "value": [112, 114, 111, 112, 111, 115, 97, 108];
-                }, {
-                    "kind": "account";
-                    "path": "moderator";
-                }, {
-                    "kind": "account";
-                    "path": "moderator.proposal_id_counter";
-                    "account": "moderatorAccount";
-                }];
-            };
-        } | {
-            name: "systemProgram";
-            address: "11111111111111111111111111111111";
-        } | {
-            name: "vaultProgram";
-            address: "VLTEetGyPKtffi1u3Jr8btWATv33NeDyUuRsPENFPTU";
-        } | {
-            name: "ammProgram";
-            address: "AMMSgtnttAKx5Ad2Y1socKJ3CcQYCB2ctg8U2SAHcVEx";
-        } | {
-            name: "tokenProgram";
-            address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
-        } | {
-            name: "associatedTokenProgram";
-            address: "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
-        }>;
-        addOptionBuilders: import("@coral-xyz/anchor/dist/cjs/program/namespace/methods").MethodsBuilder<Futarchy, {
-            name: "addOption";
-            discriminator: [229, 150, 102, 127, 99, 5, 34, 196];
-            accounts: [{
-                "name": "creator";
-                "writable": true;
-                "signer": true;
-            }, {
-                "name": "proposal";
-                "writable": true;
-                "pda": {
-                    "seeds": [{
-                        "kind": "const";
-                        "value": [112, 114, 111, 112, 111, 115, 97, 108];
-                    }, {
-                        "kind": "account";
-                        "path": "proposal.moderator";
-                        "account": "proposalAccount";
-                    }, {
-                        "kind": "account";
-                        "path": "proposal.id";
-                        "account": "proposalAccount";
-                    }];
-                };
-            }, {
-                "name": "systemProgram";
-                "address": "11111111111111111111111111111111";
-            }, {
-                "name": "vaultProgram";
-                "address": "VLTEetGyPKtffi1u3Jr8btWATv33NeDyUuRsPENFPTU";
-            }, {
-                "name": "ammProgram";
-                "address": "AMMSgtnttAKx5Ad2Y1socKJ3CcQYCB2ctg8U2SAHcVEx";
-            }, {
-                "name": "tokenProgram";
-                "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
-            }, {
-                "name": "associatedTokenProgram";
-                "address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
-            }];
-            args: [];
-        } & {
-            name: "addOption";
-        }, {
-            name: "creator";
-            writable: true;
-            signer: true;
-        } | {
-            name: "proposal";
-            writable: true;
-            pda: {
-                "seeds": [{
-                    "kind": "const";
-                    "value": [112, 114, 111, 112, 111, 115, 97, 108];
-                }, {
-                    "kind": "account";
-                    "path": "proposal.moderator";
-                    "account": "proposalAccount";
-                }, {
-                    "kind": "account";
-                    "path": "proposal.id";
-                    "account": "proposalAccount";
-                }];
-            };
-        } | {
-            name: "systemProgram";
-            address: "11111111111111111111111111111111";
-        } | {
-            name: "vaultProgram";
-            address: "VLTEetGyPKtffi1u3Jr8btWATv33NeDyUuRsPENFPTU";
-        } | {
-            name: "ammProgram";
-            address: "AMMSgtnttAKx5Ad2Y1socKJ3CcQYCB2ctg8U2SAHcVEx";
-        } | {
-            name: "tokenProgram";
-            address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
-        } | {
-            name: "associatedTokenProgram";
-            address: "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
-        }>[];
-        launchBuilder: import("@coral-xyz/anchor/dist/cjs/program/namespace/methods").MethodsBuilder<Futarchy, {
-            name: "launchProposal";
-            discriminator: [16, 211, 189, 119, 245, 72, 0, 229];
-            accounts: [{
-                "name": "creator";
-                "writable": true;
-                "signer": true;
-            }, {
-                "name": "proposal";
-                "writable": true;
-                "pda": {
-                    "seeds": [{
-                        "kind": "const";
-                        "value": [112, 114, 111, 112, 111, 115, 97, 108];
-                    }, {
-                        "kind": "account";
-                        "path": "proposal.moderator";
-                        "account": "proposalAccount";
-                    }, {
-                        "kind": "account";
-                        "path": "proposal.id";
-                        "account": "proposalAccount";
-                    }];
-                };
-            }, {
-                "name": "vault";
-                "writable": true;
-                "relations": ["proposal"];
-            }, {
-                "name": "systemProgram";
-                "address": "11111111111111111111111111111111";
-            }, {
-                "name": "vaultProgram";
-                "address": "VLTEetGyPKtffi1u3Jr8btWATv33NeDyUuRsPENFPTU";
-            }, {
-                "name": "ammProgram";
-                "address": "AMMSgtnttAKx5Ad2Y1socKJ3CcQYCB2ctg8U2SAHcVEx";
-            }, {
-                "name": "tokenProgram";
-                "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
-            }, {
-                "name": "associatedTokenProgram";
-                "address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
-            }];
-            args: [{
-                "name": "baseAmount";
-                "type": "u64";
-            }, {
-                "name": "quoteAmount";
-                "type": "u64";
-            }];
-        } & {
-            name: "launchProposal";
-        }, {
-            name: "creator";
-            writable: true;
-            signer: true;
-        } | {
-            name: "proposal";
-            writable: true;
-            pda: {
-                "seeds": [{
-                    "kind": "const";
-                    "value": [112, 114, 111, 112, 111, 115, 97, 108];
-                }, {
-                    "kind": "account";
-                    "path": "proposal.moderator";
-                    "account": "proposalAccount";
-                }, {
-                    "kind": "account";
-                    "path": "proposal.id";
-                    "account": "proposalAccount";
-                }];
-            };
-        } | {
-            name: "vault";
-            writable: true;
-            relations: ["proposal"];
-        } | {
-            name: "systemProgram";
-            address: "11111111111111111111111111111111";
-        } | {
-            name: "vaultProgram";
-            address: "VLTEetGyPKtffi1u3Jr8btWATv33NeDyUuRsPENFPTU";
-        } | {
-            name: "ammProgram";
-            address: "AMMSgtnttAKx5Ad2Y1socKJ3CcQYCB2ctg8U2SAHcVEx";
-        } | {
-            name: "tokenProgram";
-            address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
-        } | {
-            name: "associatedTokenProgram";
-            address: "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
-        }>;
-    }>;
 }