Release 20260XXX

.changeset/cozy-poets-go.md

@@ -0,0 +1,6 @@
+---
+"@human-protocol/sdk": major
+"@human-protocol/python-sdk": major
+---
+
+Updated KV Store utils in sdk to return empty string in case no value in subgraph instead of throwing and error

.changeset/crisp-buckets-agree.md

@@ -0,0 +1,5 @@
+---
+"@human-protocol/sdk": minor
+---
+
+Added typed subgraph errors (SubgraphRequestError, SubgraphBadIndexerError) and wrapped subgraph request failures with these classes

.changeset/nine-seas-dream.md

@@ -0,0 +1,11 @@
+---
+"@human-protocol/core": major
+"@human-protocol/sdk": major
+"@human-protocol/python-sdk": major
+---
+
+Updated escrow contracts and SDKs to fetch oracle fees from `KVStore` instead of passing fee values during escrow setup. `Escrow.setup(...)` and factory setup flows no longer accept fee arguments, escrow deployments now require a `KVStore` address, and fee validation is enforced on-chain from `KVStore` values, including per-oracle and total fee limits. Added upgrade-safe `EscrowFactory` support for storing and updating the `KVStore` address.
+
+Updated TypeScript and Python SDK escrow setup APIs to match the new contract signatures by removing fee arguments from `setup(...)` and create-and-setup helpers. Existing config fee fields remain optional for backward compatibility but are ignored by setup calls.
+
+Updated SDKs to use a dedicated HMT stats subgraph endpoint for HMT statistics methods and removed `totalAmountPaid` and `averageAmountPerWorker` from `IDailyPayment`.

.changeset/shaggy-months-post.md

@@ -0,0 +1,5 @@
+---
+"@human-protocol/sdk": patch
+---
+
+Split combined domain files into module folders with explicit files per responsibility.

.github/workflows/cd-packages.yaml

@@ -34,7 +34,7 @@ jobs:
     steps:
       - uses: actions/checkout@v6
         with:
-          token: ${{ secrets.GH_GITBOOK_TOKEN }}
+          token: ${{ secrets.RELEASE_GH_TOKEN }}
       - name: Setup git identity
         run: |
           git config --global user.name "github-actions[bot]"

.github/workflows/cd-python-sdk.yaml

@@ -25,7 +25,7 @@ jobs:
     steps:
       - uses: actions/checkout@v6
         with:
-          token: ${{ secrets.GH_GITBOOK_TOKEN }}
+          token: ${{ secrets.RELEASE_GH_TOKEN }}
       - name: Setup git identity
         run: |
           git config --global user.name "github-actions[bot]"

.github/workflows/cd-subgraph.yaml → .github/workflows/cd-subgraph-hmt.yaml

@@ -1,4 +1,8 @@
-name: Subgraph deployment
+name: HMT Subgraph Deployment
+
+permissions:
+  contents: read
+
 on:
   workflow_dispatch:
     inputs:
@@ -11,7 +15,7 @@ on:
 
 jobs:
   subgraph:
-    name: Deploy Subgraph
+    name: Deploy HMT Subgraph
     runs-on: ubuntu-latest
     strategy:
       matrix:
@@ -45,17 +49,17 @@ jobs:
             fi
           done
           echo "Match found: $MATCH"
-          echo "::set-output name=continue::$MATCH"
+          echo "continue=$MATCH" >> "$GITHUB_OUTPUT"
       - name: Install dependencies
         if: steps.filter_networks.outputs.continue == 'true'
-        run: yarn workspaces focus @tools/subgraph
+        run: yarn workspaces focus @tools/subgraph-hmt
       - name: Build packages (scoped)
         if: steps.filter_networks.outputs.continue == 'true'
-        run: yarn workspaces foreach -Rpt --from @tools/subgraph run build
+        run: yarn workspaces foreach -Rpt --from @tools/subgraph-hmt run build
       - name: Generate and build Subgraph
         if: steps.filter_networks.outputs.continue == 'true'
         run: yarn generate && yarn build
