Arbitrum SDK

什麼是 Arbitrum SDK？

Arbitrum SDK 是一套開發者工具，可用於打造與 Arbitrum 鏈互動的應用程式，尤其適合需要代幣跨鏈橋接、跨鏈訊息、網路偵測、交易追蹤或存取 Arbitrum 跨鏈橋合約的應用程式。

在加密貨幣領域，這個詞通常指 TypeScript 套件 @arbitrum/sdk，其設計用途是與 Arbitrum 網路進行用戶端互動。

SDK 提供具型別的類別及輔助方法，協助開發者處理常見的 Arbitrum 操作，無須從頭撰寫底層跨鏈橋邏輯。

根據 Arbitrum 官方 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 遷移指南說明，為了更好地支援更廣泛的 Arbitrum 生態系統，許多舊有的 L1 與 L2 說法已改為母鏈與子鏈用語。

Arbitrum SDK 為何重要

Arbitrum SDK 之所以重要，是因為若沒有可靠工具，要安全地打造跨鏈加密貨幣應用程式並不容易。

對使用者而言，簡單的代幣跨鏈橋接看起來可能只是一筆轉帳，但底層流程可能涉及核准、閘道、Inbox 合約、可重試票券、狀態檢查、挑戰期及 Outbox 執行。

SDK 將其中許多步驟整合至可重複使用的類別及方法中，以降低這些複雜性。

對於需要在不同鏈之間轉移資產或訊息的錢包、去中心化應用程式、跨鏈橋、儀表板、遊戲 App、支付工具、交易介面及鏈上金融產品而言，這點非常重要。

如果沒有 SDK，開發者就必須直接與跨鏈橋合約互動，並手動處理許多例外情況。

使用 SDK 後，開發者可以更專注於使用者體驗、交易安全、餘額顯示及應用程式邏輯。

Arbitrum SDK 的核心功能

資產跨鏈橋接

Arbitrum SDK 最重要的用途之一，是在母鏈與 Arbitrum 子鏈之間進行資產跨鏈橋接。

SDK 包含 EthBridger 與 Erc20Bridger 等 Bridger 類別，可用於轉移原生資產與 ERC-20 代幣。

Arbitrum 官方跨鏈橋概覽說明，代幣跨鏈橋接及跨鏈訊息是建置 Arbitrum 應用程式的重要基礎。

使用者將 ETH 或其他原生代幣存入 Arbitrum 鏈時，SDK 可協助準備並提交所需交易。

使用者存入 ERC-20 代幣時，SDK 可協助核准閘道、發起存入操作，並等待交易在子鏈上處理。

官方 Arbitrum 代幣存入指南示範如何使用 Erc20Bridger 核准閘道並存入 ERC-20 代幣。

跨鏈訊息

Arbitrum SDK 也支援跨鏈訊息，讓合約或應用程式可以在母鏈與子鏈之間傳送資料或指令。

跨鏈訊息很重要，因為許多加密貨幣應用程式需要的不只是代幣轉帳。

治理系統可能需要傳送執行指令，支付 App 可能需要觸發結算邏輯，而遊戲可能需要在不同鏈之間同步狀態。

Arbitrum 官方跨鏈訊息指南將 @arbitrum/sdk 描述為 TypeScript 函式庫，可用於在母鏈與 Arbitrum 子鏈之間跨鏈轉移代幣及傳送訊息。

SDK 提供具型別的介面，讓這些訊息流程更容易建置、測試與監控。

交易狀態追蹤

Arbitrum SDK 可協助開發者追蹤跨鏈交易目前是待處理、已完成、失敗，或已進入下一步的準備狀態。

這項功能特別實用，因為跨鏈活動通常包含不只一個交易生命週期。

從母鏈存入子鏈，可能需要先在母鏈進行交易，接著再於子鏈執行。

從子鏈提領至母鏈，可能需要先在子鏈發起操作，再等待挑戰期，最後於母鏈執行。

SDK 提供工具，讓開發者能從交易收據取得訊息並檢查狀態。

這讓應用程式可以向使用者顯示準確進度，避免使用者在提交第一筆交易後不清楚流程是否完成。

網路設定

Arbitrum SDK 可協助識別 Arbitrum 網路，並取得目標子鏈的正確設定。

這點很重要，因為不同 Arbitrum 鏈可能使用不同的 chain ID、跨鏈橋地址、代幣閘道地址、原生代幣及結算關係。

正確的網路設定可降低交易被傳送至錯誤跨鏈橋合約的風險。

這也有助於應用程式支援多條 Arbitrum 鏈，而不必手動將每個地址寫死在程式中。

重要的 Arbitrum SDK 類別

EthBridger

當應用程式需要跨鏈轉移 ETH 或支援的 Arbitrum 鏈原生代幣時，會使用 EthBridger。

