# @anywalletkit/protocol-staking-ssv-evm 中文文档

规范地址：https://npmcn.com/package/%40anywalletkit/protocol-staking-ssv-evm/

版本：0\.3\.11
npm 元数据更新时间：2026-11-02T20:13:30.219Z
中文译文更新时间：2026-11-06T22:52:53.699Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40anywalletkit/protocol-staking-ssv-evm
原文对照：https://npmcn.com/package/%40anywalletkit/protocol-staking-ssv-evm/?lang=original
项目主页：https://docs.anywallet.tech/
源码仓库：https://github.com/ultratestbro/anywalletkit

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

- 包体积（解压后）：212 kB，10 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：1 个
- peer 依赖：@anywalletkit/core 0\.8\.0
- 首次发布：2026-10-24T18:41:39.045Z
- 最新版本发布：2026-11-02T20:13:29.818Z
- 近 30 天下载量：2199（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

一个简单的包,让@anywalletkit/wallet-evm 钱包账户通过SSV网络对SSV进行赌注:sick SSV → cSSV,要求ETH奖励,冷却取出并退出.

## 安装

```sh
npm install @anywalletkit/protocol-staking-ssv-evm
```

也可以使用：`pnpm add @anywalletkit/protocol-staking-ssv-evm`、`yarn add @anywalletkit/protocol-staking-ssv-evm`、`bun add @anywalletkit/protocol-staking-ssv-evm`

## README

# @anywalletkit/protocol-swaging-sv-evm (英语)

