@provex/proving 1.8.0

package/dist/useProving.d.cts

@@ -0,0 +1,91 @@
+import { Hex } from 'viem';
+import { V3AttestationResponseObject } from '@provex/utils';
+import { c as CaptureAdapter, a as CaptureRequest, S as SelectTransaction, e as ProvingState } from './types-ByiBb7AN.cjs';
+import '@provex/utils/tokens';
+
+/**
+ * @fileoverview useProving — headless orchestrator for the enclave proving
+ * pipeline. Replicates the live AuthenticateStep/GenerateProofStep/SubmitStep
+ * state machine (ProofPanel) with no presentation. Renders nothing; returns
+ * state + actions for a UI (UnifiedBuy ProofPanel or a wallet) to bind to.
+ *
+ * Owns: the ProvingState machine, the nullifier double-spend check
+ * (SubmitStep.tsx:419-426), the attest→fulfil sequencing, retry routing
+ * (SubmitStep.tsx:931-955), and the minimum-visible-state timings
+ * (SubmitStep.tsx:404-417). Delegates capture to the injected CaptureAdapter,
+ * the on-chain write (+ receipt + indexer sync) to ProveXClient.fulfillIntent.
+ */
+
+/**
+ * Minimal context object that buildWritableMethod passes to the per-call hooks.
+ * Kept structural so @provex/proving does not depend on @valve-tech/wallet-adapter.
+ * Only `hash` is consumed by this hook — the rest is opaque context.
+ */
+interface TxCallbackContext {
+    chainId: number;
+    request: unknown;
+}
+/** Structural params for the fulfillIntent call. Mirrors FulfillIntentParams +
+ *  WriteHookParams from @provex/react but declared here to keep @provex/proving
+ *  from depending on the React package's built dist (which the test environment
+ *  doesn't require). The real ProveXClient.fulfillIntent satisfies this shape.
+ *
+ *  IMPORTANT: onAwaitingSignature and onTransactionHash match the exact call
+ *  shapes in buildWritableMethod (ProveXClient.ts ~890, ~903):
+ *    params.onAwaitingSignature?.(ctx)              → (info: TxCallbackContext) => void
+ *    params.onTransactionHash?.({ ...ctx, hash })   → (info: TxCallbackContext & { hash: Hex }) => void
+ */
+interface FulfillParams {
+    intentHash: Hex;
+    attestation: V3AttestationResponseObject;
+    verificationData: Hex;
+    postIntentHookData?: Hex;
+    onAwaitingSignature?: (info: TxCallbackContext) => void;
+    onTransactionHash?: (info: TxCallbackContext & {
+        hash: Hex;
+    }) => void;
+}
+/** The structural slice of ProveXClient the orchestrator depends on. Keeping
+ *  it structural lets tests pass a light fake and avoids importing the class. */
+interface ProvingClient {
+    fulfillIntent: (params: FulfillParams) => Promise<{
+        hash: Hex;
+        receipt: unknown;
+    }>;
+    checkNullifierUsed: (params: {
+        paymentMethodId: Hex;
+        nullifier: Hex;
+    }) => Promise<boolean | null>;
+}
+interface UseProvingOptions {
+    client: ProvingClient;
+    captureAdapter: CaptureAdapter;
+    request: CaptureRequest;
+    /** Payment method id for the nullifier registry lookup. */
+    paymentMethodId: Hex;
+    /** Manual-select resolver forwarded to the adapter. */
+    selectTransaction?: SelectTransaction;
+    /**
+     * Forwarded to ProveXClient.fulfillIntent for the consumer's tx-flight strip.
+     * Receives the raw TxContext — the hook does not inspect the argument.
+     */
+    onAwaitingSignature?: () => void;
+    /** Receives the raw tx hash extracted from the TxContext+hash payload. */
+    onTransactionHash?: (hash: Hex) => void;
+    /** Called once when the flow reaches `complete`. */
+    onComplete?: (attestation: V3AttestationResponseObject) => void;
+}
+interface UseProvingReturn {
+    state: ProvingState;
+    /** Phase 1+2: authenticate, capture, attest, nullifier-check → readyToFulfill. */
+    authenticate: () => Promise<void>;
+    /** Phase 3: submit fulfillIntent → confirm → sync → complete. */
+    fulfill: () => Promise<void>;
+    /** Re-run attestation after a pre-fulfilment error. */
+    retryVerification: () => Promise<void>;
+    /** Re-run submission after a post-fulfilment error. */
+    retrySubmission: () => Promise<void>;
+}
+declare function useProving(options: UseProvingOptions): UseProvingReturn;
+
+export { type ProvingClient, type UseProvingOptions, type UseProvingReturn, useProving };

package/dist/useProving.d.ts

