@dynamic-labs-wallet/node-midnight 0.0.0 → 1.0.115

package/package.json

@@ -1 +1,38 @@
-{ "name": "@dynamic-labs-wallet/node-midnight ", "version": "0.0.0" }
+{
+  "name": "@dynamic-labs-wallet/node-midnight",
+  "version": "1.0.115",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "@dynamic-labs-wallet/node": "1.0.115",
+    "@midnight-ntwrk/ledger-v8": "^8.1.0",
+    "@midnight-ntwrk/wallet-sdk-address-format": "3.1.2",
+    "@scure/bip32": "^2.0.1",
+    "bech32": "^2.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "nx": {
+    "sourceRoot": "packages/node-midnight/src",
+    "projectType": "library",
+    "name": "node-midnight",
+    "targets": {
+      "build": {}
+    }
+  },
+  "main": "./index.cjs",
+  "module": "./index.esm.js",
+  "types": "./index.esm.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./index.esm.d.ts",
+      "import": "./index.esm.js",
+      "require": "./index.cjs"
+    }
+  },
+  "devDependencies": {
+    "@types/http-errors": "^2.0.0"
+  }
+}

package/src/client/client.d.ts

@@ -0,0 +1,193 @@
+import { DynamicWalletClient, type DynamicWalletClientProps, type BIP340KeygenResult, type ServerKeyShare, type ThresholdSignatureScheme, type WalletMetadata } from '@dynamic-labs-wallet/node';
+import { type MidnightNetwork } from '../utils/address/index.js';
+export type DynamicMidnightWalletClientProps = DynamicWalletClientProps & {
+    /** Network whose bech32m HRP addresses are encoded with. Defaults to 'preview'. */
+    network?: MidnightNetwork;
+};
+/** Credentials every key-material operation needs. */
+export type MidnightWalletAccess = {
+    walletMetadata: WalletMetadata;
+    password?: string;
+    externalServerKeyShares?: ServerKeyShare[];
+    elevatedAccessToken?: string;
+    /** 0/'preview' (default) or 1/'mainnet'. */
+    networkId?: number | string;
+};
+/**
+ * Midnight's three key roles, each derived from the same MPC master xprv.
+ * Secret material — hold in memory only, never log or persist.
+ */
+export type MidnightRoleKeys = {
+    /** Role 0 (NightExternal) — public transfers, MPC-signed. */
+    unshielded: string;
+    /** Role 3 (Zswap) — private transfers, signed client-side. */
+    shielded: string;
+    /** Role 2 (Dust) — gas/fee management, signed client-side. */
+    dust: string;
+};
+export declare class DynamicMidnightWalletClient extends DynamicWalletClient {
+    readonly chainName = "MIDNIGHT";
+    private readonly network;
+    constructor({ environmentId, baseApiUrl, baseMPCRelayApiUrl, debug, enableMPCAccelerator, logger, network, }: DynamicMidnightWalletClientProps);
+    /**
+     * Creates a new wallet account.
+     * @param thresholdSignatureScheme - The threshold signature scheme to use for the wallet.
+     * @param password - The password to use for the wallet.
+     * @param onError - The function to call if an error occurs.
+     * @param backUpToDynamic - Whether to back up the external server key shares to the client share service. By default, it is false.
+     * @returns The walletMetadata, public key hex, raw public key, and external server key shares.
+     */
+    createWalletAccount({ thresholdSignatureScheme, password, onError, backUpToDynamic, }: {
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+        password?: string;
+        onError?: (error: Error) => void;
+        backUpToDynamic?: boolean;
+    }): Promise<{
+        walletMetadata: WalletMetadata;
+        publicKeyHex: string;
+        rawPublicKey: Uint8Array | string;
+        externalServerKeyShares: ServerKeyShare[];
+        externalKeySharesWithBackupStatus: Array<{
+            share: ServerKeyShare;
+            backedUpToClientKeyShareService: boolean;
+        }>;
+    }>;
+    /**
+     * Signs a message using MPC
+     * @param message - The message to sign
+     * @param walletMetadata - Wallet metadata (the full object returned by createWalletAccount/importPrivateKey, with backupInfo merged from any subsequent updatePassword/refresh/reshare)
+     * @param password - The password for encrypted backup shares
+     * @param externalServerKeyShares - The external server key shares
+     * @param onError - The function to call if an error occurs
+     * @returns The signature as a base64 string
+     */
+    signMessage({ message, walletMetadata, password, externalServerKeyShares, onError, }: {
+        message: string;
+        walletMetadata: WalletMetadata;
+        password?: string;
+        externalServerKeyShares?: ServerKeyShare[];
+        onError?: (error: Error) => void;
+    }): Promise<string>;
+    /**
+     * Exports the private key for a given wallet.
+     *
+     * Returns the unshielded (role 0) key at the wallet's derivation path. The
+     * shielded and dust role keys need the master xprv, which `exportKey` does
+     * not surface — see the package README.
+     *
+     * @param walletMetadata - Wallet metadata (the full object returned by createWalletAccount/importPrivateKey, with backupInfo merged from any subsequent updatePassword/refresh/reshare)
+     * @param password - The password for encrypted backup shares
+     * @param externalServerKeyShares - The external server key shares
+     * @returns The private key as a hex string
+     */
+    exportPrivateKey({ walletMetadata, password, externalServerKeyShares, }: {
+        walletMetadata: WalletMetadata;
+        password?: string;
+        externalServerKeyShares?: ServerKeyShare[];
+    }): Promise<string>;
+    /**
+     * Exports the private key offline using key shares
+     * @param keyShares - The key shares to export the private key for
+     * @param derivationPath - The derivation path
+     * @returns The derived private key
+     *
+     * `derivationPath` is the JSON-serialized index map that
+     * `walletMetadata.derivationPath` carries (e.g. `'{"0":44,"1":2400,"2":0,"3":0,"4":0}'`
+     * or `'[44,2400,0,0,0]'`). BIP-32 strings such as `"m/44'/2400'/0'/0/0"` are rejected.
+     * Omit it to export without path derivation.
+     */
+    offlineExportPrivateKey({ keyShares, derivationPath, }: {
+        keyShares: BIP340KeygenResult[];
+        derivationPath?: string;
+    }): Promise<{
+        derivedPrivateKey: string | undefined;
+    }>;
+    /**
+     * Imports a private key.
+     * @param privateKey - The private key to import.
+     * @param chainName - The chain name to use for the wallet.
+     * @param thresholdSignatureScheme - The threshold signature scheme to use for the wallet.
+     * @param password - The password to use for the wallet.
+     * @param onError - The function to call if an error occurs.
+     * @param backUpToDynamic - Whether to back up the external server key shares to the client share service.
+     * @param publicAddressCheck - Optional public address to verify against the derived address.
+     * @returns The walletMetadata, public key hex, raw public key, and external server key shares.
+     */
+    importPrivateKey({ privateKey, chainName, thresholdSignatureScheme, password, onError, backUpToDynamic, publicAddressCheck, }: {
+        privateKey: string;
+        chainName: string;
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+        password?: string;
+        onError?: (error: Error) => void;
+        backUpToDynamic?: boolean;
+        publicAddressCheck?: string;
+    }): Promise<{
+        walletMetadata: WalletMetadata;
+        publicKeyHex: string;
+        rawPublicKey: Uint8Array | string | undefined;
+        externalServerKeyShares: ServerKeyShare[];
+        externalKeySharesWithBackupStatus: Array<{
+            share: ServerKeyShare;
+            backedUpToClientKeyShareService: boolean;
+        }>;
+    }>;
+    /**
+     * Derives the BIP340 verifying key from a private key
+     * @param privateKeyHex - The private key as a hex string
+     * @returns The verifying key as a hex string
+     */
+    getPublicKeyFromPrivateKey(privateKeyHex: string): string;
+    /**
+     * Derives the bech32m unshielded account address from a BIP340 public key.
+     * The address is the Poseidon hash of the verifying key, not the key itself.
+     */
+    deriveAccountAddress: ({ publicKeyHex, network }: {
+        publicKeyHex: string;
+        network?: MidnightNetwork;
+    }) => string;
+    /**
+     * Derives the unshielded, shielded, and dust role keys from the wallet's MPC
+     * master xprv.
+     *
+     * Deliberately not persisted: these are plaintext secrets, and writing them
+     * to disk or a cache would trade a per-session MPC export for a durable
+     * exfiltration target. Callers should hold the result only as long as the
+     * operation needs it.
+     *
+     * @returns The three role private keys as hex strings
+     */
+    protected getRoleKeys({ walletMetadata, password, externalServerKeyShares, elevatedAccessToken, }: {
+        walletMetadata: WalletMetadata;
+        password?: string;
+        externalServerKeyShares?: ServerKeyShare[];
+        elevatedAccessToken?: string;
+    }): Promise<MidnightRoleKeys>;
+    /**
+     * Derives the wallet's three receiving addresses.
+     *
+     * Only the unshielded address comes from the MPC keygen (secp256k1/BIP340);
+     * shielded uses JubJub and dust BLS12-381, so both are derived client-side
+     * from the role keys. Requires an MPC export, but no facade or sync.
+     *
+     * @returns bech32m addresses for the requested network
+     */
+    getAddresses(access: MidnightWalletAccess): Promise<{
+        unshielded: string;
+        shielded: string;
+        dust?: string;
+    }>;
+    /**
+     * Gets all Midnight wallets
+     * @returns Array of Midnight wallets
+     */
+    getMidnightWallets(): Promise<{
+        walletId: string;
+        chainName: string;
+        accountAddress: string;
+        externalServerKeySharesBackupInfo: import("@dynamic-labs-wallet/core").KeyShareBackupInfo;
+        externalServerKeyShares: never[];
+        derivationPath: string | undefined;
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+    }[]>;
+}
+//# sourceMappingURL=client.d.ts.map

