Swap API 介绍：一键完成跨链 Swap

TLDR

Across Swap API 允许你在你的应用中通过一个合约调用发起无缝的跨链swap，从而抽象掉桥、DEX 和胶水逻辑。它支持多条路由路径，返回可直接执行的 calldata（不仅仅是报价），并且在底层与 0x、Uniswap 和 LI.FI 集成以实现 DEX 路由。Swap API 已经与 Lens 和 Infinex 合作上线，提供了一种可组合的、基于 intent 的方式，为你的用户构建更好的跨链体验。

Introduction

向你的应用程序添加跨链swap不应该感觉像闭着眼睛解魔方。但它确实如此。

这就是我们构建 Across Swap API 的原因。

无论你是在 Ethereum 主网、L2 或 BSC 上构建，Swap API 都旨在帮助你更快、更轻松地构建跨链swap。

以下是你需要了解的内容。

The Problem: Crosschain Swaps are Hard to Build

跨链应用程序正在兴起，但构建它们非常困难。

作为一名开发者，你必须将多个桥、去中心化交易所（DEX）和自定义合约拼接在一起，才能将 Token 从链 A 移动到链 B，然后再进行 swap。你最终会陷入维护 API 之间脆弱的胶水逻辑、报价端点、中继器逻辑和合约调用之中。

结果呢？高昂的开发成本、糟糕的用户体验和脆弱的集成。最终，你的用户在单笔交易确认之前就流失了。EVM 链及其他链上对于简单性、可靠性和可组合性存在严重的需求......

因此，我们决定一劳永逸地清理这个烂摊子。

从头开始构建跨链应用会导致高昂的开发成本、糟糕的用户体验和脆弱的集成。

Meet the Swap API: Simple On the Surface, Modular Under the Hood

Across Swap API 让你能够直接从你的应用程序发起一键式跨链swap。

有了它，你的用户可以同时进行桥接和 Token 兑换，而无需离开你的平台。复杂性被抽象掉了，所有这些都通过一个可组合的合约调用来实现。

它是链无关的，并且在你构建的地方与你相遇。非常适合在模块化的多链堆栈上进行构建的开发者。

How It Works

要了解 API 在实践中如何工作，让我们看看核心合约交互。从宏观上看，API 允许你指定：

• 一个 input token（用户拥有的）

• 一个 output token（用户想要的）

• origin chain（用户来自的链）

• destination chain（用户要去的链）

然后它会返回一个可直接执行的合约调用，其中包括你的 dApp 发送交易所需的所有 calldata，从而执行使该交易发生所需的全部 swap-bridge-swap 逻辑。整个过程通过 intents 以无需信任的方式进行，Across 中继器代表用户处理繁重的工作。

你不需要管理报价。你不需要在合约之间拆分逻辑。虽然你了解 swap 发生的确切链，但你的用户永远不必了解。一切正常运行。

一切都发生在一次交易中，从你的 dApp 到用户的钱包。

Across Swap API 在一次合约调用中执行桥接和 swap。

A Deeper Look Under the Hood

在幕后，Swap API 根据你的 Token 输入确定从源到目标的最佳流程。它支持四条路由路径：

1. Custom input → canonical output 示例：链 A 上的 $FROG → 链 B 上的 $USDC。 API 触发源链上的 swap，从 $FROG 到受支持的 canonical token，例如 $USDC。swap完成后，它将 canonical token 桥接到目标链。

2. Canonical input → custom output 示例：链 A 上的 $USDC → 链 B 上的 $CAT。 首先使用 Across 桥接 canonical token。到达后，在目标链上执行 swap，以将 $USDC 转换为所需的 output token $CAT。

3. Custom input → custom output 示例：链 A 上的 $FROG → 链 B 上的 $CAT。 API 首先在源链上将 $FROG swap为 canonical token，例如 $USDC，将其桥接到目标，最后再次 swap为 $CAT。这是一个完整的 swap-bridge-swap 流程。

