Skip to main content


import "@thirdweb-dev/contracts/extension/PrimarySale.sol";

PrimarySale lets you set a recipient for any sale value you intend to collect in your smart contract.


The PrimarySale extension is an abstract contract, and expects you to implement the following functions by yourself:

_canSetPrimarySaleRecipientinternal view virtualboolRuns on every attempt to set a new primary sale recipient. Returns whether this info can be set in the given execution context.

This is an example smart contract demonstrating how to inherit from this extension and override the functions to add (optional) custom functionality.

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "@thirdweb-dev/contracts/extension/PrimarySale.sol";

contract MyContract is PrimarySale {
* We store the contract deployer's address only for the purposes of the example
* in the code comment below.
* Doing this is not necessary to use the `PrimarySale` extension.
address public deployer;

constructor() {
deployer = msg.sender;

* This function returns who is authorized to set primary sale recipient address for your contract.
* As an EXAMPLE, we'll only allow the contract deployer to set the primary sale recipient address.
* You MUST complete the body of this function to use the `PrimarySale` extension.
function _canSetPrimarySaleRecipient()
returns (bool)
return msg.sender == deployer;

SDK Usage

By adding this extension to a smart contract, the following features, hooks and functions are unlocked in the SDK:

Base Contracts Implementing This Extension

Full API Reference

function primarySaleRecipient() public view returns (address);
  • Returns the primary sale recipient address stored in the contract.
  • Set this value using the setPrimarySaleRecipient function.
function setPrimarySaleRecipient(address saleRecipient) external;
  • Lets an authorized wallet set the primary sale recipient address.
  • Parameter saleRecipient: The address to set as the new primary sale recipient.
  • The _canSetPrimarySaleRecipient function is run on every call to this function. If the return value of _canSetPrimarySaleRecipient is false, the setPrimarySaleRecipient call will revert.
function _setupPrimarySaleRecipient(address saleRecipient) internal;
  • Sets the primary sale recipient.
  • Parameter saleRecipient: The address to set as the new primary sale recipient.
  • The _canSetPrimarySaleRecipient function is not run on a call to this function.
function _canSetPrimarySaleRecipient() internal view virtual returns (bool);
  • Runs on every setPrimarySaleRecipient function call.
  • Returns whether a new primary sale recipient can be set in the given execution context.
  • For example, this function can check whether the wallet calling setPrimarySaleRecipient is the contract owner, and enforce that only the current owner should be able to successfully call setPrimarySaleRecipient.