@arc402/sdk 0.2.0

package/dist/index.js

@@ -0,0 +1,92 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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;
+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 contractinteraction_1 = require("./contractinteraction");
+Object.defineProperty(exports, "ContractInteractionClient", { enumerable: true, get: function () { return contractinteraction_1.ContractInteractionClient; } });
+var policy_1 = require("./policy");
+Object.defineProperty(exports, "PolicyClient", { enumerable: true, get: function () { return policy_1.PolicyClient; } });
+Object.defineProperty(exports, "PolicyObject", { enumerable: true, get: function () { return policy_1.PolicyObject; } });
+Object.defineProperty(exports, "PolicyValidator", { enumerable: true, get: function () { return policy_1.PolicyValidator; } });
+var trust_1 = require("./trust");
+Object.defineProperty(exports, "TrustClient", { enumerable: true, get: function () { return trust_1.TrustClient; } });
+Object.defineProperty(exports, "TrustPrimitive", { enumerable: true, get: function () { return trust_1.TrustPrimitive; } });
+var intent_1 = require("./intent");
+Object.defineProperty(exports, "IntentAttestationClient", { enumerable: true, get: function () { return intent_1.IntentAttestationClient; } });
+Object.defineProperty(exports, "IntentAttestation", { enumerable: true, get: function () { return intent_1.IntentAttestation; } });
+var settlement_1 = require("./settlement");
+Object.defineProperty(exports, "SettlementClient", { enumerable: true, get: function () { return settlement_1.SettlementClient; } });
+Object.defineProperty(exports, "MultiAgentSettlement", { enumerable: true, get: function () { return settlement_1.MultiAgentSettlement; } });
+var agent_1 = require("./agent");
+Object.defineProperty(exports, "AgentRegistryClient", { enumerable: true, get: function () { return agent_1.AgentRegistryClient; } });
+var agreement_1 = require("./agreement");
+Object.defineProperty(exports, "ServiceAgreementClient", { enumerable: true, get: function () { return agreement_1.ServiceAgreementClient; } });
+var dispute_arbitration_1 = require("./dispute-arbitration");
+Object.defineProperty(exports, "DisputeArbitrationClient", { enumerable: true, get: function () { return dispute_arbitration_1.DisputeArbitrationClient; } });
+var reputation_1 = require("./reputation");
+Object.defineProperty(exports, "ReputationOracleClient", { enumerable: true, get: function () { return reputation_1.ReputationOracleClient; } });
+var sponsorship_1 = require("./sponsorship");
+Object.defineProperty(exports, "SponsorshipAttestationClient", { enumerable: true, get: function () { return sponsorship_1.SponsorshipAttestationClient; } });
+var capability_1 = require("./capability");
+Object.defineProperty(exports, "CapabilityRegistryClient", { enumerable: true, get: function () { return capability_1.CapabilityRegistryClient; } });
+var governance_1 = require("./governance");
+Object.defineProperty(exports, "GovernanceClient", { enumerable: true, get: function () { return governance_1.GovernanceClient; } });
+var negotiation_1 = require("./negotiation");
+Object.defineProperty(exports, "signNegotiationMessage", { enumerable: true, get: function () { return negotiation_1.signNegotiationMessage; } });
+Object.defineProperty(exports, "createSignedProposal", { enumerable: true, get: function () { return negotiation_1.createSignedProposal; } });
+Object.defineProperty(exports, "createSignedCounter", { enumerable: true, get: function () { return negotiation_1.createSignedCounter; } });
+Object.defineProperty(exports, "createSignedAccept", { enumerable: true, get: function () { return negotiation_1.createSignedAccept; } });
+Object.defineProperty(exports, "createSignedReject", { enumerable: true, get: function () { return negotiation_1.createSignedReject; } });
+Object.defineProperty(exports, "createNegotiationProposal", { enumerable: true, get: function () { return negotiation_1.createNegotiationProposal; } });
+Object.defineProperty(exports, "createNegotiationCounter", { enumerable: true, get: function () { return negotiation_1.createNegotiationCounter; } });
+Object.defineProperty(exports, "createNegotiationAccept", { enumerable: true, get: function () { return negotiation_1.createNegotiationAccept; } });
+Object.defineProperty(exports, "createNegotiationReject", { enumerable: true, get: function () { return negotiation_1.createNegotiationReject; } });
+Object.defineProperty(exports, "parseNegotiationMessage", { enumerable: true, get: function () { return negotiation_1.parseNegotiationMessage; } });
+var negotiation_guard_1 = require("./negotiation-guard");
+Object.defineProperty(exports, "NegotiationGuard", { enumerable: true, get: function () { return negotiation_guard_1.NegotiationGuard; } });
+var session_manager_1 = require("./session-manager");
+Object.defineProperty(exports, "SessionManager", { enumerable: true, get: function () { return session_manager_1.SessionManager; } });
+var channel_1 = require("./channel");
+Object.defineProperty(exports, "ChannelClient", { enumerable: true, get: function () { return channel_1.ChannelClient; } });
+var multiparty_1 = require("./multiparty");
+Object.defineProperty(exports, "AgreementTreeClient", { enumerable: true, get: function () { return multiparty_1.AgreementTreeClient; } });
+var watchtower_1 = require("./watchtower");
+Object.defineProperty(exports, "WatchtowerClient", { enumerable: true, get: function () { return watchtower_1.WatchtowerClient; } });
+var deliverable_1 = require("./deliverable");
+Object.defineProperty(exports, "DeliverableClient", { enumerable: true, get: function () { return deliverable_1.DeliverableClient; } });
+Object.defineProperty(exports, "DeliverableType", { enumerable: true, get: function () { return deliverable_1.DeliverableType; } });
+Object.defineProperty(exports, "hashDeliverable", { enumerable: true, get: function () { return deliverable_1.hashDeliverable; } });
+Object.defineProperty(exports, "hashDeliverableFile", { enumerable: true, get: function () { return deliverable_1.hashDeliverableFile; } });
+Object.defineProperty(exports, "uploadToIPFS", { enumerable: true, get: function () { return deliverable_1.uploadToIPFS; } });
+Object.defineProperty(exports, "encryptDeliverable", { enumerable: true, get: function () { return deliverable_1.encryptDeliverable; } });
+Object.defineProperty(exports, "decryptDeliverable", { enumerable: true, get: function () { return deliverable_1.decryptDeliverable; } });
+Object.defineProperty(exports, "uploadEncryptedIPFS", { enumerable: true, get: function () { return deliverable_1.uploadEncryptedIPFS; } });
+__exportStar(require("./contracts"), exports);
+__exportStar(require("./types"), exports);
+var metadata_1 = require("./metadata");
+Object.defineProperty(exports, "buildMetadata", { enumerable: true, get: function () { return metadata_1.buildMetadata; } });
+Object.defineProperty(exports, "validateMetadata", { enumerable: true, get: function () { return metadata_1.validateMetadata; } });
+Object.defineProperty(exports, "encodeMetadata", { enumerable: true, get: function () { return metadata_1.encodeMetadata; } });
+Object.defineProperty(exports, "decodeMetadata", { enumerable: true, get: function () { return metadata_1.decodeMetadata; } });
+Object.defineProperty(exports, "uploadMetadata", { enumerable: true, get: function () { return metadata_1.uploadMetadata; } });
+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 migration_1 = require("./migration");
+Object.defineProperty(exports, "MigrationClient", { enumerable: true, get: function () { return migration_1.MigrationClient; } });

