maiat-sdk 0.2.0 → 0.3.0

package/README.md

@@ -19,10 +19,14 @@ const maiat = new Maiat();
 const trusted = await maiat.isTrusted("0x...");
 
 // Token safety check
-const safe = await maiat.isTokenSafe("0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913");
+const safe = await maiat.isTokenSafe(
+  "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+);
 
 // Full trust score
-const score = await maiat.agentTrust("0xAf1aE6F344c60c7Fe56CB53d1809f2c0B997a2b9");
+const score = await maiat.agentTrust(
+  "0xE6ac05D2b50cd525F793024D75BB6f519a52Af5D",
+);
 console.log(score.trustScore, score.verdict); // 69, "caution"
 
 // Trust-verified swap quote
@@ -40,22 +44,22 @@ console.log(swap.calldata); // ready-to-sign tx calldata
 
 ### `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) |
+| Option    | Default                             | Description                             |
+| --------- | ----------------------------------- | --------------------------------------- |
+| `baseUrl` | `https://app.maiat.io` | 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 |
+| 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           |
 
 ## Outcome Reporting (Training Data)
 
@@ -76,8 +80,8 @@ if (score.trustScore >= 60) {
 await maiat.reportOutcome({
   target: "0xCounterparty",
   action: "swap",
-  result: "success",        // or "failure", "scam"
-  txHash: "0x...",           // on-chain proof
+  result: "success", // or "failure", "scam"
+  txHash: "0x...", // on-chain proof
   maiatVerdict: score.verdict,
   maiatScore: score.trustScore,
 });
@@ -87,6 +91,6 @@ This closes the feedback loop: check → act → report → oracle gets smarter.
 
 ## Links
 
-- Protocol: [maiat-protocol.vercel.app](https://maiat-protocol.vercel.app)
+- Protocol: [app.maiat.io](https://app.maiat.io)
 - 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

@@ -7,10 +7,10 @@
  *   const score = await maiat.agentTrust("0x...");
  *   const token = await maiat.tokenCheck("0x...");
  *   const swap  = await maiat.trustSwap({ ... });
- *   await maiat.reportOutcome({ agent: "0x...", action: "swap", result: "success" });
+ *   await maiat.reportOutcome({ jobId: "...", outcome: "success" });
  */
 export interface MaiatConfig {
-    /** Base URL for Maiat Protocol API. Default: https://maiat-protocol.vercel.app */
+    /** Base URL for Maiat Protocol API. Default: https://app.maiat.io */
     baseUrl?: string;
     /** Optional API key for higher rate limits */
     apiKey?: string;
@@ -32,6 +32,17 @@ export interface AgentTrustResult {
     };
     verdict: "proceed" | "caution" | "avoid";
     lastUpdated: string;
+    feedback?: {
+        queryId: string;
+    };
+}
+export interface DeepAnalysisResult {
+    address: string;
+    trustScore: number;
+    verdict: "proceed" | "caution" | "avoid";
+    deepAnalysis: Record<string, unknown>;
+    signals: Record<string, unknown>;
+    lastUpdated: string;
 }
 export interface TokenCheckResult {
     address: string;
@@ -42,6 +53,14 @@ export interface TokenCheckResult {
     riskSummary: string;
     dataSource: string;
 }
+export interface ForensicsResult {
+    address: string;
+    chain: string;
+    forensics: Record<string, unknown>;
+    riskFlags: string[];
+    verdict: "proceed" | "caution" | "avoid";
+    lastUpdated: string;
+}
 export interface TrustSwapParams {
     swapper: string;
     tokenIn: string;
@@ -87,6 +106,24 @@ export interface OutcomeResponse {
     logged: boolean;
     id?: string;
 }
+export interface OutcomeParams {
+    jobId: string;
+    outcome: "success" | "failure" | "partial" | "expired";
+    reporter?: string;
+    note?: string;
+}
+export interface OutcomeResult {
+    success: boolean;
+    id?: string;
+    message?: string;
+}
+export interface ScarabResult {
+    address: string;
+    balance: string;
+    balanceFormatted: number;
+    tier: string;
+    lastUpdated: string;
+}
 export declare class Maiat {
     private baseUrl;
     private apiKey?;
@@ -96,8 +133,12 @@ export declare class Maiat {
     private request;
     /** Get trust score for an ACP agent by wallet address */
     agentTrust(address: string): Promise<AgentTrustResult>;
+    /** Get deep analysis for an ACP agent by wallet address */
+    deep(address: string): Promise<DeepAnalysisResult>;
     /** Check if a token is safe (honeypot, rug, liquidity) */
     tokenCheck(address: string): Promise<TokenCheckResult>;
+    /** Get forensics data for a token address */
+    forensics(address: string, chain?: string): Promise<ForensicsResult>;
     /** Get a trust-verified swap quote with calldata */
     trustSwap(params: TrustSwapParams): Promise<TrustSwapResult>;
     /** List indexed agents with trust scores */
@@ -105,16 +146,17 @@ export declare class Maiat {
         agents: AgentTrustResult[];
         total: number;
     }>;
+    /** Get SCARAB token balance for an address */
+    scarab(address: string): Promise<ScarabResult>;
     /**
-     * Report the outcome of an action taken after a Maiat trust check.
-     * This is the most valuable data for training the oracle.
+     * Report the outcome of a job (new API).
      *
      * Example flow:
-     *   1. maiat.isTrusted("0x...") → true
-     *   2. You swap with that agent
-     *   3. maiat.reportOutcome({ target: "0x...", action: "swap", result: "success" })
+     *   1. maiat.agentTrust("0x...") → proceed
+     *   2. You execute the job
+     *   3. maiat.reportOutcome({ jobId: "...", outcome: "success" })
      */
-    reportOutcome(report: OutcomeReport): Promise<OutcomeResponse>;
+    reportOutcome(params: OutcomeParams): Promise<OutcomeResult>;
     /** 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? */

package/dist/index.js

@@ -7,7 +7,7 @@
  *   const score = await maiat.agentTrust("0x...");
  *   const token = await maiat.tokenCheck("0x...");
  *   const swap  = await maiat.trustSwap({ ... });
- *   await maiat.reportOutcome({ agent: "0x...", action: "swap", result: "success" });
+ *   await maiat.reportOutcome({ jobId: "...", outcome: "success" });
  */
 // ─── Client ───────────────────────────────────────────────────────────────────
 export class Maiat {
@@ -16,7 +16,7 @@ export class Maiat {
     clientId;
     timeout;
     constructor(config = {}) {
-        this.baseUrl = (config.baseUrl ?? "https://maiat-protocol.vercel.app").replace(/\/$/, "");
+        this.baseUrl = (config.baseUrl ?? "https://app.maiat.io").replace(/\/$/, "");
         this.apiKey = config.apiKey;
         this.clientId = config.clientId;
         this.timeout = config.timeout ?? 15_000;
@@ -43,10 +43,19 @@ export class Maiat {
     async agentTrust(address) {
         return this.request(`/api/v1/agent/${address}`);
     }
+    /** Get deep analysis for an ACP agent by wallet address */
+    async deep(address) {
+        return this.request(`/api/v1/agent/${address}/deep`);
+    }
     /** Check if a token is safe (honeypot, rug, liquidity) */
     async tokenCheck(address) {
         return this.request(`/api/v1/token/${address}`);
     }
+    /** Get forensics data for a token address */
+    async forensics(address, chain) {
+        const query = chain ? `?chain=${chain}` : "";
+        return this.request(`/api/v1/token/${address}/forensics${query}`);
+    }
     /** Get a trust-verified swap quote with calldata */
     async trustSwap(params) {
         return this.request("/api/v1/swap/quote", {
@@ -58,20 +67,23 @@ export class Maiat {
     async listAgents(limit = 50) {
         return this.request(`/api/v1/agents?limit=${limit}`);
     }
-    // ─── Outcome Reporting (Training Data) ────────────────────────────────────
+    /** Get SCARAB token balance for an address */
+    async scarab(address) {
+        return this.request(`/api/v1/scarab?address=${address}`);
+    }
+    // ─── Outcome Reporting ────────────────────────────────────────────────────
     /**
-     * Report the outcome of an action taken after a Maiat trust check.
-     * This is the most valuable data for training the oracle.
+     * Report the outcome of a job (new API).
      *
      * Example flow:
-     *   1. maiat.isTrusted("0x...") → true
-     *   2. You swap with that agent
-     *   3. maiat.reportOutcome({ target: "0x...", action: "swap", result: "success" })
+     *   1. maiat.agentTrust("0x...") → proceed
+     *   2. You execute the job
+     *   3. maiat.reportOutcome({ jobId: "...", outcome: "success" })
      */
-    async reportOutcome(report) {
+    async reportOutcome(params) {
         return this.request("/api/v1/outcome", {
             method: "POST",
-            body: JSON.stringify(report),
+            body: JSON.stringify(params),
         });
     }
     // ─── Convenience ──────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maiat-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Maiat Protocol SDK — trust scores, token safety, and swap verification for AI agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",