支持 Arbitrum 上的 ETH、ERC-20、ERC-721

Arbitrum API:在以太坊 Layer 2 上进行 ERC-20 支付

用一次 REST 调用在 Arbitrum 上发送 ERC-20 代币。以 Layer-2 费用享受以太坊级别的安全性,并内置存款 Webhook。

7 天免费试用 — 无需信用卡,无需 KYC 即可开始 非托管 — 私钥始终由你掌控 套餐起价 49 欧元/月(490 欧元/年)— 查看套餐和速率限制

Chaingateway 的 Arbitrum API 是一个 REST API,用一次带认证的调用在 Arbitrum 上发送 ERC-20 代币。Arbitrum 是以太坊的 Layer 2 rollup。它使用与以太坊相同的 0x 地址和代币标准,gas 费只是主网的一小部分,并在存款到账时向你的服务器发送 Webhook。7 天免费试用无需 KYC。

Arbitrum 在 rollup 上运行以太坊交易。执行发生在 Layer 2,交易数据结算到以太坊上,安全预算仍然由以太坊承担。在 L1 上没有经济意义的转账,在这里完全可行。

这对支付系统有特定的意义。存款钱包需要被清扫进热钱包,退款以小额发出,批量付款由许多单独的转账组成。

在主网上,这些操作中的每一项都可能产生超过转移金额本身的手续费。在 Arbitrum 上,同样的操作依然足够便宜。你可以按账务需要频繁执行,而不必受限于手续费表所允许的稀疏频率。

三个接口承载支付流程:导入地址、发送 ERC-20 代币、读取 Webhook 通知。认证方式是 Authorization 头中的 Bearer 令牌,面向 https://app.chaingateway.io。请求头 X-Network: testnet 可将任意调用切换到测试网络。

Arbitrum 存款如何到达我的应用?

Arbitrum 存款以签名 Webhook 的形式到达你的应用。你通过 REST API 导入地址,API 监控 Arbitrum,并把这笔转账发送到你的服务器。

流程图:你的应用向 Chaingateway API 发送 REST 请求,API 从 Arbitrum 网络读取数据并向其发送交易。存款到达时,API 向你的服务器发送一条带签名的 Webhook。 你的应用 REST 请求 通过 HTTPS Chaingateway API Bearer 令牌, JSON 响应 Arbitrum 网络 主网或 Sepolia (X-Network 请求头) REST 读取并发送 Webhook 你的服务器 在存款时收到 带签名的 Webhook
请求发往 API,存款事件以带签名的 Webhook 的形式返回。

Arbitrum 如何工作:Rollup 简述

Arbitrum 是一个乐观 rollup。交易在 Arbitrum 自己的基础设施上执行。网络将压缩后的交易数据发布到以太坊,任何人都可以根据链上数据重建 L2 的状态。

「乐观」描述的是安全模型。状态更新在发布时被假定为有效,随后进入一个挑战窗口。期间任何观察者都可以针对不正确的更新提交欺诈证明。以太坊充当争议的仲裁者。

由于底层数据存放在以太坊上,作弊无法被隐藏。L2 继承了 L1 的安全性,而不必自行建立一套验证者集合。

这一设计也解释了费用结构。一笔 Arbitrum 手续费支付两部分。一部分是 L2 上的执行,成本低廉。另一部分是该交易在向以太坊发布批量数据中所占的份额。

自 2024 年 3 月起,这些数据进入了 EIP-4844 引入的 blob 空间。它比普通的以太坊 calldata 更便宜。数百笔转账共享一个批次。因此每笔转账只承担 L1 成本中极小的一部分,而不是完整的 L1 交易手续费。

Arbitrum One 与 Arbitrum Nova

存在两条公开的 Arbitrum 链,名称经常被混淆。Arbitrum One 就是上面描述的 rollup。所有交易数据都落在以太坊上,信任假设归结为以太坊自身的信任假设。

Arbitrum Nova 则运行 AnyTrust 协议。它的交易数据由一个数据可用性委员会(Data Availability Committee)链下持有。

只要该委员会中至少有两名成员诚实行事,系统就保持稳固。如果委员会未能提供数据,链会回退到完整 rollup 模式。将数据保留在以太坊之外让 Nova 再度变得更便宜,代价是多了这一层信任假设。

