🚧 Start preimage-oracle crate

crates/preimage/Cargo.toml

@@ -0,0 +1,21 @@
+[package]
+name = "preimage-oracle"
+description = "Bindings for interacting as a client or server over the Pre-image Oracle ABI"
+edition = "2021"
+
+version.workspace = true
+authors.workspace = true
+
+[dependencies]
+alloy-primitives = "0.3.3"
+once_cell = "1.18.0"
+serde = { version = "1.0.188", features = ["derive"] }
+serde_json = "1.0.106"
+tokio = { version = "1.32.0", features = ["full"] }
+
+# misc
+anyhow = "1.0.75"
+tracing = "0.1.37"
+
+[features]
+tracing = []

crates/preimage/README.md

@@ -0,0 +1,11 @@
+# `preimage-oracle`
+
+The `preimage-oracle` crate offers bindings to interact as client or sever over the Pre-image Oracle ABI.
+
+Read more about the Preimage Oracle in the OP Stack [specs][specs].
+
+See the OP Stack's [op-program][op-program] and [Cannon client examples](../../example) for client-side usage.
+See [`mipsevm`](../mipsevm) for server-side usage.
+
+[specs]: https://github.com/ethereum-optimism/optimism/blob/6c7f366a55febbb119aa0b02d73f008c1c909900/specs/fault-proof.md
+[op-program]: https://github.com/ethereum-optimism/optimism/tree/develop/op-program

crates/preimage/src/lib.rs

@@ -0,0 +1,13 @@
+#![doc = include_str!("../README.md")]
+#![allow(dead_code, unused_variables)]
+
+mod oracle;
+// pub use oracle::{OracleClient, OracleServer};
+
+mod traits;
+pub use traits::{Hint, Hinter, Key, Oracle};
+
+mod types;
+pub use types::{
+    HinterFn, Keccak256Key, KeyType, LocalIndexKey, OracleFn, PreimageGetter, ReadWriterPair,
+};