Release/v1.13.14 0.3.0.release

.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,41 @@
+name: Bug
+description: Report a bug
+title: "Bug: "
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report!
+
+        ⚠️ Your issue will be closed as "not planned" if:
+        - you do not fill out **the title of the issue** ☝️
+        - you do not provide the **libevm version** as requested below
+  - type: input
+    id: host-os
+    attributes:
+      label: Host platform
+      description: What is your host platform?
+      placeholder: "Debian Buster amd64"
+  - type: input
+    id: version
+    attributes:
+      label: What is the version of libevm
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: "What's the problem 🤔"
+      placeholder: "That feature does not work..."
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Share your logs if needed
+      render: plain text
+  - type: textarea
+    id: config
+    attributes:
+      label: Share your configuration(s) if needed
+      render: plain text

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Need help
+    url: https://github.com/ava-labs/libevm/discussions/new/choose
+    about: Please create a Github discussion.

.github/ISSUE_TEMPLATE/feature.yml

@@ -0,0 +1,15 @@
+name: Feature request
+description: Suggest a feature to add to libevm
+title: "Feature request: "
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: "What's the feature 🧐"
+      placeholder: "Describe the feature you want and why it should be added"
+    validations:
+      required: true
+  - type: textarea
+    id: approach-and-alternatives
+    attributes:
+      label: "Recommended approach and alternatives"

.github/labels.yml

@@ -0,0 +1,74 @@
+# libevm specific labels
+- name: "Status: 🔴 Blocked by Geth sync"
+  color: "959a9c"
+  description: "This needs to wait for the next fork sync with the geth repository 🍴"
+- name: "Status: 🔴 DO NOT MERGE"
+  color: "959a9c"
+  from_name: "DO NOT MERGE"
+
+# General categories
+- name: "Category: New feature 🆕"
+  color: "ffc7ea"
+- name: "Category: Documentation ✒️"
+  description: "A problem with the readme or a code comment."
+  color: "ffc7ea"
+- name: "Category: Bug 🐛"
+  color: "ffc7ea"
+  from_name: "bug"
+- name: "Category: Investigation 🔍"
+  color: "ffc7ea"
+- name: "Category: CI ⛓️"
+  description: "Anything related to continuous integration"
+  color: "ffc7ea"
+- name: "Category: Testing 🧪"
+  description: "Unit tests, integration tests, etc."
+  color: "ffc7ea"
+- name: "Category: Code quality ✏️"
+  color: "ffc7ea"
+- name: "Category: Performance 🚀"
+  color: "ffc7ea"
+- name: "Category: Label missing ❗"
+  description: "Use this if it feels a label should be added to label this issue"
+  color: "ffc7ea"
+
+# Status
+- name: "Status: 🗯️ Waiting for feedback"
+  color: "f7d692"
+- name: "Status: 🔴 Blocked"
+  color: "f7d692"
+  description: "Blocked by another issue or pull request"
+- name: "Status: 🟡 Nearly resolved"
+  color: "f7d692"
+  description: "This might be resolved or is about to be resolved"
+
+# Priority
+- name: "Priority: 🚨 Urgent"
+  color: "03adfc"
+- name: "Priority: 📌 Before next release"
+  color: "03adfc"
+- name: "Priority: ⛓️ With next Geth sync"
+  color: "03adfc"
+  description: "Has to be done before the next release"
+- name: "Status: 🔒 After next release"
+  color: "03adfc"
+  description: "Will be done after the next release"
+- name: "Priority: 💤 Low priority"
+  color: "03adfc"
+
+# Complexity
+- name: "Complexity: 🟥 Hard to do"
+  color: "ff9efc"
+- name: "Complexity: 🟦 Easy to do"
+  color: "ff9efc"
+
+# Closing reason
+- name: "Closed: 👥 Duplicate"
+  color: "959a9c"
+  description: "Issue duplicates an existing issue"
+- name: "Closed: ⚰️ Inactive"
+  color: "959a9c"
+  description: "No answer was received for weeks"
+- name: "Closed: 🙅 Won't fix"
+  color: "959a9c"
+- name: "Closed: 🧺 Invalid"
+  color: "959a9c"

.github/pull_request_template.md

@@ -0,0 +1,5 @@
+## Why this should be merged
+
+## How this works
+
+## How this was tested

.github/workflows/go.yml

@@ -1,23 +1,93 @@
-name: i386 linux tests
+name: Go
 
 on:
   push:
-    branches: [ master ]
+    branches: [main, "release/**"]
   pull_request:
-    branches: [ master ]
+    branches: [main, "release/**"]
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+
 jobs:
-  build:
-    runs-on: self-hosted
+  # If adding a new job, add it to the `needs` list of the `go` job as this is
+  # what gates PRs.
+  go:
+    runs-on: ubuntu-latest
+    needs: [go_test_short, go_test_tooling, go_generate, go_tidy]
+    steps:
+      - run: echo "Dependencies successful"
+
+  go_test_short:
+    env:
+      FLAKY_REGEX: "ava-labs/libevm/(triedb/pathdb|eth|eth/tracers/js|eth/tracers/logger|eth/tracers/internal/tracetest|accounts/abi/bind|accounts/keystore|eth/downloader|miner|ethclient|ethclient/gethclient|eth/catalyst)$"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: "go.mod"
+      - name: Run flaky tests sequentially
+        run:
+          | # Upstream flakes are race conditions exacerbated by concurrent tests
+          go list ./... | grep -P "${FLAKY_REGEX}" | xargs -n 1 go test -short;
+      - name: Run non-flaky tests concurrently
+        run: |
+          go test -short $(go list ./... | grep -Pv "${FLAKY_REGEX}");
+
+  go_test_tooling:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./libevm/tooling
+    env:
+      TARGET_BRANCH: ${{ github.event_name == 'pull_request' && github.base_ref || github.ref }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # everything
+          ref: ${{ github.event.pull_request.head.sha }}
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: "./libevm/tooling/go.mod"
+      - name: Create local `main` if non-existent
+        run: git show-ref --quiet --verify refs/heads/main || git branch main origin/main
+      - run: go test -v ./... --target_branch="${{ env.TARGET_BRANCH }}"
+
+  go_generate:
+    env:
+      EXCLUDE_REGEX: "ava-labs/libevm/(accounts/usbwallet/trezor)$"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: "go.mod"
+
+      - name: Run `go generate`
+        run: go list ./... | grep -Pv "${EXCLUDE_REGEX}" | xargs go generate;
+
+      - name: git diff
+        run: git diff --exit-code
+
+  go_tidy:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        dir: ["./", "./libevm/tooling"]
+    defaults:
+      run:
+        working-directory: ${{ matrix.dir }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Set up Go
-        uses: actions/setup-go@v2
+        uses: actions/setup-go@v5
         with:
-          go-version: 1.21.4
-      - name: Run tests
-        run: go test -short ./...
-        env:
-          GOOS: linux
-          GOARCH: 386
+          go-version-file: "${{ matrix.dir }}/go.mod"
+      - run: go mod tidy
+      - run: git diff --exit-code

.github/workflows/labels.yml

@@ -0,0 +1,28 @@
+name: labels
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - .github/labels.yml
+      - .github/workflows/labels.yml
+  pull_request: # dry run only
+    paths:
+      - .github/labels.yml
+      - .github/workflows/labels.yml
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+
+jobs:
+  labeler:
+    permissions:
+      contents: read
+      issues: write
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: crazy-max/ghaction-github-labeler@v5
+        with:
+          dry-run: ${{ github.event_name == 'pull_request' }}

.github/workflows/libevm-delta.yml

@@ -0,0 +1,48 @@
+name: libevm delta
+
+on:
+  push:
+    branches: [main, "release/**"]
+  pull_request:
+    branches: [main, "release/**"]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+
+jobs:
+  diffs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # everything
+          fetch-tags: true
+
+      - name: Find base commit hash
+        id: base-commit
+        run: echo "LIBEVM_BASE=$(git rev-list --author "github-actions\[bot\]" --grep "rename Go module" -n 1 origin/main)" >> "$GITHUB_OUTPUT"
+
+      - name: Color-blindness a11y
+        run:
+          | # https://davidmathlogic.com/colorblind/#%23D81B60-%231E88E5-%23FFC107-%23004D40:~:text=8%20pairs%20of%20contrasting%20colors
+          git config color.diff.old "#DC3220";
+          git config color.diff.new "#005AB5";
+
+      - name: git diff ${{ steps.base-commit.outputs.LIBEVM_BASE }}
+        run: |
+          git diff --diff-filter=a --word-diff --unified=0 --color=always \
+            ${{ steps.base-commit.outputs.LIBEVM_BASE }} \
+            ':(exclude).golangci.yml' \
+            ':(exclude).github/**' \
+            ':(exclude)README.md';
+
+      - name: git diff ${{ steps.base-commit.outputs.LIBEVM_BASE }}..main
+        run: |
+          git checkout main --;
+          git diff --diff-filter=a --word-diff --unified=0 --color=always \
+            "${{ steps.base-commit.outputs.LIBEVM_BASE }}" \
+            ':(exclude).golangci.yml' \
+            ':(exclude).github/**' \
+            ':(exclude)README.md';