@tcswap/helpers 4.5.15

package/src/api/thornode/types.ts

@@ -0,0 +1,247 @@
+export type THORNodeType = "thorchain" | "mayachain";
+
+export type THORNodeTNSDetails = {
+  name: string;
+  expire_block_height: number;
+  owner: string;
+  preferred_asset: string;
+  affiliate_collector_rune: string;
+  aliases: { chain: string; address: string }[];
+};
+
+export type InboundAddressesItem = {
+  address: string;
+  chain: string;
+  gas_rate?: string;
+  halted: boolean;
+  pub_key: string;
+  router?: string;
+  global_trading_paused: boolean;
+  chain_trading_paused: boolean;
+  chain_lp_actions_paused: boolean;
+  observed_fee_rate?: string;
+  gas_rate_units: string;
+  outbound_tx_size: string;
+  outbound_fee: string;
+  dust_threshold: string;
+};
+
+export type LastBlockItem<T extends THORNodeType = "thorchain"> = {
+  chain: string;
+  last_observed_in: number;
+  last_signed_out: number;
+} & {
+  [K in T]: number;
+};
+
+export type NodeItem = {
+  active_block_height: number;
+  bond_address: string;
+  current_award: string;
+  forced_to_leave: boolean;
+  ip_address: string;
+  leave_height: number;
+  node_address: string;
+  requested_to_leave: boolean;
+  signer_membership: string[];
+  slash_points: number;
+  status: string;
+  status_since: number;
+  total_bond: string;
+  validator_cons_pub_key: string;
+  version: string;
+  jail: any;
+  preflight_status: any;
+  pub_key_set: any;
+  observe_chains: { chain: string; height: number }[];
+};
+
+export type MimirData = {
+  ADR012: number;
+  ASGARDSIZE: number;
+  BADVALIDATORREDLINE: number;
+  BURNSYNTHS: number;
+  CHURNINTERVAL: number;
+  CLOUTLIMIT: number;
+  CONFMULTIPLIERBASISPOINTS: number;
+  DEPRECATEILP: number;
+  DERIVEDDEPTHBASISPTS: number;
+  DERIVEDMINDEPTH: number;
+  DESIREDVALIDATORSET: number;
+  DYNAMICMAXANCHORTARGET: number;
+  EMISSIONCURVE: number;
+  ENABLEAVAXCHAIN: number;
+  ENABLEBSC: number;
+  ENABLESAVINGSVAULTS: number;
+  FULLIMPLOSSPROTECTIONBLOCKS: number;
+  FUNDMIGRATIONINTERVAL: number;
+  HALTAVAXCHAIN: number;
+  HALTAVAXTRADING: number;
+  HALTBCHCHAIN: number;
+  HALTBCHTRADING: number;
+  HALTBSCCHAIN: number;
+  HALTBSCTRADING: number;
+  HALTBTCCHAIN: number;
+  HALTBTCTRADING: number;
+  HALTCHAINGLOBAL: number;
+  HALTCHURNING: number;
+  HALTDOGECHAIN: number;
+  HALTDOGETRADING: number;
+  HALTETHCHAIN: number;
+  HALTETHTRADING: number;
+  HALTGAIACHAIN: number;
+  HALTGAIATRADING: number;
+  HALTLTCCHAIN: number;
+  HALTLTCTRADING: number;
+  HALTSIGNING: number;
+  HALTSIGNINGAVAX: number;
+  HALTSIGNINGBCH: number;
+  HALTSIGNINGBSC: number;
+  HALTSIGNINGBTC: number;
+  HALTSIGNINGDOGE: number;
+  HALTSIGNINGETH: number;
+  HALTSIGNINGGAIA: number;
+  HALTSIGNINGLTC: number;
+  HALTSIGNINGTERRA: number;
+  HALTTERRACHAIN: number;
+  HALTTERRATRADING: number;
+  HALTTHORCHAIN: number;
+  HALTTRADING: number;
+  ILPCUTOFF: number;
+  KEYGENRETRYINTERVAL: number;
+  KILLSWITCHSTART: number;
+  "LENDING-THOR-BTC": number;
+  "LENDING-THOR-ETH": number;
+  LENDINGLEVER: number;
+  LOANREPAYMENTMATURITY: number;
+  LOANSTREAMINGSWAPSINTERVAL: number;
+  MAXANCHORBLOCKS: number;
+  MAXANCHORSLIP: number;
+  MAXBONDPROVIDERS: number;
+  MAXCONFIRMATIONS: number;
+  MAXCR: number;
+  MAXIMUMLIQUIDITYRUNE: number;
+  MAXNODETOCHURNOUTFORLOWVERSION: number;
+  MAXOUTBOUNDATTEMPTS: number;
+  MAXOUTBOUNDFEEMULTIPLIERBASISPOINTS: number;
+  MAXRUNESUPPLY: number;
+  MAXSYNTHPERPOOLDEPTH: number;
+  MAXSYNTHSFORSAVERSYIELD: number;
+  MAXUTXOSTOSPEND: number;
+  MINCR: number;
+  MINIMUMBONDINRUNE: number;
+  MINIMUML1OUTBOUNDFEEUSD: number;
+  MINOUTBOUNDFEEMULTIPLIERBASISPOINTS: number;
+  MINRUNEPOOLDEPTH: number;
+  MINTSYNTHS: number;
+  NODEOPERATORFEE: number;
+  NODEPAUSECHAINGLOBAL: number;
+  NUMBEROFNEWNODESPERCHURN: number;
+  OBSERVATIONDELAYFLEXIBILITY: number;
+  "PAUSEASYMWITHDRAWAL-TERRA": number;
+  PAUSELOANS: number;
+  PAUSELP: number;
+  PAUSELPAVAX: number;
+  PAUSELPBCH: number;
+  PAUSELPBSC: number;
+  PAUSELPBTC: number;
+  PAUSELPDOGE: number;
+  PAUSELPETH: number;
+  PAUSELPGAIA: number;
+  PAUSELPLTC: number;
+  PAUSELPTERRA: number;
+  PAUSEUNBOND: number;
+  PENDINGLIQUIDITYAGELIMIT: number;
+  "POL-AVAX-AVAX": number;
+  "POL-AVAX-USDC-0XB97EF9EF8734C71904D8002F8B6BC66DD9C48A6E": number;
+  "POL-BCH-BCH": number;
+  "POL-BSC-USDC-0X8AC76A51CC950D9822D68B83FE1AD97B32CD580D": number;
+  "POL-BTC-BTC": number;
+  "POL-DOGE-DOGE": number;
+  "POL-ETH-DAI-0X6B175474E89094C44DA98B954EEDEAC495271D0F": number;
+  "POL-ETH-ETH": number;
+  "POL-ETH-USDC-0XA0B86991C6218B36C1D19D4A2E9EB0CE3606EB48": number;
+  "POL-ETH-USDT-0XDAC17F958D2EE523A2206206994597C13D831EC7": number;
+  "POL-GAIA-ATOM": number;
+  "POL-LTC-LTC": number;
+  POLBUFFER: number;
+  POLMAXNETWORKDEPOSIT: number;
+  POLMAXPOOLMOVEMENT: number;
+  POLTARGETSYNTHPERPOOLDEPTH: number;
+  POOLCYCLE: number;
+  POOLDEPTHFORYGGFUNDINGMIN: number;
+  PREFERREDASSETOUTBOUNDFEEMULTIPLIER: number;
+  RESCHEDULECOALESCEBLOCKS: number;
+  SAVERSSTREAMINGSWAPSINTERVAL: number;
+  SIGNERCONCURRENCY: number;
+  SLASHPENALTY: number;
+  SOLVENCYHALTAVAXCHAIN: number;
+  SOLVENCYHALTBCHCHAIN: number;
+  SOLVENCYHALTBSCCHAIN: number;
+  SOLVENCYHALTDOGECHAIN: number;
+  SOLVENCYHALTETHCHAIN: number;
+  SOLVENCYHALTGAIACHAIN: number;
+  SOLVENCYHALTTERRACHAIN: number;
+  STOPFUNDYGGDRASIL: number;
+  STOPSOLVENCYCHECK: number;
+  STOPSOLVENCYCHECKAVAX: number;
+  STOPSOLVENCYCHECKBSC: number;
+  STOPSOLVENCYCHECKDOGE: number;
+  STOPSOLVENCYCHECKETH: number;
+  STOPSOLVENCYCHECKGAIA: number;
+  STOPSOLVENCYCHECKTERRA: number;
+  STREAMINGSWAPMINBPFEE: number;
+  SYNTHYIELDBASISPOINTS: number;
+  THORNAMES: number;
+  "TORANCHOR-AVAX-USDC-0XB97EF9EF8734C71904D8002F8B6BC66DD9C48A6E": number;
+  "TORANCHOR-AVAX-USDT-0X9702230A8EA53601F5CD2DC00FDBC13D4DF4A8C7": number;
+  "TORANCHOR-BSC-USDC-0X8AC76A51CC950D9822D68B83FE1AD97B32CD580D": number;
+  "TORANCHOR-ETH-DAI-0X6B175474E89094C44DA98B954EEDEAC495271D0F": number;
+  "TORANCHOR-ETH-USDC-0XA0B86991C6218B36C1D19D4A2E9EB0CE3606EB48": number;
+  "TORANCHOR-ETH-USDT-0XDAC17F958D2EE523A2206206994597C13D831EC7": number;
+  TXOUTDELAYRATE: number;
+  VIRTUALMULTSYNTHS: number;
+  VOTEDOFM: number;
+  VOTELENDING: number;
+  VOTEMAXSYNTHSFORSAVERSYIELD: number;
+  YGGFUNDLIMIT: number;
+  YGGFUNDRETRY: number;
+};
+
+export type RunePoolInfo = {
+  pol: { rune_deposited: string; rune_withdrawn: string; value: string; pnl: string; current_deposit: string };
+  providers: {
+    units: string;
+    pending_units: string;
+    pending_rune: string;
+    value: string;
+    pnl: string;
+    current_deposit: string;
+  };
+  reserve: { units: string; value: string; pnl: string; current_deposit: string };
+};
+
+export type RunePoolProviderInfo = {
+  rune_address: string;
+  units: string;
+  value: string;
+  pnl: string;
+  deposit_amount: string;
+  withdraw_amount: string;
+  last_deposit_height: number;
+  last_withdraw_height: number;
+};
+
+export type TCYStakerSummary = { amount: string };
+
+export type TCYStaker = { address?: string; amount: string };
+
+export type TCYStakerResponse = TCYStaker;
+export type TCYStakersResponse = TCYStakerSummary[];
+
+export type TCYClaimerSummary = { amount: string; asset: string };
+
+export type TCYClaimer = { l1_address?: string; amount: string; asset: string };
+
+export type TCYClaimerResponse = TCYClaimer;
+export type TCYClaimersResponse = TCYClaimerSummary[];