@@ -0,0 +1,91 @@
+import { Hex } from 'viem';
+import { V3AttestationResponseObject } from '@provex/utils';
+import { c as CaptureAdapter, a as CaptureRequest, S as SelectTransaction, e as ProvingState } from './types-ByiBb7AN.js';
+import '@provex/utils/tokens';
+
+/**
+ * @fileoverview useProving — headless orchestrator for the enclave proving
+ * pipeline. Replicates the live AuthenticateStep/GenerateProofStep/SubmitStep
+ * state machine (ProofPanel) with no presentation. Renders nothing; returns
+ * state + actions for a UI (UnifiedBuy ProofPanel or a wallet) to bind to.
+ *
+ * Owns: the ProvingState machine, the nullifier double-spend check
+ * (SubmitStep.tsx:419-426), the attest→fulfil sequencing, retry routing
+ * (SubmitStep.tsx:931-955), and the minimum-visible-state timings
+ * (SubmitStep.tsx:404-417). Delegates capture to the injected CaptureAdapter,
+ * the on-chain write (+ receipt + indexer sync) to ProveXClient.fulfillIntent.
+ */
+
+/**
+ * Minimal context object that buildWritableMethod passes to the per-call hooks.
+ * Kept structural so @provex/proving does not depend on @valve-tech/wallet-adapter.
+ * Only `hash` is consumed by this hook — the rest is opaque context.
+ */
+interface TxCallbackContext {
+    chainId: number;
+    request: unknown;
+}
+/** Structural params for the fulfillIntent call. Mirrors FulfillIntentParams +
+ *  WriteHookParams from @provex/react but declared here to keep @provex/proving
+ *  from depending on the React package's built dist (which the test environment
+ *  doesn't require). The real ProveXClient.fulfillIntent satisfies this shape.
+ *
+ *  IMPORTANT: onAwaitingSignature and onTransactionHash match the exact call
+ *  shapes in buildWritableMethod (ProveXClient.ts ~890, ~903):
+ *    params.onAwaitingSignature?.(ctx)              → (info: TxCallbackContext) => void
+ *    params.onTransactionHash?.({ ...ctx, hash })   → (info: TxCallbackContext & { hash: Hex }) => void
+ */
+interface FulfillParams {
+    intentHash: Hex;
+    attestation: V3AttestationResponseObject;
+    verificationData: Hex;
+    postIntentHookData?: Hex;
+    onAwaitingSignature?: (info: TxCallbackContext) => void;
+    onTransactionHash?: (info: TxCallbackContext & {
+        hash: Hex;
+    }) => void;
+}
+/** The structural slice of ProveXClient the orchestrator depends on. Keeping
+ *  it structural lets tests pass a light fake and avoids importing the class. */
+interface ProvingClient {
+    fulfillIntent: (params: FulfillParams) => Promise<{
+        hash: Hex;
+        receipt: unknown;
+    }>;
+    checkNullifierUsed: (params: {
+        paymentMethodId: Hex;
+        nullifier: Hex;
+    }) => Promise<boolean | null>;
+}
+interface UseProvingOptions {
+    client: ProvingClient;
+    captureAdapter: CaptureAdapter;
+    request: CaptureRequest;
+    /** Payment method id for the nullifier registry lookup. */
+    paymentMethodId: Hex;
+    /** Manual-select resolver forwarded to the adapter. */
+    selectTransaction?: SelectTransaction;
+    /**
+     * Forwarded to ProveXClient.fulfillIntent for the consumer's tx-flight strip.
+     * Receives the raw TxContext — the hook does not inspect the argument.
+     */
+    onAwaitingSignature?: () => void;
+    /** Receives the raw tx hash extracted from the TxContext+hash payload. */
+    onTransactionHash?: (hash: Hex) => void;
+    /** Called once when the flow reaches `complete`. */
+    onComplete?: (attestation: V3AttestationResponseObject) => void;
+}
+interface UseProvingReturn {
+    state: ProvingState;
+    /** Phase 1+2: authenticate, capture, attest, nullifier-check → readyToFulfill. */
+    authenticate: () => Promise<void>;
+    /** Phase 3: submit fulfillIntent → confirm → sync → complete. */
+    fulfill: () => Promise<void>;
+    /** Re-run attestation after a pre-fulfilment error. */
+    retryVerification: () => Promise<void>;
+    /** Re-run submission after a post-fulfilment error. */
+    retrySubmission: () => Promise<void>;
+}
+declare function useProving(options: UseProvingOptions): UseProvingReturn;
+
+export { type ProvingClient, type UseProvingOptions, type UseProvingReturn, useProving };

package/dist/useProving.js

@@ -0,0 +1,3 @@
+export { useProving } from './chunk-LFDS3XGK.js';
+//# sourceMappingURL=useProving.js.map
+//# sourceMappingURL=useProving.js.map

package/dist/useProving.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"useProving.js"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@provex/proving",
+  "version": "1.8.0",
+  "description": "Headless enclave proving orchestrator for the Provex buy flow",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/provex-tech/monorepo.git",
+    "directory": "packages/proving"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./useProving": {
+      "types": "./dist/useProving.d.ts",
+      "import": "./dist/useProving.js",
+      "require": "./dist/useProving.cjs"
+    },
+    "./adapters/extensionEnclave": {
+      "types": "./dist/adapters/extensionEnclave.d.ts",
+      "import": "./dist/adapters/extensionEnclave.js",
+      "require": "./dist/adapters/extensionEnclave.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@provex/react": "1.8.0",
+    "@provex/utils": "1.8.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.2.0",
+    "@types/react": "^18.3.3",
+    "jsdom": "^26.0.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.2",
+    "viem": "^2.38.0",
+    "vitest": "^2.1.8"
+  }
+}