@nadohq/engine-client 0.12.0 → 0.13.0

package/dist/EngineClient.d.cts

@@ -4,13 +4,13 @@ import { EngineQueryClient } from './EngineQueryClient.cjs';
 import { EngineWebClient } from './EngineWebClient.cjs';
 import './types/clientExecuteTypes.cjs';
 import '@nadohq/shared';
+import 'bignumber.js';
 import './types/serverExecuteTypes.cjs';
 import './types/serverQueryTypes.cjs';
 import './types/serverQueryModelTypes.cjs';
 import './EngineBaseClient.cjs';
 import 'axios';
 import './types/clientQueryTypes.cjs';
-import 'bignumber.js';
 import './EngineExecuteBuilder.cjs';
 
 declare const EngineClient_base: ts_mixer_dist_types_types.Class<any[], EngineQueryClient & EngineExecuteClient & EngineWebClient, typeof EngineQueryClient & typeof EngineExecuteClient & typeof EngineWebClient>;

package/dist/EngineClient.d.ts

@@ -4,13 +4,13 @@ import { EngineQueryClient } from './EngineQueryClient.js';
 import { EngineWebClient } from './EngineWebClient.js';
 import './types/clientExecuteTypes.js';
 import '@nadohq/shared';
+import 'bignumber.js';
 import './types/serverExecuteTypes.js';
 import './types/serverQueryTypes.js';
 import './types/serverQueryModelTypes.js';
 import './EngineBaseClient.js';
 import 'axios';
 import './types/clientQueryTypes.js';
-import 'bignumber.js';
 import './EngineExecuteBuilder.js';
 
 declare const EngineClient_base: ts_mixer_dist_types_types.Class<any[], EngineQueryClient & EngineExecuteClient & EngineWebClient, typeof EngineQueryClient & typeof EngineExecuteClient & typeof EngineWebClient>;

package/dist/EngineExecuteBuilder.cjs

