Test Ethereum - TERC20 Tokens

Test Ethereum - TERC20 Tokens

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

Testnet	Token Id	Token Name	Precision	Contract Details
Ethereum Goerli	fixed	Goerli Example Fixed Supply Token	18	https://goerli.etherscan.io/token/0xa13de8df4ef9d6016f0826858d48045848429390
Ethereum Goerli	gterc2dp	Goerli ERC20 Token 2 Decimals	2	https://goerli.etherscan.io/token/0xe19e232e942cde4320b6354646cbb1336ae732c7
Ethereum Goerli	gterc6dp	Goerli ERC20 Token 6 Decimals	6	https://goerli.etherscan.io/token/0xe7afa17e6e5257806d2309b01e6de320668ec3dc
Ethereum Goerli	gterc18dp	Goerli ERC20 Token 18 Decimals	18	https://goerli.etherscan.io/token/0x61d54356be035944a3868eaa9556353b7150699d
Ethereum Goerli	gtaave18dp	Goerli Test AAVE Token 18 Decimals	18	https://goerli.etherscan.io/token/0x631d5e3c45a459e8f98b9d6a2734fce7b051f845
Ethereum Goerli	gtbat18dp	Goerli Test BAT Token 18 Decimals	18	https://goerli.etherscan.io/token/0x95458b26c8b524eb5ef92c7a1759ede6224bef2e
Ethereum Goerli	gtcomp18dp	Goerli Test COMP Token 18 Decimals	18	https://goerli.etherscan.io/token/0xa1ff97c394b25926acb09d12bacf0613055a2727
Ethereum Goerli	gtgrt18dp	Goerli Test GRT Token 18 Decimals	18	https://goerli.etherscan.io/token/0x1441f298d1f15084a0e5c714c966033e39597de7
Ethereum Goerli	gtlink18dp	Goerli Test LINK Token 18 Decimals	18	https://goerli.etherscan.io/token/0xfe4537ff71aef28592c5c7331ed4b20f276d770b
Ethereum Goerli	gtmkr18dp	Goerli Test MKR Token 18 Decimals	18	https://goerli.etherscan.io/token/0xf84e8207e4dc846e250208a6e4b05aa3e7ab00c6
Ethereum Goerli	gtsnx18dp	Goerli Test SNX1 Token 18 Decimals	18	https://goerli.etherscan.io/token/0x50608a26bff103290a4a47b152395047801e9280
Ethereum Goerli	gtuni18dp	Goerli Test UNI Token 18 Decimals	18	https://goerli.etherscan.io/token/0x6be1a99c215872cea33217b0f4bad63f186ddfac
Ethereum Goerli	gtusdt6dp	Goerli Test USDT Token 6 Decimals	6	https://goerli.etherscan.io/token/0x51445dcddf5246229bae8c0ba3ea462e63038641
Ethereum Goerli	gtyfi18dp	Goerli Test YFI Token 18 Decimals	18	https://goerli.etherscan.io/token/0xf4755c1a9aaad9d6b919edb8346ce9b46d066be4
Ethereum Goerli	gtwbtc8dp	Goerli Test WBTC Token 8 Decimals	8	https://goerli.etherscan.io/token/0xd4bccebe77b7c1da89818f8889e3ea09046e7e38
Ethereum Goerli	ghcn	Himalayan Coin	18	https://goerli.etherscan.io/token/0xa05e3efe2771cd04191f3eadb9a99ba3b4bf9d26
Ethereum Goerli	ghdo	Himalayan Dollar	18	https://goerli.etherscan.io/token/0x5426635915740813092eeff72158bc492799da5f
Ethereum Goerli	gusdt	Goerli USDT	18	https://goerli.etherscan.io/token/0x64d081854fad45e64db52cd28ba78ae1ecfee59b
Ethereum Goerli	terc2dp1	Test ERC Token 2 Decimals	2	https://goerli.etherscan.io/token/0xceef48d58cc3a51d8b6df155633007415b9bae01
Ethereum Goerli	terc2dp2	Test ERC Token 2 Decimals	2	https://goerli.etherscan.io/token/0x168AE5b381F7C317AC6EF2161c6e5fcC0e0de41e
Ethereum Goerli	terc2dp3	Test ERC Token 2 Decimals	2	https://goerli.etherscan.io/token/0x12cb9d6127ac74847cc444e6661cfd1b5107bd26
Ethereum Goerli	terc2dp4	Test ERC Token 2 Decimals	2	https://goerli.etherscan.io/token/0x458fdef6e1e58614d82f3116d8ca1f23419cb8c0
Ethereum Goerli	terc2dp5	Test ERC Token 2 Decimals	2	https://goerli.etherscan.io/token/0xf44c85bf1d556a8268a1212cf0b9248af4f238bd
Ethereum Goerli	terc6dp1	Test ERC Token 6 Decimals	6	https://goerli.etherscan.io/token/0x3b9f958f0ba34aa103fabb054f29400703470bac
Ethereum Goerli	terc6dp2	Test ERC Token 6 Decimals	6	https://goerli.etherscan.io/token/0x2508d109a0cd87e597a1de071325f5cf56d4639a
Ethereum Goerli	terc6dp3	Test ERC Token 6 Decimals	6	https://goerli.etherscan.io/token/0xdda2375104ee9a97e1d7aa4bc48ede2c4c6ddf48
Ethereum Goerli	terc6dp4	Test ERC Token 6 Decimals	6	https://goerli.etherscan.io/token/0x06c1f1195c59ec5f318d12d4cc2d1f9d45261756
Ethereum Goerli	terc6dp5	Test ERC Token 6 Decimals	6	https://goerli.etherscan.io/token/0x3326af8eeb6d4ce1f1f0652fcb3d5e07cd9c1039
Ethereum Goerli	terc18dp1	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0x9f77b76e6866b3f5dd99382c96f16eddabc0b78e
Ethereum Goerli	terc18dp2	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0x18b17853ff62122c60f113b8b8967243c39ad30e
Ethereum Goerli	terc18dp3	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0x96f13e2ea4b738380922dd9f5cd8fcf0416e5f2d
Ethereum Goerli	terc18dp4	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0xbecf20f89b6898bd8bbf3fa93fb4bcda367b9594
Ethereum Goerli	terc18dp5	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0x4464fe55f9a8aea46e02c4a22b4d74661805ec26
Ethereum Goerli	terc18dp6	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0x998ddfd1ac3ed76fc163528c5fc69b8d67fa5395
Ethereum Goerli	terc18dp7	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0xf2555ac243ab2606fa71e2f2728117054dd1867b
Ethereum Goerli	terc18dp8	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0xd9da1e909e3b4b2c1ec31b702bef0bf1e42533e4
Ethereum Goerli	terc18dp9	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0xb91be6a36b60c4576aff75a50d2b7c762349ddec
Ethereum Goerli	terc18dp10	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0xc53d2c04795a1cef22a91c9d52c04f5082bb5631
Ethereum Goerli	terc18dp11	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0xc325d7f188dc6015f45d3d39e58c5404e79b5cb9
Ethereum Goerli	terc18dp12	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0x7a8f375798284920cd27d1c757ceca3675603ab1
Ethereum Goerli	terc18dp13	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0x2e3f4bf47e4ea53a7a94f0597b47fe3caab78b0d
Ethereum Goerli	terc18dp14	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0x4f369aa78b9f299cb50ad4d96e13bdfbd8be7239
Ethereum Goerli	terc18dp15	Test ERC Token 18 Decimals	18	https://goerli.etherscan.io/token/0x0fcb9bc4c67d502a45a07f514638ca8f83ba2912
Ethereum Goerli	teuroc	Test Euro Coin	6	https://goerli.etherscan.io/token/0xa683d909e996052955500ddc45ca13e25c76e286
Ethereum Goerli	tmatic	Test Polygon	18	https://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.