@c7-digital/scan 0.0.1

package/lib/src/client.js

@@ -0,0 +1,160 @@
+import { logger } from "./logger.js";
+import fetch from "cross-fetch";
+// ─── ScanClient ────────────────────────────────────────────────────────
+export class ScanClient {
+    constructor(config) {
+        this.baseUrl = config.baseUrl;
+        this.token = config.token;
+    }
+    async request(path, method, options) {
+        let url = `${this.baseUrl}${path}`;
+        // Append query parameters
+        if (options?.query) {
+            const params = new URLSearchParams();
+            for (const [key, value] of Object.entries(options.query)) {
+                if (value === undefined || value === null)
+                    continue;
+                if (Array.isArray(value)) {
+                    for (const item of value) {
+                        params.append(key, String(item));
+                    }
+                }
+                else {
+                    params.append(key, String(value));
+                }
+            }
+            const qs = params.toString();
+            if (qs) {
+                url += `?${qs}`;
+            }
+        }
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.token) {
+            headers["Authorization"] = `Bearer ${this.token}`;
+        }
+        const requestInit = { method, headers };
+        if (options?.body) {
+            requestInit.body = JSON.stringify(options.body);
+        }
+        logger.debug(`${method} ${url}`);
+        const response = await fetch(url, requestInit);
+        if (!response.ok) {
+            const text = await response.text().catch(() => "");
+            throw new Error(`HTTP ${response.status}: ${response.statusText}${text ? ` - ${text}` : ""}`);
+        }
+        // Some health endpoints return empty bodies
+        const contentType = response.headers.get("content-type");
+        if (!contentType || !contentType.includes("application/json")) {
+            return undefined;
+        }
+        return (await response.json());
+    }
+    // ─── ANS / Name Service ────────────────────────────────────────────
+    async listAnsEntries(params) {
+        return this.request("/v0/ans-entries", "GET", {
+            query: params,
+        });
+    }
+    async lookupAnsEntryByParty(party) {
+        return this.request(`/v0/ans-entries/by-party/${encodeURIComponent(party)}`, "GET");
+    }
+    async lookupAnsEntryByName(name) {
+        return this.request(`/v0/ans-entries/by-name/${encodeURIComponent(name)}`, "GET");
+    }
+    // ─── Party Resolution ──────────────────────────────────────────────
+    async getPartyToParticipant(domainId, partyId) {
+        return this.request(`/v0/domains/${encodeURIComponent(domainId)}/parties/${encodeURIComponent(partyId)}/participant-id`, "GET");
+    }
+    // ─── Network Info ──────────────────────────────────────────────────
+    async getDsoInfo() {
+        return this.request("/v0/dso", "GET");
+    }
+    async getDsoPartyId() {
+        return this.request("/v0/dso-party-id", "GET");
+    }
+    async getDsoSequencers() {
+        return this.request("/v0/dso-sequencers", "GET");
+    }
+    async listScans() {
+        return this.request("/v0/scans", "GET");
+    }
+    // ─── Validator Info ────────────────────────────────────────────────
+    async listValidatorLicenses(params) {
+        return this.request("/v0/admin/validator/licenses", "GET", { query: params });
+    }
+    async getValidatorFaucets(params) {
+        return this.request("/v0/validators/validator-faucets", "GET", { query: params });
+    }
+    // ─── Updates (v2) ──────────────────────────────────────────────────
+    async getUpdates(body) {
+        return this.request("/v2/updates", "POST", { body });
+    }
+    async getUpdateById(updateId, params) {
+        return this.request(`/v2/updates/${encodeURIComponent(updateId)}`, "GET", { query: params });
+    }
+    // ─── ACS State ─────────────────────────────────────────────────────
+    async getAcsSnapshot(body) {
+        return this.request("/v0/state/acs", "POST", { body });
+    }
+    async getAcsSnapshotTimestamp(params) {
+        return this.request("/v0/state/acs/snapshot-timestamp", "GET", { query: params });
+    }
+    async getAcsSnapshotTimestampAfter(params) {
+        return this.request("/v0/state/acs/snapshot-timestamp-after", "GET", { query: params });
+    }
+    async forceAcsSnapshot() {
+        return this.request("/v0/state/acs/force", "POST");
+    }
+    // ─── Holdings ──────────────────────────────────────────────────────
+    async getHoldingsState(body) {
+        return this.request("/v0/holdings/state", "POST", { body });
+    }
+    async getHoldingsSummary(body) {
+        return this.request("/v0/holdings/summary", "POST", { body });
+    }
+    // ─── Rounds ────────────────────────────────────────────────────────
+    async getClosedRounds() {
+        return this.request("/v0/closed-rounds", "GET");
+    }
+    async getOpenAndIssuingMiningRounds(body) {
+        return this.request("/v0/open-and-issuing-mining-rounds", "POST", { body });
+    }
+    // ─── Events ────────────────────────────────────────────────────────
+    async getEvents(body) {
+        return this.request("/v0/events", "POST", { body });
+    }
+    async getEventById(updateId, params) {
+        return this.request(`/v0/events/${encodeURIComponent(updateId)}`, "GET", { query: params });
+    }
+    // ─── Misc ──────────────────────────────────────────────────────────
+    async getUnclaimedDevelopmentFundCoupons() {
+        return this.request("/v0/unclaimed-development-fund-coupons", "GET");
+    }
+    // ─── Health ────────────────────────────────────────────────────────
+    async isReady() {
+        try {
+            await this.request("/readyz", "GET");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async isLive() {
+        try {
+            await this.request("/livez", "GET");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getStatus() {
+        return this.request("/status", "GET");
+    }
+    async getVersion() {
+        return this.request("/version", "GET");
+    }
+}