# @blockhash/mancer-sdk 中文文档

规范地址：https://npmcn.com/package/%40blockhash/mancer-sdk/

版本：0\.1\.0
npm 元数据更新时间：2026-10-31T15:27:23.914Z
中文译文更新时间：2026-10-31T16:41:42.922Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40blockhash/mancer-sdk
原文对照：https://npmcn.com/package/%40blockhash/mancer-sdk/?lang=original
项目主页：https://docs.mancer.xyz/agents/sdk
源码仓库：https://github.com/blockhash-xyz/mancer-sdk

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

- 包体积（解压后）：826 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2026-10-30T22:00:45.326Z
- 最新版本发布：2026-10-30T22:02:21.832Z
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

Mancer的带有钱包的机器人API：登录，交换，订单，发送，书籍和帐户事件，在签名之前检查每个构建

## 安装

```sh
npm install @blockhash/mancer-sdk
```

也可以使用：`pnpm add @blockhash/mancer-sdk`、`yarn add @blockhash/mancer-sdk`、`bun add @blockhash/mancer-sdk`

## README

# @blockhash / mancer-sdk

Mancer的带有钱包的bot的API，在TypeScript中 [本人](https://viem.sh/). Mancer是罗宾汉链的索引聚合器和订单层。 SDK使用bot自己的帐户登录，交换，放置和取消订单，发送，对Books进行操作并听到帐户的事件。 它要求Mancer为每个动作准备好签名的步骤，并在您的帐户签名之前检查您要求的每个步骤。 您的帐户在您的机器上或在您提交的钱包客户端上签名。 SDK从不记录、发送或存储私钥。

## 安装

```bash
npm install @blockhash/mancer-sdk viem
```

它需要Node 22或更新版本，并且可以在浏览器中运行。

## 一个交换

```ts
import { privateKeyToAccount } from 'viem/accounts'
import { ETH, Mancer } from '@blockhash/mancer-sdk'

const USDG = '0x5fc5360d0400a0fd4f2af552add042d716f1d168'
const mancer = new Mancer({ account: privateKeyToAccount(process.env.BOT_PRIVATE_KEY as `0x${string}`) })

const swap = await mancer.swap({
  tokenIn: ETH,
  tokenOut: USDG,
  amountIn: 1_000_000_000_000_000n,
  // the floor: what the deepest Uniswap pool of WETH and USDG pays on your node, less 1%
  reference: mancer.poolReference(),
  maxSlippageBps: 100,
})
console.log(`received ${swap.executed?.amountOut} USDG units`)
```

`swap()` 在它需要的地方签到，用你的钱包作为接收者构建交换，检查它，发送它的批准，然后交换。 `buildSwap()` 做同样的事，却什么也不送。

## 地板是你的

底线是交换所能提供的最低限度，而链条则控制着它。 在场内，一个错误的或不友好的报价仍然可以通过支付场内的池来路由掉期。 所以每次交换都有一个规则，或者在问任何问题之前就被拒绝了：

| 名字 | 地板上 |
| --- | --- |
| `minOut` | 您自己的数字，输出的原始单位。 |
| `reference` 与 `maxSlippageBps` | 你的函数的顺序的答案是less `maxSlippageBps`. |
| `trustQuote: true` | 曼瑟的原话，更少 `slippageBps`． 错误的报价就是错误的楼层。 |

`poolReference()` 在您自己的RPC上从Uniswap的QuoterV2中对美元进行价格。 对于任何其他对，传递您自己的函数。

## 检查什么

SDK在签名前检查每一步：链、钱包、批准、路由器调用的令牌、金额、收件人、最低限额、截止日期和费用，以及与Mancer自己路由的合同相对应的每一步。 检查失败将抛出一个 `MancerCheckError` 命名第一个不是您要求的字段，并且在它之后没有任何签名或发送。

## 文档

完整的指南在 [docs.mancer.xyz /代理/ sdk](https://docs.mancer.xyz/agents/sdk)订单、发送、书籍、事件、错误、键和API的每个路由。

## 来源

来源是 [github.com/blockhash-xyz/mancer-sdk](https://github.com/blockhash-xyz/mancer-sdk)，带有MCP服务器和一个 [例子机器人](https://github.com/blockhash-xyz/mancer-sdk/tree/main/examples/trading-bot).

## 许可证

麻省理工学院©Blockhash。

## 常见问题

### @blockhash/mancer-sdk 是什么？

Mancer的带有钱包的机器人API：登录，交换，订单，发送，书籍和帐户事件，在签名之前检查每个构建

### 如何安装 @blockhash/mancer-sdk？

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

### @blockhash/mancer-sdk 支持 TypeScript 吗？

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

### @blockhash/mancer-sdk 支持 ESM 还是 CommonJS？

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

### @blockhash/mancer-sdk 需要什么版本的 Node\.js？

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

### @blockhash/mancer-sdk 可以商用吗？

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

### @blockhash/mancer-sdk 还在维护吗？

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