OasisWaker is a CLI tool that lets you contribute your cloud platform's free-tier quota (Cloudflare Workers, Vercel Edge, Supabase Edge) into a shared decentralized storage network.
Current status (v1.0): A working CLI tool with centralized coordination.
Next goal (v2.0): A true P2P mesh network where nodes discover each other without a central server.
"Your free-tier cloud quota, aggregated into infrastructure that no single company controls."
A Node.js CLI tool (@oasisbio/oasiswaker) that:
- Generates a unique node identity (
oasiswaker init) - Connects your Cloudflare/Vercel/Supabase account via OAuth2.0 PKCE (
oasiswaker login) - Deploys an edge Worker to your account that exposes a unified block storage API (
oasiswaker deploy) - Reports node health/metrics to a central coordinator (
oasiswaker status) - Securely stores credentials with AES-256-GCM encryption
$ oasiswaker init
$ oasiswaker login --cloudflare
$ oasiswaker deploy --platform cloudflare
✓ Deployed. Your node is live at: https://oasis-<nodeId>.workers.dev
Limitations (known, documented in CRITIQUE.md):
- Centralized coordination (OasisBio server is the single point of failure)
- Hardcoded secrets in Worker template (being fixed in Phase 0)
- No P2P node discovery yet (planned for v2.0)
- Test coverage is low
We are working toward a true decentralized mesh:
Browser
│
▼
DHT (Kademlia) ← peer discovery
│
├── Cloudflare Worker → R2 Storage
├── Vercel Edge → Blob Storage
└── Supabase Edge → Storage Bucket
Key goals:
- P2P node discovery via DHT (no central directory)
- Erasure coding — data survives node failures
- Client-side encryption — node operators cannot read stored data
- Incentive layer — contribute resources, earn credits
This is the VISION.md. It is not built yet. See PLAN.md for the roadmap.
# Clone the repo
git clone https://github.com/Oasis-Company/OasisWaker.git
cd OasisWaker
# Install dependencies
npm install
# Build
npm run build
# Run CLI
node dist/cli/index.js --helpNote: You need Cloudflare/Vercel/Supabase API tokens to test deployment. See RESOURCES.md for setup.
| Document | Description |
|---|---|
| VISION.md | Ideal state — what we're building toward |
| PLAN.md | Phased roadmap with checklists and pitfalls |
| CRITIQUE.md | Known security issues and technical debt |
| DOCUMENTATION.md | Full documentation index |
| RESOURCES.md | Cloud platform setup checklist |
| PROJECT_STATUS.md | Current development status |
| NEW_ARCHITECTURE.md | v2.0 architecture proposal (not implemented) |
oasiswaker/
├── src/
│ ├── cli/ # CLI commands (commander.js)
│ ├── auth/ # OAuth2.0 PKCE flow
│ ├── crypto/ # AES-256-GCM encryption
│ ├── deploy/ # Platform adapters (Cloudflare/Vercel/Supabase)
│ └── utils/ # Shared utilities
├── tests/
├── .github/workflows/ # CI (multi-OS, multi-Node matrix)
├── PLAN.md # Roadmap
├── VISION.md # Ideal state
└── CRITIQUE.md # Known issues
Note: The
packages/monorepo structure described in older docs is planned for v2.0, not yet implemented.
We welcome contributions! See:
- CONTRIBUTING.md — How to contribute
- CODE_OF_CONDUCT.md — Community guidelines
- CRITIQUE.md — Known issues (great starting points for contributors)
git clone https://github.com/Oasis-Company/OasisWaker.git
cd OasisWaker
npm install
npm run build
npm test- 🐛 GitHub Issues — Report bugs
- 💬 GitHub Discussions — Ask questions
Built with ❤️ by the OasisBio Team
Your free-tier cloud quota, aggregated.