Expose useful utility functions in Rust and TypeScript SDKs (#912)

* Export useful functions

* Add changeset

* Create alias for increase_liquidity_quote. Add tests

* Revert "Create alias for increase_liquidity_quote. Add tests"

This reverts commit 1f5a583.

* Add rust docs

Author: calintje

.changeset/chatty-cooks-push.md

@@ -0,0 +1,6 @@
+---
+"@orca-so/whirlpools": patch
+"@orca-so/whirlpools-rust-core": patch
+---
+
+Expose useful utility functions

docs/rust/Cargo.lock

@@ -370,6 +370,75 @@ pub fn increase_liquidity_quote_b(
     )
 }
 
+/// Calculate the estimated token amounts for a given liquidity delta and price range
+///
+/// # Parameters
+/// - `liquidity_delta` - The amount of liquidity to get token estimates for
+/// - `current_sqrt_price` - The current sqrt price of the pool
+/// - `tick_lower_index` - The lower tick index of the range
+/// - `tick_upper_index` - The upper tick index of the range
+/// - `round_up` - Whether to round the token amounts up
+///
+/// # Returns
+/// - A tuple containing the estimated amounts of token A and token B
+pub fn try_get_token_estimates_from_liquidity(
+    liquidity_delta: u128,
+    current_sqrt_price: u128,
+    tick_lower_index: i32,
+    tick_upper_index: i32,
+    round_up: bool,
+) -> Result<(u64, u64), CoreError> {
+    if liquidity_delta == 0 {
+        return Ok((0, 0));
+    }
+
+    let sqrt_price_lower = tick_index_to_sqrt_price(tick_lower_index).into();
+    let sqrt_price_upper = tick_index_to_sqrt_price(tick_upper_index).into();
+
+    let position_status = position_status(
+        current_sqrt_price.into(),
+        tick_lower_index,
+        tick_upper_index,
+    );
+
+    match position_status {
+        PositionStatus::PriceBelowRange => {
+            let token_a = try_get_token_a_from_liquidity(
+                liquidity_delta,
+                sqrt_price_lower,
+                sqrt_price_upper,
+                round_up,
+            )?;
+            Ok((token_a, 0))
+        }
+        PositionStatus::PriceInRange => {
+            let token_a = try_get_token_a_from_liquidity(
+                liquidity_delta,
+                current_sqrt_price,
+                sqrt_price_upper,
+                round_up,
+            )?;
+            let token_b = try_get_token_b_from_liquidity(
+                liquidity_delta,
+                sqrt_price_lower,
+                current_sqrt_price,
+                round_up,
+            )?;
+            Ok((token_a, token_b))
+        }
+        PositionStatus::PriceAboveRange => {
+            let token_b = try_get_token_b_from_liquidity(
+                liquidity_delta,
+                sqrt_price_lower,
+                sqrt_price_upper,
+                round_up,
+            )?;
+            Ok((0, token_b))
+        }
+        PositionStatus::Invalid => Ok((0, 0)),
+    }
+}
+
 // Private functions
 
 fn try_get_liquidity_from_a(
@@ -444,64 +513,6 @@ fn try_get_token_b_from_liquidity(
     }
 }
 
-fn try_get_token_estimates_from_liquidity(
-    liquidity_delta: u128,
-    current_sqrt_price: u128,
-    tick_lower_index: i32,
-    tick_upper_index: i32,
-    round_up: bool,
-) -> Result<(u64, u64), CoreError> {
-    if liquidity_delta == 0 {
-        return Ok((0, 0));
-    }
-
-    let sqrt_price_lower = tick_index_to_sqrt_price(tick_lower_index).into();
-    let sqrt_price_upper = tick_index_to_sqrt_price(tick_upper_index).into();
-
-    let position_status = position_status(
-        current_sqrt_price.into(),
-        tick_lower_index,
-        tick_upper_index,
-    );
-
-    match position_status {
-        PositionStatus::PriceBelowRange => {
-            let token_a = try_get_token_a_from_liquidity(
-                liquidity_delta,
-                sqrt_price_lower,
-                sqrt_price_upper,
-                round_up,
-            )?;
-            Ok((token_a, 0))
-        }
-        PositionStatus::PriceInRange => {
-            let token_a = try_get_token_a_from_liquidity(
-                liquidity_delta,
-                current_sqrt_price,
-                sqrt_price_upper,
-                round_up,
-            )?;
-            let token_b = try_get_token_b_from_liquidity(
-                liquidity_delta,
-                sqrt_price_lower,
-                current_sqrt_price,
-                round_up,
-            )?;
-            Ok((token_a, token_b))
-        }
-        PositionStatus::PriceAboveRange => {
-            let token_b = try_get_token_b_from_liquidity(
-                liquidity_delta,
-                sqrt_price_lower,
-                sqrt_price_upper,
-                round_up,
-            )?;
-            Ok((0, token_b))
-        }
-        PositionStatus::Invalid => Ok((0, 0)),
-    }
-}
-
 #[cfg(all(test, not(feature = "wasm")))]
 mod tests {
     use super::*;

rust-sdk/core/src/quote/liquidity.rs

@@ -6,3 +6,4 @@ export * from "./increaseLiquidity";
 export * from "./pool";
 export * from "./position";
 export * from "./swap";
+export { orderMints } from "./token";