@blindmarket/sdk 0.1.6 → 0.1.8

package/src/types.ts

@@ -22,7 +22,8 @@ export type TaskStatus =
   | 'submitted'
   | 'verified'
   | 'completed'
-  | 'cancelled';
+  | 'cancelled'
+  | 'disputed';
 
 export interface TaskMetadata {
   category: string;
@@ -74,3 +75,223 @@ export interface TxReceiptLike {
 }
 
 export type Awaitable<T> = T | Promise<T>;
+
+// ── REST API types ──────────────────────────────────────────────────────────
+
+export interface HealthStatus {
+  status: string;
+  timestamp: string;
+}
+
+export interface PlatformStats {
+  openTasks: number;
+  activeAgents: number;
+  activeValidators: number;
+  totalAgents: number;
+  registeredUsers: number;
+  completedTasks: number;
+  activeWorkers: number;
+}
+
+export interface OpenTask {
+  id: number;
+  agent: Address;
+  worker?: Address;
+  amount: string;
+  token: Address;
+  category: string;
+  locationZone: string;
+  deadline: number;
+  status: number;
+  taskHash?: Hex;
+}
+
+export interface CreateTaskTx {
+  unsignedTx: {
+    to: Address;
+    data: Hex;
+    value?: string;
+  };
+}
+
+export interface TaskDetail extends OpenTask {
+  metadata?: Record<string, unknown>;
+  a2aState?: A2ATaskState;
+}
+
+export interface A2ATaskState {
+  taskId: string;
+  status: string;
+  executorAddress?: string;
+  acceptedAt?: string;
+  submittedAt?: string;
+  resultData?: Record<string, unknown> | null;
+  verificationResult?: {
+    passed: boolean;
+    reasons: string[];
+    score?: number;
+    breakdown?: Array<{ name: string; score: number; weight: number; reason: string; error?: string }>;
+  };
+  assignTxHash?: Hex;
+  verifyTxHash?: Hex;
+  wrappedKeys?: Record<string, string>;
+}
+
+export interface ExecutorProfile {
+  address: Address;
+  displayName: string;
+  capabilities: AgentCapability[];
+  publicKey: string;
+  reputation: number;
+  tasksCompleted: number;
+  totalEarnedRaw: string;
+  minReward?: string;
+  preferredCapabilities?: AgentCapability[];
+  registeredAt: string;
+  decayedScore?: number;
+  disputeRatio?: number;
+  avgRating?: number;
+}
+
+export interface RegisterExecutorInput {
+  address: Address;
+  displayName: string;
+  capabilities: AgentCapability[];
+  publicKey: string;
+  agentCardUrl?: string;
+  mcpEndpointUrl?: string;
+  minReward?: string;
+  preferredCapabilities?: AgentCapability[];
+}
+
+/** Params for BlindMarket.createAgent() — generates wallet + registers executor in one call. */
+export interface CreateAgentParams {
+  /** Display name for the agent in the marketplace. */
+  displayName: string;
+  /** Capabilities this agent offers. Use AgentCap.DATA_PROCESSING etc. */
+  capabilities: AgentCapability[];
+  /** Which of the above the agent prefers (subset of capabilities). */
+  preferredCapabilities?: AgentCapability[];
+  /** Minimum reward per task (wei string). */
+  minReward?: string;
+  /** Agent card URL for marketplace display. */
+  agentCardUrl?: string;
+  /** MCP endpoint URL for tool-based agents. */
+  mcpEndpointUrl?: string;
+}
+
+/** Result of BlindMarket.createAgent(). */
+export interface CreateAgentResult {
+  executor: ExecutorProfile;
+  wallet: {
+    address: Address;
+    publicKey: string;
+    privateKey: string; // hex with 0x prefix — ⚠️ store securely, shown once
+  };
+}
+
+export interface DeployedAgentInfo {
+  id: string;
+  name: string;
+  ownerAddress: Address;
+  walletAddress: Address;
+  publicKey: string;
+  status: string;
+  provider: string;
+  model: string;
+  capabilities: AgentCapability[];
+  inftTokenId?: number;
+  deployedAt: string;
+  lastActiveAt?: string;
+  minReward?: string;
+}
+
+export interface AgentWalletInfo {
+  walletAddress: Address;
+  publicKey: string;
+}
+
+export interface ReputationInfo {
+  address: Address;
+  onChainScore: number;
+  decayedScore: number;
+  totalTasks: number;
+  disputesLost: number;
+  disputeRatio: number;
+}
+
+export interface LeaderboardEntry extends ReputationInfo {
+  rank: number;
+  displayName?: string;
+}
+
+export interface StorageUploadResult {
+  rootHash: RootHash;
+  size: number;
+}
+
+export interface Message {
+  id: number;
+  taskId: string;
+  fromAddress: Address;
+  toAddress: Address;
+  content: string;
+  read: boolean;
+  createdAt: string;
+}
+
+export interface AgentSearchResult {
+  address: Address;
+  displayName: string;
+  capabilities: string[];
+  avgRating: number;
+  reviewCount: number;
+  badgeCount: number;
+  reputation: number;
+}
+
+export interface TaskTemplate {
+  id: number;
+  title: string;
+  description: string;
+  category: string;
+  instructions: string;
+  verificationCriteria: Record<string, unknown>;
+  requiredCapabilities?: string[];
+  estimatedReward?: string;
+}
+
+export interface VerifyTaskInput {
+  taskId: number;
+  taskCategory: string;
+  taskRequirements: string;
+  evidenceSummary: string;
+}
+
+// ── Agent capabilities ───────────────────────────────────────────────────────
+
+/** Dot-notation access to valid capability strings. */
+export const AgentCap = {
+  DATA_PROCESSING: 'data_processing',
+  WEB_RESEARCH: 'web_research',
+  CODE_EXECUTION: 'code_execution',
+  CONTENT_GENERATION: 'content_generation',
+  API_INTEGRATION: 'api_integration',
+  TEXT_ANALYSIS: 'text_analysis',
+  TRANSLATION: 'translation',
+  SUMMARIZATION: 'summarization',
+  IMAGE_ANALYSIS: 'image_analysis',
+  DOCUMENT_PROCESSING: 'document_processing',
+  MATH_COMPUTATION: 'math_computation',
+  DATA_EXTRACTION: 'data_extraction',
+  REPORT_GENERATION: 'report_generation',
+  CODE_REVIEW: 'code_review',
+  TESTING: 'testing',
+  SCHEDULING: 'scheduling',
+  EMAIL_DRAFTING: 'email_drafting',
+  SOCIAL_MEDIA: 'social_media',
+  MARKET_RESEARCH: 'market_research',
+  COMPETITIVE_ANALYSIS: 'competitive_analysis',
+} as const;
+
+export type AgentCapability = typeof AgentCap[keyof typeof AgentCap];

package/tsconfig.json

@@ -9,5 +9,6 @@
     "strict": true,
     "skipLibCheck": true
   },
