TypeScript Types

type TradeQuotesRequest = {
  fromChain: number;
  gasless?: boolean;
  private?: boolean;
  data: TradeQuotesRequestData[];
  disableEstimation?: boolean;
  account?: string;
  bridges?: ProtocolFilter;
  dexes?: ProtocolFilter;
  filter?: QuoteFilter;
  timingStrategy?: Partial<{ minWaitTimeMs; maxWaitTimeMs; subsequentDelayMs; preferredResultCount; relaxMinSuccessOnDelay }>;
};

type TradeQuotesRequestData = {
  amount: string;        // wei as string
  srcToken: string;
  srcDecimals?: number;
  destToken: string;
  destDecimals?: number;
  toChain: number;
  slippage: number;
  selectedSource?: string;
};

type TradeQuotesResponse = {
  [pair: string]: {
    status?: string;
    message?: string;
    recommendedSource: string;
    fastestSource?: string;
    bestReturnSource: string;
    questSource?: string;
    quoteRates?: TradeQuotesByProviderId;
    tokensWithoutPrice: Record<number, string[]>;
  };
};

type TradeBuildTxnRequest = {
  sender: HexString;
  refundee: HexString;
  fromChain: number;
  gasless: boolean;
  private?: boolean;
  disableEstimation?: boolean;
  data: TradeBuildTxnRequestData[];
  hasPermit2ApprovalForAllTokens?: boolean;
  publicKey?: string; // Bitcoin chains only
};

type TradeBuildTxnRequestData = {
  amount: string;
  srcToken: string;
  srcDecimals?: number;
  destToken: string;
  destDecimals?: number;
  toChain: number;
  protocol: string;   // from quote recommendedSource or bestReturnSource
  recipient: string;
  slippage: number;
  additionalInfo?: AdditionalInfo;
  permitData?: string;
};

type TradeBuildTxnResponse = {
  status: "success";
  txId: string;        // Build/transaction ID
  chainId: number;
  transaction: EvmTxData | SvmTxData | BtcTxData | BtclnTxData | HyperLiquidTxData;
  gasless: false;
  private: boolean;
  quotes: Record<string, ParamQuotes>;

  // @deprecated top-level mirror of transaction, EVM only:
  data: string;
  from: string;
  to?: string;
  value?: string;
  gasLimit?: string;

  svmTxData?: { blockhash: string; lastValidBlockHeight: number };
  btcTxData?: { inputs: PsbtInput[]; outputs: PsbtOutput[]; feeRate: number };
  btclnTxData?: { paymentRequestType: "bolt11"; paymentRequest: string; paymentExpiry: number };
  additionalInfo: Record<string, Record<string, unknown>>;
  updatedQuotes: Record<string, string>;
};

type EvmTxData = { from: HexString; data: HexString; to: HexString; value: string; gasLimit: string };

type ParamQuotes = {
  additionalInfo?: Record<string, unknown>;
  destAmount: string;
  provider: string;
  minDestAmount: string;
  priceImpact?: string | null;
  duration?: string;
};

type GaslessTradeBuildTxnResponse = {
  status: "success";
  txId: HexString;
  transaction: BridgeGaslessTxData | SwapGaslessTxData;
  quotes: Record<string, ParamQuotes>;
  gasless: true;
  onlySwapData: false;
};

type DZapTransactionResponse = {
  status: TxnStatus;
  errorMsg?: string;
  code: StatusCodes | number;
  action?: "TRY_ANOTHER_ROUTE" | "INCREASE_SLIPPAGE" | "INCREASE_ALLOWANCE";
  txnHash?: HexString;
  error?: unknown;
  additionalInfo?: Record<string, unknown>;
  updatedQuotes?: Record<string, string>;
};

// data shape (per token address)
type AllowanceDataEntry = {
  allowance: bigint;
  type: "dzap" | "permit2" | "eip2612";
};

// Example: check if any token needs an on-chain approval
const data = allowanceCheck.data ?? {};
const needsApproval = tokens.some((t) => {
  const entry = data[t.address];
  return entry && entry.type !== "eip2612" && entry.allowance < BigInt(t.amount);
});
// "permit2" and "eip2612" types both additionally require a sign() call before executing
const needsSignature = tokens.some((t) => data[t.address]?.type !== "dzap");