feat: add support for hardware randomization (#515)

Author: erichulburd

CODEOWNERS

@@ -0,0 +1,4 @@
+crates/lib/src/qpu/experimental @erichulburd
+crates/python/src/qpu/experimental.rs @erichulburd
+crates/python/qcs_sdk/qpu/experimental @erichulburd
+crates/python/tests/qpu/experimental @erichulburd

Cargo.lock

@@ -15,7 +15,7 @@ tokio = "1.36.0"
 # `crates/python/pyproject.toml`.
 # The version must also be specified in order to publish to crates.io. Cargo enforces
 # that the specified version is the same as the version in the git repository.
-quil-rs = { version = "0.29.2", git = "https://github.com/rigetti/quil-rs", tag = "quil-py/v0.13.2" }
+quil-rs = { git = "https://github.com/rigetti/quil-rs", tag = "quil-py/v0.15.2" }
 
 # ndarray is used by the `qcs` crate, but it is also used in the `python` crate via a
 # re-export through the numpy crate. They should be updated as a pair to keep both

Cargo.toml

@@ -17,6 +17,7 @@ otel-tracing = ["tracing-config", "qcs-api-client-grpc/otel-tracing", "qcs-api-c
 libquil = ["dep:libquil-sys"]
 grpc-web = ["qcs-api-client-grpc/grpc-web"]
 tracing-opentelemetry = ["tracing-config", "qcs-api-client-grpc/tracing-opentelemetry", "qcs-api-client-openapi/tracing-opentelemetry"]
+experimental = []
 
 [dependencies]
 cached = "0.44.0"
@@ -73,3 +74,4 @@ built = "0.6.1"
 name = "compilation-and-simulation-with-libquil"
 path = "examples/libquil.rs"
 required-features = ["libquil"]
+

crates/lib/Cargo.toml

@@ -22,9 +22,16 @@ run_task = [{name = "test-flow"}]
 dependencies = ["clippy-flow"]
 
 [tasks.examples]
+dependencies = ["examples-libquil", "examples-experimental"]
+
+[tasks.examples-libquil]
 command = "cargo"
 args = ["build", "--examples", "--features", "libquil"]
 
+[tasks.examples-experimental]
+command = "cargo"
+args = ["build", "--examples", "--features", "experimental"]
+
 [tasks.deny]
 install_crate = "cargo-deny"
 command = "cargo"

crates/lib/Makefile.toml

@@ -0,0 +1,10 @@
+//! This module supports experimental features that meet the following criteria:
+//!
+//! * They support recent and compelling research in quantum computing.
+//! * Implementation is specific to Rigetti's QPUs; implementation may
+//!   not othewrise be expressed through a generalized quantum computing
+//!   language, such as Quil or QASM.
+//!
+//! As such, the features contained herein should be considered unstable, possibly
+//! ephemeral, and subject to specific authorization checks.
+pub mod random;