# @blend-money/node 中文文档

规范地址：https://npmcn.com/package/%40blend-money/node/

版本：3\.1\.1
npm 元数据更新时间：2026-11-02T17:27:57.862Z
中文译文更新时间：2026-11-08T06:40:29.512Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40blend-money/node
原文对照：https://npmcn.com/package/%40blend-money/node/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：17.6 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：^22\.23\.4 \|\| ^24\.22\.1 \|\| ^26\.12\.1
- 运行依赖：2 个
- 首次发布：2026-05-07T14:31:35.566Z
- 最新版本发布：2026-11-02T17:27:57.673Z
- 近 30 天下载量：18971（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

[![npm version](https://img.shields.io/npm/v/@blend-money/node.svg)](https://www.npmjs.com/package/@blend-money/node) [![npm downloads per week](https://img.shields.io/npm/dw/@blend-money/node.svg)](https://www.npmjs.com/package/@blend-money/node) \[不

## 安装

```sh
npm install @blend-money/node
```

也可以使用：`pnpm add @blend-money/node`、`yarn add @blend-money/node`、`bun add @blend-money/node`

## README

# @blend-money/节点

[![npm version](https://img.shields.io/npm/v/@blend-money/node.svg)](https://www.npmjs.com/package/@blend-money/node) [![npm downloads per week](https://img.shields.io/npm/dw/@blend-money/node.svg)](https://www.npmjs.com/package/@blend-money/node) [![npm downloads per month](https://img.shields.io/npm/dm/@blend-money/node.svg)](https://www.npmjs.com/package/@blend-money/node)

用于Blend协议的服务器侧 SDK. API 密钥被认证为服务器对服务器集成.

## 安装

```bash
pnpm add @blend-money/node
```

## 快速启动

```typescript
import { BlendServerSdk } from "@blend-money/node";

const sdk = new BlendServerSdk({
  apiKey: "sk_live_...",
  accountTypeId: "your-account-type",
});

// 1. Discover what's available
const chains = await sdk.discover.depositChains();
const tokens = await sdk.discover.depositTokens(8453);

// 2. Look up an account by EOA address
const account = await sdk.lookupAccount("0x...");
// { accountId, safeAddress, chainsDeployed }

// 3. Or create one if it doesn't exist
const newAccount = await sdk.createAccount("0x...", 8453);

// 4. Get a scoped client for the account
const client = sdk.forAccount(account.accountId);

// 5. Use account data and session lifecycle
const balance = await client.account.balance();
const sessions = await client.sessions.list();
```

## 配置

```typescript
const sdk = new BlendServerSdk({
  // Required
  apiKey: "sk_live_...", // Server-side API key (X-API-Key header)
  accountTypeId: "your-account-type", // Product identifier for URL routing

  // Optional
  baseUrl: "https://...", // API base URL override
  fiatCurrency: "EUR", // ISO 4217 code for multi-currency
  timeoutMs: 15000, // Request timeout (default: 15000)
  retries: 3, // Max retries for 429/5xx (default: 3)
});
```

## API 参考

### 发现

无需界定账户范围.

```typescript
const chains = await sdk.discover.depositChains();
// [{ chainId, name, displayName, iconUrl }]

const tokens = await sdk.discover.depositTokens(8453);
// [{ chainId, address, symbol, name, decimals, logoURI, price }]

const destinations = await sdk.discover.withdrawDestinations();
// [{ chainId, name, loanTokenAddress }]

const yieldData = await sdk.discover.yield();
// { accountTypeId, yieldBreakdown: [{ chainId, vaultAddress, breakdown, summary }] }
```

### 账户查询

```typescript
const account = await sdk.lookupAccount("0x...");
// { accountId, safeAddress, chainsDeployed }
```

### 账户创建

```typescript
const account = await sdk.createAccount("0x...", 8453);
// { accountId, safeAddress, chainsDeployed }
```

### 范围客户端

`forAccount()` 返回完整 `BlendClient` 范围为特定账户,可获取发现、账户数据和会话周期.

```typescript
const client = sdk.forAccount(account.accountId);

// Account data
const balance = await client.account.balance();
const positions = await client.account.positions();
const returns = await client.account.returns();

// Safe management
const resolution = await client.account.safe.resolve(8453);
await client.account.safe.request(8453);

// Session lifecycle
const session = await client.sessions.createSession({ forceReset: true });
const quoted = await client.sessions.quoteDeposit(session.intentId, { ... });
const locked = await client.sessions.lock(session.intentId, { signerAddress: "0x..." });
const submitted = await client.sessions.submit(session.intentId, { txHashes: [...] });
const result = await client.sessions.execute(session.intentId, { ... });
const sessions = await client.sessions.list();
await client.sessions.cancel(session.intentId);
```

见 [`@blend-money/fe` 读取](https://npmcn.com/package/%40blend-money/frontend/README.md) 用于账户数据、会话周期、金额助手和错误处理的完整文档——范围化客户API是相同的.

### 数额

从 `@blend-money/core`数字 :

```typescript
import { parseAmount, formatAmount } from "@blend-money/node";

const smallest = parseAmount("100.50", 6); // "100500000"
const human = formatAmount("100500000", 6); // "100.5"
```

## 处理错误

所有错误类型都从 `@blend-money/core`数字 :

```typescript
import { SdkError, SESSION_ERROR_CODES } from "@blend-money/node";

try {
  await client.account.balance();
} catch (err) {
  if (err instanceof SdkError) {
    console.log(err.code); // e.g. "INTENT_NOT_FOUND"
    console.log(err.status); // HTTP status
    console.log(err.getUserMessage()); // human-readable message
    console.log(err.isRetryable()); // true for 429, 5xx, network errors
  }
}
```

## 发展

从单列波根:

```bash
pnpm install                                # Install all dependencies
pnpm --filter @blend-money/node build       # Build this package
pnpm --filter @blend-money/node dev         # Watch mode
pnpm --filter @blend-money/node test        # Run tests (interactive)
pnpm --filter @blend-money/node test:run    # Run tests (CI)
pnpm --filter @blend-money/node check-types # Type check
```

或运行 `pnpm build`, (中文(简体) ), `pnpm test:run`等从单列波根运行到所有软件包.

## 许可证

麻省理工学院

## 常见问题

### @blend-money/node 是什么？

\[不

### 如何安装 @blend-money/node？

在项目目录运行 npm install @blend-money/node，或使用 pnpm add / yarn add / bun add。

### @blend-money/node 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @blend-money/node 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @blend-money/node 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js ^22\.23\.4 \|\| ^24\.22\.1 \|\| ^26\.12\.1。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @blend-money/node 可以商用吗？

@blend-money/node 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @blend-money/node 的下载量有多少？

根据 npm 官方下载统计，@blend-money/node 在 2026/10/09 – 2026/11/07 这 30 天内被下载 18,971 次，日均约 632 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @blend-money/node 还在维护吗？

最新版本 3\.1\.1 发布于 2026/11/03（5 天前）；至今共发布 15 个版本，其中过去 12 个月发布了 15 个；首次发布于 2026/05/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。