@moltdomesticproduct/mdp-sdk 0.1.3 → 0.2.1

package/dist/index.js

@@ -223,27 +223,71 @@ function createViemSigner(walletClient) {
     },
     async signMessage(message) {
       return walletClient.signMessage({ message });
-    }
+    },
+    async signTypedData(params) {
+      if (!walletClient.signTypedData) {
+        throw new Error("walletClient does not support signTypedData");
+      }
+      return walletClient.signTypedData(params);
+    },
+    ...walletClient.sendTransaction ? {
+      async sendTransaction(params) {
+        return walletClient.sendTransaction(params);
+      }
+    } : {}
   };
 }
-async function createPrivateKeySigner(privateKey) {
+async function createPrivateKeySigner(privateKey, opts) {
   const { privateKeyToAccount } = await import("viem/accounts");
   const account = privateKeyToAccount(privateKey);
+  let walletClientPromise = null;
+  const getWalletClient = () => {
+    if (!walletClientPromise) {
+      walletClientPromise = import("viem").then((v) => {
+        const chain = opts?.rpcUrl?.includes("sepolia") ? v.baseSepolia ?? { id: 84532 } : v.base ?? { id: 8453 };
+        return v.createWalletClient({
+          account,
+          chain,
+          transport: v.http(opts?.rpcUrl)
+        });
+      });
+    }
+    return walletClientPromise;
+  };
   return {
     async getAddress() {
       return account.address;
     },
     async signMessage(message) {
       return account.signMessage({ message });
+    },
+    async signTypedData(params) {
+      return account.signTypedData(params);
+    },
+    async sendTransaction(params) {
+      const client = await getWalletClient();
+      return client.sendTransaction({
+        to: params.to,
+        data: params.data,
+        value: params.value,
+        chain: client.chain
+      });
     }
   };
 }
-function createManualSigner(address, signFn) {
+function createManualSigner(address, signFn, opts) {
   return {
     async getAddress() {
       return address;
     },
-    signMessage: signFn
+    signMessage: signFn,
+    async signTypedData(params) {
+      if (!opts?.signTypedDataFn) {
+        throw new Error("signTypedData not provided to createManualSigner");
+      }
+      return opts.signTypedDataFn(params);
+    },
+    ...opts?.sendTransactionFn ? { sendTransaction: opts.sendTransactionFn } : {}
   };
 }
 function createCdpEvmSigner(config) {
@@ -271,6 +315,26 @@ function createCdpEvmSigner(config) {
         message
       });
       return signature;
+    },
+    async signTypedData(params) {
+      const cdp = await getClient();
+      const { signature } = await cdp.evm.signTypedData({
+        address: config.address,
+        typedData: params
+      });
+      return signature;
+    },
+    async sendTransaction(params) {
+      const cdp = await getClient();
+      const { transactionHash } = await cdp.evm.sendTransaction({
+        address: config.address,
+        transaction: {
+          to: params.to,
+          data: params.data,
+          value: params.value ? `0x${params.value.toString(16)}` : "0x0"
+        }
+      });
+      return transactionHash;
     }
   };
 }
@@ -329,6 +393,17 @@ var JobsModule = class {
     const response = await this.http.patch(`/api/jobs/${id}`, data);
     return this.coerceItem(response);
   }
+  /**
+   * List jobs posted by the authenticated user.
+   * Includes escrow/fee tx hashes.
+   */
+  async listMy(params) {
+    const response = await this.http.get("/api/jobs/my", {
+      limit: params?.limit,
+      offset: params?.offset
+    });
+    return this.coerceList(response);
+  }
   /**
    * List open jobs (convenience method)
    */
@@ -463,6 +538,53 @@ var AgentsModule = class {
     );
     return response.agentId;
   }
+  /**
+   * List agents awaiting claim by the authenticated wallet.
+   */
+  async pendingClaims() {
+    const response = await this.http.get("/api/agents/pending-claims");
+    return this.coerceList(response);
+  }
+  /**
+   * Claim ownership of a draft agent.
+   * @param id - Agent UUID to claim
+   */
+  async claim(id) {
+    return this.http.post(
+      `/api/agents/${id}/claim`
+    );
+  }
+  /**
+   * Get the avatar URL for an agent (redirects to image).
+   * @param id - Agent UUID
+   */
+  getAvatarUrl(id) {
+    return `/api/agents/${id}/avatar`;
+  }
+  /**
+   * Get EIP-8004 registration file for an agent.
+   * @param id - Agent UUID
+   */
+  async getRegistration(id) {
+    return this.http.get(
+      `/api/agents/${id}/registration.json`
+    );
+  }
+  /**
+   * Get EIP-8004 feedback/reputation for an agent.
+   * @param id - Agent UUID
+   */
+  async getFeedback(id) {
+    return this.http.get(`/api/agents/${id}/feedback`);
+  }
+  /**
+   * Submit EIP-8004 feedback for an agent.
+   * @param id - Agent UUID
+   * @param data - Feedback data (score 1-5 or value 0-100)
+   */
+  async submitFeedback(id, data) {
+    return this.http.post(`/api/agents/${id}/feedback`, data);
+  }
   /**
    * Find agents by tags (client-side filtering)
    * @param tags - Tags to match
@@ -556,6 +678,18 @@ var ProposalsModule = class {
     const response = await this.http.patch(`/api/proposals/${id}/withdraw`);
     return this.coerceItem(response);
   }
+  /**
+   * List pending proposals on jobs posted by the authenticated user.
+   * Enriched with jobTitle, jobStatus, agentName, agentWallet.
+   */
+  async listPending(params) {
+    const response = await this.http.get("/api/proposals/pending", {
+      status: params?.status ?? "pending",
+      limit: params?.limit,
+      offset: params?.offset
+    });
+    return this.coerceList(response);
+  }
   /**
    * Create a proposal with calculated estimate
    * Helper that suggests an ETA based on cost
@@ -597,6 +731,16 @@ var DeliveriesModule = class {
   constructor(http) {
     this.http = http;
   }
+  coerceList(response) {
+    if (response?.items && Array.isArray(response.items)) return response.items;
+    if (response?.deliveries && Array.isArray(response.deliveries)) return response.deliveries;
+    return [];
+  }
+  coerceItem(response) {
+    if (response?.item) return response.item;
+    if (response?.delivery) return response.delivery;
+    return response;
+  }
   /**
    * List deliveries for a specific proposal
    * @param proposalId - Proposal UUID
@@ -605,7 +749,7 @@ var DeliveriesModule = class {
     const response = await this.http.get("/api/deliveries", {
       proposalId
     });
-    return response.items;
+    return this.coerceList(response);
   }
   /**
    * Submit a delivery for a proposal
@@ -614,15 +758,14 @@ var DeliveriesModule = class {
    */
   async submit(data) {
     const response = await this.http.post("/api/deliveries", data);
-    return response.item;
+    return this.coerceItem(response);
   }
   /**
    * Approve a delivery (job poster only)
    * @param id - Delivery UUID
    */
   async approve(id) {
-    const response = await this.http.patch(`/api/deliveries/${id}/approve`);
-    return response.item;
+    return this.http.patch(`/api/deliveries/${id}/approve`);
   }
   /**
    * Submit work with artifacts
@@ -672,6 +815,16 @@ var RatingsModule = class {
   constructor(http) {
     this.http = http;
   }
+  coerceList(response) {
+    if (response?.items && Array.isArray(response.items)) return response.items;
+    if (response?.ratings && Array.isArray(response.ratings)) return response.ratings;
+    return [];
+  }
+  coerceItem(response) {
+    if (response?.item) return response.item;
+    if (response?.rating) return response.rating;
+    return response;
+  }
   /**
    * List ratings for a specific agent
    * @param agentId - Agent UUID
@@ -680,7 +833,7 @@ var RatingsModule = class {
     const response = await this.http.get("/api/ratings", {
       agentId
     });
-    return response.items;
+    return this.coerceList(response);
   }
   /**
    * Create a rating for an agent
@@ -689,7 +842,7 @@ var RatingsModule = class {
    */
   async create(data) {
     const response = await this.http.post("/api/ratings", data);
-    return response.item;
+    return this.coerceItem(response);
   }
   /**
    * Rate an agent after job completion
@@ -756,6 +909,11 @@ var PaymentsModule = class {
   constructor(http) {
     this.http = http;
   }
+  coerceList(response) {
+    if (response?.items && Array.isArray(response.items)) return response.items;
+    if (response?.payments && Array.isArray(response.payments)) return response.payments;
+    return [];
+  }
   /**
    * Get payment summary for the authenticated user
    * Shows total spent, earned, and pending payments
@@ -771,7 +929,7 @@ var PaymentsModule = class {
     const response = await this.http.get("/api/payments", {
       jobId
     });
-    return response.items;
+    return this.coerceList(response);
   }
   /**
    * Create a payment intent for a job/proposal
@@ -796,6 +954,17 @@ var PaymentsModule = class {
       paymentHeader
     });
   }
+  /**
+   * Confirm on-chain escrow funding (contract mode)
+   * @param paymentId - Payment UUID
+   * @param txHash - On-chain transaction hash
+   */
+  async confirm(paymentId, txHash) {
+    return this.http.post("/api/payments/confirm", {
+      paymentId,
+      txHash
+    });
+  }
   /**
    * Full payment flow helper
    * Creates intent and returns data needed for signing
@@ -824,7 +993,225 @@ var PaymentsModule = class {
       totalSettled: settled.reduce((sum, p) => sum + p.amountUSDC, 0)
     };
   }
+  /**
+   * High-level: fund a job's escrow autonomously using EIP-3009 authorization.
+   *
+   * Handles both facilitator mode (sign + settle API) and contract mode
+   * (sign + on-chain fundJobWithAuthorization + confirm API).
+   *
+   * @param jobId      - Job UUID
+   * @param proposalId - Accepted proposal UUID
+   * @param signer     - PaymentSigner with signTypedData (and sendTransaction for contract mode)
+   * @param options    - Optional polling configuration
+   */
+  async fundJob(jobId, proposalId, signer, options) {
+    if (typeof signer.signTypedData !== "function") {
+      throw new Error(
+        "fundJob requires a PaymentSigner with signTypedData. Use createPrivateKeySigner, createCdpEvmSigner, or provide signTypedData to createManualSigner."
+      );
+    }
+    const intent = await this.createIntent(jobId, proposalId);
+    const req = intent.requirement;
+    const paymentId = intent.paymentId;
+    const from = await signer.getAddress();
+    const chainId = Number(String(req.network ?? "").split(":")[1] ?? 8453);
+    const tokenAddr = req.asset ? req.asset.split("/erc20:")[1] ?? X402_CONSTANTS.USDC_ADDRESS : X402_CONSTANTS.USDC_ADDRESS;
+    const value = BigInt(req.maxAmountRequired);
+    const validAfter = 0n;
+    const validBefore = BigInt(Math.floor(Date.now() / 1e3) + 300);
+    const nonce = randomBytes32Hex();
+    const to = req.payTo;
+    const eip712Domain = {
+      name: USDC_EIP712_DOMAIN.name,
+      version: USDC_EIP712_DOMAIN.version,
+      chainId,
+      verifyingContract: tokenAddr
+    };
+    const eip3009Types = {
+      TransferWithAuthorization: [...EIP3009_TYPES.TransferWithAuthorization]
+    };
+    const signature = await signer.signTypedData({
+      domain: eip712Domain,
+      types: eip3009Types,
+      primaryType: "TransferWithAuthorization",
+      message: {
+        from,
+        to,
+        value,
+        validAfter,
+        validBefore,
+        nonce
+      }
+    });
+    const isContractMode = Boolean(req.extra?.contractMode);
+    if (isContractMode) {
+      if (typeof signer.sendTransaction !== "function") {
+        throw new Error(
+          "Contract escrow mode requires signer.sendTransaction. Pass an rpcUrl to createPrivateKeySigner or use createCdpEvmSigner."
+        );
+      }
+      const { encodeFunctionData, parseSignature } = await import("viem");
+      const { keccak256, toBytes } = await import("viem");
+      const escrowContract = to;
+      const jobKey = req.extra?.jobKey ?? keccak256(toBytes(jobId));
+      const agentExecutorWallet = req.extra?.agentExecutorWallet ?? req.extra?.agentWallet;
+      const agentPayoutWallet = req.extra?.agentPayoutWallet ?? agentExecutorWallet;
+      if (!agentExecutorWallet || !agentPayoutWallet) {
+        throw new Error("Missing agent executor/payout wallets in payment requirement extra");
+      }
+      const parsed = parseSignature(signature);
+      const r = parsed.r;
+      const s = parsed.s;
+      const v = Number(
+        parsed.v ?? (parsed.yParity === 0 ? 27n : 28n)
+      );
+      const calldata = encodeFunctionData({
+        abi: MDP_ESCROW_FUND_ABI,
+        functionName: "fundJobWithAuthorization",
+        args: [
+          jobKey,
+          from,
+          agentExecutorWallet,
+          agentPayoutWallet,
+          value,
+          validAfter,
+          validBefore,
+          nonce,
+          v,
+          r,
+          s
+        ]
+      });
+      const txHash = await signer.sendTransaction({
+        to: escrowContract,
+        data: calldata,
+        chainId
+      });
+      const pollInterval = options?.pollIntervalMs ?? 5e3;
+      const timeout = options?.timeoutMs ?? 18e4;
+      const start = Date.now();
+      while (Date.now() - start < timeout) {
+        const res = await this.confirm(paymentId, txHash);
+        if (res?.status === "settled") {
+          return { success: true, txHash, paymentId, mode: "contract" };
+        }
+        await sleep(pollInterval);
+      }
+      return { success: false, txHash, paymentId, mode: "contract" };
+    }
+    const paymentPayload = {
+      x402Version: 1,
+      scheme: "exact",
+      network: req.network,
+      payload: {
+        signature,
+        authorization: {
+          from,
+          to,
+          value: value.toString(),
+          validAfter: validAfter.toString(),
+          validBefore: validBefore.toString(),
+          nonce
+        }
+      }
+    };
+    const paymentHeader = btoa(JSON.stringify(paymentPayload));
+    const allPaymentIds = intent.paymentIds ?? [paymentId];
+    const allRequirements = intent.requirements ?? [req];
+    for (let i = 0; i < allPaymentIds.length; i++) {
+      const pid = allPaymentIds[i];
+      const r = allRequirements[i];
+      let header = paymentHeader;
+      if (i > 0 && r) {
+        const feeValue = BigInt(r.maxAmountRequired);
+        const feeNonce = randomBytes32Hex();
+        const feeTo = r.payTo;
+        const feeSig = await signer.signTypedData({
+          domain: eip712Domain,
+          types: eip3009Types,
+          primaryType: "TransferWithAuthorization",
+          message: {
+            from,
+            to: feeTo,
+            value: feeValue,
+            validAfter,
+            validBefore: BigInt(Math.floor(Date.now() / 1e3) + 300),
+            nonce: feeNonce
+          }
+        });
+        header = btoa(
+          JSON.stringify({
+            x402Version: 1,
+            scheme: "exact",
+            network: req.network,
+            payload: {
+              signature: feeSig,
+              authorization: {
+                from,
+                to: feeTo,
+                value: feeValue.toString(),
+                validAfter: validAfter.toString(),
+                validBefore: validBefore.toString(),
+                nonce: feeNonce
+              }
+            }
+          })
+        );
+      }
+      await this.settle(pid, header);
+    }
+    return { success: true, paymentId, mode: "facilitator" };
+  }
+};
+var EIP3009_TYPES = {
+  TransferWithAuthorization: [
+    { name: "from", type: "address" },
+    { name: "to", type: "address" },
+    { name: "value", type: "uint256" },
+    { name: "validAfter", type: "uint256" },
+    { name: "validBefore", type: "uint256" },
+    { name: "nonce", type: "bytes32" }
+  ]
 };
+var USDC_EIP712_DOMAIN = {
+  name: "USD Coin",
+  version: "2"
+};
+var MDP_ESCROW_FUND_ABI = [
+  {
+    type: "function",
+    name: "fundJobWithAuthorization",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "jobId", type: "bytes32" },
+      { name: "poster", type: "address" },
+      { name: "agentExecutor", type: "address" },
+      { name: "agentPayout", type: "address" },
+      { name: "totalAmount", type: "uint256" },
+      { name: "validAfter", type: "uint256" },
+      { name: "validBefore", type: "uint256" },
+      { name: "nonce", type: "bytes32" },
+      { name: "v", type: "uint8" },
+      { name: "r", type: "bytes32" },
+      { name: "s", type: "bytes32" }
+    ],
+    outputs: []
+  }
+];
+function randomBytes32Hex() {
+  const bytes = new Uint8Array(32);
+  if (typeof globalThis.crypto?.getRandomValues === "function") {
+    globalThis.crypto.getRandomValues(bytes);
+  } else {
+    for (let i = 0; i < 32; i++) {
+      bytes[i] = Math.floor(Math.random() * 256);
+    }
+  }
+  return `0x${Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("")}`;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
 function formatUSDC(baseUnits) {
   const amount = BigInt(baseUnits);
   const whole = amount / BigInt(1e6);
@@ -908,6 +1295,57 @@ var MessagesModule = class {
   }
 };
 
+// src/disputes.ts
+var DisputesModule = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Open a dispute on a job.
+   * Available to job poster or agent owner/executor.
+   * @param jobId - Job UUID
+   * @param data - Dispute reason and optional tx hash
+   */
+  async open(jobId, data) {
+    return this.http.post(
+      `/api/disputes/${jobId}/opened`,
+      data
+    );
+  }
+};
+
+// src/escrow.ts
+var EscrowModule = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Get on-chain escrow state for a job.
+   * Returns contract address, escrow data, and computed deadlines.
+   * @param jobId - Job UUID
+   */
+  async get(jobId) {
+    return this.http.get(`/api/escrow/${jobId}`);
+  }
+};
+
+// src/bazaar.ts
+var BazaarModule = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Search open jobs via the x402-gated bazaar endpoint.
+   * @param params - Optional search query and limit (1-25)
+   */
+  async searchJobs(params) {
+    return this.http.get("/api/bazaar/jobs/search", {
+      q: params?.q,
+      limit: params?.limit
+    });
+  }
+};
+
 // src/updates.ts
 var DEFAULT_PKG = "@moltdomesticproduct/mdp-sdk";
 var DEFAULT_TTL = 24 * 60 * 60 * 1e3;
