@wopr-network/crypto-plugins 1.0.1

package/dist/__tests__/solana-watcher.test.js

@@ -0,0 +1,281 @@
+import { describe, expect, it, vi } from "vitest";
+import { SolanaWatcher } from "../solana/watcher.js";
+/** Create a minimal mock WatcherOpts. */
+function createMockOpts(rpcResponses) {
+    // Override global fetch to return mocked RPC responses
+    const mockFetch = vi.fn(async (_url, init) => {
+        const body = JSON.parse(init?.body ?? "{}");
+        const result = rpcResponses.get(body.method);
+        return new Response(JSON.stringify({ jsonrpc: "2.0", id: body.id, result }), {
+            status: 200,
+            headers: { "Content-Type": "application/json" },
+        });
+    });
+    // biome-ignore lint/suspicious/noExplicitAny: test mock override
+    globalThis.fetch = mockFetch;
+    return {
+        rpcUrl: "http://localhost:8899",
+        rpcHeaders: {},
+        oracle: { getPrice: vi.fn().mockResolvedValue({ priceMicros: 150_000_000 }) },
+        cursorStore: {
+            get: vi.fn().mockResolvedValue(null),
+            save: vi.fn().mockResolvedValue(undefined),
+            getConfirmationCount: vi.fn().mockResolvedValue(null),
+            saveConfirmationCount: vi.fn().mockResolvedValue(undefined),
+        },
+        token: "SOL",
+        chain: "solana",
+        decimals: 9,
+        confirmations: 1,
+        _mockFetch: mockFetch,
+    };
+}
+describe("SolanaWatcher", () => {
+    it("initializes with cursor from store", async () => {
+        const rpcResponses = new Map();
+        const opts = createMockOpts(rpcResponses);
+        opts.cursorStore.get = vi.fn().mockResolvedValue(500);
+        const watcher = new SolanaWatcher(opts);
+        await watcher.init();
+        expect(watcher.getCursor()).toBe(500);
+    });
+    it("returns empty when no watched addresses", async () => {
+        const rpcResponses = new Map();
+        const opts = createMockOpts(rpcResponses);
+        const watcher = new SolanaWatcher(opts);
+        await watcher.init();
+        const events = await watcher.poll();
+        expect(events).toEqual([]);
+    });
+    it("returns empty when stopped", async () => {
+        const rpcResponses = new Map();
+        const opts = createMockOpts(rpcResponses);
+        const watcher = new SolanaWatcher(opts);
+        await watcher.init();
+        watcher.setWatchedAddresses(["SomeAddress111111111111111111111111111111111"]);
+        watcher.stop();
+        const events = await watcher.poll();
+        expect(events).toEqual([]);
+    });
+    it("detects native SOL transfer to watched address", async () => {
+        const watchedAddr = "ReceiverAddr1111111111111111111111111111111";
+        const senderAddr = "SenderAddr11111111111111111111111111111111";
+        const mockTx = {
+            slot: 100,
+            blockTime: 1700000000,
+            meta: {
+                err: null,
+                fee: 5000,
+                preBalances: [2_000_000_000, 500_000_000],
+                postBalances: [1_000_000_000, 1_500_000_000],
+            },
+            transaction: {
+                message: {
+                    accountKeys: [senderAddr, watchedAddr],
+                    instructions: [{ programIdIndex: 0, accounts: [0, 1], data: "" }],
+                },
+                signatures: ["sig123abc"],
+            },
+        };
+        const rpcResponses = new Map();
+        rpcResponses.set("getSignaturesForAddress", [
+            {
+                signature: "sig123abc",
+                slot: 100,
+                err: null,
+                memo: null,
+                blockTime: 1700000000,
+                confirmationStatus: "finalized",
+            },
+        ]);
+        rpcResponses.set("getTransaction", mockTx);
+        const opts = createMockOpts(rpcResponses);
+        const watcher = new SolanaWatcher(opts);
+        await watcher.init();
+        watcher.setWatchedAddresses([watchedAddr]);
+        const events = await watcher.poll();
+        expect(events).toHaveLength(1);
+        expect(events[0].txHash).toBe("sig123abc");
+        expect(events[0].to).toBe(watchedAddr);
+        expect(events[0].from).toBe(senderAddr);
+        expect(events[0].rawAmount).toBe("1000000000"); // 1 SOL increase
+        expect(events[0].chain).toBe("solana");
+        expect(events[0].token).toBe("SOL");
+        expect(events[0].blockNumber).toBe(100);
+    });
+    it("advances cursor for finalized transactions", async () => {
+        const watchedAddr = "ReceiverAddr1111111111111111111111111111111";
+        const mockTx = {
+            slot: 200,
+            blockTime: 1700000000,
+            meta: {
+                err: null,
+                fee: 5000,
+                preBalances: [2_000_000_000, 0],
+                postBalances: [1_000_000_000, 1_000_000_000],
+            },
+            transaction: {
+                message: {
+                    accountKeys: ["Sender1111111111111111111111111111111111111", watchedAddr],
+                    instructions: [],
+                },
+                signatures: ["sig456def"],
+            },
+        };
+        const rpcResponses = new Map();
+        rpcResponses.set("getSignaturesForAddress", [
+            {
+                signature: "sig456def",
+                slot: 200,
+                err: null,
+                memo: null,
+                blockTime: 1700000000,
+                confirmationStatus: "finalized",
+            },
+        ]);
+        rpcResponses.set("getTransaction", mockTx);
+        const opts = createMockOpts(rpcResponses);
+        const watcher = new SolanaWatcher(opts);
+        await watcher.init();
+        watcher.setWatchedAddresses([watchedAddr]);
+        await watcher.poll();
+        expect(watcher.getCursor()).toBe(200);
+        expect(opts.cursorStore.save).toHaveBeenCalledWith("solana:solana:SOL", 200);
+    });
+    it("skips errored transactions", async () => {
+        const watchedAddr = "ReceiverAddr1111111111111111111111111111111";
+        const rpcResponses = new Map();
+        rpcResponses.set("getSignaturesForAddress", [
+            {
+                signature: "errored-sig",
+                slot: 300,
+                err: { InstructionError: [0, "Custom"] },
+                memo: null,
+                blockTime: 1700000000,
+                confirmationStatus: "finalized",
+            },
+        ]);
+        const opts = createMockOpts(rpcResponses);
+        const watcher = new SolanaWatcher(opts);
+        await watcher.init();
+        watcher.setWatchedAddresses([watchedAddr]);
+        const events = await watcher.poll();
+        expect(events).toEqual([]);
+    });
+    it("skips already-emitted confirmations", async () => {
+        const watchedAddr = "ReceiverAddr1111111111111111111111111111111";
+        const mockTx = {
+            slot: 400,
+            blockTime: 1700000000,
+            meta: {
+                err: null,
+                fee: 5000,
+                preBalances: [2_000_000_000, 0],
+                postBalances: [1_000_000_000, 1_000_000_000],
+            },
+            transaction: {
+                message: {
+                    accountKeys: ["Sender1111111111111111111111111111111111111", watchedAddr],
+                    instructions: [],
+                },
+                signatures: ["sig-dup"],
+            },
+        };
+        const rpcResponses = new Map();
+        rpcResponses.set("getSignaturesForAddress", [
+            {
+                signature: "sig-dup",
+                slot: 400,
+                err: null,
+                memo: null,
+                blockTime: 1700000000,
+                confirmationStatus: "finalized",
+            },
+        ]);
+        rpcResponses.set("getTransaction", mockTx);
+        const opts = createMockOpts(rpcResponses);
+        // Already emitted at confirmation count 1
+        opts.cursorStore.getConfirmationCount = vi.fn().mockResolvedValue(1);
+        const watcher = new SolanaWatcher(opts);
+        await watcher.init();
+        watcher.setWatchedAddresses([watchedAddr]);
+        const events = await watcher.poll();
+        expect(events).toEqual([]);
+    });
+    it("detects SPL token transfer to watched address", async () => {
+        const watchedAddr = "ReceiverAddr1111111111111111111111111111111";
+        const senderAddr = "SenderAddr11111111111111111111111111111111";
+        const usdcMint = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+        const mockTx = {
+            slot: 500,
+            blockTime: 1700000000,
+            meta: {
+                err: null,
+                fee: 5000,
+                preBalances: [2_000_000_000, 1_000_000],
+                postBalances: [1_995_000_000, 1_000_000],
+                preTokenBalances: [
+                    {
+                        accountIndex: 0,
+                        mint: usdcMint,
+                        uiTokenAmount: { amount: "10000000", decimals: 6, uiAmountString: "10.0" },
+                        owner: senderAddr,
+                    },
+                    {
+                        accountIndex: 1,
+                        mint: usdcMint,
+                        uiTokenAmount: { amount: "0", decimals: 6, uiAmountString: "0.0" },
+                        owner: watchedAddr,
+                    },
+                ],
+                postTokenBalances: [
+                    {
+                        accountIndex: 0,
+                        mint: usdcMint,
+                        uiTokenAmount: { amount: "5000000", decimals: 6, uiAmountString: "5.0" },
+                        owner: senderAddr,
+                    },
+                    {
+                        accountIndex: 1,
+                        mint: usdcMint,
+                        uiTokenAmount: { amount: "5000000", decimals: 6, uiAmountString: "5.0" },
+                        owner: watchedAddr,
+                    },
+                ],
+            },
+            transaction: {
+                message: {
+                    accountKeys: [senderAddr, watchedAddr],
+                    instructions: [],
+                },
+                signatures: ["spl-sig-789"],
+            },
+        };
+        const rpcResponses = new Map();
+        rpcResponses.set("getSignaturesForAddress", [
+            {
+                signature: "spl-sig-789",
+                slot: 500,
+                err: null,
+                memo: null,
+                blockTime: 1700000000,
+                confirmationStatus: "finalized",
+            },
+        ]);
+        rpcResponses.set("getTransaction", mockTx);
+        const opts = createMockOpts(rpcResponses);
+        // Configure as SPL token watcher
+        const splOpts = { ...opts, token: "USDC", contractAddress: usdcMint };
+        const watcher = new SolanaWatcher(splOpts);
+        await watcher.init();
+        watcher.setWatchedAddresses([watchedAddr]);
+        const events = await watcher.poll();
+        expect(events).toHaveLength(1);
+        expect(events[0].txHash).toBe("spl-sig-789");
+        expect(events[0].to).toBe(watchedAddr);
+        expect(events[0].from).toBe(senderAddr);
+        expect(events[0].rawAmount).toBe("5000000"); // 5 USDC
+        expect(events[0].token).toBe("USDC");
+    });
+});
+//# sourceMappingURL=solana-watcher.test.js.map