在实践中这种划分很清晰。Nova 承载游戏和社交类应用。这类工作负载交易数量极多、单笔价值很低,委员会带来的权衡是可以接受的。Arbitrum One 承载 DeFi 协议、稳定币流动性和交易所支持。

当一个支付集成、交易所提现页面或本文在没有限定词的情况下说「Arbitrum」时,指的就是 Arbitrum One。这是你用户的 USDC 和 USDT 实际存放的链。

Arbitrum 接口

接口作用
POST /api/v2/arbitrum/addresses创建新的存款地址
POST /api/v2/arbitrum/addresses/import为已有地址导入私钥
POST /api/v2/arbitrum/transactions/erc20发送一笔 ERC-20 代币
POST /api/v2/arbitrum/webhooks为某个地址创建存款 Webhook
GET /api/v2/arbitrum/webhooks/notifications获取你账户下的 Webhook 通知列表

这一组接口覆盖了存款和付款流程。原生 ETH 转账、余额与区块查询、gas 价格、解码后的交易,以及失败通知重放接口,构成了 文档 中其余的接口能力。

账户级数据来自 GET /api/account。如果你已经在以太坊或其他 EVM 链上使用 Chaingateway,Arbitrum 的调用会显得很熟悉。它们遵循相同的结构。

在 Arbitrum 上发送一笔 ERC-20 代币

转账调用需要代币合约地址、发送方、接收方和金额,外加你在导入发送方私钥时设置的密码。gas 估算、nonce 管理和广播都在 API 一侧完成。

cURL
curl -X POST https://app.chaingateway.io/api/v2/arbitrum/transactions/erc20 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contractaddress": "0xYourTokenContract",
    "from": "0xYourHotWallet",
    "to": "0xRecipient",
    "amount": 100,
    "password": "YourWalletPassword"
  }'

这就是完整的请求——创建账户,先在 Arbitrum Sepolia 上试一试。

Arbitrum 上的转账比以太坊便宜多少?

更便宜,而且实际差别一次调用就能看到。不要相信固定数字,而是对比 GET /api/v2/ethereum/gasprice 和 GET /api/v2/arbitrum/gasprice。Arbitrum 手续费支付两部分:低廉的 Layer 2 执行,以及该交易在向以太坊发布批量数据中所占的份额。计算方式见 Arbitrum 手续费文档。

两条链都是动态定价,所以绝对数字会随 ETH 价格和网络负载波动。主网上的 gas 拍卖机制会恰好在活动高峰期让手续费飙升。这对支付业务来说是最糟糕的相关性。

对支付后端来说,这个差距很重要,因为支付操作会成倍放大手续费。一笔客户存款意味着一笔转入、一次清扫进热钱包,最终还有一笔转出付款。一次付款对应三次手续费事件。

在主网价格下,团队的应对方式是批量清扫、延迟付款。被延迟的资金则表现为分散在各个存款钱包中被搁置的营运资金。在 Arbitrum 价格下,你可以按计划清扫、按需付款,手续费这一行很容易被吸收。

小额支付也重新变得可行。当 gas 占去小额转账的很大一部分时,没有人能在主网上给小金额标价。每笔转账的手续费更低,按笔计费、按用量计费和小额退款就变得可行。

我的以太坊代码在 Arbitrum 上无需改动吗?

对支付路径来说,是的。Arbitrum 完全兼容 EVM,对支付而言这句话有精确的含义。同样的 0x 地址格式,同样的 EIP-55 校验和,同样的 ERC-20 合约接口,同样的签名方案。部署在 Arbitrum 上的代币合约暴露的 transfer 函数与其主网上的对应版本完全相同。

代币标准本身没有为 L2 重新发明任何东西。这也是为什么为以太坊构建的钱包、区块浏览器和库,只需更换 RPC 端点就能处理 Arbitrum,无需其他改动。

通过 API,这一切浓缩为一个路径片段。POST /api/v2/ethereum/transactions/erc20 和 POST /api/v2/arbitrum/transactions/erc20 接受完全相同的请求体。请求体包括合约地址、from、to 和 amount。

你的校验逻辑、Webhook 处理程序和数据库结构可以原样保留。这是因为两条链上的地址和交易哈希形式相同。

带来的实际好处可以直白地说清楚:同一个 API 调用,换一条链。已经通过 Chaingateway 运行以太坊的团队,通常一个下午就能加上 Arbitrum。他们把「链」变成配置表中的一列,而不是代码中的一个分支。

有一件事无法直接沿用:余额。这是下一节的内容。

资产必须先存在于 Arbitrum 上

一个 ERC-20 余额是某条特定链上合约内部的一条记录。以太坊上的 USDT 和 Arbitrum 上的 USDT 是两条不同的合约记录。持有其中一个并不能让你获得另一个。

在你的热钱包能在 Arbitrum 上发送代币之前,这些代币必须先存在于 Arbitrum 上。API 无法凭空把它们搬过去。没有任何 API 能做到这一点。

有两条常见途径能把代币送到那里。Arbitrum 跨链桥在以太坊上锁定代币,并在 L2 上铸造其对应的代表资产。

同样的机制反过来运行,用于提现回 L1。这个方向包含挑战窗口。因此通过官方跨链桥把价值转回以太坊大约需要一周时间。除非你付费给第三方的快速跨链桥来垫付流动性。

对大多数运营者来说,更简单的途径是从支持 Arbitrum 提现的交易所直接提现。一步就能把代币放到 L2 上,完全跳过跨链桥的机制。

也要为 gas 做好预算。Arbitrum 上的手续费以 ETH 支付。因此热钱包在持有代币的同时,也需要在 L2 上保留少量 ETH 余额。

金额很小。但一个持有代币却没有 ETH 的钱包完全无法转账。这种失败模式应该在被写进事后复盘之前,先触发一条监控告警。

亚秒级出块链上的存款 Webhook

Arbitrum 的出块速度远低于一秒,因此存款几乎在用户发送后立刻就能被看到。Chaingateway 会把这一事件转发到你的后端,而不是让你去轮询。

在你的账户中设置一个私密密钥后,每次 Webhook 投递都会携带一个 X-Signature 请求头。它是对 payload 中 txid 字段做 HMAC-SHA256 并用 base64 编码的结果。你可以用它验证投递确实来自 Chaingateway。

投递失败的通知会保留在失败通知列表中。可以通过 POST /api/v2/arbitrum/webhooks/notifications/{id}/retry 重新发送。

GET /api/v2/arbitrum/webhooks/notifications 返回投递历史。它便于审计,也便于在你这边发生停机后重放事件。Webhook 指南介绍了设置方法和签名验证。

如何在 Arbitrum 上接收存款?

为每位客户提供专属的存款地址,并通过 Webhook 监控这些地址;监控不需要任何密钥。每位客户一个地址,这使得传入付款无需用户经常忘记填写的备注字段即可归属清晰。

从存款到入账

一位客户从其交易所账户发送 200 USDC,并选择 Arbitrum 作为提现网络。区块在远低于一秒的时间内落地,因此转账几乎立刻上链。

Chaingateway 会向你的接口发送这一事件的 POST 请求。你的处理程序验证 HMAC 签名,将代币合约与白名单核对,并将该笔存款记录为待处理。一旦存款满足你自己的确认策略,该记录就切换为已入账。

在这样快速的链上,客户会把整个过程体验为即时完成。这在收银环节是有价值的。「已收到付款」是在用户开始怀疑是否成功之前出现,还是之后出现,这中间的差别很重要。

清扫与付款

接下来是那些曾经因为 L1 手续费而令人头疼的日常事务。按计划,或者每当某个余额超过阈值时,你通过 POST /api/v2/arbitrum/transactions/erc20 把存款从存款地址清扫进热钱包。在 Layer-2 手续费下,这可以按小时执行而不是按周执行。这让资金集中在付款流程能够触达的地方,而不是零散分布在成百上千个地址上。

提现是同一个调用,方向相反:从热钱包到客户地址。这套流程中除了路径片段和手续费水平之外,没有任何东西是 Arbitrum 特有的。而正是手续费水平让按小时的清扫计划变得可以承受。

为什么要在 Arbitrum 上构建支付系统

完全兼容 EVM 意味着以太坊方面的知识可以一对一迁移。地址校验和、代币合约以及签名行为都与主网完全一致。手续费只是以太坊 L1 的一小部分,这让小额转账从亏损变成了可以忽略的舍入误差。

安全性来源于以太坊本身,因为交易数据被发布到 L1,错误的状态可以在那里被挑战。而且这个生态并不是对未来的押注。大型 DeFi 协议今天就在 Arbitrum 上生产运行,因此流动性、区块浏览器和钱包支持已经存在。

