Arbitrum SDK

什么是 Arbitrum SDK？

Arbitrum SDK 是一套用于构建 Arbitrum 链交互应用的开发者工具包，尤其适用于需要代币跨链、跨链消息传递、网络检测、交易追踪或访问 Arbitrum 跨链桥合约的应用。

在加密领域，这个术语通常指 TypeScript 软件包 @arbitrum/sdk，该软件包专为与 Arbitrum 网络进行客户端交互而设计。

SDK 提供了带类型的类和辅助方法，用于处理常见 Arbitrum 操作，帮助开发者避免从头编写底层跨链桥逻辑。

根据官方 Arbitrum SDK GitHub 仓库，该 SDK 提供辅助功能，并可访问底层智能合约接口，以便在 Arbitrum 上构建应用。

对于用户来说，Arbitrum SDK 是不可见的基础设施，可为存入 ETH、跨链转移 ERC-20 代币、提取资产或检查跨链交易是否完成等操作提供支持。

对于开发者来说，Arbitrum SDK 是应用与管理父链到子链、子链到父链通信的智能合约之间的实用中间层。

Arbitrum SDK 在 Arbitrum 生态系统中的作用

Arbitrum 是一个 Ethereum 扩容生态系统，为加密应用提供更低成本的执行、更快捷的用户体验以及专门的区块链环境。

Arbitrum 的整体文档将其描述为支持应用、代币化和专用链的基础设施，因此 SDK 工具对应用开发者和链运营者都很重要。

主 SDK 通常用于 Arbitrum One、Arbitrum Nova 以及采用父子链模式的自定义 Arbitrum 链。

在这种模式中，父链是提供结算、消息传递或基础设施支持的链，而子链则是接收资产、消息或执行请求的 Arbitrum 链。

在 Arbitrum SDK v4 中，父链和子链这一表述变得更加重要，因为 SDK 现在采用了更通用的术语，可同时适用于 Layer 2 和 Layer 3 环境。

官方 Arbitrum SDK v4 迁移指南说明，许多旧有的 L1 和 L2 表述已改为父链和子链术语，以更好地支持范围更广的 Arbitrum 生态系统。

Arbitrum SDK 为何重要

Arbitrum SDK 很重要，因为如果没有可靠工具，构建安全的跨链加密应用会十分困难。

对用户来说，简单的代币跨链可能只是一笔转账，但在后台可能涉及授权、网关、Inbox 合约、可重试票据、状态检查、挑战期和 Outbox 执行。

SDK 将这些步骤中的许多封装到可重复使用的类和方法中，从而降低了操作复杂度。

对于需要在链之间转移资产或消息的钱包、去中心化应用、跨链桥、仪表盘、游戏应用、支付工具、交易界面和链上金融产品来说，这一点非常重要。

如果没有 SDK，开发者就必须直接与跨链桥合约交互，并手动处理许多边缘情况。

使用 SDK 后，开发者可以将更多精力放在用户体验、交易安全、余额显示和应用逻辑上。

Arbitrum SDK 的核心功能

资产跨链

Arbitrum SDK 最重要的用途之一，是在父链和 Arbitrum 子链之间跨链转移资产。

SDK 包含 EthBridger 和 Erc20Bridger 等跨链桥类，用于转移原生资产和 ERC-20 代币。

官方 Arbitrum 跨链桥概览说明，代币跨链和跨链消息传递是构建 Arbitrum 应用的基础部分。

用户向 Arbitrum 链存入 ETH 或其他原生代币时，SDK 可以帮助准备并提交所需交易。

用户存入 ERC-20 代币时，SDK 可以帮助批准网关、发起存款，并等待交易在子链上处理。

官方 Arbitrum 代币存款指南展示了如何使用 Erc20Bridger 批准网关并存入 ERC-20 代币。

跨链消息传递

Arbitrum SDK 还支持跨链消息传递，允许合约或应用在父链和子链之间发送数据或指令。

跨链消息很重要，因为许多加密应用需要的不只是代币转账。

