@brightchain/brightchain-lib 0.13.0 → 0.15.0

package/src/lib/services/communication/messageOperationsService.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * MessageOperationsService — shared message operation logic for Groups and Channels.
+ *
+ * Encapsulates edit, delete, pin/unpin, and reaction operations with
+ * permission checks. Both GroupService and ChannelService delegate to
+ * this service to avoid duplicating message operation logic.
+ *
+ * Requirements: 9.1, 9.2, 9.3, 9.4, 9.6
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageOperationsService = exports.MessageReactionNotFoundError = exports.MessagePermissionError = exports.MessageAuthorError = exports.MessageNotFoundError = void 0;
+const uuid_1 = require("uuid");
+const communication_1 = require("../../enumerations/communication");
+// ─── Error classes ──────────────────────────────────────────────────────────
+class MessageNotFoundError extends Error {
+    constructor(messageId) {
+        super(`Message ${messageId} not found`);
+        this.name = 'MessageNotFoundError';
+    }
+}
+exports.MessageNotFoundError = MessageNotFoundError;
+class MessageAuthorError extends Error {
+    constructor() {
+        super('You can only edit messages you authored');
+        this.name = 'MessageAuthorError';
+    }
+}
+exports.MessageAuthorError = MessageAuthorError;
+class MessagePermissionError extends Error {
+    constructor(permission) {
+        super(`Missing permission: ${permission}`);
+        this.name = 'MessagePermissionError';
+        this.missingPermission = permission;
+    }
+}
+exports.MessagePermissionError = MessagePermissionError;
+class MessageReactionNotFoundError extends Error {
+    constructor(reactionId) {
+        super(`Reaction ${reactionId} not found`);
+        this.name = 'MessageReactionNotFoundError';
+    }
+}
+exports.MessageReactionNotFoundError = MessageReactionNotFoundError;
+/**
+ * Shared message operations for edit, delete, pin, and reaction logic.
+ * Callers are responsible for membership/existence checks on the context
+ * (group or channel) before invoking these methods.
+ */
+class MessageOperationsService {
+    constructor(permissionService) {
+        this.permissionService = permissionService;
+    }
+    /**
+     * Edit a message authored by the requesting member.
+     * Preserves previous content in editHistory.
+     *
+     * Requirement 9.1: update content, preserve edit history, set editedAt.
+     */
+    editMessage(messages, messageId, memberId, newContent, messageNotFoundFactory, authorErrorFactory) {
+        const message = messages.find((m) => m.id === messageId);
+        if (!message)
+            throw messageNotFoundFactory(messageId);
+        if (message.senderId !== memberId) {
+            throw authorErrorFactory();
+        }
+        message.editHistory.push({
+            content: message.encryptedContent,
+            editedAt: new Date(),
+        });
+        message.encryptedContent = newContent;
+        message.editedAt = new Date();
+        return message;
+    }
+    /**
+     * Delete a message. Authors can delete their own; moderators/admins
+     * need DELETE_ANY_MESSAGE permission.
+     *
+     * Requirements 9.2, 9.3: mark as deleted, set deletedBy.
+     */
+    deleteMessage(messages, contextId, messageId, memberId, messageNotFoundFactory, permissionErrorFactory) {
+        const message = messages.find((m) => m.id === messageId);
+        if (!message)
+            throw messageNotFoundFactory(messageId);
+        const isAuthor = message.senderId === memberId;
+        if (!isAuthor) {
+            if (!this.permissionService.hasPermission(memberId, contextId, communication_1.Permission.DELETE_ANY_MESSAGE)) {
+                throw permissionErrorFactory(communication_1.Permission.DELETE_ANY_MESSAGE);
+            }
+        }
+        message.deleted = true;
+        message.deletedBy = memberId;
+    }
+    /**
+     * Pin a message. Requires PIN_MESSAGES permission.
+     * Adds the message ID to the context's pinnedMessageIds list.
+     *
+     * Requirement 9.3: add to pinned messages list.
+     */
+    pinMessage(messages, contextId, messageId, memberId, context, messageNotFoundFactory, permissionErrorFactory) {
+        if (!this.permissionService.hasPermission(memberId, contextId, communication_1.Permission.PIN_MESSAGES)) {
+            throw permissionErrorFactory(communication_1.Permission.PIN_MESSAGES);
+        }
+        const message = messages.find((m) => m.id === messageId);
+        if (!message)
+            throw messageNotFoundFactory(messageId);
+        message.pinned = true;
+        if (!context.pinnedMessageIds.includes(messageId)) {
+            context.pinnedMessageIds.push(messageId);
+        }
+    }
+    /**
+     * Unpin a message. Requires PIN_MESSAGES permission.
+     * Removes the message ID from the context's pinnedMessageIds list.
+     *
+     * Requirement 9.3: remove from pinned messages list.
+     */
+    unpinMessage(messages, contextId, messageId, memberId, context, messageNotFoundFactory, permissionErrorFactory) {
+        if (!this.permissionService.hasPermission(memberId, contextId, communication_1.Permission.PIN_MESSAGES)) {
+            throw permissionErrorFactory(communication_1.Permission.PIN_MESSAGES);
+        }
+        const message = messages.find((m) => m.id === messageId);
+        if (!message)
+            throw messageNotFoundFactory(messageId);
+        message.pinned = false;
+        context.pinnedMessageIds = context.pinnedMessageIds.filter((id) => id !== messageId);
+    }
+    /**
+     * Add a reaction to a message.
+     *
+     * Requirement 9.4: add reaction with emoji and member tracking.
+     */
+    addReaction(messages, messageId, memberId, emoji, messageNotFoundFactory) {
+        const message = messages.find((m) => m.id === messageId);
+        if (!message)
+            throw messageNotFoundFactory(messageId);
+        const reactionId = (0, uuid_1.v4)();
+        message.reactions.push({
+            id: reactionId,
+            emoji,
+            memberId,
+            createdAt: new Date(),
+        });
+        return reactionId;
+    }
+    /**
+     * Remove a reaction from a message.
+     *
+     * Requirement 9.4: remove reaction from message.
+     */
+    removeReaction(messages, messageId, reactionId, messageNotFoundFactory, reactionNotFoundFactory) {
+        const message = messages.find((m) => m.id === messageId);
+        if (!message)
+            throw messageNotFoundFactory(messageId);
+        const reactionIndex = message.reactions.findIndex((r) => r.id === reactionId);
+        if (reactionIndex === -1)
+            throw reactionNotFoundFactory(reactionId);
+        message.reactions.splice(reactionIndex, 1);
+    }
+}
+exports.MessageOperationsService = MessageOperationsService;
+//# sourceMappingURL=messageOperationsService.js.map

