@cmdoss/memwal-sdk 0.7.0 → 0.9.0

package/src/client/signers/KeypairSigner.ts

@@ -1,108 +1,108 @@
-/**
- * Keypair Signer Implementation
- *
- * Wraps @mysten/sui Keypair for use with SimplePDWClient.
- * Suitable for Node.js, backend services, CLI tools.
- *
- * @example
- * ```typescript
- * import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
- * import { KeypairSigner } from 'personal-data-wallet-sdk/client';
- *
- * const keypair = Ed25519Keypair.fromSecretKey(privateKey);
- * const signer = new KeypairSigner(keypair, suiClient);
- *
- * const pdw = await createPDWClient({
- *   signer,
- *   network: 'testnet'
- * });
- * ```
- *
- * @module client/signers
- */
-
-import type { SuiClient } from '@mysten/sui/client';
-import type { Keypair, Signer } from '@mysten/sui/cryptography';
-import type { Transaction } from '@mysten/sui/transactions';
-import type {
-  UnifiedSigner,
-  SignAndExecuteResult,
-  SignPersonalMessageResult
-} from './UnifiedSigner';
-
-/**
- * Keypair-based signer for Node.js and backend environments
- */
-export class KeypairSigner implements UnifiedSigner {
-  constructor(
-    private keypair: Keypair,
-    private client: SuiClient
-  ) {}
-
-  /**
-   * Sign and execute transaction using keypair
-   */
-  async signAndExecuteTransaction(transaction: Transaction): Promise<SignAndExecuteResult> {
-    const result = await this.client.signAndExecuteTransaction({
-      transaction,
-      signer: this.keypair,
-      options: {
-        showEffects: true,
-        showEvents: true,
-        showObjectChanges: true
-      }
-    });
-
-    // Wait for transaction to be finalized to prevent gas coin version conflicts
-    if (result.digest) {
-      await this.client.waitForTransaction({ digest: result.digest });
-    }
-
-    return {
-      digest: result.digest,
-      effects: result.effects,
-      events: result.events || undefined,
-      objectChanges: result.objectChanges || undefined
-    };
-  }
-
-  /**
-   * Sign personal message using keypair
-   */
-  async signPersonalMessage(message: Uint8Array): Promise<SignPersonalMessageResult> {
-    const { signature } = await this.keypair.signPersonalMessage(message);
-
-    return {
-      signature,  // Base64 string
-      bytes: message  // Original message bytes
-    };
-  }
-
-  /**
-   * Get Sui address from keypair
-   */
-  getAddress(): string {
-    return this.keypair.getPublicKey().toSuiAddress();
-  }
-
-  /**
-   * Get public key bytes
-   */
-  getPublicKey(): Uint8Array {
-    return this.keypair.getPublicKey().toRawBytes();
-  }
-
-  /**
-   * Get underlying Signer (Keypair)
-   */
-  getSigner(): Signer {
-    return this.keypair;
-  }
-
-  /**
-   * Get SuiClient instance
-   */
-  getClient(): SuiClient {
-    return this.client;
-  }
-}
+/**
+ * Keypair Signer Implementation
+ *
+ * Wraps @mysten/sui Keypair for use with SimplePDWClient.
+ * Suitable for Node.js, backend services, CLI tools.
+ *
+ * @example
+ * ```typescript
+ * import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
+ * import { KeypairSigner } from 'personal-data-wallet-sdk/client';
+ *
+ * const keypair = Ed25519Keypair.fromSecretKey(privateKey);
+ * const signer = new KeypairSigner(keypair, suiClient);
+ *
+ * const pdw = await createPDWClient({
+ *   signer,
+ *   network: 'testnet'
+ * });
+ * ```
+ *
+ * @module client/signers
+ */
+
+import type { SuiClient } from '@mysten/sui/client';
+import type { Keypair, Signer } from '@mysten/sui/cryptography';
+import type { Transaction } from '@mysten/sui/transactions';
+import type {
+  UnifiedSigner,
+  SignAndExecuteResult,
+  SignPersonalMessageResult
+} from './UnifiedSigner';
+
+/**
+ * Keypair-based signer for Node.js and backend environments
+ */
+export class KeypairSigner implements UnifiedSigner {
+  constructor(
+    private keypair: Keypair,
+    private client: SuiClient
+  ) {}
+
+  /**
+   * Sign and execute transaction using keypair
+   */
+  async signAndExecuteTransaction(transaction: Transaction): Promise<SignAndExecuteResult> {
+    const result = await this.client.signAndExecuteTransaction({
+      transaction,
+      signer: this.keypair,
+      options: {
+        showEffects: true,
+        showEvents: true,
+        showObjectChanges: true
+      }
+    });
+
+    // Wait for transaction to be finalized to prevent gas coin version conflicts
+    if (result.digest) {
+      await this.client.waitForTransaction({ digest: result.digest });
+    }
+
+    return {
+      digest: result.digest,
+      effects: result.effects,
+      events: result.events || undefined,
+      objectChanges: result.objectChanges || undefined
+    };
+  }
+
+  /**
+   * Sign personal message using keypair
+   */
+  async signPersonalMessage(message: Uint8Array): Promise<SignPersonalMessageResult> {
+    const { signature } = await this.keypair.signPersonalMessage(message);
+
+    return {
+      signature,  // Base64 string
+      bytes: message  // Original message bytes
+    };
+  }
+
+  /**
+   * Get Sui address from keypair
+   */
+  getAddress(): string {
+    return this.keypair.getPublicKey().toSuiAddress();
+  }
+
+  /**
+   * Get public key bytes
+   */
+  getPublicKey(): Uint8Array {
+    return this.keypair.getPublicKey().toRawBytes();
+  }
+
+  /**
+   * Get underlying Signer (Keypair)
+   */
+  getSigner(): Signer {
+    return this.keypair;
+  }
+
+  /**
+   * Get SuiClient instance
+   */
+  getClient(): SuiClient {
+    return this.client;
+  }
+}

