@arc402/sdk 0.3.1 → 0.4.0

package/README.md

@@ -150,6 +150,45 @@ const dispute = await agreement.getDisputeCase(agreementId);
 console.log({ remediation, dispute });
 ```
 
+## File Delivery
+
+Files are **private by default** — only the keccak256 bundle hash is published on-chain. Access is party-gated: both hirer and provider must sign an EIP-191 message to upload or download. The arbitrator receives a time-limited token for dispute resolution.
+
+The `DeliveryClient` wraps the daemon's delivery endpoints (running at `localhost:4402` by default):
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `POST` | `/job/:id/upload` | Upload a deliverable file |
+| `GET` | `/job/:id/files/:name` | Download a specific file |
+| `GET` | `/job/:id/manifest` | Fetch delivery manifest with hashes |
+
+```ts
+import { DeliveryClient } from "@arc402/sdk";
+
+const delivery = new DeliveryClient(); // default: http://localhost:4402
+
+// Provider: upload deliverables
+const file = await delivery.uploadDeliverable(42n, "./report.pdf", providerSigner);
+console.log(file.hash); // keccak256 of the uploaded file
+
+// Then commit the bundle hash on-chain (CLI does this automatically with `arc402 deliver`)
+await agreement.commitDeliverable(42n, manifest.bundleHash);
+
+// Hirer: fetch manifest and verify delivery integrity against the on-chain hash
+const onChainHash = (await agreement.getAgreement(42n)).deliverableHash;
+const result = await delivery.verifyDelivery(42n, onChainHash, hirerSigner, "./downloads/");
+if (result.ok) {
+  await agreement.verifyDeliverable(42n); // release escrow
+} else {
+  console.error("Hash mismatches:", result.mismatches);
+}
+
+// Download a single file
+const outPath = await delivery.downloadDeliverable(42n, "report.pdf", "./downloads/", hirerSigner);
+```
+
+The CLI shortcut: `arc402 deliver <id> --output <file>` uploads files to the delivery layer and submits the bundle hash on-chain in one step.
+
 ## Sponsorship + governance + operational context
 
 ```ts
