ptox
A language-neutral SDK for building file-search clients across many networks (clearnet, I2P, Freenet/Hyphanet, IPFS, BitTorrent, …).
It provides the contracts, engines, and tooling a client builds on:
- Contracts —
FileQuery,FileResult,Address,SearchProvider,Fetcher,Capabilities. - Engines —
Engine(search + retrieve),fanout,merge(deduplicate + rank),FetchRegistry. - Bridge — the NDJSON wire format and
SubprocessProvider, so providers can be written in any language.
# async
Retrieval (the fetch feature, on by default) turns a result's Address into
bytes: Engine::fetch(&result, "out.bin").await.
Providers (network plugins) and clients (frontends) are separate software. The contract, JSON Schema, and conformance suite live in the repository: https://github.com/despulii-bit/ptox.
License
Licensed under either of Apache License, Version 2.0 or MIT license at your option.