@nosana/scenario 2.2.0

package/README.md

@@ -0,0 +1,141 @@
+# @nosana/scenario
+
+Network-aware scenario test helpers for Nosana. Run the same tests against localnet, devnet, or mainnet — controlled entirely via environment variables.
+
+Uses [`@nosana/localnet`](../localnet) for Docker infrastructure and [`@nosana/kit`](../kit) for the Nosana SDK.
+
+## Quick Start
+
+```bash
+npm install --save-dev @nosana/scenario
+```
+
+### Write Tests
+
+```ts
+import { describe, it, expect } from 'vitest';
+import { getScenarioClient } from '@nosana/scenario';
+
+describe('scenario: basic', () => {
+  it('works with the Nosana SDK', async () => {
+    const client = await getScenarioClient();
+    const balance = await client.solana.getBalance();
+    expect(balance).toBeGreaterThan(0);
+  });
+});
+```
+
+### Run Against Different Networks
+
+No code changes needed — just set environment variables:
+
+```bash
+# Localnet (default) — starts a local Solana validator via Docker
+npm run test:scenario:localnet
+
+# Devnet — requires a funded wallet
+NOSANA_NETWORK=devnet NOSANA_WALLET=~/.config/solana/id.json npm run test:scenario
+
+# Mainnet
+NOSANA_NETWORK=mainnet NOSANA_WALLET=/path/to/keypair.json npm run test:scenario
+```
+
+### Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `NOSANA_NETWORK` | `localnet` | Target network: `localnet`, `devnet`, or `mainnet` |
+| `NOSANA_WALLET` | — | Path to a Solana keypair JSON file (required for devnet/mainnet) |
+
+### Vitest Integration
+
+```ts
+// vitest.scenario.config.ts
+import { defineScenarioVitestConfig } from '@nosana/scenario';
+
+export default defineScenarioVitestConfig({
+  test: {
+    include: ['tests/scenarios/**/*.test.ts'],
+  },
+});
+```
+
+### npm Scripts
+
+These scripts are already included in `@nosana/scenario`'s `package.json`:
+
+| Script | Description |
+|--------|-------------|
+| `test:scenario` | Run scenario tests with vitest |
+| `test:scenario:localnet` | Start localnet + run scenario tests |
+| `localnet:up` | Start the Docker-based Solana validator |
+| `localnet:down` | Stop the validator and clean up |
+
+From the workspace root:
+
+```bash
+# Run everything
+pnpm --filter @nosana/scenario run test:scenario:localnet
+
+# Or step by step
+pnpm run localnet:up
+pnpm --filter @nosana/scenario run test:scenario
+pnpm run localnet:down
+```
+
+## API Reference
+
+### `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)
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `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) |
+| `mintAmount` | `bigint` | `1_000_000_000n` | NOS mint amount (localnet only) |
+| `config` | `Partial<NosanaClientConfig>` | — | Override client config |
+
+**Localnet** (default): generates a random keypair, airdrops SOL, and mints NOS tokens.
+
+**Devnet / Mainnet**: connects with the provided wallet (via option or `NOSANA_WALLET` env var). No airdrop or minting is performed.
+
+### `getLocalnetClient(options?): Promise<NosanaClient>`
+
+Returns a cached `NosanaClient` connected to localnet. Equivalent to `getScenarioClient({ network: 'localnet' })`.
+
+### `mintNosTo(client, recipient, amount): Promise<void>`
+
+Mint NOS tokens to any address on the localnet.
+
+### `ensureLocalnetMint(client): Promise<{ mintAuthority, mintAddress }>`
+
+Ensures the NOS mint exists on localnet. Creates it if it doesn't exist.
+
+### `executeInstructionPlan(client, plan): Promise<void>`
+
+Execute a Solana instruction plan using the client's wallet as fee payer.
+
+### `defineScenarioVitestConfig(overrides?): object`
+
+Returns a Vitest config object with the scenario setup file pre-configured.
+
+### Re-exports from `@nosana/localnet`
+
+- `startLocalnet`, `stopLocalnet`
+- `LOCALNET_RPC_ENDPOINT`, `LOCALNET_WS_ENDPOINT`
+
+### Re-exports from `@nosana/kit`
+
+- `NosanaNetwork`, `type NosanaClient`, `type Wallet`, `type Address`

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { getScenarioClient, getLocalnetClient, type ScenarioClientOptions, type LocalnetClientOptions, } from './setup.js';
+export { mintNosTo, ensureLocalnetMint, executeInstructionPlan, loadMintKeypairSigner, loadMintAuthoritySigner, } from './utils.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';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { getScenarioClient, getLocalnetClient, } from './setup.js';
+export { mintNosTo, ensureLocalnetMint, executeInstructionPlan, loadMintKeypairSigner, loadMintAuthoritySigner, } from './utils.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';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/setup.d.ts

@@ -0,0 +1,71 @@
+import { type NosanaClient, type PartialClientConfig, type Wallet } from '@nosana/kit';
+export interface LocalnetClientOptions {
+    /**
+     * Wallet to use. If not provided, a random keypair is generated and funded.
+     */
+    wallet?: Wallet;
+    /**
+     * Amount of SOL (in lamports) to airdrop. Default: 2 SOL.
+     */
+    airdropAmount?: bigint;
+    /**
+     * Amount of NOS (in raw token units) to mint. Default: 1 000 000 000.
+     */
+    mintAmount?: bigint;
+    /**
+     * Additional Nosana client config overrides.
+     */
+    config?: PartialClientConfig;
+}
+export interface ScenarioClientOptions extends LocalnetClientOptions {
+    /**
+     * Network to run scenarios against. Defaults to `'localnet'`.
+     * Can also be set via the `NOSANA_NETWORK` environment variable.
+     *
+     * - `'localnet'` — connects to `http://127.0.0.1:8899`, generates a keypair,
+     *   airdrops SOL, and mints NOS tokens.
+     * - `'devnet'` / `'mainnet'` — connects to the respective Nosana network.
+     *   Requires a funded wallet (via `wallet` option or `NOSANA_WALLET` env var
+     *   pointing to a Solana keypair JSON file).
+     */
+    network?: 'localnet' | 'devnet' | 'mainnet';
+}
+/**
+ * Returns a cached Nosana client connected to localnet.
+ *
+ * Generates a random keypair, airdrops SOL, and mints NOS tokens automatically.
+ */
+export declare function getLocalnetClient(options?: LocalnetClientOptions): Promise<NosanaClient>;
+/**
+ * Returns a cached Nosana client for scenario tests, aware of 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)
+ *
+ * On localnet: delegates to {@link getLocalnetClient} from `@nosana/localnet`.
+ * On devnet / mainnet: connects using the provided wallet (required).
+ *
+ * @example
+ * ```ts
+ * // Localnet (default — zero config)
+ * const client = await getScenarioClient();
+ *
+ * // Devnet via env vars (no code changes needed)
+ * // NOSANA_NETWORK=devnet NOSANA_WALLET=~/.config/solana/id.json
+ * const client = await getScenarioClient();
+ *
+ * // Devnet with explicit options
+ * const client = await getScenarioClient({
+ *   network: 'devnet',
+ *   wallet: myDevnetWallet,
+ * });
+ * ```
+ */
+export declare function getScenarioClient(options?: ScenarioClientOptions): Promise<NosanaClient>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +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"}

package/dist/setup.js

@@ -0,0 +1,104 @@
+import fs from 'fs';
+import { createKeyPairSignerFromBytes, generateKeyPairSigner } from '@solana/kit';
+import { createLocalnetClient, createNosanaClient, NosanaNetwork, } from '@nosana/kit';
+import { mintNosTo } from './utils.js';
+const globalWithLocalnet = globalThis;
+const globalWithScenario = globalThis;
+// ---------------------------------------------------------------------------
+// Localnet client
+// ---------------------------------------------------------------------------
+async function createLocalnetClientInstance(options = {}) {
+    const wallet = options.wallet ?? (await generateKeyPairSigner());
+    const client = createLocalnetClient({ ...options.config, wallet });
+    const balance = await client.solana.getBalance(wallet.address);
+    if (balance === 0) {
+        await client.solana.airdrop({
+            recipient: wallet.address,
+            amount: options.airdropAmount ?? 2000000000n,
+        });
+    }
+    await mintNosTo(client, wallet.address, options.mintAmount ?? 1000000000n);
+    return client;
+}
+/**
+ * Returns a cached Nosana client connected to localnet.
+ *
+ * Generates a random keypair, airdrops SOL, and mints NOS tokens automatically.
+ */
+export function getLocalnetClient(options) {
+    if (!globalWithLocalnet.__NOSANA_LOCALNET_CLIENT__) {
+        globalWithLocalnet.__NOSANA_LOCALNET_CLIENT__ = createLocalnetClientInstance(options);
+    }
+    return globalWithLocalnet.__NOSANA_LOCALNET_CLIENT__;
+}
+// ---------------------------------------------------------------------------
+// Scenario client (network-aware)
+// ---------------------------------------------------------------------------
+/**
+ * Load a wallet from a Solana keypair JSON file.
+ */
+async function loadWalletFromFile(filePath) {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    const bytes = new Uint8Array(JSON.parse(raw));
+    return createKeyPairSignerFromBytes(bytes);
+}
+/**
+ * Returns a cached Nosana client for scenario tests, aware of 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)
+ *
+ * On localnet: delegates to {@link getLocalnetClient} from `@nosana/localnet`.
+ * On devnet / mainnet: connects using the provided wallet (required).
+ *
+ * @example
+ * ```ts
+ * // Localnet (default — zero config)
+ * const client = await getScenarioClient();
+ *
+ * // Devnet via env vars (no code changes needed)
+ * // NOSANA_NETWORK=devnet NOSANA_WALLET=~/.config/solana/id.json
+ * const client = await getScenarioClient();
+ *
+ * // Devnet with explicit options
+ * const client = await getScenarioClient({
+ *   network: 'devnet',
+ *   wallet: myDevnetWallet,
+ * });
+ * ```
+ */
+export function getScenarioClient(options) {
+    if (!globalWithScenario.__NOSANA_SCENARIO_CLIENT__) {
+        globalWithScenario.__NOSANA_SCENARIO_CLIENT__ = createScenarioClientInstance(options);
+    }
+    return globalWithScenario.__NOSANA_SCENARIO_CLIENT__;
+}
+async function createScenarioClientInstance(options) {
+    const network = options?.network ??
+        process.env.NOSANA_NETWORK ??
+        'localnet';
+    if (network === 'localnet') {
+        return getLocalnetClient(options);
+    }
+    const wallet = options?.wallet ?? (await resolveWalletFromEnv());
+    if (!wallet) {
+        throw new Error(`A funded wallet is required on ${network}. ` +
+            'Provide it via ScenarioClientOptions.wallet or set the NOSANA_WALLET ' +
+            'environment variable to a Solana keypair JSON file path.');
+    }
+    const nosanaNetwork = network === 'mainnet' ? NosanaNetwork.MAINNET : NosanaNetwork.DEVNET;
+    return createNosanaClient(nosanaNetwork, { ...options?.config, wallet });
+}
+async function resolveWalletFromEnv() {
+    const walletPath = process.env.NOSANA_WALLET;
+    if (!walletPath)
+        return undefined;
+    return loadWalletFromFile(walletPath);
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,29 @@
+import { address, type InstructionPlan, type Address, type TransactionSigner } from '@solana/kit';
+import type { NosanaClient } from '@nosana/kit';
+/**
+ * Load the NOS mint keypair signer from the bundled keys directory,
+ * or from a custom path via `LOCALNET_NOS_MINT_KEYPAIR` env var.
+ */
+export declare function loadMintKeypairSigner(): Promise<import("@solana/kit").KeyPairSigner<string>>;
+/**
+ * Load the NOS mint authority signer from the bundled keys directory,
+ * or from a custom path via `LOCALNET_NOS_MINT_AUTHORITY_KEYPAIR` env var.
+ */
+export declare function loadMintAuthoritySigner(): Promise<TransactionSigner>;
+/**
+ * Ensure the NOS mint exists on the localnet validator.
+ * Creates it if it doesn't exist, validates the authority if it does.
+ */
+export declare function ensureLocalnetMint(client: NosanaClient): Promise<{
+    mintAuthority: TransactionSigner;
+    mintAddress: Address;
+}>;
+/**
+ * Execute a Solana instruction plan using the client's wallet as fee payer.
+ */
+export declare function executeInstructionPlan(client: NosanaClient, plan: InstructionPlan): Promise<void>;
+/**
+ * Mint NOS tokens to a recipient address on the localnet.
+ */
+export declare function mintNosTo(client: NosanaClient, recipient: string | ReturnType<typeof address>, amount: bigint): Promise<void>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,OAAO,EAKP,KAAK,eAAe,EAKpB,KAAK,OAAO,EACZ,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAOrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgBhD;;;GAGG;AACH,wBAAsB,qBAAqB,yDAO1C;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,+BAY5C;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,YAAY;;;GAqD5D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,iBAoBvF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,EAC9C,MAAM,EAAE,MAAM,iBAef"}

package/dist/utils.js

@@ -0,0 +1,128 @@
+import fs from 'fs';
+import path from 'path';
+import { address, createKeyPairSignerFromBytes, createTransactionMessage, createTransactionPlanner, getAllSingleTransactionPlans, pipe, setTransactionMessageFeePayerSigner, setTransactionMessageLifetimeUsingBlockhash, unwrapOption, } from '@solana/kit';
+import { fetchMint, fetchMaybeMint, getCreateMintInstructionPlan, getMintToATAInstructionPlanAsync, } from '@solana-program/token';
+import { KEYS_DIR } from '@nosana/localnet';
+const NOS_MINT_DECIMALS = 6;
+const DEFAULT_NOS_MINT_KEYPAIR_PATH = path.join(KEYS_DIR, 'devr1BGQndEW5k5zfvG5FsLyZv1Ap73vNgAHcQ9sUVP.json');
+const DEFAULT_NOS_MINT_AUTHORITY_KEYPAIR_PATH = path.join(KEYS_DIR, 'dumQVNHZ1KNcLmzjMaDPEA5vFCzwHEEcQmZ8JHmmCNH.json');
+let cachedMintAuthority = null;
+let cachedMintAddress = null;
+/**
+ * Load the NOS mint keypair signer from the bundled keys directory,
+ * or from a custom path via `LOCALNET_NOS_MINT_KEYPAIR` env var.
+ */
+export async function loadMintKeypairSigner() {
+    const keypairPath = process.env.LOCALNET_NOS_MINT_KEYPAIR ?? DEFAULT_NOS_MINT_KEYPAIR_PATH;
+    const resolvedPath = path.isAbsolute(keypairPath)
+        ? keypairPath
+        : path.join(process.cwd(), keypairPath);
+    const keypair = JSON.parse(fs.readFileSync(resolvedPath, 'utf8'));
+    return createKeyPairSignerFromBytes(new Uint8Array(keypair));
+}
+/**
+ * Load the NOS mint authority signer from the bundled keys directory,
+ * or from a custom path via `LOCALNET_NOS_MINT_AUTHORITY_KEYPAIR` env var.
+ */
+export async function loadMintAuthoritySigner() {
+    if (cachedMintAuthority) {
+        return cachedMintAuthority;
+    }
+    const keypairPath = process.env.LOCALNET_NOS_MINT_AUTHORITY_KEYPAIR ?? DEFAULT_NOS_MINT_AUTHORITY_KEYPAIR_PATH;
+    const resolvedPath = path.isAbsolute(keypairPath)
+        ? keypairPath
+        : path.join(process.cwd(), keypairPath);
+    const keypair = JSON.parse(fs.readFileSync(resolvedPath, 'utf8'));
+    cachedMintAuthority = await createKeyPairSignerFromBytes(new Uint8Array(keypair));
+    return cachedMintAuthority;
+}
+/**
+ * Ensure the NOS mint exists on the localnet validator.
+ * Creates it if it doesn't exist, validates the authority if it does.
+ */
+export async function ensureLocalnetMint(client) {
+    if (cachedMintAuthority && cachedMintAddress) {
+        return {
+            mintAuthority: cachedMintAuthority,
+            mintAddress: cachedMintAddress,
+        };
+    }
+    const mintKeypair = await loadMintKeypairSigner();
+    const mintAuthority = await loadMintAuthoritySigner();
+    const envMint = process.env.LOCALNET_NOS_MINT;
+    if (envMint && address(envMint) !== mintKeypair.address) {
+        throw new Error(`LOCALNET_NOS_MINT (${envMint}) does not match mint keypair address (${mintKeypair.address}).`);
+    }
+    const mintAddress = envMint ? address(envMint) : mintKeypair.address;
+    const existingMint = await fetchMaybeMint(client.solana.rpc, mintAddress);
+    if (!existingMint.exists) {
+        const createMintPlan = getCreateMintInstructionPlan({
+            payer: client.wallet,
+            newMint: mintKeypair,
+            decimals: NOS_MINT_DECIMALS,
+            mintAuthority: mintAuthority.address,
+            freezeAuthority: null,
+        });
+        try {
+            await executeInstructionPlan(client, createMintPlan);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.includes('already in use') || message.includes('custom program error: #0')) {
+                const existingAfter = await fetchMaybeMint(client.solana.rpc, mintAddress);
+                if (!existingAfter.exists) {
+                    throw error;
+                }
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    else {
+        const mintAuthorityOnChain = unwrapOption(existingMint.data.mintAuthority);
+        if (mintAuthorityOnChain && mintAuthorityOnChain !== mintAuthority.address) {
+            throw new Error(`Localnet NOS mint already exists with a different mint authority (${mintAuthorityOnChain}). ` +
+                'Reset the validator or provide the matching authority keypair.');
+        }
+    }
+    cachedMintAuthority = mintAuthority;
+    cachedMintAddress = mintAddress;
+    return { mintAuthority: cachedMintAuthority, mintAddress };
+}
+/**
+ * Execute a Solana instruction plan using the client's wallet as fee payer.
+ */
+export async function executeInstructionPlan(client, plan) {
+    const planner = createTransactionPlanner({
+        createTransactionMessage: async () => {
+            const { value: latestBlockhash } = await client.solana.rpc.getLatestBlockhash().send();
+            return pipe(createTransactionMessage({ version: 0 }), (tx) => setTransactionMessageFeePayerSigner(client.wallet, tx), (tx) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx));
+        },
+    });
+    const transactionPlan = await planner(plan);
+    const messages = getAllSingleTransactionPlans(transactionPlan).map((p) => p.message);
+    for (const message of messages) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const signed = await client.solana.signTransaction(message);
+        await client.solana.sendTransaction(signed, { commitment: 'confirmed' });
+    }
+}
+/**
+ * Mint NOS tokens to a recipient address on the localnet.
+ */
+export async function mintNosTo(client, recipient, amount) {
+    const { mintAuthority, mintAddress } = await ensureLocalnetMint(client);
+    const owner = typeof recipient === 'string' ? address(recipient) : recipient;
+    const mintAccount = await fetchMint(client.solana.rpc, mintAddress);
+    const mintToPlan = await getMintToATAInstructionPlanAsync({
+        payer: client.wallet,
+        owner,
+        mint: mintAddress,
+        mintAuthority,
+        decimals: mintAccount.data.decimals,
+        amount,
+    });
+    await executeInstructionPlan(client, mintToPlan);
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/dist/vitest-config.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Create a Vitest config for scenario tests.
+ *
+ * @example
+ * ```ts
+ * // vitest.scenario.config.ts
+ * import { defineScenarioVitestConfig } from '@nosana/scenario';
+ *
+ * export default defineScenarioVitestConfig({
+ *   test: {
+ *     include: ['tests/scenarios/**\/*.test.ts'],
+ *   },
+ * });
+ * ```
+ */
+export declare function defineScenarioVitestConfig(overrides?: Record<string, unknown>): {
+    test: {
+        setupFiles: string[];
+        environment: string;
+        globals: boolean;
+    };
+};
+//# sourceMappingURL=vitest-config.d.ts.map

package/dist/vitest-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-config.d.ts","sourceRoot":"","sources":["../src/vitest-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;EAa7E"}

package/dist/vitest-config.js

@@ -0,0 +1,29 @@
+/**
+ * Create a Vitest config for scenario tests.
+ *
+ * @example
+ * ```ts
+ * // vitest.scenario.config.ts
+ * import { defineScenarioVitestConfig } from '@nosana/scenario';
+ *
+ * export default defineScenarioVitestConfig({
+ *   test: {
+ *     include: ['tests/scenarios/**\/*.test.ts'],
+ *   },
+ * });
+ * ```
+ */
+export function defineScenarioVitestConfig(overrides) {
+    const testOverrides = (overrides?.test ?? {});
+    const existingSetupFiles = (testOverrides.setupFiles ?? []);
+    return {
+        ...overrides,
+        test: {
+            environment: 'node',
+            globals: true,
+            ...testOverrides,
+            setupFiles: ['@nosana/scenario/dist/vitest-setup.js', ...existingSetupFiles],
+        },
+    };
+}
+//# sourceMappingURL=vitest-config.js.map

package/dist/vitest-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-config.js","sourceRoot":"","sources":["../src/vitest-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,0BAA0B,CAAC,SAAmC;IAC5E,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,CAA4B,CAAC;IACzE,MAAM,kBAAkB,GAAG,CAAC,aAAa,CAAC,UAAU,IAAI,EAAE,CAAa,CAAC;IAExE,OAAO;QACL,GAAG,SAAS;QACZ,IAAI,EAAE;YACJ,WAAW,EAAE,MAAM;YACnB,OAAO,EAAE,IAAI;YACb,GAAG,aAAa;YAChB,UAAU,EAAE,CAAC,uCAAuC,EAAE,GAAG,kBAAkB,CAAC;SAC7E;KACF,CAAC;AACJ,CAAC"}

package/dist/vitest-setup-fn.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Vitest setup function that initializes the scenario test client.
+ * Exported for programmatic use. For vitest setupFiles, use
+ * `@nosana/scenario/dist/vitest-setup.js` which auto-runs this.
+ */
+export declare function scenarioVitestSetup(): Promise<void>;
+//# sourceMappingURL=vitest-setup-fn.d.ts.map

package/dist/vitest-setup-fn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-setup-fn.d.ts","sourceRoot":"","sources":["../src/vitest-setup-fn.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,mBAAmB,kBAExC"}

package/dist/vitest-setup-fn.js

@@ -0,0 +1,10 @@
+import { getScenarioClient } from './setup.js';
+/**
+ * Vitest setup function that initializes the scenario test client.
+ * Exported for programmatic use. For vitest setupFiles, use
+ * `@nosana/scenario/dist/vitest-setup.js` which auto-runs this.
+ */
+export async function scenarioVitestSetup() {
+    await getScenarioClient();
+}
+//# sourceMappingURL=vitest-setup-fn.js.map

package/dist/vitest-setup-fn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-setup-fn.js","sourceRoot":"","sources":["../src/vitest-setup-fn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,iBAAiB,EAAE,CAAC;AAC5B,CAAC"}

package/dist/vitest-setup.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Vitest setup file — auto-runs getScenarioClient() when loaded.
+ *
+ * Use as a vitest setupFile:
+ * ```ts
+ * // vitest.scenario.config.ts
+ * import { defineScenarioVitestConfig } from '@nosana/scenario';
+ * export default defineScenarioVitestConfig();
+ * ```
+ *
+ * Or reference directly:
+ * ```ts
+ * setupFiles: ['@nosana/scenario/dist/vitest-setup.js']
+ * ```
+ */
+export { scenarioVitestSetup } from './vitest-setup-fn.js';
+//# sourceMappingURL=vitest-setup.d.ts.map

package/dist/vitest-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-setup.d.ts","sourceRoot":"","sources":["../src/vitest-setup.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/vitest-setup.js

@@ -0,0 +1,20 @@
+import { getScenarioClient } from './setup.js';
+/**
+ * Vitest setup file — auto-runs getScenarioClient() when loaded.
+ *
+ * Use as a vitest setupFile:
+ * ```ts
+ * // vitest.scenario.config.ts
+ * import { defineScenarioVitestConfig } from '@nosana/scenario';
+ * export default defineScenarioVitestConfig();
+ * ```
+ *
+ * Or reference directly:
+ * ```ts
+ * setupFiles: ['@nosana/scenario/dist/vitest-setup.js']
+ * ```
+ */
+export { scenarioVitestSetup } from './vitest-setup-fn.js';
+// Auto-run when used as a setup file
+await getScenarioClient();
+//# sourceMappingURL=vitest-setup.js.map

package/dist/vitest-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-setup.js","sourceRoot":"","sources":["../src/vitest-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,qCAAqC;AACrC,MAAM,iBAAiB,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@nosana/scenario",
+  "version": "2.2.0",
+  "description": "Nosana scenario test helpers: network-aware client setup for localnet, devnet, and mainnet",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:with-deps": "pnpm --filter $npm_package_name... run build",
+    "dev": "tsc --watch",
+    "dev:with-deps": "pnpm --filter $npm_package_name... run dev --parallel",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --config ../../.prettierrc --ignore-path ../../.prettierignore --check \"**/*.ts\"",
+    "format:fix": "prettier --config ../../.prettierrc --ignore-path ../../.prettierignore --write \"**/*.ts\"",
+    "test:scenario": "NODE_NO_WARNINGS=1 vitest run --config vitest.config.ts",
+    "test:scenario:localnet": "pnpm run localnet:up && pnpm run test:scenario",
+    "localnet:up": "docker compose -f ../localnet/docker/docker-compose.yml up -d --wait --force-recreate",
+    "localnet:down": "docker compose -f ../localnet/docker/docker-compose.yml down -v",
+    "localnet:logs": "docker compose -f ../localnet/docker/docker-compose.yml logs -f"
+  },
+  "keywords": [
+    "nosana",
+    "solana",
+    "scenario",
+    "testing"
+  ],
+  "author": "Nosana",
+  "license": "MIT",
+  "dependencies": {
+    "@nosana/kit": "2.2.0",
+    "@nosana/localnet": "2.2.0",
+    "@solana-program/token": "0.9.0",
+    "@solana/kit": "5.4.0"
+  },
+  "devDependencies": {
+    "prettier": "^3.7.4",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  },
+  "peerDependencies": {
+    "vitest": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
+  },
+  "packageManager": "pnpm@10.28.1",
+  "engines": {
+    "node": ">=20.18.0"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md"
+  ],
+  "gitHead": "fe1fb33d98b537b781b3cce80f78f6e61c1d1cd4"
+}