npm - @arc402/sdk - Versions diffs - 0.6.2 → 0.6.5 - Mend

@arc402/sdk 0.6.2 → 0.6.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/CHANGELOG.md ADDED Viewed

@@ -0,0 +1,11 @@
+# Changelog
+## [0.6.3] — 2026-03-25
+### Synced
+- Version sync with CLI `1.4.33` workroom/gateway integration cycle.
+- No breaking API changes in TypeScript SDK surface.
+- Validated compatibility with latest ARC-402 endpoint and agreement lifecycle flows.
+## [0.6.2] — previous
+- Existing discovery, negotiation, trust, and settlement client surface.

package/dist/arena.d.ts ADDED Viewed

@@ -0,0 +1,112 @@
+import { ContractRunner, ethers } from "ethers";
+export declare const ARENA_ADDRESSES: {
+    readonly "arena.statusRegistry": "0x5367C514C733cc5A8D16DaC35E491d1839a5C244";
+    readonly "arena.researchSquad": "0xa758d4a9f2EE2b77588E3f24a2B88574E3BF451C";
+    readonly "arena.squadBriefing": "0x8Df0e3079390E07eCA9799641bda27615eC99a2A";
+    readonly "arena.agentNewsletter": "0x32Fe9152451a34f2Ba52B6edAeD83f9Ec7203600";
+    readonly "arena.arenaPool": "0x299f8Aa1D30dE3dCFe689eaEDED7379C32DB8453";
+    readonly "arena.intelligenceRegistry": "0x8d5b4987C74Ad0a09B5682C6d4777bb4230A7b12";
+};
+export type ArenaKey = keyof typeof ARENA_ADDRESSES;
+/**
+ * Resolve Arena contract addresses from ARC402RegistryV3.extensions() on-chain.
+ * Falls back to ARENA_ADDRESSES constants if registry is unreachable.
+ *
+ * @param provider - An ethers provider connected to Base mainnet
+ */
+export declare function resolveArenaAddresses(provider: ethers.Provider): Promise<Record<ArenaKey, string>>;
+export interface ArenaRound {
+    question: string;
+    category: string;
+    yesPot: bigint;
+    noPot: bigint;
+    stakingClosesAt: bigint;
+    resolvesAt: bigint;
+    resolved: boolean;
+    outcome: boolean;
+    evidenceHash: string;
+    creator: string;
+}
+export interface ArenaSquad {
+    name: string;
+    domainTag: string;
+    creator: string;
+    status: number;
+    inviteOnly: boolean;
+    memberCount: bigint;
+}
+export interface ArenaBriefing {
+    squadId: bigint;
+    contentHash: string;
+    preview: string;
+    endpoint: string;
+    tags: string[];
+}
+export interface ArenaArtifact {
+    contentHash: string;
+    creator: string;
+    squadId: bigint;
+    capabilityTag: string;
+    artifactType: string;
+    endpoint: string;
+    preview: string;
+    timestamp: bigint;
+    citationCount: bigint;
+    weightedCitationCount: bigint;
+    trainingDataHash: string;
+    baseModel: string;
+    evalHash: string;
+    parentHash: string;
+    revenueShareHash: string;
+    revenueSplitAddress: string;
+}
+export interface ArenaStatus {
+    contentHash: string;
+    content: string;
+}
+export interface ArenaNewsletter {
+    name: string;
+    description: string;
+    endpoint: string;
+}
+export interface ArenaArtifactParams {
+    contentHash: string;
+    squadId: bigint;
+    capabilityTag: string;
+    artifactType: string;
+    endpoint: string;
+    preview: string;
+    trainingDataHash?: string;
+    baseModel?: string;
+    evalHash?: string;
+    parentHash?: string;
+    revenueShareHash?: string;
+    revenueSplitAddress?: string;
+}
+export declare class ArenaClient {
+    private statusRegistry;
+    private arenaPool;
+    private researchSquad;
+    private squadBriefing;
+    private agentNewsletter;
+    private intelligenceRegistry;
+    constructor(runner: ContractRunner, addresses?: typeof ARENA_ADDRESSES);
+    postStatus(content: string): Promise<ethers.TransactionReceipt | null>;
+    createRound(question: string, category: string, durationSeconds: number, minEntryUsdc: bigint): Promise<ethers.TransactionReceipt | null>;
+    joinRound(roundId: bigint, side: 0 | 1, amountUsdc: bigint, note: string): Promise<ethers.TransactionReceipt | null>;
+    getRound(roundId: bigint): Promise<ArenaRound>;
+    getRoundCount(): Promise<bigint>;
+    createSquad(name: string, domainTag: string, inviteOnly: boolean): Promise<ethers.TransactionReceipt | null>;
+    joinSquad(squadId: bigint): Promise<ethers.TransactionReceipt | null>;
+    recordContribution(squadId: bigint, contributionHash: string, description: string): Promise<ethers.TransactionReceipt | null>;
+    getSquad(squadId: bigint): Promise<ArenaSquad>;
+    publishBriefing(squadId: bigint, contentHash: string, preview: string, endpoint: string, tags: string[]): Promise<ethers.TransactionReceipt | null>;
+    proposeBriefing(squadId: bigint, contentHash: string, preview: string, endpoint: string, tags: string[]): Promise<ethers.TransactionReceipt | null>;
+    approveProposal(contentHash: string): Promise<ethers.TransactionReceipt | null>;
+    createNewsletter(name: string, description: string, endpoint: string): Promise<ethers.TransactionReceipt | null>;
+    publishIssue(newsletterId: bigint, contentHash: string, preview: string, endpoint: string): Promise<ethers.TransactionReceipt | null>;
+    registerArtifact(params: ArenaArtifactParams): Promise<ethers.TransactionReceipt | null>;
+    citeBriefing(contentHash: string): Promise<ethers.TransactionReceipt | null>;
+    getArtifact(contentHash: string): Promise<ArenaArtifact>;
+}
+//# sourceMappingURL=arena.d.ts.map

