@switch-win/sdk 1.2.9 → 1.3.0

package/README.md

@@ -5,9 +5,20 @@
 
 > **Official integration kit for the Switch DEX Aggregator on PulseChain and Robinhood Chain**
 
-Everything partners need to integrate Switch swaps and limit orders — API docs, TypeScript types, ABIs, constants, and ready-to-use examples.
+Everything partners need to integrate Switch swaps, limit orders, and GaslessSwitch — API docs, TypeScript types, ABIs, constants, and ready-to-use examples.
 
-**Swap API:** `https://quote.switch.win`  |  **Swap chains:** PulseChain (369), Robinhood Chain (4663)  |  **Limit orders:** PulseChain and Robinhood Chain
+**Version 1.3.0 has not been published on npm yet.** This release
+adds GaslessSwitch V2 helpers and examples. See [GASLESS.md](GASLESS.md) for the
+checked quote, approval, signing, submission, and recovery flow.
+
+**Gasless fee policy:** Every GaslessSwitch settlement charges a fixed
+**0.1% protocol fee (10 bps)**. Integrators cannot customize or waive this fee.
+The operator can also receive up to **0.05%**, including settlement gas, under
+the separate on-chain payout cap. If you do not want to offer the fixed gasless
+fee policy, **offer regular swaps only** in your integration. See
+[regular-only integration](GASLESS.md#regular-only-integration) for the steps.
+
+**Swap API:** `https://quote.switch.win`  |  **Swap chains:** PulseChain (369), Robinhood Chain (4663)  |  **Limit orders:** PulseChain and Robinhood Chain
 
 ---
 
@@ -56,6 +67,21 @@ Switch-SDK/
 
 8. [Limit Orders](#limit-orders) — full guide in [`LIMIT-ORDERS.md`](LIMIT-ORDERS.md)
 
+### Gasless swaps
+
+- [GaslessSwitch V2 integration](GASLESS.md) — settlement gas eligibility, tax
+  tokens, 0.1% protocol fee, 0.05% total operator cap, native wrapping,
+  durable pending orders, and settlement links.
+- [Browser flow example](examples/gasless-swap.ts),
+  [backend proxy](examples/gasless-nextjs-proxy.ts), and
+  [operator execution validation](examples/gasless-operator.ts).
+- Import the dedicated flow from `@switch-win/sdk/gasless`; ordinary
+  `buildLimitOrder` / LO signing and approval helpers target a different contract.
+- [API eligibility and fallback](GASLESS.md#api-eligibility-response):
+  `client.quote()` exposes `decision.eligibility` for both accepted and rejected
+  quotes, including PLS/ETH payout, gas reserves, freshness and rejection reason.
+  Only `decision.eligible` enables signing; a finished simulation alone does not.
+
 ### General
 
 9. [Constants & Addresses](#constants--addresses)
@@ -121,12 +147,12 @@ For a production integration with tax token handling, adapter filtering, and fee
 ### Robinhood Chain
 
 Robinhood uses the same quote endpoint; set `network=robinhood`. The dedicated
-module includes canonical chain metadata, deployed Switch contracts, vetted
-routing hubs, and a URL builder that always includes the correct network.
-The production router exposes nineteen adapters across Uniswap, SwapHood,
-Up33, Sheriff, Aeon, Catnip, PancakeSwap, RobinSwap, SushiSwap, GIGA, Flap,
-Ramses, and Switch limit orders. `ROBINHOOD_ADAPTERS` contains a typed snapshot;
-fetch `/swap/adapters?network=robinhood` when runtime freshness matters.
+module includes canonical chain metadata, deployed Switch contracts, vetted
+routing hubs, and a URL builder that always includes the correct network.
+The production router exposes nineteen adapters across Uniswap, SwapHood,
+Up33, Sheriff, Aeon, Catnip, PancakeSwap, RobinSwap, SushiSwap, GIGA, Flap,
+Ramses, and Switch limit orders. `ROBINHOOD_ADAPTERS` contains a typed snapshot;
+fetch `/swap/adapters?network=robinhood` when runtime freshness matters.
 
 For network configuration, deployed addresses, tax handling, execution, and
 the complete frontend token list, see [`ROBINHOOD.md`](ROBINHOOD.md).
@@ -143,7 +169,7 @@ const url = buildRobinhoodQuoteUrl({
   to: ROBINHOOD_TOKENS.USDG.address,
   amount: 1_000_000_000_000_000n,
   sender: walletAddress,
-  slippage: 100, // 1%, matching the Robinhood frontend default
+  slippage: 100, // 1%, matching the Robinhood frontend default
 });
 
 const response = await fetch(url, {
@@ -153,8 +179,8 @@ const response = await fetch(url, {
 
 Always approve `ROBINHOOD_SWITCH_CONTRACTS.router` for ERC-20 input, but submit
 the transaction to `quote.tx.to` so integrations remain safe across router
-upgrades. Robinhood limit-order deployment constants and EIP-712 domain values
-are exported from `src/networks/robinhood.ts`.
+upgrades. Robinhood limit-order deployment constants and EIP-712 domain values
+are exported from `src/networks/robinhood.ts`.
 
 ---
 
@@ -217,7 +243,7 @@ For the most accurate swap quotes — especially with tax tokens — follow this
 │  → Detect transfer taxes on both tokens                                    │
 │  → Determine feeOnOutput based on tax results + your fee strategy          │
 ├────────────────────────────────────────────────────────────────────────────┤
-│  Step 3: GET /swap/quote?...&feeOnOutput=true/false&adapters=0,3,7        │
+│  Step 3: GET /swap/quote?...&feeOnOutput=true/false&adapters=0,3,7        │
 │  → Pass feeOnOutput + adapter filter for an exact expectedOutputAmount     │
 │  → Display quote and execute swap                                          │
 └────────────────────────────────────────────────────────────────────────────┘
@@ -230,7 +256,7 @@ The SwitchRouter contract supports two fee modes:
 - **`feeOnOutput=true`** — The full input is routed through DEX pools, then the protocol fee is deducted from the output.
 - **`feeOnOutput=false`** — The protocol fee is deducted from the input *before* routing, and the reduced amount enters the DEX pools.
 
-Due to AMM curve concavity (Jensen's inequality), `AMM(amount × 0.999) ≠ AMM(amount) × 0.999`. This means the backend **must know which mode you'll use** to compute an exact `expectedOutputAmount`. If the backend routes as `feeOnOutput=true` but you send the `tx` (fee on input), the expected output will be slightly over-estimated (always in the user's favor — they receive more than quoted).
+Due to AMM curve concavity (Jensen's inequality), `AMM(amount × 0.999) ≠ AMM(amount) × 0.999`. This means the backend **must know which mode you'll use** to compute an exact `expectedOutputAmount`. If the backend routes as `feeOnOutput=true` but you send the `tx` (fee on input), the expected output will be slightly over-estimated (always in the user's favor — they receive more than quoted).
 
 By passing `feeOnOutput` explicitly, the backend adjusts routing to match the actual on-chain execution, giving you a spot-on estimate.
 
@@ -407,41 +433,41 @@ curl -H "x-api-key: YOUR_KEY" "https://quote.switch.win/swap/adapters?network=pu
 
 ```json
 {
-  "adapters": [
-    { "index": 0,  "name": "UniswapV2",       "address": "0x971eeb4a5080834f7df2b9d7a11dfbeaa7bc187e" },
-    { "index": 1,  "name": "SushiV2",         "address": "0x5ef53d5eb4f011d9bed35e7112945f0dc96b3822" },
-    { "index": 2,  "name": "PulseXV1",        "address": "0x6f5ccfca1f1d3fff70202463df05573cc1668cb6" },
-    { "index": 3,  "name": "PulseXV2",        "address": "0x393e382520b93b8f662dc76295000930c06d689f" },
-    { "index": 4,  "name": "9inchV2",         "address": "0x4810beadf72a1f297f4e5ff71424d98b2bf4441e" },
-    { "index": 5,  "name": "DextopV2",        "address": "0xd096faccdd475f2c86f3c668958fcd435e32bdc2" },
-    { "index": 6,  "name": "9mmV2",           "address": "0x67a25e62309e39e7b46f3b6f868bcf336c4ce8e2" },
-    { "index": 7,  "name": "UniswapV3",       "address": "0xc39cb531f71059fd427a63bf8a2f4b822d6b9b02" },
-    { "index": 8,  "name": "9mmV3",           "address": "0x32a63187814d6b81badc6c13dc9d46a8050fad12" },
-    { "index": 9,  "name": "9inchV3",         "address": "0xe46ef88400997a84336e1a3c14d2528da90572b6" },
-    { "index": 10, "name": "pDexV3",          "address": "0xb718836aca6ddb8745a0cecc687467dda648bdf2" },
-    { "index": 11, "name": "DextopV3",        "address": "0x8b8024ca2a4fdb34697620b80320e76c41a67124" },
-    { "index": 12, "name": "Phux",            "address": "0x98ae0249da42f789b9745b248d346a727f37e937" },
-    { "index": 13, "name": "Tide",            "address": "0xd9a17779db4173d099064e26a5d5916717dacf5" },
-    { "index": 14, "name": "PulseXStable",    "address": "0xf3b9742c859d089b6a2e3b3228dabb2c842b57d2" },
-    { "index": 15, "name": "AgoraX",          "address": "0x79ea0ec76b510d08bf4ca9a4a53a1f9f80ea1697" },
-    { "index": 16, "name": "JoltOTC",         "address": "0x033372eb8df4baad260e20d716742a825f1f113f" },
-    { "index": 17, "name": "SwitchLimitOrder", "address": "0x7b9761484301a8fe4a2ba47194f7646eef8e1cdd" },
-    { "index": 18, "name": "SwitchX",         "address": "0xf8744452598883792f235b92452127f4a8587db3" },
-    { "index": 19, "name": "LibertySwapV3",   "address": "0xba24bb413ab32f02073385850907ebcf0a357e70" },
-    { "index": 20, "name": "FinvestaV3",      "address": "0x012c44d0c465819ef3ceac208e0c1b272087a8b4" },
-    { "index": 21, "name": "TrenchV2",        "address": "0xaf48bb0936d9fa522650236917321d89978a8591" },
-    { "index": 22, "name": "TrenchV3",        "address": "0x01957ec5fcc079f1bb388b9f261278dac42cf2e9" }
-  ]
-}
-```
-
-Finvesta is a Liberty-style V3 venue with fee tiers `100`, `500`, `2500`, and
-`10000`. It can be selected for normal routes, but it is not transfer-tax safe.
-Trench V2 is a direct-pair adapter with dynamic pair-specific fees and is
-eligible for transfer-tax-sensitive hops. Trench V3 uses direct pool simulation
-across fee tiers `100`, `500`, `2500`, `3000`, and `10000`; like other V3
-callback adapters, it is not transfer-tax safe.
-Always treat the live `/swap/adapters` response as the runtime source of truth.
+  "adapters": [
+    { "index": 0,  "name": "UniswapV2",       "address": "0x971eeb4a5080834f7df2b9d7a11dfbeaa7bc187e" },
+    { "index": 1,  "name": "SushiV2",         "address": "0x5ef53d5eb4f011d9bed35e7112945f0dc96b3822" },
+    { "index": 2,  "name": "PulseXV1",        "address": "0x6f5ccfca1f1d3fff70202463df05573cc1668cb6" },
+    { "index": 3,  "name": "PulseXV2",        "address": "0x393e382520b93b8f662dc76295000930c06d689f" },
+    { "index": 4,  "name": "9inchV2",         "address": "0x4810beadf72a1f297f4e5ff71424d98b2bf4441e" },
+    { "index": 5,  "name": "DextopV2",        "address": "0xd096faccdd475f2c86f3c668958fcd435e32bdc2" },
+    { "index": 6,  "name": "9mmV2",           "address": "0x67a25e62309e39e7b46f3b6f868bcf336c4ce8e2" },
+    { "index": 7,  "name": "UniswapV3",       "address": "0xc39cb531f71059fd427a63bf8a2f4b822d6b9b02" },
+    { "index": 8,  "name": "9mmV3",           "address": "0x32a63187814d6b81badc6c13dc9d46a8050fad12" },
+    { "index": 9,  "name": "9inchV3",         "address": "0xe46ef88400997a84336e1a3c14d2528da90572b6" },
+    { "index": 10, "name": "pDexV3",          "address": "0xb718836aca6ddb8745a0cecc687467dda648bdf2" },
+    { "index": 11, "name": "DextopV3",        "address": "0x8b8024ca2a4fdb34697620b80320e76c41a67124" },
+    { "index": 12, "name": "Phux",            "address": "0x98ae0249da42f789b9745b248d346a727f37e937" },
+    { "index": 13, "name": "Tide",            "address": "0xd9a17779db4173d099064e26a5d5916717dacf5" },
+    { "index": 14, "name": "PulseXStable",    "address": "0xf3b9742c859d089b6a2e3b3228dabb2c842b57d2" },
+    { "index": 15, "name": "AgoraX",          "address": "0x79ea0ec76b510d08bf4ca9a4a53a1f9f80ea1697" },
+    { "index": 16, "name": "JoltOTC",         "address": "0x033372eb8df4baad260e20d716742a825f1f113f" },
+    { "index": 17, "name": "SwitchLimitOrder", "address": "0x7b9761484301a8fe4a2ba47194f7646eef8e1cdd" },
+    { "index": 18, "name": "SwitchX",         "address": "0xf8744452598883792f235b92452127f4a8587db3" },
+    { "index": 19, "name": "LibertySwapV3",   "address": "0xba24bb413ab32f02073385850907ebcf0a357e70" },
+    { "index": 20, "name": "FinvestaV3",      "address": "0x012c44d0c465819ef3ceac208e0c1b272087a8b4" },
+    { "index": 21, "name": "TrenchV2",        "address": "0xaf48bb0936d9fa522650236917321d89978a8591" },
+    { "index": 22, "name": "TrenchV3",        "address": "0x01957ec5fcc079f1bb388b9f261278dac42cf2e9" }
+  ]
+}
+```
+
+Finvesta is a Liberty-style V3 venue with fee tiers `100`, `500`, `2500`, and
+`10000`. It can be selected for normal routes, but it is not transfer-tax safe.
+Trench V2 is a direct-pair adapter with dynamic pair-specific fees and is
+eligible for transfer-tax-sensitive hops. Trench V3 uses direct pool simulation
+across fee tiers `100`, `500`, `2500`, `3000`, and `10000`; like other V3
+callback adapters, it is not transfer-tax safe.
+Always treat the live `/swap/adapters` response as the runtime source of truth.
 
 #### Using adapter indices to filter routing
 
@@ -451,8 +477,8 @@ Pass adapter indices as a comma-separated `adapters` param to `/swap/quote`:
 # Route only through PulseXV2 (index 3):
 GET /swap/quote?...&adapters=3
 
-# Route through PulseXV2 + UniswapV3:
-GET /swap/quote?...&adapters=3,7
+# Route through PulseXV2 + UniswapV3:
+GET /swap/quote?...&adapters=3,7
 
 # Exclude nothing (default — omit the param):
 GET /swap/quote?...
@@ -598,17 +624,17 @@ Returns the optimal split-route for a swap and (optionally) a ready-to-send tran
 | `sender` | No* | address | — | Sender wallet address. **Required to receive `tx` calldata in the response.** |
 | `receiver` | No | address | `sender` | Custom recipient address. If omitted, output tokens are sent to `sender`. |
 | `slippage` | No | integer | `50` | Slippage tolerance in **basis points** (bps). `50` = 0.50 %. Range: `0`–`5000`. |
-| `fee` | No | integer | `10` | Protocol fee in basis points (0.10 %). Range: `10`–`100`. Defaults to `10` if omitted. |
+| `fee` | No | integer | `10` | Regular swap protocol fee in basis points. Range: `10`–`100`; defaults to `10`. Gasless quotes require exactly `10` for the fixed 0.1% settlement fee; see [gasless fee policy](GASLESS.md#fixed-gasless-fee). |
 | `partnerAddress` | No | address | `0x0…0` | Your partner wallet to receive 50 % of collected fees. Omit or pass `0x0` for no partner. |
 | `feeOnOutput` | No | string | `"false"` | Controls fee mode. `"true"` = fee deducted from output. `"false"` = fee deducted from input (default). Affects `expectedOutputAmount` accuracy — see [Swap Integration Flow](#swap-integration-flow). |
-| `adapters` | No | string | — | Comma-separated adapter indices to restrict routing (e.g. `"3"` for PulseXV2 only, `"3,7"` for PulseXV2 + UniswapV3). Get available indices from [List Adapters](#list-adapters). |
+| `adapters` | No | string | — | Comma-separated adapter indices to restrict routing (e.g. `"3"` for PulseXV2 only, `"3,7"` for PulseXV2 + UniswapV3). Get available indices from [List Adapters](#list-adapters). |
 
 > \* If `sender` is omitted, the response will still contain routing data, `minAmountOut`, and tax info, but the `tx` object will be absent. This is useful for **showing estimated swap output before the user connects their wallet** — you can display prices, routes, and tax warnings without requiring a wallet connection. Once the user connects, re-fetch the quote with `sender` to get the ready-to-send `tx` object.
 
 #### Example Request
 
 ```
-GET /swap/quote?network=pulsechain&from=0xA1077a294dDE1B09bB078844df40758a5D0f9a27&to=0x95B303987A60C71504D99Aa1b13B4DA07b0790ab&amount=1000000000000000000&sender=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&slippage=100&fee=10&partnerAddress=0xYourPartnerWallet&feeOnOutput=true
+GET /swap/quote?network=pulsechain&from=0xA1077a294dDE1B09bB078844df40758a5D0f9a27&to=0x95B303987A60C71504D99Aa1b13B4DA07b0790ab&amount=1000000000000000000&sender=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&slippage=100&fee=10&partnerAddress=0xYourPartnerWallet&feeOnOutput=true
 ```
 
 #### Example Response
@@ -680,13 +706,13 @@ GET /swap/quote?network=pulsechain&from=0xA1077a294dDE1B09bB078844df40758a5D0f9a
   // Transaction object — only present when `sender` is provided
   // ⚠️ Always use tx.to from this response — do NOT hardcode the router address
   "tx": {
-    "to": "0x2dFc8B6e13fF7F04e37Ef97006084805D65a6F19",
+    "to": "0x2dFc8B6e13fF7F04e37Ef97006084805D65a6F19",
     "data": "0x...",     // ABI-encoded goSwitch() calldata with feeOnOutput = false
     "value": "0"          // "0" for ERC-20 input; amountIn for native-currency input
   },
   // Same swap but with fee taken from the output token instead
   "txFeeOnOutput": {
-    "to": "0x2dFc8B6e13fF7F04e37Ef97006084805D65a6F19",
+    "to": "0x2dFc8B6e13fF7F04e37Ef97006084805D65a6F19",
     "data": "0x...",     // ABI-encoded goSwitch() calldata with feeOnOutput = true
     "value": "0"
   }
@@ -705,11 +731,11 @@ GET /swap/quote?network=pulsechain&from=0xA1077a294dDE1B09bB078844df40758a5D0f9a
 | `toToken` | `string` | Output token address |
 | `receiver` | `string?` | Recipient address for output tokens. Same as `sender` unless a custom `receiver` was specified. |
 | `totalAmountIn` | `string` | Total input amount in wei |
-| `totalAmountOut` | `string` | Quoted route output in wei before the Switch protocol fee and slippage. Protocol-native quoters such as Flap Portal may already include their token-tax effect. |
+| `totalAmountOut` | `string` | Quoted route output in wei before the Switch protocol fee and slippage. Protocol-native quoters such as Flap Portal may already include their token-tax effect. |
 | `expectedOutputAmount` | `string` | Expected output the user will actually receive, in wei. Accounts for sell tax, protocol fee, and buy tax — but NOT slippage. This is the most accurate value to display as the estimated received amount. When `feeOnOutput` is passed correctly, this is **exact** (matches on-chain execution). |
-| `minAmountOut` | `string` | Minimum acceptable output after adapter-specific tax accounting, fee, and slippage. Use the API value directly; do not recompute it by multiplying the reported tax rates. This is encoded in `tx.data` as `_minTotalAmountOut`. |
+| `minAmountOut` | `string` | Minimum acceptable output after adapter-specific tax accounting, fee, and slippage. Use the API value directly; do not recompute it by multiplying the reported tax rates. This is encoded in `tx.data` as `_minTotalAmountOut`. |
 | `paths` | `SwapPath[]` | Human-readable path descriptions |
-| `routeAllocation` | `RouteAllocationPlan` | Human-readable structured route breakdown for display and analytics. It is not a drop-in on-chain ABI value. |
+| `routeAllocation` | `RouteAllocationPlan` | Human-readable structured route breakdown for display and analytics. It is not a drop-in on-chain ABI value. |
 | `tx` | `SwapTransaction?` | Ready-to-send transaction (fee on input). Only present when `sender` is provided. |
 | `txFeeOnOutput` | `SwapTransaction?` | Ready-to-send transaction (fee on output). Only present when `sender` is provided. Choose between `tx` and `txFeeOnOutput` at send time. |
 | `fromTokenTax` | `TokenTaxResponse?` | Transfer tax info for the input token. See [Tax Tokens Deep Dive](#tax-tokens-deep-dive). |
@@ -790,16 +816,16 @@ Present on every quote response as `fromTokenTax` and `toTokenTax`. Reports whet
 
 | Field | Type | Description |
 |---|---|---|
-| `adapter` | `string` | Human-readable DEX adapter name (e.g. `"PulseXV2"`) |
-| `amountIn` | `string` | Input amount routed through this adapter |
-| `amountOut` | `string` | Expected output from this adapter |
-| `fee` | `number?` | V3 fee tier or concentrated-liquidity tick-spacing hint; zero when unused |
-
-Use the API-provided `tx.data` for execution. If you intentionally construct
-router or limit-order calldata yourself, each on-chain adapter leg is
-`{ adapter, amountIn, fee, data }`; `data` is required and should be `0x` for
-adapters that need no payload. The display-oriented `routeAllocation` does not
-contain enough information to encode every route family.
+| `adapter` | `string` | Human-readable DEX adapter name (e.g. `"PulseXV2"`) |
+| `amountIn` | `string` | Input amount routed through this adapter |
+| `amountOut` | `string` | Expected output from this adapter |
+| `fee` | `number?` | V3 fee tier or concentrated-liquidity tick-spacing hint; zero when unused |
+
+Use the API-provided `tx.data` for execution. If you intentionally construct
+router or limit-order calldata yourself, each on-chain adapter leg is
+`{ adapter, amountIn, fee, data }`; `data` is required and should be `0x` for
+adapters that need no payload. The display-oriented `routeAllocation` does not
+contain enough information to encode every route family.
 
 ---
 
@@ -836,7 +862,7 @@ Errors are returned as JSON with an `error` field:
 | `"Amount must be greater than 0"` | `amount` is zero or negative |
 | `"Amount exceeds maximum allowed value"` | `amount` exceeds 10²⁷ (1 billion tokens @ 18 decimals) |
 | `"Slippage must be a number between 0 and 5000 (basis points)"` | `slippage` out of range |
-| `"Fee must be a number between 10 and 100 (basis points). Minimum fee is 0.10%."` | `fee` out of range or below minimum |
+| `"Fee must be a number between 10 and 100 (basis points). Minimum fee is 0.10%."` | `fee` out of range or below minimum |
 | `"receiver must be a valid Ethereum address (0x + 40 hex chars)"` | Malformed receiver address |
 | `"partnerAddress must be a valid Ethereum address (0x + 40 hex chars)"` | Malformed partner address |
 | `"Failed to find route"` | No viable swap path exists, or route computation timed out (30s limit) |
@@ -866,7 +892,7 @@ If the swap transaction reverts on-chain, the SwitchRouter contract returns one
 
 Switch supports a **50/50 fee-sharing** model for integration partners:
 
-1. Set a `fee` (e.g. `10` = 0.10 %, the current minimum) and your `partnerAddress` when calling the API.
+1. Set a `fee` (e.g. `10` = 0.10 %, the current minimum) and your `partnerAddress` when calling the API.
 2. The SwitchRouter contract automatically splits collected fees **during the swap**:
    - **50 %** sent to the protocol
    - **50 %** sent directly to your `partnerAddress`
@@ -945,15 +971,15 @@ await signer.sendTransaction(chosenTx);
 
 ## Limit Orders
 
-Switch Limit Orders let users place **gasless, signed orders** that are filled automatically when market conditions are met — no gas to create, no token deposits, EIP-712 signed.
-
-**→ Full integration guide: [`LIMIT-ORDERS.md`](LIMIT-ORDERS.md)**
-
-Covers both `pulsechain` and `robinhood`: creating orders, live deployment
-discovery, approvals, `feeOnOutput` decision rules, native PLS/ETH flows,
-querying, cancellation, API types, and EIP-712 details. Use
-`fetchLimitOrderConfig({ network })` at startup and include `network` in every
-orderbook request.
+Switch Limit Orders let users place **gasless, signed orders** that are filled automatically when market conditions are met — no gas to create, no token deposits, EIP-712 signed.
+
+**→ Full integration guide: [`LIMIT-ORDERS.md`](LIMIT-ORDERS.md)**
+
+Covers both `pulsechain` and `robinhood`: creating orders, live deployment
+discovery, approvals, `feeOnOutput` decision rules, native PLS/ETH flows,
+querying, cancellation, API types, and EIP-712 details. Use
+`fetchLimitOrderConfig({ network })` at startup and include `network` in every
+orderbook request.
 
 ---
 
@@ -969,34 +995,34 @@ Robinhood constants are available from
 | Name | Value |
 |---|---|
 | **Chain** | PulseChain (Chain ID `369`); Robinhood Chain uses ID `4663` and network-specific exports |
-| **SwitchRouter** (current) | `0x2dFc8B6e13fF7F04e37Ef97006084805D65a6F19` |
-| **SwitchRouter** (legacy) | `0x0305fcb5dA680EA6fd1B01A96C1949175B99d406` |
-| **SwitchLimitOrder** (V3 — current protected) | `0x2afBf0aB8d958a0227742F7a8BdA00c96372E4D7` |
-| **SwitchLimitOrder** (V2 — legacy) | `0x8e3881bdF81Fc0211383B2e576076B654F7aFD86` |
-| **SwitchLimitOrder** (V1 — legacy) | `0x0e884072a891b406C0D814907A1E2310fE5F5Deb` |
-| **SwitchPLSFlow** (V3 — current protected) | `0x0362177FF2ad25a33a879c881a5055575C63a4cE` |
-| **SwitchPLSFlow** (V2 — legacy) | `0xCf5606bdC750d8626Cec32CA2E1BB207968db1D5` |
-| **SwitchPLSFlow** (V1 — legacy) | `0x88c9e2C83b6B7c707602e548481e58E920694E64` |
-| **Direct-fill quoter** | `0x23A95b0f69c993CFe6180a266A93F7560102e929` |
-| **Limit-order adapter** | Index `17`; `0x7B9761484301a8FE4a2BA47194F7646eEF8e1cDd` |
-| **LimitOrderAdmin** | `0x9C8B9012AfC0489dE612F7039665212EB88be127` |
-| **OperatorAccessRegistry** | `0x7dA1AB04A712479569cCaD783Ca6114b763e36Ad` |
-| **Native PLS sentinel** | `0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE` |
-| **WPLS** | `0xA1077a294dDE1B09bB078844df40758a5D0f9a27` |
-| **Finvesta V3 adapter** | Index `20`; `0x012c44d0C465819eF3CeAC208e0c1B272087a8b4` (not transfer-tax safe) |
-| **Finvesta V3 factory** | `0x7f5c7C5144b4B4c6e954A5b2D75C318C5467EFDc` |
-| **Finvesta fee tiers** | `100`, `500`, `2500`, `10000` |
-| **Trench V2 adapter** | Index `21`; `0xAf48bb0936D9fA522650236917321D89978A8591` (direct-pair, transfer-tax safe) |
-| **Trench V2 factory** | `0xA024e4574406BEf89e624c75758c700B5bED27C7` |
-| **Trench V3 adapter** | Index `22`; `0x01957eC5FCC079f1bB388b9f261278daC42cf2E9` (not transfer-tax safe) |
-| **Trench V3 factory** | `0xCAeF0a906F3323595A8faA14DF7eDee6F59220af` |
-| **Trench V3 fee tiers** | `100`, `500`, `2500`, `3000`, `10000` |
-| **Fee denominator** | `10000` (basis points) |
+| **SwitchRouter** (current) | `0x2dFc8B6e13fF7F04e37Ef97006084805D65a6F19` |
+| **SwitchRouter** (legacy) | `0x0305fcb5dA680EA6fd1B01A96C1949175B99d406` |
+| **SwitchLimitOrder** (V3 — current protected) | `0x2afBf0aB8d958a0227742F7a8BdA00c96372E4D7` |
+| **SwitchLimitOrder** (V2 — legacy) | `0x8e3881bdF81Fc0211383B2e576076B654F7aFD86` |
+| **SwitchLimitOrder** (V1 — legacy) | `0x0e884072a891b406C0D814907A1E2310fE5F5Deb` |
+| **SwitchPLSFlow** (V3 — current protected) | `0x0362177FF2ad25a33a879c881a5055575C63a4cE` |
+| **SwitchPLSFlow** (V2 — legacy) | `0xCf5606bdC750d8626Cec32CA2E1BB207968db1D5` |
+| **SwitchPLSFlow** (V1 — legacy) | `0x88c9e2C83b6B7c707602e548481e58E920694E64` |
+| **Direct-fill quoter** | `0x23A95b0f69c993CFe6180a266A93F7560102e929` |
+| **Limit-order adapter** | Index `17`; `0x7B9761484301a8FE4a2BA47194F7646eEF8e1cDd` |
+| **LimitOrderAdmin** | `0x9C8B9012AfC0489dE612F7039665212EB88be127` |
+| **OperatorAccessRegistry** | `0x7dA1AB04A712479569cCaD783Ca6114b763e36Ad` |
+| **Native PLS sentinel** | `0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE` |
+| **WPLS** | `0xA1077a294dDE1B09bB078844df40758a5D0f9a27` |
+| **Finvesta V3 adapter** | Index `20`; `0x012c44d0C465819eF3CeAC208e0c1B272087a8b4` (not transfer-tax safe) |
+| **Finvesta V3 factory** | `0x7f5c7C5144b4B4c6e954A5b2D75C318C5467EFDc` |
+| **Finvesta fee tiers** | `100`, `500`, `2500`, `10000` |
+| **Trench V2 adapter** | Index `21`; `0xAf48bb0936D9fA522650236917321D89978A8591` (direct-pair, transfer-tax safe) |
+| **Trench V2 factory** | `0xA024e4574406BEf89e624c75758c700B5bED27C7` |
+| **Trench V3 adapter** | Index `22`; `0x01957eC5FCC079f1bB388b9f261278daC42cf2E9` (not transfer-tax safe) |
+| **Trench V3 factory** | `0xCAeF0a906F3323595A8faA14DF7eDee6F59220af` |
+| **Trench V3 fee tiers** | `100`, `500`, `2500`, `3000`, `10000` |
+| **Fee denominator** | `10000` (basis points) |
 | **Max slippage** | `5000` bps (50 %) |
 | **Max fee** | `100` bps (1 %) |
-| **Regular swap fee** | `10` bps (0.10 %) — enforced on-chain by `MIN_FEE` |
-| **Limit-order fee** | `30` bps (0.30 %); the LimitOrder is Router-fee-exempt |
-| **Maximum operator excess** | `500` bps (5 %) of the protected contract's cap base |
+| **Regular swap fee** | `10` bps (0.10 %) — enforced on-chain by `MIN_FEE` |
+| **Limit-order fee** | `30` bps (0.30 %); the LimitOrder is Router-fee-exempt |
+| **Maximum operator excess** | `500` bps (5 %) of the protected contract's cap base |
 | **Default slippage** | `50` bps (0.50 %) |
 | **Swap API base** | `https://quote.switch.win` |
 | **Limit Order API base** | `https://quote.switch.win` |