m2: l1 anchoring

.cargo/config.toml

@@ -2,9 +2,4 @@
 rustflags = ["-C", "target-cpu=native"]
 
 [target.x86_64-unknown-linux-gnu]
-rustflags = [
-  "-C",
-  "target-cpu=native",
-  # (Nightly) Make the current crate share its generic instantiations
-  "-Zshare-generics=y",
-]
+rustflags = ["-C", "target-cpu=native"]

.dockerignore

@@ -0,0 +1,46 @@
+# Project-specific ignores
+/.db
+
+# Generated by Cargo
+# will have compiled files and executables
+debug
+target
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
+
+# MSVC Windows builds of rustc generate these, which store debugging information
+*.pdb
+
+# Generated by cargo mutants
+# Contains mutation testing data
+**/mutants.out/
+
+# MacOS files
+.DS_Store
+
+# IntelliJ IDEA
+.idea
+
+# Hardhat/Foundry files
+cache
+cache-hardhat
+artifacts
+artifacts-hardhat
+broadcast
+
+# Js
+node_modules
+dist
+*.tsbuildinfo
+.eslintcache
+.rollup.cache
+
+# Project files
+.db
+
+# WAL artifacts
+.journal
+*.wal
+checkpoint.meta
+checkpoint.meta.tmp

.editorconfig

@@ -1,7 +1,10 @@
-[*.{js,jsx,ts,tsx,css,scss,html,json,md}]
+[*.{js,jsx,ts,tsx,css,scss,html,json,md,sql}]
 charset = utf-8
 insert_final_newline = true
 end_of_line = lf
 indent_style = space
 indent_size = 2
-max_line_length = 80
+max_line_length = 80
+
+[*.md]
+trim_trailing_whitespace = false

.env

@@ -1 +1,2 @@
 FOUNDRY_OUT="target/foundry"
+SQLX_OFFLINE=true

.env.test

@@ -0,0 +1,16 @@
+# All addresses here are for Scroll Sepolia testnet deployment.
+MASTER_ADDRESS=0x96B7c62f1FC932466264C19376263C980848b760
+
+L1_MESSENGER=0x50c7d3e7f7c656493D1D76aaa1a836CedfCBB16A
+L2_MESSENGER=0xBa50f5340FB9F3Bd074bD638c9BE13eCB36E603d
+EAS_SCROLL=0xaEF4103A04090071165F78D45D83A0C0782c2B2a # scroll sepolia
+EAS_MAINNET=0xC2679fBD37d54388Ce493F1DB75320D236e1815e # sepolia
+
+FEE_ORACLE=0x79bd2bb088b4E75AB26869cbEc1571019aBa06C0
+NFT_GENERATOR=0x8F1be71d553cEff8DEf08Af49214896e6D976e74
+
+ANCHORING_MANAGER_IMPL=0x5a5FBf844CBDD1aB6CbAb9151a8C1d855e296A94
+ANCHORING_MANAGER=0x7249802D50CB719547F7685d090d4b84e7183C32
+
+ANCHORING_GATEWAY_IMPL=0xf8dF10964a6E583560A71f5aB10d85cF9497F30d
+ANCHORING_GATEWAY=0x39Ea3C70A5e26C8dB4a1A5E9A7Fc7Bab04684C08

.github/FUNDING.yml

