@shogun-sdk/intents-sdk 1.2.31 → 1.4.0

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

@@ -1,11 +1,16 @@
 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 './cross-chain-limit-order.js';
+import { generateExecutionDetailsHash } from '../../utils/generate-execution-details-hash.js';
+import { Parsers } from '../../utils/parsers.js';
 
 export type CreateSuiSingleChainLimitOrderIntentParams = {
   user: string;
@@ -18,8 +23,9 @@ export type CreateSuiSingleChainLimitOrderIntentParams = {
   deadline: number;
   transactionHash: string;
   secretNumber?: string;
-  stopLossMaxOut?: bigint;
   takeProfitMinOut?: bigint;
+  stopLossType?: StopLossType;
+  stopLossTriggerPrice?: string;
 };
 
 export type CreateSuiSingleChainDcaOrderIntentParams = {
@@ -50,8 +56,10 @@ export type CreateSuiCrossChainOrderIntentParams = {
   tokenOut: string;
   amountOutMin: bigint;
   transactionHash: string;
-  stopLossMaxOut?: bigint;
   takeProfitMinOut?: bigint;
+  stopLossType?: StopLossType;
+  stopLossTriggerPrice?: string;
+  extraTransfers?: ExtraTransfer[];
 };
 
 /**
@@ -60,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,
@@ -74,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 {
@@ -95,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,
@@ -131,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 = JSON.stringify({
+  const executionDetails = {
     destChainId: params.destChainId,
     tokenOut: params.tokenOut,
-    amountOutMin: params.amountOutMin,
+    amountOutMin: params.amountOutMin.toString(),
     destinationAddress: params.destinationAddress,
-  });
+    takeProfitMinOut: params.takeProfitMinOut?.toString(),
+    stopLossType: params.stopLossType,
+    stopLossTriggerPrice: params.stopLossTriggerPrice,
+    extraTransfers: params.extraTransfers,
+  };
+  const executionDetailsString = JSON.stringify(executionDetails, Parsers.bigIntReplacer);
 
-  const executionDetailsHash = generateExecutionDetailsHash(
-    params.destChainId,
-    params.destinationAddress,
-    params.tokenOut,
-    params.amountOutMin.toString()
-  );
+  // 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,
@@ -155,13 +166,12 @@ export function createSuiCrossChainOrderIntentRequest(
     minStablecoinsAmount: params.minStablecoinsAmount,
     deadline: params.deadline,
     executionDetailsHash: executionDetailsHash as `0x${string}`,
-    stopLossMaxOut: params.stopLossMaxOut,
-    takeProfitMinOut: params.takeProfitMinOut,
+    extraTransfers: params.extraTransfers,
   };
 
   return {
     genericData,
-    executionDetails,
+    executionDetails: executionDetailsString,
     chainSpecificData: {
       Sui: {
         transactionHash: params.transactionHash,
@@ -182,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,
@@ -214,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,
@@ -50,8 +53,12 @@ export {
 export { getSuiOrderTransaction } from './core/sui/order-transaction.js';
 export { getSuiCancelCrossChainOrder } from './core/sui/cancel.js';
 export { getDcaSecretHash, getSuiSingleChainDcaOrderTransaction } from './core/sui/single-chain-dca-order.js';
-export { getSecretHash, getRandomU64Number as getSuiRandomU64Number, getSuiSingleChainLimitOrderTransaction } from './core/sui/single-chain-limit-order.js';
-export { generateExecutionDetailsHash } from './core/sui/cross-chain-limit-order.js';
+export {
+  getSecretHash,
+  getRandomU64Number as getSuiRandomU64Number,
+  getSuiSingleChainLimitOrderTransaction,
+} from './core/sui/single-chain-limit-order.js';
+export { generateExecutionDetailsHash } from './utils/generate-execution-details-hash.js';
 export {
   createSuiSingleChainLimitOrderIntentRequest,
   createSuiSingleChainDcaOrderIntentRequest,
@@ -63,33 +70,39 @@ export {
   type CreateSuiCrossChainOrderIntentParams,
 } from './core/sui/intent-helpers.js';
 
-export * from './constants.js'
+export * from './constants.js';
 
 export { getSolanaDcaSingleChainOrderInstructions } from './core/solana/dca/create-order.js';
 
 export { signSingleChainDcaOrder } from './core/evm/single-chain-dca-order.js';
 export { signSingleChainLimitOrder } from './core/evm/single-chain-limit-order.js';
 
-export { QuoteProvider } from './utils/quote/aggregator.js';
-export type { QuoteResponse } from './utils/quote/aggregator.js';
+export { QuoteProvider, type IntentsQuoteParams, type QuoteResponse } from './utils/quote/aggregator.js';
 
 export { CROSS_CHAIN_GUARD_ADDRESSES, SINGLE_CHAIN_GUARD_ADDRESSES, PERMIT2_ADDRESS } from './constants.js';
 
-export { prepareDcaSecretData, } from './core/solana/dca/single-chain-dca-order.js'
-export { prepareSecretData } from './core/solana/dca/single-chain-limit-order.js'
+export { prepareDcaSecretData } from './core/solana/dca/single-chain-dca-order.js';
+export { prepareSecretData } from './core/solana/dca/single-chain-limit-order.js';
+
+// Token List and Search Helper
+export { getTokenList } from './utils/tokens/index.js';
+export { type TokenSearchParams, type TokenInfo, type TokenSearchResponse } from './types/token-list.js';
 
 // EVM Intent Helpers
 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';
 
@@ -19,6 +19,13 @@ export type ExecutionDetails = {
   destinationAddress: string;
   /** Extra transfers to be made */
   extraTransfers?: ExtraTransfer[];
+
+  /** 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;
 };
 
 export type Hash = `0x${string}`;
@@ -65,8 +72,6 @@ export type SourceChainData = {
   deadline: number;
   /** Hash of execution details for cross-chain verification */
   executionDetailsHash: ExecutionDetailsHash;
-  stopLossMaxOut?: bigint;
-  takeProfitMinOut?: bigint;
   extraTransfers?: ExtraTransfer[];
 };
 
@@ -84,7 +89,6 @@ export type CrossChainUserIntentRequest = {
     /** Sui-specific data */
     Sui?: SuiPreparedData;
   };
-  
 };
 
 export type SingleChainUserIntentRequest = {
@@ -96,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 = {
@@ -152,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

@@ -0,0 +1,35 @@
+export interface TokenSearchParams {
+  /** Optional: search phrase (symbol, token name, or address) */
+  q?: string;
+
+  /** Optional: Chain ID filter (e.g. 8453 = Base, 42161 = Arbitrum, 7565164 = Solana, 101 = Sui) */
+  networkId?: number;
+
+  /** Optional: page number for pagination (default = 1) */
+  page?: number;
+
+  /** Optional: number of results per page (default = 20) */
+  limit?: number;
+
+  /** Optional: Abort signal to cancel requests (useful in UI search inputs) */
+  signal?: AbortSignal;
+}
+
+/** Normalized token shape returned by the API */
+export interface TokenInfo {
+  address: string;
+  symbol: string;
+  name: string;
+  chainId: number;
+  decimals: number;
+  image?: string;
+  isVerified?: boolean;
+}
+
+/** Paginated API response */
+export interface TokenSearchResponse {
+  count: number;
+  page: number;
+  limit: number;
+  results: TokenInfo[];
+}

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

@@ -0,0 +1,13 @@
+import { createHash } from 'crypto';
+
+/**
+ * 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();
+}