init repo structure, basic smart contract implementation

Author: dmytrotkk

.github/copilot-instructions.md

@@ -0,0 +1,17 @@
+# SmartClaws
+
+IoT data platform on SKALE blockchain. On-chain message channels for device-to-agent communication, Python SDK for hardware integration.
+
+## Smart Contracts (`smart-contracts/`)
+
+Hardhat 3, ESM, Solidity 0.8.28, OpenZeppelin 5.x.
+
+**Contracts:** `SmartClaws` (registry) → creates `SmartClawsChannel` (append-only message log), `SmartClawsDeviceGroup` (manages devices), `SmartClawsAgent` (AI agent with channels), `SmartClawsDevice` (device record).
+
+**Key patterns:** custom errors (not require strings), `Ownable2Step`, `EnumerableSet`, `unchecked` increments. HH3 uses `defineConfig` + `plugins` array, ethers via `await hre.network.connect()`.
+
+**Commands:** `npm test`, `npm run compile`, `npm run lint`.
+
+## Python
+
+Python 3.10+, managed with `uv`. BLE utilities for sensor communication.

.github/workflows/smart-contracts.yml

@@ -0,0 +1,37 @@
+name: Smart Contracts
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "smart-contracts/**"
+  pull_request:
+    branches: [main]
+    paths:
+      - "smart-contracts/**"
+
+jobs:
+  test:
+    name: Compile, Lint & Test
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: smart-contracts
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - run: npm ci
+
+      - name: Compile contracts
+        run: npx hardhat compile
+
+      - name: Lint Solidity
+        run: npx solhint 'contracts/**/*.sol'
+
+      - name: Run tests
+        run: npx hardhat test

.gitignore

@@ -0,0 +1,40 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+*.so
+
+# Node.js
+node_modules/
+
+# Hardhat / Solidity
+artifacts/
+cache/
+typechain-types/
+types/
+*.dbg.json
+coverage/
+coverage.json
+
+# Environment & secrets
+.env
+.env.*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Project-specific
+context/
+.claude/
+uv.lock
+*.log

python/pyproject.toml

@@ -0,0 +1,15 @@
+[project]
+name = "smartclaws"
+version = "0.1.0"
+requires-python = ">=3.10"
+dependencies = ["bleak"]
+
+[dependency-groups]
+dev = ["ruff"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]

python/read.py

@@ -0,0 +1,44 @@
+import asyncio
+from bleak import BleakClient, BleakScanner
+from datetime import datetime
+
+# The GATT characteristic that sends temp/humidity notifications
+DATA_CHAR = "ebe0ccc1-7a0a-4b0c-8a1a-6ff2997da3a6"
+
+
+async def scan():
+    devices = await BleakScanner.discover(timeout=10)
+    for d in devices:
+        if d.name and "LYWSD03" in d.name:
+            print(f"{d.name} -> {d.address}")
+
+
+async def read(address: str):
+    async with BleakClient(address) as client:
+        data = await client.read_gatt_char(DATA_CHAR)
+        temp = int.from_bytes(data[0:2], "little", signed=True) / 100
+        humi = data[2]
+        voltage = int.from_bytes(data[3:5], "little") / 1000
+        print(f"Temperature: {temp}°C")
+        print(f"Humidity: {humi}%")
+        print(f"Voltage: {voltage}V")
+
+
+async def read_loop(address: str, interval: float = 2.0):
+    async with BleakClient(address) as client:  # connect once
+        while True:
+            data = await client.read_gatt_char(DATA_CHAR)
+            temp = int.from_bytes(data[0:2], "little", signed=True) / 100
+            humi = data[2]
+            print(f"{temp}°C / {humi}%")
+            print(datetime.now().strftime("%Y-%m-%d %H:%M:%S"))
+            await asyncio.sleep(interval)
+
+
+# Scan to find MACs (only needed once):
+# asyncio.run(scan())
+
+# Read with your known MAC:
+# asyncio.run(read("229C6152-3E39-45DB-3A8B-D48CB72D171F"))
+# asyncio.run(read("99C9B552-C48E-0764-B56E-916ADDD6A0EA"))
+asyncio.run(read_loop("99C9B552-C48E-0764-B56E-916ADDD6A0EA", interval=0))

python/scan.py

@@ -0,0 +1,10 @@
+import asyncio
+from bleak import BleakScanner
+
+async def scan():
+    devices = await BleakScanner.discover(timeout=10)
+    for d in devices:
+        if d.name and "LYWSD03" in d.name:
+            print(f"{d.name} -> {d.address}")
+
+asyncio.run(scan())

smart-contracts/.solhint.json

@@ -0,0 +1,12 @@
+{
+  "extends": "solhint:recommended",
+  "rules": {
+    "func-visibility": ["warn", { "ignoreConstructors": true }],
+    "no-empty-blocks": "off",
+    "compiler-version": ["error", "^0.8.28"],
+    "max-line-length": ["warn", 120],
+    "use-natspec": "off",
+    "immutable-vars-naming": "off",
+    "gas-strict-inequalities": "off"
+  }
+}

smart-contracts/README.md

@@ -0,0 +1,48 @@
+# SmartClaws Smart Contracts
+
+On-chain message channels and device registry for the SmartClaws IoT platform, built on SKALE.
+
+## Contracts
+
+| Contract | Description |
+|---|---|
+| `SmartClaws` | Global registry — creates and tracks channels, device groups, and agents |
+| `SmartClawsChannel` | Append-only message log with circular buffer pruning by byte capacity |
+| `SmartClawsDeviceGroup` | Groups devices, handles registration and lifecycle |
+| `SmartClawsAgent` | AI agent with dedicated incoming and outgoing channels |
+| `SmartClawsDevice` | Immutable device record linking incoming/outgoing channels |
+
+## Structure
+
+```
+smart-contracts/
+├── contracts/          # Solidity source files
+├── test/               # Mocha + Ethers tests
+├── scripts/            # Deployment scripts
+├── hardhat.config.ts   # Hardhat 3 config (ESM)
+└── .solhint.json       # Solidity linter config
+```
+
+## Commands
+
+```bash
+npm install             # Install dependencies
+npm run compile         # Compile contracts
+npm test                # Run tests
+npm run lint            # Lint Solidity
+```
+
+## Deploy
+
+Set `SKALE_RPC_URL` and `DEPLOYER_PRIVATE_KEY` in `.env`, then:
+
+```bash
+npx hardhat run scripts/deploy.ts --network skaleTestnet
+```
+
+## Stack
+
+- Hardhat 3 (ESM, TypeScript)
+- Solidity 0.8.28, optimizer enabled, cancun EVM
+- OpenZeppelin Contracts 5.x
+- Mocha + Chai + Ethers.js