SuperAPI AI 工具集

blockchain-integration-builder

智能体与模型

查看项目

更新于 10-15 09:40

技能介绍

用途 该技能用于设计区块链系统,采用可跨链通用的模式。其核心理念是区块链无关的思维:先明确想要达成的目标,再选择链与框架。适合在构建 Web3 集成时使用。

核心抽象 资料列出了若干基础原语,作为跨链设计的基本单元:

  • 账户(Account):带余额的身份,链上示例包括 EOA(Eth)、Wallet(Solana)、Account(Near)。
  • 交易(Transaction):状态变更请求,表现为签名消息加 gas。
  • 区块(Block):一批交易,按时间排序且不可变。
  • 合约(Contract):链上程序,语言如 Solidity、Rust、Move。
  • 事件/日志(Event/Log):可索引的副作用,由合约发出并可查询。
  • 状态(State):持久化数据,如映射、存储槽。

链选择标准 资料按需求给出考虑方向与理由:

  • 可编程性:可考虑 Ethereum、Arbitrum、Base,理由是工具链成熟、EVM 生态完善。
  • 速度/成本:可考虑 Solana、Sui、Aptos,理由是吞吐量高、费用低。
  • 隐私:可考虑 Aztec、Zcash,理由是零知识证明。
  • 互操作性:可考虑 Cosmos、Polkadot,理由是跨链通信。
  • 简单性:可考虑 Bitcoin、Litecoin,理由是脚本有限、安全性经过验证。

模式库 身份模式包括:

  • 基于钱包的身份:用户 → 钱包 → 签名消息 → 验证签名 → 认证。特点是不存储密码、用户掌控身份、跨应用可用。
  • 灵魂绑定代币(SBT):发行方 → 铸造 SBT → 用户钱包(不可转让)。用于凭证、成就、声誉,不可出售或转让,发行方可选择撤销。
  • 去中心化标识符(DID):did:method:identifier → 解析 → DID 文档 → 公钥、服务。特点是自主主权身份、跨链可移植、W3C 标准。

代币模式:

  • 同质化代币(ERC-20 模式),通用接口包括 balanceOf(address) → uint256、transfer(to, amount) → bool、approve(spender, amount) → bool、transferFrom(from, to, amount) → bool。
  • 非同质化代币(ERC-721 模式),通用接口包括 ownerOf(tokenId) → address、transferFrom(from, to, tokenId)、tokenURI(tokenId) → string(元数据)。
  • 半同质化代币(ERC-1155 模式),支持批量操作与同质/非同质混合,接口包括 balanceOf(account, id) → uint256、balanceOfBatch(accounts[], ids[]) → uint256[]、safeTransferFrom(from, to, id, amount, data)。

治理模式:

  • 代币投票:提案 → 快照余额 → 投票期 → 计票 → 执行(若通过)。
  • 二次方投票:N 票的成本为 N² 代币,降低富豪主导。
  • 乐观治理:提案 → 挑战期 → 若无人挑战则执行。

经济模式:

  • 联合曲线(Bonding Curves):价格 = f(供应量)。买入时价格随供应量上升,卖出时随供应量下降,形成自动做市。
  • 质押/罚没:质押代币 → 履行职责 → 获得奖励;行为不当 → 失去质押(罚没)。
  • 流式支付:存入 → 随时间线性解锁 → 接收方领取。

架构模式: 链上与链下对比,资料从成本、速度、信任、隐私、存储五个方面说明:链上成本高(gas 费)、速度慢(区块时间)、无需信任、公开、存储昂贵;链下成本低或免费、速度快、需要信任、可私有、存储便宜。混合方案为:链下负责计算、存储、用户体验;链上负责验证、结算、所有权;桥接方式包括预言机、Merkle 证明、签名。 索引模式:区块链数据难以直接查询,可使用索引器:区块链 → 事件 → 索引器 → 数据库 → API → 前端。工具包括 The Graph、Goldsky、自定义索引器。 预言机模式:将外部数据带上链:外部数据 → 预言机网络 → 共识 → 链上值。用例包括价格喂价、随机数、API 数据。

安全原则 智能合约安全要点:检查-效果-交互(在外部调用前更新状态)、重入锁(防止递归调用)、访问控制(验证调用者权限)、输入验证(永远不要信任用户输入)、升级模式(为缺陷修复做规划,如代理、迁移)。 常见漏洞与防范:重入(递归调用耗尽资金,用检查-效果-交互防范)、整数溢出(运算回绕,用 SafeMath 或 Solidity 0.8+ 防范)、抢跑(矿工/验证者看到待处理交易,用提交-揭示、flashbots 防范)、预言机操纵(伪造价格数据,用多预言机、TWAP 防范)、访问控制(缺少权限检查,用基于角色的访问防范)。

集成工作流

  1. 定义需求:哪些需要免信任?哪些可留在链下?参与者是谁?资产是什么?
  2. 选择链:依据吞吐量需求、成本约束、生态契合度、团队专长。
  3. 设计合约:保持合约简单专注,将关注点拆分到多个合约,规划升级路径。
  4. 构建索引:确定查询模式,索引相关事件,构建 API 层。
  5. 创建前端:钱包连接、交易签名、状态展示、错误处理。
  6. 测试与审计:单元测试、集成测试、形式化验证(用于关键合约)、第三方审计。

参考资料 references/contract-patterns.md - 常见智能合约模式 references/chain-comparison.md - 链特定注意事项