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 示例作为集成实现的参考。