TypeScript SDK 升級：通過 Upload Relay 賦能更多應用

自?3 月主網上線以來，Walrus 開發者社區持續展現出強勁的發展勢頭：

當前 Walrus 已存儲超?758 TB 數據，為數百個項目提供支持。
在 2025 年 6 月舉辦的?Sui Overflow 黑客松上，Walrus 成為最受歡迎的數據層。該賽事共收到 599 個項目投稿，分為九個賽道，其中可編程存儲賽道的全部 4 個獲獎項目均基于 Walrus 構建，另外八個賽道中也有 5 個獲獎項目使用了 Walrus，包括?OpenGraph?的去中心化 AI 系統、ZeroLeak?的 ZK 技術爆料平臺、SuiSign?的文檔簽署平臺等。
在?ETHGlobal Cannes?黑客松中，Walrus 設立的賞金挑戰共收到超?35 個基于 Walrus 構建的項目投稿，涵蓋 iOS SDK、多鏈 CDN、以太坊橋接、GitHub 備份等多個跨鏈應用場景。

目前，已有多家領先團隊選擇 Walrus 作為其全球數據層基礎設施，包括 Swarm Network：構建用于社交媒體實時事實核查的去中心化 AI 協同系統；TradePort：先進的多鏈 NFT 交易市場；Linera：L1 公鏈項目。

隨著 Walrus 生態逐步成熟，開發者正在構建越來越多元化的動態應用，我們也在不斷優化 Walrus 的開發者體驗。

近期，我們推出了?Quilt，讓上傳小文件變得更直觀、更具性價比。今天，我們發布 Walrus TypeScript SDK 的重大升級，新增兩個核心功能：全新 Walrus Upload Relay，實現更快、更穩定的數據上傳；原生支持 Quilt，讓小文件上傳無縫融入開發流程

此前，開發者可通過 Publisher 或 TypeScript SDK 將數據上傳至 Walrus。盡管 Publisher 提供了便捷高效的 API，但也存在一些限制：

需要在云環境中運行 Publisher
用戶必須信任 Publisher 的行為可信
不支持終端用戶使用錢包直接支付上傳費用

全新升級的?Walrus TypeScript SDK?解決了上述問題，使得客戶端應用的用戶可以直接通過錢包與 Walrus 交互。SDK 可用于兩種場景：構建運行在云端基礎設施的 TypeScript 后端服務或者構建運行在瀏覽器端的前端應用。

今天發布的 TypeScript SDK 升級帶來了以下增強功能：

對使用 SDK 的開發者而言，我們新增了 Walrus Upload Relay 支持。Upload Relay 是一個功能強大但輕量易用的輔助服務，能顯著提升將數據上傳至 Walrus 的速度與穩定性。
新版 Walrus TypeScript SDK 還原生支持 Quilt，為 TypeScript 開發者提供了一套完整工具包，用于在 Walrus 上存儲大小不一的文件。這一支持以全新的?WalrusFile API?實現，將 blob 與 quilt 統一在同一個抽象接口下進行處理。
我們同步發布了 Walrus Upload Relay 示例應用，這是一個開源演示項目，展示了如何在客戶端應用中集成 TypeScript SDK，并通過 Mysten Labs 部署的 Walrus Upload Relay 提升上傳性能與穩定性。

使用 Walrus TypeScript SDK 構建應用

Walrus TypeScript SDK?是構建 Web 或后端應用的官方工具包，專為 TypeScript 語言設計，由 Sui 與 Walrus 背后的團隊?Mysten Labs?開發。現在，開發者可以通過用戶自持錢包來充值和管理他們在 Walrus 上的存儲空間。高級開發者還可結合?Upload Relay、自定義智能合約和 Sui 交易區塊，構建更靈活的上傳支付機制。使用 Upload Relay，所有通過 TypeScript SDK 和 Relay 構建的客戶端應用都能獲得更快速、更可靠的上傳體驗。

了解 Walrus Upload Relay

Walrus Upload Relay?是一個強大的二進制組件，與 Walrus TypeScript SDK 搭配使用，可大幅簡化并加速應用的數據上傳流程。Relay 是為應用設計的高性能專用“通道”，負責將數據編碼并分發至 Walrus 去中心化的存儲節點網絡。相比 Publisher 更加輕量，任何開發者都可以為自己的應用獨立運行一個 Relay，無需依賴第三方運營方。同時，任何有意運營 Relay 的用戶也能輕松部署并使用 SUI 收取服務費用。

Zoom image will be displayed

Walrus Upload Relay 通過處理繁重的數據分發工作，使應用程序能夠更輕松、更快速地將數據上傳到 Walrus。

Walrus Upload Relay 的主要優勢包括：

增強客戶端應用能力：客戶端無需再處理大量 HTTP 請求以將數據寫入存儲節點，使得應用程序更簡單、更高效，并在普通用戶環境下表現更穩健。即使在網絡連接較差的情況下，通過 Relay 上傳依然快速且可靠。
降低基礎設施要求：Upload Relay 是一個輕量級的服務，運行簡單，無需深厚的基礎設施技術。客戶端發送的是未經編碼的數據，進一步減少了上傳體積。
降低信任成本：對于不愿依賴第三方運營者的開發者來說，可以自行運行 Upload Relay，從而降低對外部服務的依賴并簡化后端管理。Relay 并不被信任用于上傳正確性驗證，因為客戶端應用可以識別出是否被篡改或存在惡意行為。
增強網絡韌性與選擇性：Upload Relay 提供了更多連接 Walrus 網絡的方式。開發者可以為自身應用運行私有 Relay，也可以選擇將其對外提供給其他開發者收費使用，或接入其他社區提供的 Relay。
可持續盈利模式：提供 Relay 服務的運營者可以配置其實例，接受以 SUI 進行的側鏈支付。隨著 Walrus 網絡的發展，這為基礎設施提供者和 SDK 開發者提供了新的盈利方式。

優化數據上傳的“最后一公里”

在 Walrus 上存儲數據時，客戶端應用需將數據分片分發到網絡中的多個存儲節點。雖然這種“最后一公里”上傳流程是 Walrus 去中心化架構的核心，但對于客戶端應用來說，這一步可能過于繁重 — — 尤其是在用戶習慣于在高流動性、弱連接的日常場景中使用應用時，上傳流程必須足夠流暢。

為解決這一問題，Walrus 提供了兩種不同的方案：Publisher?和?TypeScript SDK + Upload Relay，它們在效率、信任模型、基礎設施需求等方面各有優劣，如下表所示：

Zoom image will be displayed

總結來看：Publisher?適合不需要錢包集成、可接受高信任依賴的后臺應用場景，具備最高效率，但依賴重型基礎設施；TypeScript SDK + Upload Relay：為希望與用戶錢包直接交互的客戶端應用提供更輕量、彈性強的方案，兼顧上傳可靠性與開發便利性。

提供這兩種上傳機制，確保了構建者可以根據實際需求，靈活選擇最合適的開發工具，在 Walrus 上構建出多樣化、豐富的應用體驗。

在實際中體驗 Walrus Upload Relay 示例

為了展示升級后的?Walrus TypeScript SDK?和?Upload Relay?的強大能力，我們發布了一個開源應用：Walrus Upload Relay 示例，部署在 Walrus 測試網上。

該示例是一個簡單直接的應用，旨在作為開發者實際操作的參考，幫助你在客戶端應用中集成 Walrus TypeScript SDK 和 Walrus Upload Relay。

Walrus Upload Relay 示例前端演示了以下功能：

如何通過用戶錢包，在 Walrus 和 Sui 上支持簡單的數據上傳
如何使用 SDK 與 Upload Relay 協同上傳
如何連接用戶的 Web 錢包，由用戶擁有并管理數據存儲
如何使用 TypeScript SDK 進行 Walrus 的讀寫操作

開發者可以將 Walrus Upload Relay 示例代碼庫作為起點，探索使用 Walrus TypeScript SDK 構建應用的基礎內容。

Mysten Labs 正在為開發者社區在測試網和主網上運行 Walrus Upload Relay 實例。對于不打算自建 Relay 的開發者，或者希望為其應用程序連接 Relay 的方式增加多樣性的開發者，可以集成由 Mysten Labs 運營的 Relay，立即開始進行 blob 上傳操作。你可以通過以下鏈接訪問 Mysten Labs 的測試網和主網?Relay，同時也可以將 Walrus Upload Relay 示例作為集成實現的參考。