# @exodus/auth-mobile 中文文档

规范地址：https://npmcn.com/package/%40exodus/auth-mobile/

版本：6\.9\.8
npm 元数据更新时间：2026-11-13T18:31:10.899Z
中文译文更新时间：2026-11-14T04:13:19.413Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40exodus/auth-mobile
原文对照：https://npmcn.com/package/%40exodus/auth-mobile/?lang=original
项目主页：https://github.com/ExodusMovement/exodus/tree/master/libs/features/auth-mobile
源码仓库：https://github.com/ExodusMovement/exodus

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：47 kB，21 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：7 个
- peer 依赖：react-native \>=0\.71\.11 \<0\.79\.0
- 首次发布：2023-07-05T15:43:01.053Z
- 最新版本发布：2026-11-13T18:31:10.620Z
- 近 30 天下载量：10745（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：37（近 12 个月 12 个）

## 中文简介

简化移动设备认证机制的模块

## 安装

```sh
npm install @exodus/auth-mobile
```

也可以使用：`pnpm add @exodus/auth-mobile`、`yarn add @exodus/auth-mobile`、`bun add @exodus/auth-mobile`

## README

# @exodus/自动移动

该功能提供了一个平台独立的方法,在移动回放原生应用程序中启用并使用"针"和"生物识别认证"等认证方法.

## 安装

```sh
pnpm add @exodus/auth-mobile
```

## 使用量

此特性设计为与 `@exodus/headless`。见 [使用 sdk](https://npmcn.com/package/docs/development/using-the-sdk.md)。 。 。 .

直接建造Android `bioAuth` 模块需要 `auth`, (中文(简体) ), `authAtom`,以及 `logger`. 特性容器提供这些依赖.

### API 边

见 [使用 sdk](https://npmcn.com/package/docs/development/using-the-sdk.md#setup-the-api-side) 更多关于特性插入SDK的细节.

```js
await exodus.auth.setPin('123456') // set 6 number pin
await exodus.auth.isCorrectPin('645123') // false; rejects with `PinUnverifiable` when the stored PIN can no longer be decrypted

await exodus.auth.enableBioAuth() // enables bio authentication such as fingerprint or face id

await exodus.auth.bio.trigger() // start the bio authentication process
await exodus.auth.bio.stop() // abort
```

如果你正在构建一个需要访问认证细节的功能,你可以依赖 `authAtom` 并观察变化:

```js
authAtom.observe(
  ({ hasBioAuth, biometry, hasPin, pinUnverifiable, hasDeviceAuth, shouldAuthenticate }) => {
    // shouldAuthenticate is true if a PIN, biometric auth, or Device Lock is configured
    // (inidicator for the UI to restrict access to protectworthy resources such as the mnemonic phrase)
    // biometry is available biometry variant
    // pinUnverifiable is true when a PIN is stored but can no longer be decrypted
  }
)
```

何时 `pinUnverifiable` 没错, `hasPin` 保持真实 `hasDeviceAuth` 在操作系统报告设备证书时打开, 因此操作系统提示打开钱包, 而不是键盘; 切换生物鉴别技术保留了那个门. `setPin` 重新创建条目并清除状态, 将新 PIN 设置在 `<keyPrefix>pinPending` 而旧条目被替换, 因此每个步骤都存在一个 PIN 条目; 一个已停放的 PIN 验证为当前条目, 而下一个 `load()` 完成中断的互换, 即使旧条目仍然不可解密 .

在iOS上, `auth.bio.authenticate()` 返回时 `false` 当用户取消键链提示时。 其他键链故障通过 `errorTracking` 以否认的态度 `DeviceAuthenticationFailed`。已知的OS错误代码出现在已消毒错误消息中;本地消息和未知代码被省略。 呼叫者应抓住这些失败,并进行重试,同时保持所需的认证.

对于设备锁定用户, `hasDeviceAuth` 财务报告和审定财务报表 `shouldAuthenticate` 当操作系统无法认证时,则保持真实性. `deviceAuthUnavailable` 单独跟踪失败的可用性检查;它不授权访问或关闭设备锁定。 原生的检查也可以在瞬间出错后回回虚假,因此无法返回并不能证明用户取消了他们的设备密码. 5秒后检查可用时间 拒绝或超时的检查保留了最后已知的可用性,而后期结果被忽略了.

`auth.refreshDeviceAuth()` 在 OS 提示失败后重新装入完整的认证状态并更新可用性 。 如果加载证书失败, 它不会使 auth 原子不变, 所以一个不完整的状态不能绕过认证 。 消费者在返回前地时也可以称呼. 设备认证不存在时, 请关闭认证门, 并提供恢复消息, 请用户启用设备密码或重试 。 恢复到正常状态仍然需要在批准访问之前成功认证.

### 安全报告

这个 `auth` 节次包含 `hasDeviceAuth`,该应用程序的激活设备锁定状态,与遗留状态一起 `hasPin` 财务报告和审定财务报表 `hasBioAuth` 旗帜。 设备锁定可以在两个遗留的旗帜都是虚假的情况下活动. `deviceAuthStatus` 单独报告配置的设备锁定是否已禁用、可用或无法使用;可以在 `hasDeviceAuth` 如果遗留的生物鉴别技术优先,那就是假的。 缺席 `hasDeviceAuth` 值表示该状态未被报告. `pinUnverifiable` 当存储的 PIN 存在但无法解密时是真实的.

## 常见问题

### @exodus/auth-mobile 是什么？

简化移动设备认证机制的模块

### 如何安装 @exodus/auth-mobile？

在项目目录运行 npm install @exodus/auth-mobile，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react-native（\>=0\.71\.11 \<0\.79\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @exodus/auth-mobile 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/exodus\_\_auth-mobile 是否存在。

### @exodus/auth-mobile 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @exodus/auth-mobile 可以商用吗？

@exodus/auth-mobile 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @exodus/auth-mobile 的下载量有多少？

根据 npm 官方下载统计，@exodus/auth-mobile 在 2026/10/14 – 2026/11/12 这 30 天内被下载 10,745 次，日均约 358 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @exodus/auth-mobile 还在维护吗？

最新版本 6\.9\.8 发布于 2026/11/14（今天）；至今共发布 37 个版本，其中过去 12 个月发布了 12 个；首次发布于 2023/07/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。