cabundle

package
v1.3.111 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 16, 2026 License: AGPL-3.0 Imports: 3 Imported by: 0

Documentation

Overview

Package cabundle pkg/wasmhv/cabundle/cabundle.go c3-vis-wasm

A Mozilla CA root bundle for the js/wasm builds: Go's js/wasm runtime has NO system cert pool (crypto/x509.SystemCertPool fails), so any TLS a wasm instance terminates itself — https through a SOCKS proxy on the page's virtual loopback, above all — would otherwise fail to verify. Verification is not optional there: the tab does TLS end-to-end to the origin precisely so the exit cannot read or MITM the stream, and skipping it hands the exit exactly that power.

Used by the desk host (pkg/wasmhv/deskhost, the shell's `curl -x`).

Index

Constants

This section is empty.

Variables

View Source
var InstallFallback = sync.OnceFunc(func() { x509.SetFallbackRoots(Pool()) })

InstallFallback makes the bundle the roots crypto/x509 falls back to when the platform has none, which under js/wasm is always. After it, a Go TLS client that names no RootCAs of its own — `skywire cli got`, for one — verifies against this bundle instead of failing every certificate. Call it on the way into such a client, not at init, for the reason Pool is lazy. It is idempotent; natively the platform verifier still wins.

View Source
var Pool = sync.OnceValue(func() *x509.CertPool {
	p := x509.NewCertPool()
	p.AppendCertsFromPEM(pem)
	return p
})

Pool parses the embedded bundle on FIRST USE, not at package init.

The bundle is 186 KB / 122 certs, and parsing it measures ~47ms, 853 KB and ~10,000 allocations under js/wasm — paid on the one thread js/wasm has, before anything the instance does, if it ran at init. It is needed only on HTTPS-through-proxy paths a session may never reach, so it is behind a sync.Once, the same shape as pkg/geoip's lazily-inflated embed.

Functions

This section is empty.

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL