Docs/Reference/Public architecture
Public architecture
A high-level map of the public Loyfin contracts and how they work together.
Contract map#
The public architecture separates action verification, program balances, and event indexing.
| Contract | Role | Public surface |
|---|---|---|
| Loyfin | Factory, signature verifier, USDC fee splitter, and issuance/redemption entry point. | issue, redeem, feeToken, requiredFee, predictLoyaltyAddress. |
| Loyalty | Per-program reward balances, metadata, royalties, expiry checks, and brand controls. New programs are deterministic clones of the verified implementation. | uri, contractURI, executeAdminOperation, withdrawRoyalties, pending royalty balances. |
| EventEmitter | Public lifecycle event stream for programs, reward actions, transfers, and metadata updates. | Program, issuance, redemption, transfer, metadata, and admin events. |
Public guarantees#
- Reward actions are bound to a chain and verifying contract.
- Nonces are scoped to the issuer and consumed only after validation passes.
- Contract-wallet and regular-wallet issuer signatures are both supported.
- Program addresses are deterministic for an issuer and program ID pair.