Configuration

Maker.create

You can configure the behavior of Dai.js by passing different arguments to Maker.create. The first argument is the name of a preset, and the second is an options object.

Presets

  • 'browser'

    • Use this preset when using the library in a browser environment. It will attempt to connect using window.ethereum or window.web3.

  • 'http'

    • Connect to a JSON-RPC node. Requires url to be set in the options.

  • 'test'

    • Use a local node (e.g. Ganache) running at http://127.0.0.1:2000, and sign transactions using node-managed keys.

const makerBrowser = await Maker.create('browser');
const makerHttp = await Maker.create('http', {
url: 'https://kovan.infura.io/v3/YOUR_INFURA_PROJECT_ID'
});
const makerTest = await Maker.create('test');

Options

  • privateKey

    • Optional. The private key used to sign transactions. If this is omitted, the first account available from the Ethereum provider will be used. Only used with the 'http' preset.

    • If this is omitted and the provider does not have an unlocked account, the maker object will start in read-only mode.

  • url

    • The URL of the node to connect to. Only used with the 'http' preset.

  • web3.transactionSettings

    • Object containing transaction options to be applied to all transactions sent through the library.

    • Default value: { gasLimit: 4000000 }

  • web3.confirmedBlockCount

    • Number of blocks to wait after a transaction has been mined when calling confirm. See Transactions for further explanation.

    • Default value: 5

  • web3.inject

    • For advanced users. You can inject your own custom instance of a Web3 provider with this, instead of using the default HttpProvider.

  • log

    • Set this to false to reduce the verbosity of logging.

  • autoAuthenticate

    • Set this to false to create the Maker instance without connecting yet. If so, you must run await maker.authenticate() before using any other methods.

// It doesn't necessarily make sense to set all these
// options at the same time (e.g. `url` and `inject`),
// this is just meant to illustrate the shape of the
// options object.
const maker = await Maker.create('http', {
privateKey: YOUR_PRIVATE_KEY, // '0xabc...'
url: 'http://some-ethereum-rpc-node.net',
web3: {
statusTimerDelay: 2000,
confirmedBlockCount: 8
transactionSettings: {
gasPrice: 12000000000
},
inject: someProviderInstance
},
log: false,
autoAuthenticate: false
});

Instance methods

service()

  • Returns: service object

Return a service instance that was included in this instance of maker.

const accountsService = maker.service('accounts');

Services

The MCD plugin defines several services for working with Multi-Collateral Dai. Review Getting started to see how to add the plugin.

Read-only mode

As mentioned above, the Maker instance can be used in read-only mode, if you just want to read data from the blockchain without signing any transactions. Simply omit the privateKey option.

You can start in read-only mode and still add an account with the ability to sign transactions later on.