package/src/client/signers/UnifiedSigner.ts

@@ -1,110 +1,110 @@
-/**
- * Unified Signer Interface
- *
- * Abstracts signing operations to work with both:
- * - Keypair (Node.js, backend, CLI)
- * - WalletAdapter (Browser, React dApps)
- *
- * This allows SimplePDWClient to work in any environment.
- *
- * @module client/signers
- */
-
-import type { Transaction } from '@mysten/sui/transactions';
-import type { Signer } from '@mysten/sui/cryptography';
-import type { SuiClient } from '@mysten/sui/client';
-
-/**
- * Result of signing and executing a transaction
- */
-export interface SignAndExecuteResult {
-  /**
-   * Transaction digest
-   */
-  digest: string;
-
-  /**
-   * Transaction effects
-   */
-  effects?: any;
-
-  /**
-   * Events emitted
-   */
-  events?: any[];
-
-  /**
-   * Object changes
-   */
-  objectChanges?: any[];
-}
-
-/**
- * Result of signing a personal message
- */
-export interface SignPersonalMessageResult {
-  /**
-   * Signature (Base64-encoded string)
-   */
-  signature: string;
-
-  /**
-   * Signed bytes
-   */
-  bytes: Uint8Array;
-}
-
-/**
- * Unified Signer Interface
- *
- * Provides consistent signing API across different wallet types
- */
-export interface UnifiedSigner {
-  /**
-   * Sign and execute a transaction on Sui blockchain
-   *
-   * @param transaction - The transaction to sign and execute
-   * @returns Transaction result with digest and effects
-   */
-  signAndExecuteTransaction(transaction: Transaction): Promise<SignAndExecuteResult>;
-
-  /**
-   * Sign a personal message (for SEAL encryption identity)
-   *
-   * @param message - The message bytes to sign
-   * @returns Signature result
-   */
-  signPersonalMessage(message: Uint8Array): Promise<SignPersonalMessageResult>;
-
-  /**
-   * Get the Sui address of this signer
-   *
-   * @returns Sui address (0x-prefixed hex string)
-   */
-  getAddress(): string;
-
-  /**
-   * Get the public key (if available)
-   *
-   * @returns Public key bytes or null
-   */
-  getPublicKey?(): Uint8Array | null;
-
-  /**
-   * Get the underlying Signer (for services that need full Signer interface)
-   *
-   * Note: This may not be available for all signer types (e.g., wallet adapters)
-   * @returns Signer instance or throws error if not available
-   */
-  getSigner(): Signer;
-
-  /**
-   * Get the SuiClient instance (optional)
-   *
-   * Used by managers that need to build transactions or wait for confirmations.
-   * Returns null if not available (e.g., WalletAdapterSigner).
-   *
-   * @returns SuiClient instance or null
-   */
-  getClient?(): SuiClient | null;
-}
+/**
+ * Unified Signer Interface
+ *
+ * Abstracts signing operations to work with both:
+ * - Keypair (Node.js, backend, CLI)
+ * - WalletAdapter (Browser, React dApps)
+ *
+ * This allows SimplePDWClient to work in any environment.
+ *
+ * @module client/signers
+ */
+
+import type { Transaction } from '@mysten/sui/transactions';
+import type { Signer } from '@mysten/sui/cryptography';
+import type { SuiClient } from '@mysten/sui/client';
+
+/**
+ * Result of signing and executing a transaction
+ */
+export interface SignAndExecuteResult {
+  /**
+   * Transaction digest
+   */
+  digest: string;
+
+  /**
+   * Transaction effects
+   */
+  effects?: any;
+
+  /**
+   * Events emitted
+   */
+  events?: any[];
+
+  /**
+   * Object changes
+   */
+  objectChanges?: any[];
+}
+
+/**
+ * Result of signing a personal message
+ */
+export interface SignPersonalMessageResult {
+  /**
+   * Signature (Base64-encoded string)
+   */
+  signature: string;
+
+  /**
+   * Signed bytes
+   */
+  bytes: Uint8Array;
+}
+
+/**
+ * Unified Signer Interface
+ *
+ * Provides consistent signing API across different wallet types
+ */
+export interface UnifiedSigner {
+  /**
+   * Sign and execute a transaction on Sui blockchain
+   *
+   * @param transaction - The transaction to sign and execute
+   * @returns Transaction result with digest and effects
+   */
+  signAndExecuteTransaction(transaction: Transaction): Promise<SignAndExecuteResult>;
+
+  /**
+   * Sign a personal message (for SEAL encryption identity)
+   *
+   * @param message - The message bytes to sign
+   * @returns Signature result
+   */
+  signPersonalMessage(message: Uint8Array): Promise<SignPersonalMessageResult>;
+
+  /**
+   * Get the Sui address of this signer
+   *
+   * @returns Sui address (0x-prefixed hex string)
+   */
+  getAddress(): string;
+
+  /**
+   * Get the public key (if available)
+   *
+   * @returns Public key bytes or null
+   */
+  getPublicKey?(): Uint8Array | null;
+
+  /**
+   * Get the underlying Signer (for services that need full Signer interface)
+   *
+   * Note: This may not be available for all signer types (e.g., wallet adapters)
+   * @returns Signer instance or throws error if not available
+   */
+  getSigner(): Signer;
+
+  /**
+   * Get the SuiClient instance (optional)
+   *
+   * Used by managers that need to build transactions or wait for confirmations.
+   * Returns null if not available (e.g., WalletAdapterSigner).
+   *
+   * @returns SuiClient instance or null
+   */
+  getClient?(): SuiClient | null;
+}