Skip to content

HIP 0007: Major Versions - #1994

Open
yoshuawuyts wants to merge 1 commit into
mainfrom
major-versions-proposal
Open

yoshuawuyts wants to merge 1 commit into
mainfrom
major-versions-proposal

Conversation

@yoshuawuyts

@yoshuawuyts yoshuawuyts commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

This introduces a HIP for Hyperlight 1.0 and future major versions.

Signed-off-by: Yosh <github@yosh.is>
Copilot AI balanced review requested due to automatic review settings October 29, 2026 16:13
@yoshuawuyts yoshuawuyts changed the title add major versions HIP HIP 0007: Major Versions Oct 29, 2026
@yoshuawuyts yoshuawuyts added the A-infra Concerns infrastructure rather than core functionality label Oct 29, 2026

This comment was marked as resolved.

@jprendes jprendes left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Sounds sensible to me.

I like that we are not commiting to ABI stability.

There are some crates in hyperlight-dev/hyperlight for wich we might not want to provide the same guarantees, like hyperlight-component-util and hyperlight-common. We publish those crates, but they are not really intended for external usage.

Also, in some cases we have some #[doc(hidden)] APIs (e.g., for macros), I think we want to exclude those too (although hyrum's law probably says someone will depend on them anyway XD)


So instead we only promise API stability. If you upgrade from 1.0 to 1.1 you'll
need to recompile your guests and regenerate your snapshots, but you shouldn't
need to change any code. Guests targeting WebAssembly through `hyperlight-wasm`

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This is a little misleading: by 1.0 we will probably have hyperlight-wasm-aot produce snapshots which will need to be recompiled, so while the .wasm that your precompilation service uses will not change, the snapshot that you actually load into hyperlight-wasm to use it will need to be recompiled.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I assumed ahead of time compilation in hyperlight-wasm was optional though?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

no it's not, currently :-(

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

we could provide safe precompilaton using hl-uk :-)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

this could be useful

@jsturtevant jsturtevant left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM, One thought I had is how will we progress on the new features that are going to need a major version bump? Will that mean we have a branch for 1.x that we back port security fixes to only? and x.0 would be all new features?

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-infra Concerns infrastructure rather than core functionality

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants