Rootstock stg

.cursor/rules/safe-monorepo.mdc

@@ -0,0 +1,102 @@
+---
+description: 
+globs: 
+alwaysApply: true
+---
+You are an expert developer proficient in TypeScript, Web3/Blockchain(ethers.js, Safe Ecosystem (formally known as Gnosis Safe)), React and Next.js, Expo (React Native), Tamagui, Zod, Yarn v4 (Monorepo Management), Redux, RTK.
+
+Project Structure and Environment
+
+- Follow the established project structure
+- Use the `apps` directory for Next.js and Expo applications.
+- Utilize the `packages` directory for shared code and components.
+- use `expo-plugins` directory for custom expo config plugins
+- Use `dotenv` for environment variable management.
+- Follow patterns for environment-specific configurations in `eas.json` and `next.config.js`.
+
+Code Style and Structure
+
+- Depending on the part of the code you work on, follow the code style document in the respective docs folder.
+- Write concise, technical TypeScript code with accurate examples.
+- Use functional and declarative programming patterns; avoid classes.
+- Prefer iteration and modularization over code duplication.
+- Use descriptive variable names with auxiliary verbs (e.g., `isLoading`, `hasError`).
+- Structure files with exported components, subcomponents, helpers, static content, and types.
+- Favor named exports for components and functions.
+
+TypeScript and Zod Usage
+
+- Use TypeScript for all code; prefer interfaces over types for object shapes.
+- Utilize Zod for schema validation and type inference.
+- Avoid enums; use literal types or maps instead.
+- Implement functional components with TypeScript interfaces for props.
+- follow the lint rules and don't use ts "any" type
+
+Syntax and Formatting
+
+- Use the `const` instead of `function` for pure functions.
+- Write declarative JSX with clear and readable structure.
+
+UI and Styling
+- in the mobile project utilise Tamagui for UI compoentns and styling
+- in the nextjs project use Mui
+- Implement responsive design with a mobile-first approach.
+- Ensure styling consistency between web and native applications.
+
+State Management and Data Fetching
+
+- Use Redux for state management.
+- Use Redux RTK for data fetching, caching, and synchronization.
+- Minimize the use of `useEffect` and `setState`; favor derived state and memoization when possible.
+
+Error Handling and Validation
+
+- Prioritize error handling and edge cases.
+- Handle errors and edge cases at the beginning of functions.
+- Use early returns for error conditions to avoid deep nesting.
+- Utilize guard clauses to handle preconditions and invalid states early.
+- Implement proper error logging and user-friendly error messages.
+- Use custom error types or factories for consistent error handling.
+
+Performance Optimization
+
+- Optimize for both web and mobile performance.
+- Use dynamic imports for code splitting in Next.js.
+- Implement lazy loading for non-critical components.
+- Optimize images use appropriate formats, include size data, and implement lazy loading.
+
+Monorepo Management
+
+- Follow best practices using Yarn v4 for monorepo setups.
+- Ensure packages are properly isolated and dependencies are correctly managed.
+- Use shared configurations and scripts where appropriate.
+- Utilize the workspace structure as defined in the root `package.json`.
+
+
+Testing and Quality Assurance
+- use faker to create test data
+- Write unit and integration tests for critical components.
+- Use jest and the testing libraries specified in each package
+- Ensure code coverage and quality metrics meet the project's requirements.
+- when testing Redux code prefer actual state changes test over mock calls
+- when testing functions that call network endpoints prefer Mock Service Worker (MSW) over mocking function calls
+
+
+Key Conventions
+
+- Use descriptive and meaningful commit messages.
+- Ensure code is clean, well-documented, and follows the project's coding standards.
+- Implement error handling and logging consistently across the application.
+
+Follow Official Documentation
+
+- Adhere to the official documentation for each technology used.
+- For Next.js, focus on data fetching methods and routing conventions.
+- Stay updated with the latest best practices and updates, especially for Expo, React-Native and Tamagui.
+
+Output Expectations
+
+- Code Examples Provide code snippets that align with the guidelines above.
+- Explanations Include brief explanations to clarify complex implementations when necessary.
+- Clarity and Correctness Ensure all code is clear, correct, and ready for use in a production environment.
+- Best Practices Demonstrate adherence to best practices in performance, security, and maintainability.

.env.custom

@@ -1 +1 @@
-APPLICATION_VERSION=1.36.4
+APPLICATION_VERSION=1.45.3

.eslintrc.json

