Skip to content

GHA: bump protos version #95

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wilson-cl wants to merge 4 commits into
base: main
Choose a base branch
from
Open

GHA: bump protos version #95

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
a88a130
add comments
wilson-cl Jan 20, 2026
9dedacc
add releaes tag
wilson-cl Jan 20, 2026
fb63a2d
skip tag if exists
wilson-cl Jan 20, 2026
1c76bcb
Merge branch 'main' into feat/bump-protos-version
wilson-cl Feb 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
171 changes: 171 additions & 0 deletions .github/workflows/bump-chainlink-protos.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,171 @@
# =============================================================================
# Bump chainlink-protos Version Workflow
# =============================================================================
#
# This workflow updates the chainlink-protos/cre/go dependency in the EVM
# capability module, regenerates code, and creates a PR with version tags.
#
# TRIGGERS:
# - workflow_dispatch: Manual trigger via GitHub UI or gh CLI
# - repository_dispatch: Triggered by external workflows (e.g., chainlink-protos repo)
#
# PARAMETERS:
# version (required):
# The new chainlink-protos/cre/go version to bump to.
# Format: v0.0.0-YYYYMMDDHHMMSS-<commit-hash> (e.g., v0.0.0-20251202154221-30236deecda8)
#
# evm_cap_version (optional):
# Explicit version tag for EVM capability (e.g., v1.0.0-beta.2).
# If empty, auto-increments from the latest capabilities/blockchain/evm/* tag.
#
# sdk_version (optional):
# Explicit version tag for SDK (e.g., v1.1.2).
# If empty, auto-increments from the latest v*.*.* tag.
#
# skip_tagging (optional, default: false):
# If true, skips version calculation and tagging entirely.
#
# CROSS-REPO TRIGGER EXAMPLE:
# uses: peter-evans/repository-dispatch@v3
# with:
# token: ${{ secrets.PAT_TOKEN }}
# repository: smartcontractkit/cre-sdk-go
# event-type: bump-chainlink-protos
# client-payload: '{"version": "v0.0.0-20251202154221-30236deecda8"}'
#
# =============================================================================

name: Bump chainlink-protos version

on:
# Manual trigger via GitHub UI or CLI
workflow_dispatch:
inputs:
version:
description: 'New version for github.com/smartcontractkit/chainlink-protos/cre/go (e.g., v0.0.0-20251202154221-30236deecda8)'
required: true
type: string
evm_cap_version:
description: 'EVM capability tag (e.g., v1.0.0-beta.2). Leave empty to auto-increment.'
required: false
type: string
sdk_version:
description: 'SDK version tag (e.g., v1.1.2). Leave empty to auto-increment.'
required: false
type: string
skip_tagging:
description: 'Skip version tagging entirely'
required: false
type: boolean
default: false

# External trigger from other workflows (e.g., chainlink-protos repo)
repository_dispatch:
types: [bump-chainlink-protos]

jobs:
bump-version:
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write
steps:
# Clone repo with full history to access git tags for version calculation
- name: Checkout
uses: actions/checkout@0ad4b8fadaa221de15dcec353f45205ec38ea70b # v4.1.4
with:
fetch-depth: 0
fetch-tags: true

- name: Set up Go
uses: actions/setup-go@0c52d547c9bc32b1aa3301fd7a9cb496313a4491 # v5.0.0
with:
go-version-file: "go.mod"

# Update the chainlink-protos dependency in the EVM capability module
- name: Bump chainlink-protos version
working-directory: capabilities/blockchain/evm
run: |
go get github.com/smartcontractkit/chainlink-protos/cre/go@${{ inputs.version || github.event.client_payload.version }}
go mod tidy

# Regenerate all protobuf and SDK code to reflect the updated protos
- name: Run make clean-generate
run: make clean-generate

# Determine next version tags (uses explicit input or auto-increments from latest git tags)
- name: Calculate next versions
if: ${{ !inputs.skip_tagging && !github.event.client_payload.skip_tagging }}
id: calc-versions
run: |
./script/calculate-next-versions.sh \
"${{ inputs.evm_cap_version || github.event.client_payload.evm_cap_version || '' }}" \
"${{ inputs.sdk_version || github.event.client_payload.sdk_version || '' }}"

# Construct PR labels including version info for post-merge tagging workflows
- name: Build labels list
id: labels
run: |
LABELS="bump-chainlink-protos"
if [ -n "${{ steps.calc-versions.outputs.evm_version }}" ]; then
LABELS="${LABELS},evm:${{ steps.calc-versions.outputs.evm_version }}"
fi
if [ -n "${{ steps.calc-versions.outputs.sdk_version }}" ]; then
LABELS="${LABELS},sdk:${{ steps.calc-versions.outputs.sdk_version }}"
fi
echo "labels=${LABELS}" >> $GITHUB_OUTPUT
echo "Labels: ${LABELS}"

# Create or update the PR with all changes
- name: Create Pull Request
id: create-pr
uses: peter-evans/create-pull-request@271a8d0340265f705b14b6d32b9829c1cb33d45e # v7.0.8
env:
VERSION: ${{ inputs.version || github.event.client_payload.version }}
EVM_VERSION: ${{ steps.calc-versions.outputs.evm_version || '' }}
SDK_VERSION: ${{ steps.calc-versions.outputs.sdk_version || '' }}
with:
token: ${{ secrets.GITHUB_TOKEN }}
commit-message: "chore: bump chainlink-protos/cre/go to ${{ env.VERSION }}"
branch: chore/bump-chainlink-protos-${{ env.VERSION }}
delete-branch: true
title: "chore: bump chainlink-protos/cre/go to ${{ env.VERSION }}"
body: |
This PR bumps `github.com/smartcontractkit/chainlink-protos/cre/go` to version `${{ env.VERSION }}`.

Changes:
- Updated dependency in `capabilities/blockchain/evm/go.mod`
- Ran `make clean-generate` to regenerate code

**Tags to be created after merge:**
- EVM capability: `capabilities/blockchain/evm/${{ env.EVM_VERSION || 'skipped' }}`
- SDK: `${{ env.SDK_VERSION || 'skipped' }}`

---
*This PR was automatically created by the bump-chainlink-protos workflow.*
labels: ${{ steps.labels.outputs.labels }}

# Write a summary to the GitHub Actions UI for visibility
- name: Output summary
env:
VERSION: ${{ inputs.version || github.event.client_payload.version }}
EVM_VERSION: ${{ steps.calc-versions.outputs.evm_version || 'skipped' }}
SDK_VERSION: ${{ steps.calc-versions.outputs.sdk_version || 'skipped' }}
run: |
echo "## Bump chainlink-protos Summary" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "### Version Update" >> $GITHUB_STEP_SUMMARY
echo "- **chainlink-protos/cre/go:** \`${{ env.VERSION }}\`" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "### Pull Request" >> $GITHUB_STEP_SUMMARY
if [ "${{ steps.create-pr.outputs.pull-request-number }}" != "" ]; then
echo "- **PR Number:** #${{ steps.create-pr.outputs.pull-request-number }}" >> $GITHUB_STEP_SUMMARY
echo "- **PR URL:** ${{ steps.create-pr.outputs.pull-request-url }}" >> $GITHUB_STEP_SUMMARY
echo "- **PR Operation:** ${{ steps.create-pr.outputs.pull-request-operation }}" >> $GITHUB_STEP_SUMMARY
else
echo "- No PR was created (no changes detected)" >> $GITHUB_STEP_SUMMARY
fi
echo "" >> $GITHUB_STEP_SUMMARY
echo "### Tags to be created after merge" >> $GITHUB_STEP_SUMMARY
echo "- **EVM capability:** \`capabilities/blockchain/evm/${{ env.EVM_VERSION }}\`" >> $GITHUB_STEP_SUMMARY
echo "- **SDK:** \`${{ env.SDK_VERSION }}\`" >> $GITHUB_STEP_SUMMARY
190 changes: 190 additions & 0 deletions .github/workflows/create-release-tags.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,190 @@
# =============================================================================
# Create Release Tags Workflow
# =============================================================================
#
# This workflow creates git tags and GitHub Releases for the EVM capability
# module and the SDK. It runs automatically when bump-chainlink-protos PRs
# are merged, or can be triggered manually.
#
# TRIGGERS:
# - pull_request (closed): Runs when a PR with 'bump-chainlink-protos' label is merged
# - workflow_dispatch: Manual trigger via GitHub UI or gh CLI
# - repository_dispatch: Triggered by external workflows
#
# PARAMETERS:
# evm_cap_version (optional):
# Version tag for EVM capability (e.g., v1.0.0-beta.2).
# Creates tag and release: capabilities/blockchain/evm/<version>
# If empty, EVM tagging is skipped.
#
# sdk_version (optional):
# Version tag for SDK (e.g., v1.1.2).
# Creates tag and release: <version> (e.g., v1.1.2)
# If empty, SDK tagging is skipped.
#
# VERSION SOURCES (in priority order):
# 1. Manual inputs (workflow_dispatch) or client_payload (repository_dispatch)
# 2. PR labels: 'evm:<version>' and 'sdk:<version>' (set by bump-chainlink-protos workflow)
#
# =============================================================================

name: Create Release Tags

on:
# Triggered when PRs are merged (filtered to bump-chainlink-protos label in job condition)
pull_request:
types: [closed]

# Manual trigger via GitHub UI or CLI
workflow_dispatch:
inputs:
evm_cap_version:
description: 'EVM capability tag (e.g., v1.0.0-beta.2). Leave empty to skip.'
required: false
type: string
sdk_version:
description: 'SDK version tag (e.g., v1.1.2). Leave empty to skip.'
required: false
type: string

# External trigger from other workflows
repository_dispatch:
types: [create-release-tags]

jobs:
create-tags:
runs-on: ubuntu-latest
# Only run if: manual trigger OR (PR was merged AND has the bump-chainlink-protos label)
if: |
github.event_name == 'workflow_dispatch' ||
github.event_name == 'repository_dispatch' ||
(github.event.pull_request.merged == true && contains(github.event.pull_request.labels.*.name, 'bump-chainlink-protos'))
permissions:
contents: write
steps:
# Clone repo with full history to create and push tags
- name: Checkout
uses: actions/checkout@0ad4b8fadaa221de15dcec353f45205ec38ea70b # v4.1.4
with:
fetch-depth: 0
fetch-tags: true

# Parse version info from inputs, dispatch payload, or PR labels
- name: Extract versions from labels or inputs
id: versions
env:
LABELS: ${{ toJson(github.event.pull_request.labels.*.name) }}
run: |
# Start with manual inputs / dispatch payload (highest priority)
EVM_VERSION="${{ inputs.evm_cap_version || github.event.client_payload.evm_cap_version || '' }}"
SDK_VERSION="${{ inputs.sdk_version || github.event.client_payload.sdk_version || '' }}"

# If triggered by PR merge, extract versions from labels
if [ "${{ github.event_name }}" == "pull_request" ]; then
echo "Extracting versions from PR labels..."
echo "Labels: $LABELS"

# Extract evm:vX.X.X label
if [ -z "$EVM_VERSION" ]; then
EVM_VERSION=$(echo "$LABELS" | jq -r '.[] | select(startswith("evm:")) | sub("evm:"; "")' | head -n1)
fi

# Extract sdk:vX.X.X label
if [ -z "$SDK_VERSION" ]; then
SDK_VERSION=$(echo "$LABELS" | jq -r '.[] | select(startswith("sdk:")) | sub("sdk:"; "")' | head -n1)
fi
fi

echo "evm_cap_version=${EVM_VERSION}" >> $GITHUB_OUTPUT
echo "sdk_version=${SDK_VERSION}" >> $GITHUB_OUTPUT

echo "EVM version: ${EVM_VERSION:-'(empty)'}"
echo "SDK version: ${SDK_VERSION:-'(empty)'}"

# Set up git identity for creating annotated tags
- name: Configure Git
run: |
git config --local user.email "github-actions[bot]@users.noreply.github.com"
git config --local user.name "github-actions[bot]"

# Create and push EVM capability tag if it doesn't already exist
- name: Create EVM capability tag
if: steps.versions.outputs.evm_cap_version != ''
env:
EVM_VERSION: ${{ steps.versions.outputs.evm_cap_version }}
run: |
TAG="capabilities/blockchain/evm/${EVM_VERSION}"
if git rev-parse "${TAG}" >/dev/null 2>&1; then
echo "Tag ${TAG} already exists, skipping tag creation"
else
echo "Creating tag: ${TAG}"
git tag -a "${TAG}" -m "Release ${TAG}"
git push origin "${TAG}"
fi

# Create GitHub Release for EVM capability (creates release even if tag existed)
- name: Create EVM capability release
if: steps.versions.outputs.evm_cap_version != ''
uses: softprops/action-gh-release@c95fe1489396fe8a9eb87c0abf8aa5b2ef267fda # v2.2.1
with:
tag_name: capabilities/blockchain/evm/${{ steps.versions.outputs.evm_cap_version }}
name: EVM Capability ${{ steps.versions.outputs.evm_cap_version }}
body: |
Release of the EVM blockchain capability module.

**Tag:** `capabilities/blockchain/evm/${{ steps.versions.outputs.evm_cap_version }}`

To use this version:
```
go get github.com/smartcontractkit/cre-sdk-go/capabilities/blockchain/evm@${{ steps.versions.outputs.evm_cap_version }}
```
prerelease: ${{ contains(steps.versions.outputs.evm_cap_version, 'beta') || contains(steps.versions.outputs.evm_cap_version, 'alpha') }}

# Create and push SDK tag if it doesn't already exist
- name: Create SDK tag
if: steps.versions.outputs.sdk_version != ''
env:
SDK_VERSION: ${{ steps.versions.outputs.sdk_version }}
run: |
TAG="${SDK_VERSION}"
if git rev-parse "${TAG}" >/dev/null 2>&1; then
echo "Tag ${TAG} already exists, skipping tag creation"
else
echo "Creating tag: ${TAG}"
git tag -a "${TAG}" -m "Release ${TAG}"
git push origin "${TAG}"
fi

# Create GitHub Release for SDK (creates release even if tag existed)
- name: Create SDK release
if: steps.versions.outputs.sdk_version != ''
uses: softprops/action-gh-release@c95fe1489396fe8a9eb87c0abf8aa5b2ef267fda # v2.2.1
with:
tag_name: ${{ steps.versions.outputs.sdk_version }}
name: SDK ${{ steps.versions.outputs.sdk_version }}
body: |
Release of the CRE SDK for Go.

**Tag:** `${{ steps.versions.outputs.sdk_version }}`

To use this version:
```
go get github.com/smartcontractkit/cre-sdk-go@${{ steps.versions.outputs.sdk_version }}
```
prerelease: ${{ contains(steps.versions.outputs.sdk_version, 'beta') || contains(steps.versions.outputs.sdk_version, 'alpha') }}

# Write a summary to the GitHub Actions UI for visibility
- name: Summary
run: |
echo "## Releases Created" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
if [ -n "${{ steps.versions.outputs.evm_cap_version }}" ]; then
echo "- **EVM Capability:** \`capabilities/blockchain/evm/${{ steps.versions.outputs.evm_cap_version }}\`" >> $GITHUB_STEP_SUMMARY
else
echo "- EVM capability: skipped (not specified)" >> $GITHUB_STEP_SUMMARY
fi
if [ -n "${{ steps.versions.outputs.sdk_version }}" ]; then
echo "- **SDK:** \`${{ steps.versions.outputs.sdk_version }}\`" >> $GITHUB_STEP_SUMMARY
else
echo "- SDK: skipped (not specified)" >> $GITHUB_STEP_SUMMARY
fi
Loading
Loading