Build User Steps - LayerZero

Build transaction steps

curl --request POST \
  --url https://transfer.layerzero-api.com/v1/build-user-steps \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "quoteId": "quote_abc123"
}
'

{
  "userSteps": [
    {
      "type": "TRANSACTION",
      "description": "bridge",
      "chainKey": "solana",
      "chainType": "SOLANA",
      "signerAddress": "Dz93pUVjXuaMnSsPSn7V99V4cUzhKoQdx9ECwZJZiafG"
    }
  ]
}

POST

build-user-steps

Build transaction steps

curl --request POST \
  --url https://transfer.layerzero-api.com/v1/build-user-steps \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "quoteId": "quote_abc123"
}
'

{
  "userSteps": [
    {
      "type": "TRANSACTION",
      "description": "bridge",
      "chainKey": "solana",
      "chainType": "SOLANA",
      "signerAddress": "Dz93pUVjXuaMnSsPSn7V99V4cUzhKoQdx9ECwZJZiafG"
    }
  ]
}

Generates fresh transaction data for a quote. Required for Solana transfers due to short blockhash validity.

Reference

When to use

Chain type	When to call
EVM	Not required. Use `userSteps` directly from quote response.
Solana	Always required. Solana transactions have short blockhash validity (~60 seconds). Call this endpoint immediately before execution.

Request body

Parameter	Type	Required	Description
`quoteId`	string	Yes	Quote ID from the `/quotes` response

Response

Returns a userSteps array with fresh transaction data.

User step attributes

User steps can be TRANSACTION or SIGNATURE (same structure as quote response): TRANSACTION step:

Attribute	Type	Description
`type`	string	`TRANSACTION`
`description`	string	Human-readable action description
`chainKey`	string	Chain to execute on
`chainType`	enum	`EVM`, `SOLANA`, `STARKNET`
`signerAddress`	string	Wallet that must sign
`transaction`	object	Transaction details
`transaction.encoded`	object	Encoded transaction data

For Solana, the transaction data is base64-encoded:

{
  type: "TRANSACTION",
  chainType: "SOLANA",
  transaction: {
    encoded: {
      encoding: "base64",
      data: "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQABAgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA..."
    }
  }
}

Code examples

cURL
TypeScript
Python

curl -X POST "https://transfer.layerzero-api.com/v1/build-user-steps" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"quoteId": "QUOTE_ID_FROM_SOLANA_QUOTE"}'

const response = await fetch('https://transfer.layerzero-api.com/v1/build-user-steps', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({quoteId: quote.id}),
});

const {userSteps} = await response.json();
console.log('User steps:', userSteps);

import requests

response = requests.post(
  "https://transfer.layerzero-api.com/v1/build-user-steps",
  headers={"x-api-key": "YOUR_API_KEY"},
  json={"quoteId": quote["id"]},
)

user_steps = response.json()["userSteps"]
print("User steps:", user_steps)

Response

{
  "userSteps": [
    {
      "type": "TRANSACTION",
      "description": "bridge",
      "chainKey": "solana",
      "chainType": "SOLANA",
      "signerAddress": "Dz93pUVjXuaMnSsPSn7V99V4cUzhKoQdx9ECwZJZiafG",
      "transaction": {
        "encoded": {
          "encoding": "base64",
          "data": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAkT..."
        }
      }
    }
  ]
}

Solana execution

After building user steps, deserialize and sign the transaction:

import {VersionedTransaction, Connection} from '@solana/web3.js';

// Get fresh user steps
const {userSteps} = await buildUserSteps(quoteId);
const step = userSteps[0];

// Decode base64 transaction
const txBuffer = Buffer.from(step.transaction.encoded.data, 'base64');
const tx = VersionedTransaction.deserialize(txBuffer);

// Sign and send
const signedTx = await wallet.signTransaction(tx);
const signature = await connection.sendRawTransaction(signedTx.serialize());

await connection.confirmTransaction(signature, 'confirmed');

Why Solana needs fresh transactions

Solana transactions include a recent blockhash that expires after ~60 seconds. The /build-user-steps endpoint generates transactions with the latest blockhash, ensuring they remain valid during execution. Workflow:

Request quote → Receive quote with quoteId
Call /build-user-steps with quoteId → Get fresh transaction
Sign and submit immediately (within 60 seconds)

Quotes — Request transfer quotes (includes userSteps for EVM)
Status — Track transfer progress after execution

Examples

Solana Example — Complete Solana transfer with transaction building

Authorizations

x-api-key

string

header

required

API key for authenticating requests. Required for /quotes, /build-user-steps, /submit-signature, and /status endpoints.

Body

application/json

quoteId

string

required

The quote ID to build steps for

Example:

"quote_abc123"

Response

200 - application/json

Successfully built user steps

userSteps

object[]

Show child attributes

Quotes Submit Signature

⌘I

Documentation Index

​Reference

​When to use

​Request body

​Response

​User step attributes

​Code examples

​Response

​Solana execution

​Why Solana needs fresh transactions

​Related endpoints

​Examples

Authorizations

Body

Response

Reference

When to use

Request body

Response

User step attributes

Code examples

Response

Solana execution

Why Solana needs fresh transactions

Related endpoints

Examples