package/src/lib/services/communication/messageOperationsService.js.map

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

package/src/lib/services/communication/permissionService.d.ts

@@ -0,0 +1,47 @@
+/**
+ * PermissionService — centralized permission checking for Groups and Channels.
+ *
+ * Tracks member roles and mute status per context (group or channel ID).
+ * Uses the DEFAULT_ROLE_PERMISSIONS map from brightchain-lib to resolve
+ * whether a given role grants a specific permission.
+ *
+ * Requirements: 7.1, 7.2, 7.3, 7.4
+ */
+import { DefaultRole, Permission } from '../../enumerations/communication';
+export declare class PermissionService {
+    /** memberId:contextId → DefaultRole */
+    private readonly roles;
+    /** memberId:contextId → mute expiry timestamp (ms since epoch) */
+    private readonly mutes;
+    /**
+     * Check whether a member has a specific permission in a context.
+     * Returns false if the member has no role in the context or is missing the permission.
+     *
+     * Requirement 7.1: check member permissions against role-based permission sets.
+     */
+    hasPermission(memberId: string, contextId: string, permission: Permission): boolean;
+    /**
+     * Assign (or update) a role for a member in a context.
+     *
+     * Requirement 7.2: assign and retrieve member roles per context.
+     */
+    assignRole(memberId: string, contextId: string, role: DefaultRole): void;
+    /**
+     * Get the role assigned to a member in a context, or null if none.
+     */
+    getMemberRole(memberId: string, contextId: string): DefaultRole | null;
+    /**
+     * Check whether a member is currently muted in a context.
+     * A mute is active when the stored expiry timestamp is in the future.
+     *
+     * Requirement 7.3, 7.4: track mute status with expiration, auto-clear on check.
+     */
+    isMuted(memberId: string, contextId: string): boolean;
+    /**
+     * Mute a member in a context for the given duration (milliseconds).
+     *
+     * Requirement 7.3: track member mute status with expiration.
+     */
+    muteMember(memberId: string, contextId: string, durationMs: number): void;
+}
+//# sourceMappingURL=permissionService.d.ts.map

