@anywalletkit/protocol-swap2-usdt0 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,96 @@
-# Temporary Holding Version
+# @anywalletkit/protocol-swap2-usdt0
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[USDT0](https://docs.usdt0.to) — Tether's USDT as a LayerZero OFT — as a swap2
+provider: USDT / USDT0 between 16 EVM chains in **one source transaction**.
+`send(SendParam, MessagingFee, refund)` on the chain's OFT with the LayerZero
+messaging fee as `msg.value`; LayerZero's DVNs verify the packet and the
+executor delivers on the destination (USDT0 minted, or USDT released from the
+Ethereum adapter). No spread, no protocol fee today — the only cost is the
+LayerZero fee in the source chain's native coin (≈ 0.0000024 ETH for
+Arbitrum → HyperEVM on 2026-10-20). It is the only direct USDT path into
+HyperEVM.
+
+```ts
+import {usdt0Provider} from "@anywalletkit/protocol-swap2-usdt0/provider";
+import {RouterSwap2Protocol} from "@anywalletkit/protocol-swap2-router/swap2/router";
+
+const swap2 = new RouterSwap2Protocol(arbitrumAccount, {fromChain: "eip155:42161", providers: [usdt0Provider({rpcUrls})]});
+const res = await swap2.swap2({fromToken: "USDT0", toToken: "USDT0", toChain: 999, fromTokenAmount: 10_000_000n, minAmountOut: 10_000_000n});
+// … poll …
+const status = await swap2.getSwap2Status(res.id);   // "pending" → "completed" with the HyperEVM delivery hash
+```
+
+`rpcUrls` (CAIP-2 → URL or URLs) is required for every chain the provider
+quotes **from**: the fee and the received amount come from the OFT itself,
+not from an API.
+
+## What the provider does
+
+- **Quote** = two `eth_call`s on the source OFT. `quoteOFT(SendParam)` gives
+  the limits, any OFT fee rows and `amountReceivedLD` — what really arrives
+  after dust removal (shared decimals = 6 on every deployment, so nothing is
+  removed today). That amount becomes `minAmountLD`, and `quoteSend` prices
+  the message with it. The contract reverts rather than deliver less.
+- **Calldata is sealed in the quote**: `send(SendParam{dstEid, to, amountLD,
+  minAmountLD, extraOptions: 0x, composeMsg: 0x, oftCmd: 0x}, {nativeFee, 0},
+  refundAddress)`, `value` = `nativeFee` = the quoted LayerZero fee **+ 25 %
+  headroom** — the fee is paid at send time and moves with gas (live: +1.7 % in
+  a minute on Ethereum); OAppSender needs `msg.value == nativeFee` and the
+  endpoint refunds the unused part to `refundAddress` in the same transaction
+  (declared as `txRequest.nativeFee`
+  so the engine caps it per chain and the router prices it). `extraOptions`
+  stays empty: every deployment's `enforcedOptions` already carry the
+  executor gas (type-3, `lzReceive` gas 80 000, read on-chain 2026-10-20).
+- **Approvals**: Ethereum locks USDT in an OFT *adapter* (`approvalRequired()`
+  = true) → `approvalAddress` is the adapter, exact amount. Every other chain's
+  OFT burns the caller's USDT0 through the token's mint/burn role
+  (`approvalRequired()` = false) → no approval at all.
+- **Bound on-chain**: before the first quote on a chain the OFT's `token()`
+  and `approvalRequired()` must match `config.ts`; per pair, `peers(dstEid)`
+  must be the destination OFT. A mismatch refuses the route with its reason.
+- **Preflight** (right before signing): target is the source OFT, peer still
+  wired, and the *current* `quoteSend` fee still fits the sealed `value` —
+  the endpoint reverts an underpaid send, so a fee past the headroom means re-quote.
+- **Tracking**: LayerZero Scan `GET /v1/messages/tx/{sourceTxHash}`, matched
+  to the route's eids and the source OFT. `INFLIGHT` / `CONFIRMING` /
+  `BLOCKED` → pending; `DELIVERED` → completed with the destination hash;
+  `PAYLOAD_STORED` → action-required; `FAILED` and the burned / skipped /
+  malformed statuses → failed; a hash whose message belongs to another
+  pathway → failed.
+- **Claim** (`buildClaim`, through the engine's `claimSwap2`): a delivery that
+  reverted on the destination is stored by the endpoint and can be retried
+  by anyone — `EndpointV2.lzReceive(origin, receiver, guid, message, 0x)` with
+  the exact packet Scan recorded, on the destination chain. Null otherwise.
+- **Deployments** (docs.usdt0.to, every address re-read on-chain 2026-10-20):
+  Ethereum (eid 30101, adapter), Arbitrum 30110, OP Mainnet 30111, Polygon
+  30109, HyperEVM 30367, Ink 30339, Berachain 30362, Unichain 30320, Sei
+  30280, Plasma 30383, Monad 30390, MegaETH 30398, X Layer 30274, Mantle 30181, Morph 30322, Flare 30295. USDT0 is also live on
+  Conflux eSpace, Hedera, Rootstock, Stable, Tempo, HyperCore, IOTA and Stellar —
+  not wallet chains here yet.
+  OP's catalog `USDT` is the legacy bridged token (not the OFT); `USDT0` is.
+
+## Tests
+
+`pnpm test` — provider tests over a fake JSON-RPC + fake LayerZero Scan
+(route gating, quote maths incl. dust and OFT fee rows, calldata binding,
+every named refusal, on-chain binding failures, preflight, the whole
+pending → completed / action-required / failed lifecycle, the `lzReceive`
+claim, the router snapshot) and the conformance suite incl. the behaviour
+fixture (the engine executes exactly the reviewed plan, no approval).
+`USDT0_LIVE=1 pnpm test` adds a live read-only quote on Arbitrum.
+`pnpm verify:live` re-reads all 13 deployments on-chain and quotes
+10 USDT0 Arbitrum → HyperEVM with the preflight.
+
+## Status
+
+2026-10-20: built, tests green, all 13 deployments verified on-chain, live
+quote + preflight verified. No funded transfer yet (plan: 10 USDT Arbitrum →
+HyperEVM from the phone, then the status through LayerZero Scan).
+
+## Activity
+
+`describeActivity`: `send` on the OFT → "Bridged USDT0" ("Bridged USDT" on
+Ethereum); the executor's delivery (USDT0 minted to the owner, or USDT
+released by the adapter, in a transaction the owner did not send) → "Received
+USDT0 via LayerZero"; the owner's own `lzReceive` retry → the same. Fixtures
+are recorded mainnet transactions (`fixtures/activity`).

