@explorins/pers-signer 1.0.17 → 1.0.18

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import * as _explorins_web3_ts_types from '@explorins/web3-ts/types';
-import { AnyTransactionData, LegacyTransaction } from '@explorins/web3-ts/types';
-export { AnyTransactionData } from '@explorins/web3-ts/types';
+import { LegacyTransaction, AnyTransactionData } from '@explorins/web3-ts/types';
+export { AnyTransactionData, BaseTransaction, CounterfactualWalletEIP712Data, EIP1559Transaction, EIP2930Transaction, EIP712TransactionData, EIP712TypedData, LegacyTransaction } from '@explorins/web3-ts/types';
 import * as _explorins_pers_shared_browser from '@explorins/pers-shared/browser';
-import { TenantPublicDTO, SessionAuthContextResponseDTO, TransactionFormat, TransactionRequestResponseDTO, TransactionStatus, CounterfactualWalletTransactionResponse } from '@explorins/pers-shared/browser';
-export { TransactionFormat, TransactionRequestResponseDTO, TransactionStatus } from '@explorins/pers-shared/browser';
+import { CounterfactualWalletTransactionResponse, TransactionStatus, TransactionRequestResponseDTO, TenantPublicDTO, SessionAuthContextResponseDTO, TransactionFormat } from '@explorins/pers-shared/browser';
+export { CampaignClaimDTO, CampaignDTO, SessionAuthResponseDTO, TRANSACTION_FORMATS, TRANSACTION_FORMAT_DESCRIPTIONS, TransactionFormat, TransactionRequestResponseDTO, TransactionStatus, TransactionSubmissionRequestDTO } from '@explorins/pers-shared/browser';
 import { CounterfactualWalletTransactionResponse as CounterfactualWalletTransactionResponse$1 } from '@explorins/pers-shared';
 import { AbstractSigner, Provider, TransactionRequest, TypedDataDomain, TypedDataField } from 'ethers';
 
@@ -47,6 +47,9 @@ interface WrappedProviderResponse {
     data: unknown;
 }
 type LoginResponse = JWTLoginResponse | WrappedProviderResponse;
+interface VerifyTokenRequest {
+    token: string;
+}
 interface VerifyTokenResponse {
     valid: boolean;
     provider: string;
@@ -64,6 +67,19 @@ interface VerifyTokenResponse {
     };
     tenantId: string;
 }
+interface InitRegistrationRequest {
+    authToken: string;
+}
+interface InitRegistrationResponse {
+    success: true;
+    data: {
+        challenge?: string;
+        temporaryAuthenticationToken?: string;
+        user?: object;
+        [key: string]: unknown;
+    };
+}
+type CompleteRegistrationResponse = JWTLoginResponse | WrappedProviderResponse;
 interface ListWalletsRequest {
 }
 interface ListWalletsResponse {
@@ -73,6 +89,23 @@ interface ListWalletsResponse {
         [key: string]: unknown;
     };
 }
