@nosana/kit 1.0.10 → 2.0.10

package/dist/services/TokenService.d.ts

@@ -0,0 +1,41 @@
+import { Address } from '@solana/kit';
+import { Logger } from '../logger/Logger.js';
+export interface TokenAccount {
+    pubkey: Address;
+    owner: Address;
+    mint: Address;
+    amount: bigint;
+    decimals: number;
+}
+export interface TokenAccountWithBalance extends TokenAccount {
+    uiAmount: number;
+}
+import type { SolanaService } from './SolanaService.js';
+/**
+ * Dependencies for TokenService
+ */
+export interface TokenServiceDeps {
+    logger: Logger;
+    solana: SolanaService;
+}
+/**
+ * Config for TokenService
+ */
+export interface TokenServiceConfig {
+    tokenAddress: Address;
+}
+/**
+ * TokenService interface
+ */
+export interface TokenService {
+    getAllTokenHolders(options?: {
+        includeZeroBalance?: boolean;
+        excludePdaAccounts?: boolean;
+    }): Promise<TokenAccountWithBalance[]>;
+    getTokenAccountForAddress(owner: string | Address): Promise<TokenAccountWithBalance | null>;
+    getBalance(owner: string | Address): Promise<number>;
+}
+/**
+ * Creates a TokenService instance.
+ */
+export declare function createTokenService(deps: TokenServiceDeps, config: TokenServiceConfig): TokenService;

package/dist/services/TokenService.js

@@ -0,0 +1,136 @@
+import { address } from '@solana/kit';
+import { NosanaError, ErrorCodes } from '../errors/NosanaError.js';
+import { TOKEN_PROGRAM_ADDRESS } from '@solana-program/token';
+// Standard SPL token account size
+const TOKEN_ACCOUNT_SIZE = 165;
+// Offset of mint address in token account data structure
+const MINT_OFFSET = 0;
+/**
+ * Creates a TokenService instance.
+ */
+export function createTokenService(deps, config) {
+    return {
+        /**
+         * Retrieve all token accounts for all token holders
+         * Uses a single RPC call to fetch all accounts holding the token
+         *
+         * @param options - Optional configuration
+         * @param options.includeZeroBalance - Whether to include accounts with zero balance (default: false)
+         * @param options.excludePdaAccounts - Whether to exclude PDA (Program Derived Address) accounts owned by smart contracts (default: false)
+         * @returns Array of token accounts with their balances
+         */
+        async getAllTokenHolders(options) {
+            try {
+                const tokenMint = config.tokenAddress;
+                deps.logger.debug(`Fetching all token holders for mint: ${tokenMint}`);
+                // Use getProgramAccounts to fetch all token accounts for the token mint
+                const accounts = await deps.solana.rpc
+                    .getProgramAccounts(TOKEN_PROGRAM_ADDRESS, {
+                    encoding: 'jsonParsed',
+                    filters: [
+                        {
+                            dataSize: BigInt(TOKEN_ACCOUNT_SIZE),
+                        },
+                        {
+                            memcmp: {
+                                offset: BigInt(MINT_OFFSET),
+                                bytes: tokenMint.toString(),
+                                encoding: 'base58',
+                            },
+                        },
+                    ],
+                })
+                    .send();
+                deps.logger.info(`Found ${accounts.length} token accounts`);
+                // Parse the response
+                const allAccounts = accounts.map((accountInfo) => {
+                    const parsed = accountInfo.account.data.parsed.info;
+                    return {
+                        pubkey: accountInfo.pubkey,
+                        owner: parsed.owner,
+                        mint: parsed.mint,
+                        amount: BigInt(parsed.tokenAmount.amount),
+                        decimals: parsed.tokenAmount.decimals,
+                        uiAmount: parsed.tokenAmount.uiAmount ?? 0,
+                    };
+                });
+                // Apply filters
+                const includeZeroBalance = options?.includeZeroBalance ?? false;
+                const excludePdaAccounts = options?.excludePdaAccounts ?? false;
+                let filteredAccounts = allAccounts;
+                // Filter out zero balance accounts unless explicitly included
+                if (!includeZeroBalance) {
+                    filteredAccounts = filteredAccounts.filter((account) => account.uiAmount > 0);
+                }
+                // Filter out PDA accounts (where token account equals owner, indicating smart contract ownership)
+                if (excludePdaAccounts) {
+                    const beforePdaFilter = filteredAccounts.length;
+                    filteredAccounts = filteredAccounts.filter((account) => account.pubkey !== account.owner);
+                    const pdaCount = beforePdaFilter - filteredAccounts.length;
+                    deps.logger.debug(`Filtered out ${pdaCount} PDA accounts`);
+                }
+                const filterInfo = [];
+                if (!includeZeroBalance)
+                    filterInfo.push('excluding zero balances');
+                if (excludePdaAccounts)
+                    filterInfo.push('excluding PDA accounts');
+                const filterText = filterInfo.length > 0 ? ` (${filterInfo.join(', ')})` : '';
+                deps.logger.info(`Returning ${filteredAccounts.length} token holders${filterText}`);
+                return filteredAccounts;
+            }
+            catch (error) {
+                deps.logger.error(`Failed to fetch token holders: ${error}`);
+                throw new NosanaError('Failed to fetch token holders', ErrorCodes.RPC_ERROR, error);
+            }
+        },
+        /**
+         * Retrieve the token account for a specific owner address
+         *
+         * @param owner - The owner address to query
+         * @returns The token account with balance, or null if no account exists
+         */
+        async getTokenAccountForAddress(owner) {
+            try {
+                const ownerAddr = typeof owner === 'string' ? address(owner) : owner;
+                const tokenMint = config.tokenAddress;
+                deps.logger.debug(`Fetching token account for owner: ${ownerAddr}`);
+                // Use getTokenAccountsByOwner to fetch token accounts for this owner filtered by token mint
+                const response = await deps.solana.rpc
+                    .getTokenAccountsByOwner(ownerAddr, { mint: tokenMint }, { encoding: 'jsonParsed' })
+                    .send();
+                if (response.value.length === 0) {
+                    deps.logger.debug(`No token account found for owner: ${ownerAddr}`);
+                    return null;
+                }
+                // Typically there should only be one token account per owner per mint
+                const accountInfo = response.value[0];
+                const parsed = accountInfo.account.data.parsed.info;
+                deps.logger.info(`Found token account for owner ${ownerAddr}: balance = ${parsed.tokenAmount.uiAmount}`);
+                return {
+                    pubkey: accountInfo.pubkey,
+                    owner: parsed.owner,
+                    mint: parsed.mint,
+                    amount: BigInt(parsed.tokenAmount.amount),
+                    decimals: parsed.tokenAmount.decimals,
+                    uiAmount: parsed.tokenAmount.uiAmount ?? 0,
+                };
+            }
+            catch (error) {
+                deps.logger.error(`Failed to fetch token account for owner: ${error}`);
+                throw new NosanaError('Failed to fetch token account', ErrorCodes.RPC_ERROR, error);
+            }
+        },
+        /**
+         * Get the token balance for a specific owner address
+         * Convenience method that returns just the balance
+         *
+         * @param owner - The owner address to query
+         * @returns The token balance as a UI amount (with decimals), or 0 if no account exists
+         */
+        async getBalance(owner) {
+            const account = await this.getTokenAccountForAddress(owner);
+            return account ? account.uiAmount : 0;
+        },
+    };
+}
+//# sourceMappingURL=TokenService.js.map

package/dist/services/TokenService.js.map

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

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

@@ -0,0 +1,106 @@
+import { Address } from '@solana/kit';
+import type { ProgramDeps } from '../../types.js';
+import * as programClient from '../../generated_clients/jobs/index.js';
+import { ConvertTypesForDb } from '../../utils/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;
+};
+/**
+ * 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(params: {
+        market: Address;
+        timeout: number | bigint;
+        ipfsHash: string;
+        node?: Address;
+    }): Promise<ReturnType<typeof programClient.getListInstruction>>;
+    /**
+     * Monitor program account updates using callback functions
+     */
+    monitor(options?: {
+        onJobAccount?: (jobAccount: Job) => Promise<void> | void;
+        onMarketAccount?: (marketAccount: Market) => Promise<void> | void;
+        onRunAccount?: (runAccount: Run) => Promise<void> | void;
+        onError?: (error: Error, accountType?: string) => Promise<void> | void;
+    }): Promise<() => 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');
+ * ```
+ */
+import type { ProgramConfig } from '../../config/types.js';
+export declare function createJobsProgram(deps: ProgramDeps, config: ProgramConfig): JobsProgram;