# @consensys/native-ramps-sdk 中文文档

规范地址：https://npmcn.com/package/%40consensys/native-ramps-sdk/

版本：2\.1\.7
npm 元数据更新时间：2026-10-19T16:57:26.393Z
中文译文更新时间：2026-11-10T15:55:39.874Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40consensys/native-ramps-sdk
原文对照：https://npmcn.com/package/%40consensys/native-ramps-sdk/?lang=original

弃用说明：This package is deprecated\. Use @metamask/money-mvmt-sdk instead\.

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

- 包体积（解压后）：166 kB，19 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：7 个
- 首次发布：2025-05-20T14:28:18.769Z
- 最新版本发布：2025-12-18T02:45:56.768Z
- 近 30 天下载量：4046（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：31（近 12 个月 1 个）

## 中文简介

## 开始

## 安装

```sh
npm install @consensys/native-ramps-sdk
```

也可以使用：`pnpm add @consensys/native-ramps-sdk`、`yarn add @consensys/native-ramps-sdk`、`bun add @consensys/native-ramps-sdk`

## README

# 原生鼠标 SDK

## 开始

### 安装

```bash
yarn add @consensys/native-ramps-sdk
```

或者说

```bash
npm install @consensys/native-ramps-sdk
```

### 使用量

```typescript
import { NativeRampsSdk } from '@consensys/native-ramps-sdk'

// Initialize the SDK
const nativeRampsSdk = new NativeRampsSdk()

// Use the SDK methods
```

## 版本管理

要更新 SDK 版本 :

1.  更新版本编号 `package.json`数字 :
    
    ```json
    {
      "version": "1.0.1"
    }
    ```
    
2.  安装要同步版本的依赖性 :
    
    ```bash
    npm install
    ```
    

SDK 自动使用来自 `package.json` 用于所有版本相关功能.

## 地方发展

为当地开发和测试SDK:

### 建造SDK

1.  安装依赖性 :
    
    ```bash
    npm install
    ```
    
2.  构建 SDK :
    
    ```bash
    npm run build
    ```
    
    这将:
    
    -   将类型文件编译为 JavaScript
    -   生成类型声明( E)`.d.ts` 文档)
    -   将全部输出到 `dist/` 目录

### 测试另一个工程的本地变化

在不发布的情况下测试您在其它工程中的本地变化 :

1.  构建 SDK( 如上所示)
    
2.  复制整个 `dist/` 您的目标项目文件夹 `node_modules/@consensys/native-ramps-sdk/` 目录 :
    
    ```bash
    # From your target project directory
    cp -r /path/to/native-ramps-sdk/dist/* ./node_modules/@consensys/native-ramps-sdk/dist/
    ```
    
3.  或者,您可以使用 npm 链接进行更无缝的开发体验 :
    
    ```bash
    # In the SDK directory
    npm link
    
    # In your target project directory
    npm link @consensys/native-ramps-sdk
    ```
    

### 发展 工作流量

1.  在 `src/`
2.  运行 `npm run build` 编辑您的修改
3.  复制更新 `dist/` 用于测试项目或使用 npm 链接的文件
4.  测试您在目标工程中的变化
5.  视需要重复

### 其他有用的命令

-   `npm run test` - 运行测试
-   `npm run lint` - 检查代码样式
-   `npm run prettier` - 格式代码
-   `npm run test:watch` - 在监视模式下进行测试

## 常见问题

### @consensys/native-ramps-sdk 是什么？

开始注意：该包已被作者标记为弃用——This package is deprecated\. Use @metamask/money-mvmt-sdk instead\.

### 如何安装 @consensys/native-ramps-sdk？

在项目目录运行 npm install @consensys/native-ramps-sdk，或使用 pnpm add / yarn add / bun add。

### @consensys/native-ramps-sdk 支持 TypeScript 吗？

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

### @consensys/native-ramps-sdk 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @consensys/native-ramps-sdk 可以商用吗？

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

### @consensys/native-ramps-sdk 的下载量有多少？

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

### @consensys/native-ramps-sdk 还在维护吗？

最新版本 2\.1\.7 发布于 2025/12/18（10 个月前）；至今共发布 31 个版本，其中过去 12 个月发布了 1 个；首次发布于 2025/05/20。作者已将其标记为弃用，新项目建议寻找替代方案。