# Word List Preferred terms for Tempo products, with the words to avoid in their place. ## Overview Use one term for one concept in every Tempo product. These terms are the ones [tempo.xyz](https://tempo.xyz), the [developer docs](https://tempo.xyz/developers), Tempo Wallet, and the Tempo token list already use. Write a term in lowercase unless the table shows a capital or it starts a sentence or label. Where the sources use different words for the same thing, [Where the Sources Differ](#where-the-sources-differ) records the choice. If you need a term that isn't listed, use the word your readers already use, and suggest it with Report issue on this page. ## Actions | Use | Avoid | Notes | | ----------------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | send | transfer (for a payment) | The docs title their guides Send a payment, and Tempo Wallet's action is Send. Transfer fits the token operation and moves between networks. | | add funds | top up, load | The docs and Tempo Wallet both say Add funds. Use deposit for a specific method, such as a deposit address. | | swap | trade, exchange (as a verb) | A swap turns one stablecoin into another. Tempo Wallet and the docs both use it, and the Stablecoin DEX runs it. | | approve | sign (on consumer screens) | People approve a payment with a passkey. Keep sign for developer surfaces, where signing is the operation. | | sign in, sign out | log in, log out, login | The docs say sign in. Write sign-in, with a hyphen, as a noun or adjective, as in sign-in method. | | create account | sign up, register | Pair it with Sign in on the same screen. | | revoke | delete, remove (for keys) | Revoke an API key or access key. Delete data, such as a webhook. | | copy | copy to clipboard | Copy address on the button, and Copied after it succeeds, as `CopyButton` announces. | | sponsor | pay for, cover (for fees) | A fee payer sponsors fees. When fees are sponsored, say so where the fee would appear. | ## Money and Accounts | Use | Avoid | Notes | | --------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | account | wallet (for what holds funds) | The docs define a Tempo account as an address that holds stablecoins, with its rules stored onchain. | | wallet | Wallet (mid-sentence), Tempo wallet | The app or service that holds keys and approves payments. Capitalize it only in the product name, Tempo Wallet. | | address | public key, wallet ID, account number | The 0x identifier of an account, as in Wallet address, Deposit address, and Copy address. | | balance | holdings, funds (as a label) | Balance and Total balance. Funds is fine in sentences, such as Add funds. | | stablecoin | coin, stable, crypto (for a stablecoin) | One word, lowercase. | | token | coin | Any TIP-20 asset. Coin appears only inside stablecoin. | | pathUSD, USDC.e | PATHUSD, PathUSD (as a symbol) | Write each symbol exactly as the token list spells it. Its display name, such as PathUSD, suits a token picker or detail view. | | payment | transaction (for money sent to someone) | The docs' main word for moving money. Transaction covers any onchain operation, including swaps. | | memo | note, message, private note | Tempo Wallet's field label. A memo is stored with the transfer onchain, so don't present it as private. | | network fee | gas, gas fee | The docs' usual term. Tempo charges fees in USD stablecoins and has no native gas token, so show the fee as an amount. | | fee token | gas token | The stablecoin that pays a transaction's network fee. | | fee payer | paymaster | The account that pays network fees on someone else's behalf. | ## Network | Use | Avoid | Notes | | ------------------ | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | network | chain, blockchain (on product screens) | The docs say the Tempo network, and Tempo Wallet says Network. Chain ID stays as a technical label. | | mainnet, testnet | main net, test-net | Lowercase in sentences. Capitalize as part of a network name, such as Tempo Mainnet or Tempo Testnet (Moderato). | | onchain | on-chain, on chain | One word, lowercase, as in onchain activity. | | Tempo Explorer | block explorer, scanner | The product name. Link text names the destination, such as View in Tempo Explorer. | | Tempo Transactions | Tempo transactions | Capitalize it only for the native transaction type. A lowercase transaction means any transaction. | ## Security and Access | Use | Avoid | Notes | | ----------- | ------------------------------ | ------------------------------------------------------------------------------------------------- | | passkey | biometric login, Face ID login | Lowercase in sentences. Name Face ID, Touch ID, or Windows Hello only in the prompt that uses it. | | access key | session key, delegated key | A key that lets an app or agent pay from an account within a spending limit and an expiry. | | API key | api key, API token | Token means an asset, so don't use it for credentials. | | private key | secret key | Show it only with `SecretValue`, masked until revealed. | | webhook | web hook, callback URL | One word, lowercase. | ## Status | Use | Avoid | Notes | | -------------- | ------------------------------ | ------------------------------------------------- | | Pending | Processing, Waiting, In flight | The network hasn't confirmed the transaction yet. | | Confirmed | Complete, Done, Success | The network has confirmed the transaction. | | Failed | Error, Unsuccessful | Pair it with what to do next. | | Sent, Received | Outgoing, Incoming | Activity labels for confirmed payments. | ## Words to Avoid | Avoid | Instead | | ----------------------- | -------------------------------------------------------------------------------- | | Oops, Uh-oh, Whoops | State what happened. | | Please | Leave it out of labels and instructions. | | Successfully | Leave it out, as in Payment sent. | | Click, tap | Name the action, or use select when you must refer to the input. | | Invalid (on its own) | Say what a valid value looks like, such as Enter an address that starts with 0x. | | Instant, free, seamless | Give the fact, such as the fee amount or who pays it. | | Nonce, calldata, EOA | Leave protocol terms off consumer screens. | ## Where the Sources Differ | Topic | What the sources do | Product screens | | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | | Send or transfer | The docs say send a payment in guides, but Routes and some page summaries say transfer funds. | Send for payments. Transfer for the token operation and cross-network moves. | | Network or blockchain | tempo.xyz calls Tempo a blockchain. The docs and Tempo Wallet say network. | Network. | | Network names | The docs write Tempo mainnet and Moderato testnet in sentences. The network table and Tempo Wallet write Tempo Mainnet and Tempo Testnet (Moderato). | Capitalized names as labels, lowercase in sentences. | | Fee | The docs mostly say network fee, and sometimes transaction fee. | Network fee. | | Memo | The docs title the topic payment references and call the field a memo. Tempo Wallet labels it Memo. | Memo. | | Sign out | Tempo Wallet labels its sign-out action Log out. | Sign out, to pair with Sign in. | | Wallet or account | The docs keep account for what holds funds, but one guide speaks of giving an agent a wallet. | Account for what holds funds. | | Token names | The docs write some test tokens by display name, such as AlphaUSD, where the token list symbol is alphaUSD. | The token list symbol, after an amount and in sentences. | | TIP-20 tokens | One docs heading capitalizes Tokens, and the body text doesn't. | TIP-20 token. | ## Related * [Voice](/docs/foundations/content/voice) for why these terms favor plain words * [Writing Style](/docs/foundations/content/writing-style) for capitalization and labels * [Grammar and Mechanics](/docs/foundations/content/grammar-and-mechanics) for amounts and symbols * [Tempo Wallet](/docs/products/tempo-wallet) for wallet screens