-        working-directory: ./packages/sdk/typescript/subgraph
+        working-directory: ./packages/subgraph/hmt
         env:
           NETWORK: ${{ matrix.network.name }}
       - name: Authenticate & Deploy
@@ -64,9 +68,9 @@ jobs:
           API_KEY: ${{ secrets.HP_GRAPH_API_KEY }}
           NETWORK: ${{ matrix.network.name }}
           LABEL: ${{ github.event.inputs.label }}
-        working-directory: ./packages/sdk/typescript/subgraph
+        working-directory: ./packages/subgraph/hmt
         run: |
           yarn dlx @graphprotocol/graph-cli@0.71.2 \
             auth --studio "$API_KEY"
           yarn dlx @graphprotocol/graph-cli@0.71.2 \
-            deploy --studio ${NETWORK} -l ${LABEL}
+            deploy --studio hmt-${NETWORK} -l ${LABEL}

.github/workflows/cd-subgraph-human.yaml

@@ -0,0 +1,76 @@
+name: Human Protocol Subgraph Deployment
+
+permissions:
+  contents: read
+
+on:
+  workflow_dispatch:
+    inputs:
+      label:
+        description: "New version label"
+        required: true
+      networks:
+        description: "Comma-separated list of networks to deploy"
+        required: true
+
+jobs:
+  subgraph:
+    name: Deploy Human Protocol Subgraph
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        network:
+          - name: amoy
+          - name: bsc-testnet
+          - name: bsc
+          - name: ethereum
+          - name: polygon
+          - name: sepolia
+      fail-fast: true
+      max-parallel: 3
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: .nvmrc
+          cache: yarn
+      - name: Filter Networks
+        id: filter_networks
+        run: |
+          INPUT_NETWORKS="${{ github.event.inputs.networks }}"
+          IFS=',' read -ra NETWORK_LIST <<< "$INPUT_NETWORKS"
+          echo "Input networks: $INPUT_NETWORKS"
+          echo "Current matrix network: ${{ matrix.network.name }}"
+          MATCH=false
+          for network in "${NETWORK_LIST[@]}"; do
+            if [[ "${network}" == "${{ matrix.network.name }}" ]]; then
+              MATCH=true
+              break
+            fi
+          done
+          echo "Match found: $MATCH"
+          echo "continue=$MATCH" >> "$GITHUB_OUTPUT"
+      - name: Install dependencies
+        if: steps.filter_networks.outputs.continue == 'true'
+        run: yarn workspaces focus @tools/subgraph-human-protocol
+      - name: Build packages (scoped)
+        if: steps.filter_networks.outputs.continue == 'true'
+        run: yarn workspaces foreach -Rpt --from @tools/subgraph-human-protocol run build
+      - name: Generate and build Subgraph
+        if: steps.filter_networks.outputs.continue == 'true'
+        run: yarn generate && yarn build
+        working-directory: ./packages/subgraph/human-protocol
+        env:
+          NETWORK: ${{ matrix.network.name }}
+      - name: Authenticate & Deploy
+        if: steps.filter_networks.outputs.continue == 'true'
+        env:
+          API_KEY: ${{ secrets.HP_GRAPH_API_KEY }}
+          NETWORK: ${{ matrix.network.name }}
+          LABEL: ${{ github.event.inputs.label }}
+        working-directory: ./packages/subgraph/human-protocol
+        run: |
+          yarn dlx @graphprotocol/graph-cli@0.71.2 \
+            auth --studio "$API_KEY"
+          yarn dlx @graphprotocol/graph-cli@0.71.2 \
+            deploy --studio human-${NETWORK} -l ${LABEL}

.github/workflows/ci-dependency-review.yaml

@@ -14,6 +14,6 @@ jobs:
     steps:
       - uses: actions/checkout@v6
       - name: Dependency Review
