> 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-3.md).

# PI-3: Bug Fixes and Parameter Changes

Executed on December 5, 2024 at 02:52 UTC.

## Summary <a href="#id-00ae4019-aad5-83f2-b986-018058c55d2e" id="id-00ae4019-aad5-83f2-b986-018058c55d2e"></a>

1. [**Rain**](https://docs.pinto.money/resources/glossary#rain) [**Stalk**](https://docs.pinto.money/resources/glossary#stalk) **Preservation:** Update the [Silo](https://docs.pinto.money/resources/glossary#silo) such that [Deposits](https://docs.pinto.money/resources/glossary#deposit) do not lose Rain Stalk upon transfer or [Convert](https://docs.pinto.money/resources/glossary#convert) into non-Germinating Deposits.
2. **AL2L Converts:** Re-add Anti Lambda to Lambda (AL2L) Converts.
3. [**`gm`**](https://docs.pinto.money/resources/glossary#gm) **Reward:** Update the `gm` reward to properly issue [Pinto](https://docs.pinto.money/resources/glossary#pinto) when the `gm` function is called 239 to 240 seconds late.
4. [**Flood**](https://docs.pinto.money/resources/glossary#flood) [**Pods**](https://docs.pinto.money/resources/glossary#pods)**:** Update [Soil](https://docs.pinto.money/resources/glossary#soil) issuance above peg to properly account for Pods that became [Harvestable](https://docs.pinto.money/resources/glossary#harvestable-pods) due to a Flood.
5. **Soil Issuance Above Peg:** Change the Soil issuance above peg multiplier on Pods that became Harvestable from 1.5x to 1.2x when the [Pod Rate](https://docs.pinto.money/resources/glossary#pod-rate) is Excessively Low. Stop halving above-peg Soil issuance when the Pod Rate is Reasonably High and Pinto’s price is above the excessive-price threshold. Retain the 0.5x multiplier for Excessively High Pod Rates.
6. [**Morning**](https://docs.pinto.money/resources/glossary#morning) **Auction Duration:** Extend the duration of the Morning from 5 to 10 minutes.
7. **Minimum** [**Temperature**](https://docs.pinto.money/resources/glossary#temperature)**:** Change the minimum Temperature at the beginning of the Morning from a fixed 1% to 1% of the [Maximum Temperature](https://docs.pinto.money/resources/glossary#maximum-temperature).
8. **Maximum Temperature Increases:** Reduce the Maximum Temperature increase from 3 percentage points to 2 percentage points wherever it currently increases by 3 percentage points.
9. **Excessively Low Pod Rate Threshold:** Lower the Excessively Low Pod Rate threshold from 5% to 3%.

## Links <a href="#ad2e4019-aad5-838e-a9c3-8192733e8554" id="ad2e4019-aad5-838e-a9c3-8192733e8554"></a>

* [Implementation PR](https://github.com/pinto-org/protocol/pull/4)
* Implementation Commit: [6f65b5ecbe83fe07cf48982963e0203379cfaf0e](https://github.com/pinto-org/protocol/commit/6f65b5ecbe83fe07cf48982963e0203379cfaf0e)
* [Safe Transaction](https://app.safe.global/transactions/tx?id=multisig_0x2cf82605402912C6a79078a9BBfcCf061CbfD507_0x2ca93d84049bb826b2aacf90fcd435e9e36386b9d32c9a2ab679d03e189caa18\&safe=base:0x2cf82605402912C6a79078a9BBfcCf061CbfD507)
* [Diamond Cut Transaction](https://basescan.org/tx/0xc46d5654d9f00ae082afcb9d994f24b72fccde65f534a2200e1cc3beb6a754e9)

## Problems <a href="#id-779e4019-aad5-82c9-a930-01c4a6934b51" id="id-779e4019-aad5-82c9-a930-01c4a6934b51"></a>

### 1. Rain Stalk Preservation <a href="#id-693e4019-aad5-820f-85d9-813fd4597dce" id="id-693e4019-aad5-820f-85d9-813fd4597dce"></a>

Rain Stalk is the snapshot of Stalk holdings taken each time it begins to Rain, which determines pro rata ownership of the proceeds from the Flood sale. Rain Stalk was erroneously burned upon the transfer or Convert of a Deposit.

### 2. AL2L Converts <a href="#id-25ce4019-aad5-82ee-ac77-81402a70f033" id="id-25ce4019-aad5-82ee-ac77-81402a70f033"></a>

AL2L Converts were disabled in [PI-2](https://pinto.money/pi/3//pi/2/) due to a bug where all Rain Stalk was erroneously removed as a result of an AL2L Convert while it was Raining.

### 3. `gm` Reward <a href="#id-695e4019-aad5-8304-8e6e-0198b5cf811c" id="id-695e4019-aad5-8304-8e6e-0198b5cf811c"></a>

The `gm` reward was 0 Pinto when the `gm` function was called 239 to 240 seconds after it could have been called.

### 4. Flood Pods <a href="#e64e4019-aad5-82f7-9660-812ea18e8ab8" id="e64e4019-aad5-82f7-9660-812ea18e8ab8"></a>

Soil issuance above peg is intended to be a function of the number of Pods that became Harvestable at the beginning of the [Season](https://docs.pinto.money/resources/glossary#season). Pods that became Harvestable due to a Flood were erroneously omitted from this calculation.

### 5. Soil Issuance Above Peg <a href="#id-656e4019-aad5-82b5-b3f0-01c77802372c" id="id-656e4019-aad5-82b5-b3f0-01c77802372c"></a>

Soil issuance above peg was too aggressive when the Pod Rate was Excessively Low. The 0.5x multiplier intended for Excessively High Pod Rates also applied when the Pod Rate was Reasonably High and Pinto’s price was above the excessive-price threshold. This incorrectly halved Soil issuance in those cases.

### 6. Morning Auction Duration <a href="#e51e4019-aad5-830f-8c18-0180b0919daf" id="e51e4019-aad5-830f-8c18-0180b0919daf"></a>

The previous 5 minute duration of the Morning did not give sufficient time to participants in the Morning Auction who are submitting transactions manually to participate.

### 7. Minimum Temperature <a href="#id-0e0e4019-aad5-827c-ac34-018b6f95ac6a" id="id-0e0e4019-aad5-827c-ac34-018b6f95ac6a"></a>

The minimum Temperature of 1% at the beginning of the Morning resulted in paying more interest than necessary at lower Maximum Temperatures.

### 8. Maximum Temperature Increases <a href="#id-8a7e4019-aad5-8370-b1a1-0174484737ff" id="id-8a7e4019-aad5-8370-b1a1-0174484737ff"></a>

The Maximum Temperature increased too quickly below peg, which disincentivized lending to the protocol in an efficient fashion and resulted in the protocol overpaying for loans.

### 9. Excessively Low Pod Rate Threshold <a href="#id-5b0e4019-aad5-83c0-9308-01401216c12d" id="id-5b0e4019-aad5-83c0-9308-01401216c12d"></a>

The Excessively Low Pod Rate threshold was too high.

## Solutions <a href="#id-1e9e4019-aad5-834c-b9e0-01bcfcbd1f5e" id="id-1e9e4019-aad5-834c-b9e0-01bcfcbd1f5e"></a>

### 1. Rain Stalk Preservation <a href="#a89e4019-aad5-835f-ad3e-01680aaad566" id="a89e4019-aad5-835f-ad3e-01680aaad566"></a>

* Update `LibSilo.transferStalk` such that `rainRoots` are transferred rather than burned upon a Deposit transfer.
* Update `LibSilo.burnActiveStalk` to return `deltaRainRoots`, which corresponds to the number of Rain Stalk removed when burning active Stalk.
* Add a new `LibSilo.mintRainRoots` function that restores Rain Stalk to the user that performs the Convert.
* Update `LibConvert._withdrawTokens` to return the Rain Stalk removed from the user.
* Update `LibConvert._depositTokensForConvert` to take in `deltaRainRoots`, and to call `LibSilo.mintRainRoots`, if `deltaRainRoots > 0` and the output is non-Germinating.

### 2. AL2L Converts <a href="#id-776e4019-aad5-8313-8798-01f9166b6f22" id="id-776e4019-aad5-8313-8798-01f9166b6f22"></a>

Re-add `ANTI_LAMBDA_LAMBDA` as a valid Convert type with a fix to the bug that removed all of the Rain Stalk during an AL2L Convert instead of reducing it by the appropriate number.

### 3. `gm` Reward <a href="#id-213e4019-aad5-8283-9da2-0109cc7adc82" id="id-213e4019-aad5-8283-9da2-0109cc7adc82"></a>

Update `LibIncentive.fracExp` to properly return the scaled reward when the `gm` function is 239 to 240 seconds late.

### 4. Flood Pods <a href="#id-3b4e4019-aad5-82d6-a46b-01bee7c89faa" id="id-3b4e4019-aad5-82d6-a46b-01bee7c89faa"></a>

* Add a new storage variable in the `Rain` struct, `floodHarvestablePods`.
* Update `LibFlood.handleRain` to reset `floodHarvestablePods` to 0 each Season, and `LibFlood.floodPodline` to store the actual Pods made Harvestable by the Flood.
* Update `Sun.stepSun` to always use `floodHarvestablePods` when calculating the newly Harvestable Pods when issuing Soil above peg.

### 5. Soil Issuance Above Peg <a href="#id-391e4019-aad5-82bf-bdb4-816e6fd3226b" id="id-391e4019-aad5-82bf-bdb4-816e6fd3226b"></a>

Update `soilCoefficientLow` in the `evaluationParameters` struct from `1.5e18` to `1.2e18` (*i.e.*, 1.5x -> 1.2x). Update `Sun.setSoilAbovePeg` to apply the 0.5x Soil multiplier only when the Pod Rate is Excessively High. When the Pod Rate is Reasonably High and Pinto’s price is above the excessive-price threshold, issue the unadjusted Soil quantity instead of halving it.

### 6. Morning Auction Duration <a href="#d43e4019-aad5-83f9-84a3-81ca28432646" id="d43e4019-aad5-83f9-84a3-81ca28432646"></a>

Update `delta` in `LibDibbler.morningTemperature` such that each interval during the Morning lasts 24 seconds (12 blocks) instead of 12 seconds (6 blocks), extending the length of the Morning from 5 minutes to 10 minutes.

### 7. Minimum Temperature <a href="#id-766e4019-aad5-830c-800b-01709f099e6b" id="id-766e4019-aad5-830c-800b-01709f099e6b"></a>

* Update `LibDibbler._scaleTemperature` such that there is no longer a Temperature floor (previously set to 1%).
* Update `LibDibbler.morningTemperature` such that when `delta == 0`, the function returns 1% of the Maximum Temperature.

### 8. Maximum Temperature Increases <a href="#id-425e4019-aad5-82e6-a10d-0113f483b333" id="id-425e4019-aad5-82e6-a10d-0113f483b333"></a>

* Replace `T_PLUS_3_L_MINUS_FIFTY`, `T_PLUS_3_L_PLUS_ONE` and `T_PLUS_3_L_PLUS_TWO` in `LibCases` with `T_PLUS_2_L_MINUS_FIFTY`, `T_PLUS_2_L_PLUS_ONE` and `T_PLUS_2_L_PLUS_TWO`, respectively, which decreases the absolute Maximum Temperature increases from +3 percentage points to +2 percentage points.
* Update `s.sys.casesV2` with the new case values.

### 9. Excessively Low Pod Rate Threshold <a href="#id-4e8e4019-aad5-82c5-a530-81d2ea1030cb" id="id-4e8e4019-aad5-82c5-a530-81d2ea1030cb"></a>

Update `podRateLowerBound` in the `evaluationParameters` struct from `0.05e18` (5%) to `0.03e18` (3%).

## Rationale <a href="#id-7fee4019-aad5-83e2-b776-8170d22f35b6" id="id-7fee4019-aad5-83e2-b776-8170d22f35b6"></a>

### 1. Rain Stalk Preservation <a href="#be8e4019-aad5-8317-b90c-81dad777c581" id="be8e4019-aad5-8317-b90c-81dad777c581"></a>

Preserving Rain Roots through Deposit transfers and Converts into non-Germinating Deposits preserves ownership of Flood proceeds while allowing those operations.

### 2. AL2L Converts <a href="#ccce4019-aad5-824a-82eb-017f7f401ca0" id="ccce4019-aad5-824a-82eb-017f7f401ca0"></a>

Restoring AL2L Converts with the Rain Stalk fix restores their functionality without removing all of a user’s Rain Stalk.

### 3. `gm` Reward <a href="#c37e4019-aad5-82b8-b2d7-810125716190" id="c37e4019-aad5-82b8-b2d7-810125716190"></a>

Correcting the reward calculation preserves the intended incentive to call `gm` throughout the 239-to-240-second interval.

### 4. Flood Pods <a href="#id-94de4019-aad5-83ec-a99f-011e74e623fa" id="id-94de4019-aad5-83ec-a99f-011e74e623fa"></a>

Including Pods made Harvestable by a Flood keeps above-peg Soil issuance consistent with the total number of Pods made Harvestable.

### 5. Soil Issuance Above Peg <a href="#id-2f3e4019-aad5-83c8-b747-0108dd2b895c" id="id-2f3e4019-aad5-83c8-b747-0108dd2b895c"></a>

There is no need for the protocol to so aggressively try to increase the Pod Rate when the protocol has an excessively low Pod Rate. Removing the unintended 0.5x multiplier approximately doubles Soil issuance in the affected Reasonably High Pod Rate cases, restoring the quantity calculated from newly Harvestable Pods and the Maximum Temperature. The 0.5x reduction remains in place when the Pod Rate is Excessively High, when the protocol more strongly limits new debt.

### 6. Morning Auction Duration <a href="#a3ce4019-aad5-831c-83cc-81d264d134f4" id="a3ce4019-aad5-831c-83cc-81d264d134f4"></a>

By doubling the duration of the Morning Auction – and each interval of the auction – farmers will have more opportunity to participate manually, which should generally result in the protocol having to pay lower interest rates. A longer Morning Auction has minimal downside because the protocol will still offer Soil at the Maximum Temperature for 50 minutes during each Season, which leaves ample time for farmers to participate once the Morning Auction ends.

### 7. Minimum Temperature <a href="#ffbe4019-aad5-83e0-b4db-810acc1ab850" id="ffbe4019-aad5-83e0-b4db-810acc1ab850"></a>

The hard set minimum of 1% Temperature during the Morning Auction reduced the effectiveness of the auction during periods where the Maximum Temperature was very low. In instances where the protocol has little to no outstanding debt, it is highly plausible that some farmers would be willing to lend to the protocol at less than 1%. This minimum made it such that even if farmers were willing to do so, they would be unable to, resulting in the protocol potentially overpaying to issue debt.

### 8. Maximum Temperature Increases <a href="#id-9a0e4019-aad5-8386-98fe-81282da7d843" id="id-9a0e4019-aad5-8386-98fe-81282da7d843"></a>

The protocol raised the Maximum Temperature too quickly. By changing the Maximum Temperature increases from 3 percentage points to 2 percentage points it should decrease the rate the protocol needs to pay to attract creditors without decreasing its ability to do so.

The protocol was experiencing a nearly constantly increasing Maximum Temperature, which poses a short term threat to the protocol because it creates an incentive for potential creditors to wait for a higher interest rate, and a long term threat because if the Maximum Temperature increases in perpetuity, the protocol may eventually collapse under the weight of excessive outstanding debt.

By lowering the rate at which the Maximum Temperature increases, it should create a more efficient market for Soil in the short term and give contributors more time to design a better mechanism to prevent runaway Maximum Temperature in the long run.

### 9. Excessively Low Pod Rate Threshold <a href="#id-8a9e4019-aad5-83f5-b264-81e9844501d7" id="id-8a9e4019-aad5-83f5-b264-81e9844501d7"></a>

The Excessively Low Pod Rate threshold indicates the rate below which the protocol strongly prefers to take on more debt. It is likely safer for the protocol to be slightly more conservative and set this threshold to be 3% instead of 5%.

## Contract Changes <a href="#id-95ae4019-aad5-83c7-b1b1-81fa0c4c2e26" id="id-95ae4019-aad5-83c7-b1b1-81fa0c4c2e26"></a>

### Initialization <a href="#d6ee4019-aad5-8329-927f-01e5808f4bce" id="d6ee4019-aad5-8329-927f-01e5808f4bce"></a>

Executed `InitPI3.init()` at [`0xa35c864c9154ef9fccdc037c489ee8bc30631477`](https://basescan.org/address/0xa35c864c9154ef9fccdc037c489ee8bc30631477#code). It updated `podRateLowerBound` from `0.05e18` (5%) to `0.03e18` (3%), `soilCoefficientLow` from `1.5e18` (1.5x) to `1.2e18` (1.2x), and `s.sys.casesV2` with the revised Temperature adjustments. If `lastSopSeason` equaled the current Season, it added `totalSupply / 1000` to Soil.

### Facet Changes <a href="#id-68ee4019-aad5-83f6-8e0e-813bc8fba729" id="id-68ee4019-aad5-83f6-8e0e-813bc8fba729"></a>

`ApprovalFacet`, `ConvertGettersFacet`, `ClaimFacet`, `SiloFacet`, `SiloGettersFacet` and `SeasonGettersFacet` were replaced without changes to their facet source files. Shared-library changes are described below.

| Facet                  | Action  | Previous Implementation                                                                                                      | New Implementation                                                                                                           |
| ---------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `ConvertFacet`         | Replace | [`0xf07c34e81d56ff02c01869bf1f833c07bb52bf2b`](https://basescan.org/address/0xf07c34e81d56ff02c01869bf1f833c07bb52bf2b#code) | [`0x7bab1d09727be8f0427c6dd1d503b3d4ba697d93`](https://basescan.org/address/0x7bab1d09727be8f0427c6dd1d503b3d4ba697d93#code) |
| `PipelineConvertFacet` | Replace | [`0x9d108e7f673c773ac196bde4bebc6758088d2e59`](https://basescan.org/address/0x9d108e7f673c773ac196bde4bebc6758088d2e59#code) | [`0x508320dcc2b4e9f79555bcae1478e6ce736b22ab`](https://basescan.org/address/0x508320dcc2b4e9f79555bcae1478e6ce736b22ab#code) |
| `FieldFacet`           | Add     | N/A                                                                                                                          | [`0x0ab2b647fdfaa3abffca2a10fe78eb0ded438faf`](https://basescan.org/address/0x0ab2b647fdfaa3abffca2a10fe78eb0ded438faf#code) |
| `FieldFacet`           | Replace | [`0x6430f859a3b8825d25382ebc7941fcd719635797`](https://basescan.org/address/0x6430f859a3b8825d25382ebc7941fcd719635797#code) | [`0x0ab2b647fdfaa3abffca2a10fe78eb0ded438faf`](https://basescan.org/address/0x0ab2b647fdfaa3abffca2a10fe78eb0ded438faf#code) |
| `SeasonFacet`          | Replace | [`0x269c8386be50c176f03355c7c7925356fdef9f84`](https://basescan.org/address/0x269c8386be50c176f03355c7c7925356fdef9f84#code) | [`0x6ea855d9473168f4540d4818976ea814ecbf3456`](https://basescan.org/address/0x6ea855d9473168f4540d4818976ea814ecbf3456#code) |
| `ApprovalFacet`        | Replace | [`0x540e776e8f0eac5dfa82110b827cb6cea6705669`](https://basescan.org/address/0x540e776e8f0eac5dfa82110b827cb6cea6705669#code) | [`0xa7df4372b0404cd468703451950e2af8615996b2`](https://basescan.org/address/0xa7df4372b0404cd468703451950e2af8615996b2#code) |
| `ConvertGettersFacet`  | Replace | [`0x518f109e57c872f8acec3b3e9a6ce5f5e8e80097`](https://basescan.org/address/0x518f109e57c872f8acec3b3e9a6ce5f5e8e80097#code) | [`0xb70708268fff1b6038def6f7d29a3bee037e901c`](https://basescan.org/address/0xb70708268fff1b6038def6f7d29a3bee037e901c#code) |
| `ClaimFacet`           | Replace | [`0xea0aad388e2df06f90a218ca2eda199294fbaadb`](https://basescan.org/address/0xea0aad388e2df06f90a218ca2eda199294fbaadb#code) | [`0x28bcfb5ad84dd460f2fd080dfd706105b8fc21c6`](https://basescan.org/address/0x28bcfb5ad84dd460f2fd080dfd706105b8fc21c6#code) |
| `SiloFacet`            | Replace | [`0x3235540bb01ef11e4208a9b99c2f2dd9860e721a`](https://basescan.org/address/0x3235540bb01ef11e4208a9b99c2f2dd9860e721a#code) | [`0xd2d3d44edbbc66ef90b29627dfd0a06d3ca0cad4`](https://basescan.org/address/0xd2d3d44edbbc66ef90b29627dfd0a06d3ca0cad4#code) |
| `SiloGettersFacet`     | Replace | [`0x039ec53bb37f8fe240798e3591d9439c68e72b7b`](https://basescan.org/address/0x039ec53bb37f8fe240798e3591d9439c68e72b7b#code) | [`0x6abfe707418d80a6e06b77853ed6c098b8af6711`](https://basescan.org/address/0x6abfe707418d80a6e06b77853ed6c098b8af6711#code) |
| `SeasonGettersFacet`   | Replace | [`0x8b1ba2ea90916eca3d5b0ba428a8c5909768492a`](https://basescan.org/address/0x8b1ba2ea90916eca3d5b0ba428a8c5909768492a#code) | [`0xd0813e2378a73b7cb49bd4ff6a4bf67edcea1264`](https://basescan.org/address/0xd0813e2378a73b7cb49bd4ff6a4bf67edcea1264#code) |

### Other Contract / Parameter Changes <a href="#b94e4019-aad5-828f-b3ff-8155770f5685" id="b94e4019-aad5-828f-b3ff-8155770f5685"></a>

**Externally Linked Libraries**

The table lists the external library deployments linked by the replaced facets. Where previous deployments differed by facet, the previous address is labeled with its consuming facets.

`FieldFacet`, `ApprovalFacet`, `ConvertGettersFacet` and `SiloGettersFacet` had no externally linked libraries in either implementation.

`LibPipelineConvert`, `LibTokenSilo`, `LibEvaluate`, `LibGauge`, `LibShipping`, `LibWellMinting` and `LibGerminate` were redeployed with unchanged library source files. Their new addresses do not indicate additional source changes beyond those described below.

| Library              | Previous Implementation                                                                                                                                                                                                                                                                                                         | New Implementation                                                                                                           | Used By                                                           |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| `LibConvert`         | [`0x67e19ab71b645b8b42062b2a5c8e49ef900fee9e`](https://basescan.org/address/0x67e19ab71b645b8b42062b2a5c8e49ef900fee9e#code)                                                                                                                                                                                                    | [`0xcce6631b13ee44ad9d8146241b20f10c1a803aa2`](https://basescan.org/address/0xcce6631b13ee44ad9d8146241b20f10c1a803aa2#code) | `ConvertFacet`                                                    |
| `LibPipelineConvert` | [`0x2fc411d1ed590416ec2bc398f624bf462b60ff49`](https://basescan.org/address/0x2fc411d1ed590416ec2bc398f624bf462b60ff49#code) (`ConvertFacet`); [`0x4917dcbafc47b57b9ec004424a44ccdc5834d054`](https://basescan.org/address/0x4917dcbafc47b57b9ec004424a44ccdc5834d054#code) (`PipelineConvertFacet`)                            | [`0xb387ad744cc1a80ab629eea5ca15459076719a7a`](https://basescan.org/address/0xb387ad744cc1a80ab629eea5ca15459076719a7a#code) | `ConvertFacet`, `PipelineConvertFacet`                            |
| `LibSilo`            | [`0x453c79a1c29d81b67b3be4e2b8810674f63606d8`](https://basescan.org/address/0x453c79a1c29d81b67b3be4e2b8810674f63606d8#code) (`ConvertFacet`); [`0x351ca256f86c10b01f2640f22ca379cf1e74d8e2`](https://basescan.org/address/0x351ca256f86c10b01f2640f22ca379cf1e74d8e2#code) (`PipelineConvertFacet`, `ClaimFacet`, `SiloFacet`) | [`0x5a686e6024d1d40994ae99979ceb63bf67724b04`](https://basescan.org/address/0x5a686e6024d1d40994ae99979ceb63bf67724b04#code) | `ConvertFacet`, `PipelineConvertFacet`, `ClaimFacet`, `SiloFacet` |
| `LibTokenSilo`       | [`0x1915dcd16475dd25e2f5588888421cf80fc8d116`](https://basescan.org/address/0x1915dcd16475dd25e2f5588888421cf80fc8d116#code) (`ConvertFacet`); [`0xbbe1d3e7bb0b50d1999f631674efd5446881612a`](https://basescan.org/address/0xbbe1d3e7bb0b50d1999f631674efd5446881612a#code) (`PipelineConvertFacet`, `ClaimFacet`, `SiloFacet`) | [`0x0da233676f46427c31928f5f85678d6737f4ec7e`](https://basescan.org/address/0x0da233676f46427c31928f5f85678d6737f4ec7e#code) | `ConvertFacet`, `PipelineConvertFacet`, `ClaimFacet`, `SiloFacet` |
| `LibEvaluate`        | [`0x7f1770fa1b43abdbe8095295ecae37c00d4ba7f8`](https://basescan.org/address/0x7f1770fa1b43abdbe8095295ecae37c00d4ba7f8#code)                                                                                                                                                                                                    | [`0x7a7d5a8899f9d68530ef3c551b9cb5610bc9bd02`](https://basescan.org/address/0x7a7d5a8899f9d68530ef3c551b9cb5610bc9bd02#code) | `SeasonFacet`                                                     |
| `LibGauge`           | [`0xcd376159cfa7ff6c60a3b6d55e2ce75cec515669`](https://basescan.org/address/0xcd376159cfa7ff6c60a3b6d55e2ce75cec515669#code)                                                                                                                                                                                                    | [`0x6c2736cfc57c1328b7d3db611812297c9754e230`](https://basescan.org/address/0x6c2736cfc57c1328b7d3db611812297c9754e230#code) | `SeasonFacet`                                                     |
| `LibIncentive`       | [`0x86da3aba20454a441eceae9d5b960564abd0cba1`](https://basescan.org/address/0x86da3aba20454a441eceae9d5b960564abd0cba1#code)                                                                                                                                                                                                    | [`0xeb9bd84e354e68142e8e996823887edb4dfcf433`](https://basescan.org/address/0xeb9bd84e354e68142e8e996823887edb4dfcf433#code) | `SeasonFacet`                                                     |
| `LibShipping`        | [`0x2b6a87195446b28c404cd5d78351998a1e8b31f9`](https://basescan.org/address/0x2b6a87195446b28c404cd5d78351998a1e8b31f9#code)                                                                                                                                                                                                    | [`0x64d40771f9f6490afe20c135dc07ea48b8addc78`](https://basescan.org/address/0x64d40771f9f6490afe20c135dc07ea48b8addc78#code) | `SeasonFacet`                                                     |
| `LibWellMinting`     | [`0x78e2a41721b97f33e13a383d15726b1ac96c2a19`](https://basescan.org/address/0x78e2a41721b97f33e13a383d15726b1ac96c2a19#code) (`SeasonFacet`); [`0x4910f9a342c79ea50a4395477cfdb11f36a010ad`](https://basescan.org/address/0x4910f9a342c79ea50a4395477cfdb11f36a010ad#code) (`SeasonGettersFacet`)                               | [`0x7124f182847880f4961de89068b249c3299304af`](https://basescan.org/address/0x7124f182847880f4961de89068b249c3299304af#code) | `SeasonFacet`, `SeasonGettersFacet`                               |
| `LibFlood`           | [`0xd668ecc7df030202ee50f9c465db7f7da7581a48`](https://basescan.org/address/0xd668ecc7df030202ee50f9c465db7f7da7581a48#code)                                                                                                                                                                                                    | [`0xed513e167369af0119090d67b8910c02b2b468f6`](https://basescan.org/address/0xed513e167369af0119090d67b8910c02b2b468f6#code) | `SeasonFacet`                                                     |
| `LibGerminate`       | [`0x06cc9fb93b3cefa5dc6bb5f418c7358cd3ea0a85`](https://basescan.org/address/0x06cc9fb93b3cefa5dc6bb5f418c7358cd3ea0a85#code)                                                                                                                                                                                                    | [`0x384374407a64aa24d3335ff12c870debaa04c3e5`](https://basescan.org/address/0x384374407a64aa24d3335ff12c870debaa04c3e5#code) | `SeasonFacet`                                                     |

* Doubled each Morning interval from 6 to 12 Base blocks (12 to 24 seconds), extending the auction from 5 to 10 minutes.
* Changed the initial Morning Temperature from a fixed 1% to 1% of the Maximum Temperature.
* Reduced selected Maximum Temperature increases from +3 to +2 percentage points. Initialization applied the 1.5x-to-1.2x low-Pod-Rate Soil coefficient and 5%-to-3% lower Pod Rate threshold described above.

### Function Changes <a href="#id-19be4019-aad5-82ee-8ac5-016f15a6d0ad" id="id-19be4019-aad5-82ee-8ac5-016f15a6d0ad"></a>

* Updated `LibSilo.transferStalk` to transfer Rain Roots exceeding the sender’s remaining Roots to the recipient instead of burning them from the system.
* Updated `LibSilo.burnActiveStalk` to return `deltaRainRoots` in addition to `roots`. Updated `LibConvert._withdrawTokens` to return `deltaRainRoots` in addition to grown Stalk and PDV. Updated `ConvertFacet` and `PipelineConvertFacet` to pass this value through to `_depositTokensForConvert`, which calls the new internal `LibSilo.mintRainRoots` helper to restore burned Rain Roots for non-Germinating output.
* Restored `ANTI_LAMBDA_LAMBDA` dispatch in `LibConvert.convert` to `LibLambdaConvert.antiConvert`.
* Corrected the `LibIncentive.fracExp` branch cutoff from 240 to 238 seconds so the `gm` reward calculation covers 239–240 seconds.
* Updated `LibFlood.handleRain` to reset `floodHarvestablePods` to 0 each Season and `LibFlood.floodPodline` to store the actual number of Pods made Harvestable after the cap. Updated `Sun.stepSun` to include that count in above-peg Soil issuance.
* Added `FieldFacet.floodHarvestablePods()`, which returns the stored count.
* Updated `Sun.setSoilAbovePeg` to apply the 0.5x high-Pod-Rate coefficient when `caseId.mod(36) >= 27` instead of `>= 24`. This excludes cases 24–26 within each 36-case group, where the Pod Rate is Reasonably High and Pinto’s price is above the excessive-price threshold. Those cases now use the unadjusted Soil quantity instead of half that quantity.
* Updated `LibDibbler.morningTemperature` to use 12 Base blocks per interval instead of 6. Removed the fixed 1% floor in `LibDibbler._scaleTemperature`. At `delta == 0`, `morningTemperature` returns 1% of the Maximum Temperature.
* Updated `LibCases.setCasesV2` to use +2-percentage-point adjustments in the cases that previously used +3-percentage-point adjustments.

### Event Changes <a href="#id-72fe4019-aad5-825b-bba5-0136262b74f1" id="id-72fe4019-aad5-825b-bba5-0136262b74f1"></a>

Existing event signatures were unchanged. The revised calculations changed the following emitted values.

* `Incentivization` now reports the corrected `gm` reward in `beans` for calls 239–240 seconds late.
* `Soil` reports soil issuance that includes Pods made Harvestable by Floods and applies the revised low- and high-Pod-Rate multiplier rules.
* `Sow` reports `pods` calculated using the revised Morning Temperature schedule and minimum.
* `TemperatureChange` reports +2 instead of +3 in `absChange` for the revised cases.
* `TemperatureChange` and `BeanToMaxLpGpPerBdvRatioChange` report `caseId` using the 3% lower Pod Rate threshold instead of 5%. The ratio-change event remains conditional on no oracle failure.