[![npm](https://img.shields.io/npm/v/@anywalletkit/protocol-staking-ssv-evm?label=npm)](https://www.npmjs.com/package/@anywalletkit/protocol-staking-ssv-evm)

一个简单的软件包 `@anywalletkit/wallet-evm` 钱包账户赌注 结束 [SSV网络](https://ssv.network/): 股份SSV = cSSV, 索赔ETH 奖励,通过网络冷却退出,并读取APR和网络统计.

## 安装

```sh
npm install @anywalletkit/protocol-staking-ssv-evm @anywalletkit/core
# or: pnpm add @anywalletkit/protocol-staking-ssv-evm @anywalletkit/core  ·  yarn add @anywalletkit/protocol-staking-ssv-evm @anywalletkit/core
```

时间: [@anywalletkit/protocol-swaging-sv-evm (英语)](https://www.npmjs.com/package/@anywalletkit/protocol-staking-ssv-evm)发表于 [发布工作流程](https://github.com/ultratestbro/anywalletkit/blob/main/RELEASING.md) 与出处.

建为 **执行情况 `StakingProtocol` 类型** 内 `@anywalletkit/core` (第一个是 `@anywalletkit/protocol-staking-lido-evm`) (中文(简体) ). 基础班住在这里 `@anywalletkit/core` (单位:千美元)`src/staking-protocol.ts` 这里 保持运行时间 `IStakingProtocol` 标记和模块本身的类型)。 A 类 带冷却装置的自动取号协议 界面不是 Lido 形状.

机械师从一个生产钱包取出(反应土著/赫尔姆斯) 以实际资金进行一切流动.

## SSV网络和SSV标志是什么

[SSV网络](https://ssv.network/) 是分布式验证器技术(DVT) 对于Ethereum:一个验证器的密钥在几个独立的操作符之间被分割, 所以当他们中任何一人倒下或行为不端时,他们就继续奔跑。 一个大 ethereum液体吸附量的一部分 在它上运行其验证器。 操作员支付 (原始内容存档于2018-09-26). Network's pays in EH.

**车辆** 是网络的 ERC-20 符号 。 自SSV Network v2(主网,2026)起 SSV持有者可以进行赌注: 网络薄荷 **cSSV (英语)** 1:1——可转让, cSSV 持有者收到按比例分摊的 ETH 费用,通过每股ETH 指数逐个累积,可索赔 在任何时间,没有不负责任的。 积重也代表投票权 (原始内容存档于2018-10-21). Network's 有效平衡论. 找回SSV是一个冷却出口: `requestUnstake` 将cSSV烧为冷却入口(发射时7天,DAO可通取), 不可撤销, `withdrawUnlocked` 给每个冷却器 结束。 没有砍人。 《反倾销协定》在以下一项中标为ETH: 以SSV为标价的股权,所以它随SSV的价格而移动.

## 使用量

```js
import WalletManagerEvm from '@anywalletkit/wallet-evm'
import SsvProtocolEvm from '@anywalletkit/protocol-staking-ssv-evm'

const wallet = new WalletManagerEvm(seed, { provider: 'https://rpc.example.org' })
const account = await wallet.getAccount(0)

const ssv = new SsvProtocolEvm(account)

// Stake — approve (awaited) + stake on the first go, one transaction after
const { hash, fee, approveHash } = await ssv.stake({ amount: 10n ** 18n })

// Rewards accrue in ETH; claim any time, the stake stays put
await ssv.getClaimableRewards()            // wei
await ssv.claimRewards()

// Exit, phase 1: burn cSSV into a cooldown entry (irreversible)
await ssv.requestWithdrawal({ amount: 10n ** 18n })

// …after the cooldown — exit, phase 2: withdraw every unlocked entry as SSV
const { claimableIds } = await ssv.getWithdrawalRequests()
if (claimableIds.length) await ssv.claimWithdrawals()

// Views
await ssv.getStakedBalance()   // { balance: cSSV, wrappedBalance: 0n, rate: 1e18, total }
await ssv.getApr()             // 23.8 (percent, from SSV Network's API)
```

超出接口的 SSV 特殊额外 :

```js
await ssv.getTokenBalance()          // liquid SSV on the account
await ssv.getClaimableRewards()      // accrued ETH (wei)
await ssv.claimRewards()             // claimEthRewards()
await ssv.getCooldown()              // seconds — read it, never hardcode 7 days
await ssv.getNetworkStats()          // { totalStaked, rewardsPool, accEthPerShare }
await ssv.getAprHistory({ limit: 7 })// daily samples with SSV/ETH prices
```

## 它如何映射到界面上

| `IStakingProtocol` | SSV网络 |
| --- | --- |
| `stake({ amount })` | 津贴检查 + `approve` (等待有地雷的收据) `stake` 使用 SSVNetwork 代理服务器; cSSV 刻出 1:1 |
| `requestWithdrawal({ amount })` | `requestUnstake` 将cSSV烧成冷却入口; `token` 忽略( 单下注形式) |
| `getWithdrawalRequests()` | `pendingUnstake` • 条目 `id` = 职位, `unlockTime`, (中文(简体) ), `claimable = unlockTime <= now`; 数额 **车辆** |
| `claimWithdrawals()` | `withdrawUnlocked` 支付 **每个** 解锁条目; `ids` 为信息 |
| `getStakedBalance()` | cSSV余额, `wrappedBalance` 零点, `rate` 1e18 (韩语) |
| `getApr()` | `api.ssv.network/…/apr/current` —— 显示的数个字符串( ssv.network) |

与利多的两个诚实的区别 被记录在方法上而不是 已打印: 退出会支付挂号( SSV) , 而不是链条的原生 符号,而撤回的呼叫是全或全在网络一侧.

## 为什么写道看起来像它一样

-   **任何许可**:SSV和cSSV都没有执行EIP-2612(检查: `nonces` 编号 : `DOMAIN_SEPARATOR` 两者皆复). 因此,第一个利害关系是 + 股权批准;批准为 **等待有地雷的收据** 因为 `stake`气体的估算值与未计值的允许值相抵。 与一个 常设津贴是一笔交易.
-   **广播前证明**: 每一个书写都是用 `eth_call` 从 账户先。 抽取模块返回时出现明显的自定义错误—— `StakeTooLow`, (中文(简体) ), `UnstakeAmountExceedsBalance`, (中文(简体) ), `NothingToWithdraw`, (中文(简体) ), `NothingToClaim`, (中文(简体) ), `InsufficientBalance`... 还有.. `describeRevert` 转动 4字节选择器回到一个命名错误中,在提供者(viem)埋葬的地方 (单位:千美元)`error.data`, (中文(简体) ), `info.error.data`, (中文(简体) ), `cause`,或消息文本)。 一个用户 看见"还没有解冻请求完成",不是"执行" 已经恢复了,而且不付任何汽油.
-   **索赔四舍五入**数字 : `claimEthRewards` 付费 `accrued − accrued % 100000 wei` 当它变成零的时候,又复返于零; `claimRewards` 检查 `previewClaimableEth` 反对 `ETH_CLAIM_UNIT` 上前边.
-   **不稳定的编号**: 冷却条目按位置和 `withdrawUnlocked` 压缩列表——重读 `getWithdrawalRequests` 每次写后; 这里没有缓存 id .
-   **结构账户检查**: 可写性为 `typeof account.sendTransaction === 'function'`没有 `instanceof`。 。 。 .
-   **没有 `AbortSignal.timeout` 编号 : `AbortSignal.any`**: 赫尔墨斯船 `AbortController` 没有这些静电,这里的一切都取决于它们.
-   **REST是装饰**: APR和APR的历史来自同名API ssv.network 读取( CORS) `*`),通过 `config.endpoints`· ; 连锁流动从不依赖它们 `getAprHistory` 降解为 空阵列 .

## 配置

```js
new SsvProtocolEvm(account, {
  provider,   // RPC url or EIP-1193; defaults to the account's provider
  chainId,    // default 1; other chains must supply addresses
  addresses,  // { network, views, ssvToken, cssvToken }
  endpoints   // { apr, aprHistory }
})
```

只有主网舰作为默认部署——故意. 胡迪测试网 地址列于 `src/ssv-address-map.ts` 用于明确的配置, 所以,没有人与地址有利害关系 一个默认的静悄悄提供.

主网合同(验证了链上与直播代理,v2.0.0): SSV网络 `0xDD9BC35aE942eF0cFa76930954a156B3fF30a4E1`,SSVNetwork 视图 `0xafE830B6Ee262ba11cce5F32fDCd760FFE6a66e4`, SSV 软件 `0x9D65fF81a3c488d585bBfb0Bfe3c7707c7917f54`页:1 `0xe018D31F120A637828F46aFD6c64EC099d960546`。 。 。 .

## 测试

```
pnpm build            # TypeScript → dist/ (tsup: ESM + CJS + d.ts); built on viem
pnpm test             # offline unit tests (vitest, stubbed EIP-1193 provider) + conformance
pnpm verify:live      # read-only checks against mainnet (views, API, eth_call proofs; needs a build)
```

## 活动

`describeActivity(tx, { own })` 标签 SSV 为钱包的历史进行交易, 离线和同步。 交易是SSV的 当它叫它 `network` 代理实例在链上配置(默认情况下是主网),选择器是 `stake` → `stake` "抓获的SSV", `requestUnstake` → `unstake` "请求不取", `withdrawUnlocked` → `claim` "带着SSV", `claimEthRewards` → `claim` "要求ETH奖赏"(A`SSV_ACTIONS`,在模块装入时从签名中计算出的筛选器)。 操作员/集群管理呼叫相同的代理, SSV `approve`和任何其它东西都无效。 字幕 `"SSV Network · Ethereum"`, (中文(简体) ), `counterparty` 代理服务器; `assetsIn` 编号 : `assetsOut` 是模块标注的钱包净运动(SSV,cSSV,ETH奖励).

装入 `fixtures/activity/` 是测试钱包资助的运行(取出,请求Unstake x2,取出解锁,要求Eth Rewards; 2026-09-03-1007); 3; `negatives/` 持有Lido的呈文和USDT的批准书.

## 常见问题

### @anywalletkit/protocol-staking-ssv-evm 是什么？

一个简单的包,让@anywalletkit/wallet-evm 钱包账户通过SSV网络对SSV进行赌注:sick SSV → cSSV,要求ETH奖励,冷却取出并退出\.

### 如何安装 @anywalletkit/protocol-staking-ssv-evm？

在项目目录运行 npm install @anywalletkit/protocol-staking-ssv-evm，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@anywalletkit/core（0\.8\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @anywalletkit/protocol-staking-ssv-evm 支持 TypeScript 吗？

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

### @anywalletkit/protocol-staking-ssv-evm 支持 ESM 还是 CommonJS？

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

### @anywalletkit/protocol-staking-ssv-evm 需要什么版本的 Node\.js？

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

### @anywalletkit/protocol-staking-ssv-evm 可以商用吗？

@anywalletkit/protocol-staking-ssv-evm 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @anywalletkit/protocol-staking-ssv-evm 的下载量有多少？

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

### @anywalletkit/protocol-staking-ssv-evm 还在维护吗？

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