feat: ultra exclude router param

docs/101-ultra-api/2-execute-order.md

@@ -25,6 +25,50 @@ To fully utilize the Ultra API, check out the [Ultra API Reference](/docs/api/ul
 
 Using the Solana `web3.js` **v1** library, you can sign the transaction as follows:
 
+<details>
+  <summary>
+    Set up imports and wallet for signing
+  </summary>
+
+```bash
+npm install @solana/web3.js@1 # Using v1 of web3.js instead of v2
+npm install bs58
+npm install dotenv # if required for wallet setup
+```
+
+:::note
+- You can paste in your private key for testing purposes but this is not recommended for production applications.
+- If you want to store your private key in the project directly, you can do it via a `.env` file.
+:::
+
+To set up a development wallet via `.env` file, you can use the following script.
+
+```jsx
+// index.js
+import { Keypair } from '@solana/web3.js';
+import dotenv from 'dotenv';
+require('dotenv').config();
+
+const wallet = Keypair.fromSecretKey(bs58.decode(process.env.PRIVATE_KEY || ''));
+```
+
+```bash
+# .env
+PRIVATE_KEY=""
+```
+
+To set up a development wallet via a wallet generated via [Solana CLI](https://solana.com/docs/intro/installation#solana-cli-basics), you can use the following script.
+
+```jsx
+import { Keypair } from '@solana/web3.js';
+import fs from 'fs';
+
+const privateKeyArray = JSON.parse(fs.readFileSync('/Path/To/.config/solana/id.json', 'utf8').trim());
+const wallet = Keypair.fromSecretKey(new Uint8Array(privateKeyArray));
+```
+
+</details>
+
 ```jsx
 // ... GET /order's response
 

docs/api/ultra-api/order.api.mdx

@@ -5,7 +5,7 @@ description: "Request for a base64-encoded unsigned swap transaction to be used
 sidebar_label: "order"
 hide_title: true
 hide_table_of_contents: true
-api: eJzVV0lv2zoQ/iuETi0Qx2mR9OBbCrSF0abNy3JyDJSWxhITimRIKstz8t87o8WmbFlx0FcU72JL4iwfZ/k4XEQJuNgK44VW0Sg6g9sCnGdzbRlnM+7gw+EAVKwTSFihnEgVPrh7bpi3XDkekyLzms2AFQ7XhGI/T3+cX7BhIVFkePduCA8QFx5+XqkrNRqNlPZwpQbsDOZgSXVySZLs+HTMEh1P3wzx11XqA27EMAU/0DYB+7bElWsL6AYfc07eS6NXKtqLLDijlQMXjRbR+4MD+mvv77yIY3BuXkjWCKNerJUH5UmcGyNFXNodXjvSWUQuziDn9OQfDaAVPbuG2KOisdqA9aLyKJQp/ImoDNWizluh0uh5L9KF71sW6jjXxXbdvlWfga3WLzLcVqZl0ilIeTvBVHYvSmEMT+GjccG6KvIZWFo3VsQwzg2m/DTuBmIRJ5xKroJVbi1/xFAJD7l7OYYEcYy5fVmS5/lXeOzEIfkM5JYo/50UzQH6V7c4paBiSwoLmNFJs+dmh+F+WugDrCGyEMfK65SSCzaGFoIm8WsIlvlZ6Uyfe7dQrvUUlbbCi3/LjvsM8I3nRlvfLU3OL8qP6172IkCxMkRpaiHlXlsihPkt/mbcZXOp78udBrS1SQ+XDcMR8w0+HLKG+jbJrhbkKlnx3pLp0GmFb7ICqAopSwQpdxI5KNjETGsJ2DV1rJGAx8kmuLM6DQQg5zeABF1L05cO50EKvPZcXogcOuPq0ZpdrXSBvi2QtcfdtJK31YMVeDCI+Li7LIzknkgcs75Lt/d1T3d5bTTPqvBJgbaVPCqei/i85r4zoOLbBQ2eEvP6nDij3/7oBQwdCtZAA0En8gLDAslYxYVF4OddrNyp+QJ9I1ZItX38zvOO/kGBDAornBfxCX/o9Lo9rhvBaO/4hW21sa8h3Y5ruo7jtVzYeWwGh+Q6rrUDMDzuljXVx2gBf7VpaEUJYf+HTdu0KO6Zdn3YNdp85EnDB//dSAPW6q7WXgt9JVajO+pCN0Y4VnHJHNg7HPsqjb+IkwiIWywxxIUmJjS+oSLGz9IBq8o2adXUBpZg8Fn68LaA571uY62i/G1rSzr7bUtVbe1oaM6l22rJ0khvuTyO49eA28kmHRMd9pZMmAuFLIMzwNEBHUkP1cv7o6MOV1OUAJ9p/BDh7YLKifsMX4blPYP8lGVaFUZhcZiMMu+NGw2HEidZupbsXxdmn6fLaw4qtUv+swVgWKC2vNmASozG1LN74TNmkeOYFLlAXqCNt13sYv2Ui2Sb9UykSG2hk/CGVopwVerRNEnREM3ILbykqP5TiPjGeW4pNhSIyum7/YP9gw0oT+ybUDfs6Uo9scFgUD1MvoBnPyiavRe6SvZTNbpsk68nm0CnnB+083l112garE5eC95ixTH/8+ttXfEeHvwQhydRRqGsnEVdv5M6BJjRDKNDHxYL2uallc/P9LlqLqrqRDg+k8ue6Inam2byfMu2obihm1iLLe+4LEiuLO8/4KtFpn/a2ZJr+x1Vwg2d7iK7SZiv0aoocaUxpRcrSAVTPC2HOk71QPmuVNERmNDPxqnbIscvny7wEP0F45RMsA==
+api: eJzVV0tv2zgQ/iuETi0Qx2mR9OBbCrSFsc026yQnx0BpaWwxoUiGpFK7Tv77zuhhU7asOOgWxV5kWZzHN8OZj8NVlICLrTBeaBUNohE85OA8m2nLOJtyBx9Oe6BinUDCcuXEXOGL+8EN85Yrx2NSZF6zKbDc4ZpQ7Pvlt6tr1s8livQf3/VhAXHu4futulWDwUBpD7eqx0YwA0uq4xuSZOeXQ5boePKmj09Xqve4Ef05+J62Cdi3Ba5MW0A3+Jpx8l4YvVXRUWTBGa0cuGiwit6fnNBPM76rPI7BuVkuWS2MerFWHpQncW6MFHFht3/nSGcVuTiFjNObXxpAK3p6B7FHRWO1AetF6VEok/sLURqqRJ23Qs2j56NI575rWajzTOf7dbtWfQq2XL9OMaxUy6RVkPbtAreyfVEKY/gcPhoXrKs8m4KldWNFDMPM4JZfxu1ALOKES8lVsMqt5UtMlfCQuZdzSBCHuLcvS/Is+wuWrTgkn4Lck+U/s0UzgO7VPU4pqdiSwgLu6LiOuY4wjKeBPsAaIgtxbLxOaHPBxtBAUG/8FoL1/mx0Js+dIRRrHUWlrfDiZ9FxnwG+8sxo69ulyfl18XHby1EEKFakaD63MOdeWyKE2QM+U+7SmdQ/ikgD2tqlh5ua4Yj5eh9OWU19u2RXCXKVbHhvzXTotMQ33gBUuZQFgjl3EjkoCGKqtQTsmirXSMDDZBfcqNoGApDxe0CCrqTpS4vzYAu89lxeiwxa8+rRmt2stIF+yJG1h+20kjXVgxVYGER83l4WRnJPJI67fki3d3VPe3ntNM+m8EmBwkqWimcivqq4bwRUfIegwVNiVp0TI3p2Zy9g6FCwAhoIOpHlmBZIhirOLQK/amPlVs0X6Buxwlzb5d88a+kfFEght8J5EV/wRavX/XndSUYz4hfCamLfQrof12Qbx2u5sPXYDA7JbVxbB2B43K1rqovRAv5q0tCGEsL+D5u2blGMmaI+bRttPvKk5oP/bqQBa3Vba2+lvhSr0J21oRsiHKu4ZA7sI459pcYfxEkExC2WGOJCE2Ma31AR82fpgFVFmzRqagdLMPisfXibw/NRu7FGUf6ytTWd/bKlsrYONDTj0u21ZGmkt1yex/FrwB1kk46JFntrJsyEQpbBGeDshI6kRfnn/dnZ4a5gEcs8gRH1tXUd6DfjBtaPIMm73OCEa3+G4wYeL9WvWfqUGOd+UXD1NpzJEdlJNX6I8LJDChwVBlG/uPYQkKJryjrNLc62Ueq9cYN+X6JbuiUdI4JjPl/fush7owM/WwCG/WKLixaoxGisRPZD+JRZpFwmRSaQpig5TReHWL/kItlnPRVzZNrQSXhhLES4KvRouKVsiPoGILyktP+Ti/jeeW4pN5SI0um745Pjkx0oT+yrUPfs6VY9sV6vV76Mv4Bn3yibnffLUvZTOUntk68GrUCnGGe081l59an7vdq8BrzVhvL+57ftqiU8LHwfZzlRZKGonFVVv+MqBbijKWaHPqxWFOaNlc/P9LlsQKrqRDg+leue6Mjam3oQfsv2obini2GDvB+5zEmuKO/f4KvB7b/b2Zr6ux2VwjW7HyK7y9+v0SoZ+hCNHaLdKE3ojxWkhXUxKQZTTkVERVJqIzowIbidyaHBqF8+XeMg8C91zo8S
 sidebar_class_name: "get api-method"
 info_path: docs/api/ultra-api/quickstart
 custom_edit_url: null
@@ -52,7 +52,7 @@ Request for a base64-encoded unsigned swap transaction to be used in `POST /ultr
 </Heading>
 
 <ParamsDetails
-  parameters={[{"in":"query","name":"inputMint","schema":{"type":"string"},"required":true},{"in":"query","name":"outputMint","schema":{"type":"string"},"required":true},{"in":"query","name":"amount","schema":{"type":"string"},"required":true},{"in":"query","name":"taker","schema":{"type":"string"},"required":false},{"in":"query","name":"referralAccount","schema":{"type":"string"},"required":false},{"in":"query","name":"referralFee","schema":{"type":"number","minimum":50,"maximum":255},"required":false}]}
+  parameters={[{"in":"query","name":"inputMint","schema":{"type":"string"},"required":true},{"in":"query","name":"outputMint","schema":{"type":"string"},"required":true},{"in":"query","name":"amount","schema":{"type":"string"},"required":true},{"in":"query","name":"taker","schema":{"type":"string"},"required":false},{"in":"query","name":"referralAccount","schema":{"type":"string"},"required":false},{"in":"query","name":"referralFee","schema":{"type":"number","minimum":50,"maximum":255},"required":false},{"in":"query","name":"excludeRouters","schema":{"type":"string","enum":["metis","jupiterz","hashflow","dflow","pyth","okx"]},"required":false}]}
 >
 
 </ParamsDetails>

docs/api/ultra-api/routers.api.mdx

@@ -5,7 +5,7 @@ description: "Request for the list of routers available in the routing engine of
 sidebar_label: "routers"
 hide_title: true
 hide_table_of_contents: true
-api: eJzNVEtv2zAM/iuCdlmBJE53zK3A2m7dhnWvy9IcFJuJmcqSKlFpAzf/faTtrmmLAjsuF1N88+PHtLqCVEYMhN7pmf4ONxkSqZWPimpQFvnhVyr6TBCTMluD1iwtKHSdgxjQrRW4NToQ11+Wohmp2xrLWmFS84vs/OJtUfkyFYP7mw3rxhZvMlZIu3EffXTl9EhHSMG7BEnPWv1uOpXP0yZ/5LKElFbZqgdnjiu9I3Ak7iYEi6UR92KTJKbVqayhMSLRLgBnMTGaHcchQZMO9H65gZLYEKIPEAn7TrA68EkUeQq9H2lnGnhpGGlwudGzuf4ChInfFzlwofibxQ8m1Svrb1l8fybfBefBsm/zWYG94MEoRagkGzcxlFzsu99IN0C1Z6NeQ9e0oZofhY8VxGJYG+sTxK1Is3mrc7TsUhOFNCsKy32NTcDJJoeJWRdZ9ldsjznoKexnEUAxHFGdXH7khVfBoyN1i1SraEjI0iAlRuV5iX/Jfmmwei17jeuaDQdFFHm1BJUTVL2LcV3cJ9jp/YLhdCvfwYlkBc9vGcvrRCYKRgJEX/R4Mp1MX7Ryrz6ju1b3V+5ejcfjXpifA6mvguoDl7tRBLmCoR93gB8Nvqd3UDLyr/lDbz6IESoFn6gxHQt6VunH9T1psH3k+v9wsANlCe6oCNZgN0xHgHag41x3k8pxDxPximoeV0xtuzQJfkW734uax4k71rO4NRGldXlxyhqMJBEGX/OaZ/qE/wZCt1Bjc3fSz+9eqPD3QM5Pf/JB/QGJL7cn
+api: eJzNVE1PGzEQ/SuWeylSNht66CE3JAIttILSIqGGHJzdSXaC1zb2bCDa5L937F1KACH12L3seD48M2/euJUlhMKjI7RGjuUV3DcQSCysF1SB0MgHuxDeNgQ+CLVWqNVcg0CTHKIBzVKAWaKB6HqtyauBeKiwqAQGMT1rjJ19zEtbhLx3/7BiXabxvsESaZN10Qe3Rg6kh+CsCRDkuJWfRqP4e1nkz6YoIIRFo8WTM8cV1hAYiu7KOY2Fiu75KsSYVoaiglpFiTYO+BblvdpwHBLUYU9v5ysoiA3OWweesKsEyz2fQJ67kLuBNKqGt4aBBNPUcjyV34EYg/Xh8DMrzxrH2fxvFr+oUC20fWDx+KT7X26oEpNHxz0FcQU6VXdxfiOOJzfiKg1AzjglFl1Hr2rZRegYUA9lTMz19tXNdukbyBqosmyUS0j9Kar4kFtfgs/7CbM+gF9HaTxtZeM1u1RELozzXHP1mXI4XDVuqJZ5E0edrw856OWETjyAYOS8OLr8ytwonUVD4gG5Q68o8qpGCgzg6xT/cvulwvK92ytcVmzYSyLIijmIJkDZuSiT4s5hI3czhtMsbIITSUc8fzRY3AVSPmIUgeiSHg5Hw9GbUrbiG5o7sb01W5FlWSdMT4HERUT1ifaplYhcztBnCfCD3nfyCAUj/54/dOa9mMg6ZwPVKrGgI6B8Ht+LAtvntfgfdrunLMEj5U4rTM0kArQ9HacydRrfgb4jHlHF7UZT285VgGuvd7uo5nb8hvUsrpXHWHo88ZUVqHhJZPAdj3ksj/jFcGmgSjdp+18/EZEKfxfkdPKLF+oPbsvEkg==
 sidebar_class_name: "get api-method"
 info_path: docs/api/ultra-api/quickstart
 custom_edit_url: null
@@ -55,7 +55,7 @@ Request for the list of routers available in the routing engine of Ultra, which
 <StatusCodes
   id={undefined}
   label={undefined}
-  responses={{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","enum":["Metis","JupiterZ","Hashflow","DFlow"]},"icon":{"type":"string"}},"required":["id","name"]}}}}}}}
+  responses={{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","enum":["Metis v1.6","JupiterZ","Hashflow","DFlow","Pyth Express Relay","OKX DEX Router"]},"icon":{"type":"string"}},"required":["id","name"]}}}}}}}
 >
 
 </StatusCodes>

openapi/ultra.yaml

@@ -231,6 +231,18 @@ paths:
             minimum: 50
             maximum: 255
           required: false
+        - in: query
+          name: excludeRouters
+          schema:
+            type: string
+            enum:
+              - metis
+              - jupiterz
+              - hashflow
+              - dflow
+              - pyth
+              - okx
+          required: false
   /execute:
     post:
       summary: execute
@@ -476,10 +488,12 @@ paths:
                     name:
                       type: string
                       enum:
-                        - Metis
+                        - Metis v1.6
                         - JupiterZ
                         - Hashflow
                         - DFlow
+                        - Pyth Express Relay
+                        - OKX DEX Router
                     icon:
                       type: string
                   required: