Product
Introducing Enhanced Alert Actions and Triage Functionality
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
bxdfi-dsa-connect
Advanced tools
Readme
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 dsa-connect
For browsers, via jsDelivr CDN:
<script src="https://cdn.jsdelivr.net/npm/dsa-connect@latest/dist/index.bundle.min.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('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.
build()
getAccounts()
setInstance()
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
Parameter | Type | Description |
---|---|---|
gasPrice | string/number | The gas price in gwei. Mostly used in Node implementation to configure the transaction confirmation speed. |
origin | address | The address to track the origin of transaction. Used for analytics and affiliates. |
authority | address | The DSA authority. The address to be added as authority. |
from | address | The account with which you want to create your DSA. This is helpful to create DSA for other addresses. |
nonce | string/number | Nonce of your sender account. Mostly used in Node implementation to send transaction with a particular nonce either to override unconfirmed transaction or some other purpose. |
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)
Parameter | Type | Description |
---|---|---|
address | address | An ethereum address. |
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
},
...
]
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
Parameter | Type | Description |
---|---|---|
dsaId | Number | DSA ID to be used for casting. |
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:
spells.add({
connector: "pancakeswap",
method: "deposit",
args: [
"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"1000000000000000000", // 1 ETH (10^18 wei)
0,
0
]
})
)
Note - Make sure, your smart account have the equivalent ETH 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 Eth along the transaction.
nonce: nonce,
})
Parameter (optional) | Type | Description |
---|---|---|
gasPrice | string/number | The gas price in gwei. Mostly used in Node implementation to configure the transaction confirmation speed. |
value | string/number | Amount of ETH which you want to send along with the transaction (in wei). |
nonce | string/number | Nonce of your sender account. Mostly used in Node implementation to send transaction with a particular nonce either to override unconfirmed transaction or some other purpose. |
This will send the transaction to blockchain in node implementation (or ask users to confirm the transaction on web3 wallet like Metamask).
FAQs
BXDFI DSA connect
The npm package bxdfi-dsa-connect receives a total of 20 weekly downloads. As such, bxdfi-dsa-connect popularity was classified as not popular.
We found that bxdfi-dsa-connect demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
Security News
Polyfill.io has been serving malware for months via its CDN, after the project's open source maintainer sold the service to a company based in China.
Security News
OpenSSF is warning open source maintainers to stay vigilant against reputation farming on GitHub, where users artificially inflate their status by manipulating interactions on closed issues and PRs.