@perena/vault-sdk 1.0.38 → 1.0.40

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { address } from '@solana/kit';
 import * as _solana_web3_js from '@solana/web3.js';
 import { PublicKey, Connection, AccountMeta, Keypair, SimulatedTransactionResponse, Transaction, TransactionInstruction } from '@solana/web3.js';
 import * as _anchor_lang_core from '@anchor-lang/core';
-import { Program, IdlAccounts, BN, AnchorProvider } from '@anchor-lang/core';
+import { IdlAccounts, Program, BN, AnchorProvider } from '@anchor-lang/core';
 import { AssociatedTokenSeeds } from '@solana-program/token';
 
 /** Bankineco program id (local). Hosts new vault instructions. */
@@ -112,6 +112,71 @@ type Bankineco = {
             ];
             "args": [];
         },
+        {
+            "name": "addIncentiveRecipient";
+            "discriminator": [
+                123,
+                176,
+                195,
+                92,
+                173,
+                15,
+                58,
+                43
+            ];
+            "accounts": [
+                {
+                    "name": "curator";
+                    "signer": true;
+                },
+                {
+                    "name": "vault";
+                    "writable": true;
+                },
+                {
+                    "name": "incentive";
+                    "writable": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "wallet";
+                    "type": "pubkey";
+                }
+            ];
+        },
+        {
+            "name": "cancelIncentiveProposal";
+            "discriminator": [
+                130,
+                245,
+                210,
+                51,
+                150,
+                220,
+                58,
+                96
+            ];
+            "accounts": [
+                {
+                    "name": "authority";
+                    "signer": true;
+                },
+                {
+                    "name": "vault";
+                },
+                {
+                    "name": "incentive";
+                    "writable": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "roundId";
+                    "type": "u64";
+                }
+            ];
+        },
         {
             "name": "cancelJuniorTrancheWithdraw";
             "discriminator": [
@@ -617,6 +682,73 @@ type Bankineco = {
                 }
             ];
         },