治理系统可能需要传递执行指令，支付应用可能需要触发结算逻辑，游戏则可能需要在不同链之间同步状态。

官方 Arbitrum 跨链消息指南将 @arbitrum/sdk 描述为一个 TypeScript 库，用于在父级和子级 Arbitrum 链之间跨链转移代币和传递消息。

SDK 提供带类型的接口，让这些消息流程更容易构建、测试和监控。

交易状态追踪

Arbitrum SDK 可帮助开发者追踪跨链交易处于待处理、已完成、失败还是可以进入下一步的状态。

这一功能尤其有用，因为跨链活动往往包含不止一个交易生命周期。

从父链向子链存款，可能涉及一笔父链交易，之后还要在子链上执行。

从子链向父链提现，可能涉及在子链上发起操作、等待挑战期，然后在父链上最终执行。

SDK 提供了从交易回执中获取消息并检查其状态的工具。

这有助于应用向用户准确显示进度，避免用户在提交第一笔交易后不知所措。

网络配置

Arbitrum SDK 可以帮助识别 Arbitrum 网络，并获取目标子链的正确配置。

这一点很重要，因为不同的 Arbitrum 链可能具有不同的链 ID、跨链桥地址、代币网关地址、原生代币和结算关系。

正确配置网络可以降低交易发送到错误跨链桥合约的风险。

它还能帮助应用支持多条 Arbitrum 链，而无需手动硬编码每个地址。

Arbitrum SDK 的重要类

EthBridger

当应用需要跨链转移 ETH 或受支持 Arbitrum 链的原生代币时，可以使用 EthBridger。

开发者可以使用它将资产从父链存入子链，也可以发起从子链返回父链的提现。

官方 ETH 存款和消息指南展示了 EthBridger 如何简化向 Arbitrum 子链存款的流程。

对于钱包、支付应用以及任何需要支持 Arbitrum 原生资产转移的加密界面来说，这个类都很实用。

Erc20Bridger

Erc20Bridger 用于 ERC-20 代币的存款和提现。

它可以帮助处理授权流程、网关交互、存款交易、发起提现和追踪消息。

ERC-20 跨链比原生资产跨链更复杂，因为代币可能需要经过标准网关、自定义网关或其他代币跨链逻辑。

SDK 为开发者提供处理多种常见代币跨链任务的一致接口，让流程更加简单。

ParentToChildMessage

ParentToChildMessage 表示从父链发送到 Arbitrum 子链的消息。

当应用需要监控存款或可重试票据是否已在子链上执行时，可以使用这个类。

父链到子链的消息常用于存款、合约调用和跨链指令。

这类消息与可重试票据密切相关，而可重试票据是 Arbitrum 实现可靠消息执行的核心机制。

ChildToParentMessage

ChildToParentMessage 表示从 Arbitrum 子链发送回父链的消息。

该类对提现很重要，因为子链到父链的消息必须经过一段等待期，之后才能在父链上执行。

官方 Arbitrum 代币提现指南说明，由于挑战期，提现大约需要 6.4 天才能完成。

应用可以使用 SDK 消息工具显示提现仍在等待、已准备执行还是已经完成。

可重试票据与 Arbitrum SDK

可重试票据是 Arbitrum 父链到子链消息传递的重要组成部分。

可重试票据是一种机制，可让父链交易创建一项子链执行请求。

官方 Arbitrum 可重试票据文档说明，可重试票据将父链上的提交与子链上的执行分开。

这种设计很实用，因为跨链执行可能取决于 Gas 限额、提交成本、费用出价、调用数据大小和子链基础费用。

Arbitrum SDK 可以帮助估算可重试票据的 Gas 参数，并准备创建票据所需的交易数据。

对于加密用户来说，可重试票据通常隐藏在跨链桥或应用界面之后。

对于开发者来说，在构建可靠的 Arbitrum 存款和合约调用时，可重试票据是最重要的理解机制之一。

Arbitrum SDK v4 与父子链支持

