TIP-20 Tokens

TIP-20 tokens are Tempo's native token standard for stablecoins and payment tokens. They are designed for stablecoin payments, and are the foundation for many token-related functions on Tempo including transaction fees, payment lanes, DEX quote tokens, optimized routing for DEX liquidity, optional on-chain token logoURI metadata, implicit approvals for listed precompiles, and enshrined payment-channel reserve flows.

All TIP-20 tokens are created by interacting with the TIP-20 Factory contract, calling the createToken function. If you're issuing a stablecoin on Tempo, we strongly recommend using the TIP-20 standard. Learn more about the benefits, or follow the guide on issuance here.

Benefits & Features of TIP-20 Tokens

Below are some of the key benefits and features of TIP-20 tokens:

Payments

Exchange

Compliance & Controls

Pay Fees in Any Stablecoin

Any USD-denominated TIP-20 token can be used to pay transaction fees on Tempo.

The Fee AMM automatically converts your token to the validator's preferred fee token, eliminating the need for users to hold a separate gas token. This feature works natively: no additional infrastructure or integration required.

Full specification of this feature can be found in the Payment Lanes Specification.

Get Predictable Payment Fees

Tempo has dedicated payment lanes: reserved blockspace for payment TIP-20 transactions that other applications cannot consume. Even if there are extremely popular applications on the chain competing for blockspace, payroll runs or customer disbursements execute predictably. Learn more about the payments lane.

Role-Based Access Control (RBAC)

TIP-20 includes a built-in RBAC system that separates administrative responsibilities:

• ISSUER_ROLE: Grants permission to mint and burn tokens, enabling controlled token issuance
• PAUSE_ROLE / UNPAUSE_ROLE: Allows pausing and unpausing token transfers for emergency controls
• BURN_BLOCKED_ROLE: Permits burning tokens from blocked addresses (e.g., for compliance actions)

Roles can be granted, revoked, and delegated without custom contract changes. This enables issuers to separate operational roles (e.g., who can mint) from administrative roles (e.g., who can pause). Learn more in the TIP-20 specification.

Tempo Policy Registry (TIP-403)

TIP-20 tokens integrate with the Tempo Policy Registry (TIP-403) to enforce compliance policies. Each token can reference a policy that controls who can send and receive tokens:

• Whitelist policies: Only addresses in the whitelist can transfer tokens
• Blacklist policies: Addresses in the blacklist are blocked from transferring tokens

Policies can be shared across multiple tokens, enabling consistent compliance enforcement across your token ecosystem. See the TIP-403 specification for details.

Operational Controls

TIP-20 tokens can set supply caps, which allow you to set a maximum token supply to control issuance.

TIP-20 tokens also have pause/unpause commands, which provide emergency controls to halt transfers when needed.

Transfer Memos

Transfer memos enable you to attach 32-byte memos to transfers for payment references, invoice IDs, or transaction notes.

Currency Declaration

A TIP-20 token can declare a currency identifier that identifies the reference asset whose price the token is designed to track. This enables proper routing and pricing in Tempo's Stablecoin DEX. Currently, only USD-denominated stablecoins can be used to pay transaction fees on Tempo or traded on the StablecoinDEX.

General principle

The currency field identifies the reference asset that 1 unit of the token is designed to be worth — not what the token is called or what it is denominated in. Two tokens that track the same asset should have the same currency. When in doubt, consider that the purpose of this field is to determine what assets a token would trade against on a DEX designed for assets that trade within 2% of a 1:1 price.

Guidelines

1. Tokens that track an asset with an ISO 4217 code — use that code. This includes fiat currencies ("USD", "EUR") as well as commodities ("XAU" for gold, "XAG" for silver).
2. Tokens tracking a non-ISO asset at 1:1 — use the symbol of the reference asset. For example, a bridged WBTC that tracks BTC should use "BTC"; a bridged WETH that tracks ETH should use "ETH". Prefer "BTC" over "XBT". Use the symbol from the asset's origin chain when there is ambiguity across platforms.
3. Tokens denominated in but not pegged to a currency — do not use that currency's code. A tokenized gold product priced in USD should not use "USD", because 1 unit is not designed to be worth 1 USD.
4. Tokens with no reference asset — if a token does not track any external asset (e.g. a governance or utility token), use its own symbol as the currency.

Currency declaration examples

DEX Quote Tokens

TIP-20 tokens can serve as quote tokens in Tempo's decentralized exchange (DEX). When creating trading pairs on the Stablecoin DEX, TIP-20 tokens function as the quote currency against which other tokens are priced and traded.

This enables efficient stablecoin-to-stablecoin trading and provides optimized routing for liquidity. For example, a USDG TIP-20 token can be paired with other stablecoins, allowing traders to swap between different USD-denominated tokens with minimal slippage through concentrated liquidity pools.

By using TIP-20 tokens as quote tokens, the DEX benefits from the same payment-optimized features like deterministic addresses, currency identifiers, and compliance policies, ensuring secure and efficient exchange operations.

Additional Links