功能指南

流动性池与搜索

/pools 页面按网络列出已索引的资金池，显示 TVL、交易量、手续费和预估 APR。可搜索代币对、资金池地址或 Uniswap v4 资金池 ID。未索引的资金池仍可通过地址打开（Pool Studio）。

• Pool Studio：价格、价格附近的活跃流动性分布、TVL/手续费/交易量图表，以及按自选区间开仓。
• 在 /pools/compare 中使用相同观察窗口同时比较最多 5 个资金池。
• APR 是基于已观察到的手续费的估算，并非收益承诺。

资金池安全

每个资金池都会通过自动检查获得安全等级（A–F）：代币合约（税费、黑名单、增发、代理）、Uniswap v4 hook、持有者集中度以及可撤出的流动性。等级历史和变化都会被记录，您可以订阅特定资金池的浏览器通知。

Solana 资金池现在拥有相同的面板：官方资金池程序、活跃流动性归属与集中度（撤池风险）、资金池价格与市场价、活动与 TVL、资金池年龄与费率，以及两种代币的检查（链上买卖模拟、GoPlus、增发/冻结、创建者、自然交易量）。评级为 F 的代币会被列入黑名单并标记为诈骗代币。

自动检查不是审计，也不是安全保证。仍可能发生撤池跑路。

兑换

/swap 页面在已登记的 Uniswap v2/v3/v4 资金池中寻找最佳路由（直接或经由桥接代币，单笔交易最多 2 跳）。跨网络路由使用 Across 跨链桥。

• 默认滑点为 1%；超过 5% 的滑点需要开启专家模式。
• 代币授权金额始终等于交易金额（绝不无限授权）。
• 签名前显示：最低到账、价格影响、Gas 费用和平台费用。

流动性仓位

您的仓位（以及您查询的其他钱包）会显示在钱包资料页。对于 Uniswap v3/v4 和 Aerodrome 仓位，可以：添加流动性、部分或全部撤出、领取手续费、复投（将手续费重新加入仓位）以及再平衡（移动到当前价格附近的新区间）。

• 手动模式：按资金池比例存入两种代币。
• 区间内/外状态和未领取手续费直接从仓位合约读取。
• 已关闭仓位：在钱包资料页勾选“显示已关闭仓位”即可查看单独的表格（每页 10 条，含 « ‹ › » 按钮和页码输入框），包括关闭时提取的代币数量与手续费、总额、手续费 APR（仅限存续 ≥ 1 天的仓位）、区间、存续时长和关闭日期。含美元稳定币的交易对按关闭时价格计算总额，否则按当前价格。
• 已关闭仓位的历史保存在服务器上：已关闭的 Uniswap v3/v4 仓位不会在每次打开资料页时重新从区块链读取（摘要在后台计算一次）。Solana 仓位在开启期间即被记录；较早的 Solana 仓位会根据钱包交易历史逐步补全（最多最近 5,000 笔交易，不含价格区间）。
• 仓位对话框与“添加流动性”面板中 ⚙ 旁的 ↻ 按钮会重新寻找路由/报价并刷新余额；图标只在您点击的搜索时旋转（自动更新仍在后台运行）。

创建新资金池

在 /pools/create 中，您可以创建尚不存在的 Uniswap v2/v3/v4 资金池，并在一笔发送至 Uniswap 官方合约的交易中添加首笔流动性，支持 9 个 EVM 网络：Ethereum、Base、Arbitrum、OP、BNB Chain、Polygon、Avalanche、Robinhood Chain 和 Arc。请先在页面顶部选择网络。

• 粘贴两个代币地址：系统会自动检测网络与协议，以及各费率下已存在的资金池。选择费率（预设，或在 Uniswap v4 上自定义 0.0001%–10%）。若该费率的资金池已存在，将引导您前往该资金池。
• 初始价格（“1 A = x B”）根据 BaniPool 市场价格建议（美元价格；若代币尚无价格，则使用其他已有资金池的汇率）。偏差超过 2% 需要确认；超过 20% 只能在专家模式下进行——错误的初始价格会立即被套利者利用。
• v3/v4：初始价格 + 区间（推荐全区间），生成 NFT 仓位。v2：初始价格 = 两种代币数量之比，生成 LP 代币。
• Zap In（默认）：只用一种代币支付——代币 A、代币 B 或 ETH。BaniPool 计算需要通过其他已有资金池兑换的部分，使其符合初始价格与区间，逐笔执行兑换，然后用实际兑换所得创建资金池。需要有通往配对代币的兑换路径（其他资金池）；若没有，请使用手动模式并提供两种代币。
• 单笔交易 Zap（BaniZapCreate 合约）已在 9 个网络上可用，暂时限制为每笔最多 $500。在 Arc（没有包装原生代币）上，Zap 使用 ERC-20 代币（如 USDC）支付，而非原生资产。若路径经过带 hook 的 v4 资金池（仅限 BaniPool 已审核的 hook），签名前会显示 hook 名称及其扣费。
• 创建资金池的平台费用（启用时最高 1%）在单笔交易 Zap 中从您支付的代币中扣除，并在签名前显示（“平台费用 x%（≈ $y）”或“免费”）。手动模式不收取平台费用。
• Uniswap v4 仅支持无 hook。未验证的代币需要勾选风险确认。
• Solana（Orca Whirlpools 与 Raydium CLMM）：选择“Solana”网络，使用 Solana 钱包登录，搜索任意代币（包括 pump.fun），然后通过 Zap（已有资金池为单笔交易）或手动模式创建资金池或添加流动性。费率档位由 Fee Advisor 自动选择，每个代币都会进行安全检查。完整说明见 Solana 页面。

