• Overview
• Architecture
• Features
  • AI Money
  • Auto FrontRun
  • Utility Tools
• Tech Stack
• Getting Started
  • Prerequisites
  • Installation
  • Environment Variables
  • Running Locally
  • Building for Production
• Project Structure
• RPC Configuration
• Tool Documentation
• API Reference
• Contributing
• Security
• License

AXSOL is a professional-grade Solana toolkit that provides validator-level trading infrastructure and a comprehensive suite of wallet management utilities. Built for traders, developers, and power users who need reliable, high-performance tools for interacting with the Solana blockchain.

• Validator-Level Access: Private validator node provides priority mempool monitoring
• Professional Infrastructure: Auto-rotating RPC endpoints with failover protection
• Complete Toolkit: 8+ utilities for token management, NFT operations, and bulk transactions
• No Mock Data: Every feature connects to real Solana mainnet infrastructure
• Open Source: Full transparency on implementation and logic

graph TB
    subgraph Platform["AXSOL Platform"]
        AI[AI Money<br/>• Pool Management<br/>• AI Engine<br/>• Profit Distribution]
        FrontRun[Auto FrontRun<br/>• Mempool Scan<br/>• Pattern Detection<br/>• Auto Execute]
        Tools[Utility Tools<br/>• NFT Burner<br/>• Token Burner<br/>• Multi Sender<br/>• Create Token<br/>• And More...]
        
        subgraph Infrastructure["Core Infrastructure"]
            RPC[RPC Manager<br/>• Rotation<br/>• Failover<br/>• Health Checks]
            Wallet[Wallet Adapter<br/>• Phantom<br/>• Solflare<br/>• Backpack]
            Logger[TX Logger<br/>• Real-time<br/>• Export CSV<br/>• History]
        end
        
        AI --> Infrastructure
        FrontRun --> Infrastructure
        Tools --> Infrastructure
    end
    
    subgraph Solana["Solana Blockchain"]
        Mainnet[Mainnet RPCs]
        Validator[Validator Node]
        Mempool[Mempool<br/>gRPC]
    end
    
    Infrastructure --> Solana

sequenceDiagram
    participant D as Depositors
    participant P as AXSOL Pool
    participant AI as AI Engine
    participant V as Validator Node
    participant M as Mempool
    
    D->>P: Deposit AXSOL
    P->>P: Aggregate Liquidity
    P->>AI: Trigger Analysis
    AI->>M: Scan Mempool
    M-->>AI: Return Opportunities
    AI->>V: Execute Trades
    V-->>AI: Trade Confirmed
    AI->>P: Distribute Profits
    P->>D: Proportional Returns

sequenceDiagram
    participant M as Solana Mempool
    participant V as AXSOL Validator Node
    participant PD as Pattern Detection
    participant AE as Auto Executor
    participant DEX as DEX/Market
    
    M->>V: gRPC Stream (~50ms)<br/>[Bundler TX] [Bundler TX] [Normal TX]
    V->>PD: Analyze Transactions
    PD->>PD: • Cluster ID<br/>• Timing Analysis<br/>• Wallet Mapping
    PD->>AE: Pattern Detected
    Note over AE: T = 0ms<br/>AXSOL Executes
    AE->>DEX: Build & Send TX
    DEX-->>AE: Trade Executed ✓
    Note over M: T = 150ms<br/>Bundlers Execute
    M->>DEX: Bundler Trades ✗<br/>(Worse Price)

Autonomous liquidity pool with AI-driven profit generation.

Withdrawal Penalty Tiers:

Status: Private Beta (95% Complete)

Real-time bundler detection and counter-execution system.

Status: Private Beta (Coming Soon)

• Node.js >= 18.0.0
• pnpm >= 8.0.0 (recommended) or npm/yarn
• Solana Wallet (Phantom, Solflare, or Backpack)

1. Clone the repository

git clone https://github.com/axsoltools/axsol-toolkit.git
cd axsol-toolkit

2. Install dependencies

pnpm install

Or with npm:

npm install

Or with yarn:

yarn install

Create a .env.local file in the root directory:

# Optional: Custom RPC endpoints (comma-separated)
NEXT_PUBLIC_CUSTOM_RPC_ENDPOINTS=https://your-rpc.com

# Optional: Arweave/Irys configuration
ARWEAVE_WALLET_KEY=your-arweave-wallet-json

Note: The application works without any environment variables by using public RPC endpoints with automatic rotation.

Development mode:

pnpm dev

The application will be available at http://localhost:3000

With turbopack (faster):

pnpm dev --turbo

1. Build the application

pnpm build

2. Start production server

pnpm start

Vercel (Recommended):

Docker:

FROM node:18-alpine AS builder
WORKDIR /app
COPY package.json pnpm-lock.yaml ./
RUN npm install -g pnpm && pnpm install --frozen-lockfile
COPY . .
RUN pnpm build

FROM node:18-alpine AS runner
WORKDIR /app
COPY --from=builder /app/.next/standalone ./
COPY --from=builder /app/.next/static ./.next/static
COPY --from=builder /app/public ./public

EXPOSE 3000
CMD ["node", "server.js"]

axsol-toolkit/
├── app/                          # Next.js App Router
│   ├── api/                      # API routes
│   │   └── arweave/
│   │       └── upload/
│   │           └── route.ts      # Arweave upload endpoint
│   ├── globals.css               # Global styles & theme
│   ├── layout.tsx                # Root layout with providers
│   └── page.tsx                  # Main application page
│
├── components/
│   ├── layout/                   # Layout components
│   │   ├── header.tsx            # Top navigation bar
│   │   ├── sidebar.tsx           # Tool selection sidebar
│   │   ├── mobile-nav.tsx        # Mobile navigation
│   │   └── transaction-log.tsx   # Transaction history panel
│   │
│   ├── providers/                # React context providers
│   │   └── wallet-providers.tsx  # Solana wallet adapter setup
│   │
│   ├── tools/                    # Tool implementations
│   │   ├── nft-burner.tsx        # NFT burning tool
│   │   ├── token-burner.tsx      # Token burning tool
│   │   ├── account-closer.tsx    # Empty account closer
│   │   ├── multi-sender.tsx      # Bulk transfer tool
│   │   ├── token-creator.tsx     # PumpPortal token launcher
│   │   ├── arweave-uploader.tsx  # Arweave file upload
│   │   ├── metadata-updater.tsx  # NFT metadata editor
│   │   ├── nft-messenger.tsx     # NFT/domain messaging
│   │   ├── ai-money.tsx          # AI Money pool interface
│   │   └── auto-frontrun.tsx     # Auto FrontRun interface
│   │
│   └── ui/                       # Reusable UI components
│       ├── glass-card.tsx        # Card component
│       ├── glass-button.tsx      # Button component
│       ├── glass-input.tsx       # Input component
│       └── ...                   # shadcn/ui components
│
├── hooks/                        # Custom React hooks
│   ├── use-nfts.ts               # NFT fetching hook
│   ├── use-wallet-tokens.ts      # Token balance hook
│   └── use-transaction-log.ts    # Transaction logging hook
│
├── lib/                          # Utility libraries
│   ├── rpc-manager.ts            # RPC rotation & health checks
│   ├── solana-utils.ts           # Solana helper functions
│   ├── transaction-logger.ts     # Transaction logging utility
│   └── utils.ts                  # General utilities
│
├── public/                       # Static assets
│   ├── logo.svg                  # AXSOL logo
│   └── favicon.svg               # Browser favicon
│
├── package.json                  # Dependencies & scripts
├── tsconfig.json                 # TypeScript configuration
├── next.config.mjs               # Next.js configuration
└── README.md                     # This file

AXSOL uses automatic RPC rotation with health checks to ensure reliable connections.

const RPC_ENDPOINTS = [
  'https://api.mainnet-beta.solana.com',
  'https://solana-mainnet.g.alchemy.com/v2/demo',
  'https://rpc.ankr.com/solana',
  'https://solana.getblock.io/mainnet',
  'https://solana-api.projectserum.com',
];

To use your own RPC endpoint(s), set the environment variable:

NEXT_PUBLIC_CUSTOM_RPC_ENDPOINTS=https://your-premium-rpc.com,https://backup-rpc.com

Permanently destroy NFTs and reclaim the rent SOL.

Usage:

1. Connect your wallet
2. Select NFTs to burn (batch selection supported)
3. Set priority fee (optional)
4. Click "Burn Selected NFTs"
5. Approve transaction in wallet

Technical Details:

• Uses createBurnCheckedInstruction from @solana/spl-token
• Automatically closes token account after burn
• Batch processing: 5 NFTs per transaction

Destroy SPL tokens from your wallet.

Usage:

1. Connect your wallet
2. Select token from dropdown
3. Enter amount to burn
4. Toggle "Close account after burn" (optional)
5. Click "Burn Tokens"

Technical Details:

• Supports both Token Program and Token-2022
• Optional account closure reclaims ~0.002 SOL rent

Reclaim SOL from empty token accounts.

Usage:

1. Connect your wallet
2. Click "Scan for Empty Accounts"
3. Review accounts and reclaimable SOL
4. Click "Close All Empty Accounts"

Technical Details:

• Identifies accounts with 0 balance
• Batch processing: 10 accounts per transaction
• ~0.002 SOL reclaimed per account

Send tokens to multiple addresses in one transaction.

Modes:

• One to Many: Same token to multiple recipients
• Many to One: Multiple tokens to single recipient

Usage:

1. Select mode and token
2. Add recipients (manual or CSV upload)
3. Set amounts for each recipient
4. Click "Send Tokens"

CSV Format:

address,amount
RecipientAddress1,100
RecipientAddress2,50

Launch tokens on pump.fun or bonk.fun via PumpPortal API.

Usage:

1. Select platform (pump.fun or bonk.fun)
2. Upload token image
3. Fill token details (name, symbol, description)
4. Add social links (optional)
5. Set dev buy amount and slippage
6. Click "Create Token"

Technical Details:

• Uploads metadata to IPFS via pump.fun API
• Uses PumpPortal /api/trade-local for transaction building
• User signs with own wallet + generated mint keypair

Upload files to Arweave for permanent storage.

Usage:

1. Select file(s) to upload
2. Add custom tags (optional)
3. Click "Upload to Arweave"
4. Copy transaction ID

Technical Details:

• Uses Irys (Bundlr) network nodes
• Supports multiple file types
• Returns permanent Arweave transaction ID

Edit NFT metadata and attributes.

Usage:

1. Connect wallet and select NFT
2. Edit name, symbol, or URI
3. Modify attributes
4. Click "Update Metadata"

Technical Details:

• Uses Metaplex Token Metadata program
• Requires update authority signature

Send on-chain messages to NFT or domain owners.

Usage:

1. Enter NFT address or .sol domain
2. Compose your message
3. Click "Send Message"

Technical Details:

• Uses Solana memo program
• Message stored permanently on-chain
• Resolves .sol domains via SNS

POST /api/arweave/upload

Upload files to Arweave network.

Request:

// FormData
{
  file: File,           // File to upload
  tags?: string         // JSON stringified tags array
}

Response:

{
  success: boolean,
  id: string,           // Arweave transaction ID
  url: string           // Permanent Arweave URL
}

We welcome contributions from the community.

1. Fork the repository

2. Create a feature branch

git checkout -b feature/your-feature-name

3. Make your changes

4. Run linting

pnpm lint

5. Test locally

pnpm dev

6. Commit with conventional commits

git commit -m "feat: add new feature"
git commit -m "fix: resolve issue with X"
git commit -m "docs: update README"

7. Push and create PR

git push origin feature/your-feature-name

• TypeScript strict mode enabled
• ESLint configuration enforced
• Prettier formatting (2 space indent)
• Conventional commit messages

• Clear description of changes
• Link to related issues
• Screenshots for UI changes
• Test coverage for new features

• No Private Keys: AXSOL never requests or stores private keys
• Client-Side Signing: All transactions signed locally in user's wallet
• Open Source: Full code transparency for audit

If you discover a security vulnerability, please email security@axsol.tools or DM @Axsoltools on X.

Do not open public issues for security vulnerabilities.

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License

Copyright (c) 2024 AXSOL

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.