@onekeyfe/hd-core 1.2.8 → 1.2.9

package/src/types/api/export.ts

@@ -1,5 +1,6 @@
 export type { BTCAddress, BTCGetAddressParams } from './btcGetAddress';
 export type { BTCPublicKey, BTCGetPublicKeyParams } from './btcGetPublicKey';
+export type { BTCDeriveContextHashParams } from './btcDeriveContextHash';
 export type { BTCSignMessageParams } from './btcSignMessage';
 export type { BTCVerifyMessageParams } from './btcVerifyMessage';
 export type {
@@ -226,3 +227,19 @@ export type { BenfenAddress, BenfenGetAddressParams } from './benfenGetAddress';
 export type { BenfenPublicKey, BenfenGetPublicKeyParams } from './benfenGetPublicKey';
 export type { BenfenSignMessageParams } from './benfenSignMessage';
 export type { BenfenSignedTx, BenfenSignTransactionParams } from './benfenSignTransaction';
+export type { ZcashAddress, ZcashGetAddressParams } from './zcashGetAddress';
+export type { ZcashFullViewingKey, ZcashGetFullViewingKeyParams } from './zcashGetFullViewingKey';
+export type { ZcashSignedPczt, ZcashSignPcztParams } from './zcashSignPczt';
+
+export type { MoneroAddress, MoneroGetAddressParams } from './moneroGetAddress';
+export type { MoneroGetWatchKeyParams, MoneroWatchKey } from './moneroGetWatchKey';
+export type {
+  MoneroEncryptedKeyImage,
+  MoneroKeyImageSyncParams,
+  MoneroKeyImageSyncResult,
+  MoneroKeyImageTransfer,
+} from './moneroKeyImageSync';
+export type {
+  MoneroSignTransactionParams,
+  MoneroSignTransactionResult,
+} from './moneroSignTransaction';

package/src/types/api/index.ts

@@ -73,6 +73,7 @@ import type { evmSignTypedData } from './evmSignTypedData';
 import type { evmVerifyMessage } from './evmVerifyMessage';
 import type { btcGetAddress } from './btcGetAddress';
 import type { btcGetPublicKey } from './btcGetPublicKey';
+import type { btcDeriveContextHash } from './btcDeriveContextHash';
 import type { btcSignMessage } from './btcSignMessage';
 import type { btcSignPsbt } from './btcSignPsbt';
 import type { btcSignTransaction } from './btcSignTransaction';
@@ -153,6 +154,13 @@ import type { benfenSignTransaction } from './benfenSignTransaction';
 import type { benfenSignMessage } from './benfenSignMessage';
 import type { neoGetAddress } from './neoGetAddress';
 import type { neoSignTransaction } from './neoSignTransaction';
+import type { zcashGetAddress } from './zcashGetAddress';
+import type { zcashGetFullViewingKey } from './zcashGetFullViewingKey';
+import type { zcashSignPczt } from './zcashSignPczt';
+import type { moneroGetAddress } from './moneroGetAddress';
+import type { moneroGetWatchKey } from './moneroGetWatchKey';
+import type { moneroKeyImageSync } from './moneroKeyImageSync';
+import type { moneroSignTransaction } from './moneroSignTransaction';
 import type { ConnectSettings } from '../settings';
 import type { HardwareConnectProtocol } from '@onekeyfe/hd-shared';
 
@@ -286,6 +294,7 @@ export type CoreApi = {
    */
   btcGetAddress: typeof btcGetAddress;
   btcGetPublicKey: typeof btcGetPublicKey;
+  btcDeriveContextHash: typeof btcDeriveContextHash;
   btcSignMessage: typeof btcSignMessage;
   btcSignPsbt: typeof btcSignPsbt;
   btcSignTransaction: typeof btcSignTransaction;
@@ -470,4 +479,19 @@ export type CoreApi = {
    */
   neoGetAddress: typeof neoGetAddress;
   neoSignTransaction: typeof neoSignTransaction;
+
+  /**
+   * Zcash
+   */
+  zcashGetAddress: typeof zcashGetAddress;
+  zcashGetFullViewingKey: typeof zcashGetFullViewingKey;
+  zcashSignPczt: typeof zcashSignPczt;
+
+  /**
+   * Monero
+   */
+  moneroGetAddress: typeof moneroGetAddress;
+  moneroGetWatchKey: typeof moneroGetWatchKey;
+  moneroKeyImageSync: typeof moneroKeyImageSync;
+  moneroSignTransaction: typeof moneroSignTransaction;
 };

package/src/types/api/moneroGetAddress.ts

@@ -0,0 +1,27 @@
+import type { CommonParams, Response } from '../params';
+
+export type MoneroAddress = {
+  path: string;
+  // Primary address of the account, base58
+  address: string;
+};
+
+export type MoneroGetAddressParams = {
+  // Account path, m/44'/128'/account'
+  path: string | number[];
+  showOnOneKey?: boolean;
+  // 0 mainnet, 1 testnet, 2 stagenet
+  networkType?: number;
+};
+
+export declare function moneroGetAddress(
+  connectId: string,
+  deviceId: string,
+  params: CommonParams & MoneroGetAddressParams
+): Response<MoneroAddress>;
+
+export declare function moneroGetAddress(
+  connectId: string,
+  deviceId: string,
+  params: CommonParams & { bundle?: MoneroGetAddressParams[] }
+): Response<Array<MoneroAddress>>;

package/src/types/api/moneroGetWatchKey.ts

@@ -0,0 +1,28 @@
+import type { CommonParams, Response } from '../params';
+
+export type MoneroWatchKey = {
+  path: string;
+  // Private view key, hex
+  watchKey: string;
+  // Primary address of the account, base58
+  address: string;
+};
+
+export type MoneroGetWatchKeyParams = {
+  // Account path, m/44'/128'/account'
+  path: string | number[];
+  // 0 mainnet, 1 testnet, 2 stagenet
+  networkType?: number;
+};
+
+export declare function moneroGetWatchKey(
+  connectId: string,
+  deviceId: string,
+  params: CommonParams & MoneroGetWatchKeyParams
+): Response<MoneroWatchKey>;
+
+export declare function moneroGetWatchKey(
+  connectId: string,
+  deviceId: string,
+  params: CommonParams & { bundle?: MoneroGetWatchKeyParams[] }
+): Response<Array<MoneroWatchKey>>;

package/src/types/api/moneroKeyImageSync.ts

@@ -0,0 +1,45 @@
+import type { CommonParams, Response } from '../params';
+
+// One owned output, as wallet2 describes it to the device. Keys are 32-byte hex.
+export type MoneroKeyImageTransfer = {
+  // Output public key
+  outKey: string;
+  // Transaction public key R
+  txPubKey: string;
+  // Additional tx public keys: the one for this output, or the whole list
+  additionalTxPubKeys?: string[];
+  // Index of the output within its transaction
+  internalOutputIndex: number;
+  // Receiving subaddress index; omitted means 0 (primary address)
+  subAddrMajor?: number;
+  subAddrMinor?: number;
+};
+
+// ChaCha20-Poly1305 under encKey, hex.
+export type MoneroEncryptedKeyImage = {
+  // 12-byte nonce
+  iv: string;
+  // Ciphertext of key image || signature c || signature r, then the 16-byte tag
+  blob: string;
+};
+
+export type MoneroKeyImageSyncResult = {
+  // Key that decrypts every blob, hex
+  encKey: string;
+  // One entry per transfer, in request order
+  keyImages: MoneroEncryptedKeyImage[];
+};
+
+export type MoneroKeyImageSyncParams = {
+  // Account path, m/44'/128'/account'
+  path: string | number[];
+  // 0 mainnet, 1 testnet, 2 stagenet
+  networkType?: number;
+  transfers: MoneroKeyImageTransfer[];
+};
+
+export declare function moneroKeyImageSync(
+  connectId: string,
+  deviceId: string,
+  params: CommonParams & MoneroKeyImageSyncParams
+): Response<MoneroKeyImageSyncResult>;

package/src/types/api/moneroSignTransaction.ts

@@ -0,0 +1,54 @@
+import type { MoneroTransactionData, MoneroTransactionSourceEntry } from '@onekeyfe/hd-transport';
+import type { CommonParams, Response } from '../params';
+
+export type MoneroSignTransactionParams = {
+  // Account path, m/44'/128'/account'
+  path: string | number[];
+  // 0 mainnet, 1 testnet, 2 stagenet
+  networkType?: number;
+  // Init data in protobuf field names; outputs include the change, in final order
+  tsxData: MoneroTransactionData;
+  // One source entry per input, in original order, each with its full ring
+  inputs: MoneroTransactionSourceEntry[];
+};
+
+// Raw device output, hex unless noted. The host assembles the transaction.
+export type MoneroSignTransactionResult = {
+  // Original input index of each sorted input
+  origIndices: number[];
+  // Serialized tx.vin entries, sorted by key image (descending)
+  vinis: string[];
+  // Pseudo-output commitments from SignInputAck, sorted order
+  pseudoOuts: string[];
+  // Sealed CLSAG signatures, sorted order; openingKey unseals them
+  signatures: string[];
+  // Serialized tx.vout entries, output order
+  txOuts: string[];
+  // Output key and commitment (64 bytes each), output order
+  outPks: string[];
+  // Encrypted 8-byte amounts, output order
+  ecdhInfos: string[];
+  // Aggregated Bulletproof+ without V
+  rsig: string;
+  extra: string;
+  txPrefixHash: string;
+  fullMessageHash: string;
+  rv: {
+    // Decimal piconero
+    txnFee: string;
+    message: string;
+    rvType: number;
+  };
+  openingKey: string;
+  // Tx private keys sealed by the device for later proofs (MoneroGetTxKeyRequest), with the
+  // salts that rederive the sealing key; wallet2 keeps them as salt1, salt2, enc_keys
+  salt: string;
+  randMult: string;
+  txEncKeys: string;
+};
+
+export declare function moneroSignTransaction(
+  connectId: string,
+  deviceId: string,
+  params: CommonParams & MoneroSignTransactionParams
+): Response<MoneroSignTransactionResult>;

package/src/types/api/zcashGetAddress.ts

@@ -0,0 +1,32 @@
+import type { ZcashAddressScope, ZcashAddressType } from '@onekeyfe/hd-transport';
+import type { CommonParams, Response } from '../params';
+
+export type ZcashAddress = {
+  path: string;
+  // ZIP-316 unified address or transparent P2PKH address
+  address: string;
+  // ZIP-32 seed fingerprint (hex), present when includeSeedFingerprint was requested
+  seedFingerprint?: string;
+};
+
+export type ZcashGetAddressParams = {
+  // ZIP-32 account path, m/32'/133'/account'
+  path: string | number[];
+  showOnOneKey?: boolean;
+  diversifierIndex?: number;
+  addressType?: ZcashAddressType;
+  scope?: ZcashAddressScope;
+  includeSeedFingerprint?: boolean;
+};
+
+export declare function zcashGetAddress(
+  connectId: string,
+  deviceId: string,
+  params: CommonParams & ZcashGetAddressParams
+): Response<ZcashAddress>;
+
+export declare function zcashGetAddress(
+  connectId: string,
+  deviceId: string,
+  params: CommonParams & { bundle?: ZcashGetAddressParams[] }
+): Response<Array<ZcashAddress>>;

package/src/types/api/zcashGetFullViewingKey.ts

@@ -0,0 +1,24 @@
+import type { CommonParams, Response } from '../params';
+
+export type ZcashFullViewingKey = {
+  path: string;
+  // ZIP-316 unified full viewing key with transparent and Orchard components
+  ufvk: string;
+};
+
+export type ZcashGetFullViewingKeyParams = {
+  // ZIP-32 account path, m/32'/133'/account'
+  path: string | number[];
+};
+
+export declare function zcashGetFullViewingKey(
+  connectId: string,
+  deviceId: string,
+  params: CommonParams & ZcashGetFullViewingKeyParams
+): Response<ZcashFullViewingKey>;
+
+export declare function zcashGetFullViewingKey(
+  connectId: string,
+  deviceId: string,
+  params: CommonParams & { bundle?: ZcashGetFullViewingKeyParams[] }
+): Response<Array<ZcashFullViewingKey>>;

package/src/types/api/zcashSignPczt.ts

@@ -0,0 +1,18 @@
+import type { CommonParams, Response } from '../params';
+
+export type ZcashSignPcztParams = {
+  // Unproved PCZT (v2, tx v6) as hex; the device signs it and returns a
+  // redacted copy with signatures filled in.
+  pczt: string;
+};
+
+export type ZcashSignedPczt = {
+  // Signed, redacted PCZT as hex
+  pczt: string;
+};
+
+export declare function zcashSignPczt(
+  connectId: string,
+  deviceId: string,
+  params: CommonParams & ZcashSignPcztParams
+): Response<ZcashSignedPczt>;

package/src/types/device.ts

@@ -83,6 +83,24 @@ export type SearchDevice = {
   deviceType: IDeviceType;
   name: string;
   commType: OneKeyDeviceCommType;
+  /**
+   * React Native and Electron BLE discovery only. Serial-number color letter ('A'-'Z')
+   * advertised by Pro2 / Neo, possibly remembered from an earlier advertisement in this
+   * process. Absent when unknown; the letter's meaning depends on deviceType.
+   */
+  bleColorCode?: string;
+};
+
+/** Identity confirmed over USB. The descriptor path is only a transport address. */
+export type UsbDeviceIdentity = {
+  path: string;
+  serialNo: string | null;
+  deviceId: string | null;
+  deviceType: IDeviceType;
+  connectProtocol: HardwareConnectProtocol;
+  commType: 'webusb' | 'bridge';
+  /** Mode confirmed by the device response; absent when discovery cannot establish it. */
+  mode?: DeviceStateMode;
 };
 
 // export type UnknownDevice = {

package/src/types/params.ts

@@ -83,7 +83,7 @@ export type Params<T> = CommonParams & T & { bundle?: undefined };
 
 export interface Unsuccessful {
   success: false;
-  payload: { error: string; code?: string | number };
+  payload: { error: string; code?: string | number; params?: Record<string, unknown> };
 }
 
 export interface Success<T> {

package/src/utils/logger.ts

@@ -78,6 +78,10 @@ class Log {
 const _logs: { [k: string]: Log } = {};
 
 export const initLog = (prefix: string, enabled?: boolean) => {
+  // Loggers that share a prefix must share one instance; otherwise enableLog only reaches the
+  // last one registered and the others never print.
+  const existing = _logs[prefix];
+  if (existing) return existing;
   const instance = new Log(prefix, !!enabled);
   _logs[prefix] = instance;
   return instance;