bitpro가 원문에서 글자만 모은 내용이에요. 표·그림·수식은 빠지거나 깨질 수 있어요. 전체 61쪽 중 3쪽
nsent phishing survivable, and it is why the screen also shows where you will be returned to.
One grant covers one assistant on one account. Connecting the same assistant to a second account creates a second grant with its own scopes.
***
## 5. Lifetime and revocation
A grant lives for 90 days. Within that window the assistant holds a one-hour access token and quietly renews it, so you are not asked to re-approve hourly.
Connections are listed under **Settings → AI Connections** with the account each one reads, the scopes it holds, and when it expires. **Disconnect** sits on every connection behind one confirmation, and takes effect on the assistant's next request. Access is re-checked on every read, so revocation never waits for a token to expire.
You only re-approve when a grant hits its 90-day expiry or you disconnect it.
***
## 6. How it works
```
Claude / ChatGPT mcp.ether.fi ether.fi Cash backend
(MCP client) (MCP server + (authorization server +
OAuth 2.1 facade) account data)
| | |
| 1. connect, no token | |
|----------------------------->| 401, plus which scopes exist |
| | |
| 2. authorize + PKCE --------|------------------------------->|
| | consent in your browser:
| | who is asking, which account,
| | which scopes, passkey
|<------ one-time code --------|--------------------------------|
| 3. exchange code -----------|------------------------------->|
|<------ access token (1h) + refresh token (90d) --------------|
| | |
| 4. tool call, with token | |
|----------------------------->| verify the token |
| |------- internal read --------->|
| | is the grant still alive?
| | does its scope allow this read?
|<----- data for that one account -----------------------------|
```
Two things about that split are worth naming. The connector never mints tokens: it serves the MCP transport and forwards the OAuth endpoints, while the Cash backend is the authorization server and signs tokens with keys held in a KMS. And account reads never cross the public internet, because the routes the connector calls are reachable only from inside ether.fi's own network.
***
## Further reading
* [Technical Documentation](/etherfi/products/cash/technical-documentation), how Cash accounts, vaults, and settlement work
* [🔒 Vault](/etherfi/products/cash/vault), the non-custodial key and ownership model behind your account
* [Model Context Protocol](https://modelcontextprotocol.io), the open standard the connector implements
# Borrow
Borrow is a feature that allows you to earn rewards on your assets, and optionally use your assets as collateral that you can borrow against.
## Overview
Borrow is live. It lets ether.fi users earn yield on eligible assets and borrow against their portfolio without selling it. Borrowing is overcollateralized, so the value of the supplied collateral must remain sufficient to support the outstanding debt.
{% hint style="info" %}
The app is the source of truth for your current Product LTV, health factor, interest rates, and available-to-borrow amount. These values can change with market conditions and risk configuration.
{% endhint %}
## In this section
* [Technical documentation](/etherfi/products/borrow/technical-documentation) - high-level overview of how borrowing and lending works
* [Borrowing Power, Health Factor, and Liquidation](/etherfi/products/borrow/borrowing-power-and-liquidation) - how much you can borrow, how safe your position is, and what happens if it is liquidated
* [Parameters](/etherfi/products/borrow/lending-market-parameters) - overview of contracts and asset configuration
* [Price Feeds](/etherfi/products/borrow/price-feeds) - how collateral is priced and where those prices come from
# Technical Documentation
High-level overview of how borrowing and lending works
## Overview
All ether.fi users have a non-custodial Safe deployed on their behalf when they create an account. Eligible assets held by this Safe can be supplied to the ether.fi-managed on-chain lending protocol and used as collateral when Borrow is enabled.
When assets are used as collateral, this results in a USD-valued borrowing power. Users are able to borrow select assets directly, or use their card in Borrow Mode which borrows USDC at the time of purchases.
The Lending Protocol is an ether.fi-managed Aave v4 instance on Optimism.
<figure><img src="https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2FzQcb4Tp193mPspIDLyAF%2Fimage.png?alt=media&token=284beff2-4957-42b1-9024-67f6ccd22dd1" alt=""><figcaption></figcaption></figure>
## Asset types
There are three types of assets with respect to the Lending Protocol and non-custodial ether.fi accounts:
1. Collateral assets
2. Borrowable assets
3. Non eligible assets
#### Collateral assets
These assets can be used to increase borrowing power. If the account is opted in to Borrow, eligible assets are automatically supplied to the Lending Protocol. Each collateral asset has a Product LTV that limits how much it contributes to borrowing power. The separate collateral factor is used to calculate health factor and determine whether a position can be liquidated. See [Borrowing Power, Health Factor, and Liquidation](/etherfi/products/borrow/borrowing-power-and-liquidation).
#### Borrowable assets
A small subset of assets that can be borrowed. This is currently limited to USDC and ETH.
Suppliers of borrowable assets accrue an interest rate, and borrowers of the asset pay an interest rate. Borrowable assets are always collateral assets as well (i.e. users can both deposit USDC to be used as collateral, and borrow USDC).
#### Non eligible assets
Some assets are supported on ether.fi but are neither collateral nor borrowable assets. Primarily these are assets that can be purchased through the Swap feature but are not listed as collateral on the Lending Protocol.
For the documented list of supported assets, see [Lending Market Parameters](/etherfi/products/borrow/lending-market-parameters). The app shows the current assets and amounts available to each user.
## Lending protocol structure
The ether.fi-managed Lending Protocol currently consists of a single Liquidity Hub and a single Spoke that interfaces with the Liquidity Hub. The Lending Protocol is permissioned so that only ether.fi Safes can borrow assets, but anyone can supply to the Liquidity Hub.
<figure><img src="https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2FvUa4pZcja333muFbsXJX%2Fimage.png?alt=media&token=e9efa0fc-4dc0-4643-9020-932a36d209ec" alt=""><figcaption></figcaption></figure>
Assets used in the Lending Protocol are held in the Liquidity Hub, which is the central source of liquidity for borrows.
Position and balance tracking is managed on-chain through internal accounting. Read more about how the lending market works in the [Aave v4 documentation](https://aave.com/docs/aave-v4).
### User actions
* Supply → tokens flow from the Cash Safe into the Hub; the Spoke credits the user's supplied balance. Hub liquidity grows.
* Borrow → the Hub pays tokens out to the borrower. The debt is recorded as shares against a continuously growing index: amount owed = shares × index.
* Repay → tokens return to the Hub, debt shares are burned, liquidity is restored.
* Withdraw collateral → the Hub pays supplied tokens back out, reducing the user's supplied balance and Hub liquidity.
* Opt out → a user can disable Borrowing functionality in settings. This prevents their assets from being used as collateral (and if assets are supplied they will be withdrawn)
# Borrowing Power, Health Factor, and Liquidation
How your borrowing power is calculated, what your health factor means, and exactly what happens if you get liquidated
Borrow lets you keep your assets and take a loan against them instead of selling. The loan has to stay covered by the assets backing it. Three numbers decide whether it is: your **borrowing power**, your **health factor**, and the **liquidation** that happens if the health factor falls too far.
## Two different limits: Product LTV and collateral factor
Each collateral asset carries two percentages, and confusing them is the most common way to misjudge how much room you have.
* **Product LTV (loan-to-value)** is the borrowing limit the app enforces. It decides the most you can borrow against that asset.
* **Collateral factor (CF)** is the liquidation threshold. It decides the point at which your position can be liquidated.
For any given asset, its Product LTV is set below its own collateral factor. So each asset you hold has a borrowing limit and, above it, a separate liquidation point. That gap is the safety margin: it means borrowing your maximum does not leave you one small price move away from liquidation.
{% hint style="success" %}
Because we cap your borrowing at Product LTV while liquidation is measured against the higher collateral factor, a position borrowed to its stated maximum still starts with a health factor comfortably above 1.00, not sitting on the edge of it.
{% endhint %}
### Where each number comes from
The collateral factor is set on the lending market itself, per asset, and is published in [Lending Market Parameters](/etherfi/products/borrow/lending-market-parameters). It is the number the protocol uses when it decides whether a position is liquidatable.
The Product LTV is set by ether.fi on top of that. It starts from the asset's collateral factor and discounts it, by more for assets whose price can move sharply and by less for assets pegged to a currency. A separate per-asset ceiling can lower it further. The result is never above the collateral factor, so the safety margin cannot be configured away.
Because the Product LTV is applied by ether.fi rather than by the lending market, the app is the place to read it. The app shows the Product LTV in force for each asset you hold, alongside your live borrowing power.
## Borrowing power
Your borrowing power is the most you can borrow. It is the sum, across every asset you have posted as collateral, of:
> that asset's dollar value, multiplied by its Product LTV
An asset with a low Product LTV contributes much less borrowing power than a dollar stable with a high one, even at the same dollar value.
The dollar value comes from the price feeds, which have their own protections against a bad or stale price. See [Price Feeds](/etherfi/products/borrow/price-feeds).
Further limits can hold your available amount below this figure, so the app may show less headroom than Product LTV alone implies:
* A **borrowing cap** per account.
* A **minimum health factor** the app keeps you above after the borrow completes, which is stricter than the point at which liquidation becomes possible.
* The available market liquidity and the Lending Protocol's current reserve limits.
* Your existing debt and the prices used to value your collateral.
Whichever limit binds first determines the amount the app offers you. The same checks run again when the borrow executes, so the app's **available to borrow** amount is the source of truth for the transaction.
## Health factor
Your health factor compares your collateral against what you currently owe, including accrued interest. It is measured with the **collateral factor**, not the Product LTV, because it answers a question about liquidation:
> health factor = (collateral value x collateral factor) / total debt
With no debt it is effectively infinite. As you borrow it falls. As interest accrues it keeps falling, slowly, even if you do nothing and prices do not move.
At or above 1.00, your position is healthy. Below 1.00, it can be liquidated. Borrowing your full borrowing power does not take you to 1.00: it takes you to the ratio between the collateral factor and the Product LTV, which is the margin described above.
You can read your own live figure from the Spoke contract with `getUserAccountData(yourSafeAddress)`, which returns your health factor alongside your total collateral value and total debt. The app shows the same number.
### If your debt goes above your Product LTV limit
Prices move, and a Product LTV can be revised downward. Either can leave you owing more than your current Product LTV limit allows.
This blocks new borrowing until you are back under the limit. It is not a liquidation and it does not force you to do anything, because liquidation is still measured against the collateral factor, which sits above your Product LTV. Treat it as a warning that your margin has thinned rather than as an emergency.
## What a liquidation actually does
Someone else, a liquidator, repays part of your debt and takes some of your collateral in exchange, at a discount. It is not a foreclosure, and it usually does not close your position.
### It is partial, and it aims at a target
A liquidator cannot simply take everything. The protocol calculates how much debt needs repaying to lift your health factor back to a **target health factor** set a little above 1.00, and that is the size of the liquidation.
The normal outcome is that you keep most of your position and come out the other side with a health factor slightly above the danger line. You still owe money, and you still have collateral.
### The discount scales with how unhealthy you are
The liquidator's incentive is a **liquidation bonus**: extra collateral on top of what their repayment is worth. Each asset has a published *maximum* liquidation bonus, but that maximum does not apply at every health factor. The bonus is interpolated:
* Just below 1.00, the liquidator receives the **minimum** bonus.
* At or below a lower health-factor point, they receive the **maximum**.
* Between those two, it scales smoothly.
Being slightly underwater therefore costs you considerably less than being badly underwater, which is the main reason to act early rather than wait.
The protocol also takes a cut of that bonus as a **liquidation fee**. That fee comes out of the liquidator's bonus, not out of an extra charge to you. The maximum bonus, the fee, and the health-factor points that govern the interpolation are all published in [Lending Market Parameters](/etherfi/products/borrow/lending-market-parameters).
### Very small leftovers are closed out
If a partial liquidation would leave only a trivial amount of collateral or debt in a position, the protocol closes out that asset's position instead of leaving the remainder. Otherwise balances too small to be worth liquidating would sit there permanently as bad debt. The cutoff is a fixed constant in the protocol (`DUST_LIQUIDATION_THRESHOLD`), not a per-asset setting.
## Situations and outcomes
| Situation | What happens |
| -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| You try to borrow more than your Product LTV allows | The borrow is rejected before it reaches the chain. |
| Your debt rises above your Product LTV limit after prices move | New borrowing is blocked until you are back under it. Nothing is liquidated, because liquidation is measured against the higher collateral factor. |
| You try to withdraw collateral your debt still needs | The withdrawal is limited to what keeps you inside your Product LTV, so it may be capped or rejected. |
| Interest accrues and pushes your health factor below 1.00 | You become liquidatable. No warning transaction happens on-chain; the position simply becomes eligible. |
| Your collateral falls in price | Borrowing power falls and health factor falls. A large enough fall makes you liquidatable. |
| You are liquidated | Part of your debt is repaid by a liquidator, who takes collateral plus a bonus. You keep the rest, at a health factor above the target. |
| A price feed cannot produce a trustworthy price | Borrows and liquidations against that asset revert rather than acting on a bad number. See [Price Feeds](/etherfi/products/borrow/price-feeds). |
## What you can do about it
Two actions raise your health factor, and both are available at any time:
1. **Repay some debt.** This lowers the denominator and is the most direct fix.
2. **Add collateral.** This raises both your borrowing power and your health factor.
Withdrawing collateral or borrowing more will lower it. A liquidation is open to anyone the moment your health factor is below 1.00, and the protocol does not grant a grace period before that happens.
## Further reading
* [Technical Documentation](/etherfi/products/borrow/technical-documentation), how borrowing and lending works
* [Lending Market Parameters](/etherfi/products/borrow/lending-market-parameters), collateral factors and liquidation settings per asset
* [Price Feeds](/etherfi/products/borrow/price-feeds), how your collateral gets valued
# Lending Market Parameters
Overview of contracts and asset configuration
## Supported assets and parameters
{% hint style="warning" %}
The following Optimism Lending Protocol parameters were last updated on August 27, 2026. Market parameters, rates, caps, and borrowable assets can change. The app is the source of truth for your current Product LTV, health factor, and available-to-borrow amount.
{% endhint %}
For each asset there are a few parameters defined in the Lending Protocol spoke:
* Collateral factor (CF): The percentage of an asset's value used to calculate health factor and determine whether a position can be liquidated
* Max liquidation bonus: The cap on the discount a liquidator receives when claiming collateral
* Liquidation fee: The protocol's cut of the liquidation bonus
* Collateral risk: A per-asset score that reflects how risky an asset is to lend against and increases the interest premium
Product LTV is the app-enforced limit used to calculate borrowing power. The Product LTV values are more conservative than the Aave market collateral factor (CF). See [Borrowing Power, Health Factor, and Liquidation](/etherfi/products/borrow/borrowing-power-and-liquidation).
| Asset | Product LTV | CF | Max liq. bonus | Liq. fee | Collateral risk | Borrowable |
| ------------- | ----------: | --: | -------------: | -------: | --------------: | ---------- |
| USDC | 81% | 90% | 5% | 10% | 0 bps | yes |
| USDT | 81% | 90% | 5% | 10% | 0 bps | no |
| EURC | 81% | 90% | 7.5% | 10% | 0 bps | no |
| frxUSD | 81% | 90% | 7.5% | 10% | 0 bps | no |
| weETH | 55% | 75% | 10% | 10% | 0 bps | no |
| WETH | 55% | 75% | 10% | 10% | 0 bps | yes |
| eBTC | 52% | 72% | 12.5% | 10% | 0 bps | no |
| ETHFI | 20% | 40% | 15% | 10% | 0 bps | no |
| sETHFI | 20% | 40% | 20% | 10% | 0 bps | no |
| OP | 20% | 40% | 15% | 10% | 0 bps | no |
| WHYPE | 45% | 65% | 12.5% | 10% | 0 bps | no |
| beHYPE | 40% | 60% | 15% | 10% | 0 bps | no |
| liquidETH | 50% | 70% | 15% | 10% | 0 bps | no |
| liquidBTC | 50% | 70% | 15% | 10% | 0 bps | no |
| liquidUSD | 80% | 90% | 10% | 7.5% | 0 bps | no |
| liquidReserve | 80% | 90% | 10% | 7.5% | 0 bps | no |
| liquidEUR | 80% | 90% | 12.5% | 7.5% | 0 bps | no |
| liquidRWA | 75% | 90% | 12.5% | 7.5% | 0 bps | no |
| QQQx | 66% | 78% | 10% | 10% | 0 bps | no |
| SPYx | 67% | 78% | 10% | 10% | 0 bps | no |
| PAXG | 68% | 80% | 10% | 10% | 0 bps | no |
| TBLLx | 70% | 80% | 10% | 10% | 0 bps | no |
eUSD is being wound down as a lending market asset. It no longer counts as collateral and no new supplies are accepted. Existing balances can still be withdrawn.
### Interest curves
The interest rate curve is two straight lines with fixed slopes, the interest rate transitions between slopes when the market utilisation reaches the kink threshold.
| Asset | Liquidity fee | Kink | Base | slope 1 | slope 2 |
| ----- | ------------- | ---- | ----- | ------- | ------- |
| USDC | 30% | 85% | 3.00% | 1.25% | 10% |
| WETH | 30% | 85% | 1.00% | 1.50% |프로젝트로 돌아가기