@wopr-network/crypto-plugins 1.0.1

package/dist/shared/utxo/watcher.js

@@ -0,0 +1,150 @@
+/**
+ * Convert raw native units to USD cents using microdollar pricing.
+ *
+ * priceMicros = microdollars (10^-6 USD) per 1 whole coin.
+ * rawAmount is in the smallest unit (sats for BTC, litoshis for LTC, etc).
+ * decimals = number of decimal places (8 for BTC/LTC/DOGE).
+ *
+ * Formula: (rawAmount * priceMicros) / (10_000 * 10^decimals)
+ *   where 10_000 converts microdollars to cents (1 cent = 10,000 microdollars).
+ */
+function nativeToCents(rawAmount, priceMicros, decimals) {
+    if (rawAmount < 0n)
+        throw new Error("rawAmount must be non-negative");
+    if (!Number.isInteger(priceMicros) || priceMicros <= 0) {
+        throw new Error(`priceMicros must be a positive integer, got ${priceMicros}`);
+    }
+    const MICROS_PER_CENT = 10000n;
+    return Number((rawAmount * BigInt(priceMicros)) / (MICROS_PER_CENT * 10n ** BigInt(decimals)));
+}
+/**
+ * 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 class UtxoWatcher {
+    rpc;
+    addresses = new Set();
+    token;
+    chain;
+    decimals;
+    minConfirmations;
+    oracle;
+    cursorStore;
+    watcherId;
+    cursor = 0;
+    stopped = false;
+    constructor(config) {
+        this.rpc = config.rpc;
+        this.token = config.token;
+        this.chain = config.chain;
+        this.decimals = config.decimals;
+        this.minConfirmations = config.confirmations;
+        this.oracle = config.oracle;
+        this.cursorStore = config.cursorStore;
+        this.watcherId = `${config.chain}:${config.token}`;
+    }
+    async init() {
+        // Load persisted cursor (block height not used for UTXO, but kept for interface compat)
+        const saved = await this.cursorStore.get(this.watcherId);
+        if (saved !== null)
+            this.cursor = saved;
+    }
+    setWatchedAddresses(addresses) {
+        this.addresses.clear();
+        for (const a of addresses)
+            this.addresses.add(a);
+    }
+    getCursor() {
+        return this.cursor;
+    }
+    stop() {
+        this.stopped = true;
+    }
+    /**
+     * Import an address into the node's wallet (watch-only).
+     * Uses importdescriptors (modern) with fallback to importaddress (legacy).
+     */
+    async importAddress(address) {
+        try {
+            const info = (await this.rpc("getdescriptorinfo", [`addr(${address})`]));
+            const result = (await this.rpc("importdescriptors", [
+                [{ desc: info.descriptor, timestamp: 0 }],
+            ]));
+            if (result[0] && !result[0].success) {
+                throw new Error(result[0].error?.message ?? "importdescriptors failed");
+            }
+        }
+        catch {
+            // Fallback: legacy importaddress
+            await this.rpc("importaddress", [address, "", false]);
+        }
+        this.addresses.add(address);
+    }
+    /**
+     * Poll for payments to watched addresses.
+     * Returns PaymentEvent[] for each new or updated confirmation.
+     */
+    async poll() {
+        if (this.stopped || this.addresses.size === 0)
+            return [];
+        const events = [];
+        // Poll with minconf=0 to see unconfirmed txs
+        const received = (await this.rpc("listreceivedbyaddress", [
+            0, // minconf=0: see ALL txs including unconfirmed
+            false, // include_empty
+            true, // include_watchonly
+        ]));
+        const { priceMicros } = await this.oracle.getPrice(this.token);
+        for (const entry of received) {
+            if (!this.addresses.has(entry.address))
+                continue;
+            for (const txid of entry.txids) {
+                // Skip fully-processed txids
+                const confirmCount = await this.cursorStore.getConfirmationCount(this.watcherId, txid);
+                // Get transaction details for the exact amount
+                const tx = (await this.rpc("gettransaction", [txid, true]));
+                const detail = tx.details.find((d) => d.address === entry.address && d.category === "receive");
+                if (!detail)
+                    continue;
+                // Check if confirmations have increased since last seen
+                if (confirmCount !== null && tx.confirmations <= confirmCount)
+                    continue;
+                // Skip if already at or past threshold on a previous poll
+                if (confirmCount !== null && confirmCount >= this.minConfirmations)
+                    continue;
+                const rawAmount = BigInt(Math.round(detail.amount * 10 ** this.decimals));
+                const amountUsdCents = nativeToCents(rawAmount, priceMicros, this.decimals);
+                events.push({
+                    chain: this.chain,
+                    token: this.token,
+                    from: "", // UTXO chains don't have a single sender
+                    to: entry.address,
+                    rawAmount: rawAmount.toString(),
+                    amountUsdCents,
+                    txHash: txid,
+                    blockNumber: 0, // UTXO chains use txid-based tracking, not block numbers
+                    confirmations: tx.confirmations,
+                    confirmationsRequired: this.minConfirmations,
+                });
+                // Persist confirmation count
+                await this.cursorStore.saveConfirmationCount(this.watcherId, txid, tx.confirmations);
+            }
+        }
+        return events;
+    }
+}
+/** Create a UtxoWatcher from the standard WatcherOpts interface. */
+export function createUtxoWatcher(opts, rpc) {
+    return new UtxoWatcher({
+        rpc,
+        token: opts.token,
+        chain: opts.chain,
+        decimals: opts.decimals,
+        confirmations: opts.confirmations,
+        oracle: opts.oracle,
+        cursorStore: opts.cursorStore,
+    });
+}
+//# sourceMappingURL=watcher.js.map

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

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

package/dist/solana/encoder.d.ts

@@ -0,0 +1,13 @@
+import type { EncodingParams, IAddressEncoder } from "@wopr-network/platform-core/crypto-plugin";
+/**
+ * Encode a Uint8Array as a Base58 string (Bitcoin/Solana alphabet).
+ *
+ * This is a standalone implementation — no external dependency needed.
+ */
+export declare function base58Encode(bytes: Uint8Array): string;
+/** Solana address encoder implementing IAddressEncoder. */
+export declare class SolanaAddressEncoder implements IAddressEncoder {
+    encode(publicKey: Uint8Array, _params: EncodingParams): string;
+    encodingType(): string;
+}
+//# sourceMappingURL=encoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../src/solana/encoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAKjG;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAqCtD;AAeD,2DAA2D;AAC3D,qBAAa,oBAAqB,YAAW,eAAe;IAC3D,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;IAI9D,YAAY,IAAI,MAAM;CAGtB"}

package/dist/solana/encoder.js

@@ -0,0 +1,62 @@
+/** Base58 alphabet used by Bitcoin/Solana. */
+const ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+/**
+ * Encode a Uint8Array as a Base58 string (Bitcoin/Solana alphabet).
+ *
+ * This is a standalone implementation — no external dependency needed.
+ */
+export function base58Encode(bytes) {
+    // Count leading zeros
+    let zeros = 0;
+    for (let i = 0; i < bytes.length && bytes[i] === 0; i++) {
+        zeros++;
+    }
+    // Convert to base58
+    // Allocate enough space in big-endian base58 representation
+    const size = Math.ceil((bytes.length * 138) / 100) + 1;
+    const b58 = new Uint8Array(size);
+    for (let i = zeros; i < bytes.length; i++) {
+        let carry = bytes[i];
+        for (let j = size - 1; j >= 0; j--) {
+            carry += 256 * b58[j];
+            b58[j] = carry % 58;
+            carry = Math.floor(carry / 58);
+        }
+    }
+    // Skip leading zeros in base58 result
+    let start = 0;
+    while (start < size && b58[start] === 0) {
+        start++;
+    }
+    // Build string: leading '1's for zero bytes + base58 digits
+    let result = "";
+    for (let i = 0; i < zeros; i++) {
+        result += ALPHABET[0];
+    }
+    for (let i = start; i < size; i++) {
+        result += ALPHABET[b58[i]];
+    }
+    return result;
+}
+/**
+ * Derive a Solana address from a raw 32-byte Ed25519 public key.
+ *
+ * Solana addresses are simply the Base58 encoding of the raw public key.
+ * No hashing, no version byte, no checksum.
+ */
+function encodeSolana(pubkey) {
+    if (pubkey.length !== 32) {
+        throw new Error(`Solana address requires 32-byte Ed25519 public key, got ${pubkey.length} bytes`);
+    }
+    return base58Encode(pubkey);
+}
+/** Solana address encoder implementing IAddressEncoder. */
+export class SolanaAddressEncoder {
+    encode(publicKey, _params) {
+        return encodeSolana(publicKey);
+    }
+    encodingType() {
+        return "base58-solana";
+    }
+}
+//# sourceMappingURL=encoder.js.map

