@switch-win/sdk 1.2.2 → 1.2.3

package/README.md

@@ -121,8 +121,11 @@ 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.
+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 fourteen adapters across Uniswap, SwapHood,
+Up33, Sheriff, Aeon, Catnip, PancakeSwap, RobinSwap, SushiSwap, and Switch limit
+orders.
 
 For network configuration, deployed addresses, tax handling, execution, and
 the complete frontend token list, see [`ROBINHOOD.md`](ROBINHOOD.md).
@@ -139,7 +142,7 @@ const url = buildRobinhoodQuoteUrl({
   to: ROBINHOOD_TOKENS.USDG.address,
   amount: 1_000_000_000_000_000n,
   sender: walletAddress,
-  slippage: 50,
+  slippage: 100, // 1%, matching the Robinhood frontend default
 });
 
 const response = await fetch(url, {
@@ -917,11 +920,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: creating orders, approvals, `feeOnOutput` decision guide (tax tokens & operator flexibility), querying, cancellation, API reference, types, and EIP-712 details.
+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.
 
 ---
 

package/ROBINHOOD.md

@@ -11,8 +11,8 @@ Production integration reference for Switch swaps on Robinhood Chain mainnet.
 | Explorer | `https://robinhoodchain.blockscout.com` |
 | Quote API | `https://quote.switch.win/swap/quote` |
 | Tax API | `https://quote.switch.win/swap/checkTax` |
-| Supported liquidity | Uniswap V2, V3, and hookless static-fee V4 |
-| Limit orders | Not currently available |
+| Supported liquidity | 14 adapters: Uniswap V2/V3/V4, Switch limit orders, SwapHood, Up33, Sheriff, Aeon, Catnip, PancakeSwap, RobinSwap, and SushiSwap |
+| Limit orders | Available: EIP-712 ERC-20 orders plus native ETH flow |
 
 ## Contents
 
@@ -111,6 +111,16 @@ await window.ethereum.request({
 | SwitchLimitOrder | `0x752c50DDd3B426cAE3D7A995F313Ac74ac6B0230` |
 | Native ETH flow | `0x029FfC6aF9112eA078f1D6f4a98826DDB2136cf6` |
 | Switch Limit Order adapter (index 3) | `0x412F625072c10e58C619D1e0b3C95cd3d5689871` |
+| SwapHood V2 adapter (index 4) | `0x6D8746f02e52944c13824fA691c6f4186E463354` |
+| SwapHood V3 adapter (index 5) | `0x9645dE0AcB48F0AAefdBEb423F0558457907DE98` |
+| Up33 CL adapter (index 6) | `0x388179D2FB0ABcE9b03068916aF8a3c4dfD023c8` |
+| Sheriff V2 adapter (index 7) | `0xBDB3EB0355981500f58C9bc77c3E61762844A146` |
+| Sheriff Algebra adapter (index 8) | `0xeFE1affb0e2Bb8A9F7d9D30751bAF679996ADA26` |
+| Aeon Algebra adapter (index 9) | `0x20615954FB87360139e7DdDB519359498EbD1904` |
+| Catnip V2 adapter (index 10) | `0x5b2Ca358d56490Dc86224D502522314De7707237` |
+| PancakeSwap V2 adapter (index 11) | `0x3B6e71A59553143937Fef74a7B50AFD24528786E` |
+| RobinSwap V3 adapter (index 12) | `0x798f77D63b46b0E019de206E111e5ea5CC16BEc8` |
+| SushiSwap V3 adapter (index 13) | `0xca3EA0Fd6E31f94c81B6586836790adE638313ED` |
 
 The V4 adapter was created in
 [deployment transaction `0x60d5...34a7`](https://robinhoodchain.blockscout.com/tx/0x60d56466a8162a643a15ecde98322ec05ea23d44d03fbd817df4ddbaef4834a7)
@@ -162,6 +172,26 @@ Submit signed orders to `POST /limit-orders?network=robinhood`. For
 `feeOnOutput=false`, approve `ROBINHOOD_SWITCH_CONTRACTS.limitOrder`; for
 `feeOnOutput=true`, approve `ROBINHOOD_SWITCH_CONTRACTS.router`.
 
+Applications should fetch `/limit-orders/config?network=robinhood` at startup
+instead of relying only on static addresses. The SDK exposes this as:
+
+```ts
+const config = await fetchLimitOrderConfig({ network: "robinhood" });
+const signing = getNetworkEIP712SigningParams(
+  "robinhood",
+  config.limitOrderContract,
+);
+const approvalTarget = getLimitOrderApprovalTarget(
+  "robinhood",
+  order.feeOnOutput,
+  { limitOrderContract: config.limitOrderContract },
+);
+```
+
+Include `limitOrderContract: config.limitOrderContract` with the submitted
+signed order. Every returned order also carries its own deployment address;
+operators must fill and makers must cancel against that per-order address.
+
 Native ETH input orders are created on-chain through
 `ROBINHOOD_SWITCH_CONTRACTS.nativeEthFlow` and are indexed from its events; do
 not POST them as signed EOA orders. Native ETH output is represented by WETH in
@@ -221,9 +251,10 @@ The canonical Robinhood V4 infrastructure is available through
 | Universal Router | `0x8876789976decbfcbbbe364623c63652db8c0904` |
 | Permit2 | `0x000000000022D473030F116dDEE9F6B43aC78BA3` |
 
-Tax-token safety is unchanged: if either side is detected as a transfer-tax
-token, the complete route is restricted to Uniswap V2 adapter index `0`.
-Uniswap V3 and V4 are both excluded from that quote.
+Tax-token safety is unchanged: if either side is detected as a transfer-tax
+token, the complete route is restricted to direct-pair V2 adapters `0`, `4`,
+`7`, `10`, and `11`. Concentrated-liquidity adapters are excluded from that
+quote.
 
 ## Swap integration flow
 
@@ -239,8 +270,9 @@ Use the same sequence as a PulseChain integration:
 6. Show `expectedOutputAmount`, `minAmountOut`, route allocation, and detected
    taxes to the user.
 
-Any swap involving a tax token is routed entirely through Uniswap V2. This
-also applies when both input and output are tax tokens.
+Any swap involving a tax token is routed entirely through the tax-safe
+direct-pair V2 adapter set (`0`, `4`, `7`, `10`, and `11`). This also applies
+when both input and output are tax tokens.
 
 ## Quickstart
 
@@ -257,7 +289,7 @@ const url = buildRobinhoodQuoteUrl({
   to: ROBINHOOD_TOKENS.USDG.address,
   amount: 1_000_000_000_000_000n,
   sender: walletAddress,
-  slippage: 50, // 0.50%, expressed in basis points
+  slippage: 100, // 1.00%, the Robinhood frontend default
   feeOnOutput,
 });
 
@@ -281,7 +313,7 @@ Equivalent curl request:
 
 ```bash
 curl -H "x-api-key: YOUR_KEY" \
-  "https://quote.switch.win/swap/quote?network=robinhood&from=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&to=0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168&amount=1000000000000000&sender=0xYOUR_WALLET&slippage=50"
+  "https://quote.switch.win/swap/quote?network=robinhood&from=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&to=0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168&amount=1000000000000000&sender=0xYOUR_WALLET&slippage=100"
 ```
 
 Omit `sender` for a display-only quote. Fetch again with the sender immediately
@@ -374,7 +406,7 @@ const quoteUrl = buildRobinhoodQuoteUrl({
   to: tokenOut,
   amount: amountIn,
   sender: walletAddress,
-  slippage: 50,
+  slippage: 100,
   feeOnOutput,
 });
 
@@ -441,17 +473,28 @@ Robinhood currently returns:
 
 | Index | Adapter |
 |---:|---|
-| `0` | Uniswap V2 |
-| `1` | Uniswap V3 |
-| `2` | Uniswap V4 |
+| `0` | Uniswap V2 |
+| `1` | Uniswap V3 |
+| `2` | Uniswap V4 |
+| `3` | Switch Limit Orders |
+| `4` | SwapHood V2 |
+| `5` | SwapHood V3 |
+| `6` | Up33 CL |
+| `7` | Sheriff V2 |
+| `8` | Sheriff Algebra |
+| `9` | Aeon Algebra |
+| `10` | Catnip V2 |
+| `11` | PancakeSwap V2 |
+| `12` | RobinSwap V3 |
+| `13` | SushiSwap V3 |
 
 Treat the endpoint response, not this document, as the source of truth for
 which adapters are currently selectable.
 
-Do not permanently hard-code the available adapter list in an integration.
-Fetch it when presenting routing-source controls. If a quote involves a tax
-token, the backend overrides routing to tax-safe adapter `0`; an explicit
-filter that excludes adapter `0` is rejected.
+Do not permanently hard-code the available adapter list in an integration.
+Fetch it when presenting routing-source controls. If a quote involves a tax
+token, the backend restricts routing to tax-safe adapters `0`, `4`, `7`, `10`,
+and `11`; an explicit filter that excludes all of them is rejected.
 
 ### Check token tax
 
@@ -487,7 +530,7 @@ GET https://quote.switch.win/swap/quote
 | `amount` | Yes | Raw input amount. |
 | `sender` | No | Required when transaction calldata is needed. |
 | `receiver` | No | Output recipient; defaults to `sender`. |
-| `slippage` | No | Basis points; default `50` (`0.5%`). |
+| `slippage` | No | Basis points; API fallback `50` (`0.5%`). The Switch Robinhood frontend explicitly requests `100` (`1%`). |
 | `fee` | No | Partner/protocol fee in basis points. |
 | `partnerAddress` | No | Fee-sharing recipient. |
 | `feeOnOutput` | No | `true` takes the fee from output; `false` takes it from input. |
@@ -529,7 +572,7 @@ Common Robinhood errors include:
 - Missing or unsupported `network`.
 - Invalid token, sender, receiver, or partner address.
 - Invalid raw amount, slippage, fee, gas price, or adapter filter.
-- A tax-token quote explicitly excluded the Uniswap V2 adapter.
+- A tax-token quote explicitly excluded every tax-safe direct-pair V2 adapter.
 - No viable route across the currently active adapters, or insufficient liquidity.
 - RPC timeout or public-RPC rate limiting.
 - Missing executable transaction because `sender` was omitted.
@@ -576,7 +619,13 @@ into the UI separately from this list.
 | TENDIES | TENDIES | `0x45242320DBB855EeA8Fd36804C6487E10E97FCF9` | 18 |
 | GME | GameStop | `0x7e86381A763F0Ecca2bDF27C54eAC403ddD48123` | 18 |
 | 4663 | 4663 | `0xd4052415613B34Af236024B895574c467f65b6dD` | 18 |
-| MARIAN | Lady Marian | `0x01637b14B7378B99dE75A64d50656d98488D9a4d` | 18 |
+| MARIAN | Lady Marian | `0x01637b14B7378B99dE75A64d50656d98488D9a4d` | 18 |
+| Index | The Index | `0x56910D4409F3a0C78C64DD8D0545FF0705389870` | 18 |
+| VEX | ProjectVex | `0x8Ff92566f2e81BDd68EDfAa8cde73942A723796b` | 18 |
+| HOODIE | HOODIE | `0xC72c01AAB5f5678dc1d6f5C6d2B417d91D402Ba3` | 18 |
+| WISHBONE | WISHBONE | `0x77581054581B9c525E7dd7a0155DE43867532d03` | 18 |
+| VLAD | The Green Bull | `0x31BE8f7485e36928C9De86566c62da82d4B6BF81` | 18 |
+| AEON | Aeon | `0xd4c93eD1843606f92CccA078941f3d52A585982f` | 18 |
 
 The ordered list is exported as `ROBINHOOD_FRONTEND_TOKEN_LIST`.
 
@@ -586,22 +635,38 @@ Always identify tokens by address and obtain a fresh quote and tax check.
 
 ### Routing configuration
 
-Switch currently evaluates:
-
-- Uniswap V2 adapter index `0`.
-- Uniswap V3 adapter index `1`.
-- V3 fee tiers `100`, `500`, `3000`, and `10000`.
-- Trusted routing hubs WETH, USDG, VIRTUAL, and CASHCAT.
-
-The prepared V4 integration reserves adapter index `2`. Once activated, it
-discovers hookless static-fee V4 pools by complete `PoolKey` rather than
-applying the V3 fee-tier list. Native-ETH V4 currencies are normalized through the WETH/native
-alias described above. Until `/swap/adapters` returns index `2`, V4 is not part
-of live production quotes.
-
-If either side is detected as a transfer-tax token, the backend restricts the
-entire route (including every split and intermediate hop) to Uniswap V2. V3 is
-not considered for that quote, and V4 will remain excluded after activation.
+The production router currently exposes fourteen ordered adapters:
+
+| Index | Venue | Routing family |
+|---:|---|---|
+| `0` | Uniswap V2 | Direct-pair V2 |
+| `1` | Uniswap V3 | V3 tiers `100`, `500`, `3000`, `10000` |
+| `2` | Uniswap V4 | Complete hookless static-fee `PoolKey` |
+| `3` | Switch limit orders | Signed/on-chain order liquidity |
+| `4` | SwapHood V2 | Pair-owned variable-fee V2 |
+| `5` | SwapHood V3 | Pancake V3 tiers `100`, `500`, `2500`, `10000` |
+| `6` | Up33 | Slipstream CL tick spacings `1`, `10`, `50`, `60`, `100`, `200`, `2000` |
+| `7` | Sheriff V2 | Pair-owned variable-fee V2 |
+| `8` | Sheriff | Algebra Integral |
+| `9` | Aeon | Algebra Integral with plugin-aware fees |
+| `10` | Catnip | Direct-pair V2, fixed 30 bps |
+| `11` | PancakeSwap | Direct-pair V2, fixed 25 bps |
+| `12` | RobinSwap | V3 tiers `100`, `500`, `2500`, `3000`, `10000` |
+| `13` | SushiSwap | V3 tiers `500`, `3000`, `10000` |
+
+V4 pools are discovered by complete `PoolKey`, not by applying a V3 fee-tier
+list. Native-ETH V4 currencies are normalized through the WETH/native alias
+described above. V3-style and Up33 route legs preserve the exact fee tier or
+tick spacing that won the quote for every direct and multi-hop allocation.
+
+Trusted routing hubs are WETH, USDG, VIRTUAL, CASHCAT, HOODRAT, TENDIES,
+JUGGERNAUT, MARIAN, and WALLET. The expanded set was selected from the
+2026-07-16 pair-connectivity audit and zero-tax checks. VEX is excluded because
+it is taxed; INDEX remains an endpoint token but is excluded because its
+dominant liquidity depends on V4 hooks that are not yet supported. If either side is
+detected as a transfer-tax token, the backend restricts the entire route to
+direct-pair V2 adapters `0`, `4`, `7`, `10`, and `11`; concentrated-liquidity
+and limit-order adapters are excluded.
 
 The API may split a quote across routes and adapters. Integrators should render
 the returned `paths` or `routeAllocation` instead of assuming a single path.
@@ -616,17 +681,16 @@ For server integrations, contact Switch to coordinate the expected request
 rate and IP allowlisting. Do not distribute one production key across
 untrusted clients.
 
-## Current limitations
-
-- Robinhood limit orders are not deployed.
-- Rialto DEX is not integrated.
-- The production router supports Uniswap V2, V3, and supported hookless
-  static-fee V4 liquidity. V4 participates in quotes whenever adapter index
-  `2` is advertised by `/swap/adapters`.
-- The first V4 phase intentionally excludes hooked and dynamic-fee pools.
-- A V4 allocation currently selects its best single PoolKey; intra-V4
-  multi-pool splitting is not yet enabled. V4 can still split against V2/V3.
-- Contract and token addresses must be treated as chain-specific.
+## Current limitations
+
+- Rialto liquidity is not integrated.
+- Robinhood market routing is limited to the fourteen production adapters
+  listed above. Always use `/swap/adapters` as the runtime source of truth.
+- The first V4 phase intentionally excludes hooked and dynamic-fee pools.
+- A V4 allocation currently selects its best single PoolKey; intra-V4
+  multi-pool splitting is not yet enabled. V4 can still split against other
+  eligible adapters.
+- Contract and token addresses must be treated as chain-specific.
 
 See the main [SDK reference](README.md) for authentication, partner fees,
 response types, error handling, and the complete swap API schema.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@switch-win/sdk",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Official integration kit for the Switch DEX Aggregator on PulseChain and Robinhood Chain",
   "author": "BuildTheTech",
   "license": "MIT",
@@ -37,7 +37,8 @@
     "src/",
     "abi/",
     "README.md",
-    "ROBINHOOD.md"
+    "ROBINHOOD.md",
+    "LIMIT-ORDERS.md"
   ],
   "devDependencies": {
     "typescript": "^5.9.3"

package/src/index.ts

@@ -45,8 +45,9 @@ export type {
   CancelLimitOrderResponse,
   ListLimitOrdersResponse,
   LimitOrderPair,
-  LimitOrderStats,
-  LimitOrderMutationResponse,
+  LimitOrderStats,
+  LimitOrderConfigResponse,
+  LimitOrderMutationResponse,
 } from "./types.js";
 
 export { isErrorResponse } from "./types.js";
@@ -95,31 +96,42 @@ export {
 // Limit Order helpers
 export {
   buildLimitOrder,
-  getEIP712SigningParams,
+  getEIP712SigningParams,
+  getNetworkEIP712SigningParams,
+  getLimitOrderNetworkConfig,
+  getLimitOrderApprovalTarget,
   getApprovalTarget,
   getRouterApprovalTarget,
   shouldUnwrapOutput,
-  getPLSFlowAddress,
-  isNativePLS,
+  getPLSFlowAddress,
+  getNativeFlowAddress,
+  isNativePLS,
+  isNativeCurrency,
   submitLimitOrder,
   cancelLimitOrder,
   fetchLimitOrders,
   fetchLimitOrder,
-  fetchLimitOrderPairs,
-  fetchLimitOrderStats,
-} from "./limit-orders.js";
+  fetchLimitOrderPairs,
+  fetchLimitOrderConfig,
+  fetchLimitOrderStats,
+  LIMIT_ORDER_NETWORK_CONFIGS,
+} from "./limit-orders.js";
 
 export type {
-  BuildLimitOrderOptions,
-  ListLimitOrdersOptions,
-} from "./limit-orders.js";
+  BuildLimitOrderOptions,
+  ListLimitOrdersOptions,
+  LimitOrderNetwork,
+  LimitOrderNetworkConfig,
+  LimitOrderNetworkOptions,
+} from "./limit-orders.js";
 
 // Network-specific swap configuration
 export {
   ROBINHOOD_NETWORK,
   ROBINHOOD_CHAIN,
-  ROBINHOOD_NATIVE_ETH,
-  ROBINHOOD_SWITCH_CONTRACTS,
+  ROBINHOOD_NATIVE_ETH,
+  ROBINHOOD_LIMIT_ORDER_EIP712_DOMAIN,
+  ROBINHOOD_SWITCH_CONTRACTS,
   ROBINHOOD_UNISWAP_CONTRACTS,
   ROBINHOOD_TOKENS,
   ROBINHOOD_FRONTEND_TOKEN_LIST,

package/src/limit-orders.ts

@@ -2,7 +2,8 @@
  * Switch Limit Orders (V2) — Helper Functions
  *
  * Provides a complete toolkit for creating, signing, submitting, querying,
- * and cancelling EIP-712 signed limit orders on PulseChain.
+ * and cancelling EIP-712 signed limit orders on PulseChain and Robinhood
+ * Chain.
  *
  * ## How it works
  *
@@ -10,7 +11,8 @@
  * 2. **Sign** via EIP-712 with your wallet (ethers.js `signTypedData`)
  * 3. **Submit** the signed order to the Switch backend with `submitLimitOrder()`
  * 4. The Switch filler bot monitors active orders and fills them when profitable
- * 5. **Cancel** an order on-chain via `invalidateNonce()` + notify backend with `cancelLimitOrder()`
+ * 5. **Cancel** an order on-chain via `invalidateNonce()`; the backend indexer
+ *    observes the cancellation event
  *
  * @example
  * ```ts
@@ -26,7 +28,8 @@ import type {
   ListLimitOrdersResponse,
   LimitOrderRecord,
   LimitOrderPair,
-  LimitOrderStats,
+  LimitOrderStats,
+  LimitOrderConfigResponse,
   LimitOrderStatus,
   ErrorResponse,
 } from "./types.js";
@@ -40,8 +43,15 @@ import {
   SWITCH_LIMIT_ORDER,
   SWITCH_ROUTER,
   SWITCH_PLS_FLOW,
-  WPLS,
-} from "./constants.js";
+  WPLS,
+  NATIVE_PLS,
+} from "./constants.js";
+import {
+  ROBINHOOD_CHAIN,
+  ROBINHOOD_NATIVE_ETH,
+  ROBINHOOD_SWITCH_CONTRACTS,
+  ROBINHOOD_TOKENS,
+} from "./networks/robinhood.js";
 
 // ── Re-export EIP-712 constants for convenience ─────────────────────────────
 
@@ -247,7 +257,7 @@ export function shouldUnwrapOutput(
 }
 
 // ═══════════════════════════════════════════════════════════════════════════════
-// PLSFlow (Native PLS Limit Orders)
+// Native-currency flow (SwitchPLSFlow ABI: PLS on PulseChain, ETH on Robinhood)
 // ═══════════════════════════════════════════════════════════════════════════════
 
 /**
@@ -262,8 +272,83 @@ export function getPLSFlowAddress(nativeFlowContract?: string): string {
   return nativeFlowContract || SWITCH_PLS_FLOW;
 }
 
+/** Networks supported by the shared Switch limit-order API. */
+export type LimitOrderNetwork = "pulsechain" | "robinhood";
+
+/** Complete deployment metadata needed to create or fill limit orders. */
+export interface LimitOrderNetworkConfig {
+  network: LimitOrderNetwork;
+  chainId: number;
+  chainName: string;
+  nativeSymbol: "PLS" | "ETH";
+  nativeSentinel: string;
+  wrappedNativeToken: string;
+  routerContract: string;
+  limitOrderContract: string;
+  nativeFlowContract: string;
+}
+
+/** Static defaults. Prefer {@link fetchLimitOrderConfig} at application startup. */
+export const LIMIT_ORDER_NETWORK_CONFIGS: Readonly<
+  Record<LimitOrderNetwork, LimitOrderNetworkConfig>
+> = {
+  pulsechain: {
+    network: "pulsechain",
+    chainId: 369,
+    chainName: "PulseChain",
+    nativeSymbol: "PLS",
+    nativeSentinel: NATIVE_PLS,
+    wrappedNativeToken: WPLS,
+    routerContract: SWITCH_ROUTER,
+    limitOrderContract: SWITCH_LIMIT_ORDER,
+    nativeFlowContract: SWITCH_PLS_FLOW,
+  },
+  robinhood: {
+    network: "robinhood",
+    chainId: ROBINHOOD_CHAIN.id,
+    chainName: ROBINHOOD_CHAIN.name,
+    nativeSymbol: "ETH",
+    nativeSentinel: ROBINHOOD_NATIVE_ETH,
+    wrappedNativeToken: ROBINHOOD_TOKENS.WETH.address,
+    routerContract: ROBINHOOD_SWITCH_CONTRACTS.router,
+    limitOrderContract: ROBINHOOD_SWITCH_CONTRACTS.limitOrder,
+    nativeFlowContract: ROBINHOOD_SWITCH_CONTRACTS.nativeEthFlow,
+  },
+} as const;
+
+/** Return the static deployment defaults for a supported limit-order network. */
+export function getLimitOrderNetworkConfig(
+  network: LimitOrderNetwork = "pulsechain",
+): LimitOrderNetworkConfig {
+  return LIMIT_ORDER_NETWORK_CONFIGS[network];
+}
+
+/** Build the correct EIP-712 signing domain for a supported network. */
+export function getNetworkEIP712SigningParams(
+  network: LimitOrderNetwork,
+  limitOrderContract?: string,
+) {
+  const config = getLimitOrderNetworkConfig(network);
+  return getEIP712SigningParams(
+    limitOrderContract ?? config.limitOrderContract,
+    config.chainId,
+  );
+}
+
+/** Resolve the maker's ERC-20 approval target for the selected fee mode. */
+export function getLimitOrderApprovalTarget(
+  network: LimitOrderNetwork,
+  feeOnOutput: boolean,
+  overrides: { limitOrderContract?: string; routerContract?: string } = {},
+): string {
+  const config = getLimitOrderNetworkConfig(network);
+  return feeOnOutput
+    ? getRouterApprovalTarget(overrides.routerContract ?? config.routerContract)
+    : getApprovalTarget(overrides.limitOrderContract ?? config.limitOrderContract);
+}
+
 export interface LimitOrderNetworkOptions {
-  network?: "pulsechain" | "robinhood";
+  network?: LimitOrderNetwork;
 }
 
 function endpointForNetwork(endpoint: string, network?: string): string {
@@ -282,10 +367,27 @@ function endpointForNetwork(endpoint: string, network?: string): string {
  * @param tokenIn - The input token address
  * @returns `true` if tokenIn is the native PLS sentinel address
  */
-export function isNativePLS(tokenIn: string): boolean {
+export function isNativePLS(tokenIn: string): boolean {
   const NATIVE_SENTINEL = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
   return tokenIn.toLowerCase() === NATIVE_SENTINEL.toLowerCase();
-}
+}
+
+/** Network-neutral native-currency sentinel check (PLS or ETH). */
+export function isNativeCurrency(tokenIn: string): boolean {
+  const normalized = tokenIn.toLowerCase();
+  return (
+    normalized === NATIVE_PLS.toLowerCase() ||
+    normalized === ROBINHOOD_NATIVE_ETH.toLowerCase()
+  );
+}
+
+/** Return the native-order flow contract for PulseChain or Robinhood Chain. */
+export function getNativeFlowAddress(
+  network: LimitOrderNetwork,
+  nativeFlowContract?: string,
+): string {
+  return nativeFlowContract ?? getLimitOrderNetworkConfig(network).nativeFlowContract;
+}
 
 // ═══════════════════════════════════════════════════════════════════════════════
 // API Helpers
@@ -310,7 +412,7 @@ export function isNativePLS(tokenIn: string): boolean {
  * 4. Do **not** navigate away or close the signing flow until the
  *    backend confirms the order.
  *
- * PLSFlow (native PLS) orders are an exception — they are recorded
+ * Native PLS/ETH flow orders are an exception — they are recorded
  * on-chain first, so the backend can discover them via event indexing
  * even if the POST never arrives.
  *
@@ -344,16 +446,17 @@ export async function submitLimitOrder(
 }
 
 /**
- * Cancel a limit order on the Switch backend (marks it CANCELLED in the DB).
- *
- * **Important:** This only removes the order from the backend orderbook. To
- * prevent the order from being filled on-chain, you MUST also call
- * `invalidateNonce(nonce)` on the SwitchLimitOrder contract. See the
- * cancellation guide in the README.
+ * Legacy helper for backend deployments that implemented REST cancellation.
+ *
+ * The current hosted Switch API intentionally has no DELETE endpoint.
+ * Cancellation must be performed on-chain with `invalidateNonce(nonce)` on
+ * the contract stored in the order's `limitOrderContract` field. The indexer
+ * then updates the order status from the emitted event.
  *
  * @param maker - Maker address
  * @param nonce - Nonce of the order to cancel
- * @returns Success confirmation or error
+ * @returns Success confirmation or error on compatible legacy backends
+ * @deprecated Do not use with the hosted Switch API; cancel on-chain instead.
  */
 export async function cancelLimitOrder(
   maker: string,
@@ -372,7 +475,7 @@ export async function cancelLimitOrder(
 /** Filter options for listing limit orders */
 export interface ListLimitOrdersOptions {
   /** Backend network process to query. */
-  network?: "pulsechain" | "robinhood";
+  network?: LimitOrderNetwork;
   /** Filter by order status. Default: `"ACTIVE"` */
   status?: LimitOrderStatus;
   /** Filter by maker address */
@@ -476,7 +579,20 @@ export async function fetchLimitOrderPairs(
 ): Promise<LimitOrderPair[]> {
   const res = await fetch(endpointForNetwork(LIMIT_ORDER_PAIRS_ENDPOINT, options.network));
   return res.json() as Promise<LimitOrderPair[]>;
-}
+}
+
+/** Fetch the active deployment and EIP-712 domain for a network. */
+export async function fetchLimitOrderConfig(
+  options: LimitOrderNetworkOptions = {},
+): Promise<LimitOrderConfigResponse> {
+  const res = await fetch(
+    endpointForNetwork(`${LIMIT_ORDERS_ENDPOINT}/config`, options.network),
+  );
+  if (!res.ok) {
+    throw new Error(`Failed to fetch limit-order config (${res.status})`);
+  }
+  return res.json() as Promise<LimitOrderConfigResponse>;
+}
 
 /**
  * Fetch summary statistics for all limit orders.

package/src/networks/index.ts

@@ -1,8 +1,9 @@
 export {
   ROBINHOOD_NETWORK,
   ROBINHOOD_CHAIN,
-  ROBINHOOD_NATIVE_ETH,
-  ROBINHOOD_SWITCH_CONTRACTS,
+  ROBINHOOD_NATIVE_ETH,
+  ROBINHOOD_LIMIT_ORDER_EIP712_DOMAIN,
+  ROBINHOOD_SWITCH_CONTRACTS,
   ROBINHOOD_UNISWAP_CONTRACTS,
   ROBINHOOD_TOKENS,
   ROBINHOOD_FRONTEND_TOKEN_LIST,