Skip to main content

Glossary

Canonical definitions for TeleSwap terms. Other pages link here; use these exact terms for consistency (and so AI assistants resolve them correctly).

TeleBTC

The 1:1, collateral-backed representation of BTC minted on destination chains. See TeleBTC.

Wrap

Bridging into a destination chain: BTC → TeleBTC (often → a target token). See Protocol overview.

Unwrap

Bridging back to Bitcoin: TeleBTC (or a target token) → native BTC.

wrapAndSwap / swapAndUnwrap

The two SDK/API flows: wrapAndSwap (BTC → ERC-20/Jetton) and swapAndUnwrap (ERC-20/Jetton → BTC). See the SDK.

Light-client bridge

The TeleSwap Bitcoin light client that verifies Bitcoin transactions on the destination chain via SPV proofs. See Light client bridge.

Relayer

Submits Bitcoin block headers to the light-client bridge. See Relayers.

Teleporter

Relays a user's Bitcoin→EVM/TON bridge request with an inclusion proof and fronts destination-chain gas. See Teleporters.

Locker

A decentralized custodian that holds BTC, backs TeleBTC with collateral, and processes unwraps. See Lockers.

Filler

Provides faster settlement for swaps — delivering tokens after one Bitcoin confirmation instead of the two a standard swap waits for — and is repaid once Bitcoin reaches the standard confirmations. See Fillers.

Fast swap

A Bitcoin → other-chain swap that settles in ~10 minutes (one Bitcoin confirmation) via a Filler, versus ~20 minutes (two confirmations) for a standard swap. See Fast Swaps.

Base network / Cross-chain network

A developer-level routing distinction used by the SDK: base networks (Polygon, BNB, TON) connect to Bitcoin directly, while cross-chain networks (Ethereum, Optimism, Arbitrum, Base, Unichain) reach it via a base network. It only affects which contract integrators call — users just pick a destination chain. See Supported assets & chains.

Collateral ratio / Health factor

Parameters that keep a Locker's collateral worth more than the BTC it holds; breaching them triggers liquidation.

Slashing

Seizing a Locker's collateral to penalize theft or a missed unwrap, compensating users.

TST

The native token of TeleSwap, staked to earn a share of protocol fees in BTC. See Tokenomics.

Third-party ID

An integrator identifier (thirdPartyId) that attributes requests to an integrator so they earn a share of fees. See Installation & setup.