Skip to content

Commit

Permalink
feat: add 6 second block CIP draft
Browse files Browse the repository at this point in the history
  • Loading branch information
jcstein committed Oct 10, 2024
1 parent f03b41f commit eb058c0
Show file tree
Hide file tree
Showing 3 changed files with 62 additions and 0 deletions.
1 change: 1 addition & 0 deletions cips/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@ Read [CIP-1](./cip-1.md) for information on the CIP process.
| [23](./cip-23.md) | Coordinated prevote times | Callum Waters ([@cmwaters](https://github.com/cmwaters)) |
| [24](./cip-24.md) | Versioned Gas Scheduler Variable | Nina Barbakadze ([@ninabarbakadze](https://github.com/ninabarbakadze)) |
| [25](./cip-25.md) | Ginger Network Upgrade | Josh Stein ([@jcstein](https://github.com/jcstein)), Nina Barbakadze ([@ninabarbakadze](https://github.com/ninabarbakadze)) |
| [6 second blocks](./cip-6-second-blocks.md) | Reduce block time to six seconds | Josh Stein ([@jcstein](https://github.com/jcstein)) |

## Contributing

Expand Down
1 change: 1 addition & 0 deletions cips/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@
- [CIP-23](./cip-23.md)
- [CIP-24](./cip-24.md)
- [CIP-25](./cip-25.md)
- [CIP-6-second-blocks](./cip-6-second-blocks.md)

- [Core Devs Call notes](./notes/README.md)
- [CDC #14](./notes/cdc-14.md)
Expand Down
60 changes: 60 additions & 0 deletions cips/cip-6-second-blocks.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
| cip | TBD |
| - | - |
| title | Reduce block time to six seconds |
| description | Proposal to reduce block time on celestia-app to 6 seconds, from 12. |
| author | Josh Stein ([@jcstein](https://github.com/jcstein)) |
| discussions-to | <https://forum.celestia.org/t/cip-decrease-block-time-to-6-seconds/1836> |
| status | Draft |
| type | Standards Track |
| category | Core |
| created | 2024-10-09 |

## Abstract

This CIP proposes to reduce the block time on celestia-app to 6 seconds, from 12. This will increase the throughput by double and and reduce the time it takes for transactions to be finalized by half.

## Motivation

The motivation for this CIP stems from a discussion in Core Devs Call 17, where it was proposed to reduce the block time to 6 seconds from 12 seconds.

## Specification

1. The block time in celestia-app MUST be reduced from 12 seconds to 6 seconds.

2. All implementations of celestia-app SHALL adjust their block production mechanisms to conform to this new 6-second block time.

3. The change in block time MUST be implemented at a specific block height, which SHALL be determined and agreed upon by the Celestia network participants.

4. Celestia nodes SHOULD update their software to accommodate this change prior to the agreed-upon block height.

5. The reduction in block time SHALL NOT affect the overall security or integrity of the Celestia network.

6. Block validators MUST ensure that their systems are capable of producing and validating blocks at this increased rate.

7. Client applications interacting with the Celestia network SHOULD be updated to account for the faster block time, particularly in areas related to transaction confirmation and block finality.

8. The implementation of this change SHOULD include appropriate testing and monitoring to ensure network stability during and after the transition.

9. Documentation and APIs related to block time and block production MUST be updated to reflect this change.

10. The network SHOULD provide a grace period for node operators and other participants to adapt to the new block time, but all participants MUST be compliant by the agreed-upon implementation block height.

## Rationale

The rationale for this change is to increase the throughput of the Celestia network by doubling the number of blocks produced per unit of time. This will reduce the time it takes for transactions to be finalized and improve the overall user experience on the network.

## Backwards Compatibility

This is a breaking network upgrade and will require all participants to update their software to accommodate the new block time. The change in block time will not be backward compatible with the existing network, and all participants MUST be compliant by the agreed-upon implementation block height.

## Test Cases

This will be tested on Arabica devnet and Mocha testnet before going live on Celestia Mainnet Beta.

## Security Considerations

The security considerations for this change are minimal, as the reduction in block time does not introduce any new security risks to the network. However, participants should be aware of the faster block time and ensure that their systems are capable of handling the increased throughput.

## Copyright

Copyright and related rights waived via [CC0](https://github.com/celestiaorg/CIPs/blob/main/LICENSE).

0 comments on commit eb058c0

Please sign in to comment.