Listening to Sui Transactions with JavaScript – A DevRel Use Case

Jeffrey Agabaenwere — Wed, 11 Jun 2025 17:02:05 +0000

When building blockchain or fintech apps, reacting to real-time blockchain events is key.

Whether you're sending confirmation emails, triggering fiat payouts, or updating dashboards — knowing exactly when a transaction happens gives your app superpowers.

In this post, I’ll show you how to listen for Sui transactions in real time using JavaScript, and walk through a real-world use case: triggering a Naira payout after receiving SUI.

This is the same pattern I used while building suiFi — a swap engine that converts SUI directly to Nigerian Naira. 🚀

🛠️ Prerequisites

Node.js installed
A basic understanding of the Sui blockchain
Familiarity with JavaScript/TypeScript
An RPC provider (e.g. wss://rpc.testnet.sui.io)

🔧 Step 1: Project Setup

mkdir sui-listener
cd sui-listener
npm init -y
npm install @mysten/sui.js

- Then create a file named index.js.

Step 2: Connect to Sui WebSocket

const { WebSocketClient } = require('@mysten/sui.js');

const client = new WebSocketClient('wss://rpc.testnet.sui.io');//replace RPC with mainnet

client.connect().then(() => {
  console.log('✅ Connected to Sui WebSocket');
});

const walletAddress = '0xYOUR_WALLET_HERE';

client.subscribeTransactionEvents(
  {
    filter: {
      InputObject: walletAddress,
    },
  },
  (event) => {
    console.log('🔔 New Sui Transaction Detected:');
    console.log(JSON.stringify(event, null, 2));

    // 🔁 Add your action logic here
  }
);


npm install axios

const axios = require('axios');

async function sendPayout(ngnAmount, recipient) {
  await axios.post('https://your-fintech-api.com/payout', {
    amount: ngnAmount,
    recipientAccount: recipient,
  });
}

Final Thoughts
Listening to blockchain transactions is more than just reading data — it’s about empowering real-world action in real time.

If this helped you or you build something with it, tag me — I’d love to see what you’re working on!

Follow me for more DevRel content and practical guides on Web3, fintech, and developer experience.
💬 Twitter/X: [https//:x.com/Jeffreyonsui/]
📁 GitHub: [https://github.com/Jeffreyxdev/]

DEV Community: Jeffrey Agabaenwere

Listening to Sui Transactions with JavaScript – A DevRel Use Case

🛠️ Prerequisites

🔧 Step 1: Project Setup

Step 2: Connect to Sui WebSocket