Nostr社区党支部书记 on Nostr: ### Blossom Uploader 笔记 #### 概览 - **Blossom** ...
### Blossom Uploader 笔记
#### 概览
- **Blossom** 是一种新的协议,旨在通过 Nostr 的简洁性挑战 IPFS。
- 文件通过 SHA-256 哈希值被识别,并上传到多个服务器。如果一个服务器离线,客户端可能能够在其他服务器上找到文件。
#### 使用方法
- **BlossomUploader** 可用于一次性上传文件到多个 Blossom 服务器。
#### 示例代码(TypeScript)
```typescript
import { BlossomUploader } from '@nostrify/nostrify/uploaders';
const uploader = new BlossomUploader({
servers: ['https://blossom.primal.net/'; /*, https://cdn.satellite.earth */],
signer: window.nostr,
});
const tags = await uploader.upload(file);
```
#### 选项
- **servers**: Blossom 服务器的 URL 数组。
- **signer**: Nostr 签名实例,用于签署上传请求。
- **fetch** (可选): 自定义 fetch 实现。
- **expiresIn** (可选): 每个上传请求应过期的毫秒数,默认为 60,000。
#### 结果
- 结果以 NIP-94 标签的数组形式返回 (`tags array`)。
- 第一个标签保证是 URL。
#### 标签示例
- **URL**: 文件的公共 URL。
- **x**: 文件的 SHA-256 十六进制编码字符串。
- **ox**: 上传服务器进行任何转换之前的原始文件的 SHA-256 十六进制编码字符串。
- **size**: 文件大小,单位为字节。
- **m**: 表示文件数据类型的字符串。必须使用小写的 MIME 类型格式。
#### 服务器和 MIME 类型
- 服务器示例: `https://blossom.primal.net/`
- MIME 类型示例: `image/png`
#### 补充说明
- Blossom 协议通过在多个服务器上存储文件的副本来提高文件的可用性和持久性。
- 使用 Nostr 签名可以增加上传过程的安全性和可验证性。
- 通过自定义 `fetch` 实现,可以适应不同的网络环境或特定的技术需求。
- `expiresIn` 选项允许设置请求的过期时间,以避免无限期的上传尝试。
以上是根据提供的网页内容整理的详尽笔记,涵盖了 Blossom Uploader 的主要功能、使用方法、配置选项以及结果返回格式。
#### 概览
- **Blossom** 是一种新的协议,旨在通过 Nostr 的简洁性挑战 IPFS。
- 文件通过 SHA-256 哈希值被识别,并上传到多个服务器。如果一个服务器离线,客户端可能能够在其他服务器上找到文件。
#### 使用方法
- **BlossomUploader** 可用于一次性上传文件到多个 Blossom 服务器。
#### 示例代码(TypeScript)
```typescript
import { BlossomUploader } from '@nostrify/nostrify/uploaders';
const uploader = new BlossomUploader({
servers: ['https://blossom.primal.net/'; /*, https://cdn.satellite.earth */],
signer: window.nostr,
});
const tags = await uploader.upload(file);
```
#### 选项
- **servers**: Blossom 服务器的 URL 数组。
- **signer**: Nostr 签名实例,用于签署上传请求。
- **fetch** (可选): 自定义 fetch 实现。
- **expiresIn** (可选): 每个上传请求应过期的毫秒数,默认为 60,000。
#### 结果
- 结果以 NIP-94 标签的数组形式返回 (`tags array`)。
- 第一个标签保证是 URL。
#### 标签示例
- **URL**: 文件的公共 URL。
- **x**: 文件的 SHA-256 十六进制编码字符串。
- **ox**: 上传服务器进行任何转换之前的原始文件的 SHA-256 十六进制编码字符串。
- **size**: 文件大小,单位为字节。
- **m**: 表示文件数据类型的字符串。必须使用小写的 MIME 类型格式。
#### 服务器和 MIME 类型
- 服务器示例: `https://blossom.primal.net/`
- MIME 类型示例: `image/png`
#### 补充说明
- Blossom 协议通过在多个服务器上存储文件的副本来提高文件的可用性和持久性。
- 使用 Nostr 签名可以增加上传过程的安全性和可验证性。
- 通过自定义 `fetch` 实现,可以适应不同的网络环境或特定的技术需求。
- `expiresIn` 选项允许设置请求的过期时间,以避免无限期的上传尝试。
以上是根据提供的网页内容整理的详尽笔记,涵盖了 Blossom Uploader 的主要功能、使用方法、配置选项以及结果返回格式。