package/dist/activity.cjs

@@ -0,0 +1,124 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/activity.ts
+var activity_exports = {};
+__export(activity_exports, {
+  LZ_RECEIVE: () => LZ_RECEIVE,
+  USDT0_MODULE: () => USDT0_MODULE,
+  USDT0_SEND: () => USDT0_SEND,
+  describeUsdt0Activity: () => describeUsdt0Activity
+});
+module.exports = __toCommonJS(activity_exports);
+var import_activity = require("@anywalletkit/protocol-swap2-core/activity");
+var import_viem = require("viem");
+
+// src/config.ts
+var import_util = require("@anywalletkit/protocol-swap2-core/util");
+var LZ_ENDPOINT_A = "0x1a44076050125825900e736c501f859c50fE728c";
+var LZ_ENDPOINT_B = "0x6F475642a6e85809B1c36Fa62763669b1b48DD5B";
+var c = (chainId, eid, name, token, oft, endpoint, adapter = false) => ({
+  caip2: `eip155:${chainId}`,
+  chainId,
+  eid,
+  name,
+  token,
+  oft,
+  endpoint,
+  adapter
+});
+var USDT0_CHAINS = Object.freeze(Object.fromEntries([
+  c(1, 30101, "Ethereum", "0xdAC17F958D2ee523a2206206994597C13D831ec7", "0x6C96dE32CEa08842dcc4058c14d3aaAD7Fa41dee", LZ_ENDPOINT_A, true),
+  c(42161, 30110, "Arbitrum", "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9", "0x14E4A1B13bf7F943c8ff7C51fb60FA964A298D92", LZ_ENDPOINT_A),
+  c(10, 30111, "OP Mainnet", "0x01bFF41798a0BcF287b996046Ca68b395DbC1071", "0xF03b4d9AC1D5d1E7c4cEf54C2A313b9fe051A0aD", LZ_ENDPOINT_A),
+  c(137, 30109, "Polygon PoS", "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", "0x6BA10300f0DC58B7a1e4c0e41f5daBb7D7829e13", LZ_ENDPOINT_A),
+  c(999, 30367, "HyperEVM", "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb", "0x904861a24F30EC96ea7CFC3bE9EA4B476d237e98", "0x3A73033C0b1407574C76BdBAc67f126f6b4a9AA9"),
+  c(57073, 30339, "Ink", "0x0200C29006150606B650577BBE7B6248F58470c1", "0x1cB6De532588fCA4a21B7209DE7C456AF8434A65", "0xca29f3A6f966Cb2fc0dE625F8f325c0C46dbE958"),
+  c(80094, 30362, "Berachain", "0x779Ded0c9e1022225f8E0630b35a9b54bE713736", "0x3Dc96399109df5ceb2C226664A086140bD0379cB", LZ_ENDPOINT_B),
+  c(130, 30320, "Unichain", "0x9151434b16b9763660705744891fA906F660EcC5", "0xc07bE8994D035631c36fb4a89C918CeFB2f03EC3", LZ_ENDPOINT_B),
+  c(1329, 30280, "Sei", "0x9151434b16b9763660705744891fA906F660EcC5", "0x56Fe74A2e3b484b921c447357203431a3485CC60", LZ_ENDPOINT_A),
+  c(9745, 30383, "Plasma", "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb", "0x02ca37966753bDdDf11216B73B16C1dE756A7CF9", LZ_ENDPOINT_B),
+  c(143, 30390, "Monad", "0xe7cd86e13AC4309349F30B3435a9d337750fC82D", "0x9151434b16b9763660705744891fA906F660EcC5", LZ_ENDPOINT_B),
+  c(4326, 30398, "MegaETH", "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb", "0x9151434b16b9763660705744891fA906F660EcC5", LZ_ENDPOINT_B),
+  c(196, 30274, "X Layer", "0x779Ded0c9e1022225f8E0630b35a9b54bE713736", "0x94bcCa6BdfD6a61817aB0E960BfedE4984505554", LZ_ENDPOINT_A),
+  // 2026-10-20 (evm-chains-6 batch): docs.usdt0.to deployments, re-read on-chain (token(), approvalRequired() = false,
+  // sharedDecimals() = 6, endpoint(), peers(30110) = the Arbitrum OFT).
+  c(5e3, 30181, "Mantle", "0x779Ded0c9e1022225f8E0630b35a9b54bE713736", "0xcb768e263FB1C62214E7cab4AA8d036D76dc59CC", LZ_ENDPOINT_A),
+  c(2818, 30322, "Morph", "0xe7cd86e13AC4309349F30B3435a9d337750fC82D", "0xcb768e263FB1C62214E7cab4AA8d036D76dc59CC", LZ_ENDPOINT_B),
+  c(14, 30295, "Flare", "0xe7cd86e13AC4309349F30B3435a9d337750fC82D", "0x567287d2A9829215a37e3B88843d32f9221E7588", LZ_ENDPOINT_A)
+].map((x) => [x.caip2, x])));
+var USDT0_BY_EID = Object.freeze(
+  Object.fromEntries(Object.values(USDT0_CHAINS).map((x) => [x.eid, x]))
+);
+var USDT0_SYMBOLS = Object.freeze(["USDT0", "USDT", "USD\u20AE0", "USD\u20AE"]);
+
+// src/activity.ts
+var SEND_ABI = (0, import_viem.parseAbi)([
+  "struct SendParam { uint32 dstEid; bytes32 to; uint256 amountLD; uint256 minAmountLD; bytes extraOptions; bytes composeMsg; bytes oftCmd; }",
+  "struct MessagingFee { uint256 nativeFee; uint256 lzTokenFee; }",
+  "function send(SendParam sp, MessagingFee fee, address refundAddress)"
+]);
+var USDT0_MODULE = "@anywalletkit/protocol-swap2-usdt0";
+var USDT0_SEND = "0xc7c7f5b3";
+var LZ_RECEIVE = "0x0c0c389e";
+var ZERO = "0x0000000000000000000000000000000000000000";
+function symbolFor(chain) {
+  return chain.adapter || [42161, 10, 137].includes(chain.chainId) ? "USDT" : "USDT0";
+}
+function sendDestination(tx) {
+  const data = tx.call?.data;
+  if (!data || data.length < 10 + 64 * 2) return null;
+  try {
+    const [sp] = (0, import_viem.decodeFunctionData)({ abi: SEND_ABI, data }).args;
+    return USDT0_BY_EID[sp.dstEid] ?? null;
+  } catch {
+    return null;
+  }
+}
+var lc = (a) => a.toLowerCase();
+function describeUsdt0Activity(tx, ctx) {
+  const chain = USDT0_CHAINS[tx.chain];
+  if (!chain) return null;
+  const subtitle = `USDT0 \xB7 ${(0, import_activity.chainLabel)(tx.chain)}`;
+  if ((0, import_activity.matchesCall)(tx, [chain.oft], [USDT0_SEND])) {
+    const dst = sendDestination(tx);
+    const item = (0, import_activity.describeSwapLike)(tx, ctx, { protocol: USDT0_MODULE, subtitle, kind: "bridge", outVerb: "Bridged" });
+    if (!item) return null;
+    const native = item.assetsOut.filter((a) => a.token === null).reduce((sum, a) => sum + a.amount, 0n);
+    item.assetsOut = item.assetsOut.filter((a) => a.token !== null);
+    if (native > 0n) item.fee = (item.fee ?? 0n) + native;
+    const srcSym = item.assetsOut[0]?.symbol ?? symbolFor(chain);
+    if (dst) {
+      item.title = `Bridged ${srcSym} \u2192 ${symbolFor(dst)}`;
+      item.subtitle = `USDT0 \xB7 ${(0, import_activity.chainLabel)(tx.chain)} \u2192 ${dst.name}`;
+    } else item.title = `Bridged ${srcSym}`;
+    return item;
+  }
+  if ((0, import_activity.matchesCall)(tx, [chain.endpoint], [LZ_RECEIVE])) {
+    return (0, import_activity.describeSwapLike)(tx, ctx, { protocol: USDT0_MODULE, subtitle, kind: "bridge", inSuffix: "via LayerZero" });
+  }
+  const called = (0, import_activity.calledContract)(tx);
+  if (called && called === lc(chain.token)) return null;
+  const own = new Set([...ctx.own].map(lc));
+  const origin = chain.adapter ? lc(chain.oft) : ZERO;
+  const delivered = tx.transfers.some((t) => t.token !== null && lc(t.token) === lc(chain.token) && lc(t.from) === origin && own.has(lc(t.to)));
+  if (!delivered || own.has(lc(tx.from))) return null;
+  return (0, import_activity.describeSwapLike)(tx, ctx, { protocol: USDT0_MODULE, subtitle, kind: "bridge", inSuffix: "via LayerZero", counterparty: chain.oft });
+}
+//# sourceMappingURL=activity.cjs.map

