转移 SPL Token

Transfer SPL Tokens

curl --request POST \
  --url https://payments.magicblock.app/v1/spl/transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE",
  "to": "Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L",
  "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "amount": 1000000,
  "visibility": "private",
  "fromBalance": "base",
  "toBalance": "base",
  "exactOut": false,
  "initIfMissing": true,
  "initAtasIfMissing": true,
  "initVaultIfMissing": false,
  "memo": "Order #1042",
  "minDelayMs": "0",
  "maxDelayMs": "0",
  "clientRefId": "42",
  "split": 1,
  "gasless": true
}
'

import requests

url = "https://payments.magicblock.app/v1/spl/transfer"

payload = {
    "from": "3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE",
    "to": "Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L",
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": 1000000,
    "visibility": "private",
    "fromBalance": "base",
    "toBalance": "base",
    "exactOut": False,
    "initIfMissing": True,
    "initAtasIfMissing": True,
    "initVaultIfMissing": False,
    "memo": "Order #1042",
    "minDelayMs": "0",
    "maxDelayMs": "0",
    "clientRefId": "42",
    "split": 1,
    "gasless": True
}
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({
    from: '3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE',
    to: 'Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L',
    mint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
    amount: 1000000,
    visibility: 'private',
    fromBalance: 'base',
    toBalance: 'base',
    exactOut: false,
    initIfMissing: true,
    initAtasIfMissing: true,
    initVaultIfMissing: false,
    memo: 'Order #1042',
    minDelayMs: '0',
    maxDelayMs: '0',
    clientRefId: '42',
    split: 1,
    gasless: true
  })
};

fetch('https://payments.magicblock.app/v1/spl/transfer', 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://payments.magicblock.app/v1/spl/transfer",
  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([
    'from' => '3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE',
    'to' => 'Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L',
    'mint' => 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
    'amount' => 1000000,
    'visibility' => 'private',
    'fromBalance' => 'base',
    'toBalance' => 'base',
    'exactOut' => false,
    'initIfMissing' => true,
    'initAtasIfMissing' => true,
    'initVaultIfMissing' => false,
    'memo' => 'Order #1042',
    'minDelayMs' => '0',
    'maxDelayMs' => '0',
    'clientRefId' => '42',
    'split' => 1,
    'gasless' => true
  ]),
  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://payments.magicblock.app/v1/spl/transfer"

	payload := strings.NewReader("{\n  \"from\": \"3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE\",\n  \"to\": \"Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L\",\n  \"mint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n  \"amount\": 1000000,\n  \"visibility\": \"private\",\n  \"fromBalance\": \"base\",\n  \"toBalance\": \"base\",\n  \"exactOut\": false,\n  \"initIfMissing\": true,\n  \"initAtasIfMissing\": true,\n  \"initVaultIfMissing\": false,\n  \"memo\": \"Order #1042\",\n  \"minDelayMs\": \"0\",\n  \"maxDelayMs\": \"0\",\n  \"clientRefId\": \"42\",\n  \"split\": 1,\n  \"gasless\": true\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://payments.magicblock.app/v1/spl/transfer")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"from\": \"3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE\",\n  \"to\": \"Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L\",\n  \"mint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n  \"amount\": 1000000,\n  \"visibility\": \"private\",\n  \"fromBalance\": \"base\",\n  \"toBalance\": \"base\",\n  \"exactOut\": false,\n  \"initIfMissing\": true,\n  \"initAtasIfMissing\": true,\n  \"initVaultIfMissing\": false,\n  \"memo\": \"Order #1042\",\n  \"minDelayMs\": \"0\",\n  \"maxDelayMs\": \"0\",\n  \"clientRefId\": \"42\",\n  \"split\": 1,\n  \"gasless\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://payments.magicblock.app/v1/spl/transfer")

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  \"from\": \"3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE\",\n  \"to\": \"Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L\",\n  \"mint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n  \"amount\": 1000000,\n  \"visibility\": \"private\",\n  \"fromBalance\": \"base\",\n  \"toBalance\": \"base\",\n  \"exactOut\": false,\n  \"initIfMissing\": true,\n  \"initAtasIfMissing\": true,\n  \"initVaultIfMissing\": false,\n  \"memo\": \"Order #1042\",\n  \"minDelayMs\": \"0\",\n  \"maxDelayMs\": \"0\",\n  \"clientRefId\": \"42\",\n  \"split\": 1,\n  \"gasless\": true\n}"

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