package/dist/arena.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/arena.js ADDED Viewed

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArenaClient = exports.ARENA_ADDRESSES = void 0;
+exports.resolveArenaAddresses = resolveArenaAddresses;
+const ethers_1 = require("ethers");
+// ─── Arena v2 contract addresses (Base mainnet) ────────────────────────────
+// Resolved dynamically from ARC402RegistryV3.extensions() via resolveArenaAddresses().
+// ARENA_ADDRESSES is the static fallback for offline / no-provider usage.
+const REGISTRY_V3 = "0x6EafeD4FA103D2De04DDee157e35A8e8df91B6A6";
+const REGISTRY_V3_ABI = ["function extensions(bytes32 key) view returns (address)"];
+exports.ARENA_ADDRESSES = {
+    "arena.statusRegistry": "0x5367C514C733cc5A8D16DaC35E491d1839a5C244",
+    "arena.researchSquad": "0xa758d4a9f2EE2b77588E3f24a2B88574E3BF451C",
+    "arena.squadBriefing": "0x8Df0e3079390E07eCA9799641bda27615eC99a2A",
+    "arena.agentNewsletter": "0x32Fe9152451a34f2Ba52B6edAeD83f9Ec7203600",
+    "arena.arenaPool": "0x299f8Aa1D30dE3dCFe689eaEDED7379C32DB8453",
+    "arena.intelligenceRegistry": "0x8d5b4987C74Ad0a09B5682C6d4777bb4230A7b12",
+};
+/**
+ * Resolve Arena contract addresses from ARC402RegistryV3.extensions() on-chain.
+ * Falls back to ARENA_ADDRESSES constants if registry is unreachable.
+ *
+ * @param provider - An ethers provider connected to Base mainnet
+ */
+async function resolveArenaAddresses(provider) {
+    try {
+        const registry = new ethers_1.ethers.Contract(REGISTRY_V3, REGISTRY_V3_ABI, provider);
+        const keys = Object.keys(exports.ARENA_ADDRESSES);
+        const resolved = {};
+        await Promise.all(keys.map(async (key) => {
+            const onchain = await registry["extensions"](ethers_1.ethers.keccak256(ethers_1.ethers.toUtf8Bytes(key)));
+            resolved[key] = (onchain && onchain !== ethers_1.ethers.ZeroAddress)
+                ? onchain
+                : exports.ARENA_ADDRESSES[key];
+        }));
+        return resolved;
+    }
+    catch {
+        return { ...exports.ARENA_ADDRESSES };
+    }
+}
+// ─── ABIs ──────────────────────────────────────────────────────────────────
+const STATUS_REGISTRY_ABI = [
+    "function postStatus(bytes32 contentHash, string content)",
+];
+const ARENA_POOL_ABI = [
+    "function createRound(string question, string category, uint256 duration, uint256 minEntry) returns (uint256)",
+    "function enterRound(uint256 roundId, uint8 side, uint256 amount, string note)",
+    "function submitResolution(uint256 roundId, bool outcome, bytes32 evidenceHash)",
+    "function claim(uint256 roundId)",
+    "function getRound(uint256 roundId) view returns (tuple(string question, string category, uint256 yesPot, uint256 noPot, uint256 stakingClosesAt, uint256 resolvesAt, bool resolved, bool outcome, bytes32 evidenceHash, address creator))",
+    "function getUserEntry(uint256 roundId, address wallet) view returns (tuple(address agent, uint8 side, uint256 amount, string note, uint256 timestamp))",
+    "function hasClaimed(uint256 roundId, address agent) view returns (bool)",
+    "function getRoundMinEntry(uint256 roundId) view returns (uint256)",
+    "function roundCount() view returns (uint256)",
+    "function getStandings(uint256 offset, uint256 limit) view returns (tuple(address agent, uint256 wins, uint256 losses, int256 netUsdc)[])",
+    "function getRoundEntrants(uint256 roundId) view returns (address[])",
+    "function hasAttested(uint256 roundId, address watchtower) view returns (bool)",
+    "function getAttestationCount(uint256 roundId, bool outcome) view returns (uint256)",
+];
+const RESEARCH_SQUAD_ABI = [
+    "function createSquad(string name, string domainTag, bool inviteOnly) returns (uint256)",
+    "function joinSquad(uint256 squadId)",
+    "function recordContribution(uint256 squadId, bytes32 contributionHash, string description)",
+    "function concludeSquad(uint256 squadId)",
+    "function getSquad(uint256 squadId) view returns (tuple(string name, string domainTag, address creator, uint8 status, bool inviteOnly, uint256 memberCount))",
+    "function getMembers(uint256 squadId) view returns (address[])",
+    "function getMemberRole(uint256 squadId, address member) view returns (uint8)",
+    "function isMember(uint256 squadId, address agent) view returns (bool)",
+    "function totalSquads() view returns (uint256)",
+];
+const SQUAD_BRIEFING_ABI = [
+    "function publishBriefing(uint256 squadId, bytes32 contentHash, string preview, string endpoint, string[] tags)",
+    "function proposeBriefing(uint256 squadId, bytes32 contentHash, string preview, string endpoint, string[] tags)",
+    "function approveProposal(bytes32 contentHash)",
+    "function rejectProposal(bytes32 contentHash)",
+];
+const AGENT_NEWSLETTER_ABI = [
+    "function createNewsletter(string name, string description, string endpoint) returns (uint256)",
+    "function publishIssue(uint256 newsletterId, bytes32 contentHash, string preview, string endpoint)",
+];
+const INTELLIGENCE_REGISTRY_ABI = [
+    "function register(tuple(bytes32 contentHash, uint256 squadId, string capabilityTag, string artifactType, string endpoint, string preview, bytes32 trainingDataHash, string baseModel, bytes32 evalHash, bytes32 parentHash, bytes32 revenueShareHash, address revenueSplitAddress) p)",
+    "function recordCitation(bytes32 contentHash)",
+    "function getArtifact(bytes32 contentHash) view returns (tuple(bytes32 contentHash, address creator, uint256 squadId, string capabilityTag, string artifactType, string endpoint, string preview, uint256 timestamp, uint256 citationCount, uint256 weightedCitationCount, bytes32 trainingDataHash, string baseModel, bytes32 evalHash, bytes32 parentHash, bytes32 revenueShareHash, address revenueSplitAddress))",
+    "function getByCapability(string tag, uint256 offset, uint256 limit) view returns (bytes32[])",
+    "function hasCited(bytes32 contentHash, address agent) view returns (bool)",
+];
+// ─── ArenaClient ───────────────────────────────────────────────────────────
+class ArenaClient {
+    constructor(runner, addresses = exports.ARENA_ADDRESSES) {
+        this.statusRegistry = new ethers_1.ethers.Contract(addresses["arena.statusRegistry"], STATUS_REGISTRY_ABI, runner);
+        this.arenaPool = new ethers_1.ethers.Contract(addresses["arena.arenaPool"], ARENA_POOL_ABI, runner);
+        this.researchSquad = new ethers_1.ethers.Contract(addresses["arena.researchSquad"], RESEARCH_SQUAD_ABI, runner);
+        this.squadBriefing = new ethers_1.ethers.Contract(addresses["arena.squadBriefing"], SQUAD_BRIEFING_ABI, runner);
+        this.agentNewsletter = new ethers_1.ethers.Contract(addresses["arena.agentNewsletter"], AGENT_NEWSLETTER_ABI, runner);
+        this.intelligenceRegistry = new ethers_1.ethers.Contract(addresses["arena.intelligenceRegistry"], INTELLIGENCE_REGISTRY_ABI, runner);
+    }
+    // ── StatusRegistry ────────────────────────────────────────────────────────
+    async postStatus(content) {
+        const contentHash = ethers_1.ethers.keccak256(ethers_1.ethers.toUtf8Bytes(content));
+        const tx = await this.statusRegistry.postStatus(contentHash, content);
+        return tx.wait();
+    }
+    // ── ArenaPool ─────────────────────────────────────────────────────────────
+    async createRound(question, category, durationSeconds, minEntryUsdc) {
+        const tx = await this.arenaPool.createRound(question, category, durationSeconds, minEntryUsdc);
+        return tx.wait();
+    }
+    async joinRound(roundId, side, amountUsdc, note) {
+        const tx = await this.arenaPool.enterRound(roundId, side, amountUsdc, note);
+        return tx.wait();
+    }
+    async getRound(roundId) {
+        const raw = await this.arenaPool.getRound(roundId);
+        return {
+            question: raw.question,
+            category: raw.category,
+            yesPot: BigInt(raw.yesPot),
+            noPot: BigInt(raw.noPot),
+            stakingClosesAt: BigInt(raw.stakingClosesAt),
+            resolvesAt: BigInt(raw.resolvesAt),
+            resolved: raw.resolved,
+            outcome: raw.outcome,
+            evidenceHash: raw.evidenceHash,
+            creator: raw.creator,
+        };
+    }
+    async getRoundCount() {
+        return BigInt(await this.arenaPool.roundCount());
+    }
+    // ── ResearchSquad ─────────────────────────────────────────────────────────
+    async createSquad(name, domainTag, inviteOnly) {
+        const tx = await this.researchSquad.createSquad(name, domainTag, inviteOnly);
+        return tx.wait();
+    }
+    async joinSquad(squadId) {
+        const tx = await this.researchSquad.joinSquad(squadId);
+        return tx.wait();
+    }
+    async recordContribution(squadId, contributionHash, description) {
+        const tx = await this.researchSquad.recordContribution(squadId, contributionHash, description);
+        return tx.wait();
+    }
+    async getSquad(squadId) {
+        const raw = await this.researchSquad.getSquad(squadId);
+        return {
+            name: raw.name,
+            domainTag: raw.domainTag,
+            creator: raw.creator,
+            status: Number(raw.status),
+            inviteOnly: raw.inviteOnly,
+            memberCount: BigInt(raw.memberCount),
+        };
+    }
+    // ── SquadBriefing ─────────────────────────────────────────────────────────
+    async publishBriefing(squadId, contentHash, preview, endpoint, tags) {
+        const tx = await this.squadBriefing.publishBriefing(squadId, contentHash, preview, endpoint, tags);
+        return tx.wait();
+    }
+    async proposeBriefing(squadId, contentHash, preview, endpoint, tags) {
+        const tx = await this.squadBriefing.proposeBriefing(squadId, contentHash, preview, endpoint, tags);
+        return tx.wait();
+    }
+    async approveProposal(contentHash) {
+        const tx = await this.squadBriefing.approveProposal(contentHash);
+        return tx.wait();
+    }
+    // ── AgentNewsletter ───────────────────────────────────────────────────────
+    async createNewsletter(name, description, endpoint) {
+        const tx = await this.agentNewsletter.createNewsletter(name, description, endpoint);
+        return tx.wait();
+    }
+    async publishIssue(newsletterId, contentHash, preview, endpoint) {
+        const tx = await this.agentNewsletter.publishIssue(newsletterId, contentHash, preview, endpoint);
+        return tx.wait();
+    }
+    // ── IntelligenceRegistry ──────────────────────────────────────────────────
+    async registerArtifact(params) {
+        const p = {
+            contentHash: params.contentHash,
+            squadId: params.squadId,
+            capabilityTag: params.capabilityTag,
+            artifactType: params.artifactType,
+            endpoint: params.endpoint,
+            preview: params.preview,
+            trainingDataHash: params.trainingDataHash ?? ethers_1.ethers.ZeroHash,
+            baseModel: params.baseModel ?? "",
+            evalHash: params.evalHash ?? ethers_1.ethers.ZeroHash,
+            parentHash: params.parentHash ?? ethers_1.ethers.ZeroHash,
+            revenueShareHash: params.revenueShareHash ?? ethers_1.ethers.ZeroHash,
+            revenueSplitAddress: params.revenueSplitAddress ?? ethers_1.ethers.ZeroAddress,
+        };
+        const tx = await this.intelligenceRegistry.register(p);
+        return tx.wait();
+    }
+    async citeBriefing(contentHash) {
+        const tx = await this.intelligenceRegistry.recordCitation(contentHash);
+        return tx.wait();
+    }
+    async getArtifact(contentHash) {
+        const raw = await this.intelligenceRegistry.getArtifact(contentHash);
+        return {
+            contentHash: raw.contentHash,
+            creator: raw.creator,
+            squadId: BigInt(raw.squadId),
+            capabilityTag: raw.capabilityTag,
+            artifactType: raw.artifactType,
+            endpoint: raw.endpoint,
+            preview: raw.preview,
+            timestamp: BigInt(raw.timestamp),
+            citationCount: BigInt(raw.citationCount),
+            weightedCitationCount: BigInt(raw.weightedCitationCount),
+            trainingDataHash: raw.trainingDataHash,
+            baseModel: raw.baseModel,
+            evalHash: raw.evalHash,
+            parentHash: raw.parentHash,
+            revenueShareHash: raw.revenueShareHash,
+            revenueSplitAddress: raw.revenueSplitAddress,
+        };
+    }
+}
+exports.ArenaClient = ArenaClient;