package/dist/activity.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/activity.ts","../src/config.ts"],"sourcesContent":["/**\n * Activity recognition for USDT0 on every chain in `config.ts`:\n *  - `send(...)` on the chain's OFT is our source leg (\"Bridged USDT0\", or\n *    \"Bridged USDT\" on Ethereum where the adapter locks plain USDT);\n *  - the inbound leg is the executor's delivery — the user signs nothing, so\n *    it is recognized by its effect: the chain's USDT0 minted to the owner\n *    (from the zero address), or USDT released by the Ethereum adapter to the\n *    owner, inside a transaction that did NOT call the token itself (a plain\n *    transfer is not a bridge);\n *  - `lzReceive` on the LayerZero endpoint is the owner's own retry of a\n *    stored payload (`claimSwap2`).\n */\nimport type {ActivityItem, ChainTx, DescribeActivityContext} from \"@anywalletkit/core\";\nimport {calledContract, chainLabel, describeSwapLike, matchesCall} from \"@anywalletkit/protocol-swap2-core/activity\";\nimport {decodeFunctionData, parseAbi, type Hex} from \"viem\";\nimport {USDT0_BY_EID, USDT0_CHAINS, type Usdt0Chain} from \"./config.js\";\n\nconst SEND_ABI = parseAbi([\n  \"struct SendParam { uint32 dstEid; bytes32 to; uint256 amountLD; uint256 minAmountLD; bytes extraOptions; bytes composeMsg; bytes oftCmd; }\",\n  \"struct MessagingFee { uint256 nativeFee; uint256 lzTokenFee; }\",\n  \"function send(SendParam sp, MessagingFee fee, address refundAddress)\",\n]);\n\nexport const USDT0_MODULE = \"@anywalletkit/protocol-swap2-usdt0\";\n\n/** send((uint32,bytes32,uint256,uint256,bytes,bytes,bytes),(uint256,uint256),address) — IOFT */\nexport const USDT0_SEND = \"0xc7c7f5b3\";\n/** lzReceive((uint32,bytes32,uint64),address,bytes32,bytes,bytes) — EndpointV2 */\nexport const LZ_RECEIVE = \"0x0c0c389e\";\n\nconst ZERO = \"0x0000000000000000000000000000000000000000\";\n\n/** The symbol the catalog uses on each deployment: USDT where the OFT wraps Tether's USDT, USDT0 elsewhere. */\nfunction symbolFor(chain: Usdt0Chain): string {\n  return chain.adapter || [42161, 10, 137].includes(chain.chainId) ? \"USDT\" : \"USDT0\";\n}\n\n/** `send(SendParam, …)` → the destination deployment (dstEid is the first word of the tuple), null when the calldata is absent or foreign. */\nfunction sendDestination(tx: ChainTx): Usdt0Chain | null {\n  const data = tx.call?.data;\n  if (!data || data.length < 10 + 64 * 2) return null;\n  try {\n    const [sp] = decodeFunctionData({abi: SEND_ABI, data: data as Hex}).args as unknown as [{dstEid: number}];\n    return USDT0_BY_EID[sp.dstEid] ?? null;\n  } catch {\n    return null;\n  }\n}\nconst lc = (a: string) => a.toLowerCase();\n\nexport function describeUsdt0Activity(tx: ChainTx, ctx: DescribeActivityContext): ActivityItem | null {\n  const chain = USDT0_CHAINS[tx.chain];\n  if (!chain) return null;\n  const subtitle = `USDT0 · ${chainLabel(tx.chain)}`;\n  if (matchesCall(tx, [chain.oft], [USDT0_SEND])) {\n    // The native value is the LayerZero messaging fee (plus the headroom the\n    // endpoint refunds), not an asset the owner swapped away: it rides in `fee`\n    // next to the gas, and the title names both ends when the calldata says\n    // where the tokens go.\n    const dst = sendDestination(tx);\n    const item = describeSwapLike(tx, ctx, {protocol: USDT0_MODULE, subtitle, kind: \"bridge\", outVerb: \"Bridged\"});\n    if (!item) return null;\n    const native = item.assetsOut.filter((a) => a.token === null).reduce((sum, a) => sum + a.amount, 0n);\n    item.assetsOut = item.assetsOut.filter((a) => a.token !== null);\n    if (native > 0n) item.fee = (item.fee ?? 0n) + native;\n    const srcSym = item.assetsOut[0]?.symbol ?? symbolFor(chain);\n    if (dst) {\n      item.title = `Bridged ${srcSym} → ${symbolFor(dst)}`;\n      item.subtitle = `USDT0 · ${chainLabel(tx.chain)} → ${dst.name}`;\n    } else item.title = `Bridged ${srcSym}`;\n    return item;\n  }\n  if (matchesCall(tx, [chain.endpoint], [LZ_RECEIVE])) {\n    return describeSwapLike(tx, ctx, {protocol: USDT0_MODULE, subtitle, kind: \"bridge\", inSuffix: \"via LayerZero\"});\n  }\n  // Delivery by the LayerZero executor: the token moves out of nowhere (mint)\n  // or out of the adapter into the owner, and the call target is not the token.\n  const called = calledContract(tx);\n  if (called && called === lc(chain.token)) return null;\n  const own = new Set([...ctx.own].map(lc));\n  const origin = chain.adapter ? lc(chain.oft) : ZERO;\n  const delivered = tx.transfers.some((t) => t.token !== null && lc(t.token) === lc(chain.token) && lc(t.from) === origin && own.has(lc(t.to)));\n  if (!delivered || own.has(lc(tx.from))) return null;\n  return describeSwapLike(tx, ctx, {protocol: USDT0_MODULE, subtitle, kind: \"bridge\", inSuffix: \"via LayerZero\", counterparty: chain.oft});\n}\n","// USDT0 — Tether's LayerZero OFT for USDT. Source: docs.usdt0.to\n// (technical-documentation/deployments, read 2026-10-20) — every row below was\n// then re-read on-chain over public RPCs the same day: the OFT's `token()` is\n// the listed token, `endpoint()` is the listed endpoint (and reports the\n// listed eid), `approvalRequired()` is true only for the Ethereum adapter,\n// `sharedDecimals()` = 6 everywhere, and `peers(eid)` are wired between the\n// chains. `oftVersion()` = (0x02e49c2c, 1) on all of them.\n//\n// Only chains the SDK ships (swap2-assets / wallet-evm) are listed. USDT0 is\n// also deployed on Conflux eSpace (1030, eid 30212), Flare (14, 30295),\n// Hedera (295, 30316), Mantle (5000, 30181), Morph (2818, 30322), Rootstock\n// (30, 30333), Stable (988, 30396), Tempo (4217, 30410), plus HyperCore, IOTA\n// and Stellar (non-EVM) — not wallet chains here, so not routable here.\nimport {evmRef, isEvm} from \"@anywalletkit/protocol-swap2-core/util\";\n\nexport interface Usdt0Chain {\n  caip2: string;\n  chainId: number;\n  /** LayerZero V2 endpoint id. */\n  eid: number;\n  name: string;\n  /** The ERC-20 the user holds: USDT on Ethereum, USDT0 elsewhere (6 decimals everywhere). */\n  token: string;\n  /**\n   * The OFT contract `quoteSend` / `send` are called on. On Ethereum it is the\n   * OFT *adapter* that locks USDT (`approvalRequired()` = true, approve the\n   * token to it); elsewhere it is the OUpgradeable OFT that burns the caller's\n   * USDT0 through the token's mint/burn role — no approval.\n   */\n  oft: string;\n  /** LayerZero V2 EndpointV2 on that chain (`lzReceive` retries of a stored payload go here). */\n  endpoint: string;\n  /** True on Ethereum: the OFT is a lockbox adapter in front of plain USDT. */\n  adapter: boolean;\n}\n\nconst LZ_ENDPOINT_A = \"0x1a44076050125825900e736c501f859c50fE728c\";\nconst LZ_ENDPOINT_B = \"0x6F475642a6e85809B1c36Fa62763669b1b48DD5B\";\n\nconst c = (chainId: number, eid: number, name: string, token: string, oft: string, endpoint: string, adapter = false): Usdt0Chain => ({\n  caip2: `eip155:${chainId}`, chainId, eid, name, token, oft, endpoint, adapter,\n});\n\n/** CAIP-2 → USDT0 deployment. */\nexport const USDT0_CHAINS: Readonly<Record<string, Usdt0Chain>> = Object.freeze(Object.fromEntries([\n  c(1, 30101, \"Ethereum\", \"0xdAC17F958D2ee523a2206206994597C13D831ec7\", \"0x6C96dE32CEa08842dcc4058c14d3aaAD7Fa41dee\", LZ_ENDPOINT_A, true),\n  c(42161, 30110, \"Arbitrum\", \"0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9\", \"0x14E4A1B13bf7F943c8ff7C51fb60FA964A298D92\", LZ_ENDPOINT_A),\n  c(10, 30111, \"OP Mainnet\", \"0x01bFF41798a0BcF287b996046Ca68b395DbC1071\", \"0xF03b4d9AC1D5d1E7c4cEf54C2A313b9fe051A0aD\", LZ_ENDPOINT_A),\n  c(137, 30109, \"Polygon PoS\", \"0xc2132D05D31c914a87C6611C10748AEb04B58e8F\", \"0x6BA10300f0DC58B7a1e4c0e41f5daBb7D7829e13\", LZ_ENDPOINT_A),\n  c(999, 30367, \"HyperEVM\", \"0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb\", \"0x904861a24F30EC96ea7CFC3bE9EA4B476d237e98\", \"0x3A73033C0b1407574C76BdBAc67f126f6b4a9AA9\"),\n  c(57073, 30339, \"Ink\", \"0x0200C29006150606B650577BBE7B6248F58470c1\", \"0x1cB6De532588fCA4a21B7209DE7C456AF8434A65\", \"0xca29f3A6f966Cb2fc0dE625F8f325c0C46dbE958\"),\n  c(80094, 30362, \"Berachain\", \"0x779Ded0c9e1022225f8E0630b35a9b54bE713736\", \"0x3Dc96399109df5ceb2C226664A086140bD0379cB\", LZ_ENDPOINT_B),\n  c(130, 30320, \"Unichain\", \"0x9151434b16b9763660705744891fA906F660EcC5\", \"0xc07bE8994D035631c36fb4a89C918CeFB2f03EC3\", LZ_ENDPOINT_B),\n  c(1329, 30280, \"Sei\", \"0x9151434b16b9763660705744891fA906F660EcC5\", \"0x56Fe74A2e3b484b921c447357203431a3485CC60\", LZ_ENDPOINT_A),\n  c(9745, 30383, \"Plasma\", \"0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb\", \"0x02ca37966753bDdDf11216B73B16C1dE756A7CF9\", LZ_ENDPOINT_B),\n  c(143, 30390, \"Monad\", \"0xe7cd86e13AC4309349F30B3435a9d337750fC82D\", \"0x9151434b16b9763660705744891fA906F660EcC5\", LZ_ENDPOINT_B),\n  c(4326, 30398, \"MegaETH\", \"0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb\", \"0x9151434b16b9763660705744891fA906F660EcC5\", LZ_ENDPOINT_B),\n  c(196, 30274, \"X Layer\", \"0x779Ded0c9e1022225f8E0630b35a9b54bE713736\", \"0x94bcCa6BdfD6a61817aB0E960BfedE4984505554\", LZ_ENDPOINT_A),\n  // 2026-10-20 (evm-chains-6 batch): docs.usdt0.to deployments, re-read on-chain (token(), approvalRequired() = false,\n  // sharedDecimals() = 6, endpoint(), peers(30110) = the Arbitrum OFT).\n  c(5000, 30181, \"Mantle\", \"0x779Ded0c9e1022225f8E0630b35a9b54bE713736\", \"0xcb768e263FB1C62214E7cab4AA8d036D76dc59CC\", LZ_ENDPOINT_A),\n  c(2818, 30322, \"Morph\", \"0xe7cd86e13AC4309349F30B3435a9d337750fC82D\", \"0xcb768e263FB1C62214E7cab4AA8d036D76dc59CC\", LZ_ENDPOINT_B),\n  c(14, 30295, \"Flare\", \"0xe7cd86e13AC4309349F30B3435a9d337750fC82D\", \"0x567287d2A9829215a37e3B88843d32f9221E7588\", LZ_ENDPOINT_A),\n].map((x) => [x.caip2, x])));\n\n/** LayerZero eid → deployment. */\nexport const USDT0_BY_EID: Readonly<Record<number, Usdt0Chain>> = Object.freeze(\n  Object.fromEntries(Object.values(USDT0_CHAINS).map((x) => [x.eid, x])),\n);\n\n/** LayerZero Scan — message status by source transaction hash. */\nexport const LZ_SCAN_API = \"https://scan.layerzero-api.com\";\n\n/** Token symbols the catalog uses for the same asset across chains. */\nexport const USDT0_SYMBOLS: readonly string[] = Object.freeze([\"USDT0\", \"USDT\", \"USD₮0\", \"USD₮\"]);\n\nexport const usdt0 = {\n  supportsChain(chain: string): boolean {\n    return isEvm(chain) && !!USDT0_CHAINS[`eip155:${evmRef(chain)}`];\n  },\n  supports(from: string, to: string): boolean {\n    return from !== to && this.supportsChain(from) && this.supportsChain(to);\n  },\n};\n"],"mappings":"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","names":[]}

