# Safle Swaps

Safle enables decentralised swaps via the in house built swaps SDK. The SDK exposes set of functionalities required to execute a swap. Currently [1inch ](https://1inch.io/)DEX is integrated on safle swaps.

The SDK has a modular architecture where a dedicated controller for each DEX can be plugged in with just a few lines of code

### Step by step description

#### 1. Installation, import & initialisation

```jsx
npm install @getsafle/safle-swaps-v2

const Swap = require('@getsafle/safle-swaps-v2');
const swap = new Swap({ dex, rpcURL,chain });
```

* `dex` - The name of DEX using which you want to swap tokens.
* `rpcURL` - The rpc url to connect to a blockchain node.
* `chain` - The chain name of the blockchain. Supported for now - `ethereum`

#### 2. User Flow

1. User selects chain, wallet, source token, destination token and source token amount
   1. Get Supported Tokens: This method returns list of tokens supported on the dex to be populated.

      <pre class="language-javascript" data-overflow="wrap" data-full-width="true"><code class="lang-javascript">const supportedToken = await swap.getSupportedTokens();
      </code></pre>
   2. Get Exchange Rates: This method returns exchange rates for a token pair

      <pre class="language-javascript" data-overflow="wrap" data-full-width="true"><code class="lang-javascript">await swap.getExchangeRates({ toContractAddress, toContractDecimal, fromContractAddress, fromContractDecimal, fromQuantity, slippageTolerance });
      </code></pre>
2. Exchange rates, estimated slippage and estimated gas fees is displayed to user
   1. Get Estimated Gas: This method returns estimated gas for the swap transaction

      <pre class="language-javascript" data-overflow="wrap" data-full-width="true"><code class="lang-javascript">await swap.getEstimatedGas({ toContractAddress, toContractDecimal, fromContractAddress, fromContractDecimal, fromQuantity, slippageTolerance })
      </code></pre>
3. User confirms exchange rates
   1. Get Raw Transaction: This method returns the raw transaction

      <pre class="language-javascript" data-overflow="wrap" data-full-width="true"><code class="lang-javascript">await swap.getRawTransaction({ walletAddress, toContractAddress, toContractDecimal, fromContractAddress, fromContractDecimal, fromQuantity, toQuantity, slippageTolerance })
      </code></pre>
4. User continues to sign transaction. Enters vault pin to proceed
   1. Application calls vault method to sign raw transaction and enters pin

      <pre class="language-javascript" data-overflow="wrap" data-full-width="true"><code class="lang-javascript">const signedTransaction = await vault.signTransaction(rawTx, pin, chain);
      </code></pre>

      Returns the signed transaction string

      * `chain` - The chain for which the transaction is to be signed.
      * `rawTx` - The raw transaction object to be signed
      * `pin` - The pin to access the vault's private functions.
5. Signed transaction broadcasted by client application

   ![](https://prod-files-secure.s3.us-west-2.amazonaws.com/11344230-d69e-4a21-96e6-a71b74945f9f/b8081dbe-b22b-4ea5-8e64-61e335089078/swaps.svg)

   <figure><img src="/files/93PrnPcoq5Uymyd00AJu" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.safle.com/safleid/safle-wallet/safle-swaps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.