package/src/client/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"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"}

package/src/client/constants.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Facade network tag: which Midnight network the wallet runtime (relay, indexer,
+ * proof server, sync state) operates against. Distinct from the numeric
+ * replay-protection id below.
+ */
+export type MidnightNetworkTag = 'preview' | 'mainnet';
+export declare const MIDNIGHT_NETWORK_IDS: {
+    readonly mainnet: 1;
+    readonly preview: 0;
+    readonly preprod: 0;
+    readonly undeployed: 0;
+};
+export type MidnightNetworkName = keyof typeof MIDNIGHT_NETWORK_IDS;
+/**
+ * Resolves a caller-supplied network identifier (numeric 0/1, network name, or
+ * `midnight:<network>` chainId) to the facade network tag. Defaults to 'preview'.
+ */
+export declare const resolveMidnightNetworkTag: (networkId?: number | string) => MidnightNetworkTag;
+export declare const ERROR_KEYGEN_FAILED = "Error with keygen";
+export declare const ERROR_CREATE_WALLET_ACCOUNT = "Error creating midnight wallet account";
+export declare const ERROR_IMPORT_PRIVATE_KEY = "Error importing private key";
+export declare const ERROR_EXPORT_PRIVATE_KEY = "Error exporting private key";
+export declare const ERROR_SIGN_MESSAGE = "Error signing message";
+export declare const ERROR_ACCOUNT_ADDRESS_REQUIRED = "Account address is required";
+//# sourceMappingURL=constants.d.ts.map

package/src/client/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/client/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,CAAC;AAIvD,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,yBAAyB,eAAgB,MAAM,GAAG,MAAM,KAAG,kBAKvE,CAAC;AAEF,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAEvD,eAAO,MAAM,2BAA2B,2CAA2C,CAAC;AAEpF,eAAO,MAAM,wBAAwB,gCAAgC,CAAC;AAEtE,eAAO,MAAM,wBAAwB,gCAAgC,CAAC;AAEtE,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAE1D,eAAO,MAAM,8BAA8B,gCAAgC,CAAC"}

package/src/client/index.d.ts

@@ -0,0 +1,3 @@
+export { DynamicMidnightWalletClient, type DynamicMidnightWalletClientProps, type MidnightRoleKeys, type MidnightWalletAccess, } from './client.js';
+export { ERROR_ACCOUNT_ADDRESS_REQUIRED, ERROR_CREATE_WALLET_ACCOUNT, ERROR_EXPORT_PRIVATE_KEY, ERROR_IMPORT_PRIVATE_KEY, ERROR_KEYGEN_FAILED, ERROR_SIGN_MESSAGE, MIDNIGHT_NETWORK_IDS, resolveMidnightNetworkTag, type MidnightNetworkName, type MidnightNetworkTag, } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/src/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,KAAK,gCAAgC,EACrC,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC"}

