Prepare Solana transaction

curl --request POST \
  --url https://platform.spritz.finance/v1/wallet-kit/solana/transactions/prepare \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientIntentId": "<string>",
  "intentVersion": 1,
  "intent": {
    "kind": "transfer",
    "from": "8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj",
    "to": "FqVnHphYBfJTb46iWbwS8oRaAWGnLPVhWqvY1pgZ7yC8",
    "amount": "1000000",
    "mint": null
  }
}
'

import requests

url = "https://platform.spritz.finance/v1/wallet-kit/solana/transactions/prepare"

payload = {
    "clientIntentId": "<string>",
    "intentVersion": 1,
    "intent": {
        "kind": "transfer",
        "from": "8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj",
        "to": "FqVnHphYBfJTb46iWbwS8oRaAWGnLPVhWqvY1pgZ7yC8",
        "amount": "1000000",
        "mint": None
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    clientIntentId: '<string>',
    intentVersion: 1,
    intent: {
      kind: 'transfer',
      from: '8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj',
      to: 'FqVnHphYBfJTb46iWbwS8oRaAWGnLPVhWqvY1pgZ7yC8',
      amount: '1000000',
      mint: null
    }
  })
};

fetch('https://platform.spritz.finance/v1/wallet-kit/solana/transactions/prepare', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform.spritz.finance/v1/wallet-kit/solana/transactions/prepare",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'clientIntentId' => '<string>',
    'intentVersion' => 1,
    'intent' => [
        'kind' => 'transfer',
        'from' => '8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj',
        'to' => 'FqVnHphYBfJTb46iWbwS8oRaAWGnLPVhWqvY1pgZ7yC8',
        'amount' => '1000000',
        'mint' => null
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://platform.spritz.finance/v1/wallet-kit/solana/transactions/prepare"

	payload := strings.NewReader("{\n  \"clientIntentId\": \"<string>\",\n  \"intentVersion\": 1,\n  \"intent\": {\n    \"kind\": \"transfer\",\n    \"from\": \"8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj\",\n    \"to\": \"FqVnHphYBfJTb46iWbwS8oRaAWGnLPVhWqvY1pgZ7yC8\",\n    \"amount\": \"1000000\",\n    \"mint\": null\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://platform.spritz.finance/v1/wallet-kit/solana/transactions/prepare")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"clientIntentId\": \"<string>\",\n  \"intentVersion\": 1,\n  \"intent\": {\n    \"kind\": \"transfer\",\n    \"from\": \"8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj\",\n    \"to\": \"FqVnHphYBfJTb46iWbwS8oRaAWGnLPVhWqvY1pgZ7yC8\",\n    \"amount\": \"1000000\",\n    \"mint\": null\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://platform.spritz.finance/v1/wallet-kit/solana/transactions/prepare")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"clientIntentId\": \"<string>\",\n  \"intentVersion\": 1,\n  \"intent\": {\n    \"kind\": \"transfer\",\n    \"from\": \"8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj\",\n    \"to\": \"FqVnHphYBfJTb46iWbwS8oRaAWGnLPVhWqvY1pgZ7yC8\",\n    \"amount\": \"1000000\",\n    \"mint\": null\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "txId": "<string>",
  "messageBytes": "<string>",
  "messageFormat": "solana_message_v0",
  "userSigner": "8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj",
  "requiredSigners": [
    "<string>"
  ],
  "feePayer": "<string>",
  "sponsored": true,
  "estimatedFeeLamports": 5000,
  "addressLookupTableAddresses": [
    "<string>"
  ],
  "blockhash": "<string>",
  "lastValidBlockHeight": 1,
  "expiresAt": "2023-11-07T05:31:56Z",
  "summary": {}
}

{
  "title": "Unauthorized",
  "status": 401,
  "type": "urn:problem-type:auth:unauthorized",
  "detail": "Bearer token required",
  "instance": "<string>",
  "realm": "API",
  "scope": "read:users"
}

{
  "title": "Unauthorized",
  "status": 400,
  "type": "urn:problem-type:auth:unauthorized",
  "detail": "<string>",
  "instance": "/errors/1234567890",
  "code": "transaction_limit",
  "field": "amountUsd",
  "retryable": true
}

{
  "title": "Unauthorized",
  "status": 400,
  "type": "urn:problem-type:auth:unauthorized",
  "detail": "<string>",
  "instance": "/errors/1234567890",
  "code": "transaction_limit",
  "field": "amountUsd",
  "retryable": true
}

