@swarm-tips/client 0.2.1 → 0.2.3

package/SBOM.spdx.json

@@ -2,10 +2,10 @@
   "spdxVersion": "SPDX-2.3",
   "dataLicense": "CC0-1.0",
   "SPDXID": "SPDXRef-DOCUMENT",
-  "name": "@swarm-tips/client-0.2.1",
-  "documentNamespace": "https://swarm.tips/sbom/client/0.2.1",
+  "name": "@swarm-tips/client-0.2.3",
+  "documentNamespace": "https://swarm.tips/sbom/client/0.2.3",
   "creationInfo": {
-    "created": "2026-09-08T06:45:33.630Z",
+    "created": "2026-09-09T05:14:05.500Z",
     "creators": [
       "Tool: sdk/client/scripts/generate-sbom.mjs",
       "Organization: Swarm Tips"
@@ -15,8 +15,8 @@
     {
       "name": "@swarm-tips/client",
       "SPDXID": "SPDXRef-Package",
-      "versionInfo": "0.2.1",
-      "downloadLocation": "https://www.npmjs.com/package/@swarm-tips/client/v/0.2.1",
+      "versionInfo": "0.2.3",
+      "downloadLocation": "https://www.npmjs.com/package/@swarm-tips/client/v/0.2.3",
       "filesAnalyzed": false,
       "licenseConcluded": "MIT",
       "licenseDeclared": "MIT"

package/dist/coordination-game/chains.d.ts

@@ -0,0 +1,52 @@
+/** Canonical Coordination Game deployments, generated from the public chain registry. */
+export declare const COORDINATION_GAME_DEPLOYMENTS: {
+    readonly "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1": {
+        readonly displayName: "Solana Devnet";
+        readonly network: "testnet";
+        readonly namespace: "solana";
+        readonly coordinationGame: "2qqVk7kUqffnahiJpcQJCsSd8ErbEUgKTgCn1zYsw64P";
+        readonly crossChainGame: "2qqVk7kUqffnahiJpcQJCsSd8ErbEUgKTgCn1zYsw64P";
+        readonly stakeBaseUnits: 50000000n;
+        readonly maxTrancheBaseUnits: 100000000n;
+    };
+    readonly "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp": {
+        readonly displayName: "Solana Mainnet";
+        readonly network: "mainnet";
+        readonly namespace: "solana";
+        readonly coordinationGame: "2qqVk7kUqffnahiJpcQJCsSd8ErbEUgKTgCn1zYsw64P";
+        readonly crossChainGame: "2qqVk7kUqffnahiJpcQJCsSd8ErbEUgKTgCn1zYsw64P";
+        readonly stakeBaseUnits: 68482585n;
+        readonly maxTrancheBaseUnits: 100000000n;
+    };
+    readonly "eip155:84532": {
+        readonly displayName: "Base Sepolia";
+        readonly network: "testnet";
+        readonly namespace: "eip155";
+        readonly coordinationGame: "0x4FBBceb96D2814b5d4ac26089Eb7E43471533253";
+        readonly crossChainGame: "0x7Cc7667f4B71c8eb1D4d3fADE088BFD8d01290AB";
+        readonly stakeBaseUnits: 3200000000000000n;
+        readonly maxTrancheBaseUnits: 6400000000000000n;
+    };
+    readonly "eip155:8453": {
+        readonly displayName: "Base";
+        readonly network: "mainnet";
+        readonly namespace: "eip155";
+        readonly coordinationGame: "0xd585baE48901513202dAEb7d4feE4Af508a96234";
+        readonly crossChainGame: "0x44aC6Eb44692Bcf724d7975B91B299E2c553Ca12";
+        readonly stakeBaseUnits: 2700000000000000n;
+        readonly maxTrancheBaseUnits: 5400000000000000n;
+    };
+    readonly "eip155:1": {
+        readonly displayName: "Ethereum";
+        readonly network: "mainnet";
+        readonly namespace: "eip155";
+        readonly coordinationGame: "0x265818b054E8413Bab870e0Ce0D8aB68400CF0F9";
+        readonly crossChainGame: "0xb84638E5d03AE68c5dC58408e05C001918A23fe9";
+        readonly stakeBaseUnits: 2700000000000000n;
+        readonly maxTrancheBaseUnits: 5400000000000000n;
+    };
+};
+export type CoordinationGameChainId = keyof typeof COORDINATION_GAME_DEPLOYMENTS;
+export type CoordinationGameDeployment = (typeof COORDINATION_GAME_DEPLOYMENTS)[CoordinationGameChainId];
+/** Return the pinned deployment for a supported CAIP-2 chain ID. */
+export declare function coordinationGameDeployment(chainId: string): CoordinationGameDeployment | undefined;

package/dist/coordination-game/chains.js

@@ -0,0 +1,52 @@
+/** Canonical Coordination Game deployments, generated from the public chain registry. */
+export const COORDINATION_GAME_DEPLOYMENTS = {
+    "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1": {
+        displayName: "Solana Devnet",
+        network: "testnet",
+        namespace: "solana",
+        coordinationGame: "2qqVk7kUqffnahiJpcQJCsSd8ErbEUgKTgCn1zYsw64P",
+        crossChainGame: "2qqVk7kUqffnahiJpcQJCsSd8ErbEUgKTgCn1zYsw64P",
+        stakeBaseUnits: 50000000n,
+        maxTrancheBaseUnits: 100000000n,
+    },
+    "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp": {
+        displayName: "Solana Mainnet",
+        network: "mainnet",
+        namespace: "solana",
+        coordinationGame: "2qqVk7kUqffnahiJpcQJCsSd8ErbEUgKTgCn1zYsw64P",
+        crossChainGame: "2qqVk7kUqffnahiJpcQJCsSd8ErbEUgKTgCn1zYsw64P",
+        stakeBaseUnits: 68482585n,
+        maxTrancheBaseUnits: 100000000n,
+    },
+    "eip155:84532": {
+        displayName: "Base Sepolia",
+        network: "testnet",
+        namespace: "eip155",
+        coordinationGame: "0x4FBBceb96D2814b5d4ac26089Eb7E43471533253",
+        crossChainGame: "0x7Cc7667f4B71c8eb1D4d3fADE088BFD8d01290AB",
+        stakeBaseUnits: 3200000000000000n,
+        maxTrancheBaseUnits: 6400000000000000n,
+    },
+    "eip155:8453": {
+        displayName: "Base",
+        network: "mainnet",
+        namespace: "eip155",
+        coordinationGame: "0xd585baE48901513202dAEb7d4feE4Af508a96234",
+        crossChainGame: "0x44aC6Eb44692Bcf724d7975B91B299E2c553Ca12",
+        stakeBaseUnits: 2700000000000000n,
+        maxTrancheBaseUnits: 5400000000000000n,
+    },
+    "eip155:1": {
+        displayName: "Ethereum",
+        network: "mainnet",
+        namespace: "eip155",
+        coordinationGame: "0x265818b054E8413Bab870e0Ce0D8aB68400CF0F9",
+        crossChainGame: "0xb84638E5d03AE68c5dC58408e05C001918A23fe9",
+        stakeBaseUnits: 2700000000000000n,
+        maxTrancheBaseUnits: 5400000000000000n,
+    },
+};
+/** Return the pinned deployment for a supported CAIP-2 chain ID. */
+export function coordinationGameDeployment(chainId) {
+    return COORDINATION_GAME_DEPLOYMENTS[chainId];
+}

package/dist/coordination-game/evm/index.d.ts

@@ -4,3 +4,4 @@ export * from "./session.js";
 export * from "./session-funding.js";
 export * from "./transactions.js";
 export * from "./cross-chain.js";
+export * from "../chains.js";

package/dist/coordination-game/evm/index.js

@@ -4,3 +4,4 @@ export * from "./session.js";
 export * from "./session-funding.js";
 export * from "./transactions.js";
 export * from "./cross-chain.js";
+export * from "../chains.js";

package/dist/coordination-game/index.d.ts

@@ -3,3 +3,4 @@ export type { CoordinationGame } from "../contracts/index.js";
 export * from "./outcome-oracle.js";
 export * from "./battery.js";
 export * from "./protocol.js";
+export * from "./chains.js";

package/dist/coordination-game/index.js

@@ -2,3 +2,4 @@ export { COORDINATION_GAME_IDL, COORDINATION_GAME_IDL as IDL, COORDINATION_GAME_
 export * from "./outcome-oracle.js";
 export * from "./battery.js";
 export * from "./protocol.js";
+export * from "./chains.js";

package/dist/coordination-game/protocol.js

@@ -81,8 +81,17 @@ export function decodeTournament(data) {
     };
 }
 export function decodeTournamentStats(data) {
-    const tournament = decodeTournament(data);
-    return { gameCount: Number(tournament.gameCount), prizeLamports: tournament.prizeLamports };
+    // Stats readers need only the two u64 fields through byte 80. Accept that
+    // prefix so lightweight RPC fixtures and partial account slices do not need
+    // the trailing `finalized` byte required by the full decoder.
+    if (data.length < 80) {
+        throw new RangeError(`Tournament stats data too short: ${data.length} bytes`);
+    }
+    const view = viewOf(data);
+    return {
+        prizeLamports: view.getBigUint64(64, true),
+        gameCount: Number(view.getBigUint64(72, true)),
+    };
 }
 function hasCommitted(commit) {
     return Array.from(commit).some((byte) => byte !== 0);

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /** The unified client package version. Functional APIs live in typed subpaths. */
-export declare const CLIENT_VERSION: "0.2.1";
+export declare const CLIENT_VERSION: "0.2.3";
 export declare const CLIENT_MANIFEST_SCHEMA: "swarm.client-manifest/v1";
 export { SwarmClientError } from "./errors.js";
 export type { SwarmClientErrorCode, SwarmClientErrorOptions } from "./errors.js";

package/dist/index.js

@@ -1,4 +1,4 @@
 /** The unified client package version. Functional APIs live in typed subpaths. */
-export const CLIENT_VERSION = "0.2.1";
+export const CLIENT_VERSION = "0.2.3";
 export const CLIENT_MANIFEST_SCHEMA = "swarm.client-manifest/v1";
 export { SwarmClientError } from "./errors.js";

package/dist/shillbot/api.d.ts

@@ -1,6 +1,7 @@
 import { Connection, type BlockhashWithExpiryBlockHeight } from "@solana/web3.js";
 import { HttpClient, type HttpClientOptions } from "../http.js";
 import { type Action, type TransactionInspection, type WalletSignCallback } from "./index.js";
+export type { Action } from "./index.js";
 export interface PreparedTransactionResponse {
     message?: string;
     task_id?: string;

package/dist/shillbot/switchboard.js

@@ -1,4 +1,5 @@
-import * as anchor from "@coral-xyz/anchor";
+import { AnchorProvider, Program } from "@coral-xyz/anchor";
+import BN from "bn.js";
 import { Buffer } from "buffer";
 import { OracleJob } from "@switchboard-xyz/common/protos";
 import { ComputeBudgetProgram, Keypair, PublicKey, Secp256k1Program, SystemProgram, TransactionInstruction, TransactionMessage, VersionedTransaction, } from "@solana/web3.js";
@@ -14,7 +15,6 @@ const SWITCHBOARD_PROGRAMS = {
 };
 const CROSSBAR_URL = "https://crossbar.switchboard.xyz";
 const SWITCHBOARD_GATEWAY_API_VERSION = "1.0.0";
-const anchorRuntime = anchor.default ?? anchor;
 async function jsonResponse(response, description) {
     if (!response.ok) {
         throw new Error(`${description} failed with HTTP ${response.status}`);
@@ -120,11 +120,23 @@ function associatedTokenAddress(mint, owner) {
 export async function buildSwitchboardCrankAndVerify(request) {
     const switchboardProgramId = SWITCHBOARD_PROGRAMS[request.network];
     const dummy = Keypair.generate();
-    const provider = new anchorRuntime.AnchorProvider(request.connection, new anchorRuntime.Wallet(dummy), { commitment: "confirmed" });
-    const idl = await anchorRuntime.Program.fetchIdl(switchboardProgramId, provider);
+    const signDummy = async (transaction) => {
+        if ("partialSign" in transaction)
+            transaction.partialSign(dummy);
+        else
+            transaction.sign([dummy]);
+        return transaction;
+    };
+    const dummyWallet = {
+        publicKey: dummy.publicKey,
+        signTransaction: signDummy,
+        signAllTransactions: async (transactions) => Promise.all(transactions.map(signDummy)),
+    };
+    const provider = new AnchorProvider(request.connection, dummyWallet, { commitment: "confirmed" });
+    const idl = await Program.fetchIdl(switchboardProgramId, provider);
     if (!idl)
         throw new Error("failed to fetch Switchboard IDL");
-    const program = new anchorRuntime.Program(idl, provider);
+    const program = new Program(idl, provider);
     const switchboardAccounts = program.account;
     const feedData = (await switchboardAccounts.pullFeedAccountData.fetch(request.feed));
     const feedHashHex = Buffer.from(feedData.feedHash).toString("hex");
@@ -152,8 +164,8 @@ export async function buildSwitchboardCrankAndVerify(request) {
     const oracleStats = oraclePubkeys.map((oracle) => PublicKey.findProgramAddressSync([Buffer.from("OracleStats"), oracle.toBuffer()], switchboardProgramId)[0]);
     const feeds = response.median_responses.map((median) => median.feed_hash === feedHashHex ? request.feed : PublicKey.default);
     const submit = program.instruction.pullFeedSubmitResponseConsensus({
-        slot: new anchorRuntime.BN(response.slot),
-        values: response.median_responses.map((median) => new anchorRuntime.BN(median.value)),
+        slot: new BN(response.slot),
+        values: response.median_responses.map((median) => new BN(median.value)),
     }, {
         accounts: {
             queue: queuePubkey,

package/dist/swarm/index.js

@@ -49,7 +49,7 @@ export class SwarmClient {
     async toolCount() {
         const headers = { "Content-Type": "application/json", Accept: "application/json, text/event-stream" };
         try {
-            const init = await this.fetchImpl(`${this.baseUrl}/mcp`, { method: "POST", headers, body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "initialize", params: { protocolVersion: "2025-03-26", capabilities: {}, clientInfo: { name: "swarm-client", version: "0.2.1" } } }) });
+            const init = await this.fetchImpl(`${this.baseUrl}/mcp`, { method: "POST", headers, body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "initialize", params: { protocolVersion: "2025-03-26", capabilities: {}, clientInfo: { name: "swarm-client", version: "0.2.3" } } }) });
             if (!init.ok)
                 return null;
             const session = init.headers.get("mcp-session-id");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarm-tips/client",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Typed browser and Node.js clients for Swarm Tips, Shillbot, and Coordination Game",
   "type": "module",
   "main": "dist/index.js",
@@ -96,6 +96,7 @@
     "@coral-xyz/anchor": "^0.32.1",
     "@solana/web3.js": "^1.98.4",
     "@switchboard-xyz/common": "^5.7.0",
+    "bn.js": "^5.2.2",
     "bs58": "^6.0.0",
     "buffer": "^6.0.3",
     "js-sha256": "^0.11.0"