@clober/v2-sdk 0.0.4 → 0.0.5-0.a.dev

package/dist/esm/call.js

@@ -1,24 +1,25 @@
-import { encodeAbiParameters, isAddressEqual, parseUnits, zeroAddress, zeroHash, } from 'viem';
+import { formatUnits, isAddressEqual, parseUnits, zeroAddress, zeroHash, } from 'viem';
 import { CHAIN_MAP } from './constants/chain';
-import { calculateUnit } from './utils/unit';
+import { calculateUnitSize } from './utils/unit-size';
 import { CONTROLLER_ABI } from './abis/core/controller-abi';
 import { getDeadlineTimestampInSeconds } from './utils/time';
 import { buildTransaction } from './utils/build-transaction';
 import { CONTRACT_ADDRESSES } from './constants/addresses';
 import { MAKER_DEFAULT_POLICY, TAKER_DEFAULT_POLICY } from './constants/fee';
 import { fetchMarket } from './apis/market';
-import { parsePrice } from './utils/prices';
-import { fromPrice, invertPrice } from './utils/tick';
-import { getExpectedOutput, getOpenOrders } from './view';
+import { formatPrice, parsePrice } from './utils/prices';
+import { fromPrice, invertPrice, toPrice } from './utils/tick';
+import { getExpectedInput, getExpectedOutput } from './view';
 import { toBookId } from './utils/book-id';
-import { MAKE_ORDER_PARAMS_ABI, TAKE_ORDER_PARAMS_ABI, } from './abis/core/params-abi';
-import { Action } from './constants/action';
 import { fetchIsApprovedForAll } from './utils/approval';
 import { decorator } from './utils/decorator';
+import { fetchOrders } from './utils/order';
+import { applyPercent } from './utils/bigint';
 /**
  * Build a transaction to open a market.
  *
  * @param chainId The chain ID of the blockchain.
+ * @param userAddress The address of the user.
  * @param inputToken The address of the input token.
  * @param outputToken The address of the output token.
  * @param options
@@ -27,38 +28,42 @@ import { decorator } from './utils/decorator';
  * @example
  * import { openMarket } from '@clober/v2-sdk'
  *
- * const transaction = await openMarket(
- *   421614,
- *  '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
- *  '0x0000000000000000000000000000000000000000'
- * )
+ * const transaction = await openMarket({
+ *   chainId: 421614,
+ *   userAddress: '0xF8c1869Ecd4df136693C45EcE1b67f85B6bDaE69',
+ *   inputToken: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
+ *   outputToken: '0x0000000000000000000000000000000000000000'
+ * })
  */
