Docs/Reference/Brands

Brands

How brands define program identity, sign reward actions, configure controls, and receive revenue share.

Responsibilities#

Brands define the promise behind every reward.

  • Choose the program identity and artwork customers will recognize.
  • Sign issuances and redemptions from the brand issuer wallet or approved contract wallet.
  • Keep offchain fulfillment aligned with signed redemption terms.
  • Publish clear expiry, transfer, and marketplace policies.

Controls#

Brands can update metadata URIs, configure royalty settings, change the royalty receiver, and set issuable, redeemable, and transferable through owner-signed admin actions. Signed admin actions include the current adminEpoch, which changes whenever admin ownership transfers or is renounced. Metadata URI overrides are capped at 512 UTF-8 bytes and opaque admin data is capped at 2048 bytes. The issuer signs issue and redeem forever. transferOwnership changes admin control only; it does not transfer brand identity. Renouncing ownership freezes owner-controlled settings.

Admin action shapejson
{
  "owner": "0x1111111111111111111111111111111111111111",
  "adminEpoch": "0",
  "loyaltyId": "0x4242424242424242424242424242424242424242424242424242424242424242",
  "nonce": "0x7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a",
  "chainId": "8453",
  "verifyingContract": "0x4444444444444444444444444444444444444444",
  "deadline": "1790965800",
  "action": "SET_TRANSFERABLE",
  "tokenId": "0",
  "uri": "",
  "account": "0x0000000000000000000000000000000000000000",
  "royaltyBps": "0",
  "flag": false,
  "data": "0x"
}