@@ -170,6 +209,24 @@ const tx0 = await governance.getTransaction(0n);
 console.log({ highestTier, metrics, tx0 });
 ```
 
+## Compute + Subscription
+
+The SDK ships mainnet addresses as named exports so you never need to hardcode them:
+
+```ts
+import {
+  ComputeAgreementClient,
+  COMPUTE_AGREEMENT_ADDRESS,
+  SUBSCRIPTION_AGREEMENT_ADDRESS,
+} from "@arc402/sdk";
+
+const compute = new ComputeAgreementClient(COMPUTE_AGREEMENT_ADDRESS, signer);
+```
+
+`ComputeAgreementClient` — propose, accept, and settle GPU compute sessions on Base mainnet (chain 8453).
+
+`SUBSCRIPTION_AGREEMENT_ADDRESS` — Base mainnet address for the SubscriptionAgreement contract. A `SubscriptionAgreementClient` wrapper is on the roadmap; use the raw address with ethers until then.
+
 ## Notes
 
 - The default settlement flow is propose -> accept -> commitDeliverable -> verifyDeliverable/autoRelease, with remediation required before dispute in normal cases. Direct dispute is reserved for explicit hard-fail cases: no delivery, hard deadline breach, clearly invalid/fraudulent deliverables, or safety-critical violations.

package/dist/compute.d.ts

@@ -0,0 +1,43 @@
+import { ethers, ContractTransactionResponse } from "ethers";
+export interface ComputeSession {
+    client: string;
+    provider: string;
+    token: string;
+    ratePerHour: bigint;
+    maxHours: bigint;
+    depositAmount: bigint;
+    startedAt: bigint;
+    endedAt: bigint;
+    consumedMinutes: bigint;
+    proposedAt: bigint;
+    disputedAt: bigint;
+    gpuSpecHash: string;
+    status: number;
+}
+export interface ComputeUsageReport {
+    periodStart: bigint;
+    periodEnd: bigint;
+    computeMinutes: bigint;
+    avgUtilization: bigint;
+    providerSignature: string;
+    metricsHash: string;
+}
+export declare class ComputeAgreementClient {
+    private contract;
+    constructor(contractAddress: string, signerOrProvider: ethers.Signer | ethers.Provider);
+    proposeSession(sessionId: string, provider: string, ratePerHour: bigint, maxHours: bigint, gpuSpecHash: string, token: string, deposit: bigint): Promise<ContractTransactionResponse>;
+    acceptSession(sessionId: string): Promise<ContractTransactionResponse>;
+    startSession(sessionId: string): Promise<ContractTransactionResponse>;
+    submitUsageReport(sessionId: string, periodStart: bigint, periodEnd: bigint, computeMinutes: bigint, avgUtilization: bigint, providerSignature: string, metricsHash: string): Promise<ContractTransactionResponse>;
+    endSession(sessionId: string): Promise<ContractTransactionResponse>;
+    disputeSession(sessionId: string): Promise<ContractTransactionResponse>;
+    cancelSession(sessionId: string): Promise<ContractTransactionResponse>;
+    resolveDispute(sessionId: string, providerAmount: bigint, clientAmount: bigint): Promise<ContractTransactionResponse>;
+    claimDisputeTimeout(sessionId: string): Promise<ContractTransactionResponse>;
+    withdraw(token: string): Promise<ContractTransactionResponse>;
+    getSession(sessionId: string): Promise<ComputeSession>;
+    calculateCost(sessionId: string): Promise<bigint>;
+    getUsageReports(sessionId: string): Promise<ComputeUsageReport[]>;
+    pendingWithdrawals(user: string, token: string): Promise<bigint>;
+}
+//# sourceMappingURL=compute.d.ts.map

package/dist/compute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute.d.ts","sourceRoot":"","sources":["../src/compute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,2BAA2B,EAAE,MAAM,QAAQ,CAAC;AAuB7D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,eAAe,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ;IAIhF,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,2BAA2B,CAAC;IAQjC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAItE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAIrE,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,2BAA2B,CAAC;IAMjC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAInE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAIvE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAItE,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,2BAA2B,CAAC;IAIjC,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAI5E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAI7D,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAItD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAIjE,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAGvE"}

package/dist/compute.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComputeAgreementClient = void 0;
+const ethers_1 = require("ethers");
+// ─── ABI ──────────────────────────────────────────────────────────────────────
+const COMPUTE_AGREEMENT_ABI = [
+    "function proposeSession(bytes32 sessionId, address provider, uint256 ratePerHour, uint256 maxHours, bytes32 gpuSpecHash, address token) external payable",
+    "function acceptSession(bytes32 sessionId) external",
+    "function startSession(bytes32 sessionId) external",
+    "function submitUsageReport(bytes32 sessionId, uint256 periodStart, uint256 periodEnd, uint256 computeMinutes, uint256 avgUtilization, bytes providerSignature, bytes32 metricsHash) external",
+    "function endSession(bytes32 sessionId) external",
+    "function disputeSession(bytes32 sessionId) external",
+    "function cancelSession(bytes32 sessionId) external",
+    "function resolveDispute(bytes32 sessionId, uint256 providerAmount, uint256 clientAmount) external",
+    "function claimDisputeTimeout(bytes32 sessionId) external",
+    "function withdraw(address token) external",
+    "function getSession(bytes32 sessionId) external view returns (tuple(address client, address provider, address token, uint256 ratePerHour, uint256 maxHours, uint256 depositAmount, uint256 startedAt, uint256 endedAt, uint256 consumedMinutes, uint256 proposedAt, uint256 disputedAt, bytes32 gpuSpecHash, uint8 status))",
+    "function calculateCost(bytes32 sessionId) external view returns (uint256)",
+    "function getUsageReports(bytes32 sessionId) external view returns (tuple(uint256 periodStart, uint256 periodEnd, uint256 computeMinutes, uint256 avgUtilization, bytes providerSignature, bytes32 metricsHash)[])",
+    "function pendingWithdrawals(address user, address token) external view returns (uint256)",
+];
+// ─── Client ───────────────────────────────────────────────────────────────────
+class ComputeAgreementClient {
+    constructor(contractAddress, signerOrProvider) {
+        this.contract = new ethers_1.ethers.Contract(contractAddress, COMPUTE_AGREEMENT_ABI, signerOrProvider);
+    }
+    async proposeSession(sessionId, provider, ratePerHour, maxHours, gpuSpecHash, token, deposit) {
+        const isEth = token === ethers_1.ethers.ZeroAddress;
+        return this.contract.proposeSession(sessionId, provider, ratePerHour, maxHours, gpuSpecHash, token, { value: isEth ? deposit : 0n });
+    }
+    async acceptSession(sessionId) {
+        return this.contract.acceptSession(sessionId);
+    }
+    async startSession(sessionId) {
+        return this.contract.startSession(sessionId);
+    }
+    async submitUsageReport(sessionId, periodStart, periodEnd, computeMinutes, avgUtilization, providerSignature, metricsHash) {
+        return this.contract.submitUsageReport(sessionId, periodStart, periodEnd, computeMinutes, avgUtilization, providerSignature, metricsHash);
+    }
+    async endSession(sessionId) {
+        return this.contract.endSession(sessionId);
+    }
+    async disputeSession(sessionId) {
+        return this.contract.disputeSession(sessionId);
+    }
+    async cancelSession(sessionId) {
+        return this.contract.cancelSession(sessionId);
+    }
+    async resolveDispute(sessionId, providerAmount, clientAmount) {
+        return this.contract.resolveDispute(sessionId, providerAmount, clientAmount);
+    }
+    async claimDisputeTimeout(sessionId) {
+        return this.contract.claimDisputeTimeout(sessionId);
+    }
+    async withdraw(token) {
+        return this.contract.withdraw(token);
+    }
+    async getSession(sessionId) {
+        return this.contract.getSession(sessionId);
+    }
+    async calculateCost(sessionId) {
+        return this.contract.calculateCost(sessionId);
+    }
+    async getUsageReports(sessionId) {
+        return this.contract.getUsageReports(sessionId);
+    }
+    async pendingWithdrawals(user, token) {
+        return this.contract.pendingWithdrawals(user, token);
+    }
+}
+exports.ComputeAgreementClient = ComputeAgreementClient;

package/dist/delivery.d.ts

@@ -0,0 +1,71 @@
+/**
+ * File Delivery Layer — wraps daemon HTTP endpoints for content-addressed
+ * file delivery with party-gated access (EIP-191 signatures).
+ *
+ * Files are private by default. Only the keccak256 bundle hash is published
+ * on-chain. Downloads require a valid EIP-191 signature from either the hirer
+ * or the provider. Arbitrators receive a time-limited token for dispute access.
+ *
+ * Daemon endpoints:
+ *   POST /job/:id/upload          — upload a deliverable file
+ *   GET  /job/:id/files           — list all delivered files
+ *   GET  /job/:id/files/:name     — download a specific file
+ *   GET  /job/:id/manifest        — fetch the delivery manifest
+ */
+import { ethers } from "ethers";
+export declare const DEFAULT_DAEMON_URL = "http://localhost:4402";
+export interface DeliveryFile {
+    name: string;
+    hash: string;
+    size: number;
+}
+export interface DeliveryManifest {
+    agreementId: string;
+    files: DeliveryFile[];
+    bundleHash: string;
+}
+export interface DeliveryClientOptions {
+    /** Daemon base URL. Defaults to http://localhost:4402. */
+    daemonUrl?: string;
+}
+export declare class DeliveryClient {
+    private daemonUrl;
+    constructor(options?: DeliveryClientOptions);
+    /** Sign the standard auth message for a job. Used for upload and download. */
+    private signAuth;
+    /**
+     * Upload a file as a deliverable for the agreement.
+     * Returns the file entry recorded by the daemon (name, keccak256 hash, size).
+     * Auth: EIP-191 signature from the provider's signer.
+     *
+     * After uploading all files, commit the manifest bundleHash on-chain via
+     * ServiceAgreementClient.commitDeliverable(). The CLI does this automatically
+     * when you run `arc402 deliver <id>`.
+     */
+    uploadDeliverable(agreementId: bigint | string, filePath: string, signer: ethers.Signer): Promise<DeliveryFile>;
+    /**
+     * Download a named file from the agreement's delivery.
+     * Writes the file to <outputDir>/<name> and returns the output path.
+     * Auth: EIP-191 signature from the hirer's or provider's signer.
+     */
+    downloadDeliverable(agreementId: bigint | string, fileName: string, outputDir: string, signer: ethers.Signer): Promise<string>;
+    /**
+     * Fetch the delivery manifest for an agreement.
+     * Lists all delivered files with their keccak256 hashes and the overall bundleHash.
+     * Auth: EIP-191 signature from the hirer's or provider's signer.
+     */
+    getManifest(agreementId: bigint | string, signer: ethers.Signer): Promise<DeliveryManifest>;
+    /**
+     * Download all files and verify their keccak256 hashes against the manifest.
+     * Also checks that the manifest bundleHash matches the expectedBundleHash
+     * (which should equal the value committed on-chain via commitDeliverable).
+     *
+     * Returns { ok: true } when all hashes match, or
+     * { ok: false, mismatches: [...] } listing any files that failed.
+     */
+    verifyDelivery(agreementId: bigint | string, expectedBundleHash: string, signer: ethers.Signer, outputDir: string): Promise<{
+        ok: boolean;
+        mismatches: string[];
+    }>;
+}
+//# sourceMappingURL=delivery.d.ts.map

package/dist/delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../src/delivery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,CAAC,EAAE,qBAAqB;IAI3C,8EAA8E;YAChE,QAAQ;IAItB;;;;;;;;OAQG;IACG,iBAAiB,CACrB,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,GACpB,OAAO,CAAC,YAAY,CAAC;IAiBxB;;;;OAIG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;IAelB;;;;OAIG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAWjG;;;;;;;OAOG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAmBlD"}

package/dist/delivery.js

@@ -0,0 +1,117 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryClient = exports.DEFAULT_DAEMON_URL = void 0;
+/**
+ * File Delivery Layer — wraps daemon HTTP endpoints for content-addressed
+ * file delivery with party-gated access (EIP-191 signatures).
+ *
+ * Files are private by default. Only the keccak256 bundle hash is published
+ * on-chain. Downloads require a valid EIP-191 signature from either the hirer
+ * or the provider. Arbitrators receive a time-limited token for dispute access.
+ *
+ * Daemon endpoints:
+ *   POST /job/:id/upload          — upload a deliverable file
+ *   GET  /job/:id/files           — list all delivered files
+ *   GET  /job/:id/files/:name     — download a specific file
+ *   GET  /job/:id/manifest        — fetch the delivery manifest
+ */
+const ethers_1 = require("ethers");
+const promises_1 = require("fs/promises");
+const path_1 = __importDefault(require("path"));
+exports.DEFAULT_DAEMON_URL = "http://localhost:4402";
+class DeliveryClient {
+    constructor(options) {
+        this.daemonUrl = (options?.daemonUrl ?? exports.DEFAULT_DAEMON_URL).replace(/\/$/, "");
+    }
+    /** Sign the standard auth message for a job. Used for upload and download. */
+    async signAuth(agreementId, signer) {
+        return signer.signMessage(`arc402:job:${agreementId}`);
+    }
+    /**
+     * Upload a file as a deliverable for the agreement.
+     * Returns the file entry recorded by the daemon (name, keccak256 hash, size).
+     * Auth: EIP-191 signature from the provider's signer.
+     *
+     * After uploading all files, commit the manifest bundleHash on-chain via
+     * ServiceAgreementClient.commitDeliverable(). The CLI does this automatically
+     * when you run `arc402 deliver <id>`.
+     */
+    async uploadDeliverable(agreementId, filePath, signer) {
+        const signature = await this.signAuth(agreementId, signer);
+        const address = await signer.getAddress();
+        const filename = path_1.default.basename(filePath);
+        const fileBuffer = await (0, promises_1.readFile)(filePath);
+        const form = new FormData();
+        form.append("file", new Blob([fileBuffer]), filename);
+        form.append("address", address);
+        form.append("signature", signature);
+        const res = await fetch(`${this.daemonUrl}/job/${agreementId}/upload`, {
+            method: "POST",
+            body: form,
+        });
+        if (!res.ok)
+            throw new Error(`Upload failed: ${res.status} ${res.statusText}`);
+        return (await res.json());
+    }
+    /**
+     * Download a named file from the agreement's delivery.
+     * Writes the file to <outputDir>/<name> and returns the output path.
+     * Auth: EIP-191 signature from the hirer's or provider's signer.
+     */
+    async downloadDeliverable(agreementId, fileName, outputDir, signer) {
+        const signature = await this.signAuth(agreementId, signer);
+        const address = await signer.getAddress();
+        const res = await fetch(`${this.daemonUrl}/job/${agreementId}/files/${encodeURIComponent(fileName)}`, { headers: { "X-Arc402-Address": address, "X-Arc402-Signature": signature } });
+        if (!res.ok)
+            throw new Error(`Download failed: ${res.status} ${res.statusText}`);
+        const buffer = Buffer.from(await res.arrayBuffer());
+        await (0, promises_1.mkdir)(outputDir, { recursive: true });
+        const outPath = path_1.default.join(outputDir, fileName);
+        await (0, promises_1.writeFile)(outPath, buffer);
+        return outPath;
+    }
+    /**
+     * Fetch the delivery manifest for an agreement.
+     * Lists all delivered files with their keccak256 hashes and the overall bundleHash.
+     * Auth: EIP-191 signature from the hirer's or provider's signer.
+     */
+    async getManifest(agreementId, signer) {
+        const signature = await this.signAuth(agreementId, signer);
+        const address = await signer.getAddress();
+        const res = await fetch(`${this.daemonUrl}/job/${agreementId}/manifest`, { headers: { "X-Arc402-Address": address, "X-Arc402-Signature": signature } });
+        if (!res.ok)
+            throw new Error(`Manifest fetch failed: ${res.status} ${res.statusText}`);
+        return (await res.json());
+    }
+    /**
+     * Download all files and verify their keccak256 hashes against the manifest.
+     * Also checks that the manifest bundleHash matches the expectedBundleHash
+     * (which should equal the value committed on-chain via commitDeliverable).
+     *
+     * Returns { ok: true } when all hashes match, or
+     * { ok: false, mismatches: [...] } listing any files that failed.
+     */
+    async verifyDelivery(agreementId, expectedBundleHash, signer, outputDir) {
+        const manifest = await this.getManifest(agreementId, signer);
+        if (manifest.bundleHash.toLowerCase() !== expectedBundleHash.toLowerCase()) {
+            return {
+                ok: false,
+                mismatches: [`bundleHash mismatch: expected ${expectedBundleHash}, got ${manifest.bundleHash}`],
+            };
+        }
+        const mismatches = [];
+        for (const file of manifest.files) {
+            const outPath = await this.downloadDeliverable(agreementId, file.name, outputDir, signer);
+            const buffer = await (0, promises_1.readFile)(outPath);
+            const localHash = ethers_1.ethers.keccak256(buffer);
+            if (localHash.toLowerCase() !== file.hash.toLowerCase()) {
+                mismatches.push(`${file.name}: expected ${file.hash}, got ${localHash}`);
+            }
+        }
+        return { ok: mismatches.length === 0, mismatches };
+    }
+}
+exports.DeliveryClient = DeliveryClient;

package/dist/endpoint.d.ts

@@ -0,0 +1,51 @@
+/**
+ * HTTP endpoint helpers — resolve an agent's endpoint from AgentRegistry
+ * and notify it after onchain events (hire, handshake).
+ */
+import { ethers } from "ethers";
+export declare const DEFAULT_REGISTRY_ADDRESS = "0xD5c2851B00090c92Ba7F4723FB548bb30C9B6865";
+export interface EndpointNotifyResult {
+    ok: boolean;
+    status?: number;
+    error?: string;
+}
+/**
+ * Reads an agent's public HTTP endpoint from AgentRegistry.
+ * Returns an empty string if the agent is not registered or has no endpoint.
+ */
+export declare function resolveEndpoint(agentAddress: string, provider: ethers.Provider, registryAddress?: string): Promise<string>;
+/**
+ * POSTs a JSON payload to `${endpoint}${path}`.
+ * Returns { ok, status } on success, { ok: false, error } on failure.
+ * Never throws.
+ */
+export declare function notifyEndpoint(endpoint: string, path: string, payload: Record<string, unknown>): Promise<EndpointNotifyResult>;
+/**
+ * Convenience: resolve an agent's endpoint then POST to /hire.
+ */
+export declare function notifyHire(agentAddress: string, proposal: Record<string, unknown>, provider: ethers.Provider, registryAddress?: string): Promise<EndpointNotifyResult>;
+/**
+ * Convenience: resolve an agent's endpoint then POST to /handshake.
+ */
+export declare function notifyHandshake(agentAddress: string, payload: Record<string, unknown>, provider: ethers.Provider, registryAddress?: string): Promise<EndpointNotifyResult>;
+/**
+ * Convenience: resolve an agent's endpoint then POST to /hire/accepted.
+ */
+export declare function notifyHireAccepted(agentAddress: string, payload: Record<string, unknown>, provider: ethers.Provider, registryAddress?: string): Promise<EndpointNotifyResult>;
+/**
+ * Convenience: resolve an agent's endpoint then POST to /delivery.
+ */
+export declare function notifyDelivery(agentAddress: string, payload: Record<string, unknown>, provider: ethers.Provider, registryAddress?: string): Promise<EndpointNotifyResult>;
+/**
+ * Convenience: resolve an agent's endpoint then POST to /delivery/accepted.
+ */
+export declare function notifyDeliveryAccepted(agentAddress: string, payload: Record<string, unknown>, provider: ethers.Provider, registryAddress?: string): Promise<EndpointNotifyResult>;
+/**
+ * Convenience: resolve an agent's endpoint then POST to /dispute.
+ */
+export declare function notifyDispute(agentAddress: string, payload: Record<string, unknown>, provider: ethers.Provider, registryAddress?: string): Promise<EndpointNotifyResult>;
+/**
+ * Convenience: resolve an agent's endpoint then POST to /message.
+ */
+export declare function notifyMessage(agentAddress: string, payload: Record<string, unknown>, provider: ethers.Provider, registryAddress?: string): Promise<EndpointNotifyResult>;
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../src/endpoint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,eAAO,MAAM,wBAAwB,+CAA+C,CAAC;AAErF,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,eAAe,SAA2B,GACzC,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CAY/B;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,eAAe,SAA2B,GACzC,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,eAAe,SAA2B,GACzC,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,eAAe,SAA2B,GACzC,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,eAAe,SAA2B,GACzC,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,eAAe,SAA2B,GACzC,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,eAAe,SAA2B,GACzC,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,eAAe,SAA2B,GACzC,OAAO,CAAC,oBAAoB,CAAC,CAG/B"}

package/dist/endpoint.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_REGISTRY_ADDRESS = void 0;
+exports.resolveEndpoint = resolveEndpoint;
+exports.notifyEndpoint = notifyEndpoint;
+exports.notifyHire = notifyHire;
+exports.notifyHandshake = notifyHandshake;
+exports.notifyHireAccepted = notifyHireAccepted;
+exports.notifyDelivery = notifyDelivery;
+exports.notifyDeliveryAccepted = notifyDeliveryAccepted;
+exports.notifyDispute = notifyDispute;
+exports.notifyMessage = notifyMessage;
+/**
+ * HTTP endpoint helpers — resolve an agent's endpoint from AgentRegistry
+ * and notify it after onchain events (hire, handshake).
+ */
+const ethers_1 = require("ethers");
+const contracts_1 = require("./contracts");
+exports.DEFAULT_REGISTRY_ADDRESS = "0xD5c2851B00090c92Ba7F4723FB548bb30C9B6865";
+/**
+ * Reads an agent's public HTTP endpoint from AgentRegistry.
+ * Returns an empty string if the agent is not registered or has no endpoint.
+ */
+async function resolveEndpoint(agentAddress, provider, registryAddress = exports.DEFAULT_REGISTRY_ADDRESS) {
+    const registry = new ethers_1.ethers.Contract(registryAddress, contracts_1.AGENT_REGISTRY_ABI, provider);
+    const agentData = await registry.getAgent(agentAddress);
+    return agentData.endpoint ?? "";
+}
+/**
+ * POSTs a JSON payload to `${endpoint}${path}`.
+ * Returns { ok, status } on success, { ok: false, error } on failure.
+ * Never throws.
+ */
+async function notifyEndpoint(endpoint, path, payload) {
+    if (!endpoint)
+        return { ok: false, error: "no endpoint" };
+    try {
+        const res = await fetch(`${endpoint}${path}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(payload),
+        });
+        return { ok: res.ok, status: res.status };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+/**
+ * Convenience: resolve an agent's endpoint then POST to /hire.
+ */
+async function notifyHire(agentAddress, proposal, provider, registryAddress = exports.DEFAULT_REGISTRY_ADDRESS) {
+    const endpoint = await resolveEndpoint(agentAddress, provider, registryAddress);
+    return notifyEndpoint(endpoint, "/hire", proposal);
+}
+/**
+ * Convenience: resolve an agent's endpoint then POST to /handshake.
+ */
+async function notifyHandshake(agentAddress, payload, provider, registryAddress = exports.DEFAULT_REGISTRY_ADDRESS) {
+    const endpoint = await resolveEndpoint(agentAddress, provider, registryAddress);
+    return notifyEndpoint(endpoint, "/handshake", payload);
+}
+/**
+ * Convenience: resolve an agent's endpoint then POST to /hire/accepted.
+ */
+async function notifyHireAccepted(agentAddress, payload, provider, registryAddress = exports.DEFAULT_REGISTRY_ADDRESS) {
+    const endpoint = await resolveEndpoint(agentAddress, provider, registryAddress);
+    return notifyEndpoint(endpoint, "/hire/accepted", payload);
+}
+/**
+ * Convenience: resolve an agent's endpoint then POST to /delivery.
+ */
+async function notifyDelivery(agentAddress, payload, provider, registryAddress = exports.DEFAULT_REGISTRY_ADDRESS) {
+    const endpoint = await resolveEndpoint(agentAddress, provider, registryAddress);
+    return notifyEndpoint(endpoint, "/delivery", payload);
+}
+/**
+ * Convenience: resolve an agent's endpoint then POST to /delivery/accepted.
+ */
+async function notifyDeliveryAccepted(agentAddress, payload, provider, registryAddress = exports.DEFAULT_REGISTRY_ADDRESS) {
+    const endpoint = await resolveEndpoint(agentAddress, provider, registryAddress);
+    return notifyEndpoint(endpoint, "/delivery/accepted", payload);
+}
+/**
+ * Convenience: resolve an agent's endpoint then POST to /dispute.
+ */
+async function notifyDispute(agentAddress, payload, provider, registryAddress = exports.DEFAULT_REGISTRY_ADDRESS) {
+    const endpoint = await resolveEndpoint(agentAddress, provider, registryAddress);
+    return notifyEndpoint(endpoint, "/dispute", payload);
+}
+/**
+ * Convenience: resolve an agent's endpoint then POST to /message.
+ */
+async function notifyMessage(agentAddress, payload, provider, registryAddress = exports.DEFAULT_REGISTRY_ADDRESS) {
+    const endpoint = await resolveEndpoint(agentAddress, provider, registryAddress);
+    return notifyEndpoint(endpoint, "/message", payload);
+}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { ARC402WalletClient, ARC402Wallet, type ContextBinding } from "./wallet";
+export { ARC402WalletClient as ARC402OperatorClient, ARC402Wallet as ARC402Operator } from "./wallet";
 export { ContractInteractionClient, type IntentPayload, type ContractCallAttestation, type ContractCallResult } from "./contractinteraction";
 export { PolicyClient, PolicyObject, PolicyValidator } from "./policy";
 export { TrustClient, TrustPrimitive } from "./trust";
