@agirails/sdk 2.5.3 → 2.5.5

package/src/types/eip712.ts

@@ -1,175 +0,0 @@
-import { DeliveryProof } from './message';
-
-/**
- * EIP-712 Type Definitions for ACTP Messages
- * Reference: Yellow Paper §11.4.2
- * 
- * Each AIP message has explicit typed data for cross-language compatibility
- */
-
-/**
- * EIP-712 Domain for ACTP
- */
-export interface EIP712Domain {
-  name: string;
-  version: string;
-  chainId: number;
-  verifyingContract: string;
-}
-
-/**
- * QuoteRequest (AIP-2)
- * Reference: Yellow Paper §4.2
- */
-export const QuoteRequestTypes = {
-  QuoteRequest: [
-    { name: 'from', type: 'string' }, // DID
-    { name: 'to', type: 'string' }, // DID
-    { name: 'timestamp', type: 'uint256' },
-    { name: 'nonce', type: 'bytes32' },
-    { name: 'serviceType', type: 'string' },
-    { name: 'requirements', type: 'string' },
-    { name: 'deadline', type: 'uint256' },
-    { name: 'disputeWindow', type: 'uint256' }
-  ]
-};
-
-export interface QuoteRequestData {
-  from: string;
-  to: string;
-  timestamp: number;
-  nonce: string;
-  serviceType: string;
-  requirements: string;
-  deadline: number;
-  disputeWindow: number;
-}
-
-/**
- * QuoteResponse (AIP-2)
- * Reference: Yellow Paper §4.2
- */
-export const QuoteResponseTypes = {
-  QuoteResponse: [
-    { name: 'from', type: 'string' },
-    { name: 'to', type: 'string' },
-    { name: 'timestamp', type: 'uint256' },
-    { name: 'nonce', type: 'bytes32' },
-    { name: 'requestId', type: 'bytes32' },
-    { name: 'price', type: 'uint256' },
-    { name: 'currency', type: 'address' },
-    { name: 'deliveryTime', type: 'uint256' },
-    { name: 'terms', type: 'string' }
-  ]
-};
-
-export interface QuoteResponseData {
-  from: string;
-  to: string;
-  timestamp: number;
-  nonce: string;
-  requestId: string;
-  price: string; // BigNumber as string
-  currency: string;
-  deliveryTime: number;
-  terms: string;
-}
-
-/**
- * DeliveryProof (AIP-4) - DEPRECATED
- * @deprecated Use AIP4DeliveryProofTypes instead (AIP-4 v1.1)
- */
-export const DeliveryProofTypes = {
-  DeliveryProof: [
-    { name: 'txId', type: 'bytes32' },
-    { name: 'contentHash', type: 'bytes32' },
-    { name: 'timestamp', type: 'uint256' },
-    { name: 'deliveryUrl', type: 'string' },
-    { name: 'size', type: 'uint256' },
-    { name: 'mimeType', type: 'string' }
-  ]
-};
-
-export interface DeliveryProofData {
-  txId: string;
-  contentHash: string;
-  timestamp: number;
-  deliveryUrl: string;
-  size: number;
-  mimeType: string;
-}
-
-export function deliveryProofDataFromProof(proof: DeliveryProof): DeliveryProofData {
-  return {
-    txId: proof.txId,
-    contentHash: proof.contentHash,
-    timestamp: proof.timestamp,
-    deliveryUrl: proof.deliveryUrl || '',
-    size: proof.metadata.size,
-    mimeType: proof.metadata.mimeType
-  };
-}
-
-/**
- * AIP-4 Delivery Proof (v1.1)
- * Reference: AIP-4 §3.3
- */
-export const AIP4DeliveryProofTypes = {
-  DeliveryProof: [
-    { name: 'txId', type: 'bytes32' },
-    { name: 'provider', type: 'string' },
-    { name: 'consumer', type: 'string' },
-    { name: 'resultCID', type: 'string' },
-    { name: 'resultHash', type: 'bytes32' },
-    { name: 'easAttestationUID', type: 'bytes32' },
-    { name: 'deliveredAt', type: 'uint256' },
-    { name: 'chainId', type: 'uint256' },
-    { name: 'nonce', type: 'uint256' }
-  ]
-};
-
-export interface AIP4DeliveryProofData {
-  txId: string;
-  provider: string;
-  consumer: string;
-  resultCID: string;
-  resultHash: string;
-  easAttestationUID: string;
-  deliveredAt: number;
-  chainId: number;
-  nonce: number;
-}
-
-/**
- * Generic ACTPMessage (fallback for custom AIPs)
- */
-export const ACTPMessageTypes = {
-  ACTPMessage: [
-    { name: 'type', type: 'string' },
-    { name: 'version', type: 'string' },
-    { name: 'from', type: 'string' },
-    { name: 'to', type: 'string' },
-    { name: 'timestamp', type: 'uint256' },
-    { name: 'nonce', type: 'bytes32' },
-    { name: 'payload', type: 'bytes' }
-  ]
-};
-
-/**
- * Message type registry
- */
-export const MESSAGE_TYPES = {
-  'quote.request': QuoteRequestTypes,
-  'quote.response': QuoteResponseTypes,
-  'delivery.proof': DeliveryProofTypes,
-  // Fallback for custom/future AIPs
-  default: ACTPMessageTypes
-};
-
-/**
- * Get EIP-712 types for message type
- */
-export function getMessageTypes(messageType: string): Record<string, any> {
-  return MESSAGE_TYPES[messageType as keyof typeof MESSAGE_TYPES] || MESSAGE_TYPES.default;
-}
-