package/dist/activity.d.cts

@@ -0,0 +1,23 @@
+import { ChainTx, DescribeActivityContext, ActivityItem } from '@anywalletkit/core';
+
+/**
+ * Activity recognition for USDT0 on every chain in `config.ts`:
+ *  - `send(...)` on the chain's OFT is our source leg ("Bridged USDT0", or
+ *    "Bridged USDT" on Ethereum where the adapter locks plain USDT);
+ *  - the inbound leg is the executor's delivery — the user signs nothing, so
+ *    it is recognized by its effect: the chain's USDT0 minted to the owner
+ *    (from the zero address), or USDT released by the Ethereum adapter to the
+ *    owner, inside a transaction that did NOT call the token itself (a plain
+ *    transfer is not a bridge);
+ *  - `lzReceive` on the LayerZero endpoint is the owner's own retry of a
+ *    stored payload (`claimSwap2`).
+ */
+
+declare const USDT0_MODULE = "@anywalletkit/protocol-swap2-usdt0";
+/** send((uint32,bytes32,uint256,uint256,bytes,bytes,bytes),(uint256,uint256),address) — IOFT */
+declare const USDT0_SEND = "0xc7c7f5b3";
+/** lzReceive((uint32,bytes32,uint64),address,bytes32,bytes,bytes) — EndpointV2 */
+declare const LZ_RECEIVE = "0x0c0c389e";
+declare function describeUsdt0Activity(tx: ChainTx, ctx: DescribeActivityContext): ActivityItem | null;
+
+export { LZ_RECEIVE, USDT0_MODULE, USDT0_SEND, describeUsdt0Activity };