@@ -27,5 +28,15 @@ export * from "./types";
 export { buildMetadata, validateMetadata, encodeMetadata, decodeMetadata, uploadMetadata, AGENT_METADATA_SCHEMA } from "./metadata";
 export type { AgentMetadata, AgentMetadataModel, AgentMetadataTraining, AgentMetadataPricing, AgentMetadataSla, AgentMetadataContact, AgentMetadataSecurity } from "./metadata";
 export { ColdStartClient } from "./coldstart";
+export { ComputeAgreementClient } from "./compute";
+export type { ComputeSession, ComputeUsageReport } from "./compute";
 export { MigrationClient } from "./migration";
+export { resolveEndpoint, notifyEndpoint, notifyHire, notifyHandshake, notifyHireAccepted, notifyDelivery, notifyDeliveryAccepted, notifyDispute, notifyMessage, DEFAULT_REGISTRY_ADDRESS } from "./endpoint";
+export type { EndpointNotifyResult } from "./endpoint";
+export { DeliveryClient, DEFAULT_DAEMON_URL } from "./delivery";
+export type { DeliveryFile, DeliveryManifest, DeliveryClientOptions } from "./delivery";
+export declare const COMPUTE_AGREEMENT_ADDRESS = "0x0e06afE90aAD3e0D91e217C46d98F049C2528AF7";
+export declare const SUBSCRIPTION_AGREEMENT_ADDRESS = "0xe1b6D3d0890E09582166EB450a78F6bff038CE5A";
+export declare const ARC402_REGISTRY_V2_ADDRESS = "0xcc0D8731ccCf6CFfF4e66F6d68cA86330Ea8B622";
+export declare const ARC402_REGISTRY_V3_ADDRESS = "0x6EafeD4FA103D2De04DDee157e35A8e8df91B6A6";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,KAAK,aAAa,EAAE,KAAK,uBAAuB,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7I,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC1Q,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAChJ,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpL,YAAY,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC9I,YAAY,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AACrH,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACvF,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACpI,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAChL,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,kBAAkB,IAAI,oBAAoB,EAAE,YAAY,IAAI,cAAc,EAAE,MAAM,UAAU,CAAC;AACtG,OAAO,EAAE,yBAAyB,EAAE,KAAK,aAAa,EAAE,KAAK,uBAAuB,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7I,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC1Q,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAChJ,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpL,YAAY,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC9I,YAAY,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AACrH,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACvF,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACpI,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAChL,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,kBAAkB,EAAE,cAAc,EAAE,sBAAsB,EAAE,aAAa,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAC9M,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxF,eAAO,MAAM,yBAAyB,+CAA+C,CAAC;AACtF,eAAO,MAAM,8BAA8B,+CAA+C,CAAC;AAC3F,eAAO,MAAM,0BAA0B,+CAA+C,CAAC;AACvF,eAAO,MAAM,0BAA0B,+CAA+C,CAAC"}

