@hexora/core 1.0.0

package/dist/cache.d.ts

@@ -0,0 +1,11 @@
+import { NormalizedTransaction, ChainId } from "./types/index.js";
+declare class TransactionCache {
+    private store;
+    private key;
+    get(address: string, chain: ChainId): NormalizedTransaction[] | null;
+    set(address: string, chain: ChainId, txs: NormalizedTransaction[]): void;
+    clear(): void;
+}
+export declare const txCache: TransactionCache;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAUlE,cAAM,gBAAgB;IACpB,OAAO,CAAC,KAAK,CAAiC;IAE9C,OAAO,CAAC,GAAG;IAIX,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,qBAAqB,EAAE,GAAG,IAAI;IAUpE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,qBAAqB,EAAE,GAAG,IAAI;IAOxE,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,OAAO,kBAAyB,CAAC"}

package/dist/cache.js

@@ -0,0 +1,31 @@
+// In-memory session cache. Privacy-first — no persistence, clears on page unload.
+const CACHE_TTL_MS = 5 * 60 * 1000;
+class TransactionCache {
+    constructor() {
+        this.store = new Map();
+    }
+    key(address, chain) {
+        return `${chain}:${address.toLowerCase()}`;
+    }
+    get(address, chain) {
+        const entry = this.store.get(this.key(address, chain));
+        if (!entry)
+            return null;
+        if (Date.now() - entry.fetchedAt > CACHE_TTL_MS) {
+            this.store.delete(this.key(address, chain));
+            return null;
+        }
+        return entry.transactions;
+    }
+    set(address, chain, txs) {
+        this.store.set(this.key(address, chain), {
+            transactions: txs,
+            fetchedAt: Date.now(),
+        });
+    }
+    clear() {
+        this.store.clear();
+    }
+}
+export const txCache = new TransactionCache();
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAOnC,MAAM,gBAAgB;IAAtB;QACU,UAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IA0BhD,CAAC;IAxBS,GAAG,CAAC,OAAe,EAAE,KAAc;QACzC,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;IAC7C,CAAC;IAED,GAAG,CAAC,OAAe,EAAE,KAAc;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;YAChD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC,YAAY,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,OAAe,EAAE,KAAc,EAAE,GAA4B;QAC/D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE;YACvC,YAAY,EAAE,GAAG;YACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/history/fetcher.d.ts

@@ -0,0 +1,12 @@
+import { ChainId, NormalizedTransaction, HistoryProvider } from "../types/index.js";
+type ApiKeys = Record<string, string | undefined>;
+export declare class DefaultHistoryProvider implements HistoryProvider {
+    private readonly apiKeys;
+    constructor(apiKeys?: ApiKeys);
+    getTransactions(address: string, chain: ChainId, limit: number): Promise<NormalizedTransaction[]>;
+    private getApiKey;
+    private fetchNormal;
+    private fetchToken;
+}
+export {};
+//# sourceMappingURL=fetcher.d.ts.map

package/dist/history/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/history/fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,qBAAqB,EACrB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAe3B,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAuBlD,qBAAa,sBAAuB,YAAW,eAAe;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,GAAE,OAAY;IAE5C,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAyBnC,OAAO,CAAC,SAAS;YASH,WAAW;YAyBX,UAAU;CAwBzB"}

package/dist/history/fetcher.js

