@wopr-network/crypto-plugins 1.0.1

package/src/tron/sha256.ts

@@ -0,0 +1,100 @@
+/**
+ * SHA-256 implementation (pure TypeScript).
+ * Shared within the tron module for encoder and address-convert.
+ */
+
+function ror32(x: number, n: number): number {
+	return (x >>> n) | (x << (32 - n));
+}
+
+export function sha256(data: Uint8Array): Uint8Array {
+	const K: number[] = [
+		0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5, 0xd807aa98,
+		0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174, 0xe49b69c1, 0xefbe4786,
+		0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da, 0x983e5152, 0xa831c66d, 0xb00327c8,
+		0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967, 0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13,
+		0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85, 0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819,
+		0xd6990624, 0xf40e3585, 0x106aa070, 0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a,
+		0x5b9cca4f, 0x682e6ff3, 0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7,
+		0xc67178f2,
+	];
+
+	const msgLen = data.length;
+	const bitLen = msgLen * 8;
+	const padLen = ((msgLen + 9 + 63) & ~63) - msgLen;
+	const padded = new Uint8Array(msgLen + padLen);
+	padded.set(data);
+	padded[msgLen] = 0x80;
+	const view = new DataView(padded.buffer);
+	view.setUint32(padded.length - 4, bitLen, false);
+
+	let h0 = 0x6a09e667;
+	let h1 = 0xbb67ae85;
+	let h2 = 0x3c6ef372;
+	let h3 = 0xa54ff53a;
+	let h4 = 0x510e527f;
+	let h5 = 0x9b05688c;
+	let h6 = 0x1f83d9ab;
+	let h7 = 0x5be0cd19;
+
+	const w = new Int32Array(64);
+
+	for (let offset = 0; offset < padded.length; offset += 64) {
+		for (let i = 0; i < 16; i++) {
+			w[i] = view.getInt32(offset + i * 4, false);
+		}
+		for (let i = 16; i < 64; i++) {
+			const s0 = (ror32(w[i - 15]!, 7) ^ ror32(w[i - 15]!, 18) ^ (w[i - 15]! >>> 3)) | 0;
+			const s1 = (ror32(w[i - 2]!, 17) ^ ror32(w[i - 2]!, 19) ^ (w[i - 2]! >>> 10)) | 0;
+			w[i] = (w[i - 16]! + s0 + w[i - 7]! + s1) | 0;
+		}
+
+		let a = h0;
+		let b = h1;
+		let c = h2;
+		let d = h3;
+		let e = h4;
+		let f = h5;
+		let g = h6;
+		let h = h7;
+
+		for (let i = 0; i < 64; i++) {
+			const S1 = (ror32(e, 6) ^ ror32(e, 11) ^ ror32(e, 25)) | 0;
+			const ch = ((e & f) ^ (~e & g)) | 0;
+			const temp1 = (h + S1 + ch + K[i]! + w[i]!) | 0;
+			const S0 = (ror32(a, 2) ^ ror32(a, 13) ^ ror32(a, 22)) | 0;
+			const maj = ((a & b) ^ (a & c) ^ (b & c)) | 0;
+			const temp2 = (S0 + maj) | 0;
+
+			h = g;
+			g = f;
+			f = e;
+			e = (d + temp1) | 0;
+			d = c;
+			c = b;
+			b = a;
+			a = (temp1 + temp2) | 0;
+		}
+
+		h0 = (h0 + a) | 0;
+		h1 = (h1 + b) | 0;
+		h2 = (h2 + c) | 0;
+		h3 = (h3 + d) | 0;
+		h4 = (h4 + e) | 0;
+		h5 = (h5 + f) | 0;
+		h6 = (h6 + g) | 0;
+		h7 = (h7 + h) | 0;
+	}
+
+	const result = new Uint8Array(32);
+	const rv = new DataView(result.buffer);
+	rv.setInt32(0, h0, false);
+	rv.setInt32(4, h1, false);
+	rv.setInt32(8, h2, false);
+	rv.setInt32(12, h3, false);
+	rv.setInt32(16, h4, false);
+	rv.setInt32(20, h5, false);
+	rv.setInt32(24, h6, false);
+	rv.setInt32(28, h7, false);
+	return result;
+}

package/src/tron/watcher.ts

@@ -0,0 +1,208 @@
+import type {
+	IChainWatcher,
+	IWatcherCursorStore,
+	PaymentEvent,
+	WatcherOpts,
+} from "@wopr-network/platform-core/crypto-plugin";
+
+import { hexToTron, tronToHex } from "./address-convert.js";
+
+/** Raw JSON-RPC log entry (same shape as EVM). */
+interface RpcLog {
+	address: string;
+	topics: string[];
+	data: string;
+	blockNumber: string;
+	transactionHash: string;
+	logIndex: string;
+}
+
+type RpcCall = (method: string, params: unknown[]) => Promise<unknown>;
+
+const TRANSFER_TOPIC = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";
+
+/** Create a JSON-RPC caller for Tron's EVM-compatible endpoint. */
+function createRpcCaller(rpcUrl: string, extraHeaders?: Record<string, string>): RpcCall {
+	let id = 0;
+	const headers: Record<string, string> = { "Content-Type": "application/json", ...extraHeaders };
+	return async (method: string, params: unknown[]): Promise<unknown> => {
+		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()) as { result?: unknown; error?: { message: string } };
+		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: bigint, decimals: number): number {
+	return Number((rawAmount * 100n) / 10n ** BigInt(decimals));
+}
+
+/**
+ * Tron EVM-compatible watcher.
+ *
+ * Tron exposes an EVM-compatible JSON-RPC endpoint that supports eth_getLogs.
+ * This watcher wraps the EVM watcher pattern but converts between Tron T...
+ * Base58Check addresses and 0x hex addresses at the boundary.
+ *
+ * - setWatchedAddresses: accepts T... addresses, converts to 0x hex for filtering
+ * - poll results: converts 0x hex addresses back to T... for PaymentEvent output
+ */
+export class TronEvmWatcher implements IChainWatcher {
+	private _cursor = 0;
+	private _stopped = false;
+	private readonly chain: string;
+	private readonly token: string;
+	private readonly rpc: RpcCall;
+	private readonly confirmations: number;
+	private readonly contractAddress: string;
+	private readonly decimals: number;
+	private readonly cursorStore: IWatcherCursorStore;
+	private readonly watcherId: string;
+	/** Hex addresses used for RPC filtering. */
+	private _watchedHexAddresses: string[] = [];
+	/** Map from lowercase hex -> original T... address for reverse lookup. */
+	private readonly _hexToTronMap: Map<string, string> = new Map();
+
+	constructor(opts: WatcherOpts) {
+		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 = `tron:${opts.chain}:${opts.token}`;
+	}
+
+	async init(): Promise<void> {
+		const saved = await this.cursorStore.get(this.watcherId);
+		if (saved !== null) this._cursor = saved;
+	}
+
+	/**
+	 * Set watched addresses. Accepts Tron T... addresses.
+	 * Converts to 0x hex internally for RPC filtering.
+	 */
+	setWatchedAddresses(addresses: string[]): void {
+		this._hexToTronMap.clear();
+		this._watchedHexAddresses = addresses.map((addr) => {
+			const hex = tronToHex(addr).toLowerCase();
+			this._hexToTronMap.set(hex, addr);
+			return hex;
+		});
+	}
+
+	getCursor(): number {
+		return this._cursor;
+	}
+
+	stop(): void {
+		this._stopped = true;
+	}
+
+	/**
+	 * Poll for TRC-20 Transfer events using the EVM-compatible JSON-RPC.
+	 * Converts hex addresses in results back to Tron T... format.
+	 */
+	async poll(): Promise<PaymentEvent[]> {
+		if (this._stopped || this._watchedHexAddresses.length === 0) return [];
+
+		const latestHex = (await this.rpc("eth_blockNumber", [])) as string;
+		const latest = Number.parseInt(latestHex, 16);
+		const confirmed = latest - this.confirmations;
+
+		if (latest < this._cursor) return [];
+
+		// Filter by topic[2] (to address) using hex addresses
+		const toFilter =
+			this._watchedHexAddresses.length > 0
+				? this._watchedHexAddresses.map((a) => `0x000000000000000000000000${a.slice(2)}`)
+				: null;
+
+		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)}`,
+			},
+		])) as RpcLog[];
+
+		// Group logs by block
+		const logsByBlock = new Map<number, RpcLog[]>();
+		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: PaymentEvent[] = [];
+
+		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}`;
+
+				const lastConf = await this.cursorStore.getConfirmationCount(this.watcherId, txKey);
+				if (lastConf !== null && confs <= lastConf) continue;
+
+				const toHex = `0x${log.topics[2].slice(26)}`.toLowerCase();
+				const fromHex = `0x${log.topics[1].slice(26)}`.toLowerCase();
+				const rawAmount = BigInt(log.data);
+				const amountUsdCents = centsFromTokenAmount(rawAmount, this.decimals);
+
+				// Convert hex addresses back to Tron T... format
+				const toTron = this._hexToTronMap.get(toHex) ?? hexToTron(toHex);
+				const fromTron = hexToTron(fromHex);
+
+				events.push({
+					chain: this.chain,
+					token: this.token,
+					from: fromTron,
+					to: toTron,
+					rawAmount: rawAmount.toString(),
+					amountUsdCents,
+					txHash: log.transactionHash,
+					blockNumber: blockNum,
+					confirmations: confs,
+					confirmationsRequired: this.confirmations,
+				});
+
+				await this.cursorStore.saveConfirmationCount(this.watcherId, txKey, confs);
+			}
+
+			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;
+	}
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+	"compilerOptions": {
+		"target": "ES2022",
+		"module": "NodeNext",
+		"moduleResolution": "NodeNext",
+		"outDir": "dist",
+		"rootDir": "src",
+		"strict": true,
+		"declaration": true,
+		"declarationMap": true,
+		"sourceMap": true,
+		"esModuleInterop": true,
+		"skipLibCheck": true,
+		"types": ["node"]
+	},
+	"include": ["src"]
+}

package/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+	test: {
+		globals: true,
+		exclude: ["dist/**", "node_modules/**"],
+	},
+});