@cmdoss/memwal-sdk 0.6.0

package/dist/services/CapabilityService.js

@@ -0,0 +1,361 @@
+/**
+ * CapabilityService - Capability-based access control for Personal Data Wallet
+ *
+ * This service implements the SEAL PrivateData pattern for simplified access control
+ * using Move's capability pattern. It replaces the old HD wallet + allowlist architecture.
+ *
+ * Key benefits:
+ * - 1 user wallet instead of N HD wallets
+ * - Object ownership = access permission (SEAL idiomatic)
+ * - No global registry needed
+ * - 60% gas savings vs allowlist pattern
+ * - Type-safe access control
+ *
+ * @see CAPABILITY-ARCHITECTURE-SUMMARY.md
+ */
+import { Transaction } from '@mysten/sui/transactions';
+import { sha3_256 } from '@noble/hashes/sha3';
+import { bcs } from '@mysten/sui/bcs';
+/**
+ * CapabilityService handles MemoryCap object operations
+ *
+ * Implements the SEAL PrivateData pattern for simplified access control.
+ */
+export class CapabilityService {
+    constructor(config) {
+        this.suiClient = config.suiClient;
+        this.packageId = config.packageId;
+    }
+    /**
+     * Create a new MemoryCap for an app context
+     *
+     * @param options - Creation options
+     * @param signer - Transaction signer
+     * @returns Created MemoryCap
+     */
+    async create(options, signer) {
+        const tx = new Transaction();
+        tx.moveCall({
+            target: `${this.packageId}::capability::create_memory_cap`,
+            arguments: [
+                tx.pure.string(options.appId),
+            ],
+        });
+        const result = await this.suiClient.signAndExecuteTransaction({
+            transaction: tx,
+            signer,
+            options: {
+                showEffects: true,
+                showEvents: true,
+                showObjectChanges: true,
+            },
+        });
+        // Wait for transaction to be finalized to prevent gas coin version conflicts
+        if (result.digest) {
+            await this.suiClient.waitForTransaction({ digest: result.digest });
+        }
+        if (result.effects?.status?.status !== 'success') {
+            throw new Error(`Failed to create MemoryCap: ${result.effects?.status?.error}`);
+        }
+        // Extract created MemoryCap from events
+        const createdEvent = result.events?.find((event) => event.type.includes('::capability::MemoryCapCreated'));
+        if (!createdEvent) {
+            throw new Error('MemoryCapCreated event not found');
+        }
+        const eventData = createdEvent.parsedJson;
+        return {
+            id: eventData.cap_id,
+            nonce: eventData.nonce,
+            appId: eventData.app_id,
+            owner: eventData.owner,
+            createdAt: eventData.created_at,
+        };
+    }
+    /**
+     * Get a MemoryCap by app ID for a user
+     *
+     * @param userAddress - User's Sui address
+     * @param appId - Application identifier
+     * @returns MemoryCap or null if not found
+     */
+    async get(userAddress, appId) {
+        const caps = await this.list({ userAddress, appId });
+        return caps.length > 0 ? caps[0] : null;
+    }
+    /**
+     * Get or create a MemoryCap for an app context
+     *
+     * @param options - Get or create options
+     * @param signer - Transaction signer (required for creation)
+     * @returns Existing or newly created MemoryCap
+     */
+    async getOrCreate(options, signer) {
+        const userAddress = options.userAddress || await signer.getPublicKey?.()?.toSuiAddress?.() || '';
+        // Try to get existing capability
+        const existing = await this.get(userAddress, options.appId);
+        if (existing) {
+            return existing;
+        }
+        // Create new capability
+        return await this.create({ appId: options.appId }, signer);
+    }
+    /**
+     * List all MemoryCaps owned by a user
+     *
+     * @param options - List options (filter by appId, userAddress)
+     * @returns Array of MemoryCaps
+     */
+    async list(options) {
+        const userAddress = options?.userAddress;
+        if (!userAddress) {
+            throw new Error('userAddress is required for listing capabilities');
+        }
+        const response = await this.suiClient.getOwnedObjects({
+            owner: userAddress,
+            filter: {
+                StructType: `${this.packageId}::capability::MemoryCap`
+            },
+            options: {
+                showContent: true,
+                showType: true,
+            },
+        });
+        const caps = [];
+        for (const obj of response.data) {
+            if (!obj.data?.content || obj.data.content.dataType !== 'moveObject') {
+                continue;
+            }
+            const fields = obj.data.content.fields;
+            const appId = fields.app_id;
+            // Filter by appId if specified
+            if (options?.appId && appId !== options.appId) {
+                continue;
+            }
+            // Convert nonce from bytes to hex string
+            const nonceBytes = Array.isArray(fields.nonce)
+                ? fields.nonce
+                : [];
+            const nonceHex = nonceBytes
+                .map((b) => b.toString(16).padStart(2, '0'))
+                .join('');
+            caps.push({
+                id: obj.data.objectId,
+                nonce: nonceHex,
+                appId,
+                owner: userAddress,
+            });
+        }
+        return caps;
+    }
+    /**
+     * Transfer a MemoryCap to another address
+     *
+     * After transfer:
+     * - New owner can call seal_approve
+     * - New owner can decrypt memories
+     * - Original owner loses access
+     *
+     * @param options - Transfer options
+     * @param signer - Transaction signer
+     */
+    async transfer(options, signer) {
+        const tx = new Transaction();
+        tx.moveCall({
+            target: `${this.packageId}::capability::transfer_cap`,
+            arguments: [
+                tx.object(options.capId),
+                tx.pure.address(options.recipient),
+            ],
+        });
+        const result = await this.suiClient.signAndExecuteTransaction({
+            transaction: tx,
+            signer,
+            options: {
+                showEffects: true,
+                showEvents: true,
+            },
+        });
+        // Wait for transaction to be finalized to prevent gas coin version conflicts
+        if (result.digest) {
+            await this.suiClient.waitForTransaction({ digest: result.digest });
+        }
+        if (result.effects?.status?.status !== 'success') {
+            throw new Error(`Failed to transfer MemoryCap: ${result.effects?.status?.error}`);
+        }
+    }
+    /**
+     * Burn (revoke) a MemoryCap
+     *
+     * This permanently revokes the capability.
+     * After burning:
+     * - No one can decrypt memories for this context
+     * - Object is permanently deleted
+     *
+     * @param options - Burn options
+     * @param signer - Transaction signer
+     */
+    async burn(options, signer) {
+        const tx = new Transaction();
+        tx.moveCall({
+            target: `${this.packageId}::capability::burn_cap`,
+            arguments: [
+                tx.object(options.capId),
+            ],
+        });
+        const result = await this.suiClient.signAndExecuteTransaction({
+            transaction: tx,
+            signer,
+            options: {
+                showEffects: true,
+                showEvents: true,
+            },
+        });
+        // Wait for transaction to be finalized to prevent gas coin version conflicts
+        if (result.digest) {
+            await this.suiClient.waitForTransaction({ digest: result.digest });
+        }
+        if (result.effects?.status?.status !== 'success') {
+            throw new Error(`Failed to burn MemoryCap: ${result.effects?.status?.error}`);
+        }
+    }
+    /**
+     * Compute SEAL key ID for a capability
+     *
+     * key_id = keccak256(owner || nonce)
+     *
+     * @param cap - MemoryCap object
+     * @returns Key ID as hex string
+     */
+    computeKeyId(cap) {
+        return this.computeKeyIdFromParts({
+            owner: cap.owner,
+            nonce: cap.nonce,
+        });
+    }
+    /**
+     * Compute SEAL key ID from owner and nonce
+     *
+     * @param options - Owner address and nonce
+     * @returns Key ID as hex string
+     */
+    computeKeyIdFromParts(options) {
+        // Convert owner address to bytes (32 bytes for Sui address)
+        const ownerBytes = this.addressToBytes(options.owner);
+        // Convert nonce from hex string to bytes
+        const nonceBytes = this.hexToBytes(options.nonce);
+        // Concatenate: owner || nonce
+        const data = new Uint8Array(ownerBytes.length + nonceBytes.length);
+        data.set(ownerBytes, 0);
+        data.set(nonceBytes, ownerBytes.length);
+        // Hash with keccak256
+        const hash = sha3_256(data);
+        // Return as hex string
+        return '0x' + Array.from(hash)
+            .map(b => b.toString(16).padStart(2, '0'))
+            .join('');
+    }
+    /**
+     * Get MemoryCap object by ID
+     *
+     * @param capId - Capability object ID
+     * @returns MemoryCap or null
+     */
+    async getById(capId) {
+        try {
+            const response = await this.suiClient.getObject({
+                id: capId,
+                options: {
+                    showContent: true,
+                    showOwner: true,
+                },
+            });
+            if (!response.data?.content || response.data.content.dataType !== 'moveObject') {
+                return null;
+            }
+            const fields = response.data.content.fields;
+            // Get owner from object ownership
+            let owner = '';
+            if (response.data.owner && typeof response.data.owner === 'object') {
+                if ('AddressOwner' in response.data.owner) {
+                    owner = response.data.owner.AddressOwner;
+                }
+            }
+            // Convert nonce
+            const nonceBytes = Array.isArray(fields.nonce)
+                ? fields.nonce
+                : [];
+            const nonceHex = nonceBytes
+                .map((b) => b.toString(16).padStart(2, '0'))
+                .join('');
+            return {
+                id: capId,
+                nonce: nonceHex,
+                appId: fields.app_id,
+                owner,
+            };
+        }
+        catch (error) {
+            console.error('Error fetching MemoryCap by ID:', error);
+            return null;
+        }
+    }
+    /**
+     * Check if user has capability for an app context
+     *
+     * @param userAddress - User's Sui address
+     * @param appId - Application identifier
+     * @returns True if capability exists
+     */
+    async hasCapability(userAddress, appId) {
+        const cap = await this.get(userAddress, appId);
+        return cap !== null;
+    }
+    /**
+     * Build transaction for creating MemoryCap (for PTB composition)
+     *
+     * @param tx - Transaction to add call to
+     * @param appId - Application identifier
+     */
+    buildCreateCall(tx, appId) {
+        tx.moveCall({
+            target: `${this.packageId}::capability::create_memory_cap`,
+            arguments: [
+                tx.pure.string(appId),
+            ],
+        });
+    }
+    /**
+     * Build seal_approve transaction argument
+     *
+     * @param tx - Transaction to add call to
+     * @param capId - Capability object ID
+     * @param keyId - SEAL key ID (as hex string)
+     */
+    buildSealApproveCall(tx, capId, keyId) {
+        const keyIdBytes = this.hexToBytes(keyId);
+        tx.moveCall({
+            target: `${this.packageId}::capability::seal_approve`,
+            arguments: [
+                tx.object(capId),
+                tx.pure(bcs.vector(bcs.u8()).serialize(Array.from(keyIdBytes))),
+            ],
+        });
+    }
+    // ========== Private Helper Methods ==========
+    addressToBytes(address) {
+        // Remove 0x prefix if present
+        const cleanAddr = address.startsWith('0x') ? address.slice(2) : address;
+        // Sui addresses are 32 bytes (64 hex chars)
+        const padded = cleanAddr.padStart(64, '0');
+        return this.hexToBytes(padded);
+    }
+    hexToBytes(hex) {
+        const cleanHex = hex.startsWith('0x') ? hex.slice(2) : hex;
+        const bytes = new Uint8Array(cleanHex.length / 2);
+        for (let i = 0; i < cleanHex.length; i += 2) {
+            bytes[i / 2] = parseInt(cleanHex.slice(i, i + 2), 16);
+        }
+        return bytes;
+    }
+}
+//# sourceMappingURL=CapabilityService.js.map

