@arc402/sdk 0.2.0

package/src/contracts.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGovernance = exports.getCapabilityRegistry = exports.getSponsorshipAttestation = exports.getReputationOracle = exports.getServiceAgreement = exports.getAgentRegistry = exports.getWalletFactory = exports.getSettlementCoordinator = exports.getARC402Wallet = exports.getIntentAttestation = exports.getTrustRegistry = exports.getPolicyEngine = exports.AGREEMENT_TREE_ABI = exports.GOVERNANCE_ABI = exports.CAPABILITY_REGISTRY_ABI = exports.SPONSORSHIP_ATTESTATION_ABI = exports.REPUTATION_ORACLE_ABI = exports.SERVICE_AGREEMENT_ABI = exports.AGENT_REGISTRY_ABI = exports.WALLET_FACTORY_ABI = exports.SETTLEMENT_COORDINATOR_ABI = exports.ARC402_WALLET_ABI = exports.INTENT_ATTESTATION_ABI = exports.TRUST_REGISTRY_ABI = exports.POLICY_ENGINE_ABI = void 0;
+const ethers_1 = require("ethers");
+exports.POLICY_ENGINE_ABI = [
+    "function setPolicy(bytes32 policyHash, bytes policyData) external",
+    "function getPolicy(address wallet) external view returns (bytes32, bytes)",
+    "function setCategoryLimit(string category, uint256 limitPerTx) external",
+    "function setCategoryLimitFor(address wallet, string category, uint256 limitPerTx) external",
+    "function validateSpend(address wallet, string category, uint256 amount, bytes32 contextId) external view returns (bool, string)",
+    "function categoryLimits(address wallet, string category) external view returns (uint256)",
+    "function registerWallet(address wallet, address owner) external",
+    "function freezeSpend(address wallet) external",
+    "function unfreeze(address wallet) external",
+    "function authorizeFreezeAgent(address agent) external",
+    "function revokeFreezeAgent(address agent) external",
+    "function queueCapReduction(address wallet, string category, uint256 newCap) external",
+    "function applyCapReduction(address wallet, string category) external",
+];
+exports.TRUST_REGISTRY_ABI = [
+    "function getScore(address wallet) external view returns (uint256)",
+    "function getEffectiveScore(address wallet) external view returns (uint256)",
+    "function getTrustLevel(address wallet) external view returns (string)",
+    "function initWallet(address wallet) external",
+    "function recordSuccess(address wallet) external",
+    "function recordAnomaly(address wallet) external",
+];
+exports.INTENT_ATTESTATION_ABI = [
+    "function attest(bytes32 attestationId, string action, string reason, address recipient, uint256 amount) external",
+    "function verify(bytes32 attestationId, address wallet) external view returns (bool)",
+    "function getAttestation(bytes32 attestationId) external view returns (bytes32, address, string, string, address, uint256, uint256)",
+    "event AttestationCreated(bytes32 indexed id, address indexed wallet, string action, string reason, address recipient, uint256 amount, uint256 timestamp)",
+];
+exports.ARC402_WALLET_ABI = [
+    "function openContext(bytes32 contextId, string taskType) external",
+    "function closeContext() external",
+    "function executeSpend(address recipient, uint256 amount, string category, bytes32 attestationId) external",
+    "function getTrustScore() external view returns (uint256)",
+    "function getActiveContext() external view returns (bytes32, string, uint256, bool)",
+    "function updatePolicy(bytes32 newPolicyId) external",
+];
+exports.SETTLEMENT_COORDINATOR_ABI = [
+    "function propose(address fromWallet, address toWallet, uint256 amount, bytes32 intentId, uint256 expiresAt) external returns (bytes32)",
+    "function accept(bytes32 proposalId) external",
+    "function reject(bytes32 proposalId, string reason) external",
+    "function execute(bytes32 proposalId) external payable",
+    "function checkExpiry(bytes32 proposalId) external",
+    "function getProposal(bytes32 proposalId) external view returns (address, address, uint256, bytes32, uint256, uint8, string)",
+    "event ProposalCreated(bytes32 indexed proposalId, address indexed from, address indexed to, uint256 amount)",
+];
+exports.WALLET_FACTORY_ABI = [
+    "function createWallet() external returns (address)",
+    "function getWallets(address owner) external view returns (address[])",
+    "event WalletCreated(address indexed owner, address indexed walletAddress)",
+];
+exports.AGENT_REGISTRY_ABI = [
+    "function register(string name, string[] capabilities, string serviceType, string endpoint, string metadataURI) external",
+    "function update(string name, string[] capabilities, string serviceType, string endpoint, string metadataURI) external",
+    "function deactivate() external",
+    "function reactivate() external",
+    "function submitHeartbeat(uint32 latencyMs) external",
+    "function setHeartbeatPolicy(uint64 interval, uint64 gracePeriod) external",
+    "function getAgent(address wallet) external view returns (tuple(address wallet, string name, string[] capabilities, string serviceType, string endpoint, string metadataURI, bool active, uint256 registeredAt, uint256 endpointChangedAt, uint256 endpointChangeCount))",
+    "function getOperationalMetrics(address wallet) external view returns (tuple(uint64 heartbeatInterval, uint64 heartbeatGracePeriod, uint64 lastHeartbeatAt, uint64 rollingLatency, uint32 heartbeatCount, uint32 missedHeartbeatCount, uint32 uptimeScore, uint32 responseScore))",
+    "function isRegistered(address wallet) external view returns (bool)",
+    "function isActive(address wallet) external view returns (bool)",
+    "function getCapabilities(address wallet) external view returns (string[])",
+    "function getTrustScore(address wallet) external view returns (uint256)",
+    "function getEndpointStability(address wallet) external view returns (uint256)",
+    "function agentCount() external view returns (uint256)",
+    "function getAgentAtIndex(uint256 index) external view returns (address)",
+];
+exports.SERVICE_AGREEMENT_ABI = [
+    "function propose(address provider, string serviceType, string description, uint256 price, address token, uint256 deadline, bytes32 deliverablesHash) external payable returns (uint256)",
+    "function accept(uint256 agreementId) external",
+    "function fulfill(uint256 agreementId, bytes32 actualDeliverablesHash) external",
+    "function commitDeliverable(uint256 agreementId, bytes32 deliverableHash) external",
+    "function verifyDeliverable(uint256 agreementId) external",
+    "function autoRelease(uint256 agreementId) external",
+    "function dispute(uint256 agreementId, string reason) external",
+    "function directDispute(uint256 agreementId, uint8 directReason, string reason) external",
+    "function requestRevision(uint256 agreementId, bytes32 feedbackHash, string feedbackURI, bytes32 previousTranscriptHash) external",
+    "function respondToRevision(uint256 agreementId, uint8 responseType, uint256 proposedProviderPayout, bytes32 responseHash, string responseURI, bytes32 previousTranscriptHash) external",
+    "function escalateToDispute(uint256 agreementId, string reason) external",
+    "function canDirectDispute(uint256 agreementId, uint8 directReason) external view returns (bool)",
+    "function submitDisputeEvidence(uint256 agreementId, uint8 evidenceType, bytes32 evidenceHash, string evidenceURI) external",
+    "function nominateArbitrator(uint256 agreementId, address arbitrator) external",
+    "function castArbitrationVote(uint256 agreementId, uint8 vote, uint256 providerAward, uint256 clientAward) external",
+    "function requestHumanEscalation(uint256 agreementId, string reason) external",
+    "function resolveDisputeDetailed(uint256 agreementId, uint8 outcome, uint256 providerAward, uint256 clientAward) external",
+    "function cancel(uint256 agreementId) external",
+    "function expiredCancel(uint256 agreementId) external",
+    "function resolveDispute(uint256 agreementId, bool favorProvider) external",
+    "function getAgreement(uint256 id) external view returns (tuple(uint256 id, address client, address provider, string serviceType, string description, uint256 price, address token, uint256 deadline, bytes32 deliverablesHash, uint8 status, uint256 createdAt, uint256 resolvedAt, uint256 verifyWindowEnd, bytes32 committedHash))",
+    "function getRemediationCase(uint256 agreementId) external view returns (tuple(uint8 cycleCount, uint256 openedAt, uint256 deadlineAt, uint256 lastActionAt, bytes32 latestTranscriptHash, bool active))",
+    "function getRemediationFeedback(uint256 agreementId, uint256 index) external view returns (tuple(uint8 cycle, address author, bytes32 feedbackHash, string feedbackURI, bytes32 previousTranscriptHash, bytes32 transcriptHash, uint256 timestamp))",
+    "function getRemediationResponse(uint256 agreementId, uint256 index) external view returns (tuple(uint8 cycle, address author, uint8 responseType, uint256 proposedProviderPayout, bytes32 responseHash, string responseURI, bytes32 previousTranscriptHash, bytes32 transcriptHash, uint256 timestamp))",
+    "function getDisputeCase(uint256 agreementId) external view returns (tuple(uint256 agreementId, uint256 openedAt, uint256 responseDeadlineAt, uint8 outcome, uint256 providerAward, uint256 clientAward, bool humanReviewRequested, uint256 evidenceCount))",
+    "function getDisputeEvidence(uint256 agreementId, uint256 index) external view returns (tuple(address submitter, uint8 evidenceType, bytes32 evidenceHash, string evidenceURI, uint256 timestamp))",
+    "function getArbitrationCase(uint256 agreementId) external view returns (tuple(uint256 agreementId, address[3] arbitrators, uint8 arbitratorCount, uint8 providerVotes, uint8 clientVotes, uint8 splitVotes, uint8 humanVotes, uint256 selectionDeadlineAt, uint256 decisionDeadlineAt, uint256 splitProviderAward, uint256 splitClientAward, bool finalized, bool humanBackstopUsed))",
+    "function getAgreementsByClient(address client) external view returns (uint256[])",
+    "function getAgreementsByProvider(address provider) external view returns (uint256[])",
+    "function agreementCount() external view returns (uint256)",
+    "function openSessionChannel(address provider, address token, uint256 maxAmount, uint256 ratePerCall, uint256 deadline) external payable returns (bytes32 channelId)",
+    "function closeChannel(bytes32 channelId, bytes finalState) external",
+    "function challengeChannel(bytes32 channelId, bytes latestState) external",
+    "function finaliseChallenge(bytes32 channelId) external",
+    "function reclaimExpiredChannel(bytes32 channelId) external",
+    "function getChannel(bytes32 channelId) external view returns (tuple(address client, address provider, address token, uint256 depositAmount, uint256 settledAmount, uint256 lastSequenceNumber, uint256 deadline, uint256 challengeExpiry, uint8 status))",
+    "function getChannelsByClient(address client) external view returns (bytes32[])",
+    "function getChannelsByProvider(address provider) external view returns (bytes32[])",
+    "function resolveFromArbitration(uint256 agreementId, address recipient, uint256 providerAmount, uint256 clientAmount) external",
+    "function ownerResolveDispute(uint256 agreementId, bool favorProvider) external",
+    "event AgreementProposed(uint256 indexed id, address indexed client, address indexed provider, string serviceType, uint256 price, address token, uint256 deadline)",
+];
+exports.REPUTATION_ORACLE_ABI = [
+    "function publishSignal(address subject, uint8 signalType, bytes32 capabilityHash, string reason) external",
+    "function getReputation(address subject) external view returns (uint256, uint256, uint256, uint256)",
+    "function getCapabilityReputation(address subject, bytes32 capabilityHash) external view returns (uint256)",
+    "function getSignalCount(address subject) external view returns (uint256)",
+    "function getSignal(address subject, uint256 index) external view returns (tuple(address publisher, address subject, uint8 signalType, bytes32 capabilityHash, string reason, uint256 publisherTrustAtTime, uint256 timestamp, bool autoPublished))",
+];
+exports.SPONSORSHIP_ATTESTATION_ABI = [
+    "function publish(address agent, uint256 expiresAt) external returns (bytes32)",
+    "function publishWithTier(address agent, uint256 expiresAt, uint8 tier, string evidenceURI) external returns (bytes32)",
+    "function revoke(bytes32 attestationId) external",
+    "function isActive(bytes32 attestationId) external view returns (bool)",
+    "function getActiveAttestation(address sponsor, address agent) external view returns (bytes32)",
+    "function getAttestation(bytes32 attestationId) external view returns (tuple(address sponsor, address agent, uint256 issuedAt, uint256 expiresAt, bool revoked, uint8 tier, string evidenceURI))",
+    "function getSponsorAttestations(address sponsor) external view returns (bytes32[])",
+    "function getAgentAttestations(address agent) external view returns (bytes32[])",
+    "function activeSponsorCount(address sponsor) external view returns (uint256)",
+    "function getHighestTier(address agent) external view returns (uint8)",
+];
+exports.CAPABILITY_REGISTRY_ABI = [
+    "function registerRoot(string root) external returns (bytes32)",
+    "function setRootStatus(string root, bool active) external",
+    "function claim(string capability) external",
+    "function revoke(string capability) external",
+    "function isRootActive(string root) external view returns (bool)",
+    "function getRoot(string root) external view returns (tuple(bytes32 rootId, string root, bool active))",
+    "function rootCount() external view returns (uint256)",
+    "function getRootAt(uint256 index) external view returns (tuple(bytes32 rootId, string root, bool active))",
+    "function getCapabilities(address agent) external view returns (string[])",
+    "function capabilityCount(address agent) external view returns (uint256)",
+    "function isCapabilityClaimed(address agent, string capability) external view returns (bool)",
+];
+exports.GOVERNANCE_ABI = [
+    "function submitTransaction(address target, uint256 value, bytes data) external returns (uint256)",
+    "function confirmTransaction(uint256 txId) external",
+    "function revokeConfirmation(uint256 txId) external",
+    "function executeTransaction(uint256 txId) external returns (bytes)",
+    "function getTransaction(uint256 txId) external view returns (tuple(address target, uint256 value, bytes data, bool executed, uint256 confirmationCount))",
+    "function transactionCount() external view returns (uint256)",
+];
+exports.AGREEMENT_TREE_ABI = [
+    "function registerSubAgreement(uint256 parentAgreementId, uint256 childAgreementId) external",
+    "function getChildren(uint256 agreementId) external view returns (uint256[])",
+    "function getRoot(uint256 agreementId) external view returns (uint256)",
+    "function getPath(uint256 agreementId) external view returns (uint256[])",
+    "function allChildrenSettled(uint256 agreementId) external view returns (bool)",
+    "function getDepth(uint256 agreementId) external view returns (uint256)",
+];
+const getPolicyEngine = (address, runner) => new ethers_1.Contract(address, exports.POLICY_ENGINE_ABI, runner);
+exports.getPolicyEngine = getPolicyEngine;
+const getTrustRegistry = (address, runner) => new ethers_1.Contract(address, exports.TRUST_REGISTRY_ABI, runner);
+exports.getTrustRegistry = getTrustRegistry;
+const getIntentAttestation = (address, runner) => new ethers_1.Contract(address, exports.INTENT_ATTESTATION_ABI, runner);
+exports.getIntentAttestation = getIntentAttestation;
+const getARC402Wallet = (address, runner) => new ethers_1.Contract(address, exports.ARC402_WALLET_ABI, runner);
+exports.getARC402Wallet = getARC402Wallet;
+const getSettlementCoordinator = (address, runner) => new ethers_1.Contract(address, exports.SETTLEMENT_COORDINATOR_ABI, runner);
+exports.getSettlementCoordinator = getSettlementCoordinator;
+const getWalletFactory = (address, runner) => new ethers_1.Contract(address, exports.WALLET_FACTORY_ABI, runner);
+exports.getWalletFactory = getWalletFactory;
+const getAgentRegistry = (address, runner) => new ethers_1.Contract(address, exports.AGENT_REGISTRY_ABI, runner);
+exports.getAgentRegistry = getAgentRegistry;
+const getServiceAgreement = (address, runner) => new ethers_1.Contract(address, exports.SERVICE_AGREEMENT_ABI, runner);
+exports.getServiceAgreement = getServiceAgreement;
+const getReputationOracle = (address, runner) => new ethers_1.Contract(address, exports.REPUTATION_ORACLE_ABI, runner);
+exports.getReputationOracle = getReputationOracle;
+const getSponsorshipAttestation = (address, runner) => new ethers_1.Contract(address, exports.SPONSORSHIP_ATTESTATION_ABI, runner);
+exports.getSponsorshipAttestation = getSponsorshipAttestation;
+const getCapabilityRegistry = (address, runner) => new ethers_1.Contract(address, exports.CAPABILITY_REGISTRY_ABI, runner);
+exports.getCapabilityRegistry = getCapabilityRegistry;
+const getGovernance = (address, runner) => new ethers_1.Contract(address, exports.GOVERNANCE_ABI, runner);
+exports.getGovernance = getGovernance;
+//# sourceMappingURL=contracts.js.map

