摘要
UniCrypt，现更名为 UNCX Network，是一个面向代币团队的多链 DeFi 工具包。其核心产品包括流动性锁定器、代币归属计划、质押和 farming 奖励计划以及代币铸造器。该项目于 2020 年启动，其治理实用型代币的交易代码为 UNCX（较早的引用使用 UNC）。
如果你搜索“unicrypt”是因为正在与其合约集成，那么实际问题通常不是这个品牌做什么，而是如何在 Ethereum、BNB Chain、Base、Arbitrum、Solana、Polygon 及其他支持网络上可靠地读写其合约。这意味着需要一个可靠的 JSON-RPC 端点、正确的链设置以及调试失败交易的方法。
本页从开发者的角度解释 UNCX 的产品表面，然后重点讨论基础设施决策：你需要哪些 RPC 方法、如何处理多链读取，以及何时共享公共端点就足够，何时专用节点更有意义。OnFinality 为 UNCX 支持的许多网络提供 RPC API 访问和专用节点基础设施；在确定架构之前，请查看支持的 RPC 网络和 RPC 定价。
关键要点
- UniCrypt 现更名为 UNCX Network；代币代码为 UNCX，较早的引用使用 UNC。
- UNCX 产品基于合约：流动性锁定器、归属计划、质押/farming 和代币铸造器。
- 集成默认是多链的，因此你的 RPC 层必须处理多个 EVM 链以及 Solana。
- 大多数读取路径需要 eth_call、eth_getLogs 和归档状态来获取历史锁定和归属记录。
- 写入路径需要可靠的交易提交和清晰的回滚原因，这正是端点质量体现的地方。
- 共享 RPC API 适用于仪表盘和原型；当你大量轮询日志或需要可预测的吞吐量时，专用节点更有帮助。
- 在将合约地址和支持的网络接入生产环境之前，务必从 UNCX 自己的文档中确认。
UniCrypt 变成了什么，以及开发者为何关心
UniCrypt 最初是一套 DeFi 实用工具，现在以 UNCX Network 呈现。产品集面向代币团队：锁定流动性以便持有者验证承诺、为团队和投资者分配安排代币归属、资助质押或 LP farming 奖励，以及无需从头编写合约即可铸造代币。
对于开发者来说，重要的细节是这些是链上产品。锁定器是一个持有 LP 代币直到解锁日期的合约。归属计划是一个随时间释放代币的合约或记录。质押和 farming 计划从项目资助的预算中分配奖励。如果你正在构建仪表盘、合规检查或读取这些记录的集成，你是在进行合约调用，而不是消费 REST API。
这重新定义了搜索。输入“unicrypt”的人可能想要产品概述，但集成商需要知道合约位于哪些链上、调用哪些方法，以及什么样的 RPC 端点在你跨数千个区块轮询事件日志时不会崩溃。
- 流动性锁定器：在选定时间内持有 LP 代币并公开锁定记录。
- 代币归属：为接收者提供悬崖、线性及分步释放计划。
- 质押和 farming：向代币持有者或 LP 分配奖励预算。
- 代币铸造器：无需自定义代码即可创建和部署代币。
- 多链足迹：Ethereum、BNB Chain、Base、Arbitrum、Solana、Polygon 等，产品可用性因网络而异。
决策指南：共享 RPC API 还是专用节点？
在选择端点之前，请诚实地描述你的工作负载。一个每页读取少量锁定记录的区块浏览器式仪表盘，与一个扫描三条链上每个锁定器事件并存储历史状态的索引器截然不同。
使用下表将你的集成模式映射到基础设施选择。目标不是购买最大的计划；而是避免读取路径正常但日志查询超时或写入因速率限制而卡住的故障模式。
| 标准 | 检查内容 | 为什么重要 |
|---|---|---|
| 读取模式 | 偶尔使用 eth_call 获取锁定或归属状态，还是跨大区块范围持续使用 eth_getLogs。 | 日志密集型索引是共享端点变得痛苦的最常见原因。 |
| 历史状态 | 你是否需要过去区块的余额或合约状态，这需要归档访问。 | 非归档节点会修剪旧状态，历史查询将失败。 |
| 写入频率 | 你提交锁定、归属或质押交易的频率，以及如何处理 nonce 和替换。 | 写入突发会迅速暴露端点可靠性和内存池行为。 |
| 链数量 | 你从多少个 UNCX 支持的网络读取，以及是否需要一致的接口。 | 多链读取会成倍增加请求量和配置漂移。 |
| 团队能力 | 你是想运行和监控节点，还是消费托管端点。 | 自托管将正常运行时间和升级工作转移给你的团队。 |
链设置和端点模式
UNCX 合约部署在多个 EVM 网络以及 Solana 上，因此你的配置本质上是多链的。对于 EVM 链，你需要链 ID、JSON-RPC URL、原生货币符号以及用于验证的区块浏览器。对于 Solana，你需要 HTTP RPC URL，如果你订阅账户变更，还需要 WebSocket URL。
OnFinality 在每个支持的网络页面上发布网络特定设置。从支持的 RPC 网络开始，打开你需要的链，并从该页面复制链 ID 和端点，而不是从可能过时的第三方列表复制。下面的模式展示了多链客户端通常如何连接；将占位符替换为匹配网络页面中的端点。
- 为每条链保留一个配置对象，包含 chainId、rpcUrl 和 explorerUrl。
- 按链存储合约地址；不要假设跨网络地址相同。
- 对于 Solana，将 HTTP 和 WebSocket URL 分开保存。
- 在启动时记录链 ID，以便配置错误的端点能大声失败。
你实际会调用的方法
大多数 UNCX 集成分为两类：读取锁定和归属记录，以及提交创建或与它们交互的交易。读取侧主要由用于视图函数的 eth_call 和用于锁定创建或解锁等事件的 eth_getLogs 主导。写入侧需要 gas 估算、nonce 管理以及解码回滚的方法。
如果你正在索引，请为 eth_getLogs 限制做好规划。许多提供商限制区块范围或每个请求的结果数量，因此你的索引器应分页遍历范围并检查点进度。如果你需要历史区块的状态，请在设计之前确认归档访问。
| 标准 | 检查内容 | 为什么重要 |
|---|---|---|
| eth_call | 用于锁定详情、解锁时间、归属计划和奖励预算的视图函数。 | 这是仪表盘和验证页面的主要读取路径。 |
| eth_getLogs | 锁定创建、解锁、归属释放和质押奖励的事件主题。 | 索引器依赖它；范围限制决定你的分页策略。 |
| eth_getTransactionReceipt | 写入后的状态和日志，以及失败时的回滚数据。 | 确认锁定或归属交易是否实际成功。 |
| eth_estimateGas | 提交前锁定、归属和质押调用的 gas。 | 防止因 gas 低估导致的交易失败。 |
| eth_blockNumber | 用于检查点和新鲜度检查的当前头部。 | 有助于在滞后的端点破坏索引之前检测到它。 |
示例：使用 viem 读取锁定记录
下面的代码片段展示了读取集成的结构。它使用公共客户端、每链配置以及你从 UNCX 文档提供的合约 ABI。端点值故意是占位符：从 OnFinality 网络页面复制你目标链的真实 URL。
将 ABI 和地址保存在版本化配置中。当 UNCX 更新合约时，你希望有一个地方可以更改，并且有一个测试在某个链缺少地址时失败。
- 使用每链客户端工厂而不是全局客户端。
- 将读取包装在超时中，并使用退避重试。
- 短暂缓存锁定记录；它们仅在解锁或转移时改变。
- 在启动时断言返回的链 ID 与你的配置匹配。
故障模式及如何调试
围绕 UNCX 合约的大多数集成错误并不奇特。它们是错误的地址、错误的链、修剪的状态或日志范围限制。下表将症状映射到可能的原因，以便你按顺序调试而不是猜测。
当写入失败时，在重试之前解码回滚原因。回滚通常意味着业务规则失败，例如解锁日期已过或授权不足，而不是端点损坏。重试确定性回滚只会浪费 gas 和时间。
| 标准 | 检查内容 | 为什么重要 |
|---|---|---|
| 调用返回空数据 | 合约地址和链 ID。 | 错误链上的有效地址返回空。 |
| 历史查询失败 | 端点上的归档访问。 | 修剪的状态无法回答过去区块的读取。 |
| eth_getLogs 超时 | 区块范围大小和提供商限制。 | 大多数共享端点需要分页。 |
| 交易卡在待处理 | Nonce、gas 价格和内存池可见性。 | 替换需要看到待处理交易。 |
| 跨调用读取不一致 | 请求是否命中不同的后端或滞后的头部。 | 当一致性重要时，将读取固定到区块号。 |
OnFinality 的定位
OnFinality 为一系列网络提供 RPC API 访问和专用节点基础设施，包括 UNCX 支持的几个网络。如果你正在围绕锁定器和归属合约构建仪表盘、索引器或交易流程，你可以从共享 RPC API 开始，并在日志量或写入频率增长时迁移到专用节点。
查看支持的 RPC 网络以获取你需要的链，查看 RPC 定价以确定计划规模，如果你正在比较选项，请阅读提供商选择指南。对于希望获得隔离容量和自有配置的团队，专用节点是下一步。
- 从共享端点开始用于原型和低流量仪表盘。
- 当日志索引或写入突发占主导时，迁移到专用容量。
- 在确定计划之前确认归档和 trace 需求。
- 配置备用端点以实现故障转移。
常见问题
UniCrypt 和 UNCX Network 是同一个吗？
UNCX Network 是该项目（前身为 UniCrypt）的当前品牌。代币代码为 UNCX，较早的引用可能使用 UNC。产品可用性因网络而异，请查看官方网站获取当前列表。
UniCrypt 有用于锁定记录的 REST API 吗？
锁定和归属记录是链上合约状态。集成商通常通过 JSON-RPC 方法（如 eth_call 和 eth_getLogs）读取它们，而不是专用的 REST API。你看到的任何仪表盘或索引器都是构建在这些 RPC 调用之上的。
UNCX 集成需要哪些 RPC 方法？
对于读取，eth_call 和 eth_getLogs 涵盖大多数情况，eth_blockNumber 用于检查点。对于写入，你需要 eth_estimateGas、eth_sendRawTransaction 和 eth_getTransactionReceipt。历史状态需要归档访问。
我可以为 UNCX 仪表盘使用公共 RPC 端点吗？
公共端点可以用于低流量读取，但日志索引和写入突发通常会触及范围限制或速率限制。对于生产仪表盘和索引器，托管 RPC API 或专用节点可提供更可预测的行为。
如何处理多条链上的 UNCX 合约？
为每条链保留一个配置，包含链 ID、端点、浏览器 URL 和合约地址。不要假设跨网络地址相同。在启动时断言链 ID，以便配置错误的端点立即失败。
Ethereum
Solana
Polygon
Base
Arbitrum
BNB链
Polkadot
Optimism
