@zkproofport-app/sdk 0.1.2-beta.1 → 0.2.0

package/dist/types.d.ts

@@ -138,7 +138,6 @@ export interface ProofRequest {
  *   numPublicInputs: 2,
  *   verifierAddress: '0x5678...',
  *   chainId: 84532,
- *   nullifier: '0x9abc...',
  *   timestamp: Date.now()
  * };
  * ```
@@ -164,8 +163,6 @@ export interface ProofResponse {
     verifierAddress?: string;
     /** Chain ID where verifier contract is deployed (provided by mobile app) */
     chainId?: number;
-    /** Nullifier for proof uniqueness (prevents double-use, derived from scope) */
-    nullifier?: string;
 }
 /**
  * Parsed and formatted proof data ready for on-chain verification.
@@ -264,13 +261,6 @@ export interface ProofportConfig {
     relayUrl?: string;
     /** Custom verifier contract addresses per circuit type (overrides defaults) */
     verifiers?: Partial<Record<CircuitType, VerifierContract>>;
-    /** Nullifier registry contract config. Required for checkNullifier() and getNullifierDetails(). */
-    nullifierRegistry?: {
-        /** Registry contract address */
-        address: string;
-        /** Chain ID where registry is deployed */
-        chainId: number;
-    };
 }
 /**
  * Parsed deep link URL components.
@@ -289,115 +279,44 @@ export interface DeepLinkComponents {
     params: Record<string, string>;
 }
 /**
- * Nullifier verification status returned by smart contract.
+ * Challenge response from relay server.
  *
- * Mirrors the NullifierVerifyStatus enum in the ZKProofportNullifierRegistry contract.
- * Indicates the result of verifying and registering a proof's nullifier on-chain.
- *
- * - `verified_and_registered`: Proof verified and nullifier registered successfully
- * - `already_registered`: Proof verified but nullifier was already used (duplicate)
- * - `expired_and_reregistered`: Previous nullifier expired, new one registered
- * - `verification_failed`: Proof verification failed (invalid proof)
- * - `circuit_not_found`: Circuit not registered in the registry
- */
-export type NullifierVerifyStatus = 'verified_and_registered' | 'already_registered' | 'expired_and_reregistered' | 'verification_failed' | 'circuit_not_found';
-/**
- * On-chain nullifier record from smart contract storage.
- *
- * Contains information about a registered nullifier retrieved from
- * the ZKProofportNullifierRegistry contract.
- *
- * @example
- * ```typescript
- * const record: NullifierRecord = {
- *   registeredAt: 1707234567,
- *   scope: '0xabcd...',
- *   circuitId: '0x1234...'
- * };
- * ```
- */
-export interface NullifierRecord {
-    /** Unix timestamp (seconds) when nullifier was registered */
-    registeredAt: number;
-    /** Scope bytes32 (application identifier) */
-    scope: string;
-    /** Circuit ID bytes32 (circuit identifier) */
-    circuitId: string;
-}
-/**
- * ZKProofportNullifierRegistry smart contract configuration.
- *
- * Contains the address and ABI for the nullifier registry contract,
- * which tracks used nullifiers to prevent proof replay attacks.
+ * The relay server issues a random challenge that must be signed
+ * by the user's wallet to authenticate proof requests.
  *
  * @example
  * ```typescript