@@ -0,0 +1,10 @@
+# These are supported funding model platforms
+# See https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository
+
+# You can support the UTS project by sending ETH directly to the operator
+# address displayed on the calendar or relayer home page:
+#   Calendar: https://lgm1.calendar.test.timestamps.now/
+#   Relayer:  https://lich.relayer.test.timestamps.now/
+custom:
+  - https://lgm1.calendar.test.timestamps.now/
+  - https://lich.relayer.test.timestamps.now/

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,82 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the sections below.
+
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      description: Which component is affected?
+      options:
+        - uts-cli
+        - uts-core
+        - uts-bmt
+        - uts-calendar
+        - uts-relayer
+        - uts-stamper
+        - TypeScript SDK
+        - Python SDK
+        - Go SDK
+        - Smart Contracts
+        - Documentation
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and concise description of the bug.
+      placeholder: Describe the bug...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior.
+      placeholder: |
+        1. Run `uts stamp ...`
+        2. Observe error...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened. Include error messages or logs if applicable.
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Any relevant environment information.
+      placeholder: |
+        - OS: Ubuntu 24.04
+        - Rust: 1.94.0-nightly
+        - uts-cli version: 0.1.0-alpha.0
+      render: markdown
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, or logs.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Documentation
+    url: https://book.timestamps.now/
+    about: Read the UTS documentation

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,58 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature! Please describe your idea below.
+
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      description: Which component does this relate to?
+      options:
+        - uts-cli
+        - uts-core
+        - uts-bmt
+        - uts-calendar
+        - uts-relayer
+        - uts-stamper
+        - TypeScript SDK
+        - Python SDK
+        - Go SDK
+        - Smart Contracts
+        - Documentation
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve? Is it related to a frustration?
+      placeholder: I'm always frustrated when...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the solution you'd like.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any alternative solutions or features you've considered.
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other context, mockups, or references.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,30 @@
+## Description
+
+<!-- A clear description of what this PR does and why. -->
+
+## Related Issues
+
+<!-- Link related issues: Fixes #123, Closes #456 -->
+
+## Changes
+
+<!-- List the key changes made in this PR. -->
+
+-
+
+## Type of Change
+
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] Documentation update
+- [ ] Refactoring (no functional changes)
+- [ ] CI/CD or tooling changes
+
+## Checklist
+
+- [ ] My code follows the project's style guidelines
+- [ ] I have performed a self-review of my changes
+- [ ] I have added tests that prove my fix/feature works
+- [ ] Existing tests pass locally with my changes
+- [ ] I have updated documentation as needed

.github/workflows/ci-contracts.yml

@@ -19,7 +19,7 @@ concurrency:
 
 jobs:
   check:
-    name: Build & Test
+    name: Solidity Build & Test
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4

.github/workflows/ci-python.yml

@@ -15,7 +15,7 @@ concurrency:
 
 jobs:
   check:
-    name: Lint, Format & Test
+    name: Python Lint, Format & Test
     runs-on: ubuntu-latest
     defaults:
       run:

.github/workflows/ci-rust.yml

@@ -24,7 +24,7 @@ env:
 
 jobs:
   fmt:
-    name: Formatting
+    name: Rust Formatting
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -46,8 +46,9 @@ jobs:
         run: taplo fmt --check
 
   clippy:
-    name: Clippy
+    name: Rust Clippy
     runs-on: ubuntu-latest
+    needs: [fmt]
     steps:
       - uses: actions/checkout@v4
 
@@ -64,8 +65,9 @@ jobs:
       - run: cargo clippy --workspace --all-targets -- -D warnings
 
   test:
-    name: Tests
+    name: Rust Tests
     runs-on: ubuntu-latest
+    needs: [clippy]
     steps:
       - uses: actions/checkout@v4
 

.github/workflows/ci-typescript.yml

@@ -23,7 +23,7 @@ concurrency:
 
 jobs:
   check:
-    name: Lint, Typecheck & Test
+    name: TypeScript Lint, Typecheck & Test
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4

.github/workflows/publish-book.yml

@@ -6,7 +6,7 @@ on:
   workflow_dispatch:
 
 jobs:
-  deploy:
+  deploy-book:
     runs-on: ubuntu-latest
     permissions:
       contents: read

.github/workflows/publish-docs.yml

@@ -6,7 +6,7 @@ on:
   workflow_dispatch:
 
 jobs:
-  ci:
+  deploy-docs:
     runs-on: ubuntu-latest
     permissions:
       contents: read

.gitignore

@@ -44,3 +44,6 @@ dist
 *.wal
 checkpoint.meta
 checkpoint.meta.tmp
+
+# Book build
+book/build

.gitmodules

@@ -7,3 +7,12 @@
 [submodule "lib/openzeppelin-contracts-upgradeable"]
 	path = lib/openzeppelin-contracts-upgradeable
 	url = https://github.com/OpenZeppelin/openzeppelin-contracts-upgradeable
+[submodule "lib/scroll-contracts"]
+	path = lib/scroll-contracts
+	url = https://github.com/scroll-tech/scroll-contracts
+[submodule "lib/eas-contracts"]
+	path = lib/eas-contracts
+	url = https://github.com/ethereum-attestation-service/eas-contracts
+[submodule "lib/solady"]
+	path = lib/solady
+	url = https://github.com/Vectorized/solady

.pre-commit-config.yaml

@@ -23,4 +23,11 @@ repos:
         entry: npx prettier --write
         language: system
         files: \.(js|jsx|ts|tsx|json|css|scss|md|html|toml)$
+        exclude: \.sqlx/.*\.json$
+        pass_filenames: true
+      - id: black
+        name: black
+        entry: black
+        language: system
+        types: [python]
         pass_filenames: true