Merge pull request #1 from oasisprotocol/rube/inital-paymaster-code

initial code

Author: rube-de

.github/workflows/ci-build.yml

@@ -0,0 +1,43 @@
+# NOTE: This name appears in GitHub's Checks API and in workflow's status badge.
+name: ci-build
+
+# Trigger the workflow when:
+on:
+  # A push occurs to one of the matched branches.
+  push:
+    branches:
+      - main
+      - master
+      - stable/*
+  # Or when a pull request event occurs for a pull request against one of the
+  # matched branches.
+  pull_request:
+    branches:
+      - main
+      - master
+      - stable/*
+
+# Cancel in-progress jobs on same branch.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  CMAKE_POLICY_VERSION_MINIMUM: 3.5
+
+jobs:
+  docker-build:
+    name: docker-build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Show Docker and Compose versions
+        run: |
+          docker --version
+          docker compose version
+
+      - name: Build images with Docker Compose
+        working-directory: ./paymaster-relayer
+        run: docker compose build

.github/workflows/ci-lint.yml

@@ -0,0 +1,80 @@
+# NOTE: This name appears in GitHub's Checks API and in workflow's status badge.
+name: ci-lint
+
+# Trigger the workflow when:
+on:
+  # A push occurs to one of the matched branches.
+  push:
+    branches:
+      - main
+      - master
+      - stable/*
+  # Or when a pull request event occurs for a pull request against one of the
+  # matched branches.
+  pull_request:
+    branches:
+      - main
+      - master
+      - stable/*
+
+# Cancel in-progress jobs on same branch.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  CMAKE_POLICY_VERSION_MINIMUM: 3.5
+
+jobs:
+  lint-markdown:
+    name: lint-markdown
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Lint markdown
+        uses: nosborn/[email protected]
+        with:
+          files: .
+          config_file: .markdownlint.yml
+          ignore_path: .markdownlintignore
+
+  lint-paymaster-relayer:
+    name: lint-paymaster-relayer
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Python and uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: '3.12'
+          enable-cache: true
+
+      - name: Install dependencies
+        working-directory: ./paymaster-relayer
+        run: uv sync --dev
+
+      - name: Lint Python code
+        working-directory: ./paymaster-relayer
+        run: uv run ruff check --output-format=github .
+
+  lint-solidity:
+    name: lint-solidity
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+
+      - name: Install dependencies
+        working-directory: ./contracts
+        run: bun install
+
+      - name: Lint Solidity code
+        working-directory: ./contracts
+        run: bun run lint

.github/workflows/ci-test.yml

@@ -0,0 +1,48 @@
+# NOTE: This name appears in GitHub's Checks API and in workflow's status badge.
+name: ci-test
+
+# Trigger the workflow when:
+on:
+  # A push occurs to one of the matched branches.
+  push:
+    branches:
+      - main
+      - master
+      - stable/*
+  # Or when a pull request event occurs for a pull request against one of the
+  # matched branches.
+  pull_request:
+    branches:
+      - main
+      - master
+      - stable/*
+
+# Cancel in-progress jobs on same branch.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  CMAKE_POLICY_VERSION_MINIMUM: 3.5
+
+jobs:
+  test-paymaster-relayer:
+    name: test-paymaster-relayer
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Python and uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: '3.12'
+          enable-cache: true
+
+      - name: Install dependencies
+        working-directory: ./paymaster-relayer
+        run: uv sync --dev
+
+      - name: Run tests
+        working-directory: ./paymaster-relayer
+        run: uv run pytest tests

.gitignore

@@ -0,0 +1,102 @@
+# Dependencies
+node_modules/
+.npm
+.yarn/
+.pnpm-debug.log*
+
+# Build outputs
+dist/
+build/
+out/
+
+# Hardhat specific
+artifacts/
+cache/
+coverage/
+.coverage
+.nyc_output
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+*.egg-info/
+.eggs/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+.env.production
+
+# Temporary files
+tmp/
+temp/
+
+# Blockchain specific
+.openzeppelin/
+deployments/
+.chainId
+
+# Python virtual environments
+.venv
+venv/
+virtualenv/
+my_env/
+
+# MyPy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# wake
+/.wake/
+
+# Configuration files that might contain secrets
+config.local.*
+*.local.*
+!compose.local.yaml

.markdownlint.yml

@@ -0,0 +1,19 @@
+# Enable default rules and set a stricter line length
+default: true
+
+# MD013: Line length
+MD013:
+  line_length: 80
+  code_blocks: false   # allow long lines in fenced code blocks
+  tables: false        # allow long lines in tables
+
+# MD009: No trailing spaces at end of lines
+MD009:
+  br_spaces: 0         # disallow hard line break spaces
+  strict: true         # flag any trailing whitespace
+
+# MD029: Disable ordered list item prefix checking
+MD029: false           # allow sequential numbering (1, 2, 3, 4)
+
+# MD047: Files should end with a single newline character
+MD047: true

.markdownlintignore

@@ -0,0 +1,10 @@
+node_modules/
+**/node_modules/
+.venv/
+**/.venv/
+dist/
+build/
+coverage/
+*.min.js
+vendor/
+*.local.*

Makefile

@@ -0,0 +1,30 @@
+## ROFL Paymaster - Root Makefile
+
+.PHONY: help lint-markdown fix-markdown
+.DEFAULT_GOAL := help
+
+# Colors for output
+BLUE := \033[0;34m
+GREEN := \033[0;32m
+YELLOW := \033[1;33m
+NC := \033[0m # No Color
+
+help: ## Show this help message
+	@echo "$(BLUE)ROFL Paymaster - Repository Tasks$(NC)"
+	@echo ""
+	@echo "$(YELLOW)Top-level targets:$(NC)"
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "$(GREEN)%-22s$(NC) %s\n", $$1, $$2}'
+	@echo ""
+	@echo "$(YELLOW)Component workflows:$(NC)"
+	@echo "  - Contracts: see contracts/README.md"
+	@echo "  - Relayer: see paymaster-relayer/README.md"
+
+lint-markdown: ## Lint Markdown files using markdownlint (Docker)
+	@echo "$(BLUE)Linting Markdown files with markdownlint...$(NC)"
+	docker run --rm -v "$$PWD:/work" -w /work ghcr.io/igorshubovych/markdownlint-cli:latest \
+	  markdownlint -c .markdownlint.yml --ignore-path .markdownlintignore .
+
+fix-markdown: ## Auto-fix Markdown issues using markdownlint (Docker)
+	@echo "$(BLUE)Fixing Markdown files with markdownlint --fix...$(NC)"
+	docker run --rm -v "$$PWD:/work" -w /work ghcr.io/igorshubovych/markdownlint-cli:latest \
+	  markdownlint -c .markdownlint.yml --ignore-path .markdownlintignore --fix .