-  "include": ["src/index.ts"]
+  "include": ["src"],
+  "exclude": ["src/storage/ZgStorage.ts"]
 }

package/dist/BlindEscrowClient-CyPuKMge.d.cts

@@ -1,54 +0,0 @@
-import { ethers } from 'ethers';
-import { A as Address, H as Hex, T as TaskId, b as TxReceiptLike, e as TaskStatus } from './types-BOG5Ub1z.cjs';
-
-interface CreateTaskArgs {
-    taskHash: Hex;
-    token: Address;
-    amount: bigint;
-    category: string;
-    locationZone: string;
-    deadline: bigint;
-}
-interface OnChainTask {
-    taskId: TaskId;
-    agent: Address;
-    worker: Address;
-    token: Address;
-    amount: bigint;
-    taskHash: Hex;
-    evidenceHash: Hex;
-    status: TaskStatus;
-    createdAt: Date;
-    deadline: Date;
-}
-/**
- * Typed ethers v6 wrapper for the BlindEscrow contract. Every state-changing
- * method awaits one confirmation and returns a TxReceiptLike; every read
- * returns decoded values. Ethers errors are mapped to ChainError via
- * wrapChainError().
- */
-declare class BlindEscrowClient {
-    readonly contract: ethers.Contract;
-    readonly address: Address;
-    constructor(address: Address, runner: ethers.ContractRunner);
-    /** Create a task and return its id + receipt. Reads the TaskCreated event for the id. */
-    createTask(args: CreateTaskArgs): Promise<{
-        taskId: TaskId;
-        receipt: TxReceiptLike;
-    }>;
-    assignWorker(taskId: TaskId, worker: Address): Promise<TxReceiptLike>;
-    submitEvidence(taskId: TaskId, evidenceHash: Hex): Promise<TxReceiptLike>;
-    completeVerification(taskId: TaskId, passed: boolean): Promise<TxReceiptLike>;
-    cancelTask(taskId: TaskId): Promise<TxReceiptLike>;
-    raiseDispute(taskId: TaskId): Promise<TxReceiptLike>;
-    resolveDispute(taskId: TaskId, workerFavored: boolean): Promise<TxReceiptLike>;
-    claimTimeout(taskId: TaskId): Promise<TxReceiptLike>;
-    getTask(taskId: TaskId): Promise<OnChainTask>;
-    isTaskExpired(taskId: TaskId): Promise<boolean>;
-    nextTaskId(): Promise<TaskId>;
-    feeBps(): Promise<bigint>;
-    private sendTx;
-    private extractTaskIdFromReceipt;
-}
-
-export { BlindEscrowClient as B, type CreateTaskArgs as C, type OnChainTask as O };

