@miden-sdk/para 0.16.0-rc.5 → 0.16.0-rc.6

package/dist/{types → cjs}/modalClient.d.ts

@@ -1,4 +1,4 @@
-import { TxSummaryJson } from "./types";
+import { TxSummaryJson } from "./types.js";
 /**
  * Shows a lightweight confirmation modal for signing a hashed transaction.
  * Resolves to true when the user confirms, false when cancelled; no-op on the server.

package/dist/{types → cjs}/utils.d.ts

@@ -1,7 +1,7 @@
 import ParaWeb, { Wallet } from "@getpara/web-sdk";
 import type { TransactionSummary } from "@miden-sdk/miden-sdk";
 import { hexToBytes } from "@noble/hashes/utils.js";
-import { TxSummaryJson } from "./types";
+import { TxSummaryJson } from "./types.js";
 /** @public */
 export { hexToBytes };
 /**

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./midenClient.js";
+export { evmPkToCommitment, getUncompressedPublicKeyFromWallet, } from "./utils.js";
+export type { MidenAccountOpts, Opts, MidenAccountStorageMode, TxSummaryJson, } from "./types.js";
+export type { CustomSignConfirmStep } from "./midenClient.js";

package/dist/esm/midenClient.d.ts

@@ -0,0 +1,19 @@
+import { ParaWeb, Wallet } from "@getpara/web-sdk";
+import type { Opts, TxSummaryJson } from "./types.js";
+import type { MidenClient } from "@miden-sdk/miden-sdk";
+export type CustomSignConfirmStep = (txSummaryJson: TxSummaryJson) => Promise<unknown>;
+/**
+ * Creates a signing callback that routes Miden signing requests through Para.
+ * Prompts the user with a modal before delegating the keccak-hashed message to Para's signer,
+ * and optionally runs a custom confirmation step in between.
+ */
+export declare const signCb: (para: ParaWeb, wallet: Wallet, showSigningModal: boolean, customSignConfirmStep?: CustomSignConfirmStep) => (_: Uint8Array, signingInputs: Uint8Array) => Promise<Uint8Array<ArrayBuffer>>;
+/**
+ * Builds a MidenClient wired to Para wallets and ensures an account exists for the user.
+ * Filters to EVM wallets, prompts for selection, creates the client, and
+ * hydrates or creates the corresponding Miden account before returning the client + account id.
+ */
+export declare function createParaMidenClient(para: ParaWeb, wallets: Wallet[], opts: Opts, showSigningModal?: boolean, customSignConfirmStep?: CustomSignConfirmStep): Promise<{
+    client: MidenClient;
+    accountId: string;
+}>;

package/dist/esm/modalClient.d.ts

@@ -0,0 +1,11 @@
+import { TxSummaryJson } from "./types.js";
+/**
+ * Shows a lightweight confirmation modal for signing a hashed transaction.
+ * Resolves to true when the user confirms, false when cancelled; no-op on the server.
+ */
+export declare const signingModal: (txSummaryJson: TxSummaryJson) => Promise<boolean>;
+/**
+ * Shows a selectable list of account commitments and resolves with the chosen index.
+ * Returns 0 immediately when only one account is provided or when running server-side.
+ */
+export declare const accountSelectionModal: (accounts: string[]) => Promise<number>;

package/dist/esm/types.d.ts

@@ -0,0 +1,34 @@
+/** @public */
+export interface MidenClientOpts {
+    endpoint?: string;
+    noteTransportUrl?: string;
+    /**
+     * @deprecated Use noteTransportUrl instead
+     */
+    nodeTransportUrl?: string;
+    seed?: string;
+}
+export type MidenAccountStorageMode = "public" | "private";
+export interface MidenAccountOpts {
+    accountSeed?: string;
+    storageMode: MidenAccountStorageMode;
+}
+export type Opts = MidenClientOpts & MidenAccountOpts;
+interface NoteIdAndAsset {
+    id: string;
+    assets: {
+        assetId: string;
+        amount: string;
+    }[];
+}
+interface InputNoteSender {
+    sender: string;
+}
+interface OutputNoteType {
+    noteType: string;
+}
+export interface TxSummaryJson {
+    inputNotes: (NoteIdAndAsset & InputNoteSender)[];
+    outputNotes: (NoteIdAndAsset & OutputNoteType)[];
+}
+export {};

package/dist/esm/utils.d.ts