package/dist/index.js

@@ -14,10 +14,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MigrationClient = exports.ColdStartClient = exports.AGENT_METADATA_SCHEMA = exports.uploadMetadata = exports.decodeMetadata = exports.encodeMetadata = exports.validateMetadata = exports.buildMetadata = exports.uploadEncryptedIPFS = exports.decryptDeliverable = exports.encryptDeliverable = exports.uploadToIPFS = exports.hashDeliverableFile = exports.hashDeliverable = exports.DeliverableType = exports.DeliverableClient = exports.WatchtowerClient = exports.AgreementTreeClient = exports.ChannelClient = exports.SessionManager = exports.NegotiationGuard = exports.parseNegotiationMessage = exports.createNegotiationReject = exports.createNegotiationAccept = exports.createNegotiationCounter = exports.createNegotiationProposal = exports.createSignedReject = exports.createSignedAccept = exports.createSignedCounter = exports.createSignedProposal = exports.signNegotiationMessage = exports.GovernanceClient = exports.CapabilityRegistryClient = exports.SponsorshipAttestationClient = exports.ReputationOracleClient = exports.DisputeArbitrationClient = exports.ServiceAgreementClient = exports.AgentRegistryClient = exports.MultiAgentSettlement = exports.SettlementClient = exports.IntentAttestation = exports.IntentAttestationClient = exports.TrustPrimitive = exports.TrustClient = exports.PolicyValidator = exports.PolicyObject = exports.PolicyClient = exports.ContractInteractionClient = exports.ARC402Wallet = exports.ARC402WalletClient = void 0;
+exports.AGENT_METADATA_SCHEMA = exports.uploadMetadata = exports.decodeMetadata = exports.encodeMetadata = exports.validateMetadata = exports.buildMetadata = exports.uploadEncryptedIPFS = exports.decryptDeliverable = exports.encryptDeliverable = exports.uploadToIPFS = exports.hashDeliverableFile = exports.hashDeliverable = exports.DeliverableType = exports.DeliverableClient = exports.WatchtowerClient = exports.AgreementTreeClient = exports.ChannelClient = exports.SessionManager = exports.NegotiationGuard = exports.parseNegotiationMessage = exports.createNegotiationReject = exports.createNegotiationAccept = exports.createNegotiationCounter = exports.createNegotiationProposal = exports.createSignedReject = exports.createSignedAccept = exports.createSignedCounter = exports.createSignedProposal = exports.signNegotiationMessage = exports.GovernanceClient = exports.CapabilityRegistryClient = exports.SponsorshipAttestationClient = exports.ReputationOracleClient = exports.DisputeArbitrationClient = exports.ServiceAgreementClient = exports.AgentRegistryClient = exports.MultiAgentSettlement = exports.SettlementClient = exports.IntentAttestation = exports.IntentAttestationClient = exports.TrustPrimitive = exports.TrustClient = exports.PolicyValidator = exports.PolicyObject = exports.PolicyClient = exports.ContractInteractionClient = exports.ARC402Operator = exports.ARC402OperatorClient = exports.ARC402Wallet = exports.ARC402WalletClient = void 0;
+exports.ARC402_REGISTRY_V3_ADDRESS = exports.ARC402_REGISTRY_V2_ADDRESS = exports.SUBSCRIPTION_AGREEMENT_ADDRESS = exports.COMPUTE_AGREEMENT_ADDRESS = exports.DEFAULT_DAEMON_URL = exports.DeliveryClient = exports.DEFAULT_REGISTRY_ADDRESS = exports.notifyMessage = exports.notifyDispute = exports.notifyDeliveryAccepted = exports.notifyDelivery = exports.notifyHireAccepted = exports.notifyHandshake = exports.notifyHire = exports.notifyEndpoint = exports.resolveEndpoint = exports.MigrationClient = exports.ComputeAgreementClient = exports.ColdStartClient = void 0;
 var wallet_1 = require("./wallet");
 Object.defineProperty(exports, "ARC402WalletClient", { enumerable: true, get: function () { return wallet_1.ARC402WalletClient; } });
 Object.defineProperty(exports, "ARC402Wallet", { enumerable: true, get: function () { return wallet_1.ARC402Wallet; } });
