# @getpara/rest-sdk 中文文档

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

版本：3\.28\.0
npm 元数据更新时间：2026-11-13T02:33:46.510Z
中文译文更新时间：2026-11-16T06:35:58.948Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40getpara/rest-sdk
原文对照：https://npmcn.com/package/%40getpara/rest-sdk/?lang=original
项目主页：https://docs.getpara.com/v3/rest/sdk

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

- 包体积（解压后）：182 kB，28 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：1 个
- peer 依赖：viem ^2\.10\.0，ethers ^6\.13\.4，@solana/keys ^2\.2\.1，@solana/signers ^2\.2\.1，@solana/addresses ^2\.2\.1，@solana/transactions ^2\.2\.1
- 首次发布：2026-05-21T20:30:41.464Z
- 最新版本发布：2026-11-13T02:33:46.102Z
- 近 30 天下载量：28166（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：32（近 12 个月 32 个）

## 中文简介

Para REST 钱包管理和签名的服务器侧 SDK

## 安装

```sh
npm install @getpara/rest-sdk
```

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

## README

# @ getpara/ rest- sdk

Para 服务器对服务器钱包操作的 REST 客户端 .

当您的后端拥有工作流程并用 Para REST API 键签名时使用此软件包 。 不要把它送到浏览器, 反应应用程序,移动应用程序,钱包,或任何其他用户控制的运行时间. 它发出 `X-API-Key` 每一个请求.

使用 `@getpara/rest-sdk` 用于 API- key 备份预源或程序钱包。 使用 `@getpara/server-sdk` 需要的时候 Para的共享后置服务器SDK流量,导入用户会话,或核心SDK行为. 使用 Web, React, React 本地语, 斯威夫特(Swift),或称"Flusters SDK",用于用户的造型认证和钱包UX.

核心客户端覆盖了 Para 的公共 REST 钱包表面:

-   钱包创建、上市、查询和标识符更新
-   SDK 预源共享迁移和飞地公钥搜索
-   余额、签署、转让、费用估计、水龙头请求和REST交易历史
-   REST特定标题和行为: `X-API-Key`, (中文(简体) ), `X-Request-Id`调用 `Idempotency-Key`, (中文(简体) ), `AbortSignal`, (中文(简体) ), 环境选择、 获取注入、 JSON 序列化错误、 验证错误和 HTTP 错误映射

适配器子路径通过eders v6,viem v2和Solana v2的签名器接口来曝光签名子集.

## 安装

```bash
yarn add @getpara/rest-sdk
```

只为您使用的适配器安装端点依赖性 :

```bash
yarn add ethers
yarn add viem
yarn add @solana/addresses @solana/keys @solana/signers @solana/transactions
```

核心客户端期望 Node.js 18+ 或注入 `fetch`。 。 。 .

## 客户端

```ts
import { ParaRestClient, ParaRestError } from '@getpara/rest-sdk';

const para = new ParaRestClient({
  apiKey: process.env.PARA_API_KEY!,
  env: 'BETA',
});

const wallet = await para.createWallet({
  type: 'EVM',
  userIdentifier: 'user@test.getpara.com',
  userIdentifierType: 'EMAIL',
});

const signature = await para.signMessage(wallet.id, { message: 'hello' });
```

`env` 接受 `PROD`, (中文(简体) ), `BETA`, (中文(简体) ), `SANDBOX`,或 `{ baseUrl }`。通过 `fetch` 输入您的运行时间获取执行, 通过 `requestIdGenerator` 如果你想控制的话 `X-Request-Id` 值,并通过 `AbortSignal` 在呼叫选项中 取消飞行请求.

`ParaRestError` 用于非-2xx HTTP 响应并包含 `status`, (中文(简体) ), `code`, (中文(简体) ), `requestId`,并解析后的反应 躯体. `ParaRestValidationError` 之前抛出 `fetch` 的本地值. `ParaRestSerializationError` 之前抛出 `fetch` 当请求体不能被JSON序列化时.

```ts
try {
  await para.getWallet(wallet.id, { signal: AbortSignal.timeout(10_000) });
} catch (error) {
  if (error instanceof ParaRestError) {
    console.error(error.status, error.code, error.requestId, error.body);
  }
}
```

## 签名行为

EVM消息和打入的数据签名向REST发送未覆盖的有效载荷. EIP-191和EIP-712有效载荷 签字前 乙醚适配器遵循乙醚本身的打入数据行为并省略任何调用器提供 `EIP712Domain` 条目从 `types` 在转发到 REST 之前.

