maiat-sdk 0.1.0 → 0.2.0

package/README.md

@@ -57,6 +57,34 @@ console.log(swap.calldata); // ready-to-sign tx calldata
 | `isTrusted(address, threshold?)` | `boolean` | Quick trust check (default ≥60) |
 | `isTokenSafe(address)` | `boolean` | Quick token safety check |
 
+## Outcome Reporting (Training Data)
+
+The most valuable data for improving trust accuracy:
+
+```typescript
+const maiat = new Maiat({ clientId: "my-trading-bot" });
+
+// 1. Check trust
+const score = await maiat.agentTrust("0xCounterparty");
+
+// 2. Take action based on trust
+if (score.trustScore >= 60) {
+  // ... execute swap ...
+}
+
+// 3. Report what happened
+await maiat.reportOutcome({
+  target: "0xCounterparty",
+  action: "swap",
+  result: "success",        // or "failure", "scam"
+  txHash: "0x...",           // on-chain proof
+  maiatVerdict: score.verdict,
+  maiatScore: score.trustScore,
+});
+```
+
+This closes the feedback loop: check → act → report → oracle gets smarter.
+
 ## Links
 
 - Protocol: [maiat-protocol.vercel.app](https://maiat-protocol.vercel.app)

package/dist/index.d.ts

@@ -3,16 +3,19 @@
  *
  * Usage:
  *   import { Maiat } from "maiat-sdk";
- *   const maiat = new Maiat();
+ *   const maiat = new Maiat({ clientId: "my-agent" });
  *   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" });
  */
 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;
+    /** Client identifier — tracks which agent/app is making requests (training data) */
+    clientId?: string;
     /** Request timeout in ms. Default: 15000 */
     timeout?: number;
 }
@@ -64,9 +67,30 @@ export interface TrustSwapResult {
     };
     timestamp: string;
 }
+export interface OutcomeReport {
+    /** The agent or token address that was checked */
+    target: string;
+    /** What action was taken after checking trust */
+    action: "swap" | "delegate" | "hire" | "skip" | "block" | "other";
+    /** The outcome of that action */
+    result: "success" | "failure" | "scam" | "partial" | "pending";
+    /** On-chain tx hash as proof (optional) */
+    txHash?: string;
+    /** What Maiat verdict was at the time */
+    maiatVerdict?: "proceed" | "caution" | "avoid";
+    /** Trust score at the time of check */
+    maiatScore?: number;
+    /** Free-form context */
+    notes?: string;
+}
+export interface OutcomeResponse {
+    logged: boolean;
+    id?: string;
+}
 export declare class Maiat {
     private baseUrl;
     private apiKey?;
+    private clientId?;
     private timeout;
     constructor(config?: MaiatConfig);
     private request;
@@ -81,6 +105,16 @@ export declare class Maiat {
         agents: AgentTrustResult[];
         total: number;
     }>;
+    /**
+     * Report the outcome of an action taken after a Maiat trust check.
+     * This is the most valuable data for training the oracle.
+     *
+     * Example flow:
+     *   1. maiat.isTrusted("0x...") → true
+     *   2. You swap with that agent
+     *   3. maiat.reportOutcome({ target: "0x...", action: "swap", result: "success" })
+     */
+    reportOutcome(report: OutcomeReport): Promise<OutcomeResponse>;
     /** 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

@@ -3,25 +3,29 @@
  *
  * Usage:
  *   import { Maiat } from "maiat-sdk";
- *   const maiat = new Maiat();
+ *   const maiat = new Maiat({ clientId: "my-agent" });
  *   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" });
  */
 // ─── Client ───────────────────────────────────────────────────────────────────
 export class Maiat {
     baseUrl;
     apiKey;
+    clientId;
     timeout;
     constructor(config = {}) {
         this.baseUrl = (config.baseUrl ?? "https://maiat-protocol.vercel.app").replace(/\/$/, "");
         this.apiKey = config.apiKey;
+        this.clientId = config.clientId;
         this.timeout = config.timeout ?? 15_000;
     }
     async request(path, options) {
         const headers = {
             "Content-Type": "application/json",
             ...(this.apiKey ? { "X-Maiat-Key": this.apiKey } : {}),
+            ...(this.clientId ? { "X-Maiat-Client": this.clientId } : {}),
         };
         const res = await fetch(`${this.baseUrl}${path}`, {
             ...options,
@@ -54,6 +58,22 @@ export class Maiat {
     async listAgents(limit = 50) {
         return this.request(`/api/v1/agents?limit=${limit}`);
     }
+    // ─── Outcome Reporting (Training Data) ────────────────────────────────────
+    /**
+     * Report the outcome of an action taken after a Maiat trust check.
+     * This is the most valuable data for training the oracle.
+     *
+     * Example flow:
+     *   1. maiat.isTrusted("0x...") → true
+     *   2. You swap with that agent
+     *   3. maiat.reportOutcome({ target: "0x...", action: "swap", result: "success" })
+     */
+    async reportOutcome(report) {
+        return this.request("/api/v1/outcome", {
+            method: "POST",
+            body: JSON.stringify(report),
+        });
+    }
     // ─── Convenience ──────────────────────────────────────────────────────────
     /** Quick check: is this agent trustworthy? Returns true if score >= threshold */
     async isTrusted(address, threshold = 60) {

package/package.json

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