如何添加 Uniswap v3 流动性：钱包授权与头寸控制清单
本文正文暫以英文原文展示，翻譯版本需完成來源複核後再發布。
已验证事实边界
1. Uniswap v3 documentation includes setup guidance for providing liquidity. 2. Uniswap v3 documentation includes a guide for minting a liquidity position. 3. Uniswap v3 documentation includes guidance for increasing liquidity in a position. 4. Uniswap v3 documentation includes a guide for collecting fees. 5. Uniswap v3 documentation includes single-hop swap guidance, which is separate from liquidity provision. 6. A Uniswap v3 onboarding tutorial should describe wallet signing boundaries and should not describe this as custodial exchange account registration.
收起完整分析
决策矩阵
文章表格：可橫向滑動，或聚焦表格區域後使用方向鍵。
| Check | What it means | Practical action | Unknown to keep explicit |
|---|---|---|---|
| Wallet readiness | the user controls signing and recovery rather than opening a custodial account | verify wallet, network and recovery before any transaction | front-end availability in the reader region |
| Token address | wrong token or chain selection can make the route unsafe | verify official token addresses before approval | spoofed tokens with similar names |
| Pool and range | Uniswap v3 positions depend on pool and price range choices | record pool, fee tier and selected range before minting | future price movement and inactive range exposure |
| Approval amount | token approvals are a separate risk from the liquidity position | approve the smallest amount that fits the test | wallet-specific approval UX or permit behavior |
| Position record | minted liquidity has position state that must be tracked | record transaction hash and position identifier without exposing private data | indexer delay or failed transaction replacement |
| Fee collection | collecting fees is a separate action and not a guaranteed return | treat fees as claimable only when position state supports it | future fee income, impermanent loss and gas cost |
| Stop rule | do not sign when token, pool, range, approval or transaction data is unclear | pause and re-check source docs and wallet simulation | malicious front-end or compromised device state |
来源地图
- Uniswap Docs：Setting Up（uniswap-v3-setup）
- Uniswap Docs：Mint a Position（uniswap-v3-mint）
- Uniswap Docs：Increase Liquidity（uniswap-v3-increase）
- Uniswap Docs：Collect Fees（uniswap-v3-collect）
- Uniswap Docs：Single Swaps（uniswap-v3-single-swap）
控制说明
1. Wallet readiness
这一项要求读者先把公开来源翻译成操作规则。这里的含义是：the user controls signing and recovery rather than opening a custodial account。可执行动作是：verify wallet, network and recovery before any transaction。仍然未知的是：front-end availability in the reader region。因此本文不会把未知部分包装成收益承诺、牌照承诺、审批保证、恢复保证、结算保证、可用性保证、价格暗示或平台排名。
2. Token address
这里的含义是：wrong token or chain selection can make the route unsafe。可执行动作是：verify official token addresses before approval。仍然未知的是：spoofed tokens with similar names。
操作测试也必须很窄。这就是本节保留边界的原因。
3. Pool and range
这里的含义是：Uniswap v3 positions depend on pool and price range choices。可执行动作是：record pool, fee tier and selected range before minting。仍然未知的是：future price movement and inactive range exposure。
操作测试也必须很窄。这就是本节保留边界的原因。
4. Approval amount
这里的含义是：token approvals are a separate risk from the liquidity position。可执行动作是：approve the smallest amount that fits the test。仍然未知的是：wallet-specific approval UX or permit behavior。
操作测试也必须很窄。这就是本节保留边界的原因。
5. Position record
这里的含义是：minted liquidity has position state that must be tracked。可执行动作是：record transaction hash and position identifier without exposing private data。仍然未知的是：indexer delay or failed transaction replacement。
操作测试也必须很窄。这就是本节保留边界的原因。
6. Fee collection
这里的含义是：collecting fees is a separate action and not a guaranteed return。可执行动作是：treat fees as claimable only when position state supports it。仍然未知的是：future fee income, impermanent loss and gas cost。
操作测试也必须很窄。这就是本节保留边界的原因。
7. Stop rule
这里的含义是：do not sign when token, pool, range, approval or transaction data is unclear。可执行动作是：pause and re-check source docs and wallet simulation。仍然未知的是：malicious front-end or compromised device state。
操作测试也必须很窄。这就是本节保留边界的原因。
仍需明确的未知项
- front-end availability in the reader region
- spoofed tokens with similar names
- future price movement and inactive range exposure
- wallet-specific approval UX or permit behavior
- indexer delay or failed transaction replacement
- future fee income, impermanent loss and gas cost
- malicious front-end or compromised device state
实用结论
Uniswap v3 onboarding 是钱包与合约工作流，不是托管平台开户。Uniswap 文档覆盖 setting up、minting a position、increasing liquidity、collecting fees 与 single-hop swaps，但这些文档不能证明读者的钱包、token route、gas cost 或未来 fee income。实用结论是：在签署任何流动性交易前，先核验 token addresses、pool、price range、approval amount、position NFT or record、transaction data 与 stop condition。 本文停在证据边界内，帮助读者决定下一步核验什么，而不是把公开文档改写成私人账户、钱包、回调、政策框架、结算路径或流动性头寸在任何未来条件下都能成功的承诺。
相關專題與工具:Uniswap 平台檔案與費率