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

# Release Notes

> Information on Story execution and consensus client software releases

This page provides information on the story execution and consensus client software release information. You may find execution client releases in [story-geth](https://github.com/piplabs/story-geth/releases) repo, and consensus client releases in [story](https://github.com/piplabs/story/releases) repo.

### Production releases

There are generally four types of releases:

* Major: It requires hardfork upgrade with a predefined upgrade height. Node operators need to upgrade before or on the height. The release will increase minor version number.
* Minor: It doesn't require hardfork upgrade. Node operators are required to upgrade binaries as soon as possible. The release will increase patch version number.
* Fix: It is an urgent fix. Node operators are required to upgrade binaries as soon as possible. The release will increase minor version or patch version number.
* Optional: It is an optional fix. Node operators can upgrade binaries based on needs. The release will increase patch version number.

Each release comes with a release note describing a list of new features or fixes. Released software binaries are also attached in the release note. We currently provide binaries supporting four types of systems: darwin-amd64, darwin-arm64, linux-amd64, and linux-arm64. You may also build your binaries using the commit hash in the release note.

### Release entries

Refer to the following release matrix to run nodes for Mainnet and Aeneid Testnet.

| Network | story-geth        | story            |
| ------- | ----------------- | ---------------- |
| Mainnet | v1.2.0 (Yasunari) | v1.4.2 (Terence) |
| Aeneid  | v1.2.0 (Yasunari) | v1.4.2 (Terence) |

<Update label="2025-12-12" description="Terence (Story v1.4.2)">
  ### Terence

  [Full release note](https://github.com/piplabs/story/releases/tag/v1.4.2)

  <Accordion title="Fix">
    * Security fixes
  </Accordion>
</Update>

<Update label="2025-08-08" description="Polybius (Story v1.3.3)">
  ### Polybius

  [Full release note](https://github.com/piplabs/story/releases/tag/v1.3.3)

  <Accordion title="Fix">
    * Backport the fixes for release v1.3.3 (#598)
  </Accordion>
</Update>

<Update label="2025-08-08" description="Polybius (Story v1.3.2)">
  ### Polybius

  [Full release note](https://github.com/piplabs/story/releases/tag/v1.3.2)

  <Accordion title="Fix">
    * Increases the max number of validators from 64 to 80
  </Accordion>
</Update>

<Update label="2025-07-23" description="Polybius (Story v1.3.1)">
  ### Polybius

  [Full release note](https://github.com/piplabs/story/releases/tag/v1.3.1)

  <Accordion title="Fix">
    handling residual rewards by version
  </Accordion>
</Update>

<Update label="2025-06-19" description="Cosmas (Geth v1.1.1)">
  ### Cosmas

  [Full release note](https://github.com/piplabs/story-geth/releases)

  <Accordion title="Included EIPs">
    Enables Pectra Upgrade for Mainnet
  </Accordion>
</Update>

<Update label="2025-05-20" description="Cosmas (Geth v1.1.0)">
  ### Cosmas (Testnet Only)

  [Full release note](https://github.com/piplabs/story-geth/releases)

  <Accordion title="Included EIPs">
    * EIP-7702 – Set EOA account code
    * EIP-2537 – BLS12-381 curve operations
    * EIP-7623 – Increase calldata cost
    * EIP-7685 – Execution layer requests (EIP-7685)
  </Accordion>
</Update>

<Update label="2025-05-02" description="Ovid (Story v1.2.0)">
  ### Ovid

  [Full release note](https://github.com/piplabs/story/releases/tag/v1.2.0)

  <AccordionGroup>
    <Accordion title="Features">
      * (app) change MaxBytes of block in consensus params (#529)
      * (x/evmengine) support snap sync for execution engine (#506)
      * (cli) add encryption for validator private key (#494)
      * (cli) add with-comet flag (#518)
      * (api) add withdrawal queue query (#496)
    </Accordion>

    <Accordion title="Fixes">
      * (app) disallow unexported fields in cosmos tx (#529)
      * (x/evmengine) add validation for max size of tx (#529)
      * (cli) fix validator not found error during validator creation (#515)
      * (cli) add validation for max commission change rate (#489)
      * (cli) add self-delegation validation to unjail command (#510)
      * (api) fix incorrect type conversion between integer types (#492)
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="2025-02-26" description="Homer (Geth v1.0.2)">
  ### Ovid

  [Full release note](https://github.com/piplabs/story-geth/releases/tag/v1.0.2)

  <Accordion title="Fixes">
    * \[ipgraph] prevent overflow in calculating gas of add parent (#102)
    * \[ipgraph] apply acl to function hasAncestorIp (#106)
  </Accordion>
</Update>