Skip to content

Conversation

0xrajath
Copy link
Collaborator

@0xrajath 0xrajath commented Jul 11, 2025

Motivation:

We need to migrate the hourglass core contracts from https://github.com/Layr-Labs/hourglass-monorepo/tree/master/contracts.

This is due to the following reasons:

  • Better security posture of the core contracts repository
  • Automatic support of Zeus for contract upgrades
  • Easier maintainability along with other core contracts which will be governed by the protocol council.

Modifications:

  • TaskMailbox and interface
  • Extensive unit tests for the TaskMailbox (with appropriate Mock contracts)
  • Updated bindings (Including stale bindings from Multichain)
  • Smart contract documentation for the TaskMailbox

Result:

The Hourglass core contract migration.

@0xrajath 0xrajath self-assigned this Jul 11, 2025
@0xrajath 0xrajath added the ⌛ Hourglass Hourglass, a task-based AVS framework label Jul 11, 2025
@0xrajath 0xrajath changed the base branch from main to release-dev/hourglass July 11, 2025 15:26
@0xrajath 0xrajath marked this pull request as ready for review July 11, 2025 20:46
@0xrajath 0xrajath requested review from ypatil12 and eigenmikem July 11, 2025 20:46
@0xrajath 0xrajath requested a review from 0xClandestine July 14, 2025 14:39
@0xClandestine 0xClandestine self-requested a review July 14, 2025 20:32
@0xClandestine 0xClandestine self-requested a review July 14, 2025 22:22
Copy link
Collaborator

@ypatil12 ypatil12 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we wait to merge until after the multichain open PRs are in?

@ypatil12 ypatil12 self-requested a review July 15, 2025 15:32
@0xrajath 0xrajath merged commit 69d6546 into release-dev/hourglass Jul 15, 2025
9 checks passed
@0xrajath 0xrajath deleted the rajath/hourglass-migration branch July 15, 2025 15:45
0xrajath added a commit that referenced this pull request Jul 15, 2025
**Motivation:**

We need to migrate the hourglass core contracts from
https://github.com/Layr-Labs/hourglass-monorepo/tree/master/contracts.

This is due to the following reasons:
* Better security posture of the core contracts repository
* Automatic support of Zeus for contract upgrades
* Easier maintainability along with other core contracts which will be
governed by the protocol council.

**Modifications:**

* TaskMailbox and interface
* Extensive unit tests for the TaskMailbox (with appropriate Mock
contracts)
* Updated bindings (Including stale bindings from Multichain)
* Smart contract documentation for the TaskMailbox

**Result:**

The Hourglass core contract migration.
0xrajath added a commit that referenced this pull request Jul 15, 2025
**Motivation:**

We need to migrate the hourglass core contracts from
https://github.com/Layr-Labs/hourglass-monorepo/tree/master/contracts.

This is due to the following reasons:
* Better security posture of the core contracts repository
* Automatic support of Zeus for contract upgrades
* Easier maintainability along with other core contracts which will be
governed by the protocol council.

**Modifications:**

* TaskMailbox and interface
* Extensive unit tests for the TaskMailbox (with appropriate Mock
contracts)
* Updated bindings (Including stale bindings from Multichain)
* Smart contract documentation for the TaskMailbox

**Result:**

The Hourglass core contract migration.
0xrajath added a commit that referenced this pull request Jul 18, 2025
**Motivation:**

We need to migrate the hourglass core contracts from
https://github.com/Layr-Labs/hourglass-monorepo/tree/master/contracts.

This is due to the following reasons:
* Better security posture of the core contracts repository
* Automatic support of Zeus for contract upgrades
* Easier maintainability along with other core contracts which will be
governed by the protocol council.

**Modifications:**

* TaskMailbox and interface
* Extensive unit tests for the TaskMailbox (with appropriate Mock
contracts)
* Updated bindings (Including stale bindings from Multichain)
* Smart contract documentation for the TaskMailbox

**Result:**

The Hourglass core contract migration.
0xrajath added a commit that referenced this pull request Jul 22, 2025
**Motivation:**

We need to migrate the hourglass core contracts from
https://github.com/Layr-Labs/hourglass-monorepo/tree/master/contracts.

This is due to the following reasons:
* Better security posture of the core contracts repository
* Automatic support of Zeus for contract upgrades
* Easier maintainability along with other core contracts which will be
governed by the protocol council.

**Modifications:**

* TaskMailbox and interface
* Extensive unit tests for the TaskMailbox (with appropriate Mock
contracts)
* Updated bindings (Including stale bindings from Multichain)
* Smart contract documentation for the TaskMailbox

**Result:**

The Hourglass core contract migration.
0xrajath added a commit that referenced this pull request Jul 24, 2025
**Motivation:**

We need to migrate the hourglass core contracts from
https://github.com/Layr-Labs/hourglass-monorepo/tree/master/contracts.

This is due to the following reasons:
* Better security posture of the core contracts repository
* Automatic support of Zeus for contract upgrades
* Easier maintainability along with other core contracts which will be
governed by the protocol council.

**Modifications:**

* TaskMailbox and interface
* Extensive unit tests for the TaskMailbox (with appropriate Mock
contracts)
* Updated bindings (Including stale bindings from Multichain)
* Smart contract documentation for the TaskMailbox

**Result:**

The Hourglass core contract migration.
@0xrajath 0xrajath mentioned this pull request Jul 24, 2025
0xrajath added a commit that referenced this pull request Jul 25, 2025
**Motivation:**

