@wopr-network/crypto-plugins 1.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tron/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,2CAA2C,CAAC;AAK3F,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,eAAO,MAAM,UAAU,EAAE,YAaxB,CAAC"}

package/dist/tron/index.js

@@ -0,0 +1,20 @@
+import { keccakB58Encoder } from "./encoder.js";
+import { TronEvmWatcher } from "./watcher.js";
+export { hexToTron, isTronAddress, tronToHex } from "./address-convert.js";
+export { encodeKeccakB58Address, keccakB58Encoder } from "./encoder.js";
+export { TronEvmWatcher } from "./watcher.js";
+export const tronPlugin = {
+    pluginId: "tron",
+    supportedCurve: "secp256k1",
+    encoders: {
+        "keccak-b58check": keccakB58Encoder,
+    },
+    createWatcher(opts) {
+        return new TronEvmWatcher(opts);
+    },
+    createSweeper() {
+        throw new Error("Not implemented");
+    },
+    version: 1,
+};
+//# sourceMappingURL=index.js.map

package/dist/tron/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tron/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAC,MAAM,UAAU,GAAiB;IACvC,QAAQ,EAAE,MAAM;IAChB,cAAc,EAAE,WAAW;IAC3B,QAAQ,EAAE;QACT,iBAAiB,EAAE,gBAAgB;KACnC;IACD,aAAa,CAAC,IAAiB;QAC9B,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,aAAa;QACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,CAAC;CACV,CAAC"}

package/dist/tron/sha256.d.ts

@@ -0,0 +1,6 @@
+/**
+ * SHA-256 implementation (pure TypeScript).
+ * Shared within the tron module for encoder and address-convert.
+ */
+export declare function sha256(data: Uint8Array): Uint8Array;
+//# sourceMappingURL=sha256.d.ts.map

package/dist/tron/sha256.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.d.ts","sourceRoot":"","sources":["../../src/tron/sha256.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CA0FnD"}

package/dist/tron/sha256.js

@@ -0,0 +1,90 @@
+/**
+ * SHA-256 implementation (pure TypeScript).
+ * Shared within the tron module for encoder and address-convert.
+ */
+function ror32(x, n) {
+    return (x >>> n) | (x << (32 - n));
+}
+export function sha256(data) {
+    const K = [
+        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;
+}
+//# sourceMappingURL=sha256.js.map

package/dist/tron/sha256.js.map

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

package/dist/tron/watcher.d.ts

@@ -0,0 +1,42 @@
+import type { IChainWatcher, PaymentEvent, WatcherOpts } from "@wopr-network/platform-core/crypto-plugin";
+/**
+ * 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 declare class TronEvmWatcher 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;
+    /** Hex addresses used for RPC filtering. */
+    private _watchedHexAddresses;
+    /** Map from lowercase hex -> original T... address for reverse lookup. */
+    private readonly _hexToTronMap;
+    constructor(opts: WatcherOpts);
+    init(): Promise<void>;
+    /**
+     * Set watched addresses. Accepts Tron T... addresses.
+     * Converts to 0x hex internally for RPC filtering.
+     */
+    setWatchedAddresses(addresses: string[]): void;
+    getCursor(): number;
+    stop(): void;
+    /**
+     * Poll for TRC-20 Transfer events using the EVM-compatible JSON-RPC.
+     * Converts hex addresses in results back to Tron T... format.
+     */
+    poll(): Promise<PaymentEvent[]>;
+}
+//# sourceMappingURL=watcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/tron/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EAEb,YAAY,EACZ,WAAW,EACX,MAAM,2CAA2C,CAAC;AAkDnD;;;;;;;;;GASG;AACH,qBAAa,cAAe,YAAW,aAAa;IACnD,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,4CAA4C;IAC5C,OAAO,CAAC,oBAAoB,CAAgB;IAC5C,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;gBAEpD,IAAI,EAAE,WAAW;IAYvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;;OAGG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAS9C,SAAS,IAAI,MAAM;IAInB,IAAI,IAAI,IAAI;IAIZ;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;CAoFrC"}

package/dist/tron/watcher.js

