@nosana/kit 2.0.18 → 2.0.23

package/README.md

@@ -340,41 +340,71 @@ await client.solana.buildSignAndSend(instruction);
 
 #### Monitor Account Updates
 
+The SDK provides two monitoring methods using async iterators for real-time account updates via WebSocket:
+
+**Simple Monitoring** (`monitor()`) - Automatically merges run account data into job events:
+
 ```typescript
-async monitor(options?: {
-  onJobAccount?: (job: Job) => void | Promise<void>,
-  onMarketAccount?: (market: Market) => void | Promise<void>,
-  onRunAccount?: (run: Run) => void | Promise<void>,
-  onError?: (error: Error, accountType?: string) => void | Promise<void>
-}): Promise<() => void>
+async monitor(): Promise<[AsyncIterable<SimpleMonitorEvent>, () => void]>
 ```
 
-Subscribe to real-time account updates via WebSocket. Includes automatic reconnection on failure.
-
 ```typescript
-// Start monitoring
-const stopMonitoring = await client.jobs.monitor({
-  onJobAccount: async (job) => {
-    console.log('Job update:', job.address, job.state);
+import { MonitorEventType } from '@nosana/kit';
 
+// Start monitoring
+const [eventStream, stop] = await client.jobs.monitor();
+
+// Process events using async iteration
+for await (const event of eventStream) {
+  if (event.type === MonitorEventType.JOB) {
+    console.log('Job update:', event.data.address, event.data.state);
+    // event.data will have state, node, and timeStart from run account if it exists
+    
     // Process updates - save to database, trigger workflows, etc.
-    if (job.state === JobState.COMPLETED) {
-      await processCompletedJob(job);
+    if (event.data.state === JobState.COMPLETED) {
+      await processCompletedJob(event.data);
     }
-  },
-  onRunAccount: async (run) => {
-    console.log('Run started:', run.job, 'on node', run.node);
-  },
-  onError: (error) => {
-    console.error('Monitor error:', error);
-  },
-});
+  } else if (event.type === MonitorEventType.MARKET) {
+    console.log('Market update:', event.data.address);
+  }
+}
+
+// Stop monitoring when done
+stop();
+```
+
+**Detailed Monitoring** (`monitorDetailed()`) - Provides separate events for job, market, and run accounts:
+
+```typescript
+async monitorDetailed(): Promise<[AsyncIterable<MonitorEvent>, () => void]>
+```
+
+```typescript
+import { MonitorEventType } from '@nosana/kit';
+
+// Start detailed monitoring
+const [eventStream, stop] = await client.jobs.monitorDetailed();
+
+// Process events using async iteration
+for await (const event of eventStream) {
+  switch (event.type) {
+    case MonitorEventType.JOB:
+      console.log('Job update:', event.data.address);
+      break;
+    case MonitorEventType.MARKET:
+      console.log('Market update:', event.data.address);
+      break;
+    case MonitorEventType.RUN:
+      console.log('Run started:', event.data.job, 'on node', event.data.node);
+      break;
+  }
+}
 
 // Stop monitoring when done
-stopMonitoring();
+stop();
 ```
 
-The monitor handles WebSocket reconnection automatically and continues processing updates until explicitly stopped.
+Both methods handle WebSocket reconnection automatically and continue processing updates until explicitly stopped. The simple `monitor()` method is recommended for most use cases as it automatically merges run account data into job updates, eliminating the need to manually track run accounts.
 
 ## Account Types
 
@@ -473,6 +503,13 @@ getBalance(address?: Address | string): Promise<bigint>
 
 // Derive program derived address
 pda(seeds: Array<Address | string>, programId: Address): Promise<Address>
+
+// Get instruction to transfer SOL
+transfer(params: {
+  to: Address | string;
+  amount: number | bigint;
+  from?: TransactionSigner;
+}): Promise<Instruction> // Returns TransferSolInstruction
 ```
 
 ### Examples
@@ -495,6 +532,16 @@ console.log(`Balance: ${balance} lamports`);
 
 // Derive PDA
 const pda = await client.solana.pda(['seed1', 'seed2'], programAddress);
+
+// Get instruction to transfer SOL
+const transferSolIx = await client.solana.transfer({
+  to: 'recipient-address',
+  amount: 1000000, // lamports (can be number or bigint)
+  // from is optional - uses wallet if not provided
+});
+
+// Execute the transfer
+await client.solana.buildSignAndSend(transferSolIx);
 ```
 
 ## IPFS Service
@@ -1010,6 +1057,31 @@ console.log(`Balance: ${balance} NOS`);
 // Returns 0 if no token account exists
 ```
 
+### Transfer Tokens
+
+Get instruction(s) to transfer SPL tokens. Returns either 1 or 2 instructions depending on whether the recipient's associated token account needs to be created:
+
+```typescript
+// Get transfer instruction(s)
+const instructions = await client.nos.transfer({
+  to: 'recipient-address',
+  amount: 1000000, // token base units (can be number or bigint)
+  // from is optional - uses wallet if not provided
+});
+
+// Execute the transfer
+// instructions is a tuple:
+// - [TransferInstruction] when recipient ATA exists (1 instruction)
+// - [CreateAssociatedTokenIdempotentInstruction, TransferInstruction] when ATA needs creation (2 instructions)
+await client.solana.buildSignAndSend(instructions);
+```
+
+The function automatically:
+- Finds the sender's associated token account
+- Finds the recipient's associated token account
+- Creates the recipient's ATA if it doesn't exist (returns 2 instructions: create ATA + transfer)
+- Returns only the transfer instruction if the recipient's ATA already exists (returns 1 instruction)
+
 ### Type Definitions
 
 ```typescript

package/dist/NosanaClient.d.ts

@@ -4,11 +4,11 @@ import { type NosanaApi } from '@nosana/api';
 import { type NosanaAuthorization } from '@nosana/authorization';
 import { Logger } from './logger/Logger.js';
 import { ClientConfig, PartialClientConfig } from './config/index.js';
-import { type JobsProgram } from './services/programs/JobsProgram.js';
-import { type StakeProgram } from './services/programs/StakeProgram.js';
-import { type MerkleDistributorProgram } from './services/programs/MerkleDistributorProgram.js';
-import { type SolanaService } from './services/SolanaService.js';
-import { type TokenService } from './services/TokenService.js';
+import { type JobsProgram } from './services/programs/jobs/index.js';
+import { type StakeProgram } from './services/programs/stake/index.js';
+import { type MerkleDistributorProgram } from './services/programs/merkleDistributor/index.js';
+import { type SolanaService } from './services/solana/index.js';
+import { type TokenService } from './services/token/index.js';
 import type { Wallet } from './types.js';
 /**
  * The Nosana client interface. Contains all the services and programs

package/dist/NosanaClient.js

@@ -4,11 +4,11 @@ import { createNosanaApi } from '@nosana/api';
 import { createNosanaAuthorization } from '@nosana/authorization';
 import { Logger } from './logger/Logger.js';
 import { getNosanaConfig } from './config/index.js';
-import { createJobsProgram } from './services/programs/JobsProgram.js';
-import { createStakeProgram } from './services/programs/StakeProgram.js';
-import { createMerkleDistributorProgram, } from './services/programs/MerkleDistributorProgram.js';
-import { createSolanaService } from './services/SolanaService.js';
-import { createTokenService } from './services/TokenService.js';
+import { createJobsProgram } from './services/programs/jobs/index.js';
+import { createStakeProgram } from './services/programs/stake/index.js';
+import { createMerkleDistributorProgram, } from './services/programs/merkleDistributor/index.js';
+import { createSolanaService } from './services/solana/index.js';
+import { createTokenService } from './services/token/index.js';
 import { walletToAuthorizationSigner } from './utils/walletToAuthorizationSigner.js';
 /**
  * Creates a new Nosana client instance.
@@ -48,6 +48,7 @@ export function createNosanaClient(network = NosanaNetwork.MAINNET, customConfig
     const programDeps = {
         logger,
         solana,
+        nos,
         getWallet,
     };
     // Initialize programs

package/dist/NosanaClient.js.map

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

package/dist/index.d.ts

@@ -7,16 +7,16 @@ export type { Wallet } from './types.js';
 export * from './config/index.js';
 export * from './errors/NosanaError.js';
 export * from './logger/Logger.js';
-export { createJobsProgram, type JobsProgram, JobState, MarketQueueType, } from './services/programs/JobsProgram.js';
-export type { Job, Market, Run } from './services/programs/JobsProgram.js';
-export { createStakeProgram, type StakeProgram } from './services/programs/StakeProgram.js';
-export type { Stake } from './services/programs/StakeProgram.js';
-export { createMerkleDistributorProgram, type MerkleDistributorProgram, ClaimTarget, } from './services/programs/MerkleDistributorProgram.js';
-export type { MerkleDistributor, ClaimStatus, } from './services/programs/MerkleDistributorProgram.js';
-export { ClaimStatusNotFoundError } from './services/programs/MerkleDistributorProgram.js';
+export { createJobsProgram, type JobsProgram, JobState, MarketQueueType, } from './services/programs/jobs/index.js';
+export type { Job, Market, Run } from './services/programs/jobs/index.js';
+export { createStakeProgram, type StakeProgram } from './services/programs/stake/index.js';
+export type { Stake } from './services/programs/stake/index.js';
+export { createMerkleDistributorProgram, type MerkleDistributorProgram, ClaimTarget, } from './services/programs/merkleDistributor/index.js';
+export type { MerkleDistributor, ClaimStatus, } from './services/programs/merkleDistributor/index.js';
+export { ClaimStatusNotFoundError } from './services/programs/merkleDistributor/index.js';
 export { solBytesArrayToIpfsHash, ipfsHashToSolBytesArray } from '@nosana/ipfs';
-export { createTokenService, type TokenService } from './services/TokenService.js';
-export type { TokenAccount, TokenAccountWithBalance } from './services/TokenService.js';
+export { createTokenService, type TokenService } from './services/token/index.js';
+export type { TokenAccount, TokenAccountWithBalance } from './services/token/index.js';
 export * as JobsClient from './generated_clients/jobs/index.js';
 export * as StakingClient from './generated_clients/staking/index.js';
 export * as MerkleDistributorClient from './generated_clients/merkle_distributor/index.js';

package/dist/index.js

@@ -9,16 +9,16 @@ export * from './config/index.js';
 export * from './errors/NosanaError.js';
 export * from './logger/Logger.js';
 // Export JobsProgram and related types
-export { createJobsProgram, JobState, MarketQueueType, } from './services/programs/JobsProgram.js';
+export { createJobsProgram, JobState, MarketQueueType, } from './services/programs/jobs/index.js';
 // Export StakeProgram and related types
-export { createStakeProgram } from './services/programs/StakeProgram.js';
+export { createStakeProgram } from './services/programs/stake/index.js';
 // Export MerkleDistributorProgram and related types
-export { createMerkleDistributorProgram, ClaimTarget, } from './services/programs/MerkleDistributorProgram.js';
-export { ClaimStatusNotFoundError } from './services/programs/MerkleDistributorProgram.js';
+export { createMerkleDistributorProgram, ClaimTarget, } from './services/programs/merkleDistributor/index.js';
+export { ClaimStatusNotFoundError } from './services/programs/merkleDistributor/index.js';
 // Export IPFS utilities from @nosana/ipfs
 export { solBytesArrayToIpfsHash, ipfsHashToSolBytesArray } from '@nosana/ipfs';
 // Export token service
-export { createTokenService } from './services/TokenService.js';
+export { createTokenService } from './services/token/index.js';
 // Export generated clients under namespaces to avoid naming conflicts
 export * as JobsClient from './generated_clients/jobs/index.js';
 export * as StakingClient from './generated_clients/staking/index.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,OAAO,EAAE,kBAAkB,EAAqB,MAAM,mBAAmB,CAAC;AAE1E,oFAAoF;AACpF,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI9C,iCAAiC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AAEnC,uCAAuC;AACvC,OAAO,EACL,iBAAiB,EAEjB,QAAQ,EACR,eAAe,GAChB,MAAM,oCAAoC,CAAC;AAG5C,wCAAwC;AACxC,OAAO,EAAE,kBAAkB,EAAqB,MAAM,qCAAqC,CAAC;AAG5F,oDAAoD;AACpD,OAAO,EACL,8BAA8B,EAE9B,WAAW,GACZ,MAAM,iDAAiD,CAAC;AAKzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAE3F,0CAA0C;AAC1C,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEhF,uBAAuB;AACvB,OAAO,EAAE,kBAAkB,EAAqB,MAAM,4BAA4B,CAAC;AAGnF,sEAAsE;AACtE,OAAO,KAAK,UAAU,MAAM,mCAAmC,CAAC;AAChE,OAAO,KAAK,aAAa,MAAM,sCAAsC,CAAC;AACtE,OAAO,KAAK,uBAAuB,MAAM,iDAAiD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,OAAO,EAAE,kBAAkB,EAAqB,MAAM,mBAAmB,CAAC;AAE1E,oFAAoF;AACpF,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI9C,iCAAiC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AAEnC,uCAAuC;AACvC,OAAO,EACL,iBAAiB,EAEjB,QAAQ,EACR,eAAe,GAChB,MAAM,mCAAmC,CAAC;AAG3C,wCAAwC;AACxC,OAAO,EAAE,kBAAkB,EAAqB,MAAM,oCAAoC,CAAC;AAG3F,oDAAoD;AACpD,OAAO,EACL,8BAA8B,EAE9B,WAAW,GACZ,MAAM,gDAAgD,CAAC;AAKxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAE1F,0CAA0C;AAC1C,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEhF,uBAAuB;AACvB,OAAO,EAAE,kBAAkB,EAAqB,MAAM,2BAA2B,CAAC;AAGlF,sEAAsE;AACtE,OAAO,KAAK,UAAU,MAAM,mCAAmC,CAAC;AAChE,OAAO,KAAK,aAAa,MAAM,sCAAsC,CAAC;AACtE,OAAO,KAAK,uBAAuB,MAAM,iDAAiD,CAAC"}

package/dist/services/programs/jobs/JobsProgram.d.ts

@@ -0,0 +1,152 @@
+import { type ConvertTypesForDb } from '../../../utils/index.js';
+import type { Address } from '@solana/kit';
+import type { ProgramDeps } from '../../../types.js';
+import type { ProgramConfig } from '../../../config/types.js';
+import * as Instructions from './instructions/index.js';
+import * as programClient from '../../../generated_clients/jobs/index.js';
+import type { SimpleMonitorEvent, MonitorEvent } from './monitor/index.js';
+export declare enum JobState {
+    QUEUED = 0,
+    RUNNING = 1,
+    COMPLETED = 2,
+    STOPPED = 3
+}
+export declare enum MarketQueueType {
+    JOB_QUEUE = 0,
+    NODE_QUEUE = 1
+}
+export type Job = Omit<ConvertTypesForDb<programClient.JobAccountArgs>, 'state'> & {
+    address: Address;
+    state: JobState;
+};
+export type Market = Omit<ConvertTypesForDb<programClient.MarketAccountArgs>, 'queueType'> & {
+    address: Address;
+    queueType: MarketQueueType;
+};
+export type Run = ConvertTypesForDb<programClient.RunAccountArgs> & {
+    address: Address;
+};
+export { MonitorEventType } from './monitor/index.js';
+export type { SimpleMonitorEvent, MonitorEvent } from './monitor/index.js';
+/**
+ * Jobs program interface
+ */
+export interface JobsProgram {
+    /**
+     * Fetch a job account by address
+     */
+    get(addr: Address, checkRun?: boolean): Promise<Job>;
+    /**
+     * Fetch a run account by address
+     */
+    run(addr: Address): Promise<Run>;
+    /**
+     * Fetch a market account by address
+     */
+    market(addr: Address): Promise<Market>;
+    /**
+     * Fetch multiple job accounts by address
+     */
+    multiple(addresses: Address[], checkRuns?: boolean): Promise<Job[]>;
+    /**
+     * Fetch all job accounts
+     */
+    all(filters?: {
+        state?: JobState;
+        market?: Address;
+        node?: Address;
+        project?: Address;
+    }, checkRuns?: boolean): Promise<Job[]>;
+    /**
+     * Fetch all run accounts
+     */
+    runs(filters?: {
+        node?: Address;
+        job?: Address;
+    }): Promise<Run[]>;
+    /**
+     * Fetch all market accounts
+     */
+    markets(): Promise<Market[]>;
+    /**
+     * Post a new job to the marketplace
+     */
+    post: Instructions.Post;
+    /**
+     *  Extend an existing job's timeout
+     */
+    extend: Instructions.Extend;
+    /**
+     * Delist a job from the marketplace
+     */
+    delist: Instructions.Delist;
+    /**
+     * Stop a running job
+     */
+    end(params: {
+        job: Address;
+    }): Promise<ReturnType<typeof programClient.getEndInstruction>>;
+    /**
+     * Monitor program account updates using async iterators.
+     * Automatically merges run account data into job account updates.
+     * Returns a tuple of [eventStream, stopFunction].
+     *
+     * @example
+     * ```typescript
+     * const [eventStream, stop] = await jobsProgram.monitor();
+     * for await (const event of eventStream) {
+     *   if (event.type === MonitorEventType.JOB) {
+     *     console.log('Job updated:', event.data.address);
+     *   } else if (event.type === MonitorEventType.MARKET) {
+     *     console.log('Market updated:', event.data.address);
+     *   }
+     * }
+     * ```
+     */
+    monitor(): Promise<[AsyncIterable<SimpleMonitorEvent>, () => void]>;
+    /**
+     * Monitor program account updates with detailed events for each account type.
+     * Provides separate events for job, market, and run accounts.
+     * Returns a tuple of [eventStream, stopFunction].
+     *
+     * @example
+     * ```typescript
+     * const [eventStream, stop] = await jobsProgram.monitorDetailed();
+     * for await (const event of eventStream) {
+     *   switch (event.type) {
+     *     case MonitorEventType.JOB:
+     *       console.log('Job updated:', event.data.address);
+     *       break;
+     *     case MonitorEventType.MARKET:
+     *       console.log('Market updated:', event.data.address);
+     *       break;
+     *     case MonitorEventType.RUN:
+     *       console.log('Run updated:', event.data.address);
+     *       break;
+     *   }
+     * }
+     * ```
+     */
+    monitorDetailed(): Promise<[AsyncIterable<MonitorEvent>, () => void]>;
+}
+/**
+ * Creates a new JobsProgram instance.
+ *
+ * @param deps - Program dependencies (config, logger, solana service, wallet getter)
+ * @returns A JobsProgram instance with methods to interact with the jobs program
+ *
+ * @example
+ * ```ts
+ * import { createJobsProgram } from '@nosana/kit';
+ *
+ * const jobsProgram = createJobsProgram({
+ *   config,
+ *   logger,
+ *   solana,
+ *   getWallet,
+ * });
+ *
+ * const job = await jobsProgram.get('job-address');
+ * ```
+ */
+export declare function createJobsProgram(deps: ProgramDeps, config: ProgramConfig): JobsProgram;