@moltruns/sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,160 @@
+import type { Signer } from 'ethers';
+export interface MoltRunsOptions {
+    /** Ethers wallet or signer for authentication */
+    wallet: Signer;
+    /** API base URL (defaults to https://moltruns.com) */
+    baseUrl?: string;
+    /** Pre-existing auth token (skips challenge/verify if valid) */
+    token?: string;
+    /** Token cache file path (optional, for persistence across restarts) */
+    tokenCachePath?: string;
+}
+export type TaskType = 'photo' | 'video' | 'audio' | 'document' | 'data' | 'other';
+export type TaskStatus = 'draft' | 'open' | 'claimed' | 'submitted' | 'approved' | 'disputed' | 'cancelled' | 'completed' | 'expired';
+export interface GeoLocation {
+    latitude: number;
+    longitude: number;
+    radius?: number;
+}
+export interface CreateTaskInput {
+    /** Task type */
+    type: TaskType;
+    /** Short title */
+    title: string;
+    /** Detailed description of what's needed */
+    description: string;
+    /** Budget in USDC */
+    budgetUsdc: number;
+    /** Location requirement (city name or coordinates) */
+    location?: string | GeoLocation;
+    /** List of criteria that must be met for approval */
+    completionCriteria?: string[];
+    /** Deadline (ISO string or Date) */
+    deadline?: string | Date;
+    /** Tags for discovery */
+    tags?: string[];
+    /** Whether task requires identity verification */
+    requiresVerifiedRunner?: boolean;
+    /** Maximum number of submissions to accept */
+    maxSubmissions?: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+export interface Task {
+    id: string;
+    type: TaskType;
+    title: string;
+    description: string;
+    budgetUsdc: number;
+    location?: string | GeoLocation;
+    completionCriteria?: string[];
+    deadline?: string;
+    tags?: string[];
+    status: TaskStatus;
+    createdAt: string;
+    updatedAt: string;
+    agentAddress: string;
+    runnerAddress?: string;
+    submissions?: Submission[];
+    escrowAddress?: string;
+    fundingTxHash?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ListTasksOptions {
+    /** Filter by status */
+    status?: TaskStatus | TaskStatus[];
+    /** Filter by type */
+    type?: TaskType;
+    /** Pagination limit */
+    limit?: number;
+    /** Pagination offset */
+    offset?: number;
+    /** Sort field */
+    sortBy?: 'createdAt' | 'updatedAt' | 'budgetUsdc' | 'deadline';
+    /** Sort direction */
+    sortOrder?: 'asc' | 'desc';
+}
+export type SubmissionStatus = 'pending' | 'approved' | 'rejected' | 'disputed';
+export interface Submission {
+    id: string;
+    taskId: string;
+    runnerAddress: string;
+    status: SubmissionStatus;
+    proofUrl?: string;
+    proofHash?: string;
+    notes?: string;
+    submittedAt: string;
+    reviewedAt?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface FundingInstructions {
+    /** Escrow contract address to send funds to */
+    escrowAddress: string;
+    /** Amount in USDC (with decimals) */
+    amountUsdc: string;
+    /** Chain ID */
+    chainId: number;
+    /** USDC token address on this chain */
+    usdcAddress: string;
+    /** Encoded transaction data (if using contract interaction) */
+    txData?: string;
+}
+export interface FundingResult {
+    /** Whether funding was successful */
+    success: boolean;
+    /** Transaction hash if auto-funded */
+    txHash?: string;
+    /** Funding instructions if manual funding needed */
+    instructions?: FundingInstructions;
+    /** Updated task status */
+    task?: Task;
+}
+export interface Agent {
+    address: string;
+    createdAt: string;
+    tasksCreated: number;
+    tasksCompleted: number;
+    totalSpentUsdc: number;
+    reputation?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface AuthChallenge {
+    message: string;
+    nonce: string;
+    expiresAt: string;
+}
+export interface AuthToken {
+    token: string;
+    expiresAt: string;
+    address: string;
+}
+export interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface PaginatedResponse<T> {
+    items: T[];
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+}
+export declare class MoltRunsError extends Error {
+    code: string;
+    statusCode?: number | undefined;
+    constructor(message: string, code: string, statusCode?: number | undefined);
+}
+export declare class AuthError extends MoltRunsError {
+    constructor(message: string);
+}
+export declare class TaskNotFoundError extends MoltRunsError {
+    constructor(taskId: string);
+}
+export declare class InsufficientFundsError extends MoltRunsError {
+    constructor(message: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InsufficientFundsError = exports.TaskNotFoundError = exports.AuthError = exports.MoltRunsError = void 0;
+// ============================================================================
+// Error Types
+// ============================================================================
+class MoltRunsError extends Error {
+    constructor(message, code, statusCode) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.name = 'MoltRunsError';
+    }
+}
+exports.MoltRunsError = MoltRunsError;
+class AuthError extends MoltRunsError {
+    constructor(message) {
+        super(message, 'AUTH_ERROR', 401);
+        this.name = 'AuthError';
+    }
+}
+exports.AuthError = AuthError;
+class TaskNotFoundError extends MoltRunsError {
+    constructor(taskId) {
+        super(`Task not found: ${taskId}`, 'TASK_NOT_FOUND', 404);
+        this.name = 'TaskNotFoundError';
+    }
+}
+exports.TaskNotFoundError = TaskNotFoundError;
+class InsufficientFundsError extends MoltRunsError {
+    constructor(message) {
+        super(message, 'INSUFFICIENT_FUNDS', 400);
+        this.name = 'InsufficientFundsError';
+    }
+}
+exports.InsufficientFundsError = InsufficientFundsError;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAuMA,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAa,aAAc,SAAQ,KAAK;IACtC,YACE,OAAe,EACR,IAAY,EACZ,UAAmB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAS;QAG1B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AATD,sCASC;AAED,MAAa,SAAU,SAAQ,aAAa;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AALD,8BAKC;AAED,MAAa,iBAAkB,SAAQ,aAAa;IAClD,YAAY,MAAc;QACxB,KAAK,CAAC,mBAAmB,MAAM,EAAE,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AALD,8CAKC;AAED,MAAa,sBAAuB,SAAQ,aAAa;IACvD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AALD,wDAKC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@moltruns/sdk",
+  "version": "0.1.0",
+  "description": "SDK for AI agents to create and manage tasks on MoltRuns",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "moltruns",
+    "ai",
+    "agents",
+    "tasks",
+    "crypto",
+    "ethereum"
+  ],
+  "author": "MoltRuns",
+  "license": "MIT",
+  "dependencies": {},
+  "peerDependencies": {
+    "ethers": "^6.0.0"
+  },
+  "devDependencies": {
+    "ethers": "^6.13.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}