@ercworldio/blockchain-shared 1.0.0 → 1.0.1-dev.0

package/build/services/quicknode-notifications/QnNotificationsApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QnNotificationsApi.d.ts","sourceRoot":"","sources":["../../../src/services/quicknode-notifications/QnNotificationsApi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACtG,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,UAAU,MAAM,qBAAqB,CAAC;AAC7C,OAAyB,EAAE,kBAAkB,EAAa,MAAM,8BAA8B,CAAC;AAE/F,cAAM,kBAAmB,SAAQ,UAAU;IACvC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqB;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAgD;IAChE,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,GAAG,CAA6D;IAExE,OAAO;IAWP,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,kBAAkB,GAAG,kBAAkB;IAOpE,cAAc,CACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,EAAE,GAC5B,OAAO,CAAC,4BAA4B,CAAC;IAY3B,gBAAgB,IAAI,OAAO,CAAC,0BAA0B,CAAC;IAIvD,wBAAwB,CACjC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,IAAI,CAAC;IAQH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAIhD,IAAI;CAsCrB;AAED,eAAe,kBAAkB,CAAC"}

package/build/services/quicknode-notifications/QnNotificationsApi.js

@@ -0,0 +1,134 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const errors_1 = __importDefault(require("../../errors/errors"));
+const AsyncRateLimiter_1 = __importStar(require("../../utils/AsyncRateLimiter"));
+class QnNotificationsApi extends errors_1.default {
+    constructor(config, rlc) {
+        super();
+        this.base_url = "https://api.quicknode.com/webhooks/rest/v1";
+        this.rlc = { maxConcurrent: 1, minDelayMs: 1000 };
+        this.api_key = config.config.quicknodeApiKey;
+        if (!this.api_key)
+            throw new Error(`quicknode api key is required`);
+        if (rlc) {
+            this.rlc = rlc;
+        }
+        this.rate_limiter = new AsyncRateLimiter_1.default(this.rlc);
+    }
+    static getInstance(config, rlc) {
+        if (!this.instance) {
+            this.instance = new QnNotificationsApi(config, rlc);
+        }
+        return this.instance;
+    }
+    create_webhook(template, name, network, webhook_url, initial_addresses) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const template_arg_key = template === 'solanaWalletFilter' ? 'accounts' : 'wallets';
+            const body = {
+                name,
+                network,
+                status: 'active',
+                destination_attributes: { url: webhook_url, compression: 'none' },
+                templateArgs: { [template_arg_key]: initial_addresses }
+            };
+            return yield this.call(`/webhooks/template/${template}`, 'POST', { body });
+        });
+    }
+    get_all_webhooks() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.call('/webhooks', 'GET', { query_params: { limit: 100, offset: 0 } });
+        });
+    }
+    update_webhook_addresses(webhook_id, template, all_addresses) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const template_arg_key = template === 'solanaWalletFilter' ? 'accounts' : 'wallets';
+            const body = {
+                templateArgs: { [template_arg_key]: all_addresses }
+            };
+            yield this.call(`/webhooks/${webhook_id}/template/${template}`, 'PATCH', { body });
+        });
+    }
+    delete_webhook(webhook_id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.call(`/webhooks/${webhook_id}`, 'DELETE');
+        });
+    }
+    call(endpoint, method, opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const request_options = {
+                method,
+                headers: {
+                    'accept': 'application/json',
+                    'Content-Type': 'application/json',
+                    'x-api-key': this.api_key
+                },
+                body: (opts === null || opts === void 0 ? void 0 : opts.body) ? JSON.stringify(opts.body) : undefined,
+            };
+            let url = `${this.base_url}${endpoint}`;
+            if (opts === null || opts === void 0 ? void 0 : opts.query_params) {
+                const params = new URLSearchParams();
+                Object.entries(opts.query_params).forEach(([k, v]) => {
+                    if (v !== undefined && v !== null)
+                        params.append(k, String(v));
+                });
+                const qs = params.toString();
+                if (qs)
+                    url += `?${qs}`;
+            }
+            console.log(`QnNotificationsApi: ${method} ${url}`);
+            const res = yield this.rate_limiter.execute(() => (0, AsyncRateLimiter_1.withRetry)(() => __awaiter(this, void 0, void 0, function* () { return yield fetch(url, request_options); })));
+            if (!res.ok) {
+                const err = yield res.text();
+                throw new Error(`QnNotificationsApi: ${method} ${endpoint} failed [${res.status}]: ${err}`);
+            }
+            const text = yield res.text();
+            return text ? JSON.parse(text) : null;
+        });
+    }
+}
+exports.default = QnNotificationsApi;

