feat: test/api features

Includes test cases and example implementations for all new features.

Author: ByteZhang1024

.github/workflows/build-example-web.yml

@@ -3,10 +3,9 @@ name: Build and Deploy Examples
 on: workflow_dispatch
 
 env:
-  COMMIT_FULL_SHA: ${{ github.sha }}
+  COMMIT_SHORT_SHA: ${{ github.sha }}
 
-jobs:
-  deploy_preview:
+  build_expo:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -19,133 +18,35 @@ jobs:
         with:
           node-version: '22'
           registry-url: 'https://registry.npmjs.org'
-
       - name: Install Dependencies
         run: |
           yarn
           yarn bootstrap
-
       - name: Build All Packages
         run: yarn build
-
       - name: Build Expo Example
         run: EXPO_PUBLIC_COMMIT_SHA=${{ env.COMMIT_SHORT_SHA }} yarn expo export:web
         working-directory: packages/connect-examples/expo-example
 
-      - name: Add commit info to Expo Example
+      - name: Add commit info to build output
         run: |
+          # 先备份原始构建产物到临时目录
           mkdir -p temp-build
           cp -r web-build/* temp-build/ 2>/dev/null || true
+          # 创建带有 commit id 的子目录
           mkdir -p web-build/commits/${{ env.COMMIT_SHORT_SHA }}
+          # 复制备份的构建产物到带有 commit id 的目录
           cp -r temp-build/* web-build/commits/${{ env.COMMIT_SHORT_SHA }}/
+          # 创建一个 commit 信息文件
           echo '{"commit": "${{ env.COMMIT_SHORT_SHA }}", "fullCommit": "${{ github.sha }}", "timestamp": "'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}' > web-build/commits/${{ env.COMMIT_SHORT_SHA }}/commit-info.json
+          # 为 commit 版本也创建 404.html
           cp web-build/commits/${{ env.COMMIT_SHORT_SHA }}/index.html web-build/commits/${{ env.COMMIT_SHORT_SHA }}/404.html
+          # 清理临时目录
           rm -rf temp-build
         working-directory: packages/connect-examples/expo-example
 
-      - name: Build Expo Playground (testing preview)
-        working-directory: packages/connect-examples/expo-playground
-        env:
-          COMMIT_SHA: ${{ env.COMMIT_SHORT_SHA }}
-        run: yarn build
-
-      - name: Add SPA fallback pages
-        run: |
-          cp packages/connect-examples/expo-playground/dist/index.html packages/connect-examples/expo-playground/dist/404.html
-          cp packages/connect-examples/expo-example/web-build/index.html packages/connect-examples/expo-example/web-build/404.html
-
-      - name: Prepare root static assets
-        run: |
-          rm -rf gh-pages-root
-          mkdir -p gh-pages-root
-          cp .github/templates/404.html gh-pages-root/404.html
-          cp .github/templates/404.html gh-pages-root/index.html
-          if [ -f "packages/connect-examples/expo-example/web-build/manifest.json" ]; then
-            cp packages/connect-examples/expo-example/web-build/manifest.json gh-pages-root/manifest.json
-            echo "✅ Copied manifest.json from expo-example"
-          else
-            cp .github/templates/manifest.json gh-pages-root/manifest.json
-            echo "⚠️ expo-example manifest not found, using template"
-          fi
-          find packages/connect-examples/expo-example/web-build -maxdepth 1 -type f -name "favicon*" -exec cp {} gh-pages-root/ \;
-
-      - name: Deploy root assets
-        uses: peaceiris/actions-gh-pages@v4
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./gh-pages-root
-          cname: hardware-example.onekeytest.com
-          force_orphan: true
-
-      - name: Deploy Expo Example (GitHub Pages)
-        uses: peaceiris/actions-gh-pages@v4
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: packages/connect-examples/expo-example/web-build
-          destination_dir: expo-example
-          keep_files: true
-
-      - name: Deploy Expo Playground (GitHub Pages)
-        uses: peaceiris/actions-gh-pages@v4
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: packages/connect-examples/expo-playground/dist
-          destination_dir: expo-playground
-          keep_files: true
-
-  build_playground_production:
-    runs-on: ubuntu-latest
-    needs: deploy_preview
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Get short commit SHA
-        run: echo "COMMIT_SHORT_SHA=${GITHUB_SHA:0:7}" >> $GITHUB_ENV
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Install Dependencies
-        run: |
-          yarn
-          yarn bootstrap
-
-      - name: Build All Packages
-        run: yarn build
-
-      - name: Build Expo Playground (production)
-        working-directory: packages/connect-examples/expo-playground
-        env:
-          COMMIT_SHA: ${{ env.COMMIT_FULL_SHA }}
-        run: yarn build
-
-      - name: Package production bundle with commit id
-        working-directory: packages/connect-examples/expo-playground
-        env:
-          COMMIT_FULL_SHA: ${{ env.COMMIT_FULL_SHA }}
-          COMMIT_SHORT_SHA: ${{ env.COMMIT_SHORT_SHA }}
-        run: |
-          RELEASE_ROOT="release"
-          rm -rf "${RELEASE_ROOT}"
-          mkdir -p "${RELEASE_ROOT}"
-          cp dist/index.html "${RELEASE_ROOT}/index.html"
-          cp dist/404.html "${RELEASE_ROOT}/404.html"
-          mkdir -p "${RELEASE_ROOT}/${COMMIT_FULL_SHA}"
-          cp -R dist/${COMMIT_FULL_SHA}/. "${RELEASE_ROOT}/${COMMIT_FULL_SHA}/"
-          cat <<EOF > "${RELEASE_ROOT}/${COMMIT_FULL_SHA}/build-info.json"
-          {
-            "commit": "${COMMIT_FULL_SHA}",
-            "shortCommit": "${COMMIT_SHORT_SHA}",
-            "buildEnv": "production",
-            "buildTime": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
-          }
-          EOF
-
-      - name: Upload Production Artifact
+      - name: Upload Artifact
         uses: actions/upload-artifact@v4
         with:
-          name: ${{ env.COMMIT_FULL_SHA }}
-          path: packages/connect-examples/expo-playground/release
+          name: expo-build
+          path: packages/connect-examples/expo-example/web-build

.husky/pre-commit

@@ -2,9 +2,6 @@
 # Run tests
 yarn test
 
-# Run check versions
-yarn check-versions
-
 # Run lint:fix
 yarn lint:staged
 

packages/connect-examples/expo-example/App.tsx

@@ -5,7 +5,7 @@ import { TamaguiProvider, PortalProvider, Text, Stack, Card, YStack } from 'tama
 import { Toast, ToastProvider, ToastViewport, useToastState } from '@tamagui/toast';
 import * as ExpoLinking from 'expo-linking';
 import { SafeAreaProvider, useSafeAreaInsets } from 'react-native-safe-area-context';
-
+import Watermark from '@uiw/react-watermark';
 import { useIntl } from 'react-intl';
 import SDKProvider from './src/provider/SDKProvider';
 

packages/connect-examples/expo-example/locale/en-US.json

@@ -34,6 +34,7 @@
   "action__ok": "OK",
 
   "action__start_test": "Start Test",
+  "action__start_error_test": "Testing failed cases",
   "action__stop_test": "Stop Test",
 
   "tip__update_ready": "There are new versions that can be updated",
@@ -119,7 +120,6 @@
 
   "label__device_bootloader_statue": "Bootloader",
   "label__device_firmware_status": "Firmware",
-
   "label__device_se_info": "Device SE Information",
   "label__device_info_update_time": "Update Time",
   "label__device_info_refresh": "Refreshing Device Information",

packages/connect-examples/expo-example/locale/zh-CN.json

@@ -34,6 +34,7 @@
   "action__ok": "好的",
 
   "action__start_test": "开始测试",
+  "action__start_error_test": "测试失败用例",
   "action__stop_test": "停止测试",
 
   "tip__update_ready": "检测到新的版本可以更新，点击进行安装",
@@ -50,7 +51,7 @@
   "tip__no_select_file": "未选择文件",
   "tip__update_success": "更新成功",
 
-  "title__common_parameters": "常用参数",
+  "title__common_parameters": "通用参数 (每次请求都会使用)",
   "title__hardware_api_test": "硬件 API 测试",
   "title__updating": "正在更新",
   "title__input_pin": "输入 PIN",
@@ -119,7 +120,6 @@
 
   "label__device_bootloader_statue": "Bootloader 状态",
   "label__device_firmware_status": "开机状态",
-
   "label__device_se_info": "设备 SE 信息",
   "label__device_info_update_time": "更新时间",
   "label__device_info_refresh": "刷新设备信息",
@@ -197,7 +197,6 @@
   "message__address_not_match": "地址不匹配",
   "message__create": "创建",
   "message__generate": "生成",
-
   "message__passphrase_count_test_describe": "开始之后根据提示解锁硬件, 根据硬件提示确认 passphrase, 不用自己输入",
   "message__passphrase_count_test_step1": "1. 从零开始创建钱包 passphrase 并记录下来，注意在硬件按确认 passphrase",
   "message__passphrase_count_test_step2": "2. 每次创建完一个 passphrase 钱包，都会去检查一遍之前创建过的钱包，是否可以正常获取地址",
@@ -206,7 +205,6 @@
   "message__passphrase_special_test_describe": "请输入与当前设备一致的助记词",
   "message__test_device_create_wallet_describe": "在硬件上创建钱包，将助记词输入在这里，用来验证硬件的助记词是否正确",
   "message__test_blind_signature_security_check_describe": "检查钱包盲签安全性，是否可以使用规定 CoinType 之外的私钥签名",
-
   "message__message_is_empty": "请先输入设备的助记词",
 
   "ignore": "忽略"

packages/connect-examples/expo-example/package.json

@@ -38,6 +38,7 @@
     "@tamagui/lucide-icons": "1.90.2",
     "@tamagui/toast": "1.90.2",
     "@ton/core": "^0.57.0",
+    "@uiw/react-watermark": "^1.0.1",
     "asyncstorage-down": "^4.2.0",
     "axios": "1.12.2",
     "bchaddrjs": "^0.5.2",

packages/connect-examples/expo-example/src/components/Playground.tsx

@@ -2,20 +2,46 @@ import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react'
 import * as Clipboard from 'expo-clipboard';
 import { Group, H4, Stack, Text } from 'tamagui';
 import { useIntl } from 'react-intl';
+import { IDeviceType } from '@onekeyfe/hd-core';
 import PlaygroundExecutor, { type MethodPayload } from './PlaygroundExecutor';
 import { useExpandMode } from '../provider/ExpandModeProvider';
 import { Button } from './ui/Button';
 import AutoWrapperTextArea from './ui/AutoWrapperTextArea';
 
+export type TestDeviceType = IDeviceType | 'common';
+
+export interface TestExpect {
+  skip?: boolean;
+  success?: boolean;
+  requestPin?: boolean;
+  requestButton?: boolean;
+  unknownMessage?: boolean;
+  error?: boolean | number;
+}
+
+export interface TestModalExpect {
+  normal?: TestExpect;
+  bootloader?: TestExpect;
+}
+
+export type TestDeviceExpect = {
+  [key in TestDeviceType]?: TestModalExpect;
+};
+
 export interface PresupposeProps {
   title: string;
   value: any; // JSON object
+
+  expect?: TestDeviceExpect;
 }
 
 export type PlaygroundProps = {
   description?: string;
   presupposes?: PresupposeProps[];
   deprecated?: boolean;
+
+  // eslint-disable-next-line react/no-unused-prop-types
+  expect?: TestDeviceExpect;
 } & MethodPayload;
 
 const Playground = ({

packages/connect-examples/expo-example/src/components/ui/Page.tsx

@@ -1,4 +1,5 @@
 import { ScrollView, View } from 'tamagui';
+import Watermark from '@uiw/react-watermark';
 import HeaderView from './Header';
 
 export interface PageViewProps {
@@ -7,16 +8,18 @@ export interface PageViewProps {
 }
 
 const PageView = ({ children, scrollable = true }: PageViewProps) => (
-  <View flex={1} backgroundColor="bgApp">
-    <HeaderView />
-    {scrollable ? (
-      <ScrollView flex={1} testID="page-view-scrollable" overflow="scroll">
-        {children}
-      </ScrollView>
-    ) : (
-      <View testID="page-view-non-scrollable">{children}</View>
-    )}
-  </View>
+  <Watermark
+    content="测试使用，需要特殊 Bridge"
+    fontColor="rgb(255 0 0 / 15%)"
+    gapX={480}
+    gapY={480}
+    fontSize={28}
+  >
+    <View flex={1} backgroundColor="bgApp">
+      <HeaderView />
+      {scrollable ? <ScrollView flex={1}>{children}</ScrollView> : <View>{children}</View>}
+    </View>
+  </Watermark>
 );
 
 export default PageView;

packages/connect-examples/expo-example/src/constants/connect.ts

@@ -1,3 +1,2 @@
-// eslint-disable-next-line import/no-relative-packages
 
-export const CONNECT_SRC = process.env.CONNECT_SRC || `https://jssdk.onekey.so/1.1.17/`;
+export const CONNECT_SRC = process.env.CONNECT_SRC || `https://jssdk.onekeytest.com/`;

packages/connect-examples/expo-example/src/data/alephium.ts

@@ -3,13 +3,12 @@ import { type PlaygroundProps } from '../components/Playground';
 const api: PlaygroundProps[] = [
   {
     method: 'alephiumGetAddress',
-
+    description: 'Get address',
     presupposes: [
       {
         title: 'Get address',
         value: {
           path: "m/44'/1234'/0'/0/0",
-          includePublicKey: true,
           showOnOneKey: false,
           group: 0,
         },
@@ -20,13 +19,11 @@ const api: PlaygroundProps[] = [
           bundle: [
             {
               path: "m/44'/1234'/0'/0/0",
-              includePublicKey: true,
               showOnOneKey: false,
               group: 0,
             },
             {
               path: "m/44'/1234'/0'/0/1",
-              includePublicKey: true,
               showOnOneKey: false,
               group: 0,
             },
@@ -42,7 +39,7 @@ const api: PlaygroundProps[] = [
   },
   {
     method: 'alephiumSignMessage',
-
+    description: 'Sign Message',
     presupposes: [
       {
         title: 'Sign Alephium',
@@ -80,7 +77,7 @@ const api: PlaygroundProps[] = [
   },
   {
     method: 'alephiumSignTransaction',
-
+    description: 'Sign Transaction',
     presupposes: [
       {
         title: 'Native Transfer',