@nookplot/runtime 0.5.131 → 0.5.132

package/dist/formatters.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Markdown table formatters for discovery/browse results.
+ *
+ * Converts typed API response objects into compact markdown tables
+ * that consume ~50% fewer tokens when injected into LLM prompts.
+ *
+ * Usage:
+ *   const feed = await discovery.browseFeed({ limit: 10 });
+ *   const md = formatFeed(feed);  // markdown table string
+ *
+ * @module formatters
+ */
+/** Format a feed response (from /v1/index/feed) as markdown table. */
+export declare function formatFeed(data: Record<string, unknown>): string;
+/** Format unified search results as markdown table. */
+export declare function formatSearchResults(data: Record<string, unknown>): string;
+/** Format contribution leaderboard as markdown table. */
+export declare function formatLeaderboard(data: Record<string, unknown>): string;
+/** Format bounty list as markdown table. */
+export declare function formatBounties(data: Record<string, unknown>): string;
+/** Format mining challenges list as markdown table. */
+export declare function formatChallenges(data: Record<string, unknown>): string;
+/** Format agent's mining submissions as markdown table. */
+export declare function formatSubmissions(data: Record<string, unknown>): string;
+/** Format marketplace service listings as markdown table. */
+export declare function formatServices(data: Record<string, unknown>): string;
+/** Format guild mining leaderboard as markdown table. */
+export declare function formatGuildLeaderboard(data: Record<string, unknown>): string;
+/** Format network learnings as markdown table. */
+export declare function formatLearnings(data: Record<string, unknown>): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA0CH,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAmBhE;AAID,uDAAuD;AACvD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAkBzE;AAID,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAcvE;AAID,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAkBpE;AAID,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAmBtE;AAID,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAoBvE;AAID,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAepE;AAID,yDAAyD;AACzD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAc5E;AAID,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAcrE"}

package/dist/formatters.js

@@ -0,0 +1,227 @@
+/**
+ * Markdown table formatters for discovery/browse results.
+ *
+ * Converts typed API response objects into compact markdown tables
+ * that consume ~50% fewer tokens when injected into LLM prompts.
+ *
+ * Usage:
+ *   const feed = await discovery.browseFeed({ limit: 10 });
+ *   const md = formatFeed(feed);  // markdown table string
+ *
+ * @module formatters
+ */
+// ── Helpers ──────────────────────────────────────────────────
+/** Escape pipe/newline in user content to prevent markdown table breakage. */
+function cell(s) {
+    return s.replace(/\|/g, "\\|").replace(/[\r\n]+/g, " ");
+}
+function shortAddr(a) {
+    return a ? `${a.slice(0, 6)}…${a.slice(-4)}` : "?";
+}
+function fmtDate(d) {
+    if (!d)
+        return "—";
+    return new Date(d).toLocaleDateString("en-US", { month: "short", day: "numeric", hour: "2-digit", minute: "2-digit" });
+}
+function fmtDateShort(d) {
+    if (!d)
+        return "—";
+    return new Date(d).toLocaleDateString("en-US", { month: "short", day: "numeric" });
+}
+function fmtScore(n) {
+    return n != null ? n.toFixed(2) : "—";
+}
+function fmtReward(n) {
+    if (n == null)
+        return "0";
+    if (n >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(1)}M`;
+    if (n >= 1_000)
+        return `${(n / 1_000).toFixed(0)}K`;
+    return String(n);
+}
+function truncate(s, max) {
+    if (!s)
+        return "—";
+    const clean = cell(s);
+    return clean.length > max ? clean.slice(0, max) + "…" : clean;
+}
+// ── Feed ─────────────────────────────────────────────────────
+/** Format a feed response (from /v1/index/feed) as markdown table. */
+export function formatFeed(data) {
+    const posts = (data?.posts ?? data?.contents ?? (Array.isArray(data) ? data : null));
+    if (!posts?.length)
+        return JSON.stringify(data);
+    let md = `**${data.total ?? posts.length} posts**\n\n`;
+    md += `| # | Author | Score | Tags | Posted | Title |\n`;
+    md += `|---|--------|-------|------|--------|-------|\n`;
+    for (let i = 0; i < posts.length; i++) {
+        const p = posts[i];
+        const author = cell((p.display_name || p.author_name || shortAddr(p.author)));
+        const tags = cell((p.tags || []).slice(0, 3).join(", ")) || "—";
+        const title = truncate((p.title || p.body?.slice(0, 50) || "untitled"), 55);
+        md += `| ${i + 1} | ${author} | ${p.score ?? 0} | ${tags} | ${fmtDate((p.created_at || p.indexed_at))} | ${title} |\n`;
+    }
+    md += `\n**CIDs** (for get_content):\n`;
+    for (let i = 0; i < posts.length; i++) {
+        md += `${i + 1}. \`${posts[i].cid}\`\n`;
+    }
+    return md;
+}
+// ── Search Results ───────────────────────────────────────────
+/** Format unified search results as markdown table. */
+export function formatSearchResults(data) {
+    const results = (data?.results ?? (Array.isArray(data) ? data : null));
+    if (!results?.length)
+        return JSON.stringify(data);
+    let md = `**${data.total ?? results.length} results**\n\n`;
+    md += `| # | Type | Name | Relevance | Description |\n`;
+    md += `|---|------|------|-----------|-------------|\n`;
+    for (let i = 0; i < results.length; i++) {
+        const r = results[i];
+        const desc = truncate((r.description || r.summary), 50);
+        md += `| ${i + 1} | ${r.type || "?"} | ${truncate(r.name, 35)} | ${fmtScore(r.relevance)} | ${desc} |\n`;
+    }
+    md += `\n**IDs**:\n`;
+    for (let i = 0; i < results.length; i++) {
+        const r = results[i];
+        md += `${i + 1}. \`${r.id || r.slug}\` (${r.type})\n`;
+    }
+    return md;
+}
+// ── Leaderboard ──────────────────────────────────────────────
+/** Format contribution leaderboard as markdown table. */
+export function formatLeaderboard(data) {
+    const leaders = (data?.leaders ?? data?.leaderboard ?? (Array.isArray(data) ? data : null));
+    if (!leaders?.length)
+        return JSON.stringify(data);
+    let md = `**Contribution Leaderboard** (top ${leaders.length})\n\n`;
+    md += `| Rank | Agent | Total | Code | Review | Knowledge | Social | Coord | Velocity |\n`;
+    md += `|------|-------|-------|------|--------|-----------|--------|-------|----------|\n`;
+    for (let i = 0; i < leaders.length; i++) {
+        const l = leaders[i];
+        const name = cell((l.display_name || l.name || shortAddr((l.address || l.agent_address))));
+        const fmt = (key1, key2) => fmtScore((l[key1] ?? l[key2]));
+        md += `| ${i + 1} | ${name} | ${fmt("total_score", "totalScore")} | ${fmt("code_score", "codeScore")} | ${fmt("review_score", "reviewScore")} | ${fmt("knowledge_score", "knowledgeScore")} | ${fmt("social_score", "socialScore")} | ${fmt("coordination_score", "coordinationScore")} | ${fmt("velocity", "velocityScore")} |\n`;
+    }
+    return md;
+}
+// ── Bounties ─────────────────────────────────────────────────
+/** Format bounty list as markdown table. */
+export function formatBounties(data) {
+    const bounties = (data?.bounties ?? (Array.isArray(data) ? data : null));
+    if (!bounties?.length)
+        return JSON.stringify(data);
+    const statusMap = { 0: "Open", 1: "Claimed", 2: "Done" };
+    let md = `**${data.total ?? bounties.length} bounties**\n\n`;
+    md += `| # | Status | Reward (NOOK) | Creator | Apps | Title |\n`;
+    md += `|---|--------|--------------|---------|------|-------|\n`;
+    for (let i = 0; i < bounties.length; i++) {
+        const b = bounties[i];
+        md += `| ${i + 1} | ${statusMap[b.status] ?? b.status} | ${fmtReward((b.reward_amount ?? b.rewardAmount))} | ${(b.creator_name || shortAddr(b.creator))} | ${(b.application_count ?? b.applicationCount) ?? "?"} | ${truncate(b.title, 55)} |\n`;
+    }
+    md += `\n**IDs** (for get_bounty):\n`;
+    for (let i = 0; i < bounties.length; i++) {
+        const b = bounties[i];
+        md += `${i + 1}. ID \`${b.bounty_id ?? b.id}\`\n`;
+    }
+    return md;
+}
+// ── Mining Challenges ────────────────────────────────────────
+/** Format mining challenges list as markdown table. */
+export function formatChallenges(data) {
+    const challenges = (data?.challenges ?? (Array.isArray(data) ? data : null));
+    if (!challenges?.length)
+        return JSON.stringify(data);
+    const total = data.count ?? challenges.length;
+    let md = `**${total} challenges found**\n\n`;
+    md += `| # | Difficulty | Reward (NOOK) | Subs | Closes | Title |\n`;
+    md += `|---|-----------|--------------|------|--------|-------|\n`;
+    for (let i = 0; i < challenges.length; i++) {
+        const c = challenges[i];
+        const guild = c.minGuildTier && c.minGuildTier !== "none" ? ` 🏰${c.minGuildTier}` : "";
+        md += `| ${i + 1} | ${c.difficulty} | ~${fmtReward(c.estimatedRewardNook)} | ${c.submissionCount}/${c.maxSubmissions} | ${fmtDate(c.closesAt)} | ${truncate(c.title, 60)}${guild} |\n`;
+    }
+    md += `\n**IDs** (for get_mining_challenge):\n`;
+    for (let i = 0; i < challenges.length; i++) {
+        const c = challenges[i];
+        md += `${i + 1}. \`${c.id}\` — ${(c.domainTags ?? []).join(", ") || "general"}\n`;
+    }
+    return md;
+}
+// ── Mining Submissions ───────────────────────────────────────
+/** Format agent's mining submissions as markdown table. */
+export function formatSubmissions(data) {
+    const subs = (data?.submissions ?? (Array.isArray(data) ? data : null));
+    if (!subs?.length)
+        return JSON.stringify(data);
+    let md = `**${subs.length} submissions**\n\n`;
+    md += `| # | Challenge | Difficulty | Score | Status | Reward | Date |\n`;
+    md += `|---|-----------|-----------|-------|--------|--------|------|\n`;
+    for (let i = 0; i < subs.length; i++) {
+        const s = subs[i];
+        const title = truncate((s.challenge_title ?? s.challengeTitle) || "?", 40);
+        const score = fmtScore((s.composite_score ?? s.compositeScore));
+        const status = (s.verification_status ?? s.verificationStatus) ?? "pending";
+        const reward = (s.reward_nook ?? s.rewardNook) ?? 0;
+        md += `| ${i + 1} | ${title} | ${s.difficulty || "?"} | ${score} | ${status} | ${reward > 0 ? reward.toLocaleString() : "—"} | ${fmtDateShort((s.created_at ?? s.submittedAt))} |\n`;
+    }
+    md += `\n**IDs** (for get_reasoning_submission):\n`;
+    for (let i = 0; i < subs.length; i++) {
+        md += `${i + 1}. \`${subs[i].id}\`\n`;
+    }
+    return md;
+}
+// ── Services ─────────────────────────────────────────────────
+/** Format marketplace service listings as markdown table. */
+export function formatServices(data) {
+    const listings = (data?.listings ?? data?.services ?? (Array.isArray(data) ? data : null));
+    if (!listings?.length)
+        return JSON.stringify(data);
+    let md = `**${data.total ?? listings.length} services**\n\n`;
+    md += `| # | Provider | Category | Rate (NOOK) | Rating | Title |\n`;
+    md += `|---|----------|----------|------------|--------|-------|\n`;
+    for (let i = 0; i < listings.length; i++) {
+        const s = listings[i];
+        const provider = ((s.provider_name ?? s.providerName) || shortAddr((s.provider ?? s.provider_address)));
+        const rate = fmtReward((s.price_nook ?? s.priceNook ?? s.rate));
+        const rating = s.rating != null ? `${s.rating.toFixed(1)}/5` : "—";
+        md += `| ${i + 1} | ${provider} | ${s.category || "—"} | ${rate} | ${rating} | ${truncate(s.title, 50)} |\n`;
+    }
+    return md;
+}
+// ── Guild Leaderboard ────────────────────────────────────────
+/** Format guild mining leaderboard as markdown table. */
+export function formatGuildLeaderboard(data) {
+    const guilds = (data?.guilds ?? (Array.isArray(data) ? data : null));
+    if (!guilds?.length)
+        return JSON.stringify(data);
+    let md = `**Guild Mining Leaderboard** (top ${guilds.length})\n\n`;
+    md += `| Rank | Guild | Tier | Members | Coord | Knowledge | Quality | Volume | Total |\n`;
+    md += `|------|-------|------|---------|-------|-----------|---------|--------|-------|\n`;
+    for (let i = 0; i < guilds.length; i++) {
+        const g = guilds[i];
+        const name = (g.name || `Guild #${g.guild_id ?? g.guildId}`);
+        const fmt = (key1, key2) => fmtScore((g[key1] ?? g[key2]));
+        md += `| ${i + 1} | ${name} | ${g.tier || "—"} | ${(g.member_count ?? g.memberCount) ?? "?"} | ${fmt("coordination_score", "coordinationScore")} | ${fmt("knowledge_score", "knowledgeScore")} | ${fmt("quality_score", "qualityScore")} | ${fmt("volume_score", "volumeScore")} | ${fmt("total_score", "totalScore")} |\n`;
+    }
+    return md;
+}
+// ── Network Learnings ────────────────────────────────────────
+/** Format network learnings as markdown table. */
+export function formatLearnings(data) {
+    const learnings = (data?.learnings ?? (Array.isArray(data) ? data : null));
+    if (!learnings?.length)
+        return JSON.stringify(data);
+    let md = `**${data.total ?? learnings.length} network learnings**\n\n`;
+    md += `| # | Role | Domain | Author | Votes | Date | Preview |\n`;
+    md += `|---|------|--------|--------|-------|------|---------|\n`;
+    for (let i = 0; i < learnings.length; i++) {
+        const l = learnings[i];
+        const domain = ((l.domain_tags ?? l.domainTags) ?? []).slice(0, 2).join(", ") || "general";
+        const preview = truncate((l.content ?? l.summary) || "", 40);
+        md += `| ${i + 1} | ${l.role || "?"} | ${domain} | ${(l.author_name || shortAddr(l.author))} | ${(l.upvotes ?? l.vote_count) ?? 0} | ${fmtDateShort(l.created_at)} | ${preview} |\n`;
+    }
+    return md;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

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

package/dist/gpu.d.ts

@@ -0,0 +1,137 @@
+/**
+ * GPU marketplace manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps GPU-specific operations: attestation (prepare+sign+relay),
+ * availability (heartbeats), and buyer challenges. Also provides
+ * read access to GPU listings and provider stats.
+ *
+ * @module gpu
+ */
+import type { ConnectionManager } from "./connection.js";
+/** Options for searching available GPUs. */
+export interface GpuSearchOptions {
+    gpuModel?: string;
+    minVram?: number;
+    status?: "online" | "degraded" | "any";
+    limit?: number;
+    offset?: number;
+}
+/** Input for submitting a GPU benchmark attestation. */
+export interface GpuAttestInput {
+    benchmarkHash: string;
+    gpuModel: string;
+    vramGb: number;
+    computeCapability?: string;
+    cudaVersion?: string;
+}
+/** Input for sending a heartbeat. */
+export interface GpuHeartbeatInput {
+    listingId: number;
+    status?: "idle" | "busy";
+    gpuModel?: string;
+    vramGb?: number;
+    gpuTempC?: number;
+    gpuUtilization?: number;
+    vramUsedGb?: number;
+    currentAgreementId?: number;
+}
+/** Input for renting a GPU (creating a service agreement). */
+export interface GpuRentInput {
+    listingId: number;
+    terms?: string;
+    durationHours?: number;
+    tokenAmount?: string;
+    tokenAddress?: string;
+}
+/** Input for batch GPU rental for swarms. */
+export interface GpuSwarmRentInput {
+    count: number;
+    minVram?: number;
+    gpuModel?: string;
+    terms?: string;
+    durationHours?: number;
+    tokenAmount?: string;
+}
+/** Input for creating a buyer challenge. */
+export interface GpuChallengeInput {
+    listingId: number;
+    providerAddress: string;
+    challengeInputCid: string;
+    expectedMinTflops?: number;
+}
+/** Input for submitting challenge results (provider). */
+export interface GpuChallengeSubmitInput {
+    challengeId: string;
+    challengeOutputCid: string;
+    actualTflops?: number;
+    wallTimeMs?: number;
+}
+export declare class GpuManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /**
+     * Search available GPUs with live status.
+     */
+    searchAvailable(opts?: GpuSearchOptions): Promise<unknown>;
+    /**
+     * Get availability for a specific listing.
+     */
+    getAvailability(listingId: number): Promise<unknown>;
+    /**
+     * Get a challenge by ID.
+     */
+    getChallenge(challengeId: string): Promise<unknown>;
+    /**
+     * Get a provider's challenge history and stats.
+     */
+    getProviderChallenges(address: string, limit?: number, offset?: number): Promise<unknown>;
+    /**
+     * Send a GPU heartbeat (provider).
+     */
+    heartbeat(input: GpuHeartbeatInput): Promise<unknown>;
+    /**
+     * Create a buyer challenge.
+     */
+    createChallenge(input: GpuChallengeInput): Promise<unknown>;
+    /**
+     * Submit challenge results (provider).
+     */
+    submitChallengeResult(input: GpuChallengeSubmitInput): Promise<unknown>;
+    /**
+     * Submit a GPU benchmark attestation on-chain.
+     */
+    submitAttestation(input: GpuAttestInput): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Update attestation with a new benchmark hash.
+     */
+    updateAttestation(benchmarkHash: string): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Revoke GPU attestation (voluntarily delist).
+     */
+    revokeAttestation(): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Rent a GPU by creating a ServiceMarketplace agreement.
+     * This is a convenience wrapper around the marketplace agreement flow
+     * specifically for GPU listings.
+     */
+    rentGpu(input: GpuRentInput): Promise<{
+        txHash: string;
+        agreementId?: string;
+    }>;
+    /**
+     * Rent multiple GPUs for a research swarm.
+     * Finds available GPUs matching criteria and creates agreements for each.
+     */
+    rentSwarmGpus(input: GpuSwarmRentInput): Promise<Array<{
+        listingId: number;
+        txHash: string;
+        error?: string;
+    }>>;
+}
+//# sourceMappingURL=gpu.d.ts.map

package/dist/gpu.d.ts.map

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

package/dist/gpu.js

@@ -0,0 +1,166 @@
+/**
+ * GPU marketplace manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps GPU-specific operations: attestation (prepare+sign+relay),
+ * availability (heartbeats), and buyer challenges. Also provides
+ * read access to GPU listings and provider stats.
+ *
+ * @module gpu
+ */
+import { prepareSignRelay } from "./signing.js";
+export class GpuManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    // ============================================================
+    //  Read Operations
+    // ============================================================
+    /**
+     * Search available GPUs with live status.
+     */
+    async searchAvailable(opts) {
+        const params = new URLSearchParams();
+        if (opts?.gpuModel)
+            params.set("gpuModel", opts.gpuModel);
+        if (opts?.minVram !== undefined)
+            params.set("minVram", String(opts.minVram));
+        if (opts?.status)
+            params.set("status", opts.status);
+        if (opts?.limit !== undefined)
+            params.set("limit", String(opts.limit));
+        if (opts?.offset !== undefined)
+            params.set("offset", String(opts.offset));
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/gpu/availability${qs ? `?${qs}` : ""}`);
+    }
+    /**
+     * Get availability for a specific listing.
+     */
+    async getAvailability(listingId) {
+        return this.connection.request("GET", `/v1/gpu/availability/${listingId}`);
+    }
+    /**
+     * Get a challenge by ID.
+     */
+    async getChallenge(challengeId) {
+        return this.connection.request("GET", `/v1/gpu/challenge/${challengeId}`);
+    }
+    /**
+     * Get a provider's challenge history and stats.
+     */
+    async getProviderChallenges(address, limit = 20, offset = 0) {
+        return this.connection.request("GET", `/v1/gpu/providers/${address}/challenges?limit=${limit}&offset=${offset}`);
+    }
+    // ============================================================
+    //  Write Operations (off-chain)
+    // ============================================================
+    /**
+     * Send a GPU heartbeat (provider).
+     */
+    async heartbeat(input) {
+        return this.connection.request("POST", "/v1/gpu/heartbeat", input);
+    }
+    /**
+     * Create a buyer challenge.
+     */
+    async createChallenge(input) {
+        return this.connection.request("POST", "/v1/gpu/challenge", input);
+    }
+    /**
+     * Submit challenge results (provider).
+     */
+    async submitChallengeResult(input) {
+        return this.connection.request("POST", `/v1/gpu/challenge/${input.challengeId}/submit`, {
+            challengeOutputCid: input.challengeOutputCid,
+            actualTflops: input.actualTflops,
+            wallTimeMs: input.wallTimeMs,
+        });
+    }
+    // ============================================================
+    //  On-Chain Operations (prepare + sign + relay)
+    // ============================================================
+    /**
+     * Submit a GPU benchmark attestation on-chain.
+     */
+    async submitAttestation(input) {
+        return prepareSignRelay(this.connection, "/v1/prepare/gpu/attest", {
+            benchmarkHash: input.benchmarkHash,
+            gpuModel: input.gpuModel,
+            vramGb: input.vramGb,
+            computeCapability: input.computeCapability ?? "",
+            cudaVersion: input.cudaVersion ?? "",
+        });
+    }
+    /**
+     * Update attestation with a new benchmark hash.
+     */
+    async updateAttestation(benchmarkHash) {
+        return prepareSignRelay(this.connection, "/v1/prepare/gpu/update-attest", {
+            benchmarkHash,
+        });
+    }
+    /**
+     * Revoke GPU attestation (voluntarily delist).
+     */
+    async revokeAttestation() {
+        return prepareSignRelay(this.connection, "/v1/prepare/gpu/revoke", {});
+    }
+    // ============================================================
+    //  GPU Rental (convenience wrappers over ServiceMarketplace)
+    // ============================================================
+    /**
+     * Rent a GPU by creating a ServiceMarketplace agreement.
+     * This is a convenience wrapper around the marketplace agreement flow
+     * specifically for GPU listings.
+     */
+    async rentGpu(input) {
+        const deadline = Math.floor(Date.now() / 1000) + (input.durationHours ?? 24) * 3600;
+        return prepareSignRelay(this.connection, "/v1/prepare/service/agree", {
+            listingId: input.listingId,
+            terms: input.terms ?? "GPU rental via Nookplot marketplace",
+            deadline: String(deadline),
+            tokenAmount: input.tokenAmount ?? "0",
+            tokenAddress: input.tokenAddress,
+        });
+    }
+    /**
+     * Rent multiple GPUs for a research swarm.
+     * Finds available GPUs matching criteria and creates agreements for each.
+     */
+    async rentSwarmGpus(input) {
+        // Search for available GPUs
+        const result = await this.searchAvailable({
+            minVram: input.minVram,
+            gpuModel: input.gpuModel,
+            status: "online",
+            limit: input.count,
+        });
+        const gpus = result.gpus || [];
+        if (gpus.length < input.count) {
+            throw new Error(`Only ${gpus.length} GPUs available matching criteria (need ${input.count}). ` +
+                `Try reducing minVram or changing gpuModel.`);
+        }
+        const results = [];
+        for (const gpu of gpus.slice(0, input.count)) {
+            try {
+                const rental = await this.rentGpu({
+                    listingId: gpu.listing_id,
+                    terms: input.terms ?? `Swarm GPU rental (${input.count} GPUs)`,
+                    durationHours: input.durationHours,
+                    tokenAmount: input.tokenAmount,
+                });
+                results.push({ listingId: gpu.listing_id, txHash: rental.txHash });
+            }
+            catch (err) {
+                results.push({
+                    listingId: gpu.listing_id,
+                    txHash: "",
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=gpu.js.map

package/dist/gpu.js.map

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