package/src/types/erc8004.ts

@@ -1,293 +0,0 @@
-/**
- * ERC-8004 Trustless Agents - SDK Types
- *
- * Types and constants for ERC-8004 integration.
- *
- * SECURITY NOTES:
- * - Identity Registry is read-only (safe, no gas)
- * - Reputation Registry writes require gas (requester pays)
- * - Replay protection via feedbackHash = keccak256(txId)
- * - ERC-8004 restriction: feedback submitter ≠ agent owner
- *
- * @see https://eips.ethereum.org/EIPS/eip-8004
- * @module types/erc8004
- */
-
-// ============================================================================
-// Networks
-// ============================================================================
-
-/**
- * Networks with ERC-8004 registry deployments.
- */
-export type ERC8004Network = 'ethereum' | 'base' | 'base-sepolia';
-
-// ============================================================================
-// Identity Types (from Identity Registry)
-// ============================================================================
-
-/**
- * Agent identity resolved from ERC-8004 Identity Registry.
- */
-export interface ERC8004Agent {
-  /** ERC-8004 agent ID (uint256 as string) */
-  agentId: string;
-
-  /** Owner address (EOA that controls the NFT) */
-  owner: string;
-
-  /** Payment wallet address (checksummed) */
-  wallet: string;
-
-  /** Agent URI (IPFS or HTTPS, points to metadata JSON) */
-  agentURI: string;
-
-  /** Parsed metadata from agentURI (may be undefined if fetch fails) */
-  metadata?: ERC8004AgentMetadata;
-
-  /** Network where agent is registered */
-  network: ERC8004Network;
-}
-
-/**
- * Agent metadata schema from ERC-8004 agentURI.
- *
- * Standard fields defined by ERC-8004, plus arbitrary extensions.
- */
-export interface ERC8004AgentMetadata {
-  /** Human-readable agent name */
-  name?: string;
-
-  /** Agent description */
-  description?: string;
-
-  /** Agent avatar/logo URL */
-  image?: string;
-
-  /** Wallet address for receiving payments (overrides owner) */
-  paymentAddress?: string;
-
-  /** Alternative field name for payment address */
-  wallet?: string;
-
-  /** List of agent capabilities */
-  capabilities?: string[];
-
-  /** Service endpoints */
-  endpoints?: {
-    api?: string;
-    webhook?: string;
-  };
-
-  /** Allow arbitrary extensions */
-  [key: string]: unknown;
-}
-
-// ============================================================================
-// Reputation Types (from Reputation Registry)
-// ============================================================================
-
-/**
- * Feedback entry for ERC-8004 Reputation Registry.
- *
- * For ACTP settlements, we use binary values:
- * - value: 1 (success) or -1 (dispute lost)
- * - valueDecimals: 0 (no fractional part)
- */
-export interface ReputationFeedback {
-  /** ERC-8004 agent ID */
-  agentId: string;
-
-  /**
-   * Feedback value.
-   * For ACTP: 1 = successful settlement, -1 = dispute lost
-   */
-  value: number;
-
-  /**
-   * Decimal precision for value.
-   * For ACTP: always 0 (binary)
-   */
-  valueDecimals: number;
-
-  /**
-   * Primary tag for categorization.
-   * ACTP uses: 'actp_settled', 'actp_dispute_won', 'actp_dispute_lost'
-   */
-  tag1: string;
-
-  /**
-   * Secondary tag for filtering.
-   * ACTP uses: capability (e.g., 'code_generation', 'data_analysis')
-   */
-  tag2: string;
-
-  /** Service endpoint (optional) */
-  endpoint?: string;
-
-  /** Link to detailed feedback (optional, IPFS or HTTPS) */
-  feedbackURI?: string;
-
-  /**
-   * Hash for replay protection.
-   * ACTP uses: keccak256(txId)
-   */
-  feedbackHash: string;
-}
-
-/**
- * Aggregated reputation summary for an agent.
- */
-export interface ReputationSummary {
-  /** ERC-8004 agent ID */
-  agentId: string;
-
-  /** Total feedback count */
-  feedbackCount: number;
-
-  /** Count of positive feedback (value > 0) */
-  positiveCount: number;
-
-  /** Count of negative feedback (value < 0) */
-  negativeCount: number;
-
-  /** Aggregated score (sum of values) */
-  score: number;
-}
-
-// ============================================================================
-// Errors
-// ============================================================================
-
-/**
- * ERC-8004 error codes.
- */
-export enum ERC8004ErrorCode {
-  // Identity errors
-  AGENT_NOT_FOUND = 'AGENT_NOT_FOUND',
-  INVALID_AGENT_ID = 'INVALID_AGENT_ID',
-  WALLET_NOT_FOUND = 'WALLET_NOT_FOUND',
-  METADATA_FETCH_FAILED = 'METADATA_FETCH_FAILED',
-
-  // Reputation errors
-  REPORT_FAILED = 'REPORT_FAILED',
-  ALREADY_REPORTED = 'ALREADY_REPORTED',
-  NOT_AUTHORIZED = 'NOT_AUTHORIZED',
-
-  // Network errors
-  NETWORK_ERROR = 'NETWORK_ERROR',
-  INVALID_NETWORK = 'INVALID_NETWORK',
-}
-
-/**
- * Custom error for ERC-8004 operations.
- */
-export class ERC8004Error extends Error {
-  constructor(
-    message: string,
-    public readonly code: ERC8004ErrorCode,
-    public readonly agentId?: string,
-    public readonly cause?: Error
-  ) {
-    super(message);
-    this.name = 'ERC8004Error';
-
-    // Maintain proper stack trace in V8
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, ERC8004Error);
-    }
-  }
-}
-
-// ============================================================================
-// Registry Addresses
-// ============================================================================
-
-/**
- * ERC-8004 Identity Registry addresses per network.
- *
- * Canonical CREATE2 addresses from: https://github.com/erc-8004/erc-8004-contracts
- * Vanity prefix 0x8004 ensures same address across all EVM chains.
- */
-export const ERC8004_IDENTITY_REGISTRY: Record<ERC8004Network, string> = {
-  ethereum: '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432', // Ethereum Mainnet
-  base: '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432', // Base Mainnet
-  'base-sepolia': '0x8004A818BFB912233c491871b3d84c89A494BD9e', // Base Sepolia
-};
-
-/**
- * ERC-8004 Reputation Registry addresses per network.
- *
- * Canonical CREATE2 addresses from: https://github.com/erc-8004/erc-8004-contracts
- * Vanity prefix 0x8004 ensures same address across all EVM chains.
- */
-export const ERC8004_REPUTATION_REGISTRY: Record<ERC8004Network, string> = {
-  ethereum: '0x8004BAa17C55a88189AE136b182e5fdA19dE9b63', // Ethereum Mainnet
-  base: '0x8004BAa17C55a88189AE136b182e5fdA19dE9b63', // Base Mainnet
-  'base-sepolia': '0x8004B663056A597Dffe9eCcC1965A193B7388713', // Base Sepolia
-};
-
-// ============================================================================
-// ABI Fragments (minimal, view-only for Bridge)
-// ============================================================================
-
-/**
- * Minimal ABI for ERC-8004 Identity Registry.
- * Only includes view functions needed by ERC8004Bridge.
- */
-export const ERC8004_IDENTITY_ABI = [
-  'function ownerOf(uint256 agentId) view returns (address)',
-  'function getAgentURI(uint256 agentId) view returns (string)',
-  'function balanceOf(address owner) view returns (uint256)',
-  'function tokenOfOwnerByIndex(address owner, uint256 index) view returns (uint256)',
-] as const;
-
-/**
- * Minimal ABI for ERC-8004 Reputation Registry.
- * Includes both read and write functions.
- */
-export const ERC8004_REPUTATION_ABI = [
-  // Write
-  'function giveFeedback(uint256 agentId, int128 value, uint8 valueDecimals, string tag1, string tag2, string endpoint, string feedbackURI, bytes32 feedbackHash) external',
-  'function revokeLatest(uint256 agentId, uint64 feedbackIndex) external',
-  // Read
-  'function getSummary(uint256 agentId, address[] clientAddresses, string tag1, string tag2) view returns (uint256 count, int256 summaryValue, uint8 summaryValueDecimals)',
-  'function readFeedback(uint256 agentId, uint64 feedbackIndex) view returns (tuple(int128 value, uint8 valueDecimals, string tag1, string tag2, bool isRevoked, uint64 feedbackIndex))',
-] as const;
-
-// ============================================================================
-// Default RPC URLs
-// ============================================================================
-
-/**
- * Default RPC URLs for each network.
- * Used when no custom RPC is provided.
- */
-export const ERC8004_DEFAULT_RPC: Record<ERC8004Network, string> = {
-  ethereum: 'https://eth.llamarpc.com',
-  base: 'https://mainnet.base.org',
-  'base-sepolia': 'https://sepolia.base.org',
-};
-
-// ============================================================================
-// ACTP-specific constants
-// ============================================================================
-
-/**
- * ACTP feedback tags for ERC-8004 Reputation.
- */
-export const ACTP_FEEDBACK_TAGS = {
-  /** Successful settlement */
-  SETTLED: 'actp_settled',
-
-  /** Agent won dispute */
-  DISPUTE_WON: 'actp_dispute_won',
-
-  /** Agent lost dispute (requester won) */
-  DISPUTE_LOST: 'actp_dispute_lost',
-} as const;
-
-/**
- * Type for ACTP feedback tags.
- */
-export type ACTPFeedbackTag = (typeof ACTP_FEEDBACK_TAGS)[keyof typeof ACTP_FEEDBACK_TAGS];

