feat(sai-trading): Trades against testnet network

.github/workflows/e2e-evm.yml

@@ -151,4 +151,10 @@ jobs:
       - if: steps.check_changes.outputs.check_changes == 'true'
         working-directory: "sai-trading"
         run: |
-          just test
+          just e2e-deploy
+
+      - if: steps.check_changes.outputs.check_changes == 'true'
+        name: "Run SAI Trading E2E tests"
+        working-directory: "sai-trading"
+        run: |
+          just e2e-test

justfile

@@ -142,6 +142,18 @@ test-e2e:
   cd evm-e2e
   just test
 
+# Runs the SAI Trading E2E tests
+test-e2e-sai-trading:
+  #!/usr/bin/env bash
+  source contrib/bashlib.sh
+  log_info "Make sure the localnet is running! (just localnet)"
+  log_info "Deploying SAI contracts..."
+
+  cd sai-trading
+  just e2e-deploy
+  log_info "Running SAI Trading E2E tests..."
+  just e2e-test
+
 
 # Test: "localnet.sh" script
 test-localnet:

sai-trading/.env.example

@@ -0,0 +1,4 @@
+EVM_MNEMONIC=""
+
+# Optional: Slack webhook for error notifications (leave empty to disable)
+SLACK_WEBHOOK=""

sai-trading/.gitignore

@@ -2,3 +2,12 @@ artifacts/solidity/build-info
 *.dbg.json
 
 .env
+
+# Compiled binaries
+trader
+build/
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib

sai-trading/Dockerfile

