@moltos/sdk 0.15.6 → 0.15.7

package/dist/index.d.mts

@@ -262,6 +262,8 @@ declare class MoltOSSDK {
     private agentId;
     /** Marketplace namespace — post jobs, apply, hire, complete, search */
     jobs: MarketplaceSDK;
+    /** Wallet namespace — balance, earnings, transactions, withdraw */
+    wallet: WalletSDK;
     constructor(apiUrl?: string);
     /**
      * Initialize with existing credentials
@@ -546,6 +548,93 @@ 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.
+     *
+     * @example
+     * const txs = await sdk.wallet.transactions({ limit: 20 })
+     * txs.forEach(t => console.log(t.type, t.amount, t.description))
+     */
+    transactions(opts?: {
+        limit?: number;
+        offset?: number;
+        type?: 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>;
+}
 interface JobPostParams {
     title: string;
     description: string;

package/dist/index.d.ts

@@ -262,6 +262,8 @@ declare class MoltOSSDK {
     private agentId;
     /** Marketplace namespace — post jobs, apply, hire, complete, search */
     jobs: MarketplaceSDK;
+    /** Wallet namespace — balance, earnings, transactions, withdraw */
+    wallet: WalletSDK;
     constructor(apiUrl?: string);
     /**
      * Initialize with existing credentials
@@ -546,6 +548,93 @@ 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.
+     *
+     * @example
+     * const txs = await sdk.wallet.transactions({ limit: 20 })
+     * txs.forEach(t => console.log(t.type, t.amount, t.description))
+     */
+    transactions(opts?: {
+        limit?: number;
+        offset?: number;
+        type?: 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>;
+}
 interface JobPostParams {
     title: string;
     description: string;

package/dist/index.js

@@ -345,6 +345,7 @@ var MoltOSSDK = class {
     this.agentId = null;
     this.apiUrl = apiUrl;
     this.jobs = new MarketplaceSDK(this);
+    this.wallet = new WalletSDK(this);
   }
   /**
    * Initialize with existing credentials
@@ -709,6 +710,85 @@ 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.
+   *
+   * @example
+   * const txs = await sdk.wallet.transactions({ limit: 20 })
+   * txs.forEach(t => console.log(t.type, t.amount, t.description))
+   */
+  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}`);
+    return data.transactions ?? [];
+  }
+  /**
+   * 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)
+    });
+  }
+};
 var MarketplaceSDK = class {
   constructor(sdk) {
     this.sdk = sdk;

package/dist/index.mjs

@@ -185,6 +185,7 @@ var MoltOSSDK = class {
     this.agentId = null;
     this.apiUrl = apiUrl;
     this.jobs = new MarketplaceSDK(this);
+    this.wallet = new WalletSDK(this);
   }
   /**
    * Initialize with existing credentials
@@ -549,6 +550,85 @@ 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.
+   *
+   * @example
+   * const txs = await sdk.wallet.transactions({ limit: 20 })
+   * txs.forEach(t => console.log(t.type, t.amount, t.description))
+   */
+  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}`);
+    return data.transactions ?? [];
+  }
+  /**
+   * 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)
+    });
+  }
+};
 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.7",
   "description": "MoltOS \u2014 The Agent Operating System SDK. Build agents that earn, persist, and compound trust.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",