package/src/lib/services/communication/permissionService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionService.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/services/communication/permissionService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,WAAW,EACX,UAAU,EACX,MAAM,kCAAkC,CAAC;AAS1C,qBAAa,iBAAiB;IAC5B,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IAExD,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IAEnD;;;;;OAKG;IACH,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,GACrB,OAAO;IAQV;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI;IAIxE;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAItE;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAarD;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;CAG1E"}

package/src/lib/services/communication/permissionService.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * PermissionService — centralized permission checking for Groups and Channels.
+ *
+ * Tracks member roles and mute status per context (group or channel ID).
+ * Uses the DEFAULT_ROLE_PERMISSIONS map from brightchain-lib to resolve
+ * whether a given role grants a specific permission.
+ *
+ * Requirements: 7.1, 7.2, 7.3, 7.4
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PermissionService = void 0;
+const communication_1 = require("../../enumerations/communication");
+/**
+ * Composite key for role and mute lookups: "memberId:contextId"
+ */
+function key(memberId, contextId) {
+    return `${memberId}:${contextId}`;
+}
+class PermissionService {
+    constructor() {
+        /** memberId:contextId → DefaultRole */
+        this.roles = new Map();
+        /** memberId:contextId → mute expiry timestamp (ms since epoch) */
+        this.mutes = new Map();
+    }
+    /**
+     * Check whether a member has a specific permission in a context.
+     * Returns false if the member has no role in the context or is missing the permission.
+     *
+     * Requirement 7.1: check member permissions against role-based permission sets.
+     */
+    hasPermission(memberId, contextId, permission) {
+        const role = this.getMemberRole(memberId, contextId);
+        if (role === null) {
+            return false;
+        }
+        return communication_1.DEFAULT_ROLE_PERMISSIONS[role].includes(permission);
+    }
+    /**
+     * Assign (or update) a role for a member in a context.
+     *
+     * Requirement 7.2: assign and retrieve member roles per context.
+     */
+    assignRole(memberId, contextId, role) {
+        this.roles.set(key(memberId, contextId), role);
+    }
+    /**
+     * Get the role assigned to a member in a context, or null if none.
+     */
+    getMemberRole(memberId, contextId) {
+        return this.roles.get(key(memberId, contextId)) ?? null;
+    }
+    /**
+     * Check whether a member is currently muted in a context.
+     * A mute is active when the stored expiry timestamp is in the future.
+     *
+     * Requirement 7.3, 7.4: track mute status with expiration, auto-clear on check.
+     */
+    isMuted(memberId, contextId) {
+        const expiry = this.mutes.get(key(memberId, contextId));
+        if (expiry === undefined) {
+            return false;
+        }
+        if (Date.now() >= expiry) {
+            // Mute has expired — clean up
+            this.mutes.delete(key(memberId, contextId));
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Mute a member in a context for the given duration (milliseconds).
+     *
+     * Requirement 7.3: track member mute status with expiration.
+     */
+    muteMember(memberId, contextId, durationMs) {
+        this.mutes.set(key(memberId, contextId), Date.now() + durationMs);
+    }
+}
+exports.PermissionService = PermissionService;
+//# sourceMappingURL=permissionService.js.map

package/src/lib/services/communication/permissionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionService.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/services/communication/permissionService.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,oEAI0C;AAE1C;;GAEG;AACH,SAAS,GAAG,CAAC,QAAgB,EAAE,SAAiB;IAC9C,OAAO,GAAG,QAAQ,IAAI,SAAS,EAAE,CAAC;AACpC,CAAC;AAED,MAAa,iBAAiB;IAA9B;QACE,uCAAuC;QACtB,UAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;QAExD,kEAAkE;QACjD,UAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IA+DrD,CAAC;IA7DC;;;;;OAKG;IACH,aAAa,CACX,QAAgB,EAChB,SAAiB,EACjB,UAAsB;QAEtB,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACrD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,wCAAwB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,QAAgB,EAAE,SAAiB,EAAE,IAAiB;QAC/D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,QAAgB,EAAE,SAAiB;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,IAAI,IAAI,CAAC;IAC1D,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,QAAgB,EAAE,SAAiB;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;QACxD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,EAAE,CAAC;YACzB,8BAA8B;YAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;YAC5C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,QAAgB,EAAE,SAAiB,EAAE,UAAkB;QAChE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,CAAC;IACpE,CAAC;CACF;AApED,8CAoEC"}

package/src/lib/services/communication/searchService.d.ts

@@ -0,0 +1,30 @@
+/**
+ * SearchService — cross-context keyword search across conversations, groups, and channels.
+ *
+ * Aggregates search results from all contexts a member has access to,
+ * returning paginated results with context metadata (sender, timestamp,
+ * context name/type).
+ *
+ * Requirements: 10.4
+ */
+import { IPaginatedResult, ISearchResultItem } from '../../interfaces/communication';
+import { ChannelService } from './channelService';
+import { ConversationService } from './conversationService';
+import { GroupService } from './groupService';
+export declare class SearchService {
+    private readonly conversationService;
+    private readonly groupService;
+    private readonly channelService;
+    constructor(conversationService: ConversationService, groupService: GroupService, channelService: ChannelService);
+    /**
+     * Search messages by keyword across all contexts the member has access to.
+     *
+     * Results are sorted by `createdAt` descending (newest first) and include
+     * sender, timestamp, and context name for each match.
+     */
+    searchAll(memberId: string, query: string, cursor?: string, limit?: number): IPaginatedResult<ISearchResultItem>;
+    private searchConversations;
+    private searchGroups;
+    private searchChannels;
+}
+//# sourceMappingURL=searchService.d.ts.map

package/src/lib/services/communication/searchService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchService.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/services/communication/searchService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAS9C,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAFd,mBAAmB,EAAE,mBAAmB,EACxC,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc;IAGjD;;;;;OAKG;IACH,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,SAAK,GACT,gBAAgB,CAAC,iBAAiB,CAAC;IAgBtC,OAAO,CAAC,mBAAmB;IA4B3B,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,cAAc;CAsBvB"}

package/src/lib/services/communication/searchService.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * SearchService — cross-context keyword search across conversations, groups, and channels.
+ *
+ * Aggregates search results from all contexts a member has access to,
+ * returning paginated results with context metadata (sender, timestamp,
+ * context name/type).
+ *
+ * Requirements: 10.4
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchService = void 0;
+const pagination_1 = require("../../utils/pagination");
+class SearchService {
+    constructor(conversationService, groupService, channelService) {
+        this.conversationService = conversationService;
+        this.groupService = groupService;
+        this.channelService = channelService;
+    }
+    /**
+     * Search messages by keyword across all contexts the member has access to.
+     *
+     * Results are sorted by `createdAt` descending (newest first) and include
+     * sender, timestamp, and context name for each match.
+     */
+    searchAll(memberId, query, cursor, limit = 50) {
+        const lowerQuery = query.toLowerCase();
+        const results = [];
+        this.searchConversations(memberId, lowerQuery, results);
+        this.searchGroups(memberId, lowerQuery, results);
+        this.searchChannels(memberId, lowerQuery, results);
+        // Sort by createdAt descending (newest first)
+        results.sort((a, b) => b.message.createdAt.getTime() - a.message.createdAt.getTime());
+        return (0, pagination_1.paginateItems)(results, cursor, limit);
+    }
+    searchConversations(memberId, lowerQuery, results) {
+        const conversations = this.conversationService.listAllConversationsForMember(memberId);
+        for (const conv of conversations) {
+            const msgs = this.conversationService.getAllMessages(conv.id);
+            const otherParticipant = conv.participants[0] === memberId
+                ? conv.participants[1]
+                : conv.participants[0];
+            const contextName = `DM with ${otherParticipant}`;
+            for (const msg of msgs) {
+                if (!msg.deleted &&
+                    typeof msg.encryptedContent === 'string' &&
+                    msg.encryptedContent.toLowerCase().includes(lowerQuery)) {
+                    results.push({ id: msg.id, message: msg, contextName });
+                }
+            }
+        }
+    }
+    searchGroups(memberId, lowerQuery, results) {
+        const groups = this.groupService.listGroupsForMember(memberId);
+        for (const group of groups) {
+            const msgs = this.groupService.getAllMessages(group.id);
+            const contextName = `Group: ${group.name}`;
+            for (const msg of msgs) {
+                if (!msg.deleted &&
+                    typeof msg.encryptedContent === 'string' &&
+                    msg.encryptedContent.toLowerCase().includes(lowerQuery)) {
+                    results.push({ id: msg.id, message: msg, contextName });
+                }
+            }
+        }
+    }
+    searchChannels(memberId, lowerQuery, results) {
+        const channels = this.channelService.listChannelsForMember(memberId);
+        for (const channel of channels) {
+            const msgs = this.channelService.getAllMessages(channel.id);
+            const contextName = `Channel: #${channel.name}`;
+            for (const msg of msgs) {
+                if (!msg.deleted &&
+                    typeof msg.encryptedContent === 'string' &&
+                    msg.encryptedContent.toLowerCase().includes(lowerQuery)) {
+                    results.push({ id: msg.id, message: msg, contextName });
+                }
+            }
+        }
+    }
+}
+exports.SearchService = SearchService;
+//# sourceMappingURL=searchService.js.map

package/src/lib/services/communication/searchService.js.map

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

package/src/lib/services/crypto/ethereumWalletService.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Ethereum Wallet Service for the BrightChain identity system.
+ *
+ * Derives Ethereum addresses from BrightChain member identities using
+ * BIP44 hierarchical deterministic derivation. Provides message signing
+ * and signature verification for dApp authentication and transaction
+ * signing.
+ *
+ * Derivation path: m/44'/60'/0'/0/0 (BIP44 standard for Ethereum)
+ * - purpose = 44 (BIP44)
+ * - coin_type = 60 (Ethereum)
+ * - account = 0 (default account)
+ * - change = 0 (external chain — wallet addresses)
+ * - index = 0 (first address)
+ *
+ * Requirements: 6.1, 6.2, 6.3, 6.7, 6.8
+ */
+import { ECIESService, PlatformID } from '@digitaldefiance/ecies-lib';
+/**
+ * Error thrown when Ethereum address derivation fails.
+ */
+export declare class EthereumDerivationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when message signing fails.
+ */
+export declare class EthereumSigningError extends Error {
+    constructor(message: string);
+}
+/**
+ * Result of Ethereum address derivation.
+ */
+export interface IEthereumAddressResult {
+    /** EIP-55 checksummed Ethereum address */
+    address: string;
+    /** Uncompressed SECP256k1 public key (65 bytes, hex-encoded) */
+    publicKeyHex: string;
+    /** BIP44 derivation path used */
+    derivationPath: string;
+}
+/**
+ * Result of an Ethereum message signature.
+ */
+export interface IEthereumSignatureResult {
+    /** The original message that was signed */
+    message: string;
+    /** The ECDSA signature (hex-encoded, 65 bytes: r + s + v) */
+    signature: string;
+    /** Recovery parameter (0 or 1) */
+    recoveryParam: number;
+}
+/**
+ * Service for deriving Ethereum wallets from BrightChain member identities
+ * and performing Ethereum-compatible message signing.
+ *
+ * All methods are static — the service is stateless and safe to call
+ * from any context (browser or Node.js).
+ *
+ * @example
+ * ```typescript
+ * const eciesService = ServiceProvider.getInstance().eciesService;
+ *
+ * // Derive Ethereum address from paper key
+ * const result = EthereumWalletService.deriveAddress(paperKey);
+ * console.log(result.address); // 0x1234...abcd (EIP-55 checksummed)
+ *
+ * // Sign a message
+ * const sig = EthereumWalletService.signMessage(paperKey, 'Hello World');
+ *
+ * // Verify the signature
+ * const valid = EthereumWalletService.verifySignature(
+ *   'Hello World',
+ *   sig.signature,
+ *   result.address,
+ * );
+ * ```
+ */
+export declare class EthereumWalletService {
+    /**
+     * Derive an Ethereum address from a BIP39 mnemonic paper key.
+     *
+     * Uses BIP44 path m/44'/60'/0'/0/0 to derive the first Ethereum
+     * address. The address is returned in EIP-55 checksummed format.
+     *
+     * **Validates: Requirements 6.1, 6.4**
+     *
+     * @param paperKey - The 24-word BIP39 mnemonic
+     * @returns The derived Ethereum address, public key, and derivation path
+     * @throws {EthereumDerivationError} If derivation fails
+     */
+    static deriveAddress(paperKey: string): IEthereumAddressResult;
+    /**
+     * Derive an Ethereum address from a paper key after validating it.
+     *
+     * Convenience method that validates the paper key before derivation.
+     *
+     * @param paperKey     - The 24-word BIP39 mnemonic
+     * @param eciesService - The ECIES service for paper key validation
+     * @returns The derived Ethereum address result
+     * @throws {EthereumDerivationError} If the paper key is invalid or derivation fails
+     */
+    static deriveAddressFromValidatedKey<TID extends PlatformID = Uint8Array>(paperKey: string, eciesService: ECIESService<TID>): IEthereumAddressResult;
+    /**
+     * Sign a message using the Ethereum personal_sign format (EIP-191).
+     *
+     * Prepends the standard Ethereum message prefix before signing,
+     * making the signature compatible with MetaMask's personal_sign
+     * and web3.eth.personal.sign.
+     *
+     * **Validates: Requirements 6.2, 6.3**
+     *
+     * @param paperKey - The 24-word BIP39 mnemonic (private key source)
+     * @param message  - The message to sign
+     * @returns The signature result with hex-encoded signature and recovery param
+     * @throws {EthereumSigningError} If signing fails
+     */
+    static signMessage(paperKey: string, message: string): IEthereumSignatureResult;
+    /**
+     * Verify an Ethereum personal_sign signature.
+     *
+     * Recovers the signer's address from the signature and compares it
+     * to the expected address.
+     *
+     * **Validates: Requirements 6.7, 6.8**
+     *
+     * @param message   - The original message that was signed
+     * @param signature - The hex-encoded 65-byte signature (0x-prefixed)
+     * @param address   - The expected signer's Ethereum address (EIP-55)
+     * @returns `true` if the signature was produced by the address owner
+     */
+    static verifySignature(message: string, signature: string, address: string): boolean;
+    /**
+     * Recover the signer's Ethereum address from a signed message.
+     *
+     * @param message   - The original message
+     * @param signature - The hex-encoded 65-byte signature (0x-prefixed)
+     * @returns The recovered EIP-55 checksummed Ethereum address
+     * @throws {EthereumSigningError} If recovery fails
+     */
+    static recoverAddress(message: string, signature: string): string;
+    /**
+     * Hash a message using the EIP-191 personal message format.
+     *
+     * Format: keccak256("\x19Ethereum Signed Message:\n" + len(message) + message)
+     *
+     * @param message - The message to hash
+     * @returns The 32-byte keccak256 hash
+     */
+    static hashMessage(message: string): Uint8Array;
+    /**
+     * Validate an EIP-55 checksummed Ethereum address.
+     *
+     * @param address - The address to validate
+     * @returns `true` if the address is valid and properly checksummed
+     */
+    static isValidAddress(address: string): boolean;
+}
+//# sourceMappingURL=ethereumWalletService.d.ts.map

package/src/lib/services/crypto/ethereumWalletService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethereumWalletService.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/services/crypto/ethereumWalletService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAuBtE;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAID;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAEhB,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;IAErB,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAEhB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAElB,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAkGD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,qBAAqB;IAChC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB;IAmC9D;;;;;;;;;OASG;IACH,MAAM,CAAC,6BAA6B,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU,EACtE,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,YAAY,CAAC,GAAG,CAAC,GAC9B,sBAAsB;IAOzB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,WAAW,CAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,wBAAwB;IAoC3B;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,eAAe,CACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO;IAYV;;;;;;;OAOG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAgCjE;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAW/C;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGhD"}