@orbs-network/spot-react 1.1.21 → 1.1.23

package/README.md

@@ -0,0 +1,382 @@
+# @orbs-network/spot-react
+
+React SDK for building TWAP, Limit, Stop-Loss, and Take-Profit order interfaces on top of the [Orbs Spot protocol](https://www.orbs.com/).
+
+## Installation
+
+```bash
+npm install @orbs-network/spot-react
+```
+
+### Peer Dependencies
+
+These must be installed in your application:
+
+```bash
+npm install @tanstack/react-query bignumber.js react-error-boundary zustand react react-dom
+```
+
+| Package                | Version    |
+| ---------------------- | ---------- |
+| `@tanstack/react-query`| `^5.90.12` |
+| `bignumber.js`         | `^9.3.1`   |
+| `react-error-boundary` | `^6.0.0`   |
+| `zustand`              | `^5.0.9`   |
+| `react`                | `^18 \|\| ^19` |
+| `react-dom`            | `^18 \|\| ^19` |
+
+## Quick Start
+
+```tsx
+import {
+  SpotProvider,
+  useSpot,
+  Module,
+  Partners,
+  type WalletInteractions,
+} from "@orbs-network/spot-react";
+
+function App() {
+  return (
+    <SpotProvider
+      chainId={137}                              // Polygon
+      walletInteractions={walletInteractions}    // Wallet interaction handlers
+      account={walletAddress}                    // Connected wallet address
+      partner={Partners.Quick}                   // DEX partner
+      module={Module.TWAP}                       // Order type
+      typedInputAmount={inputAmount}             // User-typed amount (string)
+      priceProtection={0.5}                      // Slippage tolerance %
+      minChunkSizeUsd={5}                        // Min chunk size in USD
+      srcToken={srcToken}                        // { address, symbol, decimals, logoUrl }
+      dstToken={dstToken}
+      srcBalance={srcBalanceWei}                 // Balance in wei (string)
+      dstBalance={dstBalanceWei}
+      srcUsd1Token={srcUsdPrice}                 // USD price of 1 token (string)
+      dstUsd1Token={dstUsdPrice}
+      marketReferencePrice={marketPrice}         // { value?: string, isLoading?: boolean }
+      callbacks={callbacks}                      // Lifecycle event handlers
+      fees={0.25}                                // Fee percentage
+    >
+      <SwapForm />
+    </SpotProvider>
+  );
+}
+```
+
+## WalletInteractions
+
+The host app provides wallet interaction handlers via the `walletInteractions` prop. This keeps spot-react wallet-agnostic — it works with viem, ethers, web3.js, or any wallet library.
+
+```tsx
+const walletInteractions: WalletInteractions = {
+  // Wrap native token (e.g. ETH -> WETH). Wait for receipt, return tx hash.
+  wrapNativeToken: async (amountWei) => { ... },
+
+  // Approve ERC-20 token spending. Wait for receipt, return tx hash.
+  approveToken: async ({ token, amount, spender }) => { ... },
+
+  // Cancel an order on-chain. Wait for receipt, return tx hash.
+  cancelOrder: async ({ order, contractAddress, args }) => { ... },
+
+  // Sign EIP-712 typed data for order creation. Return signature hex.
+  signOrder: async ({ domain, types, primaryType, message, account }) => { ... },
+
+  // Read ERC-20 allowance. Return allowance as string.
+  getAllowance: async ({ tokenAddress, spenderAddress }) => { ... },
+};
+```
+
+Each write method (`wrapNativeToken`, `approveToken`, `cancelOrder`) should wait for tx confirmation and throw if the transaction reverts.
+
+### Example with viem/wagmi
+
+```tsx
+import { erc20Abi } from "viem";
+
+const walletInteractions: WalletInteractions = {
+  wrapNativeToken: async (amountWei) => {
+    const hash = await walletClient.writeContract({
+      abi: [{ name: "deposit", type: "function", stateMutability: "payable", inputs: [], outputs: [] }],
+      functionName: "deposit",
+      address: wTokenAddress,
+      args: [],
+      value: BigInt(amountWei),
+      chain: walletClient.chain,
+      account: walletClient.account!,
+    });
+    await publicClient.waitForTransactionReceipt({ hash, confirmations: 2 });
+    return hash;
+  },
+  approveToken: async ({ token, spender }) => {
+    const maxUint256 = BigInt("0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
+    const hash = await walletClient.writeContract({
+      abi: erc20Abi,
+      functionName: "approve",
+      address: token as `0x${string}`,
+      args: [spender as `0x${string}`, maxUint256],
+      chain: walletClient.chain,
+      account: walletClient.account!,
+    });
+    await publicClient.waitForTransactionReceipt({ hash, confirmations: 2 });
+    return hash;
+  },
+  cancelOrder: async ({ order, contractAddress, args }) => {
+    const hash = await walletClient.writeContract({
+      abi: cancelAbi, // TWAP_ABI for v1, REPERMIT_ABI for v2
+      functionName: "cancel",
+      address: contractAddress as `0x${string}`,
+      args: args as any,
+      chain: walletClient.chain,
+      account: walletClient.account!,
+    });
+    await publicClient.waitForTransactionReceipt({ hash, confirmations: 2 });
+    return hash;
+  },
+  signOrder: async ({ domain, types, primaryType, message, account }) => {
+    return walletClient.signTypedData({ domain, types, primaryType, message, account });
+  },
+  getAllowance: async ({ tokenAddress, spenderAddress }) => {
+    const result = await publicClient.readContract({
+      address: tokenAddress as `0x${string}`,
+      abi: erc20Abi,
+      functionName: "allowance",
+      args: [walletClient.account!.address, spenderAddress as `0x${string}`],
+    });
+    return String(result);
+  },
+};
+```
+
+## SpotProvider Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `partner` | `Partners` | Yes | DEX partner enum |
+| `module` | `Module` | Yes | `TWAP`, `LIMIT`, `STOP_LOSS`, or `TAKE_PROFIT` |
+| `typedInputAmount` | `string` | Yes | User-typed source amount |
+| `priceProtection` | `number` | Yes | Slippage tolerance percentage |
+| `minChunkSizeUsd` | `number` | Yes | Minimum trade chunk size in USD |
+| `marketReferencePrice` | `MarketReferencePrice` | Yes | `{ value?: string, isLoading?: boolean, noLiquidity?: boolean }` |
+| `walletInteractions` | `WalletInteractions` | Yes | Wallet interaction handlers |
+| `chainId` | `number` | No | Connected chain ID |
+| `account` | `string` | No | Connected wallet address |
+| `srcToken` | `Token` | No | `{ address, symbol, decimals, logoUrl }` |
+| `dstToken` | `Token` | No | `{ address, symbol, decimals, logoUrl }` |
+| `srcBalance` | `string` | No | Source balance in wei |
+| `dstBalance` | `string` | No | Destination balance in wei |
+| `srcUsd1Token` | `string` | No | USD price of 1 source token |
+| `dstUsd1Token` | `string` | No | USD price of 1 destination token |
+| `callbacks` | `Callbacks` | No | Lifecycle event handlers |
+| `fees` | `number` | No | Fee percentage (e.g. 0.25) |
+| `isDev` | `boolean` | No | Enable dev mode |
+| `overrides` | `Overrides` | No | Initial state overrides |
+
+## useSpot() Hook
+
+The main hook returns all data and controls for building the UI:
+
+```tsx
+const spot = useSpot();
+```
+
+### Returned panels
+
+| Panel | Description |
+| --- | --- |
+| `spot.dstTokenPanel` | `{ value, isLoading }` — estimated output amount |
+| `spot.tradesAmountPanel` | Total trades input, per-trade amounts, validation |
+| `spot.durationPanel` | Order expiry duration input |
+| `spot.fillDelayPanel` | Trade interval input |
+| `spot.limitPricePanel` | Limit price input with percentage, toggle, reset |
+| `spot.triggerPricePanel` | Trigger price for stop-loss / take-profit |
+| `spot.pricePanel` | Market price display, inversion toggle |
+| `spot.disclaimerPanel` | Disclaimer key string (or `undefined`) |
+| `spot.inputError` | Validation error `{ type, args }` (or `undefined`) |
+| `spot.submitOrderButton` | `{ disabled, loading }` |
+| `spot.orderExecutionPanel` | Full submission lifecycle (see below) |
+| `spot.orderHistoryPanel` | `{ orders: { all: Order[] } }` |
+| `spot.derivedFormData` | Computed values: amounts, prices, deadline, fees |
+| `spot.supportedChains` | Partner's supported chain IDs |
+| `spot.module` | Current `Module` enum |
+
+### Order Execution Panel
+
+```tsx
+const {
+  onSubmit,              // Trigger order creation
+  status,                // SwapStatus: LOADING | SUCCESS | FAILED
+  step,                  // Current step: WRAP | APPROVE | CREATE
+  stepIndex,             // Current step index (0-based)
+  totalSteps,            // Total number of steps
+  parsedError,           // { code, message } on failure
+  onSwapSuccess,         // Call when user acknowledges success
+  confirmButtonLoading,  // Loading state for confirm button
+  srcToken,              // Resolved source token
+  dstToken,              // Resolved destination token
+  wrapTxHash,            // Wrap transaction hash
+  approveTxHash,         // Approve transaction hash
+} = useSpot().orderExecutionPanel;
+```
+
+### Cancel Order
+
+```tsx
+import { useCancelOrder } from "@orbs-network/spot-react";
+
+// Inside a component rendered within SpotProvider:
+const { cancelOrder, isLoading, isSuccess, isError, error, txHash } = useCancelOrder(order);
+
+// Cancel the order
+await cancelOrder();
+
+// Or use getCancelStatus for any order by ID:
+const { getCancelStatus } = useCancelOrder();
+const status = getCancelStatus(orderId); // { status, txHash?, error? } | undefined
+```
+
+## Callbacks
+
+Pass lifecycle callbacks to `SpotProvider` for wallet notifications:
+
+```tsx
+const callbacks: Callbacks = {
+  // Token wrapping
+  onWrapRequest: () => {},
+  onWrapSuccess: ({ txHash, explorerUrl, amount }) => {},
+
+  // Token approval
+  onApproveRequest: () => {},
+  onApproveSuccess: ({ txHash, explorerUrl, token, amount }) => {},
+
+  // Order lifecycle
+  onSignOrderRequest: () => {},
+  onSignOrderSuccess: (signature) => {},
+  onSignOrderError: (error) => {},
+  onOrderCreated: (order) => {},
+  onOrderFilled: (order) => {},
+
+  // Errors
+  onSubmitOrderFailed: ({ code, message }) => {},
+  onSubmitOrderRejected: () => {},
+
+  // Order cancellation
+  onCancelOrderRequest: (order) => {},
+  onCancelOrderSuccess: ({ order, txHash, explorerUrl }) => {},
+  onCancelOrderFailed: (error) => {},
+
+  // Progress (good place to refetch balances)
+  onOrdersProgressUpdate: (orders) => {},
+
+  // Clipboard
+  onCopy: () => {},
+
+  // State change callbacks
+  onLimitPriceChange: (price) => {},
+  onTriggerPriceChange: (price) => {},
+  onDurationChange: (duration) => {},
+  onFillDelayChange: (fillDelay) => {},
+  onChunksChange: (chunks) => {},
+};
+```
+
+## Translations / i18n
+
+The SDK returns string keys for user-facing messages. You should resolve these through your own i18n system.
+
+### Disclaimer keys
+
+`useSpot().disclaimerPanel` returns one of:
+- `"limitOrderDisclaimer"` — shown for limit and TWAP-limit orders
+- `"marketOrderDisclaimer"` — shown for market orders
+- `"triggerMarketPriceDisclaimer"` — shown for stop-loss at market price
+
+### Input error keys
+
+`useSpot().inputError` returns `{ type, args }` where `type` is a key like:
+- `"enterAmount"`, `"insufficientFunds"`, `"emptyLimitPrice"`, `"emptyTriggerPrice"`
+- `"maxChunksError"` (args: `{ maxChunks }`)
+- `"minChunksError"` (args: `{ minChunks }`)
+- `"minTradeSizeError"` (args: `{ minTradeSize }`)
+- `"minDurationError"` / `"maxDurationError"` (args: `{ duration }`)
+- `"minFillDelayError"` / `"maxFillDelayError"` (args: `{ fillDelay }`)
+- `"noLiquidity"`
+
+## Order Types
+
+| Module | Description |
+| --- | --- |
+| `Module.TWAP` | Time-Weighted Average Price — splits order into multiple trades over time |
+| `Module.LIMIT` | Limit order — executes at specified price or better |
+| `Module.STOP_LOSS` | Stop-loss — triggers when price drops to threshold |
+| `Module.TAKE_PROFIT` | Take-profit — triggers when price rises to threshold |
+
+### Panel visibility by module
+
+| Panel | TWAP | LIMIT | STOP_LOSS | TAKE_PROFIT |
+| --- | --- | --- | --- | --- |
+| Trades amount | Yes | — | — | — |
+| Fill delay | Yes | — | — | — |
+| Duration | — | Yes | Yes | Yes |
+| Limit price | Yes | Yes | Yes | Yes |
+| Trigger price | — | — | Yes | Yes |
+
+## Helper Hooks
+
+```tsx
+import {
+  useExplorerLink,  // (txHash?: string) => explorer URL
+  useNetwork,       // () => network info (name, native, wToken, explorer)
+  useAmountUi,      // (amount: string, decimals: number) => formatted amount
+} from "@orbs-network/spot-react";
+```
+
+## Utility Functions
+
+```tsx
+import {
+  getPartners,           // () => all registered partners
+  getPartnerChains,      // (partner) => supported chain IDs
+  getNetwork,            // (chainId) => network config
+  isNativeAddress,       // (address) => boolean
+  eqIgnoreCase,          // (a, b) => case-insensitive address comparison
+  getConfig,             // (partner, chainId) => SpotConfig
+} from "@orbs-network/spot-react";
+```
+
+## Overrides
+
+For initial form state, pass `overrides` to `SpotProvider`:
+
+```tsx
+<SpotProvider
+  overrides={{
+    state: {
+      isMarketOrder: false,
+      chunks: 10,
+      limitPrice: "1.5",
+      triggerPrice: "1.2",
+      fillDelay: { value: 5, unit: TimeUnit.Minutes },
+      duration: { value: 1, unit: TimeUnit.Days },
+    },
+  }}
+  // ...other props
+/>
+```
+
+## Constants
+
+```tsx
+import {
+  SPOT_VERSION,       // SDK version identifier
+  DISCLAIMER_URL,     // Orbs disclaimer page
+  ORBS_TWAP_FAQ_URL,  // TWAP FAQ page
+  ORBS_SLTP_FAQ_URL,  // Stop-Loss/Take-Profit FAQ page
+  ORBS_LOGO,          // Orbs logo URL
+  ORBS_WEBSITE_URL,   // Orbs website
+  networks,           // All supported network configs
+} from "@orbs-network/spot-react";
+```
+
+## License
+
+MIT

package/dist/spot-react/package.json.d.ts

@@ -1,6 +1,6 @@
 declare const _default: {
   "name": "@orbs-network/spot-react",
-  "version": "1.1.21",
+  "version": "1.1.23",
   "description": "Spot React Components - React components for Spot SDK",
   "type": "module",
   "main": "./dist/spot-react.umd.cjs",
@@ -35,7 +35,6 @@ declare const _default: {
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
     "react-error-boundary": "^6.0.0",
-    "viem": "^2.43.3",
     "zustand": "^5.0.9"
   },
   "dependencies": {

package/dist/spot-react/src/hooks/use-cancel-order.d.ts

@@ -1,6 +1,17 @@
+import { SwapStatus } from '../types';
 import { Order } from '../../../spot-ui/src/index.ts';
-export declare const useCancelOrderRefetchUntilStatusSynced: () => import('@tanstack/react-query').UseMutationResult<void, Error, string[], unknown>;
-export declare const useCancelOrderMutation: () => import('@tanstack/react-query').UseMutationResult<(string | undefined)[] | undefined, Error, {
-    orders: Order[];
-}, unknown>;
+export declare const useCancelOrderRefetchUntilStatusSynced: () => import('@tanstack/react-query').UseMutationResult<void, Error, string, unknown>;
+export type CancelOrderStatus = {
+    status: SwapStatus;
+    txHash?: string;
+    error?: string;
+};
+export declare const useCancelOrder: (order?: Order) => {
+    isLoading: boolean;
+    isSuccess: boolean;
+    isError: boolean;
+    error: string | undefined;
+    txHash: string | undefined;
+    cancelOrder: () => Promise<`0x${string}` | undefined>;
+};
 //# sourceMappingURL=use-cancel-order.d.ts.map

package/dist/spot-react/src/hooks/use-cancel-order.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-cancel-order.d.ts","sourceRoot":"","sources":["../../../../src/hooks/use-cancel-order.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,EAIN,MAAM,uBAAuB,CAAC;AAU/B,eAAO,MAAM,sCAAsC,yFA0BlD,CAAC;AAEF,eAAO,MAAM,sBAAsB;YAgEU,KAAK,EAAE;WA+CnD,CAAC"}
+{"version":3,"file":"use-cancel-order.d.ts","sourceRoot":"","sources":["../../../../src/hooks/use-cancel-order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAa,KAAK,EAAe,MAAM,uBAAuB,CAAC;AAUtE,eAAO,MAAM,sCAAsC,uFAwBlD,CAAC;AAuBF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,QAAQ,KAAK;;;;;;;CAqF3C,CAAC"}

package/dist/spot-react/src/hooks/use-spot.d.ts

@@ -12,8 +12,7 @@ import { useSubmitOrderButton, useSubmitOrderPanel } from './use-submit-order-pa
 import { useFormData } from './use-form-data';
 import { useOrderHistoryPanel } from './order-hooks';
 import { usePartnerChains } from './use-partner-chains';
-import { useCancelOrderMutation, useCancelOrderRefetchUntilStatusSynced } from './use-cancel-order';
-import { useSignOrder, useSubmitOrderMutation } from './use-submit-order';
+import { useCancelOrderRefetchUntilStatusSynced } from './use-cancel-order';
 import { Module } from '../../../spot-ui/src/index.ts';
 type SpotData = {
     tradesAmountPanel: ReturnType<typeof useTradesPanel>;
@@ -31,12 +30,7 @@ type SpotData = {
     derivedFormData: ReturnType<typeof useFormData>;
     supportedChains: ReturnType<typeof usePartnerChains>;
     module: Module;
-    mutations: {
-        cancelOrder: ReturnType<typeof useCancelOrderMutation>;
-        signOrder: ReturnType<typeof useSignOrder>;
-        submitOrder: ReturnType<typeof useSubmitOrderMutation>;
-        refetchUntilStatusSynced: ReturnType<typeof useCancelOrderRefetchUntilStatusSynced>;
-    };
+    refetchUntilStatusSynced: ReturnType<typeof useCancelOrderRefetchUntilStatusSynced>;
 };
 export declare const SpotDataProvider: ({ children, }: {
     children: React.ReactNode;

package/dist/spot-react/src/hooks/use-spot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-spot.d.ts","sourceRoot":"","sources":["../../../../src/hooks/use-spot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,sCAAsC,EACvC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,KAAK,QAAQ,GAAG;IACd,iBAAiB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IACrD,aAAa,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACnD,cAAc,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IACrD,eAAe,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IACvD,iBAAiB,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC3D,UAAU,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IAC7C,aAAa,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACnD,eAAe,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IAClD,UAAU,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAC9C,iBAAiB,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC3D,iBAAiB,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC3D,mBAAmB,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;IAC5D,eAAe,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IAChD,eAAe,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE;QACT,WAAW,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;QACvD,SAAS,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;QAC3C,WAAW,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;QACvD,wBAAwB,EAAE,UAAU,CAClC,OAAO,sCAAsC,CAC9C,CAAC;KACH,CAAC;CACH,CAAC;AAIF,eAAO,MAAM,gBAAgB,GAAI,eAE9B;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,4CAsDA,CAAC;AAEF,eAAO,MAAM,OAAO,gBAMnB,CAAC"}
+{"version":3,"file":"use-spot.d.ts","sourceRoot":"","sources":["../../../../src/hooks/use-spot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACL,sCAAsC,EACvC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,KAAK,QAAQ,GAAG;IACd,iBAAiB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IACrD,aAAa,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACnD,cAAc,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IACrD,eAAe,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IACvD,iBAAiB,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC3D,UAAU,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IAC7C,aAAa,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACnD,eAAe,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IAClD,UAAU,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAC9C,iBAAiB,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC3D,iBAAiB,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC3D,mBAAmB,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;IAC5D,eAAe,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IAChD,eAAe,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB,EAAE,UAAU,CAClC,OAAO,sCAAsC,CAC9C,CAAC;CACH,CAAC;AAIF,eAAO,MAAM,gBAAgB,GAAI,eAE9B;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,4CA0CA,CAAC;AAEF,eAAO,MAAM,OAAO,gBAMnB,CAAC"}

package/dist/spot-react/src/hooks/use-submit-order-panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-submit-order-panel.d.ts","sourceRoot":"","sources":["../../../../src/hooks/use-submit-order-panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAStC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;CAkC/B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;CAsChC,CAAC"}
+{"version":3,"file":"use-submit-order-panel.d.ts","sourceRoot":"","sources":["../../../../src/hooks/use-submit-order-panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAStC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;CAmC/B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;CAsChC,CAAC"}

package/dist/spot-react/src/hooks/use-submit-order.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-submit-order.d.ts","sourceRoot":"","sources":["../../../../src/hooks/use-submit-order.ts"],"names":[],"mappings":"AAqGA,eAAO,MAAM,YAAY,sHAmDxB,CAAC;AAyLF,eAAO,MAAM,sBAAsB,sHA8GlC,CAAC"}
+{"version":3,"file":"use-submit-order.d.ts","sourceRoot":"","sources":["../../../../src/hooks/use-submit-order.ts"],"names":[],"mappings":"AAwFA,eAAO,MAAM,YAAY,sHAmDxB,CAAC;AAiKF,eAAO,MAAM,sBAAsB,sHA+GlC,CAAC"}

package/dist/spot-react/src/index.d.ts

@@ -1,10 +1,13 @@
 import { SpotProvider } from './spot-context';
 import { useDerivedHistoryOrder } from './hooks/use-history-order';
 import { useSpot } from './hooks/use-spot';
+import { useCancelOrder } from './hooks/use-cancel-order';
+import { useSignOrder, useSubmitOrderMutation } from './hooks/use-submit-order';
 export * from './types';
 export * from './utils';
 export { useAmountUi, useExplorerLink, useNetwork } from './hooks/helper-hooks';
 export { useSwapExecution } from './hooks/use-swap-execution';
-export { type Config, type SpotConfig, type TimeDuration, type PartnerPayloadItem, type RePermitOrder, type Signature, type Address, type Hex, type InputError, Module, OrderStatus, OrderFilter, OrderType, TimeUnit, Partners, InputErrors, getConfig, getPartners, getMinChunkSizeUsd, buildRePermitOrderData, submitOrder, getNetwork, getPartnerChains, isNativeAddress, eqIgnoreCase, getOrderExecutionRate, getOrderLimitPriceRate, getOrderFillDelayMillis, getTriggerPriceRate, SPOT_VERSION, DISCLAIMER_URL, ORBS_TWAP_FAQ_URL, ORBS_SLTP_FAQ_URL, ORBS_LOGO, ORBS_WEBSITE_URL, networks, IWETH_ABI, ERC20_ABI, REPERMIT_ABI, TWAP_ABI, } from '../../spot-ui/src/index.ts';
-export { SpotProvider, useSpot, useDerivedHistoryOrder, };
+export { type CancelOrderStatus } from './hooks/use-cancel-order';
+export { type Config, type SpotConfig, type TimeDuration, type PartnerPayloadItem, type RePermitOrder, type Signature, type Address, type Hex, type InputError, Module, OrderStatus, OrderFilter, OrderType, TimeUnit, Partners, InputErrors, getConfig, getPartners, getMinChunkSizeUsd, buildRePermitOrderData, submitOrder, getNetwork, getPartnerChains, isNativeAddress, eqIgnoreCase, getOrderExecutionRate, getOrderLimitPriceRate, getOrderFillDelayMillis, getTriggerPriceRate, SPOT_VERSION, DISCLAIMER_URL, ORBS_TWAP_FAQ_URL, ORBS_SLTP_FAQ_URL, ORBS_LOGO, ORBS_WEBSITE_URL, networks, } from '../../spot-ui/src/index.ts';
+export { SpotProvider, useSpot, useDerivedHistoryOrder, useCancelOrder, useSignOrder, useSubmitOrderMutation as useSubmitOrder };
 //# sourceMappingURL=index.d.ts.map

package/dist/spot-react/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAO9D,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,GAAG,EACR,KAAK,UAAU,EAGf,MAAM,EACN,WAAW,EACX,WAAW,EACX,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,WAAW,EAGX,SAAS,EACT,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EAGnB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,QAAQ,EAGR,SAAS,EACT,SAAS,EACT,YAAY,EACZ,QAAQ,GAGT,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,YAAY,EACZ,OAAO,EACP,sBAAsB,GACvB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAChF,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAOlE,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,GAAG,EACR,KAAK,UAAU,EAGf,MAAM,EACN,WAAW,EACX,WAAW,EACX,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,WAAW,EAGX,SAAS,EACT,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EAGnB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,QAAQ,GAGT,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,YAAY,EACZ,OAAO,EACP,sBAAsB,EACtB,cAAc,EACd,YAAY,EACZ,sBAAsB,IAAI,cAAc,EACzC,CAAC"}

package/dist/spot-react/src/spot-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spot-context.d.ts","sourceRoot":"","sources":["../../../src/spot-context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwD,MAAM,OAAO,CAAC;AAU7E,OAAO,EACL,SAAS,EACT,eAAe,EAGhB,MAAM,SAAS,CAAC;AAiEjB,eAAO,MAAM,WAAW,uCAA8C,CAAC;AA2LvE,eAAO,MAAM,YAAY,GAAI,OAAO,SAAS,4CAM5C,CAAC;AAEF,eAAO,MAAM,cAAc,uBAM1B,CAAC"}
+{"version":3,"file":"spot-context.d.ts","sourceRoot":"","sources":["../../../src/spot-context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwD,MAAM,OAAO,CAAC;AAU7E,OAAO,EACL,SAAS,EACT,eAAe,EAEhB,MAAM,SAAS,CAAC;AAoCjB,eAAO,MAAM,WAAW,uCAA8C,CAAC;AAqLvE,eAAO,MAAM,YAAY,GAAI,OAAO,SAAS,4CAM5C,CAAC;AAEF,eAAO,MAAM,cAAc,uBAM1B,CAAC"}

package/dist/spot-react/src/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE/C,UAAU,SAAS;IACjB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC7C,yBAAyB,EAAE,MAAM,IAAI,CAAC;IACtC,0BAA0B,EAAE,CAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,KAC1B,IAAI,CAAC;IACV,KAAK,EAAE,KAAK,CAAC;CACd;AAUD,eAAO,MAAM,YAAY,wEA+BtB,CAAC"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE/C,UAAU,SAAS;IACjB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC7C,yBAAyB,EAAE,MAAM,IAAI,CAAC;IACtC,0BAA0B,EAAE,CAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,KAC1B,IAAI,CAAC;IACV,KAAK,EAAE,KAAK,CAAC;CACd;AAWD,eAAO,MAAM,YAAY,wEA+BtB,CAAC"}

package/dist/spot-react/src/types.d.ts

@@ -1,5 +1,4 @@
 import { Partners, Module, Order, SpotConfig, TimeDuration } from '../../spot-ui/src/index.ts';
-import { createPublicClient, createWalletClient, Abi } from 'viem';
 export declare enum SwapStatus {
     LOADING = 1,
     SUCCESS = 2,
@@ -7,29 +6,29 @@ export declare enum SwapStatus {
 }
 export type { Order } from '../../spot-ui/src/index.ts';
 export { OrderStatus, type OrderFill, OrderType, Module } from '../../spot-ui/src/index.ts';
-export interface Provider {
-    request(...args: any): Promise<any>;
-    [key: string]: any;
-}
-export type PublicClient = ReturnType<typeof createPublicClient>;
-export type WalletClient = ReturnType<typeof createWalletClient>;
-export type ApproveProps = {
-    tokenAddress: string;
-    amount: bigint;
-    spenderAddress: string;
-};
-export type CreateOrderProps = {
-    contractAddress: string;
-    abi: Abi;
-    functionName: string;
-    args: [string[]];
+export type SignOrderProps = {
+    domain: Record<string, unknown>;
+    types: Record<string, unknown[]>;
+    primaryType: string;
+    message: Record<string, unknown>;
+    account: `0x${string}`;
 };
 export type CancelOrderProps = {
+    order: Order;
     contractAddress: string;
-    abi: Abi;
-    functionName: string;
-    args: number[];
-    orderId: number;
+    args: string[] | string[][];
+};
+export type ApproveTokenProps = {
+    tokenAddress: string;
+    amount: string;
+    spenderAddress: string;
+};
+export type WalletInteractions = {
+    cancelOrder: (props: CancelOrderProps) => Promise<`0x${string}`>;
+    signOrder: (props: SignOrderProps) => Promise<`0x${string}`>;
+    wrapNativeToken: (amount: string) => Promise<`0x${string}`>;
+    approveToken: (props: ApproveTokenProps) => Promise<`0x${string}`>;
+    getAllowance: (props: GetAllowanceProps) => Promise<string>;
 };
 export type GetAllowanceProps = {
     tokenAddress: string;
@@ -51,10 +50,6 @@ export declare enum Disclaimer {
     LIMIT_PRICE = "limitOrderDisclaimer"
 }
 export type Overrides = {
-    wrap?: (amountWei: string) => Promise<`0x${string}`>;
-    approveOrder?: (props: ApproveProps) => Promise<`0x${string}`>;
-    createOrder?: (props: CreateOrderProps) => Promise<`0x${string}`>;
-    getAllowance?: (props: GetAllowanceProps) => Promise<string>;
     state?: Partial<InitialState>;
 };
 export type OnApproveSuccessCallback = {
@@ -69,8 +64,8 @@ export type OnWrapSuccessCallback = {
     amount: string;
 };
 export type OnCancelOrderSuccess = {
-    orders: Order[];
-    txHash: string;
+    order: Order;
+    txHash: `0x${string}`;
     explorerUrl: string;
 };
 export type ParsedError = {
@@ -78,7 +73,7 @@ export type ParsedError = {
     code: number;
 };
 export type Callbacks = {
-    onCancelOrderRequest?: (orders: Order[]) => void;
+    onCancelOrderRequest?: (order: Order) => void;
     onCancelOrderSuccess?: (props: OnCancelOrderSuccess) => void;
     onCancelOrderFailed?: (error: Error) => void;
     onOrdersProgressUpdate?: (orders: Order[]) => void;
@@ -109,7 +104,7 @@ export type MarketReferencePrice = {
 };
 export interface SpotProps {
     children?: React.ReactNode;
-    provider?: Provider;
+    walletInteractions: WalletInteractions;
     chainId?: number;
     account?: string;
     enableQueryParams?: boolean;
@@ -131,8 +126,7 @@ export interface SpotProps {
     isDev?: boolean;
 }
 export interface SpotContextType {
-    walletClient?: ReturnType<typeof createWalletClient>;
-    publicClient?: PublicClient;
+    walletInteractions?: WalletInteractions;
     marketPrice?: string;
     marketPriceLoading?: boolean;
     account?: `0x${string}`;
@@ -196,10 +190,11 @@ export interface State {
     limitPricePercent?: string | null;
     isMarketOrder?: boolean;
     currentTime: number;
-    cancelOrderStatus?: SwapStatus;
-    cancelOrderTxHash?: string;
-    cancelOrderError?: string;
-    cancelOrderId?: number;
+    cancelOrders: Record<string, {
+        status: SwapStatus;
+        txHash?: string;
+        error?: string;
+    }>;
     swapExecutions: SwapExecution[];
     swapExecutionIndex: number;
 }