cocoon-proxy-api

An OpenAI-compatible API proxy for the Cocoon decentralized AI network on TON blockchain. Provides a familiar REST API interface with built-in billing, API key management, and automatic TON deposit detection.

Users get an API key, deposit TON to your wallet with a memo code, and make standard OpenAI-format API calls. No need to compile C++ clients or deploy smart contracts.

• OpenAI-compatible API -- drop-in replacement for any OpenAI client library
• Streaming support -- full SSE streaming for chat completions
• Prepaid billing -- per-request cost tracking with configurable pricing
• TON payments -- automatic deposit detection via tonapi.io
• Privacy first -- no prompt or response content is ever logged or stored
• API key auth -- secure key generation with SHA-256 hashed storage

• Python 3.11+
• A running Cocoon client at localhost:10000
• A TON wallet address for receiving deposits
• (Optional) A tonapi.io API key for faster deposit detection

git clone https://github.com/knyazev741/cocoon-api-proxy.git
cd cocoon-api-proxy
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Copy the example environment file and fill in your values:

cp .env.example .env

Required settings:

• COCOON_DEPOSIT_WALLET -- your TON wallet address for receiving user deposits

See .env.example for all available options.

python -m app.main

The server starts on http://0.0.0.0:8000 by default.

For production, use a reverse proxy (Caddy, nginx) for HTTPS.

curl -X POST http://localhost:8000/v1/keys

Returns an API key (ck_...) and a unique deposit code. The API key is shown once -- save it.

If COCOON_ADMIN_TOKEN is set, include it as `Authoriza