> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Nest Leverage Iteration

Execute one iteration of the pUSD leverage loop on Plume Network (chain 98866). Deposits pUSD to Nest Vault, supplies nTBILL as Morpho collateral, and borrows pUSD. Ideal for: leverage loop steps, DeFi automation, yield farming on Plume.

![Nest Leverage Iteration logo](https://cdn.b3.fun/b3os-icons/plume.svg)
Catalog action EVM Onchain wallet Gas send

Execute one iteration of the pUSD leverage loop on Plume Network (chain 98866). Deposits pUSD to Nest Vault, supplies nTBILL as Morpho collateral, and borrows pUSD. Ideal for: leverage loop steps, DeFi automation, yield farming on Plume.

**Review wallet and value movement**

This action can require a wallet connector, gas, token movement, or an external side effect. Test with simulation or a controlled amount before using it in a live workflow.

## At a Glance

| Field | Value |
| --- | --- |
| Action ID | `nest-leverage-iteration` |
| Category | EVM Onchain |
| Connector | `wallet` |
| Requires gas | Yes |
| Funds movement | `send` |
| Tags | `defi`, `plume`, `leverage`, `lending`, `borrowing`, `vault`, `morpho`, `onchain`, `write`, `yield` |

## Payload Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `depositAmountWei` | `string` | Yes | Exact amount of pUSD to deposit in wei. Passed via workflow storage between iterations. |
| `minAmountWei` | `string` | Yes | Minimum amount threshold in wei. If deposit/borrow is below this, the iteration is a noop. |
| `targetLtvWad` | `string` | Yes | Target LTV in WAD scale. From precheck output. |

## Result Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `action` | `string` | Yes | Whether the iteration executed all transactions \(executed\), deposited and supplied but borrow was too small \(partial\), or did nothing \(noop\). |
| `depositedAmount` | `string` | No | Amount of pUSD deposited to Nest vault \(wei\). |
| `nrwaReceived` | `string` | No | Amount of nTBILL received from Nest vault \(wei\). |
| `borrowedAmount` | `string` | Yes | Amount of pUSD borrowed from Morpho \(wei\). |
| `reason` | `string` | No | Reason for noop if action is noop. |
| `transactions` | `object` | No | Transaction hashes for each step. |

## Examples

**Workflow node**

```json
{
  "type": "nest-leverage-iteration",
  "payload": {
    "depositAmountWei": "1000000",
    "minAmountWei": "1000000",
    "targetLtvWad": "example-targetLtvWad"
  },
  "children": [],
  "connector": {
    "type": "wallet",
    "id": "conn_wallet"
  }
}
```
  **Test with API**

```bash
curl -X POST "https://api.b3os.org/v1/actions/nest-leverage-iteration/test" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "inputs": {
    "depositAmountWei": "1000000",
    "minAmountWei": "1000000",
    "targetLtvWad": "example-targetLtvWad"
  }
}'
```

**Use expressions for dynamic values**

Payload fields can use workflow expressions such as `{{$trigger.body.amount}}`, `{{$nodes.fetch.result.price}}`, and `{{$props.asset}}` when the value should come from a trigger, prior node, or reusable workflow prop.