@@ -0,0 +1,168 @@
+import { hexToTron, tronToHex } from "./address-convert.js";
+const TRANSFER_TOPIC = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";
+/** Create a JSON-RPC caller for Tron's EVM-compatible endpoint. */
+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));
+}
+/**
+ * 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 {
+    _cursor = 0;
+    _stopped = false;
+    chain;
+    token;
+    rpc;
+    confirmations;
+    contractAddress;
+    decimals;
+    cursorStore;
+    watcherId;
+    /** Hex addresses used for RPC filtering. */
+    _watchedHexAddresses = [];
+    /** Map from lowercase hex -> original T... address for reverse lookup. */
+    _hexToTronMap = new Map();
+    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 = `tron:${opts.chain}:${opts.token}`;
+    }
+    async init() {
+        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) {
+        this._hexToTronMap.clear();
+        this._watchedHexAddresses = addresses.map((addr) => {
+            const hex = tronToHex(addr).toLowerCase();
+            this._hexToTronMap.set(hex, addr);
+            return hex;
+        });
+    }
+    getCursor() {
+        return this._cursor;
+    }
+    stop() {
+        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() {
+        if (this._stopped || this._watchedHexAddresses.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) 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)}`,
+            },
+        ]));
+        // 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 = [];
+        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;
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/tron/watcher.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+	"name": "@wopr-network/crypto-plugins",
+	"version": "1.0.1",
+	"packageManager": "pnpm@10.31.0",
+	"type": "module",
+	"bin": {
+		"crypto-sweep": "dist/sweep/index.js"
+	},
+	"scripts": {
+		"build": "tsc",
+		"test": "vitest run",
+		"lint": "biome check src/"
+	},
+	"exports": {
+		".": "./dist/index.js",
+		"./evm": "./dist/evm/index.js",
+		"./bitcoin": "./dist/bitcoin/index.js",
+		"./litecoin": "./dist/litecoin/index.js",
+		"./dogecoin": "./dist/dogecoin/index.js",
+		"./tron": "./dist/tron/index.js",
+		"./solana": "./dist/solana/index.js",
+		"./shared/utxo": "./dist/shared/utxo/index.js"
+	},
+	"peerDependencies": {
+		"@wopr-network/platform-core": "*"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.8",
+		"@types/node": "^25.5.0",
+		"@wopr-network/platform-core": "^1.65.0",
+		"typescript": "^6.0.2",
+		"vitest": "^4.1.1"
+	},
+	"dependencies": {
+		"@noble/curves": "^2.0.1",
+		"@noble/hashes": "^2.0.1",
+		"@scure/bip32": "^2.0.1",
+		"@scure/bip39": "^2.0.1",
+		"viem": "^2.30.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"release": {
+		"extends": "@wopr-network/semantic-release-config"
+	}
+}

package/src/__tests__/bitcoin-encoder.test.ts

@@ -0,0 +1,115 @@
+import { describe, expect, it } from "vitest";
+
+import { bech32Encoder, encodeBech32Address, hash160 } from "../bitcoin/index.js";
+
+describe("hash160", () => {
+	it("produces a 20-byte output", () => {
+		const input = new Uint8Array(33).fill(0x02);
+		const result = hash160(input);
+		expect(result).toBeInstanceOf(Uint8Array);
+		expect(result.length).toBe(20);
+	});
+
+	it("is deterministic", () => {
+		const input = new Uint8Array([0x03, ...new Array(32).fill(0xab)]);
+		const a = hash160(input);
+		const b = hash160(input);
+		expect(Array.from(a)).toEqual(Array.from(b));
+	});
+
+	it("different inputs produce different hashes", () => {
+		const a = hash160(new Uint8Array(33).fill(0x02));
+		const b = hash160(new Uint8Array(33).fill(0x03));
+		expect(Array.from(a)).not.toEqual(Array.from(b));
+	});
+});
+
+describe("encodeBech32Address", () => {
+	it("produces a bc1q... address for mainnet BTC", () => {
+		// Use a known compressed public key (33 bytes starting with 02 or 03)
+		const pubkey = new Uint8Array(33);
+		pubkey[0] = 0x02;
+		for (let i = 1; i < 33; i++) pubkey[i] = i;
+
+		const address = encodeBech32Address(pubkey, "bc");
+		expect(address).toMatch(/^bc1q[a-z0-9]+$/);
+		// bech32 addresses are 42-62 chars for segwit v0
+		expect(address.length).toBeGreaterThanOrEqual(42);
+		expect(address.length).toBeLessThanOrEqual(62);
+	});
+
+	it("produces ltc1q... for Litecoin", () => {
+		const pubkey = new Uint8Array(33);
+		pubkey[0] = 0x03;
+		for (let i = 1; i < 33; i++) pubkey[i] = 0xff - i;
+
+		const address = encodeBech32Address(pubkey, "ltc");
+		expect(address).toMatch(/^ltc1q[a-z0-9]+$/);
+	});
+
+	it("produces tb1q... for testnet BTC", () => {
+		const pubkey = new Uint8Array(33);
+		pubkey[0] = 0x02;
+		for (let i = 1; i < 33; i++) pubkey[i] = 0x42;
+
+		const address = encodeBech32Address(pubkey, "tb");
+		expect(address).toMatch(/^tb1q[a-z0-9]+$/);
+	});
+
+	it("same pubkey + hrp always produces the same address", () => {
+		const pubkey = new Uint8Array(33);
+		pubkey[0] = 0x02;
+		pubkey.fill(0xde, 1);
+
+		const a = encodeBech32Address(pubkey, "bc");
+		const b = encodeBech32Address(pubkey, "bc");
+		expect(a).toBe(b);
+	});
+
+	it("different pubkeys produce different addresses", () => {
+		const pub1 = new Uint8Array(33);
+		pub1[0] = 0x02;
+		pub1.fill(0x11, 1);
+
+		const pub2 = new Uint8Array(33);
+		pub2[0] = 0x02;
+		pub2.fill(0x22, 1);
+
+		const a = encodeBech32Address(pub1, "bc");
+		const b = encodeBech32Address(pub2, "bc");
+		expect(a).not.toBe(b);
+	});
+});
+
+describe("bech32Encoder (IAddressEncoder)", () => {
+	it("encodingType returns 'bech32'", () => {
+		expect(bech32Encoder.encodingType()).toBe("bech32");
+	});
+
+	it("encode with hrp param produces correct prefix", () => {
+		const pubkey = new Uint8Array(33);
+		pubkey[0] = 0x02;
+		pubkey.fill(0xaa, 1);
+
+		const addr = bech32Encoder.encode(pubkey, { hrp: "bc" });
+		expect(addr).toMatch(/^bc1q/);
+	});
+
+	it("encode defaults to bc (mainnet) when hrp not provided", () => {
+		const pubkey = new Uint8Array(33);
+		pubkey[0] = 0x03;
+		pubkey.fill(0xbb, 1);
+
+		const addr = bech32Encoder.encode(pubkey, {});
+		expect(addr).toMatch(/^bc1q/);
+	});
+
+	it("encode with ltc hrp produces ltc1q address", () => {
+		const pubkey = new Uint8Array(33);
+		pubkey[0] = 0x02;
+		pubkey.fill(0xcc, 1);
+
+		const addr = bech32Encoder.encode(pubkey, { hrp: "ltc" });
+		expect(addr).toMatch(/^ltc1q/);
+	});
+});

package/src/__tests__/dogecoin-encoder.test.ts

@@ -0,0 +1,66 @@
+import { HDKey } from "@scure/bip32";
+import { describe, expect, it } from "vitest";
+import { encodeP2pkhAddress, p2pkhEncoder } from "../dogecoin/encoder.js";
+
+const TEST_XPUB =
+	"xpub6BnqJwdqnXEZdkynN5CsrYZr3MULY933SdLrswFfKPDFandTXPQDWY225FveTPUJXS8D91Ddp7FEfaGrvVxuMBGQsyoBYRLu6VMB3Ni2H2Z";
+
+function derivePublicKey(xpub: string, index: number): Uint8Array {
+	const master = HDKey.fromExtendedKey(xpub);
+	const child = master.deriveChild(0).deriveChild(index);
+	if (!child.publicKey) throw new Error("Failed to derive public key");
+	return child.publicKey;
+}
+
+describe("Dogecoin P2PKH encoder", () => {
+	it("produces D... addresses with default version byte 0x1e", () => {
+		const pubkey = derivePublicKey(TEST_XPUB, 0);
+		const address = p2pkhEncoder.encode(pubkey, {});
+		expect(address).toMatch(/^D[1-9A-HJ-NP-Za-km-z]+$/);
+	});
+
+	it("produces different addresses for different indices", () => {
+		const addr0 = p2pkhEncoder.encode(derivePublicKey(TEST_XPUB, 0), {});
+		const addr1 = p2pkhEncoder.encode(derivePublicKey(TEST_XPUB, 1), {});
+		expect(addr0).not.toBe(addr1);
+	});
+
+	it("produces consistent results for the same key", () => {
+		const pubkey = derivePublicKey(TEST_XPUB, 0);
+		const addr1 = p2pkhEncoder.encode(pubkey, {});
+		const addr2 = p2pkhEncoder.encode(pubkey, {});
+		expect(addr1).toBe(addr2);
+	});
+
+	it("respects custom version param", () => {
+		const pubkey = derivePublicKey(TEST_XPUB, 0);
+		// Version byte 0x00 = Bitcoin mainnet P2PKH (starts with 1)
+		const btcAddr = p2pkhEncoder.encode(pubkey, { version: "0" });
+		expect(btcAddr).toMatch(/^1[1-9A-HJ-NP-Za-km-z]+$/);
+	});
+
+	it("address length is 33-34 characters for DOGE", () => {
+		const pubkey = derivePublicKey(TEST_XPUB, 0);
+		const address = p2pkhEncoder.encode(pubkey, {});
+		// P2PKH addresses are typically 25-34 chars, DOGE mainnet usually 34
+		expect(address.length).toBeGreaterThanOrEqual(25);
+		expect(address.length).toBeLessThanOrEqual(34);
+	});
+
+	it("encodeP2pkhAddress function works directly", () => {
+		const pubkey = derivePublicKey(TEST_XPUB, 0);
+		const address = encodeP2pkhAddress(pubkey, 0x1e);
+		expect(address).toMatch(/^D/);
+	});
+
+	it("reports encoding type as p2pkh", () => {
+		expect(p2pkhEncoder.encodingType()).toBe("p2pkh");
+	});
+
+	it("DOGE addresses only contain valid Base58 characters", () => {
+		const pubkey = derivePublicKey(TEST_XPUB, 0);
+		const address = p2pkhEncoder.encode(pubkey, {});
+		// Base58 excludes 0, O, I, l
+		expect(address).not.toMatch(/[0OIl]/);
+	});
+});

package/src/__tests__/litecoin-encoder.test.ts

@@ -0,0 +1,51 @@
+import { HDKey } from "@scure/bip32";
+import { describe, expect, it } from "vitest";
+import { bech32Encoder } from "../litecoin/encoder.js";
+
+const TEST_XPUB =
+	"xpub6BnqJwdqnXEZdkynN5CsrYZr3MULY933SdLrswFfKPDFandTXPQDWY225FveTPUJXS8D91Ddp7FEfaGrvVxuMBGQsyoBYRLu6VMB3Ni2H2Z";
+
+function derivePublicKey(xpub: string, index: number): Uint8Array {
+	const master = HDKey.fromExtendedKey(xpub);
+	const child = master.deriveChild(0).deriveChild(index);
+	if (!child.publicKey) throw new Error("Failed to derive public key");
+	return child.publicKey;
+}
+
+describe("Litecoin bech32 encoder", () => {
+	it("produces ltc1q... addresses", () => {
+		const pubkey = derivePublicKey(TEST_XPUB, 0);
+		const address = bech32Encoder.encode(pubkey, {});
+		expect(address).toMatch(/^ltc1q[a-z0-9]{38,42}$/);
+	});
+
+	it("produces different addresses for different indices", () => {
+		const addr0 = bech32Encoder.encode(derivePublicKey(TEST_XPUB, 0), {});
+		const addr1 = bech32Encoder.encode(derivePublicKey(TEST_XPUB, 1), {});
+		expect(addr0).not.toBe(addr1);
+	});
+
+	it("produces consistent results for the same key", () => {
+		const pubkey = derivePublicKey(TEST_XPUB, 0);
+		const addr1 = bech32Encoder.encode(pubkey, {});
+		const addr2 = bech32Encoder.encode(pubkey, {});
+		expect(addr1).toBe(addr2);
+	});
+
+	it("respects custom hrp param", () => {
+		const pubkey = derivePublicKey(TEST_XPUB, 0);
+		const testnetAddr = bech32Encoder.encode(pubkey, { hrp: "tltc" });
+		expect(testnetAddr).toMatch(/^tltc1q/);
+	});
+
+	it("reports encoding type as bech32", () => {
+		expect(bech32Encoder.encodingType()).toBe("bech32");
+	});
+
+	it("address length is 43 characters (ltc1q + 38 chars for 20-byte witness)", () => {
+		const pubkey = derivePublicKey(TEST_XPUB, 0);
+		const address = bech32Encoder.encode(pubkey, {});
+		// ltc1q... bech32 addresses for 20-byte programs are 43 chars
+		expect(address.length).toBe(43);
+	});
+});