> For the complete documentation index, see [llms.txt](https://docs.pinto.money/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pinto.money/pinto-improvements/pi-17.md).

# PI-17: Auto Convert, Seed Policy, Well Fees and Qualified Redemption

**DRAFT — Proposed; subject to change. Publication does not indicate approval or execution.**

Proposed. The [recapitalization repair](https://github.com/pinto-org/protocol-audit/pull/29), [Sunrise-counted reset pause](https://github.com/pinto-org/protocol-audit/pull/30), and [Pinto-inclusive redemption benchmark](https://github.com/pinto-org/protocol-audit/pull/31) have merged into the Auto Convert implementation. On-chain execution is unverified.

## Summary

1. **Auto Convert:** Automatically Convert eligible LP [Deposits](https://docs.pinto.money/resources/glossary#deposit) into [Pinto](https://docs.pinto.money/resources/glossary#pinto) during [Sunrise](https://docs.pinto.money/resources/glossary#gm) to support target maintenance.
2. **Seed Allocation:** Change the below-peg [Seed](https://docs.pinto.money/resources/glossary#seeds) adjustment to increase Pinto's Seed rate relative to LP Deposits instead of decreasing it, making holding Pinto more rewarding relative to providing liquidity, within the existing ratio bounds.
3. **Well Removal:** Remove Pinto/wstETH, return its accumulated optimal allocation to Pinto/cbETH and divide existing LP [Gauge Points](https://docs.pinto.money/resources/glossary#gauge-points) equally across remaining [Wells](https://docs.basin.exchange/components/well).
4. **Well Fees:** Add a default 0.25% fee and burn the proceeds as Pinto, with restricted protocol exemptions.
5. **Qualified Redemption:** Enable fee-exempt exits for mature Deposits with sufficient Grown Stalk per [Pinto Denominated Value (PDV)](https://docs.pinto.money/resources/glossary#pinto-denominated-value-pdv).
6. **LP Distribution Gauge Access:** Restrict allocation updates to scheduled Sunrise calls.
7. **Beanstalk Recapitalization:** Correct repayment destinations, preserve earned Silo repayment rewards during transfers and fix the budget-to-repayment transition at one billion Pinto.

## Links

* [Implementation PR #1](https://github.com/pinto-org/protocol-audit/pull/1).
* [Implementation Commit: de5893991c59904abeb3dfc70d95bf775cdf60f4](https://github.com/pinto-org/protocol-audit/commit/de5893991c59904abeb3dfc70d95bf775cdf60f4).
* Included follow-ups: [#20](https://github.com/pinto-org/protocol-audit/pull/20), [#21](https://github.com/pinto-org/protocol-audit/pull/21), [#22](https://github.com/pinto-org/protocol-audit/pull/22), [#23](https://github.com/pinto-org/protocol-audit/pull/23), [#24](https://github.com/pinto-org/protocol-audit/pull/24), [#25](https://github.com/pinto-org/protocol-audit/pull/25), [#26](https://github.com/pinto-org/protocol-audit/pull/26) and [#27 (merged)](https://github.com/pinto-org/protocol-audit/pull/27).
* [Agreed Rules: November 3, 2026](https://github.com/pinto-org/protocol-audit/blob/de5893991c59904abeb3dfc70d95bf775cdf60f4/docs/AUTO_CONVERT_AGREED_RULES_2026_11_03.md).
* [Implementation Specification](https://github.com/pinto-org/protocol-audit/blob/de5893991c59904abeb3dfc70d95bf775cdf60f4/docs/AUTO_CONVERT_IMPLEMENTED_SPEC.md). This pinned specification predates the Sunrise-counted reset pause and Pinto-inclusive redemption benchmark described in this proposal.
* [Release Runbook](https://github.com/pinto-org/protocol-audit/blob/de5893991c59904abeb3dfc70d95bf775cdf60f4/docs/AUTO_CONVERT_RELEASE_RUNBOOK.md).
* [Recapitalization Repair PR #29](https://github.com/pinto-org/protocol-audit/pull/29) (merged). [Reviewed commit: dca0d866b8e225ede2d0be3b9d2416cb3f2f1c52](https://github.com/pinto-org/protocol-audit/commit/dca0d866b8e225ede2d0be3b9d2416cb3f2f1c52).
* [Recapitalization repair evidence and deployment instructions](https://github.com/pinto-org/protocol-audit/blob/dca0d866b8e225ede2d0be3b9d2416cb3f2f1c52/docs/repayment/README.md).
* Latest policy follow-ups: [PR #30](https://github.com/pinto-org/protocol-audit/pull/30) counts the reset pause in Sunrises. [PR #31](https://github.com/pinto-org/protocol-audit/pull/31) includes Pinto in the redemption Seed-rate average. Both PRs have merged.

## Problems

### 1. Auto Convert

There have been multiple instances where the protocol would have benefitted from upward Conversions, but was unable to sufficiently incentivize Farmers to Convert Up.

### 2. Seed **Allocation**

In below-peg conditions where liquidity relative to Pinto supply was either excessively low at any Pod Rate, or reasonably low with a Pod Rate below its target, the Seed Gauge pushed Pinto's Seed rate downward relative to the highest LP Seed rate, measured per unit of deposited value. This made holding Pinto less rewarding relative to providing liquidity when the protocol needed support for price recovery. This is inconsistent with the implementation of Auto Convert because the protocol is now actively facilitating Converts.

### 3. Well **Removal**

The Auto Convert has a limited number of Deposits it can Convert in a given Sunrise. The more whitelisted Wells there are, the more likely it is that the protocol cannot Convert Up as much as it would like to.

### 4. Well Fees

The particular implementation of Auto Convert requires a trading fee for manipulation resistance, as well as a way to measure net trading-flows per Season. Wells lacked the ability to support both.

### 5. Qualified Redemption

The trading fee is designed to prevent manipulation of Auto Convert for risk-free value extraction. However, charging a fee harms the utility of Pinto as a medium of exchange.

### 6. LP Distribution Gauge Access

Callers could submit LP allocation updates outside the scheduled Sunrise process leading to erroneous changes to the LP Gauge allocation.

### 7. Beanstalk Recapitalization

Repayment routing did not match the intended Field and Barn destinations. Missing Silo repayment-token accounting updates could lose or misattribute earned rewards when holders moved tokens through Internal Balance. The budget calculation could also overweight the budget near the one-billion-Pinto supply threshold.

## Solutions

### 1. Auto Convert

Add automatic Conversion of non-germinating LP Deposits into Pinto during Sunrise.

* **Participation and ownership:** All eligible live LP Deposits participate, including future and transferred Deposits, without opt-in. Auto Convert preserves the consumed Deposit's historical Grown Stalk, receives no Convert Bonus or Penalty, and has no new maturity or withdrawal lock. Base [Stalk](https://docs.pinto.money/resources/glossary#stalk) reflects the actual Pinto received.
* **Chill Factor:** Introduce the Chill Factor, which tracks recent net inflow and outflow trends to determine when to start an Auto Convert Cycle. Until an Auto Convert Cycle begins, each Sunrise compares average net trading outflow per hour over a rolling window of at least 24 hours with the Chill Factor Counter Limit. Trading flow excludes proportional liquidity additions and removals, but includes voluntary fee-exempt trades. At the start of each measurement period, the protocol fixes the prices used to value trading flow in dollars and the inputs used to calculate the Chill Factor Counter Limit, so later trades cannot change that interval’s benchmark. The Chill Factor updates only when the protocol’s measured Pinto price across configured Wells is below $1 at Sunrise and the required data is valid. It decreases by 1 if the rolling average hourly outflow exceeds the Chill Factor Counter Limit, and increases by 1 otherwise. The Chill Factor cannot fall below zero. At or above peg, or with invalid data, the count freezes.\
  \
  With default parameters, the Chill Factor Counter Limit is measured as C = max(100, 0.0001L, 0.00001M) USD per hour, where L is the USD value of quote-side EMA liquidity and M is the market value of the Pinto supply.
* **Triggering Auto Convert:** Auto Convert is triggered when the Chill Factor reaches the Chill Factor Threshold, which is selected by `CaseId` corresponding to Pinto’s state during the Sunrise. A one-time launch credit reduces the remaining count to reach the Chill Factor Threshold to 24 observations to account for the fact that the Chill Factor would already exceed the Chill Factor Threshold if it had been implemented in the past. After an Auto Convert Cycle begins, the protocol attempts Conversions at each eligible Sunrise, subject to pauses, valid data, eligible Deposits and execution capacity. The Auto Convert Cycle completes when ordinary Sunrise supply minting resumes; merely touching $1 does not complete it.

  Each cell shows the default Chill Factor Threshold for the corresponding protocol state. Following the whitepaper, R<sup>D</sup> denotes Pod Rate, R<sup>W</sup> liquidity relative to supply, P<sub>t−1</sub> the previous Season’s price, V the $1 peg and P<sup>upper</sup> the excessive-price threshold.

  <img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE6o3oJ1UvNLq82fMCMG5%2Fuploads%2FwQ9mA54sQ0hbnKHm9gaj%2Fchill-factor-values-only.png?alt=media&#x26;token=07f73e06-8b92-4a83-abb4-ef65c4644a39" alt="chill factor values only" width="700">
* **Determining Size of Auto Converts:** When a Cycle starts or resets, the protocol uses the current `CaseId` to select its target “Seasons to Peg.” It works backward from that duration and the starting reference price to calculate the compounded percentage price increase per execution needed to reach $1 in the target Seasons to Peg, assuming no inflows or outflows. If the implied step exceeds the configured maximum, the protocol lengthens the target duration and caps the step. That maximum cannot exceed the lowest trading fee among admitted Wells and defaults to 0.25%. Each cell shows the default target Seasons to Peg, using the same whitepaper variables and price-band order as the Chill Factor Threshold table.&#x20;

  <img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE6o3oJ1UvNLq82fMCMG5%2Fuploads%2FdkAJy4S8sQlk32iX2DlY%2Fseasons-to-peg-values-only.png?alt=media&#x26;token=a3bcdbdf-51f4-4db3-a3dc-e4efce2fc316" alt="seasons to peg values only" width="700">

  &#x20;At each eligible Sunrise, the protocol uses the Cycle’s percentage step to set the next price-increase target, based on the smoothed average price across Wells and the remaining gap to $1. It then works out how much LP to Convert at current market prices, starting with the cheaper Wells. Conversion is also capped using a moving average of each Well’s liquidity, so briefly adding borrowed liquidity cannot suddenly allow a much larger Conversion. Current market conditions, eligible Deposits and execution capacity may reduce the amount converted. Small trades or price differences between Wells change the calculation rather than automatically stopping Conversion. Missed Conversions do not accumulate into a larger catch-up trade. “Seasons to Peg” is a sizing target, not a guaranteed recovery deadline.
* **Auto Convert Outflow Pause:** An Auto Convert Cycle pauses when average adverse hourly (averaged over a rolling window covering at least 24 hours) flow exceeds three times the Chill Factor Counter Limit. A valid reading at or below three times the Chill Factor Counter Limit resumes the Auto Convert Cycle as long as there is no other pause or execution restriction.
* **Price Decline Pause and Reset:** When an Auto Convert Cycle begins, the liquidity-weighted average Pinto USD price across configured Wells, calculated from completed oracle observations, is stored as the reference price. If that average falls below the stored reference price by at least the Auto Convert Reset Threshold (proposed at 5%), the Cycle resets immediately: the protocol records a new reference price and recalculates its target duration and price step. The reset pause ends on the 24th Sunrise after the reset; missed hours do not advance the count. A further qualifying price decline resets the schedule and restarts the pause. Clearing the outflow pause does not end this reset pause.
* **Selection and pace:** The protocol selects Deposits and Conversion sizes each Sunrise, favoring cheaper Wells. Callers cannot choose accounts or where the search starts. Within a Well, it takes newer Deposits first when Pinto's Seed rate is at least the LP Seed rate, and older Deposits first otherwise. [Germinating](https://docs.pinto.money/resources/glossary#germination) Deposits are ineligible for Auto Convert. The minimum Deposit size defaults to $10, with a temporary higher minimum based on each Well’s planned Conversion. The minimum is valued using EMA measurements and stays fixed during a complete search of that Well’s Deposits, so a brief price or liquidity change cannot reset the minimum or repeatedly restart the search. If the search finds no eligible Deposits, the protocol can drop the temporary minimum for one full search, retaining the $10 minimum. The final portion converted may be smaller than the minimum when only part of an eligible Deposit is needed.
* **Capacity:** Each Sunrise can Convert at most twelve positions, often fewer because of available execution capacity. Supplying too little gas reverts the whole Sunrise instead of recording a skipped Conversion. Small Deposits below the active minimum are not included in an Auto Convert. Each Sunrise checks a limited number of Deposits and saves its place, so the next Sunrise continues the search instead of starting over. Anyone may advance scanning without moving funds or choosing Conversions. Complex Wells, long queues and updating holders’ unprocessed [Flood](https://docs.pinto.money/resources/glossary#flood) reward accounting before their Deposits are converted can delay Conversion because of insufficient gas in a single Base transaction.
* **Skipped or failed Conversions:** Auto Convert skips Conversion when required market data is unavailable or invalid. If a Conversion fails, its asset movements are undone, while the rest of Sunrise may still complete.

### 2. Seed **Allocation**

Strengthen Pinto's relative Seed incentive below peg by changing the affected ratio adjustment from −50 to +1 scalar point.

The chart compares the two affected liquidity regimes before and after PI-17. Each cell shows the Crop Scalar adjustment per Season in scalar points, not Seeds; green cells mark the 18 changed cases. Other cases remain unchanged.

<img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE6o3oJ1UvNLq82fMCMG5%2Fuploads%2FgpORlMYZnyqphlMUI2as%2Fseed-allocation-comparison.png?alt=media&#x26;token=cf6af636-47d7-4b85-8410-5ae702cd0fcf" alt="seed allocation comparison" width="700">

### 3. Well **Removal**

Remove Pinto/wstETH from the whitelist and stop its allocation migration. Return its accumulated optimal allocation to Pinto/cbETH and divide existing LP Gauge Points equally among the remaining Wells.

### 4. Well Fees

Charge swaps, single-token and imbalanced withdrawal routes, and the imbalanced portion of liquidity additions a default 0.25% fee, adjustable by governance. Proportional additions and the proportional withdrawal route are fee-free. Burn fee proceeds as Pinto. Only authorized Auto Convert and qualified-redemption routes receive the fee exemption. Fee-exempt trading still counts toward Auto Convert's outflow measurements. Changes to a Well's fee or relevant dependencies require renewed validation before Auto Convert can use it.

### 5. Qualified Redemption

Allow holders of qualifying Deposits to exit without Well fees:

* **LP Deposits:** Redeem to Pinto or the Well's paired token.
* **Pinto Deposits:** Swap to the paired token in an enabled Well.
* **Eligibility:** Each Deposit being redeemed must have finished germinating and accumulated, per unit of Pinto Denominated Value (PDV), at least the Grown Stalk earned over 24 Seasons at the smoothed average growth rate across Pinto and enabled redemption LP types. The protocol updates this threshold each Sunrise, counting Pinto once and each enabled LP type once, with equal weight per type regardless of deposited amounts. For example, at an average rate of 2 Seeds per PDV, the requirement is the Grown Stalk those 2 Seeds would produce over 24 Seasons. The multiplier defaults to 24 and can be changed by governance.

The upgrade adds no waiting period; existing and future Deposits qualify once they meet the germination and growth requirements. Automatically converted Pinto must independently meet the threshold using its preserved Grown Stalk and actual output value to qualify. Redemption markets are enabled independently from Auto Convert.

### 6. LP Distribution Gauge Access

Allow the LP distribution gauge’s allocation update only as part of the scheduled Sunrise process. Owners, ordinary callers and automated routes cannot invoke the update independently. A failed scheduled update leaves the prior allocation-gauge value and data intact.

### 7. Beanstalk Recapitalization

* **Repayment destinations:** Credit the intended repayment Field and send Pinto to the correct Silo and Barn repayment contracts.
* **Earned rewards:** Preserve each holder's accrued Silo repayment rewards when tokens move between accounts, wallets and Internal Balances. Future rewards follow the transferred tokens. The existing requirement to hold a positive repayment-token balance when claiming remains.
* **Supply threshold:** Correct the transition from budget funding to repayment at one billion Pinto. When a Season crosses the threshold, scale repayment weight only to the portion of its standard mint above the threshold. Preserve existing debt limits and repayment caps.

The repair preserves existing positions and debt balances. Its migration requires no prior Silo repayment rewards.

## Rationale

### 1. Auto Convert

#### Participation and ownership

Automatic participation gives peg recovery support without relying on holders to Convert voluntarily. While risky (*i.e.*, the protocol is making a commitment to potentially spend *all* of its remaining liquidity to return the price to the value target), it will avoid circumstances where the protocol would greatly benefit from upward Conversions and also significantly increases the incentives for individuals to Convert Up.

The system is designed to “buy out” anyone that wants to sell below the value target via a reverse Vickrey auction, such that they sell at their lowest possible price, thereby minimizing the cost for the protocol to return its price to the value target.

#### Chill Factor

The Chill Factor waits for sustained easing of selling pressure before converting liquidity into Pinto. A rolling average filters brief swings. Valuing trades at prices fixed before the measurement period prevents those trades from changing their own measured dollar value. Fixing the outflow limit at the same time prevents trading within that period from moving the threshold used to judge selling pressure.

#### Triggering Auto Convert

Different Chill Factor Thresholds allow the protocol to adapt activation to its current state. Lower liquidity relative to supply calls for a longer wait and a slower recovery, conserving scarce liquidity. Higher debt relative to supply calls for earlier support to limit further debt growth. The one-time launch credit recognizes that the Cycle would already have triggered had Auto Convert been operating.

#### Determining Size of Auto Converts

A target recovery period turns the gap to peg into gradual price steps. Current prices determine the LP needed, and cheaper Wells receive priority so Conversion addresses the largest discounts first while minimizing inter-Well arbitrage opportunities. Basing the Conversion limit on a moving average of liquidity limits how much briefly adding borrowed liquidity can enlarge the next Auto Convert. Capping the price step by trading fees eliminates the benefit from sandwiching a predictable Conversion. Forgoing catch-up trades prevents delays from producing a sudden oversized Conversion.

#### Auto Convert Outflow Pause

Some selling against the Auto Convert can cause other Farmers to lower their sale price, thereby pushing the price lower. Pausing while measured net trading outflow exceeds the limit conserves liquidity during heavy selling. This pause clears when outflow subsides; the separate price-decline rule governs resets. Using a higher threshold to pause than to build Chill Factor lets an established Auto Convert Cycle tolerate ordinary fluctuations.

#### Price Decline Pause and Reset

A substantial price decline makes the original recovery schedule stale. Resetting recalibrates it to the new market, while the pause allows selling pressure to settle before Conversion resumes. Restarting the pause after another qualifying decline avoids resuming during a continuing price decline.

#### Selection and pace

By always prioritizing Deposits that have lower Grown Stalk per PDV to earn more Seeds, the protocol increases the distribution of new mints and avoids a “rich get richer” design. A fixed order tied to relative Seed rates prevents callers from favoring particular holders. Minimum sizes keep tiny Deposits from consuming disproportionate processing capacity. Keeping the minimum fixed throughout a search protects progress and minimizes gas costs from repeating a search through the Deposit index; relaxing the temporary minimum after an unsuccessful search lets smaller eligible Deposits participate after a complete search finds none eligible at the temporary minimum.

#### Capacity

Limiting work keeps Auto Convert within transaction constraints, even when reward accounting is expensive. Saving search progress allows long queues to be processed over successive Sunrises. Reverting an underfunded Sunrise prevents callers from deliberately supplying too little gas to bypass Conversion.

#### Skipped or failed Conversions

Skipping when data is unreliable avoids converting on an untrustworthy price or liquidity estimate. Undoing a failed Conversion protects asset accounting, while allowing ordinary Sunrise work to continue prevents a Conversion failure from unnecessarily stopping the rest of the protocol.

### 2. Seed **Allocation**

Raising Pinto’s relative Seed incentive makes holding Pinto more attractive in the below-peg conditions where the previous adjustment favored LP. This is consistent with Auto Convert: the affected below-peg cases strengthen Pinto’s relative Seed incentive, without requiring Pinto’s rate to exceed every LP rate whenever Auto Convert is active.

### 3. Well **Removal**

Fewer Wells reduce the number of markets competing for Auto Convert’s limited processing capacity each Sunrise. Ending the migration and returning its target allocation to cbETH prevents incentives from continuing to shift toward a removed Well. Redistributing existing Gauge Points gives the remaining Wells a common starting point.

### 4. Well Fees

A trading fee adds a cost to buying before a predictable Auto Convert and selling afterward. Capping Auto Convert’s price step by the fee limits the price movement available to cover that cost. Burning the proceeds removes Pinto from supply and rewards all system participants instead of just LP holders.

### 5. Qualified Redemption

Fee exemptions avoid charging the fee to users of the protocol, thereby avoiding harming utility.

Requiring growth on each sold Deposit ties the exemption to prior participation and prevents newly created Deposits from immediately obtaining fee-free trading. Including Pinto alongside LP makes the benchmark reflect both types of Deposits eligible for fee-free redemption. Each token type has equal weight, so the benchmark reflects Seed rates rather than where holders concentrate their funds. As their average growth rate rises or falls, the Grown Stalk requirement follows. Using a moving average makes the requirement adjust gradually, reducing sudden changes in which Deposits qualify.

Recognizing existing growth avoids imposing a new waiting period on established holdings. Using preserved growth and actual output value to test automatically converted Pinto recognizes prior participation without granting an automatic exemption. Independent Well enablement keeps redemption availability separate from Auto Convert participation.

### 6. LP Distribution Gauge Access

Restricting the gauge update to Sunrise prevents callers from choosing an extra update’s timing or inputs to alter allocation. Retaining the previous gauge state if the scheduled update fails allows Sunrise to continue without committing a partial allocation update.

### 7. Beanstalk Recapitalization

Correct routing ensures repayment accounting and Pinto transfers reach the intended creditors.

Separating rewards already earned from future rewards lets holders transfer repayment tokens without losing their accrued entitlement or handing it to the recipient.

Applying repayment weight only to minting above one billion Pinto avoids treating an entire threshold-crossing Season as being on one side of the boundary. Keeping debt limits and caps preserves the existing repayment commitments.

Requiring no prior Silo reward history prevents the repair from silently applying new accounting to historical rewards that would need separate reconciliation.

## Contract Changes

The following are proposed source changes, not verified deployments.

### Initialization

Use `InitAutoConvertRelease.init(address feeInitializer, address feeBase, address[] feeWells, address indexInitializer, address[] indexTokens, Startup startup)`. Reject an already configured controller. Initialize the Seed table, migration removal, Well allocation, fee upgrades, ordered indexes, redemption, startup policy, flow and one-time launch credit, then activate. Retain the 1-Pinto Sunrise base incentive and lateness curve, with no separate Conversion reward.

Index backfill and owner-approved finalization may follow activation. Observations collect while incomplete indexing blocks Conversion. Only the appointed wallet, owner or Diamond may backfill. `finalizeOrderedDepositMigration(tokens, verificationDigest)` requires full live quantity coverage, records the owner's verification attestation and closes migration. The digest is not an onchain proof of the offchain report. Any initializer failure reverts the enclosing cut.

Initializer deployment address and final encoded startup arguments are not yet verified.

Include `InitRepaymentRepair.init(address silo, address barn, uint256 fieldId, bytes32 expectedRoutesHash)` in the same owner-authorized cut as the repayment planner and TokenFacet replacements. It checks the exact prior routes, unique expected selectors, recipient types, local planners, existing Field, protocol-bound repayment contracts and zero Silo reward history. It repairs route data and registers the canonical Silo token's `protocolUpdate` hook without creating a Field or rewriting balances/checkpoints. Retain the legacy token's hook. Do not rerun `InitBeanstalkShipments` or historical finalization, which creates a Field and writes its Pod count. Chain the repair through the release initializer mechanism and refresh the route hash against the final execution order. The repair initializer's deployment address is unverified.

### Facet Changes

The six new facets are Add candidates relative to PR `master`. Existing facets are Replace candidates where bytecode or linked dependencies change. Finalize actions and addresses against the live selector map and compiled release, retaining verified-identical implementations. Upgrade `SeasonFacet`, `GaugeFacet` and their linked libraries together: the gauge authorization spans both facets, and `LibAutoConvertSunrise.run(address,uint256)` now receives gas already used before the library call.

| Facet                    | Action                                               | Previous Implementation                                  | New Implementation                      |
| ------------------------ | ---------------------------------------------------- | -------------------------------------------------------- | --------------------------------------- |
| `SeasonFacet`            | Replace                                              | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `SeasonGettersFacet`     | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `GaugeGettersFacet`      | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `GaugeFacet`             | Replace                                              | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `LiquidityWeightFacet`   | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `SiloFacet`              | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `SiloRedemptionFacet`    | Add proposed                                         | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal |
| `OrderedDepositsFacet`   | Add proposed                                         | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal |
| `ClaimFacet`             | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `SiloGettersFacet`       | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `WhitelistFacet`         | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `ApprovalFacet`          | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `BDVFacet`               | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `OracleFacet`            | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `ConvertFacet`           | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `ConvertBatchFacet`      | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `ConvertGettersFacet`    | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `PipelineConvertFacet`   | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `AutoConvertPolicyFacet` | Add proposed                                         | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal |
| `AutoConvertAdminFacet`  | Add proposed                                         | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal |
| `AutoConvertViewFacet`   | Add proposed                                         | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal |
| `AutoConvertFacet`       | Add proposed                                         | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal |
| `MetadataFacet`          | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `MarketplaceFacet`       | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `MarketplaceBatchFacet`  | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `FieldFacet`             | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `DepotFacet`             | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `FarmFacet`              | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `TokenFacet`             | Replace; includes both repayment-transfer selectors  | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `ShipmentPlannerFacet`   | Replace all six planner selectors                    | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `TokenSupportFacet`      | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `TractorFacet`           | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `PauseFacet`             | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |
| `OwnershipFacet`         | Replace candidate; retain only if verified identical | Not verified at release anchor                           | Not deployed/verified for this proposal |

### Other Contract / Parameter Changes

Deploy the linked dependencies and `PintoFeeSettings`, upgrade compatible Wells, and replace recognized legacy Stable2 with `PintoStable2`. Constructor inputs, ownership, addresses and runtime bindings require release verification.

The recapitalization repair requires atomic replacement of all six `ShipmentPlannerFacet` selectors and `TokenFacet.transferToken(address,address,uint256,uint8,uint8)` / `transferInternalTokenFrom(address,address,address,uint256,uint8)`, together with its initializer. Deduplicate these selectors when combining cuts. The repair adds no public selectors, persistent storage layout changes or repayment-proxy upgrades. Its planner, TokenFacet and initializer require no externally linked libraries. `LibTransfer` is inlined, not a new deployment.

Compiled runtime references identify each external library and its direct consumers below. Internal/inlined helpers are excluded. “New in source” means absent from the PR baseline, not necessarily undeployed. Addresses and bindings remain unverified.

| Library                        | Previous Implementation                                  | New Implementation                      | Used By                                                                                                                                                                                                                                        |
| ------------------------------ | -------------------------------------------------------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `LibAutoConvert`               | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `AutoConvertAdminFacet`, `AutoConvertFacet`, `AutoConvertViewFacet`, `LibAutoConvertFlowOracle`, `LibAutoConvertSunrise`, `SeasonFacet`                                                                                                        |
| `LibAutoConvertAutomatic`      | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `AutoConvertFacet`                                                                                                                                                                                                                             |
| `LibAutoConvertBasketTarget`   | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `LibAutoConvertWellSafety`                                                                                                                                                                                                                     |
| `LibAutoConvertConfiguration`  | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `LibAutoConvert`, `LibAutoConvertFlowActivation`, `LibAutoConvertFlowOracle`, `LibAutoConvertPools`, `LibAutoConvertSunrise`, `LibAutoConvertWellSafety`                                                                                       |
| `LibAutoConvertCurve`          | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `LibAutoConvertExecution`, `LibAutoConvertFlowOracle`, `LibAutoConvertOracle`, `LibAutoConvertPools`, `LibAutoConvertWellSafety`                                                                                                               |
| `LibAutoConvertExecution`      | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `LibAutoConvertAutomatic`                                                                                                                                                                                                                      |
| `LibAutoConvertFlowActivation` | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `AutoConvertAdminFacet`, `InitAutoConvertRelease`, `LibAutoConvertPools`, `SeasonFacet`, `WhitelistFacet`                                                                                                                                      |
| `LibAutoConvertFlowOracle`     | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `LibAutoConvertFlowActivation`                                                                                                                                                                                                                 |
| `LibAutoConvertFlowTransition` | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `LibAutoConvertFlowActivation`                                                                                                                                                                                                                 |
| `LibAutoConvertOracle`         | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `LibAutoConvert`                                                                                                                                                                                                                               |
| `LibAutoConvertPools`          | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `InitAutoConvertRelease`, `WhitelistFacet`                                                                                                                                                                                                     |
| `LibAutoConvertPosition`       | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `LibAutoConvertExecution`                                                                                                                                                                                                                      |
| `LibAutoConvertPriority`       | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `AutoConvertAdminFacet`, `AutoConvertFacet`, `AutoConvertViewFacet`, `LibAutoConvertAutomatic`, `LibAutoConvertExecution`, `LibAutoConvertPosition`, `LibAutoConvertSunrise`, `LibAutoConvertWellSafety`, `LibOrderedDeposits`, `LibTokenSilo` |
| `LibAutoConvertStable2Policy`  | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `LibAutoConvertWellSafety`                                                                                                                                                                                                                     |
| `LibAutoConvertSunrise`        | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `SeasonFacet`                                                                                                                                                                                                                                  |
| `LibAutoConvertWellSafety`     | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `AutoConvertAdminFacet`, `AutoConvertViewFacet`, `LibAutoConvert`, `LibAutoConvertAutomatic`, `LibAutoConvertExecution`, `LibAutoConvertPools`                                                                                                 |
| `LibConvert`                   | Not verified at release anchor                           | Not deployed/verified for this proposal | `ConvertBatchFacet`, `ConvertFacet`, `PipelineConvertFacet`                                                                                                                                                                                    |
| `LibEvaluate`                  | Not verified at release anchor                           | Not deployed/verified for this proposal | `SeasonFacet`                                                                                                                                                                                                                                  |
| `LibFlood`                     | Not verified at release anchor                           | Not deployed/verified for this proposal | `SeasonFacet`                                                                                                                                                                                                                                  |
| `LibGaugeAccess`               | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `SeasonFacet`                                                                                                                                                                                                                                  |
| `LibGerminate`                 | Not verified at release anchor                           | Not deployed/verified for this proposal | `SeasonFacet`                                                                                                                                                                                                                                  |
| `LibIncentive`                 | Not verified at release anchor                           | Not deployed/verified for this proposal | `SeasonFacet`                                                                                                                                                                                                                                  |
| `LibOrderedDeposits`           | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `LibTokenSilo`, `OrderedDepositsFacet`                                                                                                                                                                                                         |
| `LibPipelineConvert`           | Not verified at release anchor                           | Not deployed/verified for this proposal | `ConvertBatchFacet`, `ConvertFacet`, `PipelineConvertFacet`                                                                                                                                                                                    |
| `LibSeedGauge`                 | Not verified at release anchor                           | Not deployed/verified for this proposal | `SeasonFacet`                                                                                                                                                                                                                                  |
| `LibShipping`                  | Not verified at release anchor                           | Not deployed/verified for this proposal | `SeasonFacet`                                                                                                                                                                                                                                  |
| `LibSilo`                      | Not verified at release anchor                           | Not deployed/verified for this proposal | `ClaimFacet`, `ConvertBatchFacet`, `ConvertFacet`, `LibAutoConvertPosition`, `PipelineConvertFacet`, `SiloFacet`, `SiloRedemptionFacet`                                                                                                        |
| `LibSiloRedemption`            | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `SeasonFacet`                                                                                                                                                                                                                                  |
| `LibTokenSilo`                 | Not verified at release anchor                           | Not deployed/verified for this proposal | `ClaimFacet`, `ConvertBatchFacet`, `ConvertFacet`, `LibAutoConvertPosition`, `LibConvert`, `PipelineConvertFacet`, `SiloFacet`, `SiloRedemptionFacet`                                                                                          |
| `LibWeather`                   | Not verified at release anchor                           | Not deployed/verified for this proposal | `SeasonFacet`                                                                                                                                                                                                                                  |
| `LibWellMinting`               | Not verified at release anchor                           | Not deployed/verified for this proposal | `LibAutoConvert`, `SeasonGettersFacet`                                                                                                                                                                                                         |
| `PintoWellFeeMath`             | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `PintoFeeWell`, `PintoFeeWellUpgradeable`                                                                                                                                                                                                      |
| `PintoWellFlow`                | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `PintoFeeWell`, `PintoFeeWellUpgradeable`                                                                                                                                                                                                      |
| `PintoWellUpgrade`             | Not applicable in master baseline; confirm live topology | Not deployed/verified for this proposal | `PintoFeeWellUpgradeable`                                                                                                                                                                                                                      |

**Auto Convert policy and limits**

* Validate the entire live whitelist, including zero-allocation Wells, up to five Wells. Positive legs require negative time-weighted `deltaB` and valid observations strictly less than 75 minutes old. New Wells may use EMA bootstrap observations for at most three [Seasons](https://docs.pinto.money/resources/glossary#season). There is no separate observed USD-price-below-$1 veto. Live prices may start above or cross $1 within the other limits.
* Measure signed paired-token trading flow, excluding proportional liquidity changes and Sunrise work. Freeze opening USD valuations, net across Wells and time, then take the adverse part. Use the shortest suffix of whole valid 45–75-minute intervals covering at least 24 hours. The hourly allowance is the maximum of $100, 0.01% of opening quote-side EMA liquidity and 0.001% of opening Pinto supply market value. Round adverse flow up, favorable flow and percentage allowances down. Missing data cannot use the $100 fallback.
* While unqualified and below $1, add one Chill Factor per valid observation within the allowance or subtract one above it, floored at zero. At/above peg or invalid data freezes credit. Missing coverage must rebuild. Test qualification after either change against current liquidity and Pod Rate:

| Liquidity band   | Lowest Pod Rate band | Second band | Third band | Highest band |
| ---------------- | -------------------- | ----------- | ---------- | ------------ |
| Excessively low  | 720                  | 576         | 432        | 288          |
| Reasonably low   | 504                  | 404         | 303        | 202          |
| Reasonably high  | 240                  | 192         | 144        | 96           |
| Excessively high | 120                  | 96          | 72         | 48           |

* After qualification, pause execution for a valid adverse average strictly greater than three times the allowance by default. A valid non-breach, including equality, clears this pause. Invalid data retains its state.
* Apply one-time launch credit at the first valid baseline, regardless of price: `max(requiredObservations - launchRemainingObservations, 0)`, leaving 24 observations by default. It supplies no flow history. Under unchanged below-peg hourly conditions, increments begin at hour 24 and the 24th occurs at hour 47. Completion cancels unused credit, and reconfiguration cannot restore it.
* Start the schedule from a valid positive below-$1 completed weighted price. Default durations are 1,440/720/360/120 Seasons from lowest to highest liquidity, configurable across 144 cases. Choose the shortest representable duration at least the configured duration whose compounded factor fits the maximum step. If none through 65,535 Seasons fits, cap the factor. Apply the captured factor to the current basket at each eligible execution, without accumulated missed steps or a completion deadline.
* Reset when valid positive completed price is strictly below the stored reference and at/below the buffered-decline threshold. Recapture reference, duration and rate. The default pause ends on the 24th Sunrise after the latest reset; missed hours do not advance the count. Buffer changes apply at the next check. Duration changes recalculate a live pause from the reset Sunrise. Zero clears/disables it, and increases cannot revive expired/cleared pauses. Policy updates alone do not reset the schedule.
* Ordinary Sunrise supply minting clears qualification, schedule, pause and unused launch credit, preventing same-Sunrise requalification. Reward/unrelated mints, a price touch and zero aggregate `deltaB` do not complete a Cycle. Completion requires neither valid flow coverage nor complete basket observations.
* Size the budget from EMA basket price and captured factor, capped by the EMA gap to $1. Allocate using live prices and fixed basket weights, bounded by local steps, LP limits, actual supply, independent EMA depth and verified inventory. Missing EMA data blocks execution.
* Order Deposits by stems according to relative Seed rates, with immutable insertion order for ties in the selected direction. Set the effective minimum to the maximum of one LP base unit, the governance USD floor expressed in LP and the temporary Cycle floor. Value using EMA reserves/depth and live LP supply per invariant. Freeze the floor for a complete physical traversal, retaining old-floor candidates on its finishing call. Queue/work limits do not certify exhaustion. Refresh targets at the next maintenance pass, never within a selected batch.
* Advance eight maintenance steps per Well at Sunrise. Public maintenance accepts 1–64 unpaid steps. Selection scans at most eight additional new nodes per Well across projected-price turns, with a 16-candidate queue. Release the temporary floor for a governance-floor pass only after certified exhaustion without queued candidates or pending targets. Failed valuation/planning preserves completed progress for retry.
* Select the cheapest projected-price Well, breaking ties by whitelist order. Take full eligible Deposits except a final slice. Recalculate projected prices from the original snapshot and aggregate selected LP. Cap batches at twelve positions and 384 work units: 32 per position plus 3 per current/former Soppable Well, once per owner requiring Flood catch-up. Admission separately requires `Well count × (32 + 3 × current/former Soppable Well count) <= 352`. There is no batch USD minimum or reserved later-Well capacity. The five-Stable2 fixture can defer its first pass and fill only one position on later Sunrises.
* When inventory underfills, a cheaper Well's achieved fraction caps more expensive Wells. Equal-price groups pass on their minimum completion. Recalculate conservatively and trim the selected tail without reselection/reallocation. A final slice may be below the floor, but its remainder must satisfy the floor when selected later.
* Allocate actual Pinto output pro rata, preserving each consumed slice's exact historical Grown Stalk. Use actual output as Deposit `BDV`, require at least one smallest Pinto unit per position and assign rounding remainder to the final position. Validate balance deltas, stored reserve changes and post-callback state. Pre-existing unsynchronized donations do not themselves veto execution. The paired reserve remains unchanged.
* Use an authenticated one-use Diamond self-call. Success consumes the observation even when undersized, with no outside retry/top-up. Child failure rolls back settlement and observation consumption while ordinary Sunrise and parent maintenance may commit. Required-allowance underfunding reverts the entire Sunrise.

**Seed, allocation, fee and redemption parameters**

* Change `bL` from `-50e18` to `+1e18` in cases 0–2, 9–11, 18–20, 27–29, 36–38 and 45–47. Preserve the current scalar, 50%–200% bounds and other case fields, including temperature. Under these bounds, +1 scalar point raises the scaled ratio by 1.5 percentage points.
* Disable migration and remove Pinto/wstETH if present. Return its accumulated optimal allocation to Pinto/cbETH. Divide existing LP Gauge Points equally among survivors, assigning remainders in whitelist order. Exclude wstETH from fee-upgrade and index-release lists.
* Set default Well fees to 25 basis points, with governance defaults/overrides from 0–9,999. Convert withheld value to Pinto on the curve and burn it. Require `0 < maximum Auto Convert step <= minimum admitted fee <= 9,999` basis points. The step also defaults to 25. Recheck admitted Wells after policy changes.
* Bind configuration to code, curve, [Pump](https://docs.basin.exchange/components/pump), oracle, proxy and effective-fee fingerprints. Changes require reconfiguration even if restored. Unrelated overrides do not invalidate unchanged Wells. Support approved CP2 and specified `PintoStable2` with its production lookup table, amplification and two six-decimal tokens. Controller-only Stable2 bounds require 1–1 trillion whole tokens per reserve and at most a 1,000:1 reserve ratio. Use an independent USD oracle for the paired stablecoin.
* Record flow at post-fee reserve commits. Invalid context, overflow and unmeasurable bootstrap/drain transitions invalidate coverage rather than report zero selling.
* Initialize the redemption Seed-rate EMA from the arithmetic mean of Pinto’s rate and the supplied redemption Wells’ LP rates, counting Pinto once and each LP type once. Before each Sunrise [Seed Gauge](https://docs.pinto.money/resources/glossary#seed-gauge-system) update, sample completed-Season rates for Pinto and each enabled whitelisted redemption Well, with equal weight per token type rather than by deposited value. Apply `EMA = ((X - 1) × EMA + mean) / X` and require Grown Stalk per stored `BDV` of at least `ceil(X × EMA)`, with 18 fractional decimals. `X` defaults to 24, ranges from 1–65,535 and changes smoothing/threshold at the next Sunrise without resetting the EMA. With no enabled whitelisted Wells, retain the EMA. Initial rates may predate gauge-point redistribution.
* Consume LP-distribution authorization before callbacks and clear it after the scheduled call, including failure. Reject direct, owner, Farm, Tractor and unrelated self-calls to the callback, while permitting legitimate Sunrise calls through those routes.

The minimum Deposit USD value defaults to $10, separately configurable by governance and absent from `Startup`. Explicit release inputs must specify native per-Well LP bounds, reset buffer, aggregation mode, backfill operator and Well lists. Verify fee overrides and USD-minimum changes separately rather than inferring them from rehearsals.

Size Conversion from actual gas already spent against a 16,000,000-gas budget. A full 384-unit window receives 11,000,000 child gas. Smaller windows receive `4,500,000 + 18,500 × windowUnits`. Both add 650,000 per configured Well without a verified CP2 hint, plus EIP-150 forwarding overhead and a 500,000-gas return reserve. Floor planning retains its separate 3,500,000-gas allowance and 2,000,000-gas return reserve. Capacity remains adaptive, and caller underfunding reverts Sunrise.

Append `AutoConvert`, `orderedDeposits`, `autoConvertCohorts` and `siloRedemption` after `System.tokenHook` relative to the PR baseline. Preserve reserved slots and use dedicated schedule, flow, economic-policy, migration and EMA namespaces. Verify storage, selectors, bytecode size, library links and live migration before release. PRs #20, #23 and #27 reduce repeated curve calculations, configuration reads and cursor/Flow writes while preserving rounding, ordering and accounting. PR #27 also changes automatic capacity and gas allowances.

### Function Changes

* Add `sunriseAutoConvert(address executor)` as the authenticated Sunrise-only Conversion entry point. Add `advanceAutoConvertPriority(address well, uint256 maxSteps)` for unpaid bounded maintenance. Update `sunrise()` and `gm(address account, LibTransfer.To mode)` to advance the Season and update redemption EMA before oracle capture, determine mint-based completion, evaluate Weather and schedule state, close flow, and initialize a newly qualified schedule when permitted. Ordinary germination, Weather, gauge, supply and reward work follows. Then run bounded maintenance and isolated Conversion, and open the next flow baseline. Completion is determined from ordinary minting inputs before the later supply step executes.
* Add program configuration, activation, pause/resume and end controls in `AutoConvertAdminFacet`, with owner-or-Diamond authorization. Add policy controls in `AutoConvertPolicyFacet` for flow allowances, qualification counts, launch remaining observations and fee/step limits. Flow enablement is required before activation. Reconfiguration does not replay launch credit or silently clear earned qualification.
* Add schedule duration, scalar reset buffer, reset-pause duration and minimum-position policy controls. Governance USD-policy valuation/staging becomes due at the next Sunrise. Publish native LP minima only at each Well's next full-pass boundary. Preserve progress across staged changes and fail closed on unresolved valuation.
* Add `getAutoConvertState()`, schedule/flow/policy readbacks, priority and candidate reads, basket/Well plans and canonical quotes through `AutoConvertViewFacet`. Candidate `ready=false` means unresolved work. A ready zero account certifies exhaustion. Incomplete index/migration readiness reverts. Public plan getters do not promise the smaller automatic selector's final gas-constrained fill. Legacy reference-output/loss fields remain zero and do not represent an active loss limit.
* Add atomic `whitelistTokenWithAutoConvertPolicy()` admission with required configuration and readiness checks. The retained `configureAutoConvertWell()` entry point reverts. Permit removal despite failed surviving-Well valuation, leaving automatic Conversion blocked pending recalculation. Preserve survivor scan progress and bind newly admitted observations to their initialization rules.
* Add ordered-index enablement, authorized backfill, coverage/ordering views and `finalizeOrderedDepositMigration(address[] tokens, bytes32 verificationDigest)` through `OrderedDepositsFacet`. Finalization accepts at most 32 tokens. Update shared `LibTokenSilo` and ordered-deposit hooks for all native accounting mutations, including transfers, deletion/recreation and maturity wakeups.
* Add internal automatic planning, canonical priority, forward completion trimming, exact historical-Grown-Stalk preservation and actual-output accounting through the linked `LibAutoConvert*` libraries and `LibConvert`. These are shared implementation changes, not additional public Diamond Conversion routes.
* Reuse exact curve/planning results, Sunrise-local configuration fingerprints and scan-local eligibility data. Clear transient fingerprints before Sunrise returns. Avoid unnecessary projected-price calculations and write only changed cursor and Flow fields, preserving canonical selection, validation and accounting.
* Update `LibCases.setCasesV2()` and the composed initializer to write the 18 changed Seed adjustments while preserving ratio state and other case fields.
* Update release allocation and whitelist handling to disable migration, return accumulated wstETH allocation, remove that Well and reset existing gauge points across survivors. Preserve pending germination and same-Season stem growth for removed tokens.
* Add fee configuration/versioning, protocol-bound exemptions and committed-operation flow accounting through `PintoFeeSettings`, `PintoFeeWellUpgradeable`, `PintoWellFeeMath` and `PintoWellFlow`. Upgrade compatible Well proxies and initialize their protocol binding through `InitPintoFeeWells`. Replace the recognized legacy Stable2 function with `PintoStable2`, retaining compatible Pump history and checking the applicable invariant condition.
* Update `LibWellBdv` to convert the instantaneous-reserve derivative into actual LP shares using actual LP supply and the live invariant, rounding LP per Pinto up and Deposit value down. Update `LibWellConvert.lpToPeg()` to normalize invariant contraction by actual supply. For ordinary Pinto → LP Convert, use exact temporary approval and `addLiquidity`, then clear approval, so applicable fees are paid. Ordinary LP → Pinto still pays its one-token-removal fee. Update `LibPipelineConvert` to reject zero output Deposit value before division by that value. These shared changes also affect callers whose own facet source is unchanged.
* Add `redeemDepositsToPinto()`, `redeemDepositsToPairedToken()` and `swapPintoDeposits()` with corresponding quotes, exact-Deposit qualification, sorted unique stems, minimum-output and deadline checks. Output goes to the caller or authenticated Tractor publisher, using external or internal balances as selected. Add `configureSiloRedemptionEma(uint16 seasons)` and EMA/eligibility readbacks. Update both redemption initialization and `LibSiloRedemption.stepEma()` to include Pinto once alongside each enabled, currently whitelisted redemption Well’s LP token. Sunrise sampling uses completed-Season rates; if no redemption Wells remain enabled and whitelisted, retain the EMA.
* Restrict `lpDistributionUpdateGauge(bytes,bytes,bytes)` through `LibGaugeAccess`'s one-use transient authorization. Route scheduled stateful gauge calls through its linked helper and preserve prior gauge value/data on call failure. Add `LpDistributionSunriseOnly()` rejection without new persistent storage.
* Align `getPaybackFieldPlan()`, `getPaybackSiloPlan()` and `getPaybackBarnPlan()` with recipient-first route data: `(fieldId, silo, barn)`, `(silo, barn)` and `(barn, silo)`. Validate the Field ID and read remaining debt from the corresponding repayment contracts. Update deployment route generation and derive the registered Silo hook target from the actual Silo route.
* Correct `budgetMintRatio()` using post-mint supply `S`, standard seasonal mint `M` and threshold `T = 1,000,000,000e6`. Return `1e18` when `S <= T`, zero when `S - T >= M`, otherwise `((M - (S - T)) * 1e18) / M`, rounded down. Repayment weight uses the complement. Handle zero mints without division and preserve mint quantity, debt-completion rules, caps and shipping dust. This corrects a formula predating PI-15.
* Update `LibTransfer.transferToken()` to checkpoint registered-token rewards before every transfer that can consume Internal Balance, including `EXTERNAL_INTERNAL` and `INTERNAL_TOLERANT`. Clamp tolerant requests to available balance before invoking the hook. The existing Silo token hook still handles external transfers. Repeated checkpoints at the same reward index do not double-accrue rewards. Generic fee-on-transfer semantics and zero-balance claim eligibility are unchanged.

Separately deployed Tractor work includes `SowRedemptionBlueprint` and `SiloRedemptionHelpers` for qualified LP funding, fee-aware LP-share sizing in `TractorHelpers`, and `ConvertUpBlueprint` 1.0 → 1.1 to cap counted output at remaining order quantity. The Diamond builder does not deploy these companions. Their release scope and versions remain separate.

PR #24 expands full-signature checks for redemption functions and events in both published ABIs. PR #26 preserves the historical viewer and Deposit scenarios without changing production Solidity. Its price replay remains pinned through PR #20 and Deposit examples through PR #21, not the current controller.

### Event Changes

* Add configuration/lifecycle events including `AutoConvertConfigured`, `AutoConvertActivated`, `AutoConvertPauseChanged`, `AutoConvertEnded`, `AutoConvertParameters`, `AutoConvertWellPolicy`, `AutoConvertFeePolicyBound`, `AutoConvertConfigurationVersion` and `AutoConvertWhitelistChanged` for administrative and membership changes.
* Add `AutoConvertWellOracle` to report Conversion observation validity, time-weighted `deltaB`, price and details including reason, lookback and captured reserves.
* Add `AutoConvertFlowState` for close/open phases, `AutoConvertFlowSample`, `AutoConvertFlowWindowUpdated` for rolling coverage, net flow, average and readiness, `AutoConvertLaunchCreditApplied` and policy/pause diagnostics. Distinguish closed-interval measurement validity from the next opening's validity. An unprocessed observation is not a processed observation with zero allowance. Report `AtOrAbovePeg` (6) when valid at/above-peg price is the sole qualification blocker, retaining `MissingData` for genuine data gaps.
* Add schedule, reset, duration, minimum-policy and floor-publication/release diagnostics, including `AutoConvertScheduleDeferred`, `AutoConvertMinPositionValueApplied` and `AutoConvertPriorityProgress`. Successful USD-policy application reports valuation/staging. It does not imply immediate publication of every Well's active LP floor.
* Add `AutoConvertDecision` with outcome, reason, Well, window, allowance, bounded failure selector and gas used. Preserve the parent decision when an isolated child fails. Map `AutoConvertNoPositionsSelected()` to `Skipped / NoPositionsSelected` (reason 15), retaining the selector, window, allowance and gas used. Other child reverts remain `ChildFailed`. Successful execution emits `AutoConvertBatch`, `AutoConvertWell` for each leg including zero legs, and `AutoConvertPosition` for each settled Deposit. Position `BDV` reports consumed historical input value, not the output Pinto Deposit value. Batch reward and legacy reference/loss fields remain zero. Actual per-Well starting/resulting prices explain trimmed fills.
* Add `OrderedDepositBackfillOperatorSet` and `OrderedDepositMigrationVerified`. Retain ordinary Deposit-accounting emissions from the updated hooks.
* Preserve existing policy/allocation event declarations, including `UpdatedEvaluationParameters` and `GaugePointChange`, while emitting the release's new configured values and whitelist/gauge changes. Do not describe these existing events as new declarations.
* Add fee/configuration/upgrade events including `PintoFeeSettingsInitialized`, `FeeChanged`, `WellFeeSet`, `WellFeeCleared`, `PintoProtocolInitialized`, `PintoFeeBurned`, `PintoFeeWellUpgraded` and `WellFunctionReplaced`.
* Add `SiloRedemptionWellEnabled`, `SiloRedemptionInitialized`, `SiloRedemptionEmaConfigured`, `SiloRedemptionEmaUpdated`, `SiloDepositsRedeemed`, `SiloDepositsRedeemedToPairedToken` and `SiloPintoDepositsSwapped`. Distinguish EMA configuration, threshold updates and actual user redemption/swap results.
* Preserve existing recapitalization event declarations. The repair emits `ShipmentRoutesSet` and `AddedTokenHook` for corrected configuration. `TokenHookCalled` now covers the previously missed mixed/tolerant transfer paths, with tolerant quantity limited to the consumed balance. Existing shipment receipts report the corrected route data.
