This repository contains the smart contracts for TrueUSD and TrueGBP, as well as the contracts that support them. This section contains a high-level overview of the contracts. For specifics, see the relevant .sol files.
We use DELEGATECALL proxies so that we can upgrade our contracts without changing their addresses.
We always seek a security audit before upgrading, in order to mitigate risk.
All of the tokens use the storage laid out in ProxyStorage.sol. Solidity storage variables for tokens should not be declared in any other file. This mitigates the risk of the storage layout shifting between upgrades.
These contracts are inspired by and roughly equivalent to the corresponding ERC20 token contracts from OpenZeppelin. Work is separated into internal functions that can be overridden for storage migrations.
TokenController is the owner for each of our tokens. Power is separated between the Owner key, Mint Pause Keys, the Mint Key, and Mint Ratifier Keys, which protect the mint process. Risk is configurable in the mint limits.
This contract can be the owner of a TokenController. It turns every TokenController owner function into a multisig function that requires 2/3 approvals.
Our own implementation of Claimable Contract, formerly part of OpenZeppelin.
This limits the minimum and maximum number of tokens that can be redeemed per-transaction.
This file processes attributes synced from the Registry.
You can register your deposit address using the Deposit Address Registrar.
This will allow you to receive TrueUSD from several addresses.
Such transactions will emit two Transfer events.
Exchanges should register deposit addresses to reduce their operating overhead.
You can redeem these tokens for fiat by transfering them to your redemption address, which starts with at least thirty-five zeroes. Sign up for your redemption address by creating a TrustToken account.
TrustToken prevents you from sending our tokens to blacklisted addresses. We blacklist our own contracts so that you cannot send them tokens by mistake. TrustToken also reserves the right to blacklist accounts that violate the TrueCoin Terms of Use.
By contacting us, you can register a contract to receive a callback when it receives tokens.
We reduce the amount of gas you pay by refunding gas during your transfer.
These are the top-level ERC20 contracts. They inherit the aforementioned functionality.
Before creating a pull request, please run the tests, the profiler, and the flattener.
Initialize the registry submodule in the root directory.
git submodule init && git submodule updatenpm install
npm test # runs ./test.shTo run the profiler and update GasProfile.json, run the profile script in the root directory.
npm run profile # runs ./profile.shRun the flattener in the root directory.
npm run flatten # runs ./flatten-all| Description | URL |
|---|---|
| Purchase and Redeem | https://app.trusttoken.com/ |
| TUSD Etherscan Page | https://etherscan.io/token/0x0000000000085d4780B73119b644AE5ecd22b376 |
| TGBP Etherscan Page | https://etherscan.io/token/0x00000000441378008EA67F4284A57932B1c000a5 |
| TUSD on CoinMarketCap | https://coinmarketcap.com/currencies/trueusd/ |
| Terms of Use | https://www.trusttoken.com/terms-of-use/ |
| Pages | URL |
|---|---|
| Website | https://www.trueusd.com/ |
| https://www.facebook.com/TrustToken/ | |
| https://twitter.com/TrustToken | |
| Telegram | https://t.me/joinchat/HihkMkTja1gIyBRM1J1_vg |
| Exchanges | URL |
|---|---|
| Binance | https://www.binance.com/ |
| Huobi | https://www.huobi.com/ |
| Okex | https://www.okex.com/ |
| Bittrex | https://bittrex.com |
| CoinTiger | https://www.cointiger.pro |
| Upbit | https://upbit.com/ |
| HBUS | https://www.hbus.com/ |