feat(taiko-client-rs): introduce Shasta driver rust crate (#20368)

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: 3 people

_typos.toml

@@ -11,7 +11,7 @@ extend-ignore-identifiers-re = [
   "Groth",
   "groth",
   "GROTH",
-  "J64QPL3oYpZ75230YMfbLfKcUEqlIyWW8"
+  "J64QPL3oYpZ75230YMfbLfKcUEqlIyWW8",
 ]
 
 [files]
@@ -26,6 +26,7 @@ extend-exclude = [
   "packages/protocol/audit/code4rena-2024-03-taiko-final-report.md",
   "packages/protocol/contracts/layer1/automata-attestation/**",
   "packages/protocol/deployments/**",
+  "packages/taiko-client-rs/crates/bindings/**",
   # TODO: fix typos and remove these
   "packages/taiko-client/**",
 ]

packages/taiko-client-rs/.claude/settings.json

@@ -0,0 +1,152 @@
+{
+  "env": {
+    "CLAUDE_CODE_ENABLE_TELEMETRY": "0"
+  },
+  "includeCoAuthoredBy": false,
+  "permissions": {
+    "allow": [
+      "Bash(~/.claude-code-docs/claude-docs-helper.sh:*)",
+      "Bash(awk:*)",
+      "Bash(biome:*)",
+      "Bash(bulloak:*)",
+      "Bash(bun:*)",
+      "Bash(cargo:*)",
+      "Bash(cat:*)",
+      "Bash(cd:*)",
+      "Bash(cp:*)",
+      "Bash(curl:*)",
+      "Bash(cut:*)",
+      "Bash(echo:*)",
+      "Bash(eza:*)",
+      "Bash(find:*)",
+      "Bash(fd:*)",
+      "Bash(forge:*)",
+      "Bash(gdate:*)",
+      "Bash(gh:*)",
+      "Bash(git:*)",
+      "Bash(grep:*)",
+      "Bash(head:*)",
+      "Bash(just:*)",
+      "Bash(ls:*)",
+      "Bash(lsof:*)",
+      "Bash(jq:*)",
+      "Bash(mkdir:*)",
+      "Bash(na:*)",
+      "Bash(ni:*)",
+      "Bash(nlx:*)",
+      "Bash(npm:*)",
+      "Bash(npx:*)",
+      "Bash(node:*)",
+      "Bash(nr:*)",
+      "Bash(nun:*)",
+      "Bash(pnpm:*)",
+      "Bash(prettier:*)",
+      "Bash(printf:*)",
+      "Bash(pwd:*)",
+      "Bash(qsv:*)",
+      "Bash(rg:*)",
+      "Bash(select:*)",
+      "Bash(sort:*)",
+      "Bash(tail:*)",
+      "Bash(timeout:*)",
+      "Bash(tree:*)",
+      "Bash(touch:*)",
+      "Bash(which:*)",
+      "Bash(yarn:*)",
+      "Glob",
+      "Grep",
+      "LS",
+      "Read",
+      "Task",
+      "TodoWrite",
+      "WebFetch",
+      "WebSearch",
+      "mcp__context7",
+      "mcp__github",
+      "mcp__magic",
+      "mcp__morphllm-fast-apply",
+      "mcp__playwright",
+      "mcp__sequential-thinking",
+      "mcp__serena"
+    ],
+    "deny": [
+      "Bash(> /dev/sda*)",
+      "Bash(> /etc/*)",
+      "Bash(chmod -R:*)",
+      "Bash(chown -R:*)",
+      "Bash(dd:*)",
+      "Bash(doas:*)",
+      "Bash(kill -9:*)",
+      "Bash(killall:*)",
+      "Bash(launchctl:*)",
+      "Bash(mkfs:*)",
+      "Bash(passwd:*)",
+      "Bash(reboot:*)",
+      "Bash(rm -rf /)",
+      "Bash(rm -rf ~)",
+      "Bash(rm -rf ~/)",
+      "Bash(rm -rf ~/*)",
+      "Bash(shutdown:*)",
+      "Bash(su:*)",
+      "Bash(sudo:*)",
+      "Bash(systemctl:*)",
+      "Bash(userdel:*)",
+      "Bash(usermod:*)",
+      "Read(./.env)",
+      "Read(./.env.production)"
+    ],
+    "defaultMode": "plan"
+  },
+  "hooks": {
+    "Notification": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/ccnotify/ccnotify.py Notification"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude-code-docs/claude-docs-helper.sh hook-check"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/ccnotify/ccnotify.py Stop"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/ccnotify/ccnotify.py UserPromptSubmit"
+          },
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/UserPromptSubmit/append-subagents.py"
+          }
+        ]
+      }
+    ]
+  },
+  "statusLine": {
+    "type": "command",
+    "command": "bunx -y ccstatusline@latest",
+    "padding": 0
+  }
+}