package/build/services/quicknode-notifications/QnWebhookAddressManager.d.ts

@@ -0,0 +1,47 @@
+import { BlockchainType, ChainId } from "../../interfaces";
+import { IConfig } from "../../interfaces/config";
+import { RateLimiterOptions } from "../../utils/AsyncRateLimiter";
+declare class QnWebhookAddressManager {
+    private static instance;
+    private api;
+    private config;
+    private cache;
+    private constructor();
+    static getInstance(config: IConfig, rlc?: RateLimiterOptions): QnWebhookAddressManager;
+    private get_blockchain_for_chain;
+    /** Returns the { name, network } pairs for the notification configs of a given chain. */
+    private get_webhook_keys_for_chain;
+    private get_notif_configs;
+    private is_stale;
+    private load;
+    private ensure_loaded;
+    private matches_key;
+    add_address(blockchain: BlockchainType, address: string): Promise<boolean>;
+    remove_address(blockchain: BlockchainType, address: string): Promise<boolean>;
+    /**
+     * Add an address to the webhook(s) for a single chain only.
+     * Matches by both name and network to avoid cross-service contamination.
+     * Use this for the immediate await before responding to the caller.
+     */
+    add_address_to_chain(chain_id: ChainId, address: string): Promise<boolean>;
+    /**
+     * Remove an address from the webhook(s) for a single chain only.
+     * Matches by both name and network to avoid cross-service contamination.
+     * Use this for the immediate await before responding to the caller.
+     */
+    remove_address_from_chain(chain_id: ChainId, address: string): Promise<boolean>;
+    /**
+     * Add an address to all webhooks for a blockchain except the already-updated chain.
+     * Excludes by both name and network so only the exact webhooks for that chain are skipped.
+     * Call this fire-and-forget after responding to the caller.
+     */
+    sync_add_to_remaining(blockchain: BlockchainType, address: string, exclude_chain_id: ChainId): Promise<void>;
+    /**
+     * Remove an address from all webhooks for a blockchain except the already-updated chain.
+     * Excludes by both name and network so only the exact webhooks for that chain are skipped.
+     * Call this fire-and-forget after responding to the caller.
+     */
+    sync_remove_from_remaining(blockchain: BlockchainType, address: string, exclude_chain_id: ChainId): Promise<void>;
+}
+export default QnWebhookAddressManager;
+//# sourceMappingURL=QnWebhookAddressManager.d.ts.map

package/build/services/quicknode-notifications/QnWebhookAddressManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QnWebhookAddressManager.d.ts","sourceRoot":"","sources":["../../../src/services/quicknode-notifications/QnWebhookAddressManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,OAAO,EAAiB,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AA0BlE,cAAM,uBAAuB;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IACjD,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,KAAK,CAAmD;IAEhE,OAAO;IAKP,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,kBAAkB,GAAG,uBAAuB;IAOtF,OAAO,CAAC,wBAAwB;IAKhC,yFAAyF;IACzF,OAAO,CAAC,0BAA0B;IAQlC,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,QAAQ;YAMF,IAAI;YAuCJ,aAAa;IAO3B,OAAO,CAAC,WAAW;IAIN,WAAW,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB1E,cAAc,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB1F;;;;OAIG;IACU,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBvF;;;;OAIG;IACU,yBAAyB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuB5F;;;;OAIG;IACU,qBAAqB,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBzH;;;;OAIG;IACU,0BAA0B,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBjI;AAED,eAAe,uBAAuB,CAAC"}

package/build/services/quicknode-notifications/QnWebhookAddressManager.js

