@shogun-sdk/intents-sdk 1.3.0 → 1.4.1

package/src/core/sui/intent-helpers.ts

@@ -1,8 +1,12 @@
 import { ChainID } from '../../chains.js';
-import type { SingleChainUserIntentRequest, CrossChainUserIntentRequest, DcaSingleChainUserIntentRequest } from '../../types/intent.js';
+import type {
+  SingleChainUserIntentRequest,
+  CrossChainUserIntentRequest,
+  DcaSingleChainUserIntentRequest,
+} from '../../types/intent.js';
 import type { SingleChainOrder } from '../orders/single-chain.js';
 import type { DcaSingleChainOrder } from '../orders/dca-single-chain.js';
-import type { ExtraTransfer } from '../orders/common.js';
+import type { ExtraTransfer, StopLossType } from '../orders/common.js';
 import { getSecretHash, getRandomU64Number } from './single-chain-limit-order.js';
 import { getDcaSecretHash } from './single-chain-dca-order.js';
 import { generateExecutionDetailsHash } from '../../utils/generate-execution-details-hash.js';
@@ -19,8 +23,9 @@ export type CreateSuiSingleChainLimitOrderIntentParams = {
   deadline: number;
   transactionHash: string;
   secretNumber?: string;
-  stopLossMaxOut?: bigint;
   takeProfitMinOut?: bigint;
+  stopLossType?: StopLossType;
+  stopLossTriggerPrice?: string;
 };
 
 export type CreateSuiSingleChainDcaOrderIntentParams = {
@@ -51,8 +56,9 @@ export type CreateSuiCrossChainOrderIntentParams = {
   tokenOut: string;
   amountOutMin: bigint;
   transactionHash: string;
-  stopLossMaxOut?: bigint;
   takeProfitMinOut?: bigint;
+  stopLossType?: StopLossType;
+  stopLossTriggerPrice?: string;
   extraTransfers?: ExtraTransfer[];
 };
 
@@ -62,10 +68,10 @@ export type CreateSuiCrossChainOrderIntentParams = {
  * @returns Formatted intent request ready to send to auctioneer
  */
 export function createSuiSingleChainLimitOrderIntentRequest(
-  params: CreateSuiSingleChainLimitOrderIntentParams
+  params: CreateSuiSingleChainLimitOrderIntentParams,
 ): SingleChainUserIntentRequest {
   const secretNumber = params.secretNumber || getRandomU64Number();
-  
+
   const order: SingleChainOrder = {
     user: params.user,
     chainId: ChainID.Sui,
@@ -76,8 +82,10 @@ export function createSuiSingleChainLimitOrderIntentRequest(
     destinationAddress: params.destinationAddress,
     extraTransfers: params.extraTransfers,
     deadline: params.deadline,
-    stopLossMaxOut: params.stopLossMaxOut,
+
     takeProfitMinOut: params.takeProfitMinOut,
+    stopLossType: params.stopLossType,
+    stopLossTriggerPrice: params.stopLossTriggerPrice,
   } as SingleChainOrder;
 
   return {
@@ -97,10 +105,10 @@ export function createSuiSingleChainLimitOrderIntentRequest(
  * @returns Formatted intent request ready to send to auctioneer
  */
 export function createSuiSingleChainDcaOrderIntentRequest(
-  params: CreateSuiSingleChainDcaOrderIntentParams
+  params: CreateSuiSingleChainDcaOrderIntentParams,
 ): DcaSingleChainUserIntentRequest {
   const secretNumber = params.secretNumber || getRandomU64Number();
-  
+
   const order: DcaSingleChainOrder = {
     user: params.user,
     chainId: ChainID.Sui,
@@ -133,21 +141,22 @@ export function createSuiSingleChainDcaOrderIntentRequest(
  * @returns Formatted intent request ready to send to auctioneer
  */
 export function createSuiCrossChainOrderIntentRequest(
-  params: CreateSuiCrossChainOrderIntentParams
+  params: CreateSuiCrossChainOrderIntentParams,
 ): CrossChainUserIntentRequest {
-
   const executionDetails = {
     destChainId: params.destChainId,
     tokenOut: params.tokenOut,
     amountOutMin: params.amountOutMin.toString(),
     destinationAddress: params.destinationAddress,
-    stopLossMaxOut: params.stopLossMaxOut?.toString(),
     takeProfitMinOut: params.takeProfitMinOut?.toString(),
+    stopLossType: params.stopLossType,
+    stopLossTriggerPrice: params.stopLossTriggerPrice,
     extraTransfers: params.extraTransfers,
   };
   const executionDetailsString = JSON.stringify(executionDetails, Parsers.bigIntReplacer);
 
-  const executionDetailsHash = generateExecutionDetailsHash(executionDetails);
+  // Hash the exact string we send; the auctioneer recomputes sha256 over it and rejects on mismatch
+  const executionDetailsHash = generateExecutionDetailsHash(executionDetailsString);
 
   const genericData = {
     user: params.user,
@@ -183,19 +192,13 @@ export function generateSuiLimitOrderSecretData(
   tokenOut: string,
   receiver: string,
   secretNumber?: string,
-  extraTransfers?: ExtraTransfer[]
+  extraTransfers?: ExtraTransfer[],
 ): { secretNumber: string; secretHash: Uint8Array } {
   const secret = secretNumber || getRandomU64Number();
   const extraTransferCoinOut = extraTransfers?.[0]?.token;
   const extraTransferReceiver = extraTransfers?.[0]?.receiver;
-  
-  const secretHash = getSecretHash(
-    tokenOut,
-    receiver,
-    secret,
-    extraTransferCoinOut,
-    extraTransferReceiver
-  );
+
+  const secretHash = getSecretHash(tokenOut, receiver, secret, extraTransferCoinOut, extraTransferReceiver);
 
   return {
     secretNumber: secret,
@@ -215,19 +218,13 @@ export function generateSuiDcaOrderSecretData(
   tokenOut: string,
   receiver: string,
   secretNumber?: string,
-  extraTransfers?: ExtraTransfer[]
+  extraTransfers?: ExtraTransfer[],
 ): { secretNumber: string; secretHash: Uint8Array } {
   const secret = secretNumber || getRandomU64Number();
   const extraTransferCoinOut = extraTransfers?.[0]?.token;
   const extraTransferReceiver = extraTransfers?.[0]?.receiver;
-  
-  const secretHash = getDcaSecretHash(
-    tokenOut,
-    receiver,
-    secret,
-    extraTransferCoinOut,
-    extraTransferReceiver
-  );
+
+  const secretHash = getDcaSecretHash(tokenOut, receiver, secret, extraTransferCoinOut, extraTransferReceiver);
 
   return {
     secretNumber: secret,

package/src/core/sui/order-transaction.ts

@@ -21,7 +21,7 @@ import type { CrossChainOrder } from '../orders/cross-chain.js';
  */
 export async function getSuiOrderTransaction(
   order: CrossChainOrder,
-  client?: ReturnType<typeof createSuiClient>
+  client?: ReturnType<typeof createSuiClient>,
 ): Promise<Transaction> {
   const userAddress = order.user;
   const suiClient = client || createSuiClient();

package/src/core/sui/single-chain-dca-order.ts

@@ -1,12 +1,17 @@
 import { bcs, fromHex } from '@mysten/bcs';
-import { keccak256 } from "js-sha3";
-import { normalizeStructTag, normalizeSuiAddress, normalizeSuiObjectId } from "@mysten/sui/utils";
+import { normalizeStructTag, normalizeSuiAddress, normalizeSuiObjectId } from '@mysten/sui/utils';
 import { Transaction } from '@mysten/sui/transactions';
 import { ValidationError } from '../../errors/index.js';
 import { createSuiClient } from './client.js';
-import { SUI_PACKAGE_ID, SUI_GUARD_COLLATERAL_TYPE, SUI_GUARD_STABLECOIN_TYPE, NATIVE_SUI_TOKEN_ADDRESS } from '../../constants.js';
+import {
+  SUI_PACKAGE_ID,
+  SUI_GUARD_COLLATERAL_TYPE,
+  SUI_GUARD_STABLECOIN_TYPE,
+  NATIVE_SUI_TOKEN_ADDRESS,
+} from '../../constants.js';
 import type { DcaSingleChainOrder } from '../orders/dca-single-chain.js';
-
+import pkg from 'js-sha3';
+const { keccak256 } = pkg;
 /**
  * Generates secret hash based on types, addresses and secret number for single chain DCA orders
  * @param coinOutType Type tag of Coin OUT
@@ -22,34 +27,18 @@ export function getDcaSecretHash(
   extraTransferCoinOut?: string,
   extraTransferReceiver?: string,
 ) {
-  const coinOutTypeBytes = Buffer.from(
-    normalizeStructTag(coinOutType).replace("0x", ""),
-    "utf8"
-  );
+  const coinOutTypeBytes = Buffer.from(normalizeStructTag(coinOutType).replace('0x', ''), 'utf8');
   const receiverBytes = fromHex(normalizeSuiAddress(receiver));
 
-  let resBytes = [
-    ...coinOutTypeBytes,
-    ...receiverBytes,
-  ];
+  let resBytes = [...coinOutTypeBytes, ...receiverBytes];
   if (extraTransferCoinOut && extraTransferReceiver) {
-    const extraTransferCoinOutBytes = Buffer.from(
-      normalizeStructTag(extraTransferCoinOut).replace("0x", ""),
-      "utf8"
-    );
+    const extraTransferCoinOutBytes = Buffer.from(normalizeStructTag(extraTransferCoinOut).replace('0x', ''), 'utf8');
     const extraTransferReceiverBytes = fromHex(normalizeSuiAddress(extraTransferReceiver));
 
-    resBytes = [
-      ...resBytes,
-      ...extraTransferCoinOutBytes,
-      ...extraTransferReceiverBytes,
-    ];
+    resBytes = [...resBytes, ...extraTransferCoinOutBytes, ...extraTransferReceiverBytes];
   }
 
-  resBytes = [
-    ...resBytes,
-    ...bcs.u64().serialize(secretNumber).toBytes(),
-  ];
+  resBytes = [...resBytes, ...bcs.u64().serialize(secretNumber).toBytes()];
 
   return keccak256.array(resBytes);
 }
@@ -66,12 +55,12 @@ export async function getSuiSingleChainDcaOrderTransaction(
   order: DcaSingleChainOrder,
   secretHash: Uint8Array,
   guardAddress: string,
-  client?: ReturnType<typeof createSuiClient>
+  client?: ReturnType<typeof createSuiClient>,
 ): Promise<Transaction> {
   const userAddress = order.user;
   const suiClient = client || createSuiClient();
   const totalAmountIn = order.getTotalAmountIn();
-  
+
   const coins = await suiClient.getCoins({
     owner: userAddress,
     coinType: order.tokenIn,
@@ -91,8 +80,7 @@ export async function getSuiSingleChainDcaOrderTransaction(
     );
   }
 
-  const spendingGasCoin =
-    normalizeSuiObjectId(order.tokenIn) === normalizeSuiObjectId(NATIVE_SUI_TOKEN_ADDRESS);
+  const spendingGasCoin = normalizeSuiObjectId(order.tokenIn) === normalizeSuiObjectId(NATIVE_SUI_TOKEN_ADDRESS);
 
   const tx = new Transaction();
   const coinInArg = spendingGasCoin ? tx.gas : sourceTokenInCoins[0]!.coinObjectId;
@@ -110,9 +98,8 @@ export async function getSuiSingleChainDcaOrderTransaction(
   const [coinIn] = tx.splitCoins(coinInArg, [totalAmountIn]);
 
   // Get extra transfer amount - only first extra transfer is supported on Sui
-  const extraTransferAmount = order.extraTransfers && order.extraTransfers.length > 0 
-    ? BigInt(order.extraTransfers[0]!.amount) 
-    : 0n;
+  const extraTransferAmount =
+    order.extraTransfers && order.extraTransfers.length > 0 ? BigInt(order.extraTransfers[0]!.amount) : 0n;
 
   tx.moveCall({
     package: SUI_PACKAGE_ID,

package/src/core/sui/single-chain-limit-order.ts

@@ -1,19 +1,22 @@
 import { bcs, fromHex } from '@mysten/bcs';
-import { keccak256 } from "js-sha3";
-import { normalizeStructTag, normalizeSuiAddress, normalizeSuiObjectId } from "@mysten/sui/utils";
+import { normalizeStructTag, normalizeSuiAddress, normalizeSuiObjectId } from '@mysten/sui/utils';
 import { Transaction } from '@mysten/sui/transactions';
 import { ValidationError } from '../../errors/index.js';
 import { createSuiClient } from './client.js';
-import { SUI_PACKAGE_ID, SUI_GUARD_COLLATERAL_TYPE, SUI_GUARD_STABLECOIN_TYPE, NATIVE_SUI_TOKEN_ADDRESS } from '../../constants.js';
+import {
+  SUI_PACKAGE_ID,
+  SUI_GUARD_COLLATERAL_TYPE,
+  SUI_GUARD_STABLECOIN_TYPE,
+  NATIVE_SUI_TOKEN_ADDRESS,
+} from '../../constants.js';
 import type { SingleChainOrder } from '../orders/single-chain.js';
-
+import pkg from 'js-sha3';
+const { keccak256 } = pkg;
 /**
  * Generates random U64 number
  */
 export function getRandomU64Number() {
-  return BigInt("0x" + [...crypto.getRandomValues(new Uint8Array(8))]
-      .map(n => n.toString(16))
-      .join("")).toString();
+  return BigInt('0x' + [...crypto.getRandomValues(new Uint8Array(8))].map((n) => n.toString(16)).join('')).toString();
 }
 
 /**
@@ -31,34 +34,18 @@ export function getSecretHash(
   extraTransferCoinOut?: string,
   extraTransferReceiver?: string,
 ) {
-  const coinOutTypeBytes = Buffer.from(
-    normalizeStructTag(coinOutType).replace("0x", ""),
-    "utf8"
-  );
+  const coinOutTypeBytes = Buffer.from(normalizeStructTag(coinOutType).replace('0x', ''), 'utf8');
   const receiverBytes = fromHex(normalizeSuiAddress(receiver));
 
-  let resBytes = [
-    ...coinOutTypeBytes,
-    ...receiverBytes,
-  ];
+  let resBytes = [...coinOutTypeBytes, ...receiverBytes];
   if (extraTransferCoinOut && extraTransferReceiver) {
-    const extraTransferCoinOutBytes = Buffer.from(
-      normalizeStructTag(extraTransferCoinOut).replace("0x", ""),
-      "utf8"
-    );
+    const extraTransferCoinOutBytes = Buffer.from(normalizeStructTag(extraTransferCoinOut).replace('0x', ''), 'utf8');
     const extraTransferReceiverBytes = fromHex(normalizeSuiAddress(extraTransferReceiver));
 
-    resBytes = [
-      ...resBytes,
-      ...extraTransferCoinOutBytes,
-      ...extraTransferReceiverBytes,
-    ];
+    resBytes = [...resBytes, ...extraTransferCoinOutBytes, ...extraTransferReceiverBytes];
   }
 
-  resBytes = [
-    ...resBytes,
-    ...bcs.u64().serialize(secretNumber).toBytes(),
-  ];
+  resBytes = [...resBytes, ...bcs.u64().serialize(secretNumber).toBytes()];
 
   return keccak256.array(resBytes);
 }
@@ -75,7 +62,7 @@ export async function getSuiSingleChainLimitOrderTransaction(
   order: SingleChainOrder,
   secretHash: Uint8Array,
   guardAddress: string,
-  client?: ReturnType<typeof createSuiClient>
+  client?: ReturnType<typeof createSuiClient>,
 ): Promise<Transaction> {
   const userAddress = order.user;
   const suiClient = client || createSuiClient();
@@ -98,8 +85,7 @@ export async function getSuiSingleChainLimitOrderTransaction(
     );
   }
 
-  const spendingGasCoin =
-    normalizeSuiObjectId(order.tokenIn) === normalizeSuiObjectId(NATIVE_SUI_TOKEN_ADDRESS);
+  const spendingGasCoin = normalizeSuiObjectId(order.tokenIn) === normalizeSuiObjectId(NATIVE_SUI_TOKEN_ADDRESS);
 
   const tx = new Transaction();
   const coinInArg = spendingGasCoin ? tx.gas : sourceTokenInCoins[0]!.coinObjectId;
@@ -117,9 +103,8 @@ export async function getSuiSingleChainLimitOrderTransaction(
   const [coinIn] = tx.splitCoins(coinInArg, [order.amountIn]);
 
   // Get extra transfer amount - only first extra transfer is supported on Sui
-  const extraTransferAmount = order.extraTransfers && order.extraTransfers.length > 0 
-    ? BigInt(order.extraTransfers[0]!.amount) 
-    : 0n;
+  const extraTransferAmount =
+    order.extraTransfers && order.extraTransfers.length > 0 ? BigInt(order.extraTransfers[0]!.amount) : 0n;
 
   tx.moveCall({
     package: SUI_PACKAGE_ID,

package/src/index.ts

@@ -11,9 +11,10 @@ export { CrossChainOrder } from './core/orders/cross-chain.js';
 export type { CreateCrossChainOrderParams } from './core/orders/cross-chain.js';
 export { SingleChainOrder } from './core/orders/single-chain.js';
 export type { CreateSingleChainOrderParams } from './core/orders/single-chain.js';
+export type { StopLossType } from './core/orders/common.js';
 
-export { fetchUserOrders } from './core/orders/api/fetch.js';
-export { AuctioneerAPI } from './core/orders/api/index.js';
+export { fetchUserOrders, type FetchUserOrdersParams } from './core/orders/api/fetch.js';
+export { AuctioneerAPI, type GetUserOrdersParams } from './core/orders/api/index.js';
 export { type FetchJWTParams, type FetchSiweMessageParams, fetchJWTToken, fetchSiweMessage } from './auth/siwe.js';
 export { ValidationError } from './errors/index.js';
 export {
@@ -22,6 +23,7 @@ export {
   type ApiSingleChainOrder,
   type ApiUserOrders,
   type ChainOrderStatus,
+  type ApiIntentResponse,
   isErrorApiResponse,
   isSuccessApiResponse,
 } from './types/api.js';
@@ -42,6 +44,7 @@ export { getSolanaOrdersWithLockedFunds } from './core/solana/inspect.js';
 export {
   getSolanaCrossChainOrderInstructions,
   getSolanaSingleChainOrderInstructions,
+  type SolanaOrderInstructionResult,
 } from './core/solana/order-instructions.js';
 export {
   cancelCrossChainOrderInstructionsAsBytes,
@@ -90,13 +93,16 @@ export {
   createEvmSingleChainLimitOrderIntentRequest,
   createEvmSingleChainDcaOrderIntentRequest,
   createEvmCrossChainOrderIntentRequest,
+  createEvmCrossChainDcaOrderIntentRequest,
   generateEvmSingleChainLimitOrderTypedData,
   generateEvmSingleChainDcaOrderTypedData,
   generateEvmCrossChainOrderTypedData,
+  getEVMCrossChainDcaOrderTypedData,
   generateEvmRandomNonce,
   type CreateEvmSingleChainLimitOrderIntentParams,
   type CreateEvmSingleChainDcaOrderIntentParams,
   type CreateEvmCrossChainOrderIntentParams,
+  type CreateEvmCrossChainDcaOrderIntentParams,
 } from './core/evm/intent-helpers.js';
 
 // Solana Intent Helpers

package/src/types/api.ts

@@ -1,6 +1,13 @@
 import type { ExtraTransfer } from '../core/orders/common.js';
 
-export type ChainOrderStatus = 'Auction' | 'NoBids' | 'Executing' | 'Fulfilled' | 'Cancelled' | 'Outdated';
+export type ChainOrderStatus =
+  | 'Auction'
+  | 'NoBids'
+  | 'Executing'
+  | 'Fulfilled'
+  | 'Cancelled'
+  | 'Outdated'
+  | 'DcaIntervalFulfilled';
 
 export type ApiCrossChainOrder = {
   orderId: string;
@@ -54,8 +61,21 @@ export type ApiUserOrders = {
   singleChainLimitOrders: ApiSingleChainOrder[];
   crossChainLimitOrders: ApiCrossChainOrder[];
 };
+/**
+ * Represents the response from an Intent API endpoint.
+ */
+export interface ApiIntentResponse {
+  /** Unique identifier for the created intent */
+  intentId: string;
 
-export type ValidResponseData = ApiUserOrders | string | null;
+  /**
+   * JWT token used for authorization or subsequent requests.
+   * Optional: order-creation responses only return `intentId`; obtain a JWT via the
+   * SIWE flow (`EVMSDK.authenticate()` / `fetchJWTToken`) instead.
+   */
+  jwt?: string;
+}
+export type ValidResponseData = ApiUserOrders | string | ApiIntentResponse | null;
 
 export type ApiResponse<T extends ValidResponseData = ValidResponseData> = {
   success: boolean;

package/src/types/intent.ts

@@ -1,6 +1,6 @@
 import type { SupportedChain } from '../chains.js';
 import type { CrossChainOrder } from '../core/orders/cross-chain.js';
-import type { ExtraTransfer } from '../core/orders/common.js';
+import type { ExtraTransfer, StopLossType } from '../core/orders/common.js';
 import type { SingleChainOrder } from '../core/orders/single-chain.js';
 import type { DcaSingleChainOrder } from '../core/orders/dca-single-chain.js';
 
@@ -20,7 +20,11 @@ export type ExecutionDetails = {
   /** Extra transfers to be made */
   extraTransfers?: ExtraTransfer[];
 
-  stopLossMaxOut?: bigint;
+  /** Stop loss type, must match the auctioneer's `stopLossType` field */
+  stopLossType?: StopLossType;
+  /** Initial trigger price (tokenIn/tokenOut) that arms the stop loss */
+  stopLossTriggerPrice?: string;
+  /** Take profit minimum amount out */
   takeProfitMinOut?: bigint;
 };
 
@@ -85,7 +89,6 @@ export type CrossChainUserIntentRequest = {
     /** Sui-specific data */
     Sui?: SuiPreparedData;
   };
-  
 };
 
 export type SingleChainUserIntentRequest = {
@@ -97,6 +100,36 @@ export type SingleChainUserIntentRequest = {
   };
 };
 
+/**
+ * Source chain data for a cross-chain DCA order. Mirrors the auctioneer's
+ * `CrossChainDcaOrderGenericRequestData` (common cross-chain fields + flattened
+ * `CommonDcaOrderData`). The destination fields live in `executionDetails`.
+ */
+export type DcaCrossChainSourceChainData = {
+  user: string;
+  srcChainId: SupportedChain;
+  tokenIn: string;
+  minStablecoinsAmount: bigint;
+  deadline: number;
+  executionDetailsHash: ExecutionDetailsHash;
+  /** Flattened CommonDcaOrderData */
+  startTime: number;
+  amountInPerInterval: bigint;
+  totalIntervals: number;
+  intervalDuration: number;
+};
+
+export type DcaCrossChainUserIntentRequest = {
+  genericData: DcaCrossChainSourceChainData;
+  /** JSON-stringified execution details for the destination chain */
+  executionDetails: string;
+  chainSpecificData: {
+    EVM?: DcaSingleChainEVMPreparedData;
+    Solana?: DcaSingleChainSolanaPreparedData;
+    Sui?: DcaSingleChainSuiPreparedData;
+  };
+};
+
 export type ChainPreparedData = EvmPreparedData | SuiPreparedData | SolanaPreparedData;
 
 export type CrossChainOrderPrepared = {
@@ -153,7 +186,10 @@ export type DcaSingleChainSolanaPreparedData = {
   orderPubkey: string;
 };
 
-export type DcaSingleChainPreparedData = DcaSingleChainEVMPreparedData | DcaSingleChainSolanaPreparedData | DcaSingleChainSuiPreparedData;
+export type DcaSingleChainPreparedData =
+  | DcaSingleChainEVMPreparedData
+  | DcaSingleChainSolanaPreparedData
+  | DcaSingleChainSuiPreparedData;
 
 export type DcaSingleChainOrderPrepared = {
   order: DcaSingleChainOrder;

package/src/types/token-list.ts

@@ -22,8 +22,8 @@ export interface TokenInfo {
   name: string;
   chainId: number;
   decimals: number;
-  image: string;
-  isVerified: boolean;
+  image?: string;
+  isVerified?: boolean;
 }
 
 /** Paginated API response */

package/src/utils/base-validator.ts

@@ -32,10 +32,6 @@ export abstract class BaseValidator implements IChainValidator {
     this.validateAmount(order.amountIn);
     this.validateAmount(order.amountOutMin ?? 1n);
 
-    if (order.stopLossMaxOut) {
-      this.validateAmount(order.stopLossMaxOut);
-    }
-
     if (order.takeProfitMinOut) {
       this.validateAmount(order.takeProfitMinOut);
     }

package/src/utils/defillama.ts

@@ -40,6 +40,8 @@ export const chainIdToDefiLlamaChainMap = {
   [ChainID.Hyperliquid]: 'hyperliquid',
   [ChainID.Solana]: 'solana',
   [ChainID.Sui]: 'sui',
+  [ChainID.BSC]: 'bsc',
+  [ChainID.MONAD]: 'monad',
 } as const;
 
 /**

package/src/utils/generate-execution-details-hash.ts

@@ -1,34 +1,13 @@
-import { createHash } from "crypto";
-import type { ExtraTransfer } from "../core/orders/common.js";
-import { Parsers } from "./parsers.js";
+import { createHash } from 'crypto';
 
-export function generateExecutionDetailsHash({
-  destChainId,
-  destinationAddress,
-  tokenOut,
-  amountOutMin,
-  stopLossMaxOut,
-  takeProfitMinOut,
-  extraTransfers,
-}: {
-  destChainId: number,
-  destinationAddress: string,
-  tokenOut: string,
-  amountOutMin: string,
-  stopLossMaxOut?: string,
-  takeProfitMinOut?: string,
-  extraTransfers?: ExtraTransfer[],
-}
-): string {
-  const executionDetails = JSON.stringify({
-    destChainId,
-    destinationAddress,
-    tokenOut,
-    amountOutMin,
-    stopLossMaxOut,
-    takeProfitMinOut,
-    extraTransfers,
-  }, Parsers.bigIntReplacer);
-  
-  return "0x" + createHash('sha256').update(executionDetails).digest('hex');
+/**
+ * Computes the SHA-256 hash the auctioneer expects for cross-chain execution details.
+ *
+ * The auctioneer recomputes sha256 over the exact `executionDetails` JSON string it
+ * receives and rejects the order when it differs (hash mismatch). Callers therefore MUST
+ * hash the same serialized string they send on the wire — pass that string here directly
+ * instead of re-serializing a parallel object, which is how key-order/field drift creeps in.
+ */
+export function generateExecutionDetailsHash(executionDetails: string): string {
+  return '0x' + createHash('sha256').update(executionDetails).digest('hex');
 }

package/src/utils/quote/address.ts

@@ -0,0 +1,4 @@
+/** Case-insensitive address equality; false if either address is missing. */
+export function compareAddresses(firstAddress?: string, secondAddress?: string): boolean {
+  return !!firstAddress && !!secondAddress && firstAddress.toLowerCase() === secondAddress.toLowerCase();
+}