@arc402/sdk 0.2.0

package/dist/deliverable.d.ts

@@ -0,0 +1,118 @@
+import { ContractRunner, ethers } from "ethers";
+export declare enum DeliverableType {
+    text = "text",
+    code = "code",
+    data = "data",
+    media = "media",
+    api = "api",
+    composite = "composite",
+    null = "null"
+}
+export interface DeliverableManifestEntry {
+    path: string;
+    hash: string;
+    size: number;
+    type?: DeliverableType;
+}
+export interface DeliverableManifest {
+    type: DeliverableType.composite;
+    version: string;
+    files: DeliverableManifestEntry[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * The encrypted structure returned by encryptDeliverable.
+ * encryptedBuffer contains the nonce (24 bytes) followed by the box ciphertext.
+ * ephemeralPublicKey is the sender's one-time public key; the recipient needs it
+ * along with their own private key to decrypt.
+ */
+export interface EncryptedDeliverable {
+    encryptedBuffer: Buffer;
+    ephemeralPublicKey: Uint8Array;
+}
+/**
+ * Encrypt a buffer for a recipient using NaCl box (X25519-XSalsa20-Poly1305).
+ * An ephemeral keypair is generated per call so encryptions are unlinkable.
+ */
+export declare function encryptDeliverable(buffer: Buffer, recipientPublicKey: Uint8Array): Promise<EncryptedDeliverable>;
+/**
+ * Decrypt a buffer produced by encryptDeliverable.
+ * secretKey is the recipient's NaCl box secret key (32 bytes).
+ */
+export declare function decryptDeliverable(encryptedBuffer: Buffer, ephemeralPublicKey: Uint8Array, secretKey: Uint8Array): Promise<Buffer>;
+export interface IPFSUploadOptions {
+    /** IPFS HTTP API base URL. Defaults to https://ipfs.io/api/v0.
+     *  Override with a pinning service endpoint (e.g. Infura, Pinata) for persistence. */
+    apiEndpoint?: string;
+}
+export interface IPFSUploadResult {
+    cid: string;
+    uri: string;
+}
+/** Compute keccak256 over arbitrary bytes. Returns 0x-prefixed hex. */
+export declare function hashDeliverable(buffer: Buffer): Promise<string>;
+/** Read a file and return its keccak256 hash. */
+export declare function hashDeliverableFile(filePath: string): Promise<string>;
+/**
+ * Upload a buffer to IPFS via the HTTP API.
+ * Returns the CID and an ipfs:// URI.
+ *
+ * The default endpoint (https://ipfs.io/api/v0) is a public gateway — it may
+ * not persist content long-term. Pass a dedicated pinning service endpoint via
+ * options.apiEndpoint for production use.
+ */
+export declare function uploadToIPFS(buffer: Buffer, options?: IPFSUploadOptions): Promise<IPFSUploadResult>;
+/**
+ * Encrypt a buffer with the recipient's public key, then upload the packed
+ * ciphertext to IPFS.  The IPFS blob format is:
+ *   magic "ARC1" (4 bytes) | ephemeral public key (32 bytes) | nonce (24 bytes) | ciphertext
+ * This self-contained layout lets the recipient recover all decryption inputs
+ * from the CID alone (plus their own private key).
+ */
+export declare function uploadEncryptedIPFS(buffer: Buffer, recipientPublicKey: Uint8Array, options?: IPFSUploadOptions): Promise<IPFSUploadResult>;
+export declare class DeliverableClient {
+    private contract;
+    constructor(address: string, runner: ContractRunner);
+    /** Compute keccak256 over a buffer. Returns 0x-prefixed hex. */
+    hashDeliverable(buffer: Buffer): Promise<string>;
+    /** Read a file and return its keccak256 hash. */
+    hashDeliverableFile(filePath: string): Promise<string>;
+    /**
+     * Commit a deliverable hash on-chain via ServiceAgreement.commitDeliverable().
+     * metadataURI is accepted for caller convenience but is not forwarded to the
+     * contract (the current ABI takes only agreementId + hash).
+     */
+    commitDeliverable(agreementId: bigint, hash: string, metadataURI: string, signer?: ContractRunner): Promise<ethers.TransactionReceipt | null>;
+    /**
+     * Fetch the on-chain committed hash and compare it against a local buffer.
+     * Does NOT release escrow — call ServiceAgreementClient.verifyDeliverable()
+     * separately once satisfied.
+     */
+    verifyDeliverable(agreementId: bigint, localBuffer: Buffer, signer?: ContractRunner): Promise<{
+        match: boolean;
+        onChainHash: string;
+        localHash: string;
+    }>;
+    /** Upload a buffer to IPFS. See uploadToIPFS for endpoint notes. */
+    uploadToIPFS(buffer: Buffer, options?: IPFSUploadOptions): Promise<IPFSUploadResult>;
+    /**
+     * Upload buffer to IPFS then commit the hash + URI in one call.
+     * Returns the committed hash, IPFS URI, and the on-chain transaction receipt.
+     */
+    commitDeliverableIPFS(agreementId: bigint, buffer: Buffer, options?: IPFSUploadOptions, signer?: ContractRunner): Promise<{
+        hash: string;
+        uri: string;
+        receipt: ethers.TransactionReceipt;
+    }>;
+    /**
+     * Encrypt buffer for recipientPublicKey, upload the ciphertext to IPFS, then
+     * commit the plaintext hash on-chain.  The on-chain hash covers plaintext so
+     * the client can verify integrity after decryption.
+     */
+    commitDeliverableIPFSEncrypted(agreementId: bigint, buffer: Buffer, recipientPublicKey: Uint8Array, options?: IPFSUploadOptions, signer?: ContractRunner): Promise<{
+        hash: string;
+        uri: string;
+        receipt: ethers.TransactionReceipt;
+    }>;
+}
+//# sourceMappingURL=deliverable.d.ts.map

package/dist/deliverable.d.ts.map

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

package/dist/deliverable.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliverableClient = exports.DeliverableType = void 0;
+exports.encryptDeliverable = encryptDeliverable;
+exports.decryptDeliverable = decryptDeliverable;
+exports.hashDeliverable = hashDeliverable;
+exports.hashDeliverableFile = hashDeliverableFile;
+exports.uploadToIPFS = uploadToIPFS;
+exports.uploadEncryptedIPFS = uploadEncryptedIPFS;
+const ethers_1 = require("ethers");
+const promises_1 = require("fs/promises");
+const tweetnacl_1 = __importDefault(require("tweetnacl"));
+const contracts_1 = require("./contracts");
+// ─── Deliverable Types ────────────────────────────────────────────────────────
+var DeliverableType;
+(function (DeliverableType) {
+    DeliverableType["text"] = "text";
+    DeliverableType["code"] = "code";
+    DeliverableType["data"] = "data";
+    DeliverableType["media"] = "media";
+    DeliverableType["api"] = "api";
+    DeliverableType["composite"] = "composite";
+    DeliverableType["null"] = "null";
+})(DeliverableType || (exports.DeliverableType = DeliverableType = {}));
+/**
+ * Encrypt a buffer for a recipient using NaCl box (X25519-XSalsa20-Poly1305).
+ * An ephemeral keypair is generated per call so encryptions are unlinkable.
+ */
+async function encryptDeliverable(buffer, recipientPublicKey) {
+    const ephemeralKeyPair = tweetnacl_1.default.box.keyPair();
+    const nonce = tweetnacl_1.default.randomBytes(tweetnacl_1.default.box.nonceLength);
+    const ciphertext = tweetnacl_1.default.box(buffer, nonce, recipientPublicKey, ephemeralKeyPair.secretKey);
+    const encryptedBuffer = Buffer.concat([Buffer.from(nonce), Buffer.from(ciphertext)]);
+    return { encryptedBuffer, ephemeralPublicKey: ephemeralKeyPair.publicKey };
+}
+/**
+ * Decrypt a buffer produced by encryptDeliverable.
+ * secretKey is the recipient's NaCl box secret key (32 bytes).
+ */
+async function decryptDeliverable(encryptedBuffer, ephemeralPublicKey, secretKey) {
+    const nonce = encryptedBuffer.subarray(0, tweetnacl_1.default.box.nonceLength);
+    const ciphertext = encryptedBuffer.subarray(tweetnacl_1.default.box.nonceLength);
+    const plaintext = tweetnacl_1.default.box.open(ciphertext, nonce, ephemeralPublicKey, secretKey);
+    if (!plaintext)
+        throw new Error("Decryption failed: invalid ciphertext or wrong keys");
+    return Buffer.from(plaintext);
+}
+// ─── Standalone functions ─────────────────────────────────────────────────────
+/** Compute keccak256 over arbitrary bytes. Returns 0x-prefixed hex. */
+async function hashDeliverable(buffer) {
+    return ethers_1.ethers.keccak256(buffer);
+}
+/** Read a file and return its keccak256 hash. */
+async function hashDeliverableFile(filePath) {
+    const buffer = await (0, promises_1.readFile)(filePath);
+    return hashDeliverable(buffer);
+}
+/**
+ * Upload a buffer to IPFS via the HTTP API.
+ * Returns the CID and an ipfs:// URI.
+ *
+ * The default endpoint (https://ipfs.io/api/v0) is a public gateway — it may
+ * not persist content long-term. Pass a dedicated pinning service endpoint via
+ * options.apiEndpoint for production use.
+ */
+async function uploadToIPFS(buffer, options) {
+    const apiEndpoint = options?.apiEndpoint ?? "https://ipfs.io/api/v0";
+    const form = new FormData();
+    form.append("file", new Blob([buffer]));
+    const response = await fetch(`${apiEndpoint}/add`, { method: "POST", body: form });
+    if (!response.ok)
+        throw new Error(`IPFS upload failed: ${response.status} ${response.statusText}`);
+    const data = (await response.json());
+    const cid = data.Hash;
+    return { cid, uri: `ipfs://${cid}` };
+}
+/**
+ * Encrypt a buffer with the recipient's public key, then upload the packed
+ * ciphertext to IPFS.  The IPFS blob format is:
+ *   magic "ARC1" (4 bytes) | ephemeral public key (32 bytes) | nonce (24 bytes) | ciphertext
+ * This self-contained layout lets the recipient recover all decryption inputs
+ * from the CID alone (plus their own private key).
+ */
+async function uploadEncryptedIPFS(buffer, recipientPublicKey, options) {
+    const { encryptedBuffer, ephemeralPublicKey } = await encryptDeliverable(buffer, recipientPublicKey);
+    const MAGIC = Buffer.from("ARC1");
+    const packed = Buffer.concat([MAGIC, Buffer.from(ephemeralPublicKey), encryptedBuffer]);
+    return uploadToIPFS(packed, options);
+}
+// ─── DeliverableClient ────────────────────────────────────────────────────────
+class DeliverableClient {
+    constructor(address, runner) {
+        this.contract = new ethers_1.ethers.Contract(address, contracts_1.SERVICE_AGREEMENT_ABI, runner);
+    }
+    /** Compute keccak256 over a buffer. Returns 0x-prefixed hex. */
+    async hashDeliverable(buffer) {
+        return hashDeliverable(buffer);
+    }
+    /** Read a file and return its keccak256 hash. */
+    async hashDeliverableFile(filePath) {
+        return hashDeliverableFile(filePath);
+    }
+    /**
+     * Commit a deliverable hash on-chain via ServiceAgreement.commitDeliverable().
+     * metadataURI is accepted for caller convenience but is not forwarded to the
+     * contract (the current ABI takes only agreementId + hash).
+     */
+    async commitDeliverable(agreementId, hash, metadataURI, signer) {
+        const contract = signer ? this.contract.connect(signer) : this.contract;
+        const tx = await contract.commitDeliverable(agreementId, hash);
+        return tx.wait();
+    }
+    /**
+     * Fetch the on-chain committed hash and compare it against a local buffer.
+     * Does NOT release escrow — call ServiceAgreementClient.verifyDeliverable()
+     * separately once satisfied.
+     */
+    async verifyDeliverable(agreementId, localBuffer, signer) {
+        const contract = signer ? this.contract.connect(signer) : this.contract;
+        const agreement = await contract.getAgreement(agreementId);
+        const onChainHash = agreement.deliverableHash;
+        const localHash = await hashDeliverable(localBuffer);
+        const match = onChainHash.toLowerCase() === localHash.toLowerCase();
+        return { match, onChainHash, localHash };
+    }
+    /** Upload a buffer to IPFS. See uploadToIPFS for endpoint notes. */
+    async uploadToIPFS(buffer, options) {
+        return uploadToIPFS(buffer, options);
+    }
+    /**
+     * Upload buffer to IPFS then commit the hash + URI in one call.
+     * Returns the committed hash, IPFS URI, and the on-chain transaction receipt.
+     */
+    async commitDeliverableIPFS(agreementId, buffer, options, signer) {
+        const [hash, { uri }] = await Promise.all([hashDeliverable(buffer), uploadToIPFS(buffer, options)]);
+        const receipt = await this.commitDeliverable(agreementId, hash, uri, signer);
+        return { hash, uri, receipt };
+    }
+    /**
+     * Encrypt buffer for recipientPublicKey, upload the ciphertext to IPFS, then
+     * commit the plaintext hash on-chain.  The on-chain hash covers plaintext so
+     * the client can verify integrity after decryption.
+     */
+    async commitDeliverableIPFSEncrypted(agreementId, buffer, recipientPublicKey, options, signer) {
+        const [hash, { uri }] = await Promise.all([
+            hashDeliverable(buffer),
+            uploadEncryptedIPFS(buffer, recipientPublicKey, options),
+        ]);
+        const receipt = await this.commitDeliverable(agreementId, hash, uri, signer);
+        return { hash, uri, receipt };
+    }
+}
+exports.DeliverableClient = DeliverableClient;

package/dist/dispute-arbitration.d.ts

@@ -0,0 +1,42 @@
+import { ContractRunner, ethers } from "ethers";
+import { ArbitratorBondState, DisputeClass, DisputeFeeState, DisputeMode } from "./types";
+export declare class DisputeArbitrationClient {
+    private contract;
+    constructor(address: string, runner: ContractRunner);
+    getDisputeFeeState(agreementId: bigint): Promise<DisputeFeeState>;
+    getArbitratorBondState(arbitrator: string, agreementId: bigint): Promise<ArbitratorBondState>;
+    getFeeQuote(agreementPrice: bigint, token: string, mode: DisputeMode, disputeClass: DisputeClass): Promise<bigint>;
+    getAcceptedArbitrators(agreementId: bigint): Promise<string[]>;
+    isEligibleArbitrator(address: string): Promise<boolean>;
+    getTokenUsdRate(token: string): Promise<bigint>;
+    /** Respondent in MUTUAL dispute funds their half of the fee. */
+    joinMutualDispute(agreementId: bigint, halfFeeEth?: bigint): Promise<ethers.TransactionReceipt>;
+    /** Nominated arbitrator accepts assignment and posts bond. */
+    acceptAssignment(agreementId: bigint, bondEth?: bigint): Promise<ethers.TransactionReceipt>;
+    /** Trigger fallback to human backstop queue (mutual unfunded or panel not formed). */
+    triggerFallback(agreementId: bigint): Promise<ethers.TransactionReceipt>;
+    /** Owner-only: slash an arbitrator for manual rules violation. */
+    slashArbitrator(agreementId: bigint, arbitrator: string, reason: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Arbitrators can reclaim their bond after 45 days if the dispute was never resolved via resolveDisputeFee.
+     * Prevents permanent bond lock on stalled disputes.
+     */
+    reclaimExpiredBond(agreementId: bigint): Promise<ethers.TransactionReceipt>;
+    /** Step 1 of two-step ownership transfer. Owner-only. */
+    proposeOwner(newOwner: string): Promise<ethers.TransactionReceipt>;
+    /** Step 2 of two-step ownership transfer. Must be called by the pending owner. */
+    acceptOwnership(): Promise<ethers.TransactionReceipt>;
+    /**
+     * Set the USD rate for a payment token. Owner only.
+     * @param token Token address (address(0) for ETH)
+     * @param usdRate18 USD per token with 18 decimals (e.g. 2000e18 for ETH at $2000)
+     * IMPORTANT: This is an admin-set rate, not a trustless oracle. Keep it current.
+     */
+    setTokenUsdRate(token: string, usdRate18: bigint): Promise<ethers.TransactionReceipt>;
+    setFeeFloorUsd(floorUsd18: bigint): Promise<ethers.TransactionReceipt>;
+    setFeeCapUsd(capUsd18: bigint): Promise<ethers.TransactionReceipt>;
+    setServiceAgreement(address: string): Promise<ethers.TransactionReceipt>;
+    setTrustRegistry(address: string): Promise<ethers.TransactionReceipt>;
+    setTreasury(address: string): Promise<ethers.TransactionReceipt>;
+}
+//# sourceMappingURL=dispute-arbitration.d.ts.map

package/dist/dispute-arbitration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispute-arbitration.d.ts","sourceRoot":"","sources":["../src/dispute-arbitration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAwC1F,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc;IAM7C,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAmBjE,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAW7F,WAAW,CACf,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,MAAM,CAAC;IAIZ,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI9D,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMrD,gEAAgE;IAC1D,iBAAiB,CACrB,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAKrC,8DAA8D;IACxD,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,MAAW,GACnB,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAKrC,sFAAsF;IAChF,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAK9E,kEAAkE;IAC5D,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAKrC;;;OAGG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAKjF,yDAAyD;IACnD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAKxE,kFAAkF;IAC5E,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAO3D;;;;;OAKG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAKrF,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAKtE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAKlE,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAKxE,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAKrE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;CAIvE"}

package/dist/dispute-arbitration.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DisputeArbitrationClient = void 0;
+const ethers_1 = require("ethers");
+const DISPUTE_ARBITRATION_ABI = [
+    // Views
+    "function getDisputeFeeState(uint256 agreementId) view returns (tuple(uint8 mode, uint8 disputeClass, address opener, address client, address provider, address token, uint256 agreementPrice, uint256 feeRequired, uint256 openerPaid, uint256 respondentPaid, uint256 openedAt, bool active, bool resolved))",
+    "function getArbitratorBondState(address arbitrator, uint256 agreementId) view returns (tuple(uint256 bondAmount, uint256 lockedAt, bool locked, bool slashed, bool returned))",
+    "function getFeeQuote(uint256 agreementPrice, address token, uint8 mode, uint8 disputeClass) view returns (uint256 feeInTokens)",
+    "function getAcceptedArbitrators(uint256 agreementId) view returns (address[])",
+    "function isEligibleArbitrator(address arbitrator) view returns (bool)",
+    "function tokenUsdRate18(address token) view returns (uint256)",
+    "function feeFloorUsd18() view returns (uint256)",
+    "function feeCapUsd18() view returns (uint256)",
+    "function minBondFloorUsd18() view returns (uint256)",
+    // Transactions
+    "function joinMutualDispute(uint256 agreementId) payable",
+    "function acceptAssignment(uint256 agreementId) payable",
+    "function triggerFallback(uint256 agreementId) returns (bool)",
+    "function slashArbitrator(uint256 agreementId, address arbitrator, string reason)",
+    "function reclaimExpiredBond(uint256 agreementId)",
+    "function transferOwnership(address newOwner)",
+    "function acceptOwnership()",
+    "function setTokenUsdRate(address token, uint256 usdRate18)",
+    "function setFeeFloorUsd(uint256 floorUsd18)",
+    "function setFeeCapUsd(uint256 capUsd18)",
+    "function setMinBondFloorUsd(uint256 floorUsd18)",
+    "function setServiceAgreement(address sa)",
+    "function setTrustRegistry(address tr)",
+    "function setTreasury(address treasury)",
+    // Events
+    "event DisputeFeeOpened(uint256 indexed agreementId, uint8 mode, uint8 disputeClass, uint256 feeRequired, address token)",
+    "event MutualDisputeFunded(uint256 indexed agreementId, address respondent, uint256 respondentFee)",
+    "event DisputeFeeResolved(uint256 indexed agreementId, uint8 outcome, uint256 openerRefund)",
+    "event ArbitratorAssigned(uint256 indexed agreementId, address indexed arbitrator, uint256 bondAmount)",
+    "event ArbitratorBondReturned(uint256 indexed agreementId, address indexed arbitrator, uint256 amount)",
+    "event ArbitratorBondSlashed(uint256 indexed agreementId, address indexed arbitrator, uint256 amount, string reason)",
+    "event ArbitratorFeePaid(uint256 indexed agreementId, address indexed arbitrator, uint256 feeShare)",
+    "event DisputeFallbackTriggered(uint256 indexed agreementId, string reason)",
+    "event TokenRateSet(address indexed token, uint256 usdRate18)",
+];
+class DisputeArbitrationClient {
+    constructor(address, runner) {
+        this.contract = new ethers_1.ethers.Contract(address, DISPUTE_ARBITRATION_ABI, runner);
+    }
+    // ─── Views ────────────────────────────────────────────────────────────────
+    async getDisputeFeeState(agreementId) {
+        const r = await this.contract.getDisputeFeeState(agreementId);
+        return {
+            mode: Number(r.mode),
+            disputeClass: Number(r.disputeClass),
+            opener: r.opener,
+            client: r.client,
+            provider: r.provider,
+            token: r.token,
+            agreementPrice: BigInt(r.agreementPrice),
+            feeRequired: BigInt(r.feeRequired),
+            openerPaid: BigInt(r.openerPaid),
+            respondentPaid: BigInt(r.respondentPaid),
+            openedAt: BigInt(r.openedAt),
+            active: r.active,
+            resolved: r.resolved,
+        };
+    }
+    async getArbitratorBondState(arbitrator, agreementId) {
+        const r = await this.contract.getArbitratorBondState(arbitrator, agreementId);
+        return {
+            bondAmount: BigInt(r.bondAmount),
+            lockedAt: BigInt(r.lockedAt),
+            locked: r.locked,
+            slashed: r.slashed,
+            returned: r.returned,
+        };
+    }
+    async getFeeQuote(agreementPrice, token, mode, disputeClass) {
+        return BigInt(await this.contract.getFeeQuote(agreementPrice, token, mode, disputeClass));
+    }
+    async getAcceptedArbitrators(agreementId) {
+        return this.contract.getAcceptedArbitrators(agreementId);
+    }
+    async isEligibleArbitrator(address) {
+        return this.contract.isEligibleArbitrator(address);
+    }
+    async getTokenUsdRate(token) {
+        return BigInt(await this.contract.tokenUsdRate18(token));
+    }
+    // ─── Transactions ─────────────────────────────────────────────────────────
+    /** Respondent in MUTUAL dispute funds their half of the fee. */
+    async joinMutualDispute(agreementId, halfFeeEth = 0n // 0 for ERC-20 agreements (pre-approve instead)
+    ) {
+        const tx = await this.contract.joinMutualDispute(agreementId, { value: halfFeeEth });
+        return (await tx.wait());
+    }
+    /** Nominated arbitrator accepts assignment and posts bond. */
+    async acceptAssignment(agreementId, bondEth = 0n // 0 for ERC-20 agreements (pre-approve instead)
+    ) {
+        const tx = await this.contract.acceptAssignment(agreementId, { value: bondEth });
+        return (await tx.wait());
+    }
+    /** Trigger fallback to human backstop queue (mutual unfunded or panel not formed). */
+    async triggerFallback(agreementId) {
+        const tx = await this.contract.triggerFallback(agreementId);
+        return (await tx.wait());
+    }
+    /** Owner-only: slash an arbitrator for manual rules violation. */
+    async slashArbitrator(agreementId, arbitrator, reason) {
+        const tx = await this.contract.slashArbitrator(agreementId, arbitrator, reason);
+        return (await tx.wait());
+    }
+    /**
+     * Arbitrators can reclaim their bond after 45 days if the dispute was never resolved via resolveDisputeFee.
+     * Prevents permanent bond lock on stalled disputes.
+     */
+    async reclaimExpiredBond(agreementId) {
+        const tx = await this.contract.reclaimExpiredBond(agreementId);
+        return (await tx.wait());
+    }
+    /** Step 1 of two-step ownership transfer. Owner-only. */
+    async proposeOwner(newOwner) {
+        const tx = await this.contract.transferOwnership(newOwner);
+        return (await tx.wait());
+    }
+    /** Step 2 of two-step ownership transfer. Must be called by the pending owner. */
+    async acceptOwnership() {
+        const tx = await this.contract.acceptOwnership();
+        return (await tx.wait());
+    }
+    // ─── Admin ────────────────────────────────────────────────────────────────
+    /**
+     * Set the USD rate for a payment token. Owner only.
+     * @param token Token address (address(0) for ETH)
+     * @param usdRate18 USD per token with 18 decimals (e.g. 2000e18 for ETH at $2000)
+     * IMPORTANT: This is an admin-set rate, not a trustless oracle. Keep it current.
+     */
+    async setTokenUsdRate(token, usdRate18) {
+        const tx = await this.contract.setTokenUsdRate(token, usdRate18);
+        return (await tx.wait());
+    }
+    async setFeeFloorUsd(floorUsd18) {
+        const tx = await this.contract.setFeeFloorUsd(floorUsd18);
+        return (await tx.wait());
+    }
+    async setFeeCapUsd(capUsd18) {
+        const tx = await this.contract.setFeeCapUsd(capUsd18);
+        return (await tx.wait());
+    }
+    async setServiceAgreement(address) {
+        const tx = await this.contract.setServiceAgreement(address);
+        return (await tx.wait());
+    }
+    async setTrustRegistry(address) {
+        const tx = await this.contract.setTrustRegistry(address);
+        return (await tx.wait());
+    }
+    async setTreasury(address) {
+        const tx = await this.contract.setTreasury(address);
+        return (await tx.wait());
+    }
+}
+exports.DisputeArbitrationClient = DisputeArbitrationClient;

package/dist/governance.d.ts

@@ -0,0 +1,13 @@
+import { ContractRunner } from "ethers";
+import { GovernanceTransaction } from "./types";
+export declare class GovernanceClient {
+    private contract;
+    constructor(address: string, runner: ContractRunner);
+    submitTransaction(target: string, value: bigint, data: string): Promise<any>;
+    confirmTransaction(txId: bigint): Promise<any>;
+    revokeConfirmation(txId: bigint): Promise<any>;
+    executeTransaction(txId: bigint): Promise<any>;
+    getTransaction(txId: bigint): Promise<GovernanceTransaction>;
+    transactionCount(): Promise<bigint>;
+}
+//# sourceMappingURL=governance.d.ts.map

package/dist/governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../src/governance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAU,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEhD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAkB;gBACtB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc;IAC7C,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAC7D,kBAAkB,CAAC,IAAI,EAAE,MAAM;IAC/B,kBAAkB,CAAC,IAAI,EAAE,MAAM;IAC/B,kBAAkB,CAAC,IAAI,EAAE,MAAM;IAC/B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAClE,gBAAgB;CACjB"}

package/dist/governance.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GovernanceClient = void 0;
+const ethers_1 = require("ethers");
+const contracts_1 = require("./contracts");
+class GovernanceClient {
+    constructor(address, runner) { this.contract = new ethers_1.ethers.Contract(address, contracts_1.GOVERNANCE_ABI, runner); }
+    async submitTransaction(target, value, data) { const tx = await this.contract.submitTransaction(target, value, data); return tx.wait(); }
+    async confirmTransaction(txId) { const tx = await this.contract.confirmTransaction(txId); return tx.wait(); }
+    async revokeConfirmation(txId) { const tx = await this.contract.revokeConfirmation(txId); return tx.wait(); }
+    async executeTransaction(txId) { const tx = await this.contract.executeTransaction(txId); return tx.wait(); }
+    async getTransaction(txId) { const raw = await this.contract.getTransaction(txId); return { target: raw.target, value: BigInt(raw.value), data: raw.data, executed: raw.executed, confirmationCount: BigInt(raw.confirmationCount) }; }
+    transactionCount() { return this.contract.transactionCount().then(BigInt); }
+}
+exports.GovernanceClient = GovernanceClient;

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+export { ARC402WalletClient, ARC402Wallet, type ContextBinding } from "./wallet";
+export { ContractInteractionClient, type IntentPayload, type ContractCallAttestation, type ContractCallResult } from "./contractinteraction";
+export { PolicyClient, PolicyObject, PolicyValidator } from "./policy";
+export { TrustClient, TrustPrimitive } from "./trust";
+export { IntentAttestationClient, IntentAttestation } from "./intent";
+export { SettlementClient, MultiAgentSettlement } from "./settlement";
+export { AgentRegistryClient, type AgentRegistrationInput } from "./agent";
+export { ServiceAgreementClient } from "./agreement";
+export { DisputeArbitrationClient } from "./dispute-arbitration";
+export { ReputationOracleClient } from "./reputation";
+export { SponsorshipAttestationClient } from "./sponsorship";
+export { CapabilityRegistryClient } from "./capability";
+export { GovernanceClient } from "./governance";
+export { signNegotiationMessage, createSignedProposal, createSignedCounter, createSignedAccept, createSignedReject, createNegotiationProposal, createNegotiationCounter, createNegotiationAccept, createNegotiationReject, parseNegotiationMessage } from "./negotiation";
+export { NegotiationGuard } from "./negotiation-guard";
+export { SessionManager } from "./session-manager";
+export { ChannelClient } from "./channel";
+export { AgreementTreeClient, type AgreementTree, type PaymentSplit, type PaymentDistribution, type CreateAgreementResult } from "./multiparty";
+export { WatchtowerClient } from "./watchtower";
+export type { WatchtowerMetadata, WatchtowerStatus } from "./watchtower";
+export { DeliverableClient, DeliverableType, hashDeliverable, hashDeliverableFile, uploadToIPFS, encryptDeliverable, decryptDeliverable, uploadEncryptedIPFS } from "./deliverable";
+export type { DeliverableManifest, DeliverableManifestEntry, IPFSUploadOptions, IPFSUploadResult, EncryptedDeliverable } from "./deliverable";
+export type { NegotiationVerificationResult, NegotiationVerificationError, SignedNegotiationMessage } from "./types";
+export type { ChannelState, Channel, ChannelStatus, OpenChannelParams } from "./types";
+export * from "./contracts";
+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 { MigrationClient } from "./migration";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}