package/dist/activity.d.ts

@@ -0,0 +1,23 @@
+import { ChainTx, DescribeActivityContext, ActivityItem } from '@anywalletkit/core';
+
+/**
+ * Activity recognition for USDT0 on every chain in `config.ts`:
+ *  - `send(...)` on the chain's OFT is our source leg ("Bridged USDT0", or
+ *    "Bridged USDT" on Ethereum where the adapter locks plain USDT);
+ *  - the inbound leg is the executor's delivery — the user signs nothing, so
+ *    it is recognized by its effect: the chain's USDT0 minted to the owner
+ *    (from the zero address), or USDT released by the Ethereum adapter to the
+ *    owner, inside a transaction that did NOT call the token itself (a plain
+ *    transfer is not a bridge);
+ *  - `lzReceive` on the LayerZero endpoint is the owner's own retry of a
+ *    stored payload (`claimSwap2`).
+ */
+
+declare const USDT0_MODULE = "@anywalletkit/protocol-swap2-usdt0";
+/** send((uint32,bytes32,uint256,uint256,bytes,bytes,bytes),(uint256,uint256),address) — IOFT */
+declare const USDT0_SEND = "0xc7c7f5b3";
+/** lzReceive((uint32,bytes32,uint64),address,bytes32,bytes,bytes) — EndpointV2 */
+declare const LZ_RECEIVE = "0x0c0c389e";
+declare function describeUsdt0Activity(tx: ChainTx, ctx: DescribeActivityContext): ActivityItem | null;
+
+export { LZ_RECEIVE, USDT0_MODULE, USDT0_SEND, describeUsdt0Activity };

