@echoclaw/echo-0g 1.0.0

package/dist/chainscan/client.d.ts

@@ -0,0 +1,28 @@
+import type { ChainScanTx, ChainScanTokenTransfer, ChainScanNftTransfer, ChainScanBalanceMulti, ChainScanTxStatus, ChainScanTxReceipt, ChainScanContractSource, ChainScanContractCreation, ChainScanDecodedMethod, ChainScanDecodedRaw, ChainScanTokenHolderStat, ChainScanTokenTransferStat, ChainScanUniqueParticipantStat, ChainScanTopAddress, PaginationOpts, StatsPaginationOpts } from "./types.js";
+export declare const chainscanClient: {
+    getBalance(address: string, tag?: string): Promise<string>;
+    getBalanceMulti(addresses: string[], tag?: string): Promise<ChainScanBalanceMulti[]>;
+    getTransactions(address: string, opts?: PaginationOpts): Promise<ChainScanTx[]>;
+    getTokenTransfers(address: string, opts?: PaginationOpts & {
+        contractaddress?: string;
+    }): Promise<ChainScanTokenTransfer[]>;
+    getNftTransfers(address: string, opts?: PaginationOpts & {
+        contractaddress?: string;
+    }): Promise<ChainScanNftTransfer[]>;
+    getTokenBalance(address: string, contractAddress: string): Promise<string>;
+    getTxStatus(txHash: string): Promise<ChainScanTxStatus>;
+    getTxReceiptStatus(txHash: string): Promise<ChainScanTxReceipt>;
+    getContractAbi(address: string): Promise<string>;
+    getContractSource(address: string): Promise<ChainScanContractSource[]>;
+    getContractCreation(addresses: string[]): Promise<ChainScanContractCreation[]>;
+    decodeByHashes(hashes: string[]): Promise<ChainScanDecodedMethod[]>;
+    decodeRaw(contracts: string[], inputs: string[]): Promise<ChainScanDecodedRaw[]>;
+    getTokenSupply(contractAddress: string): Promise<string>;
+    getTokenHolderStats(contract: string, opts?: StatsPaginationOpts): Promise<ChainScanTokenHolderStat[]>;
+    getTokenTransferStats(contract: string, opts?: StatsPaginationOpts): Promise<ChainScanTokenTransferStat[]>;
+    getTokenUniqueParticipants(contract: string, opts?: StatsPaginationOpts): Promise<ChainScanUniqueParticipantStat[]>;
+    getTopTokenSenders(spanType?: "24h" | "3d" | "7d"): Promise<ChainScanTopAddress[]>;
+    getTopTokenReceivers(spanType?: "24h" | "3d" | "7d"): Promise<ChainScanTopAddress[]>;
+    getTopTokenParticipants(spanType?: "24h" | "3d" | "7d"): Promise<ChainScanTopAddress[]>;
+};
+//# sourceMappingURL=client.d.ts.map

package/dist/chainscan/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/chainscan/client.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,WAAW,EACX,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAkLpB,eAAO,MAAM,eAAe;wBAGN,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;+BAW/B,MAAM,EAAE,QAAQ,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;6BAW3D,MAAM,SAAS,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;+BAepD,MAAM,SAAS,cAAc,GAAG;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;6BAmBlG,MAAM,SAAS,cAAc,GAAG;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;6BAmB9F,MAAM,mBAAmB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;wBActD,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;+BAS5B,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;4BAWvC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;+BASrB,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;mCASvC,MAAM,EAAE,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC;2BAWvD,MAAM,EAAE,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;yBAQ9C,MAAM,EAAE,UAAU,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;oCAmBhD,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;kCAWpB,MAAM,SAAS,mBAAmB,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC;oCAetE,MAAM,SAAS,mBAAmB,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;yCAerE,MAAM,SAAS,mBAAmB,GAAG,OAAO,CAAC,8BAA8B,EAAE,CAAC;kCAetF,KAAK,GAAG,IAAI,GAAG,IAAI,GAAW,OAAO,CAAC,mBAAmB,EAAE,CAAC;oCAK1D,KAAK,GAAG,IAAI,GAAG,IAAI,GAAW,OAAO,CAAC,mBAAmB,EAAE,CAAC;uCAKzD,KAAK,GAAG,IAAI,GAAG,IAAI,GAAW,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAIrG,CAAC"}

package/dist/chainscan/client.js