package/src/types/escrow.ts

@@ -1,27 +0,0 @@
-/**
- * Escrow creation parameters
- */
-export interface CreateEscrowParams {
-  /** Escrow identifier (bytes32). In ACTP standard this is typically the txId. */
-  escrowId: string;
-  /** Consumer/requester who funds the escrow */
-  requester: string;
-  /** Provider who receives payout on settlement */
-  provider: string;
-  /** Amount locked in escrow (USDC wei, 6 decimals) */
-  amount: bigint;
-}
-
-/**
- * Escrow state (matches on-chain EscrowVault.EscrowData struct)
- */
-export interface Escrow {
-  escrowId: string;
-  requester: string;
-  provider: string;
-  amount: bigint;
-  releasedAmount: bigint;
-  active: boolean;
-}
-
-

package/src/types/index.ts

@@ -1,17 +0,0 @@
-/**
- * Type exports
- */
-
-export * from './state';
-export * from './transaction';
-export * from './escrow';
-export * from './message';
-export * from './eip712';
-export * from './agent';
-export * from './did';
-export * from './adapter';
-export * from './x402';
-export * from './erc8004';
-// Note: storage and archive types are not yet implemented in this version
-// export * from './storage';
-// export * from './archive';

package/src/types/message.ts

@@ -1,145 +0,0 @@
-/**
- * ACTP Message Types
- * Reference: Yellow Paper §4-10 (AIPs)
- */
-
-/**
- * Base ACTP message structure
- */
-export interface ACTPMessage {
-  type: string;
-  version: string;
-  from: string; // DID
-  to: string; // DID
-  timestamp: number;
-  nonce: string;
-  signature?: string;
-  [key: string]: any;
-}
-
-/**
- * Quote Request (AIP-2)
- * Reference: Yellow Paper §6.2.1
- */
-export interface QuoteRequest extends ACTPMessage {
-  type: 'quote.request';
-  serviceRequest: {
-    capabilityType: string;
-    parameters: Record<string, any>;
-    deliveryRequirements: {
-      deadline: string;
-      maxDeliveryTime: string;
-    };
-  };
-  budgetConstraints: {
-    maxPrice: string;
-    currency: 'USDC';
-  };
-  expiresAt: string;
-}
-
-/**
- * Quote Response (AIP-2)
- * Reference: Yellow Paper §6.2.2
- */
-export interface QuoteResponse extends ACTPMessage {
-  type: 'quote.response';
-  inResponseTo: string;
-  quoteId: string;
-  pricing: {
-    totalPrice: string;
-    currency: 'USDC';
-    breakdown: Array<{ item: string; amount: string }>;
-    platformFee: string;
-  };
-  sla: {
-    successRateGuarantee: number;
-    refundPolicy: string;
-  };
-  expiresAt: string;
-}
-
-/**
- * Delivery Proof (AIP-4) - DEPRECATED
- * @deprecated Use DeliveryProofMessage instead (AIP-4 v1.1)
- */
-export interface DeliveryProof {
-  type: 'delivery.proof';
-  txId: string;
-  contentHash: string;
-  timestamp: number;
-  deliveryUrl?: string;
-  metadata: {
-    size: number;
-    mimeType: string;
-    [key: string]: any;
-  };
-}
-
-/**
- * Delivery Proof Message (AIP-4 v1.1)
- * Reference: AIP-4 §3.2, §8.1
- * Complete schema for delivery proofs with EAS attestations
- */
-export interface DeliveryProofMessage {
-  type: 'agirails.delivery.v1';
-  version: string; // Semantic version (e.g., "1.0.0")
-  txId: string; // bytes32 (0x-prefixed)
-  provider: string; // DID (e.g., "did:ethr:84532:0x...")
-  consumer: string; // DID
-  resultCID: string; // IPFS CID (CIDv1, base32, e.g., "bafybeig...")
-  resultHash: string; // Keccak256 hash of canonical result JSON
-  metadata?: {
-    executionTime?: number; // Seconds
-    outputFormat?: string; // MIME type
-    outputSize?: number; // Bytes
-    notes?: string; // Max 500 chars
-  };
-  easAttestationUID: string; // bytes32 (0x-prefixed)
-  deliveredAt: number; // Unix timestamp (seconds)
-  chainId: number; // 84532 (Base Sepolia) or 8453 (Base Mainnet)
-  nonce: number; // Monotonically increasing
-  signature: string; // EIP-712 signature (0x-prefixed, 130 chars)
-}
-
-/**
- * EAS Attestation Data for delivery proofs
- */
-export interface EASAttestationData {
-  schema: string; // EAS schema UID
-  recipient: string; // Provider address
-  expirationTime: number; // Unix timestamp (0 for no expiration)
-  revocable: boolean;
-  refUID: string; // Reference to transaction
-  data: string; // ABI-encoded attestation data
-}
-
-/**
- * Quote Message (AIP-2 v1.0)
- * Reference: AIP-2 §2.1, §2.2
- * Price quote submitted by provider for negotiated transactions
- */
-export interface QuoteMessageV2 {
-  type: 'agirails.quote.v1';
-  version: '1.0.0';
-  txId: string; // bytes32 (0x-prefixed)
-  provider: string; // DID (e.g., "did:ethr:84532:0x...")
-  consumer: string; // DID
-  quotedAmount: string; // Provider's quoted price (base units, string to avoid JS overflow)
-  originalAmount: string; // Consumer's original offer from AIP-1
-  maxPrice: string; // Consumer's maximum acceptable price from AIP-1
-  currency: string; // Currently "USDC" only
-  decimals: number; // Token decimals (6 for USDC)
-  quotedAt: number; // Unix timestamp (seconds)
-  expiresAt: number; // Unix timestamp (seconds)
-  justification?: {
-    reason?: string;
-    estimatedTime?: number;
-    computeCost?: number;
-    breakdown?: Record<string, any>;
-  };
-  chainId: number; // 84532 (Base Sepolia) or 8453 (Base Mainnet)
-  nonce: number; // Monotonically increasing per provider + message type
-  signature: string; // EIP-712 signature (0x-prefixed, 130 chars)
-}
-