The official DSA SDK for JavaScript, available for browsers and Node.js backends.

To get started, install the DSA Connect package from npm:

npm install nubian-dsa-connect

For browsers, via jsDelivr CDN:

<script src="https://cdn.jsdelivr.net/npm/nubian-dsa-connect@latest/dist/index.bundle.js"></script>

To enable web3 calls via SDK, instantiate web3 library

// in browser
if (window.ethereum) {
  window.web3 = new Web3(window.ethereum)
} else if (window.web3) {
  window.web3 = new Web3(window.web3.currentProvider)
} else {
  window.web3 = new Web3(customProvider)
}

// in nodejs
const Web3 = require('web3')
const DSA = require('nubian-dsa-connect')
const web3 = new Web3(new Web3.providers.HttpProvider(ETH_NODE_URL))

Now instantiate DSA with web3 instance.

// in browser
const dsa = new DSA(web3)

// in nodejs
const dsa = new DSA({
  web3: web3,
  mode: 'node',
  privateKey: PRIVATE_KEY,
})

Every user needs to create Smart Account to interact with DeFi Protocols seamlessly; this allows developers to build extensible use-cases with maximum security and composability. You can also create multiple account for a single address.

• Create Smart Account - build()
• Fetch Smart Accounts - getAccounts()
• Set Smart Account - setInstance()
• Set Account Name - setAccountName()

Create a DSA Account. If the account is already created, you can use the setInstance method to activate a paricular DSA account and start casting spells.

// in async functions
await dsa.build()

// or
dsa.build().then(console.log)

The build method also accepts an optional parameters as shown below:

dsa.build({
  gasPrice: gasPrice // estimated gas price
  origin: origin,
  authority: authority,
})

View this Gist for estimation of gas price

The method returns the transaction hash.

This creates a uniquely numbered Smart Account which acts as a proxy to interact with verified DeFi protocols and each DSA has a unique ethereum address.

Fetch all the accounts owned by an ethereum address by calling getAccounts().

// in async functions
await dsa.getAccounts(address)

// or
dsa.getAccounts(address).then(console.log)

The method returns an array of objects with all the DSA accounts where address is authorised:

[
  {
      id: 52, // DSA ID
      address: "0x...", // DSA Address
      version: 1 // DSA version
  },
  ...
]

This Updates the Smart Account with an easily identifiable name.

dsa.setAccountName(dsaId, "My Smart Account")

Every smart account has a default name of Account#dsaId if a custom name has not been set for it yet.

Be sure to configure global values by calling setInstance(). You can get the id by calling getAccounts(). The configured account will be used for all subsequent calls.

dsa.setInstance(dsaId) // DSA ID

The method returns an array of objects with all the DSA accounts where address is authorised:

Spells denotes a sequence of connector functions that will achieve a given use case. Spells can comprise of any number of functions across any number of connectors.

With this SDK, performing DeFi operations on your dapp consists of creating a spells instance to add transactions. Here is where you can initiate complex transactions amongst different protocols.

Create an instance:

let spells = dsa.Spell()

Add spells that you want to execute. Think of any actions, and by just adding new SPELLS, you can wonderfully CAST transactions across protocols. Let's try to execute the following actions:

• Deposit 1 ETH to Venus protocol
• Borrow 100 DAI
• Deposit borrowed DAI on Venus

- Deposit

spells.add({
  connector: "VenusV2",
  method: "deposit",
  args: [
    "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
    "1000000000000000000", // 1 ETH (10^18 wei)
    0,
    0
  ]
})

- Borrow

spells.add({
  connector: "VenusV2",
  method: "borrow",
  args: [
    "DaiAddress",
    "100000000000000000000" // 100 Dai (10^18 wei),
    0,
    0
  ]
})

- Deposit Dai

spells.add({
  connector: "VenusV2",
  method: "deposit",
  args: [
    "DaiAddress",
    "100000000000000000000" // 100 Dai (10^18 wei),
    0,
    0
  ]
})

Note - Make sure, your smart account have the equivalent BNB balance before executing the above actions.

At last, cast your spell using cast() method.

// in async functions
let transactionHash = await spells.cast()

// or
spells.cast().then(console.log) // returns transaction hash

You can also pass an object to send optional parameters like sending ETH along with the transaction.

spells.cast({
  gasPrice: web3.utils.toWei(gasPrice, 'gwei'), // in gwei, used in node implementation.
  value: '1000000000000000000', // sending 1 BNB along the transaction.
  nonce: nonce,
})

This will send the transaction to blockchain in node implementation (or ask users to confirm the transaction on web3 wallet like Metamask).

You can see the list of transactions by an address:

dsa.getAccountTransactions("0x00");

Replace 0x0 with the address of the DSA account.

You can see the list of connectors here & here