Arbitrum 上的任意代币,包括你自己的代币

Chaingateway 支持 Arbitrum 上的标准代币。这包括成熟的稳定币,也包括跨链桥接的资产和自定义发行的代币。集成方式在每条受支持的链上都是一样的。构建一次,扩展时把同一份代码指向 /api/v2/ethereum/、/api/v2/polygon/ 或 /api/v2/bsc/。blockchain API 总览列出了全部七条链。

覆盖各种支付场景

这些应用场景与其他 EVM 链相同。它们包括几秒内即可结算的稳定币收银流程、交易平台的存款监控、来自热钱包的提现处理、空投和归属付款、SaaS 的周期性计费,以及跨境转账。Arbitrum 突出的地方在于那些被主网价格挤出局的场景。它们是微支付、高频清扫,以及每个都需要偶尔维护交易的按用户存款地址。

大多数团队并不是从零开始构建 Arbitrum 支持。他们是把它作为第二条链加到已有的 Chaingateway 集成中。他们复用同一代码路径,按请求切换链。

Testnet:同一个 API,面向 Arbitrum Sepolia

为任意请求添加 X-Network: testnet,它就会运行在测试网络上。Arbitrum 的公共测试网是 Arbitrum Sepolia。测试用 ETH 可以从水龙头免费获取。路径、请求体和响应结构都不会改变,因此你演练用的代码与最终上线的代码逐字节相同。

在上主网之前,至少完整跑一遍存款周期:传入转账、Webhook 投递、签名验证、清扫。有些错误值得提前发现。例如处理程序在错误的 payload 字段上计算 HMAC,或者接口被负载均衡器超时中断。这些错误在测试网和生产环境中的表现完全一致。

唯一的区别是它们让你付出的代价。上线只是删除那一个请求头。

当请求失败时

客户端错误和服务器错误需要相反的处理方式。4xx 意味着请求本身有问题,例如令牌过期、地址格式错误、钱包无法覆盖的金额。

重试相同的请求只会重复这个拒绝。记录下来并修正输入。5xx 或网络超时不能说明你的输入有任何问题,所以应使用指数退避加上限进行重试。

真正值得为之设计的情形是发送操作中那种模棱两可的超时。你的 HTTP 客户端放弃了,但转账可能其实已经发出去了。盲目地重发正是重复付款的成因。

在重试任何转账之前,先检查实际发出去了什么。GET /api/v2/arbitrum/transactions 列出了通过 API 创建的转账。只有在能确认第一次尝试确实失败时才重新发送。

从第一天起就把这项检查内置到付款处理程序中。它每次重试只多花一次 GET 请求的成本。这能省下那次代价高得多的对话:要求客户把重复付款寄回来。

三步进入生产环境

Step 1

获取你的 API 密钥。注册后密钥立即可用;7 天试用无需 KYC。

Step 2

发出你的第一个请求。快速入门指南会带你走完第一个地址和第一笔转账。

Step 3

设置 Webhook 并上线。按照 Webhook 指南将你的后端订阅存款事件,然后移除 X-Network: testnet 请求头。套餐和限额见定价页面。

各条链支持哪些功能

Arbitrum 继承了以太坊的 ERC-20 请求模式,并通过 rollup 继承了以太坊的安全性。下表将它与该 API 覆盖的其他六条链并列展示。

链地址代币转账存款 Webhook
BitcoinPOST /api/v2/bitcoin/wallets/{wallet}/addresses—(无代币标准)GET /api/v2/bitcoin/webhooks/notifications
EthereumPOST /api/v2/ethereum/addresses/importERC-20:POST /api/v2/ethereum/transactions/erc20GET /api/v2/ethereum/webhooks/notifications
TRONPOST /api/v2/tron/addresses/importTRC-20 和 TRC-10:POST /api/v2/tron/transactions/trc20 和 .../trc10GET /api/v2/tron/webhooks/notifications
SolanaPOST /api/v2/solana/addressesSPL:POST /api/v2/solana/transactions/SPL—
BNB Smart ChainPOST /api/v2/bsc/addresses/importBEP-20:POST /api/v2/bsc/transactions/bep20GET /api/v2/bsc/webhooks/notifications
PolygonPOST /api/v2/polygon/addresses/importERC-20:POST /api/v2/polygon/transactions/erc20GET /api/v2/polygon/webhooks/notifications
ArbitrumPOST /api/v2/arbitrum/addresses/importERC-20:POST /api/v2/arbitrum/transactions/erc20GET /api/v2/arbitrum/webhooks/notifications

