Merge pull request #6085 from BitGo/COIN-3996-fetch-sdk-cosmos-batch

baltiyal · web-flow · commit 4f357bcc6646 · 2025-05-05T23:35:14.000+05:30
feat(sdk-coin-fetch): add SDK Skeleton for Fetch
diff --git a/CODEOWNERS b/CODEOWNERS
@@ -61,6 +61,7 @@
 /modules/sdk-coin-cspr/ @BitGo/ethalt-team
 /modules/sdk-coin-dot/ @BitGo/ethalt-team
 /modules/sdk-coin-eos/ @BitGo/ethalt-team
+/modules/sdk-coin-fetch/ @BitGo/ethalt-team
 /modules/sdk-coin-flr/ @BitGo/ethalt-team
 /modules/sdk-coin-ethlike/ @BitGo/ethalt-team
 /modules/sdk-coin-hbar/ @BitGo/ethalt-team
diff --git a/Dockerfile b/Dockerfile
@@ -76,6 +76,7 @@ COPY --from=builder /tmp/bitgo/modules/sdk-coin-cronos /var/modules/sdk-coin-cro
 COPY --from=builder /tmp/bitgo/modules/sdk-coin-cspr /var/modules/sdk-coin-cspr/
 COPY --from=builder /tmp/bitgo/modules/sdk-coin-dot /var/modules/sdk-coin-dot/
 COPY --from=builder /tmp/bitgo/modules/sdk-coin-etc /var/modules/sdk-coin-etc/
+COPY --from=builder /tmp/bitgo/modules/sdk-coin-fetch /var/modules/sdk-coin-fetch/
 COPY --from=builder /tmp/bitgo/modules/sdk-coin-flr /var/modules/sdk-coin-flr/
 COPY --from=builder /tmp/bitgo/modules/sdk-coin-hash /var/modules/sdk-coin-hash/
 COPY --from=builder /tmp/bitgo/modules/sdk-coin-hbar /var/modules/sdk-coin-hbar/
@@ -166,6 +167,7 @@ cd /var/modules/sdk-coin-cronos && yarn link && \
 cd /var/modules/sdk-coin-cspr && yarn link && \
 cd /var/modules/sdk-coin-dot && yarn link && \
 cd /var/modules/sdk-coin-etc && yarn link && \
+cd /var/modules/sdk-coin-fetch && yarn link && \
 cd /var/modules/sdk-coin-flr && yarn link && \
 cd /var/modules/sdk-coin-hash && yarn link && \
 cd /var/modules/sdk-coin-hbar && yarn link && \
@@ -259,6 +261,7 @@ RUN cd /var/bitgo-express && \
     yarn link @bitgo/sdk-coin-cspr && \
     yarn link @bitgo/sdk-coin-dot && \
     yarn link @bitgo/sdk-coin-etc && \
+    yarn link @bitgo/sdk-coin-fetch && \
     yarn link @bitgo/sdk-coin-flr && \
     yarn link @bitgo/sdk-coin-hash && \
     yarn link @bitgo/sdk-coin-hbar && \
diff --git a/modules/account-lib/package.json b/modules/account-lib/package.json
@@ -45,6 +45,7 @@
     "@bitgo/sdk-coin-dot": "^4.1.56",
     "@bitgo/sdk-coin-etc": "^2.2.45",
     "@bitgo/sdk-coin-eth": "^24.4.1",
+    "@bitgo/sdk-coin-fetch": "^1.0.0",
     "@bitgo/sdk-coin-flr": "^1.2.2",
     "@bitgo/sdk-coin-hash": "^3.0.47",
     "@bitgo/sdk-coin-hbar": "^2.0.78",
diff --git a/modules/account-lib/src/index.ts b/modules/account-lib/src/index.ts
@@ -113,6 +113,9 @@ export { Mantra };
 import * as Cronos from '@bitgo/sdk-coin-cronos';
 export { Cronos };
 
+import * as Fetch from '@bitgo/sdk-coin-fetch';
+export { Fetch };
+
 import * as Sol from '@bitgo/sdk-coin-sol';
 export { Sol };
 
