@anywalletkit/protocol-swap2-core 0.0.0-stage → 0.3.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,19 @@
-# Temporary Holding Version
+# @anywalletkit/protocol-swap2-core
 
-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.
+The swap2 engine: one interface for swaps and bridges ("swap2"), and the execution safety every swap2 provider package relies on.
+
+- **`BaseSwap2Protocol` / `SingleProviderSwap2`** — a `Swap2Protocol` (from `@anywalletkit/core`) over a provider. It quotes, binds the execution to the quote, runs approvals, sends, and resumes status by id (`getSwap2Status`, `claimSwap2` for two-phase routes).
+- **Safety checks.** Quote validation, a minimum-output floor, fee caps, a review gate before signing, and refusals that name their reason. Status ids look like `awk1.<provider>.<intent>[.<hash>]` (`SWAP2_ID_PREFIX`).
+- **`remoteProvider`** — runs a provider on your server (API keys, shared state) while the app keeps the keys and signs.
+- **Errors** — `Swap2Error` and its subclasses (quote, validation, execution, fee limit, status…).
+- **Activity helpers** — what `describeActivity` implementations share.
+
+Providers live in their own packages: `@anywalletkit/protocol-swap2-near-intents`, `-lifi`, `-thorchain`, `-omniston`, `-cctp`, `-usdt0`, `-chainflip`, `-jupiter`, `-uniswap`, `-balancer`, `-wrap`. `@anywalletkit/protocol-swap2-router` auctions several of them.
+
+```sh
+pnpm add @anywalletkit/protocol-swap2-core
+```
+
+Docs: [Swaps](https://docs.anywallet.tech/guides/swaps/)
+
+Apache-2.0

package/dist/activity.cjs

@@ -0,0 +1,137 @@
+"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, {
+  assetLabel: () => assetLabel,
+  assetMetaFor: () => assetMetaFor,
+  callSelector: () => callSelector,
+  calledContract: () => calledContract,
+  callsContract: () => callsContract,
+  chainLabel: () => chainLabel,
+  describeSwapLike: () => describeSwapLike,
+  matchesCall: () => matchesCall,
+  ownerAssets: () => ownerAssets,
+  shortAddress: () => shortAddress
+});
+module.exports = __toCommonJS(activity_exports);
+var import_core = require("@anywalletkit/core");
+var import_swap2_assets = require("@anywalletkit/swap2-assets");
+function calledContract(tx) {
+  const to = tx.call?.to ?? tx.to;
+  if (!to) return null;
+  return to.startsWith("0x") ? to.toLowerCase() : to;
+}
+function callSelector(tx) {
+  const explicit = tx.call?.selector;
+  if (explicit && /^0x[0-9a-fA-F]{8}$/.test(explicit)) return explicit.toLowerCase();
+  const data = tx.call?.data;
+  if (data && /^0x[0-9a-fA-F]{8}/.test(data)) return data.slice(0, 10).toLowerCase();
+  return void 0;
+}
+function callsContract(tx, contract) {
+  const to = calledContract(tx);
+  if (!to) return false;
+  return to.startsWith("0x") ? to === contract.toLowerCase() : to === contract;
+}
+function matchesCall(tx, contracts, selectors) {
+  const to = calledContract(tx);
+  if (!to) return false;
+  let hit = false;
+  for (const c of contracts) {
+    if ((c.startsWith("0x") ? c.toLowerCase() : c) === to) {
+      hit = true;
+      break;
+    }
+  }
+  if (!hit) return false;
+  if (!selectors) return true;
+  const want = /* @__PURE__ */ new Set();
+  for (const s of selectors) want.add(s.toLowerCase());
+  if (want.size === 0) return true;
+  const sel = callSelector(tx);
+  return sel !== void 0 && want.has(sel);
+}
+function chainLabel(caip2) {
+  return (0, import_swap2_assets.ccChain)(caip2)?.label ?? caip2;
+}
+function shortAddress(a) {
+  return a.length > 14 ? `${a.slice(0, 6)}\u2026${a.slice(-4)}` : a;
+}
+function assetMetaFor(tx) {
+  const fromTransfers = /* @__PURE__ */ new Map();
+  for (const t of tx.transfers) {
+    const key = t.token === null ? null : t.token.startsWith("0x") ? t.token.toLowerCase() : t.token;
+    if (fromTransfers.has(key)) continue;
+    const meta = {};
+    if (t.symbol !== void 0) meta.symbol = t.symbol;
+    if (t.decimals !== void 0) meta.decimals = t.decimals;
+    if (meta.symbol !== void 0 || meta.decimals !== void 0) fromTransfers.set(key, meta);
+  }
+  return (token) => {
+    const key = token === null ? null : token.startsWith("0x") ? token.toLowerCase() : token;
+    const known = fromTransfers.get(key);
+    if (known?.symbol !== void 0 && known.decimals !== void 0) return known;
+    const cat = (0, import_swap2_assets.ccAssetByToken)(tx.chain, token ?? "");
+    if (!cat) return known;
+    const meta = { symbol: known?.symbol ?? cat.symbol, decimals: known?.decimals ?? cat.decimals };
+    return meta;
+  };
+}
+function assetLabel(tx, a) {
+  if (a.symbol) return a.symbol;
+  if (a.token === null) return (0, import_swap2_assets.ccAssetByToken)(tx.chain, "")?.symbol ?? "native";
+  return shortAddress(a.token);
+}
+function ownerAssets(tx, ctx) {
+  return (0, import_core.splitNet)((0, import_core.netTransfers)(tx, ctx.own), assetMetaFor(tx));
+}
+function lead(tx, assets) {
+  const a = assets.find((x) => x.symbol) ?? assets[0];
+  return a ? assetLabel(tx, a) : void 0;
+}
+function describeSwapLike(tx, ctx, o) {
+  const { assetsIn, assetsOut } = ownerAssets(tx, ctx);
+  const inLabel = lead(tx, assetsIn);
+  const outLabel = lead(tx, assetsOut);
+  let kind;
+  if (o.kind === "auto") kind = assetsIn.length > 0 && assetsOut.length > 0 ? "swap" : "bridge";
+  else kind = o.kind;
+  let title = o.title;
+  if (title === void 0) {
+    const received = inLabel ? `Received ${inLabel}${o.inSuffix ? ` ${o.inSuffix}` : ""}` : void 0;
+    if (kind === "bridge") {
+      if (outLabel) title = `${o.outVerb ?? "Bridged"} ${outLabel}`;
+      else if (received) title = received;
+    } else if (outLabel && inLabel) title = `Swapped ${outLabel} \u2192 ${inLabel}`;
+    else if (outLabel) title = `${o.outVerb ?? "Swapped"} ${outLabel}`;
+    else if (received) title = received;
+    if (title === void 0) {
+      if (tx.status === "failed") title = `Failed ${kind}`;
+      else return null;
+    }
+  }
+  const counterparty = o.counterparty ?? tx.call?.to ?? tx.to ?? void 0;
+  const extra = { protocol: o.protocol, assetsIn, assetsOut };
+  if (o.subtitle !== void 0) extra.subtitle = o.subtitle;
+  if (counterparty !== void 0) extra.counterparty = counterparty;
+  return (0, import_core.activityBase)(tx, kind, title, extra);
+}
+//# sourceMappingURL=activity.cjs.map

package/dist/activity.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/activity.ts"],"sourcesContent":["/**\n * Shared `describeActivity` plumbing for the swap2 provider modules.\n *\n * A provider recognizes one of its own transactions offline (contract called +\n * 4-byte selector, or a known counterparty on non-EVM chains) and this file\n * turns the chain-normalized `ChainTx` into the wallet-facing `ActivityItem`:\n * net asset movement for the owner's addresses, symbols / decimals from the\n * transfers themselves or the swap2-assets catalog, and a \"Swapped X → Y\" /\n * \"Bridged X\" / \"Received X\" title. Pure and synchronous, like the hook itself.\n */\nimport {\n  activityBase,\n  netTransfers,\n  splitNet,\n  type ActivityAsset,\n  type ActivityItem,\n  type ActivityKind,\n  type ChainTx,\n  type DescribeActivityContext,\n} from \"@anywalletkit/core\";\nimport {ccAssetByToken, ccChain} from \"@anywalletkit/swap2-assets\";\n\n/** The contract a transaction invoked (EVM `to`, Solana program, TON destination), lowercase for EVM. */\nexport function calledContract(tx: ChainTx): string | null {\n  const to = tx.call?.to ?? tx.to;\n  if (!to) return null;\n  return to.startsWith(\"0x\") ? to.toLowerCase() : to;\n}\n\n/** 4-byte selector of an EVM call (`0x`-prefixed, lowercase), from `call.selector` or the calldata. */\nexport function callSelector(tx: ChainTx): string | undefined {\n  const explicit = tx.call?.selector;\n  if (explicit && /^0x[0-9a-fA-F]{8}$/.test(explicit)) return explicit.toLowerCase();\n  const data = tx.call?.data;\n  if (data && /^0x[0-9a-fA-F]{8}/.test(data)) return data.slice(0, 10).toLowerCase();\n  return undefined;\n}\n\n/** Does `tx` call `contract` (case-insensitive for EVM)? */\nexport function callsContract(tx: ChainTx, contract: string): boolean {\n  const to = calledContract(tx);\n  if (!to) return false;\n  return to.startsWith(\"0x\") ? to === contract.toLowerCase() : to === contract;\n}\n\n/** Does `tx` call one of `contracts` with one of `selectors` (any selector when the set is empty)? */\nexport function matchesCall(tx: ChainTx, contracts: Iterable<string>, selectors?: Iterable<string>): boolean {\n  const to = calledContract(tx);\n  if (!to) return false;\n  let hit = false;\n  for (const c of contracts) {\n    if ((c.startsWith(\"0x\") ? c.toLowerCase() : c) === to) {\n      hit = true;\n      break;\n    }\n  }\n  if (!hit) return false;\n  if (!selectors) return true;\n  const want = new Set<string>();\n  for (const s of selectors) want.add(s.toLowerCase());\n  if (want.size === 0) return true;\n  const sel = callSelector(tx);\n  return sel !== undefined && want.has(sel);\n}\n\n/** Human label of a chain for subtitles (\"Base\", \"Ethereum\"), falling back to the CAIP-2 id. */\nexport function chainLabel(caip2: string): string {\n  return ccChain(caip2)?.label ?? caip2;\n}\n\n/** `0x1234…abcd` for an address the catalog does not name. */\nexport function shortAddress(a: string): string {\n  return a.length > 14 ? `${a.slice(0, 6)}…${a.slice(-4)}` : a;\n}\n\n/**\n * Symbol / decimals per token: what the transfers already carry first, then the\n * swap2-assets catalog for the chain (native asset = `token === null`).\n */\nexport function assetMetaFor(tx: ChainTx): (token: string | null) => Partial<ActivityAsset> | undefined {\n  const fromTransfers = new Map<string | null, Partial<ActivityAsset>>();\n  for (const t of tx.transfers) {\n    const key = t.token === null ? null : t.token.startsWith(\"0x\") ? t.token.toLowerCase() : t.token;\n    if (fromTransfers.has(key)) continue;\n    const meta: Partial<ActivityAsset> = {};\n    if (t.symbol !== undefined) meta.symbol = t.symbol;\n    if (t.decimals !== undefined) meta.decimals = t.decimals;\n    if (meta.symbol !== undefined || meta.decimals !== undefined) fromTransfers.set(key, meta);\n  }\n  return (token) => {\n    const key = token === null ? null : token.startsWith(\"0x\") ? token.toLowerCase() : token;\n    const known = fromTransfers.get(key);\n    if (known?.symbol !== undefined && known.decimals !== undefined) return known;\n    const cat = ccAssetByToken(tx.chain, token ?? \"\");\n    if (!cat) return known;\n    const meta: Partial<ActivityAsset> = {symbol: known?.symbol ?? cat.symbol, decimals: known?.decimals ?? cat.decimals};\n    return meta;\n  };\n}\n\n/** Symbol for a title: the asset's symbol, the chain's native coin, or a shortened address. */\nexport function assetLabel(tx: ChainTx, a: ActivityAsset): string {\n  if (a.symbol) return a.symbol;\n  if (a.token === null) return ccAssetByToken(tx.chain, \"\")?.symbol ?? \"native\";\n  return shortAddress(a.token);\n}\n\n/** Net movement for the owner, split into what left and what arrived, with symbols. */\nexport function ownerAssets(tx: ChainTx, ctx: DescribeActivityContext): {assetsIn: ActivityAsset[]; assetsOut: ActivityAsset[]} {\n  return splitNet(netTransfers(tx, ctx.own), assetMetaFor(tx));\n}\n\n/** The largest-looking leg for a title: first asset, preferring one with a symbol. */\nfunction lead(tx: ChainTx, assets: ActivityAsset[]): string | undefined {\n  const a = assets.find((x) => x.symbol) ?? assets[0];\n  return a ? assetLabel(tx, a) : undefined;\n}\n\n/** Labels a swap module passes when describing its own transactions in the activity feed. */\nexport interface SwapActivityOptions {\n  /** Registry module name (`module.json` → `name`). */\n  protocol: string;\n  /** Venue label for the subtitle, e.g. \"LI.FI\", \"Uniswap v3 · Base\". */\n  subtitle?: string;\n  /**\n   * What the transaction is. `swap` / `bridge` get the automatic title\n   * (\"Swapped A → B\", \"Bridged A\", \"Received A\"); `auto` picks `swap` when both\n   * legs netted on this chain and `bridge` otherwise.\n   */\n  kind: ActivityKind | \"auto\";\n  /** Override the computed title. */\n  title?: string;\n  /** Override the counterparty (default: the contract called). */\n  counterparty?: string;\n  /** Verb for a one-legged outbound item (default \"Bridged\"). */\n  outVerb?: string;\n  /** Suffix for a one-legged inbound item, e.g. \"via CCTP\" → \"Received USDC via CCTP\". */\n  inSuffix?: string;\n}\n\n/**\n * Build the item once the caller has decided the transaction is this module's.\n * Returns null only when the owner moved nothing and no title was given — a\n * recognized call that touched none of the owner's balances is not activity.\n */\nexport function describeSwapLike(tx: ChainTx, ctx: DescribeActivityContext, o: SwapActivityOptions): ActivityItem | null {\n  const {assetsIn, assetsOut} = ownerAssets(tx, ctx);\n  const inLabel = lead(tx, assetsIn);\n  const outLabel = lead(tx, assetsOut);\n  let kind: ActivityKind;\n  if (o.kind === \"auto\") kind = assetsIn.length > 0 && assetsOut.length > 0 ? \"swap\" : \"bridge\";\n  else kind = o.kind;\n  let title = o.title;\n  if (title === undefined) {\n    const received = inLabel ? `Received ${inLabel}${o.inSuffix ? ` ${o.inSuffix}` : \"\"}` : undefined;\n    if (kind === \"bridge\") {\n      // A bridge leg names what left; an inbound dust refund (gas rebate, surplus) is not the destination asset.\n      if (outLabel) title = `${o.outVerb ?? \"Bridged\"} ${outLabel}`;\n      else if (received) title = received;\n    } else if (outLabel && inLabel) title = `Swapped ${outLabel} → ${inLabel}`;\n    else if (outLabel) title = `${o.outVerb ?? \"Swapped\"} ${outLabel}`;\n    else if (received) title = received;\n    if (title === undefined) {\n      if (tx.status === \"failed\") title = `Failed ${kind}`;\n      else return null;\n    }\n  }\n  const counterparty = o.counterparty ?? tx.call?.to ?? tx.to ?? undefined;\n  const extra: Partial<ActivityItem> = {protocol: o.protocol, assetsIn, assetsOut};\n  if (o.subtitle !== undefined) extra.subtitle = o.subtitle;\n  if (counterparty !== undefined) extra.counterparty = counterparty;\n  return activityBase(tx, kind, title, extra);\n}\n"],"mappings":"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","names":[]}

package/dist/activity.d.cts

@@ -0,0 +1,66 @@
+import { ActivityKind, ChainTx, ActivityAsset, DescribeActivityContext, ActivityItem } from '@anywalletkit/core';
+
+/**
+ * Shared `describeActivity` plumbing for the swap2 provider modules.
+ *
+ * A provider recognizes one of its own transactions offline (contract called +
+ * 4-byte selector, or a known counterparty on non-EVM chains) and this file
+ * turns the chain-normalized `ChainTx` into the wallet-facing `ActivityItem`:
+ * net asset movement for the owner's addresses, symbols / decimals from the
+ * transfers themselves or the swap2-assets catalog, and a "Swapped X → Y" /
+ * "Bridged X" / "Received X" title. Pure and synchronous, like the hook itself.
+ */
+
+/** The contract a transaction invoked (EVM `to`, Solana program, TON destination), lowercase for EVM. */
+declare function calledContract(tx: ChainTx): string | null;
+/** 4-byte selector of an EVM call (`0x`-prefixed, lowercase), from `call.selector` or the calldata. */
+declare function callSelector(tx: ChainTx): string | undefined;
+/** Does `tx` call `contract` (case-insensitive for EVM)? */
+declare function callsContract(tx: ChainTx, contract: string): boolean;
+/** Does `tx` call one of `contracts` with one of `selectors` (any selector when the set is empty)? */
+declare function matchesCall(tx: ChainTx, contracts: Iterable<string>, selectors?: Iterable<string>): boolean;
+/** Human label of a chain for subtitles ("Base", "Ethereum"), falling back to the CAIP-2 id. */
+declare function chainLabel(caip2: string): string;
+/** `0x1234…abcd` for an address the catalog does not name. */
+declare function shortAddress(a: string): string;
+/**
+ * Symbol / decimals per token: what the transfers already carry first, then the
+ * swap2-assets catalog for the chain (native asset = `token === null`).
+ */
+declare function assetMetaFor(tx: ChainTx): (token: string | null) => Partial<ActivityAsset> | undefined;
+/** Symbol for a title: the asset's symbol, the chain's native coin, or a shortened address. */
+declare function assetLabel(tx: ChainTx, a: ActivityAsset): string;
+/** Net movement for the owner, split into what left and what arrived, with symbols. */
+declare function ownerAssets(tx: ChainTx, ctx: DescribeActivityContext): {
+    assetsIn: ActivityAsset[];
+    assetsOut: ActivityAsset[];
+};
+/** Labels a swap module passes when describing its own transactions in the activity feed. */
+interface SwapActivityOptions {
+    /** Registry module name (`module.json` → `name`). */
+    protocol: string;
+    /** Venue label for the subtitle, e.g. "LI.FI", "Uniswap v3 · Base". */
+    subtitle?: string;
+    /**
+     * What the transaction is. `swap` / `bridge` get the automatic title
+     * ("Swapped A → B", "Bridged A", "Received A"); `auto` picks `swap` when both
+     * legs netted on this chain and `bridge` otherwise.
+     */
+    kind: ActivityKind | "auto";
+    /** Override the computed title. */
+    title?: string;
+    /** Override the counterparty (default: the contract called). */
+    counterparty?: string;
+    /** Verb for a one-legged outbound item (default "Bridged"). */
+    outVerb?: string;
+    /** Suffix for a one-legged inbound item, e.g. "via CCTP" → "Received USDC via CCTP". */
+    inSuffix?: string;
+}
+/**
+ * Build the item once the caller has decided the transaction is this module's.
+ * Returns null only when the owner moved nothing and no title was given — a
+ * recognized call that touched none of the owner's balances is not activity.
+ */
+declare function describeSwapLike(tx: ChainTx, ctx: DescribeActivityContext, o: SwapActivityOptions): ActivityItem | null;
+
+export { type SwapActivityOptions, assetLabel, assetMetaFor, callSelector, calledContract, callsContract, chainLabel, describeSwapLike, matchesCall, ownerAssets, shortAddress };

package/dist/activity.d.ts

@@ -0,0 +1,66 @@
+import { ActivityKind, ChainTx, ActivityAsset, DescribeActivityContext, ActivityItem } from '@anywalletkit/core';
+
+/**
+ * Shared `describeActivity` plumbing for the swap2 provider modules.
+ *
+ * A provider recognizes one of its own transactions offline (contract called +
+ * 4-byte selector, or a known counterparty on non-EVM chains) and this file
+ * turns the chain-normalized `ChainTx` into the wallet-facing `ActivityItem`:
+ * net asset movement for the owner's addresses, symbols / decimals from the
+ * transfers themselves or the swap2-assets catalog, and a "Swapped X → Y" /
+ * "Bridged X" / "Received X" title. Pure and synchronous, like the hook itself.
+ */
+
+/** The contract a transaction invoked (EVM `to`, Solana program, TON destination), lowercase for EVM. */
+declare function calledContract(tx: ChainTx): string | null;
+/** 4-byte selector of an EVM call (`0x`-prefixed, lowercase), from `call.selector` or the calldata. */
+declare function callSelector(tx: ChainTx): string | undefined;
+/** Does `tx` call `contract` (case-insensitive for EVM)? */
+declare function callsContract(tx: ChainTx, contract: string): boolean;
+/** Does `tx` call one of `contracts` with one of `selectors` (any selector when the set is empty)? */
+declare function matchesCall(tx: ChainTx, contracts: Iterable<string>, selectors?: Iterable<string>): boolean;
+/** Human label of a chain for subtitles ("Base", "Ethereum"), falling back to the CAIP-2 id. */
+declare function chainLabel(caip2: string): string;
+/** `0x1234…abcd` for an address the catalog does not name. */
+declare function shortAddress(a: string): string;
+/**
+ * Symbol / decimals per token: what the transfers already carry first, then the
+ * swap2-assets catalog for the chain (native asset = `token === null`).
+ */
+declare function assetMetaFor(tx: ChainTx): (token: string | null) => Partial<ActivityAsset> | undefined;
+/** Symbol for a title: the asset's symbol, the chain's native coin, or a shortened address. */
+declare function assetLabel(tx: ChainTx, a: ActivityAsset): string;
+/** Net movement for the owner, split into what left and what arrived, with symbols. */
+declare function ownerAssets(tx: ChainTx, ctx: DescribeActivityContext): {
+    assetsIn: ActivityAsset[];
+    assetsOut: ActivityAsset[];
+};
+/** Labels a swap module passes when describing its own transactions in the activity feed. */
+interface SwapActivityOptions {
+    /** Registry module name (`module.json` → `name`). */
+    protocol: string;
+    /** Venue label for the subtitle, e.g. "LI.FI", "Uniswap v3 · Base". */
+    subtitle?: string;
+    /**
+     * What the transaction is. `swap` / `bridge` get the automatic title
+     * ("Swapped A → B", "Bridged A", "Received A"); `auto` picks `swap` when both
+     * legs netted on this chain and `bridge` otherwise.
+     */
+    kind: ActivityKind | "auto";
+    /** Override the computed title. */
+    title?: string;
+    /** Override the counterparty (default: the contract called). */
+    counterparty?: string;
+    /** Verb for a one-legged outbound item (default "Bridged"). */
+    outVerb?: string;
+    /** Suffix for a one-legged inbound item, e.g. "via CCTP" → "Received USDC via CCTP". */
+    inSuffix?: string;
+}
+/**
+ * Build the item once the caller has decided the transaction is this module's.
+ * Returns null only when the owner moved nothing and no title was given — a
+ * recognized call that touched none of the owner's balances is not activity.
+ */
+declare function describeSwapLike(tx: ChainTx, ctx: DescribeActivityContext, o: SwapActivityOptions): ActivityItem | null;
+
+export { type SwapActivityOptions, assetLabel, assetMetaFor, callSelector, calledContract, callsContract, chainLabel, describeSwapLike, matchesCall, ownerAssets, shortAddress };

package/dist/activity.js

@@ -0,0 +1,25 @@
+import {
+  assetLabel,
+  assetMetaFor,
+  callSelector,
+  calledContract,
+  callsContract,
+  chainLabel,
+  describeSwapLike,
+  matchesCall,
+  ownerAssets,
+  shortAddress
+} from "./chunk-J4WXUNK2.js";
+export {
+  assetLabel,
+  assetMetaFor,
+  callSelector,
+  calledContract,
+  callsContract,
+  chainLabel,
+  describeSwapLike,
+  matchesCall,
+  ownerAssets,
+  shortAddress
+};
+//# sourceMappingURL=activity.js.map

package/dist/activity.js.map

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

package/dist/chunk-4H2JVYXT.js

@@ -0,0 +1,82 @@
+import {
+  anySignal,
+  timeoutSignal
+} from "./chunk-SKV5BVXK.js";
+
+// src/remote.ts
+function remoteProvider(opts) {
+  const name = opts.name;
+  if (!/^[A-Za-z0-9_-]+$/.test(name)) throw new Error("swap2-remote: invalid provider name");
+  const baseUrl = opts.baseUrl.replace(/\/+$/, "");
+  if (!baseUrl) throw new Error("swap2-remote: baseUrl is required");
+  const supportsRoute = opts.supportsRoute;
+  const enabled = opts.enabled;
+  const headers = Object.freeze({ ...opts.headers });
+  const doFetch = opts.fetchImpl ?? fetch;
+  const timeoutMs = opts.timeoutMs ?? 12e3;
+  if (!Number.isInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > 6e4) {
+    throw new Error("swap2-remote: timeoutMs must be an integer between 1 and 60000");
+  }
+  async function call(action, body, signal) {
+    const timeout = timeoutSignal(timeoutMs);
+    const requestSignal = signal ? anySignal([signal, timeout]) : timeout;
+    const res = await doFetch(`${baseUrl}/${action}`, {
+      method: "POST",
+      headers: { ...headers, "content-type": "application/json" },
+      // UnsignedTx carries bigint fields (value, gasLimit) — JSON.stringify
+      // throws on them ("Do not know how to serialize a BigInt", seen
+      // 2026-10-10 on a Solana → Base preflight). Wire them as decimal strings.
+      body: JSON.stringify({ provider: name, ...body }, (_k, v) => typeof v === "bigint" ? v.toString() : v),
+      signal: requestSignal
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`swap2-remote ${name}/${action}: ${res.status} ${text.slice(0, 300)}`);
+    }
+    return await res.json();
+  }
+  return {
+    name,
+    // The browser side has no dark-flag env; the backend enforces its own
+    // flags — a disabled provider simply quotes null / rejects build.
+    enabled: () => enabled ? enabled() : true,
+    supportsRoute(from, to) {
+      return supportsRoute ? supportsRoute(from, to) : true;
+    },
+    async getQuote(params, signal) {
+      const out = await call("quote", { params }, signal);
+      if (out && typeof out === "object" && "noQuote" in out) {
+        throw new Error(String(out.noQuote).slice(0, 300));
+      }
+      return out;
+    },
+    async buildDeposit(quote) {
+      return call("build", { quote });
+    },
+    async preflightDeposit(quote, tx) {
+      await call("preflight", { quote, tx });
+    },
+    async trackIntent(ref) {
+      return call("track", { ref });
+    },
+    async notifyDeposit(intentId, txHash) {
+      await call("notify", { intentId, txHash });
+    },
+    async registerSignedOrder(intentId, signature) {
+      await call("register", { intentId, signature });
+    },
+    async buildClaim(ref) {
+      const out = await call("claim", { ref });
+      if (!out || typeof out !== "object" || !("to" in out)) return null;
+      return out;
+    },
+    ...opts.supportsChain ? { supportsChain: opts.supportsChain.bind(opts) } : {},
+    ...opts.supportsChainPair ? { supportsChainPair: opts.supportsChainPair.bind(opts) } : {},
+    ...opts.supportsSameChain !== void 0 ? { supportsSameChain: opts.supportsSameChain } : {}
+  };
+}
+
+export {
+  remoteProvider
+};
+//# sourceMappingURL=chunk-4H2JVYXT.js.map