@@ -0,0 +1,265 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ChainManager_1 = __importDefault(require("../ChainManager"));
+const QnNotificationsApi_1 = __importDefault(require("./QnNotificationsApi"));
+const CACHE_TTL_MS = 10 * 60 * 1000; // 10 minutes
+class QnWebhookAddressManager {
+    constructor(config, rlc) {
+        this.cache = new Map();
+        this.config = config;
+        this.api = QnNotificationsApi_1.default.getInstance(config, rlc);
+    }
+    static getInstance(config, rlc) {
+        if (!this.instance) {
+            this.instance = new QnWebhookAddressManager(config, rlc);
+        }
+        return this.instance;
+    }
+    get_blockchain_for_chain(chain_id) {
+        var _a, _b;
+        const cfg = (_a = ChainManager_1.default.getInstance(this.config).contractsMap) === null || _a === void 0 ? void 0 : _a[chain_id.toString()];
+        return (_b = cfg === null || cfg === void 0 ? void 0 : cfg.blockchainType) !== null && _b !== void 0 ? _b : null;
+    }
+    /** Returns the { name, network } pairs for the notification configs of a given chain. */
+    get_webhook_keys_for_chain(chain_id) {
+        var _a, _b, _c;
+        const cfg = (_a = ChainManager_1.default.getInstance(this.config).contractsMap) === null || _a === void 0 ? void 0 : _a[chain_id.toString()];
+        return (_c = (_b = cfg === null || cfg === void 0 ? void 0 : cfg.quicknodeNotificationConfig) === null || _b === void 0 ? void 0 : _b.map(n => ({
+            name: n.name.toLowerCase(),
+            network: n.network.toLowerCase(),
+        }))) !== null && _c !== void 0 ? _c : [];
+    }
+    get_notif_configs(blockchain) {
+        const chain_manager = ChainManager_1.default.getInstance(this.config);
+        if (!chain_manager.contractsMap)
+            return [];
+        return Object.entries(chain_manager.contractsMap)
+            .filter(([_, cfg]) => {
+            var _a;
+            return cfg.blockchainType === blockchain &&
+                ((_a = cfg.quicknodeNotificationConfig) === null || _a === void 0 ? void 0 : _a.length) > 0;
+        })
+            .flatMap(([_, cfg]) => cfg.quicknodeNotificationConfig.map(n => (Object.assign(Object.assign({}, n), { blockchain: cfg.blockchainType }))))
+            .filter((n, i, arr) => arr.findIndex(x => x.name === n.name) === i);
+    }
+    is_stale(blockchain) {
+        const cached = this.cache.get(blockchain);
+        if (!cached)
+            return true;
+        return Date.now() - cached.loaded_at > CACHE_TTL_MS;
+    }
+    load(blockchain) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const notif_configs = this.get_notif_configs(blockchain);
+            if (notif_configs.length === 0)
+                return;
+            let all_webhooks = [];
+            try {
+                const res = yield this.api.get_all_webhooks();
+                all_webhooks = res.data || [];
+            }
+            catch (error) {
+                console.error(`QnWebhookAddressManager: Failed to fetch webhooks for blockchain=${blockchain}`, error);
+                return;
+            }
+            const entries = [];
+            for (const notif_config of notif_configs) {
+                const existing = all_webhooks.find(w => {
+                    var _a, _b;
+                    return ((_a = w.name) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === notif_config.name.toLowerCase() &&
+                        ((_b = w.network) === null || _b === void 0 ? void 0 : _b.toLowerCase()) === notif_config.network.toLowerCase();
+                });
+                if (!existing) {
+                    console.warn(`QnWebhookAddressManager: No webhook found for config=${notif_config.name} network=${notif_config.network}`);
+                    continue;
+                }
+                const arg_key = notif_config.template === 'solanaWalletFilter' ? 'accounts' : 'wallets';
+                const addresses = ((_a = existing.templateArgs) === null || _a === void 0 ? void 0 : _a[arg_key]) || [];
+                entries.push({
+                    webhook_id: existing.id,
+                    name: notif_config.name.toLowerCase(),
+                    template: notif_config.template,
+                    network: notif_config.network.toLowerCase(),
+                    address_set: new Set(addresses),
+                });
+            }
+            this.cache.set(blockchain, { entries, loaded_at: Date.now() });
+        });
+    }
+    ensure_loaded(blockchain) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (this.is_stale(blockchain)) {
+                yield this.load(blockchain);
+            }
+            return ((_a = this.cache.get(blockchain)) === null || _a === void 0 ? void 0 : _a.entries) || [];
+        });
+    }
+    matches_key(entry, key) {
+        return entry.name === key.name && entry.network === key.network;
+    }
+    add_address(blockchain, address) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const entries = yield this.ensure_loaded(blockchain);
+            for (const entry of entries) {
+                if (entry.address_set.has(address))
+                    continue;
+                entry.address_set.add(address);
+                try {
+                    yield this.api.update_webhook_addresses(entry.webhook_id, entry.template, Array.from(entry.address_set));
+                    console.log(`QnWebhookAddressManager: Added ${address} to ${entry.name} webhook`);
+                }
+                catch (error) {
+                    entry.address_set.delete(address);
+                    console.error(`QnWebhookAddressManager: Failed to add ${address} to ${entry.name}`, error);
+                    throw error;
+                }
+            }
+            return true;
+        });
+    }
+    remove_address(blockchain, address) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const entries = yield this.ensure_loaded(blockchain);
+            for (const entry of entries) {
+                if (!entry.address_set.has(address))
+                    continue;
+                entry.address_set.delete(address);
+                try {
+                    yield this.api.update_webhook_addresses(entry.webhook_id, entry.template, Array.from(entry.address_set));
+                    console.log(`QnWebhookAddressManager: Removed ${address} from ${entry.name} webhook`);
+                }
+                catch (error) {
+                    entry.address_set.add(address);
+                    console.error(`QnWebhookAddressManager: Failed to remove ${address} from ${entry.name}`, error);
+                    throw error;
+                }
+            }
+            return true;
+        });
+    }
+    /**
+     * Add an address to the webhook(s) for a single chain only.
+     * Matches by both name and network to avoid cross-service contamination.
+     * Use this for the immediate await before responding to the caller.
+     */
+    add_address_to_chain(chain_id, address) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const blockchain = this.get_blockchain_for_chain(chain_id);
+            if (!blockchain)
+                return false;
+            const keys = this.get_webhook_keys_for_chain(chain_id);
+            const entries = (yield this.ensure_loaded(blockchain))
+                .filter(e => keys.some(k => this.matches_key(e, k)));
+            for (const entry of entries) {
+                if (entry.address_set.has(address))
+                    continue;
+                entry.address_set.add(address);
+                try {
+                    yield this.api.update_webhook_addresses(entry.webhook_id, entry.template, Array.from(entry.address_set));
+                    console.log(`QnWebhookAddressManager: Added ${address} to ${entry.name} webhook (chain ${chain_id})`);
+                }
+                catch (error) {
+                    entry.address_set.delete(address);
+                    console.error(`QnWebhookAddressManager: Failed to add ${address} to ${entry.name}`, error);
+                    throw error;
+                }
+            }
+            return true;
+        });
+    }
+    /**
+     * Remove an address from the webhook(s) for a single chain only.
+     * Matches by both name and network to avoid cross-service contamination.
+     * Use this for the immediate await before responding to the caller.
+     */
+    remove_address_from_chain(chain_id, address) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const blockchain = this.get_blockchain_for_chain(chain_id);
+            if (!blockchain)
+                return false;
+            const keys = this.get_webhook_keys_for_chain(chain_id);
+            const entries = (yield this.ensure_loaded(blockchain))
+                .filter(e => keys.some(k => this.matches_key(e, k)));
+            for (const entry of entries) {
+                if (!entry.address_set.has(address))
+                    continue;
+                entry.address_set.delete(address);
+                try {
+                    yield this.api.update_webhook_addresses(entry.webhook_id, entry.template, Array.from(entry.address_set));
+                    console.log(`QnWebhookAddressManager: Removed ${address} from ${entry.name} webhook (chain ${chain_id})`);
+                }
+                catch (error) {
+                    entry.address_set.add(address);
+                    console.error(`QnWebhookAddressManager: Failed to remove ${address} from ${entry.name}`, error);
+                    throw error;
+                }
+            }
+            return true;
+        });
+    }
+    /**
+     * Add an address to all webhooks for a blockchain except the already-updated chain.
+     * Excludes by both name and network so only the exact webhooks for that chain are skipped.
+     * Call this fire-and-forget after responding to the caller.
+     */
+    sync_add_to_remaining(blockchain, address, exclude_chain_id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const exclude_keys = this.get_webhook_keys_for_chain(exclude_chain_id);
+            const entries = (yield this.ensure_loaded(blockchain))
+                .filter(e => !exclude_keys.some(k => this.matches_key(e, k)));
+            for (const entry of entries) {
+                if (entry.address_set.has(address))
+                    continue;
+                entry.address_set.add(address);
+                try {
+                    yield this.api.update_webhook_addresses(entry.webhook_id, entry.template, Array.from(entry.address_set));
+                    console.log(`QnWebhookAddressManager: Synced add ${address} to ${entry.name} webhook`);
+                }
+                catch (error) {
+                    entry.address_set.delete(address);
+                    console.error(`QnWebhookAddressManager: Sync add failed for ${entry.name}`, error);
+                }
+            }
+        });
+    }
+    /**
+     * Remove an address from all webhooks for a blockchain except the already-updated chain.
+     * Excludes by both name and network so only the exact webhooks for that chain are skipped.
+     * Call this fire-and-forget after responding to the caller.
+     */
+    sync_remove_from_remaining(blockchain, address, exclude_chain_id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const exclude_keys = this.get_webhook_keys_for_chain(exclude_chain_id);
+            const entries = (yield this.ensure_loaded(blockchain))
+                .filter(e => !exclude_keys.some(k => this.matches_key(e, k)));
+            for (const entry of entries) {
+                if (!entry.address_set.has(address))
+                    continue;
+                entry.address_set.delete(address);
+                try {
+                    yield this.api.update_webhook_addresses(entry.webhook_id, entry.template, Array.from(entry.address_set));
+                    console.log(`QnWebhookAddressManager: Synced remove ${address} from ${entry.name} webhook`);
+                }
+                catch (error) {
+                    entry.address_set.add(address);
+                    console.error(`QnWebhookAddressManager: Sync remove failed for ${entry.name}`, error);
+                }
+            }
+        });
+    }
+}
+exports.default = QnWebhookAddressManager;

