chore: initial commit

Author: drewstone

.cursor/general.mdc

@@ -0,0 +1,52 @@
+---
+description: Expert Engineer
+globs: *.rs, *.ts, *.js
+alwaysApply: false
+---
+You're an expert engineer proficient in Rust, Typescript, and thoughtboi for AI agent ideas
+
+Your software principles are:
+1. Write professional code using best practices in any language.
+2. Write concise code foremost. Always analyze if something can be removed/reworked to reduce lines of code.
+3. Write tests in separate tests file to declutter workspace.
+4. Always prioritize performance, readable code.
+5. Always write relevant documentation that informs any future reader. Keep it up to date.
+
+For blueprints, always check if something exists on the config. If it doesn't, do not assume it is on the config. Instead add it to a `Context` struct or another helper struct and read new config parameters from environment variables.
+```
+#[non_exhaustive]
+#[derive(Debug, Clone, Default)]
+pub struct GadgetConfiguration {
+    /// HTTP RPC endpoint for host restaking network (Tangle / Ethereum (Eigenlayer or Symbiotic)).
+    pub http_rpc_endpoint: String,
+    /// WS RPC endpoint for host restaking network (Tangle / Ethereum (Eigenlayer or Symbiotic)).
+    pub ws_rpc_endpoint: String,
+    /// The keystore URI for the gadget
+    pub keystore_uri: String,
+    /// Data directory exclusively for this gadget
+    ///
+    /// This will be `None` if the blueprint manager was not provided a base directory.
+    pub data_dir: Option<PathBuf>,
+    /// The list of bootnodes to connect to
+    #[cfg(feature = "networking")]
+    pub bootnodes: Vec<Multiaddr>,
+    /// The port to bind the network to
+    #[cfg(feature = "networking")]
+    pub network_bind_port: u16,
+    /// The type of protocol the gadget is executing on.
+    pub protocol: Protocol,
+    /// Protocol-specific settings
+    pub protocol_settings: ProtocolSettings,
+    /// Whether the gadget is in test mode
+    pub test_mode: bool,
+    /// Whether to enable mDNS
+    #[cfg(feature = "networking")]
+    pub enable_mdns: bool,
+    /// Whether to enable Kademlia
+    #[cfg(feature = "networking")]
+    pub enable_kademlia: bool,
+    /// The target number of peers to connect to
+    #[cfg(feature = "networking")]
+    pub target_peer_count: u32,
+}
+```

.github/dependabot.yml

@@ -0,0 +1,12 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "cargo" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "daily"
+    open-pull-requests-limit: 5

.github/workflows/ci.yml

@@ -0,0 +1,104 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+concurrency:
+  group: rust-validation-${{ github.head_ref }}
+  cancel-in-progress: true
+
+jobs:
+  fmt:
+    name: Rustfmt
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@nightly
+        with:
+          toolchain: nightly-2024-10-13
+          components: rustfmt
+
+      - name: Check Formatting
+        run: cargo fmt -- --check
+
+  lint:
+    timeout-minutes: 120
+    name: Clippy
+    runs-on: ubuntu-latest
+    steps:
+      - name: checkout code
+        uses: actions/checkout@v4
+
+      - name: Install Foundry
+        uses: foundry-rs/foundry-toolchain@v1
+        with:
+          version: nightly
+
+      - name: Verify Forge installation
+        run: forge --version
+
+      - name: Install Solidity Dependencies
+        run: forge soldeer update -d
+
+      - uses: dtolnay/rust-toolchain@nightly
+        with:
+          toolchain: nightly-2024-10-13
+          components: clippy
+
+      - uses: swatinem/rust-cache@v2
+        with:
+          cache-on-failure: "true"
+
+      - name: Forge build
+        run: forge update && forge build
+
+      - uses: taiki-e/github-actions/free-device-space@main
+
+      - name: Run Clippy
+        run: cargo clippy --tests --examples -- -D warnings
+
+  test:
+    timeout-minutes: 90
+    name: Unit tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: checkout code
+        uses: actions/checkout@v4
+
+      - name: Install Foundry
+        uses: foundry-rs/foundry-toolchain@v1
+        with:
+          version: nightly
+
+      - name: Verify Forge installation
+        run: forge --version
+
+      - name: Install Solidity Dependencies
+        run: forge soldeer update -d
+
+      - uses: dtolnay/rust-toolchain@nightly
+        with:
+          toolchain: nightly-2024-10-13
+          components: clippy
+
+      - uses: swatinem/rust-cache@v2
+        with:
+          cache-on-failure: "true"
+
+      - uses: taiki-e/install-action@v2
+        with:
+          tool: nextest
+
+      - name: Forge build
+        run: forge update && forge build
+
+      - uses: taiki-e/github-actions/free-device-space@main
+
+      - name: tests
+        run: cargo nextest run

.github/workflows/foundry.yml

@@ -0,0 +1,36 @@
+name: Foundry CI
+
+on: workflow_dispatch
+
+env:
+  FOUNDRY_PROFILE: ci
+
+jobs:
+  foundry-check:
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+      fail-fast: true
+
+    name: Foundry project
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install Foundry
+        uses: foundry-rs/foundry-toolchain@v1
+        with:
+          version: nightly
+
+      - name: Run Forge build
+        run: |
+          forge --version
+          forge build --sizes
+        id: build
+
+      - name: Run Forge tests
+        run: |
+          forge test -vvv
+        id: test