feat(sdk-coin-stt): add transaction builder

yogeshwar-bitgo · yogeshwar-bitgo · commit 1e7730665a74 · 2025-04-24T09:21:12.000+05:30
TICKET: WIN-5028
diff --git a/CODEOWNERS b/CODEOWNERS
@@ -75,6 +75,7 @@
 /modules/sdk-coin-sgb/ @BitGo/ethalt-team
 /modules/sdk-coin-sol/ @BitGo/ethalt-team
 /modules/sdk-coin-stx/ @BitGo/ethalt-team
+/modules/sdk-coin-stt/ @BitGo/ethalt-team
 /modules/sdk-coin-sui/ @BitGo/ethalt-team
 /modules/sdk-coin-tao/ @BitGo/ethalt-team
 /modules/sdk-coin-ton/ @BitGo/ethalt-team
diff --git a/Dockerfile b/Dockerfile
@@ -94,6 +94,7 @@ COPY --from=builder /tmp/bitgo/modules/sdk-coin-sei /var/modules/sdk-coin-sei/
 COPY --from=builder /tmp/bitgo/modules/sdk-coin-sgb /var/modules/sdk-coin-sgb/
 COPY --from=builder /tmp/bitgo/modules/sdk-coin-sol /var/modules/sdk-coin-sol/
 COPY --from=builder /tmp/bitgo/modules/sdk-coin-stx /var/modules/sdk-coin-stx/
+COPY --from=builder /tmp/bitgo/modules/sdk-coin-stt /var/modules/sdk-coin-stt/
 COPY --from=builder /tmp/bitgo/modules/sdk-coin-sui /var/modules/sdk-coin-sui/
 COPY --from=builder /tmp/bitgo/modules/sdk-coin-tao /var/modules/sdk-coin-tao/
 COPY --from=builder /tmp/bitgo/modules/abstract-substrate /var/modules/abstract-substrate/
@@ -189,6 +190,7 @@ cd /var/modules/sdk-coin-ton && yarn link && \
 cd /var/modules/sdk-coin-trx && yarn link && \
 cd /var/modules/sdk-coin-wemix && yarn link && \
 cd /var/modules/sdk-coin-world && yarn link && \
+cd /var/modules/sdk-coin-stt && yarn link && \
 cd /var/modules/sdk-coin-xdc && yarn link && \
 cd /var/modules/sdk-coin-xrp && yarn link && \
 cd /var/modules/sdk-coin-xtz && yarn link && \
@@ -271,6 +273,7 @@ RUN cd /var/bitgo-express && \
     yarn link @bitgo/sdk-coin-sgb && \
     yarn link @bitgo/sdk-coin-sol && \
     yarn link @bitgo/sdk-coin-stx && \
+    yarn link @bitgo/sdk-coin-stt && \
     yarn link @bitgo/sdk-coin-sui && \
     yarn link @bitgo/sdk-coin-tao && \
     yarn link @bitgo/abstract-substrate && \
diff --git a/modules/account-lib/package.json b/modules/account-lib/package.json
@@ -62,6 +62,7 @@
     "@bitgo/sdk-coin-sgb": "^1.2.0",
     "@bitgo/sdk-coin-sol": "^4.9.1",
     "@bitgo/sdk-coin-stx": "^3.5.5",
+    "@bitgo/sdk-coin-stt": "^1.0.0",
     "@bitgo/sdk-coin-sui": "^5.13.5",
     "@bitgo/sdk-coin-tao": "^1.6.6",
     "@bitgo/sdk-coin-tia": "^3.0.45",
diff --git a/modules/account-lib/src/index.ts b/modules/account-lib/src/index.ts
@@ -170,6 +170,9 @@ export { Wemix };
 import * as World from '@bitgo/sdk-coin-world';
 export { World };
 
+import * as Stt from '@bitgo/sdk-coin-stt';
+export { Stt };
+
 const coinBuilderMap = {
   trx: Trx.WrappedBuilder,
   ttrx: Trx.WrappedBuilder,
@@ -266,6 +269,8 @@ const coinBuilderMap = {
   tmon: Mon.TransactionBuilder,
   world: World.TransactionBuilder,
   tworld: World.TransactionBuilder,
+  stt: Stt.TransactionBuilder,
+  tstt: Stt.TransactionBuilder,
 };
 
 /**
diff --git a/modules/account-lib/tsconfig.json b/modules/account-lib/tsconfig.json
@@ -103,6 +103,9 @@
     {
       "path": "../sdk-coin-stx"
     },
+    {
+      "path": "../sdk-coin-stt"
+    },
     {
       "path": "../sdk-coin-tia"
     },
diff --git a/modules/bitgo/package.json b/modules/bitgo/package.json
@@ -99,6 +99,7 @@
     "@bitgo/sdk-coin-sgb": "^1.2.0",
     "@bitgo/sdk-coin-sol": "^4.9.1",
     "@bitgo/sdk-coin-stx": "^3.5.5",
+    "@bitgo/sdk-coin-stt": "^1.0.0",
     "@bitgo/sdk-coin-sui": "^5.13.5",
     "@bitgo/sdk-coin-tao": "^1.6.6",
     "@bitgo/sdk-coin-tia": "^3.0.45",
diff --git a/modules/bitgo/src/v2/coinFactory.ts b/modules/bitgo/src/v2/coinFactory.ts
@@ -81,6 +81,7 @@ import {
   Sol,
   StellarToken,
   Stx,
+  Stt,
   Sui,
   SuiToken,
   Susd,
@@ -141,6 +142,7 @@ import {
   Tsei,
   Tsol,
   Tstx,
+  Tstt,
   Tsui,
   Tsusd,
   Twemix,
@@ -229,6 +231,7 @@ function registerCoinConstructors(globalCoinFactory: CoinFactory): void {
   globalCoinFactory.register('sgb', Sgb.createInstance);
   globalCoinFactory.register('sol', Sol.createInstance);
   globalCoinFactory.register('stx', Stx.createInstance);
+  globalCoinFactory.register('stt', Stt.createInstance);
   globalCoinFactory.register('sui', Sui.createInstance);
   globalCoinFactory.register('susd', Susd.createInstance);
   globalCoinFactory.register('tao', Tao.createInstance);
@@ -290,6 +293,7 @@ function registerCoinConstructors(globalCoinFactory: CoinFactory): void {
   globalCoinFactory.register('tsei', Tsei.createInstance);
   globalCoinFactory.register('tsol', Tsol.createInstance);
   globalCoinFactory.register('tstx', Tstx.createInstance);
+  globalCoinFactory.register('tstt', Tstt.createInstance);
   globalCoinFactory.register('tsui', Tsui.createInstance);
   globalCoinFactory.register('tsusd', Tsusd.createInstance);
   globalCoinFactory.register('ttao', Ttao.createInstance);
diff --git a/modules/bitgo/src/v2/coins/index.ts b/modules/bitgo/src/v2/coins/index.ts
@@ -46,6 +46,7 @@ import { Polyx, Tpolyx } from '@bitgo/sdk-coin-polyx';
 import { Rbtc, Trbtc } from '@bitgo/sdk-coin-rbtc';
 import { Rune, Trune } from '@bitgo/sdk-coin-rune';
 import { Sei, Tsei } from '@bitgo/sdk-coin-sei';
+import { Stt, Tstt } from '@bitgo/sdk-coin-stt';
 import { Sgb, Tsgb } from '@bitgo/sdk-coin-sgb';
 import { Sol, Tsol } from '@bitgo/sdk-coin-sol';
 import { Stx, Tstx, Sip10Token } from '@bitgo/sdk-coin-stx';
@@ -110,6 +111,7 @@ export { Rbtc, Trbtc };
 export { Rune, Trune };
 export { Sgb, Tsgb };
 export { Sol, Tsol };
+export { Stt, Tstt };
 export { Stx, Tstx, Sip10Token };
 export { Sui, Tsui, SuiToken };
 export { Tao, Ttao };
diff --git a/modules/sdk-coin-stt/.eslintignore b/modules/sdk-coin-stt/.eslintignore
@@ -0,0 +1,5 @@
+node_modules
+.idea
+public
+dist
+
diff --git a/modules/sdk-coin-stt/.gitignore b/modules/sdk-coin-stt/.gitignore
@@ -0,0 +1,3 @@
+node_modules/
+.idea/
+dist/
diff --git a/modules/sdk-coin-stt/.mocharc.yml b/modules/sdk-coin-stt/.mocharc.yml
@@ -0,0 +1,8 @@
+require: 'ts-node/register'
+timeout: '120000'
+reporter: 'min'
+reporter-option:
+  - 'cdn=true'
+  - 'json=false'
+exit: true
+spec: ['test/unit/**/*.ts']
diff --git a/modules/sdk-coin-stt/.npmignore b/modules/sdk-coin-stt/.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-stt/.prettierignore b/modules/sdk-coin-stt/.prettierignore
@@ -0,0 +1,2 @@
+.nyc_output/
+dist/
diff --git a/modules/sdk-coin-stt/.prettierrc.yml b/modules/sdk-coin-stt/.prettierrc.yml
@@ -0,0 +1,3 @@
+printWidth: 120
+singleQuote: true
+trailingComma: 'es5'
diff --git a/modules/sdk-coin-stt/CHANGELOG.md b/modules/sdk-coin-stt/CHANGELOG.md
@@ -0,0 +1,10 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+### Bug Fixes
+
+**Note:** Version bump only for package @bitgo/sdk-coin-stt
+
+### Features
diff --git a/modules/sdk-coin-stt/README.md b/modules/sdk-coin-stt/README.md
@@ -0,0 +1,29 @@
+# BitGo sdk-coin-stt
+
+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-stt`.
+
+````shell
+npm i @bitgo/sdk-api @bitgo/sdk-coin-stt```
+
+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 { stt } from '@bitgo/sdk-coin-stt';
+
+const sdk = new BitGoAPI();
+
+sdk.register('stt', Somnia.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-stt/package.json b/modules/sdk-coin-stt/package.json
@@ -0,0 +1,52 @@
+{
+  "name": "@bitgo/sdk-coin-stt",
+  "version": "1.0.0",
+  "description": "BitGo SDK coin library for Somnia",
+  "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-stt"
+  },
+  "lint-staged": {
+    "*.{js,ts}": [
+      "yarn prettier --write",
+      "yarn eslint --fix"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "nyc": {
+    "extension": [
+      ".ts"
+    ]
+  },
+  "dependencies": {
+    "@bitgo/abstract-eth": "^24.2.0",
+    "@bitgo/sdk-core": "^32.2.0",
+    "@bitgo/statics": "^51.8.0",
+    "@ethereumjs/common": "^2.6.5"
+  },
+  "devDependencies": {
+    "@bitgo/sdk-api": "^1.62.0",
+    "@bitgo/sdk-test": "^8.0.81"
+  }
+}
diff --git a/modules/sdk-coin-stt/src/index.ts b/modules/sdk-coin-stt/src/index.ts
@@ -0,0 +1,4 @@
+export * from './lib';
+export * from './stt';
+export * from './tstt';
+export * from './register';
diff --git a/modules/sdk-coin-stt/src/lib/index.ts b/modules/sdk-coin-stt/src/lib/index.ts
@@ -0,0 +1,6 @@
+import * as Utils from './utils';
+
+export { TransactionBuilder } from './transactionBuilder';
+export { TransferBuilder } from './transferBuilder';
+export { Transaction, KeyPair } from '@bitgo/abstract-eth';
+export { Utils };
diff --git a/modules/sdk-coin-stt/src/lib/resources.ts b/modules/sdk-coin-stt/src/lib/resources.ts
@@ -0,0 +1,27 @@
+import EthereumCommon from '@ethereumjs/common';
+import { coins, EthereumNetwork } from '@bitgo/statics';
+
+export const testnetCommon = EthereumCommon.custom(
+  {
+    name: 'stt testnet',
+    networkId: (coins.get('tstt').network as EthereumNetwork).chainId,
+    chainId: (coins.get('tstt').network as EthereumNetwork).chainId,
+  },
+  {
+    baseChain: 'sepolia',
+    hardfork: 'london',
+    eips: [1559],
+  }
+);
+export const mainnetCommon = EthereumCommon.custom(
+  {
+    name: 'Somnia mainnet',
+    networkId: (coins.get('stt').network as EthereumNetwork).chainId,
+    chainId: (coins.get('stt').network as EthereumNetwork).chainId,
+  },
+  {
+    baseChain: 'mainnet',
+    hardfork: 'london',
+    eips: [1559],
+  }
+);
diff --git a/modules/sdk-coin-stt/src/lib/transactionBuilder.ts b/modules/sdk-coin-stt/src/lib/transactionBuilder.ts
@@ -0,0 +1,31 @@
+import { BaseCoin as CoinConfig } from '@bitgo/statics';
+import { BuildTransactionError, PublicKey, Signature, TransactionType } from '@bitgo/sdk-core';
+import { TransactionBuilder as AbstractTransactionBuilder, Transaction } from '@bitgo/abstract-eth';
+import { getCommon } from './utils';
+import { TransferBuilder } from './transferBuilder';
+
+export class TransactionBuilder extends AbstractTransactionBuilder {
+  protected _transfer: TransferBuilder;
+  private _signatures: Signature[] = [];
+
+  constructor(_coinConfig: Readonly<CoinConfig>) {
+    super(_coinConfig);
+    this._common = getCommon(this._coinConfig.network.type);
+    this.transaction = new Transaction(this._coinConfig, this._common);
+  }
+
+  /** @inheritdoc */
+  transfer(data?: string): TransferBuilder {
+    if (this._type !== TransactionType.Send) {
+      throw new BuildTransactionError('Transfers can only be set for send transactions');
+    }
+    if (!this._transfer) {
+      this._transfer = new TransferBuilder(data);
+    }
+    return this._transfer;
+  }
+
+  addSignature(publicKey: PublicKey, signature: Buffer): void {
+    this._signatures.push({ publicKey, signature });
+  }
+}
diff --git a/modules/sdk-coin-stt/src/lib/transferBuilder.ts b/modules/sdk-coin-stt/src/lib/transferBuilder.ts
@@ -0,0 +1 @@
+export { TransferBuilder } from '@bitgo/abstract-eth';
diff --git a/modules/sdk-coin-stt/src/lib/utils.ts b/modules/sdk-coin-stt/src/lib/utils.ts
@@ -0,0 +1,21 @@
+import { NetworkType } from '@bitgo/statics';
+import EthereumCommon from '@ethereumjs/common';
+import { InvalidTransactionError } from '@bitgo/sdk-core';
+import { mainnetCommon, testnetCommon } from './resources';
+
+const commons: Map<NetworkType, EthereumCommon> = new Map<NetworkType, EthereumCommon>([
+  [NetworkType.MAINNET, mainnetCommon],
+  [NetworkType.TESTNET, testnetCommon],
+]);
+
+/**
+ * @param {NetworkType} network either mainnet or testnet
+ * @returns {EthereumCommon} Ethereum common configuration object
+ */
+export function getCommon(network: NetworkType): EthereumCommon {
+  const common = commons.get(network);
+  if (!common) {
+    throw new InvalidTransactionError('Missing network common configuration');
+  }
+  return common;
+}
diff --git a/modules/sdk-coin-stt/src/register.ts b/modules/sdk-coin-stt/src/register.ts
@@ -0,0 +1,8 @@
+import { BitGoBase } from '@bitgo/sdk-core';
+import { Stt } from './stt';
+import { Tstt } from './tstt';
+
+export const register = (sdk: BitGoBase): void => {
+  sdk.register('stt', Stt.createInstance);
+  sdk.register('tstt', Tstt.createInstance);
+};
diff --git a/modules/sdk-coin-stt/src/stt.ts b/modules/sdk-coin-stt/src/stt.ts
diff --git a/modules/sdk-coin-stt/src/tstt.ts b/modules/sdk-coin-stt/src/tstt.ts
diff --git a/modules/sdk-coin-stt/test/unit/getBuilder.ts b/modules/sdk-coin-stt/test/unit/getBuilder.ts
diff --git a/modules/sdk-coin-stt/test/unit/resources.ts b/modules/sdk-coin-stt/test/unit/resources.ts
diff --git a/modules/sdk-coin-stt/test/unit/stt.ts b/modules/sdk-coin-stt/test/unit/stt.ts
diff --git a/modules/sdk-coin-stt/test/unit/transactionBuilder/send.ts b/modules/sdk-coin-stt/test/unit/transactionBuilder/send.ts
diff --git a/modules/sdk-coin-stt/test/unit/utils.ts b/modules/sdk-coin-stt/test/unit/utils.ts
diff --git a/modules/sdk-coin-stt/tsconfig.json b/modules/sdk-coin-stt/tsconfig.json
diff --git a/modules/sdk-core/src/bitgo/environments.ts b/modules/sdk-core/src/bitgo/environments.ts
diff --git a/modules/statics/src/map.ts b/modules/statics/src/map.ts
diff --git a/modules/statics/src/networks.ts b/modules/statics/src/networks.ts
diff --git a/tsconfig.packages.json b/tsconfig.packages.json

Original file line number	Diff line number	Diff line change
`@@ -103,6 +103,9 @@`
`103`	`103`	`{`
`104`	`104`	`"path": "../sdk-coin-stx"`
`105`	`105`	`},`
	`106`	`+ {`
	`107`	`+ "path": "../sdk-coin-stt"`
	`108`	`+ },`
`106`	`109`	`{`
`107`	`110`	`"path": "../sdk-coin-tia"`
`108`	`111`	`},`
-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +node_modules
 +.idea
 +public
 +dist
++