@@ -0,0 +1,33 @@
+import ParaWeb, { Wallet } from "@getpara/web-sdk";
+import type { TransactionSummary } from "@miden-sdk/miden-sdk";
+import { hexToBytes } from "@noble/hashes/utils.js";
+import { TxSummaryJson } from "./types.js";
+/** @public */
+export { hexToBytes };
+/**
+ * Converts a Para hex signature into the serialized format expected by Miden.
+ * Prefixes the auth scheme byte and appends the extra padding byte required by current crypto libs.
+ */
+export declare const fromHexSig: (hexString: string) => Uint8Array<ArrayBuffer>;
+/**
+ * Derives a 32-byte seed buffer from a UTF-8 string, truncating when longer than 32 bytes.
+ */
+export declare const accountSeedFromStr: (str?: string) => Uint8Array<ArrayBuffer> | undefined;
+/**
+ * Converts an uncompressed EVM public key into a Miden commitment.
+ * Assumes input format `0x04${x}${y}` where x and y are 64-char hex strings.
+ *
+ * The protocol commits to the affine point as Poseidon2 over 16 field elements:
+ * the x coordinate then the y coordinate, each as eight 32-bit limbs in
+ * little-endian limb order. 0.15 hashed a different preimage — nine felts
+ * packed from the 33-byte compressed SEC1 encoding — so a commitment computed
+ * by an older release will not match one computed here.
+ */
+export declare const evmPkToCommitment: (uncompressedPublicKey: string) => Promise<import("@miden-sdk/miden-sdk").Word>;
+/**
+ * Retrieves the uncompressed public key for a Para wallet, falling back to JWT data when absent.
+ * Throws rather than returning undefined: callers derive the account commitment from this value,
+ * so an absent key is an error, not a state to propagate.
+ */
+export declare const getUncompressedPublicKeyFromWallet: (para: ParaWeb, wallet: Wallet) => Promise<string>;
+export declare const txSummaryToJson: (txSummary: TransactionSummary) => TxSummaryJson;

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@miden-sdk/para",
-  "version": "0.16.0-rc.5",
+  "version": "0.16.0-rc.6",
+  "type": "commonjs",
   "description": "Miden x Para Integration",
   "license": "MIT",
   "author": "Miden Contributors",
@@ -28,17 +29,22 @@
     "react": "^19.2.0",
     "react-test-renderer": "^19.2.0",
     "typescript": "^5.8.3",
-    "@miden-sdk/miden-sdk": "0.16.0-rc.5"
+    "@miden-sdk/miden-sdk": "0.16.0-rc.6"
   },
   "peerDependencies": {
     "@getpara/web-sdk": "^2.11.0",
-    "@miden-sdk/miden-sdk": "^0.16.0-rc.5"
+    "@miden-sdk/miden-sdk": "^0.16.0-rc.6"
   },
   "exports": {
     ".": {
-      "types": "./dist/types/index.d.ts",
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js"
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
     }
   },
   "files": [
@@ -49,8 +55,8 @@
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "sideEffects": false,
-  "types": "dist/types/index.d.ts",
-  "typings": "dist/types/index.d.ts",
+  "types": "dist/cjs/index.d.ts",
+  "typings": "dist/cjs/index.d.ts",
   "keywords": [
     "miden",
     "para",
@@ -63,11 +69,8 @@
   "scripts": {
     "test": "node --test",
     "build": "rm -rf dist && node ./scripts/build.mjs && npm run build:types",
-    "build:cjs": "rm -rf dist/cjs && tsc --module commonjs --outDir dist/cjs && printf '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
-    "build:esm": "rm -rf dist/esm && tsc --module es6 --outDir dist/esm && printf '{\"type\":\"module\",\"sideEffects\":false}' > dist/esm/package.json",
-    "build:types": "rm -rf dist/types && tsc --module es2020 --declarationDir dist/types --emitDeclarationOnly --declaration",
+    "build:types": "tsc --module es2020 --declarationDir dist/esm --emitDeclarationOnly --declaration && tsc --module commonjs --declarationDir dist/cjs --emitDeclarationOnly --declaration",
     "format": "pnpm exec prettier \"**/*.{js,jsx,ts,tsx}\" --write && pnpm exec eslint . --fix",
-    "format-check": "pnpm exec prettier \"**/*.{js,jsx,ts,tsx}\" && pnpm exec eslint",
-    "old-build": "pnpm run build:cjs && pnpm run build:esm && pnpm run build:types"
+    "format-check": "pnpm exec prettier \"**/*.{js,jsx,ts,tsx}\" && pnpm exec eslint"
   }
 }