@7kprotocol/sdk-ts 3.5.1 → 3.5.2-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. package/lib/cjs/config/index.js +9 -0
  2. package/lib/cjs/features/metaAg/common.js +117 -0
  3. package/lib/cjs/features/metaAg/index.js +98 -108
  4. package/lib/cjs/features/metaAg/providers/astro.js +43 -0
  5. package/lib/cjs/features/metaAg/providers/bluefin.js +6 -6
  6. package/lib/cjs/features/metaAg/providers/bluefinx.js +87 -0
  7. package/lib/cjs/features/metaAg/providers/cetus.js +4 -4
  8. package/lib/cjs/features/metaAg/providers/flowx.js +4 -4
  9. package/lib/cjs/features/metaAg/providers/okx.js +181 -0
  10. package/lib/cjs/features/swap/buildTx.js +3 -0
  11. package/lib/cjs/features/swap/buildTxV2.js +10 -6
  12. package/lib/cjs/features/swap/config.js +2 -1
  13. package/lib/cjs/features/swap/getQuote.js +3 -2
  14. package/lib/cjs/libs/protocols/bluefinx/client.js +1 -1
  15. package/lib/cjs/types/config/index.d.ts +4 -0
  16. package/lib/cjs/types/config/index.d.ts.map +1 -1
  17. package/lib/cjs/types/features/metaAg/common.d.ts +33 -0
  18. package/lib/cjs/types/features/metaAg/common.d.ts.map +1 -0
  19. package/lib/cjs/types/features/metaAg/index.d.ts +11 -2
  20. package/lib/cjs/types/features/metaAg/index.d.ts.map +1 -1
  21. package/lib/cjs/types/features/metaAg/providers/astro.d.ts +9 -0
  22. package/lib/cjs/types/features/metaAg/providers/astro.d.ts.map +1 -0
  23. package/lib/cjs/types/features/metaAg/providers/bluefin.d.ts +3 -3
  24. package/lib/cjs/types/features/metaAg/providers/bluefin.d.ts.map +1 -1
  25. package/lib/cjs/types/features/metaAg/providers/bluefinx.d.ts +10 -0
  26. package/lib/cjs/types/features/metaAg/providers/bluefinx.d.ts.map +1 -0
  27. package/lib/cjs/types/features/metaAg/providers/cetus.d.ts +4 -5
  28. package/lib/cjs/types/features/metaAg/providers/cetus.d.ts.map +1 -1
  29. package/lib/cjs/types/features/metaAg/providers/flowx.d.ts +3 -3
  30. package/lib/cjs/types/features/metaAg/providers/flowx.d.ts.map +1 -1
  31. package/lib/cjs/types/features/metaAg/providers/okx.d.ts +21 -0
  32. package/lib/cjs/types/features/metaAg/providers/okx.d.ts.map +1 -0
  33. package/lib/cjs/types/features/swap/buildTx.d.ts.map +1 -1
  34. package/lib/cjs/types/features/swap/buildTxV2.d.ts +3 -3
  35. package/lib/cjs/types/features/swap/buildTxV2.d.ts.map +1 -1
  36. package/lib/cjs/types/features/swap/config.d.ts.map +1 -1
  37. package/lib/cjs/types/features/swap/getQuote.d.ts +1 -3
  38. package/lib/cjs/types/features/swap/getQuote.d.ts.map +1 -1
  39. package/lib/cjs/types/index.d.ts +3 -1
  40. package/lib/cjs/types/index.d.ts.map +1 -1
  41. package/lib/cjs/types/metaAg.js +11 -4
  42. package/lib/cjs/types/okx.js +6 -0
  43. package/lib/cjs/types/types/metaAg.d.ts +60 -8
  44. package/lib/cjs/types/types/metaAg.d.ts.map +1 -1
  45. package/lib/cjs/types/types/okx.d.ts +193 -0
  46. package/lib/cjs/types/types/okx.d.ts.map +1 -0
  47. package/lib/cjs/types/utils/condition.d.ts +1 -1
  48. package/lib/cjs/types/utils/condition.d.ts.map +1 -1
  49. package/lib/esm/config/index.js +9 -0
  50. package/lib/esm/features/metaAg/common.js +109 -0
  51. package/lib/esm/features/metaAg/index.js +99 -109
  52. package/lib/esm/features/metaAg/providers/astro.js +40 -0
  53. package/lib/esm/features/metaAg/providers/bluefin.js +6 -6
  54. package/lib/esm/features/metaAg/providers/bluefinx.js +84 -0
  55. package/lib/esm/features/metaAg/providers/cetus.js +4 -4
  56. package/lib/esm/features/metaAg/providers/flowx.js +4 -4
  57. package/lib/esm/features/metaAg/providers/okx.js +146 -0
  58. package/lib/esm/features/swap/buildTx.js +3 -0
  59. package/lib/esm/features/swap/buildTxV2.js +6 -2
  60. package/lib/esm/features/swap/config.js +2 -1
  61. package/lib/esm/features/swap/getQuote.js +3 -2
  62. package/lib/esm/libs/protocols/bluefinx/client.js +1 -1
  63. package/lib/esm/types/config/index.d.ts +4 -0
  64. package/lib/esm/types/config/index.d.ts.map +1 -1
  65. package/lib/esm/types/features/metaAg/common.d.ts +33 -0
  66. package/lib/esm/types/features/metaAg/common.d.ts.map +1 -0
  67. package/lib/esm/types/features/metaAg/index.d.ts +11 -2
  68. package/lib/esm/types/features/metaAg/index.d.ts.map +1 -1
  69. package/lib/esm/types/features/metaAg/providers/astro.d.ts +9 -0
  70. package/lib/esm/types/features/metaAg/providers/astro.d.ts.map +1 -0
  71. package/lib/esm/types/features/metaAg/providers/bluefin.d.ts +3 -3
  72. package/lib/esm/types/features/metaAg/providers/bluefin.d.ts.map +1 -1
  73. package/lib/esm/types/features/metaAg/providers/bluefinx.d.ts +10 -0
  74. package/lib/esm/types/features/metaAg/providers/bluefinx.d.ts.map +1 -0
  75. package/lib/esm/types/features/metaAg/providers/cetus.d.ts +4 -5
  76. package/lib/esm/types/features/metaAg/providers/cetus.d.ts.map +1 -1
  77. package/lib/esm/types/features/metaAg/providers/flowx.d.ts +3 -3
  78. package/lib/esm/types/features/metaAg/providers/flowx.d.ts.map +1 -1
  79. package/lib/esm/types/features/metaAg/providers/okx.d.ts +21 -0
  80. package/lib/esm/types/features/metaAg/providers/okx.d.ts.map +1 -0
  81. package/lib/esm/types/features/swap/buildTx.d.ts.map +1 -1
  82. package/lib/esm/types/features/swap/buildTxV2.d.ts +3 -3
  83. package/lib/esm/types/features/swap/buildTxV2.d.ts.map +1 -1
  84. package/lib/esm/types/features/swap/config.d.ts.map +1 -1
  85. package/lib/esm/types/features/swap/getQuote.d.ts +1 -3
  86. package/lib/esm/types/features/swap/getQuote.d.ts.map +1 -1
  87. package/lib/esm/types/index.d.ts +3 -1
  88. package/lib/esm/types/index.d.ts.map +1 -1
  89. package/lib/esm/types/metaAg.js +8 -2
  90. package/lib/esm/types/okx.js +5 -0
  91. package/lib/esm/types/types/metaAg.d.ts +60 -8
  92. package/lib/esm/types/types/metaAg.d.ts.map +1 -1
  93. package/lib/esm/types/types/okx.d.ts +193 -0
  94. package/lib/esm/types/types/okx.d.ts.map +1 -0
  95. package/lib/esm/types/utils/condition.d.ts +1 -1
  96. package/lib/esm/types/utils/condition.d.ts.map +1 -1
  97. package/package.json +3 -2
@@ -1,18 +1,22 @@
1
- import { getFullnodeUrl, SuiClient } from "@mysten/sui/client";
1
+ import { getFullnodeUrl, SuiClient, } from "@mysten/sui/client";
2
2
  import { coinWithBalance, Transaction, } from "@mysten/sui/transactions";
3
- import { normalizeStructTag } from "@mysten/sui/utils";
4
- import { _7K_META_CONFIG, _7K_META_PACKAGE_ID, _7K_META_PUBLISHED_AT, _7K_META_VAULT, } from "../../constants/_7k";
3
+ import { normalizeStructTag, toBase64 } from "@mysten/sui/utils";
5
4
  import { SUI_ADDRESS_ZERO } from "../../constants/sui";
6
- import { EProvider, } from "../../types/metaAg";
5
+ import { EProvider, isAggregatorProvider, isSwapAPIProvider, } from "../../types/metaAg";
7
6
  import { assert } from "../../utils/condition";
8
7
  import { SuiClientUtils } from "../../utils/SuiClientUtils";
9
8
  import { getExpectedReturn } from "../swap/buildTx";
9
+ import { metaSettle, simulateAggregator, simulateBluefinX, timeout, } from "./common";
10
10
  import { BluefinProvider } from "./providers/bluefin";
11
+ import { BluefinXProvider } from "./providers/bluefinx";
12
+ import { OkxProvider, simulateOKXSwap } from "./providers/okx";
11
13
  const HERMES_API = "https://hermes.pyth.network";
12
14
  const DEFAULT_PROVIDERS = {
13
15
  [EProvider.BLUEFIN7K]: {},
14
16
  [EProvider.FLOWX]: {},
15
17
  [EProvider.CETUS]: {},
18
+ [EProvider.ASTRO]: {},
19
+ [EProvider.BLUEFINX]: {},
16
20
  };