package/src/contracts.js.map

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

package/src/contracts.ts

@@ -0,0 +1,186 @@
+import { Contract, ContractRunner } from "ethers";
+
+export const POLICY_ENGINE_ABI = [
+  "function setPolicy(bytes32 policyHash, bytes policyData) external",
+  "function getPolicy(address wallet) external view returns (bytes32, bytes)",
+  "function setCategoryLimit(string category, uint256 limitPerTx) external",
+  "function setCategoryLimitFor(address wallet, string category, uint256 limitPerTx) external",
+  "function validateSpend(address wallet, string category, uint256 amount, bytes32 contextId) external view returns (bool, string)",
+  "function categoryLimits(address wallet, string category) external view returns (uint256)",
+  "function registerWallet(address wallet, address owner) external",
+  "function freezeSpend(address wallet) external",
+  "function unfreeze(address wallet) external",
+  "function authorizeFreezeAgent(address agent) external",
+  "function revokeFreezeAgent(address agent) external",
+  "function queueCapReduction(address wallet, string category, uint256 newCap) external",
+  "function applyCapReduction(address wallet, string category) external",
+] as const;
+
+export const TRUST_REGISTRY_ABI = [
+  "function getScore(address wallet) external view returns (uint256)",
+  "function getEffectiveScore(address wallet) external view returns (uint256)",
+  "function getTrustLevel(address wallet) external view returns (string)",
+  "function initWallet(address wallet) external",
+  "function recordSuccess(address wallet) external",
+  "function recordAnomaly(address wallet) external",
+] as const;
+
+export const INTENT_ATTESTATION_ABI = [
+  "function attest(bytes32 attestationId, string action, string reason, address recipient, uint256 amount) external",
+  "function verify(bytes32 attestationId, address wallet) external view returns (bool)",
+  "function getAttestation(bytes32 attestationId) external view returns (bytes32, address, string, string, address, uint256, uint256)",
+  "event AttestationCreated(bytes32 indexed id, address indexed wallet, string action, string reason, address recipient, uint256 amount, uint256 timestamp)",
+] as const;
+
+export const ARC402_WALLET_ABI = [
+  "function openContext(bytes32 contextId, string taskType) external",
+  "function closeContext() external",
+  "function executeSpend(address recipient, uint256 amount, string category, bytes32 attestationId) external",
+  "function getTrustScore() external view returns (uint256)",
+  "function getActiveContext() external view returns (bytes32, string, uint256, bool)",
+  "function updatePolicy(bytes32 newPolicyId) external",
+] as const;
+
+export const SETTLEMENT_COORDINATOR_ABI = [
+  "function propose(address fromWallet, address toWallet, uint256 amount, bytes32 intentId, uint256 expiresAt) external returns (bytes32)",
+  "function accept(bytes32 proposalId) external",
+  "function reject(bytes32 proposalId, string reason) external",
+  "function execute(bytes32 proposalId) external payable",
+  "function checkExpiry(bytes32 proposalId) external",
+  "function getProposal(bytes32 proposalId) external view returns (address, address, uint256, bytes32, uint256, uint8, string)",
+  "event ProposalCreated(bytes32 indexed proposalId, address indexed from, address indexed to, uint256 amount)",
+] as const;
+
+export const WALLET_FACTORY_ABI = [
+  "function createWallet() external returns (address)",
+  "function getWallets(address owner) external view returns (address[])",
+  "event WalletCreated(address indexed owner, address indexed walletAddress)",
+] as const;
+
+export const AGENT_REGISTRY_ABI = [
+  "function register(string name, string[] capabilities, string serviceType, string endpoint, string metadataURI) external",
+  "function update(string name, string[] capabilities, string serviceType, string endpoint, string metadataURI) external",
+  "function deactivate() external",
+  "function reactivate() external",
+  "function submitHeartbeat(uint32 latencyMs) external",
+  "function setHeartbeatPolicy(uint64 interval, uint64 gracePeriod) external",
+  "function getAgent(address wallet) external view returns (tuple(address wallet, string name, string[] capabilities, string serviceType, string endpoint, string metadataURI, bool active, uint256 registeredAt, uint256 endpointChangedAt, uint256 endpointChangeCount))",
+  "function getOperationalMetrics(address wallet) external view returns (tuple(uint64 heartbeatInterval, uint64 heartbeatGracePeriod, uint64 lastHeartbeatAt, uint64 rollingLatency, uint32 heartbeatCount, uint32 missedHeartbeatCount, uint32 uptimeScore, uint32 responseScore))",
+  "function isRegistered(address wallet) external view returns (bool)",
+  "function isActive(address wallet) external view returns (bool)",
+  "function getCapabilities(address wallet) external view returns (string[])",
+  "function getTrustScore(address wallet) external view returns (uint256)",
+  "function getEndpointStability(address wallet) external view returns (uint256)",
+  "function agentCount() external view returns (uint256)",
+  "function getAgentAtIndex(uint256 index) external view returns (address)",
+] as const;
+
+export const SERVICE_AGREEMENT_ABI = [
+  "function propose(address provider, string serviceType, string description, uint256 price, address token, uint256 deadline, bytes32 deliverablesHash) external payable returns (uint256)",
+  "function accept(uint256 agreementId) external",
+  "function fulfill(uint256 agreementId, bytes32 actualDeliverablesHash) external",
+  "function commitDeliverable(uint256 agreementId, bytes32 deliverableHash) external",
+  "function verifyDeliverable(uint256 agreementId) external",
+  "function autoRelease(uint256 agreementId) external",
+  "function dispute(uint256 agreementId, string reason) external",
+  "function directDispute(uint256 agreementId, uint8 directReason, string reason) external",
+  "function requestRevision(uint256 agreementId, bytes32 feedbackHash, string feedbackURI, bytes32 previousTranscriptHash) external",
+  "function respondToRevision(uint256 agreementId, uint8 responseType, uint256 proposedProviderPayout, bytes32 responseHash, string responseURI, bytes32 previousTranscriptHash) external",
+  "function escalateToDispute(uint256 agreementId, string reason) external",
+  "function canDirectDispute(uint256 agreementId, uint8 directReason) external view returns (bool)",
+  "function submitDisputeEvidence(uint256 agreementId, uint8 evidenceType, bytes32 evidenceHash, string evidenceURI) external",
+  "function nominateArbitrator(uint256 agreementId, address arbitrator) external",
+  "function castArbitrationVote(uint256 agreementId, uint8 vote, uint256 providerAward, uint256 clientAward) external",
+  "function requestHumanEscalation(uint256 agreementId, string reason) external",
+  "function resolveDisputeDetailed(uint256 agreementId, uint8 outcome, uint256 providerAward, uint256 clientAward) external",
+  "function cancel(uint256 agreementId) external",
+  "function expiredCancel(uint256 agreementId) external",
+  "function resolveDispute(uint256 agreementId, bool favorProvider) external",
+  "function getAgreement(uint256 id) external view returns (tuple(uint256 id, address client, address provider, string serviceType, string description, uint256 price, address token, uint256 deadline, bytes32 deliverablesHash, uint8 status, uint256 createdAt, uint256 resolvedAt, uint256 verifyWindowEnd, bytes32 committedHash))",
+  "function getRemediationCase(uint256 agreementId) external view returns (tuple(uint8 cycleCount, uint256 openedAt, uint256 deadlineAt, uint256 lastActionAt, bytes32 latestTranscriptHash, bool active))",
+  "function getRemediationFeedback(uint256 agreementId, uint256 index) external view returns (tuple(uint8 cycle, address author, bytes32 feedbackHash, string feedbackURI, bytes32 previousTranscriptHash, bytes32 transcriptHash, uint256 timestamp))",
+  "function getRemediationResponse(uint256 agreementId, uint256 index) external view returns (tuple(uint8 cycle, address author, uint8 responseType, uint256 proposedProviderPayout, bytes32 responseHash, string responseURI, bytes32 previousTranscriptHash, bytes32 transcriptHash, uint256 timestamp))",
+  "function getDisputeCase(uint256 agreementId) external view returns (tuple(uint256 agreementId, uint256 openedAt, uint256 responseDeadlineAt, uint8 outcome, uint256 providerAward, uint256 clientAward, bool humanReviewRequested, uint256 evidenceCount))",
+  "function getDisputeEvidence(uint256 agreementId, uint256 index) external view returns (tuple(address submitter, uint8 evidenceType, bytes32 evidenceHash, string evidenceURI, uint256 timestamp))",
+  "function getArbitrationCase(uint256 agreementId) external view returns (tuple(uint256 agreementId, address[3] arbitrators, uint8 arbitratorCount, uint8 providerVotes, uint8 clientVotes, uint8 splitVotes, uint8 humanVotes, uint256 selectionDeadlineAt, uint256 decisionDeadlineAt, uint256 splitProviderAward, uint256 splitClientAward, bool finalized, bool humanBackstopUsed))",
+  "function getAgreementsByClient(address client) external view returns (uint256[])",
+  "function getAgreementsByProvider(address provider) external view returns (uint256[])",
+  "function agreementCount() external view returns (uint256)",
+  "function openSessionChannel(address provider, address token, uint256 maxAmount, uint256 ratePerCall, uint256 deadline) external payable returns (bytes32 channelId)",
+  "function closeChannel(bytes32 channelId, bytes finalState) external",
+  "function challengeChannel(bytes32 channelId, bytes latestState) external",
+  "function finaliseChallenge(bytes32 channelId) external",
+  "function reclaimExpiredChannel(bytes32 channelId) external",
+  "function getChannel(bytes32 channelId) external view returns (tuple(address client, address provider, address token, uint256 depositAmount, uint256 settledAmount, uint256 lastSequenceNumber, uint256 deadline, uint256 challengeExpiry, uint8 status))",
+  "function getChannelsByClient(address client) external view returns (bytes32[])",
+  "function getChannelsByProvider(address provider) external view returns (bytes32[])",
+  "function resolveFromArbitration(uint256 agreementId, address recipient, uint256 providerAmount, uint256 clientAmount) external",
+  "function ownerResolveDispute(uint256 agreementId, bool favorProvider) external",
+  "event AgreementProposed(uint256 indexed id, address indexed client, address indexed provider, string serviceType, uint256 price, address token, uint256 deadline)",
+] as const;
+
+export const REPUTATION_ORACLE_ABI = [
+  "function publishSignal(address subject, uint8 signalType, bytes32 capabilityHash, string reason) external",
+  "function getReputation(address subject) external view returns (uint256, uint256, uint256, uint256)",
+  "function getCapabilityReputation(address subject, bytes32 capabilityHash) external view returns (uint256)",
+  "function getSignalCount(address subject) external view returns (uint256)",
+  "function getSignal(address subject, uint256 index) external view returns (tuple(address publisher, address subject, uint8 signalType, bytes32 capabilityHash, string reason, uint256 publisherTrustAtTime, uint256 timestamp, bool autoPublished))",
+] as const;
+
+export const SPONSORSHIP_ATTESTATION_ABI = [
+  "function publish(address agent, uint256 expiresAt) external returns (bytes32)",
+  "function publishWithTier(address agent, uint256 expiresAt, uint8 tier, string evidenceURI) external returns (bytes32)",
+  "function revoke(bytes32 attestationId) external",
+  "function isActive(bytes32 attestationId) external view returns (bool)",
+  "function getActiveAttestation(address sponsor, address agent) external view returns (bytes32)",
+  "function getAttestation(bytes32 attestationId) external view returns (tuple(address sponsor, address agent, uint256 issuedAt, uint256 expiresAt, bool revoked, uint8 tier, string evidenceURI))",
+  "function getSponsorAttestations(address sponsor) external view returns (bytes32[])",
+  "function getAgentAttestations(address agent) external view returns (bytes32[])",
+  "function activeSponsorCount(address sponsor) external view returns (uint256)",
+  "function getHighestTier(address agent) external view returns (uint8)",
+] as const;
+
+export const CAPABILITY_REGISTRY_ABI = [
+  "function registerRoot(string root) external returns (bytes32)",
+  "function setRootStatus(string root, bool active) external",
+  "function claim(string capability) external",
+  "function revoke(string capability) external",
+  "function isRootActive(string root) external view returns (bool)",
+  "function getRoot(string root) external view returns (tuple(bytes32 rootId, string root, bool active))",
+  "function rootCount() external view returns (uint256)",
+  "function getRootAt(uint256 index) external view returns (tuple(bytes32 rootId, string root, bool active))",
+  "function getCapabilities(address agent) external view returns (string[])",
+  "function capabilityCount(address agent) external view returns (uint256)",
+  "function isCapabilityClaimed(address agent, string capability) external view returns (bool)",
+] as const;
+
+export const GOVERNANCE_ABI = [
+  "function submitTransaction(address target, uint256 value, bytes data) external returns (uint256)",
+  "function confirmTransaction(uint256 txId) external",
+  "function revokeConfirmation(uint256 txId) external",
+  "function executeTransaction(uint256 txId) external returns (bytes)",
+  "function getTransaction(uint256 txId) external view returns (tuple(address target, uint256 value, bytes data, bool executed, uint256 confirmationCount))",
+  "function transactionCount() external view returns (uint256)",
+] as const;
+
+export const AGREEMENT_TREE_ABI = [
+  "function registerSubAgreement(uint256 parentAgreementId, uint256 childAgreementId) external",
+  "function getChildren(uint256 agreementId) external view returns (uint256[])",
+  "function getRoot(uint256 agreementId) external view returns (uint256)",
+  "function getPath(uint256 agreementId) external view returns (uint256[])",
+  "function allChildrenSettled(uint256 agreementId) external view returns (bool)",
+  "function getDepth(uint256 agreementId) external view returns (uint256)",
+] as const;
+
+export const getPolicyEngine = (address: string, runner: ContractRunner) => new Contract(address, POLICY_ENGINE_ABI, runner);
+export const getTrustRegistry = (address: string, runner: ContractRunner) => new Contract(address, TRUST_REGISTRY_ABI, runner);
+export const getIntentAttestation = (address: string, runner: ContractRunner) => new Contract(address, INTENT_ATTESTATION_ABI, runner);
+export const getARC402Wallet = (address: string, runner: ContractRunner) => new Contract(address, ARC402_WALLET_ABI, runner);
+export const getSettlementCoordinator = (address: string, runner: ContractRunner) => new Contract(address, SETTLEMENT_COORDINATOR_ABI, runner);
+export const getWalletFactory = (address: string, runner: ContractRunner) => new Contract(address, WALLET_FACTORY_ABI, runner);
+export const getAgentRegistry = (address: string, runner: ContractRunner) => new Contract(address, AGENT_REGISTRY_ABI, runner);
+export const getServiceAgreement = (address: string, runner: ContractRunner) => new Contract(address, SERVICE_AGREEMENT_ABI, runner);
+export const getReputationOracle = (address: string, runner: ContractRunner) => new Contract(address, REPUTATION_ORACLE_ABI, runner);
+export const getSponsorshipAttestation = (address: string, runner: ContractRunner) => new Contract(address, SPONSORSHIP_ATTESTATION_ABI, runner);
+export const getCapabilityRegistry = (address: string, runner: ContractRunner) => new Contract(address, CAPABILITY_REGISTRY_ABI, runner);
+export const getGovernance = (address: string, runner: ContractRunner) => new Contract(address, GOVERNANCE_ABI, runner);

