envoy-pay 0.1.0

package/dist/cjs/monitor/evm-watcher.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEvmWatcher = createEvmWatcher;
+const logger_1 = require("../logger");
+/**
+ * ERC-20 Transfer event topic hash.
+ * keccak256('Transfer(address,address,uint256)')
+ */
+const TRANSFER_TOPIC = '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef';
+/**
+ * Creates an EVM payment watcher using JSON-RPC polling.
+ *
+ * Monitors:
+ * 1. ERC-20 Transfer events TO the target address (USDC)
+ * 2. Native ETH transfers TO the target address (via block scanning)
+ *
+ * @returns Unsubscribe function to stop watching.
+ */
+function createEvmWatcher(config) {
+    const log = config.logger ?? logger_1.noopLogger;
+    const pollInterval = config.pollIntervalMs ?? 12000;
+    const chainName = config.chainName ?? 'EVM';
+    const chainId = config.chainId ?? 'eip155:1';
+    let running = true;
+    let lastBlock = 0;
+    let timer = null;
+    async function rpcCall(method, params) {
+        const response = await fetch(config.rpcUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ jsonrpc: '2.0', id: 1, method, params }),
+        });
+        const json = await response.json();
+        if (json.error)
+            throw new Error(`RPC error: ${json.error.message}`);
+        return json.result;
+    }
+    async function getLatestBlock() {
+        const hex = await rpcCall('eth_blockNumber', []);
+        return parseInt(hex, 16);
+    }
+    async function getErc20Transfers(fromBlock, toBlock) {
+        if (!config.usdcContractAddress)
+            return [];
+        const paddedAddress = '0x' + config.address.slice(2).toLowerCase().padStart(64, '0');
+        const logs = await rpcCall('eth_getLogs', [{
+                fromBlock: '0x' + fromBlock.toString(16),
+                toBlock: '0x' + toBlock.toString(16),
+                address: config.usdcContractAddress,
+                topics: [TRANSFER_TOPIC, null, paddedAddress],
+            }]);
+        if (!Array.isArray(logs))
+            return [];
+        return logs.map((logEntry) => {
+            const amount = BigInt(logEntry.data).toString();
+            const from = '0x' + logEntry.topics[1].slice(26);
+            return {
+                amount,
+                amountFormatted: formatUsdc(amount),
+                asset: 'USDC',
+                from,
+                transactionHash: logEntry.transactionHash,
+                chain: chainName,
+                caip2Id: chainId,
+                timestamp: new Date(),
+                confirmations: 1,
+            };
+        });
+    }
+    async function getNativeTransfers(fromBlock, toBlock) {
+        const payments = [];
+        const targetLower = config.address.toLowerCase();
+        for (let blockNum = fromBlock; blockNum <= toBlock; blockNum++) {
+            try {
+                const block = await rpcCall('eth_getBlockByNumber', ['0x' + blockNum.toString(16), true]);
+                if (!block?.transactions)
+                    continue;
+                for (const tx of block.transactions) {
+                    if (tx.to?.toLowerCase() === targetLower &&
+                        tx.value && tx.value !== '0x0' && tx.value !== '0x') {
+                        const amount = BigInt(tx.value).toString();
+                        payments.push({
+                            amount,
+                            amountFormatted: formatEth(amount),
+                            asset: 'ETH',
+                            from: tx.from,
+                            transactionHash: tx.hash,
+                            chain: chainName,
+                            caip2Id: chainId,
+                            timestamp: new Date(parseInt(block.timestamp, 16) * 1000),
+                            confirmations: 1,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                log(`[evm-watcher] ⚠️ Error scanning block ${blockNum}: ${err.message}`);
+            }
+        }
+        return payments;
+    }
+    async function poll() {
+        if (!running)
+            return;
+        try {
+            const currentBlock = await getLatestBlock();
+            if (lastBlock === 0) {
+                lastBlock = currentBlock;
+                log(`[evm-watcher] 🔍 Started watching from block ${currentBlock} on ${chainName}`);
+                schedulePoll();
+                return;
+            }
+            if (currentBlock <= lastBlock) {
+                schedulePoll();
+                return;
+            }
+            const fromBlock = lastBlock + 1;
+            const toBlock = currentBlock;
+            log(`[evm-watcher] 📦 Scanning blocks ${fromBlock}–${toBlock} on ${chainName}`);
+            // Scan for ERC-20 and native transfers in parallel
+            const [erc20Payments, nativePayments] = await Promise.all([
+                getErc20Transfers(fromBlock, toBlock),
+                getNativeTransfers(fromBlock, toBlock),
+            ]);
+            const allPayments = [...erc20Payments, ...nativePayments];
+            for (const payment of allPayments) {
+                log(`[evm-watcher] 💰 Incoming: ${payment.amountFormatted} ${payment.asset} from ${payment.from.slice(0, 10)}…`);
+                config.onPayment(payment);
+            }
+            lastBlock = toBlock;
+        }
+        catch (err) {
+            log(`[evm-watcher] ❌ Poll error: ${err.message}`);
+            config.onError?.(err);
+        }
+        schedulePoll();
+    }
+    function schedulePoll() {
+        if (running && pollInterval > 0) {
+            timer = setTimeout(poll, pollInterval);
+        }
+    }
+    // Start polling
+    poll();
+    // Return unsubscribe function
+    return () => {
+        running = false;
+        if (timer)
+            clearTimeout(timer);
+        log(`[evm-watcher] 🛑 Stopped watching on ${chainName}`);
+    };
+}
+function formatUsdc(atomicAmount) {
+    const n = BigInt(atomicAmount);
+    const whole = n / 1000000n;
+    const frac = (n % 1000000n).toString().padStart(6, '0');
+    return `${whole}.${frac}`;
+}
+function formatEth(weiAmount) {
+    const n = BigInt(weiAmount);
+    const whole = n / 10n ** 18n;
+    const frac = ((n % 10n ** 18n) / 10n ** 12n).toString().padStart(6, '0');
+    return `${whole}.${frac}`;
+}
+//# sourceMappingURL=evm-watcher.js.map

package/dist/cjs/monitor/evm-watcher.js.map

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

package/dist/cjs/monitor/index.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMultiChainWatcher = exports.createSolanaWatcher = exports.createStellarWatcher = exports.createEvmWatcher = void 0;
+/**
+ * envoy — Real-Time Payment Monitoring
+ *
+ * Chain-specific watchers that detect incoming payments
+ * and invoke callbacks in real-time.
+ *
+ * @example
+ * ```ts
+ * import { createEvmWatcher, createStellarWatcher } from 'envoy-pay/monitor';
+ *
+ * const unsub = createEvmWatcher({
+ *   address: '0xYOUR_WALLET',
+ *   rpcUrl: 'https://mainnet.base.org',
+ *   onPayment: (event) => console.log('Received:', event),
+ * });
+ *
+ * // Stop watching
+ * unsub();
+ * ```
+ */
+var evm_watcher_1 = require("./evm-watcher");
+Object.defineProperty(exports, "createEvmWatcher", { enumerable: true, get: function () { return evm_watcher_1.createEvmWatcher; } });
+var stellar_watcher_1 = require("./stellar-watcher");
+Object.defineProperty(exports, "createStellarWatcher", { enumerable: true, get: function () { return stellar_watcher_1.createStellarWatcher; } });
+var solana_watcher_1 = require("./solana-watcher");
+Object.defineProperty(exports, "createSolanaWatcher", { enumerable: true, get: function () { return solana_watcher_1.createSolanaWatcher; } });
+var multi_watcher_1 = require("./multi-watcher");
+Object.defineProperty(exports, "createMultiChainWatcher", { enumerable: true, get: function () { return multi_watcher_1.createMultiChainWatcher; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/monitor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/monitor/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,6CAAwE;AAA/D,+GAAA,gBAAgB,OAAA;AACzB,qDAAoF;AAA3E,uHAAA,oBAAoB,OAAA;AAC7B,mDAAiF;AAAxE,qHAAA,mBAAmB,OAAA;AAC5B,iDAAwF;AAA/E,wHAAA,uBAAuB,OAAA"}

package/dist/cjs/monitor/multi-watcher.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMultiChainWatcher = createMultiChainWatcher;
+const evm_watcher_1 = require("./evm-watcher");
+const stellar_watcher_1 = require("./stellar-watcher");
+const solana_watcher_1 = require("./solana-watcher");
+const logger_1 = require("../logger");
+/**
+ * Creates a multi-chain payment watcher.
+ *
+ * @returns Unsubscribe function that stops ALL chain watchers.
+ *
+ * @example
+ * ```ts
+ * const unsub = createMultiChainWatcher({
+ *   evm: [
+ *     { address: '0x...', rpcUrl: 'https://mainnet.base.org', chainName: 'Base', usdcContractAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' },
+ *     { address: '0x...', rpcUrl: 'https://arb1.arbitrum.io/rpc', chainName: 'Arbitrum' },
+ *   ],
+ *   stellar: { accountId: 'GABCD...' },
+ *   solana: { address: '7abc...' },
+ *   onPayment: (event) => console.log(`${event.chain}: ${event.amountFormatted} ${event.asset}`),
+ * });
+ *
+ * // Stop all watchers
+ * unsub();
+ * ```
+ */
+function createMultiChainWatcher(config) {
+    const log = config.logger ?? logger_1.noopLogger;
+    const unsubscribers = [];
+    log('[multi-watcher] 🌐 Starting multi-chain payment monitor…');
+    // Start EVM watchers
+    if (config.evm) {
+        for (const evmConfig of config.evm) {
+            const unsub = (0, evm_watcher_1.createEvmWatcher)({
+                ...evmConfig,
+                onPayment: (event) => {
+                    config.onPayment(event);
+                    evmConfig.onPayment?.(event);
+                },
+                onError: (err) => {
+                    config.onError?.(err);
+                    evmConfig.onError?.(err);
+                },
+                logger: evmConfig.logger ?? log,
+            });
+            unsubscribers.push(unsub);
+        }
+        log(`[multi-watcher] ⛓️ ${config.evm.length} EVM chain(s) active`);
+    }
+    // Start Stellar watcher
+    if (config.stellar) {
+        const unsub = (0, stellar_watcher_1.createStellarWatcher)({
+            ...config.stellar,
+            onPayment: (event) => {
+                config.onPayment(event);
+                config.stellar.onPayment?.(event);
+            },
+            onError: (err) => {
+                config.onError?.(err);
+                config.stellar.onError?.(err);
+            },
+            logger: config.stellar.logger ?? log,
+        });
+        unsubscribers.push(unsub);
+        log('[multi-watcher] ⭐ Stellar watcher active');
+    }
+    // Start Solana watcher
+    if (config.solana) {
+        const unsub = (0, solana_watcher_1.createSolanaWatcher)({
+            ...config.solana,
+            onPayment: (event) => {
+                config.onPayment(event);
+                config.solana.onPayment?.(event);
+            },
+            onError: (err) => {
+                config.onError?.(err);
+                config.solana.onError?.(err);
+            },
+            logger: config.solana.logger ?? log,
+        });
+        unsubscribers.push(unsub);
+        log('[multi-watcher] ◎ Solana watcher active');
+    }
+    log(`[multi-watcher] ✅ ${unsubscribers.length} watcher(s) running`);
+    return () => {
+        for (const unsub of unsubscribers) {
+            unsub();
+        }
+        log('[multi-watcher] 🛑 All watchers stopped');
+    };
+}
+//# sourceMappingURL=multi-watcher.js.map

package/dist/cjs/monitor/multi-watcher.js.map

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

package/dist/cjs/monitor/solana-watcher.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSolanaWatcher = createSolanaWatcher;
+const logger_1 = require("../logger");
+/** Mainnet USDC mint address. */
+const USDC_MINT = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
+/**
+ * Creates a Solana payment watcher using JSON-RPC polling.
+ *
+ * Polls `getSignaturesForAddress` for new transactions, then
+ * inspects each transaction to detect:
+ * 1. Native SOL transfers TO the target address
+ * 2. SPL USDC transfers TO the target's Associated Token Account
+ *
+ * @returns Unsubscribe function to stop watching.
+ */
+function createSolanaWatcher(config) {
+    const log = config.logger ?? logger_1.noopLogger;
+    const rpcUrl = config.rpcUrl ?? 'https://api.mainnet-beta.solana.com';
+    const pollInterval = config.pollIntervalMs ?? 5000;
+    const usdcMint = config.usdcMint ?? USDC_MINT;
+    let running = true;
+    let lastSignature = null;
+    let timer = null;
+    async function rpcCall(method, params) {
+        const response = await fetch(rpcUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ jsonrpc: '2.0', id: 1, method, params }),
+        });
+        const json = await response.json();
+        if (json.error)
+            throw new Error(`Solana RPC error: ${json.error.message}`);
+        return json.result;
+    }
+    async function getNewSignatures() {
+        const params = [
+            config.address,
+            { limit: 20, ...(lastSignature ? { until: lastSignature } : {}) },
+        ];
+        const result = await rpcCall('getSignaturesForAddress', params);
+        if (!Array.isArray(result) || result.length === 0)
+            return [];
+        // Return newest first
+        return result
+            .filter((r) => r.confirmationStatus === 'confirmed' || r.confirmationStatus === 'finalized')
+            .map((r) => r.signature);
+    }
+    async function inspectTransaction(signature) {
+        try {
+            const tx = await rpcCall('getTransaction', [signature, { encoding: 'jsonParsed', maxSupportedTransactionVersion: 0 }]);
+            if (!tx?.meta || tx.meta.err)
+                return null;
+            const targetLower = config.address;
+            // Check parsed instructions for SOL transfers and SPL token transfers
+            const instructions = tx.transaction?.message?.instructions || [];
+            const innerInstructions = tx.meta?.innerInstructions || [];
+            const allInstructions = [
+                ...instructions,
+                ...innerInstructions.flatMap((inner) => inner.instructions || []),
+            ];
+            for (const ix of allInstructions) {
+                const parsed = ix.parsed;
+                if (!parsed)
+                    continue;
+                // Native SOL transfer
+                if (parsed.type === 'transfer' && ix.program === 'system') {
+                    if (parsed.info?.destination === targetLower) {
+                        const lamports = parsed.info.lamports.toString();
+                        return {
+                            amount: lamports,
+                            amountFormatted: formatSol(lamports),
+                            asset: 'SOL',
+                            from: parsed.info.source || 'unknown',
+                            transactionHash: signature,
+                            chain: 'Solana',
+                            caip2Id: 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',
+                            timestamp: new Date((tx.blockTime || Date.now() / 1000) * 1000),
+                            confirmations: 1,
+                        };
+                    }
+                }
+                // SPL Token transfer (including USDC)
+                if ((parsed.type === 'transfer' || parsed.type === 'transferChecked') &&
+                    ix.program === 'spl-token') {
+                    const info = parsed.info;
+                    // Check if this is USDC (by mint address in transferChecked)
+                    const isUsdc = info?.mint === usdcMint;
+                    const amount = info?.amount || info?.tokenAmount?.amount;
+                    if (amount && info?.destination) {
+                        // We need to check if the destination ATA belongs to our address
+                        // For simplicity, we check pre/post token balances
+                        return {
+                            amount: amount.toString(),
+                            amountFormatted: isUsdc ? formatUsdc(amount.toString()) : amount.toString(),
+                            asset: isUsdc ? 'USDC' : 'SPL',
+                            from: info.source || info.authority || 'unknown',
+                            transactionHash: signature,
+                            chain: 'Solana',
+                            caip2Id: 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',
+                            timestamp: new Date((tx.blockTime || Date.now() / 1000) * 1000),
+                            confirmations: 1,
+                        };
+                    }
+                }
+            }
+            return null;
+        }
+        catch (err) {
+            log(`[solana-watcher] ⚠️ Failed to inspect tx ${signature.slice(0, 16)}…: ${err.message}`);
+            return null;
+        }
+    }
+    async function poll() {
+        if (!running)
+            return;
+        try {
+            const signatures = await getNewSignatures();
+            if (signatures.length > 0 && !lastSignature) {
+                // First poll — just record the latest signature
+                lastSignature = signatures[0];
+                log(`[solana-watcher] 🔍 Started watching from signature ${lastSignature.slice(0, 16)}… on Solana`);
+                schedulePoll();
+                return;
+            }
+            if (signatures.length === 0) {
+                schedulePoll();
+                return;
+            }
+            log(`[solana-watcher] 📦 Processing ${signatures.length} new transactions`);
+            for (const sig of signatures.reverse()) { // Oldest first
+                const payment = await inspectTransaction(sig);
+                if (payment) {
+                    log(`[solana-watcher] 💰 Incoming: ${payment.amountFormatted} ${payment.asset} from ${payment.from.slice(0, 10)}…`);
+                    config.onPayment(payment);
+                }
+            }
+            lastSignature = signatures[0]; // Most recent
+        }
+        catch (err) {
+            log(`[solana-watcher] ❌ Poll error: ${err.message}`);
+            config.onError?.(err);
+        }
+        schedulePoll();
+    }
+    function schedulePoll() {
+        if (running && pollInterval > 0) {
+            timer = setTimeout(poll, pollInterval);
+        }
+    }
+    // Start polling
+    poll();
+    return () => {
+        running = false;
+        if (timer)
+            clearTimeout(timer);
+        log(`[solana-watcher] 🛑 Stopped watching on Solana`);
+    };
+}
+function formatSol(lamports) {
+    const n = BigInt(lamports);
+    const whole = n / 1000000000n;
+    const frac = ((n % 1000000000n) / 1000n).toString().padStart(6, '0');
+    return `${whole}.${frac}`;
+}
+function formatUsdc(atomicAmount) {
+    const n = BigInt(atomicAmount);
+    const whole = n / 1000000n;
+    const frac = (n % 1000000n).toString().padStart(6, '0');
+    return `${whole}.${frac}`;
+}
+//# sourceMappingURL=solana-watcher.js.map

package/dist/cjs/monitor/solana-watcher.js.map

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

package/dist/cjs/monitor/stellar-watcher.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStellarWatcher = createStellarWatcher;
+const logger_1 = require("../logger");
+/**
+ * Creates a Stellar payment watcher using Horizon SSE streaming.
+ *
+ * Listens for `payment` and `create_account` operations directed
+ * to the target account. Supports asset-based filtering.
+ *
+ * @returns Unsubscribe function to stop watching.
+ */
+function createStellarWatcher(config) {
+    const log = config.logger ?? logger_1.noopLogger;
+    const horizonUrl = config.horizonUrl ?? 'https://horizon.stellar.org';
+    const assetFilter = config.asset ?? 'all';
+    const cursor = config.cursor ?? 'now';
+    let abortController = null;
+    let running = true;
+    let reconnectTimer = null;
+    async function startStream() {
+        if (!running)
+            return;
+        const url = `${horizonUrl}/accounts/${config.accountId}/payments?cursor=${cursor}&order=asc`;
+        log(`[stellar-watcher] 🔍 Connecting to Horizon SSE: ${config.accountId.slice(0, 10)}…`);
+        abortController = new AbortController();
+        try {
+            const response = await fetch(url, {
+                headers: { Accept: 'text/event-stream' },
+                signal: abortController.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`Horizon HTTP ${response.status}: ${response.statusText}`);
+            }
+            if (!response.body) {
+                throw new Error('No response body for SSE stream');
+            }
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = '';
+            log(`[stellar-watcher] ✅ SSE connected, watching for payments…`);
+            while (running) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                // Parse SSE events
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || '';
+                let currentData = '';
+                for (const line of lines) {
+                    if (line.startsWith('data: ')) {
+                        currentData += line.slice(6);
+                    }
+                    else if (line === '' && currentData) {
+                        // End of event — process
+                        if (currentData !== '"hello"' && currentData !== 'hello') {
+                            processEvent(currentData);
+                        }
+                        currentData = '';
+                    }
+                }
+            }
+        }
+        catch (err) {
+            if (err.name === 'AbortError') {
+                log('[stellar-watcher] 🛑 Stream aborted');
+                return;
+            }
+            log(`[stellar-watcher] ❌ Stream error: ${err.message}`);
+            config.onError?.(err);
+            // Reconnect after 5s
+            if (running) {
+                log('[stellar-watcher] 🔄 Reconnecting in 5s…');
+                reconnectTimer = setTimeout(startStream, 5000);
+            }
+        }
+    }
+    function processEvent(data) {
+        try {
+            const record = JSON.parse(data);
+            // Only process payments TO this account
+            if (record.to !== config.accountId)
+                return;
+            // Only process payment operations
+            if (record.type !== 'payment' && record.type !== 'create_account')
+                return;
+            // Determine asset
+            const asset = record.asset_type === 'native'
+                ? 'XLM'
+                : record.asset_code || 'unknown';
+            // Apply asset filter
+            if (assetFilter !== 'all' && asset !== assetFilter)
+                return;
+            // Convert amount to atomic units (stroops = amount * 10^7)
+            const atomicAmount = Math.round(parseFloat(record.amount) * 10_000_000).toString();
+            const payment = {
+                amount: atomicAmount,
+                amountFormatted: record.amount,
+                asset,
+                from: record.from,
+                transactionHash: record.transaction_hash,
+                chain: 'Stellar',
+                caip2Id: 'stellar:pubnet',
+                timestamp: new Date(record.created_at),
+            };
+            log(`[stellar-watcher] 💰 Incoming: ${record.amount} ${asset} from ${record.from.slice(0, 10)}…`);
+            config.onPayment(payment);
+        }
+        catch (err) {
+            log(`[stellar-watcher] ⚠️ Failed to parse event: ${err.message}`);
+        }
+    }
+    // Start the stream
+    startStream();
+    // Return unsubscribe
+    return () => {
+        running = false;
+        abortController?.abort();
+        if (reconnectTimer)
+            clearTimeout(reconnectTimer);
+        log(`[stellar-watcher] 🛑 Stopped watching ${config.accountId.slice(0, 10)}…`);
+    };
+}
+//# sourceMappingURL=stellar-watcher.js.map

package/dist/cjs/monitor/stellar-watcher.js.map

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