Skip to content

Commit d070d53

Browse files
v15.0.0 (#50)
1 parent e563eec commit d070d53

File tree

10 files changed

+1099
-288
lines changed

10 files changed

+1099
-288
lines changed

.coverage

-16 KB
Binary file not shown.

README.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,7 @@ config = {
7777
"solana_ultra": {
7878
"private_key": "my-private-key", # Required - base58 string - please use env vars to store the key as it is very confidential
7979
"jupiter_api_key": "my-jupiter-api-key", # Required - get free key at portal.jup.ag (60 req/min on free tier)
80+
"rpc_url": "https://mainnet.helius-rpc.com/?api-key=YOUR_KEY", # Required - Helius RPC for reliable tx sending
8081
"referral_account": "my-referral-account", # Optional - your Jupiter referral account public key for collecting fees
8182
"referral_fee": 50, # Optional - fee in basis points (50-255 bps, e.g., 50 = 0.5%). Jupiter takes 20% of this fee.
8283
"payer_private_key": "payer-private-key", # Optional - base58 private key for gasless transactions (integrator pays gas)
@@ -87,14 +88,17 @@ config = {
8788

8889
**Features:**
8990
- **Jupiter Ultra API**: Access to competitive pricing with automatic slippage protection
91+
- **Helius RPC**: Transactions sent directly via RPC instead of Jupiter's execute endpoint for reliability
9092
- **Priority Fees**: Automatically calculated to ensure transaction landing
91-
- **Transaction Landing**: Jupiter handles retries and transaction confirmation
9293
- **Referral Fees**: Optionally collect integrator fees (50-255 bps) via your Jupiter referral account
9394
- **Integrator Gas Payer**: Optionally pay for gas on behalf of users for truly gasless swaps
9495

9596
**API Key (Required):**
9697
Get a free Jupiter API key at [portal.jup.ag](https://portal.jup.ag). The free tier provides 60 requests per minute. The lite API (no key) was deprecated on December 31, 2025.
9798

99+
**RPC URL (Required):**
100+
Transactions are sent directly via your RPC instead of Jupiter's `/execute` endpoint, which can have reliability issues. Helius RPC is recommended (`https://mainnet.helius-rpc.com/?api-key=YOUR_KEY`). Get a free API key at [helius.dev](https://helius.dev).
101+
98102
**Setting up Referral Account:**
99103
To collect fees, you need a Jupiter referral account. Create one at [referral.jup.ag](https://referral.jup.ag/). Jupiter takes 20% of the referral fee you set. You also need to create token accounts for the tokens you want to collect fees in.
100104

@@ -127,12 +131,15 @@ config = {
127131

128132
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.
129133

134+
Transactions are sent directly via your RPC (Helius recommended) instead of Jupiter's `/execute` endpoint for improved reliability.
135+
130136
```python
131137
config = {
132138
"tools": {
133139
"jupiter_trigger": {
134140
"private_key": "my-private-key", # Required - base58 string
135141
"jupiter_api_key": "my-jupiter-api-key", # Required - get free key at portal.jup.ag
142+
"rpc_url": "https://mainnet.helius-rpc.com/?api-key=xxx", # Required - Helius RPC URL for transaction sending
136143
"referral_account": "my-referral-account", # Optional - for collecting fees
137144
"referral_fee": 50, # Optional - fee in basis points (50-255 bps)
138145
"payer_private_key": "payer-private-key", # Optional - for gasless transactions
@@ -302,6 +309,7 @@ config = {
302309
"app_secret": "your-privy-app-secret", # Required - your Privy application secret
303310
"signing_key": "wallet-auth:your-signing-key", # Required - your Privy wallet authorization signing key
304311
"jupiter_api_key": "my-jupiter-api-key", # Required - get free key at portal.jup.ag
312+
"rpc_url": "https://mainnet.helius-rpc.com/?api-key=YOUR_KEY", # Required - Helius RPC for reliable tx sending
305313
"referral_account": "my-referral-account", # Optional - your Jupiter referral account public key for collecting fees
306314
"referral_fee": 50, # Optional - fee in basis points (50-255 bps, e.g., 50 = 0.5%). Jupiter takes 20% of this fee.
307315
"payer_private_key": "payer-private-key", # Optional - base58 private key for gasless transactions (integrator pays gas)
@@ -313,9 +321,13 @@ config = {
313321
**Features:**
314322
- **Jupiter Ultra API**: Access to competitive pricing with automatic slippage protection
315323
- **Privy Delegated Wallets**: Use Privy's embedded wallets with delegation for seamless user experience
324+
- **Helius RPC**: Transactions sent directly via RPC instead of Jupiter's execute endpoint for reliability
316325
- **Referral Fees**: Optionally collect integrator fees (50-255 bps) via your Jupiter referral account
317326
- **Integrator Gas Payer**: Optionally pay for gas on behalf of users for truly gasless swaps
318327

328+
**RPC URL (Required):**
329+
Transactions are sent directly via your RPC instead of Jupiter's `/execute` endpoint, which can have reliability issues. Helius RPC is recommended (`https://mainnet.helius-rpc.com/?api-key=YOUR_KEY`). Get a free API key at [helius.dev](https://helius.dev).
330+
319331
### Privy Trigger
320332

321333
This plugin enables Solana Agent to create, cancel, and manage limit orders using Jupiter's Trigger API with Privy delegated wallets.

0 commit comments

Comments
 (0)