Auf dieser Seite

Gerätestatus abrufen

Den vereinheitlichten V1-/V2-Gerätestatus lesen. Verwenden Sie dies anstelle des veralteten getFeatures.

getFeatures() läuft weiterhin nur auf Protocol V1. Pro 2 und Neo müssen getDeviceState() aufrufen und payload.identity.deviceId lesen. Für Firmware-/Versionsfelder verwenden Sie scope: 'firmware' anstelle von getOnekeyFeatures.


const res = await HardwareSDK.getDeviceState(connectId);

Parameter

Optionale gemeinsame Parameter

Parameter	Typ	Erforderlich	Hinweise
`scope`	`'runtime' \| 'settings' \| 'firmware'`	Nein	Standardwert ist `'runtime'`. Der Umfang bestimmt nur, welche Teilbereiche diese Abfrage aktualisiert; die Nutzlast bleibt ein vollständiger Status

runtime — aktueller Sperr-/PIN-/Passphrase-Status (V1 GetFeatures, V2 DeviceStatusGet im Anwendungsmodus)
settings — außerdem Einstellungen aktualisieren
firmware — außerdem Identität, Versionen und Prüfinformationen aktualisieren

Bootloader / Romloader überspringt nicht unterstützte Statusbefehle und gibt den verfügbaren Status zurück.

Ergebnis


{
  success: true,
  payload: {
    protocol: 'V1' | 'V2',
    identity: {
      deviceId: string | null, // seed lifetime — pass as the second SDK argument
      serialNo: string,
      deviceType: string,
      // ...
    },
    status: { initialized, unlocked, passphraseProtection, attachToPinEnabled, ... },
    settings: { language, airgapMode, ... },
    versions: { firmware, bootloader, ble, applicationP1, applicationP2, ... },
  }
}

Lesen Sie payload.identity.deviceId für das zweite Argument von Signieraufrufen. Speichern Sie keine Firmware-session_id aus den Kompatibilitäts-Features dauerhaft.

Die Nutzlast enthält nicht die Firmware-Wallet-session_id oder rohe Protokollnachrichten. Die Wallet-Identität stammt aus openWalletSession.

Fehler


{
  success: false,
  payload: {
    error: string,
    code?: string | number,
  }
}

Siehe Protocol V1 und V2.