• SettleMintSettleMint
    • Introduction
    • Market pain points
    • Lifecycle platform approach
    • Platform capabilities
    • Use cases
    • Compliance & security
    • Glossary
    • Core component overview
    • Frontend layer
    • API layer
    • Blockchain layer
    • Data layer
    • Deployment layer
    • System architecture
    • Smart contracts
      • SMART protocol (ERC-3643)
      • Asset contracts
      • Identity & compliance
      • Addon modules
      • Factory patterns & upgradeability
    • Application layer
    • Data & indexing
    • Integration & operations
    • Performance
    • Quality
    • Getting started
    • Asset issuance
    • Platform operations
    • Troubleshooting
    • Development environment
    • Code structure
    • Smart contracts
    • API integration
    • Data model
    • Deployment & ops
    • Testing and QA
    • Developer FAQ
Back to the application
  1. Documentation
  2. Architecture
  3. Smart contracts

SMART protocol - Regulatory token foundation (ERC-3643)

The SMART (SettleMint Adaptable Regulated Token) Protocol is an advanced, modular smart contract framework designed for creating regulatory-compliant security tokens and tokenizing real-world assets. Built as a derivation of ERC-3643 with ERC-20 foundations using OpenZeppelin, it provides a complete infrastructure for regulated financial instruments.

What is SMART protocol?

SMART Protocol is the foundational protocol specification—think of it like HTTP or TCP/IP for tokenization. It defines the token standards, compliance modules, and identity management interfaces that enable regulatory-compliant asset tokenization.

ATK (Asset Tokenization Kit) is SettleMint's production implementation of the SMART Protocol with specific assumptions and optimizations for asset tokenization. ATK is one possible implementation of SMART, designed with particular choices around access control, proxy patterns, and infrastructure management.

Key capabilities

SMART Protocol enables:

  • Security token issuance - ERC-3643 derived and ERC-20 compliant tokens for regulated financial instruments
  • Asset tokenization - Bonds, equity shares, deposits, funds, and stablecoins
  • Advanced identity management - On-chain KYC/AML compliance with ERC-734/735 identities and logical expressions for complex verification rules
  • Regulatory compliance - Modular compliance rules for different jurisdictions
  • DeFi integration - Full ERC-20 compatibility for ecosystem integration

Protocol highlights

  • ERC20 compliance - Fully implements ERC20 and ERC20Upgradeable, ensuring compatibility with Ethereum tooling and DeFi ecosystems
  • Externally modular architecture - SMART uses composable extensions (e.g., SMARTBurnable, SMARTCollateral) in a plug-and-play model
  • Token-configurable compliance - SMART tokens can be configured to use specific modular rules and parameters without needing custom compliance contracts
  • Token-agnostic identity verification - Identity registry remains reusable across tokens and use cases—tokens dynamically pass required claim topics into the verification logic
  • Authorization agnostic - SMART is compatible with any authorization logic via hooks (e.g., OpenZeppelin AccessControl)
  • ERC-2771 meta-transaction support - Compatible with trusted forwarders for gasless transactions and improved UX
  • Upgradeable and non-upgradeable support - SMART supports both upgradeable (proxy-based) and fixed (non-upgradeable) token deployments
  • KYC is optional - SMART supports both regulated and unregulated assets. Tokens can opt into identity verification (KYC/AML) or operate permissionlessly
  • Built-in ERC-165 interface detection - Every SMART token implements ERC-165, allowing external systems to query which capabilities a token supports
  • Two-step identity recovery flow - Secure recovery with identity registry manager handling recovery followed by user token reclaim

Architecture overview

SMART Protocol consists of three main layers that work together to provide comprehensive compliance and functionality:

Layer 1: token layer

Smart contract tokens with configurable compliance settings. Each token can be configured with specific compliance requirements and modular extensions.

Layer 2: compliance layer

Orchestration engine with modular rules. The compliance contract acts as an orchestration engine, executing different modules based on each token's configuration.

Layer 3: identity layer

On-chain identity management and verification using ERC-734/735 standards with OnchainID integration.

Rendering chart...