Arbitrum SDK v4 引入了一些变化，以更好地支持结构更加灵活的 Arbitrum 链。

最明显的更新是将旧有的 L1 和 L2 命名方式改为父链和子链术语。

这一变化很有帮助，因为根据设计不同，Arbitrum 子链可能结算到 Ethereum、另一条 Arbitrum 链或其他父链架构。

v4 迁移指南还提到了网络类型、AssetBridger、Erc20Bridger 和消息类的变化。

开发者在更新旧版集成时，应先查阅官方迁移指南，再升级生产环境代码。

对于跨链桥界面、提现追踪器以及支持多条 Arbitrum 链的应用来说，这一点尤其重要。

Arbitrum SDK 与 Arbitrum Chain SDK

Arbitrum SDK 和 Arbitrum Chain SDK 相互关联，但并不是同一种工具。

Arbitrum SDK 通常通过 @arbitrum/sdk 安装，主要用于跨链、消息传递和读取 Arbitrum 网络数据等应用层任务。

Arbitrum Chain SDK 通常通过 @arbitrum/chain-sdk 安装，专为创建、部署和配置自定义 Arbitrum 链而设计。

官方 Arbitrum Chain SDK 部署指南说明，Chain SDK 可以通过准备配置和部署参数，帮助创建新的 Arbitrum 链。

链部署完成后，Chain SDK 还可以帮助生成 Nitro 节点配置。

官方 Arbitrum 节点配置指南说明，prepareNodeConfig 可以为 Nitro 节点生成 JSON 配置对象。

简单来说，Arbitrum SDK 用于开发使用 Arbitrum 链的应用，而 Arbitrum Chain SDK 则用于团队启动或运营 Arbitrum 链。

开发者如何安装 Arbitrum SDK

开发者通常通过 npm 安装 Arbitrum SDK，软件包名称为 @arbitrum/sdk。

常用安装命令为 npm install @arbitrum/sdk。

开发者也可以根据项目设置使用 yarn 或 pnpm 等包管理器。

安装后，开发者会将 SDK 连接到所用父链和子链的 providers、signers 及网络配置。

随后，应用可以使用 EthBridger、Erc20Bridger、ParentToChildMessage 和 ChildToParentMessage 等 SDK 类构建所需流程。

由于 SDK 会与真实的区块链交易交互，开发者应先在受支持的测试网络上测试集成，再使用真实资金。

Arbitrum SDK 的应用场景示例

钱包资产转移

加密钱包可以使用 Arbitrum SDK，让用户在 Arbitrum 链之间转入和转出资产。

钱包可以使用 SDK 状态工具，显示存款何时到达子链，或提现何时可以在父链上执行。

这能改善用户体验，因为跨链交易有时会让人觉得进度不清晰或尚未完成。

去中心化应用

去中心化应用可以使用 Arbitrum SDK，让用户直接从父链为自己在 Arbitrum 链上的账户充值。

这对于希望简化入门流程的 DeFi、支付、游戏、NFT 和现实世界资产应用很有帮助。

应用可以将跨链、状态追踪和智能合约调用整合为一个引导式流程。

代币发行方

代币发行方可以使用 SDK 工具和 Arbitrum 跨链桥文档，支持代币在父链和子链之间转移。

这有助于代币在基于 Arbitrum 的应用中更便于使用。

代币发行方仍应仔细查看网关要求，因为代币的自定义行为可能需要自定义跨链桥配置。

链运营者

启动自定义 Arbitrum 链的团队可以使用 Arbitrum Chain SDK 准备部署参数、配置 Rollup 设置并生成节点配置。

链上线后，他们也可以在应用层使用 @arbitrum/sdk。

这种组合让团队能够同时管理基础设施设置和面向用户的应用流程。

Arbitrum SDK 的优势

• • 它简化父链和子链之间的代币存款与提现。
  • 它提供对跨链桥和消息传递智能合约的带类型访问。
  • 它减少了手动处理跨链交易回执的工作。
  • 它帮助开发者估算和追踪可重试票据的执行情况。
  • 它在 SDK v4 中支持更灵活的父子链关系。
  • 它帮助应用准确显示交易进度，从而改善应用用户体验。

