chore: erc-4337 infrastructure setup

Author: jackpooleyml

.editorconfig

@@ -1,7 +1,7 @@
 root = true
 
 [*]
-indent_size = 2
+indent_size = 4
 indent_style = space
 end_of_line = lf
 charset = utf-8
@@ -12,4 +12,5 @@ quote_type = double
 [*.md]
 trim_trailing_whitespace = false
 max_line_length = 80
-indent_size = 2
+indent_size = 4
+

.gitmodules

@@ -1,6 +1,9 @@
 [submodule "packages/contracts"]
 	path = packages/contracts
 	url = git@github.com:matter-labs/zksync-sso-clave-contracts.git
+[submodule "packages/erc4337-contracts"]
+	path = packages/erc4337-contracts
+	url = git@github.com:matter-labs/zksync-sso-contracts.git
 [submodule "packages/circuits"]
 	path = packages/circuits
 	url = git@github.com:Moonsong-Labs/zksync-social-login-circuit.git

packages/erc4337-contracts

@@ -0,0 +1,22 @@
+root = true
+
+[*]
+indent_size = 4
+indent_style = space
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.rs]
+indent_size = 4
+indent_style = space
+max_line_length = 100
+
+[*.toml]
+indent_size = 4
+indent_style = space
+
+[*.md]
+trim_trailing_whitespace = false
+max_line_length = 80

packages/sdk-platforms/rust/.editorconfig

@@ -0,0 +1,84 @@
+[workspace]
+members = ["crates/*"]
+resolver = "2"
+
+[workspace.package]
+version = "0.0.1"
+edition = "2024"
+rust-version = "1.90"
+license = "Apache-2.0"
+repository = "https://github.com/matter-labs/zksync-sso"
+
+[profile.release]
+opt-level = "s"   # Optimize for size instead of speed
+lto = true        # Link Time Optimization - removes dead code
+codegen-units = 1 # Single codegen unit for better optimization
+panic = "abort"   # Smaller panic handling
+strip = true      # Remove debug symbols
+
+[workspace.dependencies]
+
+# Alloy
+alloy = { version = "1.0", default-features = false, features = [
+    "rlp",
+    "serde",
+    "rpc-types",
+    "rpc-types-eth",
+    "signer-local",
+    "contract",
+    "provider-http",
+    "reqwest",
+    "network",
+    "wasm-bindgen",
+    "sol-types",
+] }
+alloy-dyn-abi = { version = "1.0", features = ["std", "eip712"] }
+alloy-signer = { version = "1.0", features = ["eip712"] }
+alloy-provider = { version = "1.0", features = ["default", "erc4337-api"] }
+
+# Serialization
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+
+# Async
+tokio = { version = "1", features = ["full"] }
+async-trait = "0.1"
+futures = "0.3"
+
+# Error handling
+eyre = "0.6"
+thiserror = "2"
+
+# Tracing/Logging
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+log = "0.4"
+# Logging for Android
+android_logger = { version = "0.15" }
+# Logging for Apple platforms
+oslog = "0.2"
+
+# Uniffi
+uniffi = { version = "0.29" }
+
+# CLI dependencies
+clap = { version = "4.5", features = ["derive", "env"] }
+
+# Web/WASM/JS dependencies
+wasm-bindgen = "0.2"
+wasm-bindgen-futures = "0.4"
+web-sys = "0.3"
+console_error_panic_hook = "0.1"
+serde-wasm-bindgen = "0.6"
+js-sys = "0.3"
+console_log = "1.0"
+
+# HTTP
+reqwest = { version = "0.12", features = ["json"] }
+url = "2.5.4"
+
+# Test utils
+wiremock = "0.6"
+tempfile = "3"
+strip-ansi-escapes = "0.2"
+libc = "0.2"

packages/sdk-platforms/rust/zksync-sso-erc4337/Cargo.toml

@@ -0,0 +1,85 @@
+# zkSync SSO ERC-4337
+
+A Rust workspace for integrating zkSync SSO with ERC-4337 account abstraction.
+
+## Workspace Structure
+
+This workspace contains the following crates:
+
+- **`zksync-sso-erc4337-core`**: Core functionality and business logic
+- **`zksync-sso-erc4337-web-ffi`**: WebAssembly FFI bindings for web applications
+- **`zksync-sso-erc4337-ffi`**: FFI bindings for mobile platforms (iOS/Android)
+- **`zksync-sso-erc4337-cli`**: Command-line interface
+
+## Dependencies
+
+- **Core**: All crates depend on the core crate for shared functionality
+- **Web FFI**: Provides WebAssembly bindings using `wasm-bindgen`
+- **FFI**: Provides mobile platform bindings using `uniffi`
+- **CLI**: Provides command-line interface using `clap`
+
+## Building
+
+To build the entire workspace:
+
+```bash
+cargo build
+```
+
+To build a specific crate:
+
+```bash
+cargo build -p zksync-sso-erc4337-core
+cargo build -p zksync-sso-erc4337-web-ffi
+cargo build -p zksync-sso-erc4337-ffi
+cargo build -p zksync-sso-erc4337-cli
+```
+
+## Testing
+
+To run tests for all crates:
+
+```bash
+cargo test
+```
+
+To run tests for a specific crate:
+
+```bash
+cargo test -p zksync-sso-erc4337-core
+```
+
+## Usage
+
+### CLI
+
+```bash
+# Initialize the client
+cargo run -p zksync-sso-erc4337-cli -- init
+
+# Show configuration
+cargo run -p zksync-sso-erc4337-cli -- config
+
+# Test connection
+cargo run -p zksync-sso-erc4337-cli -- test
+```
+
+### Core Library
+
+```rust
+use zksync_sso_erc4337_core::{ZkSyncSsoErc4337Client, ZkSyncSsoErc4337Config};
+
+let config = ZkSyncSsoErc4337Config::new(
+    "https://sepolia.era.zksync.dev".to_string(),
+    "https://bundler.example.com".to_string(),
+    "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789".to_string(),
+    "0x9406Cc6185a346906296840746125a0E44976454".to_string(),
+);
+
+let client = ZkSyncSsoErc4337Client::new(config);
+client.initialize().await?;
+```
+
+## License
+
+Licensed under the Apache License, Version 2.0.

