Fil-Titan Agent

English | 中文

FIL-Titan-Agent is an open-source application for Filecoin Storage Providers (SPs) that securely connects your underutilized bandwidth to the Titan Network, creating a new, subsidy-free revenue stream independent of block rewards.

This repository contains the official source code for the FIL-Titan-Agent. By running this lightweight agent, you can monetize your idle infrastructure, turning underutilized resources into a stable and tangible commercial revenue stream.

Core Features & Benefits

• ✅ Generate Significant Additional Revenue: Monetize your idle bandwidth and earn a stable cash flow independent of any subsidies. Our market-validated pricing is highly competitive:

  • Mainland China: $350 / Gbps / month
  • Key overseas markets (Brazil, Japan, Thailand, Vietnam): $160 / Gbps / month

• ✅ Serve Top-Tier Commercial Clients: Your resources will power professional PCDN (Peer-to-Peer Content Delivery Network) services for premier global content platforms, including TikTok, Tencent, Bilibili, Kuaishou, and iQiyi.

• ✅ Effortless Deployment & Seamless Integration: Get started with a simple deployment of our lightweight agent. It's designed to run in parallel with your existing Lotus/Venus mining operations without interfering with your sealing or storage tasks.

• ✅ On-Chain Value Settlement: All revenue from commercial activities is settled automatically via smart contracts in various currencies, including FIL or USDFC. This ensures that value is circulated and captured directly on the Filecoin blockchain.

• ✅ Secure & Open-Source: The codebase is fully open-source and transparent, allowing you to audit every line of code for security. The agent runs in an isolated environment and does not access any of your sensitive data.

---

How It Works

The diagram below illustrates the complete value loop of the Titan Network. It shows how end-users' payments flow through the system to reward Storage Providers for contributing their bandwidth (Stage 1) and, in the future, hot storage resources (Stage 2).

---

Quick Start

To get started with Fil-Titan Agent, please refer to our running tutorials and installation guides.

Dependencies

• multipass (windows, macos, linux)
• virtualbox (windows)

📖 Detailed Running Tutorials: Multi-Device Type Running Tutorials

1. Preparation

• Download Titan Agent installation package (using linux/amd64 as an example):
  • agent-linux.zip

2. Get Your Identity Key

• Follow this tutorial to get your key:
  • Titan Network Key Acquisition Tutorial

3. Installation and Execution

A. Extract and Prepare

# Create installation directory
mkdir -p /data/.titannet

# Copy the installation package to the target directory
cp /path/to/your/agent-linux.zip /data/.titannet/

# Navigate to the directory and unzip the package
cd /data/.titannet
unzip agent-linux.zip

B. Set Permissions

chmod +x /data/.titannet/agent

C. Start Titan Agent

Replace YOUR_KEY_HERE with the actual key you obtained in Step 2.

nohup /data/.titannet/agent --working-dir=/data/.titannet \
  --server-url=[https://test4-api.titannet.io](https://test4-api.titannet.io) \
  --key=YOUR_KEY_HERE > /dev/null 2>&1 &

D. Verify the Process is Running

ps -ef | grep agent

E. Stop the Agent (If Needed)

# Find the process ID (PID)
ps -ef | grep agent

# Stop the process using its PID
kill <PID>

4. Configure Auto-start on Boot (Using systemd)

This is recommended for production environments to ensure the agent restarts automatically.

A. Create systemd Service File

Remember to replace YOUR_KEY_HERE with your actual key.

sudo tee /etc/systemd/system/titan-agent.service <<EOF
[Unit]
Description=Titan Network Agent
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/data/.titannet
ExecStart=/data/.titannet/agent \\
    --working-dir=/data/.titannet \\
    --server-url=[https://test4-api.titannet.io](https://test4-api.titannet.io) \\
    --key=YOUR_KEY_HERE
Restart=always
RestartSec=30
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=titan-agent

[Install]
WantedBy=multi-user.target
EOF

B. Set Permissions and Enable the Service

sudo chmod 644 /etc/systemd/system/titan-agent.service
sudo systemctl daemon-reload
sudo systemctl enable --now titan-agent

C. Manage the Service

You can now manage the agent using standard systemctl commands:

• Start service: sudo systemctl start titan-agent
• Stop service: sudo systemctl stop titan-agent
• Restart service: sudo systemctl restart titan-agent
• Check status: sudo systemctl status titan-agent
• View logs: sudo journalctl -u titan-agent -f

License

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

MIT License

Copyright (c) 2023 Filecoin Titan

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.