We need to migrate the hourglass core contracts from
https://github.com/Layr-Labs/hourglass-monorepo/tree/master/contracts.

This is due to the following reasons:
* Better security posture of the core contracts repository
* Automatic support of Zeus for contract upgrades
* Easier maintainability along with other core contracts which will be
governed by the protocol council.

**Modifications:**

* TaskMailbox and interface
* Extensive unit tests for the TaskMailbox (with appropriate Mock
contracts)
* Updated bindings (Including stale bindings from Multichain)
* Smart contract documentation for the TaskMailbox

**Result:**

The Hourglass core contract migration.
0xrajath added a commit that referenced this pull request Jul 30, 2025
**Motivation:**

We need to migrate the hourglass core contracts from
https://github.com/Layr-Labs/hourglass-monorepo/tree/master/contracts.

This is due to the following reasons:
* Better security posture of the core contracts repository
* Automatic support of Zeus for contract upgrades
* Easier maintainability along with other core contracts which will be
governed by the protocol council.

**Modifications:**

* TaskMailbox and interface
* Extensive unit tests for the TaskMailbox (with appropriate Mock
contracts)
* Updated bindings (Including stale bindings from Multichain)
* Smart contract documentation for the TaskMailbox

**Result:**

The Hourglass core contract migration.
0xrajath added a commit that referenced this pull request Jul 30, 2025
# v1.8.0 Hourglass

The Hourglass release consists of a framework that supports the creation
of task-based AVSs. The task-based AVSs are enabled through a
`TaskMailbox` core contract deployed to all chains that support a
`CertificateVerifier`. Additionally AVSs deploy their
`TaskAVSRegistrar`. The release has 3 components:

1. Core Contracts
2. AVS Contracts
3. Offchain Infrastructure

The below release notes cover Core Contracts. For more information on
the end to end protocol, see our
[docs](https://github.com/Layr-Labs/hourglass-monorepo/blob/master/README.md)
and [core contract docs](../docs/avs/task/TaskMailbox.md).

## Release Manager

@0xrajath 

## Highlights

This hourglass release only introduces new contracts. As a result, there
are no breaking changes or deprecations.

🚀 New Features

Destination Chain Contracts
- `TaskMailbox`: A core infrastructure contract that enables task-based
AVS execution models. It provides a standardized way for AVSs to create
tasks, have operators execute them, and submit verified results
on-chain. The contract acts as a mailbox system where task creators post
tasks with fees, and operators compete to execute and submit results
with proper consensus verification.

## Changelog

- feat: no consensus config [PR
#1574](#1574)
- fix: hourglass internal review fixes [PR
#1570](#1570)
- fix: addressing pr comments [PR
#1568](#1568)
- fix: deploy script
- fix: deploy script
- fix: hourglass release upgrade semver
- fix: hourglass release upgrade semver
- docs: changelog
- fix: correct ecdsa message hash check [PR
#1563](#1563)
- fix: missing assume in fuzz test
- fix: `submitResult` certificate checks [PR
#1557](#1557)
- chore: forge fmt
- fix: certificate verifier interface changes
- feat: hourglass zeus script [PR
#1546](#1546)
- fix: mock certificate verifiers [PR
#1545](#1545)
- feat: hourglass (task-based AVS framework) [PR
#1534](#1534)

---------

Co-authored-by: Nadir Akhtar <[email protected]>
@0xrajath 0xrajath mentioned this pull request Jul 30, 2025
0xrajath added a commit that referenced this pull request Jul 30, 2025
# v1.8.0 Hourglass

The Hourglass release consists of a framework that supports the creation
of task-based AVSs. The task-based AVSs are enabled through a
`TaskMailbox` core contract deployed to all chains that support a
`CertificateVerifier`. Additionally AVSs deploy their
`TaskAVSRegistrar`. The release has 3 components:

1. Core Contracts
2. AVS Contracts
3. Offchain Infrastructure

The below release notes cover Core Contracts. For more information on
the end to end protocol, see our
[docs](https://github.com/Layr-Labs/hourglass-monorepo/blob/master/README.md)
and [core contract docs](../docs/avs/task/TaskMailbox.md).

## Release Manager

@0xrajath 

## Highlights

This hourglass release only introduces new contracts. As a result, there
are no breaking changes or deprecations.

🚀 New Features

Destination Chain Contracts
- `TaskMailbox`: A core infrastructure contract that enables task-based
AVS execution models. It provides a standardized way for AVSs to create
tasks, have operators execute them, and submit verified results
on-chain. The contract acts as a mailbox system where task creators post
tasks with fees, and operators compete to execute and submit results
with proper consensus verification.

## Changelog

- feat: no consensus config [PR
#1574](#1574)
- fix: hourglass internal review fixes [PR
#1570](#1570)
- fix: addressing pr comments [PR
#1568](#1568)
- fix: deploy script
- fix: deploy script
- fix: hourglass release upgrade semver
- fix: hourglass release upgrade semver
- docs: changelog
- fix: correct ecdsa message hash check [PR
#1563](#1563)
- fix: missing assume in fuzz test
- fix: `submitResult` certificate checks [PR
#1557](#1557)
- chore: forge fmt
- fix: certificate verifier interface changes
- feat: hourglass zeus script [PR
#1546](#1546)
- fix: mock certificate verifiers [PR
#1545](#1545)
- feat: hourglass (task-based AVS framework) [PR
#1534](#1534)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
⌛ Hourglass Hourglass, a task-based AVS framework
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants