@across-protocol/sdk 4.3.75-alpha.0 → 4.3.76

package/dist/types/utils/TokenUtils.d.ts

@@ -186,6 +186,15 @@ export declare const resolveContractFromSymbol: (symbol: string, chainId: number
         };
         coingeckoId: string;
     };
+    POL: {
+        name: string;
+        symbol: string;
+        decimals: number;
+        addresses: {
+            [x: number]: string;
+        };
+        coingeckoId: string;
+    };
     POOL: {
         name: string;
         symbol: string;
@@ -434,6 +443,15 @@ export declare const resolveContractFromSymbol: (symbol: string, chainId: number
         };
         coingeckoId: string;
     };
+    WPOL: {
+        name: string;
+        symbol: string;
+        decimals: number;
+        addresses: {
+            [x: number]: string;
+        };
+        coingeckoId: string;
+    };
     WSOL: {
         name: string;
         symbol: string;
@@ -647,6 +665,15 @@ export declare function getTokenInfo(l2Token: Address, chainId: number, tokenMap
         };
         coingeckoId: string;
     };
+    POL: {
+        name: string;
+        symbol: string;
+        decimals: number;
+        addresses: {
+            [x: number]: string;
+        };
+        coingeckoId: string;
+    };
     POOL: {
         name: string;
         symbol: string;
@@ -895,6 +922,15 @@ export declare function getTokenInfo(l2Token: Address, chainId: number, tokenMap
         };
         coingeckoId: string;
     };
