@paraswap/dex-lib 4.8.26 → 4.8.28-uni-v3-rust.0

package/native/Cargo.lock

@@ -0,0 +1,279 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "aho-corasick"
+version = "1.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ddd31a130427c27518df266943a5308ed92d4b226cc639f5a8f1002816174301"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "bitflags"
+version = "2.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "843867be96c8daad0d758b57df9392b6d8d271134fce549de6ce169ff98a92af"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "convert_case"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ec182b0ca2f35d8fc196cf3404988fd8b8c739a4d270ff118a398feb0cbec1ca"
+dependencies = [
+ "unicode-segmentation",
+]
+
+[[package]]
+name = "ctor"
+version = "0.2.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32a2785755761f3ddc1492979ce1e48d2c00d09311c39e4466429188f3dd6501"
+dependencies = [
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "ethnum"
+version = "1.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ca81e6b4777c89fd810c25a4be2b1bd93ea034fbe58e6a75216a34c6b82c539b"
+
+[[package]]
+name = "itoa"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
+
+[[package]]
+name = "libloading"
+version = "0.8.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d7c4b02199fee7c5d21a5ae7d8cfa79a6ef5bb2fc834d6e9058e89c825efdc55"
+dependencies = [
+ "cfg-if",
+ "windows-link",
+]
+
+[[package]]
+name = "memchr"
+version = "2.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8ca58f447f06ed17d5fc4043ce1b10dd205e060fb3ce5b979b8ed8e59ff3f79"
+
+[[package]]
+name = "napi"
+version = "2.16.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "55740c4ae1d8696773c78fdafd5d0e5fe9bc9f1b071c7ba493ba5c413a9184f3"
+dependencies = [
+ "bitflags",
+ "ctor",
+ "napi-derive",
+ "napi-sys",
+ "once_cell",
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "napi-build"
+version = "2.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d376940fd5b723c6893cd1ee3f33abbfd86acb1cd1ec079f3ab04a2a3bc4d3b1"
+
+[[package]]
+name = "napi-derive"
+version = "2.16.13"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7cbe2585d8ac223f7d34f13701434b9d5f4eb9c332cccce8dee57ea18ab8ab0c"
+dependencies = [
+ "cfg-if",
+ "convert_case",
+ "napi-derive-backend",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "napi-derive-backend"
+version = "1.0.75"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1639aaa9eeb76e91c6ae66da8ce3e89e921cd3885e99ec85f4abacae72fc91bf"
+dependencies = [
+ "convert_case",
+ "once_cell",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "semver",
+ "syn",
+]
+
+[[package]]
+name = "napi-sys"
+version = "2.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "427802e8ec3a734331fec1035594a210ce1ff4dc5bc1950530920ab717964ea3"
+dependencies = [
+ "libloading",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "regex"
+version = "1.12.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e10754a14b9137dd7b1e3e5b0493cc9171fdd105e0ab477f51b72e7f3ac0e276"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-automata",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-automata"
+version = "0.4.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6e1dd4122fc1595e8162618945476892eefca7b88c52820e74af6262213cae8f"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-syntax"
+version = "0.8.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc897dd8d9e8bd1ed8cdad82b5966c3e0ecae09fb1907d58efaa013543185d0a"
+
+[[package]]
+name = "semver"
+version = "1.0.27"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d767eb0aabc880b29956c35734170f26ed551a859dbd361d140cdbeca61ab1e2"
+
+[[package]]
+name = "serde"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.149"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "83fc039473c5595ace860d8c4fafa220ff474b3fc6bfdb4293327f1a37e94d86"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.117"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "unicode-segmentation"
+version = "1.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9629274872b2bfaf8d66f5f15725007f635594914870f65218920345aa11aa8c"
+
+[[package]]
+name = "v3-math-native"
+version = "0.1.0"
+dependencies = [
+ "ethnum",
+ "napi",
+ "napi-build",
+ "napi-derive",
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+
+[[package]]
+name = "zmij"
+version = "1.0.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b8848ee67ecc8aedbaf3e4122217aff892639231befc6a1b58d29fff4c2cabaa"

package/native/Cargo.toml

@@ -0,0 +1,21 @@
+[package]
+name = "v3-math-native"
+version = "0.1.0"
+edition = "2021"
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+napi = { version = "2", features = ["napi6", "serde-json"] }
+napi-derive = "2"
+ethnum = "1"
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+
+[build-dependencies]
+napi-build = "2"
+
+[profile.release]
+lto = true
+strip = "symbols"

package/native/build.rs

@@ -0,0 +1,5 @@
+extern crate napi_build;
+
+fn main() {
+    napi_build::setup();
+}

package/native/package-lock.json

@@ -0,0 +1,32 @@
+{
+  "name": "@paraswap/v3-math-native",
+  "version": "0.1.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@paraswap/v3-math-native",
+      "version": "0.1.0",
+      "devDependencies": {
+        "@napi-rs/cli": "^2.18.0"
+      }
+    },
+    "node_modules/@napi-rs/cli": {
+      "version": "2.18.4",
+      "resolved": "https://registry.npmjs.org/@napi-rs/cli/-/cli-2.18.4.tgz",
+      "integrity": "sha512-SgJeA4df9DE2iAEpr3M2H0OKl/yjtg1BnRI5/JyowS71tUWhrfSu2LT0V3vlHET+g1hBVlrO60PmEXwUEKp8Mg==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "napi": "scripts/index.js"
+      },
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    }
+  }
+}

package/native/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@paraswap/v3-math-native",
+  "version": "0.1.0",
+  "private": true,
+  "main": "index.js",
+  "types": "index.d.ts",
+  "napi": {
+    "name": "v3-math-native",
+    "triples": {
+      "defaults": true
+    }
+  },
+  "scripts": {
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.0"
+  }
+}

package/native/src/config.rs

@@ -0,0 +1,40 @@
+/// Configures math variant differences between Uniswap V3 forks.
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum MathVariant {
+    /// Standard Uniswap V3: feeProtocol is 4-bit (% 16 / >> 4)
+    UniswapV3,
+    /// PancakeSwap V3: feeProtocol is 16-bit (% 65536 / >> 16), protocol_fee = feeAmount * fp / 10000
+    PancakeSwapV3,
+    /// Solidly V3: No oracle, fee from slot0.fee directly
+    SolidlyV3,
+}
+
+impl MathVariant {
+    pub fn from_str(s: &str) -> Self {
+        match s {
+            "pancakeswap_v3" => MathVariant::PancakeSwapV3,
+            "solidly_v3" => MathVariant::SolidlyV3,
+            _ => MathVariant::UniswapV3,
+        }
+    }
+
+    /// Extract the fee protocol value for the given swap direction.
+    pub fn fee_protocol(&self, fee_protocol_raw: ethnum::U256, zero_for_one: bool) -> ethnum::U256 {
+        match self {
+            MathVariant::UniswapV3 | MathVariant::SolidlyV3 => {
+                if zero_for_one {
+                    fee_protocol_raw % ethnum::U256::from(16u32)
+                } else {
+                    fee_protocol_raw >> 4
+                }
+            }
+            MathVariant::PancakeSwapV3 => {
+                if zero_for_one {
+                    fee_protocol_raw % ethnum::U256::from(65536u32)
+                } else {
+                    fee_protocol_raw >> 16
+                }
+            }
+        }
+    }
+}

package/native/src/lib.rs

@@ -0,0 +1,216 @@
+pub mod config;
+pub mod math;
+pub mod pool_state;
+pub mod query_outputs;
+
+use ethnum::{I256, U256};
+use napi::bindgen_prelude::*;
+use napi_derive::napi;
+use std::collections::HashMap;
+
+use config::MathVariant;
+use math::oracle::OracleObservation;
+use math::tick::TickInfo;
+use pool_state::PoolState;
+
+// ---- NAPI type definitions for JS interop ----
+
+#[napi(object)]
+pub struct JsTickEntry {
+    pub key: i32,
+    pub liquidity_gross: BigInt,
+    pub liquidity_net: BigInt,
+}
+
+#[napi(object)]
+pub struct JsBitmapEntry {
+    pub key: i32,
+    pub value: BigInt,
+}
+
+#[napi(object)]
+pub struct JsObservationEntry {
+    pub key: i32,
+    pub block_timestamp: BigInt,
+    pub tick_cumulative: BigInt,
+    pub seconds_per_liquidity_cumulative_x128: BigInt,
+    pub initialized: bool,
+}
+
+#[napi(object)]
+pub struct JsPoolStateInit {
+    pub variant: String,
+    pub block_timestamp: BigInt,
+    pub tick_spacing: BigInt,
+    pub fee: BigInt,
+    pub sqrt_price_x96: BigInt,
+    pub tick: BigInt,
+    pub observation_index: i32,
+    pub observation_cardinality: i32,
+    pub observation_cardinality_next: i32,
+    pub fee_protocol: BigInt,
+    pub liquidity: BigInt,
+    pub max_liquidity_per_tick: BigInt,
+    pub start_tick_bitmap: BigInt,
+    pub lowest_known_tick: BigInt,
+    pub highest_known_tick: BigInt,
+    pub tick_bitmap: Vec<JsBitmapEntry>,
+    pub ticks: Vec<JsTickEntry>,
+    pub observations: Vec<JsObservationEntry>,
+}
+
+#[napi(object)]
+pub struct JsOutputResult {
+    pub outputs: Vec<BigInt>,
+    pub tick_counts: Vec<i32>,
+}
+
+// ---- Conversion helpers ----
+// napi::bindgen_prelude::BigInt stores { sign_bit: bool, words: Vec<u64> }
+// words are little-endian u64 limbs.
+
+fn bigint_to_u256(bi: &BigInt) -> U256 {
+    let words = &bi.words;
+    let low = words.first().copied().unwrap_or(0) as u128
+        | (words.get(1).copied().unwrap_or(0) as u128) << 64;
+    let high = words.get(2).copied().unwrap_or(0) as u128
+        | (words.get(3).copied().unwrap_or(0) as u128) << 64;
+    U256::from_words(high, low)
+}
+
+fn bigint_to_i256(bi: &BigInt) -> I256 {
+    let u = bigint_to_u256(bi);
+    let val = u.as_i256();
+    if bi.sign_bit {
+        -val
+    } else {
+        val
+    }
+}
+
+fn u256_to_bigint(val: U256) -> BigInt {
+    let (high, low) = val.into_words();
+    let mut words = vec![
+        low as u64,
+        (low >> 64) as u64,
+        high as u64,
+        (high >> 64) as u64,
+    ];
+    // Trim trailing zeros for cleaner representation
+    while words.len() > 1 && *words.last().unwrap() == 0 {
+        words.pop();
+    }
+    BigInt {
+        sign_bit: false,
+        words,
+    }
+}
+
+// ---- The main NAPI class ----
+
+#[napi]
+pub struct RustPoolHandle {
+    state: PoolState,
+}
+
+#[napi]
+impl RustPoolHandle {
+    /// Create a new Rust-owned pool state from JS data.
+    #[napi(factory)]
+    pub fn create(init: JsPoolStateInit) -> Result<Self> {
+        let variant = MathVariant::from_str(&init.variant);
+
+        let mut tick_bitmap = HashMap::with_capacity(init.tick_bitmap.len());
+        for entry in &init.tick_bitmap {
+            tick_bitmap.insert(entry.key as i16, bigint_to_u256(&entry.value));
+        }
+
+        let mut ticks = HashMap::with_capacity(init.ticks.len());
+        for entry in &init.ticks {
+            ticks.insert(
+                entry.key,
+                TickInfo {
+                    liquidity_gross: bigint_to_u256(&entry.liquidity_gross),
+                    liquidity_net: bigint_to_i256(&entry.liquidity_net),
+                    initialized: true,
+                },
+            );
+        }
+
+        let mut observations = HashMap::with_capacity(init.observations.len());
+        for entry in &init.observations {
+            observations.insert(
+                entry.key as u16,
+                OracleObservation {
+                    block_timestamp: bigint_to_u256(&entry.block_timestamp),
+                    tick_cumulative: bigint_to_i256(&entry.tick_cumulative),
+                    seconds_per_liquidity_cumulative_x128: bigint_to_u256(
+                        &entry.seconds_per_liquidity_cumulative_x128,
+                    ),
+                    initialized: entry.initialized,
+                },
+            );
+        }
+
+        Ok(Self {
+            state: PoolState {
+                block_timestamp: bigint_to_u256(&init.block_timestamp),
+                tick_spacing: bigint_to_i256(&init.tick_spacing),
+                fee: bigint_to_u256(&init.fee),
+                sqrt_price_x96: bigint_to_u256(&init.sqrt_price_x96),
+                tick: bigint_to_i256(&init.tick),
+                observation_index: init.observation_index as u16,
+                observation_cardinality: init.observation_cardinality as u16,
+                observation_cardinality_next: init.observation_cardinality_next as u16,
+                fee_protocol: bigint_to_u256(&init.fee_protocol),
+                liquidity: bigint_to_u256(&init.liquidity),
+                max_liquidity_per_tick: bigint_to_u256(&init.max_liquidity_per_tick),
+                tick_bitmap,
+                ticks,
+                observations,
+                start_tick_bitmap: bigint_to_i256(&init.start_tick_bitmap),
+                lowest_known_tick: bigint_to_i256(&init.lowest_known_tick),
+                highest_known_tick: bigint_to_i256(&init.highest_known_tick),
+                variant,
+            },
+        })
+    }
+
+    /// HOT PATH: Price N amounts in one call.
+    /// side: 0 = SELL, 1 = BUY
+    #[napi]
+    pub fn query_outputs(
+        &self,
+        amounts: Vec<BigInt>,
+        zero_for_one: bool,
+        side: u8,
+    ) -> Result<JsOutputResult> {
+        let amounts_u256: Vec<U256> = amounts.iter().map(|a| bigint_to_u256(a)).collect();
+
+        let result = std::panic::catch_unwind(std::panic::AssertUnwindSafe(|| {
+            query_outputs::query_outputs(&self.state, &amounts_u256, zero_for_one, side)
+        }));
+
+        match result {
+            Ok(output) => {
+                let outputs: Vec<BigInt> =
+                    output.outputs.iter().map(|v| u256_to_bigint(*v)).collect();
+
+                Ok(JsOutputResult {
+                    outputs,
+                    tick_counts: output.tick_counts,
+                })
+            }
+            Err(panic_info) => {
+                let msg = if let Some(s) = panic_info.downcast_ref::<&str>() {
+                    s.to_string()
+                } else if let Some(s) = panic_info.downcast_ref::<String>() {
+                    s.clone()
+                } else {
+                    "Unknown panic in query_outputs".to_string()
+                };
+                Err(Error::new(Status::GenericFailure, msg))
+            }
+        }
+    }
+}