package/dist/activity.js

@@ -0,0 +1,14 @@
+import {
+  LZ_RECEIVE,
+  USDT0_MODULE,
+  USDT0_SEND,
+  describeUsdt0Activity
+} from "./chunk-SFWB4C4U.js";
+import "./chunk-AGN4M7OO.js";
+export {
+  LZ_RECEIVE,
+  USDT0_MODULE,
+  USDT0_SEND,
+  describeUsdt0Activity
+};
+//# sourceMappingURL=activity.js.map

package/dist/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-AGN4M7OO.js

@@ -0,0 +1,56 @@
+// src/config.ts
+import { evmRef, isEvm } from "@anywalletkit/protocol-swap2-core/util";
+var LZ_ENDPOINT_A = "0x1a44076050125825900e736c501f859c50fE728c";
+var LZ_ENDPOINT_B = "0x6F475642a6e85809B1c36Fa62763669b1b48DD5B";
+var c = (chainId, eid, name, token, oft, endpoint, adapter = false) => ({
+  caip2: `eip155:${chainId}`,
+  chainId,
+  eid,
+  name,
+  token,
+  oft,
+  endpoint,
+  adapter
+});
+var USDT0_CHAINS = Object.freeze(Object.fromEntries([
+  c(1, 30101, "Ethereum", "0xdAC17F958D2ee523a2206206994597C13D831ec7", "0x6C96dE32CEa08842dcc4058c14d3aaAD7Fa41dee", LZ_ENDPOINT_A, true),
+  c(42161, 30110, "Arbitrum", "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9", "0x14E4A1B13bf7F943c8ff7C51fb60FA964A298D92", LZ_ENDPOINT_A),
+  c(10, 30111, "OP Mainnet", "0x01bFF41798a0BcF287b996046Ca68b395DbC1071", "0xF03b4d9AC1D5d1E7c4cEf54C2A313b9fe051A0aD", LZ_ENDPOINT_A),
+  c(137, 30109, "Polygon PoS", "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", "0x6BA10300f0DC58B7a1e4c0e41f5daBb7D7829e13", LZ_ENDPOINT_A),
+  c(999, 30367, "HyperEVM", "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb", "0x904861a24F30EC96ea7CFC3bE9EA4B476d237e98", "0x3A73033C0b1407574C76BdBAc67f126f6b4a9AA9"),
+  c(57073, 30339, "Ink", "0x0200C29006150606B650577BBE7B6248F58470c1", "0x1cB6De532588fCA4a21B7209DE7C456AF8434A65", "0xca29f3A6f966Cb2fc0dE625F8f325c0C46dbE958"),
+  c(80094, 30362, "Berachain", "0x779Ded0c9e1022225f8E0630b35a9b54bE713736", "0x3Dc96399109df5ceb2C226664A086140bD0379cB", LZ_ENDPOINT_B),
+  c(130, 30320, "Unichain", "0x9151434b16b9763660705744891fA906F660EcC5", "0xc07bE8994D035631c36fb4a89C918CeFB2f03EC3", LZ_ENDPOINT_B),
+  c(1329, 30280, "Sei", "0x9151434b16b9763660705744891fA906F660EcC5", "0x56Fe74A2e3b484b921c447357203431a3485CC60", LZ_ENDPOINT_A),
+  c(9745, 30383, "Plasma", "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb", "0x02ca37966753bDdDf11216B73B16C1dE756A7CF9", LZ_ENDPOINT_B),
+  c(143, 30390, "Monad", "0xe7cd86e13AC4309349F30B3435a9d337750fC82D", "0x9151434b16b9763660705744891fA906F660EcC5", LZ_ENDPOINT_B),
+  c(4326, 30398, "MegaETH", "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb", "0x9151434b16b9763660705744891fA906F660EcC5", LZ_ENDPOINT_B),
+  c(196, 30274, "X Layer", "0x779Ded0c9e1022225f8E0630b35a9b54bE713736", "0x94bcCa6BdfD6a61817aB0E960BfedE4984505554", LZ_ENDPOINT_A),
+  // 2026-10-20 (evm-chains-6 batch): docs.usdt0.to deployments, re-read on-chain (token(), approvalRequired() = false,
+  // sharedDecimals() = 6, endpoint(), peers(30110) = the Arbitrum OFT).
+  c(5e3, 30181, "Mantle", "0x779Ded0c9e1022225f8E0630b35a9b54bE713736", "0xcb768e263FB1C62214E7cab4AA8d036D76dc59CC", LZ_ENDPOINT_A),
+  c(2818, 30322, "Morph", "0xe7cd86e13AC4309349F30B3435a9d337750fC82D", "0xcb768e263FB1C62214E7cab4AA8d036D76dc59CC", LZ_ENDPOINT_B),
+  c(14, 30295, "Flare", "0xe7cd86e13AC4309349F30B3435a9d337750fC82D", "0x567287d2A9829215a37e3B88843d32f9221E7588", LZ_ENDPOINT_A)
+].map((x) => [x.caip2, x])));
+var USDT0_BY_EID = Object.freeze(
+  Object.fromEntries(Object.values(USDT0_CHAINS).map((x) => [x.eid, x]))
+);
+var LZ_SCAN_API = "https://scan.layerzero-api.com";
+var USDT0_SYMBOLS = Object.freeze(["USDT0", "USDT", "USD\u20AE0", "USD\u20AE"]);
+var usdt0 = {
+  supportsChain(chain) {
+    return isEvm(chain) && !!USDT0_CHAINS[`eip155:${evmRef(chain)}`];
+  },
+  supports(from, to) {
+    return from !== to && this.supportsChain(from) && this.supportsChain(to);
+  }
+};
+
+export {
+  USDT0_CHAINS,
+  USDT0_BY_EID,
+  LZ_SCAN_API,
+  USDT0_SYMBOLS,
+  usdt0
+};
+//# sourceMappingURL=chunk-AGN4M7OO.js.map

