var img = document.createElement('img'); img.src = "https://terradocs.matomo.cloud//piwik.php?idsite=1&rec=1&url=https://docs.terra.money" + location.pathname; img.style = "border:0"; img.alt = "tracker"; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(img,s);
Skip to main content

Exchange migration guide

Use this guide to rebrand the original Terra chain as Terra Classic and integrate the new Terra chain. Please read this page entirely, as it contains important information. Check out the Exchange FAQ for answers to your frequently asked questions.

General info

Per governance proposal 1623, a new chain will be created and will assume the Terra name.

1. The original chain will still function and be re-branded as Terra Classic.

  • The original Cosmos chain will still run, with market swaps (mint/burn function) disabled.
  • All balances will remain as they are.
  • Luna will become Luna Classic (LUNC).
  • Terra stablecoins (UST, KRT, EUT, etc.) will be renamed Terra Classic stablecoins (USTC, KRTC, EUTC, etc.).

2. The new chain will be called Terra, and will assume all Terra branding assets.

  • The new chain is also a Cosmos chain, but will not have the treasury, oracle, or market modules of the original chain.
  • The new chain's native mining token will be Luna.
  • There will be no Terra stablecoins (UST, KRT, EUT, etc.) on the new chain.

Branding

The original chain will be branded Terra Classic. The new chain will assume the name Terra.

Naming convention:

Terra Classic

The original Terra chain will be rebranded as Terra Classic.

  • Official chain name: Terra Classic
  • All Luna currently on exchanges needs to be renamed Luna Classic (LUNC).
  • All Terra stablecoins will be rebranded as Terra Classic stablecoins. For example, TerraUSD(UST) will be renamed TerraClassicUSD(USTC) and TerraKRW(KRT) will become TerraClassicKRW(KRTC), etc.

Terra:

The new chain will assume the name Terra.

  • Official chain name: Terra
  • Luna (LUNA) will be the main staking asset of the chain.
  • The new chain does not support any Terra stablecoins (UST, KRT, etc.).
🔥Luna listing convention

It can be confusing to list the Luna coin as "Terra (LUNA)". To avoid unnecessary confusion, please stick to the following naming conventions for Luna:

For the Terra Classic chain, list as Luna Classic (LUNC)

For the new Terra chain, list as Luna (LUNA)

Logos and assets

Please update all logos and branding according to the following conventions:

Adobe Illustrator Terra Classic and new Terra chain logos.

Terra Classic:

The old chain will be rebranded using Terra Classic brand assets, including new logos for both LUNC and USTC. You will need to remove all current logos from the original chain and implement the Terra Classic brand assets on your exchange.

You can download these assets using the links below:

Terra:

The new chain will be branded with the following assets:

Mainnet launch schedule

  • 05/21 - The new Terra Core release is cut, network launch instructions made available for validators.
  • 05/25 - Essential app developer registration completed.
  • 05/27 - Genesis file created from final launch snapshot.
  • 05/27 - Network launch.

Snapshots and Airdrop

  • Pre-attack snapshot was taken at Terra Classic block 7544910 (7 May 2022 22:59:37 UTC+08:00).

  • Post-attack snapshot was taken at Terra Classic block 7790000 (27 May 2022 00:38:08 UTC+8:00).

Airdrop allocations

All airdrop allocations to UST and LUNA holders are based on the snapshots listed above. You may review the exchange-relevant allocations below. Note that these allocations exclude the Community pool allocation of 30% as it is irrelevant to exchanges. You may review the original token distribution text proposal on the Agora forum.

Note: Wallets owned by Terraform Labs are excluded from any airdrop allocations. Wallets owned by Terraform Labs will not recieve any token allocation at genesis.

Exchange Allocation Example

☢️Airdrop example

The following is an example token allocation using arbitrary numbers. None of the following balances are real. This example considers both pre- and post-attack snapshots and excludes wallets owned by TFL and the community pool.

Click here to see an airdrop allocation example.

None of the following balances are real.

The following is an example token allocation using made-up numbers. This example considers both pre- and post-attack snapshots and excludes wallets owned by TFL and the community pool.

Total LUNA Airdrop Supply: 1 Billion

Overall Assets in Terra Ecosystem

Assets in TerraSnapshotAmount
LUNApre-attack1B
aUSTpre-attack1B
LUNApost-attack1B
USTpost-attack1B

Exchange Assets