{
  "kind": "transfer",
  "transactionBase64": "<string>",
  "recentBlockhash": "<string>",
  "lastValidBlockHeight": 123,
  "instructionCount": 1,
  "requiredSigners": [
    "<string>"
  ],
  "validator": "<string>",
  "fees": {
    "lamports": "<string>",
    "tokens": "<string>"
  }
}

POST

spl

transfer

Transfer SPL Tokens

curl --request POST \
  --url https://payments.magicblock.app/v1/spl/transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE",
  "to": "Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L",
  "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "amount": 1000000,
  "visibility": "private",
  "fromBalance": "base",
  "toBalance": "base",
  "exactOut": false,
  "initIfMissing": true,
  "initAtasIfMissing": true,
  "initVaultIfMissing": false,
  "memo": "Order #1042",
  "minDelayMs": "0",
  "maxDelayMs": "0",
  "clientRefId": "42",
  "split": 1,
  "gasless": true
}
'

import requests

url = "https://payments.magicblock.app/v1/spl/transfer"

payload = {
    "from": "3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE",
    "to": "Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L",
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": 1000000,
    "visibility": "private",
    "fromBalance": "base",
    "toBalance": "base",
    "exactOut": False,
    "initIfMissing": True,
    "initAtasIfMissing": True,
    "initVaultIfMissing": False,
    "memo": "Order #1042",
    "minDelayMs": "0",
    "maxDelayMs": "0",
    "clientRefId": "42",
    "split": 1,
    "gasless": True
}
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({
    from: '3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE',
    to: 'Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L',
    mint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
    amount: 1000000,
    visibility: 'private',
    fromBalance: 'base',
    toBalance: 'base',
    exactOut: false,
    initIfMissing: true,
    initAtasIfMissing: true,
    initVaultIfMissing: false,
    memo: 'Order #1042',
    minDelayMs: '0',
    maxDelayMs: '0',
    clientRefId: '42',
    split: 1,
    gasless: true
  })
};

fetch('https://payments.magicblock.app/v1/spl/transfer', 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://payments.magicblock.app/v1/spl/transfer",
  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([
    'from' => '3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE',
    'to' => 'Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L',
    'mint' => 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
    'amount' => 1000000,
    'visibility' => 'private',
    'fromBalance' => 'base',
    'toBalance' => 'base',
    'exactOut' => false,
    'initIfMissing' => true,
    'initAtasIfMissing' => true,
    'initVaultIfMissing' => false,
    'memo' => 'Order #1042',
    'minDelayMs' => '0',
    'maxDelayMs' => '0',
    'clientRefId' => '42',
    'split' => 1,
    'gasless' => true
  ]),
  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://payments.magicblock.app/v1/spl/transfer"

	payload := strings.NewReader("{\n  \"from\": \"3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE\",\n  \"to\": \"Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L\",\n  \"mint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n  \"amount\": 1000000,\n  \"visibility\": \"private\",\n  \"fromBalance\": \"base\",\n  \"toBalance\": \"base\",\n  \"exactOut\": false,\n  \"initIfMissing\": true,\n  \"initAtasIfMissing\": true,\n  \"initVaultIfMissing\": false,\n  \"memo\": \"Order #1042\",\n  \"minDelayMs\": \"0\",\n  \"maxDelayMs\": \"0\",\n  \"clientRefId\": \"42\",\n  \"split\": 1,\n  \"gasless\": true\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://payments.magicblock.app/v1/spl/transfer")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"from\": \"3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE\",\n  \"to\": \"Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L\",\n  \"mint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n  \"amount\": 1000000,\n  \"visibility\": \"private\",\n  \"fromBalance\": \"base\",\n  \"toBalance\": \"base\",\n  \"exactOut\": false,\n  \"initIfMissing\": true,\n  \"initAtasIfMissing\": true,\n  \"initVaultIfMissing\": false,\n  \"memo\": \"Order #1042\",\n  \"minDelayMs\": \"0\",\n  \"maxDelayMs\": \"0\",\n  \"clientRefId\": \"42\",\n  \"split\": 1,\n  \"gasless\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://payments.magicblock.app/v1/spl/transfer")

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  \"from\": \"3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE\",\n  \"to\": \"Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L\",\n  \"mint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n  \"amount\": 1000000,\n  \"visibility\": \"private\",\n  \"fromBalance\": \"base\",\n  \"toBalance\": \"base\",\n  \"exactOut\": false,\n  \"initIfMissing\": true,\n  \"initAtasIfMissing\": true,\n  \"initVaultIfMissing\": false,\n  \"memo\": \"Order #1042\",\n  \"minDelayMs\": \"0\",\n  \"maxDelayMs\": \"0\",\n  \"clientRefId\": \"42\",\n  \"split\": 1,\n  \"gasless\": true\n}"

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

