@wopr-network/crypto-plugins 1.0.1

package/dist/evm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/evm/types.ts"],"names":[],"mappings":"AA6CA,oCAAoC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAgC;IAC1D,IAAI,EAAE;QACL,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,qBAAqB;QAC7B,aAAa,EAAE,CAAC;QAChB,WAAW,EAAE,IAAI;QACjB,OAAO,EAAE,IAAI;KACb;IACD,QAAQ,EAAE;QACT,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,kBAAkB;QAC1B,aAAa,EAAE,EAAE;QACjB,WAAW,EAAE,KAAK;QAClB,OAAO,EAAE,CAAC;KACV;IACD,QAAQ,EAAE;QACT,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,mBAAmB;QAC3B,aAAa,EAAE,CAAC;QAChB,WAAW,EAAE,GAAG;QAChB,OAAO,EAAE,KAAK;KACd;IACD,OAAO,EAAE;QACR,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,iBAAiB;QACzB,aAAa,EAAE,EAAE;QACjB,WAAW,EAAE,IAAI;QACjB,OAAO,EAAE,GAAG;KACZ;CACD,CAAC;AAEF,wCAAwC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAgC;IAC1D,WAAW,EAAE;QACZ,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,MAAM;QACb,eAAe,EAAE,4CAA4C;QAC7D,QAAQ,EAAE,CAAC;KACX;IACD,WAAW,EAAE;QACZ,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,MAAM;QACb,eAAe,EAAE,4CAA4C;QAC7D,QAAQ,EAAE,CAAC;KACX;IACD,UAAU,EAAE;QACX,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,MAAM;QACb,eAAe,EAAE,4CAA4C;QAC7D,QAAQ,EAAE,EAAE;KACZ;IACD,eAAe,EAAE;QAChB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,UAAU;QACjB,eAAe,EAAE,4CAA4C;QAC7D,QAAQ,EAAE,CAAC;KACX;IACD,eAAe,EAAE;QAChB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,UAAU;QACjB,eAAe,EAAE,4CAA4C;QAC7D,QAAQ,EAAE,CAAC;KACX;IACD,cAAc,EAAE;QACf,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,UAAU;QACjB,eAAe,EAAE,4CAA4C;QAC7D,QAAQ,EAAE,EAAE;KACZ;IACD,eAAe,EAAE;QAChB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,UAAU;QACjB,eAAe,EAAE,4CAA4C;QAC7D,QAAQ,EAAE,CAAC;KACX;IACD,eAAe,EAAE;QAChB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,UAAU;QACjB,eAAe,EAAE,4CAA4C;QAC7D,QAAQ,EAAE,CAAC;KACX;IACD,cAAc,EAAE;QACf,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,UAAU;QACjB,eAAe,EAAE,4CAA4C;QAC7D,QAAQ,EAAE,EAAE;KACZ;IACD,cAAc,EAAE;QACf,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,SAAS;QAChB,eAAe,EAAE,4CAA4C;QAC7D,QAAQ,EAAE,CAAC;KACX;IACD,cAAc,EAAE;QACf,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,SAAS;QAChB,eAAe,EAAE,4CAA4C;QAC7D,QAAQ,EAAE,CAAC;KACX;CACD,CAAC"}

package/dist/evm/watcher.d.ts

@@ -0,0 +1,42 @@
+import type { IChainWatcher, PaymentEvent, WatcherOpts } from "@wopr-network/platform-core/crypto-plugin";
+import type { RpcCall } from "./types.js";
+/** Create an RPC caller for a given URL (plain JSON-RPC over fetch). */
+export declare function createRpcCaller(rpcUrl: string, extraHeaders?: Record<string, string>): RpcCall;
+/**
+ * ERC-20 Transfer log scanner.
+ *
+ * Scans from cursor to latest block for Transfer events matching watched
+ * deposit addresses. Emits events with current confirmation count. Re-emits
+ * on each confirmation increment. Only advances cursor past fully-confirmed blocks.
+ */
+export declare class EvmWatcher implements IChainWatcher {
+    private _cursor;
+    private _stopped;
+    private readonly chain;
+    private readonly token;
+    private readonly rpc;
+    private readonly confirmations;
+    private readonly contractAddress;
+    private readonly decimals;
+    private readonly cursorStore;
+    private readonly watcherId;
+    private _watchedAddresses;
+    constructor(opts: WatcherOpts);
+    init(): Promise<void>;
+    setWatchedAddresses(addresses: string[]): void;
+    getCursor(): number;
+    stop(): void;
+    /**
+     * Poll for ERC-20 Transfer events, including pending (unconfirmed) blocks.
+     *
+     * Two-phase scan:
+     *   1. Scan cursor..latest for new/updated txs, emit with current confirmation count
+     *   2. Re-check pending txs automatically since cursor doesn't advance past unconfirmed blocks
+     *
+     * Cursor only advances past fully-confirmed blocks.
+     *
+     * Returns PaymentEvent[] instead of using callbacks.
+     */
+    poll(): Promise<PaymentEvent[]>;
+}
+//# sourceMappingURL=watcher.d.ts.map

