TOS Network Ecosystem Integration Hub

Connect your project with the growing TOS Network ecosystem through our comprehensive integration guides and partner APIs.

🚀 Quick Start Guide

1. Build from Source

Clone and build the TOS Network node software:


# Clone the repository
git clone https://github.com/tos-network/tos.git
cd tos
 
# Build for local platform (recommended for development)
./build_local.sh
 
# Or build manually with cargo
cargo build --release

Supported Platforms:

Linux (x86_64, ARM64, ARMv7)
macOS (Intel x86_64, Apple Silicon arm64)
Windows (x86_64)

2. Configure Environment

Copy and configure your environment:


# Copy environment template
cp .env.example .env

Edit .env with your settings:


# Network selection
TOS_NETWORK=testnet              # mainnet or testnet
 
# Logging
RUST_LOG=info                    # debug/info/warn/error
 
# Daemon configuration
TOS_RPC_BIND_ADDRESS=0.0.0.0:8080
TOS_P2P_BIND_ADDRESS=0.0.0.0:2125
 
# Mining configuration
TOS_MINER_ADDRESS=your_wallet_address_here
TOS_MINER_THREADS=4
 
# Testnet seed nodes
TOS_PRIORITY_NODES=157.7.65.157:2125,157.7.78.65:2125,157.7.192.216:2125

3. Run the Daemon

Start the TOS Network daemon:


# Run with default settings
./build/local/tos_daemon --network testnet
 
# Or with custom configuration
./build/local/tos_daemon \
  --network testnet \
  --dir-path /var/run/tos/data \
  --rpc-bind-address 0.0.0.0:8080 \
  --p2p-bind-address 0.0.0.0:2125 \
  --priority-nodes 157.7.65.157:2125

4. Run with Docker

For containerized deployment:


# Copy environment configuration
cp .env.example .env
 
# Start daemon only
docker-compose up tos-daemon
 
# Start daemon + miner
docker-compose --profile miner up
 
# Start all services (daemon + miner + wallet)
docker-compose --profile miner --profile wallet up

5. Use the Wallet

The TOS wallet supports account management and transactions:


# Run wallet CLI
./build/local/tos_wallet
 
# Example: Transfer TOS
./build/local/tos_wallet transfer \
  --address tos1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq8cczjp \
  --amount 10.5

6. Start Mining

Connect miner to your daemon:


# Set environment variables
export TOS_DAEMON_URL=ws://localhost:8080
export TOS_MINER_ADDRESS=your_wallet_address
export TOS_MINER_THREADS=4
 
# Start mining
./build/local/tos_miner

🛠️ Development Tools

Project Structure


tos/
├── common/     # Shared libraries (crypto, tx, rpc, network)
├── daemon/     # Blockchain node daemon
├── miner/      # Mining software
├── wallet/     # Wallet application
├── genesis/    # Genesis block generator
├── tck/        # Test Compatibility Kit
└── proto/      # Protocol Buffers definitions

RPC Endpoints

The daemon exposes HTTP/JSON-RPC on port 8080:


# Health check
curl http://localhost:8080/health
 
# Example RPC call
curl -X POST http://localhost:8080/rpc \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"get_block_height","params":[],"id":1}'

Testing Framework

TOS includes a comprehensive Test Compatibility Kit (TCK):


# Run all tests
cargo test --workspace
 
# Run specific component tests
cargo test -p tos_daemon
cargo test -p tos_wallet
 
# TCK structure
tck/
├── contracts/   # 58+ test contracts
├── tests/       # 62+ test suites
├── specs/       # Specification tests
├── scenarios/   # Integration scenarios
└── fuzz/        # Fuzz testing

Build Scripts


# Local development build
./build_local.sh
 
# Cross-platform release build (requires `cross`)
cargo install cross
./build_all.sh
 
# Docker image build
./docker-build.sh                              # Build daemon
./docker-build.sh --app tos_miner --tag v1.0.0 # Build miner
./docker-build.sh --all --tag latest           # Build all

📋 Integration Checklist

Pre-Integration

Review partner documentation
Obtain necessary API credentials
Set up development environment
Plan integration architecture
Define testing strategy

Development Phase

Implement core integration logic
Add error handling and retries
Implement authentication/authorization
Add logging and monitoring
Write comprehensive tests

Testing Phase

Unit tests for all functions
Integration tests with partner APIs
Load testing for high-volume scenarios
Security testing and penetration testing
User acceptance testing

Production Deployment

Configure production environment
Set up monitoring and alerting
Implement rate limiting and circuit breakers
Deploy with zero downtime strategy
Monitor initial rollout

Post-Deployment

🤝 Partner Program

Become a TOS Network Partner

Join our growing ecosystem of integration partners:

Apply for Partnership
- Submit integration proposal
- Technical review process
- Partnership agreement
Technical Integration
- Access to partner APIs
- Technical support team
- Integration testing environment
Go-to-Market Support
- Joint marketing opportunities
- Co-branded materials
- Event participation
Ongoing Partnership
- Regular technical reviews
- Feature collaboration
- Revenue sharing opportunities

Partner Benefits

Technical Support: Dedicated integration support team
Marketing Support: Joint promotional opportunities
Priority Access: Early access to new features and APIs
Revenue Sharing: Earn from successful integrations
Ecosystem Growth: Be part of the growing TOS Network

🆘 Support and Resources

Technical Support

Discord: #integration-support
Email: [email protected]
GitHub: Integration Examples
Documentation: docs.tos.network/ecosystem

Partner Resources

Partner Portal: Access exclusive resources and tools
Technical Documentation: Comprehensive API documentation
Sample Code: Ready-to-use integration examples
Best Practices: Proven integration patterns

Community

Developer Forum: Community-driven support
Monthly Calls: Technical discussion sessions
Hackathons: Build and showcase integrations
Conferences: Network with other partners

Ready to integrate? Choose your integration type above and start building with TOS Network’s comprehensive ecosystem!

“Don’t Trust, Verify it” - All integrations are built with transparency and verifiability at their core!