feat: Add Raydium Action Provider for Solana DEX Trading

[teddynix]

description

this PR adds a new Raydium Action Provider, enabling AI agents spun up using AgentKit to perform decentralized trading on Raydium.

submitted as part of the Solana Cypherpunk Hackathon, Oct 2025

features

4 core actions on Raydium:

1. get_pools - Fetch available liquidity pools with live data (liquidity, volume, APR)
2. get_price - Get real-time token pair prices from onchain pool reserves
3. swap - Execute actual token swaps using Raydium SDK with slippage protection
4. get_pool_info - Query detailed pool information including reserves and status

dependencies

{
  "@raydium-io/raydium-sdk": "^1.3.1-beta.58",
  "bn.js": "^5.2.1"
}

breaking changes

None - This is a new action provider with no impact on existing functionality.

tests

All actions have been tested with mocked dependencies using Jest. Here are example manual tests:

checklist

[x] Added documentation to all relevant README.md files
[x] Complete README in typescript/agentkit/src/action-providers/raydium/README.md
[x] Usage examples and API documentation included
[x] Network support and dependencies documented
[x] Added a changelog entry
[x] Updated typescript/agentkit/CHANGELOG.md with feature description
[x] Included all 4 actions and implementation details
[x] Code follows TypeScript best practices and AgentKit conventions
[x] Zod schemas for input validation
[x] Error handling for API failures and invalid inputs
[x] Follows existing action provider patterns (Jupiter, Pyth, etc.)
[x] All commits are signed and verified

[cb-heimdall]

🟡 Heimdall Review Status

Requirement	Status	More Info
Reviews	🟡 0/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 2 if repo is sensitive 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 0 Sum 1