packages/taiko-client-rs/.gitignore

@@ -1,3 +1,4 @@
 target/
 **/target/
-Cargo.lock
+.bmad-core/
+.code/

packages/taiko-client-rs/AGENTS.md

@@ -0,0 +1,33 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+- `bin/client/` hosts the CLI entry point; keep orchestration light and delegate protocol logic to the crates.
+- `crates/protocol`, `crates/proposer`, `crates/driver`, `crates/event-indexer`, and `crates/rpc` cover the core services. Document shared traits whenever exposing cross-crate APIs.
+- `crates/bindings/` is generated via `just gen_bindings`; never hand-edit or reformat files under `crates/bindings/src`.
+- `tests/` contains Docker-backed integration assets run through `tests/entrypoint.sh`. Place every end-to-end scenario here and note any extra prerequisites.
+- `script/` keeps repeatable maintenance scripts; extend them instead of duplicating ad-hoc helpers.
+
+## Build, Test, and Development Commands
+- `cargo build --workspace` (add `--release` for production binaries).
+- `just fmt` installs toolchain `nightly-2025-09-27`, runs `cargo +nightly fmt`, then `cargo sort --workspace --grouped`. Use `just fmt-check` for CI parity.
+- `just clippy` maps to `cargo clippy --workspace --all-features --no-deps --exclude bindings -- -D warnings`; reserve `just clippy-fix` for mechanical cleanups.
+- `just gen_bindings` executes `script/gen_bindings.sh` to refresh contract bindings whenever ABIs change.
+
+## Coding Style & Naming Conventions
+- Target MSRV 1.88 and gate newer features with `#[cfg]` as needed.
+- Follow idiomatic Rust naming: snake_case for modules and functions, PascalCase for types, `SCREAMING_SNAKE_CASE` for constants. Prefer explicit `pub(crate)` boundaries.
+- Respect the shared `rustfmt.toml`; never bulk-format `crates/bindings/src`. Document intentional deviations with a brief comment.
+
+## Testing Guidelines
+- Run `just test` before submitting changes; it launches the Dockerized L1/L2 stack and executes `cargo nextest` across the workspace.
+- For focused suites, use `cargo nextest run -p <crate> --all-features` after exporting required RPC endpoints.
+- Name tests after observable behavior (e.g., `handles_invalid_proposal`) and capture container logs for any failing integration case.
+
+## Commit & Pull Request Guidelines
+- Use Conventional Commit prefixes (`feat:`, `fix:`, `chore:`). Keep subject lines ≤72 characters with optional, meaningful scopes.
+- PR descriptions must summarize impact, link issues, and include command output or screenshots for operator-facing flows.
+- Confirm `just fmt`, `just clippy`, and `just test` pass locally; call out any follow-up work explicitly.
+
+## Security & Environment Notes
+- Use only the ephemeral test keys bundled in scripts; never commit real credentials or `.env` files.
+- Ensure ports `18545` and `28545-28551` are free before running integration tests, and document deviations in your PR.