-        uses: actions/dependency-review-action@v4.8.2
+        uses: actions/dependency-review-action@v4.9.0
         with:
           show-openssf-scorecard: false

.github/workflows/ci-test-subgraph.yaml → .github/workflows/ci-test-subgraph-hmt.yaml

@@ -1,15 +1,18 @@
-name: Subgraph check
+name: HMT Subgraph check
 
 on:
   push:
     branches: "**"
     paths:
       - "packages/core/**"
-      - "packages/sdk/typescript/subgraph/**"
+      - "packages/subgraph/hmt/**"
+
+permissions:
+  contents: read
 
 jobs:
   subgraph-test:
-    name: Subgraph Test
+    name: HMT Subgraph Test
     # TODO: Use ubuntu-latest when graph binary is not failing on ubuntu 24.04
     runs-on: ubuntu-22.04
     steps:
@@ -19,10 +22,10 @@ jobs:
           node-version-file: .nvmrc
           cache: yarn
       - name: Install dependencies
-        run: yarn workspaces focus @tools/subgraph
+        run: yarn workspaces focus @tools/subgraph-hmt
       - name: Build core package
         run: yarn workspace @human-protocol/core build
       - name: Generate manifest for Polygon for tests
-        run: NETWORK=polygon yarn workspace @tools/subgraph generate
+        run: NETWORK=polygon yarn workspace @tools/subgraph-hmt generate
       - name: Run subgraph test
-        run: yarn workspace @tools/subgraph test
+        run: yarn workspace @tools/subgraph-hmt test

.github/workflows/ci-test-subgraph-human.yaml

@@ -0,0 +1,31 @@
+name: Human Protocol Subgraph check
+
+on:
+  push:
+    branches: "**"
+    paths:
+      - "packages/core/**"
+      - "packages/subgraph/human-protocol/**"
+
+permissions:
+  contents: read
+
+jobs:
+  subgraph-test:
+    name: Human Protocol Subgraph Test
+    # TODO: Use ubuntu-latest when graph binary is not failing on ubuntu 24.04
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: .nvmrc
+          cache: yarn
+      - name: Install dependencies
+        run: yarn workspaces focus @tools/subgraph-human-protocol
+      - name: Build core package
+        run: yarn workspace @human-protocol/core build
+      - name: Generate manifest for Polygon for tests
+        run: NETWORK=polygon yarn workspace @tools/subgraph-human-protocol generate
+      - name: Run subgraph test
+        run: yarn workspace @tools/subgraph-human-protocol test

docker-setup/Makefile

@@ -3,7 +3,7 @@
 	build-services services-up services-stop
 
 export COMPOSE_BAKE=false
-DOCKER_PARALLEL ?= 4
+DOCKER_PARALLEL ?= 2
 
 check-env-file:
 	@if [ ! -f "./.env.compose.local" ]; then \
@@ -17,11 +17,19 @@ infra-stop:
 	@docker compose --env-file .env.compose.local stop postgres redis minio minio-client
 
 build-services: check-env-file
-	@docker compose --env-file .env.compose.local --parallel $(DOCKER_PARALLEL) up --no-start
+	@# TODO: Revisit compose-native parallel builds once Docker Compose v5 parallel limits are reliable again.
+	@docker compose --env-file .env.compose.local config --services | \
+		xargs -n $(DOCKER_PARALLEL) docker compose --env-file .env.compose.local build
+	@docker compose --env-file .env.compose.local up --no-start
 
 services-up: check-env-file
 	@service_names="$(wordlist 2, $(words $(MAKECMDGOALS)), $(MAKECMDGOALS))"; \
-	docker compose --env-file .env.compose.local --parallel $(DOCKER_PARALLEL) up -d $$service_names
+	@# TODO: Revisit compose-native parallel builds once Docker Compose v5 parallel limits are reliable again.
+	if [ -n "$$service_names" ]; then \
+		printf '%s\n' $$service_names | xargs -n $(DOCKER_PARALLEL) docker compose --env-file .env.compose.local up -d; \
+	else \
+		docker compose --env-file .env.compose.local config --services | xargs -n $(DOCKER_PARALLEL) docker compose --env-file .env.compose.local up -d; \
+	fi
 
 services-stop:
 	@service_names="$(wordlist 2, $(words $(MAKECMDGOALS)), $(MAKECMDGOALS))"; \