@@ -0,0 +1,361 @@
+import { EchoError, ErrorCodes } from "../errors.js";
+import { loadConfig } from "../config/store.js";
+import logger from "../utils/logger.js";
+import { TokenBucket, ConcurrencyLimiter } from "../utils/rateLimit.js";
+import { CHAINSCAN_DEFAULTS } from "./constants.js";
+import { validateAddress, validateTxHash, validateAddressBatch, validateHashBatch, validatePagination, validateStatsPagination, validateTag, } from "./validation.js";
+// --- Instances ---
+const bucket = new TokenBucket(CHAINSCAN_DEFAULTS.RATE_LIMIT_PER_SEC);
+const limiter = new ConcurrencyLimiter(CHAINSCAN_DEFAULTS.MAX_CONCURRENT);
+// --- Helpers ---
+function getBaseUrl() {
+    return loadConfig().services.chainScanBaseUrl;
+}
+function getApiKey() {
+    return process.env.CHAINSCAN_API_KEY ?? "";
+}
+async function withRetry(fn, maxRetries = CHAINSCAN_DEFAULTS.MAX_RETRIES) {
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            const msg = lastError.message;
+            const isRetryable = msg.includes("429") || /HTTP [5]\d{2}/.test(msg);
+            if (!isRetryable || attempt === maxRetries)
+                throw lastError;
+            const backoff = Math.min(1000 * 2 ** attempt, 8000) + Math.random() * 500;
+            logger.warn(`[ChainScan] Retry ${attempt + 1}/${maxRetries} after ${Math.round(backoff)}ms: ${msg}`);
+            await new Promise(resolve => setTimeout(resolve, backoff));
+        }
+    }
+    throw lastError;
+}
+// --- Etherscan-style fetch: GET /api?module=...&action=... ---
+async function fetchEtherscanApi(params) {
+    await bucket.acquire();
+    await limiter.acquire();
+    try {
+        return await withRetry(async () => {
+            const url = new URL(`${getBaseUrl()}${CHAINSCAN_DEFAULTS.API_PATH}`);
+            for (const [k, v] of Object.entries(params)) {
+                url.searchParams.set(k, v);
+            }
+            const apiKey = getApiKey();
+            if (apiKey)
+                url.searchParams.set("apikey", apiKey);
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), CHAINSCAN_DEFAULTS.TIMEOUT_MS);
+            try {
+                const res = await fetch(url.toString(), { signal: controller.signal });
+                if (!res.ok) {
+                    if (res.status === 429) {
+                        throw new EchoError(ErrorCodes.CHAINSCAN_RATE_LIMITED, `ChainScan HTTP 429`);
+                    }
+                    throw new EchoError(ErrorCodes.CHAINSCAN_API_ERROR, `ChainScan HTTP ${res.status}`);
+                }
+                const json = (await res.json());
+                if (json.status !== "1" && json.message !== "OK") {
+                    if (json.message === "No transactions found" || json.result === null || json.message === "No records found") {
+                        return [];
+                    }
+                    throw new EchoError(ErrorCodes.CHAINSCAN_API_ERROR, json.message || "ChainScan API error", "Check the request parameters");
+                }
+                return json.result;
+            }
+            catch (err) {
+                if (err instanceof EchoError)
+                    throw err;
+                if (err instanceof Error && err.name === "AbortError") {
+                    throw new EchoError(ErrorCodes.CHAINSCAN_TIMEOUT, `ChainScan request timed out after ${CHAINSCAN_DEFAULTS.TIMEOUT_MS}ms`, "Try again or check network connectivity");
+                }
+                throw new EchoError(ErrorCodes.CHAINSCAN_API_ERROR, err instanceof Error ? err.message : "ChainScan request failed");
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        });
+    }
+    finally {
+        limiter.release();
+    }
+}
+// --- Custom endpoints fetch: GET /util/decode/..., /nft/..., /statistics/... ---
+async function fetchCustomApi(path, params = {}) {
+    await bucket.acquire();
+    await limiter.acquire();
+    try {
+        return await withRetry(async () => {
+            const url = new URL(`${getBaseUrl()}${path}`);
+            for (const [k, v] of Object.entries(params)) {
+                url.searchParams.set(k, v);
+            }
+            const apiKey = getApiKey();
+            if (apiKey)
+                url.searchParams.set("apikey", apiKey);
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), CHAINSCAN_DEFAULTS.TIMEOUT_MS);
+            try {
+                const res = await fetch(url.toString(), { signal: controller.signal });
+                if (!res.ok) {
+                    if (res.status === 429) {
+                        throw new EchoError(ErrorCodes.CHAINSCAN_RATE_LIMITED, `ChainScan HTTP 429`);
+                    }
+                    throw new EchoError(ErrorCodes.CHAINSCAN_API_ERROR, `ChainScan HTTP ${res.status}`);
+                }
+                const json = await res.json();
+                // Defensively handle both response formats
+                // Etherscan-style: { status: "1", message: "OK", result: T }
+                if (typeof json.status === "string" && json.status === "1") {
+                    return json.result;
+                }
+                // Custom-style: { status: 0, message: "success", result: T }
+                if (typeof json.status === "number" && json.status === 0) {
+                    return json.result;
+                }
+                // NFT/data-style: { code: 0, message: "...", data: T }
+                if (typeof json.code === "number" && json.code === 0 && json.data !== undefined) {
+                    return json.data;
+                }
+                // Fallback: if result is present, return it
+                if (json.result !== undefined && json.result !== null) {
+                    return json.result;
+                }
+                // Array response (some endpoints return raw arrays)
+                if (Array.isArray(json)) {
+                    return json;
+                }
+                throw new EchoError(ErrorCodes.CHAINSCAN_INVALID_RESPONSE, `Unexpected ChainScan response format`, `status=${String(json.status)}, message=${String(json.message)}`);
+            }
+            catch (err) {
+                if (err instanceof EchoError)
+                    throw err;
+                if (err instanceof Error && err.name === "AbortError") {
+                    throw new EchoError(ErrorCodes.CHAINSCAN_TIMEOUT, `ChainScan request timed out after ${CHAINSCAN_DEFAULTS.TIMEOUT_MS}ms`, "Try again or check network connectivity");
+                }
+                throw new EchoError(ErrorCodes.CHAINSCAN_API_ERROR, err instanceof Error ? err.message : "ChainScan request failed");
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        });
+    }
+    finally {
+        limiter.release();
+    }
+}
+// --- Public API ---
+export const chainscanClient = {
+    // === Account ===
+    getBalance(address, tag) {
+        const addr = validateAddress(address);
+        const validTag = validateTag(tag);
+        return fetchEtherscanApi({
+            module: "account",
+            action: "balance",
+            address: addr.toLowerCase(),
+            tag: validTag,
+        });
+    },
+    getBalanceMulti(addresses, tag) {
+        const validated = validateAddressBatch(addresses, CHAINSCAN_DEFAULTS.MAX_BATCH_BALANCE);
+        const validTag = validateTag(tag);
+        return fetchEtherscanApi({
+            module: "account",
+            action: "balancemulti",
+            address: validated.map(a => a.toLowerCase()).join(","),
+            tag: validTag,
+        });
+    },
+    getTransactions(address, opts) {
+        const addr = validateAddress(address);
+        const pag = validatePagination(opts);
+        return fetchEtherscanApi({
+            module: "account",
+            action: "txlist",
+            address: addr.toLowerCase(),
+            startblock: pag.startblock ?? "0",
+            endblock: pag.endblock ?? "99999999",
+            page: String(pag.page),
+            offset: String(pag.offset),
+            sort: pag.sort,
+        });
+    },
+    getTokenTransfers(address, opts) {
+        const addr = validateAddress(address);
+        const pag = validatePagination(opts);
+        const params = {
+            module: "account",
+            action: "tokentx",
+            address: addr.toLowerCase(),
+            startblock: pag.startblock ?? "0",
+            endblock: pag.endblock ?? "99999999",
+            page: String(pag.page),
+            offset: String(pag.offset),
+            sort: pag.sort,
+        };
+        if (opts?.contractaddress) {
+            params.contractaddress = validateAddress(opts.contractaddress, "contractaddress").toLowerCase();
+        }
+        return fetchEtherscanApi(params);
+    },
+    getNftTransfers(address, opts) {
+        const addr = validateAddress(address);
+        const pag = validatePagination(opts);
+        const params = {
+            module: "account",
+            action: "tokennfttx",
+            address: addr.toLowerCase(),
+            startblock: pag.startblock ?? "0",
+            endblock: pag.endblock ?? "99999999",
+            page: String(pag.page),
+            offset: String(pag.offset),
+            sort: pag.sort,
+        };
+        if (opts?.contractaddress) {
+            params.contractaddress = validateAddress(opts.contractaddress, "contractaddress").toLowerCase();
+        }
+        return fetchEtherscanApi(params);
+    },
+    getTokenBalance(address, contractAddress) {
+        const addr = validateAddress(address);
+        const contract = validateAddress(contractAddress, "contractAddress");
+        return fetchEtherscanApi({
+            module: "account",
+            action: "tokenbalance",
+            address: addr.toLowerCase(),
+            contractaddress: contract.toLowerCase(),
+            tag: "latest",
+        });
+    },
+    // === Transaction verification ===
+    getTxStatus(txHash) {
+        const hash = validateTxHash(txHash);
+        return fetchEtherscanApi({
+            module: "transaction",
+            action: "getstatus",
+            txhash: hash,
+        });
+    },
+    getTxReceiptStatus(txHash) {
+        const hash = validateTxHash(txHash);
+        return fetchEtherscanApi({
+            module: "transaction",
+            action: "gettxreceiptstatus",
+            txhash: hash,
+        });
+    },
+    // === Contract intel ===
+    getContractAbi(address) {
+        const addr = validateAddress(address);
+        return fetchEtherscanApi({
+            module: "contract",
+            action: "getabi",
+            address: addr.toLowerCase(),
+        });
+    },
+    getContractSource(address) {
+        const addr = validateAddress(address);
+        return fetchEtherscanApi({
+            module: "contract",
+            action: "getsourcecode",
+            address: addr.toLowerCase(),
+        });
+    },
+    getContractCreation(addresses) {
+        const validated = validateAddressBatch(addresses, CHAINSCAN_DEFAULTS.MAX_BATCH_ADDRESSES);
+        return fetchEtherscanApi({
+            module: "contract",
+            action: "getcontractcreation",
+            contractaddresses: validated.map(a => a.toLowerCase()).join(","),
+        });
+    },
+    // === Decode ===
+    decodeByHashes(hashes) {
+        const validated = validateHashBatch(hashes, CHAINSCAN_DEFAULTS.MAX_BATCH_DECODE);
+        return fetchCustomApi("/util/decode/method", { hashes: validated.join(",") });
+    },
+    decodeRaw(contracts, inputs) {
+        if (contracts.length !== inputs.length) {
+            throw new EchoError(ErrorCodes.INVALID_AMOUNT, `contracts (${contracts.length}) and inputs (${inputs.length}) must have same length`);
+        }
+        const validatedContracts = validateAddressBatch(contracts, CHAINSCAN_DEFAULTS.MAX_BATCH_DECODE);
+        return fetchCustomApi("/util/decode/method/raw", {
+            contracts: validatedContracts.map(a => a.toLowerCase()).join(","),
+            inputs: inputs.join(","),
+        });
+    },
+    // === Token supply ===
+    getTokenSupply(contractAddress) {
+        const addr = validateAddress(contractAddress, "contractAddress");
+        return fetchEtherscanApi({
+            module: "stats",
+            action: "tokensupply",
+            contractaddress: addr.toLowerCase(),
+        });
+    },
+    // === Meme coin intel (statistics endpoints) ===
+    async getTokenHolderStats(contract, opts) {
+        const addr = validateAddress(contract, "contract");
+        const pag = validateStatsPagination(opts);
+        const params = {
+            contract: addr.toLowerCase(),
+            skip: String(pag.skip),
+            limit: String(pag.limit),
+            sort: pag.sort.toUpperCase(),
+        };
+        if (pag.minTimestamp)
+            params.minTimestamp = pag.minTimestamp;
+        if (pag.maxTimestamp)
+            params.maxTimestamp = pag.maxTimestamp;
+        const res = await fetchCustomApi("/statistics/token/holder", params);
+        return res.list;
+    },
+    async getTokenTransferStats(contract, opts) {
+        const addr = validateAddress(contract, "contract");
+        const pag = validateStatsPagination(opts);
+        const params = {
+            contract: addr.toLowerCase(),
+            skip: String(pag.skip),
+            limit: String(pag.limit),
+            sort: pag.sort.toUpperCase(),
+        };
+        if (pag.minTimestamp)
+            params.minTimestamp = pag.minTimestamp;
+        if (pag.maxTimestamp)
+            params.maxTimestamp = pag.maxTimestamp;
+        const res = await fetchCustomApi("/statistics/token/transfer", params);
+        return res.list;
+    },
+    async getTokenUniqueParticipants(contract, opts) {
+        const addr = validateAddress(contract, "contract");
+        const pag = validateStatsPagination(opts);
+        const params = {
+            contract: addr.toLowerCase(),
+            skip: String(pag.skip),
+            limit: String(pag.limit),
+            sort: pag.sort.toUpperCase(),
+        };
+        if (pag.minTimestamp)
+            params.minTimestamp = pag.minTimestamp;
+        if (pag.maxTimestamp)
+            params.maxTimestamp = pag.maxTimestamp;
+        const res = await fetchCustomApi("/statistics/token/unique/participant", params);
+        return res.list;
+    },
+    async getTopTokenSenders(spanType = "24h") {
+        const res = await fetchCustomApi("/statistics/top/token/sender", { spanType });
+        return res.list;
+    },
+    async getTopTokenReceivers(spanType = "24h") {
+        const res = await fetchCustomApi("/statistics/top/token/receiver", { spanType });
+        return res.list;
+    },
+    async getTopTokenParticipants(spanType = "24h") {
+        const res = await fetchCustomApi("/statistics/top/token/participant", { spanType });
+        return res.list;
+    },
+};
+//# sourceMappingURL=client.js.map

