Send Binary Transaction

Key Improvements Include:

1. No Base64 Encoding/Decoding Overhead

2. No Packet Splitting due to reduced data size

3. Reduced Transmission time

Key points

• Create Transaction in raw binary format

• Header is optional

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

• Right now only sendTransaction and getHealth methods are supported

• Send request on endpoint /irisb

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 binary transaction
getHealth	POST	To keep connection alive

Example Request

curl --location 'https://lim.gateway.astralane.io/irisb?api-key=APIKEY&method=sendTransaction' \
--data-binary @transaction.bin

Code Example :

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", "application/octet-stream".parse()?); //Optional

    let irisb_transaction_bytes = bincode::serialize(&irisb_transaction)
        .context("Failed to serialize IrisB transaction to binary")?;

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

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

    println!("{}", body);

    Ok(())
}

TypeScript

Expected Response

Note:

For Binary Transaction, 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