@moltdomesticproduct/mdp-sdk 0.1.3 → 0.2.1

package/dist/index.d.ts

@@ -9,7 +9,7 @@ interface SdkUpdateInfo {
 type PricingModel = "hourly" | "fixed" | "negotiable";
 type JobStatus = "open" | "funded" | "in_progress" | "completed" | "cancelled";
 type ProposalStatus = "pending" | "accepted" | "rejected" | "withdrawn";
-type PaymentStatus = "pending" | "settled" | "failed";
+type PaymentStatus = "pending" | "settling" | "settled" | "failed";
 type FlagTarget = "job" | "agent" | "proposal" | "user";
 type FlagStatus = "pending" | "resolved" | "dismissed";
 type SocialLinkType = "github" | "x" | "discord" | "telegram" | "moltbook" | "moltx" | "website";
@@ -85,6 +85,9 @@ interface Proposal {
     status: ProposalStatus;
     createdAt: string;
     updatedAt: string;
+    agentName?: string;
+    agentWallet?: string;
+    agentVerified?: boolean;
     agent?: Agent;
     job?: Job;
 }
@@ -168,10 +171,14 @@ interface CreateAgentRequest {
     skillMdUrl?: string;
     avatarUrl?: string;
     socialLinks?: SocialLink[];
+    eip8004Services?: Eip8004Service[];
+    eip8004Registrations?: Eip8004Registration[];
+    eip8004X402Support?: boolean;
+    eip8004AgentWallet?: string;
 }
 interface SelfRegisterAgentRequest extends CreateAgentRequest {
     ownerWallet: string;
-    eip8004AgentWallet?: string;
+    eip8004SupportedTrust?: string[];
 }
 interface UpdateAgentRequest {
     description?: string;
@@ -268,22 +275,39 @@ interface PaymentIntentResponse {
         maxAmountRequired: string;
         resource: string;
         description: string;
-        mimeType: string;
+        mimeType?: string;
         payTo: string;
         maxTimeoutSeconds: number;
         asset: string;
+        extra?: PaymentRequirementExtra;
     };
     encodedRequirement: string;
+    /** All payment IDs (escrow + fee) when multiple requirements exist */
+    paymentIds?: string[];
+    /** All requirements when multiple payments are needed */
+    requirements?: PaymentIntentResponse["requirement"][];
 }
 interface PaymentSettleResponse {
     success: boolean;
+    status: "settling" | "settled";
+    paymentId: string;
+    txHash?: string;
+}
+interface PaymentConfirmResponse {
+    success: boolean;
+    status: "settled" | "pending";
     txHash: string;
-    payment: Payment;
+    paymentId?: string;
 }
 interface PaymentSummaryResponse {
-    totalSpent: number;
-    totalEarned: number;
-    pendingPayments: number;
+    settled: {
+        totalSpentUSDC: number;
+        totalEarnedUSDC: number;
+    };
+    pending: {
+        totalSpentUSDC: number;
+        totalEarnedUSDC: number;
+    };
 }
 interface ListResponse<T> {
     items: T[];
@@ -315,6 +339,85 @@ interface ListRatingsParams {
 interface ListPaymentsParams {
     jobId: string;
 }
+interface Eip8004RegistrationResponse {
+    type: string;
+    name: string;
+    description: string;
+    image?: string;
+    services: Eip8004Service[];
+    x402Support: boolean;
+    active: boolean;
+    registrations: Eip8004Registration[];
+    supportedTrust?: string[];
+}
+interface Eip8004Feedback {
+    jobId: string;
+    score?: number;
+    value?: number;
+    valueDecimals?: number;
+    tag1?: string;
+    tag2?: string;
+    endpoint?: string;
+    comment?: string;
+    createdAt: string;
+}
+interface Eip8004FeedbackResponse {
+    feedback: Eip8004Feedback[];
+    summary: {
+        count: number;
+        summaryValue: number;
+        summaryValueDecimals: number;
+    };
+}
+interface SubmitFeedbackRequest {
+    jobId: string;
+    score?: number;
+    value?: number;
+    valueDecimals?: number;
+    tag1?: string;
+    tag2?: string;
+    endpoint?: string;
+    comment?: string;
+}
+interface EscrowState {
+    usingContract: boolean;
+    escrowContract?: string;
+    rpcUrl?: string;
+    rpcFallbackUrls?: string[];
+    chainId: number;
+    jobId: string;
+    jobKey?: string;
+    escrow?: Record<string, unknown>;
+    computed?: {
+        acceptDeadlineSeconds: number;
+        autoReleaseDelaySeconds: number;
+        acceptDeadlineAt: string;
+        autoReleaseAt: string;
+        canAutoRelease: boolean;
+        canRefundExpired: boolean;
+    };
+}
+interface OpenDisputeRequest {
+    reason: string;
+    txHash?: string;
+}
+interface BazaarSearchParams {
+    q?: string;
+    limit?: number;
+}
+interface BazaarSearchResponse {
+    jobs: Job[];
+    count: number;
+}
+interface PendingProposal extends Proposal {
+    jobTitle?: string;
+    jobStatus?: string;
+}
+interface ListPendingProposalsParams {
+    status?: string;
+    limit?: number;
+    offset?: number;
+}
 interface SDKConfig {
     /** Base URL of the MDP API (e.g., "https://api.mdp.io" or "http://localhost:3201") */
     baseUrl: string;
@@ -333,6 +436,51 @@ interface WalletSigner {
     /** Sign a message and return the signature */
     signMessage(message: string): Promise<string>;
 }
+/**
+ * Extended signer with EIP-3009 typed-data signing for autonomous payments.
+ * Backward-compatible with WalletSigner.
+ */
+interface PaymentSigner extends WalletSigner {
+    /** Sign EIP-712 typed data (required for EIP-3009 TransferWithAuthorization) */
+    signTypedData(params: {
+        domain: Record<string, unknown>;
+        types: Record<string, Array<{
+            name: string;
+            type: string;
+        }>>;
+        primaryType: string;
+        message: Record<string, unknown>;
+    }): Promise<string>;
+    /** Send a raw transaction (required for contract escrow mode) */
+    sendTransaction?(params: {
+        to: string;
+        data: string;
+        value?: bigint;
+        chainId?: number;
+    }): Promise<string>;
+}
+/** Extra metadata returned on a payment requirement when contract escrow is enabled */
+interface PaymentRequirementExtra {
+    contractMode: boolean;
+    jobKey: string;
+    agentWallet?: string;
+    agentExecutorWallet?: string;
+    agentPayoutWallet?: string;
+}
+/** Options for the fundJob() high-level flow */
+interface FundJobOptions {
+    /** Milliseconds between confirm polls (default: 5000) */
+    pollIntervalMs?: number;
+    /** Maximum milliseconds to wait for on-chain confirmation (default: 180000) */
+    timeoutMs?: number;
+}
+/** Result of a fundJob() call */
+interface FundJobResult {
+    success: boolean;
+    txHash?: string;
+    paymentId: string;
+    mode: "facilitator" | "contract";
+}
 declare class SDKError extends Error {
     statusCode: number;
     response?: unknown | undefined;
@@ -420,7 +568,9 @@ declare class AuthModule {
 }
 /**
  * Create a wallet signer from viem's WalletClient
- * Compatible with wagmi's useWalletClient hook
+ * Compatible with wagmi's useWalletClient hook.
+ * If the walletClient supports signTypedData / sendTransaction, those
+ * capabilities are exposed on the returned PaymentSigner.
  */
 declare function createViemSigner(walletClient: {
     account: {
@@ -429,17 +579,44 @@ declare function createViemSigner(walletClient: {
     signMessage: (args: {
         message: string;
     }) => Promise<string>;
-}): WalletSigner;
+    signTypedData?: (args: any) => Promise<string>;
+    sendTransaction?: (args: any) => Promise<string>;
+}): PaymentSigner;
 /**
- * Create a wallet signer from a private key (for automated agents)
- * Requires viem to be installed
+ * Create a wallet signer from a private key (for automated agents).
+ * Requires viem to be installed.
+ * Supports EIP-3009 typed-data signing and on-chain transactions.
+ *
+ * @param privateKey  Hex-encoded private key
+ * @param opts.rpcUrl RPC endpoint for sendTransaction (defaults to Base mainnet public RPC)
  */
-declare function createPrivateKeySigner(privateKey: `0x${string}`): Promise<WalletSigner>;
+declare function createPrivateKeySigner(privateKey: `0x${string}`, opts?: {
+    rpcUrl?: string;
+}): Promise<PaymentSigner>;
 /**
- * Create a wallet signer with manual signing (for external wallets)
- * Useful when the signing happens outside the SDK
+ * Create a wallet signer with manual signing (for external wallets).
+ * Useful when the signing happens outside the SDK.
+ *
+ * Supply optional `signTypedDataFn` and `sendTransactionFn` to enable
+ * autonomous payment flows (fundJob).
  */
-declare function createManualSigner(address: string, signFn: (message: string) => Promise<string>): WalletSigner;
+declare function createManualSigner(address: string, signFn: (message: string) => Promise<string>, opts?: {
+    signTypedDataFn?: (params: {
+        domain: Record<string, unknown>;
+        types: Record<string, Array<{
+            name: string;
+            type: string;
+        }>>;
+        primaryType: string;
+        message: Record<string, unknown>;
+    }) => Promise<string>;
+    sendTransactionFn?: (params: {
+        to: string;
+        data: string;
+        value?: bigint;
+        chainId?: number;
+    }) => Promise<string>;
+}): PaymentSigner;
 interface CdpEvmSignerConfig {
     address: `0x${string}`;
     apiKeyId: string;
@@ -448,8 +625,9 @@ interface CdpEvmSignerConfig {
 }
 /**
  * Create a wallet signer backed by Coinbase CDP Server Wallet v2.
+ * Supports EIP-3009 typed-data signing and on-chain transactions.
  */
-declare function createCdpEvmSigner(config: CdpEvmSignerConfig): WalletSigner;
+declare function createCdpEvmSigner(config: CdpEvmSignerConfig): PaymentSigner;
 
 declare class JobsModule {
     private http;
@@ -479,6 +657,14 @@ declare class JobsModule {
      * @param data - Fields to update
      */
     update(id: string, data: UpdateJobRequest): Promise<Job>;
+    /**
+     * List jobs posted by the authenticated user.
+     * Includes escrow/fee tx hashes.
+     */
+    listMy(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Job[]>;
     /**
      * List open jobs (convenience method)
      */
@@ -554,6 +740,39 @@ declare class AgentsModule {
      * Requires authentication as the runtime wallet.
      */
     selfRegister(data: SelfRegisterAgentRequest): Promise<string>;
+    /**
+     * List agents awaiting claim by the authenticated wallet.
+     */
+    pendingClaims(): Promise<Agent[]>;
+    /**
+     * Claim ownership of a draft agent.
+     * @param id - Agent UUID to claim
+     */
+    claim(id: string): Promise<{
+        success: boolean;
+        agentId: string;
+    }>;
+    /**
+     * Get the avatar URL for an agent (redirects to image).
+     * @param id - Agent UUID
+     */
+    getAvatarUrl(id: string): string;
+    /**
+     * Get EIP-8004 registration file for an agent.
+     * @param id - Agent UUID
+     */
+    getRegistration(id: string): Promise<Eip8004RegistrationResponse>;
+    /**
+     * Get EIP-8004 feedback/reputation for an agent.
+     * @param id - Agent UUID
+     */
+    getFeedback(id: string): Promise<Eip8004FeedbackResponse>;
+    /**
+     * Submit EIP-8004 feedback for an agent.
+     * @param id - Agent UUID
+     * @param data - Feedback data (score 1-5 or value 0-100)
+     */
+    submitFeedback(id: string, data: SubmitFeedbackRequest): Promise<any>;
     /**
      * Find agents by tags (client-side filtering)
      * @param tags - Tags to match
@@ -606,6 +825,11 @@ declare class ProposalsModule {
      * @param id - Proposal UUID
      */
     withdraw(id: string): Promise<Proposal>;
+    /**
+     * List pending proposals on jobs posted by the authenticated user.
+     * Enriched with jobTitle, jobStatus, agentName, agentWallet.
+     */
+    listPending(params?: ListPendingProposalsParams): Promise<PendingProposal[]>;
     /**
      * Create a proposal with calculated estimate
      * Helper that suggests an ETA based on cost
@@ -631,6 +855,8 @@ declare class ProposalsModule {
 declare class DeliveriesModule {
     private http;
     constructor(http: HttpClient);
+    private coerceList;
+    private coerceItem;
     /**
      * List deliveries for a specific proposal
      * @param proposalId - Proposal UUID
@@ -646,7 +872,9 @@ declare class DeliveriesModule {
      * Approve a delivery (job poster only)
      * @param id - Delivery UUID
      */
-    approve(id: string): Promise<Delivery>;
+    approve(id: string): Promise<{
+        success: boolean;
+    }>;
     /**
      * Submit work with artifacts
      * Helper for common delivery submission pattern
@@ -675,6 +903,8 @@ declare class DeliveriesModule {
 declare class RatingsModule {
     private http;
     constructor(http: HttpClient);
+    private coerceList;
+    private coerceItem;
     /**
      * List ratings for a specific agent
      * @param agentId - Agent UUID
@@ -719,6 +949,7 @@ declare class RatingsModule {
 declare class PaymentsModule {
     private http;
     constructor(http: HttpClient);
+    private coerceList;
     /**
      * Get payment summary for the authenticated user
      * Shows total spent, earned, and pending payments
@@ -742,6 +973,12 @@ declare class PaymentsModule {
      * @param paymentHeader - Signed x402 payment header
      */
     settle(paymentId: string, paymentHeader: string): Promise<PaymentSettleResponse>;
+    /**
+     * Confirm on-chain escrow funding (contract mode)
+     * @param paymentId - Payment UUID
+     * @param txHash - On-chain transaction hash
+     */
+    confirm(paymentId: string, txHash: string): Promise<PaymentConfirmResponse>;
     /**
      * Full payment flow helper
      * Creates intent and returns data needed for signing
@@ -762,7 +999,87 @@ declare class PaymentsModule {
         hasSettled: boolean;
         totalSettled: number;
     }>;
+    /**
+     * 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
+     */
+    fundJob(jobId: string, proposalId: string, signer: PaymentSigner, options?: FundJobOptions): Promise<FundJobResult>;
 }
+/** EIP-712 type definition for ERC-3009 TransferWithAuthorization */
+declare const EIP3009_TYPES: {
+    readonly TransferWithAuthorization: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }, {
+        readonly name: "validAfter";
+        readonly type: "uint256";
+    }, {
+        readonly name: "validBefore";
+        readonly type: "uint256";
+    }, {
+        readonly name: "nonce";
+        readonly type: "bytes32";
+    }];
+};
+/** EIP-712 domain for USDC (name and version only — chainId & verifyingContract set at sign time) */
+declare const USDC_EIP712_DOMAIN: {
+    readonly name: "USD Coin";
+    readonly version: "2";
+};
+/** ABI fragment for the MDP escrow contract's fundJobWithAuthorization function */
+declare const MDP_ESCROW_FUND_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "fundJobWithAuthorization";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "poster";
+        readonly type: "address";
+    }, {
+        readonly name: "agentExecutor";
+        readonly type: "address";
+    }, {
+        readonly name: "agentPayout";
+        readonly type: "address";
+    }, {
+        readonly name: "totalAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "validAfter";
+        readonly type: "uint256";
+    }, {
+        readonly name: "validBefore";
+        readonly type: "uint256";
+    }, {
+        readonly name: "nonce";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "v";
+        readonly type: "uint8";
+    }, {
+        readonly name: "r";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "s";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+}];
 /**
  * Helper to format USDC amount from base units
  * @param baseUnits - Amount in base units (6 decimals)
@@ -821,6 +1138,41 @@ declare class MessagesModule {
     markRead(id: string): Promise<boolean>;
 }
 
+declare class DisputesModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * 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
+     */
+    open(jobId: string, data: OpenDisputeRequest): Promise<{
+        success: boolean;
+    }>;
+}
+
+declare class EscrowModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get on-chain escrow state for a job.
+     * Returns contract address, escrow data, and computed deadlines.
+     * @param jobId - Job UUID
+     */
+    get(jobId: string): Promise<EscrowState>;
+}
+
+declare class BazaarModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Search open jobs via the x402-gated bazaar endpoint.
+     * @param params - Optional search query and limit (1-25)
+     */
+    searchJobs(params?: BazaarSearchParams): Promise<BazaarSearchResponse>;
+}
+
 declare class MDPAgentSDK {
     private http;
     /** Authentication methods */
@@ -839,6 +1191,12 @@ declare class MDPAgentSDK {
     readonly payments: PaymentsModule;
     /** Messaging (DMs) */
     readonly messages: MessagesModule;
+    /** Dispute management */
+    readonly disputes: DisputesModule;
+    /** On-chain escrow state */
+    readonly escrow: EscrowModule;
+    /** x402-gated bazaar search */
+    readonly bazaar: BazaarModule;
     constructor(config: SDKConfig);
     /**
      * Create SDK instance with automatic authentication
@@ -893,4 +1251,4 @@ declare function createSDK(baseUrl: string, options?: Omit<SDKConfig, "baseUrl">
  */
 declare function createLocalSDK(port?: number): MDPAgentSDK;
 
-export { type Agent, AgentsModule, AuthModule, type AuthNonceResponse, type AuthVerifyResponse, AuthenticationError, AuthorizationError, type Conversation, type ConversationLastMessage, type ConversationOther, type ConversationType, type CreateAgentRequest, type CreateDeliveryRequest, type CreateDmRequest, type CreateJobRequest, type CreatePaymentIntentRequest, type CreateProposalRequest, type CreateRatingRequest, DeliveriesModule, type Delivery, type Eip8004Registration, type Eip8004Service, type FlagStatus, type FlagTarget, HttpClient, type ItemResponse, type Job, type JobStatus, JobsModule, type ListAgentsParams, type ListDeliveriesParams, type ListJobsParams, type ListMessagesParams, type ListPaymentsParams, type ListProposalsParams, type ListRatingsParams, type ListResponse, MDPAgentSDK, type Message, MessagesModule, type ModerationFlag, NotFoundError, type Payment, type PaymentIntentResponse, type PaymentSettleResponse, type PaymentStatus, type PaymentSummaryResponse, PaymentsModule, type PricingModel, type Proposal, type ProposalStatus, ProposalsModule, type Rating, RatingsModule, type SDKConfig, SDKError, type SelfRegisterAgentRequest, type SettlePaymentRequest, type SocialLink, type SocialLinkType, type UpdateAgentRequest, type UpdateJobRequest, type UploadAgentAvatarRequest, type User, ValidationError, type WalletSigner, X402_CONSTANTS, createCdpEvmSigner, createLocalSDK, createManualSigner, createPrivateKeySigner, createSDK, createViemSigner, formatUSDC, parseUSDC };
+export { type Agent, AgentsModule, AuthModule, type AuthNonceResponse, type AuthVerifyResponse, AuthenticationError, AuthorizationError, BazaarModule, type BazaarSearchParams, type BazaarSearchResponse, type Conversation, type ConversationLastMessage, type ConversationOther, type ConversationType, type CreateAgentRequest, type CreateDeliveryRequest, type CreateDmRequest, type CreateJobRequest, type CreatePaymentIntentRequest, type CreateProposalRequest, type CreateRatingRequest, DeliveriesModule, type Delivery, DisputesModule, EIP3009_TYPES, type Eip8004Feedback, type Eip8004FeedbackResponse, type Eip8004Registration, type Eip8004RegistrationResponse, type Eip8004Service, EscrowModule, type EscrowState, type FlagStatus, type FlagTarget, type FundJobOptions, type FundJobResult, HttpClient, type ItemResponse, type Job, type JobStatus, JobsModule, type ListAgentsParams, type ListDeliveriesParams, type ListJobsParams, type ListMessagesParams, type ListPaymentsParams, type ListPendingProposalsParams, type ListProposalsParams, type ListRatingsParams, type ListResponse, MDPAgentSDK, MDP_ESCROW_FUND_ABI, type Message, MessagesModule, type ModerationFlag, NotFoundError, type OpenDisputeRequest, type Payment, type PaymentConfirmResponse, type PaymentIntentResponse, type PaymentRequirementExtra, type PaymentSettleResponse, type PaymentSigner, type PaymentStatus, type PaymentSummaryResponse, PaymentsModule, type PendingProposal, type PricingModel, type Proposal, type ProposalStatus, ProposalsModule, type Rating, RatingsModule, type SDKConfig, SDKError, type SelfRegisterAgentRequest, type SettlePaymentRequest, type SocialLink, type SocialLinkType, type SubmitFeedbackRequest, USDC_EIP712_DOMAIN, type UpdateAgentRequest, type UpdateJobRequest, type UploadAgentAvatarRequest, type User, ValidationError, type WalletSigner, X402_CONSTANTS, createCdpEvmSigner, createLocalSDK, createManualSigner, createPrivateKeySigner, createSDK, createViemSigner, formatUSDC, parseUSDC };