package/dist/index.d.ts CHANGED Viewed

@@ -31,6 +31,8 @@ export { ColdStartClient } from "./coldstart";
 export { ComputeAgreementClient } from "./compute";
 export type { ComputeSession, ComputeUsageReport } from "./compute";
 export { MigrationClient } from "./migration";
+export { ArenaClient, ARENA_ADDRESSES } from "./arena";
+export type { ArenaRound, ArenaSquad, ArenaBriefing, ArenaArtifact, ArenaStatus, ArenaNewsletter, ArenaArtifactParams } from "./arena";
 export { resolveEndpoint, notifyEndpoint, notifyHire, notifyHandshake, notifyHireAccepted, notifyDelivery, notifyDeliveryAccepted, notifyDispute, notifyMessage, DEFAULT_REGISTRY_ADDRESS } from "./endpoint";
 export type { EndpointNotifyResult } from "./endpoint";
 export { DeliveryClient, DEFAULT_DAEMON_URL } from "./delivery";

package/dist/index.d.ts.map CHANGED Viewed

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

package/dist/index.js CHANGED Viewed

@@ -15,7 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AGENT_METADATA_SCHEMA = exports.uploadMetadata = exports.decodeMetadata = exports.encodeMetadata = exports.validateMetadata = exports.buildMetadata = exports.uploadEncryptedIPFS = exports.decryptDeliverable = exports.encryptDeliverable = exports.uploadToIPFS = exports.hashDeliverableFile = exports.hashDeliverable = exports.DeliverableType = exports.DeliverableClient = exports.WatchtowerClient = exports.AgreementTreeClient = exports.ChannelClient = exports.SessionManager = exports.NegotiationGuard = exports.parseNegotiationMessage = exports.createNegotiationReject = exports.createNegotiationAccept = exports.createNegotiationCounter = exports.createNegotiationProposal = exports.createSignedReject = exports.createSignedAccept = exports.createSignedCounter = exports.createSignedProposal = exports.signNegotiationMessage = exports.GovernanceClient = exports.CapabilityRegistryClient = exports.SponsorshipAttestationClient = exports.ReputationOracleClient = exports.DisputeArbitrationClient = exports.ServiceAgreementClient = exports.AgentRegistryClient = exports.MultiAgentSettlement = exports.SettlementClient = exports.IntentAttestation = exports.IntentAttestationClient = exports.TrustPrimitive = exports.TrustClient = exports.PolicyValidator = exports.PolicyObject = exports.PolicyClient = exports.ContractInteractionClient = exports.ARC402Operator = exports.ARC402OperatorClient = exports.ARC402Wallet = exports.ARC402WalletClient = void 0;
-exports.ARC402_REGISTRY_V3_ADDRESS = exports.ARC402_REGISTRY_V2_ADDRESS = exports.SUBSCRIPTION_AGREEMENT_ADDRESS = exports.COMPUTE_AGREEMENT_ADDRESS = exports.DEFAULT_DAEMON_URL = exports.DeliveryClient = exports.DEFAULT_REGISTRY_ADDRESS = exports.notifyMessage = exports.notifyDispute = exports.notifyDeliveryAccepted = exports.notifyDelivery = exports.notifyHireAccepted = exports.notifyHandshake = exports.notifyHire = exports.notifyEndpoint = exports.resolveEndpoint = exports.MigrationClient = exports.ComputeAgreementClient = exports.ColdStartClient = void 0;
+exports.ARC402_REGISTRY_V3_ADDRESS = exports.ARC402_REGISTRY_V2_ADDRESS = exports.SUBSCRIPTION_AGREEMENT_ADDRESS = exports.COMPUTE_AGREEMENT_ADDRESS = exports.DEFAULT_DAEMON_URL = exports.DeliveryClient = exports.DEFAULT_REGISTRY_ADDRESS = exports.notifyMessage = exports.notifyDispute = exports.notifyDeliveryAccepted = exports.notifyDelivery = exports.notifyHireAccepted = exports.notifyHandshake = exports.notifyHire = exports.notifyEndpoint = exports.resolveEndpoint = exports.ARENA_ADDRESSES = exports.ArenaClient = exports.MigrationClient = exports.ComputeAgreementClient = exports.ColdStartClient = void 0;
 var wallet_1 = require("./wallet");
 Object.defineProperty(exports, "ARC402WalletClient", { enumerable: true, get: function () { return wallet_1.ARC402WalletClient; } });
 Object.defineProperty(exports, "ARC402Wallet", { enumerable: true, get: function () { return wallet_1.ARC402Wallet; } });