风险与开发者注意事项

Arbitrum SDK 可以让开发更轻松，但不能免除仔细进行安全审查的必要。

开发者仍必须保护私钥、验证代币地址、确认网络配置并测试所有跨链桥流程。

错误的链 ID、错误的 RPC 端点、错误的网关地址或 Gas 不足，都可能导致交易失败或延迟。

用户还应了解，从子链向父链提现可能需要数天，因为系统必须遵守挑战期。

应用应在用户开始提现前清楚说明这一点。

除非产品有充分理由，否则开发者应避免请求无限额代币授权。

他们还应关注依赖项更新，因为 SDK 软件包可能引入不兼容变更，尤其是在主要版本升级时。

使用 Arbitrum SDK 的最佳实践

开发者在构建生产环境集成之前，应先查阅官方文档和官方 GitHub 仓库。

他们应使用当前版本的 SDK；从旧版本升级时，还应查看迁移说明。

发布前，应在安全环境中测试存款、提现、失败的可重试票据、手动兑换和 Outbox 执行流程。

应向用户清楚显示交易状态，例如待处理、已提交、等待挑战期、可以执行、已完成和失败。

在将代币显示为可跨链转移之前，应验证代币元数据和跨链桥配置。

不要隐藏提现所需时间，因为用户需要知道资金何时会在父链上可用。

在用户签署交易之前，界面应说明费用、Gas 要求和退款规则。

常见问题

简单来说，什么是 Arbitrum SDK？

Arbitrum SDK 是一套开发者工具包，帮助加密应用在 Arbitrum 链之间跨链转移资产、发送消息和追踪交易。

Arbitrum SDK 只能用于代币跨链桥吗？

不是。Arbitrum SDK 常用于代币跨链桥，但也支持跨链消息传递、网络配置、交易回执处理和消息状态追踪。

Arbitrum SDK 使用什么编程语言？

主软件包 @arbitrum/sdk 是一个 TypeScript 库，常用于 JavaScript 和 TypeScript 加密应用。

EthBridger 和 Erc20Bridger 有什么区别？

EthBridger 用于转移 ETH 或原生代币，而 Erc20Bridger 用于 ERC-20 代币存款和提现。

Arbitrum 提现为什么需要时间？

从 Arbitrum 子链向父链提现需要经过挑战期，之后消息才能在父链上执行。

Arbitrum SDK 会启动新的 Arbitrum 链吗？

主软件包 @arbitrum/sdk 主要用于应用层的跨链和消息流程；创建和配置 Arbitrum 链则使用 @arbitrum/chain-sdk。

用户需要安装 Arbitrum SDK 吗？

普通用户无需安装 Arbitrum SDK，因为开发者会在钱包、跨链桥、仪表盘和去中心化应用中使用它。

开发者可以在哪里找到 Arbitrum SDK 官方资源？

开发者可以查阅官方 SDK 仓库、npm 软件包页面以及Arbitrum 跨链消息文档。

结语

Arbitrum SDK 是构建使用 Arbitrum 跨链、消息传递和跨链交易流程的加密应用时不可或缺的开发者工具包。

它通过更简洁的 TypeScript 类和辅助方法，帮助开发者与复杂的跨链桥合约交互。

其最重要的功能包括原生资产跨链、ERC-20 跨链、父链到子链的消息传递、子链到父链的消息追踪、可重试票据支持和网络配置。

Arbitrum SDK v4 尤其重要，因为它体现了现代 Arbitrum 部署中广泛采用的父子链模式。

对于用户来说，SDK 可以带来更顺畅的跨链体验和更清晰的交易追踪。

对于开发者来说，它减少了底层集成工作，但仍需要仔细测试、安全审查并清楚地向用户说明相关信息。

随着 Arbitrum 继续支持更多应用和专用链环境，Arbitrum SDK 仍将是连接加密产品与 Arbitrum 生态系统的主要工具之一。