UI Events: PIN

On OneKey Pro and OneKey Touch devices, PIN can only be entered on the hardware device. Software PIN entry is not supported on these models.

• When a protected call is made (e.g., btcGetAddress) and the device is locked, the SDK emits UI_REQUEST.REQUEST_PIN.

• Respond with one of the following:

  • Enter on device (recommended;):

    await HardwareSDK.uiResponse({ 
      type: UI_RESPONSE.RECEIVE_PIN,
      payload: '@@ONEKEY_INPUT_PIN_IN_DEVICE' 
    });

  • Software Blind PIN (not supported on Pro/Touch): show a fixed 3×3 keypad and send the transformed PIN string.

    let inputValue = '1111'
    await HardwareSDK.uiResponse({ 
      type: UI_RESPONSE.RECEIVE_PIN,
      payload: value 
    });

• Close your prompt when receiving UI_REQUEST.CLOSE_UI_WINDOW.

Learn more:

• Config Event

• PIN deep‑dive (mapping, UX, retries): PIN

• WebUSB connection prompts and UX: WebUSB Connection Guide