@agirails/sdk 2.0.1-beta → 2.0.2

package/dist/runtime/types/MockState.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Mock State Type Definitions
+ *
+ * These interfaces define the structure of the persistent mock blockchain state
+ * stored in `.actp/mock-state.json`. This state is shared across CLI commands,
+ * SDK library usage, and Dashboard.
+ *
+ * @module runtime/types/MockState
+ * @see ADR-001 (Mock State Persistence Strategy)
+ * @see MOCK_STATE_MANAGER_SPEC.md
+ */
+/**
+ * ACTP Transaction State enum matching the smart contract states.
+ *
+ * State machine:
+ * - INITIATED (0) -> QUOTED (1, optional) -> COMMITTED (2) -> IN_PROGRESS (3, optional)
+ *                 -> DELIVERED (4) -> SETTLED (5)
+ * - Dispute path: DELIVERED -> DISPUTED (6) -> SETTLED
+ * - Cancel path: Any pre-DELIVERED state -> CANCELLED (7)
+ */
+export type TransactionState = 'INITIATED' | 'QUOTED' | 'COMMITTED' | 'IN_PROGRESS' | 'DELIVERED' | 'SETTLED' | 'DISPUTED' | 'CANCELLED';
+/**
+ * Numeric state values matching the smart contract enum.
+ */
+export declare const TransactionStateValue: Record<TransactionState, number>;
+/**
+ * Mock blockchain event recorded during transaction lifecycle.
+ *
+ * Events are stored for debugging and can be queried to simulate
+ * blockchain event subscriptions.
+ */
+export interface MockEvent {
+    /** Event type (e.g., 'TransactionCreated', 'EscrowLinked', 'StateTransitioned') */
+    type: string;
+    /** Unix timestamp (seconds) when event was emitted */
+    timestamp: number;
+    /** Block number when event was included */
+    blockNumber: number;
+    /** Event-specific data payload */
+    data: Record<string, unknown>;
+}
+/**
+ * Mock transaction representing an ACTP transaction in the mock blockchain.
+ *
+ * Mirrors the on-chain Transaction struct but stored as JSON for human-readability.
+ * BigNumber values are stored as strings to preserve precision.
+ */
+export interface MockTransaction {
+    /** Unique transaction identifier (bytes32 hex string) */
+    id: string;
+    /** Requester's Ethereum address (checksummed) */
+    requester: string;
+    /** Provider's Ethereum address (checksummed) */
+    provider: string;
+    /** Transaction amount in USDC wei (string for BigNumber precision, 6 decimals) */
+    amount: string;
+    /** Current transaction state */
+    state: TransactionState;
+    /** Unix timestamp (seconds) when transaction was created */
+    createdAt: number;
+    /** Unix timestamp (seconds) when transaction was last updated */
+    updatedAt: number;
+    /** Unix timestamp (seconds) deadline for transaction acceptance */
+    deadline: number;
+    /** Dispute window duration in seconds */
+    disputeWindow: number;
+    /** Unix timestamp (seconds) when transaction was completed (null if not completed) */
+    completedAt: number | null;
+    /** Linked escrow ID (null if not linked yet) */
+    escrowId: string | null;
+    /** Service description or metadata hash */
+    serviceDescription: string;
+    /** Delivery proof hash (null if not delivered) */
+    deliveryProof: string | null;
+    /** List of events emitted during transaction lifecycle */
+    events: MockEvent[];
+}
+/**
+ * Mock escrow representing funds locked for a transaction.
+ *
+ * In mock mode, escrow is simulated without actual token transfers.
+ */
+export interface MockEscrow {
+    /** Unique escrow identifier */
+    id: string;
+    /** Current escrow balance in USDC wei (string for BigNumber precision) */
+    balance: string;
+    /** Whether funds are currently locked (cannot be withdrawn) */
+    locked: boolean;
+    /** List of transaction IDs using this escrow */
+    transactions: string[];
+    /** Unix timestamp (seconds) when escrow was created */
+    createdAt: number;
+}
+/**
+ * Mock account representing a user's wallet state.
+ *
+ * Tracks USDC balance for testing without real tokens.
+ */
+export interface MockAccount {
+    /** Ethereum address (checksummed) */
+    address: string;
+    /** USDC balance in wei (string for BigNumber precision, 6 decimals) */
+    usdcBalance: string;
+    /** Optional label for easier identification in tests */
+    label?: string;
+}
+/**
+ * Mock blockchain state simulating chain parameters.
+ *
+ * Allows time manipulation and block progression for testing
+ * deadline-based logic and dispute windows.
+ */
+export interface MockBlockchain {
+    /** Current simulated Unix timestamp (seconds) */
+    currentTime: number;
+    /** Current block number */
+    blockNumber: number;
+    /** Chain ID (84532 for Base Sepolia, 8453 for Base Mainnet) */
+    chainId: number;
+    /** Average block time in seconds (for time progression calculations) */
+    blockTime: number;
+}
+/**
+ * Complete mock state persisted to `.actp/mock-state.json`.
+ *
+ * This is the root interface for all mock blockchain state.
+ * Loaded/saved by MockStateManager.
+ */
+export interface MockState {
+    /** State schema version (e.g., "1.0") for migrations */
+    version: string;
+    /** Always "mock" for mock mode */
+    mode: 'mock';
+    /** Simulated blockchain parameters */
+    blockchain: MockBlockchain;
+    /** All mock transactions indexed by transaction ID */
+    transactions: Record<string, MockTransaction>;
+    /** All mock escrows indexed by escrow ID */
+    escrows: Record<string, MockEscrow>;
+    /** All mock accounts indexed by address */
+    accounts: Record<string, MockAccount>;
+    /**
+     * Global event log for all events (optional for backwards compatibility).
+     *
+     * SECURITY FIX (L-4): Events are now persisted to state file for
+     * debugging and audit purposes. This allows event history to survive
+     * across CLI invocations.
+     */
+    events?: MockEvent[];
+}
+/**
+ * Default values for creating new mock state.
+ */
+export declare const MOCK_STATE_DEFAULTS: {
+    /** Current state schema version */
+    readonly VERSION: "1.0";
+    /** Default chain ID (Base Sepolia testnet) */
+    readonly CHAIN_ID: 84532;
+    /** Default starting block number */
+    readonly INITIAL_BLOCK_NUMBER: 1000;
+    /** Default block time in seconds (Base L2 ~2 seconds) */
+    readonly BLOCK_TIME: 2;
+    /** Default initial USDC balance for new accounts (10,000 USDC = 10_000_000_000 wei) */
+    readonly DEFAULT_USDC_BALANCE: "10000000000";
+};
+//# sourceMappingURL=MockState.d.ts.map

