maiat-sdk 0.1.0

package/README.md

@@ -0,0 +1,64 @@
+# maiat-sdk
+
+Trust scores, token safety & swap verification for AI agents.
+
+## Install
+
+```bash
+npm install maiat-sdk
+```
+
+## Quick Start
+
+```typescript
+import { Maiat } from "maiat-sdk";
+
+const maiat = new Maiat();
+
+// Check if an agent is trustworthy
+const trusted = await maiat.isTrusted("0x...");
+
+// Token safety check
+const safe = await maiat.isTokenSafe("0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913");
+
+// Full trust score
+const score = await maiat.agentTrust("0xAf1aE6F344c60c7Fe56CB53d1809f2c0B997a2b9");
+console.log(score.trustScore, score.verdict); // 69, "caution"
+
+// Trust-verified swap quote
+const swap = await maiat.trustSwap({
+  swapper: "0x...",
+  tokenIn: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE", // ETH
+  tokenOut: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // USDC
+  amount: "10000000000000000", // 0.01 ETH in wei
+});
+console.log(swap.trust.tokenOut?.score); // 100
+console.log(swap.calldata); // ready-to-sign tx calldata
+```
+
+## API
+
+### `new Maiat(config?)`
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `baseUrl` | `https://maiat-protocol.vercel.app` | API base URL |
+| `apiKey` | — | Optional API key for higher rate limits |
+| `timeout` | `15000` | Request timeout (ms) |
+
+### Methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `agentTrust(address)` | `AgentTrustResult` | Full trust score + breakdown |
+| `tokenCheck(address)` | `TokenCheckResult` | Token safety analysis |
+| `trustSwap(params)` | `TrustSwapResult` | Swap quote with trust verification |
+| `listAgents(limit?)` | `{ agents, total }` | Browse indexed agents |
+| `isTrusted(address, threshold?)` | `boolean` | Quick trust check (default ≥60) |
+| `isTokenSafe(address)` | `boolean` | Quick token safety check |
+
+## Links
+
+- Protocol: [maiat-protocol.vercel.app](https://maiat-protocol.vercel.app)
+- GitHub: [JhiNResH/maiat-protocol](https://github.com/JhiNResH/maiat-protocol)
+- ACP: [Agent #3723 on Virtuals](https://app.virtuals.io/acp)

package/dist/index.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Maiat SDK — Trust scores, token safety & swap verification for AI agents
+ *
+ * Usage:
+ *   import { Maiat } from "maiat-sdk";
+ *   const maiat = new Maiat();
+ *   const score = await maiat.agentTrust("0x...");
+ *   const token = await maiat.tokenCheck("0x...");
+ *   const swap  = await maiat.trustSwap({ ... });
+ */
+export interface MaiatConfig {
+    /** Base URL for Maiat Protocol API. Default: https://maiat-protocol.vercel.app */
+    baseUrl?: string;
+    /** Optional API key for higher rate limits */
+    apiKey?: string;
+    /** Request timeout in ms. Default: 15000 */
+    timeout?: number;
+}
+export interface AgentTrustResult {
+    address: string;
+    trustScore: number;
+    dataSource: string;
+    breakdown: {
+        completionRate: number;
+        paymentRate: number;
+        expireRate: number;
+        totalJobs: number;
+        ageWeeks: number | null;
+    };
+    verdict: "proceed" | "caution" | "avoid";
+    lastUpdated: string;
+}
+export interface TokenCheckResult {
+    address: string;
+    tokenType: string;
+    trustScore: number;
+    verdict: "proceed" | "caution" | "avoid";
+    riskFlags: string[];
+    riskSummary: string;
+    dataSource: string;
+}
+export interface TrustSwapParams {
+    swapper: string;
+    tokenIn: string;
+    tokenOut: string;
+    amount: string;
+    chainId?: number;
+    slippage?: number;
+}
+export interface TrustSwapResult {
+    quote: Record<string, unknown>;
+    calldata: string | null;
+    to: string | null;
+    value: string | null;
+    trust: {
+        tokenIn: {
+            score: number;
+            risk: string;
+        } | null;
+        tokenOut: {
+            score: number;
+            risk: string;
+        } | null;
+    };
+    timestamp: string;
+}
+export declare class Maiat {
+    private baseUrl;
+    private apiKey?;
+    private timeout;
+    constructor(config?: MaiatConfig);
+    private request;
+    /** Get trust score for an ACP agent by wallet address */
+    agentTrust(address: string): Promise<AgentTrustResult>;
+    /** Check if a token is safe (honeypot, rug, liquidity) */
+    tokenCheck(address: string): Promise<TokenCheckResult>;
+    /** Get a trust-verified swap quote with calldata */
+    trustSwap(params: TrustSwapParams): Promise<TrustSwapResult>;
+    /** List indexed agents with trust scores */
+    listAgents(limit?: number): Promise<{
+        agents: AgentTrustResult[];
+        total: number;
+    }>;
+    /** Quick check: is this agent trustworthy? Returns true if score >= threshold */
+    isTrusted(address: string, threshold?: number): Promise<boolean>;
+    /** Quick check: is this token safe to swap? */
+    isTokenSafe(address: string): Promise<boolean>;
+}
+export declare class MaiatError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+export default Maiat;

package/dist/index.js

@@ -0,0 +1,89 @@
+/**
+ * Maiat SDK — Trust scores, token safety & swap verification for AI agents
+ *
+ * Usage:
+ *   import { Maiat } from "maiat-sdk";
+ *   const maiat = new Maiat();
+ *   const score = await maiat.agentTrust("0x...");
+ *   const token = await maiat.tokenCheck("0x...");
+ *   const swap  = await maiat.trustSwap({ ... });
+ */
+// ─── Client ───────────────────────────────────────────────────────────────────
+export class Maiat {
+    baseUrl;
+    apiKey;
+    timeout;
+    constructor(config = {}) {
+        this.baseUrl = (config.baseUrl ?? "https://maiat-protocol.vercel.app").replace(/\/$/, "");
+        this.apiKey = config.apiKey;
+        this.timeout = config.timeout ?? 15_000;
+    }
+    async request(path, options) {
+        const headers = {
+            "Content-Type": "application/json",
+            ...(this.apiKey ? { "X-Maiat-Key": this.apiKey } : {}),
+        };
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            ...options,
+            headers: { ...headers, ...options?.headers },
+            signal: AbortSignal.timeout(this.timeout),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            throw new MaiatError(`HTTP ${res.status}: ${body}`, res.status);
+        }
+        return res.json();
+    }
+    // ─── Core Methods ─────────────────────────────────────────────────────────
+    /** Get trust score for an ACP agent by wallet address */
+    async agentTrust(address) {
+        return this.request(`/api/v1/agent/${address}`);
+    }
+    /** Check if a token is safe (honeypot, rug, liquidity) */
+    async tokenCheck(address) {
+        return this.request(`/api/v1/token/${address}`);
+    }
+    /** Get a trust-verified swap quote with calldata */
+    async trustSwap(params) {
+        return this.request("/api/v1/swap/quote", {
+            method: "POST",
+            body: JSON.stringify(params),
+        });
+    }
+    /** List indexed agents with trust scores */
+    async listAgents(limit = 50) {
+        return this.request(`/api/v1/agents?limit=${limit}`);
+    }
+    // ─── Convenience ──────────────────────────────────────────────────────────
+    /** Quick check: is this agent trustworthy? Returns true if score >= threshold */
+    async isTrusted(address, threshold = 60) {
+        try {
+            const result = await this.agentTrust(address);
+            return result.trustScore >= threshold;
+        }
+        catch {
+            return false; // fail-closed: unknown = untrusted
+        }
+    }
+    /** Quick check: is this token safe to swap? */
+    async isTokenSafe(address) {
+        try {
+            const result = await this.tokenCheck(address);
+            return result.verdict === "proceed";
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// ─── Error ────────────────────────────────────────────────────────────────────
+export class MaiatError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "MaiatError";
+    }
+}
+// ─── Default export ───────────────────────────────────────────────────────────
+export default Maiat;

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "maiat-sdk",
+  "version": "0.1.0",
+  "description": "Maiat Protocol SDK — trust scores, token safety, and swap verification for AI agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["maiat", "trust", "agent", "acp", "virtuals", "uniswap", "safety"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JhiNResH/maiat-protocol",
+    "directory": "packages/sdk"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}