開發者可以使用它將資產從母鏈存入子鏈，或發起從子鏈提領回母鏈的操作。

官方 ETH 存入與訊息指南示範 EthBridger 如何簡化存入 Arbitrum 子鏈的流程。

對錢包、支付 App 及任何需要支援 Arbitrum 原生資產轉移的加密貨幣介面而言，這個類別都很實用。

Erc20Bridger

Erc20Bridger 用於 ERC-20 代幣存入與提領。

它可協助處理核准流程、閘道互動、存入交易、提領發起及訊息追蹤。

ERC-20 跨鏈橋接比原生資產跨鏈橋接更複雜，因為代幣可能需要透過標準閘道、自訂閘道或其他代幣跨鏈橋接邏輯。

SDK 提供一致介面，讓開發者更容易處理許多常見的代幣跨鏈橋接工作。

ParentToChildMessage

ParentToChildMessage 代表從母鏈傳送至 Arbitrum 子鏈的訊息。

當應用程式需要監控存入操作或可重試票券是否已在子鏈執行時，這個類別便很有用。

母鏈至子鏈的訊息常用於存入、合約呼叫及跨鏈指令。

這類訊息與可重試票券密切相關；可重試票券是 Arbitrum 中確保訊息可靠執行的核心機制。

ChildToParentMessage

ChildToParentMessage 代表從 Arbitrum 子鏈傳回母鏈的訊息。

這個類別對提領操作相當重要，因為子鏈至母鏈的訊息必須等待一段時間，才能在母鏈執行。

官方 Arbitrum 代幣提領指南說明，由於挑戰期的關係，提領約需 6.4 天才能完成。

應用程式可以使用 SDK 訊息工具，顯示提領目前仍在等待、已可執行，或已完成。

可重試票券與 Arbitrum SDK

可重試票券是 Arbitrum 母鏈至子鏈訊息傳遞的重要機制。

可重試票券是一種機制，可讓母鏈交易建立子鏈執行請求。

官方 Arbitrum 可重試票券文件說明，可重試票券會將母鏈上的提交與子鏈上的執行分開處理。

這項設計很實用，因為跨鏈執行可能取決於 Gas 限制、提交成本、費用出價、calldata 大小及子鏈基本費用。

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 連接至所用母鏈與子鏈的 provider、signer 及網路設定。

接著，應用程式會使用 EthBridger、Erc20Bridger、ParentToChildMessage 及 ChildToParentMessage 等 SDK 類別，建置所需流程。

由於 SDK 會與實際的區塊鏈交易互動，開發者應先在支援的測試網路上測試整合，再使用真實資金。

Arbitrum SDK 的應用範例

錢包資產轉移

加密貨幣錢包可以使用 Arbitrum SDK，讓使用者將資產轉入或轉出 Arbitrum 鏈。

錢包可使用 SDK 狀態工具，顯示存入操作何時到達子鏈，或提領何時可在母鏈執行。

這能改善使用者體驗，因為跨鏈交易不然可能讓人覺得狀態不明或尚未完成。

去中心化應用程式

去中心化應用程式可以使用 Arbitrum SDK，讓使用者直接從母鏈為 Arbitrum 鏈上的帳戶提供資金。

這對希望改善使用者引導流程的 DeFi、支付、遊戲、NFT 及實體資產應用程式都很有幫助。

App 可以將跨鏈橋接、狀態追蹤及智能合約呼叫整合至單一的引導流程中。

代幣發行方

代幣發行方可以運用 SDK 工具及 Arbitrum 跨鏈橋文件，支援代幣在母鏈與子鏈之間轉移。

這有助於讓代幣更容易在 Arbitrum 應用程式中使用。

代幣發行方仍應仔細查看閘道要求，因為自訂代幣行為可能需要自訂跨鏈橋設定。

鏈營運者

啟動自訂 Arbitrum 鏈的團隊可以使用 Arbitrum Chain SDK 準備部署參數、設定 Rollup 參數並產生節點設定。

鏈上線後，團隊也可以在應用程式層使用 @arbitrum/sdk。

這種搭配可讓團隊同時管理基礎架構設定及面向使用者的應用程式流程。

Arbitrum SDK 的優點

• • 簡化母鏈與子鏈之間的代幣存入與提領流程。
  • 提供具型別的跨鏈橋及訊息傳遞智能合約存取介面。
  • 減少手動處理跨鏈交易收據的工作。
  • 協助開發者估算並追蹤可重試票券的執行狀態。
  • SDK v4 支援更具彈性的母鏈與子鏈關係。
  • 協助應用程式顯示準確的交易進度，改善使用者體驗。

風險與開發者須知

Arbitrum SDK 能讓開發更容易，但不能免除仔細進行安全審查的必要。

開發者仍須保護私鑰、驗證代幣地址、確認網路設定，並測試所有跨鏈橋流程。

錯誤的 chain 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 生態系統的主要工具之一。