feat: Add debugging process document between StarkLotto and Debug_Starklotto

.github/workflows/demo.yaml

@@ -19,17 +19,6 @@ jobs:
           token: ${{ secrets.ORG_GITHUB_TOKEN }}
           path: source_repo
 
-      - name: Install scarb
-        uses: software-mansion/setup-scarb@v1
-        with:
-          tool-versions: ./.tool-versions
-          scarb-lock: ./packages/snfoundry/contracts/Scarb.lock
-
-      - name: Install snfoundryup
-        uses: foundry-rs/setup-snfoundry@v3
-        with:
-          tool-versions: ./.tool-versions
-
       - name: Modify scaffoldConfig in Source Repository
         run: |
           cd source_repo
@@ -39,38 +28,21 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v3
         with:
-          node-version: 22
+          node-version: 20
           registry-url: "https://registry.yarnpkg.com"
 
-      # TODO: setup yarn cache
-      - name: Install dependencies
-        run: |
-          cd source_repo
-          yarn install
-
-      - name: Deploy contracts to Sepolia
-        if: success()
-        id: deploy-contract
-        env:
-          PRIVATE_KEY_SEPOLIA: ${{ secrets.PRIVATE_KEY_SEPOLIA }}
-          ACCOUNT_ADDRESS_SEPOLIA: ${{ secrets.ACCOUNT_ADDRESS_SEPOLIA }}
-          RPC_URL_SEPOLIA: ${{ secrets.RPC_URL_SEPOLIA }}
-        run: |
-          cd source_repo
-          yarn deploy --network sepolia
-
       - name: Deploy to vercel
         if: success()
         id: deploy
         env:
           VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
           VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
           VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
-          RPC_URL_SEPOLIA: ${{ secrets.RPC_URL_SEPOLIA }}
         run: |
           cd source_repo
+          yarn install
           vercel link --yes --project $VERCEL_PROJECT_ID --token $VERCEL_TOKEN --scope $VERCEL_ORG_ID
-          vercel --build-env NEXT_PUBLIC_IGNORE_BUILD_ERROR=true --build-env NEXT_PUBLIC_SEPOLIA_PROVIDER_URL=$RPC_URL_SEPOLIA --prod --token $VERCEL_TOKEN --scope $VERCEL_ORG_ID
+          vercel --build-env NEXT_PUBLIC_IGNORE_BUILD_ERROR=true --prod --token $VERCEL_TOKEN --scope $VERCEL_ORG_ID
 
       - name: Notify Slack on Success
         if: success()

.github/workflows/main.yml

@@ -2,72 +2,54 @@ name: Next.js CI
 
 on:
   push:
+    branches: [dev]          
     paths:
-      - "packages/snfoundry/contracts/**"
       - "packages/nextjs/**"
+      - ".github/workflows/**"
   pull_request:
-    branches:
-      - main
-      - develop
+    branches: [dev]          
     paths:
       - "packages/nextjs/**"
-      - "packages/snfoundry/**"
+      - ".github/workflows/**"
+
 
 jobs:
-  ci:
-    runs-on: ${{ matrix.os }}
+  build-and-test:
+    runs-on: ubuntu-latest
 
     strategy:
       matrix:
-        os: [ubuntu-latest]
-        node: [lts/*]
+        node-version: [20.x]
 
     steps:
-      - name: Checkout
-        uses: actions/checkout@master
+      - name: 📦 Checkout code
+        uses: actions/checkout@v3
 
-      - name: Setup node env
+      - name: 🔧 Setup Node.js
         uses: actions/setup-node@v3
         with:
-          node-version: ${{ matrix.node }}
-          cache: "yarn"
+          node-version: ${{ matrix.node-version }}
+          cache: yarn
 
-      - name: Install dependencies (Next.js)
+      - name: 📦 Install dependencies
         run: yarn install --immutable
         working-directory: ./packages/nextjs
 
-      - name: Install scarb
-        uses: software-mansion/setup-scarb@v1
-        with:
-          tool-versions: ./.tool-versions
-          scarb-lock: ./packages/snfoundry/contracts/Scarb.lock
-
-      - name: Install snfoundryup
-        uses: foundry-rs/setup-snfoundry@v3
-        with:
-          tool-versions: ./.tool-versions
-
-      - name: Build Contracts
-        run: yarn compile
-
-      - name: Run smart contract tests
+      - name: 🧪 Run Vitest
         run: yarn test
-
-      - name: Check Code Format
-        run: yarn format:check
-
-      - name: Run Next.js lint
-        run: yarn next:lint --max-warnings=0
+        working-directory: ./packages/nextjs
+      - name: 🔍 Run ESLint
+        run: yarn lint
         working-directory: ./packages/nextjs
 
-      - name: Check typings on Next.js
-        run: yarn next:check-types
+      - name: 🎨 Format Check
+        run: yarn format:check
         working-directory: ./packages/nextjs
 
-      - name: Run Next.js tests
-        run: yarn test
+      - name: 🔡 Type Check
+        run: yarn check-types
         working-directory: ./packages/nextjs
 
-      - name: Build Next.js project
+      - name: 🏗️ Build App
         run: yarn build
         working-directory: ./packages/nextjs

.github/workflows/release-create-stark.yaml

@@ -75,7 +75,7 @@ jobs:
 
       - name: Copy Files to Destination Repository
         run: |
-          rsync -av --delete \
+            rsync -av --delete \
             --exclude='.git/' \
             --include='.github/' \
             --include='.github/workflows/' \
@@ -86,9 +86,9 @@ jobs:
             --exclude='CHANGELOG*' \
             --exclude='CONTRIBUTING*' \
             source_repo/ destination_repo/templates/base
-          cd destination_repo
-          git add .
-          git commit -m "chore: sync files from scaffold-stark-2 [skip ci]"
+            cd destination_repo
+            git add .
+            git commit -m "chore: sync files from scaffold-stark-2 [skip ci]"
 
       - name: Format .gitignore files
         run: |
@@ -119,7 +119,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v3
         with:
-          node-version: "22"
+          node-version: "16"
           registry-url: "https://registry.npmjs.org/"
 
       - name: Publish release

.github/workflows/snfoundry.yml

@@ -0,0 +1,49 @@
+name: Snfoundry Contracts CI
+
+on:
+  push:
+    branches: [dev]
+    paths:
+      - "packages/snfoundry/contracts/**"
+  pull_request:
+    branches: [dev]
+    paths:
+      - "packages/snfoundry/contracts/**"
+      - ".github/workflows/**"
+
+jobs:
+  build-and-test-contracts:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Setup scarb
+        uses: software-mansion/setup-scarb@v1
+        with:
+          tool-versions: ./.tool-versions
+          scarb-lock: ./packages/snfoundry/contracts/Scarb.lock
+
+      - name: Setup snfoundry
+        uses: foundry-rs/setup-snfoundry@v3
+        with:
+          tool-versions: ./.tool-versions
+
+      - name: Compile contracts
+        run: scarb build
+        working-directory: ./packages/snfoundry/contracts
+
+      # Diagnóstico previo: lista todos los tests detectados
+      - name: List tests
+        run: snforge test -- --list
+        working-directory: ./packages/snfoundry/contracts
+
+      # Ejecuta tests en modo verbose, imprime logs y stacktrace si algo falla.
+      # SNFORGE_FORMAT=pretty fuerza salida legible (no JSON), evitando parsers aguas abajo.
+      - name: Run snfoundry tests (verbose + logs)
+        env:
+          RUST_BACKTRACE: 1
+          SNFORGE_FORMAT: pretty
+        run: snforge test -- -v --print-logs
+        working-directory: ./packages/snfoundry/contracts