@exponent-labs/exponent-clmm-idl 0.9.24 → 0.9.25

package/build/exponent_clmm.d.ts

@@ -1219,7 +1219,7 @@ export type ExponentClmm = {
             ];
             "returns": {
                 "defined": {
-                    "name": "tradePtEvent";
+                    "name": "tradePtReturnData";
                 };
             };
         },
@@ -1325,7 +1325,7 @@ export type ExponentClmm = {
             ];
             "returns": {
                 "defined": {
-                    "name": "tradePtEvent";
+                    "name": "tradePtReturnData";
                 };
             };
         },
@@ -2371,6 +2371,19 @@ export type ExponentClmm = {
                 174
             ];
         },
+        {
+            "name": "tradePtReturnData";
+            "discriminator": [
+                26,
+                64,
+                30,
+                82,
+                98,
+                163,
+                184,
+                31
+            ];
+        },
         {
             "name": "withdrawLiquidityEvent";
             "discriminator": [
@@ -2669,6 +2682,21 @@ export type ExponentClmm = {
             "code": 6035;
             "name": "crossingEqualizationInvariantViolated";
             "msg": "Crossing equalization invariants were violated";
+        },
+        {
+            "code": 6036;
+            "name": "missingVaultForPyIndex";
+            "msg": "Vault account required to resolve py_index";
+        },
+        {
+            "code": 6037;
+            "name": "invalidSyExchangeRate";
+            "msg": "SY exchange rate must be positive";
+        },
+        {
+            "code": 6038;
+            "name": "crossingLiquidityWouldRoundToZero";
+            "msg": "Partial withdrawal would round crossing liquidity to zero; withdraw the full position instead";
         }
     ];
     "types": [
@@ -2989,7 +3017,7 @@ export type ExponentClmm = {
                         "type": {
                             "array": [
                                 "u8",
-                                1024
+                                1023
                             ];
                         };
                     }
@@ -3543,29 +3571,44 @@ export type ExponentClmm = {
                 "fields": [
                     {
                         "name": "windowStartTimestamp";
+                        "docs": [
+                            "Last timestamp at which the withdrawal bucket was evaluated.",
+                            "",
+                            "The legacy field name is retained to preserve generated client compatibility."
+                        ];
                         "type": "u32";
                     },
                     {
                         "name": "windowStartNetBalance";
+                        "docs": [
+                            "Remaining normalized PT-equivalent withdrawal capacity.",
+                            "",
+                            "The legacy field name is retained to preserve generated client compatibility."
+                        ];
                         "type": "u64";
                     },
                     {
                         "name": "maxNetBalanceChangeNegativePercentage";
                         "docs": [
-                            "Maximum allowed negative change in basis points (10000 = 100%)"
+                            "Maximum withdrawal capacity in basis points of the market's normalized value."
                         ];
                         "type": "u16";
                     },
                     {
                         "name": "maxNetBalanceChangePositivePercentage";
                         "docs": [
-                            "Maximum allowed positive change in basis points (10000 = 100%)",
-                            "Using u32 to allow for very large increases (up to ~429,496%)"
+                            "Fractional refill numerator carried between withdrawals.",
+                            "",
+                            "This prevents the realized refill rate from depending on how frequently withdrawals occur.",
+                            "The legacy field name is retained to preserve generated client compatibility."
                         ];
                         "type": "u32";
                     },
                     {
                         "name": "windowDurationSeconds";
+                        "docs": [
+                            "Time required for an empty withdrawal bucket to refill completely."
+                        ];
                         "type": "u32";
                     }
                 ];
@@ -3810,14 +3853,23 @@ export type ExponentClmm = {
                         "fields": [
                             {
                                 "name": "maxNetBalanceChangeNegativePercentage";
+                                "docs": [
+                                    "Maximum normalized gross withdrawal, in basis points of market value."
+                                ];
                                 "type": "u16";
                             },
                             {
                                 "name": "maxNetBalanceChangePositivePercentage";
+                                "docs": [
+                                    "Retained for instruction compatibility. The token-bucket limiter does not use it."
+                                ];
                                 "type": "u32";
                             },
                             {
                                 "name": "windowDurationSeconds";
+                                "docs": [
+                                    "Seconds required for an empty withdrawal bucket to refill completely."
+                                ];
                                 "type": "u32";
                             }
                         ];
@@ -4162,6 +4214,10 @@ export type ExponentClmm = {
                             };
                         };
                     },
+                    {
+                        "name": "selfCpiStatus";
+                        "type": "u8";
+                    },
                     {
                         "name": "financials";
                         "type": {
@@ -4958,6 +5014,22 @@ export type ExponentClmm = {
                 ];
             };
         },
+        {
+            "name": "tradePtReturnData";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "amountIn";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "amountOut";
+                        "type": "u64";
+                    }
+                ];
+            };
+        },
         {
             "name": "vault";
             "type": {
@@ -5065,7 +5137,7 @@ export type ExponentClmm = {
                         "name": "lastSeenSyExchangeRate";
                         "docs": [
                             "Last seen SY exchange rate",
-                            "This continues to be updated even after vault maturity to track SY appreciation for treasury collection"
+                            "This continues to be updated after maturity for PT redemption"
                         ];
                         "type": {
                             "defined": {
@@ -5076,7 +5148,7 @@ export type ExponentClmm = {
                     {
                         "name": "allTimeHighSyExchangeRate";
                         "docs": [
-                            "This is the all time high exchange rate for SY"
+                            "This is the all time high exchange rate for SY while the vault is not expired"
                         ];
                         "type": {
                             "defined": {
@@ -5087,7 +5159,9 @@ export type ExponentClmm = {
                     {
                         "name": "finalSyExchangeRate";
                         "docs": [
-                            "This is the exchange rate for SY when the vault expires"
+                            "Final PY index captured for YT interest at maturity.",
+                            "This is the highest observed SY exchange rate while the vault is active,",
+                            "not necessarily the live exchange rate at the last pre-expiry update."
                         ];
                         "type": {
                             "defined": {

package/build/exponent_clmm.json

@@ -1213,7 +1213,7 @@
             ],
             "returns": {
                 "defined": {
-                    "name": "TradePtEvent"
+                    "name": "TradePtReturnData"
                 }
             }
         },
@@ -1319,7 +1319,7 @@
             ],
             "returns": {
                 "defined": {
-                    "name": "TradePtEvent"
+                    "name": "TradePtReturnData"
                 }
             }
         },
@@ -2365,6 +2365,19 @@
                 174
             ]
         },
+        {
+            "name": "TradePtReturnData",
+            "discriminator": [
+                26,
+                64,
+                30,
+                82,
+                98,
+                163,
+                184,
+                31
+            ]
+        },
         {
             "name": "WithdrawLiquidityEvent",
             "discriminator": [
@@ -2663,6 +2676,21 @@
             "code": 6035,
             "name": "CrossingEqualizationInvariantViolated",
             "msg": "Crossing equalization invariants were violated"
+        },
+        {
+            "code": 6036,
+            "name": "MissingVaultForPyIndex",
+            "msg": "Vault account required to resolve py_index"
+        },
+        {
+            "code": 6037,
+            "name": "InvalidSyExchangeRate",
+            "msg": "SY exchange rate must be positive"
+        },
+        {
+            "code": 6038,
+            "name": "CrossingLiquidityWouldRoundToZero",
+            "msg": "Partial withdrawal would round crossing liquidity to zero; withdraw the full position instead"
         }
     ],
     "types": [
@@ -2983,7 +3011,7 @@
                         "type": {
                             "array": [
                                 "u8",
-                                1024
+                                1023
                             ]
                         }
                     }
@@ -3537,29 +3565,44 @@
                 "fields": [
                     {
                         "name": "window_start_timestamp",
+                        "docs": [
+                            "Last timestamp at which the withdrawal bucket was evaluated.",
+                            "",
+                            "The legacy field name is retained to preserve generated client compatibility."
+                        ],
                         "type": "u32"
                     },
                     {
                         "name": "window_start_net_balance",
+                        "docs": [
+                            "Remaining normalized PT-equivalent withdrawal capacity.",
+                            "",
+                            "The legacy field name is retained to preserve generated client compatibility."
+                        ],
                         "type": "u64"
                     },
                     {
                         "name": "max_net_balance_change_negative_percentage",
                         "docs": [
-                            "Maximum allowed negative change in basis points (10000 = 100%)"
+                            "Maximum withdrawal capacity in basis points of the market's normalized value."
                         ],
                         "type": "u16"
                     },
                     {
                         "name": "max_net_balance_change_positive_percentage",
                         "docs": [
-                            "Maximum allowed positive change in basis points (10000 = 100%)",
-                            "Using u32 to allow for very large increases (up to ~429,496%)"
+                            "Fractional refill numerator carried between withdrawals.",
+                            "",
+                            "This prevents the realized refill rate from depending on how frequently withdrawals occur.",
+                            "The legacy field name is retained to preserve generated client compatibility."
                         ],
                         "type": "u32"
                     },
                     {
                         "name": "window_duration_seconds",
+                        "docs": [
+                            "Time required for an empty withdrawal bucket to refill completely."
+                        ],
                         "type": "u32"
                     }
                 ]
@@ -3804,14 +3847,23 @@
                         "fields": [
                             {
                                 "name": "max_net_balance_change_negative_percentage",
+                                "docs": [
+                                    "Maximum normalized gross withdrawal, in basis points of market value."
+                                ],
                                 "type": "u16"
                             },
                             {
                                 "name": "max_net_balance_change_positive_percentage",
+                                "docs": [
+                                    "Retained for instruction compatibility. The token-bucket limiter does not use it."
+                                ],
                                 "type": "u32"
                             },
                             {
                                 "name": "window_duration_seconds",
+                                "docs": [
+                                    "Seconds required for an empty withdrawal bucket to refill completely."
+                                ],
                                 "type": "u32"
                             }
                         ]
@@ -4156,6 +4208,10 @@
                             }
                         }
                     },
+                    {
+                        "name": "self_cpi_status",
+                        "type": "u8"
+                    },
                     {
                         "name": "financials",
                         "type": {
@@ -4952,6 +5008,22 @@
                 ]
             }
         },
+        {
+            "name": "TradePtReturnData",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "amount_in",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "amount_out",
+                        "type": "u64"
+                    }
+                ]
+            }
+        },
         {
             "name": "Vault",
             "type": {
@@ -5059,7 +5131,7 @@
                         "name": "last_seen_sy_exchange_rate",
                         "docs": [
                             "Last seen SY exchange rate",
-                            "This continues to be updated even after vault maturity to track SY appreciation for treasury collection"
+                            "This continues to be updated after maturity for PT redemption"
                         ],
                         "type": {
                             "defined": {
@@ -5070,7 +5142,7 @@
                     {
                         "name": "all_time_high_sy_exchange_rate",
                         "docs": [
-                            "This is the all time high exchange rate for SY"
+                            "This is the all time high exchange rate for SY while the vault is not expired"
                         ],
                         "type": {
                             "defined": {
@@ -5081,7 +5153,9 @@
                     {
                         "name": "final_sy_exchange_rate",
                         "docs": [
-                            "This is the exchange rate for SY when the vault expires"
+                            "Final PY index captured for YT interest at maturity.",
+                            "This is the highest observed SY exchange rate while the vault is active,",
+                            "not necessarily the live exchange rate at the last pre-expiry update."
                         ],
                         "type": {
                             "defined": {

package/build/index.d.ts

@@ -458,6 +458,7 @@ export declare const IDL: {
                 name: string;
                 fields: {
                     name: string;
+                    docs: string[];
                     type: string;
                 }[];
             })[];

package/build/index.js

@@ -18,23 +18,13 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PROGRAM_ID = exports.IDL = void 0;
 __exportStar(require("./exponent_clmm"), exports);

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kDAA+B;AAC/B,0DAA2C;AAC9B,QAAA,GAAG,GAAG,GAAG,CAAA;AACT,QAAA,UAAU,GAAU,GAAG,CAAC,OAAO,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kDAA+B;AAC/B,0DAA2C;AAC9B,QAAA,GAAG,GAAG,GAAG,CAAA;AACT,QAAA,UAAU,GAAU,GAAG,CAAC,OAAO,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exponent-labs/exponent-clmm-idl",
-  "version": "0.9.24",
+  "version": "0.9.25",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "license": "AGPL-3.0",

package/src/exponent_clmm.json

@@ -1213,7 +1213,7 @@
       ],
       "returns": {
         "defined": {
-          "name": "TradePtEvent"
+          "name": "TradePtReturnData"
         }
       }
     },
@@ -1319,7 +1319,7 @@
       ],
       "returns": {
         "defined": {
-          "name": "TradePtEvent"
+          "name": "TradePtReturnData"
         }
       }
     },
@@ -2365,6 +2365,19 @@
         174
       ]
     },
+    {
+      "name": "TradePtReturnData",
+      "discriminator": [
+        26,
+        64,
+        30,
+        82,
+        98,
+        163,
+        184,
+        31
+      ]
+    },
     {
       "name": "WithdrawLiquidityEvent",
       "discriminator": [
@@ -2663,6 +2676,21 @@
       "code": 6035,
       "name": "CrossingEqualizationInvariantViolated",
       "msg": "Crossing equalization invariants were violated"
+    },
+    {
+      "code": 6036,
+      "name": "MissingVaultForPyIndex",
+      "msg": "Vault account required to resolve py_index"
+    },
+    {
+      "code": 6037,
+      "name": "InvalidSyExchangeRate",
+      "msg": "SY exchange rate must be positive"
+    },
+    {
+      "code": 6038,
+      "name": "CrossingLiquidityWouldRoundToZero",
+      "msg": "Partial withdrawal would round crossing liquidity to zero; withdraw the full position instead"
     }
   ],
   "types": [
@@ -2983,7 +3011,7 @@
             "type": {
               "array": [
                 "u8",
-                1024
+                1023
               ]
             }
           }
@@ -3537,29 +3565,44 @@
         "fields": [
           {
             "name": "window_start_timestamp",
+            "docs": [
+              "Last timestamp at which the withdrawal bucket was evaluated.",
+              "",
+              "The legacy field name is retained to preserve generated client compatibility."
+            ],
             "type": "u32"
           },
           {
             "name": "window_start_net_balance",
+            "docs": [
+              "Remaining normalized PT-equivalent withdrawal capacity.",
+              "",
+              "The legacy field name is retained to preserve generated client compatibility."
+            ],
             "type": "u64"
           },
           {
             "name": "max_net_balance_change_negative_percentage",
             "docs": [
-              "Maximum allowed negative change in basis points (10000 = 100%)"
+              "Maximum withdrawal capacity in basis points of the market's normalized value."
             ],
             "type": "u16"
           },
           {
             "name": "max_net_balance_change_positive_percentage",
             "docs": [
-              "Maximum allowed positive change in basis points (10000 = 100%)",
-              "Using u32 to allow for very large increases (up to ~429,496%)"
+              "Fractional refill numerator carried between withdrawals.",
+              "",
+              "This prevents the realized refill rate from depending on how frequently withdrawals occur.",
+              "The legacy field name is retained to preserve generated client compatibility."
             ],
             "type": "u32"
           },
           {
             "name": "window_duration_seconds",
+            "docs": [
+              "Time required for an empty withdrawal bucket to refill completely."
+            ],
             "type": "u32"
           }
         ]
@@ -3804,14 +3847,23 @@
             "fields": [
               {
                 "name": "max_net_balance_change_negative_percentage",
+                "docs": [
+                  "Maximum normalized gross withdrawal, in basis points of market value."
+                ],
                 "type": "u16"
               },
               {
                 "name": "max_net_balance_change_positive_percentage",
+                "docs": [
+                  "Retained for instruction compatibility. The token-bucket limiter does not use it."
+                ],
                 "type": "u32"
               },
               {
                 "name": "window_duration_seconds",
+                "docs": [
+                  "Seconds required for an empty withdrawal bucket to refill completely."
+                ],
                 "type": "u32"
               }
             ]
@@ -4156,6 +4208,10 @@
               }
             }
           },