packages/sdk-platforms/rust/zksync-sso-erc4337/README.md

@@ -0,0 +1,36 @@
+[package]
+name = "zksync-sso-erc4337-cli"
+version.workspace = true
+edition.workspace = true
+rust-version.workspace = true
+license.workspace = true
+repository.workspace = true
+description = "Command-line interface for zkSync SSO ERC-4337"
+
+[[bin]]
+name = "zksync-sso-erc4337-cli"
+path = "src/main.rs"
+
+[dependencies]
+# Core dependency
+zksync-sso-erc4337-core = { path = "../zksync-sso-erc4337-core" }
+
+# CLI framework
+clap.workspace = true
+
+# Serialization
+serde.workspace = true
+serde_json.workspace = true
+
+# Error handling
+eyre.workspace = true
+thiserror.workspace = true
+
+# Logging/Tracing
+tracing.workspace = true
+tracing-subscriber.workspace = true
+
+# Async
+tokio.workspace = true
+async-trait.workspace = true
+futures.workspace = true

packages/sdk-platforms/rust/zksync-sso-erc4337/crates/zksync-sso-erc4337-cli/Cargo.toml

@@ -0,0 +1,103 @@
+use clap::{Parser, Subcommand};
+use zksync_sso_erc4337_core::config::{
+    Config as CoreConfig, contracts::Contracts as CoreContracts,
+};
+
+#[derive(Parser)]
+#[command(name = "zksync-sso-erc4337")]
+#[command(about = "A command-line interface for zkSync SSO ERC-4337")]
+#[command(version)]
+struct Cli {
+    #[command(subcommand)]
+    command: Commands,
+
+    #[arg(short, long)]
+    verbose: bool,
+}
+
+#[derive(Subcommand)]
+enum Commands {
+    Init {
+        #[arg(long, default_value = "https://sepolia.era.zksync.dev")]
+        rpc_url: String,
+
+        #[arg(long, default_value = "https://bundler.example.com")]
+        bundler_url: String,
+
+        #[arg(
+            long,
+            default_value = "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789"
+        )]
+        entry_point_address: String,
+
+        #[arg(
+            long,
+            default_value = "0x9406Cc6185a346906296840746125a0E44976454"
+        )]
+        account_factory_address: String,
+    },
+    Config,
+    Test,
+}
+
+async fn handle_command(command: Commands) -> eyre::Result<()> {
+    match command {
+        Commands::Init {
+            rpc_url,
+            bundler_url,
+            entry_point_address,
+            account_factory_address,
+        } => {
+            let config = CoreConfig::new(
+                rpc_url,
+                bundler_url,
+                CoreContracts::from_string(
+                    entry_point_address,
+                    account_factory_address,
+                )?,
+            );
+
+            println!("Configuration: {config:?}");
+        }
+
+        Commands::Config => {
+            println!("Current configuration:");
+            println!("  RPC URL: https://sepolia.era.zksync.dev");
+            println!("  Bundler URL: https://bundler.example.com");
+            println!(
+                "  Entry Point: 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789"
+            );
+            println!(
+                "  Account Factory: 0x9406Cc6185a346906296840746125a0E44976454"
+            );
+        }
+
+        Commands::Test => {
+            let config = CoreConfig::new(
+                "https://sepolia.era.zksync.dev".to_string(),
+                "https://bundler.example.com".to_string(),
+                CoreContracts::from_string(
+                    "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789".to_string(),
+                    "0x9406Cc6185a346906296840746125a0E44976454".to_string(),
+                )?,
+            );
+
+            println!("Configuration: {config:?}");
+        }
+    }
+
+    Ok(())
+}
+
+pub async fn run_cli() -> eyre::Result<()> {
+    let cli = Cli::parse();
+
+    let log_level =
+        if cli.verbose { tracing::Level::DEBUG } else { tracing::Level::INFO };
+
+    tracing_subscriber::fmt().with_max_level(log_level).init();
+
+    handle_command(cli.command).await?;
+
+    Ok(())
+}

packages/sdk-platforms/rust/zksync-sso-erc4337/crates/zksync-sso-erc4337-cli/src/lib.rs

@@ -0,0 +1,6 @@
+use zksync_sso_erc4337_cli::run_cli;
+
+#[tokio::main]
+async fn main() -> eyre::Result<()> {
+    run_cli().await
+}