package/dist/intent.d.ts

@@ -0,0 +1,13 @@
+import { ContractRunner } from "ethers";
+import { Intent } from "./types";
+export declare class IntentAttestationClient {
+    private walletAddress;
+    private contract;
+    constructor(address: string, runner: ContractRunner, walletAddress: string);
+    create(action: string, reason: string, recipient: string, amount: bigint): Promise<string>;
+    verify(attestationId: string, walletAddress: string): Promise<any>;
+    get(attestationId: string): Promise<Intent>;
+}
+export declare class IntentAttestation extends IntentAttestationClient {
+}
+//# sourceMappingURL=intent.d.ts.map

package/dist/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../src/intent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAU,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,qBAAa,uBAAuB;IAEmB,OAAO,CAAC,aAAa;IAD1E,OAAO,CAAC,QAAQ,CAAkB;gBACtB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAU,aAAa,EAAE,MAAM;IAG5E,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMhG,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;IAC7C,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAIlD;AACD,qBAAa,iBAAkB,SAAQ,uBAAuB;CAAG"}

package/dist/intent.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntentAttestation = exports.IntentAttestationClient = void 0;
+const ethers_1 = require("ethers");
+const contracts_1 = require("./contracts");
+class IntentAttestationClient {
+    constructor(address, runner, walletAddress) {
+        this.walletAddress = walletAddress;
+        this.contract = new ethers_1.ethers.Contract(address, contracts_1.INTENT_ATTESTATION_ABI, runner);
+    }
+    async create(action, reason, recipient, amount) {
+        const attestationId = ethers_1.ethers.keccak256(ethers_1.ethers.toUtf8Bytes(`${this.walletAddress}:${action}:${reason}:${recipient}:${amount}:${Date.now()}`));
+        const tx = await this.contract.attest(attestationId, action, reason, recipient, amount);
+        await tx.wait();
+        return attestationId;
+    }
+    verify(attestationId, walletAddress) { return this.contract.verify(attestationId, walletAddress); }
+    async get(attestationId) {
+        const [id, wallet, action, reason, recipient, amount, timestamp] = await this.contract.getAttestation(attestationId);
+        return { attestationId: id, wallet, action, reason, recipient, amount: BigInt(amount), timestamp: Number(timestamp) };
+    }
+}
+exports.IntentAttestationClient = IntentAttestationClient;
+class IntentAttestation extends IntentAttestationClient {
+}
+exports.IntentAttestation = IntentAttestation;

package/dist/metadata.d.ts

@@ -0,0 +1,55 @@
+export declare const AGENT_METADATA_SCHEMA = "arc402.agent-metadata.v1";
+export interface AgentMetadataModel {
+    family?: string;
+    version?: string;
+    provider?: string;
+    contextWindow?: number;
+    multimodal?: boolean;
+}
+export interface AgentMetadataTraining {
+    disclosure?: string;
+    dataCutoff?: string;
+    specialisations?: string[];
+    synopsis?: string;
+    verified?: boolean;
+    attestations?: unknown[];
+}
+export interface AgentMetadataPricing {
+    base?: string;
+    token?: string;
+    currency?: string;
+    per?: string;
+}
+export interface AgentMetadataSla {
+    turnaroundHours?: number;
+    availability?: string;
+    maxConcurrentJobs?: number;
+}
+export interface AgentMetadataContact {
+    endpoint?: string;
+    relay?: string;
+    relayFallbacks?: string[];
+}
+export interface AgentMetadataSecurity {
+    injectionProtection?: boolean;
+    envLeakProtection?: boolean;
+    attestedSecurityPolicy?: boolean;
+}
+export interface AgentMetadata {
+    schema: string;
+    name?: string;
+    description?: string;
+    capabilities?: string[];
+    model?: AgentMetadataModel;
+    training?: AgentMetadataTraining;
+    pricing?: AgentMetadataPricing;
+    sla?: AgentMetadataSla;
+    contact?: AgentMetadataContact;
+    security?: AgentMetadataSecurity;
+}
+export declare function validateMetadata(obj: unknown): AgentMetadata;
+export declare function buildMetadata(input: Partial<AgentMetadata>): AgentMetadata;
+export declare function encodeMetadata(metadata: AgentMetadata): string;
+export declare function decodeMetadata(uri: string): Promise<AgentMetadata>;
+export declare function uploadMetadata(metadata: AgentMetadata, pinataJwt?: string): Promise<string>;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB,6BAA6B,CAAC;AAEhE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAuB5D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAmB1E;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAE9D;AASD,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAgBxE;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBjG"}

package/dist/metadata.js

