npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@abmprotocl/dtbtc

v0.1.0

Published

Library for interacting with the dotBtc coin sysm.

Downloads

17

Readme

Dai.js

GitHub License NPM Build Status Coverage Status Bundle Size

Dai.js is a JavaScript library that makes it easy to build applications on top of MakerDAO's Dai Stablecoin System. You can use Maker's contracts to open Collateralized Debt Positions, withdraw loans in Dai, trade tokens on OasisDEX, and more.

The library features a pluggable, service-based architecture, which allows users maximal control when integrating the Maker functionality into existing infrastructures. It also includes convenient configuration presets for out-of-the-box usability, a powerful smart contract state inspector, and support for both front-end and back-end applications.

Maker's entire suite of contracts will eventually be accessible through this library—including the DAO governance and the upcoming multi-collateral release—but functionality is limited in the current alpha version to the following areas:

  • Opening and shutting CDPs
  • Locking and unlocking collateral
  • Withdrawing and repaying Dai
  • Automated token conversions
  • Token contract functionality for WETH, PETH, MKR, Dai, and ETH
  • Buying and selling MKR and Dai with built-in DEX integration

Usage

Use NPM or Yarn to install the library:

npm install @makerdao/dai

Then include it:

import Maker from '@makerdao/dai';
// or:
const Maker = require('@makerdao/dai');

Example for transferring Dai:

import Maker from '@makerdao/dai';
const maker = Maker.create('test');
await maker.authenticate();

transferDai(address, amount) {
  const dai = maker.service('token').getToken('DAI');
  return dai.transfer(address, amount);
 }

Example for using CDPs:

import Maker from '@makerdao/dai';
const maker = Maker.create('test');
await maker.authenticate();
const cdp = await maker.openCdp();
const info = await cdp.getInfo();
console.log(info);

For full documentation, please refer to docs.makerdao.com.

For example code that consumes the library, check out this repository.

Developing

  1. git clone https://github.com/makerdao/dai.js
  2. yarn install
  3. Install testchain - git submodule update --init --recursive
  4. Install dapptools - curl https://dapp.tools/install | sh

Running the unit tests

The test suite is configured to run on a Ganache test chain. Before running the tests with yarn test, the test chain will start from a snapshot that has the Maker contracts deployed to it.

If you want to re-run the tests whenever you make a change to the code, use yarn test:watch.

If you want to start a test chain and leave it running, use yarn test:net.

Running the integration tests

There are also automated tests that send transactions through either the Kovan test network or the Ethereum main network. To use them, first set your private key for the appropriate network to an environment variable:

export PRIVATE_KEY="0x..."

Then, use either yarn test:kovan or yarn test:mainnet to run the tests.

Since these networks run much more slowly than Ganache, you might want to set the debug environment variable (in order to see some relevant output along the way):

export DEBUG="dai:testing"

You can also run these tests on the local test network with the command yarn test:integration.

Handling changes to contract code

If you have deployed contract code changes to the testchain, run scripts/install-testchain-outputs.sh to copy any updated ABI files and contract addresses to their expected locations.

Commands

  • yarn build:cjs - create a commonJS build in dist folder
  • yarn build:umd - create a UMD build in umd folder
  • yarn lint - run an ESLint check
  • yarn coverage - run code coverage and generate report in the coverage folder
  • yarn test - start a test chain and run all tests
  • yarn test:watch - start a test chain and run all tests in watch mode
  • yarn test:net - just start a test chain
  • yarn test:kovan - run integration tests on Kovan
  • yarn test:mainnet - run integration tests on mainnet
  • yarn test:integration - run integration tests on Ganache

Changelog

0.17.0

  • BREAKING CHANGE: Importing a file directly from the package must now be done by prefixing the path with dist. E.g. /contracts/addresses/kovan.json now becomes /dist/contract/addresses/kovan.json.

License

Dai.js is available under the MIT license included with the code.