Zap In 与 Zap Out

Zap In 让您只用一种代币即可进入仓位：服务器计算平衡兑换，BaniZap 合约在一笔交易中完成兑换并添加流动性。Zap Out 则相反：撤出仓位并将全部资产兑换为您选择的一种代币。

• 报价实时更新（通过网络 WebSocket 或轮询），发送前始终会进行模拟。
• 合约会检查路由命令白名单，并确保没有资金滞留在路由器中。
• 路由会从所有候选路径（直接或经由一个中间代币，包括其他 v4 资金池）中选择最终产出最多者。若资金池太浅无法兑换全部代币，模拟会以明确提示停止——请使用“手动”或选择其他目标代币。
• 内置无限 Permit2 授权的代币（部分较新的 ERC-20 代币）无法使用单笔交易 Zap In；BaniPool 会自动改用分步方案（先兑换再添加流动性），平台兑换手续费在每个兑换步骤中扣除。
• 仓位 NFT 对 Zap 合约的授权可随时在仓位页面撤销。

按名称查找代币（EVM）

EVM 兑换与创建资金池中的代币选择器会在显示的所有网络中按名称或符号搜索 BaniPool 列表之外的代币。DexScreener 结果按代币合并并显示总流动性；符号与小数位直接从代币合约读取。

列表之外的代币未经 BaniPool 验证。许多代币同名——请与官方来源核对合约地址并查看其安全卡片。

EVM Fee Advisor

在 EVM 创建资金池第 3 步，“费率分析”卡片对每个费率档位排名：按您的计划资金与区间计算手续费 APR、无常损失（LVR）成本和净 APR。在您自行选择费率之前，会自动选择推荐档位。

• 数据：该网络所有 DEX 上该代币对的全部资金池（DexScreener）；Uniswap/Pancake v3 费率链上读取，v2 按 DEX 惯例；基于 24 小时 5 分钟 K 线的波动率（GeckoTerminal）；网络出块时间用于套利因子。
• 加入已有资金池时，至少按您在该池自身手续费中的按比例份额计算。

自动化（keeper）

在 /automation 中为仓位创建规则：手续费累积时复投、超出区间时再平衡、退出，或仅发送通知。共有三种模式：

live 模式需要两项链上授权：keeper 策略（允许的操作、间隔、每日上限、到期时间、最大滑点）以及仓位 NFT 对 keeper 合约的授权。合约仅在仓位超出区间时再平衡/退出，自行计算兑换的最低输出，并始终将结果发送到您的钱包。可随时撤销。

跨链桥

/bridge 页面通过 Across Protocol 在网络间转移 ETH、WETH 或稳定币。中继者按报价时锁定的金额在目标网络填充；若在截止时间前未填充，资金将退回源网络。转账状态仅凭两个网络上的链上证据推进。

金库

官方 ERC-4626 金库（Robinhood 上的 Spark spUSDG、Base 上的 sUSDC，以及 Ethereum/Arbitrum/Optimism/Avalanche 上的 Spark 金库）可在 /vaults 存入和取出。存款通过 BaniVaultRouter 进行，采用有限授权并设定最低份额。

钱包资料、投资组合与关注列表

• /dashboard 与 /account：任意钱包在所有活跃网络上的代币余额和仓位（只读）。
• /portfolio：您的钱包与最多 20 个仅观察账户的汇总。
• /watchlist：保存资金池、代币或账户（最多 200 项）以便监控。
• /transactions：您通过 BaniPool 发起的交易历史及其状态（已提交、已确认、已最终确认、失败）。

通知

在 /settings 中连接 Web Push（浏览器）或 Telegram 机器人，以接收自动化规则通知和资金池安全警报。Telegram 绑定码有效期为 15 分钟。

自动仓位提醒

如果您的钱包已绑定通知（浏览器推送、Telegram 或邮件），BaniPool 每 15 分钟检查一次您在 EVM 与 Solana 上的活跃仓位，无需创建规则：

• 仓位超出区间——每个仓位每天最多一次；可在“设置”→“仓位超出区间”中关闭。已有 /automation 规则的仓位不会重复提醒。
• 仓位中的诈骗代币——仓位中的某个代币被列入 BaniPool 黑名单；因涉及资金安全，始终发送。
• /automation 规则现在也支持 Raydium CLMM 仓位（通知与模拟模式）。

WebSocket（WSS）设置

Zap 实时报价使用网络的公共 WebSocket RPC。为获得更稳定的连接，您可以在 /settings → 实时 WebSocket 中设置自己的 WSS URL，例如来自 Alchemy、QuickNode 或网络官方 RPC。

wss://base-mainnet.g.alchemy.com/v2/<KUNCI_ALCHEMY_ANDA>
wss://robinhood.drpc.org

• WSS URL 仅以加密形式保存在您的浏览器中，绝不会发送到 BaniPool 服务器。
• “测试”按钮会在使用前检查该 URL 是否确实连接到正确的网络（chain ID）。
• 无法使用 WebSocket 时，可使用轮询模式（每 0.5–30 秒）。

服务状态

/status 页面显示 API、数据库以及每个网络各数据源（RPC、索引）的健康状况和最后成功时间。若某网络出现问题，该网络上的交易可能会出于安全考虑暂停。