Docs/Start here/Start here

Tokenize a loyalty program in 3 steps.

A brand keeps its existing loyalty stack, signs exact Add to wallet and Add from wallet actions, and lets Loyfin make selected balances usable by customers, apps, and relayers.

Loyfin is a bidirectional tokenization layer for existing loyalty programs. Brands keep their CRM, points database, customer auth, earning rules, and support systems. Loyfin adds a points onramp and offramp: selected offchain balances can become customer-owned tokenized loyalty points, and tokenized balances can be burned so the brand can credit or restore offchain value.

01

Define the program

Map an existing loyalty program to a Loyalty Token identity, artwork, issuer wallet, expiry policy, and Add from wallet policy.

02

Sign tokenization actions

Your brand wallet signs exact Add to wallet or Add from wallet actions. Nobody can change the customer, amount, expiry, operation hash, or program.

03

Let them be submitted

Customers, apps, or relayers can submit Created actions with the exact native fee returned by requiredFee(). Completed events power token pages and activity views.

Add to walletView API

Tokenization layer#

Loyfin is not a replacement for the brand's points system.

A brand's primary loyalty balance still lives offchain in its own database. Loyfin is the onramp and offramp for the balances a brand chooses to tokenize: customers can add eligible points to a wallet, move them when allowed, and add them back from a wallet into the brand account.

  • Your existing app remains the place for customer authentication, earning rules, fraud checks, support, and fulfillment.
  • issue is Add to wallet: it tokenizes selected offchain value into a customer-owned balance.
  • redeem is Add from wallet: it burns tokenized value so the brand can credit or restore offchain value.
  • operationHash connects each Loyfin action to the brand's internal database row.

Brand checklist#

A non-technical team can gather these before an engineer touches the API.

Program name and short symbolProgram artworkBrand issuer walletFirst customer or seed walletReward amount rulesExpiry policyTransfer policyAdd from wallet policy

Choose your path#

Start with the task closest to what you are shipping.

Mainnet launchPlan sandbox testing, issuer/admin custody, receipts, customer copy, and Base launch steps.Add to walletTokenize selected existing offchain points or loyalty value into a customer-owned balance.Add from walletBurn tokenized loyalty value so your brand can credit or restore offchain value.Become a RelayerParticipate in the Loyalty Network by submitting Created actions for the relayer fee.

Admin controls#

Brand identity and admin control are separate.

The issuer is the immutable brand identity for a Loyalty Token and signs issue and redeem actions forever. The owner is the admin for mutable settings: metadata, royalty settings, and whether issuing, redeeming, or transferring is enabled.

  • transferOwnership moves admin control only; it does not change the issuer or brand identity.
  • renounceOwnership freezes owner-controlled settings, while issuer-signed issue and redeem actions can continue if those capabilities remain enabled.
  • Brands that need signer rotation should use a multisig as issuer and rotate signers inside that multisig.

Fees and brand revenue#

Revenue follows successful reward activity.

Issuance and redemption fees are supplied in native ETH by the submitting wallet, then split between the brand, relayer, and protocol. Relayers earn for submitting valid Created actions; brands earn when their loyalty program creates useful activity.

If a brand allows transfers and compatible marketplaces honor royalties, secondary activity can also route value back to the brand receiver. The intent is simple: loyalty should remain a retention tool while becoming a measurable distribution and revenue surface.

Glossary#

The words used across the guides.

Brand wallet

The wallet or approved contract wallet that signs reward actions.

Program

A brand loyalty program with its own identity, balances, metadata, and controls.

Reward action

A signed issuance or redemption prepared by the brand.

Nonce

A unique per-issuer value that prevents replaying the same signed action.

Expiry bucket

The reward bucket selected by expiresAt. Use 0 for no expiry.

Action deadline

The latest time a signed issuance or redemption can be submitted. Use 0 for no deadline.

Relayer

Any wallet that submits a valid Created action with the required native fee and receives the relayer portion in the same transaction.

Marketplace royalties

Program-level royalties that compatible marketplaces can honor on secondary activity.

Loyfin is built onBase