package/dist/__tests__/solana-watcher.test.js.map

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

package/dist/__tests__/sweep-key-parity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sweep-key-parity.test.d.ts.map

package/dist/__tests__/sweep-key-parity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep-key-parity.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sweep-key-parity.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/sweep-key-parity.test.js

@@ -0,0 +1,236 @@
+import { ed25519 } from "@noble/curves/ed25519.js";
+import { hmac } from "@noble/hashes/hmac.js";
+import { sha512 } from "@noble/hashes/sha2.js";
+import { HDKey } from "@scure/bip32";
+import * as bip39 from "@scure/bip39";
+import { privateKeyToAccount } from "viem/accounts";
+import { describe, expect, it } from "vitest";
+import { bech32Encoder } from "../bitcoin/encoder.js";
+import { p2pkhEncoder } from "../dogecoin/encoder.js";
+import { EvmAddressEncoder } from "../evm/encoder.js";
+import { bech32Encoder as ltcBech32Encoder } from "../litecoin/encoder.js";
+import { SolanaAddressEncoder } from "../solana/encoder.js";
+import { keccakB58Encoder } from "../tron/encoder.js";
+// ---------------------------------------------------------------------------
+// Well-known BIP-39 test mnemonic (public, never use in production)
+// ---------------------------------------------------------------------------
+const TEST_MNEMONIC = "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about";
+const TEST_SEED = bip39.mnemonicToSeedSync(TEST_MNEMONIC);
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function toHex(bytes) {
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+function privKeyHex(key) {
+    return `0x${toHex(key)}`;
+}
+const SECP256K1_CHAINS = [
+    {
+        name: "Bitcoin",
+        coinType: 0,
+        encoder: bech32Encoder,
+        params: { hrp: "bc" },
+        addrRegex: /^bc1q/,
+    },
+    {
+        name: "Litecoin",
+        coinType: 2,
+        encoder: ltcBech32Encoder,
+        params: { hrp: "ltc" },
+        addrRegex: /^ltc1q/,
+    },
+    {
+        name: "Dogecoin",
+        coinType: 3,
+        encoder: p2pkhEncoder,
+        params: { version: "0x1e" },
+        addrRegex: /^D/,
+    },
+    {
+        name: "EVM",
+        coinType: 60,
+        encoder: new EvmAddressEncoder(),
+        params: {},
+        addrRegex: /^0x[0-9a-fA-F]{40}$/,
+    },
+    {
+        name: "Tron",
+        coinType: 195,
+        encoder: keccakB58Encoder,
+        params: { version: "0x41" },
+        addrRegex: /^T/,
+    },
+];
+function slip0010MasterKey(seed) {
+    const I = hmac(sha512, new TextEncoder().encode("ed25519 seed"), seed);
+    return {
+        privateKey: I.slice(0, 32),
+        chainCode: I.slice(32),
+    };
+}
+function slip0010DeriveChild(parent, index) {
+    // SLIP-0010 Ed25519: only hardened derivation (index >= 0x80000000)
+    const hardenedIndex = (index | 0x80000000) >>> 0;
+    const data = new Uint8Array(1 + 32 + 4);
+    data[0] = 0x00;
+    data.set(parent.privateKey, 1);
+    const view = new DataView(data.buffer);
+    view.setUint32(33, hardenedIndex, false); // big-endian
+    const I = hmac(sha512, parent.chainCode, data);
+    return {
+        privateKey: I.slice(0, 32),
+        chainCode: I.slice(32),
+    };
+}
+function slip0010DerivePath(seed, path) {
+    let key = slip0010MasterKey(seed);
+    for (const index of path) {
+        key = slip0010DeriveChild(key, index);
+    }
+    return key;
+}
+// ===========================================================================
+// Tests
+// ===========================================================================
+describe("sweep key parity -- mnemonic private key controls derived address", () => {
+    // -----------------------------------------------------------------------
+    // secp256k1 chains: pubkey from xpub must equal pubkey from privkey
+    // -----------------------------------------------------------------------
+    describe("secp256k1 chains", () => {
+        for (const chain of SECP256K1_CHAINS) {
+            const path = `m/44'/${chain.coinType}'/0'`;
+            it(`${chain.name}: privkey pubkey matches xpub pubkey at indices 0-4`, () => {
+                const masterHD = HDKey.fromMasterSeed(TEST_SEED);
+                const accountKey = masterHD.derive(path);
+                const xpub = accountKey.publicExtendedKey;
+                for (let i = 0; i < 5; i++) {
+                    // From full key (has private key): derive external chain (0), index i
+                    const fullChild = accountKey.deriveChild(0).deriveChild(i);
+                    // From xpub only: derive external chain (0), index i
+                    const xpubChild = HDKey.fromExtendedKey(xpub).deriveChild(0).deriveChild(i);
+                    const fullPk = fullChild.publicKey;
+                    const xpubPk = xpubChild.publicKey;
+                    expect(fullPk).toBeDefined();
+                    expect(xpubPk).toBeDefined();
+                    expect(toHex(fullPk)).toBe(toHex(xpubPk));
+                }
+            });
+            it(`${chain.name}: encoder produces valid address from derived pubkey`, () => {
+                const masterHD = HDKey.fromMasterSeed(TEST_SEED);
+                const accountKey = masterHD.derive(path);
+                const xpub = accountKey.publicExtendedKey;
+                for (let i = 0; i < 5; i++) {
+                    const xpubChild = HDKey.fromExtendedKey(xpub).deriveChild(0).deriveChild(i);
+                    const pubkey = xpubChild.publicKey;
+                    const address = chain.encoder.encode(pubkey, chain.params);
+                    expect(address).toMatch(chain.addrRegex);
+                }
+            });
+            it(`${chain.name}: different indices produce different addresses`, () => {
+                const masterHD = HDKey.fromMasterSeed(TEST_SEED);
+                const accountKey = masterHD.derive(path);
+                const xpub = accountKey.publicExtendedKey;
+                const addresses = new Set();
+                for (let i = 0; i < 5; i++) {
+                    const xpubChild = HDKey.fromExtendedKey(xpub).deriveChild(0).deriveChild(i);
+                    const pubkey = xpubChild.publicKey;
+                    const address = chain.encoder.encode(pubkey, chain.params);
+                    addresses.add(address);
+                }
+                expect(addresses.size).toBe(5);
+            });
+            it(`${chain.name}: derivation is deterministic`, () => {
+                const masterHD = HDKey.fromMasterSeed(TEST_SEED);
+                const accountKey = masterHD.derive(path);
+                const xpub = accountKey.publicExtendedKey;
+                const xpubChild = HDKey.fromExtendedKey(xpub).deriveChild(0).deriveChild(3);
+                const pubkey = xpubChild.publicKey;
+                const addr1 = chain.encoder.encode(pubkey, chain.params);
+                const addr2 = chain.encoder.encode(pubkey, chain.params);
+                expect(addr1).toBe(addr2);
+            });
+        }
+    });
+    // -----------------------------------------------------------------------
+    // EVM signing proof: viem privateKeyToAccount matches encoder output
+    // -----------------------------------------------------------------------
+    describe("EVM signing proof", () => {
+        it("viem privateKeyToAccount matches encoder output at indices 0-9", () => {
+            const evmPath = "m/44'/60'/0'";
+            const masterHD = HDKey.fromMasterSeed(TEST_SEED);
+            const accountKey = masterHD.derive(evmPath);
+            const encoder = new EvmAddressEncoder();
+            for (let i = 0; i < 10; i++) {
+                const child = accountKey.deriveChild(0).deriveChild(i);
+                const privKey = child.privateKey;
+                const pubKey = child.publicKey;
+                // Address from encoder (pubkey -> keccak -> EIP-55)
+                const encoderAddr = encoder.encode(pubKey, {});
+                // Address from viem (privkey -> account -> address)
+                const viemAccount = privateKeyToAccount(privKeyHex(privKey));
+                expect(viemAccount.address.toLowerCase()).toBe(encoderAddr.toLowerCase());
+            }
+        });
+        it("viem treasury key matches encoder output", () => {
+            const evmPath = "m/44'/60'/0'";
+            const masterHD = HDKey.fromMasterSeed(TEST_SEED);
+            const accountKey = masterHD.derive(evmPath);
+            const encoder = new EvmAddressEncoder();
+            // Treasury: chain index 1, address index 0
+            const child = accountKey.deriveChild(1).deriveChild(0);
+            const privKey = child.privateKey;
+            const pubKey = child.publicKey;
+            const encoderAddr = encoder.encode(pubKey, {});
+            const viemAccount = privateKeyToAccount(privKeyHex(privKey));
+            expect(viemAccount.address.toLowerCase()).toBe(encoderAddr.toLowerCase());
+        });
+    });
+    // -----------------------------------------------------------------------
+    // Solana Ed25519 (SLIP-0010 derivation)
+    // -----------------------------------------------------------------------
+    describe("Solana Ed25519", () => {
+        const solanaEncoder = new SolanaAddressEncoder();
+        it("SLIP-0010 derivation produces valid Solana address", () => {
+            // m/44'/501'/0'/0' -- all hardened for SLIP-0010 Ed25519
+            const derived = slip0010DerivePath(TEST_SEED, [44, 501, 0, 0]);
+            const publicKey = ed25519.getPublicKey(derived.privateKey);
+            expect(publicKey.length).toBe(32);
+            const address = solanaEncoder.encode(publicKey, {});
+            // Valid Base58 string, typical Solana address length 32-44 chars
+            expect(address).toMatch(/^[1-9A-HJ-NP-Za-km-z]+$/);
+            expect(address.length).toBeGreaterThanOrEqual(32);
+            expect(address.length).toBeLessThanOrEqual(44);
+        });
+        it("same seed always produces same address", () => {
+            const derived1 = slip0010DerivePath(TEST_SEED, [44, 501, 0, 0]);
+            const pub1 = ed25519.getPublicKey(derived1.privateKey);
+            const addr1 = solanaEncoder.encode(pub1, {});
+            const derived2 = slip0010DerivePath(TEST_SEED, [44, 501, 0, 0]);
+            const pub2 = ed25519.getPublicKey(derived2.privateKey);
+            const addr2 = solanaEncoder.encode(pub2, {});
+            expect(addr1).toBe(addr2);
+        });
+        it("different account indices produce different addresses", () => {
+            const addresses = new Set();
+            for (let i = 0; i < 5; i++) {
+                // m/44'/501'/i'/0'
+                const derived = slip0010DerivePath(TEST_SEED, [44, 501, i, 0]);
+                const publicKey = ed25519.getPublicKey(derived.privateKey);
+                const address = solanaEncoder.encode(publicKey, {});
+                addresses.add(address);
+            }
+            expect(addresses.size).toBe(5);
+        });
+        it("privkey and pubkey are consistent via Ed25519", () => {
+            const derived = slip0010DerivePath(TEST_SEED, [44, 501, 0, 0]);
+            const publicKey = ed25519.getPublicKey(derived.privateKey);
+            // Sign something and verify to prove the key pair is valid
+            const message = new TextEncoder().encode("test message");
+            const signature = ed25519.sign(message, derived.privateKey);
+            const valid = ed25519.verify(signature, message, publicKey);
+            expect(valid).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=sweep-key-parity.test.js.map

package/dist/__tests__/sweep-key-parity.test.js.map

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

package/dist/__tests__/tron-encoder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tron-encoder.test.d.ts.map

package/dist/__tests__/tron-encoder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tron-encoder.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tron-encoder.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/tron-encoder.test.js

@@ -0,0 +1,93 @@
+import { HDKey } from "@scure/bip32";
+import { describe, expect, it } from "vitest";
+import { hexToTron, isTronAddress, tronToHex } from "../tron/address-convert.js";
+import { encodeKeccakB58Address, keccakB58Encoder } from "../tron/encoder.js";
+const TEST_XPUB = "xpub6BnqJwdqnXEZdkynN5CsrYZr3MULY933SdLrswFfKPDFandTXPQDWY225FveTPUJXS8D91Ddp7FEfaGrvVxuMBGQsyoBYRLu6VMB3Ni2H2Z";
+function derivePublicKey(xpub, index) {
+    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("Tron keccak-b58check encoder", () => {
+    it("produces T... addresses with default version byte 0x41", () => {
+        const pubkey = derivePublicKey(TEST_XPUB, 0);
+        const address = keccakB58Encoder.encode(pubkey, {});
+        expect(address).toMatch(/^T[1-9A-HJ-NP-Za-km-z]+$/);
+    });
+    it("index 0 produces TDTkBJWfXqfCPhNAgHxmgPNHigJEg4ghww", () => {
+        const pubkey = derivePublicKey(TEST_XPUB, 0);
+        const address = keccakB58Encoder.encode(pubkey, {});
+        expect(address).toBe("TDTkBJWfXqfCPhNAgHxmgPNHigJEg4ghww");
+    });
+    it("produces different addresses for different indices", () => {
+        const addr0 = keccakB58Encoder.encode(derivePublicKey(TEST_XPUB, 0), {});
+        const addr1 = keccakB58Encoder.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 = keccakB58Encoder.encode(pubkey, {});
+        const addr2 = keccakB58Encoder.encode(pubkey, {});
+        expect(addr1).toBe(addr2);
+    });
+    it("respects custom version param", () => {
+        const pubkey = derivePublicKey(TEST_XPUB, 0);
+        // Different version byte produces different address
+        const addr41 = keccakB58Encoder.encode(pubkey, {});
+        const addr00 = keccakB58Encoder.encode(pubkey, { version: "0" });
+        expect(addr41).not.toBe(addr00);
+    });
+    it("encodeKeccakB58Address function works directly", () => {
+        const pubkey = derivePublicKey(TEST_XPUB, 0);
+        const address = encodeKeccakB58Address(pubkey, 0x41);
+        expect(address).toMatch(/^T/);
+    });
+    it("reports encoding type as keccak-b58check", () => {
+        expect(keccakB58Encoder.encodingType()).toBe("keccak-b58check");
+    });
+    it("addresses only contain valid Base58 characters", () => {
+        const pubkey = derivePublicKey(TEST_XPUB, 0);
+        const address = keccakB58Encoder.encode(pubkey, {});
+        expect(address).not.toMatch(/[0OIl]/);
+    });
+});
+describe("Tron address conversion", () => {
+    it("tronToHex converts T... to 0x hex", () => {
+        const pubkey = derivePublicKey(TEST_XPUB, 0);
+        const tronAddr = keccakB58Encoder.encode(pubkey, {});
+        const hex = tronToHex(tronAddr);
+        expect(hex).toMatch(/^0x[0-9a-f]{40}$/);
+    });
+    it("hexToTron converts 0x hex back to T...", () => {
+        const pubkey = derivePublicKey(TEST_XPUB, 0);
+        const tronAddr = keccakB58Encoder.encode(pubkey, {});
+        const hex = tronToHex(tronAddr);
+        const roundTrip = hexToTron(hex);
+        expect(roundTrip).toBe(tronAddr);
+    });
+    it("tronToHex throws on non-T address", () => {
+        expect(() => tronToHex("D7abc123")).toThrow("Not a Tron address");
+    });
+    it("hexToTron throws on wrong-length hex", () => {
+        expect(() => hexToTron("0x1234")).toThrow("Invalid hex address length");
+    });
+    it("isTronAddress detects T... addresses", () => {
+        const pubkey = derivePublicKey(TEST_XPUB, 0);
+        const tronAddr = keccakB58Encoder.encode(pubkey, {});
+        expect(isTronAddress(tronAddr)).toBe(true);
+        expect(isTronAddress("0x1234567890abcdef1234567890abcdef12345678")).toBe(false);
+        expect(isTronAddress("D7abcdef")).toBe(false);
+    });
+    it("round-trip through multiple addresses", () => {
+        for (let i = 0; i < 5; i++) {
+            const pubkey = derivePublicKey(TEST_XPUB, i);
+            const tronAddr = keccakB58Encoder.encode(pubkey, {});
+            const hex = tronToHex(tronAddr);
+            const back = hexToTron(hex);
+            expect(back).toBe(tronAddr);
+        }
+    });
+});
+//# sourceMappingURL=tron-encoder.test.js.map