Builder Codes

Builder Codes (DBC) let integrators earn fees by routing flow through their application. The workflow has 3 steps: builder initializes revenue share → user creates escrow → user approves builder with max fee.

Setup

First, initialize the DriftClient for both the builder and user:


import { DriftClient } from "@drift-labs/sdk";
import { Connection, Keypair, PublicKey } from "@solana/web3.js";
 
// Initialize connection
const connection = new Connection("https://api.mainnet-beta.solana.com");
 
// Builder wallet (revenue share provider)
const builderWallet = Keypair.fromSecretKey(/* builder secret key */);
const builderAuthority = builderWallet.publicKey;
 
// User wallet (end user)
const userWallet = Keypair.fromSecretKey(/* user secret key */);
const takerAuthority = userWallet.publicKey;
 
// Builder client
const builderClient = new DriftClient({
  connection,
  wallet: builderWallet,
  env: "mainnet-beta"
});
await builderClient.subscribe();
 
// User client
const userClient = new DriftClient({
  connection,
  wallet: userWallet,
  env: "mainnet-beta"
});
await userClient.subscribe();

SDK Usage


await builderClient.initializeRevenueShare(builderAuthority);

Method DriftClient.initializeRevenueShareReference ↗

Parameters:

Name	Type	Default
`authority`	`PublicKey`
`txParams`	`TxParams`

Returns:

Promise<string>

User: Initialize Escrow


await userClient.initializeRevenueShareEscrow(takerAuthority, 16);

Method DriftClient.initializeRevenueShareEscrowReference ↗

Parameters:

Name	Type	Default
`authority`	`PublicKey`
`numOrders`	`number`
`txParams`	`TxParams`

Returns:

Promise<string>

User: Approve a Builder (Max Fee)


// max fee is expressed in tenths of a basis point (100 = 10 bps)
await userClient.changeApprovedBuilder(builderAuthority, 200, true);

Method DriftClient.changeApprovedBuilderReference ↗

Parameters:

Name	Type	Default
`builder`	`PublicKey` The public key of the builder to add or update.
`maxFeeTenthBps`	`number` The maximum fee tenth bps to set for the builder.
`add`	`boolean` Whether to add or update the builder. If the builder already exists, `add = true` will update the `maxFeeTenthBps`, otherwise it will add the builder. If `add = false`, the builder’s `maxFeeTenthBps` will be set to 0.
`txParams`	`TxParams` The transaction parameters to use for the transaction.

Returns:

Promise<string>

Builder Codes

Setup

SDK Usage

Builder: Initialize Revenue Share

User: Initialize Escrow

User: Approve a Builder (Max Fee)