+var wallet_2 = require("./wallet");
+Object.defineProperty(exports, "ARC402OperatorClient", { enumerable: true, get: function () { return wallet_2.ARC402WalletClient; } });
+Object.defineProperty(exports, "ARC402Operator", { enumerable: true, get: function () { return wallet_2.ARC402Wallet; } });
 var contractinteraction_1 = require("./contractinteraction");
 Object.defineProperty(exports, "ContractInteractionClient", { enumerable: true, get: function () { return contractinteraction_1.ContractInteractionClient; } });
 var policy_1 = require("./policy");
@@ -88,5 +92,26 @@ Object.defineProperty(exports, "uploadMetadata", { enumerable: true, get: functi
 Object.defineProperty(exports, "AGENT_METADATA_SCHEMA", { enumerable: true, get: function () { return metadata_1.AGENT_METADATA_SCHEMA; } });
 var coldstart_1 = require("./coldstart");
 Object.defineProperty(exports, "ColdStartClient", { enumerable: true, get: function () { return coldstart_1.ColdStartClient; } });
+var compute_1 = require("./compute");
+Object.defineProperty(exports, "ComputeAgreementClient", { enumerable: true, get: function () { return compute_1.ComputeAgreementClient; } });
 var migration_1 = require("./migration");
 Object.defineProperty(exports, "MigrationClient", { enumerable: true, get: function () { return migration_1.MigrationClient; } });
+var endpoint_1 = require("./endpoint");
+Object.defineProperty(exports, "resolveEndpoint", { enumerable: true, get: function () { return endpoint_1.resolveEndpoint; } });
+Object.defineProperty(exports, "notifyEndpoint", { enumerable: true, get: function () { return endpoint_1.notifyEndpoint; } });
+Object.defineProperty(exports, "notifyHire", { enumerable: true, get: function () { return endpoint_1.notifyHire; } });
+Object.defineProperty(exports, "notifyHandshake", { enumerable: true, get: function () { return endpoint_1.notifyHandshake; } });
+Object.defineProperty(exports, "notifyHireAccepted", { enumerable: true, get: function () { return endpoint_1.notifyHireAccepted; } });
+Object.defineProperty(exports, "notifyDelivery", { enumerable: true, get: function () { return endpoint_1.notifyDelivery; } });
+Object.defineProperty(exports, "notifyDeliveryAccepted", { enumerable: true, get: function () { return endpoint_1.notifyDeliveryAccepted; } });
+Object.defineProperty(exports, "notifyDispute", { enumerable: true, get: function () { return endpoint_1.notifyDispute; } });
+Object.defineProperty(exports, "notifyMessage", { enumerable: true, get: function () { return endpoint_1.notifyMessage; } });
+Object.defineProperty(exports, "DEFAULT_REGISTRY_ADDRESS", { enumerable: true, get: function () { return endpoint_1.DEFAULT_REGISTRY_ADDRESS; } });
+var delivery_1 = require("./delivery");
+Object.defineProperty(exports, "DeliveryClient", { enumerable: true, get: function () { return delivery_1.DeliveryClient; } });
+Object.defineProperty(exports, "DEFAULT_DAEMON_URL", { enumerable: true, get: function () { return delivery_1.DEFAULT_DAEMON_URL; } });
+// Base Mainnet contract addresses
+exports.COMPUTE_AGREEMENT_ADDRESS = "0x0e06afE90aAD3e0D91e217C46d98F049C2528AF7";
+exports.SUBSCRIPTION_AGREEMENT_ADDRESS = "0xe1b6D3d0890E09582166EB450a78F6bff038CE5A";
+exports.ARC402_REGISTRY_V2_ADDRESS = "0xcc0D8731ccCf6CFfF4e66F6d68cA86330Ea8B622";
+exports.ARC402_REGISTRY_V3_ADDRESS = "0x6EafeD4FA103D2De04DDee157e35A8e8df91B6A6";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arc402/sdk",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "ARC-402 typed TypeScript SDK for discovery, negotiation, trust, and governed settlement",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/compute.ts

@@ -0,0 +1,139 @@
+import { ethers, ContractTransactionResponse } from "ethers";
+
+// ─── ABI ──────────────────────────────────────────────────────────────────────
+
+const COMPUTE_AGREEMENT_ABI = [
+  "function proposeSession(bytes32 sessionId, address provider, uint256 ratePerHour, uint256 maxHours, bytes32 gpuSpecHash, address token) external payable",
+  "function acceptSession(bytes32 sessionId) external",
+  "function startSession(bytes32 sessionId) external",
+  "function submitUsageReport(bytes32 sessionId, uint256 periodStart, uint256 periodEnd, uint256 computeMinutes, uint256 avgUtilization, bytes providerSignature, bytes32 metricsHash) external",
+  "function endSession(bytes32 sessionId) external",
+  "function disputeSession(bytes32 sessionId) external",
+  "function cancelSession(bytes32 sessionId) external",
+  "function resolveDispute(bytes32 sessionId, uint256 providerAmount, uint256 clientAmount) external",
+  "function claimDisputeTimeout(bytes32 sessionId) external",
+  "function withdraw(address token) external",
+  "function getSession(bytes32 sessionId) external view returns (tuple(address client, address provider, address token, uint256 ratePerHour, uint256 maxHours, uint256 depositAmount, uint256 startedAt, uint256 endedAt, uint256 consumedMinutes, uint256 proposedAt, uint256 disputedAt, bytes32 gpuSpecHash, uint8 status))",
+  "function calculateCost(bytes32 sessionId) external view returns (uint256)",
+  "function getUsageReports(bytes32 sessionId) external view returns (tuple(uint256 periodStart, uint256 periodEnd, uint256 computeMinutes, uint256 avgUtilization, bytes providerSignature, bytes32 metricsHash)[])",
+  "function pendingWithdrawals(address user, address token) external view returns (uint256)",
+];
+
+// ─── Types ────────────────────────────────────────────────────────────────────
+
+export interface ComputeSession {
+  client: string;
+  provider: string;
+  token: string;
+  ratePerHour: bigint;
+  maxHours: bigint;
+  depositAmount: bigint;
+  startedAt: bigint;
+  endedAt: bigint;
+  consumedMinutes: bigint;
+  proposedAt: bigint;
+  disputedAt: bigint;
+  gpuSpecHash: string;
+  status: number;
+}
+
+export interface ComputeUsageReport {
+  periodStart: bigint;
+  periodEnd: bigint;
+  computeMinutes: bigint;
+  avgUtilization: bigint;
+  providerSignature: string;
+  metricsHash: string;
+}
+
+// ─── Client ───────────────────────────────────────────────────────────────────
+
+export class ComputeAgreementClient {
+  private contract: ethers.Contract;
+
+  constructor(contractAddress: string, signerOrProvider: ethers.Signer | ethers.Provider) {
+    this.contract = new ethers.Contract(contractAddress, COMPUTE_AGREEMENT_ABI, signerOrProvider);
+  }
+
+  async proposeSession(
+    sessionId: string,
+    provider: string,
+    ratePerHour: bigint,
+    maxHours: bigint,
+    gpuSpecHash: string,
+    token: string,
+    deposit: bigint,
+  ): Promise<ContractTransactionResponse> {
+    const isEth = token === ethers.ZeroAddress;
+    return this.contract.proposeSession(
+      sessionId, provider, ratePerHour, maxHours, gpuSpecHash, token,
+      { value: isEth ? deposit : 0n },
+    ) as Promise<ContractTransactionResponse>;
+  }
+
+  async acceptSession(sessionId: string): Promise<ContractTransactionResponse> {
+    return this.contract.acceptSession(sessionId) as Promise<ContractTransactionResponse>;
+  }
+
+  async startSession(sessionId: string): Promise<ContractTransactionResponse> {
+    return this.contract.startSession(sessionId) as Promise<ContractTransactionResponse>;
+  }
+
+  async submitUsageReport(
+    sessionId: string,
+    periodStart: bigint,
+    periodEnd: bigint,
+    computeMinutes: bigint,
+    avgUtilization: bigint,
+    providerSignature: string,
+    metricsHash: string,
+  ): Promise<ContractTransactionResponse> {
+    return this.contract.submitUsageReport(
+      sessionId, periodStart, periodEnd, computeMinutes, avgUtilization, providerSignature, metricsHash,
+    ) as Promise<ContractTransactionResponse>;
+  }
+
+  async endSession(sessionId: string): Promise<ContractTransactionResponse> {
+    return this.contract.endSession(sessionId) as Promise<ContractTransactionResponse>;
+  }
+
+  async disputeSession(sessionId: string): Promise<ContractTransactionResponse> {
+    return this.contract.disputeSession(sessionId) as Promise<ContractTransactionResponse>;
+  }
+
+  async cancelSession(sessionId: string): Promise<ContractTransactionResponse> {
+    return this.contract.cancelSession(sessionId) as Promise<ContractTransactionResponse>;
+  }
+
+  async resolveDispute(
+    sessionId: string,
+    providerAmount: bigint,
+    clientAmount: bigint,
+  ): Promise<ContractTransactionResponse> {
+    return this.contract.resolveDispute(sessionId, providerAmount, clientAmount) as Promise<ContractTransactionResponse>;
+  }
+
+  async claimDisputeTimeout(sessionId: string): Promise<ContractTransactionResponse> {
+    return this.contract.claimDisputeTimeout(sessionId) as Promise<ContractTransactionResponse>;
+  }
+
+  async withdraw(token: string): Promise<ContractTransactionResponse> {
+    return this.contract.withdraw(token) as Promise<ContractTransactionResponse>;
+  }
+
+  async getSession(sessionId: string): Promise<ComputeSession> {
+    return this.contract.getSession(sessionId) as Promise<ComputeSession>;
+  }
+
+  async calculateCost(sessionId: string): Promise<bigint> {
+    return this.contract.calculateCost(sessionId) as Promise<bigint>;
+  }
+
+  async getUsageReports(sessionId: string): Promise<ComputeUsageReport[]> {
+    return this.contract.getUsageReports(sessionId) as Promise<ComputeUsageReport[]>;
+  }
+
+  async pendingWithdrawals(user: string, token: string): Promise<bigint> {
+    return this.contract.pendingWithdrawals(user, token) as Promise<bigint>;
+  }
+}

package/src/delivery.ts

@@ -0,0 +1,153 @@
+/**
+ * File Delivery Layer — wraps daemon HTTP endpoints for content-addressed
+ * file delivery with party-gated access (EIP-191 signatures).
+ *
+ * Files are private by default. Only the keccak256 bundle hash is published
+ * on-chain. Downloads require a valid EIP-191 signature from either the hirer
+ * or the provider. Arbitrators receive a time-limited token for dispute access.
+ *
+ * Daemon endpoints:
+ *   POST /job/:id/upload          — upload a deliverable file
+ *   GET  /job/:id/files           — list all delivered files
+ *   GET  /job/:id/files/:name     — download a specific file
+ *   GET  /job/:id/manifest        — fetch the delivery manifest
+ */
+import { ethers } from "ethers";
+import { mkdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+
+export const DEFAULT_DAEMON_URL = "http://localhost:4402";
+
+export interface DeliveryFile {
+  name: string;
+  hash: string;  // keccak256 hex
+  size: number;
+}
+
+export interface DeliveryManifest {
+  agreementId: string;
+  files: DeliveryFile[];
+  bundleHash: string;  // keccak256 of the full manifest — matches on-chain deliverableHash
+}
+
+export interface DeliveryClientOptions {
+  /** Daemon base URL. Defaults to http://localhost:4402. */
+  daemonUrl?: string;
+}
+
+export class DeliveryClient {
+  private daemonUrl: string;
+
+  constructor(options?: DeliveryClientOptions) {
+    this.daemonUrl = (options?.daemonUrl ?? DEFAULT_DAEMON_URL).replace(/\/$/, "");
+  }
+
+  /** Sign the standard auth message for a job. Used for upload and download. */
+  private async signAuth(agreementId: bigint | string, signer: ethers.Signer): Promise<string> {
+    return signer.signMessage(`arc402:job:${agreementId}`);
+  }
+
+  /**
+   * Upload a file as a deliverable for the agreement.
+   * Returns the file entry recorded by the daemon (name, keccak256 hash, size).
+   * Auth: EIP-191 signature from the provider's signer.
+   *
+   * After uploading all files, commit the manifest bundleHash on-chain via
+   * ServiceAgreementClient.commitDeliverable(). The CLI does this automatically
+   * when you run `arc402 deliver <id>`.
+   */
+  async uploadDeliverable(
+    agreementId: bigint | string,
+    filePath: string,
+    signer: ethers.Signer,
+  ): Promise<DeliveryFile> {
+    const signature = await this.signAuth(agreementId, signer);
+    const address = await signer.getAddress();
+    const filename = path.basename(filePath);
+    const fileBuffer = await readFile(filePath);
+    const form = new FormData();
+    form.append("file", new Blob([fileBuffer]), filename);
+    form.append("address", address);
+    form.append("signature", signature);
+    const res = await fetch(`${this.daemonUrl}/job/${agreementId}/upload`, {
+      method: "POST",
+      body: form,
+    });
+    if (!res.ok) throw new Error(`Upload failed: ${res.status} ${res.statusText}`);
+    return (await res.json()) as DeliveryFile;
+  }
+
+  /**
+   * Download a named file from the agreement's delivery.
+   * Writes the file to <outputDir>/<name> and returns the output path.
+   * Auth: EIP-191 signature from the hirer's or provider's signer.
+   */
+  async downloadDeliverable(
+    agreementId: bigint | string,
+    fileName: string,
+    outputDir: string,
+    signer: ethers.Signer,
+  ): Promise<string> {
+    const signature = await this.signAuth(agreementId, signer);
+    const address = await signer.getAddress();
+    const res = await fetch(
+      `${this.daemonUrl}/job/${agreementId}/files/${encodeURIComponent(fileName)}`,
+      { headers: { "X-Arc402-Address": address, "X-Arc402-Signature": signature } },
+    );
+    if (!res.ok) throw new Error(`Download failed: ${res.status} ${res.statusText}`);
+    const buffer = Buffer.from(await res.arrayBuffer());
+    await mkdir(outputDir, { recursive: true });
+    const outPath = path.join(outputDir, fileName);
+    await writeFile(outPath, buffer);
+    return outPath;
+  }
+
+  /**
+   * Fetch the delivery manifest for an agreement.
+   * Lists all delivered files with their keccak256 hashes and the overall bundleHash.
+   * Auth: EIP-191 signature from the hirer's or provider's signer.
+   */
+  async getManifest(agreementId: bigint | string, signer: ethers.Signer): Promise<DeliveryManifest> {
+    const signature = await this.signAuth(agreementId, signer);
+    const address = await signer.getAddress();
+    const res = await fetch(
+      `${this.daemonUrl}/job/${agreementId}/manifest`,
+      { headers: { "X-Arc402-Address": address, "X-Arc402-Signature": signature } },
+    );
+    if (!res.ok) throw new Error(`Manifest fetch failed: ${res.status} ${res.statusText}`);
+    return (await res.json()) as DeliveryManifest;
+  }
+
+  /**
+   * Download all files and verify their keccak256 hashes against the manifest.
+   * Also checks that the manifest bundleHash matches the expectedBundleHash
+   * (which should equal the value committed on-chain via commitDeliverable).
+   *
+   * Returns { ok: true } when all hashes match, or
+   * { ok: false, mismatches: [...] } listing any files that failed.
+   */
+  async verifyDelivery(
+    agreementId: bigint | string,
+    expectedBundleHash: string,
+    signer: ethers.Signer,
+    outputDir: string,
+  ): Promise<{ ok: boolean; mismatches: string[] }> {
+    const manifest = await this.getManifest(agreementId, signer);
+    if (manifest.bundleHash.toLowerCase() !== expectedBundleHash.toLowerCase()) {
+      return {
+        ok: false,
+        mismatches: [`bundleHash mismatch: expected ${expectedBundleHash}, got ${manifest.bundleHash}`],
+      };
+    }
+    const mismatches: string[] = [];
+    for (const file of manifest.files) {
+      const outPath = await this.downloadDeliverable(agreementId, file.name, outputDir, signer);
+      const buffer = await readFile(outPath);
+      const localHash = ethers.keccak256(buffer);
+      if (localHash.toLowerCase() !== file.hash.toLowerCase()) {
+        mismatches.push(`${file.name}: expected ${file.hash}, got ${localHash}`);
+      }
+    }
+    return { ok: mismatches.length === 0, mismatches };
+  }
+}

package/src/index.ts

@@ -28,6 +28,16 @@ export * from "./types";
 export { buildMetadata, validateMetadata, encodeMetadata, decodeMetadata, uploadMetadata, AGENT_METADATA_SCHEMA } from "./metadata";
 export type { AgentMetadata, AgentMetadataModel, AgentMetadataTraining, AgentMetadataPricing, AgentMetadataSla, AgentMetadataContact, AgentMetadataSecurity } from "./metadata";
 export { ColdStartClient } from "./coldstart";
+export { ComputeAgreementClient } from "./compute";
+export type { ComputeSession, ComputeUsageReport } from "./compute";
 export { MigrationClient } from "./migration";
 export { resolveEndpoint, notifyEndpoint, notifyHire, notifyHandshake, notifyHireAccepted, notifyDelivery, notifyDeliveryAccepted, notifyDispute, notifyMessage, DEFAULT_REGISTRY_ADDRESS } from "./endpoint";
 export type { EndpointNotifyResult } from "./endpoint";
+export { DeliveryClient, DEFAULT_DAEMON_URL } from "./delivery";
+export type { DeliveryFile, DeliveryManifest, DeliveryClientOptions } from "./delivery";
+
+// Base Mainnet contract addresses
+export const COMPUTE_AGREEMENT_ADDRESS = "0x0e06afE90aAD3e0D91e217C46d98F049C2528AF7";
+export const SUBSCRIPTION_AGREEMENT_ADDRESS = "0xe1b6D3d0890E09582166EB450a78F6bff038CE5A";
+export const ARC402_REGISTRY_V2_ADDRESS = "0xcc0D8731ccCf6CFfF4e66F6d68cA86330Ea8B622";
+export const ARC402_REGISTRY_V3_ADDRESS = "0x6EafeD4FA103D2De04DDee157e35A8e8df91B6A6";