Test Ethereum - TERC20 Tokens

Test Ethereum - TERC20 Tokens

TERC20 tokens can be accessed on different Testnets with the following identifiers.

TestnetToken IdToken NamePrecisionContract Details
Ethereum GoerlifixedGoerli Example Fixed Supply Token18https://goerli.etherscan.io/token/0xa13de8df4ef9d6016f0826858d48045848429390
Ethereum Goerligterc2dpGoerli ERC20 Token 2 Decimals2https://goerli.etherscan.io/token/0xe19e232e942cde4320b6354646cbb1336ae732c7
Ethereum Goerligterc6dpGoerli ERC20 Token 6 Decimals6https://goerli.etherscan.io/token/0xe7afa17e6e5257806d2309b01e6de320668ec3dc
Ethereum Goerligterc18dpGoerli ERC20 Token 18 Decimals18https://goerli.etherscan.io/token/0x61d54356be035944a3868eaa9556353b7150699d
Ethereum Goerligtaave18dpGoerli Test AAVE Token 18 Decimals18https://goerli.etherscan.io/token/0x631d5e3c45a459e8f98b9d6a2734fce7b051f845
Ethereum Goerligtbat18dpGoerli Test BAT Token 18 Decimals18https://goerli.etherscan.io/token/0x95458b26c8b524eb5ef92c7a1759ede6224bef2e
Ethereum Goerligtcomp18dpGoerli Test COMP Token 18 Decimals18https://goerli.etherscan.io/token/0xa1ff97c394b25926acb09d12bacf0613055a2727
Ethereum Goerligtgrt18dpGoerli Test GRT Token 18 Decimals18https://goerli.etherscan.io/token/0x1441f298d1f15084a0e5c714c966033e39597de7
Ethereum Goerligtlink18dpGoerli Test LINK Token 18 Decimals18https://goerli.etherscan.io/token/0xfe4537ff71aef28592c5c7331ed4b20f276d770b
Ethereum Goerligtmkr18dpGoerli Test MKR Token 18 Decimals18https://goerli.etherscan.io/token/0xf84e8207e4dc846e250208a6e4b05aa3e7ab00c6
Ethereum Goerligtsnx18dpGoerli Test SNX1 Token 18 Decimals18https://goerli.etherscan.io/token/0x50608a26bff103290a4a47b152395047801e9280
Ethereum Goerligtuni18dpGoerli Test UNI Token 18 Decimals18https://goerli.etherscan.io/token/0x6be1a99c215872cea33217b0f4bad63f186ddfac
Ethereum Goerligtusdt6dpGoerli Test USDT Token 6 Decimals6https://goerli.etherscan.io/token/0x51445dcddf5246229bae8c0ba3ea462e63038641
Ethereum Goerligtyfi18dpGoerli Test YFI Token 18 Decimals18https://goerli.etherscan.io/token/0xf4755c1a9aaad9d6b919edb8346ce9b46d066be4
Ethereum Goerligtwbtc8dpGoerli Test WBTC Token 8 Decimals8https://goerli.etherscan.io/token/0xd4bccebe77b7c1da89818f8889e3ea09046e7e38
Ethereum GoerlighcnHimalayan Coin18https://goerli.etherscan.io/token/0xa05e3efe2771cd04191f3eadb9a99ba3b4bf9d26
Ethereum GoerlighdoHimalayan Dollar18https://goerli.etherscan.io/token/0x5426635915740813092eeff72158bc492799da5f
Ethereum GoerligusdtGoerli USDT18https://goerli.etherscan.io/token/0x64d081854fad45e64db52cd28ba78ae1ecfee59b
Ethereum Goerliterc2dp1Test ERC Token 2 Decimals2https://goerli.etherscan.io/token/0xceef48d58cc3a51d8b6df155633007415b9bae01
Ethereum Goerliterc2dp2Test ERC Token 2 Decimals2https://goerli.etherscan.io/token/0x168AE5b381F7C317AC6EF2161c6e5fcC0e0de41e
Ethereum Goerliterc2dp3Test ERC Token 2 Decimals2https://goerli.etherscan.io/token/0x12cb9d6127ac74847cc444e6661cfd1b5107bd26
Ethereum Goerliterc2dp4Test ERC Token 2 Decimals2https://goerli.etherscan.io/token/0x458fdef6e1e58614d82f3116d8ca1f23419cb8c0
Ethereum Goerliterc2dp5Test ERC Token 2 Decimals2https://goerli.etherscan.io/token/0xf44c85bf1d556a8268a1212cf0b9248af4f238bd
Ethereum Goerliterc6dp1Test ERC Token 6 Decimals6https://goerli.etherscan.io/token/0x3b9f958f0ba34aa103fabb054f29400703470bac
Ethereum Goerliterc6dp2Test ERC Token 6 Decimals6https://goerli.etherscan.io/token/0x2508d109a0cd87e597a1de071325f5cf56d4639a
Ethereum Goerliterc6dp3Test ERC Token 6 Decimals6https://goerli.etherscan.io/token/0xdda2375104ee9a97e1d7aa4bc48ede2c4c6ddf48
Ethereum Goerliterc6dp4Test ERC Token 6 Decimals6https://goerli.etherscan.io/token/0x06c1f1195c59ec5f318d12d4cc2d1f9d45261756
Ethereum Goerliterc6dp5Test ERC Token 6 Decimals6https://goerli.etherscan.io/token/0x3326af8eeb6d4ce1f1f0652fcb3d5e07cd9c1039
Ethereum Goerliterc18dp1Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0x9f77b76e6866b3f5dd99382c96f16eddabc0b78e
Ethereum Goerliterc18dp2Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0x18b17853ff62122c60f113b8b8967243c39ad30e
Ethereum Goerliterc18dp3Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0x96f13e2ea4b738380922dd9f5cd8fcf0416e5f2d
Ethereum Goerliterc18dp4Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0xbecf20f89b6898bd8bbf3fa93fb4bcda367b9594
Ethereum Goerliterc18dp5Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0x4464fe55f9a8aea46e02c4a22b4d74661805ec26
Ethereum Goerliterc18dp6Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0x998ddfd1ac3ed76fc163528c5fc69b8d67fa5395
Ethereum Goerliterc18dp7Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0xf2555ac243ab2606fa71e2f2728117054dd1867b
Ethereum Goerliterc18dp8Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0xd9da1e909e3b4b2c1ec31b702bef0bf1e42533e4
Ethereum Goerliterc18dp9Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0xb91be6a36b60c4576aff75a50d2b7c762349ddec
Ethereum Goerliterc18dp10Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0xc53d2c04795a1cef22a91c9d52c04f5082bb5631
Ethereum Goerliterc18dp11Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0xc325d7f188dc6015f45d3d39e58c5404e79b5cb9
Ethereum Goerliterc18dp12Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0x7a8f375798284920cd27d1c757ceca3675603ab1
Ethereum Goerliterc18dp13Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0x2e3f4bf47e4ea53a7a94f0597b47fe3caab78b0d
Ethereum Goerliterc18dp14Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0x4f369aa78b9f299cb50ad4d96e13bdfbd8be7239
Ethereum Goerliterc18dp15Test ERC Token 18 Decimals18https://goerli.etherscan.io/token/0x0fcb9bc4c67d502a45a07f514638ca8f83ba2912
Ethereum GoerliteurocTest Euro Coin6https://goerli.etherscan.io/token/0xa683d909e996052955500ddc45ca13e25c76e286
Ethereum GoerlitmaticTest Polygon18https://goerli.etherscan.io/token/0x499d11e0b6eac7c0593d8fb292dcbbf815fb29ae