{
  "title": "Unauthorized",
  "status": 400,
  "type": "urn:problem-type:auth:unauthorized",
  "detail": "<string>",
  "instance": "/errors/1234567890",
  "code": "transaction_limit",
  "field": "amountUsd",
  "retryable": true
}

{
  "title": "Unauthorized",
  "status": 400,
  "type": "urn:problem-type:auth:unauthorized",
  "detail": "<string>",
  "instance": "/errors/1234567890",
  "code": "transaction_limit",
  "field": "amountUsd",
  "retryable": true
}

{
  "title": "Unauthorized",
  "status": 400,
  "type": "urn:problem-type:auth:unauthorized",
  "detail": "<string>",
  "instance": "/errors/1234567890",
  "code": "transaction_limit",
  "field": "amountUsd",
  "retryable": true
}

POST

wallet-kit

solana

transactions

prepare

Prepare Solana transaction

curl --request POST \
  --url https://platform.spritz.finance/v1/wallet-kit/solana/transactions/prepare \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientIntentId": "<string>",
  "intentVersion": 1,
  "intent": {
    "kind": "transfer",
    "from": "8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj",
    "to": "FqVnHphYBfJTb46iWbwS8oRaAWGnLPVhWqvY1pgZ7yC8",
    "amount": "1000000",
    "mint": null
  }
}
'

import requests

url = "https://platform.spritz.finance/v1/wallet-kit/solana/transactions/prepare"

payload = {
    "clientIntentId": "<string>",
    "intentVersion": 1,
    "intent": {
        "kind": "transfer",
        "from": "8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj",
        "to": "FqVnHphYBfJTb46iWbwS8oRaAWGnLPVhWqvY1pgZ7yC8",
        "amount": "1000000",
        "mint": None
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    clientIntentId: '<string>',
    intentVersion: 1,
    intent: {
      kind: 'transfer',
      from: '8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj',
      to: 'FqVnHphYBfJTb46iWbwS8oRaAWGnLPVhWqvY1pgZ7yC8',
      amount: '1000000',
      mint: null
    }
  })
};

fetch('https://platform.spritz.finance/v1/wallet-kit/solana/transactions/prepare', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform.spritz.finance/v1/wallet-kit/solana/transactions/prepare",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'clientIntentId' => '<string>',
    'intentVersion' => 1,
    'intent' => [
        'kind' => 'transfer',
        'from' => '8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj',
        'to' => 'FqVnHphYBfJTb46iWbwS8oRaAWGnLPVhWqvY1pgZ7yC8',
        'amount' => '1000000',
        'mint' => null
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://platform.spritz.finance/v1/wallet-kit/solana/transactions/prepare"

	payload := strings.NewReader("{\n  \"clientIntentId\": \"<string>\",\n  \"intentVersion\": 1,\n  \"intent\": {\n    \"kind\": \"transfer\",\n    \"from\": \"8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj\",\n    \"to\": \"FqVnHphYBfJTb46iWbwS8oRaAWGnLPVhWqvY1pgZ7yC8\",\n    \"amount\": \"1000000\",\n    \"mint\": null\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://platform.spritz.finance/v1/wallet-kit/solana/transactions/prepare")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"clientIntentId\": \"<string>\",\n  \"intentVersion\": 1,\n  \"intent\": {\n    \"kind\": \"transfer\",\n    \"from\": \"8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj\",\n    \"to\": \"FqVnHphYBfJTb46iWbwS8oRaAWGnLPVhWqvY1pgZ7yC8\",\n    \"amount\": \"1000000\",\n    \"mint\": null\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://platform.spritz.finance/v1/wallet-kit/solana/transactions/prepare")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"clientIntentId\": \"<string>\",\n  \"intentVersion\": 1,\n  \"intent\": {\n    \"kind\": \"transfer\",\n    \"from\": \"8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj\",\n    \"to\": \"FqVnHphYBfJTb46iWbwS8oRaAWGnLPVhWqvY1pgZ7yC8\",\n    \"amount\": \"1000000\",\n    \"mint\": null\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "txId": "<string>",
  "messageBytes": "<string>",
  "messageFormat": "solana_message_v0",
  "userSigner": "8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj",
  "requiredSigners": [
    "<string>"
  ],
  "feePayer": "<string>",
  "sponsored": true,
  "estimatedFeeLamports": 5000,
  "addressLookupTableAddresses": [
    "<string>"
  ],
  "blockhash": "<string>",
  "lastValidBlockHeight": 1,
  "expiresAt": "2023-11-07T05:31:56Z",
  "summary": {}
}