package/dist/BlindEscrowClient-R7iGpE-n.d.ts

@@ -1,54 +0,0 @@
-import { ethers } from 'ethers';
-import { A as Address, H as Hex, T as TaskId, b as TxReceiptLike, e as TaskStatus } from './types-BOG5Ub1z.js';
-
-interface CreateTaskArgs {
-    taskHash: Hex;
-    token: Address;
-    amount: bigint;
-    category: string;
-    locationZone: string;
-    deadline: bigint;
-}
-interface OnChainTask {
-    taskId: TaskId;
-    agent: Address;
-    worker: Address;
-    token: Address;
-    amount: bigint;
-    taskHash: Hex;
-    evidenceHash: Hex;
-    status: TaskStatus;
-    createdAt: Date;
-    deadline: Date;
-}
-/**
- * Typed ethers v6 wrapper for the BlindEscrow contract. Every state-changing
- * method awaits one confirmation and returns a TxReceiptLike; every read
- * returns decoded values. Ethers errors are mapped to ChainError via
- * wrapChainError().
- */
-declare class BlindEscrowClient {
-    readonly contract: ethers.Contract;
-    readonly address: Address;
-    constructor(address: Address, runner: ethers.ContractRunner);
-    /** Create a task and return its id + receipt. Reads the TaskCreated event for the id. */
-    createTask(args: CreateTaskArgs): Promise<{
-        taskId: TaskId;
-        receipt: TxReceiptLike;
-    }>;
-    assignWorker(taskId: TaskId, worker: Address): Promise<TxReceiptLike>;
-    submitEvidence(taskId: TaskId, evidenceHash: Hex): Promise<TxReceiptLike>;
-    completeVerification(taskId: TaskId, passed: boolean): Promise<TxReceiptLike>;
-    cancelTask(taskId: TaskId): Promise<TxReceiptLike>;
-    raiseDispute(taskId: TaskId): Promise<TxReceiptLike>;
-    resolveDispute(taskId: TaskId, workerFavored: boolean): Promise<TxReceiptLike>;
-    claimTimeout(taskId: TaskId): Promise<TxReceiptLike>;
-    getTask(taskId: TaskId): Promise<OnChainTask>;
-    isTaskExpired(taskId: TaskId): Promise<boolean>;
-    nextTaskId(): Promise<TaskId>;
-    feeBps(): Promise<bigint>;
-    private sendTx;
-    private extractTaskIdFromReceipt;
-}
-
-export { BlindEscrowClient as B, type CreateTaskArgs as C, type OnChainTask as O };

