@switch-win/sdk 1.0.5 → 1.0.7

package/README.md

@@ -86,7 +86,8 @@ curl -H "x-api-key: YOUR_KEY" \
 # 2. Approve the SwitchRouter to spend your input token (ERC-20 only, skip for native PLS)
 
 # 3. Send the transaction using the `tx` object from the response:
-#    { to: "0x31077...", data: "0x...", value: "0" }
+#    { to: "0x0305...", data: "0x...", value: "0" }
+#    ⚠️ Always use tx.to — do NOT hardcode the router address
 ```
 
 ### Using the SDK types (TypeScript)
@@ -106,10 +107,12 @@ const quote: BestPathResponse = await res.json();
 const token = new ethers.Contract(fromToken, ["function approve(address,uint256)"], signer);
 await (await token.approve(SWITCH_ROUTER, amount)).wait();
 
-// 3. Send the swap
+// 3. Send the swap — always use quote.tx which includes the correct router address
 await signer.sendTransaction(quote.tx);
 ```
 
+> **⚠️ Always use `tx.to` from the quote response** when sending swap transactions. Do NOT hardcode the router address — the contract may be redeployed.
+
 For a production integration with tax token handling, adapter filtering, and fee mode selection, see [Swap Integration Flow](#swap-integration-flow) and the [full examples](examples/).
 
 ---
@@ -297,6 +300,8 @@ console.log("Swap confirmed:", receipt.hash);
 
 That's it. The `tx.data` already encodes the correct `goSwitch()` call with your routes, slippage protection, fee, and partner address.
 
+> **⚠️ Always use `tx.to` from the response** — do NOT hardcode the router address. The `SWITCH_ROUTER` constant is provided for **token approvals only**. The router contract may be redeployed; `tx.to` always points to the current production router.
+
 The `tx` object does not include a `gas` field. Most wallet libraries (ethers.js, web3.py, MetaMask) auto-estimate gas when `gas` is omitted. For multi-hop split swaps, `500,000`–`1,000,000` gas is typically sufficient:
 
 ```js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@switch-win/sdk",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Official integration kit for the Switch DEX Aggregator on PulseChain — types, constants, ABIs, limit orders, and examples",
   "author": "BuildTheTech",
   "license": "MIT",

package/src/constants.ts

@@ -32,8 +32,15 @@ export const CHAIN_ID = 369;
 
 // ── Contract addresses --
 
-/** SwitchRouter contract — target for all swap transactions */
-export const SWITCH_ROUTER = "0xc6d4f096A7a4B3d534DEa725821346Ee1b4FE5CE";
+/**
+ * SwitchRouter contract — approval target for swap transactions.
+ *
+ * **Important:** Do NOT hardcode this address as the `to` field when sending
+ * swap transactions. Always use `tx.to` from the quote response — the router
+ * contract may be redeployed. This constant is safe for **approvals only**
+ * (the new router honours legacy allowances).
+ */
+export const SWITCH_ROUTER = "0x0305fcb5dA680EA6fd1B01A96C1949175B99d406";
 
 /**
  * Native PLS sentinel address.
@@ -47,11 +54,11 @@ export const WPLS = "0xA1077a294dDE1B09bB078844df40758a5D0f9a27";
 // ── Limit Order contract ────────────────────────────────────────────────
 
 /**
- * SwitchLimitOrder contract address on PulseChain.
+ * SwitchLimitOrder contract address on PulseChain (V4).
  *
  * The EIP-712 domain `verifyingContract` MUST match this address.
  */
-export const SWITCH_LIMIT_ORDER = "0x0e884072a891b406C0D814907A1E2310fE5F5Deb";
+export const SWITCH_LIMIT_ORDER = "0x8e3881bdF81Fc0211383B2e576076B654F7aFD86";
 
 /**
  * SwitchPLSFlow contract address on PulseChain.
@@ -135,13 +142,49 @@ export const GO_SWITCH_ABI = [
  * SwitchRouter custom error signatures for decoding reverts.
  */
 export const SWITCH_ROUTER_ERRORS = [
-  "error FinalAmountOutTooLow()",
-  "error ExcessiveFee()",
   "error InsufficientFee()",
-  "error MsgValueMismatch()",
+  "error ExcessiveFee()",
+  "error FinalAmountOutTooLow()",
+  "error EmptySplit()",
+  "error SplitMixedTokenIn()",
+  "error SplitMixedTokenOut()",
   "error ZeroInput()",
+  "error MsgValueMismatch()",
+  "error PathNeedsBeginWithWPLS()",
+  "error PathNeedsEndWithWPLS()",
+  "error AdapterNotApproved(address)",
+  "error EmptyHop()",
+  "error FeeNotSupported()",
 ] as const;
 
+/**
+ * 4-byte error selectors for SwitchRouter reverts.
+ *
+ * Useful for matching raw revert data from `eth_call` or failed transactions.
+ * Key = selector hex, value = human-readable error name.
+ *
+ * @example
+ * ```ts
+ * const selector = revertData.slice(0, 10); // "0x4a2ab023"
+ * const name = SWITCH_ROUTER_ERROR_SELECTORS[selector]; // "FinalAmountOutTooLow"
+ * ```
+ */
+export const SWITCH_ROUTER_ERROR_SELECTORS: Record<string, string> = {
+  "0x025dbdd4": "InsufficientFee",
+  "0x2977da44": "ExcessiveFee",
+  "0x4a2ab023": "FinalAmountOutTooLow",
+  "0x5725cad2": "EmptySplit",
+  "0xdceb8b7a": "SplitMixedTokenIn",
+  "0x45a68c8c": "SplitMixedTokenOut",
+  "0xaf458c07": "ZeroInput",
+  "0xbc6f88c5": "MsgValueMismatch",
+  "0x906478dc": "PathNeedsBeginWithWPLS",
+  "0x037ccaee": "PathNeedsEndWithWPLS",
+  "0x0c48343e": "AdapterNotApproved",
+  "0xb19ef58a": "EmptyHop",
+  "0x73620122": "FeeNotSupported",
+};
+
 // ═══════════════════════════════════════════════════════════════════════════════
 // Limit Order — EIP-712 Constants
 // ═══════════════════════════════════════════════════════════════════════════════
@@ -205,17 +248,40 @@ export const LIMIT_ORDER_ABI = [
  * SwitchLimitOrder custom error signatures for decoding reverts.
  */
 export const LIMIT_ORDER_ERRORS = [
-  "error ExcessiveFee()",
-  "error InsufficientOutput()",
-  "error InvalidAmount()",
   "error InvalidSignature()",
-  "error InvalidTokens()",
   "error NonceAlreadyUsed()",
   "error OrderExpired()",
+  "error InsufficientOutput()",
+  "error InvalidAmount()",
+  "error ExcessiveFee()",
   "error RouteInputExceedsMax()",
+  "error InvalidTokens()",
   "error TransferFailed()",
+  "error OperatorOnly()",
 ] as const;
 
+/**
+ * 4-byte error selectors for SwitchLimitOrder reverts.
+ *
+ * @example
+ * ```ts
+ * const selector = revertData.slice(0, 10); // "0x8baa579f"
+ * const name = LIMIT_ORDER_ERROR_SELECTORS[selector]; // "InvalidSignature"
+ * ```
+ */
+export const LIMIT_ORDER_ERROR_SELECTORS: Record<string, string> = {
+  "0x8baa579f": "InvalidSignature",
+  "0x1fb09b80": "NonceAlreadyUsed",
+  "0xc56873ba": "OrderExpired",
+  "0xbb2875c3": "InsufficientOutput",
+  "0x2c5211c6": "InvalidAmount",
+  "0x2977da44": "ExcessiveFee",
+  "0xb6972a87": "RouteInputExceedsMax",
+  "0x672215de": "InvalidTokens",
+  "0x90b8ec18": "TransferFailed",
+  "0xae5e3e00": "OperatorOnly",
+};
+
 /**
  * Minimal ABI for the SwitchPLSFlow contract.
  *
@@ -237,3 +303,11 @@ export const PLS_FLOW_ERRORS = [
   "error ZeroAmountIn()",
   "error InvalidTokenOut()",
 ] as const;
+
+/**
+ * 4-byte error selectors for SwitchPLSFlow reverts.
+ */
+export const PLS_FLOW_ERROR_SELECTORS: Record<string, string> = {
+  "0x990965c1": "ZeroAmountIn",
+  "0x1b6d1fa0": "InvalidTokenOut",
+};

package/src/index.ts

@@ -69,6 +69,7 @@ export {
   ERC20_ABI,
   GO_SWITCH_ABI,
   SWITCH_ROUTER_ERRORS,
+  SWITCH_ROUTER_ERROR_SELECTORS,
 } from "./constants.js";
 
 // Constants — Limit Orders
@@ -83,8 +84,10 @@ export {
   LIMIT_ORDER_EIP712_TYPES,
   LIMIT_ORDER_ABI,
   LIMIT_ORDER_ERRORS,
+  LIMIT_ORDER_ERROR_SELECTORS,
   PLS_FLOW_ABI,
   PLS_FLOW_ERRORS,
+  PLS_FLOW_ERROR_SELECTORS,
 } from "./constants.js";
 
 // Limit Order helpers