# @anywalletkit/protocol-lending-morpho-evm 中文文档

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

版本：0\.4\.0
npm 元数据更新时间：2026-11-05T12:22:40.086Z
中文译文更新时间：2026-11-07T00:23:38.659Z
软件包许可：Apache-2\.0

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

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

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

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

## 中文简介

Morpho代表@anywalletkit/wallet-evm账户:Morpho Vaults(MetaMorpho V1和Vault V2, ERC-4626存款/赎回)和Morpho Blue市场(供应,取出,借出,还款,抵押品)作为出借协议,分10个连锁店. 断层被比对莫福

## 安装

```sh
npm install @anywalletkit/protocol-lending-morpho-evm
```

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

## README

# @anywalletkit/protocol-lending-morpho-evm (英语)

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

[发作](https://docs.morpho.org/) 页:1 `@anywalletkit/wallet-evm` 账户,两个 `LendingProtocol`s 在一个软件包中:

## 安装

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

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

-   **`MorphoVaultProtocolEvm`** - Morpho断层(MetaMorpho/断层V1或断层) V2: (英语) `supply` 将金库的资产存入股票, `withdraw` 赎回他们. 最简单的收入产品; `borrow` 编号 : `repay` 拒绝.
-   **`MorphoMarketProtocolEvm`** 一个莫福蓝市场: `supply` 编号 : `withdraw` 借出贷款券, `supplyCollateral` 编号 : `withdrawCollateral` 张贴并带走 担保, `borrow` 编号 : `repay` 拿走并归还贷款凭证.

由协议本身的接口( 形态- 蓝色、 元形态、 库- v2) 写入 和Morpho Blue一样的股份和利息 `SharesMathLib` 编号 : `MathLib` 编号 : `Morpho._accrueInterest`; 一个依赖(viem). 使用 Morpho 图形QL API 仅用于发现和装饰(名单、APY、TVL) 链子.

## 链条

(原始内容存档于2017-10-21). Ethereum, Base, Arbitrum, OP Mainnet, Polygon, Unichain, HyperEVM, 卡塔纳, 罗宾链的莫纳德公司`MORPHO_CHAINS`Morpho(蓝色)地址来自 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}每个金库的背后都是金库 API列表(文件不包含工厂表). 其他连锁店 `morpho` 输入 相会.

## 使用量

```ts
import WalletManagerEvm from '@anywalletkit/wallet-evm'
import { MorphoVaultProtocolEvm, MorphoMarketProtocolEvm, MorphoApi } from '@anywalletkit/protocol-lending-morpho-evm'

const account = await new WalletManagerEvm(seed, { provider: 'https://base-rpc…' }).getAccount(0)

// Discovery (API): the listed USDC vaults on Base, biggest first
const api = new MorphoApi()
const [best] = await api.listVaults({ chainId: 8453, asset: USDC })

// Vault
const vault = new MorphoVaultProtocolEvm(account, { vault: best.address })
await vault.getVault()                          // verified against Morpho's factories; asset, fees, timelock…
await vault.getApy()                            // 4.1 (net, percent, from the API)
await vault.supply({ amount: 5_000_000n })      // exact approve → deposit(assets, me)
await vault.getPosition()                       // { shares, assets, withdrawable }
await vault.withdraw({ amount: 'max' })         // redeem(every share) — refused up front if the vault lacks liquidity

// Market (Blue)
const market = new MorphoMarketProtocolEvm(account, { market: '0x9103…1836' })   // id or MarketParams
const m = await market.getMarket()              // loan/collateral tokens, LLTV, price, state accrued to now, APYs, liquidity
await market.supplyCollateral({ amount: 10n ** 7n })        // 0.1 cbBTC
await market.borrow({ amount: 3_000_000_000n })            // 3 000 USDC — refused if above LLTV or market liquidity
await market.getPosition()                      // debt (rounded up), collateral value, health factor, liquidation price
await market.repay({ amount: 'max' })           // by shares, no dust; allowance = debt + 0.1 %
await market.withdrawCollateral({ amount: 'max' })
```

### 钱移动前的安全

-   **虚空身份.** `getVault()` 问链子的Morpho金库工厂 (单位:千美元)`isMetaMorpho` 编号 : `isVaultV2`他们是否创建了地址和一个V1 保险库 `MORPHO()` 一定是链子的单子。 一个未知的地址是 拒绝,除非 `allowUnverifiedVault: true`。 。 。 .
    