+interface InitSignatureRequest {
+    walletId: string;
+    request: unknown;
+}
+interface InitSignatureResponse {
+    success: true;
+    data: {
+        requestBody: unknown;
+        challenge: unknown;
+        [key: string]: unknown;
+    };
+}
+interface CompleteSignatureRequest {
+    walletId: string;
+    requestBody: unknown;
+    signedChallenge: unknown;
+}
 interface CompleteSignatureResponse {
     success: true;
     data: {
@@ -119,27 +152,233 @@ interface WebAuthnConfig {
 }
 
 /**
- * Shared type definitions for the blockchain signer shared library
+ * Key service response types and interfaces
+ */
+/**
+ * Signature response from key signing operations
+ */
+interface SignResponse {
+    id: string;
+    keyId: string;
+    requester: {
+        userId: string;
+        appId: string;
+    };
+    requestBody: {
+        hash: string;
+        kind: "Hash";
+    };
+    status: "Signed";
+    signature: {
+        r: string;
+        s: string;
+        v: number;
+        encoded: string;
+    };
+    network: "KeyECDSA";
+    dateRequested: string;
+    dateSigned: string;
+    walletId: string;
+}
+/**
+ * Authentication response from login/register operations
+ */
+interface AuthResponse {
+    token: string;
+    message?: string;
+    status?: number;
+}
+/**
+ * Registration challenge response
+ */
+interface RegistrationChallenge {
+    temporaryAuthenticationToken: string;
+    challenge: any;
+    status?: number;
+    message?: string;
+}
+/**
+ * Registration completion response
+ */
+interface RegistrationResult {
+    token: string;
+    walletId?: string;
+    status?: number;
+    message?: string;
+}
+/**
+ * Individual wallet item
+ */
+/**
+ * Hash signing request
+ */
+interface HashSigningRequest {
+    kind: "Hash";
+    hash: string;
+}
+/**
+ * EIP-712 typed data signing request
+ */
+interface TypedDataSigningRequest {
+    blockchainKind: "Evm";
+    kind: "Eip712";
+    types: Record<string, any[]>;
+    domain: any;
+    message: Record<string, any>;
+}
+/**
+ * Generic signing request
+ */
+type SigningRequest = HashSigningRequest | TypedDataSigningRequest;
+/**
+ * Signing challenge response
+ */
+interface SigningChallenge {
+    requestBody: any;
+    challenge: {
+        challengeIdentifier: string;
+        [key: string]: any;
+    };
+    status?: number;
+    message?: string;
+}
+/**
+ * User credentials for authentication
+ */
+interface UserCredentials {
+    username: string;
+    appId?: string;
+}
+/**
+ * Relying party configuration for WebAuthn
  */
+interface RelyingPartyConfig {
+    id: string;
+    name: string;
+    origin?: string;
+}
 
 /**
- * Authentication types for 3-function split architecture
+ * Combined transaction status type that includes both PERS and additional statuses
  */
-interface AuthenticatedUser {
-    identifier: string;
+type CombinedTransactionStatus = TransactionStatus;
+/**
+ * Transaction statuses that allow signing
+ */
+declare const SIGNABLE_STATUSES: readonly [TransactionStatus.PENDING_SIGNATURE, TransactionStatus.CREATED];
+/**
+ * Transaction status information for UI display
+ */
+interface TransactionStatusInfo {
+    transactionId: string;
+    transactionStatus: CombinedTransactionStatus;
+    message: string;
+}
+/**
+ * Transaction signing result
+ */
+interface TransactionSigningResult {
+    success: boolean;
+    transactionId: string;
+    signature?: string;
+    signingData?: CounterfactualWalletTransactionResponse | LegacyTransaction;
+    error?: string;
+    statusInfo?: TransactionStatusInfo;
+    shouldShowStatus?: boolean;
+}
+/**
+ * Transaction submission result for internal processing
+ */
+interface SubmissionResult {
+    submitResult: TransactionRequestResponseDTO;
+    shouldRedirect: boolean;
+    redirectUrl?: string;
+    transactionHash: string | null;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Metadata for transaction parameters - string values only
+ */
+/**
+ * Authentication tokens required for transaction signing
+ */
+interface SigningAuthTokens {
     signerAuthToken: string;
     persAccessToken: string;
+}
+/**
+ * Transaction signing parameters
+ */
+interface TransactionSigningParams {
+    transactionId: string;
     tenantId: string;
-    expiresAt: number;
+    authTokens: SigningAuthTokens;
+    ethersProviderUrl: string;
+    returnUrl?: string;
 }
+
 /**
- * Service configuration options
+ * Wallet list response from WalletService
  */
-interface ServiceConfig {
-    apiUrl: string;
-    environment: 'development' | 'staging' | 'production';
-    timeout?: number;
-    retryAttempts?: number;
+interface WalletListResponse {
+    items: WalletItem[];
+}
+/**
+ * Individual wallet item from wallet list - compatible with KeyWallet constructor
+ */
+interface WalletItem {
+    id: string;
+    address: string;
+    network: string;
+    status: string;
+    signingKey?: unknown;
+    dateCreated?: string;
+    custodial?: boolean;
+    tags?: string[];
+    boundToEvmNetwork?: boolean;
+    [key: string]: unknown;
+}
+
+/**
+ * Error codes for transaction signing operations
+ */
+declare enum TransactionSigningErrorCode {
+    INVALID_TOKENS = "INVALID_TOKENS",
+    TRANSACTION_NOT_FOUND = "TRANSACTION_NOT_FOUND",
+    TRANSACTION_NOT_PENDING = "TRANSACTION_NOT_PENDING",
+    WALLET_NOT_AVAILABLE = "WALLET_NOT_AVAILABLE",
+    WEBAUTHN_OPERATION_IN_PROGRESS = "WEBAUTHN_OPERATION_IN_PROGRESS",
+    SIGNING_CANCELLED = "SIGNING_CANCELLED",
+    PERS_AUTH_FAILED = "PERS_AUTH_FAILED",
+    AUTH_FAILED = "AUTH_FAILED",
+    TRANSACTION_NOT_READY = "TRANSACTION_NOT_READY",
+    SUBMISSION_FAILED = "SUBMISSION_FAILED",
+    SERVER_ERROR = "SERVER_ERROR",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+/**
+ * Structured error for transaction signing operations
+ */
+interface TransactionSigningError extends Error {
+    code: TransactionSigningErrorCode;
+    transactionId?: string;
+    originalError?: unknown;
+}
+
+/**
+ * Central type definitions for the blockchain signer shared library
+ * Single source of truth for all type exports
+ */
+
+/**
+ * Authentication types for 3-function split architecture
+ */
+interface AuthenticatedUser {
+    identifier: string;
+    signerAuthToken: string;
+    persAccessToken: string;
+    expiresAt: number;
 }
 /**
  * Error types for service operations
@@ -271,113 +510,6 @@ declare class PersService {
     static getTransactionDataForSigning(transactionResponse: TransactionRequestResponseDTO): _explorins_pers_shared_browser.CounterfactualWalletTransactionResponse | _explorins_web3_ts_types.LegacyTransaction;
 }
 
-/**
- * Key service response types and interfaces
- */
-/**
- * Signature response from key signing operations
- */
-interface SignResponse {
-    id: string;
-    keyId: string;
-    requester: {
-        userId: string;
-        appId: string;
-    };
-    requestBody: {
-        hash: string;
-        kind: "Hash";
-    };
-    status: "Signed";
-    signature: {
-        r: string;
-        s: string;
-        v: number;
-        encoded: string;
-    };
-    network: "KeyECDSA";
-    dateRequested: string;
-    dateSigned: string;
-    walletId: string;
-}
-/**
- * Authentication response from login/register operations
- */
-interface AuthResponse {
-    token: string;
-    message?: string;
-    status?: number;
-}
-/**
- * Registration challenge response
- */
-interface RegistrationChallenge {
-    temporaryAuthenticationToken: string;
-    challenge: any;
-    status?: number;
-    message?: string;
-}
-/**
- * Registration completion response
- */
-interface RegistrationResult {
-    token: string;
-    walletId?: string;
-    status?: number;
-    message?: string;
-}
-/**
- * Individual wallet item
- */
-/**
- * Hash signing request
- */
-interface HashSigningRequest {
-    kind: "Hash";
-    hash: string;
-}
-/**
- * EIP-712 typed data signing request
- */
-interface TypedDataSigningRequest {
-    blockchainKind: "Evm";
-    kind: "Eip712";
-    types: Record<string, any[]>;
-    domain: any;
-    message: Record<string, any>;
-}
-/**
- * Generic signing request
- */
-type SigningRequest = HashSigningRequest | TypedDataSigningRequest;
-/**
- * Signing challenge response
- */
-interface SigningChallenge {
-    requestBody: any;
-    challenge: {
-        challengeIdentifier: string;
-        [key: string]: any;
-    };
-    status?: number;
-    message?: string;
-}
-/**
- * User credentials for authentication
- */
-interface UserCredentials {
-    username: string;
-    appId?: string;
-}
-/**
- * Relying party configuration for WebAuthn
- */
-interface RelyingPartyConfig {
-    id: string;
-    name: string;
-    origin?: string;
-}
-
 /**
  * Signing service for cryptographic operations
  * Handles hash signing and typed data signing with WebAuthn
@@ -459,66 +591,6 @@ declare class KeyWallet extends AbstractSigner {
     signPersTransaction(transactionData: AnyTransactionData): Promise<string>;
 }
 
-/**
- * Combined transaction status type that includes both PERS and additional statuses
- */
-type CombinedTransactionStatus = TransactionStatus;
-/**
- * Transaction statuses that allow signing
- */
-declare const SIGNABLE_STATUSES: readonly [TransactionStatus.PENDING_SIGNATURE, TransactionStatus.CREATED];
-/**
- * Transaction status information for UI display
- */
-interface TransactionStatusInfo {
-    transactionId: string;
-    transactionStatus: CombinedTransactionStatus;
-    message: string;
-}
-/**
- * Transaction signing result
- */
-interface TransactionSigningResult {
-    success: boolean;
-    transactionId: string;
-    signature?: string;
-    signingData?: CounterfactualWalletTransactionResponse | LegacyTransaction;
-    error?: string;
-    statusInfo?: TransactionStatusInfo;
-    shouldShowStatus?: boolean;
-}
-/**
- * Transaction submission result for internal processing
- */
-interface SubmissionResult {
-    submitResult: TransactionRequestResponseDTO;
-    shouldRedirect: boolean;
-    redirectUrl?: string;
-    transactionHash: string | null;
-    success: boolean;
-    error?: string;
-}
-/**
- * Metadata for transaction parameters - string values only
- */
-/**
- * Authentication tokens required for transaction signing
- */
-interface SigningAuthTokens {
-    signerAuthToken: string;
-    persAccessToken: string;
-}
-/**
- * Transaction signing parameters
- */
-interface TransactionSigningParams {
-    transactionId: string;
-    tenantId: string;
-    authTokens: SigningAuthTokens;
-    ethersProviderUrl: string;
-    returnUrl?: string;
-}
-
 /**
  * Service for orchestrating transaction signing operations
  * Handles the complete flow from transaction preparation to submission
@@ -554,32 +626,6 @@ declare class TransactionSigningService {
     signTransaction(params: TransactionSigningParams, signingData: CounterfactualWalletTransactionResponse | LegacyTransaction): Promise<TransactionSigningResult>;
 }
 
-/**
- * Error codes for transaction signing operations
- */
-declare enum TransactionSigningErrorCode {
-    INVALID_TOKENS = "INVALID_TOKENS",
-    TRANSACTION_NOT_FOUND = "TRANSACTION_NOT_FOUND",
-    TRANSACTION_NOT_PENDING = "TRANSACTION_NOT_PENDING",
-    WALLET_NOT_AVAILABLE = "WALLET_NOT_AVAILABLE",
-    WEBAUTHN_OPERATION_IN_PROGRESS = "WEBAUTHN_OPERATION_IN_PROGRESS",
-    SIGNING_CANCELLED = "SIGNING_CANCELLED",
-    PERS_AUTH_FAILED = "PERS_AUTH_FAILED",
-    AUTH_FAILED = "AUTH_FAILED",
-    TRANSACTION_NOT_READY = "TRANSACTION_NOT_READY",
-    SUBMISSION_FAILED = "SUBMISSION_FAILED",
-    SERVER_ERROR = "SERVER_ERROR",
-    UNKNOWN_ERROR = "UNKNOWN_ERROR"
-}
-/**
- * Structured error for transaction signing operations
- */
-interface TransactionSigningError extends Error {
-    code: TransactionSigningErrorCode;
-    transactionId?: string;
-    originalError?: unknown;
-}
-
 /**
  * Handles all error-related operations for transaction signing
  */
@@ -789,28 +835,6 @@ declare function setHttpClient(client: HttpClient): void;
  */
 declare function getHttpClient(): HttpClient;
 
-/**
- * Wallet list response from WalletService
- */
-interface WalletListResponse {
-    items: WalletItem[];
-}
-/**
- * Individual wallet item from wallet list - compatible with KeyWallet constructor
- */
-interface WalletItem {
-    id: string;
-    address: string;
-    network: string;
-    status: string;
-    signingKey?: unknown;
-    dateCreated?: string;
-    custodial?: boolean;
-    tags?: string[];
-    boundToEvmNetwork?: boolean;
-    [key: string]: unknown;
-}
-
 /**
  * PERS Blockchain Signer SDK
  *
@@ -1035,14 +1059,6 @@ declare class PersSignerSDK {
  */
 declare function createPersSignerSDK(config: ExtendedPersSignerConfig): PersSignerSDK;
 
-/**
- * Authenticated user with all required tokens
- */
-interface SignerAuthenticatedUser {
-    identifier: string;
-    signerAuthToken: string;
-    persAccessToken: string;
-}
 /**
  * Authentication service for user login and registration
  * Uses constructor-based dependency injection for WebAuthn provider
@@ -1097,7 +1113,7 @@ declare class AuthenticationService {
      * @param relyingPartyConfig - Configuration for WebAuthn relying party
      * @returns Promise resolving to authenticated user with signer token
      */
-    combinedAuthentication(identifier: string, persAccessToken: string): Promise<SignerAuthenticatedUser>;
+    combinedAuthentication(identifier: string, persAccessToken: string): Promise<AuthenticatedUser>;
 }
 
 /**
@@ -1210,4 +1226,4 @@ declare class UserCache {
 }
 
 export { AuthenticationService, FetchHttpClient, HealthService, KeyWallet, PersService, PersSignerSDK, ReactNativeConfigProvider, SIGNABLE_STATUSES, SigningService, StaticConfigProvider, TransactionErrorHandler, TransactionSigningErrorCode, TransactionSigningService, TransactionSubmissionHandler, TransactionValidator, UserCache, WalletService, WebAuthnCoordinator, WebConfigProvider, createPersSignerSDK, extractJWTFromToken, getBrowserWebAuthnProvider, getConfigProvider, getHttpClient, getJWTPayload, getReactNativeWebAuthnProvider, getServiceConfig, isJWTExpired, setConfigProvider, setHttpClient };
-export type { AuthResponse, AuthenticatedUser, CombinedTransactionStatus, ConfigProvider, HashSigningRequest, HttpClient, HttpRequestOptions, HttpResponse, JWTExtractionResult, JWTPayload, ListWalletsRequest, ListWalletsResponse, LoginRequest, LoginResponse, PersSignerConfig, RegistrationChallenge, RegistrationResult, RelyingPartyConfig, ServiceConfig, ServiceError, SignResponse, SignerApiError, SignerApiResponse, SigningAuthTokens, SigningChallenge, SigningRequest, SubmissionResult, TransactionSigningError, TransactionSigningParams, TransactionSigningResult, TransactionStatusInfo, TypedDataSigningRequest, UserCredentials, WalletItem, WalletListResponse, WebAuthnConfig, WebAuthnProvider };
+export type { AuthResponse, AuthenticatedUser, CombinedTransactionStatus, CompleteRegistrationResponse, CompleteSignatureRequest, CompleteSignatureResponse, ConfigProvider, HashSigningRequest, HealthCheckResponse, HttpClient, HttpRequestOptions, HttpResponse, InitRegistrationRequest, InitRegistrationResponse, InitSignatureRequest, InitSignatureResponse, JWTExtractionResult, JWTPayload, ListWalletsRequest, ListWalletsResponse, LoginRequest, LoginResponse, PersSignerConfig, RegistrationChallenge, RegistrationResult, RelyingPartyConfig, ServiceError, SignResponse, SignerApiError, SignerApiResponse, SigningAuthTokens, SigningChallenge, SigningRequest, SubmissionResult, TransactionSigningError, TransactionSigningParams, TransactionSigningResult, TransactionStatusInfo, TypedDataSigningRequest, UserCredentials, VerifyTokenRequest, VerifyTokenResponse, WalletItem, WalletListResponse, WebAuthnConfig, WebAuthnProvider };