Wallet functionality

Unlike Ether, ERC20 tokens do not have the full functionality of a wallet. You cannot create wallets, create/list/get receive addresses, or share wallets for ERC20 tokens.

To retrieve token details associated with an Ethereum wallet, such as balance, pending approvals, policies, and webhooks, set the allTokens parameter to true with the following calls:

  1. Get Wallet
  2. List Wallets
  3. List Pending Approvals
  4. List Wallet Webhooks
  5. List Transfers
  6. Add Wallet Webhook

Keychains

ERC20 tokens do not have a direct association with keys or keychains. Instead, all tokens share the same keys/keychains that belong to the Ethereum wallet.

Balances

Each token has a different divisibility factor which is specified in the token contract. This value is usually 1,000,000,000,000,000,000 (1018) units, but can vary from token to token. Check the client constants to see the number of decimal places the token supports.

Balances are supported in string format: balanceString, confirmedBalanceString, and spendableBalanceString.

Transactions

BitGo's Ethereum multisig contract currently only supports one sender and one recipient. That means that the sendMany call only accepts one recipient for tokens.

ERC20 Tokens Webhooks

By setting the allTokens parameter to true, a generic webhook is created which triggers on all ERC20 token and ETH transactions. It sends an HTPP request to your webhook URL and specifies whether it is Ethereum or a token using the field "coin".

Here's an example response for a test token called "terc".

{
    "hash":"0x3e00ae17961d3d42ae722085904ba84e63a32b005ff46afff28b7c9c76f63291",
    "transfer":"5b612d25c9067f2a1db11a15f165989e",
    "coin":"terc",
    "type":"transfer",
    "state":"confirmed",
    "wallet":"5a13adcab70f2c284fdd9682db5e6d64"
}

To get additional details about this transfer, you need to get the transfer details using the token name and transfer id. For the above transfer you'd need to call the Get Transfer route to check the amount transferred and other details (e.g. /api/v2/terc/wallet/5a13adcab70f2c284fdd9682db5e6d64/transfer/5b612d25c9067f2a1db11a15f165989e).

Note: Transactions that send both Ethereum and ERC20 tokens (or multiple token types) supported by BitGo generate one webhook notification for each.