+    WPOL: {
+        name: string;
+        symbol: string;
+        decimals: number;
+        addresses: {
+            [x: number]: string;
+        };
+        coingeckoId: string;
+    };
     WSOL: {
         name: string;
         symbol: string;

package/dist/types/utils/TokenUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TokenUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/TokenUtils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TokenUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/TokenUtils.ts"],"names":[],"mappings":"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"}

package/dist/types/utils/index.d.ts

@@ -27,4 +27,5 @@ export * from "./DepositUtils";
 export * from "./ValidatorUtils";
 export * from "./AddressUtils";
 export * from "./SpokeUtils";
+export * from "./CCTPUtils";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@across-protocol/sdk",
   "author": "UMA Team",
-  "version": "4.3.75-alpha.0",
+  "version": "4.3.76",
   "license": "AGPL-3.0",
   "homepage": "https://docs.across.to/reference/sdk",
   "files": [
@@ -101,12 +101,12 @@
     "ts-node": "^10.9.1",
     "typechain": "^8.3.1",
     "typescript": "^5.9",
-    "winston": "^3.17.0",
-    "winston-transport": "^4.9.0"
+    "winston": "^3.10.0",
+    "winston-transport": "^4.5.0"
   },
   "dependencies": {
     "@across-protocol/across-token": "^1.0.0",
-    "@across-protocol/constants": "^3.1.78",
+    "@across-protocol/constants": "^3.1.82",
     "@across-protocol/contracts": "^4.1.9",
     "@coral-xyz/anchor": "^0.30.1",
     "@eth-optimism/sdk": "^3.3.1",

package/src/clients/AcrossConfigStoreClient/AcrossConfigStoreClient.ts

@@ -498,7 +498,7 @@ export class AcrossConfigStoreClient extends BaseAbstractClient {
           }
           // Now check that we're only appending positive integers to the chainIndices array on each
           // update. If this isn't the case, skip the update & warn. If there is no previous update,
-          // resolve an implcit chain ID list.
+          // resolve an implicit chain ID list.
           const previousUpdate = this.chainIdIndicesUpdates.at(-1)?.value ?? this.implicitChainIdIndices(chainId);
           // We should now check that previousUpdate is a subset of chainIndices.
           if (!previousUpdate.every((chainId, idx) => chainIndices[idx] === chainId)) {

package/src/clients/BundleDataClient/BundleDataClient.ts

@@ -1033,7 +1033,7 @@ export class BundleDataClient {
             fill?.relayExecutionInfo.fillType === FillType.ReplacedSlowFill,
             "Fill type should be ReplacedSlowFill."
           );
-          // Needed for TSC - are implicitely checking that deposit exists by making it to this point.
+          // Needed for TSC - are implicitly checking that deposit exists by making it to this point.
           if (!deposits || deposits.length < 1) {
             throw new Error("Deposit should exist in relay hash dictionary.");
           }
@@ -1111,7 +1111,7 @@ export class BundleDataClient {
         // unexecutable. Mark this deposit as having created an unexecutable slow fill if there is no matching
         // slow fill request or the matching slow fill request took place in a previous bundle.
 
-        // If there is a slow fill request in this bundle, then the expired deposit refund will supercede
+        // If there is a slow fill request in this bundle, then the expired deposit refund will supersede
         // the slow fill request. If there is no slow fill request seen or its older than this bundle, then we can
         // assume a slow fill leaf was created for it when the deposit was mined. Therefore, because the deposit
         // was in an older bundle, we can assume that a slow fill leaf was created at that time and therefore

package/src/clients/HubPoolClient.ts

@@ -359,7 +359,7 @@ export class HubPoolClient extends BaseAbstractClient {
       throw new Error("HubPoolClient has not set a currentTime");
     }
 
-    // Map each HubPool token to an array of unqiue quoteTimestamps.
+    // Map each HubPool token to an array of unique quoteTimestamps.
     const utilizationTimestamps: { [hubPoolToken: string]: number[] } = {};
 
     // Map each HubPool token to utilization at a particular block number.
@@ -388,7 +388,7 @@ export class HubPoolClient extends BaseAbstractClient {
           .map((token) => token.toNative())
       ).map((token) => EvmAddress.from(token));
 
-    // Helper to resolve the unqiue hubPoolToken & quoteTimestamp mappings.
+    // Helper to resolve the unique hubPoolToken & quoteTimestamp mappings.
     const resolveUniqueQuoteTimestamps = (deposit: LpFeeRequest): void => {
       const { quoteTimestamp } = deposit;
 

package/src/clients/SpokePoolClient/index.ts

@@ -14,7 +14,7 @@ export { SpokePoolManager } from "./SpokePoolClientManager";
  * @returns True if the SpokePoolClient is an EVMSpokePoolClient, false otherwise.
  */
 export function isEVMSpokePoolClient(spokePoolClient: SpokePoolClient): spokePoolClient is EVMSpokePoolClient {
-  // @TODO: Shoud we handle the case where spokePoolClient is undefined?
+  // @TODO: Should we handle the case where spokePoolClient is undefined?
   return spokePoolClient?.type === EVM_SPOKE_POOL_CLIENT_TYPE;
 }
 
@@ -24,6 +24,6 @@ export function isEVMSpokePoolClient(spokePoolClient: SpokePoolClient): spokePoo
  * @returns True if the SpokePoolClient is an SVMSpokePoolClient, false otherwise.
  */
 export function isSVMSpokePoolClient(spokePoolClient: SpokePoolClient): spokePoolClient is SVMSpokePoolClient {
-  // @TODO: Shoud we handle the case where spokePoolClient is undefined?
+  // @TODO: Should we handle the case where spokePoolClient is undefined?
   return spokePoolClient?.type === SVM_SPOKE_POOL_CLIENT_TYPE;
 }

package/src/pool/uma/clients/erc20/README.md

@@ -14,7 +14,7 @@ const provider = new ethers.providers.WebSocketProvider(env.CUSTOM_NODE_URL)
 const erc20Address:string = // assume you have an emp address you want to connect to
 const erc20Instance:uma.clients.erc20.Instance = uma.clients.erc20.connect(erc20Address,provider)
 
-// gets all emp events, see ethers queryFilter for details on contructing the query.
+// gets all emp events, see ethers queryFilter for details on constructing the query.
 const events = await erc20Instance.queryFilter({})
 
 // returns EventState, defined in the emp client. This can contain user balances as well as approval limits.

package/src/pool/uma/utils.ts

@@ -42,7 +42,7 @@ export function Balances(balances: Balances = {}) {
 }
 
 // Loop forever but wait until execution is finished before starting next timer. Throw an error to break this
-// or add another utlity function if you need it to end on condition.
+// or add another utility function if you need it to end on condition.
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export async function loop(fn: (...args: any[]) => any, delay: number, ...args: any[]) {
   do {

package/src/providers/cachedProvider.ts

@@ -67,7 +67,7 @@ export class CacheProvider extends RateLimitedProvider {
       }
     }
 
-    // Note: use swtich to ensure all enum cases are handled.
+    // Note: use switch to ensure all enum cases are handled.
     switch (cacheType) {
       case CacheType.WITH_TTL:
         {

package/src/providers/types.ts

@@ -4,7 +4,7 @@ export type RPCProvider = "ALCHEMY" | "DRPC" | "INFURA" | "INFURA_DIN" | "QUICKN
 export type RPCTransport = "https" | "wss";
 
 // JSON-RPC 2.0 Error object
-// See JSON-RPC 2.0 Specification section 5 Reponse object
+// See JSON-RPC 2.0 Specification section 5 Response object
 // https://www.jsonrpc.org/specification
 export const JsonRpcError = type({
   jsonrpc: literal("2.0"),

package/src/utils/CCTPUtils.ts

@@ -0,0 +1,329 @@
+import { PUBLIC_NETWORKS, CCTP_NO_DOMAIN, PRODUCTION_NETWORKS, TEST_NETWORKS } from "@across-protocol/constants";
+import { BigNumber, ethers } from "ethers";
+
+import { Log } from "@ethersproject/abstract-provider";
+import { isDefined } from "./TypeGuards";
+import axios from "axios";
+import { chainIsProd } from "./NetworkUtils";
+import assert from "assert";
+import { bnZero } from "./BigNumberUtils";
+/** ********************************************************************************************************************
+ *
+ * CONSTANTS
+ *
+ ******************************************************************************************************************* **/
+
+export type CCTPMessageStatus = "finalized" | "ready" | "pending";
+export const CCTPV2_FINALITY_THRESHOLD_STANDARD = 2000;
+export const CCTPV2_FINALITY_THRESHOLD_FAST = 1000;
+/** ********************************************************************************************************************
+ *
+ * CCTP SMART CONTRACT EVENT TYPES
+ *
+ ******************************************************************************************************************* **/
+
+// Params shared by Message and DepositForBurn events.
+type CommonMessageData = {
+  // `cctpVersion` is nuanced. cctpVersion returned from API are 1 or 2 (v1 and v2 accordingly). The bytes responsible for a version within the message itself though are 0 or 1 (v1 and v2 accordingly) :\
+  cctpVersion: number;
+  sourceDomain: number;
+  destinationDomain: number;
+  sender: string;
+  recipient: string;
+  messageHash: string;
+  messageBytes: string;
+  nonce: number; // This nonce makes sense only for v1 events, as it's emitted on src chain send
+  nonceHash: string;
+};
+type DepositForBurnMessageData = CommonMessageData & { amount: string; mintRecipient: string; burnToken: string };
+type CommonMessageEvent = CommonMessageData & { log: Log };
+type DepositForBurnMessageEvent = DepositForBurnMessageData & { log: Log };
+type CCTPMessageEvent = CommonMessageEvent | DepositForBurnMessageEvent;
+
+const CCTP_MESSAGE_SENT_TOPIC_HASH = ethers.utils.id("MessageSent(bytes)");
+const CCTP_DEPOSIT_FOR_BURN_TOPIC_HASH_V1 = ethers.utils.id(
+  "DepositForBurn(uint64,address,uint256,address,bytes32,uint32,bytes32,bytes32)"
+);
+const CCTP_DEPOSIT_FOR_BURN_TOPIC_HASH_V2 = ethers.utils.id(
+  "DepositForBurn(address,uint256,address,bytes32,uint32,bytes32,bytes32,uint256,uint32,bytes)"
+);
+
+/** ********************************************************************************************************************
+ *
+ * CCTP API TYPES
+ *
+ ******************************************************************************************************************* **/
+
+// CCTP V2 /burn/USDC/fees/{sourceDomainId}/{destDomainId} response
+type CCTPV2APIGetFeesResponse = { finalityThreshold: number; minimumFee: number }[];
+
+// CCTP V2 /fastBurn/USDC/allowance response
+type CCTPV2APIGetFastBurnAllowanceResponse = { allowance: number };
+
+// CCTP V2 /messages/{sourceDomainId} response
+type CCTPV2APIAttestation = {
+  status: string;
+  attestation: string;
+  message: string;
+  eventNonce: string;
+  cctpVersion: number;
+  decodedMessage: {
+    recipient: string;
+    destinationDomain: number;
+    decodedMessageBody: {
+      amount: string;
+      mintRecipient: string;
+      messageSender: string;
+    };
+  };
+};
+type CCTPV2APIGetAttestationResponse = { messages: CCTPV2APIAttestation[] };
+
+/** ********************************************************************************************************************
+ *
+ * Exported functions and constants:
+ *
+ ******************************************************************************************************************* **/
+
+export type AttestedCCTPMessage = CCTPMessageEvent & { status: CCTPMessageStatus; attestation?: string };
+export type AttestedCCTPDeposit = DepositForBurnMessageEvent & { status: CCTPMessageStatus; attestation?: string };
+
+/**
+ * @notice Converts an ETH Address string to a 32-byte hex string.
+ * @param address The address to convert.
+ * @returns The 32-byte hex string representation of the address - required for CCTP messages.
+ */
+export function cctpAddressToBytes32(address: string): string {
+  return ethers.utils.hexZeroPad(address, 32);
+}
+
+/**
+ * Converts a 32-byte hex string with padding to a standard ETH address.
+ * @param bytes32 The 32-byte hex string to convert.
+ * @returns The ETH address representation of the 32-byte hex string.
+ */
+export function cctpBytes32ToAddress(bytes32: string): string {
+  // Grab the last 20 bytes of the 32-byte hex string
+  return ethers.utils.getAddress(ethers.utils.hexDataSlice(bytes32, 12));
+}
+
+/**
+ * @notice Returns the CCTP domain for a given chain ID. Throws if the chain ID is not a CCTP domain.
+ * @param chainId
+ * @returns CCTP Domain ID
+ */
+export function getCctpDomainForChainId(chainId: number): number {
+  const cctpDomain = PUBLIC_NETWORKS[chainId]?.cctpDomain;
+  if (!isDefined(cctpDomain) || cctpDomain === CCTP_NO_DOMAIN) {
+    throw new Error(`No CCTP domain found for chainId: ${chainId}`);
+  }
+  return cctpDomain;
+}
+
+/**
+ * @notice Returns the chain ID for a given CCTP domain. Inverse functionof `getCctpDomainForChainId()`. However,
+ * since CCTP Domains are shared between production and test networks, we need to use the `productionNetworks` flag
+ * to determine whether to return the production  or test network chain ID.
+ * @param domain CCTP domain ID.
+ * @param productionNetworks Whether to return the production or test network chain ID.
+ * @returns Chain ID.
+ */
+export function getCctpDestinationChainFromDomain(domain: number, productionNetworks: boolean): number {
+  if (domain === CCTP_NO_DOMAIN) {
+    throw new Error("Cannot input CCTP_NO_DOMAIN to getCctpDestinationChainFromDomain");
+  }
+  // Test and Production networks use the same CCTP domain, so we need to use the flag passed in to
+  // determine whether to use the Test or Production networks.
+  const networks = productionNetworks ? PRODUCTION_NETWORKS : TEST_NETWORKS;
+  const otherNetworks = productionNetworks ? TEST_NETWORKS : PRODUCTION_NETWORKS;
+  const chainId = Object.keys(networks).find(
+    (key) => networks[Number(key)].cctpDomain.toString() === domain.toString()
+  );
+  if (!isDefined(chainId)) {
+    const chainId = Object.keys(otherNetworks).find(
+      (key) => otherNetworks[Number(key)].cctpDomain.toString() === domain.toString()
+    );
+    if (!isDefined(chainId)) {
+      throw new Error(`No chainId found for domain: ${domain}`);
+    }
+    return parseInt(chainId);
+  }
+  return parseInt(chainId);
+}
+
+/**
+ * @notice Typeguard. Returns whether the event is a CCTP deposit for burn event. Should work for V1 and V2
+ * @param event CCTP message event.
+ * @returns True if the event is a CCTP deposit for burn event.
+ */
+export function isDepositForBurnEvent(event: CCTPMessageEvent): event is DepositForBurnMessageEvent {
+  return "amount" in event && "mintRecipient" in event && "burnToken" in event;
+}
+
+/**
+ * @notice Fetches CCTP V2 attestations for a given list of transaction hashes. If a transaction hash
+ * contains multiple CCTP messages, this will return an object where each key is a transaction hash and
+ * a value is an array of attestations.
+ * @param depositForBurnTxnHashes List of transaction hashes to fetch attestations for.
+ * @param sourceChainId Source chain ID of the transaction hashes.
+ * @returns Object with transaction hashes as keys and CCTP V2 attestations as values.
+ */
+export async function fetchCctpV2Attestations(
+  depositForBurnTxnHashes: string[],
+  sourceChainId: number
+): Promise<{ [sourceTxnHash: string]: CCTPV2APIGetAttestationResponse }> {
+  // For v2, we fetch an API response for every txn hash we have. API returns an array of both v1 and v2 attestations
+  const sourceDomainId = getCctpDomainForChainId(sourceChainId);
+  const isMainnet = chainIsProd(sourceChainId);
+
+  // Circle rate limit is 35 requests / second. To avoid getting banned, batch calls into chunks with 1 second delay between chunks
+  // For v2, this is actually required because we don't know if message is finalized or not before hitting the API. Therefore as our
+  // CCTP v2 list of chains grows, we might require more than 35 calls here to fetch all attestations
+  const attestationResponses: { [sourceTxnHash: string]: CCTPV2APIGetAttestationResponse } = {};
+  const chunkSize = process.env.CCTP_API_REQUEST_CHUNK_SIZE ? parseInt(process.env.CCTP_API_REQUEST_CHUNK_SIZE) : 8;
+  for (let i = 0; i < depositForBurnTxnHashes.length; i += chunkSize) {
+    const chunk = depositForBurnTxnHashes.slice(i, i + chunkSize);
+
+    await Promise.all(
+      chunk.map(async (txHash) => {
+        const attestations = await fetchAttestationsForTxn(sourceDomainId, txHash, isMainnet);
+
+        // If multiple deposit for burn events, there will be multiple attestations.
+        attestationResponses[txHash] = attestations;
+      })
+    );
+
+    if (i + chunkSize < depositForBurnTxnHashes.length) {
+      await new Promise((resolve) => setTimeout(resolve, 1000));
+    }
+  }
+  return attestationResponses;
+}
+
+/**
+ * @notice Returns the status of a CCTP attestation.
+ * @param attestation Attestation to get the status of.
+ * @returns "finalized","pending" or "ready".
+ */
+export function getPendingAttestationStatus(attestation: CCTPV2APIAttestation): CCTPMessageStatus {
+  if (!isDefined(attestation.attestation)) {
+    return "pending";
+  } else {
+    return attestation.status === "pending_confirmations" || attestation.attestation === "PENDING"
+      ? "pending"
+      : "ready";
+  }
+}
+
+/**
+ * @notice Checks if a CCTP message has been processed by a given contract.
+ * @param nonceHash Nonce hash to check.
+ * @param contract
+ * @returns True if the message has been processed, false otherwise.
+ */
+export async function hasCCTPMessageBeenProcessedEvm(nonceHash: string, contract: ethers.Contract): Promise<boolean> {
+  const resultingCall: BigNumber = await contract.callStatic.usedNonces(nonceHash);
+  // If the resulting call is 1, the message has been processed. If it is 0, the message has not been processed.
+  return (resultingCall ?? bnZero).toNumber() === 1;
+}
+
+/**
+ * @notice The maximum amount of USDC that can be sent using a fast transfer.
+ * @param isMainnet Toggles whether to call CCTP API on mainnet or sandbox environment.
+ * @returns USDC amount in units of USDC.
+ * @link https://developers.circle.com/api-reference/cctp/all/get-fast-burn-usdc-allowance
+ */
+export async function getV2FastBurnAllowance(isMainnet: boolean): Promise<string> {
+  const httpResponse = await axios.get<CCTPV2APIGetFastBurnAllowanceResponse>(
+    `https://iris-api${isMainnet ? "" : "-sandbox"}.circle.com/v2/fastBurn/USDC/allowance`
+  );
+  return httpResponse.data.allowance.toString();
+}
+
+/**
+ * Returns the minimum transfer fees required for a transfer to be relayed. When calling depositForBurn(), the maxFee
+ * parameter must be greater than or equal to the minimum fee.
+ * @param sourceChainId The source chain ID of the transfer.
+ * @param destinationChainId The destination chain ID of the transfer.
+ * @param isMainnet Toggles whether to call CCTP API on mainnet or sandbox environment.
+ * @returns The standard and fast transfer fees for the given source and destination chains.
+ * @link https://developers.circle.com/api-reference/cctp/all/get-burn-usdc-fees
+ */
+export async function getV2MinTransferFees(
+  sourceChainId: number,
+  destinationChainId: number
+): Promise<{ standard: BigNumber; fast: BigNumber }> {
+  const isMainnet = chainIsProd(destinationChainId);
+  const sourceDomain = getCctpDomainForChainId(sourceChainId);
+  const destinationDomain = getCctpDomainForChainId(destinationChainId);
+  const endpoint = `https://iris-api${
+    isMainnet ? "" : "-sandbox"
+  }.circle.com/v2/burn/USDC/fees/${sourceDomain}/${destinationDomain}`;
+  const httpResponse = await axios.get<CCTPV2APIGetFeesResponse>(endpoint);
+  const standardFee = httpResponse.data.find((fee) => fee.finalityThreshold === CCTPV2_FINALITY_THRESHOLD_STANDARD);
+  assert(
+    isDefined(standardFee?.minimumFee),
+    `CCTPUtils#getTransferFees: Standard fee not found in API response: ${endpoint}`
+  );
+  const fastFee = httpResponse.data.find((fee) => fee.finalityThreshold === CCTPV2_FINALITY_THRESHOLD_FAST);
+  assert(isDefined(fastFee?.minimumFee), `CCTPUtils#getTransferFees: Fast fee not found in API response: ${endpoint}`);
+  return {
+    standard: BigNumber.from(standardFee.minimumFee),
+    fast: BigNumber.from(fastFee.minimumFee),
+  };
+}
+
+/**
+ * @notice Fetches attestations for a given transaction hash. If transaction hash contains multiple CCTP
+ * messages, this will return an array of attestations. Should work for both v1 and v2.
+ * @param sourceDomainId
+ * @param transactionHash
+ * @param isMainnet
+ * @returns Attestation response, list of messages with attestations.
+ */
+export async function fetchAttestationsForTxn(
+  sourceDomainId: number,
+  transactionHash: string,
+  isMainnet: boolean
+): Promise<CCTPV2APIGetAttestationResponse> {
+  const httpResponse = await axios.get<CCTPV2APIGetAttestationResponse>(
+    `https://iris-api${
+      isMainnet ? "" : "-sandbox"
+    }.circle.com/v2/messages/${sourceDomainId}?transactionHash=${transactionHash}`
+  );
+
+  return httpResponse.data;
+}
+
+/**
+ * @notice Returns the CCTP version of the `MessageSent` event.
+ * @param log CCTP event log.
+ * @returns 0 for v1 `MessageSent` event, 1 for v2, -1 for other events
+ */
+export function getMessageSentVersion(log: ethers.providers.Log): number {
+  if (log.topics[0] !== CCTP_MESSAGE_SENT_TOPIC_HASH) {
+    return -1;
+  }
+  // v1 and v2 have the same topic hash, so we have to do a bit of decoding here to understand the version
+  const messageBytes = ethers.utils.defaultAbiCoder.decode(["bytes"], log.data)[0];
+  // Source: https://developers.circle.com/stablecoins/message-format
+  const version = parseInt(messageBytes.slice(2, 10), 16); // read version: first 4 bytes (skipping '0x')
+  return version;
+}
+
+/**
+ * @notice Returns the CCTP version of the `DepositForBurn` event.
+ * @param log CCTP event log.
+ * @returns 0 for v1 `DepositForBurn` event, 1 for v2, -1 for other events
+ */
+export function getDepositForBurnVersion(log: ethers.providers.Log): number {
+  const topic = log.topics[0];
+  switch (topic) {
+    case CCTP_DEPOSIT_FOR_BURN_TOPIC_HASH_V1:
+      return 0;
+    case CCTP_DEPOSIT_FOR_BURN_TOPIC_HASH_V2:
+      return 1;
+    default:
+      return -1;
+  }
+}

package/src/utils/DepositUtils.ts

@@ -192,7 +192,7 @@ export function validateFillForDeposit(
 
   // Note: this short circuits when a key is found where the comparison doesn't match.
   // TODO: if we turn on "strict" in the tsconfig, the elements of FILL_DEPOSIT_COMPARISON_KEYS will be automatically
-  // validated against the fields in Fill and Deposit, generating an error if there is a discrepency.
+  // validated against the fields in Fill and Deposit, generating an error if there is a discrepancy.
   let invalidKey = RELAYDATA_KEYS.find((key) => relayData[key].toString() !== deposit[key].toString());
 
   // There should be no paths for `messageHash` to be unset, but mask it off anyway.

package/src/utils/index.ts

@@ -27,3 +27,4 @@ export * from "./DepositUtils";
 export * from "./ValidatorUtils";
 export * from "./AddressUtils";
 export * from "./SpokeUtils";
+export * from "./CCTPUtils";