package/src/index.d.ts

@@ -0,0 +1,3 @@
+export { DynamicMidnightWalletClient, ERROR_ACCOUNT_ADDRESS_REQUIRED, ERROR_CREATE_WALLET_ACCOUNT, ERROR_EXPORT_PRIVATE_KEY, ERROR_IMPORT_PRIVATE_KEY, ERROR_KEYGEN_FAILED, ERROR_SIGN_MESSAGE, MIDNIGHT_NETWORK_IDS, resolveMidnightNetworkTag, type DynamicMidnightWalletClientProps, type MidnightNetworkName, type MidnightNetworkTag, type MidnightRoleKeys, type MidnightWalletAccess, } from './client/index.js';
+export { decodeMidnightAddress, deriveMidnightAddress, getNetworkFromAddress, isValidMidnightAddress, toXOnlyPublicKeyHex, type MidnightNetwork, } from './utils/index.js';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../packages/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,KAAK,gCAAgC,EACrC,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC"}

package/src/utils/address/address.d.ts

@@ -0,0 +1,30 @@
+/** Bech32m HRPs (BIP-0350) for Midnight unshielded addresses, per network. */
+declare const ADDRESS_PREFIXES: {
+    readonly mainnet: "mn_addr";
+    readonly preview: "mn_addr_preview";
+    readonly preprod: "mn_addr_preprod";
+    readonly undeployed: "mn_addr_undeployed";
+};
+export type MidnightNetwork = keyof typeof ADDRESS_PREFIXES;
+/**
+ * Encodes a 32-byte Midnight address hash as a bech32m address.
+ *
+ * The input is the *address hash* (`ledger.addressFromKey()` — a Poseidon hash
+ * of the verifying key), not the raw public key. Use {@link addressHashFromPublicKey}
+ * to produce it.
+ */
+export declare const deriveMidnightAddress: ({ addressHashHex, network, }: {
+    addressHashHex: string;
+    network?: MidnightNetwork;
+}) => string;
+export declare const isValidMidnightAddress: (address: string) => boolean;
+export declare const decodeMidnightAddress: (address: string) => Buffer;
+export declare const getNetworkFromAddress: (address: string) => MidnightNetwork;
+/**
+ * Normalizes an MPC-returned BIP340 public key to the 32-byte x-only hex form
+ * that `ledger.addressFromKey()` expects, dropping the 02/03 parity byte if the
+ * key arrived in 33-byte compressed form.
+ */
+export declare const toXOnlyPublicKeyHex: (publicKeyHex: string) => string;
+export {};
+//# sourceMappingURL=address.d.ts.map

package/src/utils/address/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../../src/utils/address/address.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,QAAA,MAAM,gBAAgB;;;;;CAKZ,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,iCAG/B;IACD,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,KAAG,MAQH,CAAC;AAWF,eAAO,MAAM,sBAAsB,YAAa,MAAM,KAAG,OAUxD,CAAC;AAEF,eAAO,MAAM,qBAAqB,YAAa,MAAM,KAAG,MAMvD,CAAC;AAEF,eAAO,MAAM,qBAAqB,YAAa,MAAM,KAAG,eAOvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,iBAAkB,MAAM,KAAG,MAU1D,CAAC"}

package/src/utils/address/index.d.ts

@@ -0,0 +1,2 @@
+export { decodeMidnightAddress, deriveMidnightAddress, getNetworkFromAddress, isValidMidnightAddress, toXOnlyPublicKeyHex, type MidnightNetwork, } from './address.js';
+//# sourceMappingURL=index.d.ts.map

package/src/utils/address/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/address/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC"}

package/src/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { decodeMidnightAddress, deriveMidnightAddress, getNetworkFromAddress, isValidMidnightAddress, toXOnlyPublicKeyHex, type MidnightNetwork, } from './address/index.js';
+//# sourceMappingURL=index.d.ts.map

package/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC"}