packages/apps/dashboard/client/eslint.config.mjs

@@ -46,6 +46,8 @@ export default tseslint.config(
       },
     },
     rules: {
+      'no-useless-assignment': 'off',
+      'preserve-caught-error': 'off',
       'react/prop-types': 'off',
       'react/display-name': 'off',
       'react/react-in-jsx-scope': 'off',

packages/apps/dashboard/client/package.json

@@ -20,9 +20,9 @@
     "@emotion/react": "^11.11.4",
     "@emotion/styled": "^11.11.5",
     "@human-protocol/sdk": "workspace:*",
-    "@mui/icons-material": "^7.2.0",
+    "@mui/icons-material": "^7.3.8",
     "@mui/material": "^7.2.0",
-    "@mui/styled-engine-sc": "7.2.0",
+    "@mui/styled-engine-sc": "7.3.8",
     "@mui/system": "^7.2.0",
     "@mui/x-data-grid": "^8.7.0",
     "@mui/x-date-pickers": "^8.26.0",
@@ -35,18 +35,18 @@
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-number-format": "^5.4.3",
-    "react-router-dom": "^6.23.1",
+    "react-router-dom": "^7.13.0",
     "recharts": "^2.13.0-alpha.4",
     "simplebar-react": "^3.3.2",
-    "styled-components": "^6.1.11",
+    "styled-components": "^6.3.11",
     "swiper": "^11.1.3",
     "use-debounce": "^10.1.0",
     "vite-plugin-node-polyfills": "^0.25.0",
     "zod": "^4.0.17",
     "zustand": "^5.0.10"
   },
   "devDependencies": {
-    "@eslint/js": "^9.27.0",
+    "@eslint/js": "^10.0.1",
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1",
     "@typescript-eslint/eslint-plugin": "^7.2.0",
@@ -59,7 +59,7 @@
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-react-refresh": "^0.4.11",
     "globals": "^16.2.0",
-    "prettier": "^3.7.4",
+    "prettier": "^3.8.1",
     "sass": "^1.89.2",
     "terser": "^5.36.0",
     "typescript": "^5.6.3",

packages/apps/dashboard/client/src/features/searchResults/model/transactionDetailsSchema.ts

@@ -8,6 +8,7 @@ const internalTransactionSchema = z.object({
   receiver: z.string().nullable(),
   escrow: z.string().nullable(),
   token: z.string().nullable(),
+  tokenSymbol: z.string().nullable().optional(),
 });
 
 const transactionDetailsSchema = z.object({
@@ -18,6 +19,7 @@ const transactionDetailsSchema = z.object({
   receiver: z.string().nullable(),
   block: z.number(),
   value: z.string(),
+  tokenSymbol: z.string().nullable().optional(),
   internalTransactions: z.array(internalTransactionSchema),
 });
 

packages/apps/dashboard/client/src/features/searchResults/ui/WalletTransactions/TransactionsTableBody.tsx

@@ -114,6 +114,7 @@ const TransactionsTableBody: FC<Props> = ({ data, isLoading, error }) => {
               <TransactionsTableCellValue
                 value={elem.value}
                 method={elem.method}
+                tokenSymbol={elem.tokenSymbol}
               />
             </TableCell>
           </TableRow>
@@ -150,6 +151,7 @@ const TransactionsTableBody: FC<Props> = ({ data, isLoading, error }) => {
                 <TransactionsTableCellValue
                   value={internalTx.value}
                   method={internalTx.method}
+                  tokenSymbol={internalTx.tokenSymbol}
                 />
               </TableCell>
             </TableRow>