@nosana/scenario 2.2.0 → 2.2.1

package/README.md

@@ -14,7 +14,7 @@ npm install --save-dev @nosana/scenario
 
 ```ts
 import { describe, it, expect } from 'vitest';
-import { getScenarioClient } from '@nosana/scenario';
+import { getScenarioClient, createMarket, listJob } from '@nosana/scenario';
 
 describe('scenario: basic', () => {
   it('works with the Nosana SDK', async () => {
@@ -22,9 +22,27 @@ describe('scenario: basic', () => {
     const balance = await client.solana.getBalance();
     expect(balance).toBeGreaterThan(0);
   });
+
+  it('creates a market and lists a job', async () => {
+    const marketAddress = await createMarket();
+    const jobAddress = await listJob({ market: marketAddress });
+    expect(jobAddress).toBeDefined();
+  });
 });
 ```
 
+### Multiple Clients
+
+Use the `key` option to create independently funded clients — useful for multi-party scenarios:
+
+```ts
+const deployer = await getScenarioClient();                          // cached as 'default'
+const node     = await getScenarioClient({ key: 'node' });           // separate wallet
+const node2    = await getScenarioClient({ key: 'node2' });          // another separate wallet
+```
+
+Each unique key gets its own keypair, SOL airdrop, and NOS mint on localnet.
+
 ### Run Against Different Networks
 
 No code changes needed — just set environment variables:
@@ -87,20 +105,11 @@ pnpm run localnet:down
 
 ### `getScenarioClient(options?): Promise<NosanaClient>`
 
-Returns a cached `NosanaClient` for the target network.
-
-The network is determined by (in order of precedence):
-1. `options.network`
-2. `NOSANA_NETWORK` environment variable
-3. `'localnet'` (default)
-
-The wallet is determined by (in order of precedence):
-1. `options.wallet`
-2. `NOSANA_WALLET` environment variable (path to a Solana keypair JSON file)
-3. Auto-generated keypair (localnet only)
+Returns a cached `NosanaClient` for the target network. Each unique `key` gets its own independently funded client instance.
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
+| `key` | `string` | `'default'` | Cache key — each unique key creates a separate client with its own wallet |
 | `network` | `'localnet' \| 'devnet' \| 'mainnet'` | `NOSANA_NETWORK` env or `'localnet'` | Target network |
 | `wallet` | `Wallet` | `NOSANA_WALLET` env or auto-generated (localnet) | Wallet signer |
 | `airdropAmount` | `bigint` | `2_000_000_000n` | SOL airdrop amount (localnet only) |
@@ -115,19 +124,99 @@ The wallet is determined by (in order of precedence):
 
 Returns a cached `NosanaClient` connected to localnet. Equivalent to `getScenarioClient({ network: 'localnet' })`.
 
-### `mintNosTo(client, recipient, amount): Promise<void>`
+---
+
+### Helper Functions
+
+All helper functions include built-in vitest `expect` assertions and accept an optional `clientOverride` parameter. When omitted, they use the default scenario client (`getScenarioClient()`).
+
+#### Jobs
+
+##### `createMarket(params?, clientOverride?): Promise<Address>`
+
+Create a market on-chain and return its address.
+
+```ts
+const marketAddress = await createMarket();
+const marketAddress = await createMarket({ jobPrice: 1000n });
+```
+
+##### `closeMarket(marketAddress, clientOverride?): Promise<void>`
+
+Close an existing market.
+
+```ts
+await closeMarket(marketAddress.toString());
+```
+
+##### `listJob(params, clientOverride?): Promise<Address>`
+
+List (submit) a job to a market and return the job address. `timeout` defaults to `3600` and `ipfsHash` defaults to a test hash — only `market` is required.
+
+```ts
+const jobAddress = await listJob({ market: marketAddress });
+const jobAddress = await listJob({ market: marketAddress, timeout: 7200 });
+```
+
+##### `joinMarketQueue(marketAddress, options?, clientOverride?): Promise<void>`
+
+Join a market's node queue. Verifies the node is queued by default.
+
+```ts
+const nodeClient = await getScenarioClient({ key: 'node' });
+await joinMarketQueue(marketAddress.toString(), {}, nodeClient);
+
+// Disable queue verification
+await joinMarketQueue(marketAddress.toString(), { verifyQueued: false }, nodeClient);
+```
+
+##### `waitForJobState(jobAddress, expectedState, clientOverride?): Promise<void>`
+
+Poll until a job reaches the expected state using vitest's `expect.poll`.
+
+```ts
+import { JobState } from '@nosana/scenario';
+
+await waitForJobState(jobAddress.toString(), JobState.RUNNING);
+```
+
+#### Nodes
+
+##### `finishJob(jobAddress, clientOverride?): Promise<void>`
+
+Finish (complete) a job as a node, submitting a default IPFS results hash.
+
+```ts
+const nodeClient = await getScenarioClient({ key: 'node' });
+await finishJob(jobAddress.toString(), nodeClient);
+```
+
+##### `verifyJobAssignedToNode(jobAddress, options?, clientOverride?): Promise<void>`
+
+Assert that a job is assigned to the client's wallet. Optionally verify the job state.
+
+```ts
+const nodeClient = await getScenarioClient({ key: 'node' });
+await verifyJobAssignedToNode(jobAddress.toString(), { expectedState: 1 }, nodeClient);
+```
+
+---
+
+### Utilities
+
+#### `mintNosTo(client, recipient, amount): Promise<void>`
 
 Mint NOS tokens to any address on the localnet.
 
-### `ensureLocalnetMint(client): Promise<{ mintAuthority, mintAddress }>`
+#### `ensureLocalnetMint(client): Promise<{ mintAuthority, mintAddress }>`
 
 Ensures the NOS mint exists on localnet. Creates it if it doesn't exist.
 
-### `executeInstructionPlan(client, plan): Promise<void>`
+#### `executeInstructionPlan(client, plan): Promise<void>`
 
 Execute a Solana instruction plan using the client's wallet as fee payer.
 
-### `defineScenarioVitestConfig(overrides?): object`
+#### `defineScenarioVitestConfig(overrides?): object`
 
 Returns a Vitest config object with the scenario setup file pre-configured.
 
@@ -138,4 +227,4 @@ Returns a Vitest config object with the scenario setup file pre-configured.
 
 ### Re-exports from `@nosana/kit`
 
-- `NosanaNetwork`, `type NosanaClient`, `type Wallet`, `type Address`
+- `NosanaNetwork`, `JobState`, `type NosanaClient`, `type Wallet`, `type Address`

package/dist/helpers/index.d.ts

@@ -0,0 +1,3 @@
+export { createMarket, closeMarket, listJob, joinMarketQueue, waitForJobState, type JoinMarketQueueOptions, } from './jobs/index.js';
+export { finishJob, verifyJobAssignedToNode, type VerifyJobAssignedOptions, } from './nodes/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,OAAO,EACP,eAAe,EACf,eAAe,EACf,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,SAAS,EACT,uBAAuB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC"}

package/dist/helpers/index.js

@@ -0,0 +1,3 @@
+export { createMarket, closeMarket, listJob, joinMarketQueue, waitForJobState, } from './jobs/index.js';
+export { finishJob, verifyJobAssignedToNode, } from './nodes/index.js';
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,OAAO,EACP,eAAe,EACf,eAAe,GAEhB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,SAAS,EACT,uBAAuB,GAExB,MAAM,kBAAkB,CAAC"}

package/dist/helpers/jobs/close-market.d.ts

@@ -0,0 +1,3 @@
+import { type NosanaClient } from '@nosana/kit';
+export declare function closeMarket(marketAddress: string, clientOverride?: NosanaClient): Promise<void>;
+//# sourceMappingURL=close-market.d.ts.map

package/dist/helpers/jobs/close-market.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-market.d.ts","sourceRoot":"","sources":["../../../src/helpers/jobs/close-market.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAIzD,wBAAsB,WAAW,CAC/B,aAAa,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,YAAY,GAC5B,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/helpers/jobs/close-market.js

@@ -0,0 +1,11 @@
+import { address } from '@nosana/kit';
+import { expect } from 'vitest';
+import { resolveClient } from '../resolve-client.js';
+export async function closeMarket(marketAddress, clientOverride) {
+    const client = await resolveClient(clientOverride);
+    const market = address(marketAddress);
+    const instruction = await client.jobs.closeMarket({ market });
+    const tx = await client.solana.buildSignAndSend(instruction);
+    expect(tx).not.toBeNull();
+}
+//# sourceMappingURL=close-market.js.map

package/dist/helpers/jobs/close-market.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-market.js","sourceRoot":"","sources":["../../../src/helpers/jobs/close-market.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAqB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,aAAqB,EACrB,cAA6B;IAE7B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9D,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAE7D,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/dist/helpers/jobs/create-market.d.ts