package/dist/solana/encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../../src/solana/encoder.ts"],"names":[],"mappings":"AAEA,8CAA8C;AAC9C,MAAM,QAAQ,GAAG,4DAA4D,CAAC;AAE9E;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC7C,sBAAsB;IACtB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzD,KAAK,EAAE,CAAC;IACT,CAAC;IAED,oBAAoB;IACpB,4DAA4D;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAEjC,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,KAAK,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YACtB,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;YACpB,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QAChC,CAAC;IACF,CAAC;IAED,sCAAsC;IACtC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,GAAG,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,KAAK,EAAE,CAAC;IACT,CAAC;IAED,4DAA4D;IAC5D,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,MAAkB;IACvC,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,2DAA2D,MAAM,CAAC,MAAM,QAAQ,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED,2DAA2D;AAC3D,MAAM,OAAO,oBAAoB;IAChC,MAAM,CAAC,SAAqB,EAAE,OAAuB;QACpD,OAAO,YAAY,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAED,YAAY;QACX,OAAO,eAAe,CAAC;IACxB,CAAC;CACD"}

package/dist/solana/index.d.ts

@@ -0,0 +1,17 @@
+import type { IChainPlugin } from "@wopr-network/platform-core/crypto-plugin";
+export { base58Encode, SolanaAddressEncoder } from "./encoder.js";
+export { SolanaSweeper } from "./sweeper.js";
+export type { SignatureInfo, SolanaRpcCall, SolanaTransaction, TokenBalance, TransactionMeta } from "./types.js";
+export { createSolanaRpcCaller, SolanaWatcher } from "./watcher.js";
+/**
+ * Solana chain plugin.
+ *
+ * Supports native SOL watching and SPL token watching (e.g. USDC).
+ * Uses Ed25519 curve for key derivation. Addresses are Base58-encoded
+ * raw 32-byte public keys (no hashing, no checksum).
+ *
+ * The watcher detects incoming transfers by scanning transaction history
+ * for each watched address via getSignaturesForAddress + getTransaction.
+ */
+export declare const solanaPlugin: IChainPlugin;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/solana/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAA4B,MAAM,2CAA2C,CAAC;AAKxG,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjH,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIpE;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,EAAE,YAa1B,CAAC"}

package/dist/solana/index.js

@@ -0,0 +1,32 @@
+import { SolanaAddressEncoder } from "./encoder.js";
+import { SolanaSweeper } from "./sweeper.js";
+import { SolanaWatcher } from "./watcher.js";
+export { base58Encode, SolanaAddressEncoder } from "./encoder.js";
+export { SolanaSweeper } from "./sweeper.js";
+export { createSolanaRpcCaller, SolanaWatcher } from "./watcher.js";
+const encoder = new SolanaAddressEncoder();
+/**
+ * Solana chain plugin.
+ *
+ * Supports native SOL watching and SPL token watching (e.g. USDC).
+ * Uses Ed25519 curve for key derivation. Addresses are Base58-encoded
+ * raw 32-byte public keys (no hashing, no checksum).
+ *
+ * The watcher detects incoming transfers by scanning transaction history
+ * for each watched address via getSignaturesForAddress + getTransaction.
+ */
+export const solanaPlugin = {
+    pluginId: "solana",
+    supportedCurve: "ed25519",
+    encoders: {
+        "base58-solana": encoder,
+    },
+    createWatcher(opts) {
+        return new SolanaWatcher(opts);
+    },
+    createSweeper(opts) {
+        return new SolanaSweeper(opts);
+    },
+    version: 1,
+};
+//# sourceMappingURL=index.js.map

package/dist/solana/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/solana/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,OAAO,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAE3C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAiB;IACzC,QAAQ,EAAE,QAAQ;IAClB,cAAc,EAAE,SAAS;IACzB,QAAQ,EAAE;QACT,eAAe,EAAE,OAAO;KACxB;IACD,aAAa,CAAC,IAAiB;QAC9B,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,aAAa,CAAC,IAAiB;QAC9B,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,EAAE,CAAC;CACV,CAAC"}

package/dist/solana/sweeper.d.ts

@@ -0,0 +1,47 @@
+import type { DepositInfo, ISweepStrategy, KeyPair, SweeperOpts, SweepResult } from "@wopr-network/platform-core/crypto-plugin";
+/**
+ * Solana sweep strategy.
+ *
+ * Scans deposit addresses for SOL balances and SPL token balances,
+ * then creates transfer transactions to sweep funds to the treasury.
+ */
+export declare class SolanaSweeper implements ISweepStrategy {
+    private readonly rpc;
+    private readonly token;
+    private readonly chain;
+    private readonly contractAddress?;
+    private readonly decimals;
+    constructor(opts: SweeperOpts);
+    /**
+     * Scan deposit addresses for balances.
+     *
+     * For each key:
+     *   - Check native SOL balance via getBalance
+     *   - Check SPL token balances via getTokenAccountsByOwner
+     */
+    scan(keys: KeyPair[], _treasury: string): Promise<DepositInfo[]>;
+    /**
+     * Sweep funds from deposit addresses to treasury.
+     *
+     * For native SOL: transfers balance minus fee.
+     * For SPL tokens: transfers full token balance using token transfer instruction.
+     *
+     * In dry-run mode, returns what would be swept without broadcasting.
+     */
+    sweep(keys: KeyPair[], treasury: string, dryRun: boolean): Promise<SweepResult[]>;
+    /**
+     * Submit a native SOL transfer.
+     *
+     * Builds a SystemProgram.transfer instruction, signs with the deposit keypair,
+     * and submits via sendTransaction.
+     */
+    private submitSolTransfer;
+    /**
+     * Submit an SPL token transfer.
+     *
+     * Builds a TokenProgram.transfer instruction for the given mint,
+     * signs with the deposit keypair, and submits via sendTransaction.
+     */
+    private submitSplTransfer;
+}
+//# sourceMappingURL=sweeper.d.ts.map

package/dist/solana/sweeper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweeper.d.ts","sourceRoot":"","sources":["../../src/solana/sweeper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,WAAW,EACX,cAAc,EACd,OAAO,EACP,WAAW,EACX,WAAW,EACX,MAAM,2CAA2C,CAAC;AAOnD;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,cAAc;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,IAAI,EAAE,WAAW;IAQ7B;;;;;;OAMG;IACG,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAuDtE;;;;;;;OAOG;IACG,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA6DvF;;;;;OAKG;YACW,iBAAiB;IAa/B;;;;;OAKG;YACW,iBAAiB;CAK/B"}

package/dist/solana/sweeper.js

