Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/BlockRazorinc/docs_en/llms.txt

Use this file to discover all available pages before exploring further.

BlockRazor’s Sui Fast mode provides a low-latency path for executing Sui transaction blocks by routing your signed payloads through a globally distributed acceleration network with direct validator connections. The sui_executeTransactionBlock method accepts a serialized transaction block and its corresponding signature, then submits the pair to the network with priority routing for faster finality. This is the recommended method for wallets, DEXs, and trading bots on Sui that require consistent, sub-second transaction execution under real-world network conditions.

Endpoint

POST https://fast.blockrazor.io/sui
All requests must include your BlockRazor API token in the Authorization header.

Authentication

Authorization
string
required
Your BlockRazor API token as a Bearer token: Bearer YOUR_AUTH_TOKEN. Obtain your token from the BlockRazor dashboard.

Method

sui_executeTransactionBlock This method matches the Sui JSON-RPC specification for sui_executeTransactionBlock, making BlockRazor’s Fast endpoint a drop-in replacement for the standard Sui RPC — simply change the URL and add the Authorization header.

Request Parameters

transactionBlock
string
required
The serialized, base64-encoded Sui transaction block (TransactionData). Build and serialize the transaction block using the Sui SDK before passing it to this field.
signature
string
required
The base64-encoded signature over the transaction block, produced by signing the transaction block bytes with the sender’s private key. The signature scheme (Ed25519, Secp256k1, etc.) must match the sender’s address.
options
object
Optional execution options controlling what data is returned in the response.
requestType
string
Controls when the RPC returns a response relative to the transaction’s lifecycle. Options: "WaitForEffectsCert" (returns after effects are certified), "WaitForLocalExecution" (returns after local execution, default). For time-sensitive applications, "WaitForEffectsCert" offers the fastest response time.

Response

digest
string
The unique transaction digest (base58-encoded) identifying the executed transaction block on the Sui network.
effects
object
Present when options.showEffects is true. Contains the execution status, gas summary, and object changes produced by the transaction.
events
array
Present when options.showEvents is true. Array of events emitted during transaction execution.
error
object
Present when the RPC call fails.

Code Examples

import { SuiClient } from '@mysten/sui.js/client';
import { TransactionBlock } from '@mysten/sui.js/transactions';
import { Ed25519Keypair } from '@mysten/sui.js/keypairs/ed25519';

// Connect to the BlockRazor Sui Fast endpoint
const client = new SuiClient({
  url: 'https://fast.blockrazor.io/sui',
});

// Build your transaction block
const txb = new TransactionBlock();

// Example: transfer SUI to a recipient
const [coin] = txb.splitCoins(txb.gas, [txb.pure(100_000_000n)]); // 0.1 SUI
txb.transferObjects([coin], txb.pure(RECIPIENT_ADDRESS));

// Sign the transaction block with your keypair
const keypair = Ed25519Keypair.fromSecretKey(YOUR_SECRET_KEY_BYTES);
const { bytes: serializedTxBlock, signature } = await txb.sign({
  client,
  signer: keypair,
});

// Execute the transaction block via BlockRazor Fast mode
const result = await client.executeTransactionBlock({
  transactionBlock: serializedTxBlock,
  signature: signature,
  options: {
    showEffects: true,
    showEvents: true,
    showObjectChanges: true,
  },
  requestType: 'WaitForEffectsCert',
});

console.log('Transaction digest:', result.digest);
console.log('Execution status:', result.effects?.status);
The transactionBlock must be serialized using the Sui BCS (Binary Canonical Serialization) format and then base64-encoded before submission. Use the official Sui SDK (@mysten/sui.js for TypeScript, or the Sui Move framework tooling) to produce a correctly encoded transaction block.
Use requestType: "WaitForEffectsCert" when you need the lowest-latency response after submission. This returns as soon as the transaction effects are certified by a quorum of validators, which is the earliest point at which the transaction can be considered final.
The BlockRazor Sui Fast endpoint is fully compatible with the standard Sui JSON-RPC specification. Any Sui client library that supports custom RPC URLs can be pointed at https://fast.blockrazor.io/sui without code changes beyond adding the Authorization header.

Build docs developers (and LLMs) love