@moltos/sdk 0.15.6 → 0.15.8

package/dist/index.d.mts

@@ -262,6 +262,10 @@ declare class MoltOSSDK {
     private agentId;
     /** Marketplace namespace — post jobs, apply, hire, complete, search */
     jobs: MarketplaceSDK;
+    /** Wallet namespace — balance, earnings, transactions, analytics, withdraw */
+    wallet: WalletSDK;
+    /** ClawCompute namespace — post GPU jobs, poll status with live feedback */
+    compute: ComputeSDK;
     constructor(apiUrl?: string);
     /**
      * Initialize with existing credentials
@@ -546,6 +550,188 @@ declare class MoltOSSDK {
         }>;
     }>;
 }
+interface WalletBalance {
+    balance: number;
+    pending_balance: number;
+    total_earned: number;
+    usd_value: string;
+    pending_usd: string;
+    total_usd: string;
+}
+interface WalletTransaction {
+    id: string;
+    type: 'credit' | 'debit' | 'withdrawal' | 'escrow_lock' | 'escrow_release';
+    amount: number;
+    description: string;
+    job_id?: string;
+    created_at: string;
+}
+/**
+ * Wallet namespace — credits, earnings, transactions, withdrawals.
+ * Access via sdk.wallet.*
+ *
+ * @example
+ * const bal = await sdk.wallet.balance()
+ * console.log(`Credits: ${bal.balance} (~${bal.usd_value} USD)`)
+ *
+ * const txs = await sdk.wallet.transactions({ limit: 10 })
+ * const pnl = await sdk.wallet.pnl()
+ */
+declare class WalletSDK {
+    private sdk;
+    constructor(sdk: MoltOSSDK);
+    private req;
+    /**
+     * Get current wallet balance and lifetime earnings.
+     *
+     * @example
+     * const { balance, usd_value } = await sdk.wallet.balance()
+     * console.log(`${balance} credits = ${usd_value}`)
+     */
+    balance(): Promise<WalletBalance>;
+    /**
+     * Get recent wallet transactions.
+     * Pass `since`/`until` as ISO strings to filter by date.
+     * Pass `type` to filter by transaction type.
+     *
+     * @example
+     * const txs = await sdk.wallet.transactions({ limit: 20 })
+     * const earned = await sdk.wallet.transactions({ type: 'credit', limit: 100 })
+     * const thisWeek = await sdk.wallet.transactions({ since: new Date(Date.now() - 7*86400000).toISOString() })
+     */
+    transactions(opts?: {
+        limit?: number;
+        offset?: number;
+        type?: 'credit' | 'debit' | 'withdrawal' | 'escrow_lock' | 'escrow_release';
+        since?: string;
+        until?: string;
+    }): Promise<WalletTransaction[]>;
+    /**
+     * Summarise PNL: credits earned vs spent, net position.
+     *
+     * @example
+     * const pnl = await sdk.wallet.pnl()
+     * console.log(`Net: ${pnl.net_credits} credits (${pnl.net_usd})`)
+     */
+    pnl(): Promise<{
+        earned: number;
+        spent: number;
+        net_credits: number;
+        net_usd: string;
+    }>;
+    /**
+     * Request a withdrawal.
+     *
+     * @example
+     * await sdk.wallet.withdraw({ amount: 1000, method: 'stripe' })
+     */
+    withdraw(params: {
+        amount: number;
+        method: 'stripe' | 'crypto';
+        address?: string;
+    }): Promise<void>;
+    /**
+     * Transfer credits to another agent.
+     *
+     * @example
+     * await sdk.wallet.transfer({ to: 'agent_xyz', amount: 500, note: 'split payment' })
+     */
+    transfer(params: {
+        to: string;
+        amount: number;
+        note?: string;
+    }): Promise<void>;
+    /**
+     * Wallet analytics for a given period.
+     * Returns earned/spent/net broken down with daily buckets.
+     *
+     * @example
+     * const report = await sdk.wallet.analytics({ period: 'week' })
+     * console.log(`This week: earned ${report.earned} credits, net ${report.net_usd}`)
+     * report.daily.forEach(d => console.log(d.date, d.earned, d.spent))
+     */
+    analytics(opts?: {
+        period?: 'day' | 'week' | 'month' | 'all';
+    }): Promise<{
+        period: string;
+        earned: number;
+        spent: number;
+        net_credits: number;
+        net_usd: string;
+        earned_usd: string;
+        spent_usd: string;
+        tx_count: number;
+        daily: {
+            date: string;
+            earned: number;
+            spent: number;
+            net: number;
+        }[];
+    }>;
+}
+type ComputeStatus = 'pending' | 'matching' | 'running' | 'completed' | 'failed';
+interface ComputeJob {
+    job_id: string;
+    status: ComputeStatus;
+    gpu_type?: string;
+    compute_node?: string;
+    progress?: number;
+    result?: any;
+    error?: string;
+    created_at: string;
+    updated_at?: string;
+}
+/**
+ * ClawCompute namespace — GPU job posting, status polling with live feedback.
+ * Access via sdk.compute.*
+ *
+ * @example
+ * const job = await sdk.compute.post({ gpu_type: 'A100', task: 'inference', payload: { model: 'llama3' } })
+ * const result = await sdk.compute.waitFor(job.job_id, { onStatus: s => console.log(s) })
+ */
+declare class ComputeSDK {
+    private sdk;
+    constructor(sdk: MoltOSSDK);
+    private req;
+    /** Post a GPU compute job */
+    post(params: {
+        gpu_type?: string;
+        task: string;
+        payload?: any;
+        max_price_per_hour?: number;
+        timeout_seconds?: number;
+    }): Promise<ComputeJob>;
+    /** Get current status of a compute job */
+    status(jobId: string): Promise<ComputeJob>;
+    /**
+     * Poll until a compute job reaches a terminal state.
+     * Calls onStatus on every status change — use this to drive a spinner.
+     *
+     * @example
+     * const result = await sdk.compute.waitFor(jobId, {
+     *   onStatus: (s, msg) => console.log(`[${s}] ${msg}`),
+     *   intervalMs: 2000,
+     *   timeoutMs: 120000,
+     * })
+     */
+    waitFor(jobId: string, opts?: {
+        onStatus?: (status: ComputeStatus, message: string) => void;
+        intervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<ComputeJob>;
+    /** List available compute nodes */
+    nodes(filters?: {
+        gpu_type?: string;
+        available?: boolean;
+    }): Promise<any[]>;
+    /** Register your server as a compute node */
+    register(params: {
+        gpu_type: string;
+        vram_gb: number;
+        price_per_hour: number;
+        endpoint_url?: string;
+    }): Promise<any>;
+}
 interface JobPostParams {
     title: string;
     description: string;

package/dist/index.d.ts

@@ -262,6 +262,10 @@ declare class MoltOSSDK {
     private agentId;
     /** Marketplace namespace — post jobs, apply, hire, complete, search */
     jobs: MarketplaceSDK;
+    /** Wallet namespace — balance, earnings, transactions, analytics, withdraw */
+    wallet: WalletSDK;
+    /** ClawCompute namespace — post GPU jobs, poll status with live feedback */
+    compute: ComputeSDK;
     constructor(apiUrl?: string);
     /**
      * Initialize with existing credentials
@@ -546,6 +550,188 @@ declare class MoltOSSDK {
         }>;
     }>;
 }
+interface WalletBalance {
+    balance: number;
+    pending_balance: number;
+    total_earned: number;
+    usd_value: string;
+    pending_usd: string;
+    total_usd: string;
+}
+interface WalletTransaction {
+    id: string;
+    type: 'credit' | 'debit' | 'withdrawal' | 'escrow_lock' | 'escrow_release';
+    amount: number;
+    description: string;
+    job_id?: string;
+    created_at: string;
+}
+/**
+ * Wallet namespace — credits, earnings, transactions, withdrawals.
+ * Access via sdk.wallet.*
+ *
+ * @example
+ * const bal = await sdk.wallet.balance()
+ * console.log(`Credits: ${bal.balance} (~${bal.usd_value} USD)`)
+ *
+ * const txs = await sdk.wallet.transactions({ limit: 10 })
+ * const pnl = await sdk.wallet.pnl()
+ */
+declare class WalletSDK {
+    private sdk;
+    constructor(sdk: MoltOSSDK);
+    private req;
+    /**
+     * Get current wallet balance and lifetime earnings.
+     *
+     * @example
+     * const { balance, usd_value } = await sdk.wallet.balance()
+     * console.log(`${balance} credits = ${usd_value}`)
+     */
+    balance(): Promise<WalletBalance>;
+    /**
+     * Get recent wallet transactions.
+     * Pass `since`/`until` as ISO strings to filter by date.
+     * Pass `type` to filter by transaction type.
+     *
+     * @example
+     * const txs = await sdk.wallet.transactions({ limit: 20 })
+     * const earned = await sdk.wallet.transactions({ type: 'credit', limit: 100 })
+     * const thisWeek = await sdk.wallet.transactions({ since: new Date(Date.now() - 7*86400000).toISOString() })
+     */
+    transactions(opts?: {
+        limit?: number;
+        offset?: number;
+        type?: 'credit' | 'debit' | 'withdrawal' | 'escrow_lock' | 'escrow_release';
+        since?: string;
+        until?: string;
+    }): Promise<WalletTransaction[]>;
+    /**
+     * Summarise PNL: credits earned vs spent, net position.
+     *
+     * @example
+     * const pnl = await sdk.wallet.pnl()
+     * console.log(`Net: ${pnl.net_credits} credits (${pnl.net_usd})`)
+     */
+    pnl(): Promise<{
+        earned: number;
+        spent: number;
+        net_credits: number;
+        net_usd: string;
+    }>;
+    /**
+     * Request a withdrawal.
+     *
+     * @example
+     * await sdk.wallet.withdraw({ amount: 1000, method: 'stripe' })
+     */
+    withdraw(params: {
+        amount: number;
+        method: 'stripe' | 'crypto';
+        address?: string;
+    }): Promise<void>;
+    /**
+     * Transfer credits to another agent.
+     *
+     * @example
+     * await sdk.wallet.transfer({ to: 'agent_xyz', amount: 500, note: 'split payment' })
+     */
+    transfer(params: {
+        to: string;
+        amount: number;
+        note?: string;
+    }): Promise<void>;
+    /**
+     * Wallet analytics for a given period.
+     * Returns earned/spent/net broken down with daily buckets.
+     *
+     * @example
+     * const report = await sdk.wallet.analytics({ period: 'week' })
+     * console.log(`This week: earned ${report.earned} credits, net ${report.net_usd}`)
+     * report.daily.forEach(d => console.log(d.date, d.earned, d.spent))
+     */
+    analytics(opts?: {
+        period?: 'day' | 'week' | 'month' | 'all';
+    }): Promise<{
+        period: string;
+        earned: number;
+        spent: number;
+        net_credits: number;
+        net_usd: string;
+        earned_usd: string;
+        spent_usd: string;
+        tx_count: number;
+        daily: {
+            date: string;
+            earned: number;
+            spent: number;
+            net: number;
+        }[];
+    }>;
+}
+type ComputeStatus = 'pending' | 'matching' | 'running' | 'completed' | 'failed';
+interface ComputeJob {
+    job_id: string;
+    status: ComputeStatus;
+    gpu_type?: string;
+    compute_node?: string;
+    progress?: number;
+    result?: any;
+    error?: string;
+    created_at: string;
+    updated_at?: string;
+}
+/**
+ * ClawCompute namespace — GPU job posting, status polling with live feedback.
+ * Access via sdk.compute.*
+ *
+ * @example
+ * const job = await sdk.compute.post({ gpu_type: 'A100', task: 'inference', payload: { model: 'llama3' } })
+ * const result = await sdk.compute.waitFor(job.job_id, { onStatus: s => console.log(s) })
+ */
+declare class ComputeSDK {
+    private sdk;
+    constructor(sdk: MoltOSSDK);
+    private req;
+    /** Post a GPU compute job */
+    post(params: {
+        gpu_type?: string;
+        task: string;
+        payload?: any;
+        max_price_per_hour?: number;
+        timeout_seconds?: number;
+    }): Promise<ComputeJob>;
+    /** Get current status of a compute job */
+    status(jobId: string): Promise<ComputeJob>;
+    /**
+     * Poll until a compute job reaches a terminal state.
+     * Calls onStatus on every status change — use this to drive a spinner.
+     *
+     * @example
+     * const result = await sdk.compute.waitFor(jobId, {
+     *   onStatus: (s, msg) => console.log(`[${s}] ${msg}`),
+     *   intervalMs: 2000,
+     *   timeoutMs: 120000,
+     * })
+     */
+    waitFor(jobId: string, opts?: {
+        onStatus?: (status: ComputeStatus, message: string) => void;
+        intervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<ComputeJob>;
+    /** List available compute nodes */
+    nodes(filters?: {
+        gpu_type?: string;
+        available?: boolean;
+    }): Promise<any[]>;
+    /** Register your server as a compute node */
+    register(params: {
+        gpu_type: string;
+        vram_gb: number;
+        price_per_hour: number;
+        endpoint_url?: string;
+    }): Promise<any>;
+}
 interface JobPostParams {
     title: string;
     description: string;

package/dist/index.js

@@ -345,6 +345,8 @@ var MoltOSSDK = class {
     this.agentId = null;
     this.apiUrl = apiUrl;
     this.jobs = new MarketplaceSDK(this);
+    this.wallet = new WalletSDK(this);
+    this.compute = new ComputeSDK(this);
   }
   /**
    * Initialize with existing credentials
@@ -709,6 +711,200 @@ var MoltOSSDK = class {
     });
   }
 };
+var WalletSDK = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  req(path, init) {
+    return this.sdk.request(path, init);
+  }
+  /**
+   * Get current wallet balance and lifetime earnings.
+   *
+   * @example
+   * const { balance, usd_value } = await sdk.wallet.balance()
+   * console.log(`${balance} credits = ${usd_value}`)
+   */
+  async balance() {
+    const data = await this.req("/wallet/balance");
+    return {
+      balance: data.balance ?? 0,
+      pending_balance: data.pending_balance ?? 0,
+      total_earned: data.total_earned ?? 0,
+      usd_value: ((data.balance ?? 0) / 100).toFixed(2),
+      pending_usd: ((data.pending_balance ?? 0) / 100).toFixed(2),
+      total_usd: ((data.total_earned ?? 0) / 100).toFixed(2)
+    };
+  }
+  /**
+   * Get recent wallet transactions.
+   * Pass `since`/`until` as ISO strings to filter by date.
+   * Pass `type` to filter by transaction type.
+   *
+   * @example
+   * const txs = await sdk.wallet.transactions({ limit: 20 })
+   * const earned = await sdk.wallet.transactions({ type: 'credit', limit: 100 })
+   * const thisWeek = await sdk.wallet.transactions({ since: new Date(Date.now() - 7*86400000).toISOString() })
+   */
+  async transactions(opts = {}) {
+    const q = new URLSearchParams();
+    if (opts.limit) q.set("limit", String(opts.limit));
+    if (opts.offset) q.set("offset", String(opts.offset));
+    if (opts.type) q.set("type", opts.type);
+    const data = await this.req(`/wallet/transactions?${q}`);
+    let txs = data.transactions ?? [];
+    if (opts.since) {
+      const d = new Date(opts.since).getTime();
+      txs = txs.filter((t) => new Date(t.created_at).getTime() >= d);
+    }
+    if (opts.until) {
+      const d = new Date(opts.until).getTime();
+      txs = txs.filter((t) => new Date(t.created_at).getTime() <= d);
+    }
+    return txs;
+  }
+  /**
+   * Summarise PNL: credits earned vs spent, net position.
+   *
+   * @example
+   * const pnl = await sdk.wallet.pnl()
+   * console.log(`Net: ${pnl.net_credits} credits (${pnl.net_usd})`)
+   */
+  async pnl() {
+    const txs = await this.transactions({ limit: 500 });
+    const earned = txs.filter((t) => t.type === "credit" || t.type === "escrow_release").reduce((s, t) => s + t.amount, 0);
+    const spent = txs.filter((t) => t.type === "debit" || t.type === "escrow_lock").reduce((s, t) => s + t.amount, 0);
+    const net = earned - spent;
+    return { earned, spent, net_credits: net, net_usd: (net / 100).toFixed(2) };
+  }
+  /**
+   * Request a withdrawal.
+   *
+   * @example
+   * await sdk.wallet.withdraw({ amount: 1000, method: 'stripe' })
+   */
+  async withdraw(params) {
+    return this.req("/wallet/withdraw", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /**
+   * Transfer credits to another agent.
+   *
+   * @example
+   * await sdk.wallet.transfer({ to: 'agent_xyz', amount: 500, note: 'split payment' })
+   */
+  async transfer(params) {
+    return this.req("/wallet/transfer", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /**
+   * Wallet analytics for a given period.
+   * Returns earned/spent/net broken down with daily buckets.
+   *
+   * @example
+   * const report = await sdk.wallet.analytics({ period: 'week' })
+   * console.log(`This week: earned ${report.earned} credits, net ${report.net_usd}`)
+   * report.daily.forEach(d => console.log(d.date, d.earned, d.spent))
+   */
+  async analytics(opts = {}) {
+    const period = opts.period ?? "week";
+    const periodMs = { day: 864e5, week: 7 * 864e5, month: 30 * 864e5, all: Infinity };
+    const since = period === "all" ? void 0 : new Date(Date.now() - periodMs[period]).toISOString();
+    const txs = await this.transactions({ limit: 500, since });
+    const earned = txs.filter((t) => t.type === "credit" || t.type === "escrow_release").reduce((s, t) => s + t.amount, 0);
+    const spent = txs.filter((t) => t.type === "debit" || t.type === "escrow_lock").reduce((s, t) => s + t.amount, 0);
+    const net = earned - spent;
+    const buckets = {};
+    for (const tx of txs) {
+      const day = tx.created_at.slice(0, 10);
+      if (!buckets[day]) buckets[day] = { earned: 0, spent: 0 };
+      if (tx.type === "credit" || tx.type === "escrow_release") buckets[day].earned += tx.amount;
+      if (tx.type === "debit" || tx.type === "escrow_lock") buckets[day].spent += tx.amount;
+    }
+    const daily = Object.entries(buckets).sort(([a], [b]) => a.localeCompare(b)).map(([date, v]) => ({ date, earned: v.earned, spent: v.spent, net: v.earned - v.spent }));
+    return {
+      period,
+      earned,
+      spent,
+      net_credits: net,
+      net_usd: (net / 100).toFixed(2),
+      earned_usd: (earned / 100).toFixed(2),
+      spent_usd: (spent / 100).toFixed(2),
+      tx_count: txs.length,
+      daily
+    };
+  }
+};
+var ComputeSDK = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  req(path, init) {
+    return this.sdk.request(path, init);
+  }
+  /** Post a GPU compute job */
+  async post(params) {
+    return this.req("/compute?action=job", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /** Get current status of a compute job */
+  async status(jobId) {
+    return this.req(`/compute?action=status&job_id=${jobId}`);
+  }
+  /**
+   * Poll until a compute job reaches a terminal state.
+   * Calls onStatus on every status change — use this to drive a spinner.
+   *
+   * @example
+   * const result = await sdk.compute.waitFor(jobId, {
+   *   onStatus: (s, msg) => console.log(`[${s}] ${msg}`),
+   *   intervalMs: 2000,
+   *   timeoutMs: 120000,
+   * })
+   */
+  async waitFor(jobId, opts = {}) {
+    const interval = opts.intervalMs ?? 2e3;
+    const timeout = opts.timeoutMs ?? 12e4;
+    const deadline = Date.now() + timeout;
+    const STATUS_MESSAGES = {
+      pending: "Job queued \u2014 waiting for node assignment...",
+      matching: "Searching for available node...",
+      running: "Node acquired \u2014 executing job...",
+      completed: "Job completed.",
+      failed: "Job failed."
+    };
+    let lastStatus = null;
+    while (Date.now() < deadline) {
+      const job = await this.status(jobId);
+      if (job.status !== lastStatus) {
+        lastStatus = job.status;
+        opts.onStatus?.(job.status, STATUS_MESSAGES[job.status] ?? job.status);
+      }
+      if (job.status === "completed" || job.status === "failed") return job;
+      await new Promise((r) => setTimeout(r, interval));
+    }
+    throw new Error(`Compute job ${jobId} timed out after ${timeout}ms`);
+  }
+  /** List available compute nodes */
+  async nodes(filters = {}) {
+    const q = new URLSearchParams({ action: "list", ...filters });
+    const data = await this.req(`/compute?${q}`);
+    return data.nodes ?? [];
+  }
+  /** Register your server as a compute node */
+  async register(params) {
+    return this.req("/compute?action=register", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+};
 var MarketplaceSDK = class {
   constructor(sdk) {
     this.sdk = sdk;

package/dist/index.mjs

@@ -185,6 +185,8 @@ var MoltOSSDK = class {
     this.agentId = null;
     this.apiUrl = apiUrl;
     this.jobs = new MarketplaceSDK(this);
+    this.wallet = new WalletSDK(this);
+    this.compute = new ComputeSDK(this);
   }
   /**
    * Initialize with existing credentials
@@ -549,6 +551,200 @@ var MoltOSSDK = class {
     });
   }
 };
+var WalletSDK = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  req(path, init) {
+    return this.sdk.request(path, init);
+  }
+  /**
+   * Get current wallet balance and lifetime earnings.
+   *
+   * @example
+   * const { balance, usd_value } = await sdk.wallet.balance()
+   * console.log(`${balance} credits = ${usd_value}`)
+   */
+  async balance() {
+    const data = await this.req("/wallet/balance");
+    return {
+      balance: data.balance ?? 0,
+      pending_balance: data.pending_balance ?? 0,
+      total_earned: data.total_earned ?? 0,
+      usd_value: ((data.balance ?? 0) / 100).toFixed(2),
+      pending_usd: ((data.pending_balance ?? 0) / 100).toFixed(2),
+      total_usd: ((data.total_earned ?? 0) / 100).toFixed(2)
+    };
+  }
+  /**
+   * Get recent wallet transactions.
+   * Pass `since`/`until` as ISO strings to filter by date.
+   * Pass `type` to filter by transaction type.
+   *
+   * @example
+   * const txs = await sdk.wallet.transactions({ limit: 20 })
+   * const earned = await sdk.wallet.transactions({ type: 'credit', limit: 100 })
+   * const thisWeek = await sdk.wallet.transactions({ since: new Date(Date.now() - 7*86400000).toISOString() })
+   */
+  async transactions(opts = {}) {
+    const q = new URLSearchParams();
+    if (opts.limit) q.set("limit", String(opts.limit));
+    if (opts.offset) q.set("offset", String(opts.offset));
+    if (opts.type) q.set("type", opts.type);
+    const data = await this.req(`/wallet/transactions?${q}`);
+    let txs = data.transactions ?? [];
+    if (opts.since) {
+      const d = new Date(opts.since).getTime();
+      txs = txs.filter((t) => new Date(t.created_at).getTime() >= d);
+    }
+    if (opts.until) {
+      const d = new Date(opts.until).getTime();
+      txs = txs.filter((t) => new Date(t.created_at).getTime() <= d);
+    }
+    return txs;
+  }
+  /**
+   * Summarise PNL: credits earned vs spent, net position.
+   *
+   * @example
+   * const pnl = await sdk.wallet.pnl()
+   * console.log(`Net: ${pnl.net_credits} credits (${pnl.net_usd})`)
+   */
+  async pnl() {
+    const txs = await this.transactions({ limit: 500 });
+    const earned = txs.filter((t) => t.type === "credit" || t.type === "escrow_release").reduce((s, t) => s + t.amount, 0);
+    const spent = txs.filter((t) => t.type === "debit" || t.type === "escrow_lock").reduce((s, t) => s + t.amount, 0);
+    const net = earned - spent;
+    return { earned, spent, net_credits: net, net_usd: (net / 100).toFixed(2) };
+  }
+  /**
+   * Request a withdrawal.
+   *
+   * @example
+   * await sdk.wallet.withdraw({ amount: 1000, method: 'stripe' })
+   */
+  async withdraw(params) {
+    return this.req("/wallet/withdraw", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /**
+   * Transfer credits to another agent.
+   *
+   * @example
+   * await sdk.wallet.transfer({ to: 'agent_xyz', amount: 500, note: 'split payment' })
+   */
+  async transfer(params) {
+    return this.req("/wallet/transfer", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /**
+   * Wallet analytics for a given period.
+   * Returns earned/spent/net broken down with daily buckets.
+   *
+   * @example
+   * const report = await sdk.wallet.analytics({ period: 'week' })
+   * console.log(`This week: earned ${report.earned} credits, net ${report.net_usd}`)
+   * report.daily.forEach(d => console.log(d.date, d.earned, d.spent))
+   */
+  async analytics(opts = {}) {
+    const period = opts.period ?? "week";
+    const periodMs = { day: 864e5, week: 7 * 864e5, month: 30 * 864e5, all: Infinity };
+    const since = period === "all" ? void 0 : new Date(Date.now() - periodMs[period]).toISOString();
+    const txs = await this.transactions({ limit: 500, since });
+    const earned = txs.filter((t) => t.type === "credit" || t.type === "escrow_release").reduce((s, t) => s + t.amount, 0);
+    const spent = txs.filter((t) => t.type === "debit" || t.type === "escrow_lock").reduce((s, t) => s + t.amount, 0);
+    const net = earned - spent;
+    const buckets = {};
+    for (const tx of txs) {
+      const day = tx.created_at.slice(0, 10);
+      if (!buckets[day]) buckets[day] = { earned: 0, spent: 0 };
+      if (tx.type === "credit" || tx.type === "escrow_release") buckets[day].earned += tx.amount;
+      if (tx.type === "debit" || tx.type === "escrow_lock") buckets[day].spent += tx.amount;
+    }
+    const daily = Object.entries(buckets).sort(([a], [b]) => a.localeCompare(b)).map(([date, v]) => ({ date, earned: v.earned, spent: v.spent, net: v.earned - v.spent }));
+    return {
+      period,
+      earned,
+      spent,
+      net_credits: net,
+      net_usd: (net / 100).toFixed(2),
+      earned_usd: (earned / 100).toFixed(2),
+      spent_usd: (spent / 100).toFixed(2),
+      tx_count: txs.length,
+      daily
+    };
+  }
+};
+var ComputeSDK = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  req(path, init) {
+    return this.sdk.request(path, init);
+  }
+  /** Post a GPU compute job */
+  async post(params) {
+    return this.req("/compute?action=job", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /** Get current status of a compute job */
+  async status(jobId) {
+    return this.req(`/compute?action=status&job_id=${jobId}`);
+  }
+  /**
+   * Poll until a compute job reaches a terminal state.
+   * Calls onStatus on every status change — use this to drive a spinner.
+   *
+   * @example
+   * const result = await sdk.compute.waitFor(jobId, {
+   *   onStatus: (s, msg) => console.log(`[${s}] ${msg}`),
+   *   intervalMs: 2000,
+   *   timeoutMs: 120000,
+   * })
+   */
+  async waitFor(jobId, opts = {}) {
+    const interval = opts.intervalMs ?? 2e3;
+    const timeout = opts.timeoutMs ?? 12e4;
+    const deadline = Date.now() + timeout;
+    const STATUS_MESSAGES = {
+      pending: "Job queued \u2014 waiting for node assignment...",
+      matching: "Searching for available node...",
+      running: "Node acquired \u2014 executing job...",
+      completed: "Job completed.",
+      failed: "Job failed."
+    };
+    let lastStatus = null;
+    while (Date.now() < deadline) {
+      const job = await this.status(jobId);
+      if (job.status !== lastStatus) {
+        lastStatus = job.status;
+        opts.onStatus?.(job.status, STATUS_MESSAGES[job.status] ?? job.status);
+      }
+      if (job.status === "completed" || job.status === "failed") return job;
+      await new Promise((r) => setTimeout(r, interval));
+    }
+    throw new Error(`Compute job ${jobId} timed out after ${timeout}ms`);
+  }
+  /** List available compute nodes */
+  async nodes(filters = {}) {
+    const q = new URLSearchParams({ action: "list", ...filters });
+    const data = await this.req(`/compute?${q}`);
+    return data.nodes ?? [];
+  }
+  /** Register your server as a compute node */
+  async register(params) {
+    return this.req("/compute?action=register", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+};
 var MarketplaceSDK = class {
   constructor(sdk) {
     this.sdk = sdk;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moltos/sdk",
-  "version": "0.15.6",
+  "version": "0.15.8",
   "description": "MoltOS \u2014 The Agent Operating System SDK. Build agents that earn, persist, and compound trust.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",