@@ -0,0 +1,156 @@
+const EXPLORER_CONFIG = {
+    ethereum: { baseUrl: "https://api.etherscan.io/api" },
+    bnb: { baseUrl: "https://api.bscscan.com/api" },
+    polygon: { baseUrl: "https://api.polygonscan.com/api" },
+    avalanche: { baseUrl: "https://api.snowtrace.io/api" },
+    arbitrum: { baseUrl: "https://api.arbiscan.io/api" },
+    optimism: { baseUrl: "https://api-optimistic.etherscan.io/api" },
+};
+// Works without API key (rate limited). Pass apiKeys for higher limits.
+export class DefaultHistoryProvider {
+    constructor(apiKeys = {}) {
+        this.apiKeys = apiKeys;
+    }
+    async getTransactions(address, chain, limit) {
+        const config = EXPLORER_CONFIG[chain];
+        if (!config)
+            return [];
+        const key = this.getApiKey(chain);
+        const [normal, token] = await Promise.allSettled([
+            this.fetchNormal(config.baseUrl, address, limit, key),
+            this.fetchToken(config.baseUrl, address, limit, key),
+        ]);
+        const results = [];
+        if (normal.status === "fulfilled")
+            results.push(...normal.value);
+        if (token.status === "fulfilled")
+            results.push(...token.value);
+        const seen = new Set();
+        return results
+            .filter((tx) => {
+            if (seen.has(tx.hash))
+                return false;
+            seen.add(tx.hash);
+            return true;
+        })
+            .sort((a, b) => b.timestamp - a.timestamp)
+            .slice(0, limit);
+    }
+    getApiKey(chain) {
+        const map = {
+            ethereum: this.apiKeys["etherscan"],
+            bnb: this.apiKeys["bscscan"],
+            polygon: this.apiKeys["polygonscan"],
+        };
+        return map[chain] ?? "";
+    }
+    async fetchNormal(base, address, limit, key) {
+        const data = await fetchWithRetry(buildUrl(base, {
+            module: "account",
+            action: "txlist",
+            address,
+            startblock: "0",
+            endblock: "99999999",
+            page: "1",
+            offset: String(limit),
+            sort: "desc",
+            apikey: key,
+        }));
+        if (!data?.result || !Array.isArray(data.result))
+            return [];
+        return data.result.map((tx) => normalizeEVMTx(tx, address));
+    }
+    async fetchToken(base, address, limit, key) {
+        const data = await fetchWithRetry(buildUrl(base, {
+            module: "account",
+            action: "tokentx",
+            address,
+            startblock: "0",
+            endblock: "99999999",
+            page: "1",
+            offset: String(limit),
+            sort: "desc",
+            apikey: key,
+        }));
+        if (!data?.result || !Array.isArray(data.result))
+            return [];
+        return data.result.map((tx) => normalizeEVMTokenTx(tx, address));
+    }
+}
+// 0xe19c2253 — batch transfer(address[],address[],address[],uint256[])
+// Real attack tx: 0x05c6e673787275bdff029723492a07f4d9aad9b0e4fbfb7ff95bfb12e641bd48
+const BATCH_POISON_IDS = new Set(["0xe19c2253"]);
+function normalizeEVMTx(tx, userAddress) {
+    const value = BigInt(tx.value || "0");
+    const methodId = tx.input?.slice(0, 10) ?? "0x";
+    return {
+        hash: tx.hash,
+        from: tx.from.toLowerCase(),
+        to: (tx.to || "").toLowerCase(),
+        value,
+        timestamp: Number(tx.timeStamp),
+        blockNumber: Number(tx.blockNumber),
+        isIncoming: tx.to?.toLowerCase() === userAddress.toLowerCase(),
+        contractAddress: tx.contractAddress || undefined,
+        methodId: methodId || undefined,
+        isZeroValue: value === 0n,
+        isBatchPoison: value === 0n && BATCH_POISON_IDS.has(methodId),
+    };
+}
+function normalizeEVMTokenTx(tx, userAddress) {
+    const tokenValue = BigInt(tx.value || "0");
+    return {
+        hash: tx.hash,
+        from: tx.from.toLowerCase(),
+        to: tx.to.toLowerCase(),
+        value: 0n,
+        tokenValue,
+        timestamp: Number(tx.timeStamp),
+        blockNumber: Number(tx.blockNumber),
+        isIncoming: tx.to.toLowerCase() === userAddress.toLowerCase(),
+        contractAddress: tx.contractAddress,
+        isZeroValue: tokenValue === 0n,
+        isBatchPoison: tokenValue === 0n,
+    };
+}
+function buildUrl(base, params) {
+    return (base +
+        "?" +
+        Object.entries(params)
+            .filter(([, v]) => v !== "")
+            .map(([k, v]) => `${k}=${encodeURIComponent(v)}`)
+            .join("&"));
+}
+async function fetchWithRetry(url, retries = 2, delay = 1000) {
+    for (let i = 0; i <= retries; i++) {
+        try {
+            const res = await fetch(url, {
+                headers: { Accept: "application/json" },
+                signal: AbortSignal.timeout(8000),
+            });
+            if (!res.ok) {
+                if (res.status === 429 && i < retries) {
+                    await sleep(delay * (i + 1));
+                    continue;
+                }
+                return null;
+            }
+            const json = await res.json();
+            if (json?.status === "0" && json?.message !== "No transactions found")
+                return null;
+            return json;
+        }
+        catch {
+            if (i < retries) {
+                await sleep(delay);
+                continue;
+            }
+            return null;
+        }
+    }
+    return null;
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=fetcher.js.map

package/dist/history/fetcher.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export type { ChainId, RiskLevel, ScamReason, ErrorCode, NormalizedTransaction, CheckError, EIP1193Provider, PhantomProvider, RawProvider, HexoraProvider, ProviderType, HistoryProvider, } from "./types/index.js";
+export { EVM_CHAIN_MAP } from "./types/index.js";
+export { detectProvider } from "./providers/detector.js";
+export { txCache } from "./cache.js";
+export { validateAddress } from "./validator.js";
+export { calculateSimilarity, findMostSimilar } from "./similarity.js";
+export { DefaultHistoryProvider } from "./history/fetcher.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,SAAS,EACT,UAAU,EACV,SAAS,EACT,qBAAqB,EACrB,UAAU,EACV,eAAe,EACf,eAAe,EACf,WAAW,EACX,cAAc,EACd,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { EVM_CHAIN_MAP } from "./types/index.js";
+export { detectProvider } from "./providers/detector.js";
+export { txCache } from "./cache.js";
+export { validateAddress } from "./validator.js";
+export { calculateSimilarity, findMostSimilar } from "./similarity.js";
+export { DefaultHistoryProvider } from "./history/fetcher.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/providers/detector.d.ts

@@ -0,0 +1,3 @@
+import { RawProvider, HexoraProvider } from "../types/index.js";
+export declare function detectProvider(raw: RawProvider): HexoraProvider;
+//# sourceMappingURL=detector.d.ts.map

package/dist/providers/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/providers/detector.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAGX,cAAc,EAKf,MAAM,mBAAmB,CAAC;AA6E3B,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,cAAc,CAO/D"}

package/dist/providers/detector.js

@@ -0,0 +1,79 @@
+import { EVM_CHAIN_MAP, } from "../types/index.js";
+function isEIP1193(p) {
+    return (typeof p === "object" &&
+        p !== null &&
+        "request" in p &&
+        typeof p.request === "function");
+}
+function isPhantom(p) {
+    return (typeof p === "object" &&
+        p !== null &&
+        ("isPhantom" in p || "publicKey" in p));
+}
+class EVMAdapter {
+    constructor(provider) {
+        this.provider = provider;
+    }
+    isEVM() {
+        return true;
+    }
+    getProviderType() {
+        return "eip1193";
+    }
+    async rawChainId() {
+        try {
+            const id = await this.provider.request({ method: "eth_chainId" });
+            return String(id);
+        }
+        catch {
+            try {
+                const v = await this.provider.request({ method: "net_version" });
+                return "0x" + Number(v).toString(16);
+            }
+            catch {
+                throw buildError("network_unavailable", "Failed to get chainId from provider");
+            }
+        }
+    }
+    async chainId() {
+        const raw = await this.rawChainId();
+        const hex = raw.startsWith("0x") ? raw : "0x" + Number(raw).toString(16);
+        const chain = EVM_CHAIN_MAP[hex];
+        if (!chain)
+            throw buildError("unsupported_chain", `Chain ${raw} is not supported yet`);
+        return chain;
+    }
+}
+class SolanaAdapter {
+    constructor(_provider) {
+        this._provider = _provider;
+    }
+    isEVM() {
+        return false;
+    }
+    getProviderType() {
+        return "phantom";
+    }
+    async rawChainId() {
+        return "solana-mainnet";
+    }
+    async chainId() {
+        return "solana";
+    }
+}
+// Auto-detects provider type and wraps into unified HexoraProvider.
+// Supports all EIP-1193 wallets + Phantom.
+// New chains (Bitcoin, Tron) — add adapter here, nothing else changes.
+export function detectProvider(raw) {
+    if (isEIP1193(raw))
+        return new EVMAdapter(raw);
+    if (isPhantom(raw))
+        return new SolanaAdapter(raw);
+    throw buildError("unknown_provider", "Unknown provider. Must implement EIP-1193 or be Phantom-compatible.");
+}
+function buildError(code, message) {
+    const err = new Error(message);
+    err.hexoraCode = code;
+    return err;
+}
+//# sourceMappingURL=detector.js.map

package/dist/providers/detector.js.map

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

package/dist/similarity.d.ts

@@ -0,0 +1,10 @@
+export declare function normalizeAddress(address: string): string;
+export declare function calculateSimilarity(a: string, b: string): number;
+export interface SimilarityMatch {
+    address: string;
+    similarityScore: number;
+    prefixMatch: boolean;
+    suffixMatch: boolean;
+}
+export declare function findMostSimilar(input: string, known: string[], threshold?: number): SimilarityMatch | null;
+//# sourceMappingURL=similarity.d.ts.map

package/dist/similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../src/similarity.ts"],"names":[],"mappings":"AAGA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAWhE;AAoDD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,GAAE,MAAW,GACrB,eAAe,GAAG,IAAI,CAqBxB"}

package/dist/similarity.js

@@ -0,0 +1,88 @@
+// Weighted similarity: prefix 40% + suffix 40% + levenshtein 20%
+// Mirrors attacker strategy: same first/last chars, different middle.
+export function normalizeAddress(address) {
+    return address.toLowerCase();
+}
+export function calculateSimilarity(a, b) {
+    const na = normalizeAddress(a);
+    const nb = normalizeAddress(b);
+    if (na === nb)
+        return 100;
+    const bodyA = na.startsWith("0x") ? na.slice(2) : na;
+    const bodyB = nb.startsWith("0x") ? nb.slice(2) : nb;
+    return Math.round(prefixSimilarity(bodyA, bodyB, 6) * 0.4 +
+        suffixSimilarity(bodyA, bodyB, 6) * 0.4 +
+        levenshteinSimilarity(bodyA, bodyB) * 0.2);
+}
+function prefixSimilarity(a, b, len) {
+    const pa = a.slice(0, len);
+    const pb = b.slice(0, len);
+    let m = 0;
+    for (let i = 0; i < Math.min(pa.length, pb.length); i++) {
+        const ca = pa[i];
+        const cb = pb[i];
+        if (ca !== undefined && cb !== undefined && ca === cb)
+            m++;
+    }
+    return (m / len) * 100;
+}
+function suffixSimilarity(a, b, len) {
+    const sa = a.slice(-len);
+    const sb = b.slice(-len);
+    let m = 0;
+    for (let i = 0; i < Math.min(sa.length, sb.length); i++) {
+        const ca = sa[i];
+        const cb = sb[i];
+        if (ca !== undefined && cb !== undefined && ca === cb)
+            m++;
+    }
+    return (m / len) * 100;
+}
+function levenshteinSimilarity(a, b) {
+    const maxLen = Math.max(a.length, b.length);
+    if (maxLen === 0)
+        return 100;
+    return Math.round((1 - levenshteinDistance(a, b) / maxLen) * 100);
+}
+function levenshteinDistance(a, b) {
+    const n = b.length;
+    const dp = Array.from({ length: n + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i++) {
+        let prev = dp[0] ?? 0;
+        dp[0] = i;
+        for (let j = 1; j <= n; j++) {
+            const temp = dp[j] ?? 0;
+            const ai = a[i - 1];
+            const bj = b[j - 1];
+            dp[j] =
+                ai !== undefined && bj !== undefined && ai === bj
+                    ? prev
+                    : 1 + Math.min(prev, dp[j] ?? 0, dp[j - 1] ?? 0);
+            prev = temp;
+        }
+    }
+    return dp[n] ?? 0;
+}
+export function findMostSimilar(input, known, threshold = 85) {
+    const ni = normalizeAddress(input);
+    let best = null;
+    for (const addr of known) {
+        if (normalizeAddress(addr) === ni)
+            continue;
+        const score = calculateSimilarity(input, addr);
+        if (score >= threshold && (!best || score > best.similarityScore)) {
+            const bi = ni.startsWith("0x") ? ni.slice(2) : ni;
+            const ba = normalizeAddress(addr).startsWith("0x")
+                ? normalizeAddress(addr).slice(2)
+                : normalizeAddress(addr);
+            best = {
+                address: addr,
+                similarityScore: score,
+                prefixMatch: bi.slice(0, 4) === ba.slice(0, 4),
+                suffixMatch: bi.slice(-4) === ba.slice(-4),
+            };
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=similarity.js.map

package/dist/similarity.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,58 @@
+export type ChainId = "ethereum" | "bnb" | "polygon" | "avalanche" | "arbitrum" | "optimism" | "solana" | "bitcoin" | "tron";
+export declare const EVM_CHAIN_MAP: Record<string, ChainId>;
+export type RiskLevel = "none" | "low" | "medium" | "high" | "critical";
+export type ScamReason = "address_poisoning" | "zero_value_transfer" | "batch_poisoning" | "transferfrom_spoofing" | "dust_attack" | "new_suspicious_address" | "known_phishing" | "malicious_domain" | "phishing_domain" | "typosquat_domain";
+export interface NormalizedTransaction {
+    hash: string;
+    from: string;
+    to: string;
+    value: bigint;
+    tokenValue?: bigint;
+    timestamp: number;
+    blockNumber: number;
+    isIncoming: boolean;
+    contractAddress?: string | undefined;
+    methodId?: string | undefined;
+    isZeroValue: boolean;
+    isBatchPoison: boolean;
+}
+export interface CheckError {
+    code: ErrorCode;
+    message: string;
+}
+export type ErrorCode = "network_unavailable" | "history_fetch_failed" | "unsupported_chain" | "invalid_address" | "unknown_provider" | "rate_limited" | "unknown";
+export interface EIP1193Provider {
+    request(args: {
+        method: string;
+        params?: unknown[];
+    }): Promise<unknown>;
+    on?(event: string, handler: (...args: unknown[]) => void): void;
+    removeListener?(event: string, handler: (...args: unknown[]) => void): void;
+}
+export interface PhantomProvider {
+    isPhantom: boolean;
+    publicKey?: {
+        toString(): string;
+    };
+    connect(): Promise<{
+        publicKey: {
+            toString(): string;
+        };
+    }>;
+    request?(args: {
+        method: string;
+        params?: unknown;
+    }): Promise<unknown>;
+}
+export type RawProvider = EIP1193Provider | PhantomProvider | Record<string, unknown>;
+export interface HexoraProvider {
+    chainId(): Promise<ChainId>;
+    rawChainId(): Promise<string>;
+    isEVM(): boolean;
+    getProviderType(): ProviderType;
+}
+export type ProviderType = "eip1193" | "phantom" | "unknown";
+export interface HistoryProvider {
+    getTransactions(address: string, chain: ChainId, limit: number): Promise<NormalizedTransaction[]>;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,10 @@
+// EVM numeric chain ID → ChainId mapping
+export const EVM_CHAIN_MAP = {
+    "0x1": "ethereum",
+    "0x38": "bnb",
+    "0x89": "polygon",
+    "0xa86a": "avalanche",
+    "0xa4b1": "arbitrum",
+    "0xa": "optimism",
+};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAYA,yCAAyC;AACzC,MAAM,CAAC,MAAM,aAAa,GAA4B;IACpD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,UAAU;CAClB,CAAC"}

package/dist/validator.d.ts

@@ -0,0 +1,3 @@
+import { ChainId } from "./types/index.js";
+export declare function validateAddress(address: string, chain: ChainId): boolean;
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAW3C,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAYxE"}

package/dist/validator.js

@@ -0,0 +1,24 @@
+const EVM_CHAINS = new Set([
+    "ethereum",
+    "bnb",
+    "polygon",
+    "avalanche",
+    "arbitrum",
+    "optimism",
+]);
+export function validateAddress(address, chain) {
+    if (!address || typeof address !== "string")
+        return false;
+    if (EVM_CHAINS.has(chain))
+        return /^0x[0-9a-fA-F]{40}$/.test(address);
+    if (chain === "solana")
+        return /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(address);
+    if (chain === "bitcoin")
+        return (/^1[a-km-zA-HJ-NP-Z1-9]{25,34}$/.test(address) ||
+            /^3[a-km-zA-HJ-NP-Z1-9]{25,34}$/.test(address) ||
+            /^bc1[a-z0-9]{6,87}$/.test(address));
+    if (chain === "tron")
+        return /^T[a-km-zA-HJ-NP-Z1-9]{33}$/.test(address);
+    return address.length > 0;
+}
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,IAAI,GAAG,CAAU;IAClC,UAAU;IACV,KAAK;IACL,SAAS;IACT,WAAW;IACX,UAAU;IACV,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,KAAc;IAC7D,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtE,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7E,IAAI,KAAK,KAAK,SAAS;QACrB,OAAO,CACL,gCAAgC,CAAC,IAAI,CAAC,OAAO,CAAC;YAC9C,gCAAgC,CAAC,IAAI,CAAC,OAAO,CAAC;YAC9C,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CACpC,CAAC;IACJ,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzE,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;AAC5B,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@hexora/core",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "typescript": "^5.5.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint src",
+    "dev": "tsc --watch"
+  }
+}