@@ -0,0 +1,51 @@
+FROM golang:1.24 AS builder
+
+WORKDIR /nibiru
+
+RUN apt-get update && \
+  apt-get install -y --no-install-recommends \
+  musl-dev build-essential libgflags-dev libsnappy-dev zlib1g-dev libbz2-dev liblz4-dev libzstd-dev ca-certificates wget && \
+  rm -rf /var/lib/apt/lists/*
+
+ARG WASMVM_VERSION=1.5.9
+ARG TARGETARCH
+
+RUN mkdir -p /usr/lib && \
+  if [ "${TARGETARCH}" = "arm64" ]; then \
+    wget -q https://github.com/CosmWasm/wasmvm/releases/download/v${WASMVM_VERSION}/libwasmvm_muslc.aarch64.a -O /usr/lib/libwasmvm_muslc.a; \
+  else \
+    wget -q https://github.com/CosmWasm/wasmvm/releases/download/v${WASMVM_VERSION}/libwasmvm_muslc.x86_64.a -O /usr/lib/libwasmvm_muslc.a; \
+  fi
+
+COPY go.mod go.sum /nibiru/
+COPY internal/ /nibiru/internal/
+RUN go mod download
+
+COPY sai-trading/go.mod sai-trading/go.sum /nibiru/sai-trading/
+RUN cd sai-trading && go mod download
+
+COPY . .
+
+WORKDIR /nibiru/sai-trading
+
+RUN --mount=type=cache,target=/root/.cache/go-build \
+  --mount=type=cache,target=/go/pkg \
+  --mount=type=cache,target=/nibiru/sai-trading/temp \
+  CGO_ENABLED=1 \
+  go build -tags "netgo muslc" \
+  -ldflags '-linkmode=external -extldflags "-Wl,-z,muldefs -static -lstdc++ -lm -lz -lbz2 -lsnappy -llz4 -lzstd -lpthread"' \
+  -o ./build/trader ./cmd/trader
+
+FROM alpine:3.20
+
+WORKDIR /root
+
+RUN apk --no-cache add ca-certificates
+
+COPY --from=builder /nibiru/sai-trading/build/trader /usr/local/bin/trader
+
+COPY --from=builder /nibiru/sai-trading/networks.toml /root/networks.toml
+COPY --from=builder /nibiru/sai-trading/auto-trader.localnet.json /root/
+COPY --from=builder /nibiru/sai-trading/auto-trader.testnet.json /root/
+
+ENTRYPOINT ["trader"]

sai-trading/README.md

@@ -46,51 +46,90 @@ https://github.com/mikefarah/yq?tab=readme-ov-file#github-action
 
 ## Running the EVM Trader
 
-### Configuration via `.env` file
+### Configuration
 
-Create a `.env` file in the root directory to configure the trader:
+Create a `.env` file in the root directory (see `.env.example`):
 
 ```bash
 # Account credentials (use either private key OR mnemonic)
-EVM_PRIVATE_KEY=0x1234567890abcdef...  # Your private key in hex format
+EVM_PRIVATE_KEY=0x1234567890abcdef...
 # OR
-EVM_MNEMONIC="word1 word2 word3 ..."   # Your BIP39 mnemonic phrase
+EVM_MNEMONIC="word1 word2 word3 ..."
+
+SLACK_WEBHOOK=""
+```
+
+#### Slack Notification Configuration (Optional)
+
+Slack notifications are optional. If not configured, errors will still be logged to stdout.
+
+**Step 1: Set Slack Webhook**
+
+Set your Slack webhook URL in `.env` file:
+
+```bash
+SLACK_WEBHOOK="https://hooks.slack.com/services/YOUR/WEBHOOK/URL"
+```
+
+**Step 2: Configure Error Filters**
+
+Configure which errors to send to Slack in `networks.toml`:
+
+```toml
+[notifications.filters]
+include = ["insufficient funds", "gas error", "execution failed"]
+exclude = ["expected error", "test"]
+```
+
+**Filter Logic:**
+- **Exclude list**: If any keyword matches, skip the notification (highest priority)
+- **Include list**: If not empty, only send if at least one keyword matches
+- **Empty filters**: Send all errors to Slack
 
 ### Running the trader
 
-**Dynamic trading** (uses config parameters):
+**Auto trading** :
 ```bash
-just run-trader
-# or with custom parameters:
-just run-trader --market-index 0 --leverage-min 5 --leverage-max 20
+just run-trader auto --network testnet
 ```
 
-**Static JSON file trading**:
+With custom parameters:
 ```bash
+just run-trader auto --market-index 0 --min-leverage 5 --max-leverage 20 --blocks-before-close 20 --network testnet
+```
+
+Or use a config file:
+```bash
+go run ./cmd/trader auto --config auto-trader.localnet.json
+```
+
+**Manual trading**:
+```bash
+# Open a single position
+just run-trader open --trade-type trade --market-index 0 --long false --trade-size 1 --network testnet
+
+# Using JSON file
 just run-trader --trade-json sample_txs/open_trade.json
 ```
 
 ### Available flags
 
-- `--network`: Network mode (`localnet`, `testnet`, `mainnet`)
+**Root flags (shared across all commands):**
+- `--network`: Network mode (`localnet`, `testnet`, `mainnet`) (default: `localnet`)
+- `--evm-rpc`: EVM RPC URL (overrides network mode default)
+- `--networks-toml`: Path to networks TOML configuration file (default: `networks.toml`)
+- `--contracts-env`: Path to contracts env file (legacy, overrides networks.toml)
 - `--private-key`: Private key in hex format (overrides `EVM_PRIVATE_KEY` env var)
 - `--mnemonic`: BIP39 mnemonic phrase (overrides `EVM_MNEMONIC` env var)
-- `--contracts-env`: Path to contracts env file (defaults to `.cache/localnet_contracts.env`)
-- `--trade-json`: Path to JSON file with trade parameters (overrides dynamic trading)
-- `--market-index`: Market index to trade (default: 0)
-- `--collateral-index`: Collateral token index (default: 1)
-- `--leverage-min`: Minimum leverage (default: 5)
-- `--leverage-max`: Maximum leverage (default: 20)
-- `--trade-size-min`: Minimum trade size in smallest units (default: 10000)
-- `--trade-size-max`: Maximum trade size in smallest units (default: 50000)
-- `--enable-limit-order`: Enable limit order trading (default: false)
-
-### Example `.env` file
-
-```bash
-# Account
-EVM_MNEMONIC="guard cream sadness conduct invite crumble clock pudding hole grit liar hotel maid produce squeeze return argue turtle know drive eight casino maze host"
-```
-
-**Note**: The `.env` file is automatically loaded if present. You can also pass values via command-line flags, which take precedence over environment variables.
 
+**Auto command flags:**
+- `--config`: Path to JSON config file (optional)
+- `--market-index`: Market index to trade (default: 0)
+- `--collateral-index`: Collateral token index (default: 0, uses market's quote token)
+- `--min-trade-size`: Minimum trade size in smallest units (default: 1000000)
+- `--max-trade-size`: Maximum trade size in smallest units (default: 5000000)
+- `--min-leverage`: Minimum leverage (default: 1, e.g., 1 for 1x)
+- `--max-leverage`: Maximum leverage (default: 10, e.g., 10 for 10x)
+- `--blocks-before-close`: Number of blocks to wait before closing a position (default: 20)
+- `--max-open-positions`: Maximum number of positions to keep open at once (default: 5)
+- `--loop-delay`: Delay in seconds between each loop iteration (default: 5)

sai-trading/auto-trader.localnet.json

@@ -0,0 +1,20 @@
+{
+  "network": {
+    "mode": "localnet",
+    "evm_rpc_url": "http://localhost:8545",
+    "networks_toml": "networks.toml"
+  },
+  "trading": {
+    "market_indices": [0],
+    "collateral_indices": [1],
+    "min_trade_size": 10000,
+    "max_trade_size": 50000,
+    "min_leverage": 2,
+    "max_leverage": 8
+  },
+  "bot": {
+    "blocks_before_close": 20,
+    "max_open_positions": 3,
+    "loop_delay_seconds": 5
+  }
+}

sai-trading/auto-trader.testnet.json

@@ -0,0 +1,19 @@
+{
+  "network": {
+    "mode": "testnet",
+    "networks_toml": "networks.toml"
+  },
+  "trading": {
+    "market_indices": [0, 1, 14, 18, 44],
+    "collateral_indices": [4],
+    "min_trade_size": 10000,
+    "max_trade_size": 100000,
+    "min_leverage": 1,
+    "max_leverage": 5
+  },
+  "bot": {
+    "blocks_before_close": 10,
+    "max_open_positions": 2,
+    "loop_delay_seconds": 10
+  }
+}