@@ -1,19 +1,19 @@
 {
-  "extends": [
-    "next",
-    "prettier",
-    "plugin:prettier/recommended",
-    "plugin:storybook/recommended"
-  ],
+  "extends": ["next", "prettier", "plugin:prettier/recommended", "plugin:storybook/recommended"],
   "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "project": ["./tsconfig.json"]
+  },
   "rules": {
     "@next/next/no-img-element": "off",
     "@next/next/google-font-display": "off",
     "@next/next/google-font-preconnect": "off",
     "@next/next/no-page-custom-font": "off",
     "unused-imports/no-unused-imports-ts": "off",
     "@typescript-eslint/consistent-type-imports": "error",
+    "@typescript-eslint/await-thenable": "error",
     "no-constant-condition": "warn",
+    "no-unused-vars": ["off", { "varsIgnorePattern": "^_" }],
     "react-hooks/exhaustive-deps": [
       "warn",
       {
@@ -25,14 +25,6 @@
     "jsx-quotes": ["error", "prefer-double"],
     "react/jsx-curly-brace-presence": ["off", { "props": "never", "children": "never" }]
   },
-  "ignorePatterns": [
-    "node_modules/",
-    ".next/",
-    ".github/"
-  ],
-  "plugins": [
-    "unused-imports",
-    "@typescript-eslint",
-    "no-only-tests"
-  ]
+  "ignorePatterns": ["node_modules/", ".next/", ".github/", "cypress/", "src/types/contracts/"],
+  "plugins": ["unused-imports", "@typescript-eslint", "no-only-tests"]
 }

.github/ISSUE_TEMPLATE/bug-report.md

@@ -1,7 +1,7 @@
 ---
 name: Bug report
 about: Create an issue to fix a bug
-labels: ["bug"]
+type: 'bug'
 ---
 
 <!--
@@ -11,12 +11,14 @@ BEFORE SUBMITTING: Please search to make sure this issue hasn't been reported al
 ## Bug description
 
 ## Environment
- - Browser: Chrome
- - Wallet: MetaMask
- - Chain: Ethereum mainnet
+
+- Browser: Chrome
+- Wallet: MetaMask
+- Chain: Ethereum mainnet
 
 ## Steps to reproduce
- 1. Go to
+
+1.  Go to
 
 ## Expected result
 

.github/ISSUE_TEMPLATE/task.md

@@ -0,0 +1,15 @@
+---
+name: Task
+about: Internal implementation task – only for the Safe team!
+type: 'task'
+---
+
+## Links
+
+Epic on Notion:
+
+## What must be done
+
+## Designs/sketches
+
+## How to test it

.github/ISSUE_TEMPLATE/tech-debt.md

@@ -0,0 +1,12 @@
+---
+name: Tech debt task
+about: Internal tech debt task – only for the Safe team!
+type: 'task'
+labels: 'tech debt'
+---
+
+## Problem
+
+## Proposed solution
+
+## Dependencies & risks

.github/PULL_REQUEST_TEMPLATE.md

@@ -9,6 +9,13 @@ Resolves #
 ## Screenshots
 
 ## Checklist
-* [ ] I've tested the branch on mobile 📱
-* [ ] I've documented how it affects the analytics (if at all) 📊
-* [ ] I've written a unit/e2e test for it (if applicable) 🧑‍💻
+
+- [ ] I've tested the branch on mobile 📱
+- [ ] I've documented how it affects the analytics (if at all) 📊
+- [ ] I've written a unit/e2e test for it (if applicable) 🧑‍💻
+
+---
+
+## CLA signature
+
+With the submission of this Pull Request, I confirm that I have read and agree to the terms of the [Contributor License Agreement](https://safe.global/cla).

.github/actions/build-storybook/action.yml

@@ -0,0 +1,14 @@
+name: 'Build Storybook'
+
+description: 'Build the storybook'
+
+inputs:
+  secrets:
+    required: true
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Build Storybook
+      shell: bash
+      run: yarn workspace @safe-global/web build-storybook -o ./out/storybook

.github/actions/build/action.yml

@@ -0,0 +1,72 @@
+name: 'Build'
+
+description: 'Build the app'
+
+inputs:
+  secrets:
+    required: true
+    description: 'GitHub secrets as JSON'
+
+  prod: # id of input
+    description: 'Production build flag'
+    required: false
+
+runs:
+  using: 'composite'
+
+  steps:
+    - name: Restore Next.js Build Cache & Cypress cache
+      id: restore-nc
+      uses: ./.github/actions/cache-deps
+      with:
+        mode: restore-nc
+
+    - name: Set environment variables
+      shell: bash
+      run: |
+        if [ "${{ inputs.prod }}" = "true" ]; then
+          echo "NEXT_PUBLIC_INFURA_TOKEN=${{ fromJSON(inputs.secrets).NEXT_PUBLIC_INFURA_TOKEN }}" >> $GITHUB_ENV
+          echo "NEXT_PUBLIC_SAFE_APPS_INFURA_TOKEN=${{ fromJSON(inputs.secrets).NEXT_PUBLIC_SAFE_APPS_INFURA_TOKEN }}" >> $GITHUB_ENV
+        else
+          echo "NEXT_PUBLIC_INFURA_TOKEN=${{ fromJSON(inputs.secrets).NEXT_PUBLIC_INFURA_TOKEN_DEVSTAGING }}" >> $GITHUB_ENV
+          echo "NEXT_PUBLIC_SAFE_APPS_INFURA_TOKEN=${{ fromJSON(inputs.secrets).NEXT_PUBLIC_SAFE_APPS_INFURA_TOKEN_DEVSTAGING }}" >> $GITHUB_ENV
+        fi
+
+    - name: Build
+      shell: bash
+      run: yarn workspace @safe-global/web build
+      env:
+        NEXT_PUBLIC_IS_PRODUCTION: ${{ inputs.prod }}
+        NEXT_PUBLIC_GATEWAY_URL_PRODUCTION: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_GATEWAY_URL_PRODUCTION }}
+        NEXT_PUBLIC_GATEWAY_URL_STAGING: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_GATEWAY_URL_STAGING }}
+        NEXT_PUBLIC_SAFE_VERSION: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_SAFE_VERSION }}
+        NEXT_PUBLIC_BEAMER_ID: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_BEAMER_ID }}
+        NEXT_PUBLIC_PROD_GA_TRACKING_ID: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_PROD_GA_TRACKING_ID }}
+        NEXT_PUBLIC_TEST_GA_TRACKING_ID: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_TEST_GA_TRACKING_ID }}
+        NEXT_PUBLIC_SAFE_APPS_GA_TRACKING_ID: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_SAFE_APPS_GA_TRACKING_ID }}
+        NEXT_PUBLIC_SENTRY_DSN: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_SENTRY_DSN }}
+        NEXT_PUBLIC_DATADOG_CLIENT_TOKEN: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_DATADOG_CLIENT_TOKEN }}
+        NEXT_PUBLIC_TENDERLY_ORG_NAME: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_TENDERLY_ORG_NAME }}
+        NEXT_PUBLIC_TENDERLY_PROJECT_NAME: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_TENDERLY_PROJECT_NAME }}
+        NEXT_PUBLIC_TENDERLY_SIMULATE_ENDPOINT_URL: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_TENDERLY_SIMULATE_ENDPOINT_URL }}
+        NEXT_PUBLIC_WC_PROJECT_ID: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_WC_PROJECT_ID }}
+        NEXT_PUBLIC_SAFE_RELAY_SERVICE_URL_PRODUCTION: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_SAFE_GELATO_RELAY_SERVICE_URL_PRODUCTION }}
+        NEXT_PUBLIC_SAFE_RELAY_SERVICE_URL_STAGING: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_SAFE_GELATO_RELAY_SERVICE_URL_STAGING }}
+        NEXT_PUBLIC_IS_OFFICIAL_HOST: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_IS_OFFICIAL_HOST }}
+        NEXT_PUBLIC_BRAND_LOGO: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_BRAND_LOGO }}
+        NEXT_PUBLIC_BRAND_NAME: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_BRAND_NAME }}
+        NEXT_PUBLIC_BLOCKAID_CLIENT_ID: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_BLOCKAID_CLIENT_ID }}
+        NEXT_PUBLIC_FIREBASE_OPTIONS_PRODUCTION: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_FIREBASE_OPTIONS_PRODUCTION }}
+        NEXT_PUBLIC_FIREBASE_OPTIONS_STAGING: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_FIREBASE_OPTIONS_STAGING }}
+        NEXT_PUBLIC_FIREBASE_VAPID_KEY_PRODUCTION: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_FIREBASE_VAPID_KEY_PRODUCTION }}
+        NEXT_PUBLIC_FIREBASE_VAPID_KEY_STAGING: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_FIREBASE_VAPID_KEY_STAGING }}
+        NEXT_PUBLIC_SPINDL_SDK_KEY: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_SPINDL_SDK_KEY }}
+        NEXT_PUBLIC_ECOSYSTEM_ID_ADDRESS: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_ECOSYSTEM_ID_ADDRESS }}
+        NEXT_PUBLIC_MIXPANEL_TOKEN: ${{ fromJSON(inputs.secrets).NEXT_PUBLIC_MIXPANEL_TOKEN }}
+
+    - name: Save Next.js Build Cache & Cypress cache
+      if: steps.restore-nc.outputs.cache-hit-nc != 'true'
+      uses: ./.github/actions/cache-deps
+      with:
+        mode: save-nc
+        key: ${{ steps.restore-nc.outputs.computed-cache-key-nc }}