Parsing Substitutions from Raw Transaction Data: A Best Practice Guide
As a developer building applications on Solana, parsing raw transactional data is an essential step in understanding network behavior and extracting valuable insights. In this article, we’ll dive into best practices for parsing swaps from raw transaction data.
What are substitutions?
In blockchain networks like Solana, swaps refer to transactions that involve the exchange of tokens or assets between parties. It can be a one-way exchange (e.g. sending Ether to a liquidity pool) or a spot exchange (e.g. direct exchange of two tokens). In our context, we focus on the first type.
Raw transaction data
To analyze raw transaction data, you need access to the Solana network block explorer and the ability to read binary data. The most convenient way to do this is via the
Solana CLI or a web-based interface such as [Solana Explorer](
The messageLogs field in a raw transaction represents the entire message, including the swap information. However, parsing these logs can be complex for the following reasons:
- Message Size: Swap messages are typically longer than regular transactions.
- Structured Data: Swaps often contain multiple fields, such as token amounts, liquidity providers, and swap types.
Best Practices: Parsing Swaps from Raw Transaction Data
To effectively parse swaps from raw transaction data, follow these steps:
1. Determine the Swap Type
Before parsing a swap message, identify its type (e.g. UNILP or LPT). This will help you understand the relevant fields and their contents.
2. Use a JSON parsing library
Use a library like [json-solana]( to parse the swap message as JSON. This library provides an efficient way to work with binary data and helps reduce the burden of parsing.
const JsonSolana = require('json-solana');
// Assuming 'swap' is a raw transaction object
const swapMessage = await JsonSolana.deserializeFromBinaryBuffer(
// Binary buffer containing the swap message
);
// Convert the JSON string to a JavaScript object for easier processing
const swapData = JSON.parse(JSON.stringify(swapMessage));
3. Extract relevant fields
Carefully extract relevant fields from the parsed swap data, such as:
- Token amounts (e.g.
amount,uses)
- Liquidity provider information (e.g.
liquidityProvider,liquidityToken)
Use the extracted data to create the desired output format.
4. Handling raw fields
Be prepared to handle any raw fields in the raw transaction message, such as error messages or unknown values. This may require additional processing steps or fallback strategies.
// Example: Handling an unknown token amount field
const swapData = JSON.parse(JSON.stringify(swapMessage));
if (!swapData.tokenAmount) {
console.error('Unknown token amount');
// Decide how to resolve the issue (e.g. ignore, throw an error)
}
5. Print the result
Finally, print your parsed and processed data in a convenient format, such as JSON or a custom UI.
const swapData = JSON.parse(JSON.stringify(swapMessage));
outputSwaps(swapData);
Usage Example: Parsing Swaps from Raw Transaction Data
Let’s say you’re building an application that relies on Solana’s liquidity pool for trading. You have a raw transaction log that contains multiple swaps between users, each with different token amounts and liquidity providers.
Here’s how you could parse these swaps using the steps above:
“`javascript
const JsonSolana = require(‘json-solana’);
const swapMessage = wait JsonSolana.