@@ -0,0 +1,106 @@
+"use strict";
+// ARC-402 Spec 23: Agent Metadata Standard
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_METADATA_SCHEMA = void 0;
+exports.validateMetadata = validateMetadata;
+exports.buildMetadata = buildMetadata;
+exports.encodeMetadata = encodeMetadata;
+exports.decodeMetadata = decodeMetadata;
+exports.uploadMetadata = uploadMetadata;
+exports.AGENT_METADATA_SCHEMA = "arc402.agent-metadata.v1";
+function validateMetadata(obj) {
+    if (typeof obj !== "object" || obj === null) {
+        throw new Error("metadata must be an object");
+    }
+    const m = obj;
+    if (typeof m["schema"] !== "string") {
+        throw new Error("metadata.schema must be a string");
+    }
+    if (m["schema"] !== exports.AGENT_METADATA_SCHEMA) {
+        throw new Error(`metadata.schema must be "${exports.AGENT_METADATA_SCHEMA}", got "${m["schema"]}"`);
+    }
+    if (m["name"] !== undefined && typeof m["name"] !== "string") {
+        throw new Error("metadata.name must be a string");
+    }
+    if (m["description"] !== undefined && typeof m["description"] !== "string") {
+        throw new Error("metadata.description must be a string");
+    }
+    if (m["capabilities"] !== undefined) {
+        if (!Array.isArray(m["capabilities"]) || !m["capabilities"].every((c) => typeof c === "string")) {
+            throw new Error("metadata.capabilities must be a string array");
+        }
+    }
+    return m;
+}
+function buildMetadata(input) {
+    const meta = {
+        schema: exports.AGENT_METADATA_SCHEMA,
+        ...input,
+    };
+    if (meta.training) {
+        meta.training = {
+            verified: false,
+            attestations: [],
+            ...meta.training,
+        };
+    }
+    if (meta.security) {
+        meta.security = {
+            attestedSecurityPolicy: false,
+            ...meta.security,
+        };
+    }
+    return meta;
+}
+function encodeMetadata(metadata) {
+    return JSON.stringify(metadata, null, 2);
+}
+function resolveIpfsUri(uri) {
+    if (uri.startsWith("ipfs://")) {
+        return `https://ipfs.io/ipfs/${uri.slice(7)}`;
+    }
+    return uri;
+}
+async function decodeMetadata(uri) {
+    if (uri.startsWith("data:")) {
+        // data:application/json;base64,<b64> or data:application/json,<encoded>
+        const commaIdx = uri.indexOf(",");
+        if (commaIdx === -1)
+            throw new Error("malformed data URI");
+        const header = uri.slice(5, commaIdx);
+        const payload = uri.slice(commaIdx + 1);
+        const isBase64 = header.includes(";base64");
+        const json = isBase64 ? Buffer.from(payload, "base64").toString("utf-8") : decodeURIComponent(payload);
+        return validateMetadata(JSON.parse(json));
+    }
+    const url = resolveIpfsUri(uri);
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`failed to fetch metadata from ${url}: ${res.status} ${res.statusText}`);
+    const json = await res.json();
+    return validateMetadata(json);
+}
+async function uploadMetadata(metadata, pinataJwt) {
+    if (pinataJwt) {
+        const res = await fetch("https://api.pinata.cloud/pinning/pinJSONToIPFS", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Authorization": `Bearer ${pinataJwt}`,
+            },
+            body: JSON.stringify({
+                pinataContent: metadata,
+                pinataMetadata: { name: `arc402-agent-metadata-${metadata.name ?? "unknown"}` },
+            }),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Pinata upload failed: ${res.status} ${text}`);
+        }
+        const data = await res.json();
+        return `ipfs://${data.IpfsHash}`;
+    }
+    // Fallback: data URI (no IPFS credentials configured)
+    const b64 = Buffer.from(encodeMetadata(metadata), "utf-8").toString("base64");
+    return `data:application/json;base64,${b64}`;
+}

package/dist/migration.d.ts

@@ -0,0 +1,11 @@
+import { ContractRunner, ethers } from "ethers";
+export declare class MigrationClient {
+    private address;
+    private runner?;
+    constructor(address: string, runner?: ContractRunner);
+    registerMigration(oldWallet: string, newWallet: string, signer: ContractRunner): Promise<ethers.TransactionReceipt>;
+    resolveActiveWallet(wallet: string): Promise<string>;
+    getLineage(wallet: string): Promise<string[]>;
+    approveMigrationTarget(impl: string, signer: ContractRunner): Promise<ethers.TransactionReceipt>;
+}
+//# sourceMappingURL=migration.d.ts.map

package/dist/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAWhD,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAC,CAAiB;gBAEpB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc;IAK9C,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAMnH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKpD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAM7C,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;CAKvG"}

