Autonomous DCA Agent on AO

🚨 This App was discontinued

Due to this app being some of our early work aimed at exhibiting the capabilities of AO, we're discontinuing it but keep this repo as a public good.

Feel free to explore the code in this repo or read our related research article.

An alternative to DCA on AO is currently available on Botega.

---

This Autonomous Investment Agent (AIA) executes a dynamic dollar-cost-average (DCA) investment strategy across various liquidity pools within the AO ecosystem. It automatically buys a base token at predetermined, user-configurable intervals using a consistent amount of a quote token for each transaction.

The agent has functional autonomy and operates independently on the AO platform, requiring no off-chain signals or human intervention.

The management interface is hosted on Arweave's Permaweb, ensuring operation without the need for trusted intermediaries.

Try It Out Live

Experience the DCA Agent live on the permaweb.

For more details on capabilities and a technical deep-dive, refer to our Research Article.

Run Locally

To run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.

Key Features

• Direct Pool Interaction: Operates directly with the pool, bypassing routers.
• Ownership: Initially owned by the deployment signer, ownership can be transferred.
• Currency Pair: Manages a single currency pair.
• Composability: Designed to be owned/controlled by a user possessing an Arweave wallet or by another automated agent.

Operations

• Token Loading: Supports loading with QuoteToken.
• Withdrawals: Permits the withdrawal of either Base or QuoteToken.
• Liquidation: Allows complete liquidation, returning assets in QuoteToken.

Configuration

• Initial Setup: BaseToken, slippage, and swapAmount are set during initialization.
• Fixed BaseToken: The BaseToken configuration is static and cannot be changed after initialization.

Deployment

Agent & Backend Deployment

Lua Preparation

Combine all Lua scripts into a single file for deployment:

• Use Amalg from LuaRocks: Amalg
• Build commands for OSX:

  npm run build-lua-agent
  npm run build-lua-backend

In-App Process

• Configuration: The user sets up the agent specifying base token, slippage, and swap amount.
• Deployment: User confirms deployment, which triggers:

1. the main agent process is created as a cron process and signed with the user's wallet.
2. Loading of process.lua upon deployment confirmation.
3. Initialization of the agent with its configuration and proper owner
4. Start Monitoring the agent as a cron process
5. Registration of the agent with the DCA backend process on AO

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Disclaimer

Important Notice

This software, the Autonomous Investment Agent (AIA), is provided as open-source under the MIT License. While the software has been developed with diligence and care, it is important to understand that its use comes with inherent risks. The technology behind this agent and the AO ecosystem is relatively new and may be subject to unknown vulnerabilities, rapid changes, and evolving standards.

Use at Your Own Risk

1. No Warranties: The AIA software is provided "as is", without any warranties of any kind. This includes, but is not limited to, warranties of merchantability, fitness for a particular purpose, and non-infringement. By using this software, you acknowledge that you do so at your own risk.

2. Financial Risk: The AIA employs an autonomous investment strategy. As with any investment, there are financial risks involved, including but not limited to market volatility, loss of investment, and unforeseen changes in the blockchain ecosystem. You are solely responsible for any financial decisions made using this software.

3. Technological Risk: Blockchain technology, smart contracts, and decentralized finance (DeFi) protocols are complex and still developing. This software may have bugs, experience failures, or encounter security vulnerabilities that could result in unintended behavior, including financial losses.

4. Regulatory Risk: The regulatory environment for blockchain technology and digital assets is uncertain and rapidly evolving. It is your responsibility to ensure compliance with any applicable laws and regulations in your jurisdiction.

5. No Liability: In no event shall the authors, developers, or contributors of this software be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.

User Responsibility

• Due Diligence: Users are encouraged to conduct their own due diligence before engaging in any transactions or relying on the functionality of this software.
• Education: Ensure you have a solid understanding of blockchain technology, the AO ecosystem, and decentralized finance principles before using the AIA software.
• Security Practices: Follow best practices for security, such as safeguarding private keys, using secure devices, and regularly updating software.

By using this software, you agree to this disclaimer and acknowledge that you understand and accept the risks involved.

TODO

• .update backend to latest aos
• update the AO module to use when spawning
• refactor agent to use the request-response mechanism (?)