@usewhisk/cctp 0.0.0 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SignorDev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,218 @@
+# @usewhisk/cctp
+
+CCTP V2 protocol layer for Whisk.
+
+Direct integration with CCTP V2 contracts and Circle's Iris attestation
+API across all four supported ecosystems: **EVM** (viem-typed
+`TokenMessengerV2` / `MessageTransmitterV2` calls), **Solana**
+(Anchor-encoded instructions), **Stellar** (Soroban invocations with
+the `CctpForwarder` for inbound), and **Starknet** (Cairo `Call`
+values with proper `ByteArray` encoding). Pure protocol builders and
+HTTP client: no wallet state, no transaction submission. The engine
+layer (`@usewhisk/core`) consumes this package and hands the resulting
+calldata to a per-ecosystem wallet adapter.
+
+## Install
+
+```bash
+pnpm add @usewhisk/cctp
+```
+
+`viem`, `@solana/web3.js`, `@stellar/stellar-sdk` and `starknet` are
+direct dependencies. EVM ABIs are exported as `viem`-typed const arrays.
+
+The chain registry, ABIs and Iris client are also available on their
+own as `@usewhisk/cctp/chains`, `@usewhisk/cctp/abi` and
+`@usewhisk/cctp/iris`.
+
+## Quickstart
+
+Build the calls for a Fast Transfer from Base mainnet to Arbitrum One:
+
+```ts
+import {
+  Base,
+  Arbitrum,
+  getBurnFees,
+  pickFeeTier,
+  buildBurnIntent,
+} from "@usewhisk/cctp";
+
+const tiers = await getBurnFees(
+  "mainnet",
+  Base.cctpDomain,
+  Arbitrum.cctpDomain,
+);
+const tier = pickFeeTier(tiers, "fast");
+
+const intent = buildBurnIntent({
+  source: Base,
+  destination: Arbitrum,
+  amount: 25_000_000n, // 25 USDC (6 decimals)
+  mintRecipient: "0xabc...",
+  fee: { tier, forwarderLevel: "med" },
+});
+
+// intent.calls: ordered { to, data, value } for the wallet to sign.
+```
+
+## Polling for the attestation
+
+Once the burn lands, Iris publishes a message for the source-chain tx.
+Circle's forwarder picks it up on its own; you only need to poll if you
+want to show progress or fall back to a manual mint.
+
+```ts
+import { pollMessages } from "@usewhisk/cctp";
+
+const msg = await pollMessages(
+  { sourceDomain: Base.cctpDomain, transactionHash: burnTxHash },
+  { network: "mainnet" },
+);
+```
+
+By default polling stops once the forwarder has minted or failed, or,
+for a burn without the forwarder, once the attestation is complete.
+Pass `isDone` to choose your own condition. It resolves to `null` if
+Iris has nothing by the timeout.
+
+## Manual mint (recovery)
+
+If `msg.forwardState === "FAILED"`, build the destination-chain
+`receiveMessage` calldata yourself:
+
+```ts
+import { buildMintIntent } from "@usewhisk/cctp";
+
+const mint = buildMintIntent({
+  destination: Arbitrum,
+  message: msg.message,
+  attestation: msg.attestation,
+});
+
+// mint.call -> { to, data, value: 0n }
+```
+
+`buildMintIntent` is for EVM destinations. Use
+`buildSolanaReceiveIntent`, `buildStellarMintIntent` or
+`buildStarknetReceiveIntent` for the others.
+
+## What it does
+
+- **Chain registry:** every chain that supports CCTP V2 on EVM, Solana,
+  Stellar and Starknet (mainnet and testnet), with USDC address,
+  contract addresses, domain, default RPC URLs and capability flags.
+- **Contract ABIs:** `TokenMessengerV2`, `MessageTransmitterV2`, USDC.
+- **Iris API client:** fees, signed upfront-fee quotes, message fetch
+  and poll, reattest, with a shared rate limiter.
+- **Forwarder hookData:** the magic bytes that ask Circle's forwarder
+  to submit the destination mint.
+- **Address encoding:** bytes32 mint recipients for every ecosystem.
+- **Fee math:** protocol fee (bps) plus forwarder fee, with optional
+  buffers.
+- **Burn builders:** `buildBurnIntent` and `buildBurnWithFeesIntent`
+  (EVM), `buildSolanaBurnIntent`, `buildStellarBurnIntent`,
+  `buildStarknetBurnIntent`. The forwarder is on by default.
+- **Mint builders:** `receiveMessage` calldata for recovery on every
+  ecosystem.
+
+## What it does not do
+
+- Send transactions. The engine hands calldata to a wallet adapter.
+- Hold wallet state or signers.
+
+## Error handling
+
+Every failure mode throws a typed error in a single hierarchy rooted at
+`CctpError`:
+
+```ts
+import {
+  CctpError,
+  InvalidInputError,
+  IrisHttpError,
+  IrisNetworkError,
+  IrisAbortedError,
+  ProtocolError,
+  UnsupportedError,
+  isCctpError,
+} from "@usewhisk/cctp";
+
+try {
+  const intent = buildBurnIntent(input);
+} catch (err) {
+  if (err instanceof InvalidInputError) {
+    // bad amount, bad address, identical source and destination
+  } else if (err instanceof ProtocolError) {
+    // amount above the 10M cap, Fast Transfer not offered on the source
+  } else if (isCctpError(err)) {
+    // any other typed failure: inspect err.code
+  }
+}
+```
+
+`IrisHttpError` carries `status`, `bodySnippet`, and `url` for
+debugging. `IrisRateLimitedError` carries `retryAt`. `IrisAbortedError`
+is thrown when an `AbortSignal` cancels a request. Use `err.code` for
+stable programmatic dispatch.
+
+## Supported chains
+
+Chain ids are strings such as `Base_Sepolia`. `getChain(id)` returns the
+entry, and `CHAINS` lists them all. "Fast source" means Circle offers Fast
+Transfer for burns from that chain; on the others, Circle's standard
+attestation is the only option. "Forwarding" means Circle's Forwarding Service
+can mint on that chain.
+
+| Chain       | Mainnet id    | Testnet id             | Domain | Fast source | Forwarding |
+| ----------- | ------------- | ---------------------- | ------ | ----------- | ---------- |
+| Ethereum    | `Ethereum`    | `Ethereum_Sepolia`     | 0      | yes         | yes        |
+| Avalanche   | `Avalanche`   | `Avalanche_Fuji`       | 1      | no          | yes        |
+| OP Mainnet  | `Optimism`    | `Optimism_Sepolia`     | 2      | yes         | yes        |
+| Arbitrum    | `Arbitrum`    | `Arbitrum_Sepolia`     | 3      | yes         | yes        |
+| Base        | `Base`        | `Base_Sepolia`         | 6      | yes         | yes        |
+| Polygon PoS | `Polygon`     | `Polygon_Amoy_Testnet` | 7      | no          | yes        |
+| Unichain    | `Unichain`    | `Unichain_Sepolia`     | 10     | yes         | yes        |
+| Linea       | `Linea`       | `Linea_Sepolia`        | 11     | yes         | yes        |
+| Codex       | `Codex`       | `Codex_Testnet`        | 12     | yes         | yes        |
+| Sonic       | `Sonic`       | `Sonic_Testnet`        | 13     | no          | yes        |
+| World Chain | `World_Chain` | `World_Chain_Sepolia`  | 14     | yes         | yes        |
+| Monad       | `Monad`       | `Monad_Testnet`        | 15     | no          | yes        |
+| Sei         | `Sei`         | `Sei_Testnet`          | 16     | no          | yes        |
+| XDC         | `XDC`         | `XDC_Apothem`          | 18     | no          | yes        |
+| HyperEVM    | `HyperEVM`    | `HyperEVM_Testnet`     | 19     | no          | yes        |
+| Ink         | `Ink`         | `Ink_Testnet`          | 21     | yes         | yes        |
+| Plume       | `Plume`       | `Plume_Testnet`        | 22     | yes         | yes        |
+| Arc         | `Arc`         | `Arc_Testnet`          | 26     | no          | yes        |
+| EDGE        | `Edge`        | `Edge_Testnet`         | 28     | yes         | yes        |
+| Injective   | `Injective`   | `Injective_Testnet`    | 29     | no          | no         |
+| Morph       | `Morph`       | `Morph_Testnet`        | 30     | yes         | no         |
+| Pharos      | `Pharos`      | `Pharos_Testnet`       | 31     | no          | no         |
+| Cronos      | `Cronos`      | `Cronos_Testnet`       | 32     | no          | no         |
+| Plasma      | `Plasma`      | `Plasma_Testnet`       | 33     | no          | no         |
+| X Layer     | `X_Layer`     | `X_Layer_Testnet`      | 37     | yes         | no         |
+| Solana      | `Solana`      | `Solana_Devnet`        | 5      | yes         | yes        |
+| Stellar     | `Stellar`     | `Stellar_Testnet`      | 27     | no          | no         |
+| Starknet    | `Starknet`    | `Starknet_Sepolia`     | 25     | yes         | no         |
+
+`pnpm --filter @usewhisk/cctp check:registry` reads each EVM entry back from
+its public RPCs: chain id, `localDomain()`, the TokenMessenger's transmitter,
+and the USDC symbol and decimals.
+
+## Live tests
+
+Unit tests run on every commit. There's a separate live integration
+suite that hits the real Iris sandbox; run it before publishing:
+
+```bash
+IRIS_LIVE=1 pnpm --filter @usewhisk/cctp test
+```
+
+## Status
+
+v0.1, under active development. The API may change before v1.
+
+## Links
+
+- **Source:** <https://github.com/usewhisk/whisk/tree/main/packages/cctp>
+- **Issues:** <https://github.com/usewhisk/whisk/issues>

package/dist/abi.cjs

@@ -0,0 +1,239 @@
+'use strict';
+
+// src/abi/tokenMessengerV2.ts
+var tokenMessengerV2Abi = [
+  {
+    type: "function",
+    name: "depositForBurn",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "amount", type: "uint256" },
+      { name: "destinationDomain", type: "uint32" },
+      { name: "mintRecipient", type: "bytes32" },
+      { name: "burnToken", type: "address" },
+      { name: "destinationCaller", type: "bytes32" },
+      { name: "maxFee", type: "uint256" },
+      { name: "minFinalityThreshold", type: "uint32" }
+    ],
+    outputs: []
+  },
+  {
+    type: "function",
+    name: "depositForBurnWithHook",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "amount", type: "uint256" },
+      { name: "destinationDomain", type: "uint32" },
+      { name: "mintRecipient", type: "bytes32" },
+      { name: "burnToken", type: "address" },
+      { name: "destinationCaller", type: "bytes32" },
+      { name: "maxFee", type: "uint256" },
+      { name: "minFinalityThreshold", type: "uint32" },
+      { name: "hookData", type: "bytes" }
+    ],
+    outputs: []
+  },
+  {
+    type: "event",
+    name: "DepositForBurn",
+    anonymous: false,
+    inputs: [
+      { name: "burnToken", type: "address", indexed: true },
+      { name: "amount", type: "uint256", indexed: false },
+      { name: "depositor", type: "address", indexed: true },
+      { name: "mintRecipient", type: "bytes32", indexed: false },
+      { name: "destinationDomain", type: "uint32", indexed: false },
+      { name: "destinationTokenMessenger", type: "bytes32", indexed: false },
+      { name: "destinationCaller", type: "bytes32", indexed: false },
+      { name: "maxFee", type: "uint256", indexed: false },
+      { name: "minFinalityThreshold", type: "uint32", indexed: false },
+      { name: "hookData", type: "bytes", indexed: false }
+    ]
+  }
+];
+
+// src/abi/messageTransmitterV2.ts
+var messageTransmitterV2Abi = [
+  {
+    type: "function",
+    name: "receiveMessage",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "message", type: "bytes" },
+      { name: "attestation", type: "bytes" }
+    ],
+    outputs: [{ name: "success", type: "bool" }]
+  },
+  {
+    type: "function",
+    name: "usedNonces",
+    stateMutability: "view",
+    inputs: [{ name: "nonce", type: "bytes32" }],
+    outputs: [{ name: "isUsed", type: "uint256" }]
+  },
+  {
+    type: "event",
+    name: "MessageReceived",
+    anonymous: false,
+    inputs: [
+      { name: "caller", type: "address", indexed: true },
+      { name: "sourceDomain", type: "uint32", indexed: true },
+      { name: "nonce", type: "bytes32", indexed: true },
+      { name: "sender", type: "bytes32", indexed: false },
+      { name: "finalityThresholdExecuted", type: "uint32", indexed: false },
+      { name: "messageBody", type: "bytes", indexed: false }
+    ]
+  },
+  {
+    type: "event",
+    name: "MessageSent",
+    anonymous: false,
+    inputs: [{ name: "message", type: "bytes", indexed: false }]
+  }
+];
+
+// src/abi/usdc.ts
+var usdcAbi = [
+  {
+    type: "function",
+    name: "balanceOf",
+    stateMutability: "view",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: [{ name: "balance", type: "uint256" }]
+  },
+  {
+    type: "function",
+    name: "allowance",
+    stateMutability: "view",
+    inputs: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" }
+    ],
+    outputs: [{ name: "remaining", type: "uint256" }]
+  },
+  {
+    type: "function",
+    name: "decimals",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "uint8" }]
+  },
+  {
+    type: "function",
+    name: "approve",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "spender", type: "address" },
+      { name: "value", type: "uint256" }
+    ],
+    outputs: [{ name: "", type: "bool" }]
+  },
+  {
+    type: "function",
+    name: "transfer",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "to", type: "address" },
+      { name: "value", type: "uint256" }
+    ],
+    outputs: [{ name: "", type: "bool" }]
+  },
+  {
+    type: "function",
+    name: "nonces",
+    stateMutability: "view",
+    inputs: [{ name: "owner", type: "address" }],
+    outputs: [{ name: "", type: "uint256" }]
+  },
+  {
+    type: "function",
+    name: "DOMAIN_SEPARATOR",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "bytes32" }]
+  },
+  {
+    type: "function",
+    name: "permit",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" },
+      { name: "value", type: "uint256" },
+      { name: "deadline", type: "uint256" },
+      { name: "v", type: "uint8" },
+      { name: "r", type: "bytes32" },
+      { name: "s", type: "bytes32" }
+    ],
+    outputs: []
+  },
+  {
+    type: "event",
+    name: "Transfer",
+    anonymous: false,
+    inputs: [
+      { name: "from", type: "address", indexed: true },
+      { name: "to", type: "address", indexed: true },
+      { name: "value", type: "uint256", indexed: false }
+    ]
+  },
+  {
+    type: "event",
+    name: "Approval",
+    anonymous: false,
+    inputs: [
+      { name: "owner", type: "address", indexed: true },
+      { name: "spender", type: "address", indexed: true },
+      { name: "value", type: "uint256", indexed: false }
+    ]
+  }
+];
+
+// src/abi/tokenMessengerWithFees.ts
+var tokenMessengerWithFeesAbi = [
+  {
+    type: "function",
+    name: "depositForBurnWithFees",
+    stateMutability: "payable",
+    inputs: [
+      { name: "amount", type: "uint256" },
+      { name: "destinationDomain", type: "uint32" },
+      { name: "mintRecipient", type: "bytes32" },
+      { name: "burnToken", type: "address" },
+      { name: "destinationCaller", type: "bytes32" },
+      {
+        name: "claim",
+        type: "tuple",
+        components: [
+          { name: "signedQuote", type: "bytes" },
+          { name: "refundAddress", type: "address" }
+        ]
+      }
+    ],
+    outputs: []
+  },
+  {
+    type: "function",
+    name: "getFee",
+    stateMutability: "pure",
+    inputs: [{ name: "signedQuote", type: "bytes" }],
+    outputs: [
+      { name: "totalFee", type: "uint256" },
+      { name: "feeToken", type: "address" }
+    ]
+  },
+  {
+    type: "function",
+    name: "tokenMessenger",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "address" }]
+  }
+];
+
+exports.messageTransmitterV2Abi = messageTransmitterV2Abi;
+exports.tokenMessengerV2Abi = tokenMessengerV2Abi;
+exports.tokenMessengerWithFeesAbi = tokenMessengerWithFeesAbi;
+exports.usdcAbi = usdcAbi;
+//# sourceMappingURL=abi.cjs.map
+//# sourceMappingURL=abi.cjs.map