package/dist/chunk-4H2JVYXT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/remote.ts"],"sourcesContent":["import type {Asset, CrossChainProvider, IntentRef, IntentStatus, Quote, QuoteParams, UnsignedTx} from \"./types.js\";\nimport {anySignal, timeoutSignal} from \"./util.js\";\n\n/**\n * HTTP-proxied `CrossChainProvider`: forwards every provider call to a backend\n * that runs the real provider. This is how a BROWSER context (e.g. a wallet's\n * signing worker) executes the full swap2 layer — account binding,\n * approvals, cell-body guards, id/status lifecycle — while provider secrets\n * (API JWTs, affiliate config) and non-CORS REST endpoints stay server-side.\n *\n * Wire protocol: POST {baseUrl}/{action} with a JSON body, one action per\n * provider method:\n *   quote  {provider, params: QuoteParams}        → Quote | null\n *   build  {provider, quote: Quote}               → UnsignedTx\n *   preflight {provider, quote: Quote, tx: UnsignedTx} → {}\n *   track  {provider, ref: IntentRef}             → IntentStatus\n *   notify {provider, intentId, txHash}           → {}\n *   register {provider, intentId, signature}      → {}\n *   claim  {provider, ref: IntentRef}             → UnsignedTx | null\n *   supports {provider, from, to}                 → {supported: boolean}\n *\n * `supportsRoute`/`enabled` need a SYNC answer, so they are config: pass the\n * routes the backend advertises via `supports`, or leave the default\n * allow-and-let-quote-decide behavior (a null quote is a clean miss).\n */\nexport interface RemoteProviderOptions {\n  /** Provider name the backend multiplexes on (e.g. \"near-intents\"). */\n  name: string;\n  /** Endpoint prefix, e.g. \"/api/v2/swap2\" (same-origin) or absolute URL. */\n  baseUrl: string;\n  /** Sync capability gate; defaults to true (the backend quote decides). */\n  supportsRoute?: (from: Asset, to: Asset) => boolean;\n  /** Optional synchronous dark flag for accurate client-side discovery. */\n  enabled?: () => boolean;\n  /** Optional chain-level discovery hooks mirrored from the backend. */\n  supportsChain?: (caip2: string) => boolean;\n  supportsChainPair?: (fromChain: string, toChain: string) => boolean;\n  /** Explicit opt-in when the backend can execute same-chain swaps. */\n  supportsSameChain?: boolean;\n  /** Defaults to globalThis.fetch — injectable for tests. */\n  fetchImpl?: typeof fetch;\n  /** Extra headers (e.g. auth) attached to every call. */\n  headers?: Record<string, string>;\n  /** Per-request fail-closed timeout. Defaults to 12 seconds. */\n  timeoutMs?: number;\n}\n\n/**\n * A provider that runs on your server: quotes, deposits and tracking go to `baseUrl`, so API keys\n * and affiliate settings never ship in the app. The engine still validates every quote and\n * transaction locally before signing.\n */\nexport function remoteProvider(opts: RemoteProviderOptions): CrossChainProvider {\n  const name = opts.name;\n  if (!/^[A-Za-z0-9_-]+$/.test(name)) throw new Error(\"swap2-remote: invalid provider name\");\n  const baseUrl = opts.baseUrl.replace(/\\/+$/, \"\");\n  if (!baseUrl) throw new Error(\"swap2-remote: baseUrl is required\");\n  const supportsRoute = opts.supportsRoute;\n  const enabled = opts.enabled;\n  const headers = Object.freeze({...opts.headers});\n  const doFetch = opts.fetchImpl ?? fetch;\n  const timeoutMs = opts.timeoutMs ?? 12_000;\n  if (!Number.isInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > 60_000) {\n    throw new Error(\"swap2-remote: timeoutMs must be an integer between 1 and 60000\");\n  }\n\n  async function call<T>(action: string, body: Record<string, unknown>, signal?: AbortSignal): Promise<T> {\n    const timeout = timeoutSignal(timeoutMs);\n    const requestSignal = signal ? anySignal([signal, timeout]) : timeout;\n    const res = await doFetch(`${baseUrl}/${action}`, {\n      method: \"POST\",\n      headers: {...headers, \"content-type\": \"application/json\"},\n      // UnsignedTx carries bigint fields (value, gasLimit) — JSON.stringify\n      // throws on them (\"Do not know how to serialize a BigInt\", seen\n      // 2026-10-10 on a Solana → Base preflight). Wire them as decimal strings.\n      body: JSON.stringify({provider: name, ...body}, (_k, v) => (typeof v === \"bigint\" ? v.toString() : v)),\n      signal: requestSignal,\n    });\n    if (!res.ok) {\n      // Surface the backend's message — provider errors are actionable\n      // (\"quote expired\", \"route unsupported\"), not just status codes.\n      const text = await res.text().catch(() => \"\");\n      throw new Error(`swap2-remote ${name}/${action}: ${res.status} ${text.slice(0, 300)}`);\n    }\n    return (await res.json()) as T;\n  }\n\n  return {\n    name,\n    // The browser side has no dark-flag env; the backend enforces its own\n    // flags — a disabled provider simply quotes null / rejects build.\n    enabled: () => enabled ? enabled() : true,\n    supportsRoute(from: Asset, to: Asset): boolean {\n      return supportsRoute ? supportsRoute(from, to) : true;\n    },\n    async getQuote(params: QuoteParams, signal?: AbortSignal): Promise<Quote | null> {\n      const out = await call<Quote | {noQuote: string} | null>(\"quote\", {params}, signal);\n      if (out && typeof out === \"object\" && \"noQuote\" in out) {\n        // The backend forwarded the venue's own refusal — throw it so the\n        // router records a REASON instead of an anonymous null.\n        throw new Error(String((out as {noQuote: unknown}).noQuote).slice(0, 300));\n      }\n      return out;\n    },\n    async buildDeposit(quote: Quote): Promise<UnsignedTx> {\n      return call<UnsignedTx>(\"build\", {quote});\n    },\n    async preflightDeposit(quote: Quote, tx: UnsignedTx): Promise<void> {\n      await call<Record<string, never>>(\"preflight\", {quote, tx});\n    },\n    async trackIntent(ref: IntentRef): Promise<IntentStatus> {\n      return call<IntentStatus>(\"track\", {ref});\n    },\n    async notifyDeposit(intentId: string, txHash: string): Promise<void> {\n      await call<Record<string, never>>(\"notify\", {intentId, txHash});\n    },\n    async registerSignedOrder(intentId: string, signature: string): Promise<void> {\n      await call<Record<string, never>>(\"register\", {intentId, signature});\n    },\n    async buildClaim(ref: IntentRef): Promise<UnsignedTx | null> {\n      const out = await call<UnsignedTx | null | Record<string, never>>(\"claim\", {ref});\n      // A backend without the action (older deploy) answers {} — treat as \"not ready\".\n      if (!out || typeof out !== \"object\" || !(\"to\" in out)) return null;\n      return out as UnsignedTx;\n    },\n    ...(opts.supportsChain ? {supportsChain: opts.supportsChain.bind(opts)} : {}),\n    ...(opts.supportsChainPair ? {supportsChainPair: opts.supportsChainPair.bind(opts)} : {}),\n    ...(opts.supportsSameChain !== undefined ? {supportsSameChain: opts.supportsSameChain} : {}),\n  };\n}\n"],"mappings":"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","names":[]}