+        {
+            "name": "createIncentive";
+            "discriminator": [
+                201,
+                74,
+                205,
+                206,
+                209,
+                21,
+                152,
+                179
+            ];
+            "accounts": [
+                {
+                    "name": "curator";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "vault";
+                },
+                {
+                    "name": "incentive";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    105,
+                                    110,
+                                    99,
+                                    101,
+                                    110,
+                                    116,
+                                    105,
+                                    118,
+                                    101
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault";
+                            },
+                            {
+                                "kind": "arg";
+                                "path": "args.id";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [
+                {
+                    "name": "args";
+                    "type": {
+                        "defined": {
+                            "name": "createIncentiveArgs";
+                        };
+                    };
+                }
+            ];
+        },
         {
             "name": "createVault";
             "discriminator": [
@@ -788,6 +920,41 @@ type Bankineco = {
             ];
             "args": [];
         },
+        {
+            "name": "distributeIncentive";
+            "discriminator": [
+                172,
+                211,
+                121,
+                130,
+                226,
+                29,
+                17,
+                199
+            ];
+            "accounts": [
+                {
+                    "name": "cranker";
+                    "signer": true;
+                },
+                {
+                    "name": "vault";
+                    "writable": true;
+                },
+                {
+                    "name": "incentive";
+                    "writable": true;
+                },
+                {
+                    "name": "shareMint";
+                    "writable": true;
+                },
+                {
+                    "name": "shareTokenProgram";
+                }
+            ];
+            "args": [];
+        },
         {
             "name": "executeDeposit";
             "discriminator": [
@@ -5814,6 +5981,43 @@ type Bankineco = {
                 }
             ];
         },
+        {
+            "name": "setIncentiveLimits";
+            "discriminator": [
+                22,
+                243,
+                182,
+                1,
+                240,
+                9,
+                174,
+                175
+            ];
+            "accounts": [
+                {
+                    "name": "curator";
+                    "signer": true;
+                },
+                {
+                    "name": "vault";
+                    "writable": true;
+                },
+                {
+                    "name": "incentive";
+                    "writable": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "maxTotalShares";
+                    "type": "u64";
+                },
+                {
+                    "name": "minSurplusReserve";
+                    "type": "u64";
+                }
+            ];
+        },
         {
             "name": "setManagerWithdrawDestination";
             "discriminator": [
@@ -5829,6 +6033,10 @@ type Bankineco = {
             "accounts": [
                 {
                     "name": "curator";
+                    "docs": [
+                        "Curator for staging/replacing/clearing a destination, or fulfiller for",
+                        "confirming an exact pending destination after its timelock expires."
+                    ];
                     "signer": true;
                 },
                 {
@@ -5909,6 +6117,10 @@ type Bankineco = {
             "accounts": [
                 {
                     "name": "curator";
+                    "docs": [
+                        "Curator for configuration changes, or fulfiller when settling expired",
+                        "pending role updates with an otherwise empty config update."
+                    ];
                     "signer": true;
                 },
                 {
@@ -5931,6 +6143,63 @@ type Bankineco = {
                 }
             ];
         },
+        {
+            "name": "submitIncentive";
+            "discriminator": [
+                254,
+                156,
+                245,
+                213,
+                133,
+                22,
+                132,
+                222
+            ];
+            "accounts": [
+                {
+                    "name": "oracle";
+                    "signer": true;
+                },
+                {
+                    "name": "vault";
+                    "writable": true;
+                },
+                {
+                    "name": "incentive";
+                    "writable": true;
+                },
+                {
+                    "name": "vaultOracle";
+                    "writable": true;
+                },
+                {
+                    "name": "shareMint";
+                },
+                {
+                    "name": "vaultTrancheState";
+                    "writable": true;
+                    "optional": true;
+                },
+                {
+                    "name": "juniorTrancheShareMint";
+                    "optional": true;
+                },
+                {
+                    "name": "seniorTrancheShareMint";
+                    "optional": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "args";
+                    "type": {
+                        "defined": {
+                            "name": "submitIncentiveArgs";
+                        };
+                    };
+                }
+            ];
+        },
         {
             "name": "updateAssetPrice";
             "discriminator": [
@@ -6048,6 +6317,10 @@ type Bankineco = {
             "accounts": [
                 {
                     "name": "curator";
+                    "docs": [
+                        "Curator for staging/replacing a signer set, or fulfiller for confirming",
+                        "the exact pending signer set after its timelock expires."
+                    ];
                     "signer": true;
                 },
                 {
@@ -6413,6 +6686,19 @@ type Bankineco = {
                 119
             ];
         },
+        {
+            "name": "vaultIncentive";
+            "discriminator": [
+                120,
+                176,
+                124,
+                51,
+                97,
+                144,
+                12,
+                50
+            ];
+        },
         {
             "name": "vaultOracle";
             "discriminator": [
@@ -6453,6 +6739,34 @@ type Bankineco = {
             ];
         }
     ];
+    "events": [
+        {
+            "name": "incentiveDistributed";
+            "discriminator": [
+                149,
+                100,
+                29,
+                146,
+                164,
+                197,
+                158,
+                34
+            ];
+        },
+        {
+            "name": "incentiveReserved";
+            "discriminator": [
+                168,
+                145,
+                110,
+                44,
+                228,
+                193,
+                56,
+                235
+            ];
+        }
+    ];
     "errors": [
         {
             "code": 14001;
@@ -6720,8 +7034,8 @@ type Bankineco = {
                     {
                         "name": "maxApyBps";
                         "docs": [
-                            "Maximum annualized APY accepted between oracle NAV updates, in basis",
-                            "points."
+                            "Maximum annualized APY accepted between oracle NAV updates that advance",
+                            "the vault's regular performance-fee high-water mark, in basis points."
                         ];
                         "type": "u16";
                     },
@@ -6984,16 +7298,41 @@ type Bankineco = {
             };
         },
         {
-            "name": "externalLiquiditySlot";
-            "serialization": "bytemuck";
-            "repr": {
-                "kind": "c";
-            };
+            "name": "createIncentiveArgs";
             "type": {
                 "kind": "struct";
                 "fields": [
                     {
-                        "name": "data";
+                        "name": "id";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "recipients";
+                        "type": {
+                            "vec": "pubkey";
+                        };
+                    },
+                    {
+                        "name": "maxTotalShares";
+                        "docs": [
+                            "Lifetime cap across the campaign, including shares already distributed."
+                        ];
+                        "type": "u64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "externalLiquiditySlot";
+            "serialization": "bytemuck";
+            "repr": {
+                "kind": "c";
+            };
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "data";
                         "type": {
                             "array": [
                                 "u8",
@@ -7128,6 +7467,94 @@ type Bankineco = {
                 ];
             };
         },
+        {
+            "name": "incentiveDistributed";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "incentive";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "shares";
+                        "type": "u64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "incentiveRecipient";
+            "serialization": "bytemuck";
+            "repr": {
+                "kind": "c";
+            };
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "wallet";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "oracleTotals";
+                        "docs": [
+                            "Cumulative share amounts proposed by the first two vault oracle slots."
+                        ];
+                        "type": {
+                            "array": [
+                                "u64",
+                                2
+                            ];
+                        };
+                    },
+                    {
+                        "name": "settledTotal";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "distributedTotal";
+                        "type": "u64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "incentiveReserved";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "incentive";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "roundId";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "additionalShares";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "curatorShares";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "surplusValue";
+                        "type": "u64";
+                    }
+                ];
+            };
+        },
         {
             "name": "initializeVaultRolesArgs";
             "type": {
@@ -7871,6 +8298,35 @@ type Bankineco = {
                 ];
             };
         },
+        {
+            "name": "submitIncentiveArgs";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "roundId";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "totals";
+                        "docs": [
+                            "One cumulative share total per active recipient, in registration order."
+                        ];
+                        "type": {
+                            "vec": "u64";
+                        };
+                    },
+                    {
+                        "name": "expiresAt";
+                        "type": "i64";
+                    },
+                    {
+                        "name": "maxSurplusValue";
+                        "type": "u64";
+                    }
+                ];
+            };
+        },
         {
             "name": "timelockState";
             "docs": [
@@ -8300,7 +8756,7 @@ type Bankineco = {
                     {
                         "name": "totalMintSupply";
                         "docs": [
-                            "Effective share supply: physical mint supply plus unminted fee shares."
+                            "Effective share supply: physical mint supply plus all unminted claims."
                         ];
                         "type": "u64";
                     },
@@ -8381,12 +8837,19 @@ type Bankineco = {
                             };
                         };
                     },
+                    {
+                        "name": "pendingIncentiveShares";
+                        "docs": [
+                            "Reserved shares across every incentive PDA. Already in effective supply."
+                        ];
+                        "type": "u64";
+                    },
                     {
                         "name": "padding1";
                         "type": {
                             "array": [
                                 "u64",
-                                22
+                                21
                             ];
                         };
                     },
@@ -8482,12 +8945,19 @@ type Bankineco = {
                         ];
                         "type": "i64";
                     },
+                    {
+                        "name": "incentiveMinSurplusReserve";
+                        "docs": [
+                            "Minimum surplus retained after any incentive reservation, in accounting units."
+                        ];
+                        "type": "u64";
+                    },
                     {
                         "name": "padding3";
                         "type": {
                             "array": [
                                 "u64",
-                                22
+                                21
                             ];
                         };
                     }
@@ -8506,8 +8976,8 @@ type Bankineco = {
                     {
                         "name": "juniorFloorApyBps";
                         "docs": [
-                            "Floor APY for the junior tranche, in basis points. Zero disables the",
-                            "floor. Shortfalls are funded from the untranched sleeve, never senior."
+                            "Fixed-return floor for the junior tranche, in basis points. It is funded",
+                            "only from positive regular-sleeve gains, never senior. Zero disables it."
                         ];
                         "type": "u16";
                     },
@@ -8840,6 +9310,95 @@ type Bankineco = {
                 ];
             };
         },
+        {
+            "name": "vaultIncentive";
+            "docs": [
+                "One reusable campaign. Recipients are append-only; claims never change owners."
+            ];
+            "serialization": "bytemuck";
+            "repr": {
+                "kind": "c";
+            };
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "id";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "roundId";
+                        "docs": [
+                            "Incremented after settlement, cancellation, or recipient/limit changes."
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "expiresAt";
+                        "type": "i64";
+                    },
+                    {
+                        "name": "maxSurplusValue";
+                        "docs": [
+                            "Both reporters must approve this maximum accounting-value surplus debit."
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "maxTotalShares";
+                        "docs": [
+                            "Curator-authorized lifetime share cap across all recipients."
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "recipients";
+                        "type": {
+                            "array": [
+                                {
+                                    "defined": {
+                                        "name": "incentiveRecipient";
+                                    };
+                                },
+                                5
+                            ];
+                        };
+                    },
+                    {
+                        "name": "bump";
+                        "type": "u8";
+                    },
+                    {
+                        "name": "recipientCount";
+                        "type": "u8";
+                    },
+                    {
+                        "name": "submitted";
+                        "docs": [
+                            "Zero-valued reports still set their corresponding bit."
+                        ];
+                        "type": "u8";
+                    },
+                    {
+                        "name": "version";
+                        "type": "u8";
+                    },
+                    {
+                        "name": "padding";
+                        "type": {
+                            "array": [
+                                "u8",
+                                4
+                            ];
+                        };
+                    }
+                ];
+            };
+        },
         {
             "name": "vaultOracle";
             "serialization": "bytemuck";
@@ -9145,15 +9704,14 @@ type Bankineco = {
                             "disables the floor.",
                             "",
                             "When junior's realized growth falls short of this floor, the shortfall is",
-                            "topped up from the *untranched* (regular) sleeve's value, never from the",
-                            "senior tranche -- senior's fixed-APY entitlement is settled first and is",
-                            "untouched by the floor. The top-up is best-effort: it is capped by the",
-                            "untranched sleeve's available value, and any unpaid remainder stays",
-                            "outstanding against the durable junior anchor",
+                            "topped up from the *positive gain* of the untranched (regular) sleeve,",
+                            "never from regular principal or the senior tranche. Senior's fixed-APY",
+                            "entitlement is settled first and is untouched by the floor. The top-up is",
+                            "best-effort: any unpaid remainder stays outstanding against the durable",
+                            "junior anchor",
                             "(`VaultTrancheState::junior_apy_anchor_share_price`) so it can be paid on",
-                            "a later settlement while junior remains at or above its high-water mark.",
-                            "Below that mark the floor is suspended, the accrued shortfall is forgiven,",
-                            "and a fresh prospective floor regime begins only after natural recovery."
+                            "a later positive-NAV settlement. Flat and negative NAV settlements pay",
+                            "nothing but do not reset or forgive the accrued shortfall."
                         ];
                         "type": "u16";
                     },
@@ -9253,8 +9811,8 @@ type Bankineco = {
                         "name": "juniorApyAnchorSharePrice";
                         "docs": [
                             "Junior share price at the start of the current floor-APY regime. The",
-                            "anchor stays fixed while the class is healthy, but resets when junior",
-                            "recovers from a drawdown so floor yield never accrues while underwater."
+                            "anchor stays fixed through gains and losses so unpaid fixed-return",
+                            "shortfalls can carry into later positive-NAV settlements."
                         ];
                         "type": "u64";
                     },
@@ -9268,8 +9826,9 @@ type Bankineco = {
                     {
                         "name": "juniorFloorUnderwater";
                         "docs": [
-                            "Non-zero while junior's post-fee share price is below its high-water",
-                            "mark. During this state the floor is suspended and accrues no arrears."
+                            "Legacy floor-suspension flag retained for account-layout compatibility.",
+                            "The gain-funded floor no longer uses an underwater state and clears this",
+                            "field on settlement."
                         ];
                         "type": "u64";
                     },
@@ -9299,9 +9858,10 @@ type Bankineco = {
                     {
                         "name": "juniorFloorApyBps";
                         "docs": [
-                            "Floor APY for the junior tranche, in basis points. Zero disables the",
-                            "floor. Setting this starts a fresh regime: any shortfall accrued under",
-                            "the previous value is forfeited."
+                            "Fixed-return floor for the junior tranche, in basis points. It is funded",
+                            "only from positive regular-sleeve gains. Zero disables it. Setting this",
+                            "starts a fresh regime: any shortfall accrued under the previous value is",
+                            "forfeited."
                         ];
                         "type": {
                             "option": "u16";
@@ -9639,6 +10199,8 @@ declare abstract class SingleInstructionBuilderService<TContext, TIxArgs, TTxArg
 declare class PdaClient {
     private readonly programAddress;
     constructor(programAddress: Address);
+    /** Seeds: `["incentive", vault, id_u64_le]`. */
+    deriveIncentivePda(vault: Address, id: bigint): Promise<readonly [Address, ProgramDerivedAddressBump]>;
     /**
      * Vault PDA for a global vault id.
      *
@@ -9679,6 +10241,11 @@ declare const VAULT_TRANCHE_STATE_CACHE_CATEGORY = "vault_tranche_state";
 declare const VAULT_TRANCHE_WITHDRAWAL_QUEUE_CACHE_CATEGORY = "vault_tranche_withdrawal_queue";
 /** Decoded on-chain `Vault` account (from generated IDL types). */
 type VaultAccountData = IdlAccounts<Vault>["vault"];
+type VaultIncentiveAccountData = IdlAccounts<Vault>["vaultIncentive"];
+interface VaultIncentiveAccount {
+    publicKey: Address;
+    account: VaultIncentiveAccountData;
+}
 type ExternalLiquiditySlot = VaultAccountData["externalLiquidity"][number];
 type FeeVaultAccountData = IdlAccounts<Vault>["feeVault"];
 type VaultOracleAccountData = IdlAccounts<Vault>["vaultOracle"];
@@ -9690,6 +10257,18 @@ type VaultTrancheWithdrawalQueueAccountData = IdlAccounts<Vault>["vaultWithdrawa
 declare class AccountClient extends BaseAccountClient {
     private readonly program;
     readonly pda: PdaClient;
+    /** Always fresh: callers use the proposal round and cumulative entitlements. */
+    fetchIncentive(incentive: Address): Promise<VaultIncentiveAccountData>;
+    /** Fresh lookup; returns null for missing or uninitialized accounts. */
+    fetchIncentiveNullable(incentive: Address): Promise<VaultIncentiveAccountData | null>;
+    /** Derive the campaign address from its vault and u64 ID, then fetch fresh. */
+    fetchIncentiveForVault(vault: Address, id: bigint): Promise<VaultIncentiveAccountData>;
+    /** Fresh batch lookup preserving input order, duplicates, and missing entries. */
+    fetchIncentives(incentives: Address[]): Promise<(VaultIncentiveAccountData | null)[]>;
+    /** Discover all campaigns for one vault. Results are fresh and unordered. */
+    fetchAllIncentivesForVault(vault: Address): Promise<VaultIncentiveAccount[]>;
+    /** Live on-chain Unix seconds for proposal expiry; never cached or based on block history. */
+    fetchClockUnixTimestamp(): Promise<bigint>;
     constructor(program: Program<Vault>, pda: PdaClient, rpc: Rpc<SolanaRpcApi>);
     fetchVault(vault: Address, opts?: {
         fresh?: boolean;
@@ -9824,6 +10403,7 @@ interface CreateVaultIxArgs {
     vaultOracle: Address;
     feeVault: Address;
     shareMint: Address;
+    shareTokenProgram?: Address;
     assetMint: Address;
     assetTokenProgram: Address;
     params: CreateVaultParams;
@@ -9831,6 +10411,8 @@ interface CreateVaultIxArgs {
 interface CreateVaultTxArgs {
     curator: Address;
     shareMint: Address;
+    /** Defaults to the actual share mint's owning token program. */
+    shareTokenProgram?: Address;
     strictAssetMint: Address;
     vaultId?: number;
     hwManager?: Address;
@@ -10073,10 +10655,10 @@ interface CreateTrancheStateIxArgs {
     vaultOracle?: Address;
     seniorFixedApyBps: number;
     /**
-     * Junior floor APY in basis points. Zero disables the floor. Shortfalls are
-     * funded from the untranched sleeve, never from the senior tranche. The floor
-     * is suspended without arrears while junior is below its high-water mark and
-     * restarts prospectively after natural recovery.
+     * Junior fixed-return floor in basis points. Zero disables it. Shortfalls are
+     * funded only from positive untranched-sleeve gains, never from existing
+     * regular principal or the senior tranche. Unpaid shortfalls carry forward
+     * through flat and negative NAV settlements.
      */
     juniorFloorApyBps: number;
     earlyUnstakeFeeBps: number;
@@ -10093,7 +10675,7 @@ interface CreateTrancheStateTxArgs {
     seniorShareMint: Address;
     vaultOracle?: Address;
     seniorFixedApyBps?: number;
-    /** Junior floor APY in basis points. Zero disables the floor. */
+    /** Junior fixed-return floor in basis points. Zero disables it. */
     juniorFloorApyBps?: number;
     earlyUnstakeFeeBps?: number;
     standardUnstakeFeeBps?: number;
@@ -10126,7 +10708,7 @@ interface UpdateTrancheConfigTxArgs {
     vaultTrancheState?: Address;
     vaultOracle?: Address;
     seniorFixedApyBps?: number;
-    /** Junior floor APY in basis points. Zero disables the floor. */
+    /** Junior fixed-return floor in basis points. Zero disables it. */
     juniorFloorApyBps?: number;
     earlyUnstakeFeeBps?: number;
     standardUnstakeFeeBps?: number;
@@ -10738,6 +11320,104 @@ declare abstract class VaultBuilderBase<TIxArgs, TTxArgs = TIxArgs, TTxPlan exte
     protected get rpc(): _solana_kit.Rpc<_solana_kit.RequestAirdropApi & _solana_kit.GetAccountInfoApi & _solana_kit.GetBalanceApi & _solana_kit.GetBlockApi & _solana_kit.GetBlockCommitmentApi & _solana_kit.GetBlockHeightApi & _solana_kit.GetBlockProductionApi & _solana_kit.GetBlocksApi & _solana_kit.GetBlocksWithLimitApi & _solana_kit.GetBlockTimeApi & _solana_kit.GetClusterNodesApi & _solana_kit.GetEpochInfoApi & _solana_kit.GetEpochScheduleApi & _solana_kit.GetFeeForMessageApi & _solana_kit.GetFirstAvailableBlockApi & _solana_kit.GetGenesisHashApi & _solana_kit.GetHealthApi & _solana_kit.GetHighestSnapshotSlotApi & _solana_kit.GetIdentityApi & _solana_kit.GetInflationGovernorApi & _solana_kit.GetInflationRateApi & _solana_kit.GetInflationRewardApi & _solana_kit.GetLargestAccountsApi & _solana_kit.GetLatestBlockhashApi & _solana_kit.GetLeaderScheduleApi & _solana_kit.GetMaxRetransmitSlotApi & _solana_kit.GetMaxShredInsertSlotApi & _solana_kit.GetMinimumBalanceForRentExemptionApi & _solana_kit.GetMultipleAccountsApi & _solana_kit.GetProgramAccountsApi & _solana_kit.GetRecentPerformanceSamplesApi & _solana_kit.GetRecentPrioritizationFeesApi & _solana_kit.GetSignaturesForAddressApi & _solana_kit.GetSignatureStatusesApi & _solana_kit.GetSlotApi & _solana_kit.GetSlotLeaderApi & _solana_kit.GetSlotLeadersApi & _solana_kit.GetStakeMinimumDelegationApi & _solana_kit.GetSupplyApi & _solana_kit.GetTokenAccountBalanceApi & _solana_kit.GetTokenAccountsByDelegateApi & _solana_kit.GetTokenAccountsByOwnerApi & _solana_kit.GetTokenLargestAccountsApi & _solana_kit.GetTokenSupplyApi & _solana_kit.GetTransactionApi & _solana_kit.GetTransactionCountApi & _solana_kit.GetVersionApi & _solana_kit.GetVoteAccountsApi & _solana_kit.IsBlockhashValidApi & _solana_kit.MinimumLedgerSlotApi & _solana_kit.SendTransactionApi & _solana_kit.SimulateTransactionApi>;
 }
 
+interface CreateIncentiveTxArgs {
+    curator: Address;
+    vault: Address;
+    id: bigint;
+    recipients: Address[];
+    maxTotalShares: bigint;
+}
+interface CreateIncentiveIxArgs extends CreateIncentiveTxArgs {
+    incentive: Address;
+}
+declare class CreateIncentiveBuilder extends VaultBuilderBase<CreateIncentiveIxArgs, CreateIncentiveTxArgs> {
+    getIx(args: CreateIncentiveIxArgs): Promise<_solana_kit.Instruction<string, readonly (_solana_kit.AccountLookupMeta<string, string> | _solana_kit.AccountMeta<string>)[]>>;
+    protected deriveIxArgs(args: CreateIncentiveTxArgs): Promise<CreateIncentiveIxArgs>;
+}
+interface AddIncentiveRecipientArgs {
+    curator: Address;
+    vault: Address;
+    incentive: Address;
+    wallet: Address;
+}
+declare class AddIncentiveRecipientBuilder extends VaultBuilderBase<AddIncentiveRecipientArgs> {
+    getIx(args: AddIncentiveRecipientArgs): Promise<_solana_kit.Instruction<string, readonly (_solana_kit.AccountLookupMeta<string, string> | _solana_kit.AccountMeta<string>)[]>>;
+}
+interface SetIncentiveLimitsArgs {
+    curator: Address;
+    vault: Address;
+    incentive: Address;
+    maxTotalShares: bigint;
+    /** Vault-wide floor, in accounting units, for every campaign's surplus use. */
+    minSurplusReserve: bigint;
+}
+declare class SetIncentiveLimitsBuilder extends VaultBuilderBase<SetIncentiveLimitsArgs> {
+    getIx(args: SetIncentiveLimitsArgs): Promise<_solana_kit.Instruction<string, readonly (_solana_kit.AccountLookupMeta<string, string> | _solana_kit.AccountMeta<string>)[]>>;
+    protected buildPlanExtras(args: SetIncentiveLimitsArgs): Promise<{
+        postSuccessCacheInvalidations: {
+            vaultPda: Address;
+        }[];
+    }>;
+}
+interface SubmitIncentiveTxArgs {
+    oracle: Address;
+    vault: Address;
+    incentive: Address;
+    roundId: bigint;
+    /** Cumulative lifetime totals, one per registered recipient in slot order. */
+    totals: bigint[];
+    expiresAt: bigint;
+    maxSurplusValue: bigint;
+}
+interface SubmitIncentiveIxArgs extends SubmitIncentiveTxArgs {
+    vaultOracle: Address;
+    shareMint: Address;
+    vaultTrancheState: Address | null;
+    juniorTrancheShareMint: Address | null;
+    seniorTrancheShareMint: Address | null;
+}
+declare class SubmitIncentiveBuilder extends VaultBuilderBase<SubmitIncentiveIxArgs, SubmitIncentiveTxArgs> {
+    getIx(args: SubmitIncentiveIxArgs): Promise<_solana_kit.Instruction<string, readonly (_solana_kit.AccountLookupMeta<string, string> | _solana_kit.AccountMeta<string>)[]>>;
+    protected deriveIxArgs(args: SubmitIncentiveTxArgs): Promise<SubmitIncentiveIxArgs>;
+    protected buildPlanExtras(args: SubmitIncentiveIxArgs): Promise<{
+        postSuccessCacheInvalidations: {
+            vaultPda: Address;
+            vaultOraclePda: Address;
+            vaultTrancheStatePda: Address | undefined;
+        }[];
+    }>;
+}
+interface CancelIncentiveProposalArgs {
+    authority: Address;
+    vault: Address;
+    incentive: Address;
+    roundId: bigint;
+}
+declare class CancelIncentiveProposalBuilder extends VaultBuilderBase<CancelIncentiveProposalArgs> {
+    getIx(args: CancelIncentiveProposalArgs): Promise<_solana_kit.Instruction<string, readonly (_solana_kit.AccountLookupMeta<string, string> | _solana_kit.AccountMeta<string>)[]>>;
+}
+interface DistributeIncentiveTxArgs {
+    cranker: Address;
+    vault: Address;
+    incentive: Address;
+}
+interface DistributeIncentiveIxArgs extends DistributeIncentiveTxArgs {
+    shareMint: Address;
+    shareTokenProgram: Address;
+    recipients: Address[];
+    recipientShareAtas: Address[];
+}
+declare class DistributeIncentiveBuilder extends VaultBuilderBase<DistributeIncentiveIxArgs, DistributeIncentiveTxArgs> {
+    getIx(args: DistributeIncentiveIxArgs): Promise<_solana_kit.Instruction<string, readonly (_solana_kit.AccountLookupMeta<string, string> | _solana_kit.AccountMeta<string>)[]>>;
+    protected deriveIxArgs(args: DistributeIncentiveTxArgs): Promise<DistributeIncentiveIxArgs>;
+    protected buildPreambleInstructions(args: DistributeIncentiveIxArgs): Promise<_solana_kit.Instruction<string, readonly (_solana_kit.AccountLookupMeta<string, string> | _solana_kit.AccountMeta<string>)[]>[]>;
+    protected buildPlanExtras(args: DistributeIncentiveIxArgs): Promise<{
+        postSuccessCacheInvalidations: {
+            vaultPda: Address;
+        }[];
+    }>;
+}
+
 declare class CancelJuniorTrancheWithdrawBuilder extends VaultBuilderBase<CancelJuniorTrancheWithdrawIxArgs, CancelJuniorTrancheWithdrawTxArgs> {
     getIx(args: CancelJuniorTrancheWithdrawIxArgs): Promise<_solana_kit.Instruction<string, readonly (_solana_kit.AccountLookupMeta<string, string> | _solana_kit.AccountMeta<string>)[]>>;
     protected deriveIxArgs(txArgs: CancelJuniorTrancheWithdrawTxArgs): Promise<CancelJuniorTrancheWithdrawIxArgs>;
@@ -11267,6 +11947,12 @@ declare class VaultReallocationBuilder extends VaultBuilderBase<VaultReallocatio
 }
 
 declare class TransactionClient {
+    readonly createIncentive: CreateIncentiveBuilder;
+    readonly addIncentiveRecipient: AddIncentiveRecipientBuilder;
+    readonly setIncentiveLimits: SetIncentiveLimitsBuilder;
+    readonly submitIncentive: SubmitIncentiveBuilder;
+    readonly cancelIncentiveProposal: CancelIncentiveProposalBuilder;
+    readonly distributeIncentive: DistributeIncentiveBuilder;
     readonly createVault: CreateVaultBuilder;
     readonly initializeVaultRoles: InitializeVaultRolesBuilder;
     readonly createAssetHolding: CreateAssetHoldingBuilder;
@@ -11420,6 +12106,29 @@ declare function toUiAmount(amount: bigint | number, decimals: number): number;
  */
 declare function fromUiAmount(amount: number, decimals: number): bigint;
 
+/** Maximum number of append-only wallet owners in one campaign. */
+declare const MAX_INCENTIVE_RECIPIENTS = 5;
+/** All amounts are atomic share units, never UI amounts or accounting value. */
+interface IncentiveRecipient {
+    wallet: Address;
+    /** Reports from vault oracle slots 0 and 1; these may still disagree. */
+    oracleTotals: readonly [bigint, bigint];
+    settledTotal: bigint;
+    distributedTotal: bigint;
+    outstandingShares: bigint;
+}
+interface IncentiveTotals {
+    settledShares: bigint;
+    distributedShares: bigint;
+    outstandingShares: bigint;
+}
+/** Active recipients in on-chain registration order, with bigint amounts. */
+declare function getIncentiveRecipients(incentive: VaultIncentiveAccountData): IncentiveRecipient[];
+/** Funded and paid lifetime totals; unagreed oracle reports never count as claims. */
+declare function getIncentiveTotals(incentive: VaultIncentiveAccountData): IncentiveTotals;
+/** Canonical share ATAs for every registered wallet, including zero claims and PDA owners. */
+declare function getIncentiveRecipientShareAtas(incentive: VaultIncentiveAccountData, shareMint: Address, shareTokenProgram: Address): Address[];
+
 declare function makeProvider(connection: Connection, payer: Keypair): AnchorProvider;
 
 declare function createRpcFromConnection(connection: Connection): Rpc<SolanaRpcApi>;
@@ -11509,6 +12218,8 @@ declare function prepareVaultTransaction(args: {
     proposer: PublicKey;
     instructions: readonly TransactionInstruction[];
     squadsRoutes?: readonly SquadsWalletRouteConfig[];
+    /** Skip execution simulation when proposing a transaction that depends on future funding. */
+    skipSimulation?: boolean;
 }): Promise<PreparedVaultTransaction>;
 
 interface CreateTokenMintIxs {
@@ -11792,7 +12503,7 @@ interface FulfillSummary {
     failed: number;
     signatures: string[];
 }
-type LogFn$3 = (msg: string) => void;
+type LogFn$4 = (msg: string) => void;
 declare class WithdrawalQueueService {
     private readonly client;
     constructor(client: VaultClient);
@@ -11820,7 +12531,7 @@ declare class WithdrawalQueueService {
      */
     fulfillAllDue(signer: Keypair, opts?: {
         vault?: Address;
-        log?: LogFn$3;
+        log?: LogFn$4;
     }): Promise<FulfillSummary>;
     private toSnapshot;
 }
@@ -11842,7 +12553,7 @@ declare class WithdrawalQueueService {
  * this service only submits the resulting values on-chain.
  */
 
-type LogFn$2 = (msg: string) => void;
+type LogFn$3 = (msg: string) => void;
 type NavCrankBlockerReason = "unpriced" | "stale";
 interface NavCrankBlocker {
     holdingIndex: number;
@@ -11895,12 +12606,12 @@ declare class OracleService {
         }[];
         assetMint?: Address;
         assetTokenProgram?: Address;
-    }, log?: LogFn$2): Promise<string>;
+    }, log?: LogFn$3): Promise<string>;
     /** Settle the vault NAV from its current holdings (permissionless). */
     crankNav(cranker: Keypair, args: {
         vault: Address;
         vaultTrancheState?: Address;
-    }, log?: LogFn$2): Promise<string>;
+    }, log?: LogFn$3): Promise<string>;
     /**
      * Check the same active-holding price preconditions that `crank_nav` enforces
      * before spending a transaction on the permissionless settlement.
@@ -11910,19 +12621,19 @@ declare class OracleService {
     crankNavIfReady(cranker: Keypair, args: {
         vault: Address;
         vaultTrancheState?: Address;
-    }, log?: LogFn$2): Promise<NavCrankResult>;
+    }, log?: LogFn$3): Promise<NavCrankResult>;
     /** Re-price one live-oracle holding from its bound Pyth/nested-vault account. */
     refreshAssetPrice(updater: Keypair, args: {
         vault: Address;
         mint: Address;
         oracleAccount: Address;
         maxAgeSecs?: bigint;
-    }, log?: LogFn$2): Promise<string>;
+    }, log?: LogFn$3): Promise<string>;
     /**
      * Refresh several holdings in sequence. Non-fatal: one failure is recorded
      * and the rest still run. Returns a per-mint result list.
      */
-    refreshAssetPrices(updater: Keypair, vault: Address, targets: AssetPriceRefreshTarget[], log?: LogFn$2): Promise<AssetRefreshResult[]>;
+    refreshAssetPrices(updater: Keypair, vault: Address, targets: AssetPriceRefreshTarget[], log?: LogFn$3): Promise<AssetRefreshResult[]>;
 }
 
 /**
@@ -12892,9 +13603,9 @@ interface ExternalLiquidityIntegritySummary {
     /** True when rebalances were simulated rather than sent. */
     dryRun: boolean;
 }
-type LogFn$1 = (msg: string) => void;
+type LogFn$2 = (msg: string) => void;
 interface ExternalLiquidityIntegrityOptions {
-    log?: LogFn$1;
+    log?: LogFn$2;
     /** Simulate each rebalance instead of sending it. Nothing is submitted. */
     dryRun?: boolean;
     /**
@@ -12964,7 +13675,7 @@ declare class ExternalLiquidityIntegrityService {
      * Process a single vault: for each active external liquidity slot, move each
      * holding's balance toward the target local/external split.
      */
-    processVault(vault: Address, vaultState: VaultAccountData, hwManager: Keypair, log: LogFn$1, opts?: {
+    processVault(vault: Address, vaultState: VaultAccountData, hwManager: Keypair, log: LogFn$2, opts?: {
         dryRun?: boolean;
         minAmountUi?: number;
         targetLocalBps?: number;
@@ -13012,7 +13723,7 @@ declare const DEFAULT_MAX_ACCOUNTS = 20;
  * reverts with `AssetRebalanceRateLimitExceeded`, so the run is skipped instead.
  */
 declare const ASSET_REBALANCE_COOLDOWN_SECS = 60;
-type LogFn = (msg: string) => void;
+type LogFn$1 = (msg: string) => void;
 /** Why a run did not swap, or that it did. */
 type IdleLiquidityStatus = "swapped" | "simulated" | "above-floor" | "insufficient-pst" | "rebalance-cooldown" | "rebalance-limit" | "missing-holding" | "stale-price" | "no-tvl" | "failed";
 interface IdleLiquidityResult {
@@ -13035,7 +13746,7 @@ interface IdleLiquidityResult {
     signature?: string;
 }
 interface IdleLiquidityOptions {
-    log?: LogFn;
+    log?: LogFn$1;
     /** Simulate the swap and stop; nothing is submitted. */
     dryRun?: boolean;
     /** Jupiter slippage tolerance for the top-up quote. */
@@ -13091,4 +13802,63 @@ declare class IdleLiquidityService {
     private executeSwap;
 }
 
-export { ASSET_DECIMALS, ASSET_REBALANCE_COOLDOWN_SECS, type AccountBalanceResponse, AccountClient, type AccountYieldResponse, ActivateCircuitBreakerBuilder, type ActivateCircuitBreakerIxArgs, type ActivateCircuitBreakerTxArgs, type AddAprCashflowUpdateParams, type AddCashflowUpdateParams, type AddNavCashflowUpdateParams, type AprAccountBalanceResponse, type AprAccountYieldResponse, type AssetPriceOracleConfigIxArgs, type AssetPriceOracleConfigTxArgs, type AssetPriceRefreshTarget, type AssetRefreshResult, type AssetType, BALANCE_CHANGE_BASELINE_MAX_AGE_SECS, type Bankineco, type BasicAuthCredentials, type Bigintish, type BuildMarginfiWithdrawInteractionArgs, CONSENSUS_ORACLE_VARIANT, CancelJuniorTrancheWithdrawBuilder, type CancelJuniorTrancheWithdrawIxArgs, type CancelJuniorTrancheWithdrawTxArgs, type Clock, type CollectSamplesOptions, type ConsensusAssetUpdate, type ConsensusHoldingEntry, type ConsensusHoldingSimulation, type ConsensusOracleDeps, type ConsensusOracleHoldingConfig, ConsensusOracleService, type ConsensusOracleTarget, CrankNavBuilder, type CrankNavIxArgs, type CrankNavTxArgs, CrankPerformanceFeesBuilder, type CrankPerformanceFeesIxArgs, type CrankPerformanceFeesTxArgs, type CreateAccountParams, CreateAssetHoldingBuilder, type CreateAssetHoldingIxArgs, type CreateAssetHoldingTxArgs, type CreateTokenMintIxs, CreateTrancheStateBuilder, type CreateTrancheStateIxArgs, type CreateTrancheStateTxArgs, CreateVaultBuilder, type CreateVaultClientOptions, type CreateVaultIxArgs, type CreateVaultParams, type CreateVaultTxArgs, type CreateYieldPaymentParams, DEFAULT_CU_PRICE_MICRO_LAMPORTS, DEFAULT_JUNIOR_EARLY_UNSTAKE_FEE_BPS, DEFAULT_JUNIOR_STANDARD_UNSTAKE_FEE_BPS, DEFAULT_JUNIOR_WITHDRAWAL_LOCKUP_SECS, DEFAULT_MAX_ACCEPTABLE_APY_BPS, DEFAULT_MAX_ACCOUNTS, DEFAULT_MINTS, DEFAULT_MIN_AMOUNT_UI, DEFAULT_ORACLE_STALENESS_THRESHOLD_SECS, DEFAULT_PRICE_ORACLE_ACCOUNT, DEFAULT_PRICE_STALENESS_SECS, DEFAULT_PRICE_STALENESS_THRESHOLD_SECS, DEFAULT_REBALANCE_BAND_BPS, DEFAULT_SLIPPAGE_BPS, DEFAULT_TARGET_LOCAL_BPS, DEFAULT_VAULT_ID, type DecodedHolding, type DecodedVault, type DecodedVaultTrancheState, type DeleteAccountParams, DisableCircuitBreakerBuilder, type DisableCircuitBreakerIxArgs, type DisableCircuitBreakerTxArgs, EXTERNAL_POSITION_SAMPLES, ExecuteDepositBuilder, type ExecuteDepositIxArgs, type ExecuteDepositTxArgs, ExecuteShareSwapBuilder, type ExecuteShareSwapIxArgs, type ExecuteShareSwapTxArgs, ExecuteTrancheDepositBuilder, type ExecuteTrancheDepositIxArgs, type ExecuteTrancheDepositTxArgs, ExecuteTrancheWithdrawBuilder, type ExecuteTrancheWithdrawIxArgs, type ExecuteTrancheWithdrawTxArgs, ExecuteWithdrawBuilder, type ExecuteWithdrawIxArgs, type ExecuteWithdrawTxArgs, type ExternalLiquidityIntegrityOptions, type ExternalLiquidityIntegrityResult, ExternalLiquidityIntegrityService, type ExternalLiquidityIntegritySummary, type ExternalLiquiditySlot, type ExternalLiquiditySourceArgs, type ExternalPosition, type ExternalPositionContext, type ExternalPositionProvider, type ExternalPositionRef, ExternalPositionRegistry, FEE_VAULT_CACHE_CATEGORY, type FeeVaultAccountData, type FetchNestTokenPriceOptions, FulfillJuniorTrancheWithdrawBuilder, type FulfillJuniorTrancheWithdrawIxArgs, type FulfillJuniorTrancheWithdrawTxArgs, type FulfillSummary, type HoldingNavContribution, type HoldingUpdatePreview, IDL, IDLE_RESERVE_FLOOR_BPS, IDLE_RESERVE_TARGET_BPS, type IdleLiquidityOptions, type IdleLiquidityResult, IdleLiquidityService, type IdleLiquidityStatus, InitializeVaultRolesBuilder, type InitializeVaultRolesIxArgs, type InitializeVaultRolesTxArgs, type JuniorWithdrawalMode, JupiterBalanceSource, type JupiterBalanceSourceOptions, JupiterPriceSource, type JupiterPriceSourceOptions, JupiterSwapBuilder, type JupiterSwapIxArgs, type JupiterSwapTxArgs, KaminoPositionProvider, LIVE_ORACLE_VARIANTS, LIVE_PRICE_REFRESH_INTERVAL_SECS, LOCAL_PROTOCOL_ADMIN, LargeBalanceChangeError, type LargeBalanceChangeViolation, type LiveConsensusOracleDepsOptions, LivePriceSource, type LivePriceSourceOptions, MAX_BALANCE_CHANGE_BPS, MAX_CONSENSUS_SIGNERS, MAX_MANAGER_WITHDRAW_DESTINATIONS, MAX_PRICE_STALENESS_THRESHOLD_SECS, MIN_EXTERNAL_POSITION_SAMPLES, ManagerRedepositAssetBuilder, type ManagerRedepositAssetIxArgs, type ManagerRedepositAssetTxArgs, ManagerWithdrawAssetBuilder, type ManagerWithdrawAssetIxArgs, type ManagerWithdrawAssetTxArgs, MarginfiPositionProvider, type MintConfig, type MintIdentifier, type MintInfo, MintRegistry, type MintRegistryOptions, type MockYieldAccountConfig, MockYieldTracker, type MockYieldTrackerOptions, NEST_API_BASE_URL, NEST_RWA_SHARE_MINT, NEST_VAULT_SLUG, type NavAccountBalanceResponse, type NavAccountValueResponse, type NavCrankBlocker, type NavCrankBlockerReason, type NavCrankReadiness, type NavCrankResult, type NavPriceConfig, type NavYieldAccount, NestPriceSource, type NestPriceSourceOptions, ORACLE_ENTRIES_OFFSET, ORACLE_ENTRY_SIZE, ORACLE_SETTLED_NAV_TS_OFFSET, OracleService, PRICE_ORACLE_TYPES_BY_INDEX, PROGRAM_FEE_EXEMPT_OWNER_WHITELIST, PROTOCOL_ADMIN, PROTOCOL_FEE_RECIPIENT, PdaClient, type PreparedDirectTransaction, type PreparedSquadsTransaction, type PreparedVaultTransaction, type PriceOracleTypeArgs, type PriceSource, ProtocolInteractionBuilder, type ProtocolInteractionIxArgs, type ProtocolInteractionTxArgs, type QuoteFeeUnit, REPORTABLE_ORACLE_VARIANTS, type RefreshLiveOraclePricesParams, RemoveAssetHoldingBuilder, type RemoveAssetHoldingIxArgs, type RemoveAssetHoldingTxArgs, RequestJuniorTrancheWithdrawBuilder, type RequestJuniorTrancheWithdrawIxArgs, type RequestJuniorTrancheWithdrawTxArgs, type ResolveExternalWithdrawArgs, type ResolvedExternalWithdraw, type ResolvedSquadsWalletRoute, type RollingLimitConfig, type RollingRebalanceLimitConfig, type RunLiveConsensusOracleOptions, type RunOptions, type RunSummary, SHARE_DECIMALS, SYSTEM_PROGRAM, SetAssetPriceOracleBuilder, type SetAssetPriceOracleIxArgs, type SetAssetPriceOracleTxArgs, SetExternalLiquidityBuilder, type SetExternalLiquidityIxArgs, type SetExternalLiquidityTxArgs, SetManagerWithdrawDestinationBuilder, type SetManagerWithdrawDestinationIxArgs, type SetManagerWithdrawDestinationTxArgs, SetProtocolFeeBuilder, type SetProtocolFeeIxArgs, type SetProtocolFeeTxArgs, SetVaultConfigBuilder, type SetVaultConfigIxArgs, type SetVaultConfigTxArgs, type SettleVaultParams, type SettleVaultResult, type SettlementSimulation, type SettlementSimulationSnapshot, type SimulateDryRunSettlementParams, type SimulateSettlementArgs, type SimulatedShareClass, SquadsProposalExecutionSimulationError, type SquadsWalletRouteConfig, type StaleBalanceChangeBypass, StaticPositionProvider, TOKEN_PROGRAM, TOKEN_PROGRAM_ID, type TrackedAccountValue, type TrancheKindArgs, type TransactionBuilder, TransactionClient, USDC_MINT, USD_STAR_JUNIOR_MINT, USD_STAR_MINT, USD_STAR_PRINCIPAL_MINT, type UpdateAccountParams, UpdateAssetPriceBuilder, type UpdateAssetPriceIxArgs, type UpdateAssetPriceTxArgs, UpdateConsensusOracleBuilder, type UpdateConsensusOracleIxArgs, type UpdateConsensusOracleTxArgs, UpdateConsensusSignersBuilder, type UpdateConsensusSignersIxArgs, type UpdateConsensusSignersTxArgs, type UpdateDynamicAprParams, UpdateTrancheConfigBuilder, type UpdateTrancheConfigIxArgs, type UpdateTrancheConfigTxArgs, VAULT_CACHE_CATEGORY, VAULT_CREATOR_WHITELIST, VAULT_ENVIRONMENTS, VAULT_ORACLE_CACHE_CATEGORY, VAULT_PROGRAM_ID, VAULT_PROGRAM_IDS, VAULT_PROGRAM_PUBLIC_KEY, VAULT_ROLE_UPDATE_TIMELOCK_SECS, VAULT_TRANCHE_STATE_CACHE_CATEGORY, VAULT_TRANCHE_WITHDRAWAL_QUEUE_CACHE_CATEGORY, type Vault, type VaultAccountData, VaultBuilderBase, type VaultBuilderContext, type VaultCacheInvalidation, VaultClient, type VaultClientBundle, type VaultEnv, type VaultOracleAccountData, type VaultOracleResult, type VaultPricingInputs, type VaultQuote, type VaultQuoteArgs, VaultQuoteClient, type VaultQuoteDirection, type VaultQuoteShareClass, VaultReallocationBuilder, type VaultReallocationIxArgs, type VaultReallocationTxArgs, type VaultTrancheStateAccountData, type VaultTrancheWithdrawalQueueAccountData, type VaultTransactionPlan, type WalletBalanceSource, type WithdrawProtocolFeesIxArgs, type WithdrawProtocolFeesTxArgs, WithdrawalQueueService, type WithdrawalQueueSnapshot, type YieldAccount, type YieldAccountSnapshot, type YieldCalculationLog, type YieldCashflow, type YieldPaymentResponse, type YieldPaymentSnapshot, type YieldTracker, type YieldValuationModel, accountingUnitPriceToUsd, addCashflowUpdate, applyEffectiveApy, assertNoLargeBalanceChanges, assertNoUnconfirmedYieldPayments, buildHoldingUpdate, buildMarginfiWithdrawInteraction, buildUpdates, coerceBool, collectSamples, confirmYieldPayment, createAccount, createLiveConsensusOracleDeps, createRpcFromConnection, createTokenMint, createTokenMintIxs, createVaultClient, createYieldPayment, dateToStr, defaultKeypairPath, deleteAccount, discoverVaultsForSigner, fetchExternalPositions, fetchNestTokenPrice, fetchReceiptMints, filterTargetHoldings, findLargeBalanceChanges, findSquadsWalletRoute, formatSettlementSimulation, fromUiAmount, gatherPricingInputs, getAccount, getAccounts, getAprYield, getBalance, getCashflows, getNavValue, getRpcUrl, getTotalOutstandingYield, getTotalTrackedValue, getTotalYield, getTrackedValue, getVaultProgramId, getYield, getYieldPayments, indexConfigByMint, isNavAccountBalance, isNavAccountValue, isNavYieldAccount, isVaultEnv, keypairAddress, loadKeypair, logProspectiveApy, makeProvider, mintTokensTo, mints, mostFrequent, parseExternalLiquidityRefs, planRebalance, prepareVaultTransaction, priceInAccountingUnit, readI64LE, readSplMintSupply, refreshLiveOraclePrices, resolveExternalWithdraw, resolveKeypairPath, resolveSquadsWalletRoute, resolveTrackedAmounts, roundToNextUtcMidnight, runLiveConsensusOracle, selectReportableHoldings, settleVault, signerInOracleData, simulateConsensusOracleSettlement, simulateDryRunSettlement, simulateSquadsProposalExecution, sumPositionsByMint, systemClock, toBigInt, toUiAmount, toWeb3AccountMeta, trackedValueFromResponse, updateAccount, updateDynamicApr, validateSquadsWalletRoutes, variantName, vaultAuthorityForWallet, withDiscoveredYieldAccounts };
+/**
+ * Timelock settlement service.
+ *
+ * Scans vault state for expired staged configuration and confirms it with the
+ * vault's active fulfiller. Timelocks never apply merely because wall-clock
+ * time passed; each one needs the corresponding on-chain instruction:
+ *
+ * - pending vault roles -> empty `set_vault_config`
+ * - pending manager-withdraw destination -> exact
+ *   `set_manager_withdraw_destination`
+ * - pending consensus signers -> exact `update_consensus_signers`
+ *
+ * Holding cooldowns are action guards rather than staged changes, and junior
+ * withdrawal queues are handled by `WithdrawalQueueService`.
+ */
+
+type LogFn = (message: string) => void;
+type TimelockSettlementKind = "manager-withdraw-destination" | "consensus-signers" | "vault-roles";
+interface TimelockSettlementRecord {
+    vault: Address;
+    kind: TimelockSettlementKind;
+    effectiveTs: number;
+    signature?: string;
+    dryRun: boolean;
+}
+interface TimelockSettlementSummary {
+    vaultsScanned: number;
+    scanFailed: number;
+    pendingFound: number;
+    skippedNotExpired: number;
+    skippedAuthorityMismatch: number;
+    settled: number;
+    failed: number;
+    records: TimelockSettlementRecord[];
+}
+interface TimelockSettlementOptions {
+    /** Restrict a run to one vault; otherwise every program-owned vault is read. */
+    vault?: Address;
+    /** Simulate due confirmations without submitting them. */
+    dryRun?: boolean;
+    log?: LogFn;
+    /** Override chain time for deterministic tests. */
+    now?: number;
+}
+interface PendingConsensusSignerSet {
+    signers: Address[];
+    effectiveTs: number;
+}
+/** Decode the pending signer set from the zero-copy consensus-oracle payload. */
+declare function decodePendingConsensusSigners(data: readonly number[]): PendingConsensusSignerSet | null;
+declare class TimelockSettlementService {
+    private readonly client;
+    constructor(client: VaultClient);
+    private chainTime;
+    /** Scan and settle every due configuration timelock the signer can fulfill. */
+    runAll(fulfiller: Keypair, opts?: TimelockSettlementOptions): Promise<TimelockSettlementSummary>;
+    private execute;
+}
+
+export { ASSET_DECIMALS, ASSET_REBALANCE_COOLDOWN_SECS, type AccountBalanceResponse, AccountClient, type AccountYieldResponse, ActivateCircuitBreakerBuilder, type ActivateCircuitBreakerIxArgs, type ActivateCircuitBreakerTxArgs, type AddAprCashflowUpdateParams, type AddCashflowUpdateParams, type AddIncentiveRecipientArgs, AddIncentiveRecipientBuilder, type AddNavCashflowUpdateParams, type AprAccountBalanceResponse, type AprAccountYieldResponse, type AssetPriceOracleConfigIxArgs, type AssetPriceOracleConfigTxArgs, type AssetPriceRefreshTarget, type AssetRefreshResult, type AssetType, BALANCE_CHANGE_BASELINE_MAX_AGE_SECS, type Bankineco, type BasicAuthCredentials, type Bigintish, type BuildMarginfiWithdrawInteractionArgs, CONSENSUS_ORACLE_VARIANT, type CancelIncentiveProposalArgs, CancelIncentiveProposalBuilder, CancelJuniorTrancheWithdrawBuilder, type CancelJuniorTrancheWithdrawIxArgs, type CancelJuniorTrancheWithdrawTxArgs, type Clock, type CollectSamplesOptions, type ConsensusAssetUpdate, type ConsensusHoldingEntry, type ConsensusHoldingSimulation, type ConsensusOracleDeps, type ConsensusOracleHoldingConfig, ConsensusOracleService, type ConsensusOracleTarget, CrankNavBuilder, type CrankNavIxArgs, type CrankNavTxArgs, CrankPerformanceFeesBuilder, type CrankPerformanceFeesIxArgs, type CrankPerformanceFeesTxArgs, type CreateAccountParams, CreateAssetHoldingBuilder, type CreateAssetHoldingIxArgs, type CreateAssetHoldingTxArgs, CreateIncentiveBuilder, type CreateIncentiveIxArgs, type CreateIncentiveTxArgs, type CreateTokenMintIxs, CreateTrancheStateBuilder, type CreateTrancheStateIxArgs, type CreateTrancheStateTxArgs, CreateVaultBuilder, type CreateVaultClientOptions, type CreateVaultIxArgs, type CreateVaultParams, type CreateVaultTxArgs, type CreateYieldPaymentParams, DEFAULT_CU_PRICE_MICRO_LAMPORTS, DEFAULT_JUNIOR_EARLY_UNSTAKE_FEE_BPS, DEFAULT_JUNIOR_STANDARD_UNSTAKE_FEE_BPS, DEFAULT_JUNIOR_WITHDRAWAL_LOCKUP_SECS, DEFAULT_MAX_ACCEPTABLE_APY_BPS, DEFAULT_MAX_ACCOUNTS, DEFAULT_MINTS, DEFAULT_MIN_AMOUNT_UI, DEFAULT_ORACLE_STALENESS_THRESHOLD_SECS, DEFAULT_PRICE_ORACLE_ACCOUNT, DEFAULT_PRICE_STALENESS_SECS, DEFAULT_PRICE_STALENESS_THRESHOLD_SECS, DEFAULT_REBALANCE_BAND_BPS, DEFAULT_SLIPPAGE_BPS, DEFAULT_TARGET_LOCAL_BPS, DEFAULT_VAULT_ID, type DecodedHolding, type DecodedVault, type DecodedVaultTrancheState, type DeleteAccountParams, DisableCircuitBreakerBuilder, type DisableCircuitBreakerIxArgs, type DisableCircuitBreakerTxArgs, DistributeIncentiveBuilder, type DistributeIncentiveIxArgs, type DistributeIncentiveTxArgs, EXTERNAL_POSITION_SAMPLES, ExecuteDepositBuilder, type ExecuteDepositIxArgs, type ExecuteDepositTxArgs, ExecuteShareSwapBuilder, type ExecuteShareSwapIxArgs, type ExecuteShareSwapTxArgs, ExecuteTrancheDepositBuilder, type ExecuteTrancheDepositIxArgs, type ExecuteTrancheDepositTxArgs, ExecuteTrancheWithdrawBuilder, type ExecuteTrancheWithdrawIxArgs, type ExecuteTrancheWithdrawTxArgs, ExecuteWithdrawBuilder, type ExecuteWithdrawIxArgs, type ExecuteWithdrawTxArgs, type ExternalLiquidityIntegrityOptions, type ExternalLiquidityIntegrityResult, ExternalLiquidityIntegrityService, type ExternalLiquidityIntegritySummary, type ExternalLiquiditySlot, type ExternalLiquiditySourceArgs, type ExternalPosition, type ExternalPositionContext, type ExternalPositionProvider, type ExternalPositionRef, ExternalPositionRegistry, FEE_VAULT_CACHE_CATEGORY, type FeeVaultAccountData, type FetchNestTokenPriceOptions, FulfillJuniorTrancheWithdrawBuilder, type FulfillJuniorTrancheWithdrawIxArgs, type FulfillJuniorTrancheWithdrawTxArgs, type FulfillSummary, type HoldingNavContribution, type HoldingUpdatePreview, IDL, IDLE_RESERVE_FLOOR_BPS, IDLE_RESERVE_TARGET_BPS, type IdleLiquidityOptions, type IdleLiquidityResult, IdleLiquidityService, type IdleLiquidityStatus, type IncentiveRecipient, type IncentiveTotals, InitializeVaultRolesBuilder, type InitializeVaultRolesIxArgs, type InitializeVaultRolesTxArgs, type JuniorWithdrawalMode, JupiterBalanceSource, type JupiterBalanceSourceOptions, JupiterPriceSource, type JupiterPriceSourceOptions, JupiterSwapBuilder, type JupiterSwapIxArgs, type JupiterSwapTxArgs, KaminoPositionProvider, LIVE_ORACLE_VARIANTS, LIVE_PRICE_REFRESH_INTERVAL_SECS, LOCAL_PROTOCOL_ADMIN, LargeBalanceChangeError, type LargeBalanceChangeViolation, type LiveConsensusOracleDepsOptions, LivePriceSource, type LivePriceSourceOptions, MAX_BALANCE_CHANGE_BPS, MAX_CONSENSUS_SIGNERS, MAX_INCENTIVE_RECIPIENTS, MAX_MANAGER_WITHDRAW_DESTINATIONS, MAX_PRICE_STALENESS_THRESHOLD_SECS, MIN_EXTERNAL_POSITION_SAMPLES, ManagerRedepositAssetBuilder, type ManagerRedepositAssetIxArgs, type ManagerRedepositAssetTxArgs, ManagerWithdrawAssetBuilder, type ManagerWithdrawAssetIxArgs, type ManagerWithdrawAssetTxArgs, MarginfiPositionProvider, type MintConfig, type MintIdentifier, type MintInfo, MintRegistry, type MintRegistryOptions, type MockYieldAccountConfig, MockYieldTracker, type MockYieldTrackerOptions, NEST_API_BASE_URL, NEST_RWA_SHARE_MINT, NEST_VAULT_SLUG, type NavAccountBalanceResponse, type NavAccountValueResponse, type NavCrankBlocker, type NavCrankBlockerReason, type NavCrankReadiness, type NavCrankResult, type NavPriceConfig, type NavYieldAccount, NestPriceSource, type NestPriceSourceOptions, ORACLE_ENTRIES_OFFSET, ORACLE_ENTRY_SIZE, ORACLE_SETTLED_NAV_TS_OFFSET, OracleService, PRICE_ORACLE_TYPES_BY_INDEX, PROGRAM_FEE_EXEMPT_OWNER_WHITELIST, PROTOCOL_ADMIN, PROTOCOL_FEE_RECIPIENT, PdaClient, type PendingConsensusSignerSet, type PreparedDirectTransaction, type PreparedSquadsTransaction, type PreparedVaultTransaction, type PriceOracleTypeArgs, type PriceSource, ProtocolInteractionBuilder, type ProtocolInteractionIxArgs, type ProtocolInteractionTxArgs, type QuoteFeeUnit, REPORTABLE_ORACLE_VARIANTS, type RefreshLiveOraclePricesParams, RemoveAssetHoldingBuilder, type RemoveAssetHoldingIxArgs, type RemoveAssetHoldingTxArgs, RequestJuniorTrancheWithdrawBuilder, type RequestJuniorTrancheWithdrawIxArgs, type RequestJuniorTrancheWithdrawTxArgs, type ResolveExternalWithdrawArgs, type ResolvedExternalWithdraw, type ResolvedSquadsWalletRoute, type RollingLimitConfig, type RollingRebalanceLimitConfig, type RunLiveConsensusOracleOptions, type RunOptions, type RunSummary, SHARE_DECIMALS, SYSTEM_PROGRAM, SetAssetPriceOracleBuilder, type SetAssetPriceOracleIxArgs, type SetAssetPriceOracleTxArgs, SetExternalLiquidityBuilder, type SetExternalLiquidityIxArgs, type SetExternalLiquidityTxArgs, type SetIncentiveLimitsArgs, SetIncentiveLimitsBuilder, SetManagerWithdrawDestinationBuilder, type SetManagerWithdrawDestinationIxArgs, type SetManagerWithdrawDestinationTxArgs, SetProtocolFeeBuilder, type SetProtocolFeeIxArgs, type SetProtocolFeeTxArgs, SetVaultConfigBuilder, type SetVaultConfigIxArgs, type SetVaultConfigTxArgs, type SettleVaultParams, type SettleVaultResult, type SettlementSimulation, type SettlementSimulationSnapshot, type SimulateDryRunSettlementParams, type SimulateSettlementArgs, type SimulatedShareClass, SquadsProposalExecutionSimulationError, type SquadsWalletRouteConfig, type StaleBalanceChangeBypass, StaticPositionProvider, SubmitIncentiveBuilder, type SubmitIncentiveIxArgs, type SubmitIncentiveTxArgs, TOKEN_PROGRAM, TOKEN_PROGRAM_ID, type TimelockSettlementKind, type TimelockSettlementOptions, type TimelockSettlementRecord, TimelockSettlementService, type TimelockSettlementSummary, type TrackedAccountValue, type TrancheKindArgs, type TransactionBuilder, TransactionClient, USDC_MINT, USD_STAR_JUNIOR_MINT, USD_STAR_MINT, USD_STAR_PRINCIPAL_MINT, type UpdateAccountParams, UpdateAssetPriceBuilder, type UpdateAssetPriceIxArgs, type UpdateAssetPriceTxArgs, UpdateConsensusOracleBuilder, type UpdateConsensusOracleIxArgs, type UpdateConsensusOracleTxArgs, UpdateConsensusSignersBuilder, type UpdateConsensusSignersIxArgs, type UpdateConsensusSignersTxArgs, type UpdateDynamicAprParams, UpdateTrancheConfigBuilder, type UpdateTrancheConfigIxArgs, type UpdateTrancheConfigTxArgs, VAULT_CACHE_CATEGORY, VAULT_CREATOR_WHITELIST, VAULT_ENVIRONMENTS, VAULT_ORACLE_CACHE_CATEGORY, VAULT_PROGRAM_ID, VAULT_PROGRAM_IDS, VAULT_PROGRAM_PUBLIC_KEY, VAULT_ROLE_UPDATE_TIMELOCK_SECS, VAULT_TRANCHE_STATE_CACHE_CATEGORY, VAULT_TRANCHE_WITHDRAWAL_QUEUE_CACHE_CATEGORY, type Vault, type VaultAccountData, VaultBuilderBase, type VaultBuilderContext, type VaultCacheInvalidation, VaultClient, type VaultClientBundle, type VaultEnv, type VaultIncentiveAccount, type VaultIncentiveAccountData, type VaultOracleAccountData, type VaultOracleResult, type VaultPricingInputs, type VaultQuote, type VaultQuoteArgs, VaultQuoteClient, type VaultQuoteDirection, type VaultQuoteShareClass, VaultReallocationBuilder, type VaultReallocationIxArgs, type VaultReallocationTxArgs, type VaultTrancheStateAccountData, type VaultTrancheWithdrawalQueueAccountData, type VaultTransactionPlan, type WalletBalanceSource, type WithdrawProtocolFeesIxArgs, type WithdrawProtocolFeesTxArgs, WithdrawalQueueService, type WithdrawalQueueSnapshot, type YieldAccount, type YieldAccountSnapshot, type YieldCalculationLog, type YieldCashflow, type YieldPaymentResponse, type YieldPaymentSnapshot, type YieldTracker, type YieldValuationModel, accountingUnitPriceToUsd, addCashflowUpdate, applyEffectiveApy, assertNoLargeBalanceChanges, assertNoUnconfirmedYieldPayments, buildHoldingUpdate, buildMarginfiWithdrawInteraction, buildUpdates, coerceBool, collectSamples, confirmYieldPayment, createAccount, createLiveConsensusOracleDeps, createRpcFromConnection, createTokenMint, createTokenMintIxs, createVaultClient, createYieldPayment, dateToStr, decodePendingConsensusSigners, defaultKeypairPath, deleteAccount, discoverVaultsForSigner, fetchExternalPositions, fetchNestTokenPrice, fetchReceiptMints, filterTargetHoldings, findLargeBalanceChanges, findSquadsWalletRoute, formatSettlementSimulation, fromUiAmount, gatherPricingInputs, getAccount, getAccounts, getAprYield, getBalance, getCashflows, getIncentiveRecipientShareAtas, getIncentiveRecipients, getIncentiveTotals, getNavValue, getRpcUrl, getTotalOutstandingYield, getTotalTrackedValue, getTotalYield, getTrackedValue, getVaultProgramId, getYield, getYieldPayments, indexConfigByMint, isNavAccountBalance, isNavAccountValue, isNavYieldAccount, isVaultEnv, keypairAddress, loadKeypair, logProspectiveApy, makeProvider, mintTokensTo, mints, mostFrequent, parseExternalLiquidityRefs, planRebalance, prepareVaultTransaction, priceInAccountingUnit, readI64LE, readSplMintSupply, refreshLiveOraclePrices, resolveExternalWithdraw, resolveKeypairPath, resolveSquadsWalletRoute, resolveTrackedAmounts, roundToNextUtcMidnight, runLiveConsensusOracle, selectReportableHoldings, settleVault, signerInOracleData, simulateConsensusOracleSettlement, simulateDryRunSettlement, simulateSquadsProposalExecution, sumPositionsByMint, systemClock, toBigInt, toUiAmount, toWeb3AccountMeta, trackedValueFromResponse, updateAccount, updateDynamicApr, validateSquadsWalletRoutes, variantName, vaultAuthorityForWallet, withDiscoveredYieldAccounts };