package/src/api/uswap/endpoints.ts

@@ -0,0 +1,252 @@
+/**
+ * Modifications © 2025 Horizontal Systems.
+ */
+
+import {
+  type Chain,
+  type EVMChain,
+  EVMChains,
+  isGasAsset,
+  type ProviderName,
+  RequestClient,
+  type RequestOptions,
+  USwapConfig,
+  USwapError,
+} from "@tcswap/helpers";
+import { match, P } from "ts-pattern";
+import {
+  type BalanceResponse,
+  type BrokerDepositChannelParams,
+  type DepositChannelResponse,
+  DepositChannelResponseSchema,
+  type GasResponse,
+  GasResponseSchema,
+  type NearDepositChannelParams,
+  type NearSwapResponse,
+  NearSwapResponseSchema,
+  type PriceRequest,
+  type PriceResponse,
+  PriceResponseSchema,
+  type QuoteRequest,
+  type QuoteResponse,
+  type QuoteResponseRoute,
+  QuoteResponseRouteItem,
+  QuoteResponseSchema,
+  type TokenListProvidersResponse,
+  type TokensResponseV2,
+  type TrackerResponse,
+  TrackerResponseSchema,
+  type TrackingRequest,
+} from "./types";
+
+const USwapRequestClient = RequestClient.extend({
+  dynamicHeader: () => {
+    const { uSwap } = USwapConfig.get("apiKeys");
+    return uSwap ? { "x-api-key": uSwap } : {};
+  },
+});
+
+export async function getTrackerDetails(json: TrackingRequest, options?: RequestOptions) {
+  const response = await USwapRequestClient.post<TrackerResponse>(getApiUrl("/track"), { json, ...options });
+
+  try {
+    const parsedResponse = TrackerResponseSchema.safeParse(response);
+
+    if (!parsedResponse.success) {
+      throw new USwapError("api_v2_invalid_response", parsedResponse.error);
+    }
+
+    return parsedResponse.data;
+  } catch (_error) {
+    // throw new USwapError("api_v2_invalid_response", error);
+    return response;
+  }
+}
+
+export async function getSwapQuote(json: QuoteRequest, options?: RequestOptions) {
+  const { getQuote } = USwapConfig.get("endpoints");
+
+  if (getQuote) return getQuote(json);
+
+  const response = await USwapRequestClient.post<QuoteResponse>(getApiUrl("/quote"), { json, ...options });
+
+  if (response.error) {
+    throw new USwapError("api_v2_server_error", { message: response.error });
+  }
+
+  try {
+    const parsedResponse = QuoteResponseSchema.safeParse(response);
+
+    if (!parsedResponse.success) {
+      throw new USwapError("api_v2_invalid_response", parsedResponse.error);
+    }
+
+    return parsedResponse.data;
+  } catch {
+    // throw new USwapError("api_v2_invalid_response", error);
+    return response;
+  }
+}
+
+export async function getRouteWithTx(json: { routeId: string; sourceAddress: string; destinationAddress: string }) {
+  const { getRouteWithTx } = USwapConfig.get("endpoints");
+
+  if (getRouteWithTx) return getRouteWithTx(json);
+
+  const response = await USwapRequestClient.post<QuoteResponseRoute>(getApiUrl("/swap"), { json });
+
+  try {
+    const parsedResponse = QuoteResponseRouteItem.safeParse(response);
+
+    if (!parsedResponse.success) {
+      throw new USwapError("api_v2_invalid_response", parsedResponse.error);
+    }
+
+    return parsedResponse.data;
+  } catch (error) {
+    console.error(new USwapError("api_v2_invalid_response", error));
+    return response;
+  }
+}
+
+export async function getChainBalance<T extends Chain>({
+  chain,
+  address,
+  scamFilter = true,
+}: {
+  chain: T;
+  address: string;
+  scamFilter?: boolean;
+}) {
+  const { getBalance } = USwapConfig.get("endpoints");
+  if (getBalance) return getBalance({ address, chain });
+
+  const url = getApiUrl(`/balance?chain=${chain}&address=${address}`);
+  const balanceResponse = await USwapRequestClient.get<BalanceResponse>(url);
+  const balances = Array.isArray(balanceResponse) ? balanceResponse : [];
+  return scamFilter ? filterAssets(balances) : balances;
+}
+
+export function getTokenListProviders() {
+  const url = getApiUrl("/providers");
+  return USwapRequestClient.get<TokenListProvidersResponse>(url);
+}
+
+export function getTokenList(provider: ProviderName) {
+  const url = getApiUrl(`/tokens?provider=${provider}`);
+  return USwapRequestClient.get<TokensResponseV2>(url);
+}
+
+export async function getPrice(body: PriceRequest) {
+  const url = getApiUrl("/price");
+  const response = await USwapRequestClient.post<PriceResponse>(url, { json: body });
+
+  try {
+    const parsedResponse = PriceResponseSchema.safeParse(response);
+
+    if (!parsedResponse.success) {
+      throw new USwapError("api_v2_invalid_response", parsedResponse.error);
+    }
+
+    return parsedResponse.data;
+  } catch (error) {
+    throw new USwapError("api_v2_invalid_response", error);
+  }
+}
+
+export async function getGasRate() {
+  const url = getApiUrl("/gas");
+  const response = await USwapRequestClient.get<GasResponse>(url);
+
+  try {
+    const parsedResponse = GasResponseSchema.safeParse(response);
+
+    if (!parsedResponse.success) {
+      throw new USwapError("api_v2_invalid_response", parsedResponse.error);
+    }
+
+    const gasRates = Array.isArray(parsedResponse) ? parsedResponse : [parsedResponse];
+    return gasRates;
+  } catch (error) {
+    throw new USwapError("api_v2_invalid_response", error);
+  }
+}
+
+export async function getChainflipDepositChannel(body: BrokerDepositChannelParams) {
+  const { destinationAddress } = body;
+
+  if (!destinationAddress) {
+    throw new USwapError("chainflip_broker_invalid_params");
+  }
+  const url = USwapConfig.get("integrations").chainflip?.brokerUrl || getApiUrl("/chainflip/broker/channel");
+
+  const response = await USwapRequestClient.post<DepositChannelResponse>(url, { json: body });
+
+  try {
+    const parsedResponse = DepositChannelResponseSchema.safeParse(response);
+
+    if (!parsedResponse.success) {
+      throw new USwapError("api_v2_invalid_response", parsedResponse.error);
+    }
+
+    return parsedResponse.data;
+  } catch (error) {
+    throw new USwapError("api_v2_invalid_response", error);
+  }
+}
+
+export async function getNearDepositChannel(body: NearDepositChannelParams) {
+  const { destinationAddress } = body;
+
+  if (!destinationAddress) {
+    throw new USwapError("chainflip_broker_invalid_params");
+  }
+  const url = getApiUrl("/near/channel");
+
+  const response = await USwapRequestClient.post<NearSwapResponse>(url, { json: body });
+
+  try {
+    const parsedResponse = NearSwapResponseSchema.safeParse(response);
+
+    if (!parsedResponse.success) {
+      throw new USwapError("api_v2_invalid_response", parsedResponse.error);
+    }
+
+    return parsedResponse.data;
+  } catch (error) {
+    throw new USwapError("api_v2_invalid_response", error);
+  }
+}
+
+function getApiUrl(path?: `/${string}`) {
+  const { isDev, apiUrl, devApiUrl, experimental_apiUrlQuote, experimental_apiUrlSwap } = USwapConfig.get("envs");
+
+  const defaultUrl = `${isDev ? devApiUrl : apiUrl}${path}`;
+
+  return match({ experimental_apiUrlQuote, experimental_apiUrlSwap, path })
+    .with(
+      { experimental_apiUrlQuote: P.string.startsWith("http"), path: "/quote" },
+      ({ experimental_apiUrlQuote, path }) => `${experimental_apiUrlQuote}${path}`,
+    )
+    .with(
+      { experimental_apiUrlSwap: P.string.startsWith("http"), path: "/swap" },
+      ({ experimental_apiUrlSwap, path }) => `${experimental_apiUrlSwap}${path}`,
+    )
+    .otherwise(() => defaultUrl);
+}
+
+function evmAssetHasAddress(assetString: string) {
+  const [chain, symbol] = assetString.split(".") as [EVMChain, string];
+  if (!EVMChains.includes(chain as EVMChain)) return true;
+  const splitSymbol = symbol.split("-");
+  const address = splitSymbol.length === 1 ? undefined : splitSymbol[splitSymbol.length - 1];
+
+  return isGasAsset({ chain: chain as Chain, symbol }) || !!address;
+}
+
+const potentialScamRegex = new RegExp(/(.)\1{6}|\.ORG|\.NET|\.FINANCE|\.COM|WWW|HTTP|\\\\|\/\/|[\s$%:[\]]/, "gmi");
+function filterAssets(tokens: BalanceResponse) {
+  return tokens.filter((token) => {
+    return !potentialScamRegex.test(token.identifier) && evmAssetHasAddress(token.identifier);
+  });
+}