Документация Zcan
Документация
Как работает Zcan.
Zcan — некастодиальный интерфейс: обмены и приватные отправки исполняются маркет-мейкерами NEAR Intents, инструменты приватности работают на вашем устройстве, а агенты выполняют только одобренные вами шаги. Все графики на этой странице живые.
01 · Как это работает
Вы отправляете средства на одноразовый адрес депозита. Солверы соревнуются в аукционе за исполнение обмена, и победитель платит напрямую на ваш адрес. Если гарантированный минимум недостижим, депозит возвращается.
02 · Жизненный цикл ордера
Каждый ордер проходит через эти состояния, о которых сообщает API статусов 1Click. Страница ордера опрашивает его каждые 5 секунд; приложение обновляет остальные открытые ордера каждые 10 секунд.
Автопоказ · нажмите на состояние
PENDING_DEPOSIT
Ордер создан, и его адрес депозита ждёт ваших средств. Пока ничего не перемещалось.
03 · Котировки и проскальзывание
У котировки есть ожидаемый результат и гарантированный минимум. Разница между ними — допустимое проскальзывание. Двигайте ползунок, чтобы увидеть компромисс на живых ценах.
По умолчанию Zcan запрашивает 1,0%.
- Текущий курс
- —
- Ожидается
- 0 ZEC
- Гарант. минимум
- 0 ZEC
- Худший случай
- −$0.00
04 · Сети
Zcan поддерживает всё, что поддерживает NEAR Intents, — с ZEC на одной из сторон. Этот график читает живой список активов.
05 · Приватная отправка
Разделите сумму между 10 получателями. У каждого получателя свой ордер, и платит ему маркет-мейкер — никогда не ваш кошелёк, — а вы отправляете каждый депозит в запланированное время, чтобы переводы нельзя было связать по времени.
- Без хранения средствКаждая часть — независимый ордер 1Click. Zcan ничего не объединяет и не хранит.
- Несвязанные выплатыПолучатели видят адрес солвера, а не ваш. Неравные доли и задержки мешают сопоставить части.
- ОграниченияАдреса депозитов прозрачные. Для максимальной приватности отправляйте с экранированного баланса Zcash. Задержки должны укладываться в дедлайн каждого ордера (несколько часов).
06 · Живые данные
Цены поступают по WebSocket. Котировки и выплаты всегда приходят от NEAR Intents; потоковые цены нужны для отображения и оценок.
Подключение к рыночному потоку…
ZEC/USD
—
—
BTC/USD
—
—
ETH/USD
—
—
SOL/USD
—
—
XRP/USD
—
—
DOGE/USD
—
—
| Данные | Источник | Обновление |
|---|---|---|
| Цены в USD (27 активов) | Coinbase WebSocket | В реальном времени · пакеты 4/с |
| Список токенов и резервные цены | NEAR Intents /v0/tokens | Каждые 30 с |
| История ZEC за 24 ч | CoinGecko | Каждые 5 мин + живые тики |
| Котировки обмена | Пробные котировки 1Click | Каждые 15 с |
| Статус ордера | 1Click /v0/status | 5 с (страница ордера) · 10 с (в фоне) |
07 · Модель приватности
Что покидает ваше устройство и куда уходит — для каждой функции.
| Функция | Покидает устройство | Куда уходит |
|---|---|---|
| Очистка ссылок | Ничего | Работает полностью в браузере |
| Очистка фото | Ничего | Декодирование и перекодирование — на устройстве |
| Обмен / приватная отправка | Адреса, суммы | NEAR Intents 1Click (чтобы создать и исполнить ордер) |
| Живые цены | Ничего о вас | Публичный рыночный поток Coinbase |
| Агенты приватности | То, что вы вводите в форму | Zcan Privacy Model (модель) · Tavily (поисковые запросы) |
| Плановые перепроверки агентов | Ничего | Хранится только в localStorage этого браузера |
| Отправленные запуски агентов (по желанию) | Анонимизированная расшифровка — только если вы нажмёте «Поделиться» после запуска | Обучающее хранилище Zcan (можно отозвать) |
| История ордеров | Ничего | Хранится только в localStorage этого браузера |
- Exposure Scout
- Breach Guide
- Access Auditor
- Data Broker Remover
- Account Cleanup
- Social Media Lockdown
- Phishing Checker
- Wallet Hygiene Check
- Travel Privacy Prep
Каждый агент сначала составляет план, ищет в открытом интернете только для одобренных вами шагов и никогда не входит за вас в аккаунты.
08 · Справочник API
Серверные маршруты Zcan — тонкие прокси, которые держат ключи на сервере. Это те же эндпоинты, что использует приложение.
GET/api/tokens
Поддерживаемые активы с ценами в USD (список 1Click без дублей).
curl https://your-zcan.app/api/tokensPOST/api/quote
Пробная или реальная котировка. dry:false возвращает одноразовый адрес депозита. С одной из сторон должен быть ZEC; маршруты с тем же активом (ZEC→ZEC) разрешены.
# recipient: unified u1… or transparent t1…/tex1…; Sapling-only zs1… is rejected
curl -X POST https://your-zcan.app/api/quote \
-H 'content-type: application/json' \
-d '{"from":"nep141:btc.omft.near","to":"nep141:zec.omft.near",
"amount":"0.01","mode":"float","dry":true,
"recipient":"u1…","refundTo":"bc1…"}'GET/api/status?address=…&memo=…
Статус исполнения ордера по его адресу депозита.
curl 'https://your-zcan.app/api/status?address=bc1q…'POST/api/deposit
Необязательно: отправьте хеш транзакции депозита, чтобы ускорить его обнаружение.
{"txHash":"…","depositAddress":"bc1q…"}GET/api/chart
ZEC/USD за 24 ч, объём и капитализация (CoinGecko, кэш 1 мин).
curl https://your-zcan.app/api/chartPOST/api/agents/plan
Агент составляет план (JSON). Поиск пока не выполняется.
{"agentId":"breach-guide","values":{"breach":"…"}}POST/api/agents/run
Выполняет только одобренный план; отдаёт поток событий NDJSON.
{"t":"status","text":"Searching the public web…"}
{"t":"search","query":"Example Corp breach 2026"}
{"t":"source","url":"https://…","title":"…"}
{"t":"text","text":"## What happened\n…"}
{"t":"done"}09 · Свой хостинг
Zcan — приложение на Next.js. Все ключи необязательны; функции без ключа аккуратно отключаются.
# Swaps (optional; keyless quotes include a 0.2% 1Click fee)
ONECLICK_JWT=
ZCAN_FEE_RECIPIENT= # your NEAR Intents account for a service fee
ZCAN_FEE_BPS= # e.g. 50 = 0.5%
# Privacy agents — any OpenAI-compatible model (DeepSeek by default)
AI_API_KEY=
AI_BASE_URL= # e.g. your own vLLM deployment (deploy/model); empty = DeepSeek
AI_MODEL= # model for reports (required for a custom endpoint)
AI_PLAN_MODEL= # optional faster model for plans
NEXT_PUBLIC_AI_SELF_HOSTED= # true only for a model you deploy yourself
NEXT_PUBLIC_AI_MODEL_NAME= # its name, e.g. "Zcan Privacy Model"
NEXT_PUBLIC_AI_HOST= # GPU host, e.g. "Modal"
NEXT_PUBLIC_AI_PROVIDER= # or: the outside AI company answering
TAVILY_API_KEY= # optional live web search
# Optional: opt-in, anonymized training data for your own model
TRAINING_SIGNING_SECRET= # 32+ random characters
TRAINING_ADMIN_TOKEN= # 24+ chars; GET /api/training/export
KV_REST_API_URL= # Upstash / Vercel KV Redis REST store
KV_REST_API_TOKEN=
# Optional: cookieless usage counts, proxied through /api/event
NEXT_PUBLIC_ANALYTICS= # plausible | umami
ANALYTICS_SITE= # Plausible domain or Umami website id