硬件 SDK 核心接口指南

const res = await HardwareSDK.evmGetAddress(connectId, deviceId, {
  path: "m/44'/60'/0'/0/0",
});
 
if (!res.success) throw new Error(res.payload.error);
console.log(res.payload.address);

import HardwareSDK, { UI_EVENT, UI_REQUEST, UI_RESPONSE } from '@onekeyfe/hd-common-connect-sdk';
 
// 1. 初始化 SDK（应用入口执行一次即可）
await HardwareSDK.init({ env: 'webusb', fetchConfig: true, debug: false });
 
// 2. 搜索已连接的设备
const devices = await HardwareSDK.searchDevices();
if (!devices.length) throw new Error('No device');
const [{ connectId }] = devices;
 
// 3. 获取设备信息（BLE 必需，WebUSB 建议）
const features = await HardwareSDK.getFeatures(connectId);
const deviceId = features?.payload?.device_id;
 
// 4. 订阅 UI 事件
HardwareSDK.on(UI_REQUEST.REQUEST_PIN, () => {
  // 显示 PIN 输入界面，获取用户输入后调用 uiResponse
});
HardwareSDK.on(UI_REQUEST.REQUEST_PASSPHRASE, () => {
  // 显示 Passphrase 输入界面
});
 
// 5. 执行区块链操作（以 EVM 签名为例）
await HardwareSDK.evmSignTransaction(connectId, deviceId, {
  path: "m/44'/60'/0'/0/0",
});

await HardwareSDK.evmGetAddress(connectId, deviceId, {
  path: "m/44'/60'/0'/0/0",
  useEmptyPassphrase: true,
});

// 一次性获取 passphraseState（会提示用户输 passphrase）
const { payload: passphraseState } = await HardwareSDK.getPassphraseState(
  connectId,
  { initSession: true }
);
 
// 后续所有隐藏钱包调用统一带上
const hiddenWallet = { initSession: true, passphraseState };
 
await HardwareSDK.evmGetAddress(connectId, deviceId, {
  path: "m/44'/60'/0'/0/0",
  ...hiddenWallet,
});
await HardwareSDK.btcGetAddress(connectId, deviceId, {
  path: "m/84'/0'/0'/0/0",
  coin: 'btc',
  ...hiddenWallet,
});

const bleDefaults = {
  retryCount: 3,
  pollIntervalTime: 1000,
  timeout: 30_000,
};
 
await HardwareSDK.btcSignTransaction(connectId, deviceId, {
  ...tx,
  ...bleDefaults,
});

import HardwareSDK, { UI_EVENT, UI_REQUEST, UI_RESPONSE } from '@onekeyfe/hd-common-connect-sdk';
 
const handleUiEvent = (msg: any) => {
  switch (msg.type) {
    case UI_REQUEST.REQUEST_PIN:
      openPinModal(({ value }) =>
        HardwareSDK.uiResponse({ type: UI_RESPONSE.RECEIVE_PIN, payload: value })
      );
      return;
    case UI_REQUEST.REQUEST_PASSPHRASE:
      openPassphraseModal(({ value, onDevice, save }) =>
        HardwareSDK.uiResponse({
          type: UI_RESPONSE.RECEIVE_PASSPHRASE,
          payload: { value, passphraseOnDevice: onDevice, attachPinOnDevice: false, save },
        })
      );
      return;
    case UI_REQUEST.REQUEST_DEVICE_IN_BOOTLOADER_FOR_WEB_DEVICE:
      showDeviceList((deviceId) =>
        HardwareSDK.uiResponse({
          type: UI_RESPONSE.SELECT_DEVICE_IN_BOOTLOADER_FOR_WEB_DEVICE,
          payload: { deviceId },
        })
      );
      return;
    default:
      console.log('UI event', msg.type, msg.payload);
  }
};
 
HardwareSDK.on(UI_EVENT, handleUiEvent);

const BLIND_KEYBOARD_MAP = ['7', '8', '9', '4', '5', '6', '1', '2', '3'];
HardwareSDK.uiResponse({
  type: UI_RESPONSE.RECEIVE_PIN,
  payload: BLIND_KEYBOARD_MAP[label - 1],
});