示例工程区块链【免费下载链接】Dapp-LearningDapp learning project for developers at all stages. Becoming and cultivating sovereign individuals. Nonprofit organization.项目地址https://gitcode.com/gh_mirrors/da/Dapp-Learning点击查看免费下载导读本文以仓库文档 defi/instadapp/InstaDapp合约解析.md 为骨架系统拆解 InstaDapp 作为 DeFi 中间件平台的产品定位Lite / Pro 双产品、三层架构Dapp / DeFi Smart Layer / DeFi 协议并深入到合约层面还原 DeFi Smart AccountDSA的创建、delegate 代理、cast / spell 调用链与 Authority 赋权机制。读完本文你将掌握 InstaDapp 如何用智能账户 连接器把多笔 DeFi 操作合并进一笔交易并能对照仓库源码独立复盘链上调用。InstaDapp 是什么InstaDapp 是 DeFi 领域的中间件平台一个面向用户的去中心化资产管理协议为 MakerDAO、Compound、AAVE、Uniswap 等协议提供高效的资产管理能力。它的核心目标是简化 DeFi 的复杂性最终成为 DeFi 的统一前端——用户无需逐协议学习操作即可在同一入口完成借贷、交易、杠杆与跨链等复杂动作。仓库文档 defi/instadapp/readme.md 将 defisaver、cian 列为相关竞品可作为理解其定位的参照。两大产品InstaDapp Lite 与 InstaDapp Pro针对不同用户群体InstaDapp 推出了两个产品InstaDapp Lite 和 InstaDapp Pro。两者最主要的区别在于风险系数、用户对 DeFi 的认知水平或操作频率Lite面向低风险偏好、不频繁操作、DeFi 认知水平较低的用户Pro面向具备专业 DeFi 知识、能自主识别和控制风险的进阶用户。InstaDapp Lite根据官方文档的介绍InstaDapp Lite 有如下特点1POS 奖励放大Lite 只有一个主要收益策略通过在 Lido 上质押 ETH 赚取收益。即使存入 DAILite 也会把 DAI 转换为 stETH。POS 奖励放大的本质是集中散户资金、在 Lido 中形成较高占比从而获取更高收益。次要收益策略则是把 stETH 放入 Compound、AAVE 等借贷协议中放贷赚取双重收益。2简化 DeFi 策略利用 DSADeFi Smart Accounts详见下文 Pro 部分账户来简化和封装各个 DeFi 协议的操作。3最小化交易和节省 Gas 成本同样依托 DSA 的便捷性多步操作可在同一账户内合并执行减少交易次数。仓库补充Lite 的合约层实现。仓库内 defi/instadapp/code.md 记录了 Lite v1 的核心合约分析可进一步印证上述策略的产品逻辑iETH v10xc383a3833a87009fd9597f8184979af5edfad019系统参数合约supply若是 ETH先在 1inch 将 ETH 兑换为 stETH再调用ethVault.supply传入 stETH 数量、按当前getCurrentExchangePrice汇率铸出对应数量 iToken 给用户withdraw先按汇率计算可提 stETHburniToken扣除 withdraw fee 后按优先提 vault 的 weth/steth → 再提 vaultDSA → 最后从借贷协议提取的顺序执行withdrawTransfers并调用validateFinalRatio校验协议安全系数leverage当 vault 内 weth 不足时将 vault 的全部 stETH 充入 vaultDSA、deposit 到 Aaveborrow 剩余 weth 返还给用户同时校验最大/最小负债率deleveragevault 将用户 weth 转入 vaultDSA先偿还 Aave 上的 weth 债务再从 Aave 提取 astETH 转给用户非 DSA 用户或直接从 vaultDSA 提取DSA 用户rebalanceOne/rebalanceTwo通过闪电贷与 1inch 兑换调仓前者增加负债、平衡仓位后者使仓位更安全、方便用户退出。Lite v2官方介绍其具备 ERC-4626 标准、多协议策略Multi-protocol Strategy、改进的取款Improved Withdrawals以及 Rebalancer——Rebalancer 可在 vault 上执行 deposit资金过剩时存入协议、withdraw按最大比例取回、leverage按最大比例加杠杆、Refinance跨协议转移资产等操作Deleverage 时通过闪电贷平仓并取回存款。InstaDapp ProPro 面向进阶用户提供更大的操作空间用户可以利用不同策略进行杠杆、再融资和转移头寸并通过自动化实现回报最大化。Pro 页面提供Simulation 功能用户可在正式使用前模拟操作、熟悉 Pro 的用法。1协议集成范围Pro 目前在 Ethereum Mainnet 上集成了 Maker、Compound、Aave V2、Aave V3、Uniswap V3、Liquity、Savings Dai、Morpho、Morpho V3、Spark 等协议在 L2 上集成的协议较少例如 Polygon 上仅集成了 Aave V2、Aave V3、Compound V3、Uniswap V3。2账户资金操作资产跨链集成 Hop.Exchange 实现资产交易SwapDeposit、Withdraw。3杠杆与头寸操作StrategiesPro 将杠杆、头寸操作统一定义为 Strategies总共有如下 7 类Strategy含义示例Refinance仓位再融资/转移把 Aave V2 的仓位转移到 MorphoLeverage / Max mining最大化杠杆在 Aave 存入 ETH借出 DAI 再换成 ETH再次存入 Aave循环操作Unwind / Deleverage降低杠杆Withdraw Aave 中的 ETH 用来偿还从 Aave 借出的 DAICollateral Swap抵押品转换Withdraw 部分 Aave 抵押品ETH换成 USDT 后再次存入 AaveDebt Swap债务转换已从 Aave 借出 10 DAI再借 5 USDT 换成 DAI 偿还 Aave使债务由 10 DAI 变为 5 DAI 5 USDTDeposit Borrow一笔交易内完成存入和借款—Payback Withdraw一笔交易内完成债务偿还和取款—从上表可以看出Pro 的 Strategies 本质上是组合多笔操作把原先需要 23 笔交易才能完成的操作合并为 1 笔交易且操作对象始终围绕用户当前的仓位对应的 DeFi 协议。这正是依赖下文 DSA Connector 架构实现的能力。InstaDapp 整体架构三层结构Lite 与 Pro 采用同一套架构主要分为 3 个角色Dapp与 DeFi Smart LayerDSL交互的 Dapp包括 InstaDapp 自身、其他 Dapp、钱包如 MetaMask 等DeFi Smart LayerDSLDeFi 智能层InstaDapp 的核心逻辑层可细分为 3 个部分Authority只有被授权的地址才能操作 Smart Accounts、使用 Smart Accounts 中的资金进行交易DeFi Smart AccountsDSA智能账户层Solidity 合约。InstaDapp 为每个用户单独创建一个 Solidity 合约作为 Account优势在于可以在合约内插件式组合各种操作从而在一笔交易中完成复杂操作这是原生 address 无法做到的Connectors连接器层。Smart Accounts 不直接与各 DeFi 协议交易而是通过 Connector 进行操作实现账户与操作分离的架构。开发者或项目方可以实现特定 Connector 来接入 InstaDapp。DeFi Protocol协议层对应各 DeFi 协议。仓库内 defi/instadapp/code.md 给出了 DSL 各核心合约的职责清单与上文架构一一对应InstaIndex所有 DeFi Smart Accounts 的主合约负责为用户创建新的 DSA并可在新 Smart Account 中执行 cast 函数InstaImplementationM1包含 Smart Account 的核心函数cast()仅由 Smart Account 的所有者调用拥有对账户的完整操作权限InstaList使用链表维护所有 DSA 用户的注册表——由用户地址生成 Smart Account Id再映射到 Smart Account 地址并基于该地址建立 account link用于增删链表节点InstaAccountsDeFi Smart Account 钱包合约所有创建的 Smart Account 都是它的 cloneInstaConnectors维护与 InstaDapp 关联的所有 Connector 注册表用地址数组保存 ConnectorInstaMemory存储 cast 函数相关的全部数据bytes、uint、address 与 Storage Id。DeFi Smart Layer 实现解析下面分析 DeFi Smart Layer 的具体实现逻辑。创建 Smart Account从 DSL 结构可知用户必须拥有一个 Smart Account 才能与各 DeFi 协议交互且初次进入 InstaDapp Pro 时会强制要求创建 DSA。创建过程如下用户调用InstaIndex 合约的build接口Polygon 上的 InstaIndex 地址为0xa9b99766e6c676cf1975c0d3166f96c0848ff5adfunction build( address _owner, uint accountVersion, address _origin ) public returns (address _account) { require(accountVersion ! 0 accountVersion versionCount, not-valid-account); _account createClone(accountVersion); // 通过 clone 的 方式生成 Smart Account ListInterface(list).init(_account); AccountInterface(_account).enable(_owner); emit LogAccountCreated(msg.sender, _owner, _account, _origin); }其中_owner为账户所有者、accountVersion指定要 clone 的账户模板版本必须位于[1, versionCount]区间否则以not-valid-account拒绝、_origin记录调用来源地址用于事件追溯。InstaIndex 在build内部通过cloneEIP-1167 最小代理方式生成 Smart Accountfunction createClone(uint version) internal returns (address result) { bytes20 targetBytes bytes20(account[version]); // solium-disable-next-line security/no-inline-assembly assembly { let clone : mload(0x40) mstore(clone, 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000000000000000000000) mstore(add(clone, 0x14), targetBytes) mstore(add(clone, 0x28), 0x5af43d82803e903d91602b57fd5bf30000000000000000000000000000000000) result : create(0, clone, 0x37) } }clone 模式的核心思想是所有用户账户共用同一份逻辑实现InstaAccounts 模板仅复制极薄的代理字节码大幅降低每个用户的部署成本。合约创建完成后还会调用ListInterface(list).init(_account)将新账户登记进链表并通过AccountInterface(_account).enable(_owner)把_owner设为账户 Authority详见下文 Authority 一节。至此Smart Account 创建完成。Smart Account 的 delegateSmart Account 内部代码非常简洁所有进来的用户调用最终通过delegate 方式转发到真正的业务合约delegate 的目标地址为 implementation 地址。以 InstaAccountV2 为例Polygon 上账户实现地址0x51cbc90528bf960a6d5728306f0e9fae3cce38edcontract InstaAccountV2 { AccountImplementations public immutable implementations; constructor(address _implementations) { implementations AccountImplementations(_implementations); } ................... function _fallback(bytes4 _sig) internal { address _implementation implementations.getImplementation(_sig); require(_implementation ! address(0), InstaAccountV2: Not able to find _implementation); _delegate(_implementation); } fallback () external payable { _fallback(msg.sig); } }_delegate的具体实现如下标准 delegatecall 汇编function _delegate(address implementation) internal { // solhint-disable-next-line no-inline-assembly assembly { // Copy msg.data. We take full control of memory in this inline assembly // block because it will not return to Solidity code. We overwrite the // Solidity scratch pad at memory position 0. calldatacopy(0, 0, calldatasize()) // Call the implementation. // out and outsize are 0 because we dont know the size yet. let result : delegatecall(gas(), implementation, 0, calldatasize(), 0, 0) // Copy the returned data. returndatacopy(0, 0, returndatasize()) switch result // delegatecall returns 0 on error. case 0 { revert(0, returndatasize()) } default { return(0, returndatasize()) } } }由于采用 delegatecallimplementation 中的逻辑代码会直接作用于 Smart Account 自身的存储上下文——账户的资产、授权、仓位状态都保存在账户合约中而执行逻辑可以自由升级或组合。Smart Account 的处理流程如下图所示Implementation 的实现cast 与 spell从 InstaAccountV2 的 fallback 逻辑可以看到根据用户的msg.sig会选择不同的 implementation 实现。这里以其中一个实现InstaImplementationM1为例Ethereum 主网地址0x8a3462a50e1a9fe8c9e7d9023cacbd9a98d90021。InstaImplementationM1 的入口只有一个cast接口。cast的处理过程如下根据传入的_targetNames字符串数组获取对应的 connectors返回的 connectors 同样是数组connectors 在代码中对应为_targets对每个_target调用spell其内部执行的就是 delegatecall 到 connector。function cast( string[] calldata _targetNames, bytes[] calldata _datas, address _origin ) external payable returns (bytes32) // Dummy return to fix instaIndex buildWithCast function { .............. string[] memory eventNames new string[](_length); bytes[] memory eventParams new bytes[](_length); (bool isOk, address[] memory _targets) ConnectorsInterface(connectorsM1).isConnectors(_targetNames); require(isOk, 1: not-connector); for (uint i 0; i _length; i) { bytes memory response spell(_targets[i], _datas[i]); (eventNames[i], eventParams[i]) decodeEvent(response); } .............. }_targetNames中的每个元素对应一个 Connector 名称如 AAVE-A、UNISWAP-A、AUTHORITY-A_datas是与之等长的 calldata 数组两者按下标一一配对。调用前通过ConnectorsInterface(connectorsM1).isConnectors(_targetNames)统一校验名称合法性任一名称未注册即以1: not-connector回滚。spell的代码确认其内部就是 delegatecall 到 connectorfunction spell(address _target, bytes memory _data) internal returns (bytes memory response) { require(_target ! address(0), target-invalid); assembly { let succeeded : delegatecall(gas(), _target, add(_data, 0x20), mload(_data), 0, 0) let size : returndatasize() response : mload(0x40) mstore(0x40, add(response, and(add(add(size, 0x20), 0x1f), not(0x1f)))) mstore(response, size) returndatacopy(add(response, 0x20), 0, size) switch iszero(succeeded) case 1 { // throw if delegatecall failed returndatacopy(0x00, 0x00, size) revert(0x00, size) } } }cast依次对每个_target执行spell并把每次调用的返回数据通过decodeEvent解析成事件eventNames / eventParams方便前端读取各步骤结果。由于cast是external payable用户可以在一次调用中携带资金串联完成多个协议操作。Connector 中承载的才是与具体 DeFi 协议交互的逻辑例如 Aave、Uniswap、Compound。文档以ConnectV2AaveV2PolygonPolygon 地址0x14272cf069a5ce1b97c9999b8c368cf3704acd0b为例其内部实现了 Aave V2 的 deposit、borrow、withdraw、payback 等标准操作函数供cast按需拼接。Smart Account 整体调用流程总结起来Smart Account 的调用链路是用户/前端 → InstaIndex或直接对账户地址→ InstaAccountV2.fallback → implementations.getImplementation(msg.sig) → InstaImplementationM1.cast(_targetNames, _datas, _origin) → 逐项 spell(_target, _data) → delegatecall 到各 Connector → 与具体 DeFi 协议交互即账户合约只做代理分发业务逻辑沉淀在 Implementation 与 Connector 中通过 calldata 组合即可在同一笔交易里串起借贷、兑换、抵押、还款等跨协议操作。调用实例复盘Aave V2 杠杆仓位Leverage / Max mining下面以在 InstaDapp Pro 上对 Aave V2 的仓位进行Leverage / Max mining为例复盘一笔真实交易交易中传入的_targetNames包含三个元素对应三个 Connector在交易模拟/重放工具中重放该笔交易可以看到其中具体的调用跳转——cast依次对三个 connector 执行 delegatecall完成存入 ETH → 借出 DAI → 兑换回 ETH → 再次存入的循环加杠杆动作整个过程被打包为一笔交易这正是 Pro Strategies 合并多笔操作能力的落地体现。对于此类链上交易可用交易分析工具如 Tenderly Dashboard 的交易模拟器重放并逐帧查看内部调用与状态变化这也是下文对着文档发一笔交易进行 debug的推荐实践。Authority 角色赋权Defi Smart Layer 中的一个重要角色就是 Authorityuser。一个 Smart Account 可以有多个 Authorities。Authority 的管理涉及两个合约InstaListPolygon 地址0x839c2D3aDe63DF5b0b8F3E57D5e145057Ab41556与InstaIndex这两个合约共同记录了 Smart Account 与各 Authority 的对应关系。初次创建 Smart Account 时添加 Authority前文已述创建 Smart Account 需要调用 InstaIndex 的build接口该接口内部会把 user 添加进新账户的 Authority 列表function build( address _owner, uint accountVersion, address _origin ) public returns (address _account) { require(accountVersion ! 0 accountVersion versionCount, not-valid-account); _account createClone(accountVersion); ListInterface(list).init(_account); AccountInterface(_account).enable(_owner); // 添加 owner 为 Authority emit LogAccountCreated(msg.sender, _owner, _account, _origin); }添加其他 Authority在界面上手工添加另一个 Authority 时从交易参数可以看到_targetNames传入的参数值为AUTHORITY-A——即通过cast调用 Authority Connector重放这笔交易最终实际调用的是InstaList 的addAuth函数将新地址登记为账户的额外 Authority。此后该地址即可在权限范围内操作账户资金。由此DSL 的只有被授权的地址才能操作 Smart Accounts这一约束在合约层得到了落实。学习建议与仓库实践指引文档作者结合实践给出的经验总结值得借鉴官方仓库只需关注 dsa-contract 这个仓库即可——DSL 的核心合约InstaIndex、InstaAccountV2、InstaImplementationM1、InstaList、InstaConnectors、InstaMemory都集中于此不必在多个仓库间来回翻找官方文档是最新的因此最有效的学习路径是对着官方文档然后实际发一笔交易进行 debug——用交易模拟/重放工具查看内部调用跳转把_targetNames、_datas与代码实现一一对上理解效率远高于纯读代码。配套仓库资料合约解析主文档defi/instadapp/InstaDapp合约解析.mdDSL 核心合约职责清单与 Lite v1/v2 合约级代码分析defi/instadapp/code.mdInstaDapp 竞品与参考链接defi/instadapp/readme.md小结InstaDapp 的核心价值可以浓缩为三点DSA 让每个用户拥有可编程的合约账户clone 低成本部署 delegate 代理执行Connector 让账户与协议操作解耦通过实现 Connector 即可接入任意 DeFi 协议cast/spell 让跨协议组合操作压缩为单笔交易Pro 的七大 Strategies 与 Lite 的自动策略都是其上层应用。理解这条账户代理 连接器组合的链路也就掌握了 InstaDapp 这类 DeFi 中间件架构的精髓。赞分享示例工程区块链【免费下载链接】Dapp-LearningDapp learning project for developers at all stages. Becoming and cultivating sovereign individuals. Nonprofit organization.项目地址https://gitcode.com/gh_mirrors/da/Dapp-Learning点击查看免费下载上一篇Vibe-Trading 学术因子库资产定价因子的来源归因、价格代理构造与版权立场下一篇Refine 视角下的 URI 与 URL 区别从资源标识原理到管理后台路由实战创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考