package/dist/KeyStore-Be_SSpCt.d.cts

@@ -1,21 +0,0 @@
-import { T as TaskId, a as TaskKey, A as Address, H as Hex, c as TaskKeyRef } from './types-BOG5Ub1z.cjs';
-
-/**
- * Per-session storage for task AES keys and cached peer public keys. The SDK
- * never logs or serializes anything from here — this is the one place at-rest
- * secrets live. Implementations MUST treat passphrase-protected exports as the
- * only portable format.
- */
-interface KeyStore {
-    putTaskKey(taskId: TaskId, key: TaskKey): Promise<void>;
-    getTaskKey(taskId: TaskId): Promise<TaskKey | null>;
-    putPeerPubKey(addr: Address, pubkey: Hex): Promise<void>;
-    getPeerPubKey(addr: Address): Promise<Hex | null>;
-    list(): Promise<TaskKeyRef[]>;
-    delete(taskId: TaskId): Promise<void>;
-    /** Portable, encrypted-at-rest JSON export for backup/migration. */
-    export(passphrase: string): Promise<string>;
-    import(data: string, passphrase: string): Promise<void>;
-}
-
-export type { KeyStore as K };

package/dist/KeyStore-k1JgYPJY.d.ts

@@ -1,21 +0,0 @@
-import { T as TaskId, a as TaskKey, A as Address, H as Hex, c as TaskKeyRef } from './types-BOG5Ub1z.js';
-
-/**
- * Per-session storage for task AES keys and cached peer public keys. The SDK
- * never logs or serializes anything from here — this is the one place at-rest
- * secrets live. Implementations MUST treat passphrase-protected exports as the
- * only portable format.
- */
-interface KeyStore {
-    putTaskKey(taskId: TaskId, key: TaskKey): Promise<void>;
-    getTaskKey(taskId: TaskId): Promise<TaskKey | null>;
-    putPeerPubKey(addr: Address, pubkey: Hex): Promise<void>;
-    getPeerPubKey(addr: Address): Promise<Hex | null>;
-    list(): Promise<TaskKeyRef[]>;
-    delete(taskId: TaskId): Promise<void>;
-    /** Portable, encrypted-at-rest JSON export for backup/migration. */
-    export(passphrase: string): Promise<string>;
-    import(data: string, passphrase: string): Promise<void>;
-}
-
-export type { KeyStore as K };

package/dist/Signer-BnqH_qew.d.cts

@@ -1,38 +0,0 @@
-import { A as Address, H as Hex } from './types-BOG5Ub1z.cjs';
-
-interface TxRequest {
-    to: Address;
-    from?: Address;
-    data?: Hex;
-    value?: bigint;
-    gasLimit?: bigint;
-    nonce?: number;
-    chainId?: bigint;
-}
-interface TypedDataDomain {
-    name?: string;
-    version?: string;
-    chainId?: bigint | number;
-    verifyingContract?: Address;
-    salt?: Hex;
-}
-type TypedDataField = {
-    name: string;
-    type: string;
-};
-/**
- * Uniform signing interface used across the SDK. Adapters wrap ethers Signer,
- * raw private keys, EIP-1193 providers, or KMS. Implementations MUST return
- * hex-encoded signatures (0x-prefixed) and addresses (0x-prefixed, 20 bytes).
- */
-interface Signer {
-    getAddress(): Promise<Address>;
-    chainId(): Promise<bigint>;
-    signMessage(msg: string | Uint8Array): Promise<Hex>;
-    signTypedData(domain: TypedDataDomain, types: Record<string, TypedDataField[]>, value: Record<string, unknown>): Promise<Hex>;
-    signTransaction(tx: TxRequest): Promise<Hex>;
-    /** Uncompressed secp256k1 public key, 0x04-prefixed (hex). */
-    getPublicKey(): Promise<Hex>;
-}
-
-export type { Signer as S, TypedDataDomain as T, TypedDataField as a, TxRequest as b };