4. Same token on both ends 示例：链 A 上的 $USDC → 链 B 上的 $USDC。 这是最简单的情况。API 识别到不需要 swap，并使用 Across 的标准机制启动纯桥接交易。

作为开发者，这些流程已被抽象化。API 确定最佳路线，生成 calldata，并让用户的钱包处理执行。

Across Swap API 支持四种不同的路由路径，每种路径都可以通过单击执行。

Built for Builders: What Makes It Different

Across Swap API 是为构建者提供的便利层。这是一个经过深思熟虑的设计选择，植根于 Across 的 intent-based 架构，为你提供模块化的、可组合的构建块，而不会将你锁定在僵化的逻辑中。

以下是它的不同之处：

1. Calldata > Quotes

与大多数仅返回报价的 API 不同，Across Swap API 生成完整的合约调用。它提供了一个完整的交易，可以立即执行，无需组装。

不再需要花费大量时间编写胶水代码和处理极端情况。

2. Modular DEX Integration via 0x, Uniswap’s Trading API, and LI.FI

Across 使用 0x、Uniswap's Trading API 和 LI.FI 来处理 DEX 聚合和路由。我们没有直接聚合 DEX，而是接入了最好的可用基础设施，并将其封装到 Swap API 的跨链流程中。

Across Swap API 使用 0x、Uniswap 和 LI.FI 在底层处理 DEX 聚合和路由。

3. Relayers Handle Bridge + Swap

中继器管理链下的桥接和 swap 执行逻辑，使开发者能够专注于 intent 构造，而不是执行。这也确保了 dApp 和前端之间可靠的行为。

所有 intent 都由 UMA 保护和验证。

4. Across V4

最近推出的 Across V4 极大地加速了向更多链的部署。对于 Swap API 集成者来说，这可以让他们在推出新链时立即访问这些链。

Already Live: Lens and Infinex are Swapping with Across

Lens 和 Infinex 集成了 Across Swap API，以支持其平台上的跨链功能。

Swap API 已经为生产中的实际swap提供支持。

Lens 是 web3 的社交 L2，它使用户能够拥有和控制自己的社交媒体数据和连接。该链集成了 Across Swap API，以在 Lens 生态系统中实现跨链桥接体验。

当 Lens 用户领取奖励或完成需要在链之间移动Token的操作时，API 会在后台处理路由逻辑。它支持无摩擦的桥接、swap执行和可选 Gas 支付，所有这些都由一次交易调用启动。此集成是 Swap API 如何用于典型 dApp 之外的一个主要示例，可以为社交协议和特定于应用程序的流程解锁更顺畅的 UX。（查看此处的技术细节）

Lens 集成了 Across Swap API，以在 Lens 生态系统中实现跨链桥接体验。

Infinex 是一个 DEX 和非托管钱包平台，它为跨多个链的交易、收益、NFT 等提供类似于 CEX 的简单性。该平台最近集成了 Across Swap API，以简化其平台内的跨链swap。Infinex 是一个非托管的跨链 DeFi 平台，提供跨 13 多个区块链的统一“Swidge”（swap + 桥接）体验。

Infinex 集成了 Across Swap API，以简化其平台内的跨链swap。

总而言之，这些集成展示了 Swap API 的强大功能和灵活性，可以改善各种不同类型应用程序的现实世界用户体验。

A Note on Solana Support

对 Solana 的 Swap API 支持已在路线图上，但不包含在初始版本中。

目前，涉及 Solana 的跨链流程将使用 Across 的 Suggested Fee API 和通过 Across 应用程序的合约级逻辑，而不是 Swap API 端点。我们正在努力实现更深入的集成，并将在 Solana 支持推出后更新文档。

Start Building

构建跨链swap不必很难。

如果你正在构建钱包、聚合器、DEX 或任何跨链应用程序，那么 Across Swap API 适合你。

准备好开始了吗？

→ Read the Swap API Docs

→ Join the Integrator Telegram Group

Join the Across community:

Twitter | Discord | Telegram | Farcaster | Hey.xyz | LinkedIn

• 原文链接： across.to/blog/swap-api...
• 登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～