package/dist/migration.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MigrationClient = void 0;
+const ethers_1 = require("ethers");
+const MIGRATION_REGISTRY_ABI = [
+    "function registerMigration(address oldWallet, address newWallet) external",
+    "function resolveActiveWallet(address wallet) external view returns (address)",
+    "function getLineage(address wallet) external view returns (address[])",
+    "function approveMigrationTarget(address implementation) external",
+    "function migratedTo(address wallet) external view returns (address)",
+    "function migratedFrom(address wallet) external view returns (address)",
+];
+class MigrationClient {
+    constructor(address, runner) {
+        this.address = address;
+        this.runner = runner;
+    }
+    async registerMigration(oldWallet, newWallet, signer) {
+        const contract = new ethers_1.ethers.Contract(this.address, MIGRATION_REGISTRY_ABI, signer);
+        const tx = await contract.registerMigration(oldWallet, newWallet);
+        return tx.wait();
+    }
+    async resolveActiveWallet(wallet) {
+        const contract = new ethers_1.ethers.Contract(this.address, MIGRATION_REGISTRY_ABI, this.runner);
+        return contract.resolveActiveWallet(wallet);
+    }
+    async getLineage(wallet) {
+        const contract = new ethers_1.ethers.Contract(this.address, MIGRATION_REGISTRY_ABI, this.runner);
+        const result = await contract.getLineage(wallet);
+        return [...result];
+    }
+    async approveMigrationTarget(impl, signer) {
+        const contract = new ethers_1.ethers.Contract(this.address, MIGRATION_REGISTRY_ABI, signer);
+        const tx = await contract.approveMigrationTarget(impl);
+        return tx.wait();
+    }
+}
+exports.MigrationClient = MigrationClient;

package/dist/multiparty.d.ts

@@ -0,0 +1,56 @@
+import { ContractRunner, ethers } from "ethers";
+import { ProposeParams } from "./types";
+export interface AgreementTree {
+    root: bigint;
+    path: bigint[];
+    children: bigint[];
+    depth: number;
+    allSettled: boolean;
+}
+export interface PaymentSplit {
+    address: string;
+    percentage: number;
+}
+export interface PaymentDistribution {
+    total: bigint;
+    distributions: Array<{
+        address: string;
+        amount: bigint;
+        percentage: number;
+    }>;
+}
+export interface CreateAgreementResult {
+    rootAgreementId: bigint;
+    childAgreementIds: bigint[];
+}
+export declare class AgreementTreeClient {
+    private treeContract;
+    private agreementClient;
+    constructor(treeAddress: string, agreementAddress: string, runner: ContractRunner);
+    registerSubAgreement(params: {
+        parentAgreementId: bigint;
+        childAgreementId: bigint;
+    }): Promise<ethers.TransactionReceipt>;
+    /**
+     * Propose the root agreement, then propose each child agreement and register
+     * them all under the root in the AgreementTree contract.
+     *
+     * The caller must be the client for the root agreement AND the provider for
+     * all child agreements (i.e. the middle-layer agent that subcontracts work).
+     */
+    createAgreement(rootTerms: ProposeParams, childAgreements: ProposeParams[]): Promise<CreateAgreementResult>;
+    getAgreementTree(rootAgreementId: bigint): Promise<AgreementTree>;
+    /** Alias for getAgreementTree — matches spec SDK interface. */
+    getTree(agreementId: bigint): Promise<AgreementTree>;
+    treeStatus(agreementId: bigint): Promise<{
+        allSettled: boolean;
+        childCount: number;
+    }>;
+    /**
+     * Off-chain payment distribution helper.
+     * Splits paymentAmount across recipients according to their percentage shares.
+     * Percentages must sum to 100. This does not touch the chain.
+     */
+    splitPayment(paymentAmount: bigint, splits: PaymentSplit[]): PaymentDistribution;
+}
+//# sourceMappingURL=multiparty.d.ts.map

package/dist/multiparty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiparty.d.ts","sourceRoot":"","sources":["../src/multiparty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,eAAe,CAAyB;gBAEpC,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc;IAK3E,oBAAoB,CAAC,MAAM,EAAE;QACjC,iBAAiB,EAAE,MAAM,CAAC;QAC1B,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAQtC;;;;;;OAMG;IACG,eAAe,CACnB,SAAS,EAAE,aAAa,EACxB,eAAe,EAAE,aAAa,EAAE,GAC/B,OAAO,CAAC,qBAAqB,CAAC;IAgB3B,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBvE,+DAA+D;IACzD,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpD,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAW3F;;;;OAIG;IACH,YAAY,CACV,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,YAAY,EAAE,GACrB,mBAAmB;CAevB"}

