Skip to content

Commit

Permalink
feat(sdk-coin-coredao): add coredao sdk skeleton
Browse files Browse the repository at this point in the history
Ticket: WIN-3696
  • Loading branch information
adarsh312 committed Nov 14, 2024
1 parent c5a1da8 commit 1b982fb
Show file tree
Hide file tree
Showing 33 changed files with 416 additions and 0 deletions.
1 change: 1 addition & 0 deletions CODEOWNERS
Validating CODEOWNERS rules …
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,7 @@
/modules/sdk-coin-avaxc/ @BitGo/ethalt-team
/modules/sdk-coin-avaxp/ @BitGo/ethalt-team
/modules/sdk-coin-bsc/ @BitGo/ethalt-team
/modules/sdk-coin-coredao/ @BitGo/ethalt-team
/modules/sdk-coin-cspr/ @BitGo/ethalt-team
/modules/sdk-coin-dot/ @BitGo/ethalt-team
/modules/sdk-coin-eos/ @BitGo/ethalt-team
Expand Down
3 changes: 3 additions & 0 deletions Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,7 @@ COPY --from=builder /tmp/bitgo/modules/sdk-coin-hbar /var/modules/sdk-coin-hbar/
COPY --from=builder /tmp/bitgo/modules/sdk-coin-injective /var/modules/sdk-coin-injective/
COPY --from=builder /tmp/bitgo/modules/sdk-coin-islm /var/modules/sdk-coin-islm/
COPY --from=builder /tmp/bitgo/modules/sdk-coin-near /var/modules/sdk-coin-near/
COPY --from=builder /tmp/bitgo/modules/sdk-coin-coredao /var/modules/sdk-coin-coredao/
COPY --from=builder /tmp/bitgo/modules/sdk-coin-opeth /var/modules/sdk-coin-opeth/
COPY --from=builder /tmp/bitgo/modules/sdk-coin-osmo /var/modules/sdk-coin-osmo/
COPY --from=builder /tmp/bitgo/modules/sdk-coin-polygon /var/modules/sdk-coin-polygon/
Expand Down Expand Up @@ -147,6 +148,7 @@ cd /var/modules/sdk-coin-hbar && yarn link && \
cd /var/modules/sdk-coin-injective && yarn link && \
cd /var/modules/sdk-coin-islm && yarn link && \
cd /var/modules/sdk-coin-near && yarn link && \
cd /var/modules/sdk-coin-coredao && yarn link && \
cd /var/modules/sdk-coin-opeth && yarn link && \
cd /var/modules/sdk-coin-osmo && yarn link && \
cd /var/modules/sdk-coin-polygon && yarn link && \
Expand Down Expand Up @@ -221,6 +223,7 @@ RUN cd /var/bitgo-express && \
yarn link @bitgo/sdk-coin-injective && \
yarn link @bitgo/sdk-coin-islm && \
yarn link @bitgo/sdk-coin-near && \
yarn link @bitgo/sdk-coin-coredao && \
yarn link @bitgo/sdk-coin-opeth && \
yarn link @bitgo/sdk-coin-osmo && \
yarn link @bitgo/sdk-coin-polygon && \
Expand Down
1 change: 1 addition & 0 deletions modules/account-lib/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@
"@bitgo/sdk-coin-bld": "^3.0.14",
"@bitgo/sdk-coin-bsc": "^22.1.29",
"@bitgo/sdk-coin-celo": "^3.0.37",
"@bitgo/sdk-coin-coredao": "^1.0.0",
"@bitgo/sdk-coin-coreum": "^21.0.14",
"@bitgo/sdk-coin-cspr": "^2.0.45",
"@bitgo/sdk-coin-dot": "^4.1.23",
Expand Down
5 changes: 5 additions & 0 deletions modules/account-lib/src/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -134,6 +134,9 @@ export { XRP };
import * as zkEth from '@bitgo/sdk-coin-zketh';
export { zkEth };

import * as Coredao from '@bitgo/sdk-coin-coredao';
export { Coredao };

