Guide: The Loyalty Rewards Engine

// Registers a new business. The transaction sender becomes the owner
// outright -- there's no "owner" field in the payload, so you cannot
// register a business on someone else's behalf.
const createBusinessTx = {
  type: 0x42, // TxTypeCreateLoyaltyBusiness
  nonce: ownerAccount.nonce,
  data: JSON.stringify({
    name: "Joe's Coffee"
  }),
  // ...gas, etc.
};
const signedTx = await ownerWallet.signTransaction(createBusinessTx);
await rpc.call('nhb_sendTransaction', [signedTx]);

// Transactions don't return a synchronous result, so there's no businessId
// handed back here. Look up the ID the chain just assigned you instead:
const businesses = await rpc.call('loyalty_listBusinesses', [
  { owner: ownerAddress }
]);
const businessId = businesses[0].id;

// Points the business at the wallet that will fund its programs' rewards.
const setPaymasterTx = {
  type: 0x43, // TxTypeLoyaltySetPaymaster
  nonce: ownerAccount.nonce,
  data: JSON.stringify({
    businessId, // 0x... (64 hex chars, from loyalty_listBusinesses)
    paymaster: paymasterAddress // nhb1... -- omit/empty to clear it
  }),
  // ...gas, etc.
};
const signedTx = await ownerWallet.signTransaction(setPaymasterTx);
await rpc.call('nhb_sendTransaction', [signedTx]);

// Funding that wallet is just an ordinary NHB/ZNHB transfer to its
// address -- nothing loyalty-specific about it.

// Marks an address as a merchant of the business. Purchases customers
// send to a registered merchant address become eligible for that
// business's reward programs.
const addMerchantTx = {
  type: 0x44, // TxTypeLoyaltyAddMerchant
  nonce: ownerAccount.nonce,
  data: JSON.stringify({ businessId, merchant: merchantAddress }),
  // ...gas, etc.
};
const signedTx = await ownerWallet.signTransaction(addMerchantTx);
await rpc.call('nhb_sendTransaction', [signedTx]);

// To unassign it later, sign the same payload as TxTypeLoyaltyRemoveMerchant (0x45).

// Generate your own program ID -- the chain doesn't assign one.
const programId = '0x' + crypto.randomBytes(32).toString('hex');

const createProgramTx = {
  type: 0x46, // TxTypeCreateLoyaltyProgram
  // Must be signed by a wallet that is ALREADY a registered merchant of
  // this business (added via TxTypeLoyaltyAddMerchant above) -- a
  // business's own owner is not automatically its own merchant.
  nonce: merchantAccount.nonce,
  data: JSON.stringify({
    businessId,
    id: programId,
    pool: poolAddress,       // nhb1... rewards are tracked/paid against
    tokenSymbol: 'NHB',
    accrualBps: 500,         // 5% cashback (percentage mode is the default)
    dailyCapProgram: '1000000000000000000000' // required -- see note below
  }),
  // ...gas, etc.
};
const signedTx = await merchantWallet.signTransaction(createProgramTx);
await rpc.call('nhb_sendTransaction', [signedTx]);

// UpdateProgram is a full replace, not a patch -- resend every field
// you want to keep, not just the one you're changing.
const updateProgramTx = {
  type: 0x47, // TxTypeUpdateLoyaltyProgram
  nonce: programOwnerAccount.nonce,
  data: JSON.stringify({
    id: programId,           // the program's id/owner can never change
    pool: poolAddress,
    tokenSymbol: 'NHB',
    accrualBps: 750,         // raised from 5% to 7.5%
    dailyCapProgram: '1000000000000000000000' // must be resent even though it's unchanged
  }),
  // ...gas, etc.
};
const signedTx = await programOwnerWallet.signTransaction(updateProgramTx);
await rpc.call('nhb_sendTransaction', [signedTx]);

// Pausing/resuming is idempotent -- pausing an already-paused program
// is a harmless no-op, not an error.
const pauseProgramTx = {
  type: 0x48, // TxTypePauseLoyaltyProgram
  nonce: programOwnerAccount.nonce,
  data: JSON.stringify({ id: programId }),
  // ...gas, etc.
};
const signedTx = await programOwnerWallet.signTransaction(pauseProgramTx);
await rpc.call('nhb_sendTransaction', [signedTx]);

// To resume, sign the same { id } payload as TxTypeResumeLoyaltyProgram (0x49).