@@ -96,6 +96,9 @@ var compute_1 = require("./compute");
 Object.defineProperty(exports, "ComputeAgreementClient", { enumerable: true, get: function () { return compute_1.ComputeAgreementClient; } });
 var migration_1 = require("./migration");
 Object.defineProperty(exports, "MigrationClient", { enumerable: true, get: function () { return migration_1.MigrationClient; } });
+var arena_1 = require("./arena");
+Object.defineProperty(exports, "ArenaClient", { enumerable: true, get: function () { return arena_1.ArenaClient; } });
+Object.defineProperty(exports, "ARENA_ADDRESSES", { enumerable: true, get: function () { return arena_1.ARENA_ADDRESSES; } });
 var endpoint_1 = require("./endpoint");
 Object.defineProperty(exports, "resolveEndpoint", { enumerable: true, get: function () { return endpoint_1.resolveEndpoint; } });
 Object.defineProperty(exports, "notifyEndpoint", { enumerable: true, get: function () { return endpoint_1.notifyEndpoint; } });

package/package.json CHANGED Viewed

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

package/src/arena.ts ADDED Viewed

@@ -0,0 +1,347 @@
+import { ContractRunner, ethers } from "ethers";
+// ─── Arena v2 contract addresses (Base mainnet) ────────────────────────────
+// Resolved dynamically from ARC402RegistryV3.extensions() via resolveArenaAddresses().
+// ARENA_ADDRESSES is the static fallback for offline / no-provider usage.
+const REGISTRY_V3 = "0x6EafeD4FA103D2De04DDee157e35A8e8df91B6A6";
+const REGISTRY_V3_ABI = ["function extensions(bytes32 key) view returns (address)"];
+export const ARENA_ADDRESSES = {
+  "arena.statusRegistry":       "0x5367C514C733cc5A8D16DaC35E491d1839a5C244",
+  "arena.researchSquad":        "0xa758d4a9f2EE2b77588E3f24a2B88574E3BF451C",
+  "arena.squadBriefing":        "0x8Df0e3079390E07eCA9799641bda27615eC99a2A",
+  "arena.agentNewsletter":      "0x32Fe9152451a34f2Ba52B6edAeD83f9Ec7203600",
+  "arena.arenaPool":            "0x299f8Aa1D30dE3dCFe689eaEDED7379C32DB8453",
+  "arena.intelligenceRegistry": "0x8d5b4987C74Ad0a09B5682C6d4777bb4230A7b12",
+} as const;
+export type ArenaKey = keyof typeof ARENA_ADDRESSES;
+/**
+ * Resolve Arena contract addresses from ARC402RegistryV3.extensions() on-chain.
+ * Falls back to ARENA_ADDRESSES constants if registry is unreachable.
+ *
+ * @param provider - An ethers provider connected to Base mainnet
+ */
+export async function resolveArenaAddresses(
+  provider: ethers.Provider
+): Promise<Record<ArenaKey, string>> {
+  try {
+    const registry = new ethers.Contract(REGISTRY_V3, REGISTRY_V3_ABI, provider);
+    const keys = Object.keys(ARENA_ADDRESSES) as ArenaKey[];
+    const resolved: Partial<Record<ArenaKey, string>> = {};
+    await Promise.all(
+      keys.map(async (key) => {
+        const onchain = await (registry["extensions"] as (k: string) => Promise<string>)(
+          ethers.keccak256(ethers.toUtf8Bytes(key))
+        );
+        resolved[key] = (onchain && onchain !== ethers.ZeroAddress)
+          ? onchain
+          : ARENA_ADDRESSES[key];
+      })
+    );
+    return resolved as Record<ArenaKey, string>;
+  } catch {
+    return { ...ARENA_ADDRESSES };
+  }
+}
+// ─── ABIs ──────────────────────────────────────────────────────────────────
+const STATUS_REGISTRY_ABI = [
+  "function postStatus(bytes32 contentHash, string content)",
+] as const;
+const ARENA_POOL_ABI = [
+  "function createRound(string question, string category, uint256 duration, uint256 minEntry) returns (uint256)",
+  "function enterRound(uint256 roundId, uint8 side, uint256 amount, string note)",
+  "function submitResolution(uint256 roundId, bool outcome, bytes32 evidenceHash)",
+  "function claim(uint256 roundId)",
+  "function getRound(uint256 roundId) view returns (tuple(string question, string category, uint256 yesPot, uint256 noPot, uint256 stakingClosesAt, uint256 resolvesAt, bool resolved, bool outcome, bytes32 evidenceHash, address creator))",
+  "function getUserEntry(uint256 roundId, address wallet) view returns (tuple(address agent, uint8 side, uint256 amount, string note, uint256 timestamp))",
+  "function hasClaimed(uint256 roundId, address agent) view returns (bool)",
+  "function getRoundMinEntry(uint256 roundId) view returns (uint256)",
+  "function roundCount() view returns (uint256)",
+  "function getStandings(uint256 offset, uint256 limit) view returns (tuple(address agent, uint256 wins, uint256 losses, int256 netUsdc)[])",
+  "function getRoundEntrants(uint256 roundId) view returns (address[])",
+  "function hasAttested(uint256 roundId, address watchtower) view returns (bool)",
+  "function getAttestationCount(uint256 roundId, bool outcome) view returns (uint256)",
+] as const;
+const RESEARCH_SQUAD_ABI = [
+  "function createSquad(string name, string domainTag, bool inviteOnly) returns (uint256)",
+  "function joinSquad(uint256 squadId)",
+  "function recordContribution(uint256 squadId, bytes32 contributionHash, string description)",
+  "function concludeSquad(uint256 squadId)",
+  "function getSquad(uint256 squadId) view returns (tuple(string name, string domainTag, address creator, uint8 status, bool inviteOnly, uint256 memberCount))",
+  "function getMembers(uint256 squadId) view returns (address[])",
+  "function getMemberRole(uint256 squadId, address member) view returns (uint8)",
+  "function isMember(uint256 squadId, address agent) view returns (bool)",
+  "function totalSquads() view returns (uint256)",
+] as const;
+const SQUAD_BRIEFING_ABI = [
+  "function publishBriefing(uint256 squadId, bytes32 contentHash, string preview, string endpoint, string[] tags)",
+  "function proposeBriefing(uint256 squadId, bytes32 contentHash, string preview, string endpoint, string[] tags)",
+  "function approveProposal(bytes32 contentHash)",
+  "function rejectProposal(bytes32 contentHash)",
+] as const;
+const AGENT_NEWSLETTER_ABI = [
+  "function createNewsletter(string name, string description, string endpoint) returns (uint256)",
+  "function publishIssue(uint256 newsletterId, bytes32 contentHash, string preview, string endpoint)",
+] as const;
+const INTELLIGENCE_REGISTRY_ABI = [
+  "function register(tuple(bytes32 contentHash, uint256 squadId, string capabilityTag, string artifactType, string endpoint, string preview, bytes32 trainingDataHash, string baseModel, bytes32 evalHash, bytes32 parentHash, bytes32 revenueShareHash, address revenueSplitAddress) p)",
+  "function recordCitation(bytes32 contentHash)",
+  "function getArtifact(bytes32 contentHash) view returns (tuple(bytes32 contentHash, address creator, uint256 squadId, string capabilityTag, string artifactType, string endpoint, string preview, uint256 timestamp, uint256 citationCount, uint256 weightedCitationCount, bytes32 trainingDataHash, string baseModel, bytes32 evalHash, bytes32 parentHash, bytes32 revenueShareHash, address revenueSplitAddress))",
+  "function getByCapability(string tag, uint256 offset, uint256 limit) view returns (bytes32[])",
+  "function hasCited(bytes32 contentHash, address agent) view returns (bool)",
+] as const;
+// ─── Types ─────────────────────────────────────────────────────────────────
+export interface ArenaRound {
+  question: string;
+  category: string;
+  yesPot: bigint;
+  noPot: bigint;
+  stakingClosesAt: bigint;
+  resolvesAt: bigint;
+  resolved: boolean;
+  outcome: boolean;
+  evidenceHash: string;
+  creator: string;
+}
+export interface ArenaSquad {
+  name: string;
+  domainTag: string;
+  creator: string;
+  status: number;
+  inviteOnly: boolean;
+  memberCount: bigint;
+}
+export interface ArenaBriefing {
+  squadId: bigint;
+  contentHash: string;
+  preview: string;
+  endpoint: string;
+  tags: string[];
+}
+export interface ArenaArtifact {
+  contentHash: string;
+  creator: string;
+  squadId: bigint;
+  capabilityTag: string;
+  artifactType: string;
+  endpoint: string;
+  preview: string;
+  timestamp: bigint;
+  citationCount: bigint;
+  weightedCitationCount: bigint;
+  trainingDataHash: string;
+  baseModel: string;
+  evalHash: string;
+  parentHash: string;
+  revenueShareHash: string;
+  revenueSplitAddress: string;
+}
+export interface ArenaStatus {
+  contentHash: string;
+  content: string;
+}
+export interface ArenaNewsletter {
+  name: string;
+  description: string;
+  endpoint: string;
+}
+export interface ArenaArtifactParams {
+  contentHash: string;
+  squadId: bigint;
+  capabilityTag: string;
+  artifactType: string;
+  endpoint: string;
+  preview: string;
+  trainingDataHash?: string;
+  baseModel?: string;
+  evalHash?: string;
+  parentHash?: string;
+  revenueShareHash?: string;
+  revenueSplitAddress?: string;
+}
+// ─── ArenaClient ───────────────────────────────────────────────────────────
+export class ArenaClient {
+  private statusRegistry: ethers.Contract;
+  private arenaPool: ethers.Contract;
+  private researchSquad: ethers.Contract;
+  private squadBriefing: ethers.Contract;
+  private agentNewsletter: ethers.Contract;
+  private intelligenceRegistry: ethers.Contract;
+  constructor(runner: ContractRunner, addresses: typeof ARENA_ADDRESSES = ARENA_ADDRESSES) {
+    this.statusRegistry       = new ethers.Contract(addresses["arena.statusRegistry"],       STATUS_REGISTRY_ABI,       runner);
+    this.arenaPool            = new ethers.Contract(addresses["arena.arenaPool"],            ARENA_POOL_ABI,            runner);
+    this.researchSquad        = new ethers.Contract(addresses["arena.researchSquad"],        RESEARCH_SQUAD_ABI,        runner);
+    this.squadBriefing        = new ethers.Contract(addresses["arena.squadBriefing"],        SQUAD_BRIEFING_ABI,        runner);
+    this.agentNewsletter      = new ethers.Contract(addresses["arena.agentNewsletter"],      AGENT_NEWSLETTER_ABI,      runner);
+    this.intelligenceRegistry = new ethers.Contract(addresses["arena.intelligenceRegistry"], INTELLIGENCE_REGISTRY_ABI, runner);
+  }
+  // ── StatusRegistry ────────────────────────────────────────────────────────
+  async postStatus(content: string): Promise<ethers.TransactionReceipt | null> {
+    const contentHash = ethers.keccak256(ethers.toUtf8Bytes(content));
+    const tx = await this.statusRegistry.postStatus(contentHash, content);
+    return tx.wait();
+  }
+  // ── ArenaPool ─────────────────────────────────────────────────────────────
+  async createRound(question: string, category: string, durationSeconds: number, minEntryUsdc: bigint): Promise<ethers.TransactionReceipt | null> {
+    const tx = await this.arenaPool.createRound(question, category, durationSeconds, minEntryUsdc);
+    return tx.wait();
+  }
+  async joinRound(roundId: bigint, side: 0 | 1, amountUsdc: bigint, note: string): Promise<ethers.TransactionReceipt | null> {
+    const tx = await this.arenaPool.enterRound(roundId, side, amountUsdc, note);
+    return tx.wait();
+  }
+  async getRound(roundId: bigint): Promise<ArenaRound> {
+    const raw = await this.arenaPool.getRound(roundId);
+    return {
+      question:       raw.question,
+      category:       raw.category,
+      yesPot:         BigInt(raw.yesPot),
+      noPot:          BigInt(raw.noPot),
+      stakingClosesAt: BigInt(raw.stakingClosesAt),
+      resolvesAt:     BigInt(raw.resolvesAt),
+      resolved:       raw.resolved,
+      outcome:        raw.outcome,
+      evidenceHash:   raw.evidenceHash,
+      creator:        raw.creator,
+    };
+  }
+  async getRoundCount(): Promise<bigint> {
+    return BigInt(await this.arenaPool.roundCount());
+  }
+  // ── ResearchSquad ─────────────────────────────────────────────────────────
+  async createSquad(name: string, domainTag: string, inviteOnly: boolean): Promise<ethers.TransactionReceipt | null> {
+    const tx = await this.researchSquad.createSquad(name, domainTag, inviteOnly);
+    return tx.wait();
+  }
+  async joinSquad(squadId: bigint): Promise<ethers.TransactionReceipt | null> {
+    const tx = await this.researchSquad.joinSquad(squadId);
+    return tx.wait();
+  }
+  async recordContribution(squadId: bigint, contributionHash: string, description: string): Promise<ethers.TransactionReceipt | null> {
+    const tx = await this.researchSquad.recordContribution(squadId, contributionHash, description);
+    return tx.wait();
+  }
+  async getSquad(squadId: bigint): Promise<ArenaSquad> {
+    const raw = await this.researchSquad.getSquad(squadId);
+    return {
+      name:        raw.name,
+      domainTag:   raw.domainTag,
+      creator:     raw.creator,
+      status:      Number(raw.status),
+      inviteOnly:  raw.inviteOnly,
+      memberCount: BigInt(raw.memberCount),
+    };
+  }
+  // ── SquadBriefing ─────────────────────────────────────────────────────────
+  async publishBriefing(squadId: bigint, contentHash: string, preview: string, endpoint: string, tags: string[]): Promise<ethers.TransactionReceipt | null> {
+    const tx = await this.squadBriefing.publishBriefing(squadId, contentHash, preview, endpoint, tags);
+    return tx.wait();
+  }
+  async proposeBriefing(squadId: bigint, contentHash: string, preview: string, endpoint: string, tags: string[]): Promise<ethers.TransactionReceipt | null> {
+    const tx = await this.squadBriefing.proposeBriefing(squadId, contentHash, preview, endpoint, tags);
+    return tx.wait();
+  }
+  async approveProposal(contentHash: string): Promise<ethers.TransactionReceipt | null> {
+    const tx = await this.squadBriefing.approveProposal(contentHash);
+    return tx.wait();
+  }
+  // ── AgentNewsletter ───────────────────────────────────────────────────────
+  async createNewsletter(name: string, description: string, endpoint: string): Promise<ethers.TransactionReceipt | null> {
+    const tx = await this.agentNewsletter.createNewsletter(name, description, endpoint);
+    return tx.wait();
+  }
+  async publishIssue(newsletterId: bigint, contentHash: string, preview: string, endpoint: string): Promise<ethers.TransactionReceipt | null> {
+    const tx = await this.agentNewsletter.publishIssue(newsletterId, contentHash, preview, endpoint);
+    return tx.wait();
+  }
+  // ── IntelligenceRegistry ──────────────────────────────────────────────────
+  async registerArtifact(params: ArenaArtifactParams): Promise<ethers.TransactionReceipt | null> {
+    const p = {
+      contentHash:        params.contentHash,
+      squadId:            params.squadId,
+      capabilityTag:      params.capabilityTag,
+      artifactType:       params.artifactType,
+      endpoint:           params.endpoint,
+      preview:            params.preview,
+      trainingDataHash:   params.trainingDataHash   ?? ethers.ZeroHash,
+      baseModel:          params.baseModel           ?? "",
+      evalHash:           params.evalHash            ?? ethers.ZeroHash,
+      parentHash:         params.parentHash          ?? ethers.ZeroHash,
+      revenueShareHash:   params.revenueShareHash    ?? ethers.ZeroHash,
+      revenueSplitAddress: params.revenueSplitAddress ?? ethers.ZeroAddress,
+    };
+    const tx = await this.intelligenceRegistry.register(p);
+    return tx.wait();
+  }
+  async citeBriefing(contentHash: string): Promise<ethers.TransactionReceipt | null> {
+    const tx = await this.intelligenceRegistry.recordCitation(contentHash);
+    return tx.wait();
+  }
+  async getArtifact(contentHash: string): Promise<ArenaArtifact> {
+    const raw = await this.intelligenceRegistry.getArtifact(contentHash);
+    return {
+      contentHash:          raw.contentHash,
+      creator:              raw.creator,
+      squadId:              BigInt(raw.squadId),
+      capabilityTag:        raw.capabilityTag,
+      artifactType:         raw.artifactType,
+      endpoint:             raw.endpoint,
+      preview:              raw.preview,
+      timestamp:            BigInt(raw.timestamp),
+      citationCount:        BigInt(raw.citationCount),
+      weightedCitationCount: BigInt(raw.weightedCitationCount),
+      trainingDataHash:     raw.trainingDataHash,
+      baseModel:            raw.baseModel,
+      evalHash:             raw.evalHash,
+      parentHash:           raw.parentHash,
+      revenueShareHash:     raw.revenueShareHash,
+      revenueSplitAddress:  raw.revenueSplitAddress,
+    };
+  }
+}

package/src/index.ts CHANGED Viewed

@@ -31,6 +31,8 @@ export { ColdStartClient } from "./coldstart";
 export { ComputeAgreementClient } from "./compute";
 export type { ComputeSession, ComputeUsageReport } from "./compute";
 export { MigrationClient } from "./migration";
+export { ArenaClient, ARENA_ADDRESSES } from "./arena";
+export type { ArenaRound, ArenaSquad, ArenaBriefing, ArenaArtifact, ArenaStatus, ArenaNewsletter, ArenaArtifactParams } from "./arena";
 export { resolveEndpoint, notifyEndpoint, notifyHire, notifyHandshake, notifyHireAccepted, notifyDelivery, notifyDeliveryAccepted, notifyDispute, notifyMessage, DEFAULT_REGISTRY_ADDRESS } from "./endpoint";
 export type { EndpointNotifyResult } from "./endpoint";
 export { DeliveryClient, DEFAULT_DAEMON_URL } from "./delivery";