# @beblurt/blurt-rpc-core 中文文档

规范地址：https://npmcn.com/package/%40beblurt/blurt-rpc-core/

版本：0\.1\.0
npm 元数据更新时间：2026-06-22T11:07:44.437Z
中文译文更新时间：2026-11-07T20:07:18.634Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40beblurt/blurt-rpc-core
原文对照：https://npmcn.com/package/%40beblurt/blurt-rpc-core/?lang=original
项目主页：https://gitlab.com/blurt-blockchain/blurt-rpc-core#readme
源码仓库：https://gitlab.com/blurt-blockchain/blurt-rpc-core

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

- 包体积（解压后）：173 kB，81 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-06-22T11:07:43.649Z
- 最新版本发布：2026-06-22T11:07:43.982Z
- 近 30 天下载量：7098（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 1 个）

## 中文简介

通用JSON-RPC 2.0核心用于运输,回转,端点池,钩和可观察性.

## 安装

```sh
npm install @beblurt/blurt-rpc-core
```

也可以使用：`pnpm add @beblurt/blurt-rpc-core`、`yarn add @beblurt/blurt-rpc-core`、`bun add @beblurt/blurt-rpc-core`

## README

# 模糊- rpc- 核心

TypeScript项目通用JSON-RPC 2.0核心.

这个包是有意的域-不可知. 它为下列目的提供了已执行的原始材料:

-   JSON-RPC的请求和答复;
-   (单位:千美元) `RpcClient` 单次通话、原始通话、通知和批发;
-   `fetch`\- 基于 HTTP 的运输,有超时和中止支持;
-   复试和后退;
-   终点池和甄选战略;
-   订出生命周期钩;
-   通用度量衡;
-   可选的明确缓存;
-   结构化公共错误;
-   测试帮助者.

它不执行块链逻辑,健康检查,打分,加密签名,链验证或MCP服务器行为.

## 状态

实施MVP. 核心作为通用JSON-RPC引擎可用,并被针对客户管弦,运输,重试/失败,节点池选择,缓存,钩子,度量衡和结构错误的单元测试所覆盖.

## 安装

```bash
npm install @beblurt/blurt-rpc-core
```

该软件包仅限无害环境管理,目标Node.js QQ 18,并在浏览器运行时运行 提供 `fetch`, (中文(简体) ), `AbortController`, (中文(简体) ), `URL` 财务报告和审定财务报表 `setTimeout`。 。 。 .

## 脚本

```bash
npm run build
npm run typecheck
npm run lint
npm test
npm audit --audit-level=high
```

## 最小使用量

```ts
import { RpcClient } from '@beblurt/blurt-rpc-core'

const rpc = new RpcClient('https://rpc.example.org', { timeoutMs: 4000 })
const result = await rpc.call('namespace.method', { limit: 10 })
```

## 原始回应

```ts
const response = await rpc.call('namespace.method', { limit: 10 }, { responseMode: 'response' })
```

## 多个端点和重试/失败

```ts
import { fixedBackoff, RpcClient } from '@beblurt/blurt-rpc-core'

const rpc = new RpcClient(['https://rpc-a.example.org', 'https://rpc-b.example.org'], {
  retry: { maxAttempts: 3, backoff: fixedBackoff(250) }
})

const value = await rpc.call('namespace.method')
```

## 明确的缓存

缓存绝不是隐含的,核心从不从方法名称中决定可缓存性.

```ts
import { MemoryCacheProvider, RpcClient } from '@beblurt/blurt-rpc-core'

const rpc = new RpcClient('https://rpc.example.org', {
  cache: { provider: new MemoryCacheProvider(), ttlMs: 5000 }
})

await rpc.call('namespace.method', { limit: 10 }, { cache: { ttlMs: 5000 } })
```

## 钩和度量衡

```ts
import { InMemoryMetricsCollector, RpcClient } from '@beblurt/blurt-rpc-core'

const metrics = new InMemoryMetricsCollector()
const rpc = new RpcClient('https://rpc.example.org', {
  metrics,
  hooks: {
    beforeRequest: (request, context) => {
      // Return a replacement request to mutate, or void to continue unchanged.
    },
    afterAttempt: (outcome) => {
      // Observe success/error for each concrete attempt.
    }
  }
})
```

## 文档

以 :

-   `ARCHITECTURE.md`
-   `API.md`
-   `DESIGN_DECISIONS.md`
-   `docs/public-api.md`
-   `docs/release-0.1.0.md`
-   模块参考页 `docs/`

## 非目标

本包中没有块链,打分,签名,健康检查,方法特定行为或MCP服务器代码等属于.

## 常见问题

### @beblurt/blurt-rpc-core 是什么？

通用JSON-RPC 2\.0核心用于运输,回转,端点池,钩和可观察性\.

### 如何安装 @beblurt/blurt-rpc-core？

在项目目录运行 npm install @beblurt/blurt-rpc-core，或使用 pnpm add / yarn add / bun add。

### @beblurt/blurt-rpc-core 支持 TypeScript 吗？

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

### @beblurt/blurt-rpc-core 支持 ESM 还是 CommonJS？

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

### @beblurt/blurt-rpc-core 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @beblurt/blurt-rpc-core 可以商用吗？

@beblurt/blurt-rpc-core 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @beblurt/blurt-rpc-core 的下载量有多少？

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

### @beblurt/blurt-rpc-core 还在维护吗？

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