This library is responsible for building and signing transactions for account-based coins (ie: coins such as Ethereum, Algorand, EOS, Tron, etc.). This library is used by BitGo and our multi-sig wallets, however, it can be used independently, outside of our wallet ecosystem.
Below is the list of coins supported by this library -- as well as those that are on the roadmap.
| Coin | Mainnet Ticker | Testnet Ticker | Supported In Library |
|---|---|---|---|
| Tron | trx | ttrx | Yes |
| Tezos | xtz | txtz | Not yet... |
| Ethereum | eth | teth | Not yet... |
| EOS | eos | teos | Not yet... |
| Alogrand | algo | talgo | Not yet... |
| Ripple | xrp | txrp | Not yet... |
| Stellar | xlm | txlm | Not yet... |
The TranssactionBuilder class guides a user through the construction of a transaction. The purpose of the TransactionBuilder is to yield Transaction object that is able to be broadcast to the network.
Transaction objects are javascript representations of blockchain transactions that implement protocol specific validation rules. Transactions provide encoding mechanisms that allow them to be validly broadcast to their respective network.
The intention is that this library can be used in an offline environment, for offline signings.
Install the library via npm. If you plan on contributing to the project, you may wish to follow different installation instructions outlined in this doc.
$ cd <your_project>
$ npm install @bitgo/account-lib
Below is an example that demonstrates how the library can be used to build and sign a Tron testnet transaction.
Instantiate the TransactionBuilder for the coin you want to work sign with:
// Import the package (javascript import)
const accountLib = require('@bitgo/account-lib');
// or import the pacakage using typescript
import * as accountLib from '@bitgo/account-lib';
// Instantiate the Transaction Builder for Tron (testnet)
const txBuilder = new accountLib.TransactionBuilder({'coinName': 'ttrx'});Use that transaction builder instance to sign a transaction:
// Define an unsigned Tron transaction object
const unsignedBuildTransaction = {
visible: false,
txID: '80b8b9eaed51c8bba3b49f7f0e7cc5f21ac99a6f3e2893c663b544bf2c695b1d',
raw_data: {
contract: [ {
parameter: {
value: {
amount: 1718,
owner_address: '41c4530f6bfa902b7398ac773da56106a15af15f92',
to_address: '4189ffaf9da8c6fae32189b2e6dce228249b1129aa'
},
type_url: 'type.googleapis.com/protocol.TransferContract'
},
type: 'TransferContract'
} ],
ref_block_bytes: '90e4',
ref_block_hash: 'a018bf9892ddb138',
expiration: 1571811468000,
timestamp: 1571811410819
},
raw_data_hex: '0a0290e42208a018bf9892ddb13840e0c58ebadf2d5a66080112620a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412310a1541c4530f6bfa902b7398ac773da56106a15af15f9212154189ffaf9da8c6fae32189b2e6dce228249b1129aa18b60d7083878bbadf2d',
};
// Use that object to build and sign a transaction
txBuilder.from(unsignedBuildTransaction);
txBuilder.sign({
key: 'A81B2E0C55A7E2B2E837ZZC437A6397B316536196989A6F09EE49C19AD33590W'
});
const tx = txBuilder.build();If you'd like to contribute to this project, see the developer guide for contribution norms and expectations.
Note that there is a near-term goal to move this library towards a plugin-based architecture for coin registration. Until this library gets there (and this note is removed), PRs adding support for new coins will be put on hold.