Skip to content

feat: add TLSNotary alpha.15 proving modes#407

Merged
Step7750 merged 6 commits into
masterfrom
feat/tlsn-alpha15-migration
Jul 13, 2026
Merged

feat: add TLSNotary alpha.15 proving modes#407
Step7750 merged 6 commits into
masterfrom
feat/tlsn-alpha15-migration

Conversation

@Step7750

@Step7750 Step7750 commented Jul 10, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • default notary requests to alpha.15 Proxy-TLS with an optional MPC override
  • adapt browser WebSockets to the new WASM IoChannel API
  • point release environments at the parallel alpha.15 notary stack

Depends on csfloat/tlsn-wasm#9 and csfloat/harpocrates#30.

Ref CSF-1648


Note

High Risk
Changes the TLSNotary proving protocol, WASM dependency, and production notary endpoints—core to attested Steam API proofs—with only MPC as an escape hatch.

Overview
Bumps the extension to 5.16.0 and upgrades @csfloat/tlsn-wasm to 0.1.0-alpha.15 via a vendored tarball until npm publish is restored.

Notary TLS/WS endpoints in dev, staging, and production now target the parallel alpha.15 notary hosts instead of the previous production notary URLs.

Proving flow is updated for the new WASM API: prover.setup and send_request use IoChannel instances over WebSockets (verifier URL is derived from the HTTP notary base via toWebSocketUrl). Proxy-TLS is the default prover mode; meta.prover_mode: 'mpc' keeps the legacy path that still opens the notary proxy WebSocket for the Steam request. Request meta gains optional prover_mode typing in NotaryProveRequest.

Adds WebSocketIoChannel plus unit tests for queued reads, EOF on close, and write-after-close behavior. Channels are closed in a finally block alongside the session.

Reviewed by Cursor Bugbot for commit d7a596c. Bugbot is set up for automated code reviews on this repo. Configure here.


Note

High Risk
Changes the TLSNotary WASM dependency, proving protocol (default Proxy-TLS), and production/staging notary endpoints—core to attested Steam API proofs—with MPC as the only legacy fallback.

Overview
Upgrades @csfloat/tlsn-wasm to 0.1.0-alpha.15 and retargets notary TLS/WS URLs: production and staging use /v15 on notary.csfloat.com; dev points at localhost:7047.

The offscreen prove path is wired to the new WASM API: prover.setup and send_request take IoChannel instances backed by a new WebSocketIoChannel (verifier URL is opened via toWebSocketUrl). Proxy-TLS is the default Prover mode; meta.prover_mode: 'mpc' keeps the legacy flow that still opens the notary proxy WebSocket for the Steam request. Request meta gains optional prover_mode typing.

Verifier and proxy channels are closed in finally alongside the session. Unit tests cover connect failures, queued reads/EOF, and write-after-close on WebSocketIoChannel.

Reviewed by Cursor Bugbot for commit 0c2fdbc. Bugbot is set up for automated code reviews on this repo. Configure here.

Default extension proofs to Proxy-TLS while retaining explicit MPC support through an injected WebSocket I/O adapter.

Ref CSF-1648
@Step7750 Step7750 marked this pull request as draft July 10, 2026 02:46
Step7750 added 3 commits July 9, 2026 22:43
Use the shared notary load balancer and its prefix-rewriting alpha.15 route.

Ref CSF-1648
Remove the temporary vendored tarball now that the scoped npm release is available.

Ref CSF-1648
Keep package and manifest versions unchanged in the feature PR so the release process owns the version bump.

Ref CSF-1648
@Step7750 Step7750 marked this pull request as ready for review July 12, 2026 20:34
@Step7750 Step7750 requested a review from GODrums July 12, 2026 20:34

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit ef5c43f. Configure here.

Comment thread src/offscreen/io_channel.ts
Comment thread src/lib/notary/types.ts
@Step7750 Step7750 merged commit d680152 into master Jul 13, 2026
4 checks passed
@Step7750 Step7750 deleted the feat/tlsn-alpha15-migration branch July 13, 2026 18:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants