@nosana/kit 1.0.7 → 1.0.8

package/examples/browser/package.json

@@ -1,31 +0,0 @@
-{
-  "name": "nosana-sdk-browser-playground",
-  "description": "Interactive documentation and testing environment for the Nosana SDK",
-  "version": "1.0.0",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "build": "nuxt build",
-    "dev": "nuxt dev",
-    "generate": "nuxt generate",
-    "preview": "nuxt preview",
-    "postinstall": "nuxt prepare",
-    "start": "nuxt dev"
-  },
-  "dependencies": {
-    "@headlessui/vue": "^1.7.23",
-    "@heroicons/vue": "^2.2.0",
-    "@nosana/kit": "^0.1.2",
-    "@nuxtjs/tailwindcss": "^7.0.0-beta.0",
-    "@tailwindcss/typography": "^0.5.16",
-    "nuxt": "^3.17.4",
-    "vue": "^3.5.15",
-    "vue-router": "^4.5.1"
-  },
-  "devDependencies": {
-    "@tailwindcss/postcss": "^4.1.8",
-    "autoprefixer": "^10.4.21",
-    "postcss": "^8.5.4",
-    "tailwindcss": "^4.1.8"
-  }
-}

package/examples/browser/public/robots.txt

@@ -1,2 +0,0 @@
-User-Agent: *
-Disallow:

package/examples/browser/start.sh

@@ -1,38 +0,0 @@
-#!/bin/bash
-
-echo "🚀 Starting Nosana SDK Browser Playground..."
-echo ""
-
-# Check if Node.js is installed
-if ! command -v node &> /dev/null; then
-    echo "❌ Node.js is not installed. Please install Node.js 20.18.0 or higher."
-    exit 1
-fi
-
-# Check Node.js version
-NODE_VERSION=$(node -v | cut -d'v' -f2)
-REQUIRED_VERSION="20.18.0"
-
-if [ "$(printf '%s\n' "$REQUIRED_VERSION" "$NODE_VERSION" | sort -V | head -n1)" != "$REQUIRED_VERSION" ]; then
-    echo "⚠️  Warning: Node.js version $NODE_VERSION detected. Recommended version is $REQUIRED_VERSION or higher."
-fi
-
-# Check if we're in the right directory
-if [ ! -f "package.json" ]; then
-    echo "❌ Please run this script from the examples/browser directory"
-    exit 1
-fi
-
-# Install dependencies if node_modules doesn't exist
-if [ ! -d "node_modules" ]; then
-    echo "📦 Installing dependencies..."
-    npm install
-    echo ""
-fi
-
-echo "🌐 Starting development server..."
-echo "📖 Open http://localhost:3000 in your browser"
-echo "🛑 Press Ctrl+C to stop the server"
-echo ""
-
-npm run dev 

package/examples/browser/tailwind.config.js

@@ -1,26 +0,0 @@
-/** @type {import('tailwindcss').Config} */
-module.exports = {
-  content: [
-    "./components/**/*.{js,vue,ts}",
-    "./layouts/**/*.vue",
-    "./pages/**/*.vue",
-    "./plugins/**/*.{js,ts}",
-    "./app.vue",
-    "./error.vue"
-  ],
-  theme: {
-    extend: {
-      colors: {
-        terminal: {
-          bg: '#1a202c',
-          text: '#68d391',
-          error: '#fc8181',
-          success: '#68d391',
-          info: '#63b3ed',
-          warning: '#f6e05e'
-        }
-      }
-    },
-  },
-  plugins: [],
-} 

package/examples/node/README.md

@@ -1,261 +0,0 @@
-# Nosana Kit Node.js Examples
-
-This directory contains Node.js examples for using the Nosana Kit.
-
-## Set Wallet Example
-
-The `set-wallet.ts` example demonstrates various ways to initialize and set a wallet for the Nosana Client.
-
-### Supported Wallet Formats
-
-The `setWallet` method supports the following input formats:
-
-1. **File Path**: Path to a JSON file containing a keypair array
-2. **JSON Array String**: A string containing a JSON array of numbers representing the keypair
-3. **Number Array**: A direct array of numbers representing the keypair
-4. **Base58 String**: A base58-encoded private key
-5. **Environment Variable**: Name of an environment variable containing the keypair data
-6. **KeyPairSigner Object**: An existing KeyPairSigner instance
-
-### Running the Example
-
-```bash
-# Navigate to the examples/node directory
-cd examples/node
-
-# Install dependencies
-npm install
-
-# Run the set-wallet example
-npx ts-node set-wallet.ts
-```
-
-### Example Usage
-
-```typescript
-import { NosanaClient, NosanaNetwork } from '@nosana/kit';
-
-const client = new NosanaClient(NosanaNetwork.DEVNET);
-
-// From file path
-await client.setWallet('./path/to/keypair.json');
-
-// From JSON string
-await client.setWallet('[174,47,154,16,...]');
-
-// From number array
-await client.setWallet([174, 47, 154, 16, ...]);
-
-// From base58 string
-await client.setWallet('base58EncodedPrivateKey');
-
-// From environment variable
-process.env.WALLET_KEY = '[174,47,154,16,...]';
-await client.setWallet('WALLET_KEY');
-```
-
-### Quick Test
-
-You can test the setWallet functionality manually by creating a simple test file:
-
-```javascript
-// test-setwallet.js
-const { NosanaClient, NosanaNetwork } = require('@nosana/kit');
-
-async function testSetWallet() {
-  const client = new NosanaClient(NosanaNetwork.DEVNET);
-  
-  // Test with a sample keypair array
-  const sampleKeypair = [
-    174, 47, 154, 16, 202, 193, 206, 113, 199, 190, 53, 133, 169, 175, 31, 56, 222, 53, 138,
-    189, 224, 216, 117, 173, 10, 149, 53, 45, 73, 251, 237, 246, 15, 185, 186, 82, 177, 240,
-    148, 69, 241, 227, 167, 80, 141, 89, 240, 121, 121, 35, 172, 247, 68, 251, 226, 218, 48,
-    63, 176, 109, 168, 89, 238, 135,
-  ];
-  
-  try {
-    const wallet = await client.setWallet(sampleKeypair);
-    console.log('✅ Wallet set successfully!');
-    console.log('Address:', wallet?.address);
-  } catch (error) {
-    console.error('❌ Error:', error.message);
-  }
-}
-
-testSetWallet();
-```
-
-Run it with: `node test-setwallet.js`
-
-### Error Handling
-
-The `setWallet` method tries multiple conversion methods in sequence. If all methods fail, it throws a `NosanaError` with the code `WALLET_CONVERSION_ERROR`.
-
-```typescript
-try {
-  await client.setWallet(walletData);
-  console.log('Wallet set successfully:', client.wallet?.address);
-} catch (error) {
-  if (error instanceof NosanaError && error.code === ErrorCodes.WALLET_CONVERSION_ERROR) {
-    console.error('Failed to set wallet:', error.message);
-  }
-}
-```
-
-### Implementation Details
-
-The `setWallet` method in `src/index.ts` implements the following logic:
-
-1. **KeyPairSigner Check**: If the input is already a KeyPairSigner object, it's used directly
-2. **File Path Processing**: For strings that look like file paths (absolute, `./`, or `../`), it attempts to load the keypair from file
-3. **Environment Variable**: Tries to load from environment variables (both JSON and base58 formats)
-4. **JSON Parsing**: Attempts to parse JSON array strings
-5. **Base58 Decoding**: Tries to decode base58-encoded strings  
-6. **Array Processing**: Converts number arrays to Uint8Array for keypair creation
-
-### Unit Tests
-
-Comprehensive unit tests have been created in `src/__tests__/setWallet.test.ts` to cover:
-
-- ✅ KeyPairSigner input handling
-- ✅ File path validation and loading
-- ✅ Environment variable processing
-- ✅ JSON array string parsing
-- ✅ Base58 string decoding
-- ✅ Number array conversion
-- ✅ Error handling for invalid inputs
-- ✅ File path validation (absolute vs relative paths)
-
-**Note**: Due to Jest/TypeScript configuration complexities with the `gill/dist/node` imports, running the tests may require additional setup. The functionality works correctly at runtime.
-
-## NOS Token Service Example
-
-The `nos-service.ts` example demonstrates how to interact with NOS token accounts using the NosService.
-
-### Features
-
-1. **Get all NOS token holders** - Fetch all token accounts holding NOS tokens (excludes zero balances by default)
-2. **Include zero balance accounts** - Optional flag to include accounts with zero balance
-3. **Exclude PDA accounts** - Filter out smart contract-owned token accounts (PDAs)
-4. **Get token account for address** - Retrieve token account details for a specific owner
-5. **Get balance** - Convenience method to get just the NOS balance
-6. **Batch queries** - Fetch balances for multiple addresses
-7. **Filter and analyze** - Find large holders and analyze token distribution
-
-### Running the Example
-
-```bash
-# Navigate to the examples/node directory
-cd examples/node
-
-# Install dependencies
-npm install
-
-# Run the nos-service example
-npm run nos-service
-```
-
-### Example Usage
-
-```typescript
-import { NosanaClient, NosanaNetwork } from '@nosana/kit';
-
-const client = new NosanaClient(NosanaNetwork.MAINNET);
-
-// Get all token holders (single RPC call, excludes zero balances by default)
-const holders = await client.nos.getAllTokenHolders();
-console.log(`Found ${holders.length} NOS token holders`);
-
-// Include accounts with zero balance
-const allAccounts = await client.nos.getAllTokenHolders({ includeZeroBalance: true });
-console.log(`Total accounts: ${allAccounts.length}`);
-
-// Exclude PDA accounts (smart contract-owned accounts)
-const userAccounts = await client.nos.getAllTokenHolders({ excludePdaAccounts: true });
-console.log(`User-owned accounts: ${userAccounts.length}`);
-
-// Get token account for specific address
-const account = await client.nos.getTokenAccountForAddress('owner-address');
-if (account) {
-  console.log(`Balance: ${account.uiAmount} NOS`);
-}
-
-// Get just the balance (convenience method)
-const balance = await client.nos.getBalance('owner-address');
-console.log(`Balance: ${balance} NOS`);
-
-// Filter holders by minimum balance
-const largeHolders = holders.filter(holder => holder.uiAmount >= 1000);
-```
-
-### Use Cases
-
-- **Analytics**: Analyze token distribution and holder statistics
-- **Airdrops**: Get list of all token holders for airdrop campaigns
-- **Balance checks**: Check NOS balances for specific addresses
-- **Leaderboards**: Create holder leaderboards sorted by balance
-- **Monitoring**: Track large holder movements
-
-## Stake Program Example
-
-The `stake-program.ts` example demonstrates how to interact with Nosana staking accounts using the StakeProgram.
-
-### Features
-
-1. **Get all stake accounts** - Fetch all staking accounts on-chain
-2. **Get single stake** - Fetch details of a specific stake account
-3. **Get multiple stakes** - Fetch multiple stake accounts by address
-4. **Analyze distribution** - Calculate staking statistics (total, average, largest)
-
-### Running the Example
-
-```bash
-# Navigate to the examples/node directory
-cd examples/node
-
-# Install dependencies
-npm install
-
-# Run the stake-program example
-npm run stake-program
-```
-
-### Example Usage
-
-```typescript
-import { NosanaClient, NosanaNetwork } from '@nosana/kit';
-
-const client = new NosanaClient(NosanaNetwork.MAINNET);
-
-// Get all stake accounts
-const allStakes = await client.stake.all();
-console.log(`Found ${allStakes.length} stake accounts`);
-
-// Get single stake account
-const stake = await client.stake.get('stake-account-address');
-console.log(`Staked amount: ${stake.amount}`);
-console.log(`xNOS tokens: ${stake.xnos}`);
-
-// Analyze staking distribution
-const totalStaked = allStakes.reduce((sum, s) => sum + s.amount, 0);
-const averageStake = totalStaked / allStakes.length;
-console.log(`Total staked: ${totalStaked.toLocaleString()}`);
-console.log(`Average stake: ${averageStake.toLocaleString()}`);
-```
-
-## Other Examples
-
-- `retrieve.ts` - Example of retrieving job data
-- `monitor.ts` - Example of monitoring jobs
-
-## Running Tests
-
-To run all tests:
-```bash
-npm test
-```
-
-To run specific tests:
-```bash
-npm test -- --testNamePattern="setWallet"
-``` 

package/examples/node/example-keypair.json

@@ -1 +0,0 @@
-[66,240,117,68,169,30,179,62,57,123,28,249,122,218,186,173,196,222,208,58,126,168,32,91,126,64,102,33,220,51,49,97,6,197,228,206,210,117,23,184,89,48,217,110,194,137,242,129,112,23,140,120,148,249,210,18,105,192,40,197,250,132,40,149]

package/examples/node/monitor.ts

@@ -1,143 +0,0 @@
-import { NosanaClient, NosanaNetwork, Job, Market, Run } from '@nosana/kit';
-import { promises as fs } from 'fs';
-
-// Type for storing accounts in a more readable format
-type AccountData = {
-  address: string;
-  data: Job | Run | Market;
-  lastUpdated: string;
-};
-
-async function main() {
-  // Initialize the Nosana client
-  const client = new NosanaClient(NosanaNetwork.MAINNET);
-
-  console.log('Starting job account monitoring...');
-
-  // Storage for accounts
-  const jobAccounts = new Map<string, AccountData>();
-  const runAccounts = new Map<string, AccountData>();
-  const marketAccounts = new Map<string, AccountData>();
-
-  // Helper function to save accounts to file
-  const saveAccountsToFile = async () => {
-    const data = {
-      jobAccounts: Object.fromEntries(jobAccounts),
-      runAccounts: Object.fromEntries(runAccounts),
-      marketAccounts: Object.fromEntries(marketAccounts),
-      lastUpdated: new Date().toISOString(),
-      totalAccounts: jobAccounts.size + runAccounts.size + marketAccounts.size
-    };
-
-    try {
-      await fs.writeFile('accounts.json', JSON.stringify(data, null, 2));
-      console.log(`💾 Saved ${data.totalAccounts} accounts to accounts.json`);
-    } catch (error) {
-      console.error('Failed to save accounts to file:', error);
-    }
-  };
-
-  // Load existing accounts if file exists
-  try {
-    const existingData = await fs.readFile('accounts.json', 'utf-8');
-    const parsed = JSON.parse(existingData);
-
-    if (parsed.jobAccounts) {
-      for (const [key, value] of Object.entries(parsed.jobAccounts)) {
-        jobAccounts.set(key, value as AccountData);
-      }
-    }
-    if (parsed.runAccounts) {
-      for (const [key, value] of Object.entries(parsed.runAccounts)) {
-        runAccounts.set(key, value as AccountData);
-      }
-    }
-    if (parsed.marketAccounts) {
-      for (const [key, value] of Object.entries(parsed.marketAccounts)) {
-        marketAccounts.set(key, value as AccountData);
-      }
-    }
-
-    console.log(`📂 Loaded existing accounts: ${jobAccounts.size} jobs, ${runAccounts.size} runs, ${marketAccounts.size} markets`);
-  } catch (error) {
-    console.log('📝 Starting with empty account storage (no existing file found)');
-  }
-
-  try {
-    // Start monitoring job account updates with callback functions
-    const stopMonitoring = await client.jobs.monitor({
-      onJobAccount: async (jobAccount: Job) => {
-        const accountData: AccountData = {
-          address: jobAccount.address.toString(),
-          data: jobAccount,
-          lastUpdated: new Date().toISOString()
-        };
-
-        jobAccounts.set(jobAccount.address.toString(), accountData);
-        console.log(`🔄 Job account updated: ${jobAccount.address.toString()}`);
-
-        // Save to file after each update
-        await saveAccountsToFile();
-      },
-
-      onRunAccount: async (runAccount: Run) => {
-        const accountData: AccountData = {
-          address: runAccount.address.toString(),
-          data: runAccount,
-          lastUpdated: new Date().toISOString()
-        };
-
-        runAccounts.set(runAccount.address.toString(), accountData);
-        console.log(`🏃 Run account updated: ${runAccount.address.toString()}`);
-
-        // Save to file after each update
-        await saveAccountsToFile();
-      },
-
-      onMarketAccount: async (marketAccount: Market) => {
-        const accountData: AccountData = {
-          address: marketAccount.address.toString(),
-          data: marketAccount,
-          lastUpdated: new Date().toISOString()
-        };
-
-        marketAccounts.set(marketAccount.address.toString(), accountData);
-        console.log(`🏪 Market account updated: ${marketAccount.address.toString()}`);
-
-        // Save to file after each update
-        await saveAccountsToFile();
-      },
-
-      onError: async (error: Error, accountType?: string) => {
-        console.error(`❌ Error processing ${accountType || 'unknown'} account:`, error.message);
-      }
-    });
-
-    console.log('✅ Job account monitoring started successfully!');
-    console.log('📊 Monitoring will save account updates to accounts.json');
-    console.log('🔍 Watching for job, run, and market account updates...');
-    console.log('⏹️  Press Ctrl+C to stop monitoring...');
-
-    // Handle graceful shutdown
-    process.on('SIGINT', async () => {
-      console.log('\n🛑 Stopping job account monitoring...');
-      stopMonitoring();
-
-      // Final save
-      await saveAccountsToFile();
-
-      console.log('✅ Monitoring stopped. Final data saved. Exiting...');
-      process.exit(0);
-    });
-
-    // Keep the process running
-    await new Promise(() => { });
-
-  } catch (error) {
-    console.error('❌ Failed to start job account monitoring:', error);
-    process.exit(1);
-  }
-}
-
-// Run the example
-main().catch(console.error); 

package/examples/node/nos-service.ts

@@ -1,117 +0,0 @@
-/**
- * Example: Using the NosService to interact with NOS token accounts
- * 
- * This example demonstrates how to use the NosService to:
- * 1. Get all NOS token holders
- * 2. Get a specific token account for an address
- * 3. Get the NOS balance for an address
- */
-
-import { NosanaClient, NosanaNetwork } from '@nosana/kit';
-
-async function main() {
-  // Initialize the Nosana client (use MAINNET for real data)
-  const client = new NosanaClient(NosanaNetwork.MAINNET);
-
-  // Example 1: Get all NOS token holders (excludes zero balance by default)
-  console.log('Fetching all NOS token holders...');
-  try {
-    const holders = await client.nos.getAllTokenHolders();
-
-    console.log(`Found ${holders.length} NOS token holders (with non-zero balances)`);
-
-    // Display first 5 holders
-    holders.slice(0, 5).forEach((holder, index) => {
-      console.log(`\nHolder ${index + 1}:`);
-      console.log(`  Token Account: ${holder.pubkey}`);
-      console.log(`  Owner: ${holder.owner}`);
-      console.log(`  Balance: ${holder.uiAmount} NOS`);
-      console.log(`  Raw Amount: ${holder.amount.toString()}`);
-      console.log(`  Decimals: ${holder.decimals}`);
-    });
-
-    // Include zero balance accounts
-    console.log('\nFetching all accounts including zero balances...');
-    const allAccounts = await client.token.getAllTokenHolders({ includeZeroBalance: true });
-    console.log(`Total accounts (including zero balance): ${allAccounts.length}`);
-    console.log(`Accounts with zero balance: ${allAccounts.length - holders.length}`);
-
-    // Exclude PDA accounts (smart contract-owned accounts)
-    console.log('\nFetching user-owned accounts only (excluding PDAs)...');
-    const userAccounts = await client.token.getAllTokenHolders({ excludePdaAccounts: true });
-    console.log(`User-owned accounts: ${userAccounts.length}`);
-    console.log(`PDA accounts: ${holders.length - userAccounts.length}`);
-  } catch (error) {
-    console.error('Error fetching token holders:', error);
-  }
-
-  // Example 2: Get token account for a specific address
-  const ownerAddress = 'YourWalletAddressHere';
-
-  console.log(`\nFetching NOS token account for ${ownerAddress}...`);
-  try {
-    const account = await client.nos.getTokenAccountForAddress(ownerAddress);
-
-    if (account) {
-      console.log('Token Account found:');
-      console.log(`  Account Address: ${account.pubkey}`);
-      console.log(`  Owner: ${account.owner}`);
-      console.log(`  Mint: ${account.mint}`);
-      console.log(`  Balance: ${account.uiAmount} NOS`);
-      console.log(`  Raw Amount: ${account.amount.toString()}`);
-      console.log(`  Decimals: ${account.decimals}`);
-    } else {
-      console.log('No NOS token account found for this address');
-    }
-  } catch (error) {
-    console.error('Error fetching token account:', error);
-  }
-
-  // Example 3: Get just the balance (convenience method)
-  console.log(`\nFetching NOS balance for ${ownerAddress}...`);
-  try {
-    const balance = await client.nos.getBalance(ownerAddress);
-    console.log(`Balance: ${balance} NOS`);
-  } catch (error) {
-    console.error('Error fetching balance:', error);
-  }
-
-  // Example 4: Working with multiple addresses
-  const addresses = [
-    'Address1Here',
-    'Address2Here',
-    'Address3Here',
-  ];
-
-  console.log('\nFetching balances for multiple addresses...');
-  for (const addr of addresses) {
-    try {
-      const balance = await client.nos.getBalance(addr);
-      console.log(`${addr}: ${balance} NOS`);
-    } catch (error) {
-      console.error(`Error fetching balance for ${addr}:`, error);
-    }
-  }
-
-  // Example 5: Filter holders by minimum balance
-  console.log('\nFinding holders with at least 1000 NOS...');
-  try {
-    const holders = await client.nos.getAllTokenHolders();
-    const largeHolders = holders.filter(holder => holder.uiAmount >= 1000);
-
-    console.log(`Found ${largeHolders.length} holders with >= 1000 NOS`);
-
-    // Sort by balance descending
-    const sorted = largeHolders.sort((a, b) => b.uiAmount - a.uiAmount);
-
-    // Display top 10
-    sorted.slice(0, 10).forEach((holder, index) => {
-      console.log(`${index + 1}. ${holder.owner}: ${holder.uiAmount.toLocaleString()} NOS`);
-    });
-  } catch (error) {
-    console.error('Error analyzing holders:', error);
-  }
-}
-
-main().catch(console.error);
-