正确理解此表需要两点说明。第一:TRON 是平台上集成最深的链。除上述路由外,参考文档还记录了质押(POST /api/v2/tron/freeze 和 /delegate)和链参数。

另外还有一对自签名接口。/transactions/trc20/build 用于构建交易。/transactions/broadcast 用于提交本地签名后的交易。你的合规团队可能坚持要求私钥永远不离开你的服务器。这时就用 build-and-broadcast 模式。

第二:表格中的破折号表示当前参考文档尚未记录该单元格对应的 v2 路由。这并不意味着该网络是二等公民。

Bitcoin 没有代币标准,因此代币列为空。原生 BTC 通过自己的钱包模型运行。用 POST /api/v2/bitcoin/wallets 创建密码加密的钱包,并在其下派生存款地址。再通过 POST /api/v2/bitcoin/transactions 发送。

Solana 的参考文档涵盖地址创建、SOL 和 SPL 转账,以及余额和区块查询。但它尚无 Webhook。此处未列出的内容,请参阅 API 参考文档 获取当前状态。

来源与延伸阅读

以下一手资料记录了本页所述的标准和链上行为:

常见问题:Arbitrum API

可以。Arbitrum 以 Layer-2 手续费和以太坊级别的安全性结算 ERC-20 转账。分配一个存款地址、注册 Webhook,在转账结算后为 USDC 或任意 ERC-20 入账;付款使用 POST /api/v2/arbitrum/transactions/erc20。与以太坊上相同的请求结构,只是运行在 Arbitrum 上。

你通过 POST /api/v2/arbitrum/addresses/import 导入的私钥用于签署你的转出转账。接收资金完全不需要密钥:通过 Webhook 监控存款地址,只为你实际发送资金的钱包导入私钥。

是的,除了路径片段不同。/api/v2/ethereum/transactions/erc20 和 /api/v2/arbitrum/transactions/erc20 接受相同的请求体。团队通常用一套代码路径加一个链参数来同时运行两条链。

Arbitrum 上的任意 ERC-20 代币。USDT、USDC 和 DAI 开箱即用,自动处理小数位;其他代币则传入合约地址即可。

支持。为任意请求添加 X-Network: testnet 请求头,它就会运行在测试网络上。请求体和响应保持不变,因此上线只是一行改动。

限额取决于你选择的套餐;详情见定价页面。每个账户都以 7 天免费试用开始,无需 KYC,因此你可以先用真实流量验证集成。

Arbitrum One 将全部交易数据发布到以太坊,完整继承其安全性。Nova 将数据交由一个数据可用性委员会保管,并假设至少两名成员保持诚实,这使它更便宜,适合高交易量的游戏流量。稳定币流动性、DeFi 和交易所支持都在 Arbitrum One 上,支付集成在说「Arbitrum」时指的就是这条链。

需要。代币必须先存在于 Arbitrum 上,才能在那里被转移;主网上的余额是另一条链上不同的合约记录。可以从以太坊跨链过去,或者更简单地,直接从交易所提现到 Arbitrum 网络。发送方钱包在 Arbitrum 上也需要少量 ETH 用于 gas,因为仅有代币余额无法支付手续费。

比以太坊 L1 上同样的转账便宜得多。具体费用取决于网络负载。手续费以 ETH 支付,已经包含该交易在 L1 数据发布中所占的份额。API 会报告一个合并后的数字。GET /api/v2/arbitrum/gasprice 返回当前价格。

Arbitrum 的出块时间远低于一秒,因此客户发送后传入转账几乎立刻上链,Webhook 紧随其后触发。在入账前要求多少确认数是你的策略决定;Webhook 会在转账到账的那一刻就通知你,无需轮询。

准备好接入 Arbitrum 了吗?

在 app.chaingateway.io/register 创建账户,发送一笔测试网 ERC-20 转账,并接入你的第一个 Webhook。接口参考见 文档,套餐和速率限制在单独的页面上。

审核: Maurice Sobiera 我们如何撰写这些页面