package/build/services/quicknode-notifications/SetupNotifications.d.ts

@@ -0,0 +1,40 @@
+import BaseErrors from "../../errors/errors";
+import { BlockchainType } from "../../interfaces";
+import { IConfig } from "../../interfaces/config";
+import { IDatabasePool } from "../../interfaces/database";
+import { RateLimiterOptions } from "../../utils/AsyncRateLimiter";
+export interface NotificationWebhookEntry {
+    webhook_id: string;
+    template: string;
+    network: string;
+    blockchain: BlockchainType;
+    address_set: Set<string>;
+}
+declare class SetupNotifications extends BaseErrors {
+    private static instance;
+    private api;
+    private webhook_map;
+    private by_blockchain;
+    private pending_configs;
+    private config;
+    private db;
+    private constructor();
+    static getInstance(config: IConfig, db: IDatabasePool, rlc: RateLimiterOptions): SetupNotifications;
+    get_all_webhook_ids(): string[];
+    get_entry_by_webhook_id(id: string): NotificationWebhookEntry | undefined;
+    /**
+     * Fetch all deposit addresses for a blockchain from the DB (paginated).
+     * The `blockchain` filter value in DepositAddressService is the string stored
+     * in the DB — e.g. "solana", "evm", "ethereum", etc.
+     */
+    private fetch_all_db_addresses;
+    /**
+     * Register a newly-created webhook entry in the internal maps.
+     */
+    private register_entry;
+    initialize(): Promise<void>;
+    add_address(blockchain: BlockchainType, address: string): Promise<void>;
+    remove_address(blockchain: BlockchainType, address: string): Promise<void>;
+}
+export default SetupNotifications;
+//# sourceMappingURL=SetupNotifications.d.ts.map

package/build/services/quicknode-notifications/SetupNotifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SetupNotifications.d.ts","sourceRoot":"","sources":["../../../src/services/quicknode-notifications/SetupNotifications.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAiB,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAQlE,MAAM,WAAW,wBAAwB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,cAAc,CAAC;IAC3B,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B;AAWD,cAAM,kBAAmB,SAAQ,UAAU;IACvC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqB;IAC5C,OAAO,CAAC,GAAG,CAAqB;IAEhC,OAAO,CAAC,WAAW,CAAoD;IAEvE,OAAO,CAAC,aAAa,CAA8D;IAEnF,OAAO,CAAC,eAAe,CAAqD;IAC5E,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO;IAOP,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,kBAAkB,GAAG,kBAAkB;IAO5F,mBAAmB,IAAI,MAAM,EAAE;IAI/B,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS;IAOhF;;;;OAIG;YACW,sBAAsB;IAuBpC;;OAEG;IACH,OAAO,CAAC,cAAc;IAOT,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAwH3B,WAAW,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyDvE,cAAc,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAe1F;AAED,eAAe,kBAAkB,CAAC"}