Create initial release

.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/[email protected]/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "restricted",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.eslintrc.json

@@ -0,0 +1,20 @@
+{
+    "env": {
+        "browser": true,
+        "es2021": true
+    },
+    "extends": [
+        "eslint:recommended",
+        "plugin:@typescript-eslint/recommended"
+    ],
+    "parser": "@typescript-eslint/parser",
+    "parserOptions": {
+        "ecmaVersion": "latest",
+        "sourceType": "module"
+    },
+    "plugins": [
+        "@typescript-eslint"
+    ],
+    "rules": {
+    }
+}

.github/actions/build-test-image/action.yml

@@ -0,0 +1,53 @@
+name: Build Test Image
+description: A composite action that allows building and publishing the test remote runner image
+
+inputs:
+  tag:
+    description: The tag to use by default and to use for checking image existance
+    default: ${{ github.sha }}
+    required: false
+  other_tags:
+    description: Other tags to push if needed
+    required: false
+  QA_AWS_ROLE_TO_ASSUME:
+    description: The AWS role to assume as the CD user, if any. Used in configuring the docker/login-action
+    required: true
+  QA_AWS_REGION:
+    description: The AWS region the ECR repository is located in, should only be needed for public ECR repositories, used in configuring docker/login-action
+    required: true
+  QA_AWS_ACCOUNT_NUMBER:
+    description: The AWS region the ECR repository is located in, should only be needed for public ECR repositories, used in configuring docker/login-action
+    required: true
+
+runs:
+  using: composite
+  steps:
+    - name: Install Cairo
+      uses: ./.github/actions/install-cairo
+    - name: Check if image exists
+      id: check-image
+      uses: smartcontractkit/chainlink-github-actions/docker/image-exists@fc3e0df622521019f50d772726d6bf8dc919dd38 # v2.3.19
+      with:
+        repository: chainlink-starknet-tests
+        tag: ${{ inputs.tag }}
+        AWS_REGION: ${{ inputs.QA_AWS_REGION }}
+        AWS_ROLE_TO_ASSUME: ${{ inputs.QA_AWS_ROLE_TO_ASSUME }}
+    - name: Build and Publish Test Runner
+      if: steps.check-image.outputs.exists == 'false'
+      uses: smartcontractkit/chainlink-github-actions/docker/build-push@fc3e0df622521019f50d772726d6bf8dc919dd38 # v2.3.19
+      with:
+        tags: |
+          ${{ inputs.QA_AWS_ACCOUNT_NUMBER }}.dkr.ecr.${{ inputs.QA_AWS_REGION }}.amazonaws.com/chainlink-starknet-tests:${{ inputs.tag }}
+          ${{ inputs.other_tags }}
+        file: ./integration-tests/test.Dockerfile
+        build-args: |
+          SUITES="smoke soak"
+        AWS_REGION: ${{ inputs.QA_AWS_REGION }}
+        AWS_ROLE_TO_ASSUME: ${{ inputs.QA_AWS_ROLE_TO_ASSUME }}
+    - name: Print Image Built
+      env:
+        INPUTS_TAG: ${{ inputs.tag }}
+      shell: sh
+      run: |
+        echo "### chainlink-starknet-tests image tag for this test run :ship:" >> $GITHUB_STEP_SUMMARY
+        echo "\`${INPUTS_TAG}\`" >> $GITHUB_STEP_SUMMARY

.github/actions/install-cairo/action.yml

@@ -0,0 +1,33 @@
+name: Install Cairo and Scarb
+description: A composite action that installs cairo and scarb binaries
+
+inputs:
+  cairo_version:
+    description: Cairo release version
+    default: "v2.6.4"
+    required: false
+  scarb_version:
+    description: Scarb release version
+    default: "v2.6.5"
+    required: false
+
+runs:
+  using: composite
+  steps:
+    - name: Setup Cairo for Linux
+      id: install-cairo
+      shell: bash
+      run: |
+        wget https://github.com/starkware-libs/cairo/releases/download/${{ inputs.cairo_version }}/release-x86_64-unknown-linux-musl.tar.gz
+        tar -xvzf release-x86_64-unknown-linux-musl.tar.gz
+        mv -vf cairo cairo-build
+        echo "$GITHUB_WORKSPACE/cairo-build/bin" >> $GITHUB_PATH
+
+    - name: Setup Scarb for Linux
+      id: install-scarb
+      shell: bash
+      run: |
+        wget https://github.com/software-mansion/scarb/releases/download/${{ inputs.scarb_version }}/scarb-${{ inputs.scarb_version }}-x86_64-unknown-linux-musl.tar.gz
+        tar -xvzf scarb-${{ inputs.scarb_version }}-x86_64-unknown-linux-musl.tar.gz
+        mv -vf scarb-${{ inputs.scarb_version }}-x86_64-unknown-linux-musl scarb-build
+        echo "$GITHUB_WORKSPACE/scarb-build/bin" >> $GITHUB_PATH

.github/actions/install-starknet-foundry/action.yml

@@ -0,0 +1,19 @@
+name: Install Starknet Foundry (snforge and sncast)
+description: A composite action that installs the snforge and sncast binaries
+
+inputs:
+  starknet_foundry_version:
+    description: Starknet Foundry release version
+    default: "0.21.0"
+    required: false
+
+runs:
+  using: composite
+  steps:
+    - name: Setup Starknet Foundry for Linux
+      id: install-starknet-foundry
+      shell: bash
+      run: |
+        curl -L https://raw.githubusercontent.com/foundry-rs/starknet-foundry/master/scripts/install.sh | sh 
+        snfoundryup -v ${{ inputs.starknet_foundry_version }}
+

.github/dependabot.yml

@@ -0,0 +1,9 @@
+# Please see the documentation for all configuration options:
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/workflows/changesets.yml

@@ -0,0 +1,46 @@
+name: Changesets
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  changesets:
+    name: Changesets
+    runs-on: ubuntu-latest
+    steps:
+      # Checkout this repository
+      - name: Checkout Repo
+        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
+        with:
+          # This makes Actions fetch all Git history so that Changesets can generate changelogs with the correct commits
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+      # Install nix
+      - name: Install Nix
+        uses: cachix/install-nix-action@ba0dd844c9180cbf77aa72a116d6fbc515d0e87b # v27
+        with:
+          nix_path: nixpkgs=channel:nixos-unstable
+      # Install dependencies using yarn
+      - name: Install Dependencies
+        run: nix develop -c yarn install --frozen-lockfile
+      # Create PR that will update versions or trigger publish
+      - name: Create Release Pull Request
+        uses: changesets/action@aba318e9165b45b7948c60273e0b72fce0a64eb9 # v1.4.7
+        id: changesets
+        with:
+          publish: nix develop -c yarn release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+      # Dispatch Relayer release
+      - name: Release relayer
+        run: gh workflow run .github/workflows/release/starknet-relayer.yml
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      # Dispatch Gauntlet CLI build & release
+      - name: Build and release Gauntlet CLI
+        run: gh workflow run .github/workflows/release/starknet-gauntlet-cli.yml
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/contracts.yml

@@ -0,0 +1,45 @@
+name: Contracts
+
+on:
+  push:
+    branches:
+      - develop
+      - main
+  pull_request:
+
+jobs:
+  contracts_run_ts_tests:
+    name: Run Typescript Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout sources
+        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
+
+      - name: Install Nix
+        uses: cachix/install-nix-action@ba0dd844c9180cbf77aa72a116d6fbc515d0e87b # v27
+        with:
+          nix_path: nixpkgs=channel:nixos-unstable
+
+      - name: Install Cairo
+        uses: ./.github/actions/install-cairo
+
+      - name: Test
+        run: nix develop -c make test-ts-contracts
+
+  contracts_run_cairo_tests:
+    name: Run Cairo Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout sources
+        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
+
+      - name: Install Nix
+        uses: cachix/install-nix-action@ba0dd844c9180cbf77aa72a116d6fbc515d0e87b # v27
+        with:
+          nix_path: nixpkgs=channel:nixos-unstable
+
+      - name: Install Cairo
+        uses: ./.github/actions/install-cairo
+
+      - name: Test
+        run: nix develop -c make test-cairo-contracts

.github/workflows/examples.yml

@@ -0,0 +1,30 @@
+name: Example Contracts
+
+on:
+  push:
+    branches:
+      - develop
+      - main
+  pull_request:
+
+jobs:
+  run_examples_tests:
+    name: Run Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout sources
+        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
+
+      - name: Install Nix
+        uses: cachix/install-nix-action@ba0dd844c9180cbf77aa72a116d6fbc515d0e87b # v27
+        with:
+          nix_path: nixpkgs=channel:nixos-unstable
+
+      - name: Install Cairo
+        uses: ./.github/actions/install-cairo
+
+      - name: Install Starknet Foundry
+        uses: ./.github/actions/install-starknet-foundry
+
+      - name: Test
+        run: nix develop -c make test-examples