package/src/deliverable.ts

@@ -0,0 +1,231 @@
+import { ContractRunner, ethers } from "ethers";
+import { readFile } from "fs/promises";
+import nacl from "tweetnacl";
+import { SERVICE_AGREEMENT_ABI } from "./contracts";
+
+// ─── Deliverable Types ────────────────────────────────────────────────────────
+
+export enum DeliverableType {
+  text = "text",
+  code = "code",
+  data = "data",
+  media = "media",
+  api = "api",
+  composite = "composite",
+  null = "null",
+}
+
+export interface DeliverableManifestEntry {
+  path: string;
+  hash: string; // keccak256 hex
+  size: number;
+  type?: DeliverableType;
+}
+
+export interface DeliverableManifest {
+  type: DeliverableType.composite;
+  version: string;
+  files: DeliverableManifestEntry[];
+  metadata?: Record<string, unknown>;
+}
+
+// ─── Encrypted Deliverable ────────────────────────────────────────────────────
+
+/**
+ * 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 async function encryptDeliverable(
+  buffer: Buffer,
+  recipientPublicKey: Uint8Array,
+): Promise<EncryptedDeliverable> {
+  const ephemeralKeyPair = nacl.box.keyPair();
+  const nonce = nacl.randomBytes(nacl.box.nonceLength);
+  const ciphertext = nacl.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).
+ */
+export async function decryptDeliverable(
+  encryptedBuffer: Buffer,
+  ephemeralPublicKey: Uint8Array,
+  secretKey: Uint8Array,
+): Promise<Buffer> {
+  const nonce = encryptedBuffer.subarray(0, nacl.box.nonceLength);
+  const ciphertext = encryptedBuffer.subarray(nacl.box.nonceLength);
+  const plaintext = nacl.box.open(ciphertext, nonce, ephemeralPublicKey, secretKey);
+  if (!plaintext) throw new Error("Decryption failed: invalid ciphertext or wrong keys");
+  return Buffer.from(plaintext);
+}
+
+// ─── IPFS helpers ─────────────────────────────────────────────────────────────
+
+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; // ipfs://<cid>
+}
+
+// ─── Standalone functions ─────────────────────────────────────────────────────
+
+/** Compute keccak256 over arbitrary bytes. Returns 0x-prefixed hex. */
+export async function hashDeliverable(buffer: Buffer): Promise<string> {
+  return ethers.keccak256(buffer);
+}
+
+/** Read a file and return its keccak256 hash. */
+export async function hashDeliverableFile(filePath: string): Promise<string> {
+  const buffer = await 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.
+ */
+export async function uploadToIPFS(buffer: Buffer, options?: IPFSUploadOptions): Promise<IPFSUploadResult> {
+  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()) as { Hash: string };
+  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).
+ */
+export async function uploadEncryptedIPFS(
+  buffer: Buffer,
+  recipientPublicKey: Uint8Array,
+  options?: IPFSUploadOptions,
+): Promise<IPFSUploadResult> {
+  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 ────────────────────────────────────────────────────────
+
+export class DeliverableClient {
+  private contract: ethers.Contract;
+
+  constructor(address: string, runner: ContractRunner) {
+    this.contract = new ethers.Contract(address, SERVICE_AGREEMENT_ABI, runner);
+  }
+
+  /** Compute keccak256 over a buffer. Returns 0x-prefixed hex. */
+  async hashDeliverable(buffer: Buffer): Promise<string> {
+    return hashDeliverable(buffer);
+  }
+
+  /** Read a file and return its keccak256 hash. */
+  async hashDeliverableFile(filePath: string): Promise<string> {
+    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: bigint,
+    hash: string,
+    metadataURI: string,
+    signer?: ContractRunner,
+  ): Promise<ethers.TransactionReceipt | null> {
+    const contract = signer ? this.contract.connect(signer) : this.contract;
+    const tx = await (contract as any).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: bigint,
+    localBuffer: Buffer,
+    signer?: ContractRunner,
+  ): Promise<{ match: boolean; onChainHash: string; localHash: string }> {
+    const contract = signer ? this.contract.connect(signer) : this.contract;
+    const agreement = await (contract as any).getAgreement(agreementId);
+    const onChainHash = agreement.deliverableHash as string;
+    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: Buffer, options?: IPFSUploadOptions): Promise<IPFSUploadResult> {
+    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: bigint,
+    buffer: Buffer,
+    options?: IPFSUploadOptions,
+    signer?: ContractRunner,
+  ): Promise<{ hash: string; uri: string; receipt: ethers.TransactionReceipt }> {
+    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: bigint,
+    buffer: Buffer,
+    recipientPublicKey: Uint8Array,
+    options?: IPFSUploadOptions,
+    signer?: ContractRunner,
+  ): Promise<{ hash: string; uri: string; receipt: ethers.TransactionReceipt }> {
+    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 };
+  }
+}