Docs/Reference/Issue action

Issue action

A developer-focused reference for constructing and signing a tokenization issuance.

When to use#

Issue when a customer adds eligible existing offchain loyalty value to a wallet.

The first successful issuance can create the Loyalty Token. Later issuances tokenize additional offchain value into an existing Loyalty Token. expiresAt controls the reward bucket; deadline controls how long the signed action can be submitted. The brand backend should reserve or deduct the offchain points before publishing the signed issuance.

Fields#

Field	Type	Required	Meaning
`issuer`	address	yes	Brand wallet that signs the action.
`to`	address	session	Customer wallet receiving tokenized loyalty value. Not part of the issuer-signed terms; add it with the recipient signature or collect it on checkout.
`loyaltyId`	bytes32	yes	Brand-scoped program ID.
`amount`	uint256 string	yes	Amount of offchain loyalty value to tokenize. Must be greater than zero.
`expiresAt`	uint256 string	yes	Use 0 for no expiry, or a Unix timestamp for an expiring bucket.
`deadline`	uint256 string	yes	Last Unix timestamp when the issuance can be submitted. Use 0 for no execution deadline.
`nonce`	bytes32	yes	Unique per issuer. Replays are rejected.
`chainId`	uint256 string	yes	Expected chain ID. Loyfin uses Base 8453.
`verifyingContract`	address	yes	The Loyfin factory that will execute the action.
`operationHash`	bytes32	optional	Brand reference hash for correlating this action with an internal database row. Defaults to zero bytes when omitted.
`metadata`	Metadata	yes	Program metadata. Required for issuance because the first issuance can create the program.
`data`	hex bytes	optional	Brand-defined data. Defaults to 0x. Max 2048 bytes.

Example#

IssuanceActionjson

{
  "issuance": {
    "issuer": "0x1111111111111111111111111111111111111111",
    "loyaltyId": "0x4242424242424242424242424242424242424242424242424242424242424242",
    "amount": "1000",
    "expiresAt": "0",
    "deadline": "0",
    "nonce": "0x7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a",
    "chainId": "8453",
    "verifyingContract": "0x3333333333333333333333333333333333333333",
    "operationHash": "0x9999999999999999999999999999999999999999999999999999999999999999",
    "metadata": {
      "loyaltyId": "0x4242424242424242424242424242424242424242424242424242424242424242",
      "name": "Bloom Coffee Rewards",
      "symbol": "BLOOM",
      "media": "ipfs://bafy.../bloom.png",
      "description": "Rewards for Bloom Coffee customers.",
      "contractURI": "",
      "tokenURI": ""
    },
    "data": "0x"
  },
  "signature": "0xababababababababababababababababababababababababababababababababababababababababababababababababababababababababababababababababab"
}