package/dist/chainscan/client.js.map

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

package/dist/chainscan/constants.d.ts

@@ -0,0 +1,15 @@
+export declare const CHAINSCAN_DEFAULTS: {
+    readonly BASE_URL: "https://chainscan.0g.ai/open";
+    readonly API_PATH: "/api";
+    readonly TIMEOUT_MS: 10000;
+    readonly RATE_LIMIT_PER_SEC: 4;
+    readonly MAX_CONCURRENT: 3;
+    readonly MAX_RETRIES: 2;
+    readonly MAX_BATCH_DECODE: 10;
+    readonly MAX_BATCH_ADDRESSES: 5;
+    readonly MAX_BATCH_BALANCE: 20;
+    readonly MAX_PAGE_OFFSET: 100;
+    readonly MAX_SKIP: 10000;
+    readonly MAX_STATS_LIMIT: 2000;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/chainscan/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/chainscan/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;CAarB,CAAC"}

package/dist/chainscan/constants.js

@@ -0,0 +1,15 @@
+export const CHAINSCAN_DEFAULTS = {
+    BASE_URL: "https://chainscan.0g.ai/open",
+    API_PATH: "/api",
+    TIMEOUT_MS: 10_000,
+    RATE_LIMIT_PER_SEC: 4,
+    MAX_CONCURRENT: 3,
+    MAX_RETRIES: 2,
+    MAX_BATCH_DECODE: 10,
+    MAX_BATCH_ADDRESSES: 5,
+    MAX_BATCH_BALANCE: 20,
+    MAX_PAGE_OFFSET: 100,
+    MAX_SKIP: 10_000,
+    MAX_STATS_LIMIT: 2000,
+};
+//# sourceMappingURL=constants.js.map

package/dist/chainscan/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/chainscan/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ,EAAE,8BAA8B;IACxC,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE,MAAM;IAClB,kBAAkB,EAAE,CAAC;IACrB,cAAc,EAAE,CAAC;IACjB,WAAW,EAAE,CAAC;IACd,gBAAgB,EAAE,EAAE;IACpB,mBAAmB,EAAE,CAAC;IACtB,iBAAiB,EAAE,EAAE;IACrB,eAAe,EAAE,GAAG;IACpB,QAAQ,EAAE,MAAM;IAChB,eAAe,EAAE,IAAI;CACb,CAAC"}

package/dist/chainscan/types.d.ts

@@ -0,0 +1,148 @@
+export interface EtherscanResponse<T> {
+    status: string;
+    message: string;
+    result: T;
+}
+export interface CustomResponse<T> {
+    status: number;
+    message: string;
+    result: T;
+}
+export interface ChainScanTx {
+    blockNumber: string;
+    timeStamp: string;
+    hash: string;
+    nonce: string;
+    blockHash: string;
+    transactionIndex: string;
+    from: string;
+    to: string;
+    value: string;
+    gas: string;
+    gasPrice: string;
+    isError: string;
+    txreceipt_status: string;
+    input: string;
+    contractAddress: string;
+    cumulativeGasUsed: string;
+    gasUsed: string;
+    confirmations: string;
+}
+export interface ChainScanTokenTransfer {
+    blockNumber: string;
+    timeStamp: string;
+    hash: string;
+    nonce: string;
+    blockHash: string;
+    from: string;
+    to: string;
+    contractAddress: string;
+    value: string;
+    tokenName: string;
+    tokenSymbol: string;
+    tokenDecimal: string;
+    transactionIndex: string;
+    gas: string;
+    gasPrice: string;
+    gasUsed: string;
+    cumulativeGasUsed: string;
+    confirmations: string;
+}
+export interface ChainScanNftTransfer {
+    blockNumber: string;
+    timeStamp: string;
+    hash: string;
+    nonce: string;
+    blockHash: string;
+    from: string;
+    to: string;
+    contractAddress: string;
+    tokenID: string;
+    tokenName: string;
+    tokenSymbol: string;
+    tokenDecimal: string;
+    transactionIndex: string;
+    gas: string;
+    gasPrice: string;
+    gasUsed: string;
+    cumulativeGasUsed: string;
+    confirmations: string;
+}
+export interface ChainScanBalanceMulti {
+    account: string;
+    balance: string;
+}
+export interface ChainScanTxStatus {
+    isError: string;
+    errDescription: string;
+}
+export interface ChainScanTxReceipt {
+    status: string;
+}
+export interface ChainScanContractSource {
+    SourceCode: string;
+    ABI: string;
+    ContractName: string;
+    CompilerVersion: string;
+    OptimizationUsed: string;
+    Runs: string;
+    ConstructorArguments: string;
+    EVMVersion: string;
+    Library: string;
+    LicenseType: string;
+    Proxy: string;
+    Implementation: string;
+    SwarmSource: string;
+}
+export interface ChainScanContractCreation {
+    contractAddress: string;
+    contractCreator: string;
+    txHash: string;
+    blockNumber: string;
+    timestamp: string;
+}
+export interface ChainScanDecodedMethod {
+    hash: string;
+    abi: string;
+    decodedData: string;
+    error: string;
+}
+export interface ChainScanDecodedRaw {
+    contract: string;
+    input: string;
+    abi: string;
+    decodedData: string;
+    error: string;
+}
+export interface ChainScanTokenHolderStat {
+    statTime: string;
+    holderCount: string;
+}
+export interface ChainScanTokenTransferStat {
+    transferCount: string;
+    userCount: string;
+    statTime: string;
+}
+export interface ChainScanUniqueParticipantStat {
+    statTime: string;
+    uniqueParticipant: string;
+}
+export interface ChainScanTopAddress {
+    address: string;
+    value: string;
+}
+export interface PaginationOpts {
+    page?: number;
+    offset?: number;
+    sort?: "asc" | "desc";
+    startblock?: number;
+    endblock?: number;
+}
+export interface StatsPaginationOpts {
+    skip?: number;
+    limit?: number;
+    sort?: "asc" | "desc";
+    minTimestamp?: number;
+    maxTimestamp?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/chainscan/types.js

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

package/dist/chainscan/types.js.map

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

package/dist/chainscan/validation.d.ts

@@ -0,0 +1,35 @@
+import { type Address } from "viem";
+export declare function validateAddress(input: string, label?: string): Address;
+export declare function validateTxHash(input: string): string;
+export declare function validateAddressBatch(input: string[], maxSize: number): Address[];
+export declare function validateHashBatch(input: string[], maxSize: number): string[];
+export interface ValidatedPagination {
+    page: number;
+    offset: number;
+    sort: "asc" | "desc";
+    startblock?: string;
+    endblock?: string;
+}
+export declare function validatePagination(opts?: {
+    page?: number;
+    offset?: number;
+    sort?: string;
+    startblock?: number;
+    endblock?: number;
+}): ValidatedPagination;
+export interface ValidatedStatsPagination {
+    skip: number;
+    limit: number;
+    sort: "asc" | "desc";
+    minTimestamp?: string;
+    maxTimestamp?: string;
+}
+export declare function validateStatsPagination(opts?: {
+    skip?: number;
+    limit?: number;
+    sort?: string;
+    minTimestamp?: number;
+    maxTimestamp?: number;
+}): ValidatedStatsPagination;
+export declare function validateTag(tag?: string): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/chainscan/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/chainscan/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAe3D,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAgBzE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBpD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAehF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAe5E;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,mBAAmB,CAiCtB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,wBAAwB,CAiC3B;AAED,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAUhD"}