feat: Add Irys plugin

[Hugo-SEQUIER]

Relates to: Irys Plugin

Risks

Low - This is a new plugin implementation with isolated functionality. Main risks:

• Data storage security (mitigated by using dedicated wallet)
• Network dependency on Irys services
• Cost management for large file uploads

Background

What does this PR do?

Implements a new ElizaOS plugin that enables decentralized data storage and retrieval using the Irys network. The plugin provides:

• Decentralized data storage functionality
• File and image upload capabilities
• Data retrieval using GraphQL queries
• Multi-agent support for data sharing

What kind of change is this?

Features (non-breaking change which adds functionality)

Documentation changes needed?

My changes doesn't require a change to the ElizaOS documentation.

The documentation has been provided in the README.md file which includes:

• Installation instructions
• Configuration requirements
• Usage examples
• API reference
• Irys platform overview

Testing

Where should a reviewer start?

1. Review the core service implementation in:
   src/services/irysService.ts
2. Check the plugin configuration in:
   src/plugins/irysPlugin.ts
3. Run tests:
   src/test/wallet.test.ts
   src/test/provider.test.ts
   src/test/worder.test.ts

Detailed testing steps

1. Install the plugin using pnpm add @elizaos/plugin-irys

2. Configure environment variables:

   • Set EVM_WALLET_PRIVATE_KEY with a Base network wallet private key
   • Set AGENTS_WALLET_PUBLIC_KEYS with comma-separated public keys

3. Test data storage for both worker and provider

4. Test data retrieval:

   • Use the getDataFromAnAgent function with configured wallet addresses
   • Verify both text data and file URLs are properly retrieved
   • Check content type handling for different data types

5. Test request from the worker to have an enhanced context

Deploy Notes

• Requires Base Sepolia ETH tokens for storing data larger than 100KB
• Free tier available for data under 100KB
• No database changes required
• Standard npm package deployment

Discord username

@_hugo_12

[github-actions]

Hi @Hugo-SEQUIER! Welcome to the ai16z community. Thanks for submitting your first pull request; your efforts are helping us accelerate towards AGI. We'll review it shortly. You are now a ai16z contributor!

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

---

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

• Review comments: Directly reply to a review comment made by CodeRabbit. Example:
  • I pushed a fix in commit <commit_id>, please review it.
  • Generate unit testing code for this file.
  • Open a follow-up GitHub issue for this discussion.
• Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
  • @coderabbitai generate unit testing code for this file.
  • @coderabbitai modularize this function.
• PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
  • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
  • @coderabbitai read src/utils.ts and generate unit testing code.
  • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
  • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

• @coderabbitai pause to pause the reviews on a PR.
• @coderabbitai resume to resume the paused reviews.
• @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
• @coderabbitai full review to do a full review from scratch and review all the files again.
• @coderabbitai summary to regenerate the summary of the PR.
• @coderabbitai generate docstrings to generate docstrings for this PR. (Beta)
• @coderabbitai resolve resolve all the CodeRabbit review comments.
• @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
• @coderabbitai help to get help.

Other keywords and placeholders

• Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
• Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
• Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

• You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
• Please see the configuration documentation for more information.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

• Visit our Documentation for detailed information on how to use CodeRabbit.
• Join our Discord Community to get help, request features, and share feedback.
• Follow us on X/Twitter for updates and announcements.