Frequently Asked Questions
Find quick answers to the most common questions about TOS Network. Can’t find what you’re looking for? Join our Discord community for real-time support.
🌐 General Questions
What is TOS Network?
TOS Network is a next-generation blockchain that combines traditional Proof-of-Work mining with AI-Mining, creating a unique ecosystem where computational power contributes to both network security and artificial intelligence advancement.
Key Features:
- Hybrid Mining: Traditional PoW + AI-Mining
- BlockDAG Architecture: Enhanced scalability and parallelization
- Smart Contracts: Java-based contracts running on RVM (Rust Virtual Machine)
- Privacy Features: Ring signatures and confidential transactions
- Cross-chain Bridges: Multi-chain interoperability
How is TOS Network different from other blockchains?
Unique Advantages:
- Dual-purpose Mining: Computational power serves blockchain security AND AI research
- Energy Efficiency: AI-Mining utilizes otherwise “wasted” computational cycles
- Real-world Value: AI tasks have practical applications beyond just mining
- Developer-friendly: Java smart contracts with familiar syntax
What is the TOS token used for?
Primary Uses:
- Transaction Fees: Pay for network transactions
- Smart Contract Execution: Gas fees for contract operations
- AI-Mining Rewards: Earnings from AI task completion
- Staking: Governance participation and validation
- Cross-chain Transfers: Bridge fees for multi-chain operations
Tokenomics:
- Total Supply: 21,000,000 TOS (same as Bitcoin)
- Current Circulation: ~8,945,123 TOS
- Block Reward: 50 TOS (halving every 210,000 blocks)
- AI-Mining Bonus: Up to 30% additional rewards
Is TOS Network environmentally friendly?
Yes, significantly more than traditional PoW blockchains:
// Energy efficiency comparison
const energyComparison = {
bitcoin: {
energyPerTransaction: "700 kWh",
utilization: "Single-purpose mining",
wasteHeat: "100% wasted"
},
tosNetwork: {
energyPerTransaction: "0.15 kWh",
utilization: "Mining + AI research",
wasteHeat: "Minimal (efficient algorithms)"
}
};
Environmental Benefits:
- 4,600x more energy efficient per transaction than Bitcoin
- Dual-purpose computation reduces overall energy waste
- AI-Mining optimization continuously improves efficiency
- Renewable energy incentives for AI-Mining participants
🤖 AI-Mining Questions
What is AI-Mining and how does it work?
AI-Mining is TOS Network’s innovative consensus mechanism where miners contribute computational power to solve real-world AI tasks while simultaneously securing the blockchain.
How it Works:
- Task Assignment: Network assigns AI tasks (image recognition, NLP, etc.)
- Computation: Miners process tasks using CPU/GPU resources
- Quality Scoring: Solutions evaluated for accuracy and efficiency
- Rewards: High-quality solutions earn TOS tokens
- Network Security: Mining also validates blockchain transactions
What types of AI tasks are available?
Current Task Categories:
Task Type | Difficulty | Reward Multiplier | Hardware Needs |
---|---|---|---|
Image Classification | Medium | 1.0x | GPU recommended |
Natural Language Processing | High | 1.2x | GPU + RAM |
Time Series Prediction | Medium | 1.1x | CPU sufficient |
Computer Vision | High | 1.3x | High-end GPU |
Speech Recognition | Medium | 1.0x | GPU recommended |
Anomaly Detection | Low | 0.9x | CPU sufficient |
Example Task:
# Image classification task example
task = {
'type': 'image_classification',
'dataset': 'medical_xrays',
'classes': ['normal', 'pneumonia', 'covid19'],
'images': 1000,
'target_accuracy': 0.92,
'reward': 15.5, # TOS tokens
'deadline': '2024-10-25T12:00:00Z'
}
What hardware do I need for AI-Mining?
Minimum Requirements:
- CPU: 4 cores, 2.5GHz+
- RAM: 8GB
- Storage: 50GB SSD
- GPU: GTX 1060 or equivalent (recommended)
- Internet: Stable broadband connection
Recommended Setups:
budget_setup:
cpu: "AMD Ryzen 5 5600X"
ram: "16GB DDR4"
gpu: "RTX 3060"
estimated_daily_earnings: "3-5 TOS"
performance_setup:
cpu: "AMD Ryzen 9 7900X"
ram: "32GB DDR5"
gpu: "RTX 4080"
estimated_daily_earnings: "12-18 TOS"
professional_setup:
cpu: "AMD Threadripper PRO"
ram: "128GB DDR4"
gpu: "RTX 4090 x2"
estimated_daily_earnings: "35-50 TOS"
How much can I earn with AI-Mining?
Earnings depend on:
- Hardware performance
- Quality score consistency
- Task selection strategy
- Network participation level
- Energy costs
Example Calculations:
// Daily earnings estimation
function estimateEarnings(hashRate, qualityScore, powerCost) {
const baseReward = hashRate * 0.0001; // Base mining
const aiBonus = baseReward * (qualityScore / 10) * 0.3; // AI bonus
const grossEarnings = baseReward + aiBonus;
const energyCost = powerCost * 24; // Daily energy cost
return grossEarnings - energyCost;
}
// Example: RTX 3080 setup
const dailyEarnings = estimateEarnings(
120, // TH/s equivalent
8.5, // Quality score
0.15 // $0.15/kWh
);
// Result: ~8-12 TOS per day
How is AI task quality measured?
Quality Scoring Algorithm:
pub fn calculate_quality_score(
accuracy: f64, // 0.0 to 1.0
efficiency: f64, // Speed factor
innovation: f64, // Algorithm novelty
consistency: f64 // Historical performance
) -> f64 {
let weights = [0.4, 0.25, 0.2, 0.15];
let scores = [accuracy, efficiency, innovation, consistency];
weights.iter()
.zip(scores.iter())
.map(|(w, s)| w * s)
.sum::<f64>()
.min(10.0)
}
Scoring Factors:
- Accuracy (40%): Correctness of AI solution
- Efficiency (25%): Speed and resource optimization
- Innovation (20%): Novel approaches and improvements
- Consistency (15%): Historical performance track record
🔗 Smart Contracts & Development
What programming language is used for smart contracts?
TOS Network uses Java for smart contract development, running on our custom RVM (Rust Virtual Machine).
Why Java?:
- Familiar Syntax: Most developers know Java
- Rich Ecosystem: Existing libraries and tools
- Enterprise-Ready: Battle-tested in production environments
- Type Safety: Compile-time error detection
- Performance: Optimized execution on RVM
Example Contract:
import tos.contract.Contract;
import tos.contract.annotations.*;
public class TokenContract extends Contract {
private Map<Address, BigInteger> balances;
private BigInteger totalSupply;
@Constructor
public TokenContract(BigInteger initialSupply) {
balances = new HashMap<>();
totalSupply = initialSupply;
balances.put(getCaller(), initialSupply);
}
@View
public BigInteger balanceOf(Address account) {
return balances.getOrDefault(account, BigInteger.ZERO);
}
@External
public boolean transfer(Address to, BigInteger amount) {
Address from = getCaller();
require(balanceOf(from).compareTo(amount) >= 0, "Insufficient balance");
balances.put(from, balances.get(from).subtract(amount));
balances.put(to, balances.getOrDefault(to, BigInteger.ZERO).add(amount));
emit(new TransferEvent(from, to, amount));
return true;
}
}
How do I deploy a smart contract?
Step-by-Step Deployment:
- Write Contract:
// MyContract.java
public class MyContract extends Contract {
// Contract implementation
}
- Compile Contract:
# Using TOS CLI
tos-cli compile MyContract.java
# Output: MyContract.class (bytecode)
- Deploy to Network:
# Deploy to testnet
tos-cli deploy MyContract.class \
--network testnet \
--constructor-args "1000000" \
--gas-limit 1000000
# Deploy to mainnet
tos-cli deploy MyContract.class \
--network mainnet \
--constructor-args "1000000" \
--gas-limit 1000000
- Verify Deployment:
// Using SDK
const contract = await tos.contracts.at(contractAddress);
const result = await contract.methods.myMethod().call();
console.log('Contract deployed successfully:', result);
What are the gas fees for smart contracts?
Gas Pricing Model:
pub struct GasPrices {
pub base_fee: u64, // 21,000 gas
pub contract_creation: u64, // 32,000 gas
pub contract_call: u64, // 21,000 + execution
pub storage_write: u64, // 20,000 gas per 32 bytes
pub storage_read: u64, // 800 gas per read
}
impl Default for GasPrices {
fn default() -> Self {
Self {
base_fee: 21000,
contract_creation: 32000,
contract_call: 21000,
storage_write: 20000,
storage_read: 800,
}
}
}
Typical Costs (1 TOS = $0.50):
- Simple Transfer: ~0.001 TOS ($0.0005)
- Token Transfer: ~0.003 TOS ($0.0015)
- Contract Deployment: ~0.05-0.2 TOS ($0.025-0.10)
- Complex DeFi Operation: ~0.01-0.05 TOS ($0.005-0.025)
How do I interact with deployed contracts?
Using JavaScript SDK:
import { TOSNetwork } from '@tos-network/sdk';
const tos = new TOSNetwork('https://rpc.tos.network');
// Connect to deployed contract
const contract = tos.contract({
address: '0x742d35Cc6634C0532925a3b8D09...0b1e3e0',
abi: contractABI
});
// Read from contract (free)
const balance = await contract.methods.balanceOf(userAddress).call();
// Write to contract (requires gas)
const txHash = await contract.methods.transfer(
recipientAddress,
amount
).send({
from: userAddress,
gas: 100000
});
Using Python SDK:
from tos_network import TOSNetwork
tos = TOSNetwork('https://rpc.tos.network')
# Load contract
contract = tos.contract(
address='0x742d35Cc6634C0532925a3b8D09...0b1e3e0',
abi=contract_abi
)
# Call contract method
balance = contract.functions.balanceOf(user_address).call()
# Send transaction
tx_hash = contract.functions.transfer(
recipient_address,
amount
).transact({'from': user_address, 'gas': 100000})
🌉 Integration & APIs
What APIs are available for developers?
API Endpoints:
API Type | Purpose | Endpoint | Documentation |
---|---|---|---|
Daemon API | Node operations | /v1/daemon | Docs |
Wallet API | Wallet management | /v1/wallet | Docs |
Index API | Blockchain data | /v1/index | Docs |
Mini API | Mobile/IoT | /v1/mini | Docs |
AI-Mining API | Mining operations | /v1/ai-mining | Docs |
Example API Usage:
// Get network status
const response = await fetch('https://api.tos.network/v1/daemon/status');
const status = await response.json();
console.log(`Block height: ${status.block_height}`);
console.log(`Network hashrate: ${status.hashrate}`);
How do I integrate TOS Network with my application?
Quick Integration Steps:
- Install SDK:
npm install @tos-network/sdk
# or
pip install tos-network-sdk
- Initialize Connection:
import { TOSNetwork } from '@tos-network/sdk';
const tos = new TOSNetwork({
rpcUrl: 'https://rpc.tos.network',
networkId: 1, // Mainnet
apiKey: 'your-api-key' // Optional for rate limiting
});
- Basic Operations:
// Check balance
const balance = await tos.wallet.getBalance(userAddress);
// Send transaction
const txHash = await tos.wallet.sendTransaction({
to: recipientAddress,
amount: '10.5',
from: userAddress,
privateKey: userPrivateKey
});
// Monitor transaction
const receipt = await tos.waitForTransaction(txHash);
What wallets support TOS Network?
Supported Wallets:
Wallet | Type | Platforms | Features |
---|---|---|---|
TOS Wallet | Official | Web, Mobile, Desktop | Full features |
MetaMask | Browser | Web extension | Basic support |
Trust Wallet | Mobile | iOS, Android | Mobile-optimized |
Ledger | Hardware | Hardware device | Cold storage |
WalletConnect | Protocol | Various apps | Multi-wallet support |
Integration Examples:
// MetaMask integration
if (window.ethereum) {
await window.ethereum.request({
method: 'wallet_addEthereumChain',
params: [{
chainId: '0x1', // TOS Network chain ID
chainName: 'TOS Network',
rpcUrls: ['https://rpc.tos.network'],
nativeCurrency: {
name: 'TOS',
symbol: 'TOS',
decimals: 18
}
}]
});
}
// WalletConnect integration
import WalletConnect from '@walletconnect/client';
const connector = new WalletConnect({
bridge: 'https://bridge.walletconnect.org',
qrcodeModal: QRCodeModal,
});
if (!connector.connected) {
connector.createSession();
}
🔧 Technical Issues
My transaction is stuck/pending. What should I do?
Common Causes & Solutions:
- Low Gas Price:
// Check recommended gas price
const gasPrice = await tos.getGasPrice();
// Resubmit with higher gas price
const newTxHash = await tos.wallet.sendTransaction({
...originalTx,
gasPrice: gasPrice * 1.2 // 20% higher
});
- Network Congestion:
# Check network status
curl https://api.tos.network/v1/daemon/status
# Look for:
# - High mempool size
# - Slow block times
# - Network congestion indicators
- Nonce Issues:
// Get current nonce
const nonce = await tos.getTransactionCount(userAddress);
// Reset transaction with correct nonce
const txHash = await tos.wallet.sendTransaction({
...originalTx,
nonce: nonce
});
Why is my AI-Mining not working?
Troubleshooting Checklist:
- Check Hardware Requirements:
# GPU status
nvidia-smi
# CPU info
lscpu | grep "Model name"
# Memory usage
free -h
- Verify Network Connection:
# Test RPC connection
curl -X POST https://rpc.tos.network \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"tos_blockNumber","params":[],"id":1}'
- Check Mining Configuration:
# ~/.tos/miner.toml
[ai_mining]
enabled = true
gpu_enabled = true
max_memory_usage = 0.8
worker_threads = 8
[network]
rpc_url = "https://rpc.tos.network"
worker_address = "your_wallet_address"
- Monitor Logs:
# Check miner logs
tail -f ~/.tos/logs/miner.log
# Look for common issues:
# - CUDA initialization errors
# - Network connectivity issues
# - Task downloading failures
# - Quality score problems
How do I troubleshoot smart contract deployment failures?
Common Issues:
- Compilation Errors:
// Common fix: Import missing dependencies
import tos.contract.Contract;
import tos.contract.annotations.*;
import java.math.BigInteger;
// Ensure proper inheritance
public class MyContract extends Contract {
// Implementation
}
- Gas Estimation Problems:
// Manual gas estimation
const gasEstimate = await contract.methods.myMethod().estimateGas();
const gasLimit = Math.floor(gasEstimate * 1.2); // 20% buffer
const txHash = await contract.methods.myMethod().send({
from: userAddress,
gas: gasLimit
});
- Constructor Parameter Issues:
# Correct parameter encoding
tos-cli deploy MyContract.class \
--constructor-args "1000000,\"TokenName\",\"TKN\"" \
--gas-limit 2000000
Why are my transactions failing with “out of gas” errors?
Gas Optimization Strategies:
- Optimize Contract Code:
// Before: Inefficient loop
for (int i = 0; i < users.length; i++) {
if (users[i].isActive()) {
processUser(users[i]);
}
}
// After: Optimized with early exit
for (User user : users) {
if (!user.isActive()) continue;
processUser(user);
if (processedCount >= maxProcessing) break;
}
- Use Gas Estimation:
// Estimate gas before sending
const gasEstimate = await contract.methods.complexOperation().estimateGas({
from: userAddress
});
// Add 20% buffer for safety
const gasLimit = Math.floor(gasEstimate * 1.2);
- Batch Operations:
// Instead of multiple transactions
public void batchTransfer(Address[] recipients, BigInteger[] amounts) {
require(recipients.length == amounts.length, "Array length mismatch");
for (int i = 0; i < recipients.length; i++) {
transfer(recipients[i], amounts[i]);
}
}
💰 Economics & Trading
Where can I buy/sell TOS tokens?
Supported Exchanges:
Exchange | Type | Trading Pairs | Features |
---|---|---|---|
Binance | CEX | TOS/USDT, TOS/BTC | High liquidity |
Coinbase | CEX | TOS/USD | Fiat gateway |
KuCoin | CEX | TOS/USDT | Advanced trading |
TOSSwap | DEX | TOS/ETH, TOS/USDC | Native DEX |
Uniswap V3 | DEX | TOS/ETH | DeFi ecosystem |
Trading Examples:
// TOSSwap (native DEX)
const quote = await tosSwap.getQuote({
tokenIn: 'USDT',
tokenOut: 'TOS',
amountIn: '1000'
});
const swapTx = await tosSwap.swap({
tokenIn: 'USDT',
tokenOut: 'TOS',
amountIn: '1000',
amountOutMin: quote.amountOutMin,
slippage: 0.5 // 0.5%
});
What is the current market cap and price?
Live Market Data (Example):
const marketData = {
price: '$0.52',
marketCap: '$4.65M',
volume24h: '$1.2M',
circulatingSupply: '8,945,123 TOS',
maxSupply: '21,000,000 TOS',
rank: 387,
priceChange24h: '+12.4%'
};
Where to Track:
How do staking and governance work?
Staking Process:
// Stake TOS for governance participation
const stakeTx = await tos.governance.stake({
amount: '1000', // TOS tokens
duration: 90, // days
delegate: null // or delegate address
});
// Voting power calculation
const votingPower = await tos.governance.getVotingPower(userAddress);
// Returns: { power: 1500, multiplier: 1.5, duration: 90 }
Governance Participation:
// Vote on proposal
const voteTx = await tos.governance.vote({
proposalId: 'TIP-2024-001',
choice: 'yes', // 'yes', 'no', 'abstain'
reason: 'This improves network efficiency'
});
// Create proposal (requires minimum stake)
const proposalTx = await tos.governance.createProposal({
title: 'Increase Block Size Limit',
description: 'Proposal to increase block size from 2MB to 4MB',
type: 'parameter_change',
changes: { maxBlockSize: '4MB' }
});
🛡️ Security & Privacy
How secure is TOS Network?
Security Features:
- Proven Cryptography: ECDSA signatures, SHA-256 hashing
- Distributed Consensus: Thousands of mining nodes
- Regular Audits: Quarterly security assessments
- Bug Bounty Program: Up to $50,000 rewards
- Open Source: Fully auditable codebase
Security Metrics:
const securityStats = {
activeNodes: 15420,
hashRate: '125.5 PH/s',
uptimePercentage: 99.97,
securityBudget: '$2.3M/year',
lastSecurityIncident: 'None reported',
auditScore: '96.8/100'
};
What privacy features are available?
Privacy Options:
- Confidential Transactions:
// Send private transaction
const privateTx = await tos.privacy.sendConfidential({
to: recipientAddress,
amount: '10.5',
memo: 'encrypted memo',
privacyLevel: 'high'
});
- Ring Signatures:
// Ring signature implementation
pub struct RingTransaction {
pub inputs: Vec<RingInput>,
pub outputs: Vec<Output>,
pub ring_signature: RingSignature,
pub key_image: KeyImage,
}
- Stealth Addresses:
// Generate stealth address
const stealthAddr = await tos.privacy.generateStealthAddress(
publicViewKey,
publicSpendKey
);
How do I keep my wallet secure?
Security Best Practices:
- Use Hardware Wallets:
// Ledger integration example
import TransportWebUSB from '@ledgerhq/hw-transport-webusb';
import { TOSLedgerApp } from '@tos-network/ledger';
const transport = await TransportWebUSB.create();
const ledger = new TOSLedgerApp(transport);
// Sign transaction with Ledger
const signature = await ledger.signTransaction(transaction);
- Multi-Signature Setup:
// Create 2-of-3 multisig wallet
const multisig = await tos.wallet.createMultiSig({
owners: [owner1, owner2, owner3],
threshold: 2,
timelock: 86400 // 24 hours
});
- Regular Backups:
# Backup wallet securely
tos-cli wallet backup \
--output encrypted_backup.json \
--password secure_password
# Store backup in multiple secure locations
# Never store password with backup file
📱 Mobile & Ecosystem
Is there a mobile wallet app?
TOS Mobile Wallet:
- iOS: Available on App Store
- Android: Available on Google Play
- Features: Full wallet functionality, AI-Mining monitoring, DeFi access
Mobile SDK Integration:
// iOS Swift example
import TOSNetworkSDK
let wallet = TOSWallet()
let balance = try await wallet.getBalance(address: userAddress)
print("Balance: \(balance) TOS")
// Android Kotlin example
import network.tos.sdk.*
val wallet = TOSWallet()
val balance = wallet.getBalance(userAddress)
println("Balance: $balance TOS")
What DeFi protocols are available?
Native DeFi Ecosystem:
Protocol | Type | TVL | Features |
---|---|---|---|
TOSSwap | DEX | $45M | AMM, Liquidity Mining |
TOSLend | Lending | $23M | Borrowing, Lending |
TOSFarm | Yield Farming | $18M | LP staking, Rewards |
TOSBridge | Cross-chain | $12M | Multi-chain assets |
DeFi Integration Example:
// Provide liquidity to TOSSwap
const liquidityTx = await tosSwap.addLiquidity({
tokenA: 'TOS',
tokenB: 'USDT',
amountA: '1000',
amountB: '500',
slippage: 0.5
});
// Start yield farming
const farmTx = await tosFarm.stake({
poolId: 'TOS-USDT-LP',
amount: lpTokenBalance,
lockPeriod: 30 // days
});
How can I contribute to the ecosystem?
Contribution Opportunities:
-
Development:
- Core protocol contributions
- DeFi protocol development
- Mobile app improvements
- Developer tooling
-
Community:
- Documentation translation
- Tutorial creation
- Community management
- Educational content
-
Business Development:
- Exchange listings
- Partnership development
- Enterprise integrations
- Marketing initiatives
Getting Started:
# Join contributor onboarding
git clone https://github.com/tos-network/contributors
cd contributors
./onboarding-script.sh
# or join Discord
# discord.gg/tos-network #contributors-welcome
🆘 Still Need Help?
Quick Support Options:
- 💬 Discord: #general-help - Real-time community support
- 📧 Email: [email protected] - Technical support
- 📖 Documentation: docs.tos.network - Comprehensive guides
- 🐛 GitHub Issues: Report bugs - Bug reports
Response Times:
- Discord: Usually < 1 hour during business hours
- Email: < 24 hours for standard issues
- Critical issues: < 4 hours guaranteed
“Don’t Trust, Verify it” - All information in this FAQ is backed by verifiable code examples and can be independently verified on the TOS Network!