Node reference
Swap with Jupiter
Sign and execute the best Jupiter route
Sign and execute the best Jupiter route
Part of Solana / Jupiter. This reference is generated from the node definitions shipped with Blokboard.
When to use it#
- Swap tokens using the best Jupiter route.
This node uses solana. Configure the runtime’s RPC route and check Test mode. For signing operations, review wallet safety.
Parameters#
| Parameter | Field type | Default | Description |
|---|---|---|---|
Wallet (userAddress) | string | {{global.main_wallet}} | |
Input Mint (inputMintAddress) | string | — | |
Output Mint (outputMintAddress) | string | — | |
Amount (amount) | string | — | |
Input Decimals (inputDecimals) | number | — | |
Output Decimals (outputDecimals) | number | — | |
Look Up Missing Decimals (lookupMintDecimals) | boolean | true | |
Slippage (slippageMode) | tabs | automatic | Automatic uses Jupiter RTSE. Fixed sends your selected limit. |
Slippage (%) (slippagePercent) | string | 0.5 | |
Jupiter API key (apiKeyConnectionId) | connection | (empty) | Uses your encrypted HTTP credential. Leave empty for Jupiter keyless access. |
Maximum Priority Fee (SOL) (priorityFeeSol) | string | (empty) | Requests a maximum priority fee from Jupiter. Leave empty for automatic pricing. Base fees and account rent are additional. |
Transaction Verification (verificationMode) | tabs | trustJupiter | Trust Jupiter accepts its trade instructions. Strict checks recognized Metis token routes and may reject valid swaps; requires Fixed slippage. SOL, account setup, platform fees and other routes are unsupported. |
Maximum Extra SOL (maxExtraSol) | string | (empty) | Required in Strict mode. Maximum total SOL for base and priority fees. No budget is assumed. Routes needing rent, tips or other SOL transfers are rejected. |
Receiver Wallet (receiverAddress) | string | — | Optional wallet that receives the output. It must differ from the signer. |
Signing Layer (signingLayer) | select | auto | |
On failure (onFailure) | select | stop | Choose whether a failed execution stops the workflow or only ends this path. |
Retry attempts (retryCount) | number | 0 | How many additional attempts to make after the first failure. |
Input Decimals: Available under More options. Limits: minimum 0; maximum 18.
Output Decimals: Available under More options. Limits: minimum 0; maximum 18.
Look Up Missing Decimals: Available under More options.
Slippage: Choices: Automatic (automatic), Fixed (fixed).
Slippage (%): Shown when slippageMode is fixed.
Jupiter API key: Select your own http connection. See connection setup. Available under More options.
Maximum Priority Fee (SOL): Available under More options.
Transaction Verification: Choices: Trust Jupiter (trustJupiter), Strict (strict).
Maximum Extra SOL: Shown when verificationMode is strict.
Receiver Wallet: Available under More options.
Signing Layer: Choices: Auto (auto), Application (executable), Extension (extension), Web Vault (web). Available under More options.
On failure: Choices: Stop workflow (stop), Continue (continue). Available under More options.
Retry attempts: Available under More options. Limits: minimum 0; no declared maximum.
Inputs#
| Port | Value | Description |
|---|---|---|
in | any | Payload to preserve with the Jupiter swap result. |
Outputs#
| Port | Value | Description |
|---|---|---|
out | object | A freshly quoted, signed, and executed Jupiter Meta-Aggregator swap. |
out fields#
| Field | Type | Description |
|---|---|---|
inputMint | string | |
outputMint | string | |
inputAmountRaw | string | |
outputAmountRaw | string | |
router | string | |
feeMint | string | |
feeBps | number | |
referralFeeApplied | boolean | |
transactionSignature | string | |
totalInputAmountRaw | string | |
totalOutputAmountRaw | string |
Use in a workflow#
Connect this node to the path that should execute it. Run a small example, inspect its actual output, and use the expression picker to select values for later nodes.
See expressions for mapping values, workflow basics for connections, and troubleshooting for failed runs.