Send Transaction V2

Key Improvements Include:

• No CORS preflight checks

• Plain text instead of a JSON payload

• Reduced body size, which means reduced bandwidth and network overhead

Key points

• Request should only have one header as Content-Type : text/plain

• Txn should be in Base64 encoded

• Compulsory to add api-key and method in URI params

• Right now we only support sendTransaction and getHealth method

• Send request on endpoint /iris2

URI Params

Param	Type	Description
api-key	String	Mandatory, to set api key for authentication
method	String	Mandatory, to set method
mev-protect	Boolean	Optional, To set mev protect, default is false
swqos-only	Boolean	Optional, if set true, txn will be only send via swqos, default is false

Methods

Method	REST Method	Description
sendTransaction	POST	To send base64 encoded transaction
getHealth	POST	To keep alive connection

Example Request

curl --location 'https://lim.gateway.astralane.io/iris2?api-key=APIKEY&method=sendTransaction' \
--header 'Content-Type: text/plain' \
--data 'base64_encoded_txn'

Rust :

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::builder()
        .build()?;

    let mut headers = reqwest::header::HeaderMap::new();
    headers.insert("Content-Type", "text/plain".parse()?);

    let data = "base64_encoded_txn";

    let request = client.request(reqwest::Method::POST, "https://lim.gateway.astralane.io/iris2?api-key=APIKEY&method=sendTransaction")
        .headers(headers)
        .body(data);

    let response = request.send().await?;
    let body = response.text().await?;

    println!("{}", body);

    Ok(())
}

NodeJS

const axios = require('axios');
let data = 'base64_encoded_txn';

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://lim.gateway.astralane.io/iris2?api-key=APIKEY&method=sendTransaction',
  headers: { 
    'Content-Type': 'text/plain'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Go Lang

package main

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

func main() {

  url := "https://lim.gateway.astralane.io/iris2?api-key=APIKEY&method=sendTransaction"
  method := "POST"

  payload := strings.NewReader(`base64_encoded_txn`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "text/plain")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Expected Response

Note:

For Txn V2, a successful request returns status 200 OK with an empty body. Please note that unlike JSON RPC, no signature is included in the response.

Status Code	Description
200	Request is successful
400	Request might have some issues