Partner authority

A partner authority lets an approved partner build and send Trench trades without using the Partner API. The same partner authority can sign trades for many user wallets. It is not tied to one user.

Set up

Create a new Solana keypair on your backend.
Send only the public key to Trench.
Trench adds the public key to the onchain Config whitelist.
Wait for Trench to confirm that the public key is ready.

Use the active Trench program ID that Trench gives you.

Build a trade

Use the Trench IDL to build the existing trade instructions.

Instruction	User signer	Partner signer
`buy`	`buyer`	`authority`
`buy_exact_out`	`buyer`	`authority`
`sell`	`seller`	`authority`

Set authority to your approved partner public key. Use one address from Config.fee_addresses for protocol_fee_recipient. Both the user signer and the authority signer must sign the same transaction.

Referral accounts

Every trade must include the writable trader_referral account meta from the IDL. Derive it with the user signer. Use buyer for buys and seller for sells.

const [traderReferral] = PublicKey.findProgramAddressSync(
  [Buffer.from("trader_referral"), userPublicKey.toBuffer()],
  trenchProgramId,
);

Do not initialize this PDA. Include its address as trader_referral and do not add any remaining referral accounts.

Claim cashback

Build claim_trader_cashback from the IDL. Only the trader is a signer. This instruction does not use authority.

Get Started

Principles

How-to Guides

Resources

Partner authority

Set up

Build a trade

Referral accounts

Claim cashback

​Set up

​Build a trade

​Referral accounts

​Claim cashback

Set up

Build a trade

Referral accounts

Claim cashback