A Fully Native, Dependency‑Free Web5 Case Study

TL;DR:

This case study demonstrates how the Ascoos OS Kernel 1.0.0 performs OAuth2 authentication, event‑driven processing, torrent file creation, and secure P2P upload using raw sockets — all without frameworks, external libraries, or middleware.

🔗 Full source code: https://github.com/ascoos/oauth2-torrent-upload

Introduction

Modern decentralized systems require:

• secure authentication
• event‑driven workflows
• portable file‑sharing mechanisms
• zero‑dependency execution
• native networking

The Ascoos OS Kernel provides all of these capabilities out of the box.

This case study shows how a single PHP file can:

1. Authenticate via OAuth2
2. Validate credentials through a remote API
3. Emit events on success/failure
4. Generate a torrent file dynamically
5. Upload it to a P2P node using raw TCP sockets

Everything is implemented using native kernel handlers, with no external packages.

Kernel Components Used

OAuth2 Authentication

The authentication flow is fully native:

$oauth = new TOAuth2Handler($properties);
$oauth->setEventHandler($eventHandler);

if ($oauth->authenticate(['access_token' => 'xyz123', 'provider' => 'x'])) {
    echo "OAuth authenticated!\n";
    $token = $oauth->generateToken();
}

If authentication fails, the kernel triggers an event:

$eventHandler->register('module', 'auth.oauth.failed',
    fn($creds, $errors) => error_log("OAuth failed: " . json_encode($errors))
);

Event‑Driven Architecture

The kernel supports lightweight event hooks:

$eventHandler->register('module', 'auth.oauth.success',
    fn($creds) => error_log("OAuth success: " . json_encode($creds))
);

This enables:

• logging
• auditing
• monitoring
• custom workflows

without observers, middleware, or frameworks.

Torrent File Creation

Torrent creation is handled natively:

$torrent = new TTorrentFileHandler();
$torrentData = [
    'name' => 'secure_share.torrent',
    'files' => ['data.txt' => 'OAuth protected content']
];

$torrent->createTorrentFile(
    $AOS_TMP_DATA_PATH . '/secure_share.torrent',
    $torrentData
);

The generated torrent includes:

• metadata
• embedded content
• file map

and is ready for decentralized distribution.

Secure P2P Upload (Socket‑Based)

The upload uses raw TCP sockets:

$socket = new TSocketHandler();
$socket->createSocket(AF_INET, SOCK_STREAM, SOL_TCP);
$socket->connectSocket('p2p.example.com', 22);

$socket->sendData(
    "UPLOAD_TORRENT:" . $token . ":" .
    file_get_contents($AOS_TMP_DATA_PATH . '/secure_share.torrent')
);

$response = $socket->receiveData(1024);
echo "Torrent upload response: $response\n";

This approach provides:

• direct node communication
• zero‑dependency networking
• Web5‑ready decentralized sharing

Architecture Overview

[ OAuth2 Client ]
       |
       v
[ TOAuth2Handler ] ---> emits events ---> [ TEventHandler ]
       |
       v
[ Token Generation ]
       |
       v
[ TTorrentFileHandler ] ---> creates torrent
       |
       v
[ TSocketHandler ] ---> uploads to P2P node

What This Case Study Demonstrates

Full Source Code

The complete implementation is available here:

https://github.com/ascoos/oauth2-torrent-upload

If you find it useful, consider starring the repository.