@elmntl/jlpd-sdk 0.1.11 → 0.2.0

package/dist/index.d.ts

@@ -99,66 +99,71 @@ type JlpDProgram = {
             "args": [];
         },
         {
-            "name": "closeStv";
+            "name": "claimWithdraw";
             "docs": [
-                "Close an STV account and return rent to admin",
-                "Destructive operation - use only for cleanup/migration",
+                "Claim processed withdrawal (epoch-based delayed withdrawal)",
                 "",
-                "# Safety Checks",
-                "- Validates jvX supply is 0 (no active shares)",
-                "- Validates base_loaned is 0 (no outstanding loans)",
-                "- Validates accrued_fees_jlx is 0 (no unclaimed fees)"
+                "# Flow",
+                "1. Verify request is processed (pps > 0) and claim period reached",
+                "2. Transfer base from STV to user",
+                "3. Close request's jvX ATA and WithdrawRequest PDA (rent to user)"
             ];
             "discriminator": [
-                173,
-                189,
-                151,
-                131,
-                240,
-                39,
-                199,
-                147
+                232,
+                89,
+                154,
+                117,
+                16,
+                204,
+                182,
+                224
             ];
             "accounts": [
                 {
-                    "name": "admin";
+                    "name": "user";
                     "docs": [
-                        "Admin must sign - verified via vault.has_one = admin"
+                        "User claiming their withdrawal"
                     ];
                     "writable": true;
                     "signer": true;
-                    "relations": [
-                        "jlpVault"
+                },
+                {
+                    "name": "stv";
+                    "docs": [
+                        "The STV PDA account (mut for reserved_base update)"
                     ];
+                    "writable": true;
                 },
                 {
-                    "name": "jlpVault";
+                    "name": "baseMint";
                     "docs": [
-                        "JLP Vault for admin validation"
+                        "Base asset mint (for transfer_checked)"
                     ];
-                    "pda": {
-                        "seeds": [
-                            {
-                                "kind": "const";
-                                "value": [
-                                    106,
-                                    108,
-                                    112,
-                                    95,
-                                    118,
-                                    97,
-                                    117,
-                                    108,
-                                    116
-                                ];
-                            }
-                        ];
-                    };
                 },
                 {
-                    "name": "stv";
+                    "name": "jvMint";
+                    "docs": [
+                        "jvX mint (for ATA close verification)"
+                    ];
+                },
+                {
+                    "name": "userBaseAta";
+                    "docs": [
+                        "User's base token destination"
+                    ];
+                    "writable": true;
+                },
+                {
+                    "name": "stvBaseAta";
+                    "docs": [
+                        "STV's base ATA (source for base transfer)"
+                    ];
+                    "writable": true;
+                },
+                {
+                    "name": "withdrawRequest";
                     "docs": [
-                        "STV to close"
+                        "WithdrawRequest PDA - closed after claim (rent to user)"
                     ];
                     "writable": true;
                     "pda": {
@@ -166,33 +171,49 @@ type JlpDProgram = {
                             {
                                 "kind": "const";
                                 "value": [
-                                    115,
+                                    119,
+                                    105,
                                     116,
-                                    118
+                                    104,
+                                    100,
+                                    114,
+                                    97,
+                                    119,
+                                    95,
+                                    114,
+                                    101,
+                                    113,
+                                    117,
+                                    101,
+                                    115,
+                                    116
                                 ];
                             },
                             {
                                 "kind": "account";
-                                "path": "baseMint";
+                                "path": "stv";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "withdraw_request.epoch_id";
+                                "account": "WithdrawRequest";
                             }
                         ];
                     };
                 },
                 {
-                    "name": "jvMint";
+                    "name": "requestJvxAta";
                     "docs": [
-                        "jvX mint for this STV - used to verify no active shares"
-                    ];
-                },
-                {
-                    "name": "baseMint";
-                    "docs": [
-                        "Base asset mint for this STV"
+                        "Empty jvX ATA owned by WithdrawRequest PDA (to close, rent to user)"
                     ];
+                    "writable": true;
                 },
                 {
-                    "name": "systemProgram";
-                    "address": "11111111111111111111111111111111";
+                    "name": "tokenProgram";
                 }
             ];
             "args": [];
@@ -377,7 +398,7 @@ type JlpDProgram = {
                     "name": "params";
                     "type": {
                         "defined": {
-                            "name": "initOrUpdateJlpVaultParams";
+                            "name": "InitOrUpdateJlpVaultParams";
                         };
                     };
                 }
@@ -433,7 +454,7 @@ type JlpDProgram = {
                             },
                             {
                                 "kind": "account";
-                                "path": "baseMint";
+                                "path": "base_mint";
                             }
                         ];
                     };
