Deflex SDK (Javascript)
Deflex Javascript SDK for order routing and limit orders.
Installation
Run: npm install @deflex/deflex-sdk-js
Order Routing
Fetch Deflex Quote
To fetch an Deflex quote, initialize the client and use:
-
getFixedInputSwapQuote
for a fixed input swap -
getFixedOutputSwapQuote
for a fixed output swap
Example (for fixed input):
import {DeflexOrderRouterClient} from 'deflex-sdk-js'
import algosdk from 'algosdk'
const token = '<INSERT ALGOD TOKEN>'
const uri = '<INSERT ALGOD URI>'
const sender = algosdk.mnemonicToSecretKey('bottom stone elegant just symbol bunker review curve laugh burden jewel pepper replace north tornado alert relief wrist better property spider picture insect abandon tuna')
const client = deflex.DeflexOrderRouterClient.fetchTestnetClient(uri, token, '', sender.addr)
const quote = await client.getFixedInputSwapQuote(0, 10458941, 1000000)
const algod = new algosdk.Algodv2(token, uri, '')
const params = await algod.getTransactionParams().do()
const requiredAppOptIns = quote.requiredAppOptIns
// opt into required app for swap
const accountInfo = await algod.accountInformation(sender.addr).do()
const optedInAppIds = 'apps-local-state' in accountInfo ? accountInfo['apps-local-state'].map((state) => parseInt(state.id)) : []
for (let i = 0; i < requiredAppOptIns.length; i++) {
const requiredAppId = requiredAppOptIns[i]
if (!optedInAppIds.includes(requiredAppId)) {
const appOptInTxn = algosdk.makeApplicationOptInTxn(sender.addr, params, requiredAppId)
const signedTxn = appOptInTxn.signTxn(sender.sk)
await algod
.sendRawTransaction(signedTxn)
.do();
}
}
Fetch Transaction Group for Executing Deflex Quote
To fetch the transaction group for executing an Deflex quote,
use getSwapQuoteTransactions
.
Example (using quote from example above):
...
const slippage = 0.5
const txnGroup = await client.getSwapQuoteTransactions(swapperAddress, quote.txnPayload, slippage)
const signedTxns = txnGroup.txns.map((txn) => {
if (txn.logicSigBlob !== false) {
return txn.logicSigBlob
} else {
let bytes = new Uint8Array(Buffer.from(txn.data, 'base64'))
const decoded = algosdk.decodeUnsignedTransaction(bytes)
return algosdk.signTransaction(decoded, sender.sk).blob
}
})
const {txId} = await algod
.sendRawTransaction(signedTxns)
.do();
console.log(txId)
Limit Orders
To manage (create and cancel) limit orders, first create a DeflexLimitOrderPlatformClient
and make sure a limit order application has been created for the user.
See examples/limitOrderExample.js
for an example usage.
To fill limit orders, create a DeflexLimitOrderFillerClient
.
See examples/limitOrderExample.js
for an example usage.