-   **断层限制.** V1:核对存款 `maxDeposit` (盖子), 退 款 `maxWithdraw` 编号 : `maxRedeem` (故障流动性)——错误 说多少 _实值_ 现在可能。 V2从最大\* 视图中回答 0, 所以 其转接闸口被读取(`canReceiveShares` 编号 : `canSendAssets` 内, `canSendShares` 编号 : `canReceiveAssets` 上限和流动性留给 页:1 `eth_call` 在每次发送之前运行的证据.
    
-   **死钱.** 在保险库存款或市场供应之前,目标 必须持有一个死亡的保证金 `0x…dEaD`,规则Morpho自己的SDK适用 (形态-sdk 9.2.0):至少 `MIN_DEAD_SHARES` (1e9)股份(蓝色供应) 市场股票 保险库股票 保险库股票 保险库股票 保险库股票 V2 也必须是 价值 `MIN_VAULT_V2_DEAD_ASSETS` (1e6个基单位),其份额价格高于 1 / (10×虚拟股份). 如果没有一个,一个几乎空的靶子的股价可以 对下一个储户充气。 失败的目标被拒绝使用 `MorphoDeadDepositError` (单位:千美元)`code: 'InsufficientDeadDeposit'`, (中文(简体) ), `observed`, (中文(简体) ), `required`除非配置通过 `allowWithoutDeadDeposit: true`。 。 。 . `getDeadDeposit()` 读它不供应。 提款、抵押、, 出借和还款从不由之入门.
    
    只检查目标本身 。 Morpho的SDK也在市场里走过 保险库可以分配给(每个退出的V1市场,每个 上限分配和Vult V2的流动资金市场。 此模块确实 不,有两个原因。 首先,目标检查 保证金本身: 储户的资产在目标自己的股份数学中四舍五入。 A 类 将金库分配用于影响金库资产 保管人 选择、封顶和每个持有者股票;即管理风险,即 此模块不试图判断。 第二,步行拒绝 大部分列出 保险库:在2026-11-04年,它会拒绝列出的69个地窖V1中的45个, 大部分是因为市场闲置(没有抵押品) 队列.
    
-   **上市对存.** `MorphoApi.listVaults` 返回 API 列表, V1和V2都一样 API没有死库,所以是上市金库 不守规矩的人留在名单上 就像一个盖子满了的金库 或者V2门拒绝开户 由 保险库协议 : `getDeadDeposit()` 显示规则,和 `quoteSupply` 编号 : `supply` 拒绝未兑现的存款(`MorphoDeadDepositError`),满V1 上限(`ExceededMaxDeposit`)和V2门(`CannotReceiveShares`, (中文(简体) ), `CannotSendAssets`),在任何事项获得批准前出现打字出错. 打电话 `quoteSupply` (或 `getDeadDeposit`在提供押金之前.
    
-   **市场身份.** Id解决 `idToMarketParams`还有RPC的 回答必须散列返回id或被拒绝;配置中给出的参数是 hashed to the id 和市场必须存在(`lastUpdate ≠ 0`) (中文(简体) ). 黄金 cbBTC/USDC id从参数中得出.
    
-   **市场州.** `market()` 现为 `accrueInterest` 将(由泰勒计算出从IRM的借款率,费用份额),因此提供 / 借入的资产,健康和流动性是流动的,而不是最后触摸.
    
-   **卫生.** 对借款和抵押物提取进行核对 `collateral × price / 1e36 × LLTV`\- 流动资金与供应——借入. `onBehalfOf` 借钱需要 `isAuthorized`。 。 。 .
    
-   **证相.** 每个主要交易是 `eth_call`编自账户;Morpho's 返回字符串( e)`insufficient liquidity`, (中文(简体) ), `insufficient collateral`,(......)和 金库的自定义错误( e)`AllCapsReached`, (中文(简体) ), `ERC4626ExceededMaxWithdraw`, (中文(简体) ), 五. 2级 `CannotReceiveShares`,)成为可读性 `MorphoError`编号.
    
-   **核准** 精确( 绝不是无限的), 与 `approve(0)` 重设 Ethereum的UDT要求。 Morpho没有本土-币路径:先包好.
    

### 读取

|  | 返回时 |
| --- | --- |
| `vault.getVault()` | 版本、工厂、名称、资产、总资产 |
| `vault.getPosition()` | 股票,资产,现在可以收回 |
| `vault.getApy()`, (中文(简体) ), `vault.getStats()` | aPY净%,API记录 |
| `vault.getDeadDeposit()`, (中文(简体) ), `market.getDeadDeposit()` | 股票(和 V2 资产) `0x…dEaD`死保规则是否通过 以及什么失败 |
| `market.getMarket()` | parums, sidences, LLTV, oracle价格(1e36), 累积状态,流动性,利用率,借款/供应APY |
| `market.getPosition(user?)` | 供应/借款份额和资产、抵押、抵押价值、最大借款、健康因素、LTV、清算价格 |
| `MorphoApi.listVaults / listMarkets / vault / marketById` | 发现,最大的第一, `listed: true` (V1和V2;所列不可存放,见上文) |

## 测试

`pnpm test` - 27次离线测试,测试基地的Memero Morpho(蓝色) 单通有真实的 cbBTC/USDC 市场参数, IRM, oracle, a MetaMorpho v1.0工厂后面的金库,一个外观相像的金库,多呼3,回放) + 两个协议的配套套装. `pnpm verify:live` 读取基础 通过公共RPC和API.

## 状态

2026-10-10:建成通车,下线测试绿色,现场只读验证基地. 尚未通过模块获得资金(计划:5美元进入基地金库, 页:1.

## 活动

`describeActivity(tx, { own })` 标签 Morpho 钱包历史交易, 离线和同步( 两类通过 `MorphoBase`:

-   **蓝色** 已确认 **通过地址**:所谓的合同是交易链中的Morpho singleton(`MORPHO_CHAINS`,或 `morpho` 此实例已配置),选择器是 `supply` 编号 : `withdraw` 编号 : `borrow` 编号 : `repay` 编号 : `supplyCollateral` 编号 : `withdrawCollateral` (-) `supply` 编号 : `withdraw` 编号 : `borrow` 编号 : `repay`)或(或) `setAuthorization` (-) `contract`) (中文(简体) ). 主要资产是: `MarketParams.loanToken` 从当前时的调用数据.
-   **断层** (MetaMorpho / Vault V1, Vault V2)不能下线上市——它们来自工厂和 `isMetaMorpho` 编号 : `isVaultV2` 证明需要一个节点——所以规则是: 选择器是一个 ERC-4626 切入点(`deposit` 编号 : `mint` → `supply`, (中文(简体) ), `withdraw` 编号 : `redeem` → `withdraw`(中文(简体) ) **财务报告和审定财务报表** 所谓合同本身就是收据显示的股份代号,该代号是从钱包的地址(取出)中刻出(存放)或从(取出)钱包的地址中被烧毁的,在一条带有Morpho部署的链上。 保险库 a `MorphoVaultProtocolEvm` 实例的配置仅由地址接受. _洞穴:_ morpho 链上的任何 ERC-4626 保险库都符合通用规则;工具包按登记顺序询问模块,因此,在此之前应当登记一个知道具体保险库的模块.
-   **标题** `"<Verb> <asset>"` ("存款的USDC","Undrew USDC";股份代币从来不是本金), **字幕** `"Morpho · <chain>"` 编号 : `"Morpho Vault · <chain>"`, (中文(简体) ), `counterparty` 合同要求, `protocol` 软件包名称; `assetsIn` 编号 : `assetsOut` 是钱包的净移动(包括份额).
-   **无** 否则.

装入 `fixtures/activity/` 公共基础交易(Moonwell旗舰UDC金库) `deposit` 编号 : `redeem` 一个账户,一个蓝色 `supply` 编号 : `withdraw` 由另一个;测试钱包尚未运行 Morpho , `negatives/` aave网关存款和普通的USDC转账.

## 常见问题

### @anywalletkit/protocol-lending-morpho-evm 是什么？

Morpho代表@anywalletkit/wallet-evm账户:Morpho Vaults\(MetaMorpho V1和Vault V2, ERC-4626存款/赎回\)和Morpho Blue市场\(供应,取出,借出,还款,抵押品\)作为出借协议,分10个连锁店\. 断层被比对莫福

### 如何安装 @anywalletkit/protocol-lending-morpho-evm？

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

### @anywalletkit/protocol-lending-morpho-evm 支持 TypeScript 吗？

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

### @anywalletkit/protocol-lending-morpho-evm 支持 ESM 还是 CommonJS？

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

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

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

### @anywalletkit/protocol-lending-morpho-evm 可以商用吗？

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

### @anywalletkit/protocol-lending-morpho-evm 的下载量有多少？

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

### @anywalletkit/protocol-lending-morpho-evm 还在维护吗？

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