+          {
+            "name": "self_cpi_status",
+            "type": "u8"
+          },
           {
             "name": "financials",
             "type": {
@@ -4952,6 +5008,22 @@
         ]
       }
     },
+    {
+      "name": "TradePtReturnData",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "amount_in",
+            "type": "u64"
+          },
+          {
+            "name": "amount_out",
+            "type": "u64"
+          }
+        ]
+      }
+    },
     {
       "name": "Vault",
       "type": {
@@ -5059,7 +5131,7 @@
             "name": "last_seen_sy_exchange_rate",
             "docs": [
               "Last seen SY exchange rate",
-              "This continues to be updated even after vault maturity to track SY appreciation for treasury collection"
+              "This continues to be updated after maturity for PT redemption"
             ],
             "type": {
               "defined": {
@@ -5070,7 +5142,7 @@
           {
             "name": "all_time_high_sy_exchange_rate",
             "docs": [
-              "This is the all time high exchange rate for SY"
+              "This is the all time high exchange rate for SY while the vault is not expired"
             ],
             "type": {
               "defined": {
@@ -5081,7 +5153,9 @@
           {
             "name": "final_sy_exchange_rate",
             "docs": [
-              "This is the exchange rate for SY when the vault expires"
+              "Final PY index captured for YT interest at maturity.",
+              "This is the highest observed SY exchange rate while the vault is active,",
+              "not necessarily the live exchange rate at the last pre-expiry update."
             ],
             "type": {
               "defined": {

package/src/exponent_clmm.ts

@@ -1219,7 +1219,7 @@ export type ExponentClmm = {
       ],
       "returns": {
         "defined": {
-          "name": "tradePtEvent"
+          "name": "tradePtReturnData"
         }
       }
     },
@@ -1325,7 +1325,7 @@ export type ExponentClmm = {
       ],
       "returns": {
         "defined": {
-          "name": "tradePtEvent"
+          "name": "tradePtReturnData"
         }
       }
     },
@@ -2371,6 +2371,19 @@ export type ExponentClmm = {
         174
       ]
     },
+    {
+      "name": "tradePtReturnData",
+      "discriminator": [
+        26,
+        64,
+        30,
+        82,
+        98,
+        163,
+        184,
+        31
+      ]
+    },
     {
       "name": "withdrawLiquidityEvent",
       "discriminator": [
@@ -2669,6 +2682,21 @@ export type ExponentClmm = {
       "code": 6035,
       "name": "crossingEqualizationInvariantViolated",
       "msg": "Crossing equalization invariants were violated"
+    },
+    {
+      "code": 6036,
+      "name": "missingVaultForPyIndex",
+      "msg": "Vault account required to resolve py_index"
+    },
+    {
+      "code": 6037,
+      "name": "invalidSyExchangeRate",
+      "msg": "SY exchange rate must be positive"
+    },
+    {
+      "code": 6038,
+      "name": "crossingLiquidityWouldRoundToZero",
+      "msg": "Partial withdrawal would round crossing liquidity to zero; withdraw the full position instead"
     }
   ],
   "types": [
@@ -2989,7 +3017,7 @@ export type ExponentClmm = {
             "type": {
               "array": [
                 "u8",
-                1024
+                1023
               ]
             }
           }
@@ -3543,29 +3571,44 @@ export type ExponentClmm = {
         "fields": [
           {
             "name": "windowStartTimestamp",
+            "docs": [
+              "Last timestamp at which the withdrawal bucket was evaluated.",
+              "",
+              "The legacy field name is retained to preserve generated client compatibility."
+            ],
             "type": "u32"
           },
           {
             "name": "windowStartNetBalance",
+            "docs": [
+              "Remaining normalized PT-equivalent withdrawal capacity.",
+              "",
+              "The legacy field name is retained to preserve generated client compatibility."
+            ],
             "type": "u64"
           },
           {
             "name": "maxNetBalanceChangeNegativePercentage",
             "docs": [
-              "Maximum allowed negative change in basis points (10000 = 100%)"
+              "Maximum withdrawal capacity in basis points of the market's normalized value."
             ],
             "type": "u16"
           },
           {
             "name": "maxNetBalanceChangePositivePercentage",
             "docs": [
-              "Maximum allowed positive change in basis points (10000 = 100%)",
-              "Using u32 to allow for very large increases (up to ~429,496%)"
+              "Fractional refill numerator carried between withdrawals.",
+              "",
+              "This prevents the realized refill rate from depending on how frequently withdrawals occur.",
+              "The legacy field name is retained to preserve generated client compatibility."
             ],
             "type": "u32"
           },
           {
             "name": "windowDurationSeconds",
+            "docs": [
+              "Time required for an empty withdrawal bucket to refill completely."
+            ],
             "type": "u32"
           }
         ]
@@ -3810,14 +3853,23 @@ export type ExponentClmm = {
             "fields": [
               {
                 "name": "maxNetBalanceChangeNegativePercentage",
+                "docs": [
+                  "Maximum normalized gross withdrawal, in basis points of market value."
+                ],
                 "type": "u16"
               },
               {
                 "name": "maxNetBalanceChangePositivePercentage",
+                "docs": [
+                  "Retained for instruction compatibility. The token-bucket limiter does not use it."
+                ],
                 "type": "u32"
               },
               {
                 "name": "windowDurationSeconds",
+                "docs": [
+                  "Seconds required for an empty withdrawal bucket to refill completely."
+                ],
                 "type": "u32"
               }
             ]
@@ -4162,6 +4214,10 @@ export type ExponentClmm = {
               }
             }
           },
+          {
+            "name": "selfCpiStatus",
+            "type": "u8"
+          },
           {
             "name": "financials",
             "type": {
@@ -4958,6 +5014,22 @@ export type ExponentClmm = {
         ]
       }
     },
+    {
+      "name": "tradePtReturnData",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "amountIn",
+            "type": "u64"
+          },
+          {
+            "name": "amountOut",
+            "type": "u64"
+          }
+        ]
+      }
+    },
     {
       "name": "vault",
       "type": {
@@ -5065,7 +5137,7 @@ export type ExponentClmm = {
             "name": "lastSeenSyExchangeRate",
             "docs": [
               "Last seen SY exchange rate",
-              "This continues to be updated even after vault maturity to track SY appreciation for treasury collection"
+              "This continues to be updated after maturity for PT redemption"
             ],
             "type": {
               "defined": {
@@ -5076,7 +5148,7 @@ export type ExponentClmm = {
           {
             "name": "allTimeHighSyExchangeRate",
             "docs": [
-              "This is the all time high exchange rate for SY"
+              "This is the all time high exchange rate for SY while the vault is not expired"
             ],
             "type": {
               "defined": {
@@ -5087,7 +5159,9 @@ export type ExponentClmm = {
           {
             "name": "finalSyExchangeRate",
             "docs": [
-              "This is the exchange rate for SY when the vault expires"
+              "Final PY index captured for YT interest at maturity.",
+              "This is the highest observed SY exchange rate while the vault is active,",
+              "not necessarily the live exchange rate at the last pre-expiry update."
             ],
             "type": {
               "defined": {