Potato Tipper

🥔 LUKSO 社交打赏合约一站式开发套件

LUKSO 生态的 Universal Profile 自动打赏合约工具,支持一键部署配置、LSP1/LSP7 集成及 TypeScript/Solidity 开发,适合构建社交激励类 dApp。

收藏
4.3k
安装
996
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Potato Tipper 是一套围绕 LUKSO 生态 LSP 标准(LSP0/LSP1/LSP7/LSP26)构建的智能合约开发工具,主要实现「关注即打赏」(tip-on-follow) 的社交激励模式。开发者可通过该 skill 完成以下工作流:

1. 代码理解与架构分析:阅读 repo-overview.md 掌握合约职责分工,理解 PotatoTipper 作为 LSP1 Universal Receiver Delegate 的核心机制——监听 LSP26 的 follow/unfollow 事件,自动从被关注者的 UP 向新关注者转账 $POTATO 代币。

2. 测试与调试:使用内置 Foundry 脚本运行 forge 测试,支持 lite 模式加速开发循环及多级 verbosity 调试输出。

3. 部署与配置:通过 ./skills/potato-tipper/scripts/deploy.sh 一键部署至 LUKSO Mainnet/Testnet;使用 SetupPotatoTipper.s.sol Foundry 脚本在单笔 batchCalls 交易中完成 LSP1 委托连接、打赏参数设置及预算授权。

4. 前端集成:提供完整的 TypeScript 示例(wagmi/viem/ethers + erc725.js),涵盖数据键编码、权限配置、dApp 连接交互。

5. 合约扩展:Solidity 示例包括从合约内配置 PotatoTipper、实现 LSP1 接口以接收打赏、使用免费函数读取解码配置等。

显著优点

  • LUKSO 原生深度集成:完整拥抱 LUKSO 账户抽象体系(Universal Profile + KeyManager),利用 LSP1 事件委托、LSP7 可授权代币、LSP26 社交图谱注册表,实现无需用户额外签名的自动化打赏。
  • 一键配置体验:通过 Foundry batchCalls 脚本,将原本需要多笔交易的配置流程压缩为单笔原子交易,显著降低用户摩擦。
  • 完善的开发支持:提供 repo 地图、测试脚本、部署工具、ABI 资源、TypeScript/Solidity 双语言示例,覆盖从开发到生产的全生命周期。
  • 自文档化设计:配置数据键与 helper view 函数内置文档,降低集成者理解成本。
  • 弹性安全设计:LSP7 转账包裹 try/catch,失败时返回状态信息而非回滚,保障用户体验;仅允许 LSP0 合约关注者接收打赏,EOA 自动拒绝。

潜在缺点与局限性

  • 生态绑定度高:深度依赖 LUKSO 特有的 LSP 标准,无法直接迁移至以太坊主网或其他 L2,跨链扩展需重新设计。
  • 用户门槛:终端用户需理解 Universal Profile、LSP6 权限模型、wei 单位换算等概念,对非技术用户存在学习曲线。
  • 预关注者排除:安装前已存在的关注者无法获得追溯打赏,可能引发社区争议。
  • 权限管理风险:需授予 ADDUNIVERSALRECEIVERDELEGATE 等高权限,配置错误可能导致委托被恶意替换或资金风险。
  • 预算耗尽无提醒:授权预算消耗完毕后自动停止打赏,无主动通知机制,需用户自行监控余额。

适合人群

  • LUKSO 生态开发者:计划基于 Universal Profile 构建社交、创作者经济或粉丝激励类应用的团队。
  • Web3 合约工程师:熟悉 Foundry,希望深入理解 LSP1/LSP7/LSP26 集成的中级以上开发者。
  • 产品/增长负责人:探索新型用户增长机制(关注即挖矿、社交空投)的项目方。

常规风险

  • 合约权限风险:错误配置 LSP6 权限或泄露控制器私钥可能导致 UP 被接管、资金被盗。
  • 前端集成风险:erc725.js 或 viem 版本与合约不匹配可能导致数据编码错误,配置失效。
  • 经济模型风险:$POTATO 代币价格波动、预算设置不当可能导致激励效果不达预期或资金快速耗尽。
  • 网络依赖风险:LUKSO 网络稳定性、RPC 节点可用性直接影响打赏流程可用性。
  • 合规风险:代币打赏可能涉及证券、支付或税务法规,需根据运营地区评估合规性。

Potato Tipper 内容

assets文件夹
abis文件夹
references文件夹
scripts文件夹
手动下载zip · 25.1 kB
KeyManager.abi.jsonapplication/json
请选择文件