The compliance contract acts as an orchestration engine, executing different modules based on each token's configuration. This allows multiple tokens to share the same compliance infrastructure while having completely different compliance requirements.

ERC standards implemented

SMART Protocol implements multiple Ethereum standards to provide comprehensive functionality:

ERC-20: fungible token standard

  • Full compatibility - Complete ERC-20 and ERC-20 Metadata implementation
  • DeFi ready - Compatible with DEXs, lending protocols, and wallets
  • Extensions - Transfer hooks, pausable transfers, burnable tokens
  • Upgradeability - UUPS proxy pattern support for contract upgrades

ERC-3643: T-REX security token standard

  • Regulatory compliance - Built-in KYC/AML and jurisdiction-specific rules
  • Transfer restrictions - Conditional transfers based on investor eligibility
  • Identity verification - Integration with trusted identity providers
  • Compliance modules - Pluggable rules for different regulatory requirements
  • Components:
    • Identity Registry for investor management
    • Compliance validation engine
    • Trusted issuers registry for claim verification
    • Claim topics for required documentation types

ERC-734: key holder standard

  • On-chain identity - Self-sovereign identity management
  • Multi-purpose keys - Management, action, claim signing, and encryption keys
  • Execution framework - Multi-signature execution with key-based approval
  • Key management - Add, remove, and replace keys with proper authorization

ERC-735: claim holder standard

  • Verifiable claims - On-chain attestations about identity attributes
  • Trusted issuers - Claims validated by authorized third parties
  • Topic-based organization - Claims categorized by topics (KYC, nationality, etc.)
  • Revocation support - Ability to revoke outdated or invalid claims

ERC-2771: meta-transaction standard

  • Gasless transactions - Users can transact without holding ETH
  • Improved UX - Third-party relayers can sponsor transaction costs
  • Trusted forwarders - Secure delegation of transaction execution
  • Native integration - Built into all SMART Protocol contracts

Token extensions

SMART Protocol provides modular extensions that add specific functionality through well-defined interfaces:

Rendering chart...

Administrative extensions

Burnable extension - Allows designated administrators to burn tokens from any account for regulatory compliance, token destruction, and supply management.

Pausable extension - Emergency pause functionality for all token transfers during security incidents, regulatory orders, or system maintenance.

Custodian extension - Freeze addresses and force transfers for compliance with legal orders, sanctions compliance, and dispute resolution.

User-facing extensions

Redeemable extension - Users can burn their own tokens (self-redemption) for token buybacks, voluntary redemptions, and exit mechanisms.

Yield extension - Distribute dividends or yield to token holders for dividend payments, profit sharing, and interest distribution.

Data and analytics extensions

Historical balances extension - Query historical balance data at specific blocks for snapshot governance, historical reporting, and audit trails.

Supply management extensions

Capped extension - Enforce maximum token supply limits for fixed supply tokens, inflation control, and tokenomics.

Collateral extension - Require collateral backing for token issuance in asset-backed tokens, stablecoins, and secured instruments.

Compliance modules

The compliance layer provides a flexible system of modular rules that can be configured per-token. See the compliance modules documentation for detailed information on:

  • Country-based restrictions (allow/block lists)
  • Identity-based restrictions (allow/block lists, verification)
  • Transfer and supply limits (caps, investor counts)
  • Time-based restrictions (lock-up periods)

Identity and OnchainID integration

SMART Protocol integrates with OnchainID for decentralized identity management:

Identity registry

Central registry mapping wallet addresses to identity contracts with features including:

  • Identity contract address storage for each wallet
  • Identity verification status management
  • Wallet recovery mechanisms
  • Identity transfer support

Trusted issuers registry

Manages trusted entities that can issue identity claims:

  • Trusted issuer address storage
  • Topic-to-issuer mapping for attestation authority
  • Support for multiple issuers per topic

Topic scheme registry

Defines the claim topics available for compliance:

  • Valid claim topics listing globally
  • Topic-to-verification requirement mapping
  • Shared registry across all tokens

ERC-3643 vs SMART protocol

