简介

# Web / 桌面 WebUSB（推荐）
npm i @onekeyfe/hd-common-connect-sdk
 
# React Native BLE
npm i @onekeyfe/hd-ble-sdk
 
# 原生宿主 + 底层插件（Android/iOS/Flutter 桥接）
npm i @onekeyfe/hd-common-connect-sdk
 
# 插件端 iframe（仅插件端）
npm i @onekeyfe/hd-web-sdk

import HardwareSDK from '@onekeyfe/hd-common-connect-sdk';
 
await HardwareSDK.init({
  env: 'webusb',
  debug: process.env.NODE_ENV !== 'production',
  fetchConfig: true,
});

import HardwareSDK from '@onekeyfe/hd-ble-sdk';
 
await HardwareSDK.init({
  debug: __DEV__,
});

import HardwareSDK from '@onekeyfe/hd-common-connect-sdk';
 
await HardwareSDK.init({
  env: 'lowlevel',
  debug: process.env.NODE_ENV !== 'production',
  fetchConfig: true,
});

import { HardwareSDK } from '@onekeyfe/hd-web-sdk';
 
await HardwareSDK.init({
  debug: process.env.NODE_ENV !== 'production',
  connectSrc: 'https://jssdk.onekey.so/1.1.19/', // iframe host
});

import { UI_EVENT, UI_REQUEST, DEVICE } from '@onekeyfe/hd-core';
 
HardwareSDK.on(UI_EVENT, async (message) => {
  switch (message.type) {
    case UI_REQUEST.REQUEST_PIN:
      // 处理 PIN 输入（见下文）
      break;
    case UI_REQUEST.REQUEST_PASSPHRASE:
      // 处理密码短语输入（见下文）
      break;
  }
});
 
HardwareSDK.on(DEVICE.CONNECT, (payload) => console.log('已连接:', payload));
HardwareSDK.on(DEVICE.DISCONNECT, (payload) => console.log('已断开:', payload));

import { ONEKEY_WEBUSB_FILTER } from '@onekeyfe/hd-shared';
 
// 触发浏览器设备选择器
await navigator.usb.requestDevice({ filters: ONEKEY_WEBUSB_FILTER });

const result = await HardwareSDK.searchDevices();
if (!result.success) throw new Error(result.payload.error);
 
const devices = result.payload;
// [{ connectId, deviceId?, name, deviceType, ... }]

const features = await HardwareSDK.getFeatures(connectId);
if (!features.success) throw new Error(features.payload.error);
 
const deviceId = features.payload.device_id;

import { UI_RESPONSE } from '@onekeyfe/hd-core';
 
// 方式 1：在设备上输入（推荐）
await HardwareSDK.uiResponse({
  type: UI_RESPONSE.RECEIVE_PIN,
  payload: '@@ONEKEY_INPUT_PIN_IN_DEVICE'
});
 
// 方式 2：软件盲输 PIN（Pro/Touch 不支持）
await HardwareSDK.uiResponse({
  type: UI_RESPONSE.RECEIVE_PIN,
  payload: userInputPin  // 例如 '1234'
});

// 方式 1：在设备上输入（最安全）
await HardwareSDK.uiResponse({
  type: UI_RESPONSE.RECEIVE_PASSPHRASE,
  payload: { passphraseOnDevice: true, value: '' }
});
 
// 方式 2：软件输入，可选会话缓存
await HardwareSDK.uiResponse({
  type: UI_RESPONSE.RECEIVE_PASSPHRASE,
  payload: { value: userPassphrase, passphraseOnDevice: false, save: true }
});

const message = 'Hello OneKey';
const messageHex = Buffer.from(message).toString('hex');
 
const res = await HardwareSDK.evmSignMessage(connectId, deviceId, {
  path: "m/44'/60'/0'",
  messageHex,
  chainId: 1,
});
 
if (!res.success) throw new Error(res.payload.error);
 
console.log('地址:', res.payload.address);
console.log('签名:', res.payload.signature);