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

# Release Notes

> Information on DATA Foundation 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>