package/dist/multiparty.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgreementTreeClient = void 0;
+const ethers_1 = require("ethers");
+const contracts_1 = require("./contracts");
+const agreement_1 = require("./agreement");
+class AgreementTreeClient {
+    constructor(treeAddress, agreementAddress, runner) {
+        this.treeContract = new ethers_1.ethers.Contract(treeAddress, contracts_1.AGREEMENT_TREE_ABI, runner);
+        this.agreementClient = new agreement_1.ServiceAgreementClient(agreementAddress, runner);
+    }
+    async registerSubAgreement(params) {
+        const tx = await this.treeContract.registerSubAgreement(params.parentAgreementId, params.childAgreementId);
+        return tx.wait();
+    }
+    /**
+     * Propose the root agreement, then propose each child agreement and register
+     * them all under the root in the AgreementTree contract.
+     *
+     * The caller must be the client for the root agreement AND the provider for
+     * all child agreements (i.e. the middle-layer agent that subcontracts work).
+     */
+    async createAgreement(rootTerms, childAgreements) {
+        const { agreementId: rootAgreementId } = await this.agreementClient.propose(rootTerms);
+        const childAgreementIds = [];
+        for (const child of childAgreements) {
+            const { agreementId: childId } = await this.agreementClient.propose(child);
+            await this.registerSubAgreement({
+                parentAgreementId: rootAgreementId,
+                childAgreementId: childId,
+            });
+            childAgreementIds.push(childId);
+        }
+        return { rootAgreementId, childAgreementIds };
+    }
+    async getAgreementTree(rootAgreementId) {
+        const id = BigInt(rootAgreementId);
+        const [root, path, children, depth, allSettled] = await Promise.all([
+            this.treeContract.getRoot(id),
+            this.treeContract.getPath(id),
+            this.treeContract.getChildren(id),
+            this.treeContract.getDepth(id),
+            this.treeContract.allChildrenSettled(id),
+        ]);
+        return {
+            root: BigInt(root),
+            path: path.map(BigInt),
+            children: children.map(BigInt),
+            depth: Number(depth),
+            allSettled: Boolean(allSettled),
+        };
+    }
+    /** Alias for getAgreementTree — matches spec SDK interface. */
+    async getTree(agreementId) {
+        return this.getAgreementTree(agreementId);
+    }
+    async treeStatus(agreementId) {
+        const [allSettled, children] = await Promise.all([
+            this.treeContract.allChildrenSettled(BigInt(agreementId)),
+            this.treeContract.getChildren(BigInt(agreementId)),
+        ]);
+        return {
+            allSettled: Boolean(allSettled),
+            childCount: children.length,
+        };
+    }
+    /**
+     * Off-chain payment distribution helper.
+     * Splits paymentAmount across recipients according to their percentage shares.
+     * Percentages must sum to 100. This does not touch the chain.
+     */
+    splitPayment(paymentAmount, splits) {
+        const totalPct = splits.reduce((sum, s) => sum + s.percentage, 0);
+        if (Math.abs(totalPct - 100) > 0.001) {
+            throw new Error(`Split percentages must sum to 100 (got ${totalPct})`);
+        }
+        const distributions = splits.map((s) => ({
+            address: s.address,
+            percentage: s.percentage,
+            // Use integer basis points (x100) to avoid floating-point in BigInt arithmetic
+            amount: (paymentAmount * BigInt(Math.round(s.percentage * 100))) / 10000n,
+        }));
+        return { total: paymentAmount, distributions };
+    }
+}
+exports.AgreementTreeClient = AgreementTreeClient;

package/dist/negotiation-guard.d.ts

@@ -0,0 +1,20 @@
+import type { ContractRunner } from "ethers";
+import type { NegotiationVerificationResult } from "./types";
+export interface NegotiationGuardOptions {
+    agentRegistryAddress: string;
+    runner: ContractRunner;
+    timestampToleranceSeconds?: number;
+    nonceCacheTtlMs?: number;
+    maxMessageBytes?: number;
+}
+export declare class NegotiationGuard {
+    private registry;
+    private nonceCache;
+    private opts;
+    constructor(options: NegotiationGuardOptions);
+    verify(rawJson: string): Promise<NegotiationVerificationResult>;
+    private pruneNonceCache;
+    /** Reset nonce cache (testing / restart) */
+    clearNonceCache(): void;
+}
+//# sourceMappingURL=negotiation-guard.d.ts.map