package/dist/Signer-LColE0Uo.d.ts

@@ -1,38 +0,0 @@
-import { A as Address, H as Hex } from './types-BOG5Ub1z.js';
-
-interface TxRequest {
-    to: Address;
-    from?: Address;
-    data?: Hex;
-    value?: bigint;
-    gasLimit?: bigint;
-    nonce?: number;
-    chainId?: bigint;
-}
-interface TypedDataDomain {
-    name?: string;
-    version?: string;
-    chainId?: bigint | number;
-    verifyingContract?: Address;
-    salt?: Hex;
-}
-type TypedDataField = {
-    name: string;
-    type: string;
-};
-/**
- * Uniform signing interface used across the SDK. Adapters wrap ethers Signer,
- * raw private keys, EIP-1193 providers, or KMS. Implementations MUST return
- * hex-encoded signatures (0x-prefixed) and addresses (0x-prefixed, 20 bytes).
- */
-interface Signer {
-    getAddress(): Promise<Address>;
-    chainId(): Promise<bigint>;
-    signMessage(msg: string | Uint8Array): Promise<Hex>;
-    signTypedData(domain: TypedDataDomain, types: Record<string, TypedDataField[]>, value: Record<string, unknown>): Promise<Hex>;
-    signTransaction(tx: TxRequest): Promise<Hex>;
-    /** Uncompressed secp256k1 public key, 0x04-prefixed (hex). */
-    getPublicKey(): Promise<Hex>;
-}
-
-export type { Signer as S, TypedDataDomain as T, TypedDataField as a, TxRequest as b };

package/dist/Storage-4QOrh7rm.d.ts

@@ -1,17 +0,0 @@
-import { U as UploadResult, d as RootHash } from './types-BOG5Ub1z.js';
-
-/**
- * Abstraction over blob storage. Default implementation (ZgStorage) uses
- * 0G Storage; MemoryStorage is for tests and local fallback. Consumers can
- * provide their own adapter for IPFS, S3, etc.
- */
-interface Storage {
-    /** Upload bytes, return root hash + optional tx hash + size. */
-    upload(bytes: Uint8Array): Promise<UploadResult>;
-    /** Download bytes by root hash. Throws StorageError('STORAGE/NOT_FOUND') if absent. */
-    download(rootHash: RootHash): Promise<Uint8Array>;
-    /** Compute the canonical root hash without uploading. */
-    hash(bytes: Uint8Array): Promise<RootHash>;
-}
-
-export type { Storage as S };

package/dist/Storage-Cf4IJRMk.d.cts

@@ -1,17 +0,0 @@
-import { U as UploadResult, d as RootHash } from './types-BOG5Ub1z.cjs';
-
-/**
- * Abstraction over blob storage. Default implementation (ZgStorage) uses
- * 0G Storage; MemoryStorage is for tests and local fallback. Consumers can
- * provide their own adapter for IPFS, S3, etc.
- */
-interface Storage {
-    /** Upload bytes, return root hash + optional tx hash + size. */
-    upload(bytes: Uint8Array): Promise<UploadResult>;
-    /** Download bytes by root hash. Throws StorageError('STORAGE/NOT_FOUND') if absent. */
-    download(rootHash: RootHash): Promise<Uint8Array>;
-    /** Compute the canonical root hash without uploading. */
-    hash(bytes: Uint8Array): Promise<RootHash>;
-}
-
-export type { Storage as S };

package/dist/TaskRegistryClient-Ch6lYqM_.d.ts

@@ -1,24 +0,0 @@
-import { ethers } from 'ethers';
-import { A as Address, T as TaskId, b as TxReceiptLike } from './types-BOG5Ub1z.js';
-
-interface OpenTaskMeta {
-    taskId: TaskId;
-    token: Address;
-    category: string;
-    locationZone: string;
-    reward: bigint;
-    createdAt: Date;
-}
-declare class TaskRegistryClient {
-    readonly contract: ethers.Contract;
-    readonly address: Address;
-    constructor(address: Address, runner: ethers.ContractRunner);
-    getTaskMeta(taskId: TaskId): Promise<OpenTaskMeta>;
-    getOpenTasks(offset: bigint, limit: bigint): Promise<TaskId[]>;
-    totalTasks(): Promise<bigint>;
-    openTaskCount(): Promise<bigint>;
-    taskExists(taskId: TaskId): Promise<boolean>;
-    closeTask(taskId: TaskId): Promise<TxReceiptLike>;
-}
-
-export { type OpenTaskMeta as O, TaskRegistryClient as T };

