base-token-safety-client 1.0.0

package/README.md

@@ -0,0 +1,37 @@
+# @antigravity/token-safety-client
+
+Node.js/browser API client for the [Antigravity Token Safety Scanner](https://antigravity-connect-ia.vercel.app/token-safety). Scan any Base chain token address for rug pulls, honeypots, and dangerous functions.
+
+## Install
+
+```bash
+npm install @antigravity/token-safety-client
+```
+
+## Usage
+
+```js
+const { scanToken, getLatestScans } = require("@antigravity/token-safety-client");
+
+const result = await scanToken("0x4200000000000000000000000000000000000006");
+console.log(result.symbol, result.safetyScore, result.riskLevel);
+// WETH 10 "safe"
+
+const latest = await getLatestScans(5);
+console.log(latest.map((s) => `${s.symbol}: ${s.safetyScore}/10`));
+```
+
+## API
+
+### `scanToken(address)`
+Scans a Base chain token address. Returns `{ address, symbol, name, safetyScore, riskLevel, risks, dangerousFunctions, note }`.
+
+### `getLatestScans(limit?)`
+Returns the latest scanned tokens from the live watcher (up to 50).
+
+### `formatScore(score)`
+Converts 0-10 numeric score to `"safe" | "warning" | "danger"`.
+
+## Web
+
+Full interactive scanner: [antigravity-connect-ia.vercel.app/token-safety](https://antigravity-connect-ia.vercel.app/token-safety)

package/index.d.ts

@@ -0,0 +1,18 @@
+export interface ScanResult {
+  address: string;
+  symbol: string;
+  name: string | null;
+  safetyScore: number;
+  riskLevel: "safe" | "warning" | "danger";
+  risks: string[];
+  dangerousFunctions: Array<{ sig: string; desc: string }>;
+  note: string | null;
+}
+
+export class TokenSafetyError extends Error {
+  status: number;
+}
+
+export function scanToken(address: string): Promise<ScanResult>;
+export function getLatestScans(limit?: number): Promise<ScanResult[]>;
+export function formatScore(score: number): "safe" | "warning" | "danger";

package/index.js

@@ -0,0 +1,51 @@
+const BASE_URL = "https://antigravity-connect-ia.vercel.app";
+
+class TokenSafetyError extends Error {
+  constructor(message, status) {
+    super(message);
+    this.name = "TokenSafetyError";
+    this.status = status;
+  }
+}
+
+async function request(path, body) {
+  const res = await fetch(`${BASE_URL}${path}`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body),
+  });
+  const data = await res.json();
+  if (!res.ok || data.error) {
+    throw new TokenSafetyError(data.error || `HTTP ${res.status}`, res.status);
+  }
+  return data;
+}
+
+function formatScore(score) {
+  return score >= 8 ? "safe" : score >= 5 ? "warning" : "danger";
+}
+
+async function scanToken(address) {
+  if (!address || !/^0x[a-fA-F0-9]{40}$/.test(address)) {
+    throw new TokenSafetyError(`Invalid address: ${address}`);
+  }
+  const data = await request("/api/token-safety", { address });
+  return {
+    address: data.address || address,
+    symbol: data.symbol || "UNKNOWN",
+    name: data.name || null,
+    safetyScore: data.safetyScore ?? 0,
+    riskLevel: formatScore(data.safetyScore ?? 0),
+    risks: data.risks || [],
+    dangerousFunctions: data.dangerousFunctions || [],
+    note: data.note || null,
+  };
+}
+
+async function getLatestScans(limit = 10) {
+  const res = await fetch(`${BASE_URL}/api/latest-scans?limit=${limit}`);
+  if (!res.ok) throw new TokenSafetyError(`HTTP ${res.status}`, res.status);
+  return res.json();
+}
+
+module.exports = { scanToken, getLatestScans, formatScore, TokenSafetyError };

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "base-token-safety-client",
+  "version": "1.0.0",
+  "description": "Node.js/browser API client for the Antigravity Token Safety Scanner. Scan any Base chain token address for rug pulls, honeypots, and dangerous functions.",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": ["index.js", "index.d.ts", "README.md"],
+  "keywords": [
+    "base-chain",
+    "token-scanner",
+    "rug-pull-detector",
+    "honeypot-checker",
+    "crypto-security",
+    "web3",
+    "defi-security",
+    "smart-contract-audit",
+    "api-client"
+  ],
+  "author": "Antigravity Labs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/josemiguel3125-sketch/live-agent-os-infra.git"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}