package/dist/runtime/types/MockState.d.ts.map

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

package/dist/runtime/types/MockState.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Mock State Type Definitions
+ *
+ * These interfaces define the structure of the persistent mock blockchain state
+ * stored in `.actp/mock-state.json`. This state is shared across CLI commands,
+ * SDK library usage, and Dashboard.
+ *
+ * @module runtime/types/MockState
+ * @see ADR-001 (Mock State Persistence Strategy)
+ * @see MOCK_STATE_MANAGER_SPEC.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MOCK_STATE_DEFAULTS = exports.TransactionStateValue = void 0;
+/**
+ * Numeric state values matching the smart contract enum.
+ */
+exports.TransactionStateValue = {
+    INITIATED: 0,
+    QUOTED: 1,
+    COMMITTED: 2,
+    IN_PROGRESS: 3,
+    DELIVERED: 4,
+    SETTLED: 5,
+    DISPUTED: 6,
+    CANCELLED: 7,
+};
+/**
+ * Default values for creating new mock state.
+ */
+exports.MOCK_STATE_DEFAULTS = {
+    /** Current state schema version */
+    VERSION: '1.0',
+    /** Default chain ID (Base Sepolia testnet) */
+    CHAIN_ID: 84532,
+    /** Default starting block number */
+    INITIAL_BLOCK_NUMBER: 1000,
+    /** Default block time in seconds (Base L2 ~2 seconds) */
+    BLOCK_TIME: 2,
+    /** Default initial USDC balance for new accounts (10,000 USDC = 10_000_000_000 wei) */
+    DEFAULT_USDC_BALANCE: '10000000000',
+};
+//# sourceMappingURL=MockState.js.map

