hypermap binding cacher

.gitignore

@@ -1,4 +1,5 @@
 target
 *.swp
 .vscode
+/.idea
 .DS_Store

hyperware-wit/hypermap-cacher-sys-v1.wit

@@ -0,0 +1,162 @@
+interface binding-cacher {
+    // Metadata associated with a batch of Ethereum logs.
+    record binding-logs-metadata {
+        chain-id: string,
+        from-block: string,
+        to-block: string,
+        time-created: string,
+        created-by: string,
+        signature: string,
+    }
+
+    // Represents an item in the manifest, detailing a single log cache file.
+    record binding-manifest-item {
+        metadata: binding-logs-metadata,
+        is-empty: bool,
+        file-hash: string,
+        file-name: string,
+    }
+
+    // The main manifest structure, listing all available log cache files.
+    // WIT does not support direct map types, so a list of key-value tuples is used.
+    record binding-manifest {
+        // The key is the filename of the log cache.
+        items: list<tuple<string, binding-manifest-item>>,
+        manifest-filename: string,
+        chain-id: string,
+        protocol-version: string,
+    }
+
+    record binding-get-logs-by-range-request {
+        from-block: u64,
+        to-block: option<u64>, // If None, signifies to the latest available/relevant cached block.
+    }
+
+    variant binding-get-logs-by-range-ok-response {
+        logs(tuple<u64, string>),
+        latest(u64),
+    }
+
+    // Defines the types of requests that can be sent to the Hypermap Cacher process.
+    variant binding-cacher-request {
+        get-manifest,
+        get-log-cache-content(string),
+        get-status,
+        get-logs-by-range(binding-get-logs-by-range-request),
+        reset(option<list<string>>),
+        start-providing,
+        stop-providing,
+        set-nodes(list<string>),
+    }
+
+    // Represents the operational status of the cacher.
+    record binding-cacher-status {
+        last-cached-block: u64,
+        chain-id: string,
+        protocol-version: string,
+        next-cache-attempt-in-seconds: option<u64>,
+        manifest-filename: string,
+        log-files-count: u32,
+        our-address: string,
+        is-providing: bool,
+    }
+
+    // Defines the types of responses the Hypermap Cacher process can send.
+    variant binding-cacher-response {
+        get-manifest(option<binding-manifest>),
+        get-log-cache-content(result<option<string>, string>),
+        get-status(binding-cacher-status),
+        get-logs-by-range(result<binding-get-logs-by-range-ok-response, string>),
+        start-providing(result<string, string>),
+        stop-providing(result<string, string>),
+        set-nodes(result<string, string>),
+        reset(result<string, string>),
+        rejected,
+        is-starting,
+    }
+}
+
+interface hypermap-cacher {
+    // Metadata associated with a batch of Ethereum logs.
+    record logs-metadata {
+        chain-id: string,
+        from-block: string,
+        to-block: string,
+        time-created: string,
+        created-by: string,
+        signature: string,
+    }
+
+    // Represents an item in the manifest, detailing a single log cache file.
+    record manifest-item {
+        metadata: logs-metadata,
+        is-empty: bool,
+        file-hash: string,
+        file-name: string,
+    }
+
+    // The main manifest structure, listing all available log cache files.
+    // WIT does not support direct map types, so a list of key-value tuples is used.
+    record manifest {
+        // The key is the filename of the log cache.
+        items: list<tuple<string, manifest-item>>,
+        manifest-filename: string,
+        chain-id: string,
+        protocol-version: string,
+    }
+
+    record get-logs-by-range-request {
+        from-block: u64,
+        to-block: option<u64>, // If None, signifies to the latest available/relevant cached block.
+    }
+
+    variant get-logs-by-range-ok-response {
+        logs(tuple<u64, string>),
+        latest(u64),
+    }
+
+    // Defines the types of requests that can be sent to the Hypermap Cacher process.
+    variant cacher-request {
+        get-manifest,
+        get-log-cache-content(string),
+        get-status,
+        get-logs-by-range(get-logs-by-range-request),
+        reset(option<list<string>>),
+        start-providing,
+        stop-providing,
+        set-nodes(list<string>),
+    }
+
+    // Represents the operational status of the cacher.
+    record cacher-status {
+        last-cached-block: u64,
+        chain-id: string,
+        protocol-version: string,
+        next-cache-attempt-in-seconds: option<u64>,
+        manifest-filename: string,
+        log-files-count: u32,
+        our-address: string,
+        is-providing: bool,
+    }
+
+    // Defines the types of responses the Hypermap Cacher process can send.
+    variant cacher-response {
+        get-manifest(option<manifest>),
+        get-log-cache-content(result<option<string>, string>),
+        get-status(cacher-status),
+        get-logs-by-range(result<get-logs-by-range-ok-response, string>),
+        start-providing(result<string, string>),
+        stop-providing(result<string, string>),
+        set-nodes(result<string, string>),
+        reset(result<string, string>),
+        rejected,
+        is-starting,
+    }
+}
+
+world hypermap-cacher-sys-v1 {
+    import sign;
+    import binding-cacher;
+    import hypermap-cacher;
+    include process-v1;
+}

src/bindings.rs

@@ -0,0 +1,2 @@
+/// Hypermap binding deployment address on base
+pub const HYPERMAP_BINDING_ADDRESS: &'static str = "0x8A791620dd6260079BF849Dc5567aDC3F2FdC318";

src/hypermap.rs

@@ -25,7 +25,7 @@ use std::str::FromStr;
 
 /// hypermap deployment address on base
 pub const HYPERMAP_ADDRESS: &'static str = "0x000000000044C6B8Cb4d8f0F889a3E47664EAeda";
-/// base chain id
+
 #[cfg(not(feature = "simulation-mode"))]
 pub const HYPERMAP_CHAIN_ID: u64 = 8453; // base
 #[cfg(feature = "simulation-mode")]

src/lib.rs

@@ -30,6 +30,10 @@ wit_bindgen::generate!({
     generate_unused_types: true,
 });
 
+/// Interact with the tokenregistry contract data
+pub mod bindings;
+/// Currently nothing in here except for the contract address.
+
 /// Interact with the eth provider module.
 pub mod eth;
 /// Your process must have the [`Capability`] to message
@@ -91,6 +95,7 @@ pub mod scripting;
 pub mod hyperwallet_client;
 
 mod types;
+
 pub use types::{
     address::{Address, AddressParseError},
     capability::Capability,