适配器跟随相机 `signMessage` 拆分: 将字符串消息传输到 REST `sign-message`时 类似字节的信息被本地散列并传送到 REST `sign-raw`。通过 `{ raw: bytes }` 当 a `0x...` 字符串 应当作为字节而不是文本对待.

EVM交易签名返回REST API签名的交易回复. SDK将呼叫者的交易正常化 在发送前请求,但不重新确定所签有效载荷的本地位置或每个返回的场对 请求。 REST EVM交易签名支持普通遗产,EIP-1559只发送;合同部署,访问 列表、blob交易和授权清单交易在呼叫 REST 之前被拒绝。 viem 适配器接受 输出等于标准Eetheum序列化的链式串联器,例如Base和其他OP Stack链, 或用于标准Celo和ZKsync交易。 特定交易,例如OP Stack存款、Celo `feeCurrency` 交易,以及ZKsync EIP-712交易,在拨打REST之前被拒绝.

索拉纳适配器通过签名消息字节执行索拉纳 v2 签名特性 `sign-raw`返回时返回 签名词典并可以将签名合并到Solana v2 信件和交易对象. 使用 `para.signTransaction(..., { broadcast: true })` 或者说 `para.transfer(...)` 当您的后端想要 REST 提交 交易和返回 a `transactionId`。 。 。 .

`Idempotency-Key` 每一个请求都提供呼叫器:

```ts
await para.createWallet(
  {
    type: 'EVM',
    userIdentifier: 'user@test.getpara.com',
    userIdentifierType: 'EMAIL',
  },
  { idempotencyKey: crypto.randomUUID() },
);
```

当重试可以产生重复状态或提交重复的签名/广播工作时,使用一能键. SDK这个 不为您生成一个,因为它不会在内部重试请求.

## EVM 收费紧急

设定 `urgency: 'normal' | 'urgent'` 自筹资金的EVM `transfer`, (中文(简体) ), `transferWithAutoRetry`, (中文(简体) ), `speedUpRestTransaction`, (中文(简体) ), `cancelRestTransaction`, (中文(简体) ), `createYieldDeposit`,或 `createYieldWithdrawal` 请求. 漏出意为常. Para 选择新建议的价格; SDK 不计算费用而转发选择 .

```ts
await para.transfer(wallet.id, {
  to: '0x1111111111111111111111111111111111111111',
  value: '1000000000000',
  chainId: '11155111',
  urgency: 'urgent',
}, { idempotencyKey: 'saved-payment-key' });
```

明确初始价格,包括零,保持固定. 紧迫变化产生价格,而不是气体单位;不一致 收费对价被拒绝。 紧急情况不能保证确认时间。 赞助转移、非执行核查和监测机制,以及 调用器 `signTransaction`编号 :`signTransactionWithAutoRetry` 拒绝紧急请求。 EVM 估计回报率 两种选项,不使用选择器. `estimateFee()` 显示类型 `feeOptions.normal` 财务报告和审定财务报表 `feeOptions.urgent`, (中文(简体) ), 他们的付费家庭, 执行预算, 引用时间戳和块号。 没有这些可选字段 关于非EVM或更早反应.

持久恢复和收益在工人重新开始工作以及批准/行动阶段都保留着选择权。 公开和明确 (b) 在同一关键冲突下不断变化的紧迫性。 重玩保留准备和 签名字节。 收费上限和期限保持不变;紧急事项绝不扩大支出授权.

## 交易历史

当REST广播交易时, `signTransaction(..., { broadcast: true })` 财务报告和审定财务报表 `transfer(...)` 返回 a `transactionId`以自己的订单、付款或工作记录存储ID,以便日后核对广播内容.

```ts
const result = await para.signTransaction(wallet.id, {
  transaction,
  broadcast: true,
});

if (result.transactionId) {
  const record = await para.getRestTransaction(wallet.id, result.transactionId);
  console.log(record.status, record.hash);
}

const recent = await para.listRestTransactions(wallet.id, {
  status: 'confirmed',
  limit: 10,
});
```

Webhooks是播出后接收同步状态变化的首选方式. 研究SDK历史 方法作为读取模式:在广播后立即获取记录,回填错过了webhook发送,或 调和您的数据库 与帕拉的持续交易状态。 请参看Para webhook 文件签名 核查和核查 `rest.transaction.confirmed` 编号 : `rest.transaction.failed` 有效载荷实例.

## EVM 传输自动重试