{
  "title": "Unauthorized",
  "status": 401,
  "type": "urn:problem-type:auth:unauthorized",
  "detail": "Bearer token required",
  "instance": "<string>",
  "realm": "API",
  "scope": "read:users"
}

{
  "title": "Unauthorized",
  "status": 400,
  "type": "urn:problem-type:auth:unauthorized",
  "detail": "<string>",
  "instance": "/errors/1234567890",
  "code": "transaction_limit",
  "field": "amountUsd",
  "retryable": true
}

{
  "title": "Unauthorized",
  "status": 400,
  "type": "urn:problem-type:auth:unauthorized",
  "detail": "<string>",
  "instance": "/errors/1234567890",
  "code": "transaction_limit",
  "field": "amountUsd",
  "retryable": true
}

{
  "title": "Unauthorized",
  "status": 400,
  "type": "urn:problem-type:auth:unauthorized",
  "detail": "<string>",
  "instance": "/errors/1234567890",
  "code": "transaction_limit",
  "field": "amountUsd",
  "retryable": true
}

{
  "title": "Unauthorized",
  "status": 400,
  "type": "urn:problem-type:auth:unauthorized",
  "detail": "<string>",
  "instance": "/errors/1234567890",
  "code": "transaction_limit",
  "field": "amountUsd",
  "retryable": true
}

{
  "title": "Unauthorized",
  "status": 400,
  "type": "urn:problem-type:auth:unauthorized",
  "detail": "<string>",
  "instance": "/errors/1234567890",
  "code": "transaction_limit",
  "field": "amountUsd",
  "retryable": true
}

Authorizations

Authorization

string

header

required

Cognito JWT token for regular user authentication

Body

Request body for preparing a Solana transaction. The authenticated user id is derived from the bearer token; clients do not send userId to Wallet Kit. The server builds and stores an unsigned Solana v0 message, then returns the exact bytes the embedded wallet must sign.

clientIntentId

string

required

Caller-supplied idempotency key for this prepare call. Repeating the same clientIntentId with an identical intent returns the existing prepared transaction while it is active. Reusing the same key with different intent details returns a conflict error.

Minimum string length: 1

intentVersion

enum<number>

required

Version of the intent schema. Production prepare currently expects exactly 1.

Available options:

1

Example:

1

intent

object

required

Discriminated Solana transaction intent. Use transfer for wallet transfers, payment for Spritz off-ramp quote payments, yield.deposit for Kamino USDC vault deposits, and yield.withdraw for Kamino USDC vault withdrawals.

Option 1
Option 2
Option 3
Option 4

Show child attributes

feeMode

enum<string>

Available options:

auto,

sponsored_only,

user_paid_only

Response

Prepare response for the embedded-wallet signing flow. Decode messageBytes, sign those exact bytes with userSigner, then submit only the detached base64 signature. Do not submit a serialized transaction or rebuild the message client-side.

txId

string

required

Server-issued transaction id. Pass this back to the submit endpoint along with the user signature.

messageBytes

string

required

Base64-encoded Solana v0 message bytes. The embedded wallet must sign exactly these bytes after base64 decoding — do not mutate, rebuild, or wrap.

messageFormat

enum<string>

required

Format of messageBytes. solana_message_v0 means the bytes are a Solana v0 message, not a serialized transaction.

Available options:

solana_message_v0

userSigner

string

required

Solana public key that must produce userSignature over the decoded messageBytes.

Example:

"8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj"

requiredSigners

string[]

required

All signer public keys required by the prepared message. The embedded wallet is responsible for the userSigner; Spritz may add the fee-payer signature during submit.

feePayer

string

required

Solana public key paying the network fee for the prepared transaction.

Auto-Ramp Accounts

Auto-Ramp Addresses

Off-Ramp Quotes

Off-Ramps

On-Ramps

Bank Accounts

Funding Sources

Deposits

Bills

Cards

Debit Cards

Integrator Connect

Integrator

Users

Compliance

Terms

API Keys

Device Authorization

Wallet Kit

Sandbox

Prepare Solana transaction

Authorizations

Body

Response