package/dist/abi.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/abi/tokenMessengerV2.ts","../src/abi/messageTransmitterV2.ts","../src/abi/usdc.ts","../src/abi/tokenMessengerWithFees.ts"],"names":[],"mappings":"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","file":"abi.cjs","sourcesContent":["/**\n * `TokenMessengerV2` ABI (relevant subset).\n *\n * Source: github.com/circlefin/evm-cctp-contracts (v2 abis).\n * Only the functions and events Whisk actually calls are included.\n */\nexport const tokenMessengerV2Abi = [\n  {\n    type: \"function\",\n    name: \"depositForBurn\",\n    stateMutability: \"nonpayable\",\n    inputs: [\n      { name: \"amount\", type: \"uint256\" },\n      { name: \"destinationDomain\", type: \"uint32\" },\n      { name: \"mintRecipient\", type: \"bytes32\" },\n      { name: \"burnToken\", type: \"address\" },\n      { name: \"destinationCaller\", type: \"bytes32\" },\n      { name: \"maxFee\", type: \"uint256\" },\n      { name: \"minFinalityThreshold\", type: \"uint32\" },\n    ],\n    outputs: [],\n  },\n  {\n    type: \"function\",\n    name: \"depositForBurnWithHook\",\n    stateMutability: \"nonpayable\",\n    inputs: [\n      { name: \"amount\", type: \"uint256\" },\n      { name: \"destinationDomain\", type: \"uint32\" },\n      { name: \"mintRecipient\", type: \"bytes32\" },\n      { name: \"burnToken\", type: \"address\" },\n      { name: \"destinationCaller\", type: \"bytes32\" },\n      { name: \"maxFee\", type: \"uint256\" },\n      { name: \"minFinalityThreshold\", type: \"uint32\" },\n      { name: \"hookData\", type: \"bytes\" },\n    ],\n    outputs: [],\n  },\n  {\n    type: \"event\",\n    name: \"DepositForBurn\",\n    anonymous: false,\n    inputs: [\n      { name: \"burnToken\", type: \"address\", indexed: true },\n      { name: \"amount\", type: \"uint256\", indexed: false },\n      { name: \"depositor\", type: \"address\", indexed: true },\n      { name: \"mintRecipient\", type: \"bytes32\", indexed: false },\n      { name: \"destinationDomain\", type: \"uint32\", indexed: false },\n      { name: \"destinationTokenMessenger\", type: \"bytes32\", indexed: false },\n      { name: \"destinationCaller\", type: \"bytes32\", indexed: false },\n      { name: \"maxFee\", type: \"uint256\", indexed: false },\n      { name: \"minFinalityThreshold\", type: \"uint32\", indexed: false },\n      { name: \"hookData\", type: \"bytes\", indexed: false },\n    ],\n  },\n] as const;\n","/**\n * The subset of `MessageTransmitterV2` Whisk uses: `receiveMessage` for\n * manual recovery, `usedNonces` to check whether a message was minted, and\n * the `MessageReceived` and `MessageSent` events.\n */\nexport const messageTransmitterV2Abi = [\n  {\n    type: \"function\",\n    name: \"receiveMessage\",\n    stateMutability: \"nonpayable\",\n    inputs: [\n      { name: \"message\", type: \"bytes\" },\n      { name: \"attestation\", type: \"bytes\" },\n    ],\n    outputs: [{ name: \"success\", type: \"bool\" }],\n  },\n  {\n    type: \"function\",\n    name: \"usedNonces\",\n    stateMutability: \"view\",\n    inputs: [{ name: \"nonce\", type: \"bytes32\" }],\n    outputs: [{ name: \"isUsed\", type: \"uint256\" }],\n  },\n  {\n    type: \"event\",\n    name: \"MessageReceived\",\n    anonymous: false,\n    inputs: [\n      { name: \"caller\", type: \"address\", indexed: true },\n      { name: \"sourceDomain\", type: \"uint32\", indexed: true },\n      { name: \"nonce\", type: \"bytes32\", indexed: true },\n      { name: \"sender\", type: \"bytes32\", indexed: false },\n      { name: \"finalityThresholdExecuted\", type: \"uint32\", indexed: false },\n      { name: \"messageBody\", type: \"bytes\", indexed: false },\n    ],\n  },\n  {\n    type: \"event\",\n    name: \"MessageSent\",\n    anonymous: false,\n    inputs: [{ name: \"message\", type: \"bytes\", indexed: false }],\n  },\n] as const;\n","/**\n * The parts of the USDC (FiatTokenV2) ABI that Whisk needs.\n *\n * Read: balanceOf, allowance, decimals, nonces, DOMAIN_SEPARATOR.\n * Write: approve, transfer, permit (EIP-2612).\n */\nexport const usdcAbi = [\n  {\n    type: \"function\",\n    name: \"balanceOf\",\n    stateMutability: \"view\",\n    inputs: [{ name: \"account\", type: \"address\" }],\n    outputs: [{ name: \"balance\", type: \"uint256\" }],\n  },\n  {\n    type: \"function\",\n    name: \"allowance\",\n    stateMutability: \"view\",\n    inputs: [\n      { name: \"owner\", type: \"address\" },\n      { name: \"spender\", type: \"address\" },\n    ],\n    outputs: [{ name: \"remaining\", type: \"uint256\" }],\n  },\n  {\n    type: \"function\",\n    name: \"decimals\",\n    stateMutability: \"view\",\n    inputs: [],\n    outputs: [{ name: \"\", type: \"uint8\" }],\n  },\n  {\n    type: \"function\",\n    name: \"approve\",\n    stateMutability: \"nonpayable\",\n    inputs: [\n      { name: \"spender\", type: \"address\" },\n      { name: \"value\", type: \"uint256\" },\n    ],\n    outputs: [{ name: \"\", type: \"bool\" }],\n  },\n  {\n    type: \"function\",\n    name: \"transfer\",\n    stateMutability: \"nonpayable\",\n    inputs: [\n      { name: \"to\", type: \"address\" },\n      { name: \"value\", type: \"uint256\" },\n    ],\n    outputs: [{ name: \"\", type: \"bool\" }],\n  },\n  {\n    type: \"function\",\n    name: \"nonces\",\n    stateMutability: \"view\",\n    inputs: [{ name: \"owner\", type: \"address\" }],\n    outputs: [{ name: \"\", type: \"uint256\" }],\n  },\n  {\n    type: \"function\",\n    name: \"DOMAIN_SEPARATOR\",\n    stateMutability: \"view\",\n    inputs: [],\n    outputs: [{ name: \"\", type: \"bytes32\" }],\n  },\n  {\n    type: \"function\",\n    name: \"permit\",\n    stateMutability: \"nonpayable\",\n    inputs: [\n      { name: \"owner\", type: \"address\" },\n      { name: \"spender\", type: \"address\" },\n      { name: \"value\", type: \"uint256\" },\n      { name: \"deadline\", type: \"uint256\" },\n      { name: \"v\", type: \"uint8\" },\n      { name: \"r\", type: \"bytes32\" },\n      { name: \"s\", type: \"bytes32\" },\n    ],\n    outputs: [],\n  },\n  {\n    type: \"event\",\n    name: \"Transfer\",\n    anonymous: false,\n    inputs: [\n      { name: \"from\", type: \"address\", indexed: true },\n      { name: \"to\", type: \"address\", indexed: true },\n      { name: \"value\", type: \"uint256\", indexed: false },\n    ],\n  },\n  {\n    type: \"event\",\n    name: \"Approval\",\n    anonymous: false,\n    inputs: [\n      { name: \"owner\", type: \"address\", indexed: true },\n      { name: \"spender\", type: \"address\", indexed: true },\n      { name: \"value\", type: \"uint256\", indexed: false },\n    ],\n  },\n] as const;\n","/**\n * The parts of Circle's `TokenMessengerWithFees` that Whisk calls, from the ABI\n * in Circle's contract interface reference. Only the `bytes signedQuote`\n * overload of each burn is listed, so encoding never has to pick between them.\n */\nexport const tokenMessengerWithFeesAbi = [\n  {\n    type: \"function\",\n    name: \"depositForBurnWithFees\",\n    stateMutability: \"payable\",\n    inputs: [\n      { name: \"amount\", type: \"uint256\" },\n      { name: \"destinationDomain\", type: \"uint32\" },\n      { name: \"mintRecipient\", type: \"bytes32\" },\n      { name: \"burnToken\", type: \"address\" },\n      { name: \"destinationCaller\", type: \"bytes32\" },\n      {\n        name: \"claim\",\n        type: \"tuple\",\n        components: [\n          { name: \"signedQuote\", type: \"bytes\" },\n          { name: \"refundAddress\", type: \"address\" },\n        ],\n      },\n    ],\n    outputs: [],\n  },\n  {\n    type: \"function\",\n    name: \"getFee\",\n    stateMutability: \"pure\",\n    inputs: [{ name: \"signedQuote\", type: \"bytes\" }],\n    outputs: [\n      { name: \"totalFee\", type: \"uint256\" },\n      { name: \"feeToken\", type: \"address\" },\n    ],\n  },\n  {\n    type: \"function\",\n    name: \"tokenMessenger\",\n    stateMutability: \"view\",\n    inputs: [],\n    outputs: [{ name: \"\", type: \"address\" }],\n  },\n] as const;\n"]}