{
  "kind": "transfer",
  "transactionBase64": "<string>",
  "recentBlockhash": "<string>",
  "lastValidBlockHeight": 123,
  "instructionCount": 1,
  "requiredSigners": [
    "<string>"
  ],
  "validator": "<string>",
  "fees": {
    "lamports": "<string>",
    "tokens": "<string>"
  }
}

授权

Authorization

string

header

必填

Token obtained from the /v1/spl/login flow.

请求体

application/json

from

string

必填

Sender wallet pubkey.

示例:

"3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE"

string

必填

Recipient wallet pubkey, or an initialized stealth handle (e.g. alice@magicblock.id). When a non-pubkey handle is provided it is resolved via its stealth pool and requires visibility: private, fromBalance: base, toBalance: base.

示例:

"Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L"

mint

string

必填

SPL mint pubkey.

示例:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

amount

integer

必填

Base-unit amount as an integer JSON value with minimum 1.

必填范围: x >= 1

示例:

1000000

cluster

Optional. Use mainnet for BASE_RPC_URL and EPHEMERAL_RPC_URL, devnet for BASE_DEVNET_RPC_URL and EPHEMERAL_DEVNET_RPC_URL, or provide a custom http(s) RPC URL to override the base RPC while keeping the configured ephemeral RPC.

可用选项:

mainnet,

devnet

示例:

"mainnet"

visibility

enum<string>

Optional. Defaults to private. Use public for a transparent SPL transfer or private to route through the Private Ephemeral Rollup.

可用选项:

public,

private

fromBalance

enum<string>

Optional. Defaults to base. Where the sender's balance is held. Drives which RPC the API uses for blockhash and where the client should submit.

可用选项:

base,

ephemeral

toBalance

enum<string>

Optional. Defaults to base. Where the recipient should receive the funds.

可用选项:

base,

ephemeral

exactOut

boolean

Optional. When true, treats amount as the exact amount the recipient should receive (relevant when fees are deducted).

validator

string

Optional. When this transfer route needs a validator and none is provided, the API resolves it from the selected ephemeral RPC via getIdentity.

示例:

"MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57"

initIfMissing

boolean

Optional. Initialize the transfer queue if missing.

initAtasIfMissing

boolean

Optional. Initialize associated token accounts if missing.

initVaultIfMissing

boolean

Optional. Initialize the vault if missing. Defaults to false.

memo

string

Optional. Appends a final Memo Program instruction with this UTF-8 message.

示例:

"Order #1042"

minDelayMs

string

Optional. Private transfer only. Defaults to 0. Earliest (ms) the queued transfer may settle.

Pattern: ^\d+$

示例:

"0"

maxDelayMs

string

Optional. Private transfer only. Defaults to 0 when omitted, or to minDelayMs when only minDelayMs is set. Must be >= minDelayMs.

Pattern: ^\d+$

示例:

"0"

clientRefId

string

Optional. Private transfer only. Encrypted client reference ID that can be used to confirm a payment.

Pattern: ^\d+$

示例:

"42"

split

integer

Optional. Private transfer only. Defaults to 1. Number of queue entries to split the transfer across. Must be between 1 and 15 and cannot exceed amount.

必填范围: x <= 15

示例:

1

gasless

boolean

Optional. When true, the API uses the configured sponsor as transaction fee payer and prepends a relay-fee token transfer to the sponsor ATA.

示例:

true

legacy

boolean

Optional. Defaults to false. When true, skips lookup-table compilation and returns a legacy transaction. Private base -> base transfers may otherwise return a v0 transaction when a useful lookup table is configured.

响应

Unsigned serialized transaction

kind

enum<string>

必填

可用选项:

transfer

version

enum<string>

必填

可用选项:

legacy,

v0

transactionBase64

string

必填

sendTo

enum<string>

必填

可用选项:

base,

ephemeral

recentBlockhash

string

必填

lastValidBlockHeight

integer

必填

instructionCount

integer

必填

必填范围: x >= 0

requiredSigners

string[]

必填

from

enum<string>

Mirrors the request fromBalance.

可用选项:

base,

ephemeral

validator

string

fees

object

Fees applied to the transfer, in base units.

Show child attributes

存入 SPL Token 提取 SPL Token

⌘I

开始使用

指南

API 参考

授权

请求体

响应