{"id":34638080,"url":"https://github.com/metastable-labs/liquid-protocol-v1","last_synced_at":"2025-12-24T17:12:25.608Z","repository":{"id":255458410,"uuid":"851847514","full_name":"metastable-labs/liquid-protocol-v1","owner":"metastable-labs","description":"The Liquid protocol is an open protocol for democratizing access to DeFi","archived":false,"fork":false,"pushed_at":"2025-01-17T16:38:33.000Z","size":352,"stargazers_count":22,"open_issues_count":1,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-18T07:41:35.570Z","etag":null,"topics":["base","defi","protocol","yield-farming"],"latest_commit_sha":null,"homepage":"","language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/metastable-labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":"audits/liquid-audit.md","citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-09-03T19:50:36.000Z","updated_at":"2025-10-13T04:14:01.000Z","dependencies_parsed_at":"2024-09-05T14:19:37.305Z","dependency_job_id":"8cd00e31-de6a-4aad-a6eb-f84adb1861a6","html_url":"https://github.com/metastable-labs/liquid-protocol-v1","commit_stats":null,"previous_names":["metastable-labs/liquid-contracts","metastable-labs/liquid-protocol"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/metastable-labs/liquid-protocol-v1","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metastable-labs%2Fliquid-protocol-v1","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metastable-labs%2Fliquid-protocol-v1/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metastable-labs%2Fliquid-protocol-v1/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metastable-labs%2Fliquid-protocol-v1/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/metastable-labs","download_url":"https://codeload.github.com/metastable-labs/liquid-protocol-v1/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metastable-labs%2Fliquid-protocol-v1/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28005414,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-24T02:00:07.193Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["base","defi","protocol","yield-farming"],"created_at":"2025-12-24T17:09:55.643Z","updated_at":"2025-12-24T17:12:25.589Z","avatar_url":"https://github.com/metastable-labs.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Liquid Protocol\n\nLiquid Curator is a permissionless strategy curation protocol. It introduces a new primitive for creating, managing, and executing complex DeFi strategies across multiple protocols. The protocol enables trustless strategy curation with atomic execution. It provides a framework for strategy composers to create and monetize their expertise while allowing users and AI Agents to discover, evaluate, and participate in these strategies with minimal friction.\n\n## Architecture\n\nThe protocol consists of several key components:\n\n### 1. Strategy Module\n- **Strategy Contract**: Core contract that manages strategy creation and tracking\n  - Stores strategy metadata and execution steps\n  - Tracks strategy statistics and performance\n  - Manages user participation records\n  - Handles curator registration\n\n### 2. Execution Engine\n- **Engine Contract**: Handles atomic execution of strategy steps\n  - Validates and executes multi-step strategies\n  - Manages token approvals and transfers\n  - Ensures atomic execution (all steps succeed or revert)\n  - Updates strategy and user statistics\n\n### 3. Protocol Connectors\n- **Connector Contracts**: Protocol-specific adapters that:\n  - Standardize interactions with external protocols (Morpho, Moonwell, etc.)\n  - Handle protocol-specific logic and token conversions\n  - Track protocol-level balances and shares\n  - Report performance metrics back to the strategy module\n \n### Component Diagram\n[![](https://mermaid.ink/img/pako:eNp9kktvwjAMx79K5HPp-kKUakKaSo9IkwqXtRxCa0q1NkZposEQ330Z5VEOW6REf9s_O87jBAWVCBFUku93bDnPBTNjlcVackVyzUajGUuzVBkTqyNbUKkbXPfYIlt1eGWSLDlgoVVNgiWiqsUNSv8PJ5dw7GYxCYGF2ZO5rxv5MkO7ss12cr-jZ9QboN4QJfGFTfMM-wPYf8BvKKmU1D43mS7NQbnq2FLy4rMW1TXar53e9LcUk0T2LklRQU0fu9R4yGTgXfYaRflHsWt73SMndgfaG2j_XgssaFG2vC7N451-3TmoHbaYQ2RkiVuuG5VDLs4G5VpRehQFREpqtECSrnYQbXnTGUvvS_O485qbjtq7d8_FB1F7SzEmRCc4QOQGdjCZBFPP98x0grFnwdG4_bHtO14QuGHguGNvPDlb8H2p4NjBtB9O6IfuNAwtwLI2h170v68gsa0rOP8A6InBXw?type=png)](https://mermaid.live/edit#pako:eNp9kktvwjAMx79K5HPp-kKUakKaSo9IkwqXtRxCa0q1NkZposEQ330Z5VEOW6REf9s_O87jBAWVCBFUku93bDnPBTNjlcVackVyzUajGUuzVBkTqyNbUKkbXPfYIlt1eGWSLDlgoVVNgiWiqsUNSv8PJ5dw7GYxCYGF2ZO5rxv5MkO7ss12cr-jZ9QboN4QJfGFTfMM-wPYf8BvKKmU1D43mS7NQbnq2FLy4rMW1TXar53e9LcUk0T2LklRQU0fu9R4yGTgXfYaRflHsWt73SMndgfaG2j_XgssaFG2vC7N451-3TmoHbaYQ2RkiVuuG5VDLs4G5VpRehQFREpqtECSrnYQbXnTGUvvS_O485qbjtq7d8_FB1F7SzEmRCc4QOQGdjCZBFPP98x0grFnwdG4_bHtO14QuGHguGNvPDlb8H2p4NjBtB9O6IfuNAwtwLI2h170v68gsa0rOP8A6InBXw)\n\n### Sequence Diagram / Execution Flow\n[![](https://mermaid.ink/img/pako:eNptUt1rwjAQ_1fCPeypulpb3PLgi3OwwWBM3MPoS0jPWmiTLk1AJ_7vu7ZWqzWQ5D5-97sP7gBSJwgcKvx1qCS-ZCI1oogVo1MKYzOZlUJZtq7QDK0ra4TFdD_0LFWaKRzaF1oplFbfIfs02mqp89bTvnXa0Xze5eFsYZCkx3edqZvsnXYF_xZ5lpDMHsivDdIrbHXF3VbK2XKH0lm8Yc21LtmrNgyF3LLKYtna69NGEsW5qT5LH3kGELhrk7M3ZdEIaS-4zje6Jv1C64yir3K5vcfaa2NdNv3WfbrqTq2X2fSQJyCqpBVOaILXQxoUAB4UaAqRJbQ6hzokBrvFAmPgJCa4ETUOYnUkqHBWr_ZKArfGoQdGu3QLfCPyijTXVHHau7OVFuJH66ILIRX4AXbAJ-E4nM3C52Aa0PXDKPBgT-ZpNJ76QRhOnkJ_EgXR7OjBX8PgjyMPMMloTh_tsjc7f_wHVLD53g?type=png)](https://mermaid.live/edit#pako:eNptUt1rwjAQ_1fCPeypulpb3PLgi3OwwWBM3MPoS0jPWmiTLk1AJ_7vu7ZWqzWQ5D5-97sP7gBSJwgcKvx1qCS-ZCI1oogVo1MKYzOZlUJZtq7QDK0ra4TFdD_0LFWaKRzaF1oplFbfIfs02mqp89bTvnXa0Xze5eFsYZCkx3edqZvsnXYF_xZ5lpDMHsivDdIrbHXF3VbK2XKH0lm8Yc21LtmrNgyF3LLKYtna69NGEsW5qT5LH3kGELhrk7M3ZdEIaS-4zje6Jv1C64yir3K5vcfaa2NdNv3WfbrqTq2X2fSQJyCqpBVOaILXQxoUAB4UaAqRJbQ6hzokBrvFAmPgJCa4ETUOYnUkqHBWr_ZKArfGoQdGu3QLfCPyijTXVHHau7OVFuJH66ILIRX4AXbAJ-E4nM3C52Aa0PXDKPBgT-ZpNJ76QRhOnkJ_EgXR7OjBX8PgjyMPMMloTh_tsjc7f_wHVLD53g)\n\n\u003e ⚠️ **Warning**: This version of Liquid protocol hasn't been audited, so use it with caution for test purposes only.\n\n## Roadmap (not in order):\n\n - [x] Single step strategies\n - [x] Multi-step strategy curation\n - [ ] Yield and rewards calculation\n - [ ] Onchain risk analysis\n - [ ] Simulating strategy before creation\n - [ ] Making some of the contracts upgradeable\n\n## Get started\n\n1. **Clone the repository**\n   We recommend using [GH CLI](https://cli.github.com):\n\n   ```sh\n   gh repo clone metastable-labs/liquid-protocol ~/metastable-labs/liquid-protocol\n   cd ~/metastable-labs/liquid-protocol\n   ```\n\n2. **Install Foundry**\n   Make sure you have Foundry installed. If not, you can install it by following the instructions [here](https://book.getfoundry.sh/getting-started/installation).\n\n3. **Install dependencies**\n   Run the following command to install the necessary dependencies:\n\n   ```sh\n   forge update \u0026\u0026 forge install\n   ```\n\n## Deployments\n\n### If you encounter this error:\n\nError: \"./shell/deploy.base.sh: Permission denied\"\n\nRun this command:\n\n```\nchmod +x shell/deploy.*.sh\n```\n\n### Deploy\n\n```\nsh shell/deploy.sh --network=\u003cNETWORK\u003e\n```\n\nwhere \u003cNETWORK\u003e can be anything between [\"base\", \"scroll\", \"mode\", \"op\"]\n\n### Help in deployment\n\n```\nsh shell/deploy.sh ---help\n```\n\n### Adding new network\n\n1. Duplicate any deploy.NETWORK.sh file and name it deploy.DESIRED_NETWORK.sh\n2. Add two enviornment variables to .env and .env.example file\n\n```\nDESIRED_NETWORKSCAN_API_KEY=\nDESIRED_NETWORK_RPC_URL=\n```\n\n3. In the file `deploy.DESIRED_NETWORK.sh` file update the following variables\n\n```\nexport ETHERSCAN_API_KEY=$DESIRED_NETWORKSCAN_API_KEY\nexport RPC_URL=$DESIRED_NETWORK_RPC_URL\n```\n\n4. Add the network to array of `allowed_networks` in file `deploy.sh`.\n5. Run the command\n\n```\nsh shell/deploy.sh --network=DESIRED_NETWORK\n``\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetastable-labs%2Fliquid-protocol-v1","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmetastable-labs%2Fliquid-protocol-v1","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetastable-labs%2Fliquid-protocol-v1/lists"}