package/dist/services/CapabilityService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapabilityService.js","sourceRoot":"","sources":["../../src/services/CapabilityService.ts"],"names":[],"mappings":"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"}

package/dist/services/ChatService.d.ts

@@ -0,0 +1,89 @@
+import { PDWApiClient } from '../api/client';
+import { ChatSession, ChatMessageRequest, ChatMessageResponse, CreateChatSessionRequest, ChatSessionResponse, ChatSessionsResponse, AddMessageRequest, SaveSummaryRequest, ChatStreamOptions } from '../types';
+/**
+ * ChatService handles all chat-related operations including session management,
+ * message sending, and streaming responses with memory context integration.
+ */
+export declare class ChatService {
+    private apiClient;
+    constructor(apiClient: PDWApiClient);
+    /**
+     * Get all chat sessions for a user
+     */
+    getSessions(userAddress: string): Promise<ChatSessionsResponse>;
+    /**
+     * Get a specific chat session with messages
+     */
+    getSession(sessionId: string, userAddress: string): Promise<ChatSessionResponse>;
+    /**
+     * Create a new chat session
+     */
+    createSession(request: CreateChatSessionRequest): Promise<ChatSessionResponse>;
+    /**
+     * Delete a chat session
+     */
+    deleteSession(sessionId: string, userAddress: string): Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    /**
+     * Update the title of a chat session
+     */
+    updateSessionTitle(sessionId: string, userAddress: string, title: string): Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    /**
+     * Add a message to a chat session
+     */
+    addMessage(sessionId: string, request: AddMessageRequest): Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    /**
+     * Save a summary for a chat session
+     */
+    saveSummary(request: SaveSummaryRequest): Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    /**
+     * Send a non-streaming chat message
+     */
+    sendMessage(request: ChatMessageRequest): Promise<ChatMessageResponse>;
+    /**
+     * Stream chat responses using Server-Sent Events
+     * Returns a promise that resolves when the stream completes
+     */
+    streamChat(request: ChatMessageRequest, options?: ChatStreamOptions): Promise<void>;
+    /**
+     * Stream chat using fetch API with streaming response
+     */
+    private streamChatWithFetch;
+    /**
+     * Convenient method to stream chat with simple callback
+     */
+    streamChatSimple(request: ChatMessageRequest, onMessage: (content: string) => void, onError?: (error: string) => void, onDone?: () => void): Promise<void>;
+    /**
+     * Create a convenient chat interface with session management
+     */
+    createChatInterface(userAddress: string, modelName?: string): Promise<{
+        sessionId: string;
+        session: ChatSession;
+        sendMessage: (text: string) => Promise<ChatMessageResponse>;
+        streamMessage: (text: string, options?: ChatStreamOptions) => Promise<void>;
+        updateTitle: (title: string) => Promise<{
+            success: boolean;
+            message?: string;
+        }>;
+        addMessage: (content: string, type?: "user" | "assistant" | "system") => Promise<{
+            success: boolean;
+            message?: string;
+        }>;
+        delete: () => Promise<{
+            success: boolean;
+            message?: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=ChatService.d.ts.map

package/dist/services/ChatService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatService.d.ts","sourceRoot":"","sources":["../../src/services/ChatService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAEL,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EAGpB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,YAAY;IAE3C;;OAEG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAcrE;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IActF;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAcpF;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAa5G;;OAEG;IACG,kBAAkB,CACtB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAalD;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAahH;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAa/F;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiB5E;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7F;;OAEG;YACW,mBAAmB;IA+FjC;;OAEG;IACG,gBAAgB,CACpB,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EACjC,MAAM,CAAC,EAAE,MAAM,IAAI,GAClB,OAAO,CAAC,IAAI,CAAC;IAwBhB;;OAEG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAA+D;;;4BAa3F,MAAM;8BASJ,MAAM,YAAW,iBAAiB;6BASnC,MAAM;qBAhQf,OAAO;sBAAY,MAAM;;8BAoQf,MAAM,SAAQ,MAAM,GAAG,WAAW,GAAG,QAAQ;qBApPO,OAAO;sBAAY,MAAM;;;qBApC7B,OAAO;sBAAY,MAAM;;;CAqS1G"}