package/dist/evm/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/evm/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EAEb,YAAY,EACZ,WAAW,EACX,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAU,MAAM,YAAY,CAAC;AAIlD,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAqB9F;AAUD;;;;;;GAMG;AACH,qBAAa,UAAW,YAAW,aAAa;IAC/C,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAU;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,iBAAiB,CAAW;gBAExB,IAAI,EAAE,WAAW;IAavB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAI9C,SAAS,IAAI,MAAM;IAInB,IAAI,IAAI,IAAI;IAIZ;;;;;;;;;;OAUG;IACG,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;CAqFrC"}

package/dist/evm/watcher.js

@@ -0,0 +1,162 @@
+const TRANSFER_TOPIC = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";
+/** Create an RPC caller for a given URL (plain JSON-RPC over fetch). */
+export function createRpcCaller(rpcUrl, extraHeaders) {
+    let id = 0;
+    const headers = { "Content-Type": "application/json", ...extraHeaders };
+    return async (method, params) => {
+        const res = await fetch(rpcUrl, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({ jsonrpc: "2.0", id: ++id, method, params }),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            const hasApiKey = "TRON-PRO-API-KEY" in headers;
+            console.error(`[rpc] ${method} ${res.status} auth=${hasApiKey} url=${rpcUrl.replace(/apikey=[^&]+/, "apikey=***")} body=${body.slice(0, 200)}`);
+            throw new Error(`RPC ${method} failed: ${res.status}`);
+        }
+        const data = (await res.json());
+        if (data.error)
+            throw new Error(`RPC ${method} error: ${data.error.message}`);
+        return data.result;
+    };
+}
+/**
+ * Convert token raw amount (BigInt) to USD cents (integer).
+ * Stablecoins are 1:1 USD. Truncates fractional cents.
+ */
+function centsFromTokenAmount(rawAmount, decimals) {
+    return Number((rawAmount * 100n) / 10n ** BigInt(decimals));
+}
+/**
+ * ERC-20 Transfer log scanner.
+ *
+ * Scans from cursor to latest block for Transfer events matching watched
+ * deposit addresses. Emits events with current confirmation count. Re-emits
+ * on each confirmation increment. Only advances cursor past fully-confirmed blocks.
+ */
+export class EvmWatcher {
+    _cursor = 0;
+    _stopped = false;
+    chain;
+    token;
+    rpc;
+    confirmations;
+    contractAddress;
+    decimals;
+    cursorStore;
+    watcherId;
+    _watchedAddresses;
+    constructor(opts) {
+        this.chain = opts.chain;
+        this.token = opts.token;
+        this.rpc = createRpcCaller(opts.rpcUrl, opts.rpcHeaders);
+        this._cursor = 0;
+        this.confirmations = opts.confirmations;
+        this.contractAddress = (opts.contractAddress ?? "").toLowerCase();
+        this.decimals = opts.decimals;
+        this.cursorStore = opts.cursorStore;
+        this.watcherId = `evm:${opts.chain}:${opts.token}`;
+        this._watchedAddresses = [];
+    }
+    async init() {
+        const saved = await this.cursorStore.get(this.watcherId);
+        if (saved !== null)
+            this._cursor = saved;
+    }
+    setWatchedAddresses(addresses) {
+        this._watchedAddresses = addresses.map((a) => a.toLowerCase());
+    }
+    getCursor() {
+        return this._cursor;
+    }
+    stop() {
+        this._stopped = true;
+    }
+    /**
+     * Poll for ERC-20 Transfer events, including pending (unconfirmed) blocks.
+     *
+     * Two-phase scan:
+     *   1. Scan cursor..latest for new/updated txs, emit with current confirmation count
+     *   2. Re-check pending txs automatically since cursor doesn't advance past unconfirmed blocks
+     *
+     * Cursor only advances past fully-confirmed blocks.
+     *
+     * Returns PaymentEvent[] instead of using callbacks.
+     */
+    async poll() {
+        if (this._stopped || this._watchedAddresses.length === 0)
+            return [];
+        const latestHex = (await this.rpc("eth_blockNumber", []));
+        const latest = Number.parseInt(latestHex, 16);
+        const confirmed = latest - this.confirmations;
+        if (latest < this._cursor)
+            return [];
+        // Filter by topic[2] (to address) when watched addresses are set.
+        const toFilter = this._watchedAddresses.length > 0
+            ? this._watchedAddresses.map((a) => `0x000000000000000000000000${a.slice(2)}`)
+            : null;
+        // Scan from cursor to latest (not just confirmed) to detect pending txs
+        const logs = (await this.rpc("eth_getLogs", [
+            {
+                address: this.contractAddress,
+                topics: [TRANSFER_TOPIC, null, toFilter],
+                fromBlock: `0x${this._cursor.toString(16)}`,
+                toBlock: `0x${latest.toString(16)}`,
+            },
+        ]));
+        // Group logs by block
+        const logsByBlock = new Map();
+        for (const log of logs) {
+            const bn = Number.parseInt(log.blockNumber, 16);
+            const arr = logsByBlock.get(bn);
+            if (arr)
+                arr.push(log);
+            else
+                logsByBlock.set(bn, [log]);
+        }
+        const events = [];
+        // Process all blocks (including unconfirmed), emit with confirmation count
+        const blockNums = [...logsByBlock.keys()].sort((a, b) => a - b);
+        for (const blockNum of blockNums) {
+            const confs = latest - blockNum;
+            for (const log of logsByBlock.get(blockNum) ?? []) {
+                const txKey = `${log.transactionHash}:${log.logIndex}`;
+                // Skip if we already emitted at this confirmation count
+                const lastConf = await this.cursorStore.getConfirmationCount(this.watcherId, txKey);
+                if (lastConf !== null && confs <= lastConf)
+                    continue;
+                const to = `0x${log.topics[2].slice(26)}`.toLowerCase();
+                const from = `0x${log.topics[1].slice(26)}`.toLowerCase();
+                const rawAmount = BigInt(log.data);
+                const amountUsdCents = centsFromTokenAmount(rawAmount, this.decimals);
+                events.push({
+                    chain: this.chain,
+                    token: this.token,
+                    from,
+                    to,
+                    rawAmount: rawAmount.toString(),
+                    amountUsdCents,
+                    txHash: log.transactionHash,
+                    blockNumber: blockNum,
+                    confirmations: confs,
+                    confirmationsRequired: this.confirmations,
+                });
+                // Track confirmation count
+                await this.cursorStore.saveConfirmationCount(this.watcherId, txKey, confs);
+            }
+            // Only advance cursor past fully-confirmed blocks
+            if (blockNum <= confirmed) {
+                this._cursor = blockNum + 1;
+                await this.cursorStore.save(this.watcherId, this._cursor);
+            }
+        }
+        // Advance cursor if no logs found but confirmed blocks exist
+        if (blockNums.length === 0 && confirmed >= this._cursor) {
+            this._cursor = confirmed + 1;
+            await this.cursorStore.save(this.watcherId, this._cursor);
+        }
+        return events;
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/evm/watcher.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { bitcoinPlugin } from "./bitcoin/index.js";
+export { dogecoinPlugin, encodeP2pkhAddress, p2pkhEncoder } from "./dogecoin/index.js";
+export { evmPlugin } from "./evm/index.js";
+export { bech32Encoder as ltcBech32Encoder, litecoinPlugin } from "./litecoin/index.js";
+export { base58Encode, createSolanaRpcCaller, SolanaAddressEncoder, SolanaSweeper, SolanaWatcher, solanaPlugin, } from "./solana/index.js";
+export { encodeKeccakB58Address, hexToTron, isTronAddress, keccakB58Encoder, TronEvmWatcher, tronPlugin, tronToHex, } from "./tron/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EACN,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,YAAY,GACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,sBAAsB,EACtB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,SAAS,GACT,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { bitcoinPlugin } from "./bitcoin/index.js";
+export { dogecoinPlugin, encodeP2pkhAddress, p2pkhEncoder } from "./dogecoin/index.js";
+export { evmPlugin } from "./evm/index.js";
+export { bech32Encoder as ltcBech32Encoder, litecoinPlugin } from "./litecoin/index.js";
+export { base58Encode, createSolanaRpcCaller, SolanaAddressEncoder, SolanaSweeper, SolanaWatcher, solanaPlugin, } from "./solana/index.js";
+export { encodeKeccakB58Address, hexToTron, isTronAddress, keccakB58Encoder, TronEvmWatcher, tronPlugin, tronToHex, } from "./tron/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EACN,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,YAAY,GACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,sBAAsB,EACtB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,SAAS,GACT,MAAM,iBAAiB,CAAC"}

package/dist/litecoin/encoder.d.ts

@@ -0,0 +1,8 @@
+import type { IAddressEncoder } from "@wopr-network/platform-core/crypto-plugin";
+/**
+ * Litecoin bech32 address encoder.
+ * Implements IAddressEncoder for the litecoin plugin.
+ * Default HRP is "ltc" (mainnet). Override with params.hrp for testnet ("tltc").
+ */
+export declare const bech32Encoder: IAddressEncoder;
+//# sourceMappingURL=encoder.d.ts.map

package/dist/litecoin/encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../src/litecoin/encoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAIjG;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,eAQ3B,CAAC"}

package/dist/litecoin/encoder.js

@@ -0,0 +1,16 @@
+import { encodeBech32Address } from "../bitcoin/encoder.js";
+/**
+ * Litecoin bech32 address encoder.
+ * Implements IAddressEncoder for the litecoin plugin.
+ * Default HRP is "ltc" (mainnet). Override with params.hrp for testnet ("tltc").
+ */
+export const bech32Encoder = {
+    encode(publicKey, params) {
+        const hrp = params.hrp ?? "ltc";
+        return encodeBech32Address(publicKey, hrp);
+    },
+    encodingType() {
+        return "bech32";
+    },
+};
+//# sourceMappingURL=encoder.js.map

package/dist/litecoin/encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../../src/litecoin/encoder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC7C,MAAM,CAAC,SAAqB,EAAE,MAAsB;QACnD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC;QAChC,OAAO,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC5C,CAAC;IACD,YAAY;QACX,OAAO,QAAQ,CAAC;IACjB,CAAC;CACD,CAAC"}

package/dist/litecoin/index.d.ts

@@ -0,0 +1,4 @@
+import type { IChainPlugin } from "@wopr-network/platform-core/crypto-plugin";
+export { bech32Encoder } from "./encoder.js";
+export declare const litecoinPlugin: IChainPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/litecoin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/litecoin/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,2CAA2C,CAAC;AAM3F,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,eAAO,MAAM,cAAc,EAAE,YAc5B,CAAC"}

package/dist/litecoin/index.js

@@ -0,0 +1,20 @@
+import { createRpcFromOpts } from "../shared/utxo/index.js";
+import { createUtxoWatcher } from "../shared/utxo/watcher.js";
+import { bech32Encoder } from "./encoder.js";
+export { bech32Encoder } from "./encoder.js";
+export const litecoinPlugin = {
+    pluginId: "litecoin",
+    supportedCurve: "secp256k1",
+    encoders: {
+        bech32: bech32Encoder,
+    },
+    createWatcher(opts) {
+        const rpc = createRpcFromOpts(opts.rpcUrl, opts.rpcHeaders);
+        return createUtxoWatcher(opts, rpc);
+    },
+    createSweeper() {
+        throw new Error("Not implemented");
+    },
+    version: 1,
+};
+//# sourceMappingURL=index.js.map

package/dist/litecoin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/litecoin/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC3C,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,WAAW;IAC3B,QAAQ,EAAE;QACT,MAAM,EAAE,aAAa;KACrB;IACD,aAAa,CAAC,IAAiB;QAC9B,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5D,OAAO,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,aAAa;QACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,CAAC;CACV,CAAC"}

package/dist/shared/test-helpers/index.d.ts

@@ -0,0 +1,9 @@
+import type { IPriceOracle, IWatcherCursorStore } from "@wopr-network/platform-core/crypto-plugin";
+/** In-memory mock cursor store for testing UTXO watchers. */
+export declare function createMockCursorStore(): IWatcherCursorStore & {
+    _cursors: Map<string, number>;
+    _confirmations: Map<string, number>;
+};
+/** Mock price oracle that returns a fixed price. */
+export declare function createMockOracle(priceMicros?: number): IPriceOracle;
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/test-helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/test-helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAEnG,6DAA6D;AAC7D,wBAAgB,qBAAqB,IAAI,mBAAmB,GAAG;IAC9D,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,CAoBA;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,WAAW,SAAkB,GAAG,YAAY,CAM5E"}

package/dist/shared/test-helpers/index.js

@@ -0,0 +1,30 @@
+/** In-memory mock cursor store for testing UTXO watchers. */
+export function createMockCursorStore() {
+    const cursors = new Map();
+    const confirmations = new Map();
+    return {
+        _cursors: cursors,
+        _confirmations: confirmations,
+        async get(watcherId) {
+            return cursors.get(watcherId) ?? null;
+        },
+        async save(watcherId, cursor) {
+            cursors.set(watcherId, cursor);
+        },
+        async getConfirmationCount(watcherId, txKey) {
+            return confirmations.get(`${watcherId}:${txKey}`) ?? null;
+        },
+        async saveConfirmationCount(watcherId, txKey, count) {
+            confirmations.set(`${watcherId}:${txKey}`, count);
+        },
+    };
+}
+/** Mock price oracle that returns a fixed price. */
+export function createMockOracle(priceMicros = 100_000_000_000) {
+    return {
+        async getPrice(_token) {
+            return { priceMicros };
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/shared/test-helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/test-helpers/index.ts"],"names":[],"mappings":"AAEA,6DAA6D;AAC7D,MAAM,UAAU,qBAAqB;IAIpC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEhD,OAAO;QACN,QAAQ,EAAE,OAAO;QACjB,cAAc,EAAE,aAAa;QAC7B,KAAK,CAAC,GAAG,CAAC,SAAiB;YAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;QACvC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,MAAc;YAC3C,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QACD,KAAK,CAAC,oBAAoB,CAAC,SAAiB,EAAE,KAAa;YAC1D,OAAO,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC;QAC3D,CAAC;QACD,KAAK,CAAC,qBAAqB,CAAC,SAAiB,EAAE,KAAa,EAAE,KAAa;YAC1E,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;QACnD,CAAC;KACD,CAAC;AACH,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,gBAAgB,CAAC,WAAW,GAAG,eAAe;IAC7D,OAAO;QACN,KAAK,CAAC,QAAQ,CAAC,MAAc;YAC5B,OAAO,EAAE,WAAW,EAAE,CAAC;QACxB,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/shared/utxo/index.d.ts

@@ -0,0 +1,5 @@
+export { createBitcoindRpc, createRpcFromOpts, parseRpcUrl } from "./rpc.js";
+export type { DescriptorInfo, GetTransactionResponse, ImportDescriptorResult, ReceivedByAddress, RpcCall, TxDetail, UtxoNodeConfig, } from "./types.js";
+export type { UtxoWatcherConfig } from "./watcher.js";
+export { createUtxoWatcher, UtxoWatcher } from "./watcher.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/utxo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/utxo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC7E,YAAY,EACX,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,OAAO,EACP,QAAQ,EACR,cAAc,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/shared/utxo/index.js

@@ -0,0 +1,3 @@
+export { createBitcoindRpc, createRpcFromOpts, parseRpcUrl } from "./rpc.js";
+export { createUtxoWatcher, UtxoWatcher } from "./watcher.js";
+//# sourceMappingURL=index.js.map

package/dist/shared/utxo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/utxo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAW7E,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/shared/utxo/rpc.d.ts

@@ -0,0 +1,24 @@
+import type { RpcCall } from "./types.js";
+interface RpcConfig {
+    rpcUrl: string;
+    rpcUser: string;
+    rpcPassword: string;
+}
+/**
+ * Parse RPC credentials from a URL with embedded basic auth.
+ * e.g. "http://user:pass@host:8332" -> { rpcUrl: "http://host:8332", rpcUser: "user", rpcPassword: "pass" }
+ * If no auth in URL, returns the URL as-is with empty credentials.
+ */
+export declare function parseRpcUrl(url: string): RpcConfig;
+/**
+ * Create a JSON-RPC caller for a bitcoind-compatible node (BTC, LTC, DOGE).
+ * Uses basic auth and JSON-RPC 1.0 protocol.
+ */
+export declare function createBitcoindRpc(rpcUrl: string, rpcUser: string, rpcPassword: string): RpcCall;
+/**
+ * Create a bitcoind-compatible RPC caller from WatcherOpts-style config.
+ * Parses rpcUrl for embedded credentials, falls back to rpcHeaders Authorization.
+ */
+export declare function createRpcFromOpts(rpcUrl: string, rpcHeaders: Record<string, string>): RpcCall;
+export {};
+//# sourceMappingURL=rpc.d.ts.map

package/dist/shared/utxo/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../../src/shared/utxo/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,UAAU,SAAS;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAclD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAiB/F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAuB7F"}

package/dist/shared/utxo/rpc.js

@@ -0,0 +1,75 @@
+/**
+ * Parse RPC credentials from a URL with embedded basic auth.
+ * e.g. "http://user:pass@host:8332" -> { rpcUrl: "http://host:8332", rpcUser: "user", rpcPassword: "pass" }
+ * If no auth in URL, returns the URL as-is with empty credentials.
+ */
+export function parseRpcUrl(url) {
+    try {
+        const parsed = new URL(url);
+        if (parsed.username) {
+            const rpcUser = decodeURIComponent(parsed.username);
+            const rpcPassword = decodeURIComponent(parsed.password);
+            parsed.username = "";
+            parsed.password = "";
+            return { rpcUrl: parsed.toString().replace(/\/$/, ""), rpcUser, rpcPassword };
+        }
+    }
+    catch {
+        // Not a valid URL with auth, return as-is
+    }
+    return { rpcUrl: url, rpcUser: "", rpcPassword: "" };
+}
+/**
+ * Create a JSON-RPC caller for a bitcoind-compatible node (BTC, LTC, DOGE).
+ * Uses basic auth and JSON-RPC 1.0 protocol.
+ */
+export function createBitcoindRpc(rpcUrl, rpcUser, rpcPassword) {
+    let id = 0;
+    const auth = btoa(`${rpcUser}:${rpcPassword}`);
+    return async (method, params) => {
+        const res = await fetch(rpcUrl, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Basic ${auth}`,
+            },
+            body: JSON.stringify({ jsonrpc: "1.0", id: ++id, method, params }),
+        });
+        if (!res.ok)
+            throw new Error(`RPC ${method} failed: ${res.status}`);
+        const data = (await res.json());
+        if (data.error)
+            throw new Error(`RPC ${method}: ${data.error.message}`);
+        return data.result;
+    };
+}
+/**
+ * Create a bitcoind-compatible RPC caller from WatcherOpts-style config.
+ * Parses rpcUrl for embedded credentials, falls back to rpcHeaders Authorization.
+ */
+export function createRpcFromOpts(rpcUrl, rpcHeaders) {
+    // Try parsing credentials from URL
+    const parsed = parseRpcUrl(rpcUrl);
+    if (parsed.rpcUser) {
+        return createBitcoindRpc(parsed.rpcUrl, parsed.rpcUser, parsed.rpcPassword);
+    }
+    // Fall back to rpcHeaders (may contain Authorization header)
+    let id = 0;
+    return async (method, params) => {
+        const res = await fetch(rpcUrl, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...rpcHeaders,
+            },
+            body: JSON.stringify({ jsonrpc: "1.0", id: ++id, method, params }),
+        });
+        if (!res.ok)
+            throw new Error(`RPC ${method} failed: ${res.status}`);
+        const data = (await res.json());
+        if (data.error)
+            throw new Error(`RPC ${method}: ${data.error.message}`);
+        return data.result;
+    };
+}
+//# sourceMappingURL=rpc.js.map

package/dist/shared/utxo/rpc.js.map

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

package/dist/shared/utxo/types.d.ts

@@ -0,0 +1,40 @@
+/** Configuration for a bitcoind-compatible JSON-RPC node (BTC, LTC, DOGE). */
+export interface UtxoNodeConfig {
+    readonly rpcUrl: string;
+    readonly rpcUser: string;
+    readonly rpcPassword: string;
+    readonly network: "mainnet" | "testnet" | "regtest";
+    readonly confirmations: number;
+}
+/** A single "received by address" entry from listreceivedbyaddress. */
+export interface ReceivedByAddress {
+    address: string;
+    amount: number;
+    confirmations: number;
+    txids: string[];
+}
+/** Transaction detail from gettransaction. */
+export interface TxDetail {
+    address: string;
+    amount: number;
+    category: string;
+}
+/** Response from gettransaction RPC call. */
+export interface GetTransactionResponse {
+    details: TxDetail[];
+    confirmations: number;
+}
+/** Descriptor info response from getdescriptorinfo. */
+export interface DescriptorInfo {
+    descriptor: string;
+}
+/** Result of importdescriptors RPC call. */
+export interface ImportDescriptorResult {
+    success: boolean;
+    error?: {
+        message: string;
+    };
+}
+/** JSON-RPC call signature for bitcoind-compatible nodes. */
+export type RpcCall = (method: string, params: unknown[]) => Promise<unknown>;
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/utxo/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/utxo/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAC/B;AAED,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,8CAA8C;AAC9C,MAAM,WAAW,QAAQ;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5B;AAED,6DAA6D;AAC7D,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC"}

package/dist/shared/utxo/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shared/utxo/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shared/utxo/types.ts"],"names":[],"mappings":""}

package/dist/shared/utxo/watcher.d.ts

@@ -0,0 +1,55 @@
+import type { IChainWatcher, IPriceOracle, IWatcherCursorStore, PaymentEvent, WatcherOpts } from "@wopr-network/platform-core/crypto-plugin";
+import type { RpcCall } from "./types.js";
+export interface UtxoWatcherConfig {
+    /** JSON-RPC call function for the node. */
+    rpc: RpcCall;
+    /** Chain identifier for the price oracle (e.g. "BTC", "LTC", "DOGE"). */
+    token: string;
+    /** Chain name for PaymentEvent (e.g. "bitcoin", "litecoin", "dogecoin"). */
+    chain: string;
+    /** Number of decimal places for this chain's native unit (8 for BTC/LTC/DOGE). */
+    decimals: number;
+    /** Required confirmations before marking fully processed. */
+    confirmations: number;
+    /** Price oracle for USD conversion. */
+    oracle: IPriceOracle;
+    /** Cursor store for dedup and confirmation tracking. */
+    cursorStore: IWatcherCursorStore;
+}
+/**
+ * Generic UTXO chain watcher that works with any bitcoind-compatible node.
+ * Polls listreceivedbyaddress for payments and tracks confirmations.
+ *
+ * Reusable for BTC, LTC, and DOGE.
+ */
+export declare class UtxoWatcher implements IChainWatcher {
+    private readonly rpc;
+    private readonly addresses;
+    private readonly token;
+    private readonly chain;
+    private readonly decimals;
+    private readonly minConfirmations;
+    private readonly oracle;
+    private readonly cursorStore;
+    private readonly watcherId;
+    private cursor;
+    private stopped;
+    constructor(config: UtxoWatcherConfig);
+    init(): Promise<void>;
+    setWatchedAddresses(addresses: string[]): void;
+    getCursor(): number;
+    stop(): void;
+    /**
+     * Import an address into the node's wallet (watch-only).
+     * Uses importdescriptors (modern) with fallback to importaddress (legacy).
+     */
+    importAddress(address: string): Promise<void>;
+    /**
+     * Poll for payments to watched addresses.
+     * Returns PaymentEvent[] for each new or updated confirmation.
+     */
+    poll(): Promise<PaymentEvent[]>;
+}
+/** Create a UtxoWatcher from the standard WatcherOpts interface. */
+export declare function createUtxoWatcher(opts: WatcherOpts, rpc: RpcCall): IChainWatcher;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/shared/utxo/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../../src/shared/utxo/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,MAAM,2CAA2C,CAAC;AAEnD,OAAO,KAAK,EAKX,OAAO,EACP,MAAM,YAAY,CAAC;AAqBpB,MAAM,WAAW,iBAAiB;IACjC,2CAA2C;IAC3C,GAAG,EAAE,OAAO,CAAC;IACb,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,MAAM,EAAE,YAAY,CAAC;IACrB,wDAAwD;IACxD,WAAW,EAAE,mBAAmB,CAAC;CACjC;AAED;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,aAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAU;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,iBAAiB;IAW/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAK9C,SAAS,IAAI,MAAM;IAInB,IAAI,IAAI,IAAI;IAIZ;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnD;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;CAwDrC;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,GAAG,aAAa,CAUhF"}