-export const openMarket = decorator(async ({ chainId, inputToken, outputToken, }) => {
+export const openMarket = decorator(async ({ chainId, userAddress, inputToken, outputToken, options, }) => {
     const market = await fetchMarket(chainId, [inputToken, outputToken]);
     const isBid = isAddressEqual(market.quote.address, inputToken);
-    if ((isBid && !market.bidBookOpen) || (!isBid && !market.askBookOpen)) {
-        const unit = await calculateUnit(chainId, isBid ? market.quote : market.base);
+    if ((isBid && !market.bidBook.isOpened) ||
+        (!isBid && !market.askBook.isOpened)) {
+        const unitSize = await calculateUnitSize(chainId, isBid ? market.quote : market.base);
         return buildTransaction(chainId, {
+            chain: CHAIN_MAP[chainId],
             address: CONTRACT_ADDRESSES[chainId].Controller,
+            account: userAddress,
             abi: CONTROLLER_ABI,
             functionName: 'open',
             args: [
                 [
                     {
                         key: {
-                            base: inputToken,
-                            unit,
-                            quote: outputToken,
-                            makerPolicy: MAKER_DEFAULT_POLICY.value,
+                            base: outputToken,
+                            unitSize,
+                            quote: inputToken,
+                            makerPolicy: MAKER_DEFAULT_POLICY[chainId].value,
                             hooks: zeroAddress,
-                            takerPolicy: TAKER_DEFAULT_POLICY.value,
+                            takerPolicy: TAKER_DEFAULT_POLICY[chainId].value,
                         },
                         hookData: zeroHash,
                     },
                 ],
                 getDeadlineTimestampInSeconds(),
             ],
-        });
+        }, options?.gasLimit);
     }
     return undefined;
 });
@@ -72,63 +77,78 @@ export const openMarket = decorator(async ({ chainId, inputToken, outputToken, }
  * @param {string} amount The amount of input tokens for the order.
  * @param {string} price The price at which the order should be executed.
  * @param {Object} [options] Optional parameters for the limit order.
- * @param {PermitSignature} [options.signature] The permit signature for token approval.
+ * @param {erc20PermitParam} [options.erc20PermitParam] The permit signature for token approval.
  * @param {boolean} [options.postOnly] A boolean indicating whether the order is only to be made not taken.
  * @param {string} [options.rpcUrl] The RPC URL of the blockchain.
- * @returns {Promise<Transaction>} Promise resolving to the transaction object representing the limit order.
+ * @param {number} [options.gasLimit] The gas limit to use for the transaction.
+ * @param {bigint} [options.makeTick] The tick for the make order.
+ * @param {bigint} [options.takeLimitTick] The tick for the take order.
+ * @param {boolean} [options.useSubgraph] A boolean indicating whether to use the subgraph for fetching orders.
+ * @returns {Promise<{ transaction: Transaction, result: { make: CurrencyFlow, take: CurrencyFlow, spent: CurrencyFlow }>}
+ * Promise resolving to the transaction object representing the limit order with the result of the order.
  * @example
  * import { signERC20Permit, limitOrder } from '@clober/v2-sdk'
  * import { privateKeyToAccount } from 'viem/accounts'
  *
- * const signature = await signERC20Permit(
- *   421614,
- *   privateKeyToAccount('0x...'),
- *   '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
- *   '100.123'
- * )
+ * const erc20PermitParam = await signERC20Permit({
+ *   chainId: 421614,
+ *   walletClient,
+ *   token: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
+ *   amount: '100.123'
+ * })
  *
- * const transaction = await limitOrder(
- *   421614,
- *  '0xF8c1869Ecd4df136693C45EcE1b67f85B6bDaE69
- *  '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
- *  '0x0000000000000000000000000000000000000000',
- *  '100.123', // 100.123 USDC
- *  '4000.01', // price at 4000.01 (ETH/USDC)
- *  { signature }
- * )
+ * const { transaction } = await limitOrder({
+ *   chainId: 421614,
+ *   userAddress: '0xF8c1869Ecd4df136693C45EcE1b67f85B6bDaE69
+ *   inputToken: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
+ *   outputToken: '0x0000000000000000000000000000000000000000',
+ *   amount: '100.123', // 100.123 USDC
+ *   price: '4000.01', // price at 4000.01 (ETH/USDC)
+ *   options: { erc20PermitParam }
+ * })
  *
  * @example
  * import { limitOrder } from '@clober/v2-sdk'
  *
- * const transaction = await limitOrder(
- *   421614,
- *  '0xF8c1869Ecd4df136693C45EcE1b67f85B6bDaE69
- *  '0x0000000000000000000000000000000000000000',
- *  '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
- *  '0.13', // 0.13 ETH
- *  '4000.01', // price at 4000.01 (ETH/USDC)
- * )
+ * const { transaction } = await limitOrder({
+ *   chainId: 421614,
+ *   userAddress: '0xF8c1869Ecd4df136693C45EcE1b67f85B6bDaE69
+ *   inputToken: '0x0000000000000000000000000000000000000000',
+ *   outputToken: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
+ *   amount: '0.13', // 0.13 ETH
+ *   price: '4000.01', // price at 4000.01 (ETH/USDC)
+ * })
  */
 export const limitOrder = decorator(async ({ chainId, userAddress, inputToken, outputToken, amount, price, options, }) => {
+    const [roundingUpMakeBid, roundingDownMakeAsk, roundingDownTakenBid, roundingUpTakenAsk,] = [
+        options?.roundingUpMakeBid ? options.roundingUpMakeBid : false,
+        options?.roundingDownMakeAsk ? options.roundingDownMakeAsk : false,
+        options?.roundingDownTakenBid ? options.roundingDownTakenBid : false,
+        options?.roundingUpTakenAsk ? options.roundingUpTakenAsk : false,
+    ];
     const market = await fetchMarket(chainId, [inputToken, outputToken]);
     const isBid = isAddressEqual(market.quote.address, inputToken);
-    if ((isBid && !market.bidBookOpen) || (!isBid && !market.askBookOpen)) {
+    const [inputCurrency, outputCurrency] = isBid
+        ? [market.quote, market.base]
+        : [market.base, market.quote];
+    if ((isBid && !market.bidBook.isOpened) ||
+        (!isBid && !market.askBook.isOpened)) {
         throw new Error(`
+       Open the market before placing a limit order.
        import { openMarket } from '@clober/v2-sdk'
 
-       const transaction = await openMarket(
-            ${chainId},
-           '${inputToken}',
-           '${outputToken}',
-       )
+       const transaction = await openMarket({
+            chainId: ${chainId},
+            inputToken: '${inputToken}',
+            outputToken: '${outputToken}',
+       })
     `);
     }
-    const rawPrice = parsePrice(Number(price), market.quote.decimals, market.base.decimals);
-    const tick = isBid ? fromPrice(rawPrice) : fromPrice(invertPrice(rawPrice));
+    const { roundingDownPrice, roundingUpPrice } = parsePrice(Number(price), market.quote.decimals, market.base.decimals);
     const tokensToSettle = [inputToken, outputToken].filter((address) => !isAddressEqual(address, zeroAddress));
-    const quoteAmount = parseUnits(amount, isBid ? market.quote.decimals : market.base.decimals);
-    const [unit, { result }] = await Promise.all([
-        calculateUnit(chainId, isBid ? market.quote : market.base),
+    const quoteAmount = parseUnits(amount, inputCurrency.decimals);
+    const [unitSize, { takenAmount, spentAmount, bookId, events }] = await Promise.all([
+        calculateUnitSize(chainId, inputCurrency),
         getExpectedOutput({
             chainId,
             inputToken,
@@ -136,162 +156,184 @@ export const limitOrder = decorator(async ({ chainId, userAddress, inputToken, o
             amountIn: amount,
             options: {
                 ...options,
+                limitPrice: price,
             },
         }),
     ]);
     const isETH = isAddressEqual(inputToken, zeroAddress);
-    const permitParamsList = options?.signature && !isETH
-        ? [
-            {
-                token: inputToken,
-                permitAmount: quoteAmount,
-                signature: options.signature,
-            },
-        ]
-        : [];
     const makeParam = {
-        id: toBookId(inputToken, outputToken, unit),
-        tick: Number(tick),
+        id: toBookId(chainId, inputToken, outputToken, unitSize),
+        tick: options?.makeTick
+            ? Number(options.makeTick)
+            : Number(isBid
+                ? fromPrice(roundingUpMakeBid ? roundingUpPrice : roundingDownPrice)
+                : fromPrice(invertPrice(roundingDownMakeAsk ? roundingDownPrice : roundingUpPrice))),
         quoteAmount,
         hookData: zeroHash,
     };
-    if (options?.postOnly === true || result.length === 0) {
-        return buildTransaction(chainId, {
-            chain: CHAIN_MAP[chainId],
-            account: userAddress,
-            address: CONTRACT_ADDRESSES[chainId].Controller,
-            abi: CONTROLLER_ABI,
-            functionName: 'make',
-            args: [
-                [makeParam],
-                tokensToSettle,
-                permitParamsList,
-                getDeadlineTimestampInSeconds(),
-            ],
-            value: isETH ? quoteAmount : 0n,
-        });
-    }
-    else if (result.length === 1) {
-        // take and make
-        return buildTransaction(chainId, {
-            chain: CHAIN_MAP[chainId],
-            account: userAddress,
-            address: CONTRACT_ADDRESSES[chainId].Controller,
-            abi: CONTROLLER_ABI,
-            functionName: 'limit',
-            args: [
-                [
-                    {
-                        takeBookId: result[0].bookId,
-                        makeBookId: makeParam.id,
-                        limitPrice: rawPrice,
-                        tick: makeParam.tick,
-                        quoteAmount,
-                        takeHookData: zeroHash,
-                        makeHookData: makeParam.hookData,
-                    },
+    if (options?.postOnly === true || spentAmount === '0') {
+        return {
+            transaction: await buildTransaction(chainId, {
+                chain: CHAIN_MAP[chainId],
+                account: userAddress,
+                address: CONTRACT_ADDRESSES[chainId].Controller,
+                abi: CONTROLLER_ABI,
+                functionName: 'make',
+                args: [
+                    [makeParam],
+                    tokensToSettle,
+                    options?.erc20PermitParam ? [options.erc20PermitParam] : [],
+                    getDeadlineTimestampInSeconds(),
                 ],
-                tokensToSettle,
-                permitParamsList,
-                getDeadlineTimestampInSeconds(),
-            ],
-            value: isETH ? quoteAmount : 0n,
-        });
+                value: isETH ? quoteAmount : 0n,
+            }, options?.gasLimit),
+            result: {
+                make: {
+                    amount: formatUnits(quoteAmount, inputCurrency.decimals),
+                    currency: inputCurrency,
+                    direction: 'in',
+                    price: formatPrice(isBid
+                        ? toPrice(BigInt(makeParam.tick))
+                        : invertPrice(toPrice(BigInt(makeParam.tick))), market.quote.decimals, market.base.decimals),
+                },
+                spent: {
+                    amount: '0',
+                    currency: inputCurrency,
+                    direction: 'in',
+                    events: [],
+                },
+                taken: {
+                    amount: '0',
+                    currency: outputCurrency,
+                    direction: 'out',
+                    events: [],
+                },
+            },
+        };
     }
     else {
-        // take x n and make
-        const makeAmount = quoteAmount -
-            result.reduce((acc, { spendAmount }) => acc + spendAmount, 0n);
-        return buildTransaction(chainId, {
-            chain: CHAIN_MAP[chainId],
-            account: userAddress,
-            address: CONTRACT_ADDRESSES[chainId].Controller,
-            abi: CONTROLLER_ABI,
-            functionName: 'execute',
-            args: [
-                [
-                    ...result.map(() => Action.TAKE),
-                    ...(makeAmount > 0n ? [Action.MAKE] : []),
-                ],
-                [
-                    ...result.map(({ bookId, takenAmount }) => encodeAbiParameters(TAKE_ORDER_PARAMS_ABI, [
+        // take and make
+        return {
+            transaction: await buildTransaction(chainId, {
+                chain: CHAIN_MAP[chainId],
+                account: userAddress,
+                address: CONTRACT_ADDRESSES[chainId].Controller,
+                abi: CONTROLLER_ABI,
+                functionName: 'limit',
+                args: [
+                    [
                         {
-                            id: bookId,
-                            limitPrice: rawPrice,
-                            quoteAmount: takenAmount,
-                            hookData: zeroHash,
+                            takeBookId: bookId,
+                            makeBookId: makeParam.id,
+                            limitPrice: options?.takeLimitTick
+                                ? toPrice(options.takeLimitTick)
+                                : isBid
+                                    ? invertPrice(roundingUpTakenAsk
+                                        ? roundingUpPrice
+                                        : roundingDownPrice)
+                                    : roundingDownTakenBid
+                                        ? roundingDownPrice
+                                        : roundingUpPrice,
+                            tick: makeParam.tick,
+                            quoteAmount,
+                            takeHookData: zeroHash,
+                            makeHookData: makeParam.hookData,
                         },
-                    ])),
-                    ...(makeAmount > 0n
-                        ? [
-                            encodeAbiParameters(MAKE_ORDER_PARAMS_ABI, [
-                                {
-                                    ...makeParam,
-                                    quoteAmount: makeAmount,
-                                },
-                            ]),
-                        ]
-                        : []),
+                    ],
+                    tokensToSettle,
+                    options?.erc20PermitParam ? [options.erc20PermitParam] : [],
+                    getDeadlineTimestampInSeconds(),
                 ],
-                tokensToSettle,
-                permitParamsList,
-                [],
-                getDeadlineTimestampInSeconds(),
-            ],
-            value: isETH ? quoteAmount : 0n,
-        });
+                value: isETH ? quoteAmount : 0n,
+            }, options?.gasLimit),
+            result: {
+                make: {
+                    amount: formatUnits(quoteAmount - parseUnits(spentAmount, inputCurrency.decimals), inputCurrency.decimals),
+                    currency: inputCurrency,
+                    direction: 'in',
+                    price: formatPrice(isBid
+                        ? toPrice(BigInt(makeParam.tick))
+                        : invertPrice(toPrice(BigInt(makeParam.tick))), market.quote.decimals, market.base.decimals),
+                },
+                spent: {
+                    amount: spentAmount,
+                    currency: inputCurrency,
+                    direction: 'in',
+                    events: events.map(({ price, spentAmount }) => ({
+                        price,
+                        amount: spentAmount,
+                    })),
+                },
+                taken: {
+                    amount: takenAmount,
+                    currency: outputCurrency,
+                    direction: 'out',
+                    events: events.map(({ price, takenAmount }) => ({
+                        price,
+                        amount: takenAmount,
+                    })),
+                },
+            },
+        };
     }
 });
 /**
  * Executes a market order on the specified chain for trading tokens.
+ * If only `amountIn` is provided, spend the specified amount of input tokens.
+ * If only `amountOut` is provided, take the specified amount of output tokens.
  *
  * @param {CHAIN_IDS} chainId The chain ID.
  * @param {`0x${string}`} userAddress The Ethereum address of the user placing the order.
  * @param {`0x${string}`} inputToken The address of the token to be used as input.
  * @param {`0x${string}`} outputToken The address of the token to be received as output.
- * @param {string} amount The amount of input tokens for the order.
- * @param {Object} [options] Optional parameters for the limit order.
- * @param {PermitSignature} [options.signature] The permit signature for token approval.
+ * @param {string} amountIn The amount of input tokens for the order to spend.
+ * @param {string} amountOut The amount of output tokens for the order to take.
+ * @param {Object} [options] Optional parameters for the market order.
+ * @param {erc20PermitParam} [options.erc20PermitParam] The permit signature for token approval.
  * @param {string} [options.rpcUrl] The RPC URL of the blockchain.
- * @param {string} [options.limitPrice] The upper bound price to tolerate for the market bid, or the lower bound price to tolerate for the market ask.
- * if the limit price is not provided, unlimited slippage is allowed.
- * @returns {Promise<Transaction>} Promise resolving to the transaction object representing the limit order.
+ * @param {number} [options.gasLimit] The gas limit to use for the transaction.
+ * @param {boolean} [options.useSubgraph] A boolean indicating whether to use the subgraph for fetching orders.
+ * @param {number} [options.slippage] The maximum slippage percentage allowed for the order.
+ * if the slippage is not provided, unlimited slippage is allowed.
+ * @returns {Promise<{ transaction: Transaction, result: { spent: CurrencyFlow, taken: CurrencyFlow } }>}
+ * Promise resolving to the transaction object representing the market order with the result of the order.
  * @example
  * import { signERC20Permit, marketOrder } from '@clober/v2-sdk'
  * import { privateKeyToAccount } from 'viem/accounts'
  *
- * const signature = await signERC20Permit(
- *   421614,
- *   privateKeyToAccount('0x...'),
- *   '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
- *   '100.123'
- * )
- *
- * const transaction = await marketOrder(
- *   421614,
- *  '0xF8c1869Ecd4df136693C45EcE1b67f85B6bDaE69
- *  '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
- *  '0x0000000000000000000000000000000000000000',
- *  '100.123', // 100.123 USDC
- *  { signature }
- * )
+ * const erc20PermitParam = await signERC20Permit({
+ *   chainId: 421614,
+ *   walletClient,
+ *   token: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
+ *   amount: '100.123'
+ * })
  *
- * @example
- * import { marketOrder } from '@clober/v2-sdk'
+ * const transaction = await marketOrder({
+ *   chainId: 421614,
+ *   userAddress: '0xF8c1869Ecd4df136693C45EcE1b67f85B6bDaE69
+ *   inputToken: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
+ *   outputToken: '0x0000000000000000000000000000000000000000',
+ *   amount: '100.123', // 100.123 USDC
+ *   options: { erc20PermitParam }
+ * })
  *
- * const transaction = await limitOrder(
- *   421614,
- *  '0xF8c1869Ecd4df136693C45EcE1b67f85B6bDaE69
- *  '0x0000000000000000000000000000000000000000',
- *  '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
- *  '0.13', // 0.13 ETH
- * )
  */
-export const marketOrder = decorator(async ({ chainId, userAddress, inputToken, outputToken, amount, options, }) => {
+export const marketOrder = decorator(async ({ chainId, userAddress, inputToken, outputToken, amountIn, amountOut, options, }) => {
+    if (!amountIn && !amountOut) {
+        throw new Error('Either amountIn or amountOut must be provided');
+    }
+    else if (amountIn && amountOut) {
+        throw new Error('Only one of amountIn or amountOut can be provided');
+    }
     const market = await fetchMarket(chainId, [inputToken, outputToken]);
-    const isBid = isAddressEqual(market.quote.address, inputToken);
-    if ((isBid && !market.bidBookOpen) || (!isBid && !market.askBookOpen)) {
+    const isTakingBid = isAddressEqual(market.base.address, inputToken);
+    const [inputCurrency, outputCurrency] = isTakingBid
+        ? [market.base, market.quote]
+        : [market.quote, market.base];
+    if ((isTakingBid && !market.bidBook.isOpened) ||
+        (!isTakingBid && !market.askBook.isOpened)) {
         throw new Error(`
+       Open the market before placing a market order.
        import { openMarket } from '@clober/v2-sdk'
 
        const transaction = await openMarket(
@@ -301,47 +343,134 @@ export const marketOrder = decorator(async ({ chainId, userAddress, inputToken,
        )
     `);
     }
-    const rawLimitPrice = parsePrice(Number(options?.limitPrice ?? '0'), market.quote.decimals, market.base.decimals);
     const tokensToSettle = [inputToken, outputToken].filter((address) => !isAddressEqual(address, zeroAddress));
-    const quoteAmount = parseUnits(amount, isBid ? market.quote.decimals : market.base.decimals);
-    const { result } = await getExpectedOutput({
-        chainId,
-        inputToken,
-        outputToken,
-        amountIn: amount,
-        options: {
-            ...options,
-        },
-    });
     const isETH = isAddressEqual(inputToken, zeroAddress);
-    const permitParamsList = options?.signature && !isETH
-        ? [
-            {
-                token: inputToken,
-                permitAmount: quoteAmount,
-                signature: options.signature,
+    if (amountIn && !amountOut) {
+        const { bookId, takenAmount, spentAmount, events } = await getExpectedOutput({
+            chainId,
+            inputToken,
+            outputToken,
+            amountIn,
+            options: {
+                ...options,
+                // don't need to check limit price for market order
             },
-        ]
-        : [];
-    return buildTransaction(chainId, {
-        chain: CHAIN_MAP[chainId],
-        account: userAddress,
-        address: CONTRACT_ADDRESSES[chainId].Controller,
-        abi: CONTROLLER_ABI,
-        functionName: 'take',
-        args: [
-            result.map(({ bookId, takenAmount }) => ({
-                id: bookId,
-                limitPrice: isBid ? invertPrice(rawLimitPrice) : rawLimitPrice,
-                quoteAmount: takenAmount,
-                hookData: zeroHash,
-            })),
-            tokensToSettle,
-            permitParamsList,
-            getDeadlineTimestampInSeconds(),
-        ],
-        value: isETH ? quoteAmount : 0n,
-    });
+        });
+        const baseAmount = parseUnits(amountIn, inputCurrency.decimals);
+        return {
+            transaction: await buildTransaction(chainId, {
+                chain: CHAIN_MAP[chainId],
+                account: userAddress,
+                address: CONTRACT_ADDRESSES[chainId].Controller,
+                abi: CONTROLLER_ABI,
+                functionName: 'spend',
+                args: [
+                    [
+                        {
+                            id: bookId,
+                            limitPrice: 0n,
+                            baseAmount,
+                            minQuoteAmount: options?.slippage
+                                ? applyPercent(parseUnits(takenAmount, outputCurrency.decimals), 100 - options.slippage)
+                                : 0n,
+                            hookData: zeroHash,
+                        },
+                    ],
+                    tokensToSettle,
+                    options?.erc20PermitParam ? [options.erc20PermitParam] : [],
+                    getDeadlineTimestampInSeconds(),
+                ],
+                value: isETH ? baseAmount : 0n,
+            }, options?.gasLimit),
+            result: {
+                spent: {
+                    amount: spentAmount,
+                    currency: inputCurrency,
+                    direction: 'in',
+                    events: events.map(({ price, spentAmount }) => ({
+                        price,
+                        amount: spentAmount,
+                    })),
+                },
+                taken: {
+                    amount: takenAmount,
+                    currency: outputCurrency,
+                    direction: 'out',
+                    events: events.map(({ price, takenAmount }) => ({
+                        price,
+                        amount: takenAmount,
+                    })),
+                },
+            },
+        };
+    }
+    else if (!amountIn && amountOut) {
+        const { bookId, spentAmount, takenAmount, events } = await getExpectedInput({
+            chainId,
+            inputToken,
+            outputToken,
+            amountOut,
+            options: {
+                ...options,
+                // don't need to check limit price for market order
+            },
+        });
+        const quoteAmount = parseUnits(amountOut, outputCurrency.decimals);
+        const baseAmount = parseUnits(spentAmount, inputCurrency.decimals);
+        const maxBaseAmount = options?.erc20PermitParam?.permitAmount ??
+            (options?.slippage
+                ? applyPercent(baseAmount, 100 + options.slippage)
+                : isETH
+                    ? baseAmount
+                    : 2n ** 256n - 1n);
+        return {
+            transaction: await buildTransaction(chainId, {
+                chain: CHAIN_MAP[chainId],
+                account: userAddress,
+                address: CONTRACT_ADDRESSES[chainId].Controller,
+                abi: CONTROLLER_ABI,
+                functionName: 'take',
+                args: [
+                    [
+                        {
+                            id: bookId,
+                            limitPrice: 0n,
+                            quoteAmount,
+                            maxBaseAmount,
+                            hookData: zeroHash,
+                        },
+                    ],
+                    tokensToSettle,
+                    options?.erc20PermitParam ? [options.erc20PermitParam] : [],
+                    getDeadlineTimestampInSeconds(),
+                ],
+                value: isETH ? maxBaseAmount : 0n,
+            }, options?.gasLimit),
+            result: {
+                spent: {
+                    amount: spentAmount,
+                    currency: inputCurrency,
+                    direction: 'in',
+                    events: events.map(({ price, spentAmount }) => ({
+                        price,
+                        amount: spentAmount,
+                    })),
+                },
+                taken: {
+                    amount: takenAmount,
+                    currency: outputCurrency,
+                    direction: 'out',
+                    events: events.map(({ price, takenAmount }) => ({
+                        price,
+                        amount: takenAmount,
+                    })),
+                },
+            },
+        };
+    }
+    else {
+        throw new Error('Either amountIn or amountOut must be provided');
+    }
 });
 /**
  * Claims specified open order for settlement.
@@ -352,28 +481,35 @@ export const marketOrder = decorator(async ({ chainId, userAddress, inputToken,
  * @param {string} id An ID representing the open order to be claimed.
  * @param {Object} [options] Optional parameters for claiming orders.
  * @param {string} [options.rpcUrl] The RPC URL to use for executing the transaction.
- * @returns {Promise<Transaction>} Promise resolving to the transaction object representing the claim action.
+ * @param {number} [options.gasLimit] The gas limit to use for the transaction.
+ * @param {boolean} [options.useSubgraph] A boolean indicating whether to use the subgraph for fetching orders.
+ * @returns {Promise<{ transaction: Transaction, result: CurrencyFlow }>}
+ * Promise resolving to the transaction object representing the claim action with the result of the order.
  * @throws {Error} Throws an error if no open orders are found for the specified user.
  * @example
  * import { getOpenOrders, claimOrders } from '@clober/v2-sdk'
  *
- * const openOrders = await getOpenOrders(
- *     421614,
- *    '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0'
- * )
- * const transaction = await claimOrders(
- *    421614,
- *    '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
- *    openOrders.map((order) => order.id)
- * )
+ * const openOrders = await getOpenOrders({
+ *     chainId: 421614,
+ *     userAddress: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0'
+ * })
+ * const transaction = await claimOrders({
+ *    chainId: 421614,
+ *    userAddress: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
+ *    id: openOrders.map((order) => order.id)
+ * })
  */
 export const claimOrder = decorator(async ({ chainId, userAddress, id, options, }) => {
-    return claimOrders({
+    const { transaction, result } = await claimOrders({
         chainId,
         userAddress,
         ids: [id],
         options: { ...options },
     });
+    return {
+        transaction,
+        result: result[0],
+    };
 });
 /**
  * Claims specified open orders for settlement.
@@ -384,61 +520,73 @@ export const claimOrder = decorator(async ({ chainId, userAddress, id, options,
  * @param {string[]} ids An array of IDs representing the open orders to be claimed.
  * @param {Object} [options] Optional parameters for claiming orders.
  * @param {string} [options.rpcUrl] The RPC URL to use for executing the transaction.
- * @returns {Promise<Transaction>} Promise resolving to the transaction object representing the claim action.
+ * @param {number} [options.gasLimit] The gas limit to use for the transaction.
+ * @param {boolean} [options.useSubgraph] A boolean indicating whether to use the subgraph for fetching orders.
+ * @returns {Promise<{ transaction: Transaction, result: CurrencyFlow[] }>}
+ * Promise resolving to the transaction object representing the claim action with the result of the orders.
  * @throws {Error} Throws an error if no open orders are found for the specified user.
  * @example
  * import { getOpenOrders, claimOrders } from '@clober/v2-sdk'
  *
- * const openOrders = await getOpenOrders(
- *     421614,
- *    '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0'
- * )
+ * const openOrders = await getOpenOrders({
+ *     chainId: 421614,
+ *     userAddress: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0'
+ * })
  * const transaction = await claimOrders(
- *    421614,
- *    '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
- *    openOrders.map((order) => order.id)
+ *    chainId: 421614,
+ *    userAddress: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
+ *    ids: openOrders.map((order) => order.id)
  * )
  */
 export const claimOrders = decorator(async ({ chainId, userAddress, ids, options, }) => {
     const isApprovedForAll = await fetchIsApprovedForAll(chainId, userAddress);
     if (!isApprovedForAll) {
         throw new Error(`
+       Set ApprovalForAll before calling this function.
        import { setApprovalOfOpenOrdersForAll } from '@clober/v2-sdk'
 
-       const hash = await setApprovalOfOpenOrdersForAll(
-            ${chainId},
-            privateKeyToAccount('0x...')
-       )
+       const hash = await setApprovalOfOpenOrdersForAll({
+            chainId: ${chainId},
+            walletClient, // use viem
+       })
     `);
     }
-    const openOrders = (await getOpenOrders({ chainId, userAddress, options: { ...options } })).filter((order) => ids.includes(order.id));
-    if (openOrders.length === 0) {
-        throw new Error(`No claimable open orders found for ${userAddress}`);
-    }
-    const tokensToSettle = openOrders
+    const orders = (await fetchOrders(chainId, ids.map((id) => BigInt(id)))).filter((order) => isAddressEqual(order.user, userAddress) &&
+        order.claimable.value !== '0');
+    const tokensToSettle = orders
         .map((order) => [
-        order.outputCurrency.address,
         order.inputCurrency.address,
+        order.outputCurrency.address,
     ])
         .flat()
         .filter((address, index, self) => self.findIndex((c) => isAddressEqual(c, address)) === index)
         .filter((address) => !isAddressEqual(address, zeroAddress));
-    return buildTransaction(chainId, {
-        chain: CHAIN_MAP[chainId],
-        account: userAddress,
-        address: CONTRACT_ADDRESSES[chainId].Controller,
-        abi: CONTROLLER_ABI,
-        functionName: 'claim',
-        args: [
-            openOrders.map((order) => ({
-                id: BigInt(order.id),
-                hookData: zeroHash,
-            })),
-            tokensToSettle,
-            [],
-            getDeadlineTimestampInSeconds(),
-        ],
-    });
+    return {
+        transaction: await buildTransaction(chainId, {
+            chain: CHAIN_MAP[chainId],
+            account: userAddress,
+            address: CONTRACT_ADDRESSES[chainId].Controller,
+            abi: CONTROLLER_ABI,
+            functionName: 'claim',
+            args: [
+                orders.map(({ id }) => ({
+                    id,
+                    hookData: zeroHash,
+                })),
+                tokensToSettle,
+                [],
+                getDeadlineTimestampInSeconds(),
+            ],
+        }, options?.gasLimit),
+        result: orders.reduce((acc, { claimable: { currency, value } }) => {
+            const index = acc.findIndex((c) => isAddressEqual(c.currency.address, currency.address));
+            if (index === -1) {
+                return [...acc, { currency, amount: value, direction: 'out' }];
+            }
+            acc[index].amount = (Number(acc[index].amount) + Number(value)).toString();
+            return acc;
+        }, []),
+    };
 });
 /**
  * Cancels specified open order if the order is not fully filled.
@@ -449,28 +597,35 @@ export const claimOrders = decorator(async ({ chainId, userAddress, ids, options
  * @param {string} id An ID representing the open order to be canceled
  * @param {Object} [options] Optional parameters for canceling orders.
  * @param {string} [options.rpcUrl] The RPC URL to use for executing the transaction.
- * @returns {Promise<Transaction>} Promise resolving to the transaction object representing the cancel action.
+ * @param {number} [options.gasLimit] The gas limit to use for the transaction.
+ * @param {boolean} [options.useSubgraph] A boolean indicating whether to use the subgraph for fetching orders.
+ * @returns {Promise<{ transaction: Transaction, result: CurrencyFlow }>}
+ * Promise resolving to the transaction object representing the cancel action with the result of the order.
  * @throws {Error} Throws an error if no open orders are found for the specified user.
  * @example
  * import { getOpenOrders, cancelOrders } from '@clober/v2-sdk'
  *
- * const openOrders = await getOpenOrders(
- *     421614,
- *    '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0'
- * )
- * const transaction = await cancelOrders(
- *    421614,
- *    '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
- *    openOrders.map((order) => order.id)
- * )
+ * const openOrders = await getOpenOrders({
+ *     chainId: 421614,
+ *     userAddress:'0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0'
+ * })
+ * const transaction = await cancelOrders({
+ *    chainId: 421614,
+ *    userAddress: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
+ *    id: openOrders.map((order) => order.id)
+ * })
  */
 export const cancelOrder = decorator(async ({ chainId, userAddress, id, options, }) => {
-    return cancelOrders({
+    const { transaction, result } = await cancelOrders({
         chainId,
         userAddress,
         ids: [id],
         options: { ...options },
     });
+    return {
+        transaction,
+        result: result[0],
+    };
 });
 /**
  * Cancels specified open orders if orders are not fully filled.
@@ -481,61 +636,73 @@ export const cancelOrder = decorator(async ({ chainId, userAddress, id, options,
  * @param {string[]} ids An array of IDs representing the open orders to be canceled.
  * @param {Object} [options] Optional parameters for canceling orders.
  * @param {string} [options.rpcUrl] The RPC URL to use for executing the transaction.
- * @returns {Promise<Transaction>} Promise resolving to the transaction object representing the cancel action.
+ * @param {number} [options.gasLimit] The gas limit to use for the transaction.
+ * @param {boolean} [options.useSubgraph] A boolean indicating whether to use the subgraph for fetching orders.
+ * @returns {Promise<{ transaction: Transaction, result: CurrencyFlow[] }>
+ * Promise resolving to the transaction object representing the cancel action with the result of the orders.
  * @throws {Error} Throws an error if no open orders are found for the specified user.
  * @example
  * import { getOpenOrders, cancelOrders } from '@clober/v2-sdk'
  *
- * const openOrders = await getOpenOrders(
- *     421614,
- *    '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0'
- * )
- * const transaction = await cancelOrders(
- *    421614,
- *    '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
- *    openOrders.map((order) => order.id)
- * )
+ * const openOrders = await getOpenOrders({
+ *     chainId: 421614,
+ *     userAddress: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0'
+ * })
+ * const transaction = await cancelOrders({
+ *    chainId: 421614,
+ *    userAddress: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
+ *    ids: openOrders.map((order) => order.id)
+ * })
  */
 export const cancelOrders = decorator(async ({ chainId, userAddress, ids, options, }) => {
     const isApprovedForAll = await fetchIsApprovedForAll(chainId, userAddress);
     if (!isApprovedForAll) {
         throw new Error(`
+       Set ApprovalForAll before calling this function.
        import { setApprovalOfOpenOrdersForAll } from '@clober/v2-sdk'
 
-       const hash = await setApprovalOfOpenOrdersForAll(
-            ${chainId},
-            privateKeyToAccount('0x...')
-       )
+       const hash = await setApprovalOfOpenOrdersForAll({
+            chainId: ${chainId},
+            walletClient, // use viem
+       })
     `);
     }
-    const openOrders = (await getOpenOrders({ chainId, userAddress, options: { ...options } })).filter((order) => ids.includes(order.id) && order.cancelable);
-    if (openOrders.length === 0) {
-        throw new Error(`No cancelable open orders found for ${userAddress}`);
-    }
-    const tokensToSettle = openOrders
+    const orders = (await fetchOrders(chainId, ids.map((id) => BigInt(id)))).filter((order) => isAddressEqual(order.user, userAddress) &&
+        order.cancelable.value !== '0');
+    const tokensToSettle = orders
         .map((order) => [
-        order.outputCurrency.address,
         order.inputCurrency.address,
+        order.outputCurrency.address,
     ])
         .flat()
         .filter((address, index, self) => self.findIndex((c) => isAddressEqual(c, address)) === index)
         .filter((address) => !isAddressEqual(address, zeroAddress));
-    return buildTransaction(chainId, {
-        chain: CHAIN_MAP[chainId],
-        account: userAddress,
-        address: CONTRACT_ADDRESSES[chainId].Controller,
-        abi: CONTROLLER_ABI,
-        functionName: 'cancel',
-        args: [
-            openOrders.map((order) => ({
-                id: BigInt(order.id),
-                leftQuoteAmount: 0n,
-                hookData: zeroHash,
-            })),
-            tokensToSettle,
-            [],
-            getDeadlineTimestampInSeconds(),
-        ],
-    });
+    return {
+        transaction: await buildTransaction(chainId, {
+            chain: CHAIN_MAP[chainId],
+            account: userAddress,
+            address: CONTRACT_ADDRESSES[chainId].Controller,
+            abi: CONTROLLER_ABI,
+            functionName: 'cancel',
+            args: [
+                orders.map(({ id }) => ({
+                    id,
+                    leftQuoteAmount: 0n,
+                    hookData: zeroHash,
+                })),
+                tokensToSettle,
+                [],
+                getDeadlineTimestampInSeconds(),
+            ],
+        }, options?.gasLimit),
+        result: orders.reduce((acc, { cancelable: { currency, value } }) => {
+            const index = acc.findIndex((c) => isAddressEqual(c.currency.address, currency.address));
+            if (index === -1) {
+                return [...acc, { currency, amount: value, direction: 'out' }];
+            }
+            acc[index].amount = (Number(acc[index].amount) + Number(value)).toString();
+            return acc;
+        }, []),
+    };
 });
 //# sourceMappingURL=call.js.map