@@ -0,0 +1,151 @@
+import { createSolanaRpcCaller } from "./watcher.js";
+/** Transaction fee estimate (in lamports). */
+const TX_FEE = 5000n;
+/**
+ * Solana sweep strategy.
+ *
+ * Scans deposit addresses for SOL balances and SPL token balances,
+ * then creates transfer transactions to sweep funds to the treasury.
+ */
+export class SolanaSweeper {
+    rpc;
+    token;
+    chain;
+    contractAddress;
+    decimals;
+    constructor(opts) {
+        this.rpc = createSolanaRpcCaller(opts.rpcUrl, opts.rpcHeaders);
+        this.token = opts.token;
+        this.chain = opts.chain;
+        this.contractAddress = opts.contractAddress;
+        this.decimals = opts.decimals;
+    }
+    /**
+     * Scan deposit addresses for balances.
+     *
+     * For each key:
+     *   - Check native SOL balance via getBalance
+     *   - Check SPL token balances via getTokenAccountsByOwner
+     */
+    async scan(keys, _treasury) {
+        const results = [];
+        for (const key of keys) {
+            const balance = (await this.rpc("getBalance", [key.address]));
+            const nativeBalance = BigInt(balance.value);
+            const tokenBalances = [];
+            if (this.contractAddress) {
+                const tokenAccounts = (await this.rpc("getTokenAccountsByOwner", [
+                    key.address,
+                    { mint: this.contractAddress },
+                    { encoding: "jsonParsed" },
+                ]));
+                for (const ta of tokenAccounts.value) {
+                    const info = ta.account.data.parsed.info;
+                    const bal = BigInt(info.tokenAmount.amount);
+                    if (bal > 0n) {
+                        tokenBalances.push({
+                            token: info.mint,
+                            balance: bal,
+                            decimals: info.tokenAmount.decimals,
+                        });
+                    }
+                }
+            }
+            if (nativeBalance > 0n || tokenBalances.length > 0) {
+                results.push({
+                    index: key.index,
+                    address: key.address,
+                    nativeBalance,
+                    tokenBalances,
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Sweep funds from deposit addresses to treasury.
+     *
+     * For native SOL: transfers balance minus fee.
+     * For SPL tokens: transfers full token balance using token transfer instruction.
+     *
+     * In dry-run mode, returns what would be swept without broadcasting.
+     */
+    async sweep(keys, treasury, dryRun) {
+        const deposits = await this.scan(keys, treasury);
+        const results = [];
+        for (const deposit of deposits) {
+            const key = keys.find((k) => k.index === deposit.index);
+            if (!key)
+                continue;
+            // Sweep SPL tokens first
+            for (const tb of deposit.tokenBalances) {
+                if (dryRun) {
+                    results.push({
+                        index: deposit.index,
+                        address: deposit.address,
+                        token: tb.token,
+                        amount: tb.balance.toString(),
+                        txHash: "dry-run",
+                    });
+                    continue;
+                }
+                // In production, this would build and sign an SPL token transfer transaction
+                // using @solana/web3.js. For now, placeholder for the transaction submission.
+                const txHash = await this.submitSplTransfer(key, treasury, tb.token, tb.balance);
+                results.push({
+                    index: deposit.index,
+                    address: deposit.address,
+                    token: tb.token,
+                    amount: tb.balance.toString(),
+                    txHash,
+                });
+            }
+            // Sweep native SOL (leave enough for rent + fee if token accounts exist)
+            const sweepableNative = deposit.nativeBalance - TX_FEE;
+            if (sweepableNative > 0n) {
+                if (dryRun) {
+                    results.push({
+                        index: deposit.index,
+                        address: deposit.address,
+                        token: "SOL",
+                        amount: sweepableNative.toString(),
+                        txHash: "dry-run",
+                    });
+                    continue;
+                }
+                const txHash = await this.submitSolTransfer(key, treasury, sweepableNative);
+                results.push({
+                    index: deposit.index,
+                    address: deposit.address,
+                    token: "SOL",
+                    amount: sweepableNative.toString(),
+                    txHash,
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Submit a native SOL transfer.
+     *
+     * Builds a SystemProgram.transfer instruction, signs with the deposit keypair,
+     * and submits via sendTransaction.
+     */
+    async submitSolTransfer(key, treasury, lamports) {
+        // Get recent blockhash
+        const blockhashResult = (await this.rpc("getLatestBlockhash", [{ commitment: "finalized" }]));
+        // In production, build + sign the transaction using @solana/web3.js or manual serialization.
+        // For Phase 1, we use a simplified approach:
+        throw new Error(`SOL transfer not yet implemented — would send ${lamports} lamports from ${key.address} to ${treasury} with blockhash ${blockhashResult.value.blockhash}`);
+    }
+    /**
+     * Submit an SPL token transfer.
+     *
+     * Builds a TokenProgram.transfer instruction for the given mint,
+     * signs with the deposit keypair, and submits via sendTransaction.
+     */
+    async submitSplTransfer(key, treasury, mint, amount) {
+        throw new Error(`SPL transfer not yet implemented — would send ${amount} of ${mint} from ${key.address} to ${treasury}`);
+    }
+}
+//# sourceMappingURL=sweeper.js.map

package/dist/solana/sweeper.js.map

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

package/dist/solana/types.d.ts

@@ -0,0 +1,49 @@
+/** JSON-RPC call function signature. */
+export type SolanaRpcCall = (method: string, params: unknown[]) => Promise<unknown>;
+/** Solana signature info from getSignaturesForAddress. */
+export interface SignatureInfo {
+    signature: string;
+    slot: number;
+    err: unknown | null;
+    memo: string | null;
+    blockTime: number | null;
+    confirmationStatus: "processed" | "confirmed" | "finalized" | null;
+}
+/** Solana transaction metadata. */
+export interface TransactionMeta {
+    err: unknown | null;
+    fee: number;
+    preBalances: number[];
+    postBalances: number[];
+    preTokenBalances?: TokenBalance[];
+    postTokenBalances?: TokenBalance[];
+}
+/** SPL token balance entry in transaction metadata. */
+export interface TokenBalance {
+    accountIndex: number;
+    mint: string;
+    uiTokenAmount: {
+        amount: string;
+        decimals: number;
+        uiAmountString: string;
+    };
+    owner?: string;
+}
+/** Parsed Solana transaction from getTransaction. */
+export interface SolanaTransaction {
+    slot: number;
+    blockTime: number | null;
+    meta: TransactionMeta | null;
+    transaction: {
+        message: {
+            accountKeys: string[];
+            instructions: Array<{
+                programIdIndex: number;
+                accounts: number[];
+                data: string;
+            }>;
+        };
+        signatures: string[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/solana/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/solana/types.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpF,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,IAAI,CAAC;CACnE;AAED,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC;IAClC,iBAAiB,CAAC,EAAE,YAAY,EAAE,CAAC;CACnC;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE;QACZ,OAAO,EAAE;YACR,WAAW,EAAE,MAAM,EAAE,CAAC;YACtB,YAAY,EAAE,KAAK,CAAC;gBACnB,cAAc,EAAE,MAAM,CAAC;gBACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;gBACnB,IAAI,EAAE,MAAM,CAAC;aACb,CAAC,CAAC;SACH,CAAC;QACF,UAAU,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACF"}

package/dist/solana/types.js

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

package/dist/solana/types.js.map

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

package/dist/solana/watcher.d.ts

@@ -0,0 +1,59 @@
+import type { IChainWatcher, PaymentEvent, WatcherOpts } from "@wopr-network/platform-core/crypto-plugin";
+import type { SolanaRpcCall } from "./types.js";
+/** Create a Solana JSON-RPC caller. */
+export declare function createSolanaRpcCaller(rpcUrl: string, extraHeaders?: Record<string, string>): SolanaRpcCall;
+/**
+ * Solana chain watcher.
+ *
+ * Monitors watched addresses for incoming SOL transfers and SPL token transfers.
+ * Uses getSignaturesForAddress + getTransaction RPCs. Cursor is a slot number.
+ *
+ * For native SOL: detects balance increases to watched addresses.
+ * For SPL tokens: detects token transfer instructions to watched addresses.
+ */
+export declare class SolanaWatcher implements IChainWatcher {
+    private _cursor;
+    private _stopped;
+    private readonly chain;
+    private readonly token;
+    private readonly rpc;
+    private readonly confirmations;
+    private readonly decimals;
+    private readonly cursorStore;
+    private readonly watcherId;
+    private readonly contractAddress?;
+    private _watchedAddresses;
+    constructor(opts: WatcherOpts);
+    init(): Promise<void>;
+    setWatchedAddresses(addresses: string[]): void;
+    getCursor(): number;
+    stop(): void;
+    /**
+     * Poll for SOL or SPL token transfers to watched addresses.
+     *
+     * For each watched address:
+     *   1. Call getSignaturesForAddress to find recent transactions
+     *   2. Call getTransaction for each to extract transfer details
+     *   3. Detect native SOL transfers (balance diff) or SPL token transfers
+     *
+     * Cursor is the highest slot seen, advanced only for finalized transactions.
+     */
+    poll(): Promise<PaymentEvent[]>;
+    /** Fetch recent signatures for an address, filtering by slot > cursor. */
+    private getRecentSignatures;
+    /**
+     * Extract native SOL transfer events from a transaction.
+     *
+     * Detects balance increases to the watched address by comparing
+     * preBalances and postBalances in the transaction metadata.
+     */
+    private extractNativeTransferEvents;
+    /**
+     * Extract SPL token transfer events from a transaction.
+     *
+     * Compares preTokenBalances and postTokenBalances for the watched address
+     * filtered by the configured token mint (contractAddress).
+     */
+    private extractSplTransferEvents;
+}
+//# sourceMappingURL=watcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/solana/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EAEb,YAAY,EACZ,WAAW,EACX,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAiB,aAAa,EAAqB,MAAM,YAAY,CAAC;AAQlF,uCAAuC;AACvC,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAiB1G;AAaD;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,aAAa;IAClD,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,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAS;IAC1C,OAAO,CAAC,iBAAiB,CAAc;gBAE3B,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;;;;;;;;;OASG;IACG,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAgDrC,0EAA0E;YAC5D,mBAAmB;IAOjC;;;;;OAKG;IACH,OAAO,CAAC,2BAA2B;IAkDnC;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;CAwDhC"}