@@ -0,0 +1,3 @@
+import type { Address, NosanaClient, OpenParams } from '@nosana/kit';
+export declare function createMarket(params?: OpenParams, clientOverride?: NosanaClient): Promise<Address>;
+//# sourceMappingURL=create-market.d.ts.map

package/dist/helpers/jobs/create-market.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-market.d.ts","sourceRoot":"","sources":["../../../src/helpers/jobs/create-market.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKrE,wBAAsB,YAAY,CAChC,MAAM,GAAE,UAAe,EACvB,cAAc,CAAC,EAAE,YAAY,GAC5B,OAAO,CAAC,OAAO,CAAC,CAYlB"}

package/dist/helpers/jobs/create-market.js

@@ -0,0 +1,14 @@
+import { JobsClient } from '@nosana/kit';
+import { expect } from 'vitest';
+import { resolveClient } from '../resolve-client.js';
+export async function createMarket(params = {}, clientOverride) {
+    const client = await resolveClient(clientOverride);
+    const instruction = await client.jobs.createMarket(params);
+    const tx = await client.solana.buildSignAndSend(instruction);
+    const parsed = JobsClient.parseOpenInstruction(instruction);
+    const marketAddress = parsed.accounts.market.address;
+    expect(marketAddress).toBeDefined();
+    expect(tx).not.toBeNull();
+    return marketAddress;
+}
+//# sourceMappingURL=create-market.js.map

package/dist/helpers/jobs/create-market.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-market.js","sourceRoot":"","sources":["../../../src/helpers/jobs/create-market.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAqB,EAAE,EACvB,cAA6B;IAE7B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAE7D,MAAM,MAAM,GAAG,UAAU,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;IAErD,MAAM,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAE1B,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/helpers/jobs/index.d.ts

@@ -0,0 +1,6 @@
+export { createMarket } from './create-market.js';
+export { closeMarket } from './close-market.js';
+export { listJob } from './list-job.js';
+export { joinMarketQueue, type JoinMarketQueueOptions } from './join-market-queue.js';
+export { waitForJobState } from './wait-for-job-state.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/jobs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/helpers/jobs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/helpers/jobs/index.js

@@ -0,0 +1,6 @@
+export { createMarket } from './create-market.js';
+export { closeMarket } from './close-market.js';
+export { listJob } from './list-job.js';
+export { joinMarketQueue } from './join-market-queue.js';
+export { waitForJobState } from './wait-for-job-state.js';
+//# sourceMappingURL=index.js.map

package/dist/helpers/jobs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/jobs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAA+B,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/helpers/jobs/join-market-queue.d.ts

@@ -0,0 +1,6 @@
+import { type NosanaClient } from '@nosana/kit';
+export interface JoinMarketQueueOptions {
+    verifyQueued?: boolean;
+}
+export declare function joinMarketQueue(marketAddress: string, options?: JoinMarketQueueOptions, clientOverride?: NosanaClient): Promise<void>;
+//# sourceMappingURL=join-market-queue.d.ts.map

package/dist/helpers/jobs/join-market-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-market-queue.d.ts","sourceRoot":"","sources":["../../../src/helpers/jobs/join-market-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAIzD,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,sBAA2B,EACpC,cAAc,CAAC,EAAE,YAAY,GAC5B,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist/helpers/jobs/join-market-queue.js

@@ -0,0 +1,28 @@
+import { address } from '@nosana/kit';
+import { expect } from 'vitest';
+import { resolveClient } from '../resolve-client.js';
+export async function joinMarketQueue(marketAddress, options = {}, clientOverride) {
+    const client = await resolveClient(clientOverride);
+    const market = address(marketAddress);
+    const { verifyQueued = true } = options;
+    const instruction = await client.jobs.work({ market });
+    try {
+        await client.solana.buildSignAndSend(instruction);
+    }
+    catch (error) {
+        const err = error;
+        const errorCode = err?.details?.cause?.context?.code;
+        const errorLogs = err?.context?.logs || [];
+        const hasNodeAlreadyQueued = errorCode === 6014 || errorLogs.some((log) => log.includes('NodeAlreadyQueued'));
+        if (!hasNodeAlreadyQueued) {
+            throw error;
+        }
+    }
+    if (verifyQueued) {
+        const marketAfter = await client.jobs.market(market);
+        const nodeAddress = client.wallet.address.toString();
+        const queueAddresses = marketAfter.queue.map((addr) => addr.toString());
+        expect(queueAddresses).toContain(nodeAddress);
+    }
+}
+//# sourceMappingURL=join-market-queue.js.map

package/dist/helpers/jobs/join-market-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-market-queue.js","sourceRoot":"","sources":["../../../src/helpers/jobs/join-market-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAqB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAMrD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,aAAqB,EACrB,UAAkC,EAAE,EACpC,cAA6B;IAE7B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtC,MAAM,EAAE,YAAY,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAExC,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAEvD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAGX,CAAC;QACF,MAAM,SAAS,GAAG,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC;QACrD,MAAM,SAAS,GAAG,GAAG,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;QAC3C,MAAM,oBAAoB,GACxB,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAEnF,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC1B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtD,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxE,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/helpers/jobs/list-job.d.ts

@@ -0,0 +1,3 @@
+import type { Address, ListParams, NosanaClient } from '@nosana/kit';
+export declare function listJob(params: Omit<ListParams, 'timeout' | 'ipfsHash'> & Partial<Pick<ListParams, 'timeout' | 'ipfsHash'>>, clientOverride?: NosanaClient): Promise<Address>;
+//# sourceMappingURL=list-job.d.ts.map

package/dist/helpers/jobs/list-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-job.d.ts","sourceRoot":"","sources":["../../../src/helpers/jobs/list-job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQrE,wBAAsB,OAAO,CAC3B,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC,GAC9C,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC,EACnD,cAAc,CAAC,EAAE,YAAY,GAC5B,OAAO,CAAC,OAAO,CAAC,CAgBlB"}

package/dist/helpers/jobs/list-job.js

@@ -0,0 +1,20 @@
+import { JobsClient } from '@nosana/kit';
+import { expect } from 'vitest';
+import { resolveClient } from '../resolve-client.js';
+const DEFAULT_TIMEOUT = 3600;
+const DEFAULT_IPFS_HASH = 'QmVp8m3Uq1Cm6JJ3NsuTMSGLNnqXa1mC85uV7YxBREQ78p';
+export async function listJob(params, clientOverride) {
+    const client = await resolveClient(clientOverride);
+    const instruction = await client.jobs.list({
+        timeout: DEFAULT_TIMEOUT,
+        ipfsHash: DEFAULT_IPFS_HASH,
+        ...params,
+    });
+    const tx = await client.solana.buildSignAndSend(instruction);
+    const parsed = JobsClient.parseListInstruction(instruction);
+    const jobAddress = parsed.accounts.job.address;
+    expect(jobAddress).toBeDefined();
+    expect(tx).not.toBeNull();
+    return jobAddress;
+}
+//# sourceMappingURL=list-job.js.map

package/dist/helpers/jobs/list-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-job.js","sourceRoot":"","sources":["../../../src/helpers/jobs/list-job.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,eAAe,GAAG,IAAI,CAAC;AAC7B,MAAM,iBAAiB,GAAG,gDAAgD,CAAC;AAE3E,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MACmD,EACnD,cAA6B;IAE7B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QACzC,OAAO,EAAE,eAAe;QACxB,QAAQ,EAAE,iBAAiB;QAC3B,GAAG,MAAM;KACV,CAAC,CAAC;IACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAE7D,MAAM,MAAM,GAAG,UAAU,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;IAE/C,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAE1B,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/helpers/jobs/wait-for-job-state.d.ts

@@ -0,0 +1,3 @@
+import { JobState, type NosanaClient } from '@nosana/kit';
+export declare function waitForJobState(jobAddress: string, expectedState: JobState, clientOverride?: NosanaClient): Promise<void>;
+//# sourceMappingURL=wait-for-job-state.d.ts.map

package/dist/helpers/jobs/wait-for-job-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-job-state.d.ts","sourceRoot":"","sources":["../../../src/helpers/jobs/wait-for-job-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAInE,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,QAAQ,EACvB,cAAc,CAAC,EAAE,YAAY,GAC5B,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/helpers/jobs/wait-for-job-state.js

@@ -0,0 +1,14 @@
+import { address } from '@nosana/kit';
+import { expect } from 'vitest';
+import { resolveClient } from '../resolve-client.js';
+export async function waitForJobState(jobAddress, expectedState, clientOverride) {
+    const client = await resolveClient(clientOverride);
+    const job = address(jobAddress);
+    await expect
+        .poll(async () => {
+        const fetched = await client.jobs.get(job);
+        return fetched?.state;
+    }, { message: `Waiting for job to reach ${expectedState} state` })
+        .toBe(expectedState);
+}
+//# sourceMappingURL=wait-for-job-state.js.map

package/dist/helpers/jobs/wait-for-job-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-job-state.js","sourceRoot":"","sources":["../../../src/helpers/jobs/wait-for-job-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA+B,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,aAAuB,EACvB,cAA6B;IAE7B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEhC,MAAM,MAAM;SACT,IAAI,CACH,KAAK,IAAI,EAAE;QACT,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO,OAAO,EAAE,KAAK,CAAC;IACxB,CAAC,EACD,EAAE,OAAO,EAAE,4BAA4B,aAAa,QAAQ,EAAE,CAC/D;SACA,IAAI,CAAC,aAAa,CAAC,CAAC;AACzB,CAAC"}

package/dist/helpers/nodes/finish-job.d.ts

@@ -0,0 +1,3 @@
+import { type NosanaClient } from '@nosana/kit';
+export declare function finishJob(jobAddress: string, clientOverride?: NosanaClient): Promise<void>;
+//# sourceMappingURL=finish-job.d.ts.map

package/dist/helpers/nodes/finish-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish-job.d.ts","sourceRoot":"","sources":["../../../src/helpers/nodes/finish-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAIzD,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhG"}

package/dist/helpers/nodes/finish-job.js

@@ -0,0 +1,14 @@
+import { address } from '@nosana/kit';
+import { expect } from 'vitest';
+import { resolveClient } from '../resolve-client.js';
+export async function finishJob(jobAddress, clientOverride) {
+    const client = await resolveClient(clientOverride);
+    const job = address(jobAddress);
+    const instruction = await client.jobs.finish({
+        job,
+        ipfsResultsHash: 'QmV2iq3gexzSwPAbhBAPVDip7Pu6k7whECUa4wzUjnPtdA',
+    });
+    const tx = await client.solana.buildSignAndSend(instruction);
+    expect(tx).not.toBeNull();
+}
+//# sourceMappingURL=finish-job.js.map

package/dist/helpers/nodes/finish-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish-job.js","sourceRoot":"","sources":["../../../src/helpers/nodes/finish-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAqB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAAkB,EAAE,cAA6B;IAC/E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEhC,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAC3C,GAAG;QACH,eAAe,EAAE,gDAAgD;KAClE,CAAC,CAAC;IACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAE7D,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/dist/helpers/nodes/index.d.ts

@@ -0,0 +1,3 @@
+export { finishJob } from './finish-job.js';
+export { verifyJobAssignedToNode, type VerifyJobAssignedOptions, } from './verify-job-assigned-to-node.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/nodes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/helpers/nodes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,uBAAuB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,kCAAkC,CAAC"}

package/dist/helpers/nodes/index.js

@@ -0,0 +1,3 @@
+export { finishJob } from './finish-job.js';
+export { verifyJobAssignedToNode, } from './verify-job-assigned-to-node.js';
+//# sourceMappingURL=index.js.map

package/dist/helpers/nodes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/nodes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,uBAAuB,GAExB,MAAM,kCAAkC,CAAC"}

package/dist/helpers/nodes/verify-job-assigned-to-node.d.ts

@@ -0,0 +1,6 @@
+import { type NosanaClient } from '@nosana/kit';
+export type VerifyJobAssignedOptions = {
+    expectedState?: number;
+};
+export declare function verifyJobAssignedToNode(jobAddress: string, options?: VerifyJobAssignedOptions, clientOverride?: NosanaClient): Promise<void>;
+//# sourceMappingURL=verify-job-assigned-to-node.d.ts.map

package/dist/helpers/nodes/verify-job-assigned-to-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-job-assigned-to-node.d.ts","sourceRoot":"","sources":["../../../src/helpers/nodes/verify-job-assigned-to-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAIzD,MAAM,MAAM,wBAAwB,GAAG;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,wBAAwB,EAClC,cAAc,CAAC,EAAE,YAAY,GAC5B,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/helpers/nodes/verify-job-assigned-to-node.js

@@ -0,0 +1,14 @@
+import { address } from '@nosana/kit';
+import { expect } from 'vitest';
+import { resolveClient } from '../resolve-client.js';
+export async function verifyJobAssignedToNode(jobAddress, options, clientOverride) {
+    const client = await resolveClient(clientOverride);
+    const job = address(jobAddress);
+    const { state, node } = await client.jobs.get(job);
+    const nodeAddress = client.wallet.address.toString();
+    expect(node).toBe(nodeAddress);
+    if (options?.expectedState !== undefined) {
+        expect(state).toBe(options.expectedState);
+    }
+}
+//# sourceMappingURL=verify-job-assigned-to-node.js.map

package/dist/helpers/nodes/verify-job-assigned-to-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-job-assigned-to-node.js","sourceRoot":"","sources":["../../../src/helpers/nodes/verify-job-assigned-to-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAqB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAMrD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,UAAkB,EAClB,OAAkC,EAClC,cAA6B;IAE7B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IAEtD,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAE/B,IAAI,OAAO,EAAE,aAAa,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/helpers/resolve-client.d.ts

@@ -0,0 +1,3 @@
+import type { NosanaClient } from '@nosana/kit';
+export declare function resolveClient(clientOverride?: NosanaClient): Promise<NosanaClient>;
+//# sourceMappingURL=resolve-client.d.ts.map

package/dist/helpers/resolve-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-client.d.ts","sourceRoot":"","sources":["../../src/helpers/resolve-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,wBAAsB,aAAa,CAAC,cAAc,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAExF"}

package/dist/helpers/resolve-client.js

@@ -0,0 +1,5 @@
+import { getScenarioClient } from '../setup.js';
+export async function resolveClient(clientOverride) {
+    return clientOverride ?? (await getScenarioClient());
+}
+//# sourceMappingURL=resolve-client.js.map

package/dist/helpers/resolve-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-client.js","sourceRoot":"","sources":["../../src/helpers/resolve-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,cAA6B;IAC/D,OAAO,cAAc,IAAI,CAAC,MAAM,iBAAiB,EAAE,CAAC,CAAC;AACvD,CAAC"}

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 export { getScenarioClient, getLocalnetClient, type ScenarioClientOptions, type LocalnetClientOptions, } from './setup.js';
 export { mintNosTo, ensureLocalnetMint, executeInstructionPlan, loadMintKeypairSigner, loadMintAuthoritySigner, } from './utils.js';
+export { createMarket, closeMarket, listJob, joinMarketQueue, waitForJobState, finishJob, verifyJobAssignedToNode, type JoinMarketQueueOptions, type VerifyJobAssignedOptions, } from './helpers/index.js';
 export { scenarioVitestSetup } from './vitest-setup-fn.js';
 export { defineScenarioVitestConfig } from './vitest-config.js';
 export { startLocalnet, stopLocalnet, LOCALNET_RPC_ENDPOINT, LOCALNET_WS_ENDPOINT, type LocalnetOptions, } from '@nosana/localnet';
 export type { NosanaClient, Wallet, Address } from '@nosana/kit';
-export { NosanaNetwork } from '@nosana/kit';
+export { NosanaNetwork, JobState } from '@nosana/kit';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGhE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,OAAO,EACP,eAAe,EACf,eAAe,EACf,SAAS,EACT,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,GAC9B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGhE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,8 +1,9 @@
 export { getScenarioClient, getLocalnetClient, } from './setup.js';
 export { mintNosTo, ensureLocalnetMint, executeInstructionPlan, loadMintKeypairSigner, loadMintAuthoritySigner, } from './utils.js';
+export { createMarket, closeMarket, listJob, joinMarketQueue, waitForJobState, finishJob, verifyJobAssignedToNode, } from './helpers/index.js';
 export { scenarioVitestSetup } from './vitest-setup-fn.js';
 export { defineScenarioVitestConfig } from './vitest-config.js';
 // Re-export localnet helpers for convenience
 export { startLocalnet, stopLocalnet, LOCALNET_RPC_ENDPOINT, LOCALNET_WS_ENDPOINT, } from '@nosana/localnet';
-export { NosanaNetwork } from '@nosana/kit';
+export { NosanaNetwork, JobState } from '@nosana/kit';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAGlB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEhE,6CAA6C;AAC7C,OAAO,EACL,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,GAErB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAGlB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,OAAO,EACP,eAAe,EACf,eAAe,EACf,SAAS,EACT,uBAAuB,GAGxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEhE,6CAA6C;AAC7C,OAAO,EACL,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,GAErB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/setup.d.ts

@@ -29,6 +29,11 @@ export interface ScenarioClientOptions extends LocalnetClientOptions {
      *   pointing to a Solana keypair JSON file).
      */
     network?: 'localnet' | 'devnet' | 'mainnet';
+    /**
+     * Cache key for the client instance. Each unique key gets its own
+     * independently funded client. Defaults to `'default'`.
+     */
+    key?: string;
 }
 /**
  * Returns a cached Nosana client connected to localnet.

package/dist/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,MAAM,EACZ,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC7C;AAmCD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKxF;AAeD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKxF"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,MAAM,EACZ,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;IAE5C;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAmCD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKxF;AAeD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAWxF"}

package/dist/setup.js

@@ -74,17 +74,22 @@ async function loadWalletFromFile(filePath) {
  * ```
  */
 export function getScenarioClient(options) {
-    if (!globalWithScenario.__NOSANA_SCENARIO_CLIENT__) {
-        globalWithScenario.__NOSANA_SCENARIO_CLIENT__ = createScenarioClientInstance(options);
+    if (!globalWithScenario.__NOSANA_SCENARIO_CLIENTS__) {
+        globalWithScenario.__NOSANA_SCENARIO_CLIENTS__ = new Map();
     }
-    return globalWithScenario.__NOSANA_SCENARIO_CLIENT__;
+    const resolvedKey = options?.key ?? 'default';
+    const clients = globalWithScenario.__NOSANA_SCENARIO_CLIENTS__;
+    if (!clients.has(resolvedKey)) {
+        clients.set(resolvedKey, createScenarioClientInstance(options));
+    }
+    return clients.get(resolvedKey);
 }
 async function createScenarioClientInstance(options) {
     const network = options?.network ??
         process.env.NOSANA_NETWORK ??
         'localnet';
     if (network === 'localnet') {
-        return getLocalnetClient(options);
+        return createLocalnetClientInstance(options);
     }
     const wallet = options?.wallet ?? (await resolveWalletFromEnv());
     if (!wallet) {

package/dist/setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,GAId,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA8CvC,MAAM,kBAAkB,GAAG,UAAsC,CAAC;AAClE,MAAM,kBAAkB,GAAG,UAAsC,CAAC;AAElE,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,KAAK,UAAU,4BAA4B,CACzC,UAAiC,EAAE;IAEnC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,qBAAqB,EAAE,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEnE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;YAC1B,SAAS,EAAE,MAAM,CAAC,OAAO;YACzB,MAAM,EAAE,OAAO,CAAC,aAAa,IAAI,WAAc;SAChD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,IAAI,WAAc,CAAC,CAAC;IAC9E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA+B;IAC/D,IAAI,CAAC,kBAAkB,CAAC,0BAA0B,EAAE,CAAC;QACnD,kBAAkB,CAAC,0BAA0B,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,kBAAkB,CAAC,0BAA0B,CAAC;AACvD,CAAC;AAED,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E;;GAEG;AACH,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IAChD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,OAAO,4BAA4B,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA+B;IAC/D,IAAI,CAAC,kBAAkB,CAAC,0BAA0B,EAAE,CAAC;QACnD,kBAAkB,CAAC,0BAA0B,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,kBAAkB,CAAC,0BAA0B,CAAC;AACvD,CAAC;AAED,KAAK,UAAU,4BAA4B,CACzC,OAA+B;IAE/B,MAAM,OAAO,GACX,OAAO,EAAE,OAAO;QACf,OAAO,CAAC,GAAG,CAAC,cAAmD;QAChE,UAAU,CAAC;IAEb,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,MAAM,oBAAoB,EAAE,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,kCAAkC,OAAO,IAAI;YAC3C,uEAAuE;YACvE,0DAA0D,CAC7D,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC;IAC3F,OAAO,kBAAkB,CAAC,aAAa,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,KAAK,UAAU,oBAAoB;IACjC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC7C,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,kBAAkB,CAAC,UAAU,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nosana/scenario",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "Nosana scenario test helpers: network-aware client setup for localnet, devnet, and mainnet",
   "type": "module",
   "main": "dist/index.js",
@@ -59,5 +59,5 @@
     "package.json",
     "README.md"
   ],
-  "gitHead": "fe1fb33d98b537b781b3cce80f78f6e61c1d1cd4"
+  "gitHead": "9b58da22f18b0391ef29d2657055b0ac0b9c53c6"
 }