Zcan 文档
文档
Zcan 如何 运作。
Zcan 是非托管界面：兑换和私密发送通过 NEAR Intents 做市商结算，隐私工具在你的设备上运行，智能体只执行你批准的步骤。本页所有图表都是实时的。
01 · 运作方式
你把资金发送到一次性存入地址。求解者通过竞价争夺这笔兑换，胜出者直接付款到你的目标地址。如果无法满足保证最低值，存入会被退款。
02 · 订单生命周期
每个订单都会经历这些状态，由 1Click 状态 API 报告。订单页每 5 秒查询一次；应用每 10 秒刷新你其他未完成的订单。
自动播放中 · 点击某个状态
PENDING_DEPOSIT
订单已创建，存入地址正在等待你的资金。目前还没有任何资金移动。
03 · 报价与滑点
报价包含预期产出和保证最低值，两者之间的差距就是滑点容差。拖动滑块，用实时价格查看两者的取舍。
Zcan 默认使用 1.0%。
- 实时汇率
- —
- 预期
- 0 ZEC
- 保证最低
- 0 ZEC
- 最差情况
- −$0.00
04 · 网络
NEAR Intents 支持的，Zcan 都支持，其中一方始终是 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
24 小时 ZEC/USD 以及成交量和市值（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