package/dist/TaskRegistryClient-CrQjddDc.d.cts

@@ -1,24 +0,0 @@
-import { ethers } from 'ethers';
-import { A as Address, T as TaskId, b as TxReceiptLike } from './types-BOG5Ub1z.cjs';
-
-interface OpenTaskMeta {
-    taskId: TaskId;
-    token: Address;
-    category: string;
-    locationZone: string;
-    reward: bigint;
-    createdAt: Date;
-}
-declare class TaskRegistryClient {
-    readonly contract: ethers.Contract;
-    readonly address: Address;
-    constructor(address: Address, runner: ethers.ContractRunner);
-    getTaskMeta(taskId: TaskId): Promise<OpenTaskMeta>;
-    getOpenTasks(offset: bigint, limit: bigint): Promise<TaskId[]>;
-    totalTasks(): Promise<bigint>;
-    openTaskCount(): Promise<bigint>;
-    taskExists(taskId: TaskId): Promise<boolean>;
-    closeTask(taskId: TaskId): Promise<TxReceiptLike>;
-}
-
-export { type OpenTaskMeta as O, TaskRegistryClient as T };

package/dist/aes-J-7HrHze.d.cts

@@ -1,17 +0,0 @@
-/** Generate a fresh 32-byte AES-256 key. */
-declare function generateAesKey(): Promise<Uint8Array>;
-/**
- * AES-256-GCM encrypt. Output format: [12 IV][16 tag][ciphertext].
- * This ordering matches backend/src/services/crypto.ts and frontend/src/lib/crypto.ts
- * byte-for-byte, so SDK blobs decrypt anywhere in the stack.
- */
-declare function aesEncrypt(plaintext: Uint8Array, key: Uint8Array): Promise<Uint8Array>;
-/**
- * AES-256-GCM decrypt. Input format: [12 IV][16 tag][ciphertext].
- * Throws CRYPTO/INTEGRITY_CHECK on truncation or tag mismatch.
- */
-declare function aesDecrypt(blob: Uint8Array, key: Uint8Array): Promise<Uint8Array>;
-/** SHA-256 of arbitrary bytes. Returns 32-byte digest. */
-declare function sha256(data: Uint8Array): Promise<Uint8Array>;
-
-export { aesDecrypt as a, aesEncrypt as b, generateAesKey as g, sha256 as s };

package/dist/aes-J-7HrHze.d.ts

@@ -1,17 +0,0 @@
-/** Generate a fresh 32-byte AES-256 key. */
-declare function generateAesKey(): Promise<Uint8Array>;
-/**
- * AES-256-GCM encrypt. Output format: [12 IV][16 tag][ciphertext].
- * This ordering matches backend/src/services/crypto.ts and frontend/src/lib/crypto.ts
- * byte-for-byte, so SDK blobs decrypt anywhere in the stack.
- */
-declare function aesEncrypt(plaintext: Uint8Array, key: Uint8Array): Promise<Uint8Array>;
-/**
- * AES-256-GCM decrypt. Input format: [12 IV][16 tag][ciphertext].
- * Throws CRYPTO/INTEGRITY_CHECK on truncation or tag mismatch.
- */
-declare function aesDecrypt(blob: Uint8Array, key: Uint8Array): Promise<Uint8Array>;
-/** SHA-256 of arbitrary bytes. Returns 32-byte digest. */
-declare function sha256(data: Uint8Array): Promise<Uint8Array>;
-
-export { aesDecrypt as a, aesEncrypt as b, generateAesKey as g, sha256 as s };