varitykit 1.0.0

AI-powered CLI for building dashboards on Varity L3

VarityKit CLI

AI-powered CLI for building dashboards on Varity L3

VarityKit is an enterprise-grade command-line tool for building, testing, and deploying AI-powered dashboard templates to the Varity L3 blockchain. Inspired by Algorand's AlgoKit, VarityKit enables developers worldwide to create industry-specific dashboards with built-in AI capabilities.

Status: ✅ ALL BLOCKERS RESOLVED - Ready for End-to-End Testing (Jan 24, 2026)

Deployed Smart Contracts (Varity L3 - Chain ID 33529)

Contract	Address	Purpose
TemplateMarketplace	0x769250dac29817081f38CfBa597Ef2485F3a94e8	70/30 Revenue Split
TemplateRegistry	0xEbD8C516c05BD2b76b5CDd56530b3Dd9f8b3D748	Template metadata
VarityAppRegistry	0x52d4f28ebe20fad743bbef9daa61bfe3ce91eb74	App Store submissions
SimplifiedPaymaster	0xeF467aef91d4e626C7e56967779069bEF22c4453	Gas sponsorship
VarityWalletFactory	0x85AB92708CB4d921f5c2BdCCd7f2D0813a380f71	Smart wallets

Revenue Split: 70% → Developer | 30% → Varity Platform

🎉 Enterprise-Grade Blockchain CLI - COMPLETE!

VarityKit v1.0 - State-of-the-art multi-chain developer platform

🚀 What Makes VarityKit Unique

The ONLY blockchain CLI with ALL of these:

• ✅ AI-Powered Code Generation - Natural language to smart contracts
• ✅ Multi-Industry Templates - Finance, Healthcare, Retail, ISO
• ✅ Multi-Chain Native - Deploy to any EVM blockchain
• ✅ Full Local DePin Stack - 9 integrated services
• ✅ Enterprise Features - Matching AlgoKit + Hardhat + Foundry
• ✅ State Management - Snapshot/restore workflow states

📦 What's Included (77+ Commands)

Phase 1 Complete (Weeks 1-6):

• ✅ Local Development Network (localnet) - 8 commands
• ✅ Deployment Automation (deploy) - 4 commands
• ✅ Contract Interaction (contract) - 4 commands
• ✅ Enhanced Doctor - 20-29 comprehensive checks
• ✅ Shell Completions - Bash, zsh, fish
• ✅ Task Utilities - Wallet, storage, dashboard management
• ✅ TestNet Dispenser - Automated funding + faucet guide

Phase 2 Complete (Weeks 7-10):

• ✅ Template Creation (template) - 6 commands
• ✅ AI-Powered Component Generation - Natural language to code
• ✅ Template Marketplace (marketplace) - 6 commands
• ✅ 70/30 Revenue Sharing - Automatic payments via smart contracts

See docs/CLI_THIRDWEB_COMMANDS.md for thirdweb integration details and blockchain command reference.

Features

• AI-Powered Configuration: Intelligent project setup with chain-of-thought reasoning (Vertex AI / Gemini 2.5 Flash)
• Conversational Interface: Natural language Q&A instead of manual coding
• Self-Correction: Automatic code validation and error fixing (max 3 attempts)
• Quality Scoring: 6-dimension quality assessment with >85% threshold
• Industry Templates: Pre-built templates for Finance, Healthcare, Retail, ISO Merchant Services
• DePin Integration: Deploy to decentralized infrastructure (Akash, Filecoin, Celestia)
• Local Development: Full local blockchain environment with hot reload
• Smart Contract Deployment: Automated deployment to Varity L3 (testnet/mainnet)
• RAG Knowledge Management: 50,000+ knowledge documents for intelligent context
• License Management: Built-in revenue sharing and licensing system

Installation

Using pipx (Recommended)

# Standard installation
pipx install varitykit

# With blockchain utilities (wallet, fund commands)
pipx install "varitykit[blockchain]"

# With all optional features
pipx install "varitykit[all]"

Using pip

# Standard installation
pip install varitykit

# With blockchain utilities (wallet, fund commands)
pip install "varitykit[blockchain]"

# With all optional features
pip install "varitykit[all]"

Development Installation

# Clone repository
git clone https://github.com/varity-ai/varitykit-cli.git
cd varitykit-cli

# Install in editable mode with all features
pip install -e ".[all]"

# Install shell completions
varitykit completions --install

Quick Start

1. Check Your Environment

varitykit doctor

This validates that all required tools are installed:

• Docker & Docker Compose
• Node.js & npm
• Python 3.10+
• Git

2. Create a New Project

varitykit init my-finance-dashboard

Follow the interactive prompts to configure your project:

• Select industry template (Finance, Healthcare, Retail, etc.)
• Configure company details
• Choose features and integrations

3. Install Dependencies

cd my-finance-dashboard
varitykit bootstrap

4. Start Development

# Start local DePin network
varitykit localdepin start

# Start development server
varitykit dev

Your dashboard will be available at http://localhost:3000

5. Deploy

# Deploy to testnet
varitykit deploy testnet

# Deploy to mainnet (requires license)
varitykit deploy mainnet

Commands

Core Commands

varitykit doctor ⭐ ENHANCED (Phase 1)

Comprehensive environment diagnostics with 20+ validation checks.

# Quick check (20 checks)
varitykit doctor

# Full diagnostics (29 checks - includes LocalDePin services)
varitykit doctor --full

Check Categories:

• Required Tools (6): Docker, Node.js, Python, Git
• System Resources (2): Disk space, Memory
• Project Configuration (2): .env file, varity.config.json
• Network Connectivity (1): Internet
• API Endpoints (2): Staging, Production
• Port Availability (3): 3000, 3001, 8545
• Blockchain RPC (3): Arbitrum L3, Sepolia, Arbitrum One
• LocalDePin Services (9, --full only): All 9 DePin services

varitykit completions ⭐ NEW (Phase 1)

Setup shell completions for bash, zsh, and fish.

# Auto-detect shell and show instructions
varitykit completions

# Auto-install to shell config
varitykit completions --install

# Generate for specific shell
varitykit completions --shell bash

Enables tab completion for all commands, options, and arguments.

varitykit init [PROJECT_NAME]

Initialize a new Varity dashboard project.

# Interactive mode
varitykit init

# With options
varitykit init my-dashboard --template finance --path ./projects/acme

Options:

• --template, -t: Template to use (finance, healthcare, retail, iso-merchant, generic)
• --path, -p: Path where project should be created
• --yes, -y: Skip confirmation prompts

varitykit bootstrap

Install project dependencies (npm, pip, Docker images).

varitykit bootstrap

# Skip specific steps
varitykit bootstrap --skip-npm --skip-docker

Options:

• --skip-npm: Skip npm install
• --skip-pip: Skip pip install
• --skip-docker: Skip Docker setup

Local Development Network Commands ⭐ NEW (Phase 1)

varitykit localnet

Manage local DePin development network with 9 integrated services.

# Start entire local network (Arbitrum L3 + IPFS + Celestia + more)
varitykit localnet start

# Check status of all services
varitykit localnet status

# View logs (with optional filtering)
varitykit localnet logs
varitykit localnet logs -f                    # Follow logs
varitykit localnet logs -s arbitrum-node      # Specific service

# List pre-funded test accounts
varitykit localnet accounts                    # 10 accounts with 10K-1M ETH each

# Show network information
varitykit localnet info

# State management (save/restore network state)
varitykit localnet snapshot --name my-state
varitykit localnet restore --name my-state

# Stop network (preserves data)
varitykit localnet stop

# Reset to clean state (deletes all data)
varitykit localnet reset

Included Services:

• Arbitrum L3 Node (Chain ID: 421614)
• IPFS/Filecoin storage
• Celestia data availability
• PostgreSQL database
• Redis cache
• Pinata mock service
• Akash compute simulator
• Varity API server
• Block explorer (http://localhost:8080)

Pre-funded Accounts: 10 test accounts with 10,000-1,000,000 ETH each

Unique Features:

• State snapshots (save/restore workflow states)
• Integrated 9-service stack
• One-command startup (~60 seconds)

Deployment Commands ⭐ NEW (Phase 1)

varitykit deploy

Enterprise-grade deployment automation with multi-network support.

# Deploy to local network
varitykit deploy run --network local

# Deploy to testnet with verification
varitykit deploy run --network sepolia --verify

# Interactive deployment wizard
varitykit deploy run --interactive

# Dry run (simulate without deploying)
varitykit deploy run --dry-run --network mainnet

# Check deployment status
varitykit deploy status

# View deployment history
varitykit deploy list

# Rollback to previous deployment
varitykit deploy rollback --network sepolia --steps 1

Features:

• Multi-network deployment (local/sepolia/mainnet)
• Automatic contract verification on Arbiscan
• Deployment state tracking
• Complete deployment history
• Rollback capabilities
• Interactive wizard mode
• Dry-run simulation
• Gas estimation

Networks Supported:

• local - LocalDePin network
• sepolia - Arbitrum Sepolia testnet
• mainnet - Arbitrum One mainnet

varitykit app deploy ⭐ UPDATED (Jan 24, 2026)

Deploy full applications to decentralized infrastructure with one command.

# Deploy static website to IPFS (default)
varitykit app deploy --hosting ipfs

# Deploy dynamic app to Akash (NEW!)
varitykit app deploy --hosting akash

# Deploy with custom resources
varitykit app deploy --hosting akash --cpu 2 --memory 2Gi --storage 5Gi

# Deploy specific directory
varitykit app deploy --path ./my-next-app

# Deploy to specific network
varitykit app deploy --network varity

# Submit to App Store
varitykit app deploy --submit-to-store

# Deploy and submit in one command
varitykit app deploy --hosting akash --submit-to-store

# List all deployments
varitykit app list

# View deployment details
varitykit app info deploy-1737492000

# Check deployment status
varitykit app status --network varity

Hosting Options ✅ COMPLETE:

Option	Use Case	App Store Link
--hosting ipfs	Static websites	"Website" link
--hosting akash	Dynamic apps with compute	"Launch App" link

Features:

• Frontend deployment to IPFS (static)
• Backend deployment to Akash (dynamic) - NEW!
• Automatic project detection (Next.js, React, Vue)
• Build automation
• thirdweb Storage integration
• Auto-submission to Varity App Store
• Cost: ~$0.01/GB/month (70-85% cheaper than AWS)

Supported Frameworks:

• Next.js 13+ (App Router with output: "export")
• React 18+ (Create React App, Vite)
• Vue 3+
• Express.js, Fastify, FastAPI (Phase 2)

See docs/APP_DEPLOY.md for complete documentation, examples, and troubleshooting.

Development Commands

varitykit dev

Start development server with hot reload.

varitykit dev

# Custom ports
varitykit dev --frontend-port 3000 --backend-port 3001

varitykit localdepin

Manage local DePin network (Docker Compose).

# Start services
varitykit localdepin start

# Stop services
varitykit localdepin stop

# Reset to clean state
varitykit localdepin reset

# Show service status
varitykit localdepin status

varitykit test

Run tests.

# Run all tests
varitykit test

# Watch mode
varitykit test --watch

# Coverage report
varitykit test --coverage

Deployment Commands

varitykit deploy

Deploy dashboard to blockchain network.

# Deploy to local network
varitykit deploy localnet

# Deploy to testnet
varitykit deploy testnet

# Deploy to mainnet
varitykit deploy mainnet

Contract Interaction Commands ⭐ NEW (Phase 1)

varitykit contract

Interact with deployed smart contracts.

# Call read-only contract method
varitykit contract call 0x123... balanceOf 0xABC... --network sepolia

# Send state-changing transaction
varitykit contract send 0x123... transfer 0xABC... 1000000 --network sepolia

# Query historical events
varitykit contract events 0x123... --event Transfer --from-block 1000000 --network sepolia

# Watch events in real-time
varitykit contract events 0x123... --event Transfer --watch --network sepolia

# List deployed contracts
varitykit contract list --network sepolia

Features:

• Read-only contract method calls
• State-changing transactions with confirmation
• Event querying and real-time watching
• Automatic ABI loading from deployments
• Multi-network support (local/sepolia/mainnet)
• Transaction signing and receipt handling
• Gas estimation and custom limits

Contract Call Options:

• --network - Target network (local/sepolia/mainnet)
• --abi - Custom ABI file path
• --value - ETH to send with call (in wei)
• --gas-limit - Override gas limit

Contract Send Options:

• --from-address - Sender wallet address
• --private-key - Private key for signing
• --confirm - Skip confirmation prompt
• --gas-limit - Override gas limit
• --value - ETH to send with transaction

Contract Events Options:

• --event - Event name to filter (default: all events)
• --from-block - Start block number
• --to-block - End block number (default: latest)
• --watch - Real-time event watching
• --limit - Maximum events to display

Template Creation Commands ⭐ NEW (Phase 2A)

varitykit template

Create, test, and manage dashboard templates with AI assistance.

# Create new template with AI-powered wizard
varitykit template create

# Create template for specific industry
varitykit template create --industry legal --name legal-dashboard

# Run automated tests
varitykit template test
varitykit template test --coverage           # With coverage report
varitykit template test --watch              # Watch mode

# Preview template in browser
varitykit template preview
varitykit template preview --port 3001       # Custom port

# Validate template quality
varitykit template validate
varitykit template validate --fix            # Auto-fix issues

# List available templates
varitykit template list

# Show template details
varitykit template info finance

Features:

• AI-Powered Generation - Natural language to production code in 10 minutes
• Automated Component Creation - 5-12 React components generated
• TypeScript Support - Full type safety with auto-generated types
• Test Generation - Unit tests + E2E tests (85%+ coverage)
• Quality Validation - 6-dimension quality scoring
• Live Preview - Hot reload development server
• Production Ready - Tailwind CSS, Vite, modern React

Template Creation Flow:

1. Describe industry and features (natural language)
2. AI generates React components automatically
3. Tests created (85%+ coverage)
4. Preview and validate
5. Ready to publish

What You Provide:

• Industry/vertical (e.g., legal, manufacturing, education)
• Main features (natural language description)
• Target company size (small/medium/large)
• Component preferences (optional)

What AI Generates:

• 5-12 React components (TypeScript)
• Dashboard pages with routing
• API integration code
• TypeScript types and interfaces
• Tailwind CSS styling
• Unit tests (85%+ coverage)
• E2E tests (Playwright)
• Documentation (README, API docs)

Time Metrics:

• Template creation: < 10 minutes
• Code you write: ~50 lines (config only)
• Code AI generates: ~2,000 lines

Marketplace Commands ⭐ NEW (Phase 2B)

varitykit marketplace

Publish, discover, and monetize dashboard templates with 70/30 revenue sharing.

# Publish your template to marketplace
varitykit marketplace publish
varitykit marketplace publish --price 299

# Search for templates
varitykit marketplace search legal
varitykit marketplace search --category Finance --max-price 300

# Install template from marketplace
varitykit marketplace install legal-case-management
varitykit marketplace install healthcare-portal --output ./my-project

# View your statistics and earnings
varitykit marketplace stats

# Update published template
varitykit marketplace update --version 1.1.0
varitykit marketplace update --price 349

# Remove from marketplace
varitykit marketplace unpublish my-template

Features:

• 70/30 Revenue Split - You keep 70% of every sale
• Automatic Payments - Via Varity L3 smart contracts
• Template Discovery - Search by category, price, quality
• Quality Assurance - Only 85+ quality score templates
• Transparent Analytics - Track downloads and earnings
• Instant Installation - One-command template purchase

Publishing Requirements:

• Quality score > 85/100
• Test coverage > 85%
• Complete documentation
• Valid template.json
• GitHub repository

Revenue Model:

• You set the price ($99-$999 recommended)
• Smart contract enforces 70/30 split
• Automatic payment on each sale
• No manual invoicing needed
• Transparent transaction history

What Happens on Purchase:

1. Customer pays template price
2. Smart contract splits payment:
   • 70% to template creator
   • 30% to Varity (platform fee)
3. Customer gets instant access
4. You receive payment automatically

Example Earnings:

Template Price: $299
Your Revenue: $209.30 per sale (70%)
Platform Fee: $89.70 (30%)

10 sales = $2,093
50 sales = $10,465
100 sales = $20,930

Data Migration Commands ⭐ NEW

varitykit migrate

Migrate data from AWS S3 or Google Cloud Storage to Varity's decentralized infrastructure with blockchain verification.

# Migrate from AWS S3
varitykit migrate s3 --bucket my-s3-bucket --verify

# Migrate from Google Cloud Storage
varitykit migrate gcs --bucket my-gcs-bucket --project my-project

# Check migration status
varitykit migrate status --job-id mig_abc123xyz

# Verify migration integrity
varitykit migrate verify --job-id mig_abc123xyz

# Blockchain chain verification
varitykit migrate verify-chain --source-chain 1 --wallet 0xYourAddress

# Pre-flight checks
varitykit migrate preflight --source-chain 1 --wallet 0xYourAddress

# Generate migration report
varitykit migrate report --source-chain 1 --format markdown --output report.md

# List supported chains
varitykit migrate chains

Features:

• Multi-Cloud Support - Migrate from AWS S3 or Google Cloud Storage
• Progress Tracking - Real-time progress bars with speed indicators
• Resume Capability - Automatically resume interrupted migrations
• Data Integrity - SHA-256 hash verification for all transfers
• Blockchain Verification - Verify chain connectivity and compatibility
• Contract Compatibility - Check smart contract deployability
• Cost Estimation - Calculate savings vs. traditional cloud storage
• Concurrent Transfers - Configurable concurrency for optimal performance
• Dry Run Mode - Test migration without actual data transfer

Supported Chains:

• Ethereum Mainnet (1)
• Arbitrum One (42161)
• Arbitrum Sepolia (421614)
• Polygon (137)
• Base (8453)
• Optimism (10)
• Varity L3 Testnet (33529) - Default destination

Migration Commands:

• s3 - Migrate from AWS S3 bucket
• gcs - Migrate from Google Cloud Storage bucket
• status - Check migration job status
• verify - Verify migration integrity
• verify-chain - Verify blockchain chain connectivity
• preflight - Run pre-flight checks before migration
• chains - List supported blockchain chains
• report - Generate comprehensive migration report

Prerequisites:

• Install @varity/migrate: npm install -g @varity/migrate
• AWS credentials (for S3 migrations)
• GCP credentials (for GCS migrations)
• Varity API credentials (VARITY_API_KEY)

Utility Commands ⭐ NEW (Phase 1)

varitykit task wallet

Wallet management utilities.

# Create new wallet
varitykit task wallet create --name "Dev Wallet" --save

# Import existing wallet
varitykit task wallet import --name "Imported" --save

# List all wallets
varitykit task wallet list

# Check balance
varitykit task wallet balance --network sepolia
varitykit task wallet balance --address 0x123... --network local

varitykit task storage

IPFS/Filecoin storage utilities.

# Upload file to IPFS
varitykit task storage upload ./myfile.json --pin

# Download from IPFS
varitykit task storage download QmHash123... --output ./downloaded.json

# List pinned files
varitykit task storage list

varitykit task dashboard

Dashboard deployment and management utilities.

# Deploy dashboard
varitykit task dashboard deploy --name "Finance Dashboard" --network testnet

# List deployed dashboards
varitykit task dashboard list

# View dashboard logs
varitykit task dashboard logs <dashboard-id>

varitykit fund ⭐ NEW (Phase 1)

Fund wallet with test ETH from faucets.

# Fund default wallet on Sepolia (guided)
varitykit fund --network sepolia

# Fund specific address
varitykit fund --address 0x123... --network sepolia

# Fund on local network (automated)
varitykit fund --network local --amount 1.0

Supported Faucets:

• Alchemy Sepolia Faucet
• Chainlink Sepolia Faucet
• QuickNode Sepolia Faucet
• Infura Sepolia Faucet

Local network funding is fully automated. Sepolia funding provides guided instructions and browser integration.

Advanced Commands

varitykit configure

Launch AI-powered configuration wizard.

varitykit configure

varitykit knowledge

Manage RAG knowledge base.

# Ingest documents
varitykit knowledge ingest ./docs

# Search knowledge
varitykit knowledge search "compliance requirements"

# Show statistics
varitykit knowledge stats

# Validate quality
varitykit knowledge validate

varitykit license

Manage dashboard licenses.

# Create license
varitykit license create

# Verify license
varitykit license verify <license-id>

# Show status
varitykit license status

varitykit explore

Launch VarityKit Explorer (web UI).

# Local explorer
varitykit explore

# Network-specific
varitykit explore testnet
varitykit explore mainnet

varitykit generate

Generate code from templates.

# Generate React component
varitykit generate component MyComponent

# Generate dashboard page
varitykit generate page Dashboard

# Generate API integration
varitykit generate api MyService

Global Options

All commands support these global options:

• --verbose, -v: Enable verbose output
• --debug: Enable debug output
• --json: Output in JSON format
• --version: Show version
• --help: Show help

Configuration

VarityKit uses .varitykit.toml for project configuration. This file is automatically created when you run varitykit init.

Example Configuration

environment = "development"
project_name = "my-dashboard"
project_path = "/path/to/project"

[api]
staging_url = "https://staging.api.varity.io"
production_url = "https://api.varity.io"
local_url = "http://localhost:3001"
timeout = 30

[network]
localnet_rpc = "http://localhost:8545"
testnet_rpc = "https://sepolia.varity.io"
mainnet_rpc = "https://mainnet.varity.io"

[storage]
filecoin_gateway = "https://api.pinata.cloud"
ipfs_gateway = "https://gateway.pinata.cloud"

[logging]
level = "INFO"
json_format = false

Environment Variables

• VARITY_API_KEY: API key for Varity services
• VARITY_WALLET_ADDRESS: Your Ethereum wallet address
• VARITY_ENV: Environment (development, staging, production)
• VARITY_CONFIG_DIR: Custom config directory

Templates

VarityKit includes official templates for different industries:

Finance Template

• Fraud detection
• AML monitoring
• Transaction analytics
• Compliance reporting

Healthcare Template

• Patient management
• Appointment scheduling
• EHR integration
• HIPAA compliance

Retail Template

• Inventory management
• Sales analytics
• Customer insights
• Supply chain tracking

ISO Merchant Template

• Merchant onboarding
• Payment processing
• Residuals tracking
• PCI compliance

Generic Template

• Data visualization
• Reporting
• User management

Development

Setup Development Environment

# Clone repository
git clone https://github.com/varity-ai/varitykit-cli.git
cd varitykit-cli

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install in editable mode
pip install -e ".[dev]"

# Run tests
pytest

# Run linting
black .
ruff check .
mypy varitykit

Project Structure

varitykit-cli/
├── varitykit/
│   ├── cli/
│   │   ├── __init__.py
│   │   ├── main.py          # CLI entrypoint
│   │   ├── doctor.py        # doctor command
│   │   ├── init.py          # init command
│   │   ├── bootstrap.py     # bootstrap command
│   │   └── ...              # other commands
│   ├── core/
│   │   ├── __init__.py
│   │   ├── config.py        # Configuration management
│   │   └── templates.py     # Template management
│   ├── utils/
│   │   ├── __init__.py
│   │   ├── logger.py        # Logging utilities
│   │   └── validators.py    # Validation utilities
│   └── __init__.py
├── tests/
│   ├── unit/
│   ├── integration/
│   └── e2e/
├── docs/
├── examples/
├── pyproject.toml
├── README.md
└── LICENSE

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

MIT License - see LICENSE file for details.

Support

• Documentation: https://docs.varity.ai/varitykit
• GitHub Issues: https://github.com/varity-ai/varitykit-cli/issues
• Discord: https://discord.gg/varity
• Email: [e-mail]

Related Projects

• @varity/ui-kit - React component library
• @varity/core-backend - Backend services
• varity-api-server - API gateway

Acknowledgments

Inspired by AlgoKit from the Algorand Foundation.

---

Built with ❤️ by the Varity team