@arc402/sdk 0.6.3 → 0.6.6

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.6.6] — 2026-04-02
+
+### Added
+- `DaemonClient` / `DaemonNodeClient` for the split ARC-402 node API (`/health`, `/auth/*`, `/wallet/status`, `/workroom/status`, `/agreements`).
+- Local daemon URL helpers that infer `:4402` / `:4403` from `~/.arc402/daemon.toml`.
+- Local daemon token loading from `~/.arc402/daemon.token` for authenticated node reads.
+
+### Docs
+- Clarified the split between the delivery plane (`DeliveryClient` on `:4402`) and the authenticated node API plane (`DaemonClient` on `:4403`).
+- Synced the README to the current official node/daemon architecture and package release lane.
+
 ## [0.6.3] — 2026-03-25
 
 ### Synced

package/README.md

@@ -2,9 +2,9 @@
 
 [![npm](https://img.shields.io/npm/v/@arc402/sdk?color=blue)](https://www.npmjs.com/package/@arc402/sdk)
 
-Typed TypeScript SDK for the current ARC-402 network workflow: discovery, off-chain negotiation payloads, escrowed hiring, delivery verification, remediation, disputes, reputation signals, sponsorship, canonical capability taxonomy, governance reads, and operational-context reads.
+Typed TypeScript SDK for the current ARC-402 network workflow: discovery, off-chain negotiation payloads, escrowed hiring, delivery verification, remediation, disputes, reputation signals, sponsorship, canonical capability taxonomy, governance reads, and operator/node runtime reads.
 
-Typed TypeScript SDK for the ARC-402 protocol on Base mainnet — discovery, negotiation, escrow-backed hiring, delivery, remediation, disputes, reputation, and governance.
+Typed TypeScript SDK for the ARC-402 protocol on Base mainnet and the current node/daemon architecture.
 
 > Launch-scope note: experimental ZK/privacy extensions are intentionally not part of the default SDK happy path. Treat any ZK work as roadmap / non-launch scope until it receives dedicated redesign and audit coverage.
 
@@ -23,7 +23,7 @@ openclaw install arc402-agent
 
 The SDK is the programmatic surface. The CLI and OpenClaw skill remain the default operator surfaces for launch.
 
-## What v0.2 adds
+## What v0.6.6 adds
 
 - typed remediation + dispute models aligned to `ServiceAgreement`
 - `ReputationOracleClient`
@@ -32,6 +32,8 @@ The SDK is the programmatic surface. The CLI and OpenClaw skill remain the defau
 - `GovernanceClient`
 - heartbeat / operational trust reads on `AgentRegistry` (informational today, not strong ranking-grade truth)
 - negotiation message helpers for Spec 14 payloads
+- `DaemonClient` / `DaemonNodeClient` for the official split node runtime (`/health`, `/auth/*`, `/wallet/status`, `/workroom/status`, `/agreements`)
+- daemon URL/token helpers that follow the host-node layout (`~/.arc402/daemon.toml`, `~/.arc402/daemon.token`)
 
 ## Operator model
 
@@ -42,6 +44,8 @@ The launch mental model is **operator-first**:
 
 If you want that naming directly in code, the package now exports `ARC402OperatorClient` as an alias of `ARC402WalletClient`.
 
+The active package publish lane is still the `packages/arc402-cli` + `packages/arc402-daemon` pair. This SDK stays in `reference/sdk`, but it now exposes the same local node API shape so programmatic integrations can harden against the official node/daemon runtime instead of shelling out to the CLI.
+
 ## Quick start
 
 ```ts
@@ -189,6 +193,34 @@ const outPath = await delivery.downloadDeliverable(42n, "report.pdf", "./downloa
 
 The CLI shortcut: `arc402 deliver <id> --output <file>` uploads files to the delivery layer and submits the bundle hash on-chain in one step.
 
+Use `DeliveryClient` for the delivery plane on `:4402`. Use `DaemonClient` / `DaemonNodeClient` for the authenticated split node API on `:4403`.
+
+## Node / daemon runtime
+
+For operator-facing local node reads and auth, use `DaemonClient`. This targets the split daemon API on `http://127.0.0.1:4403` by default, infers the API port from `~/.arc402/daemon.toml` when available, and reads `~/.arc402/daemon.token` automatically for authenticated endpoints.
+
+```ts
+import { DaemonClient } from "@arc402/sdk";
+
+const daemon = new DaemonClient();
+
+const health = await daemon.getHealth();
+const wallet = await daemon.getWalletStatus();
+const workroom = await daemon.getWorkroomStatus();
+const agreements = await daemon.listAgreements();
+
+console.log({ health, wallet, workroom, agreements: agreements.agreements.length });
+```
+
+To create a remote owner session explicitly:
+
+```ts
+const daemon = new DaemonClient({ baseUrl: "https://node.example.com" });
+const challenge = await daemon.requestAuthChallenge("0xYourWallet");
+const signature = await ownerSigner.signMessage(challenge.challenge);
+const session = await daemon.createSession(challenge.challengeId, signature);
+```
+
 ## Sponsorship + governance + operational context
 
 ```ts

package/dist/arena.d.ts

@@ -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

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

package/dist/arena.js

@@ -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/daemon.d.ts

@@ -0,0 +1,118 @@
+export declare const DEFAULT_DAEMON_HTTP_URL = "http://127.0.0.1:4402";
+export declare const DEFAULT_DAEMON_API_URL = "http://127.0.0.1:4403";
+export declare const DEFAULT_DAEMON_TOKEN_PATH: string;
+export declare const DEFAULT_DAEMON_CONFIG_PATH: string;
+export interface DaemonHealthStatus {
+    ok: boolean;
+    wallet: string;
+}
+export interface DaemonWalletStatus {
+    ok: boolean;
+    wallet: string;
+    daemonId: string;
+    chainId: number;
+    rpcUrl: string;
+    policyEngineAddress: string;
+}
+export interface DaemonWorkroomStatus {
+    ok: boolean;
+    status: string;
+}
+export interface DaemonAgreementRecord {
+    id: string;
+    agreement_id: string | null;
+    hirer_address: string;
+    capability: string;
+    price_eth: string;
+    deadline_unix: number;
+    spec_hash: string;
+    task_description: string | null;
+    status: string;
+    created_at: number;
+    updated_at: number;
+    reject_reason: string | null;
+}
+export interface DaemonAgreementsResponse {
+    ok: boolean;
+    agreements: DaemonAgreementRecord[];
+}
+export interface AuthChallengeResponse {
+    challengeId: string;
+    challenge: string;
+    daemonId: string;
+    wallet: string;
+    chainId: number;
+    scope: string;
+    expiresAt: number;
+    issuedAt: number;
+}
+export interface AuthSessionResponse {
+    ok: true;
+    token: string;
+    wallets: string[];
+    wallet: string;
+    scope: string;
+    expiresAt: number;
+}
+export interface RevokeSessionsResponse {
+    ok: boolean;
+    revoked: string;
+}
+export interface DaemonNodeClientOptions {
+    /** Split daemon API base URL. Defaults to http://127.0.0.1:4403. */
+    apiUrl?: string;
+    /** Alias for apiUrl to match older docs/examples. */
+    baseUrl?: string;
+    /** Local daemon token. Defaults to ~/.arc402/daemon.token when present. */
+    token?: string;
+    /** Explicit path to daemon.token if you don't want the default. */
+    tokenPath?: string;
+    /** Explicit path to daemon.toml if you want port inference from a non-default location. */
+    configPath?: string;
+    /** Custom fetch implementation for testing or non-standard runtimes. */
+    fetchImpl?: typeof fetch;
+}
+export declare class DaemonClientError extends Error {
+    readonly statusCode?: number;
+    readonly details?: unknown;
+    constructor(message: string, statusCode?: number, details?: unknown);
+}
+export declare function loadLocalDaemonToken(tokenPath?: string): string | undefined;
+export declare function resolveDaemonHttpBaseUrl(configPath?: string): string;
+export declare function resolveDaemonApiBaseUrl(options?: Pick<DaemonNodeClientOptions, "apiUrl" | "baseUrl" | "configPath">): string;
+/**
+ * Thin typed client for the split ARC-402 node API (`arc402-api`).
+ *
+ * This surface is for operator-side reads and auth against the host daemon/node process:
+ * - `/health`
+ * - `/auth/challenge`
+ * - `/auth/session`
+ * - `/auth/revoke`
+ * - `/wallet/status`
+ * - `/workroom/status`
+ * - `/agreements`
+ *
+ * The delivery plane still lives on the host daemon HTTP port (usually `:4402`)
+ * and is wrapped separately by `DeliveryClient`.
+ */
+export declare class DaemonNodeClient {
+    readonly apiUrl: string;
+    private readonly options;
+    private readonly fetchImpl;
+    constructor(options?: DaemonNodeClientOptions);
+    private request;
+    getHealth(): Promise<DaemonHealthStatus>;
+    requestAuthChallenge(wallet: string, requestedScope?: string): Promise<AuthChallengeResponse>;
+    health(): Promise<DaemonHealthStatus>;
+    createSession(challengeId: string, signature: string): Promise<AuthSessionResponse>;
+    revokeSessions(): Promise<RevokeSessionsResponse>;
+    revokeSession(): Promise<RevokeSessionsResponse>;
+    getWalletStatus(): Promise<DaemonWalletStatus>;
+    walletStatus(): Promise<DaemonWalletStatus>;
+    getWorkroomStatus(): Promise<DaemonWorkroomStatus>;
+    workroomStatus(): Promise<DaemonWorkroomStatus>;
+    listAgreements(): Promise<DaemonAgreementsResponse>;
+    agreements(): Promise<DaemonAgreementsResponse>;
+}
+export { DaemonNodeClient as DaemonClient };
+//# sourceMappingURL=daemon.d.ts.map

package/dist/daemon.d.ts.map

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