LUKSO 专家指南

面向 LUKSO 的完整知识库 —— 专为创意经济、数字身份及新型社交标准打造的区块链平台。

快速概览

• 链 ID：42（主网）/ 4201（测试网）
• 原生代币：LYX
• 共识机制：权益证明（PoS），每个验证者需质押 32 LYX
• EVM 兼容性：是，采用未经修改的以太坊执行层
• 独特特性：使用通用档案（Universal Profiles，智能合约账户），替代外部拥有账户（EOA）
• 创始人：Fabian Vogelsteller（亦为 ERC-20 和 ERC-725 标准的创建者）

核心概念

LUKSO 在以太坊基础上扩展了 LSP 标准（LUKSO Standard Proposals），支持以下能力：

• 智能账户（通用档案），内置权限管理、元数据及社交功能
• 灵活代币（LSP7 / LSP8），具备安全特性，例如 force 参数与通用接收器钩子（universal receiver hooks）
• 免 Gas 交易（通过中继服务 LSP25 实现）
• 链上社交图谱（通过关注系统 LSP26 构建）
• 档案自定义（通过 The Grid 模块 LSP28 实现）

架构概览

通用档案（LSP0 / ERC725Account）
├── 密钥管理器（LSP6）—— 权限控制层
│   ├── 控制器（Controllers）—— 拥有特定权限的地址
│   └── 允许调用/允许地址（Allowed calls/addresses）—— 细粒度访问控制
├── 档案数据（LSP3）—— 名称、描述、头像、链接等
├── 通用接收器（LSP1）—— 处理入账交易的钩子
├── 已持有资产（LSP5）—— 所拥有的代币/NFT 注册表
├── 已发行资产（LSP12）—— 所创建的代币/NFT 注册表
└── The Grid（LSP28）—— 可定制的档案布局

参考文档

请根据实际需求加载对应文件：

LSP 标准（references/lsp-standards.md）

涵盖全部 LSP 标准（LSP0–LSP28+）的完整参考文档，包括接口定义、函数签名与实现细节。在开发涉及任一具体 LSP 的功能，或需深入理解标准整体架构时查阅。

开发者模式（references/dev-patterns.md）

提供实用代码示例与实施指南，覆盖通用档案（UP）创建、代币操作、权限配置、免 Gas 交易以及常见陷阱等内容。在编写代码或调试 LUKSO 特定问题时查阅。

生态体系（references/ecosystem.md）

汇总项目列表、团队信息、社区渠道、资助计划及链基础设施。在回答生态相关问题或查找项目资料时查阅。

合约与代码仓库（references/contracts-and-repos.md）

列出已部署合约地址、GitHub 仓库、NPM 包及 API 接口端点。在查询合约地址、ABI 或集成接口时查阅。

关键合约地址（主网）

完整地址列表见 references/contracts-and-repos.md

常用操作速查

将用户名解析为通用档案（UP）地址

# Envio GraphQL
query { Profile(where: {name: {_eq: "username"}}) { id name } }

查询通用档案（UP）总数

query { Profile_aggregate { aggregate { count } } }

关注一个档案（LSP26）

const LSP26 = "0xf01103E5a9909Fc0DBe8166dA7085e0285daDDcA";
const calldata = lsp26Contract.methods.follow(targetAddress).encodeABI();
await universalProfile.methods.execute(0, LSP26, 0, calldata).send({from: controller});

重要注意事项

1. force 参数（LSP7 / LSP8）：设为 true 可向任意地址发送代币；默认为 false，此时仅允许发送至具备通用接收器（Universal Receiver）的通用档案（UP），可防止误发至不支持该代币的 EOA 或合约。

2. LSP6 权限配置：权限采用位掩码（bitmask）机制。常见错误：授予了 CALL 权限，却遗漏了用于免 Gas 交易的 EXECUTE_RELAY_CALL 权限。

3. ERC725Y 数据编码：请使用 @erc725/erc725.js 库进行编码 —— 手动编码极易出错，尤其对于 VerifiableURI 和数组类型。

4. Gas 预估：通用档案（UP）交易经由 KeyManager 代理执行，因此 Gas 预估值可能偏差较大，建议额外预留 20–30% 的缓冲空间。

开发者资源

• 文档：https://docs.lukso.tech
• GitHub：https://github.com/lukso-network
• Medium：https://medium.com/lukso
• Discord：https://discord.gg/lukso
• 测试网水龙头：https://faucet.testnet.lukso.network