package/dist/chunk-AGN4M7OO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["// USDT0 — Tether's LayerZero OFT for USDT. Source: docs.usdt0.to\n// (technical-documentation/deployments, read 2026-10-20) — every row below was\n// then re-read on-chain over public RPCs the same day: the OFT's `token()` is\n// the listed token, `endpoint()` is the listed endpoint (and reports the\n// listed eid), `approvalRequired()` is true only for the Ethereum adapter,\n// `sharedDecimals()` = 6 everywhere, and `peers(eid)` are wired between the\n// chains. `oftVersion()` = (0x02e49c2c, 1) on all of them.\n//\n// Only chains the SDK ships (swap2-assets / wallet-evm) are listed. USDT0 is\n// also deployed on Conflux eSpace (1030, eid 30212), Flare (14, 30295),\n// Hedera (295, 30316), Mantle (5000, 30181), Morph (2818, 30322), Rootstock\n// (30, 30333), Stable (988, 30396), Tempo (4217, 30410), plus HyperCore, IOTA\n// and Stellar (non-EVM) — not wallet chains here, so not routable here.\nimport {evmRef, isEvm} from \"@anywalletkit/protocol-swap2-core/util\";\n\nexport interface Usdt0Chain {\n  caip2: string;\n  chainId: number;\n  /** LayerZero V2 endpoint id. */\n  eid: number;\n  name: string;\n  /** The ERC-20 the user holds: USDT on Ethereum, USDT0 elsewhere (6 decimals everywhere). */\n  token: string;\n  /**\n   * The OFT contract `quoteSend` / `send` are called on. On Ethereum it is the\n   * OFT *adapter* that locks USDT (`approvalRequired()` = true, approve the\n   * token to it); elsewhere it is the OUpgradeable OFT that burns the caller's\n   * USDT0 through the token's mint/burn role — no approval.\n   */\n  oft: string;\n  /** LayerZero V2 EndpointV2 on that chain (`lzReceive` retries of a stored payload go here). */\n  endpoint: string;\n  /** True on Ethereum: the OFT is a lockbox adapter in front of plain USDT. */\n  adapter: boolean;\n}\n\nconst LZ_ENDPOINT_A = \"0x1a44076050125825900e736c501f859c50fE728c\";\nconst LZ_ENDPOINT_B = \"0x6F475642a6e85809B1c36Fa62763669b1b48DD5B\";\n\nconst c = (chainId: number, eid: number, name: string, token: string, oft: string, endpoint: string, adapter = false): Usdt0Chain => ({\n  caip2: `eip155:${chainId}`, chainId, eid, name, token, oft, endpoint, adapter,\n});\n\n/** CAIP-2 → USDT0 deployment. */\nexport const USDT0_CHAINS: Readonly<Record<string, Usdt0Chain>> = Object.freeze(Object.fromEntries([\n  c(1, 30101, \"Ethereum\", \"0xdAC17F958D2ee523a2206206994597C13D831ec7\", \"0x6C96dE32CEa08842dcc4058c14d3aaAD7Fa41dee\", LZ_ENDPOINT_A, true),\n  c(42161, 30110, \"Arbitrum\", \"0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9\", \"0x14E4A1B13bf7F943c8ff7C51fb60FA964A298D92\", LZ_ENDPOINT_A),\n  c(10, 30111, \"OP Mainnet\", \"0x01bFF41798a0BcF287b996046Ca68b395DbC1071\", \"0xF03b4d9AC1D5d1E7c4cEf54C2A313b9fe051A0aD\", LZ_ENDPOINT_A),\n  c(137, 30109, \"Polygon PoS\", \"0xc2132D05D31c914a87C6611C10748AEb04B58e8F\", \"0x6BA10300f0DC58B7a1e4c0e41f5daBb7D7829e13\", LZ_ENDPOINT_A),\n  c(999, 30367, \"HyperEVM\", \"0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb\", \"0x904861a24F30EC96ea7CFC3bE9EA4B476d237e98\", \"0x3A73033C0b1407574C76BdBAc67f126f6b4a9AA9\"),\n  c(57073, 30339, \"Ink\", \"0x0200C29006150606B650577BBE7B6248F58470c1\", \"0x1cB6De532588fCA4a21B7209DE7C456AF8434A65\", \"0xca29f3A6f966Cb2fc0dE625F8f325c0C46dbE958\"),\n  c(80094, 30362, \"Berachain\", \"0x779Ded0c9e1022225f8E0630b35a9b54bE713736\", \"0x3Dc96399109df5ceb2C226664A086140bD0379cB\", LZ_ENDPOINT_B),\n  c(130, 30320, \"Unichain\", \"0x9151434b16b9763660705744891fA906F660EcC5\", \"0xc07bE8994D035631c36fb4a89C918CeFB2f03EC3\", LZ_ENDPOINT_B),\n  c(1329, 30280, \"Sei\", \"0x9151434b16b9763660705744891fA906F660EcC5\", \"0x56Fe74A2e3b484b921c447357203431a3485CC60\", LZ_ENDPOINT_A),\n  c(9745, 30383, \"Plasma\", \"0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb\", \"0x02ca37966753bDdDf11216B73B16C1dE756A7CF9\", LZ_ENDPOINT_B),\n  c(143, 30390, \"Monad\", \"0xe7cd86e13AC4309349F30B3435a9d337750fC82D\", \"0x9151434b16b9763660705744891fA906F660EcC5\", LZ_ENDPOINT_B),\n  c(4326, 30398, \"MegaETH\", \"0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb\", \"0x9151434b16b9763660705744891fA906F660EcC5\", LZ_ENDPOINT_B),\n  c(196, 30274, \"X Layer\", \"0x779Ded0c9e1022225f8E0630b35a9b54bE713736\", \"0x94bcCa6BdfD6a61817aB0E960BfedE4984505554\", LZ_ENDPOINT_A),\n  // 2026-10-20 (evm-chains-6 batch): docs.usdt0.to deployments, re-read on-chain (token(), approvalRequired() = false,\n  // sharedDecimals() = 6, endpoint(), peers(30110) = the Arbitrum OFT).\n  c(5000, 30181, \"Mantle\", \"0x779Ded0c9e1022225f8E0630b35a9b54bE713736\", \"0xcb768e263FB1C62214E7cab4AA8d036D76dc59CC\", LZ_ENDPOINT_A),\n  c(2818, 30322, \"Morph\", \"0xe7cd86e13AC4309349F30B3435a9d337750fC82D\", \"0xcb768e263FB1C62214E7cab4AA8d036D76dc59CC\", LZ_ENDPOINT_B),\n  c(14, 30295, \"Flare\", \"0xe7cd86e13AC4309349F30B3435a9d337750fC82D\", \"0x567287d2A9829215a37e3B88843d32f9221E7588\", LZ_ENDPOINT_A),\n].map((x) => [x.caip2, x])));\n\n/** LayerZero eid → deployment. */\nexport const USDT0_BY_EID: Readonly<Record<number, Usdt0Chain>> = Object.freeze(\n  Object.fromEntries(Object.values(USDT0_CHAINS).map((x) => [x.eid, x])),\n);\n\n/** LayerZero Scan — message status by source transaction hash. */\nexport const LZ_SCAN_API = \"https://scan.layerzero-api.com\";\n\n/** Token symbols the catalog uses for the same asset across chains. */\nexport const USDT0_SYMBOLS: readonly string[] = Object.freeze([\"USDT0\", \"USDT\", \"USD₮0\", \"USD₮\"]);\n\nexport const usdt0 = {\n  supportsChain(chain: string): boolean {\n    return isEvm(chain) && !!USDT0_CHAINS[`eip155:${evmRef(chain)}`];\n  },\n  supports(from: string, to: string): boolean {\n    return from !== to && this.supportsChain(from) && this.supportsChain(to);\n  },\n};\n"],"mappings":";AAaA,SAAQ,QAAQ,aAAY;AAuB5B,IAAM,gBAAgB;AACtB,IAAM,gBAAgB;AAEtB,IAAM,IAAI,CAAC,SAAiB,KAAa,MAAc,OAAe,KAAa,UAAkB,UAAU,WAAuB;AAAA,EACpI,OAAO,UAAU,OAAO;AAAA,EAAI;AAAA,EAAS;AAAA,EAAK;AAAA,EAAM;AAAA,EAAO;AAAA,EAAK;AAAA,EAAU;AACxE;AAGO,IAAM,eAAqD,OAAO,OAAO,OAAO,YAAY;AAAA,EACjG,EAAE,GAAG,OAAO,YAAY,8CAA8C,8CAA8C,eAAe,IAAI;AAAA,EACvI,EAAE,OAAO,OAAO,YAAY,8CAA8C,8CAA8C,aAAa;AAAA,EACrI,EAAE,IAAI,OAAO,cAAc,8CAA8C,8CAA8C,aAAa;AAAA,EACpI,EAAE,KAAK,OAAO,eAAe,8CAA8C,8CAA8C,aAAa;AAAA,EACtI,EAAE,KAAK,OAAO,YAAY,8CAA8C,8CAA8C,4CAA4C;AAAA,EAClK,EAAE,OAAO,OAAO,OAAO,8CAA8C,8CAA8C,4CAA4C;AAAA,EAC/J,EAAE,OAAO,OAAO,aAAa,8CAA8C,8CAA8C,aAAa;AAAA,EACtI,EAAE,KAAK,OAAO,YAAY,8CAA8C,8CAA8C,aAAa;AAAA,EACnI,EAAE,MAAM,OAAO,OAAO,8CAA8C,8CAA8C,aAAa;AAAA,EAC/H,EAAE,MAAM,OAAO,UAAU,8CAA8C,8CAA8C,aAAa;AAAA,EAClI,EAAE,KAAK,OAAO,SAAS,8CAA8C,8CAA8C,aAAa;AAAA,EAChI,EAAE,MAAM,OAAO,WAAW,8CAA8C,8CAA8C,aAAa;AAAA,EACnI,EAAE,KAAK,OAAO,WAAW,8CAA8C,8CAA8C,aAAa;AAAA;AAAA;AAAA,EAGlI,EAAE,KAAM,OAAO,UAAU,8CAA8C,8CAA8C,aAAa;AAAA,EAClI,EAAE,MAAM,OAAO,SAAS,8CAA8C,8CAA8C,aAAa;AAAA,EACjI,EAAE,IAAI,OAAO,SAAS,8CAA8C,8CAA8C,aAAa;AACjI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAGpB,IAAM,eAAqD,OAAO;AAAA,EACvE,OAAO,YAAY,OAAO,OAAO,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACvE;AAGO,IAAM,cAAc;AAGpB,IAAM,gBAAmC,OAAO,OAAO,CAAC,SAAS,QAAQ,cAAS,WAAM,CAAC;AAEzF,IAAM,QAAQ;AAAA,EACnB,cAAc,OAAwB;AACpC,WAAO,MAAM,KAAK,KAAK,CAAC,CAAC,aAAa,UAAU,OAAO,KAAK,CAAC,EAAE;AAAA,EACjE;AAAA,EACA,SAAS,MAAc,IAAqB;AAC1C,WAAO,SAAS,MAAM,KAAK,cAAc,IAAI,KAAK,KAAK,cAAc,EAAE;AAAA,EACzE;AACF;","names":[]}