使用 `transferWithAutoRetry` 自筹资金的本地/ERC-20EVM转让。 在发送前保存正文和密钥; 超时后再用 HTTP 202 表示在签署或广播前的持久接纳,并返回原件 交易编号和 `autoRetry` 状态而不是签名字节.

```ts
const key = crypto.randomUUID();
const request = {
  to: '0x1111111111111111111111111111111111111111',
  value: '1000000000000',
  chainId: '11155111',
  urgency: 'urgent' as const,
  autoRetry: {
    maxExecutionFeeWei: '1000000000000000',
    expiresAt: new Date(Date.now() + 30 * 60 * 1000).toISOString(),
  },
};
// Persist { key, request } before submitting. Never renew the deadline on replay.
const accepted = await para.transferWithAutoRetry(wallet.id, request, { idempotencyKey: key });
const current = await para.getRestTransaction(wallet.id, accepted.transactionId);
console.log(current.status, current.autoRetry?.state);
```

`maxExecutionFeeWei` 是每一次尝试执行气体的上限,不包括单独的连锁收费。 初始收费必须适合; 以后的建议仍须遵守最初的上限和以往的更换最低限额。 此 SDK 方法 支持EVM转移;并不增加索拉纳恢复的紧迫性。 见 [自动重试收费](https://docs.getpara.com/v3/rest/automatic-retry)。 。 。 .

## 手动回收EVM

对符合条件的未解决的普通自筹资金的EVM转让,使用 `speedUpRestTransaction` 或者说 `cancelRestTransaction` 带有新保存的一等钥匙和更换费上限:

```ts
const recovery = await para.speedUpRestTransaction(wallet.id, transactionId, {
  maxExecutionFeeWei: '1000000000000000',
  urgency: 'urgent',
}, { idempotencyKey: recoveryKey });
console.log(recovery.manualRecovery.state, recovery.manualRecovery.attempt.hash);
```

两种方法都返回原始交易ID并输入 `manualRecovery` 元数据。 读取进度 `getRestTransaction`启用 `cancelRestTransaction` 和身体形状相同,请求取消。 只有一本手册 加速或取消被接受每一次原始转让;HTTP接受并不能证明包含或取消. 原付款仍能取胜. 重放所保存的密钥/ 机构保留所选替换字节 . 见 [手动回收EVM](https://docs.getpara.com/v3/rest/transaction-history#manual-evm-recovery) 获得资格.

## 用于广播签名的自动重试

使用 `signTransactionWithAutoRetry` 与 `autoRetry` 财务报告和审定财务报表 `broadcast: true` 授权收回一笔EVM交易或支持的遗产索拉纳 交易。 在提交前保存密钥和全部请求; HTTP 重复使用两者, 包括原最后期限 . 服务器在签名或广播前返回 HTTP 202,使用 `transactionId`, (中文(简体) ), `status`,以及 `autoRetry` 而不是签名字节 .

```ts
const key = crypto.randomUUID();
const request = {
  transaction: { ...transaction, type: 2 as const },
  broadcast: true as const,
  autoRetry: {
    maxExecutionFeeWei: '1000000000000000',
    expiresAt: new Date(Date.now() + 30 * 60 * 1000).toISOString(),
  },
};
// Persist { key, request } in your job record before this call.
const result = await para.signTransactionWithAutoRetry(wallet.id, request, { idempotencyKey: key });
const record = await para.getRestTransaction(wallet.id, result.transactionId);
console.log(record.status, record.autoRetry?.state, record.monitoring?.winningHash);
```

EVM支持0和2型合同呼叫,包括2型访问列表. 收费和气体限制使用十进制整数 字符串。 同值替换保留目的地、值、调用数据、气体限制和访问列表;费用上限 增加至少12.5%,四舍五入,在上次播出后至少60秒. 没有固定的尝试限制. `maxExecutionFeeWei` 限制每次尝试的执行气体;不包括单独的链路费.

对索拉纳来说,发送一个未签名的遗产交易,钱包是唯一的签名人和付费人,一个仍然有效的最终结果 最近的Blackash, 正好一个120000单位计算限额和一个计算单位价格指示。 使用 `maxExecutionFeeLamports` 改为 `maxExecutionFeeWei`;它规定了基数加优先费的上限,不包括账户租金。 版本和耐用 交易和无凭证的系统/账户指示被否决。 帕拉必须在其 512-slot已最终确定历史窗口;缺失或更老的锚地历史在签署前被拒绝. 原始交易 字节被保留, 即使有更新的已定稿散列存在 。 索拉纳重新发送精确的字节直到到期 需要最终确定非执行证据,然后用新的块块重建.

注册的秘密密钥、钱包和当前政策必须授权每次尝试。 交易授权 不批准更改收费:重试请求不接受 `reviewId` 或者说 `initiatorUserId`。停止重试 仍然有一个待处理的链上交易。 继续投票 原身份证;不再提交操作 新建密钥。 签字人适配器保持其只签的行为. 见 [自动重试收费](https://docs.getpara.com/v3/rest/automatic-retry)。 。 。 .

## 存款和提款

使用 `createYieldDeposit`, (中文(简体) ), `createYieldWithdrawal` 财务报告和审定财务报表 `getYieldOperation` 现有Aave/Morpho产量路线. 在第一次通话前保存完整的请求和自强键. 数额为UDC小数单位;提取 还接受 `'all'`。选择一个支持 `marketId`,或使用 `chainId` 选择其Aave市场.

```ts
const key = crypto.randomUUID();
const request = {
  marketId: 'aave-v3:11155111:usdc',
  amount: '10',
  autoRetry: {
    expiresAt: new Date(Date.now() + 30 * 60 * 1000).toISOString(),
    approval: { maxExecutionFeeWei: '200000000000000' },
    action: { maxExecutionFeeWei: '1000000000000000' },
  },
};
// Persist { key, request } before submitting; replay both unchanged.
const accepted = await para.createYieldDeposit(wallet.id, request, { idempotencyKey: key });
const operation = await para.getYieldOperation(wallet.id, accepted.id);
console.log(operation.status, operation.transactions, operation.autoRetry?.phases);
```

`autoRetry` 是可选的。 其所需行动上限授权一次存款/撤回交易,包括所有 同非收费替代。 需要批准的,须有其自身的明确上限 上限或滚动未使用的授权。 包括核准存款,除非现有备抵 ; 提款从不需要。 每个上限使用现有的 每个交易执行-气体语义,不包括单独的链式收费. 这不是累计业务预算.

缺失的核准上限或高于上限的第一次交易不能通过重放同一请求来固定. 首先取消未验证的操作 `POST /v1/wallets/{walletId}/yield/operations/{operationId}/cancel`,然后使用新的钥匙和适当的上限. SDK不包此取消路径 。 签署阶段或不确定阶段仍在跟踪,不能以这种方式取而代之.

最初的期限适用于批准、行动和每次重播。 如果批准后失效,则确认 核准情况仍然可见,未签名的行动没有运行. `autoRetry.phases` 显示每个阶段的交易 身份证,尝试和重试状态。 初始审查的交易保留其精确的字节;替换需要新鲜 政策允许并重新使用该阶段的主要会计。 现行政策和会计必须重新证明; 不相容的再利用,包括未经支持的核准支出超龄,在MPC之前停止签名. 停止重试仍然可以 正在等待:跟踪 相同的操作和交易ID直到解决。 排除保留了现有的精确字节回收.

## 赞助转让

设定 `sponsoredGas: true` 要求在符合资格的EVM令牌转让上提供准付费气体。 段落必须启用 合作伙伴现有管理人员 `featureFlags.restGasSponsorship` 设置。 如果赞助不能兑现 请求失败时出现可操作错误;它永远不会回到钱包支付的气体。 接受赞助的转移返回 HTTP 202 `sponsoredGas: true`页:1 `transactionId`和状态。 答复没有 `signedTransaction`。 。 。 .

就共同转让而言,向收款人提供金额和资产(链和令牌) `sponsoredGas: true`· ; 第1段选择非ce、气体和费用。 如果您需要明确的非ce、 费用上限或其他控制, SDK 转发 它没有改变。 当前的赞助 API 拒绝不支持的控件, 并带有可操作错误 。 SDK从不 放下控件, 翻转 `sponsoredGas` 改为 `false`,或者通过钱包支付的执行重试.

设定 `sponsoredGas: false` 或省略要求支付钱包的气体,而不论合伙人的赞助资格. 仅 `sponsoredGas: true` 准付费气体。 转账回复和交易 历史/详情 `sponsoredGas: true` 补偿性气体或 `false` 钱包支付汽油。 较旧的API版本可能省略; 已贬值的响应 `executionMode` 字段所剩的相容性( e)`'sponsored'` 或者说 `'legacy'`) (中文(简体) ). 不发送 `executionMode` 在请求中:API以可操作错误拒绝.

服务器必须支持 `sponsoredGas` 在你使用它之前。 SDK 在省略字段时期望钱包付费气体 并且保留请求不变。 如果服务器返回不同的赞助选择, SDK 掷出 `ParaRestSponsorshipError` 并保留结果 `error.response`对于更古老的反应,SDK推断 提案国: `executionMode === 'sponsored'`。可能已经提交了交易:核对其跟踪 重试前的ID/hash. 此响应检查无法取消广播 .

提高以前仅依靠伙伴入学的一体化程度,改变其煤气支付合同: 发送 `sponsoredGas: true` 在每笔新转帐中,需要预付汽油。 已发送的请求现在需要支付钱包费用 气体,而SDK拒绝一个出人意料的赞助响应,包括一个没有"布尔"的更古老的响应. 重放已有的被担保密钥需要 `sponsoredGas: true` 和不变的经济意图。 重放密钥 与 `false` 或省略的旗帜返回 `409 IDEMPOTENCY_CONFLICT` 不创建另一个传输。 恢复 原作跟踪ID或重放原作所担保的请求; 永远不要用新的一能键重试支付.

```ts
import { isSponsoredTransfer } from '@getpara/rest-sdk';

// Save this key with your payout before the request. Reuse it if the response is lost.
const requestKey = crypto.randomUUID();
const result = await para.transfer(
  wallet.id,
  { to: recipient, value: '1000000', chainId, tokenAddress, kind: 'ERC20', sponsoredGas: true },
  { idempotencyKey: requestKey },
);

if (isSponsoredTransfer(result)) {
  // Save the tracking ID, then poll this lookup from your background job.
  const record = await para.getRestTransaction(wallet.id, result.transactionId);
  console.log(record.status, record.stage, record.hash, record.actualGasCost);
} else {
  console.log(result.signedTransaction, result.txHash);
}
```

`isSponsoredTransfer()` 缩小用于跟踪或读取签名字节的响应。 用这个 `sponsoredGas` 当存在时 回到旧的反应中 `executionMode` 字段.

支持的请求需要一等钥匙和正整数 `value` 在符号基单元。 赞助管理 (a) 非现金、煤气、费用和提交。 唯一被接受的身体领域是 `to`, (中文(简体) ), `value`, (中文(简体) ), `chainId`, (中文(简体) ), `tokenAddress`, (中文(简体) ), `kind`, (中文(简体) ), `broadcast`, (中文(简体) ), `addressScreening`,以及 `sponsoredGas`。所有其他字段都被拒绝,即使无效或空,包括 `autoRetry`, (中文(简体) ), /类型/收费超过, `reviewId`, (中文(简体) ), `initiatorUserId`,以及 `network`常规 `TransferRequest` 还在曝光 遗产转让的发起者和网络域。 奥米 `kind` 或设定为 `'ERC20'`; 省略 `broadcast` 财务报告和审定财务报表 `addressScreening` 或设置为 `true`明确赞助不支持索拉纳或残疾受益人的筛选. 服务器执行伙伴资格及其支持的链/托肯配置. 无法提供或暂停的赞助拒绝明确赞助的请求。 伙伴旗帜控制赞助资格; 它从不为请求选择赞助 `sponsoredGas: false` 或省略的字段。 现有赞助业务保留其追踪身份证.

票价 `getRestTransaction` 直到状态 `confirmed`, (中文(简体) ), `reverted`,或 `failed`;当 `stage` 实值 `requires_action`。 。 。 . `submitted` 带有舞台 `included` 仍在等待验收. `submission_unknown` 表示 提供者可能已经接受了操作. `delivery_unverified` 表示包括了操作但代号交付 需要调和;两个阶段都不是再次发送的理由。 重用原始请求和密钥以追回丢失 并恢复投票 原始跟踪ID。 SDK不会自动重试或投票.

有条件的审批政策不支持本试点的担保转让. 在现有政策审查获得批准后,明确继续开展以下行动:

```ts
await para.resumeRestTransaction(wallet.id, transactionId, { reviewId });
```

恢复接受复议ID,而不是新的转会. 重复 `transfer` 仅取出已有的密钥 操作而不恢复. `userOperationHash` 确定赞助的操作; `txHash` 转让 反应和 `hash` 在交易历史中注明其曾经包括的链上交易. `actualGasCost` 是一个小数 链条的本地键基单元在结算后设置字符串,包括包含还原. 保持它作为一个字符串或 转换为 `bigint`没有 `number`启用 `getRestTransaction()` 赞助阶段、审查细节、用户操作散列、, 固定天然气成本; `listRestTransactions()` 返回交易摘要。 获取持续状态以校正错过的 Webhooks .

## 采购

`getOnRampPurchase` 查一查身份证明的 `ONRAMP_LAUNCHED` 事件—— 和到达时相同的id `purchaseId` 编辑 `onramp.completed` 网瘾.

```ts
const purchase = await para.getOnRampPurchase(purchaseId);

if (purchase.status === 'FINISHED') {
  console.log(purchase.transactionHash, purchase.asset.symbol, purchase.assetQuantity);
}
```

反应是 `onramp.completed` 有效载荷加一个生命周期 `status`. 未结算回报的购买 部分数据 - `transactionHash` 财务报告和审定财务报表 `completedAt` 为: `null` 直至 `status` 实值 `FINISHED` - 所以,分支开 `status` 而不是从散列中推断完成, 并视未承认的地位为非绝对状态.

与交易历史一样, Webhooks 是了解结算的首选方式; 使用此方式来回填入缺失的 或检查仍在飞行中的购买。 检查 `testMode` 在生产中记录购买情况之前 会计核算:测试采购使用真实报价,但从未收费.

## Webhook 类型

Webhooks 被送到您的后端, 所以处理它们的类型在这里直播. `ParaWebhookEvent` 是一个 歧视的结合,所以 `switch` 打开 `event.type` 缩进 `event.data` 该事件的有效载荷:

```ts
import { WebhookEventType, type ParaWebhookEvent } from '@getpara/rest-sdk';

export function handleParaWebhook(event: ParaWebhookEvent) {
  switch (event.type) {
    case WebhookEventType.ONRAMP_COMPLETED:
      // event.data is OnrampCompletedPayload
      return credit(event.data.purchaseId, event.data.transactionHash);
    case WebhookEventType.REST_TRANSACTION_CONFIRMED:
      // event.data is RestTransactionConfirmedPayload
      return settle(event.data.transactionId, event.data.hash);
  }
}
```

使用 `ParaWebhookEvent` 而不是通用的 `WebhookEvent`,其 `type` 财务报告和审定财务报表 `data` 无关 - `data` 保持每个有效载荷的结合,无论 `type`个人有效载荷接口`OnrampCompletedPayload`, (中文(简体) ), `WalletCreatedPayload`,(......) `WebhookEventPayloadMap`,以及 `ParaWebhookPayload<K>` 也导出,用于输入 a 单事处理者.

这些只是类型——这个软件包不接受,校验,或发送webhoks. 验证原始文件上的签名 请求机构,然后才能信任发送; 程序请参见 Para Webhook 文件.

## 适配器

```ts
import { createParaRestEthersSigner } from '@getpara/rest-sdk/ethers';
import { createParaRestViemAccount } from '@getpara/rest-sdk/viem';
import { createParaRestSolanaSigner } from '@getpara/rest-sdk/solana';

const ethersSigner = createParaRestEthersSigner({
  client: para,
  walletId,
  address,
});

const viemAccount = createParaRestViemAccount({
  client: para,
  walletId,
  address: address as `0x${string}`,
});

const solanaSigner = createParaRestSolanaSigner({
  client: para,
  walletId: solanaWalletId,
  address: solanaAddress,
});
```

## 不支持的表面

此软件包有意不包括浏览器连接器, React hooks, wagmi 或 RainbowKit 连接器, 移动 auth,用户会话流量,账户创建UI,MPC共享存储,共享迁移加密帮助器,遗留适配器, 或自动复试。 使用 `@getpara/server-sdk` 页:1 `migrateWalletShare`。保留后端的 API 密钥并曝光 只有您自己的应用程序给客户端的路径.

## 沙盒探测器

`scripts/probe-signature-format.ts` 可以在 `PARA_API_KEY` 已提供。 消毒的动物 安装在 `src/__fixtures__/signature-formats.json` 文档观察到回归测试的行为。 这不是一个 替换 OpenAPI 合同或实时 REST 路由器行为.

## 常见问题

### @getpara/rest-sdk 是什么？

Para REST 钱包管理和签名的服务器侧 SDK

### 如何安装 @getpara/rest-sdk？

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

### @getpara/rest-sdk 支持 TypeScript 吗？

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

### @getpara/rest-sdk 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

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

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

### @getpara/rest-sdk 可以商用吗？

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

### @getpara/rest-sdk 的下载量有多少？

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

### @getpara/rest-sdk 还在维护吗？

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