@@ -454,7 +475,7 @@ type JlpDProgram = {
                     "name": "jvMint";
                     "docs": [
                         "Vault share token mint (jvX) - STV is the mint authority",
-                        "Client generates keypair and passes it as signer"
+                        "Uses init_if_needed in case mint exists from a previous STV initialization"
                     ];
                     "writable": true;
                     "signer": true;
@@ -511,7 +532,7 @@ type JlpDProgram = {
                             },
                             {
                                 "kind": "account";
-                                "path": "jlMint";
+                                "path": "jl_mint";
                             }
                         ];
                         "program": {
@@ -586,7 +607,7 @@ type JlpDProgram = {
                     "name": "params";
                     "type": {
                         "defined": {
-                            "name": "initializeStvParams";
+                            "name": "InitializeStvParams";
                         };
                     };
                 }
@@ -686,7 +707,7 @@ type JlpDProgram = {
                     "name": "params";
                     "type": {
                         "defined": {
-                            "name": "jupEarnParams";
+                            "name": "JupEarnParams";
                         };
                     };
                 }
@@ -780,9 +801,308 @@ type JlpDProgram = {
                     "name": "params";
                     "type": {
                         "defined": {
-                            "name": "moveJlxParams";
+                            "name": "MoveJlxParams";
+                        };
+                    };
+                }
+            ];
+        },
+        {
+            "name": "processEpoch";
+            "docs": [
+                "Process epoch: burn jvX from withdraw requests, record PPS, earmark base",
+                "",
+                "Permissionless (anyone can call after epoch ends).",
+                "Processes WithdrawRequest pairs from remaining_accounts.",
+                "Uses epoch_pps for multi-batch consistency.",
+                "",
+                "# Remaining Accounts",
+                "- [0-1]: Jupiter Lend accounts (if jl_mint != base_mint)",
+                "- [N..]: pairs of [WithdrawRequest (mut), request_jvx_ata (mut)]"
+            ];
+            "discriminator": [
+                115,
+                194,
+                215,
+                160,
+                113,
+                154,
+                81,
+                5
+            ];
+            "accounts": [
+                {
+                    "name": "payer";
+                    "docs": [
+                        "Payer/caller - permissionless (anyone can call after epoch ends)"
+                    ];
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "jlpVault";
+                    "docs": [
+                        "The JLP Vault PDA account (for pause checks)"
+                    ];
+                },
+                {
+                    "name": "stv";
+                    "docs": [
+                        "The STV PDA account (mut for epoch state + fee crystallization)"
+                    ];
+                    "writable": true;
+                },
+                {
+                    "name": "baseMint";
+                    "docs": [
+                        "Base asset mint (for NAV calc)"
+                    ];
+                },
+                {
+                    "name": "jlMint";
+                    "docs": [
+                        "jlX mint (for exchange rate)"
+                    ];
+                },
+                {
+                    "name": "jvMint";
+                    "docs": [
+                        "jvX mint (mut for burn - supply decreases)"
+                    ];
+                    "writable": true;
+                },
+                {
+                    "name": "stvBaseAta";
+                    "docs": [
+                        "STV's base ATA (for NAV)"
+                    ];
+                },
+                {
+                    "name": "stvJlxAta";
+                    "docs": [
+                        "STV's jlX ATA (for NAV)"
+                    ];
+                },
+                {
+                    "name": "tokenProgram";
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "requestWithdraw";
+            "docs": [
+                "Request withdrawal of jvX shares (epoch-based delayed withdrawal)",
+                "",
+                "# Flow",
+                "1. Validate epoch is active and not ended",
+                "2. Create or accumulate into WithdrawRequest PDA for this epoch",
+                "3. Transfer jvX from user to request's escrow ATA",
+                "",
+                "User must wait for process_epoch + claim_withdraw to receive base."
+            ];
+            "discriminator": [
+                137,
+                95,
+                187,
+                96,
+                250,
+                138,
+                31,
+                182
+            ];
+            "accounts": [
+                {
+                    "name": "user";
+                    "docs": [
+                        "User requesting withdrawal"
+                    ];
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "jlpVault";
+                    "docs": [
+                        "The JLP Vault PDA account (for pause checks)"
+                    ];
+                },
+                {
+                    "name": "stv";
+                    "docs": [
+                        "The STV PDA account (for epoch validation)"
+                    ];
+                    "writable": true;
+                },
+                {
+                    "name": "jvMint";
+                    "docs": [
+                        "jvX mint (vault share token)"
+                    ];
+                },
+                {
+                    "name": "userJvxAta";
+                    "docs": [
+                        "User's jvX token account (source of shares)"
+                    ];
+                    "writable": true;
+                },
+                {
+                    "name": "withdrawRequest";
+                    "docs": [
+                        "WithdrawRequest PDA - created or accumulated into"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    119,
+                                    105,
+                                    116,
+                                    104,
+                                    100,
+                                    114,
+                                    97,
+                                    119,
+                                    95,
+                                    114,
+                                    101,
+                                    113,
+                                    117,
+                                    101,
+                                    115,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "stv";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            },
+                            {
+                                "kind": "arg";
+                                "path": "epoch_id";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "requestJvxAta";
+                    "docs": [
+                        "jvX ATA owned by the WithdrawRequest PDA (escrow for shares)"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "account";
+                                "path": "withdraw_request";
+                            },
+                            {
+                                "kind": "const";
+                                "value": [
+                                    6,
+                                    221,
+                                    246,
+                                    225,
+                                    215,
+                                    101,
+                                    161,
+                                    147,
+                                    217,
+                                    203,
+                                    225,
+                                    70,
+                                    206,
+                                    235,
+                                    121,
+                                    172,
+                                    28,
+                                    180,
+                                    133,
+                                    237,
+                                    95,
+                                    91,
+                                    55,
+                                    145,
+                                    58,
+                                    140,
+                                    245,
+                                    133,
+                                    126,
+                                    255,
+                                    0,
+                                    169
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "jv_mint";
+                            }
+                        ];
+                        "program": {
+                            "kind": "const";
+                            "value": [
+                                140,
+                                151,
+                                37,
+                                143,
+                                78,
+                                36,
+                                137,
+                                241,
+                                187,
+                                61,
+                                16,
+                                41,
+                                20,
+                                142,
+                                13,
+                                131,
+                                11,
+                                90,
+                                19,
+                                153,
+                                218,
+                                255,
+                                16,
+                                132,
+                                4,
+                                142,
+                                123,
+                                216,
+                                219,
+                                233,
+                                248,
+                                89
+                            ];
                         };
                     };
+                },
+                {
+                    "name": "tokenProgram";
+                },
+                {
+                    "name": "associatedTokenProgram";
+                    "address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [
+                {
+                    "name": "shares";
+                    "type": "u64";
+                },
+                {
+                    "name": "epochId";
+                    "type": "u32";
                 }
             ];
         },
@@ -975,7 +1295,7 @@ type JlpDProgram = {
                     "name": "params";
                     "type": {
                         "defined": {
-                            "name": "swapJlxJlpParams";
+                            "name": "SwapJlxJlpParams";
                         };
                     };
                 }
@@ -1027,131 +1347,16 @@ type JlpDProgram = {
                     "name": "params";
                     "type": {
                         "defined": {
-                            "name": "updateStvParams";
-                        };
-                    };
-                }
-            ];
-        },
-        {
-            "name": "withdraw";
-            "docs": [
-                "Withdraw base asset by burning jvX shares",
-                "",
-                "# Flow",
-                "1. Crystallize fees inline (ensures fair PPS)",
-                "2. Calculate base amount from shares at post-fee PPS",
-                "3. Burn jvX shares from user",
-                "4. Transfer base from STV's base ATA to user",
-                "",
-                "# Note",
-                "Requires sufficient base balance in STV's base ATA.",
-                "Manager must ensure liquidity by converting jlX to base via",
-                "jup_earn_deposit_withdraw instruction before user withdrawals.",
-                "",
-                "Remaining accounts (optional, for exchange rate):",
-                "[0] = Jupiter Lend lending account",
-                "[1] = Jupiter Lend rewards rate model"
-            ];
-            "discriminator": [
-                183,
-                18,
-                70,
-                156,
-                148,
-                109,
-                161,
-                34
-            ];
-            "accounts": [
-                {
-                    "name": "user";
-                    "docs": [
-                        "User performing the withdrawal"
-                    ];
-                    "writable": true;
-                    "signer": true;
-                },
-                {
-                    "name": "jlpVault";
-                    "docs": [
-                        "The JLP Vault PDA account",
-                        "Note: PDA verified in handler via get_pda() to avoid multiple loads"
-                    ];
-                },
-                {
-                    "name": "stv";
-                    "docs": [
-                        "The STV PDA account",
-                        "Note: PDA verified in handler via get_pda() to avoid multiple loads"
-                    ];
-                    "writable": true;
-                },
-                {
-                    "name": "baseMint";
-                    "docs": [
-                        "Base asset mint (underlying token: SOL, BTC, ETH, USDC)"
-                    ];
-                },
-                {
-                    "name": "jlMint";
-                    "docs": [
-                        "jlX mint (Jupiter Lend token) - used for NAV calculation"
-                    ];
-                },
-                {
-                    "name": "jvMint";
-                    "docs": [
-                        "jvX mint (vault share token) - STV is mint authority",
-                        "Verified against STV.jv_mint in handler"
-                    ];
-                    "writable": true;
-                },
-                {
-                    "name": "userBaseAta";
-                    "docs": [
-                        "User's base asset token account (destination for withdrawal)"
-                    ];
-                    "writable": true;
-                },
-                {
-                    "name": "userJvxAta";
-                    "docs": [
-                        "User's jvX token account (source - shares to burn)"
-                    ];
-                    "writable": true;
-                },
-                {
-                    "name": "stvBaseAta";
-                    "docs": [
-                        "STV's base ATA (source for base tokens to user)"
-                    ];
-                    "writable": true;
-                },
-                {
-                    "name": "stvJlxAta";
-                    "docs": [
-                        "STV's jlX ATA (used for NAV calculation)"
-                    ];
-                },
-                {
-                    "name": "tokenProgram";
-                    "docs": [
-                        "Token program"
-                    ];
-                }
-            ];
-            "args": [
-                {
-                    "name": "sharesToBurn";
-                    "type": "u64";
+                            "name": "UpdateStvParams";
+                        };
+                    };
                 }
             ];
         }
     ];
     "accounts": [
         {
-            "name": "jlpVault";
+            "name": "JLPVault";
             "discriminator": [
                 41,
                 108,
@@ -1164,7 +1369,7 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "stv";
+            "name": "STV";
             "discriminator": [
                 214,
                 2,
@@ -1175,11 +1380,24 @@ type JlpDProgram = {
                 17,
                 230
             ];
+        },
+        {
+            "name": "WithdrawRequest";
+            "discriminator": [
+                186,
+                239,
+                174,
+                191,
+                189,
+                13,
+                47,
+                196
+            ];
         }
     ];
     "events": [
         {
-            "name": "deposited";
+            "name": "Deposited";
             "discriminator": [
                 111,
                 141,
@@ -1192,7 +1410,33 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "feesClaimSkipped";
+            "name": "EpochAdvanced";
+            "discriminator": [
+                41,
+                220,
+                14,
+                123,
+                117,
+                70,
+                117,
+                157
+            ];
+        },
+        {
+            "name": "EpochProcessed";
+            "discriminator": [
+                18,
+                238,
+                2,
+                247,
+                238,
+                178,
+                94,
+                138
+            ];
+        },
+        {
+            "name": "FeesClaimSkipped";
             "discriminator": [
                 7,
                 214,
@@ -1205,7 +1449,7 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "feesClaimed";
+            "name": "FeesClaimed";
             "discriminator": [
                 22,
                 104,
@@ -1218,7 +1462,7 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "jlpSwapped";
+            "name": "JlpSwapped";
             "discriminator": [
                 253,
                 47,
@@ -1231,7 +1475,7 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "jlpVaultInitialized";
+            "name": "JlpVaultInitialized";
             "discriminator": [
                 52,
                 94,
@@ -1244,7 +1488,7 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "jlpVaultUpdated";
+            "name": "JlpVaultUpdated";
             "discriminator": [
                 20,
                 204,
@@ -1257,7 +1501,7 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "jlxMoved";
+            "name": "JlxMoved";
             "discriminator": [
                 251,
                 80,
@@ -1270,7 +1514,7 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "jlxSwapped";
+            "name": "JlxSwapped";
             "discriminator": [
                 200,
                 218,
@@ -1283,7 +1527,7 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "jupEarnEvent";
+            "name": "JupEarnEvent";
             "discriminator": [
                 138,
                 10,
@@ -1296,7 +1540,7 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "settleYieldEvent";
+            "name": "SettleYieldEvent";
             "discriminator": [
                 208,
                 142,
@@ -1309,7 +1553,7 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "settleYieldSkipped";
+            "name": "SettleYieldSkipped";
             "discriminator": [
                 189,
                 221,
@@ -1322,7 +1566,7 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "settleYieldStvEvent";
+            "name": "SettleYieldStvEvent";
             "discriminator": [
                 12,
                 42,
@@ -1335,7 +1579,7 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "stvInitialized";
+            "name": "StvInitialized";
             "discriminator": [
                 41,
                 106,
@@ -1348,7 +1592,7 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "stvUpdated";
+            "name": "StvUpdated";
             "discriminator": [
                 108,
                 129,
@@ -1361,254 +1605,317 @@ type JlpDProgram = {
             ];
         },
         {
-            "name": "withdrawn";
+            "name": "WithdrawClaimed";
             "discriminator": [
-                20,
+                77,
+                130,
                 89,
-                223,
-                198,
-                194,
-                124,
-                219,
-                13
+                38,
+                239,
+                172,
+                174,
+                85
+            ];
+        },
+        {
+            "name": "WithdrawRequested";
+            "discriminator": [
+                114,
+                16,
+                240,
+                206,
+                93,
+                128,
+                151,
+                39
             ];
         }
     ];
     "errors": [
         {
             "code": 6000;
-            "name": "unauthorized";
+            "name": "Unauthorized";
             "msg": "Unauthorized: not admin";
         },
         {
             "code": 6001;
-            "name": "notManager";
+            "name": "NotManager";
             "msg": "Unauthorized: not manager";
         },
         {
             "code": 6002;
-            "name": "vaultPaused";
+            "name": "VaultPaused";
             "msg": "Vault is paused";
         },
         {
             "code": 6003;
-            "name": "depositsDisabled";
+            "name": "DepositsDisabled";
             "msg": "Deposits disabled";
         },
         {
             "code": 6004;
-            "name": "withdrawalsDisabled";
+            "name": "WithdrawalsDisabled";
             "msg": "Withdrawals disabled";
         },
         {
             "code": 6005;
-            "name": "jlpDisabled";
+            "name": "JlpDisabled";
             "msg": "JLP operations disabled";
         },
         {
             "code": 6006;
-            "name": "rebalanceDisabled";
+            "name": "RebalanceDisabled";
             "msg": "Rebalance operations disabled";
         },
         {
             "code": 6007;
-            "name": "mathOverflow";
+            "name": "MathOverflow";
             "msg": "Math overflow";
         },
         {
             "code": 6008;
-            "name": "invalidTimestamp";
+            "name": "InvalidTimestamp";
             "msg": "Invalid timestamp";
         },
         {
             "code": 6009;
-            "name": "divisionByZero";
+            "name": "DivisionByZero";
             "msg": "Division by zero";
         },
         {
             "code": 6010;
-            "name": "stagingNotZero";
+            "name": "StagingNotZero";
             "msg": "Staging ATAs must be zero";
         },
         {
             "code": 6011;
-            "name": "insufficientLiquidity";
+            "name": "InsufficientLiquidity";
             "msg": "Insufficient liquidity for withdrawal";
         },
         {
             "code": 6012;
-            "name": "insufficientBalance";
+            "name": "InsufficientBalance";
             "msg": "Insufficient balance";
         },
         {
             "code": 6013;
-            "name": "slippageExceeded";
+            "name": "SlippageExceeded";
             "msg": "Slippage exceeded";
         },
         {
             "code": 6014;
-            "name": "invalidJlpVaultBump";
+            "name": "InvalidJlpVaultBump";
             "msg": "Invalid JLP vault PDA bump";
         },
         {
             "code": 6015;
-            "name": "invalidStvBump";
+            "name": "InvalidStvBump";
             "msg": "Invalid STV PDA bump";
         },
         {
             "code": 6016;
-            "name": "invalidJlMint";
+            "name": "InvalidJlMint";
             "msg": "Invalid jlX mint (Jupiter Lend token)";
         },
         {
             "code": 6017;
-            "name": "invalidJvMint";
+            "name": "InvalidJvMint";
             "msg": "Invalid jvX mint (vault share token)";
         },
         {
             "code": 6018;
-            "name": "invalidBaseMint";
+            "name": "InvalidBaseMint";
             "msg": "Invalid base asset mint";
         },
         {
             "code": 6019;
-            "name": "invalidJlpMint";
+            "name": "InvalidJlpMint";
             "msg": "Invalid JLP mint";
         },
         {
             "code": 6020;
-            "name": "invalidOwner";
+            "name": "InvalidOwner";
             "msg": "Invalid account owner";
         },
         {
             "code": 6021;
-            "name": "invalidStvIndex";
+            "name": "InvalidStvIndex";
             "msg": "Invalid STV index";
         },
         {
             "code": 6022;
-            "name": "invalidFeeParams";
+            "name": "InvalidFeeParams";
             "msg": "Invalid fee parameters";
         },
         {
             "code": 6023;
-            "name": "amountTooSmall";
+            "name": "AmountTooSmall";
             "msg": "Amount too small";
         },
         {
             "code": 6024;
-            "name": "zeroAmount";
+            "name": "ZeroAmount";
             "msg": "Zero amount not allowed";
         },
         {
             "code": 6025;
-            "name": "feeCapExceeded";
+            "name": "FeeCapExceeded";
             "msg": "Fee cap exceeded";
         },
         {
             "code": 6026;
-            "name": "mintMismatch";
+            "name": "MintMismatch";
             "msg": "Mint mismatch";
         },
         {
             "code": 6027;
-            "name": "insufficientAccounts";
+            "name": "InsufficientAccounts";
             "msg": "Insufficient accounts provided";
         },
         {
             "code": 6028;
-            "name": "invalidProgram";
+            "name": "InvalidProgram";
             "msg": "Invalid program ID";
         },
         {
             "code": 6029;
-            "name": "invalidSwapDiscriminator";
+            "name": "InvalidSwapDiscriminator";
             "msg": "Invalid swap discriminator";
         },
         {
             "code": 6030;
-            "name": "maxDepositExceeded";
+            "name": "MaxDepositExceeded";
             "msg": "Deposit exceeds maximum allowed";
         },
         {
             "code": 6031;
-            "name": "invalidLendingAccount";
+            "name": "InvalidLendingAccount";
             "msg": "Invalid Jupiter Lend lending account";
         },
         {
             "code": 6032;
-            "name": "missingExchangeRateAccounts";
+            "name": "MissingExchangeRateAccounts";
             "msg": "Missing exchange rate accounts - lending and rewards_rate_model required for pools with Jupiter Earn";
         },
         {
             "code": 6033;
-            "name": "jupiterLendCpiFailed";
+            "name": "JupiterLendCpiFailed";
             "msg": "Jupiter Lend CPI failed";
         },
         {
             "code": 6034;
-            "name": "jupiterSwapCpiFailed";
+            "name": "JupiterSwapCpiFailed";
             "msg": "Jupiter swap CPI failed";
         },
         {
             "code": 6035;
-            "name": "oracleStale";
+            "name": "OracleStale";
             "msg": "Oracle price is stale - older than staleness threshold";
         },
         {
             "code": 6036;
-            "name": "oraclePriceNegative";
+            "name": "OraclePriceNegative";
             "msg": "Oracle returned negative price";
         },
         {
             "code": 6037;
-            "name": "invalidBaseAssetIndex";
+            "name": "InvalidBaseAssetIndex";
             "msg": "Invalid base asset index";
         },
         {
             "code": 6038;
-            "name": "priceFeedMismatch";
+            "name": "PriceFeedMismatch";
             "msg": "Price feed mismatch";
         },
         {
             "code": 6039;
-            "name": "oracleAccountInvalid";
+            "name": "OracleAccountInvalid";
             "msg": "Oracle account invalid";
         },
         {
             "code": 6040;
-            "name": "invalidAccountData";
+            "name": "InvalidAccountData";
             "msg": "Invalid account data - could not parse account";
         },
         {
             "code": 6041;
-            "name": "invalidExchangeRate";
+            "name": "InvalidExchangeRate";
             "msg": "Invalid exchange rate from Jupiter Lend";
         },
         {
             "code": 6042;
-            "name": "invalidOracleAccount";
+            "name": "InvalidOracleAccount";
             "msg": "Invalid oracle account - not owned by expected program";
         },
         {
             "code": 6043;
-            "name": "jlpPriceOutOfRange";
+            "name": "JlpPriceOutOfRange";
             "msg": "JLP price out of reasonable range ($0.50 - $50.00)";
         },
         {
             "code": 6044;
-            "name": "testModeRequired";
+            "name": "TestModeRequired";
             "msg": "Test mode required: FLAG_TEST_MODE must be set for devnet/localnet builds";
         },
         {
             "code": 6045;
-            "name": "notAdmin";
+            "name": "NotAdmin";
             "msg": "Unauthorized: not admin";
+        },
+        {
+            "code": 6046;
+            "name": "TokenAccountNotEmpty";
+            "msg": "Token account balance must be zero before closing";
+        },
+        {
+            "code": 6047;
+            "name": "TokenAccountOwnerMismatch";
+            "msg": "Token account not owned by expected PDA";
+        },
+        {
+            "code": 6048;
+            "name": "EpochEnded";
+            "msg": "Epoch has ended - call process_epoch first";
+        },
+        {
+            "code": 6049;
+            "name": "EpochNotEnded";
+            "msg": "Epoch has not ended yet";
+        },
+        {
+            "code": 6050;
+            "name": "ClaimNotAvailableYet";
+            "msg": "Claim not available yet - wait for next epoch";
+        },
+        {
+            "code": 6051;
+            "name": "InvalidEpochInterval";
+            "msg": "Withdraw epoch interval must be > 0";
+        },
+        {
+            "code": 6052;
+            "name": "ActiveWithdrawReserves";
+            "msg": "Cannot update epoch interval with active reserves";
+        },
+        {
+            "code": 6053;
+            "name": "EpochIdMismatch";
+            "msg": "Epoch ID mismatch";
+        },
+        {
+            "code": 6054;
+            "name": "WithdrawRequestNotProcessed";
+            "msg": "Withdraw request not processed yet";
+        },
+        {
+            "code": 6055;
+            "name": "WithdrawRequestAlreadyProcessed";
+            "msg": "Withdraw request already processed";
         }
     ];
     "types": [
         {
-            "name": "deposited";
+            "name": "Deposited";
             "type": {
                 "kind": "struct";
                 "fields": [
@@ -1639,7 +1946,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "direction";
+            "name": "Direction";
             "docs": [
                 "Direction of jlX token movement between STV and Vault"
             ];
@@ -1647,16 +1954,72 @@ type JlpDProgram = {
                 "kind": "enum";
                 "variants": [
                     {
-                        "name": "toVault";
+                        "name": "ToVault";
+                    },
+                    {
+                        "name": "FromVault";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "EpochAdvanced";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "stv";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "newEpochId";
+                        "type": "u32";
+                    },
+                    {
+                        "name": "newNextEpochTs";
+                        "type": "u32";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "EpochProcessed";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "stv";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "epochId";
+                        "type": "u32";
+                    },
+                    {
+                        "name": "pps";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "totalShares";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "totalBase";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "newEpochId";
+                        "type": "u32";
                     },
                     {
-                        "name": "fromVault";
+                        "name": "newNextEpochTs";
+                        "type": "u32";
                     }
                 ];
             };
         },
         {
-            "name": "feesClaimSkipped";
+            "name": "FeesClaimSkipped";
             "docs": [
                 "Event emitted when claim_fees returns early (no fees to claim)"
             ];
@@ -1681,7 +2044,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "feesClaimed";
+            "name": "FeesClaimed";
             "docs": [
                 "Fee claim event - when manager claims accrued fees"
             ];
@@ -1710,7 +2073,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "initOrUpdateJlpVaultParams";
+            "name": "InitOrUpdateJlpVaultParams";
             "docs": [
                 "Parameters for initializing or updating the JLP Vault"
             ];
@@ -1806,7 +2169,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "initializeStvParams";
+            "name": "InitializeStvParams";
             "docs": [
                 "Parameters for initializing an STV"
             ];
@@ -1840,12 +2203,19 @@ type JlpDProgram = {
                             "Minimum deposit amount in base asset (0 = no minimum)"
                         ];
                         "type": "u64";
+                    },
+                    {
+                        "name": "epochSec";
+                        "docs": [
+                            "Epoch duration in seconds for delayed withdrawals"
+                        ];
+                        "type": "u32";
                     }
                 ];
             };
         },
         {
-            "name": "jlpVault";
+            "name": "JLPVault";
             "docs": [
                 "JLPVault - Global vault configuration account",
                 "Seeds: [\"jlp_vault\"]",
@@ -1968,7 +2338,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "jlpSwapped";
+            "name": "JlpSwapped";
             "type": {
                 "kind": "struct";
                 "fields": [
@@ -2007,7 +2377,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "jlpVaultInitialized";
+            "name": "JlpVaultInitialized";
             "type": {
                 "kind": "struct";
                 "fields": [
@@ -2035,7 +2405,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "jlpVaultUpdated";
+            "name": "JlpVaultUpdated";
             "type": {
                 "kind": "struct";
                 "fields": [
@@ -2087,7 +2457,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "jlxMoved";
+            "name": "JlxMoved";
             "type": {
                 "kind": "struct";
                 "fields": [
@@ -2135,7 +2505,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "jlxSwapped";
+            "name": "JlxSwapped";
             "type": {
                 "kind": "struct";
                 "fields": [
@@ -2167,7 +2537,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "jupEarnDirection";
+            "name": "JupEarnDirection";
             "docs": [
                 "Direction for Jupiter Earn operations"
             ];
@@ -2175,16 +2545,16 @@ type JlpDProgram = {
                 "kind": "enum";
                 "variants": [
                     {
-                        "name": "deposit";
+                        "name": "Deposit";
                     },
                     {
-                        "name": "withdraw";
+                        "name": "Withdraw";
                     }
                 ];
             };
         },
         {
-            "name": "jupEarnEvent";
+            "name": "JupEarnEvent";
             "docs": [
                 "Event emitted for Jupiter Earn deposit/withdraw operations"
             ];
@@ -2223,7 +2593,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "jupEarnParams";
+            "name": "JupEarnParams";
             "docs": [
                 "Parameters for Jupiter Earn deposit/withdraw"
             ];
@@ -2237,7 +2607,7 @@ type JlpDProgram = {
                         ];
                         "type": {
                             "defined": {
-                                "name": "jupEarnDirection";
+                                "name": "JupEarnDirection";
                             };
                         };
                     },
@@ -2252,7 +2622,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "moveJlxParams";
+            "name": "MoveJlxParams";
             "docs": [
                 "Parameters for moving jlX tokens between STV and Vault"
             ];
@@ -2273,7 +2643,7 @@ type JlpDProgram = {
                         ];
                         "type": {
                             "defined": {
-                                "name": "direction";
+                                "name": "Direction";
                             };
                         };
                     }
@@ -2281,11 +2651,11 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "stv";
+            "name": "STV";
             "docs": [
                 "STV - Single Token Vault account",
                 "Seeds: [\"stv\", base_mint.key().as_ref()]",
-                "Size: 8 (discriminator) + 160 (data) = 168 bytes"
+                "Size: 8 (discriminator) + 200 (data) = 208 bytes"
             ];
             "serialization": "bytemuck";
             "repr": {
@@ -2367,6 +2737,50 @@ type JlpDProgram = {
                         ];
                         "type": "u64";
                     },
+                    {
+                        "name": "requestedBase";
+                        "docs": [
+                            "Estimated base for current epoch's withdrawal requests (reset on process_epoch)",
+                            "Manager reads this to know how much to unwind before next epoch"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "reservedBase";
+                        "docs": [
+                            "Base earmarked for unclaimed withdrawals (+process_epoch, -claim_withdraw)",
+                            "Subtracted from NAV so reserved funds don't inflate PPS"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "epochPps";
+                        "docs": [
+                            "PPS locked at first process_epoch batch (0 = not set, reset on epoch advance)"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "nextEpochTs";
+                        "docs": [
+                            "Unix timestamp when current epoch ends"
+                        ];
+                        "type": "u32";
+                    },
+                    {
+                        "name": "epochSec";
+                        "docs": [
+                            "Epoch duration in seconds"
+                        ];
+                        "type": "u32";
+                    },
+                    {
+                        "name": "currentEpochId";
+                        "docs": [
+                            "Incrementing epoch counter"
+                        ];
+                        "type": "u32";
+                    },
                     {
                         "name": "mgmtFeeBps";
                         "docs": [
@@ -2401,12 +2815,24 @@ type JlpDProgram = {
                             "PDA bump seed"
                         ];
                         "type": "u8";
+                    },
+                    {
+                        "name": "Padding";
+                        "docs": [
+                            "Alignment padding"
+                        ];
+                        "type": {
+                            "array": [
+                                "u8",
+                                4
+                            ];
+                        };
                     }
                 ];
             };
         },
         {
-            "name": "settleYieldEvent";
+            "name": "SettleYieldEvent";
             "docs": [
                 "Aggregate yield settlement event - emitted once per settle_yield call"
             ];
@@ -2459,7 +2885,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "settleYieldSkipped";
+            "name": "SettleYieldSkipped";
             "docs": [
                 "Event emitted when settle_yield returns early (no loans outstanding)"
             ];
@@ -2484,7 +2910,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "settleYieldStvEvent";
+            "name": "SettleYieldStvEvent";
             "docs": [
                 "Per-STV yield settlement event - emitted for each STV with non-zero base_loaned"
             ];
@@ -2530,7 +2956,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "stvInitialized";
+            "name": "StvInitialized";
             "type": {
                 "kind": "struct";
                 "fields": [
@@ -2554,7 +2980,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "stvUpdated";
+            "name": "StvUpdated";
             "type": {
                 "kind": "struct";
                 "fields": [
@@ -2618,7 +3044,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "swapDirection";
+            "name": "SwapDirection";
             "docs": [
                 "Direction of the swap operation"
             ];
@@ -2626,16 +3052,16 @@ type JlpDProgram = {
                 "kind": "enum";
                 "variants": [
                     {
-                        "name": "jlxToJlp";
+                        "name": "JlxToJlp";
                     },
                     {
-                        "name": "jlpToJlx";
+                        "name": "JlpToJlx";
                     }
                 ];
             };
         },
         {
-            "name": "swapJlxJlpParams";
+            "name": "SwapJlxJlpParams";
             "docs": [
                 "Parameters for the swap instruction"
             ];
@@ -2656,7 +3082,7 @@ type JlpDProgram = {
                         ];
                         "type": {
                             "defined": {
-                                "name": "swapDirection";
+                                "name": "SwapDirection";
                             };
                         };
                     },
@@ -2687,7 +3113,7 @@ type JlpDProgram = {
             };
         },
         {
-            "name": "updateStvParams";
+            "name": "UpdateStvParams";
             "docs": [
                 "Parameters for updating an STV"
             ];
@@ -2764,12 +3190,21 @@ type JlpDProgram = {
                         "type": {
                             "option": "u64";
                         };
+                    },
+                    {
+                        "name": "epochSec";
+                        "docs": [
+                            "Optional new epoch duration in seconds"
+                        ];
+                        "type": {
+                            "option": "u32";
+                        };
                     }
                 ];
             };
         },
         {
-            "name": "withdrawn";
+            "name": "WithdrawClaimed";
             "type": {
                 "kind": "struct";
                 "fields": [
@@ -2782,19 +3217,113 @@ type JlpDProgram = {
                         "type": "pubkey";
                     },
                     {
-                        "name": "sharesBurned";
+                        "name": "shares";
                         "type": "u64";
                     },
                     {
-                        "name": "amountBase";
+                        "name": "baseAmount";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "epochId";
+                        "type": "u32";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "WithdrawRequest";
+            "docs": [
+                "WithdrawRequest - Per-user per-epoch withdrawal request",
+                "Seeds: [\"withdraw_request\", stv.key(), user.key(), &epoch_id.to_le_bytes()]",
+                "",
+                "One PDA per user per STV per epoch. Multiple request_withdraw calls",
+                "in the same epoch accumulate into the same PDA.",
+                "",
+                "Lifecycle:",
+                "1. Created by request_withdraw (user escrows jvX into request's ATA)",
+                "2. Processed by process_epoch (jvX burned, pps + claim_available_after set)",
+                "3. Closed by claim_withdraw (base transferred, PDA + ATA closed)"
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "stv";
+                        "docs": [
+                            "Back-reference to the STV"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "user";
+                        "docs": [
+                            "The user who requested the withdrawal"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "shares";
                         "docs": [
-                            "Amount of base asset withdrawn"
+                            "Total jvX shares escrowed (accumulated across multiple requests in same epoch)"
                         ];
                         "type": "u64";
                     },
                     {
                         "name": "pps";
+                        "docs": [
+                            "PPS at process time (0 = unprocessed)"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "epochId";
+                        "docs": [
+                            "Epoch when request was made"
+                        ];
+                        "type": "u32";
+                    },
+                    {
+                        "name": "claimAvailableAfter";
+                        "docs": [
+                            "Unix timestamp after which claim is available (0 = unprocessed)"
+                        ];
+                        "type": "u32";
+                    },
+                    {
+                        "name": "bump";
+                        "docs": [
+                            "PDA bump seed"
+                        ];
+                        "type": "u8";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "WithdrawRequested";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "stv";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "user";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "shares";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "totalShares";
                         "type": "u64";
+                    },
+                    {
+                        "name": "epochId";
+                        "type": "u32";
                     }
                 ];
             };
@@ -2830,12 +3359,27 @@ interface STV {
     accruedFeesJlx: BN;
     maxDeposit: BN;
     minDeposit: BN;
+    requestedBase: BN;
+    reservedBase: BN;
+    epochPps: BN;
+    nextEpochTs: number;
+    epochSec: number;
+    currentEpochId: number;
     mgmtFeeBps: number;
     perfFeeBps: number;
     flags: number;
     version: number;
     bump: number;
 }
+interface WithdrawRequest {
+    stv: PublicKey;
+    user: PublicKey;
+    shares: BN;
+    pps: BN;
+    epochId: number;
+    claimAvailableAfter: number;
+    bump: number;
+}
 interface ExchangeRateResult {
     rate: number;
     rawRate: bigint;
@@ -2921,6 +3465,7 @@ interface UpdateStvParams$1 {
     pps?: BN;
     hwm?: BN;
     baseLoaned?: BN;
+    epochSec?: number;
 }
 interface InitializeStvParams$1 {
     poolName: PoolName;
@@ -2928,6 +3473,7 @@ interface InitializeStvParams$1 {
     perfFeeBps: number;
     maxDeposit: BN;
     minDeposit: BN;
+    withdrawEpochSec: number;
 }
 interface JupiterQuoteResponse {
     inputMint: string;
@@ -2985,10 +3531,14 @@ interface DepositParams {
     user: PublicKey;
     amount: BN;
 }
-interface WithdrawParams {
+interface RequestWithdrawParams {
     user: PublicKey;
     shares: BN;
 }
+interface ClaimWithdrawParams {
+    user: PublicKey;
+    epochId: number;
+}
 interface JupEarnParams$1 {
     manager: PublicKey;
     direction: JupEarnDirection;
@@ -3013,6 +3563,11 @@ interface SwapJlxJlpParams$1 {
 interface SettleYieldParams {
     manager: PublicKey;
 }
+interface ProcessEpochParams {
+    payer: PublicKey;
+    poolName: PoolName;
+    withdrawRequests: PublicKey[];
+}
 /**
  * Main SDK client for JLP.D program
  */
@@ -3083,7 +3638,8 @@ declare class PoolContext {
     readonly stvJlxAta: PublicKey;
     constructor(client: JlpdClient, pool: JupiterLendPool);
     deposit(params: DepositParams): Promise<VersionedTransaction>;
-    withdraw(params: WithdrawParams): Promise<VersionedTransaction>;
+    requestWithdraw(params: RequestWithdrawParams): Promise<VersionedTransaction>;
+    claimWithdraw(params: ClaimWithdrawParams): Promise<VersionedTransaction>;
     jupEarn(params: JupEarnParams$1): Promise<VersionedTransaction>;
     moveJlx(params: MoveJlxParams$1): Promise<VersionedTransaction>;
     claimFees(params: ClaimFeesParams): Promise<VersionedTransaction>;
@@ -3117,6 +3673,7 @@ declare class AdminContext {
     initializeStv(params: {
         admin: PublicKey;
     } & InitializeStvParams$1, jvMintKeypair: PublicKey): Promise<VersionedTransaction>;
+    processEpoch(params: ProcessEpochParams): Promise<VersionedTransaction>;
     settleYield(params: SettleYieldParams): Promise<VersionedTransaction>;
 }
 
@@ -3132,6 +3689,7 @@ declare const JUPITER_LEND_PROGRAM_ID$1: PublicKey;
 declare const JUPITER_SWAP_PROGRAM_ID: PublicKey;
 declare const SEED_JLP_VAULT = "jlp_vault";
 declare const SEED_STV = "stv";
+declare const SEED_WITHDRAW_REQUEST = "withdraw_request";
 declare const FLAG_PAUSED = 1;
 declare const FLAG_DEPOSITS_DISABLED = 2;
 declare const FLAG_WITHDRAWALS_DISABLED = 4;
@@ -3172,6 +3730,11 @@ declare function deriveVaultPda(programId: PublicKey): [PublicKey, number];
  * Seeds: ["stv", base_mint]
  */
 declare function deriveStvPda(baseMint: PublicKey, programId: PublicKey): [PublicKey, number];
+/**
+ * Derive WithdrawRequest PDA address (cached)
+ * Seeds: ["withdraw_request", stv, user, epoch_id.to_le_bytes()]
+ */
+declare function deriveWithdrawRequestPda(stvPda: PublicKey, user: PublicKey, epochId: number, programId: PublicKey): [PublicKey, number];
 /**
  * Clear PDA cache (useful for testing)
  */
@@ -3189,9 +3752,33 @@ declare const JLP_VAULT_DISCRIMINATOR: Buffer<ArrayBuffer>;
 declare function parseVault(data: Buffer): JLPVault;
 
 /**
- * STV (Single Token Vault) account layout (160 bytes data + 8 byte discriminator = 168 bytes total)
+ * STV (Single Token Vault) account layout (200 bytes data + 8 byte discriminator = 208 bytes total)
+ *
+ * Layout (data starts after 8-byte discriminator):
+ * Offset 0-31:   baseMint (Pubkey)
+ * Offset 32-63:  jlMint (Pubkey)
+ * Offset 64-95:  jvMint (Pubkey)
+ * Offset 96-103: pps (u64 LE)
+ * Offset 104-111: hwm (u64 LE)
+ * Offset 112-119: lastMgmtFeeTs (u64 LE)
+ * Offset 120-127: baseLoaned (u64 LE)
+ * Offset 128-135: accruedFeesJlx (u64 LE)
+ * Offset 136-143: maxDeposit (u64 LE)
+ * Offset 144-151: minDeposit (u64 LE)
+ * Offset 152-159: requestedBase (u64 LE)
+ * Offset 160-167: reservedBase (u64 LE)
+ * Offset 168-175: epochPps (u64 LE)
+ * Offset 176-179: nextEpochTs (u32 LE)
+ * Offset 180-183: epochSec (u32 LE)
+ * Offset 184-187: currentEpochId (u32 LE)
+ * Offset 188-189: mgmtFeeBps (u16 LE)
+ * Offset 190-191: perfFeeBps (u16 LE)
+ * Offset 192-193: flags (u16 LE)
+ * Offset 194:     version (u8)
+ * Offset 195:     bump (u8)
+ * Offset 196-199: _padding (4 bytes)
  */
-declare const STV_DATA_SIZE = 160;
+declare const STV_DATA_SIZE = 200;
 declare const STV_ACCOUNT_SIZE: number;
 declare const STV_DISCRIMINATOR: Buffer<ArrayBuffer>;
 /**
@@ -3199,6 +3786,27 @@ declare const STV_DISCRIMINATOR: Buffer<ArrayBuffer>;
  */
 declare function parseStv(data: Buffer): STV;
 
+/**
+ * WithdrawRequest account layout
+ * Seeds: ["withdraw_request", stv, user, epoch_id.to_le_bytes()]
+ *
+ * Layout (data starts after 8-byte discriminator):
+ * Offset 0-31:  stv (Pubkey)
+ * Offset 32-63: user (Pubkey)
+ * Offset 64-71: shares (u64 LE)
+ * Offset 72-79: pps (u64 LE) — 0 = unprocessed
+ * Offset 80-83: epochId (u32 LE)
+ * Offset 84-87: claimAvailableAfter (u32 LE) — 0 = unprocessed
+ * Offset 88:    bump (u8)
+ */
+declare const WITHDRAW_REQUEST_DATA_SIZE = 89;
+declare const WITHDRAW_REQUEST_ACCOUNT_SIZE: number;
+declare const WITHDRAW_REQUEST_DISCRIMINATOR: Buffer<ArrayBuffer>;
+/**
+ * Parse a WithdrawRequest account from raw account data
+ */
+declare function parseWithdrawRequest(data: Buffer): WithdrawRequest;
+
 /**
  * Derive ATA address (cached)
  */
@@ -3231,9 +3839,15 @@ declare function clearAtaCache(): void;
 
 /**
  * Calculate NAV for an STV
- * NAV = stv_base_ata.amount + (stv_jlx_ata.amount * exchange_rate / 1e12) + base_loaned
+ * NAV = stv_base_ata.amount + (stv_jlx_ata.amount * exchange_rate / 1e12) + base_loaned - reserved_base
+ *
+ * @param stvBaseBalance - STV base token balance
+ * @param stvJlxBalance - STV jlX token balance
+ * @param exchangeRate - Jupiter Lend exchange rate (12 decimals)
+ * @param baseLoaned - Base loaned to vault
+ * @param reservedBase - Optional: base earmarked for unclaimed processed withdrawals (subtracted from NAV)
  */
-declare function calculateNav(stvBaseBalance: BN, stvJlxBalance: BN, exchangeRate: bigint, baseLoaned: BN): BN;
+declare function calculateNav(stvBaseBalance: BN, stvJlxBalance: BN, exchangeRate: bigint, baseLoaned: BN, reservedBase?: BN): BN;
 /**
  * Calculate PPS from NAV and total jvX supply
  * PPS = NAV * PPS_DECIMALS / total_jvx_supply
@@ -3394,6 +4008,7 @@ interface InitializeStvParams {
     perfFeeBps: number;
     maxDeposit: BN;
     minDeposit: BN;
+    epochSec: number;
 }
 interface UpdateStvParams {
     mgmtFeeBps: number;
@@ -3405,6 +4020,7 @@ interface UpdateStvParams {
     pps: BN | null;
     hwm: BN | null;
     baseLoaned: BN | null;
+    epochSec: number | null;
 }
 interface InitOrUpdateJlpVaultAccounts {
     admin: PublicKey;
@@ -3439,17 +4055,27 @@ interface DepositAccounts {
     stvJlxAta: PublicKey;
     tokenProgram: PublicKey;
 }
-interface WithdrawAccounts {
+interface RequestWithdrawAccounts {
     user: PublicKey;
     jlpVault: PublicKey;
     stv: PublicKey;
+    jvMint: PublicKey;
+    userJvxAta: PublicKey;
+    withdrawRequest: PublicKey;
+    requestJvxAta: PublicKey;
+    tokenProgram: PublicKey;
+    associatedTokenProgram: PublicKey;
+    systemProgram: PublicKey;
+}
+interface ClaimWithdrawAccounts {
+    user: PublicKey;
+    stv: PublicKey;
     baseMint: PublicKey;
-    jlMint: PublicKey;
     jvMint: PublicKey;
     userBaseAta: PublicKey;
-    userJvxAta: PublicKey;
     stvBaseAta: PublicKey;
-    stvJlxAta: PublicKey;
+    withdrawRequest: PublicKey;
+    requestJvxAta: PublicKey;
     tokenProgram: PublicKey;
 }
 /**
@@ -3457,9 +4083,18 @@ interface WithdrawAccounts {
  */
 declare function createDepositInstruction(program: Program<JlpDProgram>, amount: BN, accounts: DepositAccounts, remainingAccounts?: AccountMeta[]): Promise<TransactionInstruction>;
 /**
- * Create a withdraw instruction
+ * Create a request_withdraw instruction.
+ * Escrows the user's jvX shares into the WithdrawRequest PDA's ATA for the current epoch.
  */
-declare function createWithdrawInstruction(program: Program<JlpDProgram>, sharesToBurn: BN, accounts: WithdrawAccounts, remainingAccounts?: AccountMeta[]): Promise<TransactionInstruction>;
+declare function createRequestWithdrawInstruction(program: Program<JlpDProgram>, params: {
+    shares: BN;
+    epochId: number;
+}, accounts: RequestWithdrawAccounts): Promise<TransactionInstruction>;
+/**
+ * Create a claim_withdraw instruction.
+ * Claims base tokens for a processed WithdrawRequest, closing the PDA.
+ */
+declare function createClaimWithdrawInstruction(program: Program<JlpDProgram>, accounts: ClaimWithdrawAccounts): Promise<TransactionInstruction>;
 
 interface JupEarnParams {
     direction: JupEarnDirection;
@@ -3530,6 +4165,18 @@ interface SettleYieldInstructionParams {
 declare function createJupEarnInstruction(program: Program<JlpDProgram>, params: JupEarnParams, accounts: JupEarnAccounts, remainingAccounts?: AccountMeta[]): Promise<TransactionInstruction>;
 declare function createMoveJlxInstruction(program: Program<JlpDProgram>, params: MoveJlxParams, accounts: MoveStvAccounts, remainingAccounts?: AccountMeta[]): Promise<TransactionInstruction>;
 declare function createSwapJlxJlpInstruction(program: Program<JlpDProgram>, params: SwapJlxJlpParams, accounts: SwapJlxJlpAccounts, remainingAccounts?: AccountMeta[]): Promise<TransactionInstruction>;
+interface ProcessEpochAccounts {
+    payer: PublicKey;
+    jlpVault: PublicKey;
+    stv: PublicKey;
+    baseMint: PublicKey;
+    jlMint: PublicKey;
+    jvMint: PublicKey;
+    stvBaseAta: PublicKey;
+    stvJlxAta: PublicKey;
+    tokenProgram: PublicKey;
+}
+declare function createProcessEpochInstruction(program: Program<JlpDProgram>, accounts: ProcessEpochAccounts, remainingAccounts?: AccountMeta[]): Promise<TransactionInstruction>;
 declare function createSettleYieldInstruction(program: Program<JlpDProgram>, params: SettleYieldInstructionParams, accounts: SettleYieldAccounts, remainingAccounts?: AccountMeta[]): Promise<TransactionInstruction>;
 
 interface ClaimFeesAccounts {
@@ -3549,4 +4196,4 @@ interface ClaimFeesAccounts {
  */
 declare function createClaimFeesInstruction(program: Program<JlpDProgram>, accounts: ClaimFeesAccounts, remainingAccounts?: AccountMeta[]): Promise<TransactionInstruction>;
 
-export { type AccountMeta, AdminContext, type ClaimFeesAccounts, type ClaimFeesParams, type DepositAccounts, type DepositParams, EXCHANGE_RATE_PRECISION, type ExchangeRateResult, FLAG_DEPOSITS_DISABLED, FLAG_JLP_DISABLED, FLAG_PAUSED, FLAG_REBALANCE_DISABLED, FLAG_WITHDRAWALS_DISABLED, type InitOrUpdateJlpVaultAccounts, type InitOrUpdateJlpVaultParams, type InitializeStvAccounts, type InitializeStvParams$1 as InitializeStvParams, JLPD_PROGRAM_ID, type JLPVault, JLP_POOL_PUBKEY, JLP_VAULT_ACCOUNT_SIZE, JLP_VAULT_DATA_SIZE, JLP_VAULT_DISCRIMINATOR, JUPITER_LEND_PROGRAM_ID$1 as JUPITER_LEND_PROGRAM_ID, JUPITER_PERPS_PROGRAM_ID, JUPITER_SWAP_PROGRAM_ID, JUPUSD_POOL, JUPITER_LEND_PROGRAM_ID as JUP_LEND_PROGRAM_ID, type JlpDProgram, JlpdClient, JlpdClientError, type JupEarnAccounts, type JupEarnDirection, type JupEarnParams$1 as JupEarnParams, type JupiterLendPool, type JupiterPriceData, type JupiterPriceResponse, type JupiterQuoteResponse, type JupiterSwapInstructionsResponse, LENDING_ADMIN, LIQUIDITY_PROGRAM_ID, LIQUIDITY_SINGLETON, type LendingAccountData, MINTS, type MoveDirection, type MoveJlxParams$1 as MoveJlxParams, type MoveStvAccounts, ORACLES, POOLS, PPS_DECIMALS, PoolContext, type PoolName, type RewardsRateModelData, SEED_JLP_VAULT, SEED_STV, type STV, STV_ACCOUNT_SIZE, STV_DATA_SIZE, STV_DISCRIMINATOR, STV_INDEX, type SerializedInstruction, type SettleYieldAccounts, type SettleYieldInstructionParams, type SettleYieldParams, SwapContext, type SwapDirection, type SwapJlxJlpAccounts, type SwapJlxJlpParams$1 as SwapJlxJlpParams, type SwapQuote, USDC_POOL, type UpdateStvAccounts, type UpdateStvParams$1 as UpdateStvParams, type UpdateVaultParams, WBTC_POOL, WETH_POOL, WSOL_POOL, type WithdrawAccounts, type WithdrawParams, baseToJlx, baseToShares, buildExchangeRateAccounts, buildJupEarnDepositAccounts, buildJupEarnWithdrawAccounts, buildSwapData, calculateExchangeRate, calculateNav, calculatePps, clearAtaCache, clearPdaCache, createClaimFeesInstruction, createDepositInstruction, createInitOrUpdateVaultInstruction, createInitializeStvInstruction, createJupEarnInstruction, createMoveJlxInstruction, createProgram, createSettleYieldInstruction, createSwapJlxJlpInstruction, createUpdateStvInstruction, createWithdrawInstruction, deriveAta, deriveStvAtas, deriveStvPda, deriveUserAtas, deriveVaultAtas, deriveVaultPda, fetchAddressLookupTables, fetchJlpRate, fetchJupiterPriceUsd, getJupiterQuote, getJupiterSwapInstructions, getPoolByMint, getPoolByName, jlxToBase, parseLendingAccount, parseRewardsRateModel, parseStv, parseSwapRemainingAccounts, parseVault, sharesToBase };
+export { type AccountMeta, AdminContext, type ClaimFeesAccounts, type ClaimFeesParams, type ClaimWithdrawAccounts, type ClaimWithdrawParams, type DepositAccounts, type DepositParams, EXCHANGE_RATE_PRECISION, type ExchangeRateResult, FLAG_DEPOSITS_DISABLED, FLAG_JLP_DISABLED, FLAG_PAUSED, FLAG_REBALANCE_DISABLED, FLAG_WITHDRAWALS_DISABLED, type InitOrUpdateJlpVaultAccounts, type InitOrUpdateJlpVaultParams, type InitializeStvAccounts, type InitializeStvParams$1 as InitializeStvParams, JLPD_PROGRAM_ID, type JLPVault, JLP_POOL_PUBKEY, JLP_VAULT_ACCOUNT_SIZE, JLP_VAULT_DATA_SIZE, JLP_VAULT_DISCRIMINATOR, JUPITER_LEND_PROGRAM_ID$1 as JUPITER_LEND_PROGRAM_ID, JUPITER_PERPS_PROGRAM_ID, JUPITER_SWAP_PROGRAM_ID, JUPUSD_POOL, JUPITER_LEND_PROGRAM_ID as JUP_LEND_PROGRAM_ID, type JlpDProgram, JlpdClient, JlpdClientError, type JupEarnAccounts, type JupEarnDirection, type JupEarnParams$1 as JupEarnParams, type JupiterLendPool, type JupiterPriceData, type JupiterPriceResponse, type JupiterQuoteResponse, type JupiterSwapInstructionsResponse, LENDING_ADMIN, LIQUIDITY_PROGRAM_ID, LIQUIDITY_SINGLETON, type LendingAccountData, MINTS, type MoveDirection, type MoveJlxParams$1 as MoveJlxParams, type MoveStvAccounts, ORACLES, POOLS, PPS_DECIMALS, PoolContext, type PoolName, type ProcessEpochAccounts, type ProcessEpochParams, type RequestWithdrawAccounts, type RequestWithdrawParams, type RewardsRateModelData, SEED_JLP_VAULT, SEED_STV, SEED_WITHDRAW_REQUEST, type STV, STV_ACCOUNT_SIZE, STV_DATA_SIZE, STV_DISCRIMINATOR, STV_INDEX, type SerializedInstruction, type SettleYieldAccounts, type SettleYieldInstructionParams, type SettleYieldParams, SwapContext, type SwapDirection, type SwapJlxJlpAccounts, type SwapJlxJlpParams$1 as SwapJlxJlpParams, type SwapQuote, USDC_POOL, type UpdateStvAccounts, type UpdateStvParams$1 as UpdateStvParams, type UpdateVaultParams, WBTC_POOL, WETH_POOL, WITHDRAW_REQUEST_ACCOUNT_SIZE, WITHDRAW_REQUEST_DATA_SIZE, WITHDRAW_REQUEST_DISCRIMINATOR, WSOL_POOL, type WithdrawRequest, baseToJlx, baseToShares, buildExchangeRateAccounts, buildJupEarnDepositAccounts, buildJupEarnWithdrawAccounts, buildSwapData, calculateExchangeRate, calculateNav, calculatePps, clearAtaCache, clearPdaCache, createClaimFeesInstruction, createClaimWithdrawInstruction, createDepositInstruction, createInitOrUpdateVaultInstruction, createInitializeStvInstruction, createJupEarnInstruction, createMoveJlxInstruction, createProcessEpochInstruction, createProgram, createRequestWithdrawInstruction, createSettleYieldInstruction, createSwapJlxJlpInstruction, createUpdateStvInstruction, deriveAta, deriveStvAtas, deriveStvPda, deriveUserAtas, deriveVaultAtas, deriveVaultPda, deriveWithdrawRequestPda, fetchAddressLookupTables, fetchJlpRate, fetchJupiterPriceUsd, getJupiterQuote, getJupiterSwapInstructions, getPoolByMint, getPoolByName, jlxToBase, parseLendingAccount, parseRewardsRateModel, parseStv, parseSwapRemainingAccounts, parseVault, parseWithdrawRequest, sharesToBase };