V1

.cspell.json

@@ -5,6 +5,23 @@
   "useGitignore": true,
   "language": "en",
   "words": [
+    "ision",
+    "stableswap",
+    "ptable",
+    "larg",
+    "tive",
+    "depeg",
+    "ohlcv",
+    "depegs",
+    "backtest",
+    "backtester",
+    "foundryup",
+    "backtesting",
+    "viem",
+    "twap",
+    "geckoterminal",
+    "uusd",
+    "lusd",
     "Nektos",
     "dataurl",
     "devpool",

.env.example

@@ -1 +1,23 @@
-MY_SECRET="MY_SECRET"
+# UUSD Peg Maintenance Bot - Environment Variables
+
+# Required: Private key for the hot wallet that executes trades
+# Must be a valid Ethereum private key starting with 0x
+# Below is Anvil Account[0] private key for dry runs and testing
+HOT_WALLET_PRIVATE_KEY=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
+
+# Optional: Price deviation threshold to trigger action (default: 0.01 = 1%)
+# Only trades if UUSD price deviates more than this from $1.00
+DEVIATION_THRESHOLD=0.01
+
+# Optional: Maximum gas price in gwei (default: 50)
+# Skips trading if gas price exceeds this value
+MAX_GAS_PRICE_GWEI=50
+
+# Optional: Maximum slippage tolerance (default: 0.05 = 5%)
+# Transaction will revert if actual slippage exceeds this
+MAX_SLIPPAGE=0.01
+
+# Optional: Enable trade execution (default: false)
+# Set to "true" to actually execute trades
+# Keep as "false" for dry-run/simulation mode
+EXECUTE_ENABLED=false

.github/knip.ts

@@ -1,11 +1,10 @@
 import type { KnipConfig } from "knip";
 
 const config: KnipConfig = {
-  entry: ["src/action.ts"],
   project: ["src/**/*.ts", "tests/**/*.ts"],
   ignore: ["src/types/config.ts", "**/__mocks__/**", "**/__fixtures__/**"],
   ignoreExportsUsedInFile: true,
-  ignoreDependencies: ["ts-node"],
+  ignoreBinaries: ["tsx", "anvil"],
   eslint: true,
 };
 

.github/workflows/jest-testing.yml

@@ -19,11 +19,41 @@ jobs:
         with:
           fetch-depth: 0
 
-      - name: Jest With Coverage
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Jest With Coverage (Unit Tests)
+        run: bun run test
+
+      - name: Save Unit Test Report
+        if: always()
+        run: |
+          echo "## Unit Tests" >> $GITHUB_STEP_SUMMARY
+          echo "$(cat test-dashboard.md)" >> $GITHUB_STEP_SUMMARY
+
+      - name: Install Foundry
+        uses: foundry-rs/foundry-toolchain@v1
+        with:
+          version: nightly
+
+      - name: Start Anvil
+        run: bun run test:anvil &
+
+      - name: Wait for Anvil
         run: |
-          bun install --frozen-lockfile
-          bun run test
+          for i in {1..30}
+          do
+            if curl -s http://127.0.0.1:8545; then
+              break
+            fi
+            sleep 1
+          done || exit 1
 
-      - name: Add Jest Report to Summary
+      - name: Jest Integration Tests
+        run: bun run test:integration
+
+      - name: Save Integration Test Report
         if: always()
-        run: echo "$(cat test-dashboard.md)" >> $GITHUB_STEP_SUMMARY
+        run: |
+          echo "## Integration Tests" >> $GITHUB_STEP_SUMMARY
+          echo "$(cat test-dashboard.md)" >> $GITHUB_STEP_SUMMARY

.github/workflows/peg-maintenance.yml

@@ -0,0 +1,51 @@
+name: UUSD Peg Maintenance
+
+on:
+  schedule:
+    # Run every 6 hours
+    - cron: "0 */6 * * *"
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: "Dry run (don't execute trades)"
+        required: false
+        default: "true"
+        type: choice
+        options:
+          - "true"
+          - "false"
+
+jobs:
+  maintain-peg:
+    name: Check and Maintain UUSD Peg
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Run Peg Maintenance
+        env:
+          HOT_WALLET_PRIVATE_KEY: ${{ secrets.HOT_WALLET_PRIVATE_KEY }}
+          DEVIATION_THRESHOLD: ${{ vars.DEVIATION_THRESHOLD || '0.01' }}
+          MAX_GAS_PRICE_GWEI: ${{ vars.MAX_GAS_PRICE_GWEI || '50' }}
+          MAX_SLIPPAGE: ${{ vars.MAX_SLIPPAGE || '0.01' }}
+          EXECUTE_ENABLED: ${{ github.event_name == 'schedule' && 'true' || github.event.inputs.dry_run != 'true' }}
+        run: bun run src/action.ts
+
+      - name: Upload logs
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: peg-maintenance-logs-${{ github.run_id }}
+          path: logs/
+          retention-days: 30