@pkcprotocol/pkc-js 0.0.11

package/dist/node/rpc/src/index.js

@@ -0,0 +1,1267 @@
+import { Server as RpcWebsocketsServer } from "rpc-websockets";
+import { mkdirSync } from "fs";
+import path from "path";
+import Database from "better-sqlite3";
+import PKCJs, { setPKCJs } from "./lib/pkc-js/index.js";
+import { encodeChallengeAnswerMessage, encodeChallengeMessage, encodeChallengeRequest, encodeChallengeVerificationMessage, generateSubscriptionId } from "./utils.js";
+import Logger from "../../logger.js";
+import { PKCError } from "../../pkc-error.js";
+import { LocalCommunity } from "../../runtime/node/community/local-community.js";
+import { hideClassPrivateProps, replaceXWithY } from "../../util.js";
+import * as remeda from "remeda";
+import { parseCommentChallengeRequestToEncryptSchemaWithPKCErrorIfItFails, parseCommentEditChallengeRequestToEncryptSchemaWithPKCErrorIfItFails, parseCommentModerationChallengeRequestToEncryptSchemaWithPKCErrorIfItFails, parseCreateNewLocalCommunityUserOptionsSchemaWithPKCErrorIfItFails, parseCreatePKCWsServerOptionsSchemaWithPKCErrorIfItFails, parseDecryptedChallengeAnswerWithPKCErrorIfItFails, parseSetNewSettingsPKCWsServerSchemaWithPKCErrorIfItFails, parseCommunityEditChallengeRequestToEncryptSchemaWithPKCErrorIfItFails, parseCommunityEditOptionsSchemaWithPKCErrorIfItFails, parseVoteChallengeRequestToEncryptSchemaWithPKCErrorIfItFails } from "../../schema/schema-util.js";
+import { stringify as deterministicStringify } from "safe-stable-stringify";
+import { TypedEmitter } from "tiny-typed-emitter";
+import { sanitizeRpcNotificationResult } from "./json-rpc-util.js";
+import { buildPageRuntimeFields, buildPagesRuntimeFields } from "../../pages/util.js";
+import { parseRpcCommunityAddressParam, parseRpcCommunityLookupParam, parseRpcAuthorNameParam, parseRpcCidParam, parseRpcCommentRepliesPageParam, parseRpcCommunityPageParam, parseRpcEditCommunityParam, parseRpcPublishChallengeAnswersParam, parseRpcUnsubscribeParam } from "../../clients/rpc-client/rpc-schema-util.js";
+import { findStartedCommunity } from "../../pkc/tracked-instance-registry-util.js";
+// store started communities to be able to stop them
+// store as a singleton because not possible to start the same community twice at the same time
+const log = Logger("pkc-js-rpc:pkc-ws-server");
+// TODO need to think how to update PKC instance of publication after setSettings?
+class PKCWsServer extends TypedEmitter {
+    constructor({ port, server, pkc, authKey, startStartedCommunitiesOnStartup }) {
+        super();
+        this.connections = {};
+        this.subscriptionCleanups = {};
+        // store publishing publications so they can be used by publishChallengeAnswers
+        this.publishing = {};
+        this._setSettingsQueue = Promise.resolve();
+        this._trackedCommunityListeners = new WeakMap();
+        this._getIpFromConnectionRequest = (req) => req.socket.remoteAddress; // we set it up here so we can mock it in tests
+        this._onSettingsChange = {}; // TODO rename this to _afterSettingsChange
+        this._startedCommunities = {}; // TODO replace this with pkc._startedCommunities
+        this._autoStartOnBoot = false;
+        const log = Logger("pkc-js:PKCWsServer");
+        this.authKey = authKey;
+        this._autoStartOnBoot = startStartedCommunitiesOnStartup ?? true;
+        // don't instantiate pkc in constructor because it's an async function
+        this._initPKC(pkc);
+        this.rpcWebsockets = new RpcWebsocketsServer({
+            port,
+            server,
+            verifyClient: ({ req }, callback) => {
+                // block non-localhost requests without auth key for security
+                const requestOriginatorIp = this._getIpFromConnectionRequest(req);
+                log.trace("Received new connection request from", requestOriginatorIp, "with url", req.url);
+                const xForwardedFor = Boolean(req.rawHeaders.find((item, i) => item.toLowerCase() === "x-forwarded-for" && i % 2 === 0));
+                // client is on localhost and server is not forwarded by a proxy
+                // req.socket.localAddress is the local address of the rpc server
+                const isLocalhost = req.socket.localAddress && req.socket.localAddress === requestOriginatorIp && !xForwardedFor;
+                // the request path is the auth key, e.g. localhost:9138/some-random-auth-key (not secure on http)
+                const hasAuth = this.authKey && `/${this.authKey}` === req.url;
+                // if isn't localhost and doesn't have auth, block access
+                if (!isLocalhost && !hasAuth) {
+                    log(`Rejecting RPC connection request from`, requestOriginatorIp, `rejected because there is no auth key, url:`, req.url);
+                    callback(false, 403, "You need to set the auth key to connect remotely");
+                }
+                else
+                    callback(true);
+            }
+        });
+        // rpc-sockets uses this library https://www.npmjs.com/package/ws
+        this.ws = this.rpcWebsockets.wss;
+        // forward errors to PKCWsServer
+        this.rpcWebsockets.on("error", (error) => {
+            log.error("RPC server", "Received an error on rpc-websockets", error);
+            this._emitError(error);
+        });
+        // save connections to send messages to them later
+        this.ws.on("connection", (ws) => {
+            //@ts-ignore-error
+            this.connections[ws._id] = ws;
+            //@ts-ignore-error
+            this.subscriptionCleanups[ws._id] = {};
+            //@ts-expect-error
+            this._onSettingsChange[ws._id] = {};
+            //@ts-expect-error
+            log("Established connection with new RPC client", ws._id);
+        });
+        // cleanup on disconnect
+        this.rpcWebsockets.on("disconnection", async (ws) => {
+            log("RPC client disconnected", ws._id, "number of rpc clients connected", this.rpcWebsockets.wss.clients.size);
+            const subscriptionCleanups = this.subscriptionCleanups[ws._id];
+            if (!subscriptionCleanups) {
+                delete this.subscriptionCleanups[ws._id];
+                delete this.connections[ws._id];
+                delete this._onSettingsChange[ws._id];
+                log("Disconnected from RPC client (no subscriptions to clean)", ws._id);
+                return;
+            }
+            for (const subscriptionId in subscriptionCleanups) {
+                await subscriptionCleanups[subscriptionId]();
+                delete subscriptionCleanups[subscriptionId];
+            }
+            delete this.subscriptionCleanups[ws._id];
+            delete this.connections[ws._id];
+            delete this._onSettingsChange[ws._id];
+            log("Disconnected from RPC client", ws._id);
+        });
+        // register all JSON RPC methods
+        this.rpcWebsocketsRegister("getComment", this.getComment.bind(this));
+        this.rpcWebsocketsRegister("getCommunityPage", this.getCommunityPage.bind(this));
+        this.rpcWebsocketsRegister("getCommentPage", this.getCommentPage.bind(this));
+        this.rpcWebsocketsRegister("createCommunity", this.createCommunity.bind(this));
+        this.rpcWebsocketsRegister("startCommunity", this.startCommunity.bind(this));
+        this.rpcWebsocketsRegister("stopCommunity", this.stopCommunity.bind(this));
+        this.rpcWebsocketsRegister("editCommunity", this.editCommunity.bind(this));
+        this.rpcWebsocketsRegister("deleteCommunity", this.deleteCommunity.bind(this));
+        this.rpcWebsocketsRegister("communitiesSubscribe", this.communitiesSubscribe.bind(this));
+        this.rpcWebsocketsRegister("settingsSubscribe", this.settingsSubscribe.bind(this));
+        this.rpcWebsocketsRegister("fetchCid", this.fetchCid.bind(this));
+        this.rpcWebsocketsRegister("resolveAuthorName", this.resolveAuthorName.bind(this));
+        this.rpcWebsocketsRegister("setSettings", this.setSettings.bind(this));
+        // JSON RPC pubsub methods
+        this.rpcWebsocketsRegister("commentUpdateSubscribe", this.commentUpdateSubscribe.bind(this));
+        this.rpcWebsocketsRegister("communityUpdateSubscribe", this.communityUpdateSubscribe.bind(this));
+        this.rpcWebsocketsRegister("publishComment", this.publishComment.bind(this));
+        this.rpcWebsocketsRegister("publishCommunityEdit", this.publishCommunityEdit.bind(this));
+        this.rpcWebsocketsRegister("publishVote", this.publishVote.bind(this));
+        this.rpcWebsocketsRegister("publishCommentEdit", this.publishCommentEdit.bind(this));
+        this.rpcWebsocketsRegister("publishCommentModeration", this.publishCommentModeration.bind(this));
+        this.rpcWebsocketsRegister("publishChallengeAnswers", this.publishChallengeAnswers.bind(this));
+        this.rpcWebsocketsRegister("unsubscribe", this.unsubscribe.bind(this));
+        hideClassPrivateProps(this);
+    }
+    async getStartedCommunity(address) {
+        if (!(address in this._startedCommunities))
+            throw Error("Can't call getStartedCommunity when the community hasn't been started");
+        // if pending, wait until no longer pendng
+        while (this._startedCommunities[address] === "pending") {
+            await new Promise((r) => setTimeout(r, 20));
+        }
+        return this._startedCommunities[address];
+    }
+    _emitError(error) {
+        if (this.listeners("error").length === 0)
+            log.error("Unhandled error. This may crash your process, you need to listen for error event on PKCRpcWsServer", error);
+        this.emit("error", error);
+    }
+    // SQLite-based state management for auto-start functionality
+    _getRpcStateDb() {
+        if (this._rpcStateDb)
+            return this._rpcStateDb;
+        const dataPath = this.pkc.dataPath;
+        if (!dataPath)
+            return undefined;
+        const rpcServerDir = path.join(dataPath, "rpc-server");
+        mkdirSync(rpcServerDir, { recursive: true });
+        const dbPath = path.join(rpcServerDir, "rpc-state.db");
+        this._rpcStateDb = new Database(dbPath);
+        this._rpcStateDb.pragma("journal_mode = WAL");
+        // Auto-migrate old table name
+        try {
+            this._rpcStateDb.exec("ALTER TABLE community_states RENAME TO community_states");
+        }
+        catch (_) { }
+        this._rpcStateDb.exec(`
+            CREATE TABLE IF NOT EXISTS community_states (
+                address TEXT PRIMARY KEY,
+                wasStarted INTEGER NOT NULL DEFAULT 0,
+                wasExplicitlyStopped INTEGER NOT NULL DEFAULT 0
+            )
+        `);
+        return this._rpcStateDb;
+    }
+    _updateCommunityState(address, update) {
+        const db = this._getRpcStateDb();
+        if (!db)
+            return;
+        // Ensure row exists with defaults (INSERT OR IGNORE won't fail if row already exists)
+        db.prepare("INSERT OR IGNORE INTO community_states (address) VALUES (?)").run(address);
+        // Update only the specified fields
+        if (update.wasStarted !== undefined) {
+            db.prepare("UPDATE community_states SET wasStarted = ? WHERE address = ?").run(update.wasStarted ? 1 : 0, address);
+        }
+        if (update.wasExplicitlyStopped !== undefined) {
+            db.prepare("UPDATE community_states SET wasExplicitlyStopped = ? WHERE address = ?").run(update.wasExplicitlyStopped ? 1 : 0, address);
+        }
+    }
+    _removeCommunityState(address) {
+        const db = this._getRpcStateDb();
+        if (!db)
+            return;
+        db.prepare("DELETE FROM community_states WHERE address = ?").run(address);
+    }
+    async _autoStartPreviousCommunities() {
+        if (!this._autoStartOnBoot)
+            return;
+        const autoStartLog = Logger("pkc-js-rpc:pkc-ws-server:auto-start");
+        autoStartLog("Checking for previously started communities to auto-start");
+        const db = this._getRpcStateDb();
+        if (!db)
+            return;
+        const rows = db.prepare("SELECT address FROM community_states WHERE wasStarted = 1 AND wasExplicitlyStopped = 0").all();
+        const pkc = await this._getPKCInstance();
+        const localCommunities = pkc.communities;
+        for (const row of rows) {
+            if (!localCommunities.includes(row.address)) {
+                autoStartLog(`Skipping auto-start for ${row.address} - community no longer exists`);
+                this._removeCommunityState(row.address);
+                continue;
+            }
+            if (row.address in this._startedCommunities) {
+                autoStartLog(`Skipping auto-start for ${row.address} - already started`);
+                continue;
+            }
+            autoStartLog(`Auto-starting community: ${row.address}`);
+            try {
+                await this._internalStartCommunity(row.address);
+                autoStartLog(`Successfully auto-started: ${row.address}`);
+            }
+            catch (e) {
+                autoStartLog.error(`Failed to auto-start community ${row.address}`, e);
+                this._emitError(e instanceof Error ? e : new Error(`Failed to auto-start ${row.address}: ${String(e)}`));
+            }
+        }
+    }
+    async _internalStartCommunity(address) {
+        const pkc = await this._getPKCInstance();
+        this._startedCommunities[address] = "pending";
+        try {
+            const community = await pkc.createCommunity({ address });
+            community.started = true;
+            await community.start();
+            this._startedCommunities[address] = community;
+            this._updateCommunityState(address, { wasStarted: true, wasExplicitlyStopped: false });
+            return community;
+        }
+        catch (e) {
+            delete this._startedCommunities[address];
+            throw e;
+        }
+    }
+    // util function to log errors of registered methods
+    rpcWebsocketsRegister(method, callback) {
+        const callbackWithErrorHandled = async (params, connectionId) => {
+            try {
+                const res = await callback(params, connectionId);
+                return res;
+            }
+            catch (e) {
+                const typedError = e;
+                log.error(`${callback.name} error`, { params, error: typedError });
+                // We need to stringify the error here because rpc-websocket will remove props from PKCError
+                if (typedError instanceof PKCError) {
+                    const errorJson = JSON.parse(JSON.stringify(typedError));
+                    delete errorJson["stack"];
+                    throw errorJson;
+                }
+                else
+                    throw typedError;
+            }
+        };
+        this.rpcWebsockets.register(method, callbackWithErrorHandled);
+        // register localhost:9138/<auth-key> to bypass block on non-localhost requests, using /<auth-key> as namespace
+        if (this.authKey) {
+            this.rpcWebsockets.register(method, callbackWithErrorHandled, `/${this.authKey}`);
+        }
+    }
+    // send json rpc notification message (no id field, but must have subscription id)
+    jsonRpcSendNotification({ method, result, subscription, event, connectionId }) {
+        const message = {
+            jsonrpc: "2.0",
+            method,
+            params: {
+                result: sanitizeRpcNotificationResult(event, result),
+                subscription,
+                event
+            }
+        };
+        this.connections[connectionId]?.send?.(JSON.stringify(message));
+    }
+    _registerPublishing(subscriptionId, publication, pkc, connectionId) {
+        this.publishing[subscriptionId] = { publication, pkc, connectionId };
+    }
+    _clearPublishing(subscriptionId) {
+        const record = this.publishing[subscriptionId];
+        if (record?.timeout)
+            clearTimeout(record.timeout);
+        delete this.publishing[subscriptionId];
+    }
+    async _forceCleanupPublication(subscriptionId, reason) {
+        const record = this.publishing[subscriptionId];
+        if (!record)
+            return;
+        const cleanup = await this.subscriptionCleanups?.[record.connectionId]?.[subscriptionId];
+        log(`Force-cleaning publication ${subscriptionId} after ${reason}`);
+        if (cleanup) {
+            await cleanup();
+            if (this.subscriptionCleanups?.[record.connectionId])
+                delete this.subscriptionCleanups[record.connectionId][subscriptionId];
+        }
+        this._clearPublishing(subscriptionId);
+        await this._retirePKCIfNeeded(record.pkc);
+    }
+    async _retirePKCIfNeeded(pkc) {
+        const activePublishes = Object.values(this.publishing).filter(({ pkc: p }) => p === pkc).length;
+        if (activePublishes === 0 && !pkc.destroyed) {
+            // nothing relies on this instance anymore
+            await pkc.destroy().catch((error) => log.error("Failed destroying old pkc immediately after setSettings", { error }));
+            return;
+        }
+    }
+    async _getPKCInstance() {
+        await this._setSettingsQueue;
+        return this.pkc;
+    }
+    async getComment(params) {
+        const getCommentArgs = parseRpcCidParam(params[0]);
+        const comment = await (await this._getPKCInstance()).getComment(getCommentArgs);
+        // TODO may need to be changed later
+        return comment.raw.comment;
+    }
+    async getCommunityPage(params) {
+        const { cid: pageCid, communityAddress, type, pageMaxSize } = parseRpcCommunityPageParam(params[0]);
+        const pkc = await this._getPKCInstance();
+        // Use started community to fetch the page if possible, to expedite the process
+        const community = communityAddress in this._startedCommunities
+            ? await this.getStartedCommunity(communityAddress)
+            : await pkc.createCommunity({ address: communityAddress });
+        const { page } = type === "posts"
+            ? await community.posts._fetchAndVerifyPage({ pageCid, pageMaxSize })
+            : await community.modQueue._fetchAndVerifyPage({ pageCid, pageMaxSize });
+        const runtimeFields = buildPageRuntimeFields(page, pkc._memCaches.nameResolvedCache);
+        return { page, runtimeFields };
+    }
+    async getCommentPage(params) {
+        const { cid: pageCid, commentCid, communityAddress, pageMaxSize } = parseRpcCommentRepliesPageParam(params[0]);
+        const pkc = await this._getPKCInstance();
+        const comment = await pkc.createComment({ cid: commentCid, communityAddress });
+        const { page } = await comment.replies._fetchAndVerifyPage({ pageCid, pageMaxSize });
+        const runtimeFields = buildPageRuntimeFields(page, pkc._memCaches.nameResolvedCache);
+        return { page, runtimeFields };
+    }
+    async createCommunity(params) {
+        const createCommunityOptions = parseCreateNewLocalCommunityUserOptionsSchemaWithPKCErrorIfItFails(params[0]);
+        const pkc = await this._getPKCInstance();
+        const community = await pkc.createCommunity(createCommunityOptions);
+        if (!(community instanceof LocalCommunity))
+            throw Error("Failed to create a local community. This is a critical error");
+        return community.toJSONInternalRpcBeforeFirstUpdate();
+    }
+    _trackCommunityListener(community, event, listener) {
+        let listenersByEvent = this._trackedCommunityListeners.get(community);
+        if (!listenersByEvent) {
+            listenersByEvent = new Map();
+            this._trackedCommunityListeners.set(community, listenersByEvent);
+        }
+        let listeners = listenersByEvent.get(event);
+        if (!listeners) {
+            listeners = new Set();
+            listenersByEvent.set(event, listeners);
+        }
+        listeners.add(listener);
+    }
+    _untrackCommunityListener(community, event, listener) {
+        const listenersByEvent = this._trackedCommunityListeners.get(community);
+        if (!listenersByEvent)
+            return;
+        const listeners = listenersByEvent.get(event);
+        if (!listeners)
+            return;
+        listeners.delete(listener);
+        if (listeners.size === 0)
+            listenersByEvent.delete(event);
+        if (listenersByEvent.size === 0)
+            this._trackedCommunityListeners.delete(community);
+    }
+    _setupStartedEvents(community, connectionId, subscriptionId) {
+        const sendEvent = (event, result) => this.jsonRpcSendNotification({ method: "startCommunity", subscription: subscriptionId, event, result, connectionId });
+        const getUpdateJson = () => typeof community.updatedAt === "number"
+            ? community.toJSONInternalRpcAfterFirstUpdate()
+            : community.toJSONInternalRpcBeforeFirstUpdate();
+        const updateListener = () => {
+            const json = getUpdateJson();
+            // Merge preloaded page runtimeFields into existing runtimeFields
+            const communityIpfsRecord = community.raw.communityIpfs;
+            if (communityIpfsRecord?.posts?.pages && "runtimeFields" in json && json.runtimeFields) {
+                Object.assign(json.runtimeFields, {
+                    posts: { pages: buildPagesRuntimeFields(communityIpfsRecord.posts.pages, community._pkc._memCaches.nameResolvedCache) }
+                });
+            }
+            sendEvent("update", json);
+        };
+        community.on("update", updateListener);
+        this._trackCommunityListener(community, "update", updateListener);
+        const startedStateListener = () => sendEvent("startedstatechange", { state: community.startedState });
+        community.on("startedstatechange", startedStateListener);
+        this._trackCommunityListener(community, "startedstatechange", startedStateListener);
+        const requestListener = (request) => sendEvent("challengerequest", encodeChallengeRequest(request));
+        community.on("challengerequest", requestListener);
+        this._trackCommunityListener(community, "challengerequest", requestListener);
+        const challengeListener = (challenge) => sendEvent("challenge", encodeChallengeMessage(challenge));
+        community.on("challenge", challengeListener);
+        this._trackCommunityListener(community, "challenge", challengeListener);
+        const challengeAnswerListener = (answer) => sendEvent("challengeanswer", encodeChallengeAnswerMessage(answer));
+        community.on("challengeanswer", challengeAnswerListener);
+        this._trackCommunityListener(community, "challengeanswer", challengeAnswerListener);
+        const challengeVerificationListener = (challengeVerification) => sendEvent("challengeverification", {
+            challengeVerification: encodeChallengeVerificationMessage(challengeVerification)
+        });
+        community.on("challengeverification", challengeVerificationListener);
+        this._trackCommunityListener(community, "challengeverification", challengeVerificationListener);
+        const errorListener = (error) => {
+            const rpcError = error;
+            if (community.state === "started")
+                rpcError.details = { ...rpcError.details, newStartedState: community.startedState };
+            else if (community.state === "updating")
+                rpcError.details = { ...rpcError.details, newUpdatingState: community.updatingState };
+            log("community rpc error", rpcError);
+            sendEvent("error", rpcError);
+        };
+        community.on("error", errorListener);
+        this._trackCommunityListener(community, "error", errorListener);
+        // cleanup function
+        this.subscriptionCleanups[connectionId][subscriptionId] = async () => {
+            community.removeListener("update", updateListener);
+            this._untrackCommunityListener(community, "update", updateListener);
+            community.removeListener("startedstatechange", startedStateListener);
+            this._untrackCommunityListener(community, "startedstatechange", startedStateListener);
+            community.removeListener("challengerequest", requestListener);
+            this._untrackCommunityListener(community, "challengerequest", requestListener);
+            community.removeListener("challenge", challengeListener);
+            this._untrackCommunityListener(community, "challenge", challengeListener);
+            community.removeListener("challengeanswer", challengeAnswerListener);
+            this._untrackCommunityListener(community, "challengeanswer", challengeAnswerListener);
+            community.removeListener("challengeverification", challengeVerificationListener);
+            this._untrackCommunityListener(community, "challengeverification", challengeVerificationListener);
+            community.removeListener("error", errorListener);
+            this._untrackCommunityListener(community, "error", errorListener);
+            if (this._onSettingsChange[connectionId])
+                delete this._onSettingsChange[connectionId][subscriptionId];
+        };
+    }
+    async startCommunity(params, connectionId) {
+        const { address } = parseRpcCommunityAddressParam(params[0]);
+        const pkc = await this._getPKCInstance();
+        const localCommunities = pkc.communities;
+        if (!localCommunities.includes(address))
+            throw new PKCError("ERR_RPC_CLIENT_ATTEMPTING_TO_START_A_REMOTE_COMMUNITY", { communityAddress: address });
+        const subscriptionId = generateSubscriptionId();
+        const startCommunityImpl = async () => {
+            const pkc = await this._getPKCInstance();
+            const isCommunityStarted = address in this._startedCommunities;
+            if (isCommunityStarted) {
+                const community = await this.getStartedCommunity(address);
+                this._setupStartedEvents(community, connectionId, subscriptionId);
+            }
+            else {
+                try {
+                    this._startedCommunities[address] = "pending";
+                    const community = await pkc.createCommunity({ address });
+                    this._setupStartedEvents(community, connectionId, subscriptionId);
+                    community.started = true; // a small hack to make sure first update has started=true
+                    community.emit("update", community); // Need to emit an update so rpc user can receive community props prior to running
+                    await community.start();
+                    this._startedCommunities[address] = community;
+                    this._updateCommunityState(address, { wasStarted: true, wasExplicitlyStopped: false });
+                }
+                catch (e) {
+                    const cleanup = this.subscriptionCleanups?.[connectionId]?.[subscriptionId];
+                    if (cleanup)
+                        await cleanup();
+                    delete this._startedCommunities[address];
+                    throw e;
+                }
+            }
+        };
+        this._onSettingsChange[connectionId][subscriptionId] = async ({ newPKC }) => {
+            const current = this._startedCommunities[address];
+            if (!current || current === "pending")
+                return;
+            const community = await this.getStartedCommunity(address);
+            // mark as pending so other consumers wait while we restart with the new pkc instance
+            this._startedCommunities[address] = "pending";
+            try {
+                await community.stop();
+                community._pkc = newPKC;
+                await community.start();
+                this._startedCommunities[address] = community;
+            }
+            catch (error) {
+                delete this._startedCommunities[address];
+                throw error;
+            }
+        };
+        await startCommunityImpl();
+        return subscriptionId;
+    }
+    async stopCommunity(params) {
+        const { address } = parseRpcCommunityAddressParam(params[0]);
+        const pkc = await this._getPKCInstance();
+        const localCommunities = pkc.communities;
+        if (!localCommunities.includes(address))
+            throw new PKCError("ERR_RPC_CLIENT_TRYING_TO_STOP_REMOTE_COMMUNITY", { communityAddress: address });
+        const isCommunityStarted = address in this._startedCommunities;
+        if (!isCommunityStarted)
+            throw new PKCError("ERR_RPC_CLIENT_TRYING_TO_STOP_COMMUNITY_THAT_IS_NOT_RUNNING", { communityAddress: address });
+        const startedCommunity = await this.getStartedCommunity(address);
+        await startedCommunity.stop();
+        // emit last updates so subscribed instances can set their state to stopped
+        await this._postStoppingOrDeleting(startedCommunity);
+        delete this._startedCommunities[address];
+        this._updateCommunityState(address, { wasExplicitlyStopped: true });
+        return true;
+    }
+    async _postStoppingOrDeleting(community) {
+        // emit the last updates
+        // remove all listeners
+        community.emit("update", community);
+        community.emit("startedstatechange", community.startedState);
+        const trackedListeners = this._trackedCommunityListeners.get(community);
+        if (trackedListeners) {
+            for (const [event, listeners] of trackedListeners) {
+                for (const listener of listeners) {
+                    community.removeListener(event, listener);
+                }
+            }
+            this._trackedCommunityListeners.delete(community);
+        }
+    }
+    async editCommunity(params) {
+        const rawParam = params[0];
+        rawParam.editOptions = replaceXWithY(rawParam.editOptions, null, undefined);
+        const { address, editOptions } = parseRpcEditCommunityParam(rawParam);
+        const editCommunityOptions = parseCommunityEditOptionsSchemaWithPKCErrorIfItFails(editOptions);
+        const pkc = await this._getPKCInstance();
+        const localCommunities = pkc.communities;
+        if (!localCommunities.includes(address))
+            throw new PKCError("ERR_RPC_CLIENT_TRYING_TO_EDIT_REMOTE_COMMUNITY", { communityAddress: address });
+        let community;
+        if (this._startedCommunities[address] instanceof LocalCommunity)
+            community = this._startedCommunities[address];
+        else {
+            community = await pkc.createCommunity({ address });
+            community.once("error", (error) => {
+                log.error("RPC server Received an error on community", community.address, "edit", error);
+            });
+        }
+        await community.edit(editCommunityOptions);
+        if (editCommunityOptions.address && this._startedCommunities[address]) {
+            // if (editCommunityOptions.address && this._startedCommunities[address] && editCommunityOptions.address !== address) {
+            this._startedCommunities[editCommunityOptions.address] = this._startedCommunities[address];
+            delete this._startedCommunities[address];
+            // Update RPC state with new address
+            const db = this._getRpcStateDb();
+            if (db) {
+                db.prepare("UPDATE community_states SET address = @newAddress WHERE address = @oldAddress").run({
+                    newAddress: editCommunityOptions.address,
+                    oldAddress: address
+                });
+            }
+        }
+        if (typeof community.updatedAt === "number")
+            return community.toJSONInternalRpcAfterFirstUpdate();
+        else
+            return community.toJSONInternalRpcBeforeFirstUpdate();
+    }
+    async deleteCommunity(params) {
+        const { address } = parseRpcCommunityAddressParam(params[0]);
+        const pkc = await this._getPKCInstance();
+        const addresses = pkc.communities;
+        if (!addresses.includes(address))
+            throw new PKCError("ERR_RPC_CLIENT_TRYING_TO_DELETE_REMOTE_COMMUNITY", { communityAddress: address });
+        const isCommunityStarted = address in this._startedCommunities;
+        const community = isCommunityStarted
+            ? await this.getStartedCommunity(address)
+            : await pkc.createCommunity({ address });
+        await community.delete();
+        await this._postStoppingOrDeleting(community);
+        delete this._startedCommunities[address];
+        this._removeCommunityState(address);
+        return true;
+    }
+    async communitiesSubscribe(params, connectionId) {
+        // TODO need to implement _onSettingsChange here
+        const subscriptionId = generateSubscriptionId();
+        const sendEvent = (event, result) => {
+            this.jsonRpcSendNotification({
+                method: "communitiesNotification",
+                subscription: Number(subscriptionId),
+                event,
+                result,
+                connectionId
+            });
+        };
+        const pkcSubscribeEvent = (newCommunities) => sendEvent("communitieschange", { communities: newCommunities });
+        const pkc = await this._getPKCInstance();
+        pkc.on("communitieschange", pkcSubscribeEvent);
+        this.subscriptionCleanups[connectionId][subscriptionId] = async () => {
+            pkc.removeListener("communitieschange", pkcSubscribeEvent);
+        };
+        sendEvent("communitieschange", { communities: pkc.communities });
+        return subscriptionId;
+    }
+    async fetchCid(params) {
+        const parsedArgs = parseRpcCidParam(params[0]);
+        const pkc = await this._getPKCInstance();
+        const res = await pkc.fetchCid(parsedArgs);
+        if (typeof res !== "string")
+            throw Error("Result of fetchCid should be a string");
+        return { content: res };
+    }
+    _serializeSettingsFromPKC(pkc) {
+        const pkcOptions = pkc.parsedPKCOptions;
+        const builtInChallenges = PKCJs.PKC.challenges || {};
+        const allChallengeFactories = {
+            ...builtInChallenges, // built-ins first
+            ...(pkc.settings?.challenges || {}) // user-defined override
+        };
+        const challenges = remeda.mapValues(allChallengeFactories, (challengeFactory) => remeda.omit(challengeFactory({ challengeSettings: {} }), ["getChallenge"]));
+        return { pkcOptions, challenges };
+    }
+    async settingsSubscribe(params, connectionId) {
+        const subscriptionId = generateSubscriptionId();
+        const sendEvent = (event, result) => {
+            this.jsonRpcSendNotification({
+                method: "settingsNotification",
+                subscription: Number(subscriptionId),
+                event,
+                result,
+                connectionId
+            });
+        };
+        const sendRpcSettings = async ({ newPKC }) => {
+            sendEvent("settingschange", this._serializeSettingsFromPKC(newPKC));
+        };
+        this.subscriptionCleanups[connectionId][subscriptionId] = async () => {
+            if (this._onSettingsChange[connectionId])
+                delete this._onSettingsChange[connectionId][subscriptionId];
+        };
+        this._onSettingsChange[connectionId][subscriptionId] = sendRpcSettings;
+        await sendRpcSettings({ newPKC: this.pkc });
+        return subscriptionId;
+    }
+    _initPKC(pkc) {
+        this.pkc = pkc;
+        pkc.on("error", (error) => log.error("RPC server", "Received an error on pkc instance", error));
+    }
+    async _createPKCInstanceFromSetSettings(newOptions) {
+        return PKCJs.PKC(newOptions);
+    }
+    async setSettings(params) {
+        const runSetSettings = async () => {
+            const settings = parseSetNewSettingsPKCWsServerSchemaWithPKCErrorIfItFails(params[0]);
+            const currentSettings = this._serializeSettingsFromPKC(this.pkc);
+            if (deterministicStringify(settings.pkcOptions) === deterministicStringify(currentSettings.pkcOptions)) {
+                log("RPC client called setSettings with the same settings as the current one, aborting");
+                return;
+            }
+            log(`RPC client called setSettings, the clients need to call all subscription methods again`);
+            const oldPKC = this.pkc;
+            // Strip nameResolvers from client settings — RPC server ignores them for now
+            const { nameResolvers: _stripNr, ...pkcOptionsWithoutNameResolvers } = settings.pkcOptions;
+            const newPKC = await this._createPKCInstanceFromSetSettings({
+                ...pkcOptionsWithoutNameResolvers,
+                nameResolvers: this.pkc.parsedPKCOptions.nameResolvers
+            });
+            this._initPKC(newPKC); // swap to new instance first so new RPC calls don't hit a destroyed pkc
+            // send a settingsNotification to all subscribers
+            for (const connectionId of remeda.keys.strict(this._onSettingsChange)) {
+                const connectionHandlers = this._onSettingsChange[connectionId];
+                if (!connectionHandlers)
+                    continue;
+                for (const subscriptionId of remeda.keys.strict(connectionHandlers)) {
+                    const handler = connectionHandlers[subscriptionId];
+                    if (handler)
+                        await handler({ newPKC });
+                }
+            }
+            // ensure any existing publications get a timeout if they were created before the first setSettings
+            for (const [subscriptionId, pub] of Object.entries(this.publishing).filter((pub) => pub[1].pkc === oldPKC)) {
+                pub.timeout = setTimeout(async () => {
+                    await this._forceCleanupPublication(Number(subscriptionId), "timeout");
+                }, 60000);
+            }
+            setTimeout(async () => {
+                await this._retirePKCIfNeeded(oldPKC);
+            }, 60000); // set this in a timeout because createCommunity may be using it
+        };
+        const setSettingsRun = this._setSettingsQueue.then(() => runSetSettings());
+        // keep queue usable even if a run fails; error still propagates to the caller via setSettingsRun
+        this._setSettingsQueue = setSettingsRun.catch(() => { });
+        await setSettingsRun;
+        return true;
+    }
+    async commentUpdateSubscribe(params, connectionId) {
+        const logUpdate = Logger("pkc-js-rpc:pkc-ws-server:commentUpdateSubscribe");
+        const parsedCommentUpdateArgs = parseRpcCidParam(params[0]);
+        const subscriptionId = generateSubscriptionId();
+        const sendEvent = (event, result) => this.jsonRpcSendNotification({
+            method: "commentUpdateNotification",
+            subscription: subscriptionId,
+            event,
+            result,
+            connectionId
+        });
+        let sentCommentIpfsUpdateEvent = false;
+        let lastSentNameResolved = undefined;
+        const pkc = await this._getPKCInstance();
+        const comment = await pkc.createComment(parsedCommentUpdateArgs);
+        const sendUpdate = () => {
+            if (!sentCommentIpfsUpdateEvent && comment.raw.comment) {
+                sendEvent("comment", {
+                    comment: comment.raw.comment,
+                    runtimeFields: { author: { nameResolved: comment.author.nameResolved } }
+                });
+                sentCommentIpfsUpdateEvent = true;
+                lastSentNameResolved = comment.author.nameResolved;
+            }
+            if (comment.raw.commentUpdate) {
+                const updateEvent = { commentUpdate: comment.raw.commentUpdate };
+                const runtimeFields = {};
+                if (comment.raw.commentUpdate.replies?.pages) {
+                    runtimeFields.replies = {
+                        pages: buildPagesRuntimeFields(comment.raw.commentUpdate.replies.pages, pkc._memCaches.nameResolvedCache)
+                    };
+                }
+                if (typeof comment.author.nameResolved === "boolean") {
+                    runtimeFields.author = { nameResolved: comment.author.nameResolved };
+                }
+                if (Object.keys(runtimeFields).length > 0) {
+                    updateEvent.runtimeFields = runtimeFields;
+                }
+                sendEvent("update", updateEvent);
+                lastSentNameResolved = comment.author.nameResolved;
+            }
+            else if (sentCommentIpfsUpdateEvent &&
+                typeof comment.author.nameResolved === "boolean" &&
+                comment.author.nameResolved !== lastSentNameResolved) {
+                // nameResolved changed but no commentUpdate to piggyback on — send dedicated runtimeupdate event
+                sendEvent("runtimeupdate", { author: { nameResolved: comment.author.nameResolved } });
+                lastSentNameResolved = comment.author.nameResolved;
+            }
+        };
+        const updateListener = () => sendUpdate();
+        comment.on("update", updateListener);
+        const updatingStateListener = () => sendEvent("updatingstatechange", { state: comment.updatingState });
+        comment.on("updatingstatechange", updatingStateListener);
+        const stateListener = () => sendEvent("statechange", { state: comment.state });
+        comment.on("statechange", stateListener);
+        const errorListener = (error) => {
+            const errorWithNewUpdatingState = error;
+            if (comment.state === "publishing")
+                errorWithNewUpdatingState.details = { ...errorWithNewUpdatingState.details, newPublishingState: comment.publishingState };
+            else if (comment.state === "updating")
+                errorWithNewUpdatingState.details = { ...errorWithNewUpdatingState.details, newUpdatingState: comment.updatingState };
+            sendEvent("error", errorWithNewUpdatingState);
+        };
+        comment.on("error", errorListener);
+        // cleanup function
+        this.subscriptionCleanups[connectionId][subscriptionId] = async () => {
+            logUpdate("Cleaning up commentUpdate subscription", { subscriptionId, connectionId, cid: comment.cid });
+            comment.removeListener("update", updateListener);
+            comment.removeListener("updatingstatechange", updatingStateListener);
+            comment.removeListener("statechange", stateListener);
+            comment.removeListener("error", errorListener);
+            await comment.stop();
+            if (this._onSettingsChange[connectionId])
+                delete this._onSettingsChange[connectionId][subscriptionId];
+        };
+        this._onSettingsChange[connectionId][subscriptionId] = async ({ newPKC }) => {
+            // TODO need to clean up and remove old comment here, and create a new comment
+            comment._pkc = newPKC;
+            await comment.update();
+        };
+        // if fail, cleanup
+        try {
+            sendUpdate();
+            await comment.update();
+        }
+        catch (e) {
+            logUpdate.error("Cleaning up subscription to comment", comment.cid, "because comment.update threw an error", e);
+            const cleanup = this.subscriptionCleanups?.[connectionId]?.[subscriptionId];
+            if (cleanup)
+                await cleanup();
+            throw e;
+        }
+        return subscriptionId;
+    }
+    async communityUpdateSubscribe(params, connectionId) {
+        const parsedCommunityUpdateArgs = parseRpcCommunityLookupParam(params[0]);
+        const subscriptionId = generateSubscriptionId();
+        await this._bindCommunityUpdateSubscription(parsedCommunityUpdateArgs, connectionId, subscriptionId);
+        return subscriptionId;
+    }
+    async _bindCommunityUpdateSubscription(parsedArgs, connectionId, subscriptionId) {
+        const sendEvent = (event, result) => this.jsonRpcSendNotification({
+            method: "communityUpdateNotification",
+            subscription: subscriptionId,
+            event,
+            result,
+            connectionId
+        });
+        const pkc = await this._getPKCInstance();
+        const startedCommunity = findStartedCommunity(pkc, parsedArgs);
+        const isStartedCommunity = Boolean(startedCommunity);
+        const community = startedCommunity || await pkc.createCommunity(parsedArgs);
+        const sendCommunityJson = () => {
+            let jsonToSend;
+            if (community instanceof LocalCommunity)
+                jsonToSend =
+                    typeof community.updatedAt === "number"
+                        ? community.toJSONInternalRpcAfterFirstUpdate()
+                        : community.toJSONInternalRpcBeforeFirstUpdate();
+            else
+                jsonToSend = community.toJSONRpcRemote();
+            // Merge preloaded page runtimeFields into existing runtimeFields
+            const communityIpfsRecord = community.raw.communityIpfs;
+            if (communityIpfsRecord?.posts?.pages && "runtimeFields" in jsonToSend && jsonToSend.runtimeFields) {
+                Object.assign(jsonToSend.runtimeFields, {
+                    posts: { pages: buildPagesRuntimeFields(communityIpfsRecord.posts.pages, pkc._memCaches.nameResolvedCache) }
+                });
+            }
+            sendEvent("update", jsonToSend);
+        };
+        const updateListener = () => sendCommunityJson();
+        community.on("update", updateListener);
+        const updatingStateListener = () => sendEvent("updatingstatechange", { state: community.updatingState });
+        community.on("updatingstatechange", updatingStateListener);
+        // listener for startestatechange
+        const startedStateListener = () => sendEvent("updatingstatechange", { state: community.startedState });
+        if (isStartedCommunity) {
+            community.on("startedstatechange", startedStateListener);
+        }
+        const errorListener = (error) => {
+            const rpcError = error;
+            if (community.state === "started")
+                rpcError.details = { ...rpcError.details, newStartedState: community.startedState };
+            else if (community.state === "updating")
+                rpcError.details = { ...rpcError.details, newUpdatingState: community.updatingState };
+            log("community rpc error", rpcError);
+            sendEvent("error", rpcError);
+        };
+        community.on("error", errorListener);
+        // cleanup function
+        this.subscriptionCleanups[connectionId][subscriptionId] = async () => {
+            log("Cleaning up community", community.address, "client subscription");
+            community.removeListener("update", updateListener);
+            community.removeListener("updatingstatechange", updatingStateListener);
+            community.removeListener("error", errorListener);
+            community.removeListener("startedstatechange", startedStateListener);
+            if (this._onSettingsChange[connectionId])
+                delete this._onSettingsChange[connectionId][subscriptionId];
+            // We don't wanna stop the local community if it's running already, this function is just for fetching updates
+            // if we comment this out remove test passes
+            if (!isStartedCommunity && community.state !== "stopped")
+                await community.stop();
+        };
+        this._onSettingsChange[connectionId][subscriptionId] = async ({ newPKC }) => {
+            // TODO this may need changing
+            if (!isStartedCommunity) {
+                community._pkc = newPKC;
+                await community.stop();
+                await community.update();
+            }
+        };
+        // if fail, cleanup
+        try {
+            // need to send an update with first communityUpdate if it's a local community
+            if ("signer" in community || community.raw.communityIpfs)
+                sendCommunityJson();
+            // No need to call .update() if it's already running locally because we're listening to update event
+            if (!isStartedCommunity)
+                await community.update();
+        }
+        catch (e) {
+            const cleanup = this.subscriptionCleanups?.[connectionId]?.[subscriptionId];
+            if (cleanup)
+                await cleanup();
+            throw e;
+        }
+    }
+    async _createCommentInstanceFromPublishCommentParams(params) {
+        const pkc = await this._getPKCInstance();
+        const comment = await pkc.createComment(params.comment);
+        comment.challengeRequest = remeda.omit(params, ["comment"]);
+        return comment;
+    }
+    async publishComment(params, connectionId) {
+        // TODO need to implement _onSettingsChange here
+        const publishOptions = parseCommentChallengeRequestToEncryptSchemaWithPKCErrorIfItFails(params[0]);
+        const subscriptionId = generateSubscriptionId();
+        const sendEvent = (event, result) => this.jsonRpcSendNotification({
+            method: "publishCommentNotification",
+            subscription: subscriptionId,
+            event,
+            result,
+            connectionId
+        });
+        const comment = await this._createCommentInstanceFromPublishCommentParams(publishOptions);
+        this._registerPublishing(subscriptionId, comment, comment._pkc, connectionId);
+        const challengeListener = (challenge) => sendEvent("challenge", encodeChallengeMessage(challenge));
+        comment.on("challenge", challengeListener);
+        const challengeAnswerListener = (answer) => sendEvent("challengeanswer", encodeChallengeAnswerMessage(answer));
+        comment.on("challengeanswer", challengeAnswerListener);
+        const challengeRequestListener = (request) => sendEvent("challengerequest", encodeChallengeRequest(request));
+        comment.on("challengerequest", challengeRequestListener);
+        const challengeVerificationListener = (challengeVerification) => sendEvent("challengeverification", {
+            challengeVerification: encodeChallengeVerificationMessage(challengeVerification),
+            runtimeFields: { author: { nameResolved: comment.author.nameResolved } }
+        });
+        comment.on("challengeverification", challengeVerificationListener);
+        const publishingStateListener = () => {
+            sendEvent("publishingstatechange", { state: comment.publishingState });
+        };
+        comment.on("publishingstatechange", publishingStateListener);
+        const stateListener = () => sendEvent("statechange", { state: comment.state });
+        comment.on("statechange", stateListener);
+        const errorListener = (error) => {
+            const commentRpcError = error;
+            commentRpcError.details = {
+                ...commentRpcError.details,
+                newPublishingState: comment.publishingState
+            };
+            sendEvent("error", commentRpcError);
+        };
+        comment.on("error", errorListener);
+        // cleanup function
+        this.subscriptionCleanups[connectionId][subscriptionId] = async () => {
+            comment.removeListener("challenge", challengeListener);
+            comment.removeListener("challengeanswer", challengeAnswerListener);
+            comment.removeListener("challengerequest", challengeRequestListener);
+            comment.removeListener("challengeverification", challengeVerificationListener);
+            comment.removeListener("publishingstatechange", publishingStateListener);
+            comment.removeListener("statechange", stateListener);
+            comment.removeListener("error", errorListener);
+            await comment.stop();
+            this._clearPublishing(subscriptionId);
+            if (this._onSettingsChange[connectionId])
+                delete this._onSettingsChange[connectionId][subscriptionId];
+        };
+        // if fail, cleanup
+        try {
+            await comment.publish();
+        }
+        catch (e) {
+            const error = e;
+            error.details = { ...error.details, publishThrowError: true };
+            errorListener(error);
+            const cleanup = this.subscriptionCleanups?.[connectionId]?.[subscriptionId];
+            if (cleanup)
+                await cleanup();
+            return subscriptionId;
+        }
+        return subscriptionId;
+    }
+    async _createVoteInstanceFromPublishVoteParams(params) {
+        const pkc = await this._getPKCInstance();
+        const vote = await pkc.createVote(params.vote);
+        vote.challengeRequest = remeda.omit(params, ["vote"]);
+        return vote;
+    }
+    async publishVote(params, connectionId) {
+        // TODO need to implement _onSettingsChange here
+        const publishOptions = parseVoteChallengeRequestToEncryptSchemaWithPKCErrorIfItFails(params[0]);
+        // TODO need to think, what happens if user never sends a unsubsribe call?
+        // publication will never get removed from this.publishing
+        const subscriptionId = generateSubscriptionId();
+        const sendEvent = (event, result) => this.jsonRpcSendNotification({ method: "publishVoteNotification", subscription: subscriptionId, event, result, connectionId });
+        const vote = await this._createVoteInstanceFromPublishVoteParams(publishOptions);
+        this._registerPublishing(subscriptionId, vote, vote._pkc, connectionId);
+        const challengeListener = (challenge) => sendEvent("challenge", encodeChallengeMessage(challenge));
+        vote.on("challenge", challengeListener);
+        const challengeAnswerListener = (answer) => sendEvent("challengeanswer", encodeChallengeAnswerMessage(answer));
+        vote.on("challengeanswer", challengeAnswerListener);
+        const challengeRequestListener = (request) => sendEvent("challengerequest", encodeChallengeRequest(request));
+        vote.on("challengerequest", challengeRequestListener);
+        const challengeVerificationListener = (challengeVerification) => sendEvent("challengeverification", {
+            challengeVerification: encodeChallengeVerificationMessage(challengeVerification)
+        });
+        vote.on("challengeverification", challengeVerificationListener);
+        const publishingStateListener = () => sendEvent("publishingstatechange", { state: vote.publishingState });
+        vote.on("publishingstatechange", publishingStateListener);
+        const errorListener = (error) => {
+            const voteRpcError = error;
+            voteRpcError.details = { ...voteRpcError.details, newPublishingState: vote.publishingState };
+            sendEvent("error", voteRpcError);
+        };
+        vote.on("error", errorListener);
+        // cleanup function
+        this.subscriptionCleanups[connectionId][subscriptionId] = async () => {
+            this._clearPublishing(subscriptionId);
+            await vote.stop();
+            vote.removeListener("challenge", challengeListener);
+            vote.removeListener("challengeanswer", challengeAnswerListener);
+            vote.removeListener("challengerequest", challengeRequestListener);
+            vote.removeListener("challengeverification", challengeVerificationListener);
+            vote.removeListener("publishingstatechange", publishingStateListener);
+            vote.removeListener("error", errorListener);
+        };
+        // if fail, cleanup
+        try {
+            await vote.publish();
+        }
+        catch (e) {
+            const error = e;
+            error.details = { ...error.details, publishThrowError: true };
+            errorListener(error);
+            const cleanup = this.subscriptionCleanups?.[connectionId]?.[subscriptionId];
+            if (cleanup)
+                await cleanup();
+        }
+        return subscriptionId;
+    }
+    async _createCommunityEditInstanceFromPublishCommunityEditParams(params) {
+        const pkc = await this._getPKCInstance();
+        const communityEdit = await pkc.createCommunityEdit(params.communityEdit);
+        communityEdit.challengeRequest = remeda.omit(params, ["communityEdit"]);
+        return communityEdit;
+    }
+    async publishCommunityEdit(params, connectionId) {
+        // TODO need to implement _onSettingsChange here
+        const publishOptions = parseCommunityEditChallengeRequestToEncryptSchemaWithPKCErrorIfItFails(params[0]);
+        const subscriptionId = generateSubscriptionId();
+        const sendEvent = (event, result) => this.jsonRpcSendNotification({
+            method: "publishCommunityEditNotification",
+            subscription: subscriptionId,
+            event,
+            result,
+            connectionId
+        });
+        const communityEdit = await this._createCommunityEditInstanceFromPublishCommunityEditParams(publishOptions);
+        this._registerPublishing(subscriptionId, communityEdit, communityEdit._pkc, connectionId);
+        const challengeListener = (challenge) => sendEvent("challenge", encodeChallengeMessage(challenge));
+        communityEdit.on("challenge", challengeListener);
+        const challengeAnswerListener = (answer) => sendEvent("challengeanswer", encodeChallengeAnswerMessage(answer));
+        communityEdit.on("challengeanswer", challengeAnswerListener);
+        const challengeRequestListener = (request) => sendEvent("challengerequest", encodeChallengeRequest(request));
+        communityEdit.on("challengerequest", challengeRequestListener);
+        const challengeVerificationListener = (challengeVerification) => sendEvent("challengeverification", {
+            challengeVerification: encodeChallengeVerificationMessage(challengeVerification)
+        });
+        communityEdit.on("challengeverification", challengeVerificationListener);
+        const publishingStateListener = () => sendEvent("publishingstatechange", { state: communityEdit.publishingState });
+        communityEdit.on("publishingstatechange", publishingStateListener);
+        const errorListener = (error) => {
+            const editRpcError = error;
+            editRpcError.details = { ...editRpcError.details, newPublishingState: communityEdit.publishingState };
+            sendEvent("error", editRpcError);
+        };
+        communityEdit.on("error", errorListener);
+        // cleanup function
+        this.subscriptionCleanups[connectionId][subscriptionId] = async () => {
+            this._clearPublishing(subscriptionId);
+            await communityEdit.stop();
+            communityEdit.removeListener("challenge", challengeListener);
+            communityEdit.removeListener("challengeanswer", challengeAnswerListener);
+            communityEdit.removeListener("challengerequest", challengeRequestListener);
+            communityEdit.removeListener("challengeverification", challengeVerificationListener);
+            communityEdit.removeListener("publishingstatechange", publishingStateListener);
+            communityEdit.removeListener("error", errorListener);
+        };
+        // if fail, cleanup
+        try {
+            await communityEdit.publish();
+        }
+        catch (e) {
+            const error = e;
+            error.details = { ...error.details, publishThrowError: true };
+            errorListener(error);
+            const cleanup = this.subscriptionCleanups?.[connectionId]?.[subscriptionId];
+            if (cleanup)
+                await cleanup();
+        }
+        return subscriptionId;
+    }
+    async _createCommentEditInstanceFromPublishCommentEditParams(params) {
+        const pkc = await this._getPKCInstance();
+        const commentEdit = await pkc.createCommentEdit(params.commentEdit);
+        commentEdit.challengeRequest = remeda.omit(params, ["commentEdit"]);
+        return commentEdit;
+    }
+    async publishCommentEdit(params, connectionId) {
+        // TODO need to implement _onSettingsChange here
+        const publishOptions = parseCommentEditChallengeRequestToEncryptSchemaWithPKCErrorIfItFails(params[0]);
+        const subscriptionId = generateSubscriptionId();
+        const sendEvent = (event, result) => this.jsonRpcSendNotification({
+            method: "publishCommentEditNotification",
+            subscription: subscriptionId,
+            event,
+            result,
+            connectionId
+        });
+        const commentEdit = await this._createCommentEditInstanceFromPublishCommentEditParams(publishOptions);
+        this._registerPublishing(subscriptionId, commentEdit, commentEdit._pkc, connectionId);
+        const challengeListener = (challenge) => sendEvent("challenge", encodeChallengeMessage(challenge));
+        commentEdit.on("challenge", challengeListener);
+        const challengeAnswerListener = (answer) => sendEvent("challengeanswer", encodeChallengeAnswerMessage(answer));
+        commentEdit.on("challengeanswer", challengeAnswerListener);
+        const challengeRequestListener = (request) => sendEvent("challengerequest", encodeChallengeRequest(request));
+        commentEdit.on("challengerequest", challengeRequestListener);
+        const challengeVerificationListener = (challengeVerification) => sendEvent("challengeverification", {
+            challengeVerification: encodeChallengeVerificationMessage(challengeVerification)
+        });
+        commentEdit.on("challengeverification", challengeVerificationListener);
+        const publishingStateListener = () => sendEvent("publishingstatechange", { state: commentEdit.publishingState });
+        commentEdit.on("publishingstatechange", publishingStateListener);
+        const errorListener = (error) => {
+            const commentEditRpcError = error;
+            commentEditRpcError.details = {
+                ...commentEditRpcError.details,
+                newPublishingState: commentEdit.publishingState
+            };
+            sendEvent("error", commentEditRpcError);
+        };
+        commentEdit.on("error", errorListener);
+        // cleanup function
+        this.subscriptionCleanups[connectionId][subscriptionId] = async () => {
+            this._clearPublishing(subscriptionId);
+            await commentEdit.stop();
+            commentEdit.removeListener("challenge", challengeListener);
+            commentEdit.removeListener("challengeanswer", challengeAnswerListener);
+            commentEdit.removeListener("challengerequest", challengeRequestListener);
+            commentEdit.removeListener("challengeverification", challengeVerificationListener);
+            commentEdit.removeListener("publishingstatechange", publishingStateListener);
+            commentEdit.removeListener("error", errorListener);
+        };
+        // if fail, cleanup
+        try {
+            await commentEdit.publish();
+        }
+        catch (e) {
+            const error = e;
+            error.details = { ...error.details, publishThrowError: true };
+            errorListener(error);
+            const cleanup = this.subscriptionCleanups?.[connectionId]?.[subscriptionId];
+            if (cleanup)
+                await cleanup();
+        }
+        return subscriptionId;
+    }
+    async _createCommentModerationInstanceFromPublishCommentModerationParams(params) {
+        const pkc = await this._getPKCInstance();
+        const commentModeration = await pkc.createCommentModeration(params.commentModeration);
+        commentModeration.challengeRequest = remeda.omit(params, ["commentModeration"]);
+        return commentModeration;
+    }
+    async publishCommentModeration(params, connectionId) {
+        // TODO need to implement _onSettingsChange here
+        const publishOptions = parseCommentModerationChallengeRequestToEncryptSchemaWithPKCErrorIfItFails(params[0]);
+        const subscriptionId = generateSubscriptionId();
+        const sendEvent = (event, result) => this.jsonRpcSendNotification({
+            method: "publishCommentModerationNotification",
+            subscription: subscriptionId,
+            event,
+            result,
+            connectionId
+        });
+        const commentMod = await this._createCommentModerationInstanceFromPublishCommentModerationParams(publishOptions);
+        this._registerPublishing(subscriptionId, commentMod, commentMod._pkc, connectionId);
+        const challengeListener = (challenge) => sendEvent("challenge", encodeChallengeMessage(challenge));
+        commentMod.on("challenge", challengeListener);
+        const challengeAnswerListener = (answer) => sendEvent("challengeanswer", encodeChallengeAnswerMessage(answer));
+        commentMod.on("challengeanswer", challengeAnswerListener);
+        const challengeRequestListener = (request) => sendEvent("challengerequest", encodeChallengeRequest(request));
+        commentMod.on("challengerequest", challengeRequestListener);
+        const challengeVerificationListener = (challengeVerification) => sendEvent("challengeverification", {
+            challengeVerification: encodeChallengeVerificationMessage(challengeVerification)
+        });
+        commentMod.on("challengeverification", challengeVerificationListener);
+        const publishingStateListener = () => sendEvent("publishingstatechange", { state: commentMod.publishingState });
+        commentMod.on("publishingstatechange", publishingStateListener);
+        const errorListener = (error) => {
+            const commentModRpcError = error;
+            commentModRpcError.details = {
+                ...commentModRpcError.details,
+                newPublishingState: commentMod.publishingState
+            };
+            sendEvent("error", commentModRpcError);
+        };
+        commentMod.on("error", errorListener);
+        // cleanup function
+        this.subscriptionCleanups[connectionId][subscriptionId] = async () => {
+            commentMod.removeListener("challenge", challengeListener);
+            commentMod.removeListener("challengeanswer", challengeAnswerListener);
+            commentMod.removeListener("challengerequest", challengeRequestListener);
+            commentMod.removeListener("challengeverification", challengeVerificationListener);
+            commentMod.removeListener("publishingstatechange", publishingStateListener);
+            commentMod.removeListener("error", errorListener);
+            await commentMod.stop();
+            this._clearPublishing(subscriptionId);
+        };
+        // if fail, cleanup
+        try {
+            await commentMod.publish();
+        }
+        catch (e) {
+            const error = e;
+            error.details = { ...error.details, publishThrowError: true };
+            errorListener(error);
+            const cleanup = this.subscriptionCleanups?.[connectionId]?.[subscriptionId];
+            if (cleanup)
+                await cleanup();
+        }
+        return subscriptionId;
+    }
+    async publishChallengeAnswers(params) {
+        const parsed = parseRpcPublishChallengeAnswersParam(params[0]);
+        const subscriptionId = parsed.subscriptionId;
+        const decryptedChallengeAnswers = parseDecryptedChallengeAnswerWithPKCErrorIfItFails({
+            challengeAnswers: parsed.challengeAnswers
+        });
+        const record = this.publishing[subscriptionId];
+        if (!record?.publication) {
+            throw Error(`no subscription with id '${subscriptionId}'`);
+        }
+        const publication = record.publication;
+        await this._getPKCInstance(); // to await for settings change
+        await publication.publishChallengeAnswers(decryptedChallengeAnswers.challengeAnswers);
+        return true;
+    }
+    async resolveAuthorName(params) {
+        const parsedArgs = parseRpcAuthorNameParam(params[0]);
+        const pkc = await this._getPKCInstance();
+        const resolvedAuthorAddress = await pkc.resolveAuthorName(parsedArgs);
+        return { resolvedAddress: resolvedAuthorAddress };
+    }
+    async unsubscribe(params, connectionId) {
+        const { subscriptionId } = parseRpcUnsubscribeParam(params[0]);
+        log("Received unsubscribe", { connectionId, subscriptionId });
+        const connectionCleanups = this.subscriptionCleanups[connectionId];
+        if (!connectionCleanups || !connectionCleanups[subscriptionId])
+            return true;
+        await connectionCleanups[subscriptionId](); // commenting this out fixes the timeout with remove.test.js
+        delete connectionCleanups[subscriptionId];
+        return true;
+    }
+    async destroy() {
+        for (const connectionId of remeda.keys.strict(this.subscriptionCleanups))
+            for (const subscriptionId of remeda.keys.strict(this.subscriptionCleanups[connectionId]))
+                await this.unsubscribe([{ subscriptionId: Number(subscriptionId) }], connectionId);
+        this.ws.close();
+        const pkc = await this._getPKCInstance();
+        await pkc.destroy(); // this will stop all started communities
+        for (const communityAddress of remeda.keys.strict(this._startedCommunities)) {
+            delete this._startedCommunities[communityAddress];
+        }
+        this._rpcStateDb?.close();
+        this._rpcStateDb = undefined;
+        this._onSettingsChange = {};
+    }
+}
+const createPKCWsServer = async (options) => {
+    const parsedOptions = parseCreatePKCWsServerOptionsSchemaWithPKCErrorIfItFails(options);
+    const pkc = await PKCJs.PKC(parsedOptions.pkcOptions);
+    const pkcWss = new PKCWsServer({
+        pkc,
+        port: parsedOptions.port,
+        server: parsedOptions.server,
+        authKey: parsedOptions.authKey,
+        startStartedCommunitiesOnStartup: parsedOptions.startStartedCommunitiesOnStartup
+    });
+    // Auto-start previously started communities (fire-and-forget, non-blocking)
+    pkcWss._autoStartPreviousCommunities().catch((e) => {
+        log.error("Failed to auto-start previous communities", e);
+    });
+    return pkcWss;
+};
+const PKCRpc = {
+    PKCWsServer: createPKCWsServer,
+    // for mocking pkc-js during tests
+    setPKCJs
+};
+export default PKCRpc;
+//# sourceMappingURL=index.js.map