@@ -152,7 +152,8 @@ var EngineExecuteBuilder = class {
     const tx = (0, import_shared.getNadoEIP712Values)("cancel_orders", clientParams);
     return {
       tx,
-      signature: clientParams.signature
+      signature: clientParams.signature,
+      required_unfilled_amount: clientParams.requiredUnfilledAmount ? (0, import_shared.toIntegerString)(clientParams.requiredUnfilledAmount) : void 0
     };
   }
   /**

package/dist/EngineExecuteBuilder.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/EngineExecuteBuilder.ts"],"sourcesContent":["import {\n  EIP712OrderParams,\n  getNadoEIP712Values,\n  getOrderNonce,\n  SignableRequestType,\n  SignableRequestTypeToParams,\n} from '@nadohq/shared';\nimport { EngineBaseClient } from './EngineBaseClient';\nimport {\n  EngineExecuteRequestParamsByType,\n  EngineServerExecutePlaceOrderPayload,\n  EngineServerExecuteRequestByType,\n  SignatureParams,\n  WithBaseEngineExecuteParams,\n  WithSignature,\n} from './types';\n\n/**\n * Builds execute payloads as expected by the server.\n * @param nonce A nonce is computed when one is not provided.\n * @param signature A signature is computed when one is not provided.\n */\nexport class EngineExecuteBuilder {\n  readonly engineClient: EngineBaseClient;\n\n  constructor(engineClient: EngineBaseClient) {\n    this.engineClient = engineClient;\n  }\n\n  /**\n   * Builds server payload for the `liquidate_subaccount` execute action.\n   * @param clientParams Client LiquidateSubaccount params.\n   * @returns `liquidate_subaccount` payload\n   */\n  async buildLiquidateSubaccountPayload(\n    clientParams: EngineExecuteRequestParamsByType['liquidate_subaccount'],\n  ): Promise<EngineServerExecuteRequestByType['liquidate_subaccount']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('liquidate_subaccount', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'liquidate_subaccount',\n      paramsWithNonce,\n    );\n\n    return {\n      signature,\n      tx,\n    };\n  }\n\n  /**\n   * Builds server payload for the `withdraw_collateral` execute action.\n   * @param clientParams Client WithdrawCollateral params.\n   * @returns `liquidate_subaccount` payload\n   */\n  async buildWithdrawCollateralPayload(\n    clientParams: EngineExecuteRequestParamsByType['withdraw_collateral'],\n  ): Promise<EngineServerExecuteRequestByType['withdraw_collateral']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const signature = await this.getSignatureIfNeeded(\n      'withdraw_collateral',\n      paramsWithNonce,\n    );\n\n    const tx = getNadoEIP712Values('withdraw_collateral', paramsWithNonce);\n    return {\n      signature,\n      tx,\n      spot_leverage: clientParams.spotLeverage ?? null,\n    };\n  }\n\n  /**\n   * Builds server payload for the `place_order` execute action.\n   *\n   * @param clientParams Client PlaceOrder params.\n   * @returns `place_order` payload\n   */\n  async buildPlaceOrderPayload(\n    clientParams: EngineExecuteRequestParamsByType['place_order'],\n  ): Promise<EngineServerExecutePlaceOrderPayload> {\n    const nonce = this.getOrderNonceIfNeeded(clientParams);\n    const orderWithNonce = { ...clientParams.order, nonce };\n\n    const signature = await this.getSignatureIfNeeded('place_order', {\n      // Gets expected type (signature params from `clientParams` and order params from `orderWithNonce`)\n      ...clientParams,\n      ...orderWithNonce,\n    });\n\n    return this.buildPlaceOrderPayloadSync({\n      ...clientParams,\n      order: orderWithNonce,\n      signature,\n    });\n  }\n\n  /**\n   * Synchronously builds server payload for the `place_order` execute action.\n   *\n   * @param clientParams Client PlaceOrder params.\n   * @returns `place_order` payload\n   */\n  buildPlaceOrderPayloadSync(\n    clientParams: WithSignature<\n      EngineExecuteRequestParamsByType['place_order'] & {\n        order: EIP712OrderParams;\n      }\n    >,\n  ): EngineServerExecutePlaceOrderPayload {\n    const orderEIP712Values = getNadoEIP712Values(\n      'place_order',\n      clientParams.order,\n    );\n\n    return {\n      payload: {\n        id: clientParams.id ?? null,\n        product_id: clientParams.productId,\n        order: orderEIP712Values,\n        signature: clientParams.signature,\n        spot_leverage: clientParams.spotLeverage ?? null,\n        borrow_margin: clientParams.borrowMargin ?? null,\n      },\n      orderParams: clientParams.order,\n    };\n  }\n\n  /**\n   * Builds server payload for the `place_orders` execute action.\n   * @param clientParams Client PlaceOrders params.\n   * @returns `place_orders` payload\n   */\n  async buildPlaceOrdersPayload(\n    clientParams: EngineExecuteRequestParamsByType['place_orders'],\n  ): Promise<EngineServerExecuteRequestByType['place_orders']> {\n    return {\n      orders: await Promise.all(\n        clientParams.orders.map(async (orderParams) => {\n          const payload = await this.buildPlaceOrderPayload(orderParams);\n          return payload.payload;\n        }),\n      ),\n      stop_on_failure: clientParams.stopOnFailure ?? null,\n    };\n  }\n\n  /**\n   * Builds server payload for the `cancel_orders` execute action. As such, requires a signature to be given\n   *\n   * @param clientParams Client CancelOrders params.\n   * @returns `cancel_orders` payload\n   */\n  async buildCancelOrdersPayload(\n    clientParams: EngineExecuteRequestParamsByType['cancel_orders'],\n  ): Promise<EngineServerExecuteRequestByType['cancel_orders']> {\n    const nonce = this.getOrderNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n    const signature = await this.getSignatureIfNeeded(\n      'cancel_orders',\n      paramsWithNonce,\n    );\n\n    return this.buildCancelOrdersPayloadSync({\n      ...paramsWithNonce,\n      signature,\n    });\n  }\n\n  /**\n   * Synchronously builds server payload for the `cancel_orders` execute action.\n   *\n   * @param clientParams Client CancelOrders params.\n   * @returns `cancel_orders` payload\n   */\n  buildCancelOrdersPayloadSync(\n    clientParams: WithSignature<\n      EngineExecuteRequestParamsByType['cancel_orders'] & { nonce: string }\n    >,\n  ): EngineServerExecuteRequestByType['cancel_orders'] {\n    const tx = getNadoEIP712Values('cancel_orders', clientParams);\n\n    return {\n      tx,\n      signature: clientParams.signature,\n    };\n  }\n\n  /**\n   * Builds server payload for the `cancel_product_orders` execute action.\n   * @param clientParams Client CancelProductOrders params.\n   * @returns `cancel_product_orders` payload\n   */\n  async buildCancelProductOrdersPayload(\n    clientParams: EngineExecuteRequestParamsByType['cancel_product_orders'],\n  ): Promise<EngineServerExecuteRequestByType['cancel_product_orders']> {\n    const nonce = this.getOrderNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('cancel_product_orders', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'cancel_product_orders',\n      paramsWithNonce,\n    );\n\n    return {\n      tx,\n      signature,\n    };\n  }\n\n  /**\n   * Builds server payload for the `link_signer` execute action.\n   *\n   * @param clientParams Client LinkSigner params.\n   * @returns `link_signer` payload\n   */\n  async buildLinkSignerPayload(\n    clientParams: EngineExecuteRequestParamsByType['link_signer'],\n  ): Promise<EngineServerExecuteRequestByType['link_signer']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('link_signer', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'link_signer',\n      paramsWithNonce,\n    );\n\n    return {\n      tx,\n      signature,\n    };\n  }\n\n  /**\n   * Builds server payload for the `transfer_quote` execute action.\n   *\n   * @param clientParams Client TransferQuote params.\n   * @returns `transfer_quote` payload\n   */\n  async buildTransferQuotePayload(\n    clientParams: EngineExecuteRequestParamsByType['transfer_quote'],\n  ): Promise<EngineServerExecuteRequestByType['transfer_quote']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('transfer_quote', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'transfer_quote',\n      paramsWithNonce,\n    );\n\n    return {\n      tx,\n      signature,\n    };\n  }\n\n  /**\n   * Builds server payload for the `mint_nlp` execute action.\n   * @param clientParams Client MintNlp params.\n   * @returns `mint_nlp` payload\n   */\n  async buildMintNlpPayload(\n    clientParams: EngineExecuteRequestParamsByType['mint_nlp'],\n  ): Promise<EngineServerExecuteRequestByType['mint_nlp']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('mint_nlp', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'mint_nlp',\n      paramsWithNonce,\n    );\n\n    return {\n      signature,\n      tx,\n      spot_leverage: clientParams.spotLeverage ?? null,\n    };\n  }\n\n  /**\n   * Builds server payload for the `burn_nlp` execute action.\n   * @param clientParams Client BurnNlp params.\n   * @returns `burn_nlp` payload\n   */\n  async buildBurnNlpPayload(\n    clientParams: EngineExecuteRequestParamsByType['burn_nlp'],\n  ): Promise<EngineServerExecuteRequestByType['burn_nlp']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('burn_nlp', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'burn_nlp',\n      paramsWithNonce,\n    );\n\n    return {\n      signature,\n      tx,\n    };\n  }\n\n  protected async getSignatureIfNeeded<T extends SignableRequestType>(\n    requestType: T,\n    paramsWithNonce: SignatureParams & SignableRequestTypeToParams[T],\n  ) {\n    if ('signature' in paramsWithNonce) {\n      return paramsWithNonce.signature;\n    }\n\n    return await this.engineClient.sign(\n      requestType,\n      paramsWithNonce.verifyingAddr,\n      paramsWithNonce.chainId,\n      paramsWithNonce,\n    );\n  }\n\n  protected async getTxNonceIfNeeded(\n    params: WithBaseEngineExecuteParams<{ subaccountOwner: string }>,\n  ) {\n    if (params.nonce) {\n      return params.nonce;\n    }\n    return await this.engineClient.getTxNonce(params.subaccountOwner);\n  }\n\n  protected getOrderNonceIfNeeded(\n    params: WithBaseEngineExecuteParams<unknown>,\n  ) {\n    if (params.nonce) {\n      return params.nonce;\n    }\n    return getOrderNonce();\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/EngineExecuteBuilder.ts"],"sourcesContent":["import {\n  EIP712OrderParams,\n  getNadoEIP712Values,\n  getOrderNonce,\n  SignableRequestType,\n  SignableRequestTypeToParams,\n  toIntegerString,\n} from '@nadohq/shared';\nimport { EngineBaseClient } from './EngineBaseClient';\nimport {\n  EngineExecuteRequestParamsByType,\n  EngineServerExecutePlaceOrderPayload,\n  EngineServerExecuteRequestByType,\n  SignatureParams,\n  WithBaseEngineExecuteParams,\n  WithSignature,\n} from './types';\n\n/**\n * Builds execute payloads as expected by the server.\n * @param nonce A nonce is computed when one is not provided.\n * @param signature A signature is computed when one is not provided.\n */\nexport class EngineExecuteBuilder {\n  readonly engineClient: EngineBaseClient;\n\n  constructor(engineClient: EngineBaseClient) {\n    this.engineClient = engineClient;\n  }\n\n  /**\n   * Builds server payload for the `liquidate_subaccount` execute action.\n   * @param clientParams Client LiquidateSubaccount params.\n   * @returns `liquidate_subaccount` payload\n   */\n  async buildLiquidateSubaccountPayload(\n    clientParams: EngineExecuteRequestParamsByType['liquidate_subaccount'],\n  ): Promise<EngineServerExecuteRequestByType['liquidate_subaccount']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('liquidate_subaccount', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'liquidate_subaccount',\n      paramsWithNonce,\n    );\n\n    return {\n      signature,\n      tx,\n    };\n  }\n\n  /**\n   * Builds server payload for the `withdraw_collateral` execute action.\n   * @param clientParams Client WithdrawCollateral params.\n   * @returns `liquidate_subaccount` payload\n   */\n  async buildWithdrawCollateralPayload(\n    clientParams: EngineExecuteRequestParamsByType['withdraw_collateral'],\n  ): Promise<EngineServerExecuteRequestByType['withdraw_collateral']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const signature = await this.getSignatureIfNeeded(\n      'withdraw_collateral',\n      paramsWithNonce,\n    );\n\n    const tx = getNadoEIP712Values('withdraw_collateral', paramsWithNonce);\n    return {\n      signature,\n      tx,\n      spot_leverage: clientParams.spotLeverage ?? null,\n    };\n  }\n\n  /**\n   * Builds server payload for the `place_order` execute action.\n   *\n   * @param clientParams Client PlaceOrder params.\n   * @returns `place_order` payload\n   */\n  async buildPlaceOrderPayload(\n    clientParams: EngineExecuteRequestParamsByType['place_order'],\n  ): Promise<EngineServerExecutePlaceOrderPayload> {\n    const nonce = this.getOrderNonceIfNeeded(clientParams);\n    const orderWithNonce = { ...clientParams.order, nonce };\n\n    const signature = await this.getSignatureIfNeeded('place_order', {\n      // Gets expected type (signature params from `clientParams` and order params from `orderWithNonce`)\n      ...clientParams,\n      ...orderWithNonce,\n    });\n\n    return this.buildPlaceOrderPayloadSync({\n      ...clientParams,\n      order: orderWithNonce,\n      signature,\n    });\n  }\n\n  /**\n   * Synchronously builds server payload for the `place_order` execute action.\n   *\n   * @param clientParams Client PlaceOrder params.\n   * @returns `place_order` payload\n   */\n  buildPlaceOrderPayloadSync(\n    clientParams: WithSignature<\n      EngineExecuteRequestParamsByType['place_order'] & {\n        order: EIP712OrderParams;\n      }\n    >,\n  ): EngineServerExecutePlaceOrderPayload {\n    const orderEIP712Values = getNadoEIP712Values(\n      'place_order',\n      clientParams.order,\n    );\n\n    return {\n      payload: {\n        id: clientParams.id ?? null,\n        product_id: clientParams.productId,\n        order: orderEIP712Values,\n        signature: clientParams.signature,\n        spot_leverage: clientParams.spotLeverage ?? null,\n        borrow_margin: clientParams.borrowMargin ?? null,\n      },\n      orderParams: clientParams.order,\n    };\n  }\n\n  /**\n   * Builds server payload for the `place_orders` execute action.\n   * @param clientParams Client PlaceOrders params.\n   * @returns `place_orders` payload\n   */\n  async buildPlaceOrdersPayload(\n    clientParams: EngineExecuteRequestParamsByType['place_orders'],\n  ): Promise<EngineServerExecuteRequestByType['place_orders']> {\n    return {\n      orders: await Promise.all(\n        clientParams.orders.map(async (orderParams) => {\n          const payload = await this.buildPlaceOrderPayload(orderParams);\n          return payload.payload;\n        }),\n      ),\n      stop_on_failure: clientParams.stopOnFailure ?? null,\n    };\n  }\n\n  /**\n   * Builds server payload for the `cancel_orders` execute action. As such, requires a signature to be given\n   *\n   * @param clientParams Client CancelOrders params.\n   * @returns `cancel_orders` payload\n   */\n  async buildCancelOrdersPayload(\n    clientParams: EngineExecuteRequestParamsByType['cancel_orders'],\n  ): Promise<EngineServerExecuteRequestByType['cancel_orders']> {\n    const nonce = this.getOrderNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n    const signature = await this.getSignatureIfNeeded(\n      'cancel_orders',\n      paramsWithNonce,\n    );\n\n    return this.buildCancelOrdersPayloadSync({\n      ...paramsWithNonce,\n      signature,\n    });\n  }\n\n  /**\n   * Synchronously builds server payload for the `cancel_orders` execute action.\n   *\n   * @param clientParams Client CancelOrders params.\n   * @returns `cancel_orders` payload\n   */\n  buildCancelOrdersPayloadSync(\n    clientParams: WithSignature<\n      EngineExecuteRequestParamsByType['cancel_orders'] & { nonce: string }\n    >,\n  ): EngineServerExecuteRequestByType['cancel_orders'] {\n    const tx = getNadoEIP712Values('cancel_orders', clientParams);\n\n    return {\n      tx,\n      signature: clientParams.signature,\n      required_unfilled_amount: clientParams.requiredUnfilledAmount\n        ? toIntegerString(clientParams.requiredUnfilledAmount)\n        : undefined,\n    };\n  }\n\n  /**\n   * Builds server payload for the `cancel_product_orders` execute action.\n   * @param clientParams Client CancelProductOrders params.\n   * @returns `cancel_product_orders` payload\n   */\n  async buildCancelProductOrdersPayload(\n    clientParams: EngineExecuteRequestParamsByType['cancel_product_orders'],\n  ): Promise<EngineServerExecuteRequestByType['cancel_product_orders']> {\n    const nonce = this.getOrderNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('cancel_product_orders', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'cancel_product_orders',\n      paramsWithNonce,\n    );\n\n    return {\n      tx,\n      signature,\n    };\n  }\n\n  /**\n   * Builds server payload for the `link_signer` execute action.\n   *\n   * @param clientParams Client LinkSigner params.\n   * @returns `link_signer` payload\n   */\n  async buildLinkSignerPayload(\n    clientParams: EngineExecuteRequestParamsByType['link_signer'],\n  ): Promise<EngineServerExecuteRequestByType['link_signer']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('link_signer', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'link_signer',\n      paramsWithNonce,\n    );\n\n    return {\n      tx,\n      signature,\n    };\n  }\n\n  /**\n   * Builds server payload for the `transfer_quote` execute action.\n   *\n   * @param clientParams Client TransferQuote params.\n   * @returns `transfer_quote` payload\n   */\n  async buildTransferQuotePayload(\n    clientParams: EngineExecuteRequestParamsByType['transfer_quote'],\n  ): Promise<EngineServerExecuteRequestByType['transfer_quote']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('transfer_quote', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'transfer_quote',\n      paramsWithNonce,\n    );\n\n    return {\n      tx,\n      signature,\n    };\n  }\n\n  /**\n   * Builds server payload for the `mint_nlp` execute action.\n   * @param clientParams Client MintNlp params.\n   * @returns `mint_nlp` payload\n   */\n  async buildMintNlpPayload(\n    clientParams: EngineExecuteRequestParamsByType['mint_nlp'],\n  ): Promise<EngineServerExecuteRequestByType['mint_nlp']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('mint_nlp', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'mint_nlp',\n      paramsWithNonce,\n    );\n\n    return {\n      signature,\n      tx,\n      spot_leverage: clientParams.spotLeverage ?? null,\n    };\n  }\n\n  /**\n   * Builds server payload for the `burn_nlp` execute action.\n   * @param clientParams Client BurnNlp params.\n   * @returns `burn_nlp` payload\n   */\n  async buildBurnNlpPayload(\n    clientParams: EngineExecuteRequestParamsByType['burn_nlp'],\n  ): Promise<EngineServerExecuteRequestByType['burn_nlp']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('burn_nlp', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'burn_nlp',\n      paramsWithNonce,\n    );\n\n    return {\n      signature,\n      tx,\n    };\n  }\n\n  protected async getSignatureIfNeeded<T extends SignableRequestType>(\n    requestType: T,\n    paramsWithNonce: SignatureParams & SignableRequestTypeToParams[T],\n  ) {\n    if ('signature' in paramsWithNonce) {\n      return paramsWithNonce.signature;\n    }\n\n    return await this.engineClient.sign(\n      requestType,\n      paramsWithNonce.verifyingAddr,\n      paramsWithNonce.chainId,\n      paramsWithNonce,\n    );\n  }\n\n  protected async getTxNonceIfNeeded(\n    params: WithBaseEngineExecuteParams<{ subaccountOwner: string }>,\n  ) {\n    if (params.nonce) {\n      return params.nonce;\n    }\n    return await this.engineClient.getTxNonce(params.subaccountOwner);\n  }\n\n  protected getOrderNonceIfNeeded(\n    params: WithBaseEngineExecuteParams<unknown>,\n  ) {\n    if (params.nonce) {\n      return params.nonce;\n    }\n    return getOrderNonce();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAOO;AAgBA,IAAM,uBAAN,MAA2B;AAAA,EAGhC,YAAY,cAAgC;AAC1C,SAAK,eAAe;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,gCACJ,cACmE;AACnE,UAAM,QAAQ,MAAM,KAAK,mBAAmB,YAAY;AACxD,UAAM,kBAAkB,EAAE,GAAG,cAAc,MAAM;AAEjD,UAAM,SAAK,mCAAoB,wBAAwB,eAAe;AACtE,UAAM,YAAY,MAAM,KAAK;AAAA,MAC3B;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,+BACJ,cACkE;AAClE,UAAM,QAAQ,MAAM,KAAK,mBAAmB,YAAY;AACxD,UAAM,kBAAkB,EAAE,GAAG,cAAc,MAAM;AAEjD,UAAM,YAAY,MAAM,KAAK;AAAA,MAC3B;AAAA,MACA;AAAA,IACF;AAEA,UAAM,SAAK,mCAAoB,uBAAuB,eAAe;AACrE,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,eAAe,aAAa,gBAAgB;AAAA,IAC9C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,uBACJ,cAC+C;AAC/C,UAAM,QAAQ,KAAK,sBAAsB,YAAY;AACrD,UAAM,iBAAiB,EAAE,GAAG,aAAa,OAAO,MAAM;AAEtD,UAAM,YAAY,MAAM,KAAK,qBAAqB,eAAe;AAAA;AAAA,MAE/D,GAAG;AAAA,MACH,GAAG;AAAA,IACL,CAAC;AAED,WAAO,KAAK,2BAA2B;AAAA,MACrC,GAAG;AAAA,MACH,OAAO;AAAA,MACP;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,2BACE,cAKsC;AACtC,UAAM,wBAAoB;AAAA,MACxB;AAAA,MACA,aAAa;AAAA,IACf;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,QACP,IAAI,aAAa,MAAM;AAAA,QACvB,YAAY,aAAa;AAAA,QACzB,OAAO;AAAA,QACP,WAAW,aAAa;AAAA,QACxB,eAAe,aAAa,gBAAgB;AAAA,QAC5C,eAAe,aAAa,gBAAgB;AAAA,MAC9C;AAAA,MACA,aAAa,aAAa;AAAA,IAC5B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,wBACJ,cAC2D;AAC3D,WAAO;AAAA,MACL,QAAQ,MAAM,QAAQ;AAAA,QACpB,aAAa,OAAO,IAAI,OAAO,gBAAgB;AAC7C,gBAAM,UAAU,MAAM,KAAK,uBAAuB,WAAW;AAC7D,iBAAO,QAAQ;AAAA,QACjB,CAAC;AAAA,MACH;AAAA,MACA,iBAAiB,aAAa,iBAAiB;AAAA,IACjD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,yBACJ,cAC4D;AAC5D,UAAM,QAAQ,KAAK,sBAAsB,YAAY;AACrD,UAAM,kBAAkB,EAAE,GAAG,cAAc,MAAM;AACjD,UAAM,YAAY,MAAM,KAAK;AAAA,MAC3B;AAAA,MACA;AAAA,IACF;AAEA,WAAO,KAAK,6BAA6B;AAAA,MACvC,GAAG;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,6BACE,cAGmD;AACnD,UAAM,SAAK,mCAAoB,iBAAiB,YAAY;AAE5D,WAAO;AAAA,MACL;AAAA,MACA,WAAW,aAAa;AAAA,MACxB,0BAA0B,aAAa,6BACnC,+BAAgB,aAAa,sBAAsB,IACnD;AAAA,IACN;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,gCACJ,cACoE;AACpE,UAAM,QAAQ,KAAK,sBAAsB,YAAY;AACrD,UAAM,kBAAkB,EAAE,GAAG,cAAc,MAAM;AAEjD,UAAM,SAAK,mCAAoB,yBAAyB,eAAe;AACvE,UAAM,YAAY,MAAM,KAAK;AAAA,MAC3B;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,uBACJ,cAC0D;AAC1D,UAAM,QAAQ,MAAM,KAAK,mBAAmB,YAAY;AACxD,UAAM,kBAAkB,EAAE,GAAG,cAAc,MAAM;AAEjD,UAAM,SAAK,mCAAoB,eAAe,eAAe;AAC7D,UAAM,YAAY,MAAM,KAAK;AAAA,MAC3B;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,0BACJ,cAC6D;AAC7D,UAAM,QAAQ,MAAM,KAAK,mBAAmB,YAAY;AACxD,UAAM,kBAAkB,EAAE,GAAG,cAAc,MAAM;AAEjD,UAAM,SAAK,mCAAoB,kBAAkB,eAAe;AAChE,UAAM,YAAY,MAAM,KAAK;AAAA,MAC3B;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,oBACJ,cACuD;AACvD,UAAM,QAAQ,MAAM,KAAK,mBAAmB,YAAY;AACxD,UAAM,kBAAkB,EAAE,GAAG,cAAc,MAAM;AAEjD,UAAM,SAAK,mCAAoB,YAAY,eAAe;AAC1D,UAAM,YAAY,MAAM,KAAK;AAAA,MAC3B;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,eAAe,aAAa,gBAAgB;AAAA,IAC9C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,oBACJ,cACuD;AACvD,UAAM,QAAQ,MAAM,KAAK,mBAAmB,YAAY;AACxD,UAAM,kBAAkB,EAAE,GAAG,cAAc,MAAM;AAEjD,UAAM,SAAK,mCAAoB,YAAY,eAAe;AAC1D,UAAM,YAAY,MAAM,KAAK;AAAA,MAC3B;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAgB,qBACd,aACA,iBACA;AACA,QAAI,eAAe,iBAAiB;AAClC,aAAO,gBAAgB;AAAA,IACzB;AAEA,WAAO,MAAM,KAAK,aAAa;AAAA,MAC7B;AAAA,MACA,gBAAgB;AAAA,MAChB,gBAAgB;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAgB,mBACd,QACA;AACA,QAAI,OAAO,OAAO;AAChB,aAAO,OAAO;AAAA,IAChB;AACA,WAAO,MAAM,KAAK,aAAa,WAAW,OAAO,eAAe;AAAA,EAClE;AAAA,EAEU,sBACR,QACA;AACA,QAAI,OAAO,OAAO;AAChB,aAAO,OAAO;AAAA,IAChB;AACA,eAAO,6BAAc;AAAA,EACvB;AACF;","names":[]}

package/dist/EngineExecuteBuilder.js

@@ -1,7 +1,8 @@
 // src/EngineExecuteBuilder.ts
 import {
   getNadoEIP712Values,
-  getOrderNonce
+  getOrderNonce,
+  toIntegerString
 } from "@nadohq/shared";
 var EngineExecuteBuilder = class {
   constructor(engineClient) {
@@ -131,7 +132,8 @@ var EngineExecuteBuilder = class {
     const tx = getNadoEIP712Values("cancel_orders", clientParams);
     return {
       tx,
-      signature: clientParams.signature
+      signature: clientParams.signature,
+      required_unfilled_amount: clientParams.requiredUnfilledAmount ? toIntegerString(clientParams.requiredUnfilledAmount) : void 0
     };
   }
   /**

package/dist/EngineExecuteBuilder.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/EngineExecuteBuilder.ts"],"sourcesContent":["import {\n  EIP712OrderParams,\n  getNadoEIP712Values,\n  getOrderNonce,\n  SignableRequestType,\n  SignableRequestTypeToParams,\n} from '@nadohq/shared';\nimport { EngineBaseClient } from './EngineBaseClient';\nimport {\n  EngineExecuteRequestParamsByType,\n  EngineServerExecutePlaceOrderPayload,\n  EngineServerExecuteRequestByType,\n  SignatureParams,\n  WithBaseEngineExecuteParams,\n  WithSignature,\n} from './types';\n\n/**\n * Builds execute payloads as expected by the server.\n * @param nonce A nonce is computed when one is not provided.\n * @param signature A signature is computed when one is not provided.\n */\nexport class EngineExecuteBuilder {\n  readonly engineClient: EngineBaseClient;\n\n  constructor(engineClient: EngineBaseClient) {\n    this.engineClient = engineClient;\n  }\n\n  /**\n   * Builds server payload for the `liquidate_subaccount` execute action.\n   * @param clientParams Client LiquidateSubaccount params.\n   * @returns `liquidate_subaccount` payload\n   */\n  async buildLiquidateSubaccountPayload(\n    clientParams: EngineExecuteRequestParamsByType['liquidate_subaccount'],\n  ): Promise<EngineServerExecuteRequestByType['liquidate_subaccount']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('liquidate_subaccount', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'liquidate_subaccount',\n      paramsWithNonce,\n    );\n\n    return {\n      signature,\n      tx,\n    };\n  }\n\n  /**\n   * Builds server payload for the `withdraw_collateral` execute action.\n   * @param clientParams Client WithdrawCollateral params.\n   * @returns `liquidate_subaccount` payload\n   */\n  async buildWithdrawCollateralPayload(\n    clientParams: EngineExecuteRequestParamsByType['withdraw_collateral'],\n  ): Promise<EngineServerExecuteRequestByType['withdraw_collateral']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const signature = await this.getSignatureIfNeeded(\n      'withdraw_collateral',\n      paramsWithNonce,\n    );\n\n    const tx = getNadoEIP712Values('withdraw_collateral', paramsWithNonce);\n    return {\n      signature,\n      tx,\n      spot_leverage: clientParams.spotLeverage ?? null,\n    };\n  }\n\n  /**\n   * Builds server payload for the `place_order` execute action.\n   *\n   * @param clientParams Client PlaceOrder params.\n   * @returns `place_order` payload\n   */\n  async buildPlaceOrderPayload(\n    clientParams: EngineExecuteRequestParamsByType['place_order'],\n  ): Promise<EngineServerExecutePlaceOrderPayload> {\n    const nonce = this.getOrderNonceIfNeeded(clientParams);\n    const orderWithNonce = { ...clientParams.order, nonce };\n\n    const signature = await this.getSignatureIfNeeded('place_order', {\n      // Gets expected type (signature params from `clientParams` and order params from `orderWithNonce`)\n      ...clientParams,\n      ...orderWithNonce,\n    });\n\n    return this.buildPlaceOrderPayloadSync({\n      ...clientParams,\n      order: orderWithNonce,\n      signature,\n    });\n  }\n\n  /**\n   * Synchronously builds server payload for the `place_order` execute action.\n   *\n   * @param clientParams Client PlaceOrder params.\n   * @returns `place_order` payload\n   */\n  buildPlaceOrderPayloadSync(\n    clientParams: WithSignature<\n      EngineExecuteRequestParamsByType['place_order'] & {\n        order: EIP712OrderParams;\n      }\n    >,\n  ): EngineServerExecutePlaceOrderPayload {\n    const orderEIP712Values = getNadoEIP712Values(\n      'place_order',\n      clientParams.order,\n    );\n\n    return {\n      payload: {\n        id: clientParams.id ?? null,\n        product_id: clientParams.productId,\n        order: orderEIP712Values,\n        signature: clientParams.signature,\n        spot_leverage: clientParams.spotLeverage ?? null,\n        borrow_margin: clientParams.borrowMargin ?? null,\n      },\n      orderParams: clientParams.order,\n    };\n  }\n\n  /**\n   * Builds server payload for the `place_orders` execute action.\n   * @param clientParams Client PlaceOrders params.\n   * @returns `place_orders` payload\n   */\n  async buildPlaceOrdersPayload(\n    clientParams: EngineExecuteRequestParamsByType['place_orders'],\n  ): Promise<EngineServerExecuteRequestByType['place_orders']> {\n    return {\n      orders: await Promise.all(\n        clientParams.orders.map(async (orderParams) => {\n          const payload = await this.buildPlaceOrderPayload(orderParams);\n          return payload.payload;\n        }),\n      ),\n      stop_on_failure: clientParams.stopOnFailure ?? null,\n    };\n  }\n\n  /**\n   * Builds server payload for the `cancel_orders` execute action. As such, requires a signature to be given\n   *\n   * @param clientParams Client CancelOrders params.\n   * @returns `cancel_orders` payload\n   */\n  async buildCancelOrdersPayload(\n    clientParams: EngineExecuteRequestParamsByType['cancel_orders'],\n  ): Promise<EngineServerExecuteRequestByType['cancel_orders']> {\n    const nonce = this.getOrderNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n    const signature = await this.getSignatureIfNeeded(\n      'cancel_orders',\n      paramsWithNonce,\n    );\n\n    return this.buildCancelOrdersPayloadSync({\n      ...paramsWithNonce,\n      signature,\n    });\n  }\n\n  /**\n   * Synchronously builds server payload for the `cancel_orders` execute action.\n   *\n   * @param clientParams Client CancelOrders params.\n   * @returns `cancel_orders` payload\n   */\n  buildCancelOrdersPayloadSync(\n    clientParams: WithSignature<\n      EngineExecuteRequestParamsByType['cancel_orders'] & { nonce: string }\n    >,\n  ): EngineServerExecuteRequestByType['cancel_orders'] {\n    const tx = getNadoEIP712Values('cancel_orders', clientParams);\n\n    return {\n      tx,\n      signature: clientParams.signature,\n    };\n  }\n\n  /**\n   * Builds server payload for the `cancel_product_orders` execute action.\n   * @param clientParams Client CancelProductOrders params.\n   * @returns `cancel_product_orders` payload\n   */\n  async buildCancelProductOrdersPayload(\n    clientParams: EngineExecuteRequestParamsByType['cancel_product_orders'],\n  ): Promise<EngineServerExecuteRequestByType['cancel_product_orders']> {\n    const nonce = this.getOrderNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('cancel_product_orders', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'cancel_product_orders',\n      paramsWithNonce,\n    );\n\n    return {\n      tx,\n      signature,\n    };\n  }\n\n  /**\n   * Builds server payload for the `link_signer` execute action.\n   *\n   * @param clientParams Client LinkSigner params.\n   * @returns `link_signer` payload\n   */\n  async buildLinkSignerPayload(\n    clientParams: EngineExecuteRequestParamsByType['link_signer'],\n  ): Promise<EngineServerExecuteRequestByType['link_signer']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('link_signer', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'link_signer',\n      paramsWithNonce,\n    );\n\n    return {\n      tx,\n      signature,\n    };\n  }\n\n  /**\n   * Builds server payload for the `transfer_quote` execute action.\n   *\n   * @param clientParams Client TransferQuote params.\n   * @returns `transfer_quote` payload\n   */\n  async buildTransferQuotePayload(\n    clientParams: EngineExecuteRequestParamsByType['transfer_quote'],\n  ): Promise<EngineServerExecuteRequestByType['transfer_quote']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('transfer_quote', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'transfer_quote',\n      paramsWithNonce,\n    );\n\n    return {\n      tx,\n      signature,\n    };\n  }\n\n  /**\n   * Builds server payload for the `mint_nlp` execute action.\n   * @param clientParams Client MintNlp params.\n   * @returns `mint_nlp` payload\n   */\n  async buildMintNlpPayload(\n    clientParams: EngineExecuteRequestParamsByType['mint_nlp'],\n  ): Promise<EngineServerExecuteRequestByType['mint_nlp']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('mint_nlp', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'mint_nlp',\n      paramsWithNonce,\n    );\n\n    return {\n      signature,\n      tx,\n      spot_leverage: clientParams.spotLeverage ?? null,\n    };\n  }\n\n  /**\n   * Builds server payload for the `burn_nlp` execute action.\n   * @param clientParams Client BurnNlp params.\n   * @returns `burn_nlp` payload\n   */\n  async buildBurnNlpPayload(\n    clientParams: EngineExecuteRequestParamsByType['burn_nlp'],\n  ): Promise<EngineServerExecuteRequestByType['burn_nlp']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('burn_nlp', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'burn_nlp',\n      paramsWithNonce,\n    );\n\n    return {\n      signature,\n      tx,\n    };\n  }\n\n  protected async getSignatureIfNeeded<T extends SignableRequestType>(\n    requestType: T,\n    paramsWithNonce: SignatureParams & SignableRequestTypeToParams[T],\n  ) {\n    if ('signature' in paramsWithNonce) {\n      return paramsWithNonce.signature;\n    }\n\n    return await this.engineClient.sign(\n      requestType,\n      paramsWithNonce.verifyingAddr,\n      paramsWithNonce.chainId,\n      paramsWithNonce,\n    );\n  }\n\n  protected async getTxNonceIfNeeded(\n    params: WithBaseEngineExecuteParams<{ subaccountOwner: string }>,\n  ) {\n    if (params.nonce) {\n      return params.nonce;\n    }\n    return await this.engineClient.getTxNonce(params.subaccountOwner);\n  }\n\n  protected getOrderNonceIfNeeded(\n    params: WithBaseEngineExecuteParams<unknown>,\n  ) {\n    if (params.nonce) {\n      return params.nonce;\n    }\n    return getOrderNonce();\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/EngineExecuteBuilder.ts"],"sourcesContent":["import {\n  EIP712OrderParams,\n  getNadoEIP712Values,\n  getOrderNonce,\n  SignableRequestType,\n  SignableRequestTypeToParams,\n  toIntegerString,\n} from '@nadohq/shared';\nimport { EngineBaseClient } from './EngineBaseClient';\nimport {\n  EngineExecuteRequestParamsByType,\n  EngineServerExecutePlaceOrderPayload,\n  EngineServerExecuteRequestByType,\n  SignatureParams,\n  WithBaseEngineExecuteParams,\n  WithSignature,\n} from './types';\n\n/**\n * Builds execute payloads as expected by the server.\n * @param nonce A nonce is computed when one is not provided.\n * @param signature A signature is computed when one is not provided.\n */\nexport class EngineExecuteBuilder {\n  readonly engineClient: EngineBaseClient;\n\n  constructor(engineClient: EngineBaseClient) {\n    this.engineClient = engineClient;\n  }\n\n  /**\n   * Builds server payload for the `liquidate_subaccount` execute action.\n   * @param clientParams Client LiquidateSubaccount params.\n   * @returns `liquidate_subaccount` payload\n   */\n  async buildLiquidateSubaccountPayload(\n    clientParams: EngineExecuteRequestParamsByType['liquidate_subaccount'],\n  ): Promise<EngineServerExecuteRequestByType['liquidate_subaccount']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('liquidate_subaccount', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'liquidate_subaccount',\n      paramsWithNonce,\n    );\n\n    return {\n      signature,\n      tx,\n    };\n  }\n\n  /**\n   * Builds server payload for the `withdraw_collateral` execute action.\n   * @param clientParams Client WithdrawCollateral params.\n   * @returns `liquidate_subaccount` payload\n   */\n  async buildWithdrawCollateralPayload(\n    clientParams: EngineExecuteRequestParamsByType['withdraw_collateral'],\n  ): Promise<EngineServerExecuteRequestByType['withdraw_collateral']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const signature = await this.getSignatureIfNeeded(\n      'withdraw_collateral',\n      paramsWithNonce,\n    );\n\n    const tx = getNadoEIP712Values('withdraw_collateral', paramsWithNonce);\n    return {\n      signature,\n      tx,\n      spot_leverage: clientParams.spotLeverage ?? null,\n    };\n  }\n\n  /**\n   * Builds server payload for the `place_order` execute action.\n   *\n   * @param clientParams Client PlaceOrder params.\n   * @returns `place_order` payload\n   */\n  async buildPlaceOrderPayload(\n    clientParams: EngineExecuteRequestParamsByType['place_order'],\n  ): Promise<EngineServerExecutePlaceOrderPayload> {\n    const nonce = this.getOrderNonceIfNeeded(clientParams);\n    const orderWithNonce = { ...clientParams.order, nonce };\n\n    const signature = await this.getSignatureIfNeeded('place_order', {\n      // Gets expected type (signature params from `clientParams` and order params from `orderWithNonce`)\n      ...clientParams,\n      ...orderWithNonce,\n    });\n\n    return this.buildPlaceOrderPayloadSync({\n      ...clientParams,\n      order: orderWithNonce,\n      signature,\n    });\n  }\n\n  /**\n   * Synchronously builds server payload for the `place_order` execute action.\n   *\n   * @param clientParams Client PlaceOrder params.\n   * @returns `place_order` payload\n   */\n  buildPlaceOrderPayloadSync(\n    clientParams: WithSignature<\n      EngineExecuteRequestParamsByType['place_order'] & {\n        order: EIP712OrderParams;\n      }\n    >,\n  ): EngineServerExecutePlaceOrderPayload {\n    const orderEIP712Values = getNadoEIP712Values(\n      'place_order',\n      clientParams.order,\n    );\n\n    return {\n      payload: {\n        id: clientParams.id ?? null,\n        product_id: clientParams.productId,\n        order: orderEIP712Values,\n        signature: clientParams.signature,\n        spot_leverage: clientParams.spotLeverage ?? null,\n        borrow_margin: clientParams.borrowMargin ?? null,\n      },\n      orderParams: clientParams.order,\n    };\n  }\n\n  /**\n   * Builds server payload for the `place_orders` execute action.\n   * @param clientParams Client PlaceOrders params.\n   * @returns `place_orders` payload\n   */\n  async buildPlaceOrdersPayload(\n    clientParams: EngineExecuteRequestParamsByType['place_orders'],\n  ): Promise<EngineServerExecuteRequestByType['place_orders']> {\n    return {\n      orders: await Promise.all(\n        clientParams.orders.map(async (orderParams) => {\n          const payload = await this.buildPlaceOrderPayload(orderParams);\n          return payload.payload;\n        }),\n      ),\n      stop_on_failure: clientParams.stopOnFailure ?? null,\n    };\n  }\n\n  /**\n   * Builds server payload for the `cancel_orders` execute action. As such, requires a signature to be given\n   *\n   * @param clientParams Client CancelOrders params.\n   * @returns `cancel_orders` payload\n   */\n  async buildCancelOrdersPayload(\n    clientParams: EngineExecuteRequestParamsByType['cancel_orders'],\n  ): Promise<EngineServerExecuteRequestByType['cancel_orders']> {\n    const nonce = this.getOrderNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n    const signature = await this.getSignatureIfNeeded(\n      'cancel_orders',\n      paramsWithNonce,\n    );\n\n    return this.buildCancelOrdersPayloadSync({\n      ...paramsWithNonce,\n      signature,\n    });\n  }\n\n  /**\n   * Synchronously builds server payload for the `cancel_orders` execute action.\n   *\n   * @param clientParams Client CancelOrders params.\n   * @returns `cancel_orders` payload\n   */\n  buildCancelOrdersPayloadSync(\n    clientParams: WithSignature<\n      EngineExecuteRequestParamsByType['cancel_orders'] & { nonce: string }\n    >,\n  ): EngineServerExecuteRequestByType['cancel_orders'] {\n    const tx = getNadoEIP712Values('cancel_orders', clientParams);\n\n    return {\n      tx,\n      signature: clientParams.signature,\n      required_unfilled_amount: clientParams.requiredUnfilledAmount\n        ? toIntegerString(clientParams.requiredUnfilledAmount)\n        : undefined,\n    };\n  }\n\n  /**\n   * Builds server payload for the `cancel_product_orders` execute action.\n   * @param clientParams Client CancelProductOrders params.\n   * @returns `cancel_product_orders` payload\n   */\n  async buildCancelProductOrdersPayload(\n    clientParams: EngineExecuteRequestParamsByType['cancel_product_orders'],\n  ): Promise<EngineServerExecuteRequestByType['cancel_product_orders']> {\n    const nonce = this.getOrderNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('cancel_product_orders', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'cancel_product_orders',\n      paramsWithNonce,\n    );\n\n    return {\n      tx,\n      signature,\n    };\n  }\n\n  /**\n   * Builds server payload for the `link_signer` execute action.\n   *\n   * @param clientParams Client LinkSigner params.\n   * @returns `link_signer` payload\n   */\n  async buildLinkSignerPayload(\n    clientParams: EngineExecuteRequestParamsByType['link_signer'],\n  ): Promise<EngineServerExecuteRequestByType['link_signer']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('link_signer', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'link_signer',\n      paramsWithNonce,\n    );\n\n    return {\n      tx,\n      signature,\n    };\n  }\n\n  /**\n   * Builds server payload for the `transfer_quote` execute action.\n   *\n   * @param clientParams Client TransferQuote params.\n   * @returns `transfer_quote` payload\n   */\n  async buildTransferQuotePayload(\n    clientParams: EngineExecuteRequestParamsByType['transfer_quote'],\n  ): Promise<EngineServerExecuteRequestByType['transfer_quote']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('transfer_quote', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'transfer_quote',\n      paramsWithNonce,\n    );\n\n    return {\n      tx,\n      signature,\n    };\n  }\n\n  /**\n   * Builds server payload for the `mint_nlp` execute action.\n   * @param clientParams Client MintNlp params.\n   * @returns `mint_nlp` payload\n   */\n  async buildMintNlpPayload(\n    clientParams: EngineExecuteRequestParamsByType['mint_nlp'],\n  ): Promise<EngineServerExecuteRequestByType['mint_nlp']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('mint_nlp', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'mint_nlp',\n      paramsWithNonce,\n    );\n\n    return {\n      signature,\n      tx,\n      spot_leverage: clientParams.spotLeverage ?? null,\n    };\n  }\n\n  /**\n   * Builds server payload for the `burn_nlp` execute action.\n   * @param clientParams Client BurnNlp params.\n   * @returns `burn_nlp` payload\n   */\n  async buildBurnNlpPayload(\n    clientParams: EngineExecuteRequestParamsByType['burn_nlp'],\n  ): Promise<EngineServerExecuteRequestByType['burn_nlp']> {\n    const nonce = await this.getTxNonceIfNeeded(clientParams);\n    const paramsWithNonce = { ...clientParams, nonce };\n\n    const tx = getNadoEIP712Values('burn_nlp', paramsWithNonce);\n    const signature = await this.getSignatureIfNeeded(\n      'burn_nlp',\n      paramsWithNonce,\n    );\n\n    return {\n      signature,\n      tx,\n    };\n  }\n\n  protected async getSignatureIfNeeded<T extends SignableRequestType>(\n    requestType: T,\n    paramsWithNonce: SignatureParams & SignableRequestTypeToParams[T],\n  ) {\n    if ('signature' in paramsWithNonce) {\n      return paramsWithNonce.signature;\n    }\n\n    return await this.engineClient.sign(\n      requestType,\n      paramsWithNonce.verifyingAddr,\n      paramsWithNonce.chainId,\n      paramsWithNonce,\n    );\n  }\n\n  protected async getTxNonceIfNeeded(\n    params: WithBaseEngineExecuteParams<{ subaccountOwner: string }>,\n  ) {\n    if (params.nonce) {\n      return params.nonce;\n    }\n    return await this.engineClient.getTxNonce(params.subaccountOwner);\n  }\n\n  protected getOrderNonceIfNeeded(\n    params: WithBaseEngineExecuteParams<unknown>,\n  ) {\n    if (params.nonce) {\n      return params.nonce;\n    }\n    return getOrderNonce();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/EngineExecuteClient.cjs

@@ -23,6 +23,7 @@ __export(EngineExecuteClient_exports, {
   EngineExecuteClient: () => EngineExecuteClient
 });
 module.exports = __toCommonJS(EngineExecuteClient_exports);
+var import_shared = require("@nadohq/shared");
 var import_EngineBaseClient = require("./EngineBaseClient.cjs");
 var import_EngineExecuteBuilder = require("./EngineExecuteBuilder.cjs");
 var EngineExecuteClient = class extends import_EngineBaseClient.EngineBaseClient {
@@ -69,7 +70,9 @@ var EngineExecuteClient = class extends import_EngineBaseClient.EngineBaseClient
     return this.execute("cancel_and_place", {
       cancel_tx: cancelOrdersPayload.tx,
       cancel_signature: cancelOrdersPayload.signature,
-      place_order: placeOrderPayload.payload
+      place_order: placeOrderPayload.payload,
+      required_unfilled_amount: params.requiredUnfilledAmount ? (0, import_shared.toIntegerString)(params.requiredUnfilledAmount) : void 0,
+      place_requires_unfilled: params.placeRequiresUnfilled
     });
   }
   async cancelProductOrders(params) {

package/dist/EngineExecuteClient.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/EngineExecuteClient.ts"],"sourcesContent":["import { EngineBaseClient, EngineClientOpts } from './EngineBaseClient';\nimport { EngineExecuteBuilder } from './EngineExecuteBuilder';\nimport {\n  EngineExecuteRequestParamsByType,\n  EnginePlaceOrderResult,\n} from './types';\n\nexport class EngineExecuteClient extends EngineBaseClient {\n  readonly payloadBuilder: EngineExecuteBuilder;\n\n  constructor(opts: EngineClientOpts) {\n    super(opts);\n    this.payloadBuilder = new EngineExecuteBuilder(this);\n  }\n\n  async liquidateSubaccount(\n    params: EngineExecuteRequestParamsByType['liquidate_subaccount'],\n  ) {\n    return this.execute(\n      'liquidate_subaccount',\n      await this.payloadBuilder.buildLiquidateSubaccountPayload(params),\n    );\n  }\n\n  async withdrawCollateral(\n    params: EngineExecuteRequestParamsByType['withdraw_collateral'],\n  ) {\n    return this.execute(\n      'withdraw_collateral',\n      await this.payloadBuilder.buildWithdrawCollateralPayload(params),\n    );\n  }\n\n  async placeOrder(\n    params: EngineExecuteRequestParamsByType['place_order'],\n  ): Promise<EnginePlaceOrderResult> {\n    const placeOrderPayload =\n      await this.payloadBuilder.buildPlaceOrderPayload(params);\n    return {\n      ...(await this.execute('place_order', placeOrderPayload.payload)),\n      orderParams: placeOrderPayload.orderParams,\n    };\n  }\n\n  async placeOrders(params: EngineExecuteRequestParamsByType['place_orders']) {\n    return this.execute(\n      'place_orders',\n      await this.payloadBuilder.buildPlaceOrdersPayload(params),\n    );\n  }\n\n  async cancelOrders(\n    params: EngineExecuteRequestParamsByType['cancel_orders'],\n  ) {\n    return this.execute(\n      'cancel_orders',\n      await this.payloadBuilder.buildCancelOrdersPayload(params),\n    );\n  }\n\n  async cancelAndPlace(\n    params: EngineExecuteRequestParamsByType['cancel_and_place'],\n  ) {\n    const cancelOrdersPayload =\n      await this.payloadBuilder.buildCancelOrdersPayload(params.cancelOrders);\n    const placeOrderPayload = await this.payloadBuilder.buildPlaceOrderPayload(\n      params.placeOrder,\n    );\n    return this.execute('cancel_and_place', {\n      cancel_tx: cancelOrdersPayload.tx,\n      cancel_signature: cancelOrdersPayload.signature,\n      place_order: placeOrderPayload.payload,\n    });\n  }\n\n  async cancelProductOrders(\n    params: EngineExecuteRequestParamsByType['cancel_product_orders'],\n  ) {\n    return this.execute(\n      'cancel_product_orders',\n      await this.payloadBuilder.buildCancelProductOrdersPayload(params),\n    );\n  }\n\n  async linkSigner(params: EngineExecuteRequestParamsByType['link_signer']) {\n    return this.execute(\n      'link_signer',\n      await this.payloadBuilder.buildLinkSignerPayload(params),\n    );\n  }\n\n  async transferQuote(\n    params: EngineExecuteRequestParamsByType['transfer_quote'],\n  ) {\n    return this.execute(\n      'transfer_quote',\n      await this.payloadBuilder.buildTransferQuotePayload(params),\n    );\n  }\n\n  async mintNlp(params: EngineExecuteRequestParamsByType['mint_nlp']) {\n    return this.execute(\n      'mint_nlp',\n      await this.payloadBuilder.buildMintNlpPayload(params),\n    );\n  }\n\n  async burnNlp(params: EngineExecuteRequestParamsByType['burn_nlp']) {\n    return this.execute(\n      'burn_nlp',\n      await this.payloadBuilder.buildBurnNlpPayload(params),\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8BAAmD;AACnD,kCAAqC;AAM9B,IAAM,sBAAN,cAAkC,yCAAiB;AAAA,EAGxD,YAAY,MAAwB;AAClC,UAAM,IAAI;AACV,SAAK,iBAAiB,IAAI,iDAAqB,IAAI;AAAA,EACrD;AAAA,EAEA,MAAM,oBACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,gCAAgC,MAAM;AAAA,IAClE;AAAA,EACF;AAAA,EAEA,MAAM,mBACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,+BAA+B,MAAM;AAAA,IACjE;AAAA,EACF;AAAA,EAEA,MAAM,WACJ,QACiC;AACjC,UAAM,oBACJ,MAAM,KAAK,eAAe,uBAAuB,MAAM;AACzD,WAAO;AAAA,MACL,GAAI,MAAM,KAAK,QAAQ,eAAe,kBAAkB,OAAO;AAAA,MAC/D,aAAa,kBAAkB;AAAA,IACjC;AAAA,EACF;AAAA,EAEA,MAAM,YAAY,QAA0D;AAC1E,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,wBAAwB,MAAM;AAAA,IAC1D;AAAA,EACF;AAAA,EAEA,MAAM,aACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,yBAAyB,MAAM;AAAA,IAC3D;AAAA,EACF;AAAA,EAEA,MAAM,eACJ,QACA;AACA,UAAM,sBACJ,MAAM,KAAK,eAAe,yBAAyB,OAAO,YAAY;AACxE,UAAM,oBAAoB,MAAM,KAAK,eAAe;AAAA,MAClD,OAAO;AAAA,IACT;AACA,WAAO,KAAK,QAAQ,oBAAoB;AAAA,MACtC,WAAW,oBAAoB;AAAA,MAC/B,kBAAkB,oBAAoB;AAAA,MACtC,aAAa,kBAAkB;AAAA,IACjC,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,oBACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,gCAAgC,MAAM;AAAA,IAClE;AAAA,EACF;AAAA,EAEA,MAAM,WAAW,QAAyD;AACxE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,uBAAuB,MAAM;AAAA,IACzD;AAAA,EACF;AAAA,EAEA,MAAM,cACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,0BAA0B,MAAM;AAAA,IAC5D;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,QAAsD;AAClE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,oBAAoB,MAAM;AAAA,IACtD;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,QAAsD;AAClE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,oBAAoB,MAAM;AAAA,IACtD;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/EngineExecuteClient.ts"],"sourcesContent":["import { toIntegerString } from '@nadohq/shared';\nimport { EngineBaseClient, EngineClientOpts } from './EngineBaseClient';\nimport { EngineExecuteBuilder } from './EngineExecuteBuilder';\nimport {\n  EngineExecuteRequestParamsByType,\n  EnginePlaceOrderResult,\n} from './types';\n\nexport class EngineExecuteClient extends EngineBaseClient {\n  readonly payloadBuilder: EngineExecuteBuilder;\n\n  constructor(opts: EngineClientOpts) {\n    super(opts);\n    this.payloadBuilder = new EngineExecuteBuilder(this);\n  }\n\n  async liquidateSubaccount(\n    params: EngineExecuteRequestParamsByType['liquidate_subaccount'],\n  ) {\n    return this.execute(\n      'liquidate_subaccount',\n      await this.payloadBuilder.buildLiquidateSubaccountPayload(params),\n    );\n  }\n\n  async withdrawCollateral(\n    params: EngineExecuteRequestParamsByType['withdraw_collateral'],\n  ) {\n    return this.execute(\n      'withdraw_collateral',\n      await this.payloadBuilder.buildWithdrawCollateralPayload(params),\n    );\n  }\n\n  async placeOrder(\n    params: EngineExecuteRequestParamsByType['place_order'],\n  ): Promise<EnginePlaceOrderResult> {\n    const placeOrderPayload =\n      await this.payloadBuilder.buildPlaceOrderPayload(params);\n    return {\n      ...(await this.execute('place_order', placeOrderPayload.payload)),\n      orderParams: placeOrderPayload.orderParams,\n    };\n  }\n\n  async placeOrders(params: EngineExecuteRequestParamsByType['place_orders']) {\n    return this.execute(\n      'place_orders',\n      await this.payloadBuilder.buildPlaceOrdersPayload(params),\n    );\n  }\n\n  async cancelOrders(\n    params: EngineExecuteRequestParamsByType['cancel_orders'],\n  ) {\n    return this.execute(\n      'cancel_orders',\n      await this.payloadBuilder.buildCancelOrdersPayload(params),\n    );\n  }\n\n  async cancelAndPlace(\n    params: EngineExecuteRequestParamsByType['cancel_and_place'],\n  ) {\n    const cancelOrdersPayload =\n      await this.payloadBuilder.buildCancelOrdersPayload(params.cancelOrders);\n    const placeOrderPayload = await this.payloadBuilder.buildPlaceOrderPayload(\n      params.placeOrder,\n    );\n    return this.execute('cancel_and_place', {\n      cancel_tx: cancelOrdersPayload.tx,\n      cancel_signature: cancelOrdersPayload.signature,\n      place_order: placeOrderPayload.payload,\n      required_unfilled_amount: params.requiredUnfilledAmount\n        ? toIntegerString(params.requiredUnfilledAmount)\n        : undefined,\n      place_requires_unfilled: params.placeRequiresUnfilled,\n    });\n  }\n\n  async cancelProductOrders(\n    params: EngineExecuteRequestParamsByType['cancel_product_orders'],\n  ) {\n    return this.execute(\n      'cancel_product_orders',\n      await this.payloadBuilder.buildCancelProductOrdersPayload(params),\n    );\n  }\n\n  async linkSigner(params: EngineExecuteRequestParamsByType['link_signer']) {\n    return this.execute(\n      'link_signer',\n      await this.payloadBuilder.buildLinkSignerPayload(params),\n    );\n  }\n\n  async transferQuote(\n    params: EngineExecuteRequestParamsByType['transfer_quote'],\n  ) {\n    return this.execute(\n      'transfer_quote',\n      await this.payloadBuilder.buildTransferQuotePayload(params),\n    );\n  }\n\n  async mintNlp(params: EngineExecuteRequestParamsByType['mint_nlp']) {\n    return this.execute(\n      'mint_nlp',\n      await this.payloadBuilder.buildMintNlpPayload(params),\n    );\n  }\n\n  async burnNlp(params: EngineExecuteRequestParamsByType['burn_nlp']) {\n    return this.execute(\n      'burn_nlp',\n      await this.payloadBuilder.buildBurnNlpPayload(params),\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAAgC;AAChC,8BAAmD;AACnD,kCAAqC;AAM9B,IAAM,sBAAN,cAAkC,yCAAiB;AAAA,EAGxD,YAAY,MAAwB;AAClC,UAAM,IAAI;AACV,SAAK,iBAAiB,IAAI,iDAAqB,IAAI;AAAA,EACrD;AAAA,EAEA,MAAM,oBACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,gCAAgC,MAAM;AAAA,IAClE;AAAA,EACF;AAAA,EAEA,MAAM,mBACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,+BAA+B,MAAM;AAAA,IACjE;AAAA,EACF;AAAA,EAEA,MAAM,WACJ,QACiC;AACjC,UAAM,oBACJ,MAAM,KAAK,eAAe,uBAAuB,MAAM;AACzD,WAAO;AAAA,MACL,GAAI,MAAM,KAAK,QAAQ,eAAe,kBAAkB,OAAO;AAAA,MAC/D,aAAa,kBAAkB;AAAA,IACjC;AAAA,EACF;AAAA,EAEA,MAAM,YAAY,QAA0D;AAC1E,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,wBAAwB,MAAM;AAAA,IAC1D;AAAA,EACF;AAAA,EAEA,MAAM,aACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,yBAAyB,MAAM;AAAA,IAC3D;AAAA,EACF;AAAA,EAEA,MAAM,eACJ,QACA;AACA,UAAM,sBACJ,MAAM,KAAK,eAAe,yBAAyB,OAAO,YAAY;AACxE,UAAM,oBAAoB,MAAM,KAAK,eAAe;AAAA,MAClD,OAAO;AAAA,IACT;AACA,WAAO,KAAK,QAAQ,oBAAoB;AAAA,MACtC,WAAW,oBAAoB;AAAA,MAC/B,kBAAkB,oBAAoB;AAAA,MACtC,aAAa,kBAAkB;AAAA,MAC/B,0BAA0B,OAAO,6BAC7B,+BAAgB,OAAO,sBAAsB,IAC7C;AAAA,MACJ,yBAAyB,OAAO;AAAA,IAClC,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,oBACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,gCAAgC,MAAM;AAAA,IAClE;AAAA,EACF;AAAA,EAEA,MAAM,WAAW,QAAyD;AACxE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,uBAAuB,MAAM;AAAA,IACzD;AAAA,EACF;AAAA,EAEA,MAAM,cACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,0BAA0B,MAAM;AAAA,IAC5D;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,QAAsD;AAClE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,oBAAoB,MAAM;AAAA,IACtD;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,QAAsD;AAClE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,oBAAoB,MAAM;AAAA,IACtD;AAAA,EACF;AACF;","names":[]}

package/dist/EngineExecuteClient.d.cts

@@ -3,11 +3,11 @@ import { EngineServerExecuteSuccessResult } from './types/serverExecuteTypes.cjs
 import { EngineBaseClient, EngineClientOpts } from './EngineBaseClient.cjs';
 import { EngineExecuteBuilder } from './EngineExecuteBuilder.cjs';
 import '@nadohq/shared';
+import 'bignumber.js';
 import './types/serverQueryTypes.cjs';
 import './types/serverQueryModelTypes.cjs';
 import 'axios';
 import './types/clientQueryTypes.cjs';
-import 'bignumber.js';
 
 declare class EngineExecuteClient extends EngineBaseClient {
     readonly payloadBuilder: EngineExecuteBuilder;

package/dist/EngineExecuteClient.d.ts

@@ -3,11 +3,11 @@ import { EngineServerExecuteSuccessResult } from './types/serverExecuteTypes.js'
 import { EngineBaseClient, EngineClientOpts } from './EngineBaseClient.js';
 import { EngineExecuteBuilder } from './EngineExecuteBuilder.js';
 import '@nadohq/shared';
+import 'bignumber.js';
 import './types/serverQueryTypes.js';
 import './types/serverQueryModelTypes.js';
 import 'axios';
 import './types/clientQueryTypes.js';
-import 'bignumber.js';
 
 declare class EngineExecuteClient extends EngineBaseClient {
     readonly payloadBuilder: EngineExecuteBuilder;

package/dist/EngineExecuteClient.js

@@ -1,4 +1,5 @@
 // src/EngineExecuteClient.ts
+import { toIntegerString } from "@nadohq/shared";
 import { EngineBaseClient } from "./EngineBaseClient.js";
 import { EngineExecuteBuilder } from "./EngineExecuteBuilder.js";
 var EngineExecuteClient = class extends EngineBaseClient {
@@ -45,7 +46,9 @@ var EngineExecuteClient = class extends EngineBaseClient {
     return this.execute("cancel_and_place", {
       cancel_tx: cancelOrdersPayload.tx,
       cancel_signature: cancelOrdersPayload.signature,
-      place_order: placeOrderPayload.payload
+      place_order: placeOrderPayload.payload,
+      required_unfilled_amount: params.requiredUnfilledAmount ? toIntegerString(params.requiredUnfilledAmount) : void 0,
+      place_requires_unfilled: params.placeRequiresUnfilled
     });
   }
   async cancelProductOrders(params) {

package/dist/EngineExecuteClient.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/EngineExecuteClient.ts"],"sourcesContent":["import { EngineBaseClient, EngineClientOpts } from './EngineBaseClient';\nimport { EngineExecuteBuilder } from './EngineExecuteBuilder';\nimport {\n  EngineExecuteRequestParamsByType,\n  EnginePlaceOrderResult,\n} from './types';\n\nexport class EngineExecuteClient extends EngineBaseClient {\n  readonly payloadBuilder: EngineExecuteBuilder;\n\n  constructor(opts: EngineClientOpts) {\n    super(opts);\n    this.payloadBuilder = new EngineExecuteBuilder(this);\n  }\n\n  async liquidateSubaccount(\n    params: EngineExecuteRequestParamsByType['liquidate_subaccount'],\n  ) {\n    return this.execute(\n      'liquidate_subaccount',\n      await this.payloadBuilder.buildLiquidateSubaccountPayload(params),\n    );\n  }\n\n  async withdrawCollateral(\n    params: EngineExecuteRequestParamsByType['withdraw_collateral'],\n  ) {\n    return this.execute(\n      'withdraw_collateral',\n      await this.payloadBuilder.buildWithdrawCollateralPayload(params),\n    );\n  }\n\n  async placeOrder(\n    params: EngineExecuteRequestParamsByType['place_order'],\n  ): Promise<EnginePlaceOrderResult> {\n    const placeOrderPayload =\n      await this.payloadBuilder.buildPlaceOrderPayload(params);\n    return {\n      ...(await this.execute('place_order', placeOrderPayload.payload)),\n      orderParams: placeOrderPayload.orderParams,\n    };\n  }\n\n  async placeOrders(params: EngineExecuteRequestParamsByType['place_orders']) {\n    return this.execute(\n      'place_orders',\n      await this.payloadBuilder.buildPlaceOrdersPayload(params),\n    );\n  }\n\n  async cancelOrders(\n    params: EngineExecuteRequestParamsByType['cancel_orders'],\n  ) {\n    return this.execute(\n      'cancel_orders',\n      await this.payloadBuilder.buildCancelOrdersPayload(params),\n    );\n  }\n\n  async cancelAndPlace(\n    params: EngineExecuteRequestParamsByType['cancel_and_place'],\n  ) {\n    const cancelOrdersPayload =\n      await this.payloadBuilder.buildCancelOrdersPayload(params.cancelOrders);\n    const placeOrderPayload = await this.payloadBuilder.buildPlaceOrderPayload(\n      params.placeOrder,\n    );\n    return this.execute('cancel_and_place', {\n      cancel_tx: cancelOrdersPayload.tx,\n      cancel_signature: cancelOrdersPayload.signature,\n      place_order: placeOrderPayload.payload,\n    });\n  }\n\n  async cancelProductOrders(\n    params: EngineExecuteRequestParamsByType['cancel_product_orders'],\n  ) {\n    return this.execute(\n      'cancel_product_orders',\n      await this.payloadBuilder.buildCancelProductOrdersPayload(params),\n    );\n  }\n\n  async linkSigner(params: EngineExecuteRequestParamsByType['link_signer']) {\n    return this.execute(\n      'link_signer',\n      await this.payloadBuilder.buildLinkSignerPayload(params),\n    );\n  }\n\n  async transferQuote(\n    params: EngineExecuteRequestParamsByType['transfer_quote'],\n  ) {\n    return this.execute(\n      'transfer_quote',\n      await this.payloadBuilder.buildTransferQuotePayload(params),\n    );\n  }\n\n  async mintNlp(params: EngineExecuteRequestParamsByType['mint_nlp']) {\n    return this.execute(\n      'mint_nlp',\n      await this.payloadBuilder.buildMintNlpPayload(params),\n    );\n  }\n\n  async burnNlp(params: EngineExecuteRequestParamsByType['burn_nlp']) {\n    return this.execute(\n      'burn_nlp',\n      await this.payloadBuilder.buildBurnNlpPayload(params),\n    );\n  }\n}\n"],"mappings":";AAAA,SAAS,wBAA0C;AACnD,SAAS,4BAA4B;AAM9B,IAAM,sBAAN,cAAkC,iBAAiB;AAAA,EAGxD,YAAY,MAAwB;AAClC,UAAM,IAAI;AACV,SAAK,iBAAiB,IAAI,qBAAqB,IAAI;AAAA,EACrD;AAAA,EAEA,MAAM,oBACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,gCAAgC,MAAM;AAAA,IAClE;AAAA,EACF;AAAA,EAEA,MAAM,mBACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,+BAA+B,MAAM;AAAA,IACjE;AAAA,EACF;AAAA,EAEA,MAAM,WACJ,QACiC;AACjC,UAAM,oBACJ,MAAM,KAAK,eAAe,uBAAuB,MAAM;AACzD,WAAO;AAAA,MACL,GAAI,MAAM,KAAK,QAAQ,eAAe,kBAAkB,OAAO;AAAA,MAC/D,aAAa,kBAAkB;AAAA,IACjC;AAAA,EACF;AAAA,EAEA,MAAM,YAAY,QAA0D;AAC1E,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,wBAAwB,MAAM;AAAA,IAC1D;AAAA,EACF;AAAA,EAEA,MAAM,aACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,yBAAyB,MAAM;AAAA,IAC3D;AAAA,EACF;AAAA,EAEA,MAAM,eACJ,QACA;AACA,UAAM,sBACJ,MAAM,KAAK,eAAe,yBAAyB,OAAO,YAAY;AACxE,UAAM,oBAAoB,MAAM,KAAK,eAAe;AAAA,MAClD,OAAO;AAAA,IACT;AACA,WAAO,KAAK,QAAQ,oBAAoB;AAAA,MACtC,WAAW,oBAAoB;AAAA,MAC/B,kBAAkB,oBAAoB;AAAA,MACtC,aAAa,kBAAkB;AAAA,IACjC,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,oBACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,gCAAgC,MAAM;AAAA,IAClE;AAAA,EACF;AAAA,EAEA,MAAM,WAAW,QAAyD;AACxE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,uBAAuB,MAAM;AAAA,IACzD;AAAA,EACF;AAAA,EAEA,MAAM,cACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,0BAA0B,MAAM;AAAA,IAC5D;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,QAAsD;AAClE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,oBAAoB,MAAM;AAAA,IACtD;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,QAAsD;AAClE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,oBAAoB,MAAM;AAAA,IACtD;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/EngineExecuteClient.ts"],"sourcesContent":["import { toIntegerString } from '@nadohq/shared';\nimport { EngineBaseClient, EngineClientOpts } from './EngineBaseClient';\nimport { EngineExecuteBuilder } from './EngineExecuteBuilder';\nimport {\n  EngineExecuteRequestParamsByType,\n  EnginePlaceOrderResult,\n} from './types';\n\nexport class EngineExecuteClient extends EngineBaseClient {\n  readonly payloadBuilder: EngineExecuteBuilder;\n\n  constructor(opts: EngineClientOpts) {\n    super(opts);\n    this.payloadBuilder = new EngineExecuteBuilder(this);\n  }\n\n  async liquidateSubaccount(\n    params: EngineExecuteRequestParamsByType['liquidate_subaccount'],\n  ) {\n    return this.execute(\n      'liquidate_subaccount',\n      await this.payloadBuilder.buildLiquidateSubaccountPayload(params),\n    );\n  }\n\n  async withdrawCollateral(\n    params: EngineExecuteRequestParamsByType['withdraw_collateral'],\n  ) {\n    return this.execute(\n      'withdraw_collateral',\n      await this.payloadBuilder.buildWithdrawCollateralPayload(params),\n    );\n  }\n\n  async placeOrder(\n    params: EngineExecuteRequestParamsByType['place_order'],\n  ): Promise<EnginePlaceOrderResult> {\n    const placeOrderPayload =\n      await this.payloadBuilder.buildPlaceOrderPayload(params);\n    return {\n      ...(await this.execute('place_order', placeOrderPayload.payload)),\n      orderParams: placeOrderPayload.orderParams,\n    };\n  }\n\n  async placeOrders(params: EngineExecuteRequestParamsByType['place_orders']) {\n    return this.execute(\n      'place_orders',\n      await this.payloadBuilder.buildPlaceOrdersPayload(params),\n    );\n  }\n\n  async cancelOrders(\n    params: EngineExecuteRequestParamsByType['cancel_orders'],\n  ) {\n    return this.execute(\n      'cancel_orders',\n      await this.payloadBuilder.buildCancelOrdersPayload(params),\n    );\n  }\n\n  async cancelAndPlace(\n    params: EngineExecuteRequestParamsByType['cancel_and_place'],\n  ) {\n    const cancelOrdersPayload =\n      await this.payloadBuilder.buildCancelOrdersPayload(params.cancelOrders);\n    const placeOrderPayload = await this.payloadBuilder.buildPlaceOrderPayload(\n      params.placeOrder,\n    );\n    return this.execute('cancel_and_place', {\n      cancel_tx: cancelOrdersPayload.tx,\n      cancel_signature: cancelOrdersPayload.signature,\n      place_order: placeOrderPayload.payload,\n      required_unfilled_amount: params.requiredUnfilledAmount\n        ? toIntegerString(params.requiredUnfilledAmount)\n        : undefined,\n      place_requires_unfilled: params.placeRequiresUnfilled,\n    });\n  }\n\n  async cancelProductOrders(\n    params: EngineExecuteRequestParamsByType['cancel_product_orders'],\n  ) {\n    return this.execute(\n      'cancel_product_orders',\n      await this.payloadBuilder.buildCancelProductOrdersPayload(params),\n    );\n  }\n\n  async linkSigner(params: EngineExecuteRequestParamsByType['link_signer']) {\n    return this.execute(\n      'link_signer',\n      await this.payloadBuilder.buildLinkSignerPayload(params),\n    );\n  }\n\n  async transferQuote(\n    params: EngineExecuteRequestParamsByType['transfer_quote'],\n  ) {\n    return this.execute(\n      'transfer_quote',\n      await this.payloadBuilder.buildTransferQuotePayload(params),\n    );\n  }\n\n  async mintNlp(params: EngineExecuteRequestParamsByType['mint_nlp']) {\n    return this.execute(\n      'mint_nlp',\n      await this.payloadBuilder.buildMintNlpPayload(params),\n    );\n  }\n\n  async burnNlp(params: EngineExecuteRequestParamsByType['burn_nlp']) {\n    return this.execute(\n      'burn_nlp',\n      await this.payloadBuilder.buildBurnNlpPayload(params),\n    );\n  }\n}\n"],"mappings":";AAAA,SAAS,uBAAuB;AAChC,SAAS,wBAA0C;AACnD,SAAS,4BAA4B;AAM9B,IAAM,sBAAN,cAAkC,iBAAiB;AAAA,EAGxD,YAAY,MAAwB;AAClC,UAAM,IAAI;AACV,SAAK,iBAAiB,IAAI,qBAAqB,IAAI;AAAA,EACrD;AAAA,EAEA,MAAM,oBACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,gCAAgC,MAAM;AAAA,IAClE;AAAA,EACF;AAAA,EAEA,MAAM,mBACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,+BAA+B,MAAM;AAAA,IACjE;AAAA,EACF;AAAA,EAEA,MAAM,WACJ,QACiC;AACjC,UAAM,oBACJ,MAAM,KAAK,eAAe,uBAAuB,MAAM;AACzD,WAAO;AAAA,MACL,GAAI,MAAM,KAAK,QAAQ,eAAe,kBAAkB,OAAO;AAAA,MAC/D,aAAa,kBAAkB;AAAA,IACjC;AAAA,EACF;AAAA,EAEA,MAAM,YAAY,QAA0D;AAC1E,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,wBAAwB,MAAM;AAAA,IAC1D;AAAA,EACF;AAAA,EAEA,MAAM,aACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,yBAAyB,MAAM;AAAA,IAC3D;AAAA,EACF;AAAA,EAEA,MAAM,eACJ,QACA;AACA,UAAM,sBACJ,MAAM,KAAK,eAAe,yBAAyB,OAAO,YAAY;AACxE,UAAM,oBAAoB,MAAM,KAAK,eAAe;AAAA,MAClD,OAAO;AAAA,IACT;AACA,WAAO,KAAK,QAAQ,oBAAoB;AAAA,MACtC,WAAW,oBAAoB;AAAA,MAC/B,kBAAkB,oBAAoB;AAAA,MACtC,aAAa,kBAAkB;AAAA,MAC/B,0BAA0B,OAAO,yBAC7B,gBAAgB,OAAO,sBAAsB,IAC7C;AAAA,MACJ,yBAAyB,OAAO;AAAA,IAClC,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,oBACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,gCAAgC,MAAM;AAAA,IAClE;AAAA,EACF;AAAA,EAEA,MAAM,WAAW,QAAyD;AACxE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,uBAAuB,MAAM;AAAA,IACzD;AAAA,EACF;AAAA,EAEA,MAAM,cACJ,QACA;AACA,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,0BAA0B,MAAM;AAAA,IAC5D;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,QAAsD;AAClE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,oBAAoB,MAAM;AAAA,IACtD;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,QAAsD;AAClE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,MAAM,KAAK,eAAe,oBAAoB,MAAM;AAAA,IACtD;AAAA,EACF;AACF;","names":[]}

package/dist/types/clientExecuteTypes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/clientExecuteTypes.ts"],"sourcesContent":["import {\n  EIP712BurnNlpParams,\n  EIP712CancelOrdersParams,\n  EIP712CancelProductOrdersParams,\n  EIP712LinkSignerParams,\n  EIP712LiquidateSubaccountParams,\n  EIP712MintNlpParams,\n  EIP712OrderParams,\n  EIP712TransferQuoteParams,\n  EIP712WithdrawCollateralParams,\n} from '@nadohq/shared';\nimport { EngineServerExecuteSuccessResult } from './serverExecuteTypes';\n\n/**\n * Either verifying address or signature must be provided;\n * If signature is not provided, the verifying address with the engine signer will be used to sign.\n */\nexport type SignatureParams =\n  | {\n      // Endpoint address for all executes except order placement\n      verifyingAddr: string;\n      chainId: number;\n    }\n  | {\n      signature: string;\n    };\n\ntype WithoutNonce<T extends { nonce: unknown }> = Omit<T, 'nonce'>;\n\ntype WithSpotLeverage<T> = T & {\n  spotLeverage?: boolean;\n};\n\nexport type WithSignature<T> = T & {\n  signature: string;\n};\n\n// Params associated with all engine executes\nexport type WithBaseEngineExecuteParams<T> = SignatureParams &\n  Omit<T, 'nonce'> & {\n    nonce?: string;\n  };\n\nexport type EngineOrderParams = WithoutNonce<EIP712OrderParams>;\n\nexport type EnginePlaceOrderParams = WithBaseEngineExecuteParams<{\n  id?: number;\n  productId: number;\n  order: EngineOrderParams;\n  // If not given, engine defaults to true (leverage/borrow enabled)\n  spotLeverage?: boolean;\n  // For isolated orders, this specifies whether margin can be borrowed (i.e. whether the cross account can have a negative USDT balance)\n  borrowMargin?: boolean;\n}>;\n\nexport type EngineLiquidateSubaccountParams =\n  WithBaseEngineExecuteParams<EIP712LiquidateSubaccountParams>;\n\nexport type EngineWithdrawCollateralParams = WithBaseEngineExecuteParams<\n  WithSpotLeverage<EIP712WithdrawCollateralParams>\n>;\n\nexport type EngineCancelOrdersParams =\n  WithBaseEngineExecuteParams<EIP712CancelOrdersParams>;\n\nexport type EngineCancelAndPlaceParams = {\n  cancelOrders: EngineCancelOrdersParams;\n  placeOrder: EnginePlaceOrderParams;\n};\n\nexport type EngineCancelProductOrdersParams =\n  WithBaseEngineExecuteParams<EIP712CancelProductOrdersParams>;\n\nexport type EngineLinkSignerParams =\n  WithBaseEngineExecuteParams<EIP712LinkSignerParams>;\n\nexport type EngineTransferQuoteParams =\n  WithBaseEngineExecuteParams<EIP712TransferQuoteParams>;\n\nexport type EngineMintNlpParams = WithBaseEngineExecuteParams<\n  WithSpotLeverage<EIP712MintNlpParams>\n>;\n\nexport type EngineBurnNlpParams =\n  WithBaseEngineExecuteParams<EIP712BurnNlpParams>;\n\nexport type EnginePlaceOrdersParams = {\n  orders: EnginePlaceOrderParams[];\n  /**\n   * If `true`, aborts the batch after the first failed order; if `false`, remaining orders continue to execute.\n   * If not provided, the default value is `false`.\n   */\n  stopOnFailure?: boolean;\n};\n\nexport interface EngineExecuteRequestParamsByType {\n  burn_nlp: EngineBurnNlpParams;\n  cancel_and_place: EngineCancelAndPlaceParams;\n  cancel_orders: EngineCancelOrdersParams;\n  cancel_product_orders: EngineCancelProductOrdersParams;\n  link_signer: EngineLinkSignerParams;\n  liquidate_subaccount: EngineLiquidateSubaccountParams;\n  mint_nlp: EngineMintNlpParams;\n  place_order: EnginePlaceOrderParams;\n  place_orders: EnginePlaceOrdersParams;\n  transfer_quote: EngineTransferQuoteParams;\n  withdraw_collateral: EngineWithdrawCollateralParams;\n}\n\nexport type EnginePlaceOrderResult =\n  EngineServerExecuteSuccessResult<'place_order'> & {\n    orderParams: EIP712OrderParams;\n  };\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/types/clientExecuteTypes.ts"],"sourcesContent":["import {\n  EIP712BurnNlpParams,\n  EIP712CancelOrdersParams,\n  EIP712CancelProductOrdersParams,\n  EIP712LinkSignerParams,\n  EIP712LiquidateSubaccountParams,\n  EIP712MintNlpParams,\n  EIP712OrderParams,\n  EIP712TransferQuoteParams,\n  EIP712WithdrawCollateralParams,\n} from '@nadohq/shared';\nimport BigNumber from 'bignumber.js';\nimport { EngineServerExecuteSuccessResult } from './serverExecuteTypes';\n\n/**\n * Either verifying address or signature must be provided;\n * If signature is not provided, the verifying address with the engine signer will be used to sign.\n */\nexport type SignatureParams =\n  | {\n      // Endpoint address for all executes except order placement\n      verifyingAddr: string;\n      chainId: number;\n    }\n  | {\n      signature: string;\n    };\n\ntype WithoutNonce<T extends { nonce: unknown }> = Omit<T, 'nonce'>;\n\ntype WithSpotLeverage<T> = T & {\n  spotLeverage?: boolean;\n};\n\nexport type WithSignature<T> = T & {\n  signature: string;\n};\n\n// Params associated with all engine executes\nexport type WithBaseEngineExecuteParams<T> = SignatureParams &\n  Omit<T, 'nonce'> & {\n    nonce?: string;\n  };\n\nexport type EngineOrderParams = WithoutNonce<EIP712OrderParams>;\n\nexport type EnginePlaceOrderParams = WithBaseEngineExecuteParams<{\n  id?: number;\n  productId: number;\n  order: EngineOrderParams;\n  // If not given, engine defaults to true (leverage/borrow enabled)\n  spotLeverage?: boolean;\n  // For isolated orders, this specifies whether margin can be borrowed (i.e. whether the cross account can have a negative USDT balance)\n  borrowMargin?: boolean;\n}>;\n\nexport type EngineLiquidateSubaccountParams =\n  WithBaseEngineExecuteParams<EIP712LiquidateSubaccountParams>;\n\nexport type EngineWithdrawCollateralParams = WithBaseEngineExecuteParams<\n  WithSpotLeverage<EIP712WithdrawCollateralParams>\n>;\n\nexport type EngineCancelOrdersParams =\n  WithBaseEngineExecuteParams<EIP712CancelOrdersParams> & {\n    /**\n     * The current unfilled amount of the order. If provided, the cancel will fail if the\n     * order's unfilled amount does not match this value. Used to prevent race conditions\n     * where a fill occurs at the same time as a cancel.\n     */\n    requiredUnfilledAmount?: BigNumber;\n  };\n\nexport interface EngineCancelAndPlaceParams {\n  cancelOrders: EngineCancelOrdersParams;\n  placeOrder: EnginePlaceOrderParams;\n  /**\n   * The current unfilled amount of the order being cancelled. If provided, the cancel will\n   * fail if the order's unfilled amount does not match this value.\n   */\n  requiredUnfilledAmount?: BigNumber;\n  /**\n   * If `true`, the cancel_and_place operation will fail if the order being cancelled has been\n   * partially filled.\n   */\n  placeRequiresUnfilled?: boolean;\n}\n\nexport type EngineCancelProductOrdersParams =\n  WithBaseEngineExecuteParams<EIP712CancelProductOrdersParams>;\n\nexport type EngineLinkSignerParams =\n  WithBaseEngineExecuteParams<EIP712LinkSignerParams>;\n\nexport type EngineTransferQuoteParams =\n  WithBaseEngineExecuteParams<EIP712TransferQuoteParams>;\n\nexport type EngineMintNlpParams = WithBaseEngineExecuteParams<\n  WithSpotLeverage<EIP712MintNlpParams>\n>;\n\nexport type EngineBurnNlpParams =\n  WithBaseEngineExecuteParams<EIP712BurnNlpParams>;\n\nexport type EnginePlaceOrdersParams = {\n  orders: EnginePlaceOrderParams[];\n  /**\n   * If `true`, aborts the batch after the first failed order; if `false`, remaining orders continue to execute.\n   * If not provided, the default value is `false`.\n   */\n  stopOnFailure?: boolean;\n};\n\nexport interface EngineExecuteRequestParamsByType {\n  burn_nlp: EngineBurnNlpParams;\n  cancel_and_place: EngineCancelAndPlaceParams;\n  cancel_orders: EngineCancelOrdersParams;\n  cancel_product_orders: EngineCancelProductOrdersParams;\n  link_signer: EngineLinkSignerParams;\n  liquidate_subaccount: EngineLiquidateSubaccountParams;\n  mint_nlp: EngineMintNlpParams;\n  place_order: EnginePlaceOrderParams;\n  place_orders: EnginePlaceOrdersParams;\n  transfer_quote: EngineTransferQuoteParams;\n  withdraw_collateral: EngineWithdrawCollateralParams;\n}\n\nexport type EnginePlaceOrderResult =\n  EngineServerExecuteSuccessResult<'place_order'> & {\n    orderParams: EIP712OrderParams;\n  };\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types/clientExecuteTypes.d.cts

@@ -1,4 +1,5 @@
 import { EIP712BurnNlpParams, EIP712CancelOrdersParams, EIP712OrderParams, EIP712CancelProductOrdersParams, EIP712LinkSignerParams, EIP712LiquidateSubaccountParams, EIP712MintNlpParams, EIP712TransferQuoteParams, EIP712WithdrawCollateralParams } from '@nadohq/shared';
+import BigNumber from 'bignumber.js';
 import { EngineServerExecuteSuccessResult } from './serverExecuteTypes.cjs';
 import './serverQueryTypes.cjs';
 import './serverQueryModelTypes.cjs';
@@ -35,11 +36,28 @@ type EnginePlaceOrderParams = WithBaseEngineExecuteParams<{
 }>;
 type EngineLiquidateSubaccountParams = WithBaseEngineExecuteParams<EIP712LiquidateSubaccountParams>;
 type EngineWithdrawCollateralParams = WithBaseEngineExecuteParams<WithSpotLeverage<EIP712WithdrawCollateralParams>>;
-type EngineCancelOrdersParams = WithBaseEngineExecuteParams<EIP712CancelOrdersParams>;
-type EngineCancelAndPlaceParams = {
+type EngineCancelOrdersParams = WithBaseEngineExecuteParams<EIP712CancelOrdersParams> & {
+    /**
+     * The current unfilled amount of the order. If provided, the cancel will fail if the
+     * order's unfilled amount does not match this value. Used to prevent race conditions
+     * where a fill occurs at the same time as a cancel.
+     */
+    requiredUnfilledAmount?: BigNumber;
+};
+interface EngineCancelAndPlaceParams {
     cancelOrders: EngineCancelOrdersParams;
     placeOrder: EnginePlaceOrderParams;
-};
+    /**
+     * The current unfilled amount of the order being cancelled. If provided, the cancel will
+     * fail if the order's unfilled amount does not match this value.
+     */
+    requiredUnfilledAmount?: BigNumber;
+    /**
+     * If `true`, the cancel_and_place operation will fail if the order being cancelled has been
+     * partially filled.
+     */
+    placeRequiresUnfilled?: boolean;
+}
 type EngineCancelProductOrdersParams = WithBaseEngineExecuteParams<EIP712CancelProductOrdersParams>;
 type EngineLinkSignerParams = WithBaseEngineExecuteParams<EIP712LinkSignerParams>;
 type EngineTransferQuoteParams = WithBaseEngineExecuteParams<EIP712TransferQuoteParams>;

package/dist/types/clientExecuteTypes.d.ts

@@ -1,4 +1,5 @@
 import { EIP712BurnNlpParams, EIP712CancelOrdersParams, EIP712OrderParams, EIP712CancelProductOrdersParams, EIP712LinkSignerParams, EIP712LiquidateSubaccountParams, EIP712MintNlpParams, EIP712TransferQuoteParams, EIP712WithdrawCollateralParams } from '@nadohq/shared';
+import BigNumber from 'bignumber.js';
 import { EngineServerExecuteSuccessResult } from './serverExecuteTypes.js';
 import './serverQueryTypes.js';
 import './serverQueryModelTypes.js';
@@ -35,11 +36,28 @@ type EnginePlaceOrderParams = WithBaseEngineExecuteParams<{
 }>;
 type EngineLiquidateSubaccountParams = WithBaseEngineExecuteParams<EIP712LiquidateSubaccountParams>;
 type EngineWithdrawCollateralParams = WithBaseEngineExecuteParams<WithSpotLeverage<EIP712WithdrawCollateralParams>>;
-type EngineCancelOrdersParams = WithBaseEngineExecuteParams<EIP712CancelOrdersParams>;
-type EngineCancelAndPlaceParams = {
+type EngineCancelOrdersParams = WithBaseEngineExecuteParams<EIP712CancelOrdersParams> & {
+    /**
+     * The current unfilled amount of the order. If provided, the cancel will fail if the
+     * order's unfilled amount does not match this value. Used to prevent race conditions
+     * where a fill occurs at the same time as a cancel.
+     */
+    requiredUnfilledAmount?: BigNumber;
+};
+interface EngineCancelAndPlaceParams {
     cancelOrders: EngineCancelOrdersParams;
     placeOrder: EnginePlaceOrderParams;
-};
+    /**
+     * The current unfilled amount of the order being cancelled. If provided, the cancel will
+     * fail if the order's unfilled amount does not match this value.
+     */
+    requiredUnfilledAmount?: BigNumber;
+    /**
+     * If `true`, the cancel_and_place operation will fail if the order being cancelled has been
+     * partially filled.
+     */
+    placeRequiresUnfilled?: boolean;
+}
 type EngineCancelProductOrdersParams = WithBaseEngineExecuteParams<EIP712CancelProductOrdersParams>;
 type EngineLinkSignerParams = WithBaseEngineExecuteParams<EIP712LinkSignerParams>;
 type EngineTransferQuoteParams = WithBaseEngineExecuteParams<EIP712TransferQuoteParams>;

package/dist/types/serverExecuteTypes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/serverExecuteTypes.ts"],"sourcesContent":["import {\n  EIP712BurnNlpValues,\n  EIP712LinkSignerValues,\n  EIP712LiquidateSubaccountValues,\n  EIP712MintNlpValues,\n  EIP712OrderCancellationValues,\n  EIP712OrderParams,\n  EIP712OrderValues,\n  EIP712ProductOrdersCancellationValues,\n  EIP712TransferQuoteValues,\n  EIP712WithdrawCollateralValues,\n  SignedTx,\n} from '@nadohq/shared';\nimport { EngineServerOrderResponse } from './serverQueryTypes';\n\nexport interface EngineServerPlaceOrderResponse {\n  digest: string;\n  error: string | null;\n}\n\nexport type EngineServerPlaceOrdersResponse = EngineServerPlaceOrderResponse[];\n\nexport interface EngineServerCancelOrdersResponse {\n  cancelled_orders: EngineServerOrderResponse[];\n}\n\nexport interface EngineServerExecuteResponseDataByType {\n  burn_nlp: null;\n  cancel_and_place: EngineServerPlaceOrderResponse;\n  cancel_orders: EngineServerCancelOrdersResponse;\n  cancel_product_orders: EngineServerCancelOrdersResponse;\n  link_signer: null;\n  liquidate_subaccount: null;\n  mint_nlp: null;\n  place_order: EngineServerPlaceOrderResponse;\n  place_orders: EngineServerPlaceOrdersResponse;\n  transfer_quote: null;\n  withdraw_collateral: null;\n}\n\nexport interface EngineServerExecuteSuccessResult<\n  T extends EngineServerExecuteRequestType = EngineServerExecuteRequestType,\n> {\n  status: 'success';\n  data: EngineServerExecuteResponseDataByType[T];\n  signature: string;\n  request_type: EngineServerExecuteResultRequestType;\n  // NOTE: `id` is excluded from the response to avoid parsing issues.\n  // type of `id` on the backend is `u64` which can overflow until we introduce proper parsing on the SDK.\n}\n\nexport interface EngineServerExecuteFailureResult {\n  status: 'failure';\n  signature: string;\n  error: string;\n  error_code: number;\n  request_type: EngineServerExecuteResultRequestType;\n}\n\nexport type EngineServerExecuteResult<\n  T extends EngineServerExecuteRequestType = EngineServerExecuteRequestType,\n> = EngineServerExecuteSuccessResult<T> | EngineServerExecuteFailureResult;\n\ntype EngineServerExecuteResultRequestType = {\n  [K in keyof EngineServerExecuteRequestByType]: `execute_${K}`;\n}[keyof EngineServerExecuteRequestByType];\n\nexport interface EngineServerPlaceOrderParams {\n  id: number | null;\n  product_id: number;\n  order: EIP712OrderValues;\n  // Bytes\n  signature: string;\n  // Engine defaults this to true\n  spot_leverage: boolean | null;\n  // For isolated orders, this specifies whether margin can be borrowed (i.e. whether the cross account can have a negative USDT balance)\n  borrow_margin: boolean | null;\n}\n\nexport type EngineServerCancelOrdersParams = SignedTx<\n  Omit<EIP712OrderCancellationValues, 'productIds'> & {\n    // number[] is technically assignable to \"Bytes\", so we need to override the ByteFieldsToHex result here\n    productIds: number[];\n  }\n>;\n\nexport type EngineServiceCancelAndPlaceParams = Omit<\n  EngineServerCancelOrdersParams,\n  'tx' | 'signature'\n> & {\n  cancel_tx: EngineServerCancelOrdersParams['tx'];\n  cancel_signature: EngineServerCancelOrdersParams['signature'];\n  place_order: EngineServerPlaceOrderParams;\n};\n\ntype WithSpotLeverage<T> = T & {\n  spot_leverage: boolean | null;\n};\n\nexport interface EngineServerExecuteRequestByType {\n  burn_nlp: SignedTx<EIP712BurnNlpValues>;\n  cancel_and_place: EngineServiceCancelAndPlaceParams;\n  cancel_orders: EngineServerCancelOrdersParams;\n  cancel_product_orders: SignedTx<\n    Omit<EIP712ProductOrdersCancellationValues, 'productIds'> & {\n      // number[] is technically assignable to \"Bytes\", so we need to override the ByteFieldsToHex result here\n      productIds: number[];\n    }\n  >;\n  link_signer: SignedTx<EIP712LinkSignerValues>;\n  liquidate_subaccount: SignedTx<EIP712LiquidateSubaccountValues>;\n  mint_nlp: WithSpotLeverage<SignedTx<EIP712MintNlpValues>>;\n  place_order: EngineServerPlaceOrderParams;\n  place_orders: {\n    orders: EngineServerPlaceOrderParams[];\n    /**\n     * If `true`, aborts the batch after the first failed order; if `false`, remaining orders continue to execute.\n     * If `null`, the default value is `false`.\n     */\n    stop_on_failure: boolean | null;\n  };\n  transfer_quote: SignedTx<EIP712TransferQuoteValues>;\n  withdraw_collateral: WithSpotLeverage<\n    SignedTx<EIP712WithdrawCollateralValues>\n  >;\n}\n\nexport type EngineServerExecuteRequestType =\n  keyof EngineServerExecuteRequestByType;\n\nexport interface EngineServerExecutePlaceOrderPayload {\n  payload: EngineServerExecuteRequestByType['place_order'];\n  orderParams: EIP712OrderParams;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/types/serverExecuteTypes.ts"],"sourcesContent":["import {\n  EIP712BurnNlpValues,\n  EIP712LinkSignerValues,\n  EIP712LiquidateSubaccountValues,\n  EIP712MintNlpValues,\n  EIP712OrderCancellationValues,\n  EIP712OrderParams,\n  EIP712OrderValues,\n  EIP712ProductOrdersCancellationValues,\n  EIP712TransferQuoteValues,\n  EIP712WithdrawCollateralValues,\n  SignedTx,\n} from '@nadohq/shared';\nimport { EngineServerOrderResponse } from './serverQueryTypes';\n\nexport interface EngineServerPlaceOrderResponse {\n  digest: string;\n  error: string | null;\n}\n\nexport type EngineServerPlaceOrdersResponse = EngineServerPlaceOrderResponse[];\n\nexport interface EngineServerCancelOrdersResponse {\n  cancelled_orders: EngineServerOrderResponse[];\n}\n\nexport interface EngineServerExecuteResponseDataByType {\n  burn_nlp: null;\n  cancel_and_place: EngineServerPlaceOrderResponse;\n  cancel_orders: EngineServerCancelOrdersResponse;\n  cancel_product_orders: EngineServerCancelOrdersResponse;\n  link_signer: null;\n  liquidate_subaccount: null;\n  mint_nlp: null;\n  place_order: EngineServerPlaceOrderResponse;\n  place_orders: EngineServerPlaceOrdersResponse;\n  transfer_quote: null;\n  withdraw_collateral: null;\n}\n\nexport interface EngineServerExecuteSuccessResult<\n  T extends EngineServerExecuteRequestType = EngineServerExecuteRequestType,\n> {\n  status: 'success';\n  data: EngineServerExecuteResponseDataByType[T];\n  signature: string;\n  request_type: EngineServerExecuteResultRequestType;\n  // NOTE: `id` is excluded from the response to avoid parsing issues.\n  // type of `id` on the backend is `u64` which can overflow until we introduce proper parsing on the SDK.\n}\n\nexport interface EngineServerExecuteFailureResult {\n  status: 'failure';\n  signature: string;\n  error: string;\n  error_code: number;\n  request_type: EngineServerExecuteResultRequestType;\n}\n\nexport type EngineServerExecuteResult<\n  T extends EngineServerExecuteRequestType = EngineServerExecuteRequestType,\n> = EngineServerExecuteSuccessResult<T> | EngineServerExecuteFailureResult;\n\ntype EngineServerExecuteResultRequestType = {\n  [K in keyof EngineServerExecuteRequestByType]: `execute_${K}`;\n}[keyof EngineServerExecuteRequestByType];\n\nexport interface EngineServerPlaceOrderParams {\n  id: number | null;\n  product_id: number;\n  order: EIP712OrderValues;\n  // Bytes\n  signature: string;\n  // Engine defaults this to true\n  spot_leverage: boolean | null;\n  // For isolated orders, this specifies whether margin can be borrowed (i.e. whether the cross account can have a negative USDT balance)\n  borrow_margin: boolean | null;\n}\n\nexport type EngineServerCancelOrdersParams = SignedTx<\n  Omit<EIP712OrderCancellationValues, 'productIds'> & {\n    // number[] is technically assignable to \"Bytes\", so we need to override the ByteFieldsToHex result here\n    productIds: number[];\n  }\n> & {\n  required_unfilled_amount?: string;\n};\n\nexport type EngineServiceCancelAndPlaceParams = Omit<\n  EngineServerCancelOrdersParams,\n  'tx' | 'signature'\n> & {\n  cancel_tx: EngineServerCancelOrdersParams['tx'];\n  cancel_signature: EngineServerCancelOrdersParams['signature'];\n  place_order: EngineServerPlaceOrderParams;\n  place_requires_unfilled?: boolean;\n};\n\ntype WithSpotLeverage<T> = T & {\n  spot_leverage: boolean | null;\n};\n\nexport interface EngineServerExecuteRequestByType {\n  burn_nlp: SignedTx<EIP712BurnNlpValues>;\n  cancel_and_place: EngineServiceCancelAndPlaceParams;\n  cancel_orders: EngineServerCancelOrdersParams;\n  cancel_product_orders: SignedTx<\n    Omit<EIP712ProductOrdersCancellationValues, 'productIds'> & {\n      // number[] is technically assignable to \"Bytes\", so we need to override the ByteFieldsToHex result here\n      productIds: number[];\n    }\n  >;\n  link_signer: SignedTx<EIP712LinkSignerValues>;\n  liquidate_subaccount: SignedTx<EIP712LiquidateSubaccountValues>;\n  mint_nlp: WithSpotLeverage<SignedTx<EIP712MintNlpValues>>;\n  place_order: EngineServerPlaceOrderParams;\n  place_orders: {\n    orders: EngineServerPlaceOrderParams[];\n    /**\n     * If `true`, aborts the batch after the first failed order; if `false`, remaining orders continue to execute.\n     * If `null`, the default value is `false`.\n     */\n    stop_on_failure: boolean | null;\n  };\n  transfer_quote: SignedTx<EIP712TransferQuoteValues>;\n  withdraw_collateral: WithSpotLeverage<\n    SignedTx<EIP712WithdrawCollateralValues>\n  >;\n}\n\nexport type EngineServerExecuteRequestType =\n  keyof EngineServerExecuteRequestByType;\n\nexport interface EngineServerExecutePlaceOrderPayload {\n  payload: EngineServerExecuteRequestByType['place_order'];\n  orderParams: EIP712OrderParams;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types/serverExecuteTypes.d.cts

@@ -50,11 +50,14 @@ interface EngineServerPlaceOrderParams {
 }
 type EngineServerCancelOrdersParams = SignedTx<Omit<EIP712OrderCancellationValues, 'productIds'> & {
     productIds: number[];
-}>;
+}> & {
+    required_unfilled_amount?: string;
+};
 type EngineServiceCancelAndPlaceParams = Omit<EngineServerCancelOrdersParams, 'tx' | 'signature'> & {
     cancel_tx: EngineServerCancelOrdersParams['tx'];
     cancel_signature: EngineServerCancelOrdersParams['signature'];
     place_order: EngineServerPlaceOrderParams;
+    place_requires_unfilled?: boolean;
 };
 type WithSpotLeverage<T> = T & {
     spot_leverage: boolean | null;

package/dist/types/serverExecuteTypes.d.ts

@@ -50,11 +50,14 @@ interface EngineServerPlaceOrderParams {
 }
 type EngineServerCancelOrdersParams = SignedTx<Omit<EIP712OrderCancellationValues, 'productIds'> & {
     productIds: number[];
-}>;
+}> & {
+    required_unfilled_amount?: string;
+};
 type EngineServiceCancelAndPlaceParams = Omit<EngineServerCancelOrdersParams, 'tx' | 'signature'> & {
     cancel_tx: EngineServerCancelOrdersParams['tx'];
     cancel_signature: EngineServerCancelOrdersParams['signature'];
     place_order: EngineServerPlaceOrderParams;
+    place_requires_unfilled?: boolean;
 };
 type WithSpotLeverage<T> = T & {
     spot_leverage: boolean | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadohq/engine-client",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "type": "module",
   "sideEffects": false,
   "description": "HTTP client for the Nado off-chain matching engine",
@@ -41,7 +41,7 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@nadohq/shared": "^0.12.0",
+    "@nadohq/shared": "^0.13.0",
     "axios": "1.14.0",
     "ts-mixer": "6.0.4"
   },
@@ -53,5 +53,5 @@
     "bignumber.js": "10.0.2",
     "viem": "2.45.3"
   },
-  "gitHead": "bad9b58d3e5bde93b62838b5cb75dad79cefbc78"
+  "gitHead": "e1ee8f9301cf6bd6b0775d505e7606a80eed1458"
 }

package/src/EngineExecuteBuilder.ts

@@ -4,6 +4,7 @@ import {
   getOrderNonce,
   SignableRequestType,
   SignableRequestTypeToParams,
+  toIntegerString,
 } from '@nadohq/shared';
 import { EngineBaseClient } from './EngineBaseClient';
 import {
@@ -187,6 +188,9 @@ export class EngineExecuteBuilder {
     return {
       tx,
       signature: clientParams.signature,
+      required_unfilled_amount: clientParams.requiredUnfilledAmount
+        ? toIntegerString(clientParams.requiredUnfilledAmount)
+        : undefined,
     };
   }
 

package/src/EngineExecuteClient.ts

@@ -1,3 +1,4 @@
+import { toIntegerString } from '@nadohq/shared';
 import { EngineBaseClient, EngineClientOpts } from './EngineBaseClient';
 import { EngineExecuteBuilder } from './EngineExecuteBuilder';
 import {
@@ -70,6 +71,10 @@ export class EngineExecuteClient extends EngineBaseClient {
       cancel_tx: cancelOrdersPayload.tx,
       cancel_signature: cancelOrdersPayload.signature,
       place_order: placeOrderPayload.payload,
+      required_unfilled_amount: params.requiredUnfilledAmount
+        ? toIntegerString(params.requiredUnfilledAmount)
+        : undefined,
+      place_requires_unfilled: params.placeRequiresUnfilled,
     });
   }
 

package/src/types/clientExecuteTypes.ts

@@ -9,6 +9,7 @@ import {
   EIP712TransferQuoteParams,
   EIP712WithdrawCollateralParams,
 } from '@nadohq/shared';
+import BigNumber from 'bignumber.js';
 import { EngineServerExecuteSuccessResult } from './serverExecuteTypes';
 
 /**
@@ -61,12 +62,29 @@ export type EngineWithdrawCollateralParams = WithBaseEngineExecuteParams<
 >;
 
 export type EngineCancelOrdersParams =
-  WithBaseEngineExecuteParams<EIP712CancelOrdersParams>;
+  WithBaseEngineExecuteParams<EIP712CancelOrdersParams> & {
+    /**
+     * The current unfilled amount of the order. If provided, the cancel will fail if the
+     * order's unfilled amount does not match this value. Used to prevent race conditions
+     * where a fill occurs at the same time as a cancel.
+     */
+    requiredUnfilledAmount?: BigNumber;
+  };
 
-export type EngineCancelAndPlaceParams = {
+export interface EngineCancelAndPlaceParams {
   cancelOrders: EngineCancelOrdersParams;
   placeOrder: EnginePlaceOrderParams;
-};
+  /**
+   * The current unfilled amount of the order being cancelled. If provided, the cancel will
+   * fail if the order's unfilled amount does not match this value.
+   */
+  requiredUnfilledAmount?: BigNumber;
+  /**
+   * If `true`, the cancel_and_place operation will fail if the order being cancelled has been
+   * partially filled.
+   */
+  placeRequiresUnfilled?: boolean;
+}
 
 export type EngineCancelProductOrdersParams =
   WithBaseEngineExecuteParams<EIP712CancelProductOrdersParams>;

package/src/types/serverExecuteTypes.ts

@@ -82,7 +82,9 @@ export type EngineServerCancelOrdersParams = SignedTx<
     // number[] is technically assignable to "Bytes", so we need to override the ByteFieldsToHex result here
     productIds: number[];
   }
->;
+> & {
+  required_unfilled_amount?: string;
+};
 
 export type EngineServiceCancelAndPlaceParams = Omit<
   EngineServerCancelOrdersParams,
@@ -91,6 +93,7 @@ export type EngineServiceCancelAndPlaceParams = Omit<
   cancel_tx: EngineServerCancelOrdersParams['tx'];
   cancel_signature: EngineServerCancelOrdersParams['signature'];
   place_order: EngineServerPlaceOrderParams;
+  place_requires_unfilled?: boolean;
 };
 
 type WithSpotLeverage<T> = T & {