Track Transactions

Track the conversion of your transactions by adding a reference key to your API

With our SDKs, you have the ability to track the conversion of your transactions by adding a reference key to your API.

How it works

1. Create a unique reference (e.g. a random PublicKey)
2. Add the reference to the instruction
3. Add the reference to the POST response

Code example

For the full blink, checkout our donation blink example on GitHub.

export const POST = async (request: Request) => {
  try {
    const { account } = (await request.json()) as ActionPostRequest;
    const payer = new PublicKey(account);

    const ix = SystemProgram.transfer({
      fromPubkey: payer,
      toPubkey: new PublicKey(DONATION_DESTINATION_WALLET),
      lamports: DONATION_AMOUNT_SOL * LAMPORTS_PER_SOL,
    });

    // Step 1: Generate random PublicKey
    const reference = Keypair.generate().publicKey;

    // Step 2: Add key to transaction
    ix.keys.push({
      pubkey: reference,
      isSigner: false,
      isWritable: false,
    });

    const transaction = await prepareTransaction([ix], payer);

    // Step 3: Add to response using dialectExperimental
    const response: TransactionResponse & {
        dialectExperimental: { reference: string };
    } = {
      type: "transaction",
      transaction: Buffer.from(transaction.serialize()).toString("base64"),
      dialectExperimental: {
        reference: reference.toString(),
      },
    };

    return Response.json(response, { status: 200, headers });
  }
};