@moltos/sdk 0.15.5 → 0.15.7

package/dist/chunk-7BF5BHNF.mjs

@@ -0,0 +1,156 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/crypto.ts
+import { createHash, randomBytes } from "crypto";
+var STUB_MODE = true;
+function setStubMode(enabled) {
+  STUB_MODE = enabled;
+}
+function isStubMode() {
+  return STUB_MODE;
+}
+function generateKeypair() {
+  const privateBytes = new Uint8Array(randomBytes(32));
+  const publicBytes = derivePublicKeyBytes(privateBytes);
+  return {
+    privateKey: {
+      bytes: privateBytes,
+      toHex: () => Buffer.from(privateBytes).toString("hex")
+    },
+    publicKey: {
+      type: "BLS12_381",
+      bytes: publicBytes,
+      toHex: () => Buffer.from(publicBytes).toString("hex")
+    },
+    mnemonic: generateMnemonic()
+  };
+}
+function deriveKeypair(mnemonic, path = "m/44'/60'/0'/0/0") {
+  const seed = createHash("sha256").update(mnemonic + path).digest();
+  const privateBytes = new Uint8Array(seed.slice(0, 32));
+  const publicBytes = derivePublicKeyBytes(privateBytes);
+  return {
+    privateKey: {
+      bytes: privateBytes,
+      toHex: () => Buffer.from(privateBytes).toString("hex")
+    },
+    publicKey: {
+      type: "BLS12_381",
+      bytes: publicBytes,
+      toHex: () => Buffer.from(publicBytes).toString("hex")
+    }
+  };
+}
+function hashPayload(payload) {
+  const canonical = JSON.stringify(payload, Object.keys(payload).sort());
+  const hash = createHash("sha256").update(canonical).digest();
+  return new Uint8Array(hash);
+}
+function signAttestation(payload, privateKey) {
+  const messageHash = hashPayload(payload);
+  const sigData = createHash("sha256").update(Buffer.from(messageHash)).update(Buffer.from(privateKey.bytes)).digest();
+  const sigBytes = new Uint8Array(sigData.slice(0, 48));
+  const signature = {
+    type: "BLS12_381",
+    bytes: sigBytes,
+    toHex: () => Buffer.from(sigBytes).toString("hex"),
+    aggregate: (other) => aggregateSignatures([sigBytes, other.bytes])
+  };
+  return {
+    payload,
+    signature,
+    publicKey: derivePublicKey(privateKey),
+    proof: {
+      type: "bls12_381",
+      scheme: "basic"
+    }
+  };
+}
+function verifyAttestation(signed) {
+  if (STUB_MODE) {
+    console.warn("[TAP-SDK] BLS verification running in STUB mode");
+    return true;
+  }
+  throw new Error("Real BLS verification not yet implemented. Use stub mode for testing.");
+}
+function batchVerifyAttestations(attestations) {
+  if (STUB_MODE) {
+    const valid = attestations.map(() => true);
+    return { valid, allValid: true };
+  }
+  throw new Error("Batch verification not yet implemented");
+}
+function aggregateSignatures(signatures) {
+  const bytes = signatures.map((s) => s instanceof Uint8Array ? s : s.bytes);
+  const result = new Uint8Array(48);
+  for (const sig of bytes) {
+    for (let i = 0; i < 48 && i < sig.length; i++) {
+      result[i] ^= sig[i];
+    }
+  }
+  return {
+    type: "BLS12_381",
+    bytes: result,
+    toHex: () => Buffer.from(result).toString("hex"),
+    aggregate: (other) => aggregateSignatures([result, other.bytes])
+  };
+}
+function verifyAggregate(message, aggregateSig, publicKeys) {
+  if (STUB_MODE) {
+    console.warn("[TAP-SDK] Aggregate verification running in STUB mode");
+    return true;
+  }
+  throw new Error("Aggregate verification not yet implemented");
+}
+function derivePublicKeyBytes(privateBytes) {
+  const hash = createHash("sha256").update(privateBytes).digest();
+  const publicBytes = new Uint8Array(96);
+  for (let i = 0; i < 96; i++) {
+    publicBytes[i] = hash[i % hash.length] ^ privateBytes[i % privateBytes.length];
+  }
+  return publicBytes;
+}
+function derivePublicKey(privateKey) {
+  return {
+    type: "BLS12_381",
+    bytes: derivePublicKeyBytes(privateKey.bytes),
+    toHex: () => Buffer.from(derivePublicKeyBytes(privateKey.bytes)).toString("hex")
+  };
+}
+function generateMnemonic() {
+  const words = ["abandon", "ability", "able", "about", "above", "absent", "absorb", "abstract"];
+  const phrase = Array(12).fill(0).map(() => words[Math.floor(Math.random() * words.length)]);
+  return phrase.join(" ");
+}
+var crypto_default = {
+  generateKeypair,
+  deriveKeypair,
+  signAttestation,
+  verifyAttestation,
+  batchVerifyAttestations,
+  aggregateSignatures,
+  verifyAggregate,
+  hashPayload,
+  setStubMode,
+  isStubMode
+};
+
+export {
+  __require,
+  setStubMode,
+  isStubMode,
+  generateKeypair,
+  deriveKeypair,
+  hashPayload,
+  signAttestation,
+  verifyAttestation,
+  batchVerifyAttestations,
+  aggregateSignatures,
+  verifyAggregate,
+  crypto_default
+};

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;
@@ -654,6 +743,14 @@ declare class MarketplaceSDK {
  */
 declare const MoltOS: {
     sdk: (apiUrl?: string) => MoltOSSDK;
+    /**
+     * Register a new agent and return an initialized SDK instance.
+     * MoltOS.register('my-agent') — matches docs and Python SDK API.
+     */
+    register: (name: string, options?: {
+        email?: string;
+        apiUrl?: string;
+    }) => Promise<MoltOSSDK>;
     init: (agentId: string, apiKey: string, apiUrl?: string) => Promise<MoltOSSDK>;
 };
 

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;
@@ -654,6 +743,14 @@ declare class MarketplaceSDK {
  */
 declare const MoltOS: {
     sdk: (apiUrl?: string) => MoltOSSDK;
+    /**
+     * Register a new agent and return an initialized SDK instance.
+     * MoltOS.register('my-agent') — matches docs and Python SDK API.
+     */
+    register: (name: string, options?: {
+        email?: string;
+        apiUrl?: string;
+    }) => Promise<MoltOSSDK>;
     init: (agentId: string, apiKey: string, apiUrl?: string) => Promise<MoltOSSDK>;
 };
 

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
@@ -398,15 +399,18 @@ var MoltOSSDK = class {
       method: "POST",
       body: JSON.stringify({
         name,
-        public_key: publicKey,
+        publicKey,
+        // camelCase — matches API route
         ...config
       })
     });
-    if (response.agent && response.api_key) {
-      this.agentId = response.agent.agent_id;
-      this.apiKey = response.api_key;
+    const agentId = response.agent?.agentId || response.agent?.agent_id;
+    const apiKey = response.credentials?.apiKey || response.api_key;
+    if (agentId && apiKey) {
+      this.agentId = agentId;
+      this.apiKey = apiKey;
     }
-    return response;
+    return { agent: { ...response.agent, agent_id: agentId }, apiKey };
   }
   /**
    * Get agent profile and status
@@ -706,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;
@@ -830,6 +913,31 @@ var MarketplaceSDK = class {
 };
 var MoltOS = {
   sdk: (apiUrl) => new MoltOSSDK(apiUrl),
+  /**
+   * Register a new agent and return an initialized SDK instance.
+   * MoltOS.register('my-agent') — matches docs and Python SDK API.
+   */
+  register: async (name, options) => {
+    const { generateKeyPairSync } = await import("crypto");
+    const { privateKey, publicKey } = generateKeyPairSync("ed25519");
+    const pubRaw = publicKey.export({ type: "spki", format: "der" }).slice(-32);
+    const pubHex = pubRaw.toString("hex");
+    const sdk = new MoltOSSDK(options?.apiUrl);
+    const body = { name, publicKey: pubHex };
+    if (options?.email) body.email = options.email;
+    const response = await sdk.request("/agent/register", {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+    const agentId = response.agent?.agentId || response.agent?.agent_id;
+    const apiKey = response.credentials?.apiKey || response.api_key;
+    if (!agentId || !apiKey) throw new Error("Registration failed: " + JSON.stringify(response));
+    await sdk.init(agentId, apiKey);
+    sdk._ed25519PrivateKey = privateKey;
+    sdk._publicKeyHex = pubHex;
+    sdk.agentId = agentId;
+    return sdk;
+  },
   init: async (agentId, apiKey, apiUrl) => {
     const sdk = new MoltOSSDK(apiUrl);
     await sdk.init(agentId, apiKey);

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
@@ -238,15 +239,18 @@ var MoltOSSDK = class {
       method: "POST",
       body: JSON.stringify({
         name,
-        public_key: publicKey,
+        publicKey,
+        // camelCase — matches API route
         ...config
       })
     });
-    if (response.agent && response.api_key) {
-      this.agentId = response.agent.agent_id;
-      this.apiKey = response.api_key;
+    const agentId = response.agent?.agentId || response.agent?.agent_id;
+    const apiKey = response.credentials?.apiKey || response.api_key;
+    if (agentId && apiKey) {
+      this.agentId = agentId;
+      this.apiKey = apiKey;
     }
-    return response;
+    return { agent: { ...response.agent, agent_id: agentId }, apiKey };
   }
   /**
    * Get agent profile and status
@@ -546,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;
@@ -670,6 +753,31 @@ var MarketplaceSDK = class {
 };
 var MoltOS = {
   sdk: (apiUrl) => new MoltOSSDK(apiUrl),
+  /**
+   * Register a new agent and return an initialized SDK instance.
+   * MoltOS.register('my-agent') — matches docs and Python SDK API.
+   */
+  register: async (name, options) => {
+    const { generateKeyPairSync } = await import("crypto");
+    const { privateKey, publicKey } = generateKeyPairSync("ed25519");
+    const pubRaw = publicKey.export({ type: "spki", format: "der" }).slice(-32);
+    const pubHex = pubRaw.toString("hex");
+    const sdk = new MoltOSSDK(options?.apiUrl);
+    const body = { name, publicKey: pubHex };
+    if (options?.email) body.email = options.email;
+    const response = await sdk.request("/agent/register", {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+    const agentId = response.agent?.agentId || response.agent?.agent_id;
+    const apiKey = response.credentials?.apiKey || response.api_key;
+    if (!agentId || !apiKey) throw new Error("Registration failed: " + JSON.stringify(response));
+    await sdk.init(agentId, apiKey);
+    sdk._ed25519PrivateKey = privateKey;
+    sdk._publicKeyHex = pubHex;
+    sdk.agentId = agentId;
+    return sdk;
+  },
   init: async (agentId, apiKey, apiUrl) => {
     const sdk = new MoltOSSDK(apiUrl);
     await sdk.init(agentId, apiKey);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@moltos/sdk",
-  "version": "0.15.5",
-  "description": "MoltOS — The Agent Operating System SDK. Build agents that earn, persist, and compound trust.",
+  "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",
   "types": "dist/index.d.ts",
@@ -90,4 +90,4 @@
   "bin": {
     "moltos": "dist/cli.js"
   }
-}
+}