feat: add Quai integration

[0xalank]

Based on the code and files provided, I'll fill out the PR template for the Quai plugin integration:

Relates to

Integration of Quai Network functionality into Eliza OS plugins ecosystem

Risks

Low:

• Only implements basic token transfer functionality
• Uses established quais library (v1.0.0-alpha.25)
• Includes input validation for addresses and amounts
• No direct interaction with smart contracts yet

Background

What does this PR do?

Adds a new Quai Network plugin (@elizaos/plugin-quai) that enables:

• Native QUAI token transfers
• Secure transaction signing
• Network connection management
• Environment-based configuration
• Address and transaction validation

What kind of change is this?

Features (non-breaking change which adds functionality):

• New plugin for Quai Network integration
• Core transfer functionality
• Basic configuration and validation utilities

Documentation changes needed?

My changes require a change to the project documentation:

• Added comprehensive README.md for the plugin
• Includes installation, configuration, and usage instructions
• Documents API reference and troubleshooting steps

Testing

Where should a reviewer start?

1. Review the core plugin structure in index.ts
2. Check token transfer implementation in actions/transfer.ts
3. Examine utility functions in utils.ts
4. Review configuration validation and error handling

Detailed testing steps

1. Configure environment variables:

QUAI_PRIVATE_KEY=your-quai-private-key
QUAI_RPC_URL=https://rpc.quai.network

2. Test token transfer:

const result = await eliza.execute({
  action: 'SEND_TOKEN',
  content: {
    recipient: '0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7',
    amount: '10'
  }
});

3. Verify address validation:

• Test with invalid addresses
• Test with null token addresses
• Test with malformed addresses

4. Check error handling:

• Test with insufficient balance
• Test with invalid network connection
• Test with missing configuration

Deploy Notes

Database changes

None - This plugin doesn't interact with any database

Deployment instructions

1. Install dependencies:

pnpm install

2. Build the plugin:

pnpm build

3. Run tests:

pnpm test

4. Ensure environment variables are properly configured in deployment environment

This PR sets up the foundation for Quai Network integration, focusing on secure and reliable token transfers while maintaining consistency with Eliza's plugin architecture.

Discord username

alank7528

[github-actions]

Hi @0xalank! 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!