feat(renegade): rebuild integration for v2 rfq flow

Author: sehyunc

src/dex/renegade/api/renegade-client.ts

@@ -1,15 +1,12 @@
-// RenegadeClient - Client for Renegade match endpoint API
-// Handles authentication and HTTP requests to Renegade's external match endpoint.
-
 import { Network } from '../../../constants';
 import { IDexHelper } from '../../../dex-helper/idex-helper';
 import { Logger } from '../../../types';
 import { generateRenegadeAuthHeaders } from './auth';
 import {
-  buildRenegadeApiUrl,
+  buildRenegadeV2ApiUrl,
   RENEGADE_API_TIMEOUT_MS,
-  RENEGADE_QUOTE_ENDPOINT,
   RENEGADE_ASSEMBLE_ENDPOINT,
+  RENEGADE_QUOTE_ENDPOINT,
 } from '../constants';
 import {
   AssembleExternalMatchRequest,
@@ -21,13 +18,11 @@ import {
   SponsoredQuoteResponse,
 } from './types';
 
-// Default headers for Renegade API requests
 const DEFAULT_RENEGADE_HEADERS: Record<string, string> = {
   'content-type': 'application/json',
-  accept: 'application/json;number=string',
+  accept: 'application/json',
 };
 
-// Client for interacting with Renegade match endpoint API
 export class RenegadeClient {
   private readonly baseUrl: string;
 
@@ -38,10 +33,9 @@ export class RenegadeClient {
     private readonly apiSecret: string,
     private readonly logger: Logger,
   ) {
-    this.baseUrl = buildRenegadeApiUrl(this.network);
+    this.baseUrl = buildRenegadeV2ApiUrl(this.network);
   }
 
-  // Request a quote from Renegade API
   async requestQuote(
     externalOrder: ExternalOrder,
     queryParams?: QuoteQueryParams,
@@ -65,40 +59,50 @@ export class RenegadeClient {
 
     this.logger.debug('Requesting quote from Renegade API', {
       url: quoteUrl,
-      order: externalOrder,
+      externalOrder,
       queryParams,
     });
 
-    const response: SponsoredQuoteResponse =
-      await this.dexHelper.httpRequest.post(
+    try {
+      return await this.dexHelper.httpRequest.post(
         quoteUrl,
         requestBody,
         RENEGADE_API_TIMEOUT_MS,
         headers,
       );
-
-    return response;
+    } catch (e: any) {
+      this.logger.error('Renegade quote request failed', {
+        url: quoteUrl,
+        requestBody,
+        status: e?.response?.status,
+        responseData: e?.response?.data,
+      });
+      throw e;
+    }
   }
 
-  // Assemble an external match from a signed quote
   async assembleExternalMatch(
     signedQuote: SignedExternalQuote,
-    queryParams?: QuoteQueryParams & {
-      updated_order?: ExternalOrder | null;
+    options?: {
+      updatedOrder?: ExternalOrder | null;
+      receiverAddress?: string | null;
+      queryParams?: QuoteQueryParams;
+      doGasEstimation?: boolean;
     },
   ): Promise<SponsoredMatchResponse> {
     const requestBody: AssembleExternalMatchRequest = {
-      signed_quote: signedQuote,
+      do_gas_estimation: options?.doGasEstimation ?? false,
+      receiver_address: options?.receiverAddress,
+      order: {
+        type: 'quoted-order',
+        signed_quote: signedQuote,
+        updated_order: options?.updatedOrder,
+      },
     };
 
-    if (queryParams?.updated_order !== undefined) {
-      requestBody.updated_order = queryParams.updated_order;
-    }
-
-    const { updated_order, ...urlQueryParams } = queryParams || {};
     const { url: assembleUrl, pathWithQuery } = this.buildUrlWithQueryParams(
       RENEGADE_ASSEMBLE_ENDPOINT,
-      urlQueryParams,
+      options?.queryParams,
     );
 
     const headers = generateRenegadeAuthHeaders(
@@ -111,25 +115,27 @@ export class RenegadeClient {
 
     this.logger.debug('Assembling external match from Renegade API', {
       url: assembleUrl,
-      queryParams,
+      options,
     });
 
-    const response: SponsoredMatchResponse =
-      await this.dexHelper.httpRequest.post(
+    try {
+      return await this.dexHelper.httpRequest.post(
         assembleUrl,
         requestBody,
         RENEGADE_API_TIMEOUT_MS,
         headers,
       );
-
-    this.logger.debug(
-      'Assembled external match from Renegade API',
-      JSON.stringify(response, null, 2),
-    );
-
-    return response;
+    } catch (e: any) {
+      this.logger.error('Renegade assemble request failed', {
+        url: assembleUrl,
+        requestBody,
+        status: e?.response?.status,
+        responseData: e?.response?.data,
+      });
+      throw e;
+    }
   }
-  // Build URL with query parameters from endpoint path and optional query params
+
   private buildUrlWithQueryParams(
     endpoint: string,
     queryParams?: QuoteQueryParams,
@@ -144,6 +150,7 @@ export class RenegadeClient {
       }
       url.search = searchParams.toString();
     }
+
     return {
       url: url.toString(),
       pathWithQuery: url.pathname + url.search,

src/dex/renegade/api/types.ts

@@ -1,121 +1,82 @@
-// Request body for assemble external match endpoint
-export type AssembleExternalMatchRequest = {
-  signed_quote: SignedExternalQuote;
-  do_gas_estimation?: boolean;
-  allow_shared?: boolean;
-  matching_pool?: string;
-  relayer_fee_rate?: number;
-  receiver_address?: string | null;
-  updated_order?: ExternalOrder | null;
+export type QuoteQueryParams = {
+  disable_gas_sponsorship?: boolean;
+  refund_address?: string;
+  refund_native_eth?: boolean;
 };
 
-// External order structure for Renegade match requests
 export type ExternalOrder = {
-  quote_mint: string;
-  base_mint: string;
-  side: 'Buy' | 'Sell';
-  base_amount: string;
-  quote_amount: string;
-  exact_base_output: string;
-  exact_quote_output: string;
+  input_mint: string;
+  output_mint: string;
+  input_amount: string;
+  output_amount: string;
+  use_exact_output_amount: boolean;
   min_fill_size: string;
 };
 
-// Request body for quote endpoint
 export type ExternalQuoteRequest = {
   external_order: ExternalOrder;
-  matching_pool?: string;
-  relayer_fee_rate?: number;
-};
-
-// Quote with signature binding it to the relayer
-export type SignedExternalQuote = {
-  quote: ApiExternalQuote;
-  signature: string;
-};
-
-// Response from assemble endpoint
-export type SponsoredMatchResponse = {
-  match_bundle: AtomicMatchApiBundle;
-  is_sponsored: boolean;
-  gas_sponsorship_info?: GasSponsorshipInfo | null;
-};
-
-// Response from quote endpoint with signed quote and optional sponsorship
-export type SponsoredQuoteResponse = {
-  signed_quote: SignedExternalQuote;
-  gas_sponsorship_info?: SignedGasSponsorshipInfo | null;
 };
 
-// Optional query parameters for quote and assembly endpoints
-export type QuoteQueryParams = {
-  disable_gas_sponsorship?: boolean;
-  refund_address?: string;
-  refund_native_eth?: boolean;
-  use_gas_sponsorship?: boolean;
-};
-
-// Represents a token transfer with mint address and amount
-type ApiExternalAssetTransfer = {
+type AssetTransfer = {
   mint: string;
   amount: string;
 };
 
-// Match result with quote/base mints, amounts, and direction
-type ApiExternalMatchResult = {
-  quote_mint: string;
-  base_mint: string;
-  quote_amount: string;
-  base_amount: string;
-  direction: 'Buy' | 'Sell';
+type ExternalQuote = {
+  order: ExternalOrder;
+  send: AssetTransfer;
+  receive: AssetTransfer;
 };
 
-// Price with timestamp
-type ApiTimestampedPrice = {
-  price: string;
-  timestamp: number;
+export type SignedExternalQuote = {
+  quote: ExternalQuote;
+  signature: string;
+  deadline: number | string;
 };
 
-// Complete match bundle with settlement transaction
-type AtomicMatchApiBundle = {
-  match_result: ApiExternalMatchResult;
-  fees: FeeTake;
-  receive: ApiExternalAssetTransfer;
-  send: ApiExternalAssetTransfer;
-  settlement_tx: TransactionRequest;
+export type SponsoredQuoteResponse = {
+  signed_quote: SignedExternalQuote;
+  gas_sponsorship_info?: {
+    refund_amount: string;
+    refund_native_eth: boolean;
+    refund_address: string | null;
+  } | null;
 };
 
-// Complete quote structure with order, match result, fees, and pricing
-type ApiExternalQuote = {
-  order: ExternalOrder;
-  match_result: ApiExternalMatchResult;
-  fees: FeeTake;
-  send: ApiExternalAssetTransfer;
-  receive: ApiExternalAssetTransfer;
-  price: ApiTimestampedPrice;
-  timestamp: number;
+type QuotedOrderAssembly = {
+  type: 'quoted-order';
+  signed_quote: SignedExternalQuote;
+  updated_order?: ExternalOrder | null;
 };
 
-// Relayer and protocol fees
-type FeeTake = {
-  relayer_fee: string;
-  protocol_fee: string;
+type DirectOrderAssembly = {
+  type: 'direct-order';
+  external_order: ExternalOrder;
 };
 
-// Gas refund details
-type GasSponsorshipInfo = {
-  refund_amount: string;
-  refund_native_eth: boolean;
-  refund_address: string | null;
+export type AssembleExternalMatchRequest = {
+  do_gas_estimation?: boolean;
+  receiver_address?: string | null;
+  order: QuotedOrderAssembly | DirectOrderAssembly;
 };
 
-// Signed gas sponsorship info (deprecated signature field)
-type SignedGasSponsorshipInfo = {
-  gas_sponsorship_info: GasSponsorshipInfo;
-  signature: string; // deprecated
+export type SponsoredMatchResponse = {
+  match_bundle: {
+    min_receive: AssetTransfer;
+    max_receive: AssetTransfer;
+    min_send: AssetTransfer;
+    max_send: AssetTransfer;
+    deadline: number | string;
+    settlement_tx: TransactionRequest;
+  };
+  input_amount?: string | null;
+  gas_sponsorship_info?: {
+    refund_amount: string;
+    refund_native_eth: boolean;
+    refund_address: string | null;
+  } | null;
 };
 
-// EIP-1559 / EIP-4844 aware transaction request
 type TransactionRequest = {
   from?: string | null;
   to?: string | null;
@@ -135,6 +96,6 @@ type TransactionRequest = {
   }>;
   type?: string;
   blobVersionedHashes?: string[];
-  sidecar?: Record<string, any>;
-  authorizationList?: Array<Record<string, any>>;
+  sidecar?: Record<string, unknown>;
+  authorizationList?: Array<Record<string, unknown>>;
 };

src/dex/renegade/constants.ts

@@ -3,24 +3,40 @@ import { Network } from '../../constants';
 
 export const RENEGADE_NAME = 'Renegade';
 
-// Base API URLs for each network
-export const RENEGADE_ARBITRUM_BASE_URL =
+// Legacy RFQT host (used for levels polling only).
+export const RENEGADE_ARBITRUM_RFQT_BASE_URL =
   'https://arbitrum-one.auth-server.renegade.fi';
-export const RENEGADE_BASE_BASE_URL =
+export const RENEGADE_BASE_RFQT_BASE_URL =
   'https://base-mainnet.auth-server.renegade.fi';
 
+// V2 host (used for external match quote/assemble).
+export const RENEGADE_ARBITRUM_V2_BASE_URL =
+  'https://arbitrum-one.v2.auth-server.renegade.fi';
+export const RENEGADE_BASE_V2_BASE_URL =
+  'https://base-mainnet.v2.auth-server.renegade.fi';
+
 export const RENEGADE_LEVELS_ENDPOINT = '/rfqt/v3/levels';
-export const RENEGADE_QUOTE_ENDPOINT = '/v0/matching-engine/quote';
+export const RENEGADE_QUOTE_ENDPOINT = '/v2/external-matches/get-quote';
 export const RENEGADE_ASSEMBLE_ENDPOINT =
-  '/v0/matching-engine/assemble-external-match';
+  '/v2/external-matches/assemble-match-bundle';
+
+export function buildRenegadeRfqtApiUrl(network: Network): string {
+  switch (network) {
+    case Network.ARBITRUM:
+      return RENEGADE_ARBITRUM_RFQT_BASE_URL;
+    case Network.BASE:
+      return RENEGADE_BASE_RFQT_BASE_URL;
+    default:
+      throw new Error(`Network ${network} is not supported by Renegade`);
+  }
+}
 
-// Get Renegade API base URL for a specific network.
-export function buildRenegadeApiUrl(network: Network): string {
+export function buildRenegadeV2ApiUrl(network: Network): string {
   switch (network) {
     case Network.ARBITRUM:
-      return RENEGADE_ARBITRUM_BASE_URL;
+      return RENEGADE_ARBITRUM_V2_BASE_URL;
     case Network.BASE:
-      return RENEGADE_BASE_BASE_URL;
+      return RENEGADE_BASE_V2_BASE_URL;
     default:
       throw new Error(`Network ${network} is not supported by Renegade`);
   }
@@ -35,9 +51,6 @@ export const RENEGADE_TOKEN_METADATA_CACHE_TTL_SECONDS = 24 * 60 * 60; // 24 hou
 export const RENEGADE_TOKEN_METADATA_POLLING_INTERVAL = 24 * 60 * 60 * 1000; // 24 hours
 export const RENEGADE_TOKEN_METADATA_CACHE_KEY = 'renegade_token_metadata';
 
-export const RENEGADE_QUOTE_CACHE_TTL_SECONDS = 5;
-export const RENEGADE_QUOTE_CACHE_KEY = 'renegade_quote';
-
 // API timeout settings
 export const RENEGADE_API_TIMEOUT_MS = 10_000;
 export const RENEGADE_INIT_TIMEOUT_MS = 5_000;