const coinBuilderMap = {
trx: Trx.WrappedBuilder,
ttrx: Trx.WrappedBuilder,
Expand Down Expand Up @@ -204,6 +207,8 @@ const coinBuilderMap = {
tbera: Bera.TransactionBuilder,
rune: Rune.TransactionBuilderFactory,
trune: Rune.TransactionBuilderFactory,
coredao: Coredao.TransactionBuilder,
tcoredao: Coredao.TransactionBuilder,
};

/**
Expand Down
3 changes: 3 additions & 0 deletions modules/account-lib/tsconfig.json
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,9 @@
{
"path": "../sdk-coin-celo"
},
{
"path": "../sdk-coin-coredao"
},
{
"path": "../sdk-coin-coreum"
},
Expand Down
1 change: 1 addition & 0 deletions modules/bitgo/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,7 @@
"@bitgo/sdk-coin-btc": "^2.3.6",
"@bitgo/sdk-coin-btg": "^2.0.45",
"@bitgo/sdk-coin-celo": "^3.0.37",
"@bitgo/sdk-coin-coredao": "^1.0.0",
"@bitgo/sdk-coin-coreum": "^21.0.14",
"@bitgo/sdk-coin-cspr": "^2.0.45",
"@bitgo/sdk-coin-dash": "^2.0.45",
Expand Down
4 changes: 4 additions & 0 deletions modules/bitgo/src/v2/coinFactory.ts
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ import {
Btg,
Celo,
CeloToken,
Coredao,
Coreum,
Cspr,
Dash,
Expand Down Expand Up @@ -88,6 +89,7 @@ import {
Tbtc4,
Tbtcbgsig,
Tcelo,
Tcoredao,
Tcoreum,
Tcspr,
Tdash,
Expand Down Expand Up @@ -153,6 +155,7 @@ function registerCoinConstructors(globalCoinFactory: CoinFactory): void {
globalCoinFactory.register('btc', Btc.createInstance);
globalCoinFactory.register('btg', Btg.createInstance);
globalCoinFactory.register('celo', Celo.createInstance);
globalCoinFactory.register('coredao', Coredao.createInstance);
globalCoinFactory.register('coreum', Coreum.createInstance);
globalCoinFactory.register('cspr', Cspr.createInstance);
globalCoinFactory.register('dash', Dash.createInstance);
Expand Down Expand Up @@ -207,6 +210,7 @@ function registerCoinConstructors(globalCoinFactory: CoinFactory): void {
globalCoinFactory.register('tbtc4', Tbtc4.createInstance);
globalCoinFactory.register('tbtcbgsig', Tbtcbgsig.createInstance);
globalCoinFactory.register('tcelo', Tcelo.createInstance);
globalCoinFactory.register('tcoredao', Tcoredao.createInstance);
globalCoinFactory.register('tcoreum', Tcoreum.createInstance);
globalCoinFactory.register('tcspr', Tcspr.createInstance);
globalCoinFactory.register('tdash', Tdash.createInstance);
Expand Down
2 changes: 2 additions & 0 deletions modules/bitgo/src/v2/coins/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ import { Bsv, Tbsv } from '@bitgo/sdk-coin-bsv';
import { Btc, Tbtc, Tbtcsig, Tbtc4, Tbtcbgsig } from '@bitgo/sdk-coin-btc';
import { Btg } from '@bitgo/sdk-coin-btg';
import { Celo, CeloToken, Tcelo } from '@bitgo/sdk-coin-celo';
import { Coredao, Tcoredao } from '@bitgo/sdk-coin-coredao';
import { Coreum, Tcoreum } from '@bitgo/sdk-coin-coreum';
import { Cspr, Tcspr } from '@bitgo/sdk-coin-cspr';
import { Dash, Tdash } from '@bitgo/sdk-coin-dash';
Expand Down Expand Up @@ -66,6 +67,7 @@ export { Bsv, Tbsv };
export { Btc, Tbtc, Tbtcsig, Tbtc4, Tbtcbgsig };
export { Btg };
export { Celo, CeloToken, Tcelo };
export { Coredao, Tcoredao };
export { Coreum, Tcoreum };
export { Cspr, Tcspr };
export { Dash, Tdash };
Expand Down
3 changes: 3 additions & 0 deletions modules/bitgo/tsconfig.json
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,9 @@
{
"path": "../sdk-coin-celo"
},
{
"path": "../sdk-coin-coredao"
},
{
"path": "../sdk-coin-coreum"
},
Expand Down
5 changes: 5 additions & 0 deletions modules/sdk-coin-coredao/.eslintignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
node_modules
.idea
public
dist

3 changes: 3 additions & 0 deletions modules/sdk-coin-coredao/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
node_modules/
.idea/
dist/
8 changes: 8 additions & 0 deletions modules/sdk-coin-coredao/.mocharc.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
require: 'ts-node/register'
timeout: '120000'
reporter: 'min'
reporter-option:
- 'cdn=true'
- 'json=false'
exit: true
spec: ['test/unit/**/*.ts']
14 changes: 14 additions & 0 deletions modules/sdk-coin-coredao/.npmignore
Original file line number Diff line number Diff line change
@@ -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
2 changes: 2 additions & 0 deletions modules/sdk-coin-coredao/.prettierignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
.nyc_output/
dist/
3 changes: 3 additions & 0 deletions modules/sdk-coin-coredao/.prettierrc.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
printWidth: 120
singleQuote: true
trailingComma: 'es5'
30 changes: 30 additions & 0 deletions modules/sdk-coin-coredao/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# BitGo sdk-coin-coredao

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-coredao`.

```shell
npm i @bitgo/sdk-api @bitgo/sdk-coin-coredao
```

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 { Coredao } from '@bitgo/sdk-coin-coredao';

const sdk = new BitGoAPI();

sdk.register('coredao', Coredao.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.
52 changes: 52 additions & 0 deletions modules/sdk-coin-coredao/package.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
{
"name": "@bitgo/sdk-coin-coredao",
"version": "1.0.0",
"description": "BitGo SDK coin library for Coredao",
"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 <[email protected]>",
"license": "MIT",
"engines": {
"node": ">=18 <21"
},
"repository": {
"type": "git",
"url": "https://github.com/BitGo/BitGoJS.git",
"directory": "modules/sdk-coin-coredao"
},
"lint-staged": {
"*.{js,ts}": [
"yarn prettier --write",
"yarn eslint --fix"
]
},
"publishConfig": {
"access": "public"
},
"nyc": {
"extension": [
".ts"
]
},
"dependencies": {
"@bitgo/abstract-eth": "^22.3.1",
"@bitgo/sdk-core": "^28.13.1",
"@bitgo/statics": "^50.6.0",
"@ethereumjs/common": "^2.6.5"
},
"devDependencies": {
"@bitgo/sdk-api": "^1.56.3",
"@bitgo/sdk-test": "^8.0.50"
}
}
34 changes: 34 additions & 0 deletions modules/sdk-coin-coredao/src/coredao.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
import { BaseCoin, BitGoBase, common, MPCAlgorithm } from '@bitgo/sdk-core';
import { BaseCoin as StaticsBaseCoin, coins } from '@bitgo/statics';
import { AbstractEthLikeNewCoins, recoveryBlockchainExplorerQuery } from '@bitgo/abstract-eth';
import { TransactionBuilder } from './lib';

export class Coredao extends AbstractEthLikeNewCoins {
protected constructor(bitgo: BitGoBase, staticsCoin?: Readonly<StaticsBaseCoin>) {
super(bitgo, staticsCoin);
}

static createInstance(bitgo: BitGoBase, staticsCoin?: Readonly<StaticsBaseCoin>): BaseCoin {
return new Coredao(bitgo, staticsCoin);
}

protected getTransactionBuilder(): TransactionBuilder {
return new TransactionBuilder(coins.get(this.getBaseChain()));
}

/** @inheritDoc */
supportsTss(): boolean {
return true;
}

/** @inheritDoc */
getMPCAlgorithm(): MPCAlgorithm {
return 'ecdsa';
}

async recoveryBlockchainExplorerQuery(query: Record<string, string>): Promise<Record<string, unknown>> {
const apiToken = common.Environments[this.bitgo.getEnv()].coredaoExplorerApiToken;
const explorerUrl = common.Environments[this.bitgo.getEnv()].coredaoExplorerBaseUrl;
return await recoveryBlockchainExplorerQuery(query, explorerUrl as string, apiToken);
}
}
4 changes: 4 additions & 0 deletions modules/sdk-coin-coredao/src/index.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
export * from './lib';
export * from './coredao';
export * from './tcoredao';
export * from './register';
5 changes: 5 additions & 0 deletions modules/sdk-coin-coredao/src/lib/index.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
import * as Utils from './utils';

export { TransactionBuilder } from './transactionBuilder';
export { TransferBuilder } from './transferBuilder';
export { Utils };
28 changes: 28 additions & 0 deletions modules/sdk-coin-coredao/src/lib/resources.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
import EthereumCommon from '@ethereumjs/common';
import { coins, EthereumNetwork } from '@bitgo/statics';

export const testnetCommon = EthereumCommon.custom(
{
name: 'coredao testnet',
networkId: (coins.get('tcoredao').network as EthereumNetwork).chainId,
chainId: (coins.get('tcoredao').network as EthereumNetwork).chainId,
},
{
baseChain: 'sepolia',
hardfork: 'london',
eips: [1559],
}
);

export const mainnetCommon = EthereumCommon.custom(
{
name: 'coredao mainnet',
networkId: (coins.get('coredao').network as EthereumNetwork).chainId,
chainId: (coins.get('coredao').network as EthereumNetwork).chainId,
},
{
baseChain: 'mainnet',
hardfork: 'london',
eips: [1559],
}
);
30 changes: 30 additions & 0 deletions modules/sdk-coin-coredao/src/lib/transactionBuilder.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
import { BaseCoin as CoinConfig } from '@bitgo/statics';
import { BuildTransactionError, 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;

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;
}

protected getContractData(addresses: string[]): string {
throw new Error('Method not implemented.');
}
}
1 change: 1 addition & 0 deletions modules/sdk-coin-coredao/src/lib/transferBuilder.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
export { TransferBuilder } from '@bitgo/abstract-eth';
21 changes: 21 additions & 0 deletions modules/sdk-coin-coredao/src/lib/utils.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
import { NetworkType } from '@bitgo/statics';
import EthereumCommon from '@ethereumjs/common';
import { InvalidTransactionError } from '@bitgo/sdk-core';
import { testnetCommon, mainnetCommon } 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;
}
8 changes: 8 additions & 0 deletions modules/sdk-coin-coredao/src/register.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
import { BitGoBase } from '@bitgo/sdk-core';
import { Coredao } from './coredao';
import { Tcoredao } from './tcoredao';

export const register = (sdk: BitGoBase): void => {
sdk.register('coredao', Coredao.createInstance);
sdk.register('tcoredao', Tcoredao.createInstance);
};
Loading

0 comments on commit 1b982fb

Please sign in to comment.