@amra-finance/yin
v0.26.9
Published
Library for interacting with the Yin Stablecoin System.
Downloads
25
Maintainers
Readme
Yin.js
Yin.js is a JavaScript library that makes it easy to build applications on top of Amra's Yin Stablecoin System. You can use Amra's contracts to open Collateralized Debt Positions and withdraw loans in Yin.
The library features a pluggable, service-based architecture, which allows users maximal control when integrating the Amra 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.
Usage
Use NPM or Yarn to install the library:
npm install @amra-finance/yin
Then include it:
import Amra from '@amra-finance/yin';
// or:
const Amra = require('@amra-finance/yin');
For full documentation, please refer to the wiki.
For example code that consumes the library, check out this repository.
Developing
git clone https://github.com/amra-finance/yin.js
yarn install
- Install testchain -
git submodule update --init --recursive
- 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 Amra 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="yin: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:backend
- create backend build indist
folderyarn build:frontend
- create a UMD build indist
folderyarn lint
- run an ESLint checkyarn coverage
- run code coverage and generate report in thecoverage
folderyarn test
- start a test chain and run all testsyarn test:watch
- start a test chain and run all tests in watch modeyarn test:net
- just start a test chainyarn test:kovan
- run integration tests on Kovanyarn test:mainnet
- run integration tests on mainnetyarn 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
Yin.js is available under the MIT license included with the code.