- Pull Liquidity Pools from DEX APIs or On-chain using Blockfrost / Kupo
- Submit and cancel swap orders
- Submit split swap orders across multple DEXs
- Build your own data, wallet, or asset metadata providers to plug into Dexter
- Build swap datums given specific parameters using Dexters Definition Builder
- Load wallets using a seedphrase or CIP-30 interface using Lucid
- You may need to use the flag
--experimental-specifier-resolution=nodewhen building your project to correctly import Dexter - All figures/parameters represented as a bigint are denominated in lovelaces
npm i @indigo-labs/dexter
yarn add @indigo-labs/dexter
constdexterConfig: DexterConfig={shouldFetchMetadata: true,// Whether to fetch asset metadata (Best to leave this `true` for accurate pool info)shouldFallbackToApi: true,// Only use when using Blockfrost or Kupo as data providers. On failure, fallback to the DEX API to grab necessary datashouldSubmitOrders: false,// Allow Dexter to submit orders from swap requests. Useful during developmentmetadataMsgBranding: 'Dexter',// Prepend branding name in Tx message};constrequestConfig: RequestConfig={timeout: 5000,// How long outside network requests have to replyproxyUrl: '',// URL to prepend to all outside URLs. Useful when dealing with CORsretries: 3,// Number of times to reattempt any outside request};constdexter: Dexter=newDexter(dexterConfig,requestConfig);// Basic fetch exampledexter.newFetchRequest().onAllDexs().getLiquidityPools().then((pools: LiquidityPool[])=>{console.log(pools);});// Example loading wallet to be used in a swapconstlucidProvider: BaseWalletProvider=newLucidProvider();lucidProvider.loadWallet(cip30Interface,{url: 'https://cardano-mainnet.blockfrost.io/api/v0',projectId: '<blockfrost-project-id>'}).then((walletProvider: BaseWalletProvider)=>{dexter.withWalletProvider(walletProvider).newFetchRequest()...});All providers outlined below are modular, so you can extend the 'base' of the specific provider you want to supply, and provide it to Dexter with one of the methods below.
dexByName(string): BaseDex | undefined Grab a DEX instance by name.
dexter.dexByName(Minswap.identifier)...withDataProvider(BaseDataProvider): Dexter Set where Dexter should grab liquidity pool data.
By default, Dexter will use the DEX APIs to grab information. However, you can use Blockfrost or Kupo to supply your own data.
constprovider: BaseDataProvider=newBlockfrostProvider({url: 'https://cardano-mainnet.blockfrost.io/api/v0',projectId: '<blockfrost-project-id>',});dexter.withDataProvider(provider)...withWalletProvider(BaseWalletProvider): Dexter Set who Dexter sends wallet requests to.
At this time, Dexter only supplies a Mock wallet provider & a Lucid provider. Behind the scenes, the lucid provider leverages Lucid to manage your wallet & create transactions.
constprovider: BaseWalletProvider=newLucidProvider();constseedphrase: string[]=['...'];constblockfrostConfig: BlockfrostConfig={url: 'https://cardano-mainnet.blockfrost.io/api/v0',projectId: '<blockfrost-project-id>',};provider.loadWalletFromSeedPhrase(seedphrase,blockfrostConfig).then((walletProvider: BaseWalletProvider)=>{dexter.withWalletProvider(walletProvider)...});withMetadataProvider(BaseMetadataProvider): Dexter Set where Dexter grabs necessary asset metadata.
By default, Dexter will use the Cardano Token Registry for grabbing
asset metadata. You can extend the BaseMetadataProvider interface to provide your own metadata.
constprovider: BaseMetadataProvider=newTokenRegistryProvider();dexter.withMetadataProvider(provider)...newFetchRequest(): FetchRequest Create new request for liquidity pool data.
For available methods on the FetchRequest instance, please see those specific
docs.
dexter.newFetchRequest()...newSwapRequest(): SwapRequest Create new request for a swap order.
For available methods on the SwapRequest instance, please see those specific
docs.
dexter.newSwapRequest()...newSplitSwapRequest(): SplitSwapRequest Create new request for a split swap order.
For available methods on the SplitSwapRequest instance, please see those specific
docs.
dexter.newSplitSwapRequest()...newCancelSwapRequest(): CancelSwapRequest Create new request for cancelling a swap order.
For available methods on the CancelSwapRequest instance, please see those specific
docs.
dexter.newCancelSwapRequest()...newSplitCancelSwapRequest(): SplitCancelSwapRequest Create new request for cancelling multiple swap orders.
For available methods on the SplitCancelSwapRequest instance, please see those specific
docs.
dexter.newSplitCancelSwapRequest()...