AspectERC-3643SMART ProtocolNotes
ERC20 compatibilityPartial / constrainedFully ERC20 and ERC20Upgradeable compliantEnsures full compatibility with DeFi and wallets
UpgradeabilityCentralized via Implementation AuthoritySupported via UUPS; system-agnosticSMART provides the option but doesn't enforce a pattern
ModularityPartially modularModular by default (OpenZeppelin extension pattern)SMARTBurnable, SMARTRedeemable, SMARTPausable, etc.
Identity / compliance contract reuseTypically one-off per tokenReusable across all tokensEfficient architecture, simplifies ecosystem-wide compliance
Compliance modelSingle compliance contract, may be modularFully modular compliance rules; also supports monolithic if desiredFlexible based on project use case
Compliance configurationNo token-specific configurationRule-specific parameters configurable per tokenEnables rule reuse with different behaviors
Claim topics storageExternal Claim Topics RegistryDefined and stored per tokenImproves clarity and portability of tokens
Identity verificationSimple AND-only logic for required topicsAdvanced logical expressions with AND/OR/NOTEnables complex rules like "CONTRACT OR (KYC AND AML)"
KYC optionalImplied as requiredOptional per token, part of the modular complianceAllows issuing cryptocurrencies or unrestricted tokens
AuthorizationAgent-based role systemAccess-control agnosticSupports OpenZeppelin AccessControl, custom roles, or hybrid models
Burning logicOwner-initiated only (burn(user, amount))SMARTBurnable (admin burn) + SMARTRedeemable (self-burn)Enables more flexible redemption logic (e.g. for bonds)
Meta-transaction supportNot specifiedFully ERC-2771 compatible (trusted forwarders)Enables gasless transactions and better UX
ImmutabilityName and symbol mutableImmutable following ERC20 standardAvoids confusion and aligns with token standards
Interface detection (ERC-165)Not part of standardBuilt-in ERC-165 supportEnables introspection: e.g., query if token supports Burnable, etc.
Token recovery flowCustodian-based recoveryTwo-step: identity registry manager handles recovery + user reclaims tokensSMART separates identity and asset recovery for better security and UX

Complete system flow

Here's how all three layers work together during a token transfer:

Rendering chart...

Transfer validation steps

  1. Identity verification - Verify receiver has valid identity contract and required claims. Sender verification is assumed (already owns tokens, so was previously verified)

  2. Compliance validation - Compliance engine runs through modules configured on the specific token. Each configured module performs its specific checks. All configured modules must approve for transfer to proceed

  3. Balance updates - Execute standard ERC-20 transfer, update compliance module states, emit transfer events

Common use cases

Use CaseAsset TypeKey ExtensionsCompliance Requirements
Corporate bondsSMARTBondYield, Redeemable, PausableAccredited investor, KYC
Real estate sharesSMARTEquityCustodian, Historical BalancesKYC, Jurisdiction restrictions
Tokenized depositsSMARTDepositYield, CappedBank verification, deposit insurance
Investment fundsSMARTFundYield, Custodian, BurnableFund prospectus, investor suitability
Regulatory stablecoinsSMARTStableCoinPausable, CustodianMoney transmitter license

Conclusion

SMART Protocol rethinks the ERC-3643 architecture by moving modularity, configuration, and verification closer to the token layer. This creates a more flexible, reusable, and standards-compliant framework for compliant token issuance in dynamic regulatory environments. By decoupling identity and compliance logic from any single token, SMART improves scalability and opens doors for broader cross-application identity use.

System architecture
Asset contracts
llms-full.txt

On this page

What is SMART protocol?Key capabilitiesProtocol highlightsArchitecture overviewLayer 1: token layerLayer 2: compliance layerLayer 3: identity layerERC standards implementedERC-20: fungible token standardERC-3643: T-REX security token standardERC-734: key holder standardERC-735: claim holder standardERC-2771: meta-transaction standardToken extensionsAdministrative extensionsUser-facing extensionsData and analytics extensionsSupply management extensionsCompliance modulesIdentity and OnchainID integrationIdentity registryTrusted issuers registryTopic scheme registryERC-3643 vs SMART protocolComplete system flowTransfer validation stepsCommon use casesConclusion