- * const registryConfig: NullifierRegistryConfig = {
- *   address: '0x5678...',
- *   chainId: 84532,
- *   abi: ZKPROOFPORT_NULLIFIER_REGISTRY_ABI
+ * const challenge: ChallengeResponse = {
+ *   challenge: '0xabcdef...',
+ *   expiresAt: 1707234567890
  * };
  * ```
  */
-export interface NullifierRegistryConfig {
-    /** Registry contract address (checksummed) */
-    address: string;
-    /** Chain ID where registry is deployed */
-    chainId: number;
-    /** Contract ABI (ethers v6 format) */
-    abi: string[];
+export interface ChallengeResponse {
+    /** Hex-encoded 32-byte random challenge */
+    challenge: string;
+    /** Unix timestamp (ms) when challenge expires */
+    expiresAt: number;
 }
 /**
- * Client credentials for API authentication.
+ * Wallet signer interface for challenge signing.
+ * Compatible with ethers v6 Signer.
  *
- * Used to authenticate with the ZKProofport API server and obtain
- * a JWT token for making authenticated requests to the relay server.
+ * Any object implementing `signMessage` and `getAddress` can be used,
+ * including ethers v6 `Signer` instances.
  *
  * @example
  * ```typescript
- * const credentials: AuthCredentials = {
- *   clientId: 'your-client-id',
- *   apiKey: 'your-api-key'
- * };
- * ```
- */
-export interface AuthCredentials {
-    /** Client ID identifying the application */
-    clientId: string;
-    /** API key for authentication */
-    apiKey: string;
-}
-/**
- * JWT authentication token received from the API server.
- *
- * Contains the JWT token and metadata about the authenticated session,
- * including tier information, expiration time, and associated identifiers.
+ * import { BrowserProvider } from 'ethers';
  *
- * @example
- * ```typescript
- * const auth: AuthToken = {
- *   token: 'eyJhbGc...',
- *   clientId: 'your-client-id',
- *   dappId: 'app-123',
- *   tier: 'plan1',
- *   expiresIn: 3600,
- *   expiresAt: 1707234567890
- * };
+ * const provider = new BrowserProvider(window.ethereum);
+ * const signer = await provider.getSigner();
+ * // signer implements WalletSigner
  * ```
  */
-export interface AuthToken {
-    /** JWT token for authenticating relay requests */
-    token: string;
-    /** Client ID that the token was issued for */
-    clientId: string;
-    /** DApp ID associated with this client */
-    dappId: string;
-    /** Service tier (free, credit, plan1, plan2) */
-    tier: string;
-    /** Token lifetime in seconds (typically 3600 = 1 hour) */
-    expiresIn: number;
-    /** Unix timestamp (ms) when the token expires */
-    expiresAt: number;
+export interface WalletSigner {
+    signMessage(message: string | Uint8Array): Promise<string>;
+    getAddress(): Promise<string>;
 }
 /**
  * Result from creating a proof request via relay.
@@ -427,7 +346,6 @@ export interface RelayProofResult {
     publicInputs?: string[];
     verifierAddress?: string;
     chainId?: number;
-    nullifier?: string;
     circuit?: string;
     /** Present when status is 'failed' */
     error?: string;

package/dist/verifier.d.ts

@@ -145,80 +145,3 @@ export declare function getVerifierChainId(circuit: CircuitType, customVerifier?
  * ```
  */
 export declare function extractScopeFromPublicInputs(publicInputsHex: string[], circuit?: string): string | null;
-/**
- * Extract nullifier value from public inputs array.
- *
- * The nullifier is a bytes32 value encoded across 32 consecutive field elements
- * in the public inputs. The exact position depends on the circuit type.
- * Nullifiers are used for duplicate proof detection and must be unique per user+scope.
- *
- * @param publicInputsHex - Array of public input hex strings (zero-padded to 32 bytes)
- * @param circuit - Optional circuit identifier to determine field positions
- * @returns Reconstructed nullifier as hex string with 0x prefix, or null if inputs are insufficient
- *
- * @example
- * ```typescript
- * const nullifier = extractNullifierFromPublicInputs(publicInputsHex, 'coinbase_attestation');
- * console.log(nullifier); // '0xabcd1234...'
- *
- * // Check if nullifier is already registered
- * const isRegistered = await isNullifierRegistered(nullifier, registryAddress, provider);
- * ```
- */
-export declare function extractNullifierFromPublicInputs(publicInputsHex: string[], circuit?: string): string | null;
-/**
- * Check if a nullifier is already registered on-chain in the ZKProofport nullifier registry.
- *
- * This function queries the on-chain nullifier registry contract to determine if a nullifier
- * has been used before. This is used to prevent duplicate proof submissions from the same user
- * for the same scope.
- *
- * @param nullifier - The nullifier hash as hex string with 0x prefix
- * @param registryAddress - ZKProofportNullifierRegistry contract address
- * @param provider - ethers.js Provider instance (v5 or v6 compatible)
- * @returns Promise resolving to true if nullifier is registered, false otherwise
- *
- * @example
- * ```typescript
- * const nullifier = extractNullifierFromPublicInputs(publicInputsHex, circuit);
- * const isRegistered = await isNullifierRegistered(
- *   nullifier,
- *   '0x...',
- *   provider
- * );
- *
- * if (isRegistered) {
- *   console.log('This nullifier has already been used');
- * }
- * ```
- */
-export declare function isNullifierRegistered(nullifier: string, registryAddress: string, provider: any): Promise<boolean>;
-/**
- * Get detailed information about a registered nullifier from the on-chain registry.
- *
- * This function retrieves the registration timestamp, scope, and circuit ID for a nullifier
- * that has been registered on-chain. This metadata is useful for auditing and analytics.
- *
- * @param nullifier - The nullifier hash as hex string with 0x prefix
- * @param registryAddress - ZKProofportNullifierRegistry contract address
- * @param provider - ethers.js Provider instance (v5 or v6 compatible)
- * @returns Promise resolving to nullifier info object, or null if not registered
- *
- * @example
- * ```typescript
- * const info = await getNullifierInfo(nullifier, registryAddress, provider);
- *
- * if (info) {
- *   console.log('Registered at:', new Date(info.registeredAt * 1000));
- *   console.log('Scope:', info.scope);
- *   console.log('Circuit:', info.circuitId);
- * } else {
- *   console.log('Nullifier not registered');
- * }
- * ```
- */
-export declare function getNullifierInfo(nullifier: string, registryAddress: string, provider: any): Promise<{
-    registeredAt: number;
-    scope: string;
-    circuitId: string;
-} | null>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zkproofport-app/sdk",
-  "version": "0.1.2-beta.1",
+  "version": "0.2.0",
   "description": "ZKProofport SDK for requesting zero-knowledge proofs from the ZKProofport mobile app and verifying them on-chain",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",