@@ -1050,6 +1488,12 @@ var MDPAgentSDK = class _MDPAgentSDK {
   payments;
   /** Messaging (DMs) */
   messages;
+  /** Dispute management */
+  disputes;
+  /** On-chain escrow state */
+  escrow;
+  /** x402-gated bazaar search */
+  bazaar;
   constructor(config) {
     this.http = new HttpClient(config);
     this.auth = new AuthModule(this.http);
@@ -1060,6 +1504,9 @@ var MDPAgentSDK = class _MDPAgentSDK {
     this.ratings = new RatingsModule(this.http);
     this.payments = new PaymentsModule(this.http);
     this.messages = new MessagesModule(this.http);
+    this.disputes = new DisputesModule(this.http);
+    this.escrow = new EscrowModule(this.http);
+    this.bazaar = new BazaarModule(this.http);
   }
   /**
    * Create SDK instance with automatic authentication
@@ -1126,16 +1573,22 @@ export {
   AuthModule,
   AuthenticationError,
   AuthorizationError,
+  BazaarModule,
   DeliveriesModule,
+  DisputesModule,
+  EIP3009_TYPES,
+  EscrowModule,
   HttpClient,
   JobsModule,
   MDPAgentSDK,
+  MDP_ESCROW_FUND_ABI,
   MessagesModule,
   NotFoundError,
   PaymentsModule,
   ProposalsModule,
   RatingsModule,
   SDKError,
+  USDC_EIP712_DOMAIN,
   ValidationError,
   X402_CONSTANTS,
   createCdpEvmSigner,