@@ -263,6 +266,8 @@ const coinBuilderMap = {
   tbaby: Baby.TransactionBuilder,
   cronos: Cronos.TransactionBuilder,
   tcronos: Cronos.TransactionBuilder,
+  fetch: Fetch.TransactionBuilder,
+  tfetch: Fetch.TransactionBuilder,
   flr: Flr.TransactionBuilder,
   tflr: Flr.TransactionBuilder,
   sgb: Sgb.TransactionBuilder,
diff --git a/modules/bitgo/package.json b/modules/bitgo/package.json
@@ -78,6 +78,7 @@
     "@bitgo/sdk-coin-eth": "^24.4.1",
     "@bitgo/sdk-coin-ethlike": "^1.2.13",
     "@bitgo/sdk-coin-ethw": "^20.0.78",
+    "@bitgo/sdk-coin-fetch": "^1.0.0",
     "@bitgo/sdk-coin-flr": "^1.2.2",
     "@bitgo/sdk-coin-hash": "^3.0.47",
     "@bitgo/sdk-coin-hbar": "^2.0.78",
diff --git a/modules/bitgo/src/v2/coinFactory.ts b/modules/bitgo/src/v2/coinFactory.ts
@@ -47,6 +47,7 @@ import {
   Eth,
   Ethw,
   EthLikeCoin,
+  Fetch,
   Flr,
   TethLikeCoin,
   FiatAED,
@@ -117,6 +118,7 @@ import {
   Teos,
   Tetc,
   Teth,
+  Tfetch,
   Tflr,
   Tmon,
   TfiatAED,
@@ -211,6 +213,7 @@ function registerCoinConstructors(globalCoinFactory: CoinFactory): void {
   globalCoinFactory.register('fiatgbp', FiatGBP.createInstance);
   globalCoinFactory.register('fiatsgd', FiatSGD.createInstance);
   globalCoinFactory.register('fiatusd', FiatUsd.createInstance);
+  globalCoinFactory.register('fetch', Fetch.createInstance);
   globalCoinFactory.register('flr', Flr.createInstance);
   globalCoinFactory.register('gteth', Gteth.createInstance);
   globalCoinFactory.register('hash', Hash.createInstance);
@@ -277,6 +280,7 @@ function registerCoinConstructors(globalCoinFactory: CoinFactory): void {
   globalCoinFactory.register('tfiatgbp', TfiatGBP.createInstance);
   globalCoinFactory.register('tfiatsgd', TfiatSGD.createInstance);
   globalCoinFactory.register('tfiatusd', TfiatUsd.createInstance);
+  globalCoinFactory.register('tfetch', Tfetch.createInstance);
   globalCoinFactory.register('tflr', Tflr.createInstance);
   globalCoinFactory.register('tmon', Tmon.createInstance);
   globalCoinFactory.register('thash', Thash.createInstance);
diff --git a/modules/bitgo/src/v2/coins/index.ts b/modules/bitgo/src/v2/coins/index.ts
@@ -27,6 +27,7 @@ import { Dot, Tdot } from '@bitgo/sdk-coin-dot';
 import { Eos, EosToken, Teos } from '@bitgo/sdk-coin-eos';
 import { Etc, Tetc } from '@bitgo/sdk-coin-etc';
 import { Erc20Token, Eth, Gteth, Hteth, Teth } from '@bitgo/sdk-coin-eth';
+import { Fetch, Tfetch } from '@bitgo/sdk-coin-fetch';
 import { Flr, Tflr } from '@bitgo/sdk-coin-flr';
 import { Ethw } from '@bitgo/sdk-coin-ethw';
 import { EthLikeCoin, TethLikeCoin } from '@bitgo/sdk-coin-ethlike';
@@ -97,6 +98,7 @@ export { Erc20Token, Eth, Gteth, Hteth, Teth };
 export { Ethw };
 export { EthLikeCoin, TethLikeCoin };
 export { Etc, Tetc };
+export { Fetch, Tfetch };
 export { Flr, Tflr };
 export { Hash, Thash };
 export { Hbar, Thbar };
diff --git a/modules/bitgo/tsconfig.json b/modules/bitgo/tsconfig.json
@@ -146,6 +146,9 @@
     {
       "path": "../sdk-coin-ethw"
     },
+    {
+      "path": "../sdk-coin-fetch"
+    },
     {
       "path": "../sdk-coin-flr"
     },
diff --git a/modules/sdk-coin-fetch/.eslintignore b/modules/sdk-coin-fetch/.eslintignore
@@ -0,0 +1,4 @@
+node_modules
+.idea
+public
+dist
diff --git a/modules/sdk-coin-fetch/.gitignore b/modules/sdk-coin-fetch/.gitignore
@@ -0,0 +1,3 @@
+node_modules/
+.idea/
+dist/
diff --git a/modules/sdk-coin-fetch/.mocharc.yml b/modules/sdk-coin-fetch/.mocharc.yml
@@ -0,0 +1,8 @@
+require: 'ts-node/register'
+timeout: '60000'
+reporter: 'min'
+reporter-option:
+  - 'cdn=true'
+  - 'json=false'
+exit: true
+spec: ['test/unit/**/*.ts']
diff --git a/modules/sdk-coin-fetch/.npmignore b/modules/sdk-coin-fetch/.npmignore
@@ -0,0 +1,14 @@
+!dist/
+dist/test/
+dist/tsconfig.tsbuildinfo
+.idea/
+.prettierrc.yml
+tsconfig.json
+src/
+test/
+scripts/
+.nyc_output
+CODEOWNERS
+node_modules/
+.prettierignore
+.mocharc.js
diff --git a/modules/sdk-coin-fetch/.prettierignore b/modules/sdk-coin-fetch/.prettierignore
@@ -0,0 +1,2 @@
+.nyc_output/
+dist/
diff --git a/modules/sdk-coin-fetch/.prettierrc.yml b/modules/sdk-coin-fetch/.prettierrc.yml
@@ -0,0 +1,3 @@
+printWidth: 120
+singleQuote: true
+trailingComma: 'es5'
diff --git a/modules/sdk-coin-fetch/README.md b/modules/sdk-coin-fetch/README.md
@@ -0,0 +1,30 @@
+# BitGo sdk-coin-fetch
+
+SDK coins provide a modular approach to a monolithic architecture. This and all BitGoJS SDK coins allow developers to use only the coins needed for a given project.
+
+## Installation
+
+All coins are loaded traditionally through the `bitgo` package. If you are using coins individually, you will be accessing the coin via the `@bitgo/sdk-api` package.
+
+In your project install both `@bitgo/sdk-api` and `@bitgo/sdk-coin-fetch`.
+
+```shell
+npm i @bitgo/sdk-api @bitgo/sdk-coin-fetch
+```
+
+Next, you will be able to initialize an instance of "bitgo" through `@bitgo/sdk-api` instead of `bitgo`.
+
+```javascript
+import { BitGoAPI } from '@bitgo/sdk-api';
+import { Fetch } from '@bitgo/sdk-coin-fetch';
+
+const sdk = new BitGoAPI();
+
+sdk.register('fetch', Fetch.createInstance);
+```
+
+## Development
+
+Most of the coin implementations are derived from `@bitgo/sdk-core`, `@bitgo/statics`, and coin specific packages. These implementations are used to interact with the BitGo API and BitGo platform services.
+
+You will notice that the basic version of common class extensions have been provided to you and must be resolved before the package build will succeed. Upon initiation of a given SDK coin, you will need to verify that your coin has been included in the root `tsconfig.packages.json` and that the linting, formatting, and testing succeeds when run both within the coin and from the root of BitGoJS.
diff --git a/modules/sdk-coin-fetch/package.json b/modules/sdk-coin-fetch/package.json
@@ -0,0 +1,52 @@
+{
+  "name": "@bitgo/sdk-coin-fetch",
+  "version": "1.0.0",
+  "description": "BitGo SDK coin library for Fetch",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "scripts": {
+    "build": "yarn tsc --build --incremental --verbose .",
+    "fmt": "prettier --write .",
+    "check-fmt": "prettier --check .",
+    "clean": "rm -r ./dist",
+    "lint": "eslint --quiet .",
+    "prepare": "npm run build",
+    "test": "npm run coverage",
+    "coverage": "nyc -- npm run unit-test",
+    "unit-test": "mocha"
+  },
+  "author": "BitGo SDK Team <sdkteam@bitgo.com>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18 <21"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BitGo/BitGoJS.git",
+    "directory": "modules/sdk-coin-fetch"
+  },
+  "lint-staged": {
+    "*.{js,ts}": [
+      "yarn prettier --write",
+      "yarn eslint --fix"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "nyc": {
+    "extension": [
+      ".ts"
+    ]
+  },
+  "dependencies": {
+    "@bitgo/abstract-cosmos": "^11.7.2",
+    "@bitgo/sdk-core": "^33.1.0",
+    "@bitgo/statics": "^52.1.0",
+    "@cosmjs/stargate": "^0.29.5"
+  },
+  "devDependencies": {
+    "@bitgo/sdk-api": "^1.62.2",
+    "@bitgo/sdk-test": "^8.0.83"
+  }
+}
diff --git a/modules/sdk-coin-fetch/src/fetch.ts b/modules/sdk-coin-fetch/src/fetch.ts
@@ -0,0 +1,62 @@
+import { BaseCoin, BitGoBase } from '@bitgo/sdk-core';
+import { BaseCoin as StaticsBaseCoin } from '@bitgo/statics';
+import { CosmosCoin, CosmosKeyPair, GasAmountDetails } from '@bitgo/abstract-cosmos';
+import { TransactionBuilderFactory } from './lib';
+
+export class Fetch extends CosmosCoin {
+  protected readonly _staticsCoin: Readonly<StaticsBaseCoin>;
+
+  protected constructor(bitgo: BitGoBase, staticsCoin?: Readonly<StaticsBaseCoin>) {
+    super(bitgo, staticsCoin);
+
+    if (!staticsCoin) {
+      throw new Error('missing required constructor parameter staticsCoin');
+    }
+
+    this._staticsCoin = staticsCoin;
+  }
+
+  static createInstance(bitgo: BitGoBase, staticsCoin?: Readonly<StaticsBaseCoin>): BaseCoin {
+    return new Fetch(bitgo, staticsCoin);
+  }
+
+  /** @inheritDoc **/
+  getBaseFactor(): number {
+    return Math.pow(10, this._staticsCoin.decimalPlaces);
+  }
+
+  /** @inheritDoc **/
+  getBuilder(): TransactionBuilderFactory {
+    throw new Error('Method not implemented.');
+  }
+
+  /** @inheritDoc **/
+  isValidAddress(address: string): boolean {
+    throw new Error('Method not implemented.');
+  }
+
+  /** @inheritDoc **/
+  getDenomination(): string {
+    throw new Error('Method not implemented');
+  }
+
+  /** @inheritDoc **/
+  getGasAmountDetails(): GasAmountDetails {
+    throw new Error('Method not implemented');
+  }
+
+  /** @inheritDoc **/
+  getKeyPair(publicKey: string): CosmosKeyPair {
+    throw new Error('Method not implemented');
+  }
+
+  /** @inheritDoc **/
+  protected getPublicNodeUrl(): string {
+    throw new Error('Method not implemented');
+  }
+
+  /** @inheritDoc **/
+  getAddressFromPublicKey(pubKey: string): string {
+    throw new Error('Method not implemented');
+  }
+}
diff --git a/modules/sdk-coin-fetch/src/index.ts b/modules/sdk-coin-fetch/src/index.ts
@@ -0,0 +1,4 @@
+export * from './lib';
+export * from './register';
+export * from './fetch';
+export * from './tfetch';
diff --git a/modules/sdk-coin-fetch/src/lib/constants.ts b/modules/sdk-coin-fetch/src/lib/constants.ts
diff --git a/modules/sdk-coin-fetch/src/lib/index.ts b/modules/sdk-coin-fetch/src/lib/index.ts
@@ -0,0 +1,9 @@
+import * as Utils from './utils';
+
+export {
+  CosmosTransaction as Transaction,
+  CosmosTransactionBuilder as TransactionBuilder,
+} from '@bitgo/abstract-cosmos';
+export { KeyPair } from './keyPair';
+export { TransactionBuilderFactory } from './transactionBuilderFactory';
+export { Utils };
diff --git a/modules/sdk-coin-fetch/src/lib/keyPair.ts b/modules/sdk-coin-fetch/src/lib/keyPair.ts
@@ -0,0 +1,16 @@
+import { KeyPairOptions } from '@bitgo/sdk-core';
+import { CosmosKeyPair } from '@bitgo/abstract-cosmos';
+
+/**
+ * Fetch keys and address management.
+ */
+export class KeyPair extends CosmosKeyPair {
+  constructor(source?: KeyPairOptions) {
+    super(source);
+  }
+
+  /** @inheritdoc */
+  getAddress(): string {
+    throw new Error('Method not implemented.');
+  }
+}
diff --git a/modules/sdk-coin-fetch/src/lib/transactionBuilderFactory.ts b/modules/sdk-coin-fetch/src/lib/transactionBuilderFactory.ts
diff --git a/modules/sdk-coin-fetch/src/lib/utils.ts b/modules/sdk-coin-fetch/src/lib/utils.ts
diff --git a/modules/sdk-coin-fetch/src/register.ts b/modules/sdk-coin-fetch/src/register.ts
diff --git a/modules/sdk-coin-fetch/src/tfetch.ts b/modules/sdk-coin-fetch/src/tfetch.ts
diff --git a/modules/sdk-coin-fetch/test/unit/fetch.ts b/modules/sdk-coin-fetch/test/unit/fetch.ts
diff --git a/modules/sdk-coin-fetch/tsconfig.json b/modules/sdk-coin-fetch/tsconfig.json
diff --git a/modules/sdk-core/src/bitgo/environments.ts b/modules/sdk-core/src/bitgo/environments.ts
diff --git a/tsconfig.packages.json b/tsconfig.packages.json

Original file line number	Diff line number	Diff line change
`@@ -146,6 +146,9 @@`
`146`	`146`	`{`
`147`	`147`	`"path": "../sdk-coin-ethw"`
`148`	`148`	`},`
	`149`	`+ {`
	`150`	`+ "path": "../sdk-coin-fetch"`
	`151`	`+ },`
`149`	`152`	`{`
`150`	`153`	`"path": "../sdk-coin-flr"`
`151`	`154`	`},`
-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +node_modules
 +.idea
 +public
 +dist