package/dist/runtime/types/MockState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockState.js","sourceRoot":"","sources":["../../../src/runtime/types/MockState.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAqBH;;GAEG;AACU,QAAA,qBAAqB,GAAqC;IACrE,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,CAAC;IACT,SAAS,EAAE,CAAC;IACZ,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;IACX,SAAS,EAAE,CAAC;CACb,CAAC;AAqKF;;GAEG;AACU,QAAA,mBAAmB,GAAG;IACjC,mCAAmC;IACnC,OAAO,EAAE,KAAK;IAEd,8CAA8C;IAC9C,QAAQ,EAAE,KAAK;IAEf,oCAAoC;IACpC,oBAAoB,EAAE,IAAI;IAE1B,yDAAyD;IACzD,UAAU,EAAE,CAAC;IAEb,uFAAuF;IACvF,oBAAoB,EAAE,aAAa;CAC3B,CAAC"}

package/dist/types/agent.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Agent Registry Types (AIP-7)
+ *
+ * Types for AI agent identity, registration, and reputation
+ */
+/**
+ * Service descriptor metadata for an agent
+ */
+export interface ServiceDescriptor {
+    /** keccak256(lowercase(serviceType)) */
+    serviceTypeHash: string;
+    /** Human-readable service type (lowercase, alphanumeric + hyphens) */
+    serviceType: string;
+    /** IPFS/HTTPS URL to JSON Schema for inputData */
+    schemaURI: string;
+    /** Minimum price in USDC base units (6 decimals) */
+    minPrice: bigint;
+    /** Maximum price in USDC base units */
+    maxPrice: bigint;
+    /** Average completion time in seconds */
+    avgCompletionTime: number;
+    /** IPFS CID to full service descriptor JSON */
+    metadataCID: string;
+}
+/**
+ * Agent profile stored on-chain
+ */
+export interface AgentProfile {
+    /** Agent's Ethereum address (controller of DID) */
+    agentAddress: string;
+    /** Full DID (e.g., did:ethr:8453:0x...) */
+    did: string;
+    /** HTTPS endpoint or IPFS gateway URL */
+    endpoint: string;
+    /** Supported service type hashes */
+    serviceTypes: string[];
+    /** USDC staked (V1: always 0, V2: slashing for disputes) */
+    stakedAmount: bigint;
+    /** Aggregated reputation (scale: 0-10000, 2 decimals precision) */
+    reputationScore: number;
+    /** Count of completed SETTLED transactions */
+    totalTransactions: number;
+    /** Count of transactions that went to DISPUTED state */
+    disputedTransactions: number;
+    /** Cumulative transaction volume (6 decimals) */
+    totalVolumeUSDC: bigint;
+    /** Block timestamp of registration */
+    registeredAt: number;
+    /** Last profile update timestamp */
+    updatedAt: number;
+    /** Agent is accepting new requests */
+    isActive: boolean;
+}
+/**
+ * Parameters for registering a new agent
+ */
+export interface RegisterAgentParams {
+    /** HTTPS endpoint or IPFS gateway URL */
+    endpoint: string;
+    /** List of services the agent provides */
+    serviceDescriptors: ServiceDescriptor[];
+}
+/**
+ * Query parameters for finding agents by service
+ */
+export interface QueryAgentsParams {
+    /** Service type hash to search for */
+    serviceTypeHash: string;
+    /** Minimum reputation score (0-10000) */
+    minReputation?: number;
+    /** Skip first N results (for pagination) */
+    offset?: number;
+    /** Maximum number of results to return */
+    limit?: number;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/types/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/agent.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Agent Registry Types (AIP-7)
+ *
+ * Types for AI agent identity, registration, and reputation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=agent.js.map

package/dist/types/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/types/did.d.ts

@@ -0,0 +1,192 @@
+/**
+ * DID (Decentralized Identity) Types - AIP-7 §2
+ *
+ * Implements W3C DID specification for Ethereum-based identities
+ * using the did:ethr method with ERC-1056 registry
+ */
+/**
+ * DID format: did:ethr:<chainId>:<address>
+ * Example: did:ethr:84532:0x742d35cc6634c0532925a3b844bc9e7595f0beb
+ */
+export type DID = string;
+/**
+ * W3C DID Document structure
+ * @see https://www.w3.org/TR/did-core/
+ */
+export interface DIDDocument {
+    '@context': string | string[];
+    id: DID;
+    verificationMethod?: VerificationMethod[];
+    authentication?: (string | VerificationMethod)[];
+    assertionMethod?: (string | VerificationMethod)[];
+    keyAgreement?: (string | VerificationMethod)[];
+    capabilityInvocation?: (string | VerificationMethod)[];
+    capabilityDelegation?: (string | VerificationMethod)[];
+    service?: ServiceEndpoint[];
+}
+/**
+ * Verification method for cryptographic key
+ */
+export interface VerificationMethod {
+    id: string;
+    type: string;
+    controller: DID;
+    blockchainAccountId?: string;
+    publicKeyHex?: string;
+    publicKeyBase58?: string;
+    publicKeyMultibase?: string;
+    ethereumAddress?: string;
+    validTo?: number | bigint;
+}
+/**
+ * Service endpoint in DID Document
+ */
+export interface ServiceEndpoint {
+    id: string;
+    type: string;
+    serviceEndpoint: string | string[] | Record<string, unknown>;
+    description?: string;
+}
+/**
+ * DID Resolution result
+ */
+export interface DIDResolutionResult {
+    didDocument: DIDDocument | null;
+    didResolutionMetadata: DIDResolutionMetadata;
+    didDocumentMetadata: DIDDocumentMetadata;
+}
+/**
+ * DID Resolution metadata
+ */
+export interface DIDResolutionMetadata {
+    contentType?: string;
+    error?: 'invalidDid' | 'notFound' | 'representationNotSupported' | 'unsupportedDidMethod' | string;
+    message?: string;
+}
+/**
+ * DID Document metadata
+ */
+export interface DIDDocumentMetadata {
+    created?: string;
+    updated?: string;
+    deactivated?: boolean;
+    versionId?: string;
+    nextUpdate?: string;
+    nextVersionId?: string;
+}
+/**
+ * Configuration for DID Resolver
+ */
+export interface DIDResolverConfig {
+    /**
+     * Network to use (base-sepolia or base-mainnet)
+     */
+    network?: string;
+    /**
+     * Custom RPC URL (overrides network default)
+     */
+    rpcUrl?: string;
+    /**
+     * Custom Identity Registry address (overrides network default)
+     */
+    registryAddress?: string;
+    /**
+     * Chain ID (required if not using predefined network)
+     */
+    chainId?: number;
+}
+/**
+ * Parsed DID components
+ */
+export interface ParsedDID {
+    method: string;
+    chainId: number;
+    address: string;
+}
+/**
+ * ERC-1056 Identity Changed Event
+ */
+export interface DIDOwnerChangedEvent {
+    identity: string;
+    owner: string;
+    previousChange: bigint;
+}
+/**
+ * ERC-1056 Delegate Changed Event
+ */
+export interface DIDDelegateChangedEvent {
+    identity: string;
+    delegateType: string;
+    delegate: string;
+    validTo: bigint;
+    previousChange: bigint;
+}
+/**
+ * ERC-1056 Attribute Changed Event
+ */
+export interface DIDAttributeChangedEvent {
+    identity: string;
+    name: string;
+    value: Uint8Array;
+    validTo: bigint;
+    previousChange: bigint;
+}
+/**
+ * Delegate types for ERC-1056
+ */
+export declare enum DelegateType {
+    /** Can sign on behalf of identity */
+    SIGNING = "veriKey",
+    /** Can encrypt messages for identity */
+    ENCRYPTION = "encryptionKey",
+    /** Can perform general actions */
+    GENERAL = "delegate",
+    /** Custom delegate type */
+    CUSTOM = "custom"
+}
+/**
+ * Attribute names for ERC-1056
+ */
+export declare enum AttributeName {
+    /** Service endpoint (e.g., AGIRAILS API endpoint) */
+    SERVICE_ENDPOINT = "did/svc/AGIRAILSProvider",
+    /** Public key for verification */
+    PUBLIC_KEY = "did/pub/Secp256k1/veriKey",
+    /** Encryption public key */
+    ENCRYPTION_KEY = "did/pub/X25519/enc",
+    /** Custom attribute */
+    CUSTOM = "custom"
+}
+/**
+ * Options for DID signature verification
+ */
+export interface VerifySignatureOptions {
+    /** Chain ID to verify against (prevents cross-chain replay) */
+    chainId: number;
+    /** Expected DID (optional additional check) */
+    expectedDID?: DID;
+    /** Timestamp for delegate validity check */
+    timestamp?: number;
+    /**
+     * Use domain separation to prevent cross-protocol replay attacks
+     * Default: true (recommended for security)
+     * Set to false only for backwards compatibility with old signatures
+     */
+    useDomainSeparation?: boolean;
+}
+/**
+ * Result of signature verification
+ */
+export interface SignatureVerificationResult {
+    /** Whether signature is valid */
+    valid: boolean;
+    /** Recovered signer address */
+    signer?: string;
+    /** Error message if verification failed */
+    error?: string;
+    /** Whether signer is a delegate (not the owner) */
+    isDelegate?: boolean;
+    /** Delegate type if signer is a delegate */
+    delegateType?: string;
+}
+//# sourceMappingURL=did.d.ts.map

package/dist/types/did.d.ts.map

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

package/dist/types/did.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * DID (Decentralized Identity) Types - AIP-7 §2
+ *
+ * Implements W3C DID specification for Ethereum-based identities
+ * using the did:ethr method with ERC-1056 registry
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttributeName = exports.DelegateType = void 0;
+/**
+ * Delegate types for ERC-1056
+ */
+var DelegateType;
+(function (DelegateType) {
+    /** Can sign on behalf of identity */
+    DelegateType["SIGNING"] = "veriKey";
+    /** Can encrypt messages for identity */
+    DelegateType["ENCRYPTION"] = "encryptionKey";
+    /** Can perform general actions */
+    DelegateType["GENERAL"] = "delegate";
+    /** Custom delegate type */
+    DelegateType["CUSTOM"] = "custom";
+})(DelegateType || (exports.DelegateType = DelegateType = {}));
+/**
+ * Attribute names for ERC-1056
+ */
+var AttributeName;
+(function (AttributeName) {
+    /** Service endpoint (e.g., AGIRAILS API endpoint) */
+    AttributeName["SERVICE_ENDPOINT"] = "did/svc/AGIRAILSProvider";
+    /** Public key for verification */
+    AttributeName["PUBLIC_KEY"] = "did/pub/Secp256k1/veriKey";
+    /** Encryption public key */
+    AttributeName["ENCRYPTION_KEY"] = "did/pub/X25519/enc";
+    /** Custom attribute */
+    AttributeName["CUSTOM"] = "custom";
+})(AttributeName || (exports.AttributeName = AttributeName = {}));
+//# sourceMappingURL=did.js.map

package/dist/types/did.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"did.js","sourceRoot":"","sources":["../../src/types/did.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAgJH;;GAEG;AACH,IAAY,YAYX;AAZD,WAAY,YAAY;IACtB,qCAAqC;IACrC,mCAAmB,CAAA;IAEnB,wCAAwC;IACxC,4CAA4B,CAAA;IAE5B,kCAAkC;IAClC,oCAAoB,CAAA;IAEpB,2BAA2B;IAC3B,iCAAiB,CAAA;AACnB,CAAC,EAZW,YAAY,4BAAZ,YAAY,QAYvB;AAED;;GAEG;AACH,IAAY,aAYX;AAZD,WAAY,aAAa;IACvB,qDAAqD;IACrD,8DAA6C,CAAA;IAE7C,kCAAkC;IAClC,yDAAwC,CAAA;IAExC,4BAA4B;IAC5B,sDAAqC,CAAA;IAErC,uBAAuB;IACvB,kCAAiB,CAAA;AACnB,CAAC,EAZW,aAAa,6BAAb,aAAa,QAYxB"}

package/dist/types/eip712.d.ts

@@ -1,10 +1,23 @@
 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 declare const QuoteRequestTypes: {
     QuoteRequest: {
         name: string;
@@ -21,6 +34,10 @@ export interface QuoteRequestData {
     deadline: number;
     disputeWindow: number;
 }
+/**
+ * QuoteResponse (AIP-2)
+ * Reference: Yellow Paper §4.2
+ */
 export declare const QuoteResponseTypes: {
     QuoteResponse: {
         name: string;
@@ -38,6 +55,10 @@ export interface QuoteResponseData {
     deliveryTime: number;
     terms: string;
 }
+/**
+ * DeliveryProof (AIP-4) - DEPRECATED
+ * @deprecated Use AIP4DeliveryProofTypes instead (AIP-4 v1.1)
+ */
 export declare const DeliveryProofTypes: {
     DeliveryProof: {
         name: string;
@@ -53,6 +74,10 @@ export interface DeliveryProofData {
     mimeType: string;
 }
 export declare function deliveryProofDataFromProof(proof: DeliveryProof): DeliveryProofData;
+/**
+ * AIP-4 Delivery Proof (v1.1)
+ * Reference: AIP-4 §3.3
+ */
 export declare const AIP4DeliveryProofTypes: {
     DeliveryProof: {
         name: string;
@@ -70,12 +95,18 @@ export interface AIP4DeliveryProofData {
     chainId: number;
     nonce: number;
 }
+/**
+ * Generic ACTPMessage (fallback for custom AIPs)
+ */
 export declare const ACTPMessageTypes: {
     ACTPMessage: {
         name: string;
         type: string;
     }[];
 };
+/**
+ * Message type registry
+ */
 export declare const MESSAGE_TYPES: {
     'quote.request': {
         QuoteRequest: {
@@ -102,5 +133,8 @@ export declare const MESSAGE_TYPES: {
         }[];
     };
 };
+/**
+ * Get EIP-712 types for message type
+ */
 export declare function getMessageTypes(messageType: string): Record<string, any>;
 //# sourceMappingURL=eip712.d.ts.map

package/dist/types/eip712.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eip712.d.ts","sourceRoot":"","sources":["../../src/types/eip712.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAY1C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAMD,eAAO,MAAM,iBAAiB;;;;;CAW7B,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD,eAAO,MAAM,kBAAkB;;;;;CAY9B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,eAAO,MAAM,kBAAkB;;;;;CAS9B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB,CASlF;AAMD,eAAO,MAAM,sBAAsB;;;;;CAYlC,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAKD,eAAO,MAAM,gBAAgB;;;;;CAU5B,CAAC;AAKF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;CAMzB,CAAC;AAKF,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAExE"}
+{"version":3,"file":"eip712.d.ts","sourceRoot":"","sources":["../../src/types/eip712.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;CAW7B,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;CAY9B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;CAS9B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB,CASlF;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;CAYlC,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;CAU5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;CAMzB,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAExE"}