17
21
  export class MetaAg {
18
22
  client;
@@ -52,6 +56,16 @@ export class MetaAg {
52
56
  const { CetusProvider } = await import("./providers/cetus").catch(catchImportError(EProvider.CETUS));
53
57
  this.providers[EProvider.CETUS] = new CetusProvider(providerOptions, this.options, this.client);
54
58
  break;
59
+ case EProvider.OKX:
60
+ this.providers[EProvider.OKX] = new OkxProvider(providerOptions, this.options, this.client);
61
+ break;
62
+ case EProvider.BLUEFINX:
63
+ this.providers[EProvider.BLUEFINX] = new BluefinXProvider(providerOptions);
64
+ break;
65
+ case EProvider.ASTRO:
66
+ const { AstroProvider } = await import("./providers/astro").catch(catchImportError(EProvider.ASTRO));
67
+ this.providers[EProvider.ASTRO] = new AstroProvider(providerOptions);
68
+ break;
55
69
  default:
56
70
  throw new Error(`Provider not supported: ${provider}`);
57
71
  }
@@ -59,62 +73,56 @@ export class MetaAg {
59
73
  }
60
74
  async _simulate(provider, quote, simulation) {
61
75
  try {
62
- const tx = new Transaction();
63
- const id = quote.id;
64
- const coinOut = await provider.swap({
65
- quote,
66
- coinIn: coinWithBalance({
67
- balance: BigInt(quote.amountIn),
68
- type: quote.coinTypeIn,
69
- useGasCoin: false,
70
- }),
71
- signer: simulation.sender,
72
- tx,
73
- });
74
- tx.add(metaSettle(quote, coinOut, 10000, this.options.tipBps, this.options.partner, this.options.partnerCommissionBps));
75
- tx.transferObjects([coinOut], simulation.sender);
76
- const res = await timeout(() => this.inspector.devInspectTransactionBlock({
77
- sender: simulation.sender,
78
- transactionBlock: tx,
79
- }), simulation.timeout ?? 2000, `simulation for ${provider.kind} provider with id ${id}`);
80
- if (res.effects.status.status === "failure") {
81
- throw new Error(res.error ?? "Simulation failed");
76
+ if (isAggregatorProvider(provider)) {
77
+ return simulateAggregator(provider, quote, simulation, this.inspector, this.options);
78
+ }
79
+ switch (quote.provider) {
80
+ case EProvider.BLUEFINX:
81
+ return simulateBluefinX(quote);
82
+ case EProvider.OKX:
83
+ return simulateOKXSwap(quote, this.inspector, simulation, this.options);
84
+ default:
85
+ throw new Error(`Provider not supported: ${provider.kind}`);
82
86
  }
83
- const amountOut = extractAmountOutWrapper(res.events);
84
- return {
85
- id,
86
- simulatedAmountOut: amountOut,
87
- gasUsed: res.effects.gasUsed,
88
- provider: provider.kind,
89
- };
90
87
  }
91
88
  catch (error) {
92
- console.warn(`Failed to simulate ${provider.kind}: `, error);
89
+ console.warn(error, { provider: provider.kind, quote: quote.id });
93
90
  }
94
91
  }
95
- async _quote(provider, options, simulation) {
92
+ async _quote(provider, options) {
96
93
  const quote = await timeout(async () => {
97
94
  const quote = await provider.quote(options);
95
+ if (!quote)
96
+ return null;
98
97
  const { expectedAmount } = getExpectedReturn(quote.rawAmountOut, 0, this.options.partnerCommissionBps, this.options.tipBps);
99
98
  quote.amountOut = expectedAmount;
100
99
  return quote;
101
- }, options.timeout ?? 2000, `quote for ${provider.kind} provider from ${options.coinInType} to ${options.coinOutType}`);
102
- if (simulation) {
103
- if (simulation.onSimulated) {
104
- this._simulate(provider, quote, simulation).then((payload) => {
105
- if (payload) {
106
- simulation.onSimulated?.(payload);
107
- }
108
- });
109
- }
110
- else {
111
- const updated = await this._simulate(provider, quote, simulation);
112
- quote.simulatedAmountOut = updated?.simulatedAmountOut;
113
- quote.gasUsed = updated?.gasUsed;
114
- }
115
- }
100
+ }, options.timeout ?? 2000, `quote for ${provider.kind} provider from ${options.coinTypeIn} to ${options.coinTypeOut}`);
116
101
  return quote;
117
102
  }
103
+ async _fastSwap({ quote, signer, useGasCoin, signTransaction }, getTransactionBlockParams) {
104
+ const tx = new Transaction();
105
+ const coin = await this.swap({
106
+ quote,
107
+ signer,
108
+ tx,
109
+ coinIn: coinWithBalance({
110
+ type: quote.coinTypeIn,
111
+ balance: BigInt(quote.amountIn),
112
+ useGasCoin,
113
+ }),
114
+ });
115
+ tx.transferObjects([coin], signer);
116
+ tx.setSenderIfNotSet(signer);
117
+ const txBytes = await tx.build({ client: this.client });
118
+ const { signature, bytes } = await signTransaction(toBase64(txBytes));
119
+ return this.client.executeTransactionBlock({
120
+ transactionBlock: bytes,
121
+ signature,
122
+ options: getTransactionBlockParams?.options,
123
+ signal: getTransactionBlockParams?.signal,
124
+ });
125
+ }
118
126
  /**
119
127
  * Get quotes from all providers
120
128
  * @param options - quote options
@@ -124,23 +132,38 @@ export class MetaAg {
124
132
  async quote(options, simulation) {
125
133
  const opts = {
126
134
  ...options,
127
- coinInType: normalizeStructTag(options.coinInType),
128
- coinOutType: normalizeStructTag(options.coinOutType),
135
+ coinTypeIn: normalizeStructTag(options.coinTypeIn),
136
+ coinTypeOut: normalizeStructTag(options.coinTypeOut),
129
137
  };
130
138
  const quotes = await Promise.allSettled(Object.entries(this.options.providers)
131
139
  .filter(([_k, v]) => !v.disabled)
132
140
  .map(async ([provider]) => {
133
141
  const p = await this._getProvider(provider);
134
- return this._quote(p, opts, simulation);
142
+ return this._quote(p, opts);
135
143
  }));
136
- return quotes
144
+ const result = quotes
137
145
  .map((quote) => quote.status === "fulfilled"
138
146
  ? quote.value
139
147
  : (console.log(quote.reason), null))
140
148
  .filter((quote) => quote !== null);
149
+ if (simulation) {
150
+ const requests = result.map(async (quote) => {
151
+ const provider = await this._getProvider(quote.provider);
152
+ const updated = await this._simulate(provider, quote, simulation);
153
+ quote.simulatedAmountOut = updated?.simulatedAmountOut;
154
+ quote.gasUsed = updated?.gasUsed;
155
+ simulation?.onSimulated?.({ ...quote });
156
+ });
157
+ if (!simulation.onSimulated) {
158
+ await Promise.all(requests);
159
+ }
160
+ }
161
+ return result;
141
162
  }
142
163
  /**
143
164
  * Build transaction from quote
165
+ * @info Use this function to build composable transaction (ie: add more commands after the swap, consume the coin out object)
166
+ * @warning Providers that build transaction on the fly (typically RFQ, Swap-API providers ie: BluefinX, Okx, ...) are not supported, please use `fastSwap` instead
144
167
  * @param options - build tx options
145
168
  * @param slippageBps - slippage bps if not specified, fallback to global slippage bps, if none of them specified, default to 100
146
169
  * @returns coin out object, you must consume it by transferObjects, or other sub sequence commands
@@ -148,11 +171,32 @@ export class MetaAg {
148
171
  async swap(options, slippageBps) {
149
172
  const provider = await this._getProvider(options.quote.provider);
150
173
  assert(!!provider, `Provider not found: ${options.quote.provider}`);
174
+ assert(isAggregatorProvider(provider), `Provider does not support swap: ${provider.kind}`);
151
175
  const coinOut = await provider.swap(options);
152
176
  options.tx.add(metaSettle(options.quote, coinOut, slippageBps ?? this.options.slippageBps ?? 100, this.options.tipBps, this.options.partner, this.options.partnerCommissionBps));
153
177
  options.tx.setSenderIfNotSet(options.signer);
154
178
  return coinOut;
155
179
  }
180
+ /**
181
+ * Build, Sign, and Execute transaction in one step
182
+ * @param options - fast swap options
183
+ * @returns - txDigest of the transaction
184
+ */
185
+ async fastSwap(options, getTransactionBlockParams) {
186
+ const provider = await this._getProvider(options.quote.provider);
187
+ if (isAggregatorProvider(provider)) {
188
+ return this._fastSwap(options, getTransactionBlockParams);
189
+ }
190
+ else if (isSwapAPIProvider(provider)) {
191
+ return this.client.waitForTransaction({
192
+ ...getTransactionBlockParams,
193
+ digest: await provider.fastSwap(options),
194
+ });
195
+ }
196
+ else {
197
+ throw new Error(`Provider not supported: ${provider.kind}`);
198
+ }
199
+ }
156
200
  /**
157
201
  * Update meta aggregator options
158
202
  * @param options - update options payload
@@ -185,71 +229,17 @@ export class MetaAg {
185
229
  }
186
230
  }
187
231
  }
188
- /**
189
- * this settlement does not charge commission fee for partner, since all integrated aggregators already charge commission fee for partner
190
- * @param quote Meta Aggregator Quote
191
- * @param coinOut Coin Out Object
192
- * @param slippageBps Slippage Bps
193
- * @param tipBps Tip Bps default = 0
194
- * @param partner address of partner for analytic default is zero address
195
- */
196
- const metaSettle = (quote, coinOut, slippageBps = 100, tipBps = 0, partner, commissionBps = 0) => {
197
- return (tx) => {
198
- const { minAmount, expectedAmount } = getExpectedReturn(quote.rawAmountOut, slippageBps, commissionBps, tipBps);
199
- if (tipBps > 0) {
200
- tx.moveCall({
201
- target: `${_7K_META_PUBLISHED_AT}::vault::collect_tip`,
202
- typeArguments: [quote.coinTypeOut],
203
- arguments: [
204
- tx.object(_7K_META_VAULT),
205
- tx.object(_7K_META_CONFIG),
206
- coinOut,
207
- tx.pure.u64(tipBps),
208
- ],
209
- });
210
- }
211
- tx.moveCall({
212
- target: `${_7K_META_PUBLISHED_AT}::settle::settle`,
213
- typeArguments: [quote.coinTypeIn, quote.coinTypeOut],
214
- arguments: [
215
- tx.object(_7K_META_CONFIG),
216
- tx.object(_7K_META_VAULT),
217
- tx.pure.u64(quote.amountIn),
218
- coinOut,
219
- tx.pure.u64(minAmount),
220
- tx.pure.u64(expectedAmount),
221
- tx.pure.option("address", partner),
222
- tx.pure.u64(commissionBps),
223
- tx.pure.u64(0), // ps
224
- ],
225
- });
226
- };
227
- };
228
- const extractAmountOutWrapper = (events) => {
229
- const swapEvent = events
230
- .filter((event) => event.type === `${_7K_META_PACKAGE_ID}::settle::Swap`)
231
- ?.pop();
232
- return swapEvent?.parsedJson?.amount_out;
233
- };
234
232
  const catchImportError = (provider) => {
235
233
  return (e) => {
236
234
  const map = {
237
235
  [EProvider.CETUS]: "@cetusprotocol/aggregator-sdk",
238
236
  [EProvider.FLOWX]: "@flowx-finance/sdk",
239
237
  [EProvider.BLUEFIN7K]: "@7kprotocol/sdk-ts",
238
+ [EProvider.ASTRO]: "@naviprotocol/astros-aggregator-sdk",
239
+ [EProvider.OKX]: "",
240
+ [EProvider.BLUEFINX]: "",
240
241
  };
241
242
  console.warn(`Please install ${map[provider]} to use ${provider} provider`);
242
243
  throw e;
243
244
  };
244
245
  };
245
- const timeout = async (fn, timeout, msg) => {
246
- if (timeout <= 0)
247
- return fn();
248
- return new Promise((resolve, reject) => {
249
- const timer = setTimeout(() => reject(new Error(`Timeout ${msg ?? "operation"}`)), timeout);
250
- fn()
251
- .then(resolve)
252
- .catch(reject)
253
- .finally(() => clearTimeout(timer));
254
- });
255
- };
@@ -0,0 +1,40 @@
1
+ import { buildSwapPTBFromQuote, getQuote, } from "@naviprotocol/astros-aggregator-sdk";
2
+ import { v4 } from "uuid";
3
+ import { _7K_PARTNER_ADDRESS } from "../../../constants/_7k";
4
+ import { EProvider, } from "../../../types/metaAg";
5
+ import { assert } from "../../../utils/condition";
6
+ export class AstroProvider {
7
+ options;
8
+ kind = EProvider.ASTRO;
9
+ constructor(options) {
10
+ this.options = options;
11
+ }
12
+ async quote({ amountIn, coinTypeIn, coinTypeOut, }) {
13
+ const quote = await getQuote(coinTypeIn, coinTypeOut, amountIn, this.options.api, {
14
+ baseUrl: this.options.api,
15
+ byAmountIn: true,
16
+ depth: this.options.depth,
17
+ dexList: this.options.dexList,
18
+ ifPrint: false,
19
+ serviceFee: {
20
+ fee: 0,
21
+ receiverAddress: _7K_PARTNER_ADDRESS,
22
+ },
23
+ });
24
+ return {
25
+ id: v4(),
26
+ provider: this.kind,
27
+ quote,
28
+ amountIn,
29
+ rawAmountOut: quote.amount_out.toString(),
30
+ amountOut: quote.amount_out.toString(),
31
+ coinTypeIn,
32
+ coinTypeOut,
33
+ };
34
+ }
35
+ async swap({ signer, quote, coinIn, tx }) {
36
+ assert(quote.provider === EProvider.ASTRO, "Invalid quote");
37
+ const coin = await buildSwapPTBFromQuote(signer, tx, 0, coinIn, quote.quote);
38
+ return coin;
39
+ }
40
+ }
@@ -2,7 +2,6 @@ import { SuiPriceServiceConnection, SuiPythClient, } from "@pythnetwork/pyth-sui
2
2
  import { v4 } from "uuid";
3
3
  import { Config } from "../../../config";
4
4
  import { _7K_PARTNER_ADDRESS } from "../../../constants/_7k";
5
- import { API_ENDPOINTS } from "../../../constants/apiEndpoints";
6
5
  import { EProvider, } from "../../../types/metaAg";
7
6
  import { assert } from "../../../utils/condition";
8
7
  import { buildTxV2 } from "../../swap/buildTxV2";
@@ -20,6 +19,8 @@ export class BluefinProvider {
20
19
  const pythConnection = new SuiPriceServiceConnection(this.metaOptions.hermesApi);
21
20
  if (options.apiKey)
22
21
  Config.setApiKey(options.apiKey);
22
+ if (options.api)
23
+ Config.setApi(options.api);
23
24
  Config.setSuiClient(client);
24
25
  Config.setPythClient(pythClient);
25
26
  Config.setPythConnection(pythConnection);
@@ -27,9 +28,8 @@ export class BluefinProvider {
27
28
  async quote(options) {
28
29
  const quote = await getQuote({
29
30
  amountIn: options.amountIn,
30
- tokenIn: options.coinInType,
31
- tokenOut: options.coinOutType,
32
- api: this.options.api || API_ENDPOINTS.MAIN,
31
+ tokenIn: options.coinTypeIn,
32
+ tokenOut: options.coinTypeOut,
33
33
  sources: this.options.sources,
34
34
  maxPaths: this.options.maxPaths,
35
35
  excludedPools: this.options.excludedPools,
@@ -42,8 +42,8 @@ export class BluefinProvider {
42
42
  amountIn: quote.swapAmountWithDecimal,
43
43
  rawAmountOut: quote.returnAmountWithDecimal,
44
44
  amountOut: quote.returnAmountWithDecimal,
45
- coinTypeIn: options.coinInType,
46
- coinTypeOut: options.coinOutType,
45
+ coinTypeIn: options.coinTypeIn,
46
+ coinTypeOut: options.coinTypeOut,
47
47
  };
48
48
  }
49
49
  async swap({ quote, signer, tx, coinIn }) {
@@ -0,0 +1,84 @@
1
+ import { coinWithBalance, Transaction } from "@mysten/sui/transactions";
2
+ import { isValidSuiAddress } from "@mysten/sui/utils";
3
+ import { v4 } from "uuid";
4
+ import { Config } from "../../../config";
5
+ import { _7K_PARTNER_ADDRESS } from "../../../constants/_7k";
6
+ import { executeBluefinTx } from "../../../libs/protocols/bluefinx/client";
7
+ import { BluefinXTx } from "../../../types/aggregator";
8
+ import { EProvider, } from "../../../types/metaAg";
9
+ import { assert } from "../../../utils/condition";
10
+ import { buildTxV2Int } from "../../swap/buildTxV2";
11
+ import { getQuote } from "../../swap/getQuote";
12
+ import { metaSettle } from "../common";
13
+ const SUPPORT_COINS = [
14
+ "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
15
+ "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
16
+ ];
17
+ export class BluefinXProvider {
18
+ options;
19
+ kind = EProvider.BLUEFINX;
20
+ constructor(options) {
21
+ this.options = options;
22
+ if (options.apiKey)
23
+ Config.setApiKey(options.apiKey);
24
+ if (options.api)
25
+ Config.setApi(options.api);
26
+ }
27
+ async quote(options) {
28
+ if (!this.canQuote(options))
29
+ return null;
30
+ const quote = await getQuote({
31
+ amountIn: options.amountIn,
32
+ tokenIn: options.coinTypeIn,
33
+ tokenOut: options.coinTypeOut,
34
+ sources: ["bluefinx"],
35
+ taker: options.signer,
36
+ });
37
+ return {
38
+ id: v4(),
39
+ provider: this.kind,
40
+ quote,
41
+ amountIn: quote.swapAmountWithDecimal,
42
+ rawAmountOut: quote.returnAmountWithDecimal,
43
+ amountOut: quote.returnAmountWithDecimal,
44
+ coinTypeIn: options.coinTypeIn,
45
+ coinTypeOut: options.coinTypeOut,
46
+ };
47
+ }
48
+ canQuote(options) {
49
+ return (!!options.signer &&
50
+ isValidSuiAddress(options.signer) &&
51
+ SUPPORT_COINS.includes(options.coinTypeIn) &&
52
+ SUPPORT_COINS.includes(options.coinTypeOut));
53
+ }
54
+ async fastSwap(options) {
55
+ assert(options.quote.provider === this.kind, "Invalid BluefinX quote");
56
+ const quote = options.quote.quote;
57
+ const tx = new Transaction();
58
+ const { tx: bluefinTx } = await buildTxV2Int({
59
+ quoteResponse: quote,
60
+ accountAddress: options.signer,
61
+ commission: { commissionBps: 0, partner: _7K_PARTNER_ADDRESS },
62
+ slippage: 0,
63
+ extendTx: {
64
+ tx,
65
+ coinIn: coinWithBalance({
66
+ type: options.quote.coinTypeIn,
67
+ balance: BigInt(options.quote.amountIn),
68
+ useGasCoin: false,
69
+ }),
70
+ },
71
+ }, (tx, coinOut) => {
72
+ if (coinOut) {
73
+ tx.add(metaSettle(options.quote, coinOut, 0, 0));
74
+ tx.transferObjects([coinOut], options.signer);
75
+ }
76
+ });
77
+ assert(bluefinTx instanceof BluefinXTx, "BluefinX transaction not found");
78
+ const { signature } = await options.signTransaction(bluefinTx.txBytes);
79
+ const res = await executeBluefinTx(bluefinTx, signature);
80
+ assert(res.approved, "BluefinX transaction not approved");
81
+ assert(res.txDigest, "BluefinX transaction digest not found");
82
+ return res.txDigest;
83
+ }
84
+ }
@@ -23,8 +23,8 @@ export class CetusProvider {
23
23
  const quote = await this.cetusClient.findRouters({
24
24
  amount: quoteOptions.amountIn,
25
25
  byAmountIn: true,
26
- from: quoteOptions.coinInType,
27
- target: quoteOptions.coinOutType,
26
+ from: quoteOptions.coinTypeIn,
27
+ target: quoteOptions.coinTypeOut,
28
28
  providers: this.options.sources,
29
29
  splitCount: this.options.splitCount,
30
30
  splitAlgorithm: this.options.splitAlgorithm,
@@ -40,8 +40,8 @@ export class CetusProvider {
40
40
  amountIn: quote.amountIn.toString() || "0",
41
41
  rawAmountOut: quote.amountOut.toString() || "0",
42
42
  amountOut: quote.amountOut.toString() || "0",
43
- coinTypeIn: quoteOptions.coinInType,
44
- coinTypeOut: quoteOptions.coinOutType,
43
+ coinTypeIn: quoteOptions.coinTypeIn,
44
+ coinTypeOut: quoteOptions.coinTypeOut,
45
45
  };
46
46
  }
47
47
  async swap(options) {
@@ -16,8 +16,8 @@ export class FlowxProvider {
16
16
  async quote(quoteOptions) {
17
17
  const quote = await this.quoter.getRoutes({
18
18
  amountIn: quoteOptions.amountIn,
19
- tokenIn: quoteOptions.coinInType,
20
- tokenOut: quoteOptions.coinOutType,
19
+ tokenIn: quoteOptions.coinTypeIn,
20
+ tokenOut: quoteOptions.coinTypeOut,
21
21
  includeSources: this.options.sources,
22
22
  excludePools: this.options.excludePools,
23
23
  excludeSources: this.options.excludeSources,
@@ -31,8 +31,8 @@ export class FlowxProvider {
31
31
  amountIn: quote.amountIn?.toString() ?? "0",
32
32
  rawAmountOut: quote.amountOut?.toString() ?? "0",
33
33
  amountOut: quote.amountOut?.toString() ?? "0",
34
- coinTypeIn: quoteOptions.coinInType,
35
- coinTypeOut: quoteOptions.coinOutType,
34
+ coinTypeIn: quoteOptions.coinTypeIn,
35
+ coinTypeOut: quoteOptions.coinTypeOut,
36
36
  };
37
37
  }
38
38
  async swap(options) {
@@ -0,0 +1,146 @@
1
+ import { Commands, Transaction, TransactionDataBuilder, } from "@mysten/sui/transactions";
2
+ import { normalizeStructTag, normalizeSuiAddress, toBase64, } from "@mysten/sui/utils";
3
+ import { v4 } from "uuid";
4
+ import { SUI_TYPE } from "../../../constants/tokens";
5
+ import { EProvider, } from "../../../types/metaAg";
6
+ import { assert } from "../../../utils/condition";
7
+ import { metaSettle, simulateSwapTx } from "../common";
8
+ const API = "https://web3.okx.com";
9
+ const SWAP_PATH = "/api/v5/dex/aggregator/swap";
10
+ const CHAIN_ID = "784";
11
+ const NORMALIZED_SUI_TYPE = normalizeStructTag(SUI_TYPE);
12
+ export class OkxProvider {
13
+ options;
14
+ metaOptions;
15
+ client;
16
+ kind = EProvider.OKX;
17
+ constructor(options, metaOptions, client) {
18
+ this.options = options;
19
+ this.metaOptions = metaOptions;
20
+ this.client = client;
21
+ }
22
+ async quote({ amountIn, coinTypeIn, coinTypeOut, signer, }) {
23
+ if (!signer)
24
+ return null;
25
+ const request = {
26
+ chainId: CHAIN_ID,
27
+ amount: amountIn,
28
+ fromTokenAddress: coinTypeIn === NORMALIZED_SUI_TYPE ? SUI_TYPE : coinTypeIn,
29
+ toTokenAddress: coinTypeOut === NORMALIZED_SUI_TYPE ? SUI_TYPE : coinTypeOut,
30
+ slippage: (this.metaOptions.slippageBps / 10000).toString(),
31
+ userWalletAddress: signer,
32
+ };
33
+ const queryString = "?" + new URLSearchParams(request).toString();
34
+ const url = `${this.options.api ?? API}${SWAP_PATH}${queryString}`;
35
+ const response = await fetch(url, {
36
+ headers: await getHeaders(this.options, "GET", SWAP_PATH, queryString),
37
+ });
38
+ const quote = (await response.json());
39
+ assert(quote.code === "0" && quote.data.length > 0, "No quote found");
40
+ return {
41
+ id: v4(),
42
+ provider: this.kind,
43
+ coinTypeIn,
44
+ coinTypeOut,
45
+ amountIn,
46
+ amountOut: quote.data[0].routerResult.toTokenAmount,
47
+ rawAmountOut: quote.data[0].routerResult.toTokenAmount,
48
+ quote: quote.data[0],
49
+ };
50
+ }
51
+ async fastSwap(options) {
52
+ const { quote, signer, signTransaction } = options;
53
+ assert(quote.provider === EProvider.OKX, "Invalid quote");
54
+ const { tx, coin } = buildTx({ quote, signer });
55
+ tx.add(metaSettle(quote, coin, this.metaOptions.slippageBps, this.metaOptions.tipBps, this.metaOptions.partner, this.metaOptions.partnerCommissionBps));
56
+ tx.transferObjects([coin], signer);
57
+ const txBytes = await tx.build({ client: this.client });
58
+ const { bytes, signature } = await signTransaction(toBase64(txBytes));
59
+ const res = await this.client.executeTransactionBlock({
60
+ signature,
61
+ transactionBlock: bytes,
62
+ });
63
+ return res.digest;
64
+ }
65
+ }
66
+ async function generateHmacSha256(message, secretKey) {
67
+ const encoder = new TextEncoder();
68
+ const encodeBase64 = (bytes) => {
69
+ if (typeof Buffer !== "undefined") {
70
+ return Buffer.from(bytes).toString("base64");
71
+ }
72
+ let binary = "";
73
+ for (let i = 0; i < bytes.byteLength; i++) {
74
+ binary += String.fromCharCode(bytes[i]);
75
+ }
76
+ if (typeof btoa !== "undefined") {
77
+ return btoa(binary);
78
+ }
79
+ throw new Error("Base64 encoder not available in this environment");
80
+ };
81
+ if (typeof globalThis !== "undefined" && globalThis.crypto?.subtle) {
82
+ const key = await globalThis.crypto.subtle.importKey("raw", encoder.encode(secretKey), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
83
+ const signature = await globalThis.crypto.subtle.sign("HMAC", key, encoder.encode(message));
84
+ return encodeBase64(new Uint8Array(signature));
85
+ }
86
+ const { createHmac } = await import("node:crypto");
87
+ return createHmac("sha256", secretKey).update(message).digest("base64");
88
+ }
89
+ async function getHeaders(options, method, requestPath, queryString = "") {
90
+ const { apiKey, secretKey, apiPassphrase, projectId } = options;
91
+ if (!apiKey || !secretKey || !apiPassphrase || !projectId) {
92
+ throw new Error("Missing required environment variables");
93
+ }
94
+ const timestamp = new Date().toISOString();
95
+ const stringToSign = timestamp + method + requestPath + queryString;
96
+ return {
97
+ "Content-Type": "application/json",
98
+ "OK-ACCESS-KEY": apiKey,
99
+ "OK-ACCESS-SIGN": await generateHmacSha256(stringToSign, secretKey),
100
+ "OK-ACCESS-TIMESTAMP": timestamp,
101
+ "OK-ACCESS-PASSPHRASE": apiPassphrase,
102
+ "OK-ACCESS-PROJECT": projectId,
103
+ };
104
+ }
105
+ const replaceFinalizeCommand = (tx, packageId) => {
106
+ const builder = TransactionDataBuilder.restore(tx.getData());
107
+ const i = builder.commands.findIndex((cmd) => cmd.$kind === "MoveCall" &&
108
+ normalizeSuiAddress(cmd.MoveCall.package) ===
109
+ normalizeSuiAddress(packageId) &&
110
+ cmd.MoveCall.module === "router" &&
111
+ cmd.MoveCall.function === "finalize");
112
+ const cmd = builder.commands[i];
113
+ assert(cmd.MoveCall, "OKX: Finalize command not found");
114
+ builder.replaceCommand(i, Commands.MoveCall({
115
+ package: packageId,
116
+ module: "router",
117
+ function: "finalize_without_transfer",
118
+ typeArguments: cmd.MoveCall.typeArguments,
119
+ arguments: [
120
+ cmd.MoveCall.arguments[0],
121
+ cmd.MoveCall.arguments[5],
122
+ cmd.MoveCall.arguments[6],
123
+ ],
124
+ }));
125
+ const tx2 = Transaction.from(builder.build());
126
+ return { tx: tx2, coin: { NestedResult: [i, 0] } };
127
+ };
128
+ const buildTx = (options) => {
129
+ const { quote, signer } = options;
130
+ assert(quote.provider === EProvider.OKX, "Invalid quote");
131
+ const tx = Transaction.from(quote.quote.tx.data);
132
+ tx.setSenderIfNotSet(signer);
133
+ const { tx: tx2, coin } = replaceFinalizeCommand(tx, quote.quote.tx.to);
134
+ return { tx: tx2, coin };
135
+ };
136
+ export const simulateOKXSwap = async (quote, inspector, simulation, metaOptions) => {
137
+ const { tx, coin } = buildTx({ quote, signer: quote.quote.tx.from });
138
+ tx.add(metaSettle(quote, coin, 10000, metaOptions.tipBps, metaOptions.partner, metaOptions.partnerCommissionBps));
139
+ tx.transferObjects([coin], quote.quote.tx.from);
140
+ const res = await simulateSwapTx(tx, inspector, simulation);
141
+ return {
142
+ id: quote.id,
143
+ provider: quote.provider,
144
+ ...res,
145
+ };
146
+ };
@@ -168,6 +168,9 @@ export const buildBluefinXTx = async (tx, accountAddress, quoteResponse) => {
168
168
  if (extra.quoteExpiresAtUtcMillis < Date.now()) {
169
169
  throw new Error("Quote expired");
170
170
  }
171
+ if (extra.taker !== accountAddress) {
172
+ throw new Error("Sender mismatch with quote");
173
+ }
171
174
  tx.setSenderIfNotSet(accountAddress);
172
175
  const bytes = await tx.build({
173
176
  client: Config.getSuiClient(),