feat(statics): add new map of address to coin

TICKET: SC-512

Author: noel-bitgo

modules/statics/src/map.ts

@@ -1,11 +1,14 @@
 import { BaseCoin } from './base';
 import { DuplicateCoinDefinitionError, CoinNotDefinedError, DuplicateCoinIdDefinitionError } from './errors';
+import { ContractAddressDefinedToken } from './account';
 
 export class CoinMap {
   private readonly _map = new Map<string, Readonly<BaseCoin>>();
   private readonly _coinByIds = new Map<string, Readonly<BaseCoin>>();
   // Holds key equivalences used during an asset name migration
   private readonly _coinByAliases = new Map<string, Readonly<BaseCoin>>();
+  // map of coin by address -> l1:address
+  private readonly _coinByContractAddress = new Map<string, Readonly<BaseCoin>>();
 
   private constructor() {
     // Do not instantiate
@@ -30,6 +33,9 @@ export class CoinMap {
         }
         coinMap._coinByAliases.set(alias, coin);
       }
+      if (coin.isToken && coin instanceof ContractAddressDefinedToken) {
+        coinMap._coinByContractAddress.set(`${coin.family}:${coin.contractAddress}`, coin);
+      }
       return coinMap;
     }, new CoinMap());
   }
@@ -60,7 +66,11 @@ export class CoinMap {
    * @return {BaseCoin}
    */
   public get(key: string): Readonly<BaseCoin> {
-    const coin = this._map.get(key) || this._coinByIds.get(key) || this._coinByAliases.get(key);
+    const coin =
+      this._map.get(key) ||
+      this._coinByIds.get(key) ||
+      this._coinByAliases.get(key) ||
+      this._coinByContractAddress.get(key);
 
     if (coin) {
       return coin;
@@ -70,7 +80,12 @@ export class CoinMap {
   }
 
   public has(key: string): boolean {
-    return this._map.has(key) || this._coinByIds.has(key) || this._coinByAliases.has(key);
+    return (
+      this._map.has(key) ||
+      this._coinByIds.has(key) ||
+      this._coinByAliases.has(key) ||
+      this._coinByContractAddress.has(key)
+    );
   }
 
   public map<T>(mapper: (coin: Readonly<BaseCoin>, coinName: string) => T): T[] {

modules/statics/test/unit/coins.ts

@@ -352,6 +352,15 @@ describe('CoinMap', function () {
     btcById.should.deepEqual(btc);
   });
 
+  it('should get coin by address', () => {
+    const weth = coins.get('weth');
+    const wethByAddress = coins.get(`${weth.family}:${(weth as Erc20Coin).contractAddress}`);
+    wethByAddress.should.deepEqual(weth);
+    const tweth = coins.get('tweth');
+    const twethByAddress = coins.get(`${tweth.family}:${(tweth as Erc20Coin).contractAddress}`);
+    twethByAddress.should.deepEqual(tweth);
+  });
+
   it('should find coin by id', () => {
     coins.has(btc.id).should.be.true();
   });