package/dist/negotiation-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"negotiation-guard.d.ts","sourceRoot":"","sources":["../src/negotiation-guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAsB,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAOjF,MAAM,WAAW,uBAAuB;IACtC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,IAAI,CAAoC;gBAEpC,OAAO,EAAE,uBAAuB;IActC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IA6ErE,OAAO,CAAC,eAAe;IAOvB,4CAA4C;IAC5C,eAAe,IAAI,IAAI;CAGxB"}

package/dist/negotiation-guard.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NegotiationGuard = void 0;
+const ethers_1 = require("ethers");
+const negotiation_1 = require("./negotiation");
+const AGENT_REGISTRY_ABI = [
+    "function isRegistered(address wallet) view returns (bool)",
+];
+class NegotiationGuard {
+    constructor(options) {
+        this.nonceCache = new Map(); // nonceKey -> expiry timestamp (ms)
+        this.opts = {
+            timestampToleranceSeconds: 60,
+            nonceCacheTtlMs: 24 * 60 * 60 * 1000,
+            maxMessageBytes: 64 * 1024,
+            ...options,
+        };
+        this.registry = new ethers_1.ethers.Contract(options.agentRegistryAddress, AGENT_REGISTRY_ABI, options.runner);
+    }
+    async verify(rawJson) {
+        // 1. Size check
+        if (Buffer.byteLength(rawJson, "utf8") > this.opts.maxMessageBytes) {
+            return { valid: false, error: "MESSAGE_TOO_LARGE" };
+        }
+        // 2. Parse
+        let message;
+        try {
+            message = JSON.parse(rawJson);
+        }
+        catch {
+            return { valid: false, error: "SCHEMA_INVALID" };
+        }
+        // 3. Required fields
+        if (!message.sig || message.timestamp == null || !message.from) {
+            return { valid: false, error: "SCHEMA_INVALID" };
+        }
+        // 4. Timestamp check
+        const now = Math.floor(Date.now() / 1000);
+        const delta = now - message.timestamp;
+        if (Math.abs(delta) > this.opts.timestampToleranceSeconds) {
+            return { valid: false, error: delta < 0 ? "TIMESTAMP_IN_FUTURE" : "TIMESTAMP_TOO_OLD" };
+        }
+        // 5. Expiry check (PROPOSE only)
+        if (message.type === "PROPOSE" && message.expiresAt != null && now > message.expiresAt) {
+            return { valid: false, error: "MESSAGE_EXPIRED" };
+        }
+        // 6. Signature recovery
+        let recoveredSigner;
+        try {
+            const digest = (0, negotiation_1.computeMessageDigest)(message);
+            recoveredSigner = ethers_1.ethers.recoverAddress(ethers_1.ethers.hashMessage(ethers_1.ethers.getBytes(digest)), message.sig);
+        }
+        catch {
+            return { valid: false, error: "INVALID_SIGNATURE" };
+        }
+        // 7. Signer must match from
+        if (recoveredSigner.toLowerCase() !== message.from.toLowerCase()) {
+            return { valid: false, error: "INVALID_SIGNATURE" };
+        }
+        // 8. Registry check (fail open on registry downtime)
+        try {
+            const registered = await this.registry.isRegistered(recoveredSigner);
+            if (!registered) {
+                return { valid: false, error: "SIGNER_NOT_REGISTERED" };
+            }
+        }
+        catch {
+            console.warn("NegotiationGuard: AgentRegistry check failed — proceeding with signature-only verification");
+        }
+        // 9. Nonce replay check
+        const nonceVal = "nonce" in message && message.nonce
+            ? message.nonce
+            : "refNonce" in message && message.refNonce
+                ? message.refNonce
+                : "";
+        const nonceKey = `${message.from.toLowerCase()}:${nonceVal}:${message.timestamp}`;
+        this.pruneNonceCache();
+        if (this.nonceCache.has(nonceKey)) {
+            return { valid: false, error: "NONCE_REPLAYED" };
+        }
+        this.nonceCache.set(nonceKey, Date.now() + this.opts.nonceCacheTtlMs);
+        return { valid: true, recoveredSigner: recoveredSigner };
+    }
+    pruneNonceCache() {
+        const now = Date.now();
+        for (const [key, expiry] of this.nonceCache) {
+            if (now > expiry)
+                this.nonceCache.delete(key);
+        }
+    }
+    /** Reset nonce cache (testing / restart) */
+    clearNonceCache() {
+        this.nonceCache.clear();
+    }
+}
+exports.NegotiationGuard = NegotiationGuard;