v14.1.0 (#31)

Author: truemagic-coder

.coverage

@@ -16,6 +16,7 @@ Solana Agent Kit provides a growing library of plugins that enhance your Solana
 
 * Solana Transfer - Transfer Solana tokens between the agent's wallet and the destination wallet
 * Solana Ultra - Swap Solana tokens using Jupiter Ultra API with automatic slippage, priority fees, and transaction landing
+* Solana DFlow Swap - Fast token swaps using DFlow API with platform fees
 * Jupiter Trigger - Create, cancel, and manage limit orders using Jupiter Trigger API
 * Jupiter Recurring - Create, cancel, and manage DCA orders using Jupiter Recurring API
 * Jupiter Holdings - Get token holdings with USD values for any wallet
@@ -25,6 +26,7 @@ Solana Agent Kit provides a growing library of plugins that enhance your Solana
 * Privy Ultra - Swap tokens using Jupiter Ultra with Privy delegated wallets
 * Privy Trigger - Create and manage limit orders with Privy delegated wallets
 * Privy Recurring - Create and manage DCA orders with Privy delegated wallets
+* Privy DFlow Swap - Fast token swaps using DFlow API with Privy delegated wallets and platform fees
 * Privy Wallet Address - Get the wallet address of a Privy delegated wallet
 * Privy Create User - Create a new Privy user with a linked Telegram account (for bot-first flows)
 * Privy Create Wallet - Create a Solana wallet for a Privy user with optional bot delegation
@@ -98,6 +100,33 @@ To collect fees, you need a Jupiter referral account. Create one at [referral.ju
 **Gasless Transactions:**
 By default, Jupiter Ultra provides gasless swaps when the user has < 0.01 SOL and trade is > $10. However, this **doesn't work with referral fees**. To enable gasless + referral fees, configure `payer_private_key` - this wallet will pay all gas fees and you recoup costs via referral fees.
 
+### Solana DFlow Swap
+
+This plugin enables Solana Agent to swap tokens using DFlow's Swap API with a Solana keypair. DFlow offers faster swaps compared to Jupiter Ultra with competitive rates and supports platform fees for monetization.
+
+```python
+config = {
+    "tools": {
+        "solana_dflow_swap": {
+            "private_key": "my-private-key", # Required - base58 string
+            "platform_fee_bps": 50, # Optional - platform fee in basis points (e.g., 50 = 0.5%)
+            "fee_account": "your-fee-token-account", # Optional - token account to receive platform fees
+            "referral_account": "your-referral-account", # Optional - referral account for tracking
+            "payer_private_key": "payer-private-key", # Optional - for gasless/sponsored transactions
+            "rpc_url": "https://api.mainnet-beta.solana.com", # Optional - RPC URL (defaults to mainnet)
+        },
+    },
+}
+```
+
+**Features:**
+- **Fast Swaps**: DFlow typically executes faster than Jupiter Ultra
+- **Platform Fees**: Collect fees on swaps (in basis points) paid to your fee account
+- **Gasless Transactions**: Optionally sponsor gas fees for users via `payer_private_key`
+
+**Platform Fee Setup:**
+To collect platform fees, you need to create a token account for the output token and provide it as `fee_account`. The `platform_fee_bps` specifies the fee amount (e.g., 50 = 0.5%).
+
 ### Jupiter Trigger
 
 This plugin enables Solana Agent to create, cancel, and manage limit orders using Jupiter's Trigger API. It's a smart tool that handles the full lifecycle of limit orders with a single action parameter.
@@ -333,6 +362,35 @@ config = {
 
 **Actions:** Same as Jupiter Recurring (create, cancel, list)
 
+### Privy DFlow Swap
+
+This plugin enables Solana Agent to swap tokens using DFlow's Swap API with Privy delegated wallets. DFlow offers faster swaps compared to Jupiter Ultra with competitive rates and supports platform fees for monetization.
+
+```python
+config = {
+    "tools": {
+        "privy_dflow_swap": {
+            "app_id": "your-privy-app-id", # Required - your Privy application ID
+            "app_secret": "your-privy-app-secret", # Required - your Privy application secret
+            "signing_key": "wallet-auth:your-signing-key", # Required - your Privy wallet authorization signing key
+            "platform_fee_bps": 50, # Optional - platform fee in basis points (e.g., 50 = 0.5%)
+            "fee_account": "your-fee-token-account", # Optional - token account to receive platform fees
+            "referral_account": "your-referral-account", # Optional - referral account for tracking
+            "payer_private_key": "payer-private-key", # Optional - for gasless/sponsored transactions
+        },
+    },
+}
+```
+
+**Features:**
+- **Fast Swaps**: DFlow typically executes faster than Jupiter Ultra
+- **Platform Fees**: Collect fees on swaps (in basis points) paid to your fee account
+- **Privy Delegated Wallets**: Seamless user experience with embedded wallets
+- **Gasless Transactions**: Optionally sponsor gas fees for users via `payer_private_key`
+
+**Platform Fee Setup:**
+To collect platform fees, you need to create a token account for the output token and provide it as `fee_account`. The `platform_fee_bps` specifies the fee amount (e.g., 50 = 0.5%).
+
 ### Privy Wallet Address
 
 This plugin enables Solana Agent to get the wallet address of a Privy delegated wallet.