Asset Owned by ExchangeSnapshotAmount
LUNApre-attack10M
aUSTpre-attack100M
LUNApost-attack10M
USTpost-attack100M

Exchange User Assets

Asset Owned by Exchange UserSnapshotAmount
LUNApre-attack100
aUSTpre-attack10k
LUNApost-attack100
USTpost-attack10k

Airdrop Calculation for Exchange

Pre-attack LUNA holders 35% allocation (350 M)


_5
35% * Total LUNA Supply * Total LUNA owned by Exchange pre-attack / Total LUNA supply pre-attack
_5
_5
= 0.35 x 1B x 10M / 1B
_5
_5
= 3.5M LUNA

Pre-attack aUST holders: 10% allocation (100 M)


_5
10% x Total LUNA Supply x Total aUST owned by Exchange pre-attack / Total aUST supply pre-attack
_5
_5
= 0.1 x 1B x 100M / 1B
_5
_5
= 10M LUNA

Post-attack LUNA holders: 10% allocation (100 M)


_5
10% x Total LUNA Supply x Total LUNA owned by Exchange post-attack / Total LUNA supply post-attack
_5
_5
= 0.1 x 1B x 10M / 1B
_5
_5
= 1M LUNA

Post-attack UST holders: 15% allocation (150 M)


_5
15% x Total LUNA Supply x Total UST owned by Exchange post-attack / Total UST supply post-attack
_5
_5
= 0.15 x 1B x 100M / 1B
_5
_5
= 15M LUNA

Total Exchange Allocation


_3
= 3.5M + 10M + 1M + 15M
_3
_3
= 29.5M LUNA


Airdrop Calculation for User A

Pre-attack LUNA holders allocation: 3.5M


_5
(Total LUNA owned by User A pre-attack / Total LUNA owned by Exchange pre-attack) x Pre-attack LUNA holders' allocation
_5
_5
= (100 / 10M) x 3.5M
_5
_5
= 35 LUNA

Pre-attack aUST holders allocation: 10M


_5
(Total aUST owned by User A pre-attack / Total aUST owned by Exchange pre-attack) x Pre-attack aUST holders allocation
_5
_5
= (10k / 100M) x 10M
_5
_5
= 1000 LUNA

Post-attack LUNA holders allocation: 1M


_5
(Total LUNA owned by User A post-attack / Total LUNA owned by Exchange post-attack) x Post-attack LUNA holders' allocation
_5
_5
= (100 / 10M) x 1M
_5
_5
= 10 LUNA

Post-attack UST holders allocation: 15M


_5
(Total UST owned by User A post-attack / Total UST owned by Exchange post-attack) x Post-attack UST holders' allocation
_5
_5
= (10k / 100M) x 15M
_5
_5
= 1500 LUNA

Total Allocation to User A


_3
= 35 + 1000 + 10 + 1500
_3
_3
= 2545 LUNA

Use different seeds

To avoid user confusion and prevent the sending of funds to the wrong accounts, ensure that the Terra Classic and new Terra chain addresses have different seeds on your exchange. You may want to include a warning to users to make sure they are transacting on the correct chain and to the correct address.

Multisig guide

For questions regarding multisig wallets, refer to the multisig guide.

Base pairs

Exchanges:

  • LUNC/USDT
  • USTC/USDT

Dexes:

  • LUNC/ETH
  • LUNC/USDC

Initial supply and inflation

  • The initial supply of Luna at the genesis block of the new Terra chain will be 1 billion coins.
  • The mint module will release new coins every block as staking rewards at a default rate of around 7% p.a.

Terra Code and audit

Code

Audit

Networks

Terra Classic

  • Mainnet: columbus-5
  • Testnet: bombay-12

Terra

  • Mainnet: phoenix-1
  • Testnet: pisco-1

Integration

Terra Classic:

The current primary LCD (https://lcd.terra.dev) and FCD (https://fcd.terra.dev) will continue to support the Terra Classic chain. However to ensure long-term support, please use https://columbus-lcd.terra.dev for LCD and https://columbus-fcd.terra.dev for FCD.

Terra:

The previous LCD (https://lcd.terra.dev) and FCD (https://fcd.terra.dev) endpoints will not support the new chain. To support the new Terra chain (phoenix-1), LCD should be altered to https://phoenix-lcd.terra.dev and FCD should be altered to https://phoenix-fcd.terra.dev.