@gala-chain/gswap-sdk 2.0.0-rc.0 → 2.0.0-rc.1

package/README.md

@@ -11,7 +11,7 @@ Gateway. Swap requests are queued for later application.
 npm install @gala-chain/gswap-sdk@next @gala-chain/gala-core-sdk@next
 ```
 
-`@gala-chain/gala-core-sdk` is a peer dependency (range `>=1.0.0-rc.4 <2`):
+`@gala-chain/gala-core-sdk` is a peer dependency (range `>=1.0.0-rc.6 <2`):
 install it next to the SDK. 2.0 is a release candidate under the `next`
 dist-tag; `latest` is still 1.2.0, so an install without `@next` gets 1.x.
 Pin exact versions for a wallet or app build.
@@ -73,6 +73,19 @@ const series = await gSwap.market.getPriceSeries('GALA$Unit$none$none', '1W');
 const season = await gSwap.leaderboard.getCurrentSeason(); // null between seasons
 ```
 
+## Onramper widget URL
+
+`gSwap.onramper.generateWidgetUrl(request)` asks the swap backend for a signed Onramper (fiat
+on-ramp) widget URL. The route is public: the request carries no `Authorization` header. An app that
+needs only this builds the small service without a whole client:
+
+```typescript
+import { createOnramper } from '@gala-chain/gswap-sdk';
+
+const onramper = createOnramper({ dexBackendBaseUrl: 'https://dex-backend-prod1.defi.gala.com' });
+const url = await onramper.generateWidgetUrl({ walletAddress: '0x…', defaultCrypto: 'gala', mode: 'buy' });
+```
+
 ## Hosts and environment presets
 
 The SDK has one network boundary: the swap backend. It does not call public

package/dist/browser/classes/gswap.js

@@ -1,2 +1,2 @@
-import e from"../_virtual/_@oxc-project_runtime@0.153.0/helpers/esm/defineProperty.js";import{Assets as t}from"./assets.js";import{DexFees as n}from"./dex_fees.js";import{ChainGateway as r}from"./gateway.js";import{GSWAP_ENVIRONMENTS as i}from"../types/env.js";import{GdexStreamService as a}from"./gdex_stream.js";import{HttpClient as o}from"./http_client.js";import{Leaderboard as s}from"./leaderboard.js";import{Market as c}from"./market.js";import{CanonicalSymbols as l,Symbols as u}from"./symbols.js";import{Pools as d}from"./pools.js";import{Positions as f}from"./positions.js";import{Quoting as p}from"./quoting.js";import{Swaps as m}from"./swaps.js";var h=class{constructor(a){e(this,`dexBackendBaseUrl`,void 0),e(this,`chainCallTimeoutMs`,void 0),e(this,`signer`,void 0),e(this,`walletAddress`,void 0),e(this,`gateway`,void 0),e(this,`symbols`,void 0),e(this,`quoting`,void 0),e(this,`pools`,void 0),e(this,`positions`,void 0),e(this,`swaps`,void 0),e(this,`assets`,void 0),e(this,`market`,void 0),e(this,`leaderboard`,void 0),e(this,`fees`,void 0),e(this,`dexBackendWsUrl`,void 0),e(this,`webSocketImpl`,void 0),e(this,`streamApiKey`,void 0),e(this,`streamClient`,void 0);let h=i[a?.env??`prod`];this.dexBackendBaseUrl=g(a?.dexBackendBaseUrl??h.dexBackendBaseUrl),this.chainCallTimeoutMs=a?.chainCallTimeoutMs??3e4,this.signer=a?.signer,this.walletAddress=a?.walletAddress;let _=new o(a?.httpRequestor,this.chainCallTimeoutMs,a?.wire);this.gateway=new r({dexBackendBaseUrl:this.dexBackendBaseUrl,chainCallTimeoutMs:this.chainCallTimeoutMs,...a?.wire===void 0?{}:{wire:a.wire},...a?.httpRequestor===void 0?{}:{httpRequestor:a.httpRequestor},...this.walletAddress===void 0?{}:{walletAddress:this.walletAddress}});let v={onInvalidEntry:a?.onInvalidEntry};this.symbols=new u(this.gateway,v);let y=a?.symbolResolution===`canonical`?new l:this.symbols;this.quoting=new p(this.gateway,y),this.pools=new d(this.gateway,y,v);let b={uniqueKeyPrefix:a?.uniqueKeyPrefix,...v};this.positions=new f(this.gateway,y,this.signer,this.walletAddress,b),this.swaps=new m(this.gateway,y,this.signer,this.walletAddress,b),this.assets=new t(this.dexBackendBaseUrl,_),this.market=new c(this.dexBackendBaseUrl,_,v),this.leaderboard=new s(this.dexBackendBaseUrl,_,v),this.fees=new n(this.gateway,this.signer),this.dexBackendWsUrl=a?.dexBackendWsUrl??(a?.dexBackendBaseUrl===void 0?h.dexBackendWsUrl:`${this.dexBackendBaseUrl.replace(/^http/u,`ws`)}/ws`),this.webSocketImpl=a?.webSocketImpl,this.streamApiKey=a?.streamApiKey}get stream(){return this.streamClient??(this.streamClient=new a({url:this.dexBackendWsUrl,...this.webSocketImpl===void 0?{}:{webSocketImpl:this.webSocketImpl},...this.streamApiKey===void 0?{}:{apiKey:this.streamApiKey}})),this.streamClient}};function g(e){return e.replace(/\/$/u,``)}export{h as GSwap};
+import e from"../_virtual/_@oxc-project_runtime@0.153.0/helpers/esm/defineProperty.js";import{Assets as t}from"./assets.js";import{DexFees as n}from"./dex_fees.js";import{ChainGateway as r}from"./gateway.js";import{GSWAP_ENVIRONMENTS as i}from"../types/env.js";import{GdexStreamService as a}from"./gdex_stream.js";import{HttpClient as o}from"./http_client.js";import{Leaderboard as s}from"./leaderboard.js";import{Market as c}from"./market.js";import{Onramper as l}from"./onramper.js";import{CanonicalSymbols as u,Symbols as d}from"./symbols.js";import{Pools as f}from"./pools.js";import{Positions as p}from"./positions.js";import{Quoting as m}from"./quoting.js";import{Swaps as h}from"./swaps.js";var g=class{constructor(a){e(this,`dexBackendBaseUrl`,void 0),e(this,`chainCallTimeoutMs`,void 0),e(this,`signer`,void 0),e(this,`walletAddress`,void 0),e(this,`gateway`,void 0),e(this,`symbols`,void 0),e(this,`quoting`,void 0),e(this,`pools`,void 0),e(this,`positions`,void 0),e(this,`swaps`,void 0),e(this,`assets`,void 0),e(this,`market`,void 0),e(this,`leaderboard`,void 0),e(this,`onramper`,void 0),e(this,`fees`,void 0),e(this,`dexBackendWsUrl`,void 0),e(this,`webSocketImpl`,void 0),e(this,`streamApiKey`,void 0),e(this,`streamClient`,void 0);let g=i[a?.env??`prod`];this.dexBackendBaseUrl=_(a?.dexBackendBaseUrl??g.dexBackendBaseUrl),this.chainCallTimeoutMs=a?.chainCallTimeoutMs??3e4,this.signer=a?.signer,this.walletAddress=a?.walletAddress;let v=new o(a?.httpRequestor,this.chainCallTimeoutMs,a?.wire);this.gateway=new r({dexBackendBaseUrl:this.dexBackendBaseUrl,chainCallTimeoutMs:this.chainCallTimeoutMs,...a?.wire===void 0?{}:{wire:a.wire},...a?.httpRequestor===void 0?{}:{httpRequestor:a.httpRequestor},...this.walletAddress===void 0?{}:{walletAddress:this.walletAddress}});let y={onInvalidEntry:a?.onInvalidEntry};this.symbols=new d(this.gateway,y);let b=a?.symbolResolution===`canonical`?new u:this.symbols;this.quoting=new m(this.gateway,b),this.pools=new f(this.gateway,b,y);let x={uniqueKeyPrefix:a?.uniqueKeyPrefix,...y};this.positions=new p(this.gateway,b,this.signer,this.walletAddress,x),this.swaps=new h(this.gateway,b,this.signer,this.walletAddress,x),this.assets=new t(this.dexBackendBaseUrl,v),this.market=new c(this.dexBackendBaseUrl,v,y),this.leaderboard=new s(this.dexBackendBaseUrl,v,y),this.onramper=new l(this.dexBackendBaseUrl,v),this.fees=new n(this.gateway,this.signer),this.dexBackendWsUrl=a?.dexBackendWsUrl??(a?.dexBackendBaseUrl===void 0?g.dexBackendWsUrl:`${this.dexBackendBaseUrl.replace(/^http/u,`ws`)}/ws`),this.webSocketImpl=a?.webSocketImpl,this.streamApiKey=a?.streamApiKey}get stream(){return this.streamClient??(this.streamClient=new a({url:this.dexBackendWsUrl,...this.webSocketImpl===void 0?{}:{webSocketImpl:this.webSocketImpl},...this.streamApiKey===void 0?{}:{apiKey:this.streamApiKey}})),this.streamClient}};function _(e){return e.replace(/\/$/u,``)}export{g as GSwap};
 //# sourceMappingURL=gswap.js.map

package/dist/browser/classes/gswap.js.map

@@ -1 +1 @@
-{"version":3,"file":"gswap.js","names":["_defineProperty","GSwap","environment","GSWAP_ENVIRONMENTS","options","trimTrailingSlash","httpClient","HttpClient","ChainGateway","lenient","Symbols","resolver","CanonicalSymbols","Quoting","Pools","keyOptions","Positions","Swaps","Assets","Market","Leaderboard","DexFees","GdexStreamService","value"],"sources":["../../../src/classes/gswap.ts"],"sourcesContent":["import { Assets } from './assets.js';\nimport { DexFees } from './dex_fees.js';\nimport { ChainGateway } from './gateway.js';\nimport { GdexStreamService } from './gdex_stream.js';\nimport { HttpClient } from './http_client.js';\nimport { Leaderboard } from './leaderboard.js';\nimport { Market } from './market.js';\nimport { Pools } from './pools.js';\nimport { Positions } from './positions.js';\nimport { Quoting } from './quoting.js';\nimport type { GalaChainSigner, HttpRequestor, WireOptions } from '@gala-chain/gala-core-sdk';\nimport { CanonicalSymbols, Symbols } from './symbols.js';\nimport type { InvalidEntryHandler } from '../utils/lenient.js';\nimport { Swaps } from './swaps.js';\nimport type { GSwapEnv } from '../types/env.js';\nimport { GSWAP_ENVIRONMENTS } from '../types/env.js';\n\n/** Options for constructing a backend-routed SDK client. */\nexport interface GSwapOptions {\n  /** Signs every write. Without one, reads work and any write throws `NO_SIGNER`. */\n  signer?: GalaChainSigner | undefined;\n  /**\n   * The selected account, sent as `X-Wallet-Address` on writes (attribution only; the chain\n   * recovers the signer from the signature). Required for shadow writes.\n   */\n  walletAddress?: string | undefined;\n  /** `'stage'` or `'prod'` swap backend preset; defaults to `'prod'`. */\n  env?: GSwapEnv | undefined;\n  /** Overrides the preset's swap backend base URL (a test or private deployment). */\n  dexBackendBaseUrl?: string | undefined;\n  /** HTTP transport for every request; defaults to the global `fetch`. */\n  httpRequestor?: HttpRequestor | undefined;\n  /** Request timeout in milliseconds (default 30 000); `Infinity` arms no timer. */\n  chainCallTimeoutMs?: number | undefined;\n  /** Query encoding and `User-Agent` of the read requests (see {@link WireOptions}). */\n  wire?: WireOptions | undefined;\n  /**\n   * How tokens are turned into trading symbols. `'registry'` (default) reads the symbol registry\n   * once (`GET /v2/trade/symbols`, cached) and accepts symbols or class keys. `'canonical'` makes\n   * no registry request: the caller passes the backend's canonical trading symbols (from a quote,\n   * an estimate or a position), reads send tokens and ticks exactly as given (composite keys\n   * included) and the backend orients the pair; see {@link CanonicalSymbols}.\n   */\n  symbolResolution?: 'registry' | 'canonical' | undefined;\n  /**\n   * Told about every row of a pool, symbol, position, price, price-series, season or leaderboard\n   * answer that was skipped as unusable (see {@link InvalidEntryHandler}); without it such rows are\n   * skipped silently.\n   */\n  onInvalidEntry?: InvalidEntryHandler | undefined;\n  /** Realtime stream endpoint. Defaults to the environment's, or is derived from `dexBackendBaseUrl`. */\n  dexBackendWsUrl?: string | undefined;\n  /** WebSocket constructor for the realtime stream; required on Node.js older than 22. */\n  webSocketImpl?: unknown;\n  /**\n   * `x-api-key` for the privileged stream view; server-side only, and it requires `webSocketImpl`\n   * (see `GdexStreamConfig.apiKey`).\n   */\n  streamApiKey?: string | undefined;\n  /**\n   * Prefix of every write's `uniqueKey` (`<prefix><uuid>`). Defaults to `galaswap-operation-`,\n   * what frontend_v2 and wallet_extension send; defi-backend does not depend on it.\n   */\n  uniqueKeyPrefix?: string | undefined;\n}\n\n/**\n * Main entry point for the current GalaChainDex SDK: one client bundling the services that read\n * and write through the swap backend (`quoting`, `swaps`, `pools`, `positions`, `assets`,\n * `market`, `leaderboard`, `symbols`, `fees`, `stream`). See {@link GSwapOptions} for\n * configuration.\n */\nexport class GSwap {\n  /** The swap backend base URL every request goes to, without a trailing slash. */\n  public readonly dexBackendBaseUrl: string;\n  /** The request timeout in milliseconds (default 30 000; `Infinity` arms no timer). */\n  public readonly chainCallTimeoutMs: number;\n  /** The signer given at construction, if any. */\n  public readonly signer: GalaChainSigner | undefined;\n  /** The account given at construction, if any. */\n  public readonly walletAddress: string | undefined;\n  /** The chain-gateway client every other service reads and writes through. */\n  public readonly gateway: ChainGateway;\n  /** The trading-symbol registry. */\n  public readonly symbols: Symbols;\n  /** Read-only exact-input and exact-output quotes. */\n  public readonly quoting: Quoting;\n  /** Pool, slot0 and composite-pool reads. */\n  public readonly pools: Pools;\n  /** Position reads, liquidity estimates and liquidity / pool-creation writes. */\n  public readonly positions: Positions;\n  /** Queued swaps (`RequestTrade`), dark swaps and swap confirmation. */\n  public readonly swaps: Swaps;\n  /** User token balances. */\n  public readonly assets: Assets;\n  /** USD prices, price series and the platform volume totals. */\n  public readonly market: Market;\n  /** Trading-competition seasons and rankings. */\n  public readonly leaderboard: Leaderboard;\n  /** Network-fee quotes (DryRun) signed with this client's signer. */\n  public readonly fees: DexFees;\n  /** The realtime stream endpoint {@link GSwap.stream} connects to. */\n  public readonly dexBackendWsUrl: string;\n  private readonly webSocketImpl: unknown;\n  private readonly streamApiKey: string | undefined;\n  private streamClient: GdexStreamService | undefined;\n\n  /**\n   * Create an SDK client for prod (the default) or stage, or for a `dexBackendBaseUrl` of your own.\n   *\n   * @example\n   * ```typescript\n   * const gSwap = new GSwap({ env: 'stage' });\n   * const symbols = await gSwap.symbols.list();\n   * ```\n   */\n  constructor(options?: GSwapOptions) {\n    const environment = GSWAP_ENVIRONMENTS[options?.env ?? 'prod'];\n    this.dexBackendBaseUrl = trimTrailingSlash(\n      options?.dexBackendBaseUrl ?? environment.dexBackendBaseUrl,\n    );\n    this.chainCallTimeoutMs = options?.chainCallTimeoutMs ?? 30_000;\n    this.signer = options?.signer;\n    this.walletAddress = options?.walletAddress;\n\n    const httpClient = new HttpClient(\n      options?.httpRequestor,\n      this.chainCallTimeoutMs,\n      options?.wire,\n    );\n    this.gateway = new ChainGateway({\n      dexBackendBaseUrl: this.dexBackendBaseUrl,\n      chainCallTimeoutMs: this.chainCallTimeoutMs,\n      ...(options?.wire === undefined ? {} : { wire: options.wire }),\n      ...(options?.httpRequestor === undefined ? {} : { httpRequestor: options.httpRequestor }),\n      ...(this.walletAddress === undefined ? {} : { walletAddress: this.walletAddress }),\n    });\n    const lenient = { onInvalidEntry: options?.onInvalidEntry };\n    this.symbols = new Symbols(this.gateway, lenient);\n    // The services resolve tokens through the registry by default; the offline resolver sends the\n    // caller's canonical symbols and keys as they are and never reads the registry.\n    const resolver =\n      options?.symbolResolution === 'canonical' ? new CanonicalSymbols() : this.symbols;\n    this.quoting = new Quoting(this.gateway, resolver);\n    this.pools = new Pools(this.gateway, resolver, lenient);\n    const keyOptions = { uniqueKeyPrefix: options?.uniqueKeyPrefix, ...lenient };\n    this.positions = new Positions(\n      this.gateway,\n      resolver,\n      this.signer,\n      this.walletAddress,\n      keyOptions,\n    );\n    this.swaps = new Swaps(this.gateway, resolver, this.signer, this.walletAddress, keyOptions);\n    this.assets = new Assets(this.dexBackendBaseUrl, httpClient);\n    this.market = new Market(this.dexBackendBaseUrl, httpClient, lenient);\n    this.leaderboard = new Leaderboard(this.dexBackendBaseUrl, httpClient, lenient);\n    this.fees = new DexFees(this.gateway, this.signer);\n    this.dexBackendWsUrl =\n      options?.dexBackendWsUrl ??\n      (options?.dexBackendBaseUrl === undefined\n        ? environment.dexBackendWsUrl\n        : `${this.dexBackendBaseUrl.replace(/^http/u, 'ws')}/ws`);\n    this.webSocketImpl = options?.webSocketImpl;\n    this.streamApiKey = options?.streamApiKey;\n  }\n\n  /**\n   * The realtime stream client for this environment (created on first use, not connected until you\n   * call `connect()`).\n   *\n   * @example\n   * ```typescript\n   * const gSwap = new GSwap({ env: 'stage' });\n   * await gSwap.stream.connect();\n   * await gSwap.stream.subscribeLiquidity((event) => console.log(event.action, event.amount0));\n   * ```\n   */\n  get stream(): GdexStreamService {\n    this.streamClient ??= new GdexStreamService({\n      url: this.dexBackendWsUrl,\n      ...(this.webSocketImpl === undefined ? {} : { webSocketImpl: this.webSocketImpl }),\n      ...(this.streamApiKey === undefined ? {} : { apiKey: this.streamApiKey }),\n    });\n    return this.streamClient;\n  }\n}\n\nfunction trimTrailingSlash(value: string): string {\n  return value.replace(/\\/$/u, '');\n}\n"],"mappings":"ipBAwEA,IAAaC,EAAb,KAAmB,CA4CjB,YAAY,EAAwB,CA1CpBD,EAAA,KAAA,oBAAA,IAAA,EAAA,EAEAA,EAAA,KAAA,qBAAA,IAAA,EAAA,EAEAA,EAAA,KAAA,SAAA,IAAA,EAAA,EAEAA,EAAA,KAAA,gBAAA,IAAA,EAAA,EAEAA,EAAA,KAAA,UAAA,IAAA,EAAA,EAEAA,EAAA,KAAA,UAAA,IAAA,EAAA,EAEAA,EAAA,KAAA,UAAA,IAAA,EAAA,EAEAA,EAAA,KAAA,QAAA,IAAA,EAAA,EAEAA,EAAA,KAAA,YAAA,IAAA,EAAA,EAEAA,EAAA,KAAA,QAAA,IAAA,EAAA,EAEAA,EAAA,KAAA,SAAA,IAAA,EAAA,EAEAA,EAAA,KAAA,SAAA,IAAA,EAAA,EAEAA,EAAA,KAAA,cAAA,IAAA,EAAA,EAEAA,EAAA,KAAA,OAAA,IAAA,EAAA,EAEAA,EAAA,KAAA,kBAAA,IAAA,EAAA,EACCA,EAAA,KAAA,gBAAA,IAAA,EAAA,EACAA,EAAA,KAAA,eAAA,IAAA,EAAA,EACTA,EAAA,KAAA,eAAA,IAAA,EAAA,EAYN,IAAME,EAAcC,EAAmBC,GAAS,KAAO,QACvD,KAAK,kBAAoBC,EACvBD,GAAS,mBAAqBF,EAAY,iBAC5C,EACA,KAAK,mBAAqBE,GAAS,oBAAsB,IACzD,KAAK,OAASA,GAAS,OACvB,KAAK,cAAgBA,GAAS,cAE9B,IAAME,EAAa,IAAIC,EACrBH,GAAS,cACT,KAAK,mBACLA,GAAS,IACX,EACA,KAAK,QAAU,IAAII,EAAa,CAC9B,kBAAmB,KAAK,kBACxB,mBAAoB,KAAK,mBACzB,GAAIJ,GAAS,OAAS,IAAA,GAAY,CAAC,EAAI,CAAE,KAAMA,EAAQ,IAAK,EAC5D,GAAIA,GAAS,gBAAkB,IAAA,GAAY,CAAC,EAAI,CAAE,cAAeA,EAAQ,aAAc,EACvF,GAAI,KAAK,gBAAkB,IAAA,GAAY,CAAC,EAAI,CAAE,cAAe,KAAK,aAAc,CAClF,CAAC,EACD,IAAMK,EAAU,CAAE,eAAgBL,GAAS,cAAe,EAC1D,KAAK,QAAU,IAAIM,EAAQ,KAAK,QAASD,CAAO,EAGhD,IAAME,EACJP,GAAS,mBAAqB,YAAc,IAAIQ,EAAqB,KAAK,QAC5E,KAAK,QAAU,IAAIC,EAAQ,KAAK,QAASF,CAAQ,EACjD,KAAK,MAAQ,IAAIG,EAAM,KAAK,QAASH,EAAUF,CAAO,EACtD,IAAMM,EAAa,CAAE,gBAAiBX,GAAS,gBAAiB,GAAGK,CAAQ,EAC3E,KAAK,UAAY,IAAIO,EACnB,KAAK,QACLL,EACA,KAAK,OACL,KAAK,cACLI,CACF,EACA,KAAK,MAAQ,IAAIE,EAAM,KAAK,QAASN,EAAU,KAAK,OAAQ,KAAK,cAAeI,CAAU,EAC1F,KAAK,OAAS,IAAIG,EAAO,KAAK,kBAAmBZ,CAAU,EAC3D,KAAK,OAAS,IAAIa,EAAO,KAAK,kBAAmBb,EAAYG,CAAO,EACpE,KAAK,YAAc,IAAIW,EAAY,KAAK,kBAAmBd,EAAYG,CAAO,EAC9E,KAAK,KAAO,IAAIY,EAAQ,KAAK,QAAS,KAAK,MAAM,EACjD,KAAK,gBACHjB,GAAS,kBACRA,GAAS,oBAAsB,IAAA,GAC5BF,EAAY,gBACZ,GAAG,KAAK,kBAAkB,QAAQ,SAAU,IAAI,EAAE,MACxD,KAAK,cAAgBE,GAAS,cAC9B,KAAK,aAAeA,GAAS,YAC/B,CAaA,IAAI,QAA4B,CAM9B,OALA,KAAK,eAAL,KAAK,aAAiB,IAAIkB,EAAkB,CAC1C,IAAK,KAAK,gBACV,GAAI,KAAK,gBAAkB,IAAA,GAAY,CAAC,EAAI,CAAE,cAAe,KAAK,aAAc,EAChF,GAAI,KAAK,eAAiB,IAAA,GAAY,CAAC,EAAI,CAAE,OAAQ,KAAK,YAAa,CACzE,CAAC,GACM,KAAK,YACd,CACF,EAEA,SAASjB,EAAkB,EAAuB,CAChD,OAAOkB,EAAM,QAAQ,OAAQ,EAAE,CACjC"}
+{"version":3,"file":"gswap.js","names":["_defineProperty","GSwap","environment","GSWAP_ENVIRONMENTS","options","trimTrailingSlash","httpClient","HttpClient","ChainGateway","lenient","Symbols","resolver","CanonicalSymbols","Quoting","Pools","keyOptions","Positions","Swaps","Assets","Market","Leaderboard","Onramper","DexFees","GdexStreamService","value"],"sources":["../../../src/classes/gswap.ts"],"sourcesContent":["import { Assets } from './assets.js';\nimport { DexFees } from './dex_fees.js';\nimport { ChainGateway } from './gateway.js';\nimport { GdexStreamService } from './gdex_stream.js';\nimport { HttpClient } from './http_client.js';\nimport { Leaderboard } from './leaderboard.js';\nimport { Market } from './market.js';\nimport { Onramper } from './onramper.js';\nimport { Pools } from './pools.js';\nimport { Positions } from './positions.js';\nimport { Quoting } from './quoting.js';\nimport type { GalaChainSigner, HttpRequestor, WireOptions } from '@gala-chain/gala-core-sdk';\nimport { CanonicalSymbols, Symbols } from './symbols.js';\nimport type { InvalidEntryHandler } from '../utils/lenient.js';\nimport { Swaps } from './swaps.js';\nimport type { GSwapEnv } from '../types/env.js';\nimport { GSWAP_ENVIRONMENTS } from '../types/env.js';\n\n/** Options for constructing a backend-routed SDK client. */\nexport interface GSwapOptions {\n  /** Signs every write. Without one, reads work and any write throws `NO_SIGNER`. */\n  signer?: GalaChainSigner | undefined;\n  /**\n   * The selected account, sent as `X-Wallet-Address` on writes (attribution only; the chain\n   * recovers the signer from the signature). Required for shadow writes.\n   */\n  walletAddress?: string | undefined;\n  /** `'stage'` or `'prod'` swap backend preset; defaults to `'prod'`. */\n  env?: GSwapEnv | undefined;\n  /** Overrides the preset's swap backend base URL (a test or private deployment). */\n  dexBackendBaseUrl?: string | undefined;\n  /** HTTP transport for every request; defaults to the global `fetch`. */\n  httpRequestor?: HttpRequestor | undefined;\n  /** Request timeout in milliseconds (default 30 000); `Infinity` arms no timer. */\n  chainCallTimeoutMs?: number | undefined;\n  /** Query encoding and `User-Agent` of the read requests (see {@link WireOptions}). */\n  wire?: WireOptions | undefined;\n  /**\n   * How tokens are turned into trading symbols. `'registry'` (default) reads the symbol registry\n   * once (`GET /v2/trade/symbols`, cached) and accepts symbols or class keys. `'canonical'` makes\n   * no registry request: the caller passes the backend's canonical trading symbols (from a quote,\n   * an estimate or a position), reads send tokens and ticks exactly as given (composite keys\n   * included) and the backend orients the pair; see {@link CanonicalSymbols}.\n   */\n  symbolResolution?: 'registry' | 'canonical' | undefined;\n  /**\n   * Told about every row of a pool, symbol, position, price, price-series, season or leaderboard\n   * answer that was skipped as unusable (see {@link InvalidEntryHandler}); without it such rows are\n   * skipped silently.\n   */\n  onInvalidEntry?: InvalidEntryHandler | undefined;\n  /** Realtime stream endpoint. Defaults to the environment's, or is derived from `dexBackendBaseUrl`. */\n  dexBackendWsUrl?: string | undefined;\n  /** WebSocket constructor for the realtime stream; required on Node.js older than 22. */\n  webSocketImpl?: unknown;\n  /**\n   * `x-api-key` for the privileged stream view; server-side only, and it requires `webSocketImpl`\n   * (see `GdexStreamConfig.apiKey`).\n   */\n  streamApiKey?: string | undefined;\n  /**\n   * Prefix of every write's `uniqueKey` (`<prefix><uuid>`). Defaults to `galaswap-operation-`,\n   * what frontend_v2 and wallet_extension send; defi-backend does not depend on it.\n   */\n  uniqueKeyPrefix?: string | undefined;\n}\n\n/**\n * Main entry point for the current GalaChainDex SDK: one client bundling the services that read\n * and write through the swap backend (`quoting`, `swaps`, `pools`, `positions`, `assets`,\n * `market`, `leaderboard`, `onramper`, `symbols`, `fees`, `stream`). See {@link GSwapOptions} for\n * configuration.\n */\nexport class GSwap {\n  /** The swap backend base URL every request goes to, without a trailing slash. */\n  public readonly dexBackendBaseUrl: string;\n  /** The request timeout in milliseconds (default 30 000; `Infinity` arms no timer). */\n  public readonly chainCallTimeoutMs: number;\n  /** The signer given at construction, if any. */\n  public readonly signer: GalaChainSigner | undefined;\n  /** The account given at construction, if any. */\n  public readonly walletAddress: string | undefined;\n  /** The chain-gateway client every other service reads and writes through. */\n  public readonly gateway: ChainGateway;\n  /** The trading-symbol registry. */\n  public readonly symbols: Symbols;\n  /** Read-only exact-input and exact-output quotes. */\n  public readonly quoting: Quoting;\n  /** Pool, slot0 and composite-pool reads. */\n  public readonly pools: Pools;\n  /** Position reads, liquidity estimates and liquidity / pool-creation writes. */\n  public readonly positions: Positions;\n  /** Queued swaps (`RequestTrade`), dark swaps and swap confirmation. */\n  public readonly swaps: Swaps;\n  /** User token balances. */\n  public readonly assets: Assets;\n  /** USD prices, price series and the platform volume totals. */\n  public readonly market: Market;\n  /** Trading-competition seasons and rankings. */\n  public readonly leaderboard: Leaderboard;\n  /** The Onramper (fiat on-ramp) widget URL. */\n  public readonly onramper: Onramper;\n  /** Network-fee quotes (DryRun) signed with this client's signer. */\n  public readonly fees: DexFees;\n  /** The realtime stream endpoint {@link GSwap.stream} connects to. */\n  public readonly dexBackendWsUrl: string;\n  private readonly webSocketImpl: unknown;\n  private readonly streamApiKey: string | undefined;\n  private streamClient: GdexStreamService | undefined;\n\n  /**\n   * Create an SDK client for prod (the default) or stage, or for a `dexBackendBaseUrl` of your own.\n   *\n   * @example\n   * ```typescript\n   * const gSwap = new GSwap({ env: 'stage' });\n   * const symbols = await gSwap.symbols.list();\n   * ```\n   */\n  constructor(options?: GSwapOptions) {\n    const environment = GSWAP_ENVIRONMENTS[options?.env ?? 'prod'];\n    this.dexBackendBaseUrl = trimTrailingSlash(\n      options?.dexBackendBaseUrl ?? environment.dexBackendBaseUrl,\n    );\n    this.chainCallTimeoutMs = options?.chainCallTimeoutMs ?? 30_000;\n    this.signer = options?.signer;\n    this.walletAddress = options?.walletAddress;\n\n    const httpClient = new HttpClient(\n      options?.httpRequestor,\n      this.chainCallTimeoutMs,\n      options?.wire,\n    );\n    this.gateway = new ChainGateway({\n      dexBackendBaseUrl: this.dexBackendBaseUrl,\n      chainCallTimeoutMs: this.chainCallTimeoutMs,\n      ...(options?.wire === undefined ? {} : { wire: options.wire }),\n      ...(options?.httpRequestor === undefined ? {} : { httpRequestor: options.httpRequestor }),\n      ...(this.walletAddress === undefined ? {} : { walletAddress: this.walletAddress }),\n    });\n    const lenient = { onInvalidEntry: options?.onInvalidEntry };\n    this.symbols = new Symbols(this.gateway, lenient);\n    // The services resolve tokens through the registry by default; the offline resolver sends the\n    // caller's canonical symbols and keys as they are and never reads the registry.\n    const resolver =\n      options?.symbolResolution === 'canonical' ? new CanonicalSymbols() : this.symbols;\n    this.quoting = new Quoting(this.gateway, resolver);\n    this.pools = new Pools(this.gateway, resolver, lenient);\n    const keyOptions = { uniqueKeyPrefix: options?.uniqueKeyPrefix, ...lenient };\n    this.positions = new Positions(\n      this.gateway,\n      resolver,\n      this.signer,\n      this.walletAddress,\n      keyOptions,\n    );\n    this.swaps = new Swaps(this.gateway, resolver, this.signer, this.walletAddress, keyOptions);\n    this.assets = new Assets(this.dexBackendBaseUrl, httpClient);\n    this.market = new Market(this.dexBackendBaseUrl, httpClient, lenient);\n    this.leaderboard = new Leaderboard(this.dexBackendBaseUrl, httpClient, lenient);\n    this.onramper = new Onramper(this.dexBackendBaseUrl, httpClient);\n    this.fees = new DexFees(this.gateway, this.signer);\n    this.dexBackendWsUrl =\n      options?.dexBackendWsUrl ??\n      (options?.dexBackendBaseUrl === undefined\n        ? environment.dexBackendWsUrl\n        : `${this.dexBackendBaseUrl.replace(/^http/u, 'ws')}/ws`);\n    this.webSocketImpl = options?.webSocketImpl;\n    this.streamApiKey = options?.streamApiKey;\n  }\n\n  /**\n   * The realtime stream client for this environment (created on first use, not connected until you\n   * call `connect()`).\n   *\n   * @example\n   * ```typescript\n   * const gSwap = new GSwap({ env: 'stage' });\n   * await gSwap.stream.connect();\n   * await gSwap.stream.subscribeLiquidity((event) => console.log(event.action, event.amount0));\n   * ```\n   */\n  get stream(): GdexStreamService {\n    this.streamClient ??= new GdexStreamService({\n      url: this.dexBackendWsUrl,\n      ...(this.webSocketImpl === undefined ? {} : { webSocketImpl: this.webSocketImpl }),\n      ...(this.streamApiKey === undefined ? {} : { apiKey: this.streamApiKey }),\n    });\n    return this.streamClient;\n  }\n}\n\nfunction trimTrailingSlash(value: string): string {\n  return value.replace(/\\/$/u, '');\n}\n"],"mappings":"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"}

package/dist/browser/classes/onramper.js

@@ -0,0 +1,2 @@
+import{GSwapSDKError as e}from"./gswap_sdk_error.js";import{HttpClient as t}from"./http_client.js";import{asEntryRecord as n}from"../utils/lenient.js";const r=[`buy`,`sell`,`swap`],i=[`defaultFiat`,`onlyCryptoNetworks`,`defaultPaymentMethod`,`defaultCrypto`,`onlyPaymentMethods`,`excludePaymentMethods`,`onlyFiat`,`excludeFiat`,`isAddressEditable`,`networkPrefix`],a=[`defaultAmount`,`sellDefaultAmount`];function o(t,n){return new e(`INVALID_DTO`,{method:`onramper.generateWidgetUrl`,field:t,expected:n})}function s(e){if(typeof e!=`object`||!e)throw o(`request`,`an object`);if(typeof e.walletAddress!=`string`||e.walletAddress.trim()===``)throw o(`walletAddress`,`a non-empty string`);let t={walletAddress:e.walletAddress};if(e.mode!==void 0){if(!r.includes(e.mode))throw o(`mode`,r.join(`, `));t.mode=e.mode}for(let n of i){let r=e[n];if(r!==void 0){if(typeof r!=`string`)throw o(n,`a string`);t[n]=r}}for(let n of a){let r=e[n];if(r!==void 0){if(typeof r!=`number`||!Number.isFinite(r)||r<0)throw o(n,`a finite number, 0 or more`);t[n]=r}}return t}function c(t){let r=n(n(t)?.data)?.url;if(typeof r==`string`&&r!==``)try{return new URL(r),r}catch{}throw new e(`INVALID_CHAIN_RESPONSE`,{resource:`onramper widget url`},{body:t,write:!1})}var l=class{constructor(e,t){this.dexBackendBaseUrl=e,this.httpClient=t}async generateWidgetUrl(e){let t=s(e);return c(await this.httpClient.sendPostRequest(this.dexBackendBaseUrl,`/api/v1/onramper`,`/generate-widget-url`,t))}};function u(e){return new l(e.dexBackendBaseUrl.replace(/\/$/u,``),new t(e.httpRequestor,e.timeoutMs,e.wire))}export{r as ONRAMPER_MODES,l as Onramper,u as createOnramper};
+//# sourceMappingURL=onramper.js.map

package/dist/browser/classes/onramper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onramper.js","names":["ONRAMPER_MODES","TEXT_FIELDS","AMOUNT_FIELDS","invalidField","GSwapSDKError","widgetBody","request","body","\"mode\"","field","value","widgetUrlOf","url","asEntryRecord","response","\"data\"","\"url\"","Onramper","dexBackendBaseUrl","httpClient","createOnramper","options","HttpClient"],"sources":["../../../src/classes/onramper.ts"],"sourcesContent":["import type { HttpRequestor, WireOptions } from '@gala-chain/gala-core-sdk';\nimport { asEntryRecord } from '../utils/lenient.js';\nimport { GSwapSDKError } from './gswap_sdk_error.js';\nimport { HttpClient } from './http_client.js';\n\n/** What the Onramper widget does. */\nexport const ONRAMPER_MODES = ['buy', 'sell', 'swap'] as const;\n\n/** One of {@link ONRAMPER_MODES}. */\nexport type OnramperMode = (typeof ONRAMPER_MODES)[number];\n\n/**\n * The request of {@link Onramper.generateWidgetUrl}: the fields of the swap backend's\n * `GenerateWidgetUrlDto`, no others (the backend refuses a field it does not know). A field left\n * out is the backend's default (`mode` `buy`, `defaultFiat` `USD`, `defaultAmount` 100,\n * `sellDefaultAmount` 1, `onlyCryptoNetworks` `gala`, `defaultPaymentMethod` `creditcard`,\n * `networkPrefix` `gala_gala`).\n */\nexport interface OnramperWidgetRequest {\n  /** The wallet that receives the crypto, sent as given (the backend wants an `0x` Ethereum address). */\n  walletAddress: string;\n  mode?: OnramperMode | undefined;\n  defaultFiat?: string | undefined;\n  /** The fiat amount the widget opens with (the backend accepts 15 to 15 000, at most 2 decimals). */\n  defaultAmount?: number | undefined;\n  /** The crypto amount a sell opens with (0.000001 to 1 000 000, at most 18 decimals). */\n  sellDefaultAmount?: number | undefined;\n  onlyCryptoNetworks?: string | undefined;\n  defaultPaymentMethod?: string | undefined;\n  defaultCrypto?: string | undefined;\n  onlyPaymentMethods?: string | undefined;\n  excludePaymentMethods?: string | undefined;\n  onlyFiat?: string | undefined;\n  excludeFiat?: string | undefined;\n  isAddressEditable?: string | undefined;\n  networkPrefix?: string | undefined;\n}\n\n/** The request fields that are text, besides `walletAddress` and `mode`. */\nconst TEXT_FIELDS = [\n  'defaultFiat',\n  'onlyCryptoNetworks',\n  'defaultPaymentMethod',\n  'defaultCrypto',\n  'onlyPaymentMethods',\n  'excludePaymentMethods',\n  'onlyFiat',\n  'excludeFiat',\n  'isAddressEditable',\n  'networkPrefix',\n] as const;\n\n/** The request fields that are amounts. */\nconst AMOUNT_FIELDS = ['defaultAmount', 'sellDefaultAmount'] as const;\n\nconst METHOD = 'onramper.generateWidgetUrl';\n\nfunction invalidField(field: string, expected: string): GSwapSDKError {\n  return new GSwapSDKError('INVALID_DTO', { method: METHOD, field, expected });\n}\n\n/**\n * The body to send: the fields the caller gave, checked. A field left out (or `undefined`) is not\n * sent, so the backend's default applies. An amount that is not a finite number is refused here:\n * `JSON.stringify` would turn `NaN` into `null`, which the backend reads as \"not given\" and\n * silently replaces with its default amount.\n */\nfunction widgetBody(request: OnramperWidgetRequest): Record<string, string | number> {\n  if (typeof request !== 'object' || request === null) {\n    throw invalidField('request', 'an object');\n  }\n  if (typeof request.walletAddress !== 'string' || request.walletAddress.trim() === '') {\n    throw invalidField('walletAddress', 'a non-empty string');\n  }\n  const body: Record<string, string | number> = { walletAddress: request.walletAddress };\n  if (request.mode !== undefined) {\n    if (!(ONRAMPER_MODES as readonly unknown[]).includes(request.mode)) {\n      throw invalidField('mode', ONRAMPER_MODES.join(', '));\n    }\n    body['mode'] = request.mode;\n  }\n  for (const field of TEXT_FIELDS) {\n    const value: unknown = request[field];\n    if (value === undefined) continue;\n    if (typeof value !== 'string') throw invalidField(field, 'a string');\n    body[field] = value;\n  }\n  for (const field of AMOUNT_FIELDS) {\n    const value: unknown = request[field];\n    if (value === undefined) continue;\n    if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {\n      throw invalidField(field, 'a finite number, 0 or more');\n    }\n    body[field] = value;\n  }\n  return body;\n}\n\n/** The widget URL of the backend's `{ status, error, message, data: { url } }` answer. */\nfunction widgetUrlOf(response: unknown): string {\n  const data = asEntryRecord(asEntryRecord(response)?.['data']);\n  const url = data?.['url'];\n  if (typeof url === 'string' && url !== '') {\n    try {\n      // Only to know it is an absolute URL; the backend's text is returned as it is.\n      void new URL(url);\n      return url;\n    } catch {\n      // Falls through to the invalid-answer error below.\n    }\n  }\n  throw new GSwapSDKError(\n    'INVALID_CHAIN_RESPONSE',\n    { resource: 'onramper widget url' },\n    { body: response, write: false },\n  );\n}\n\n/**\n * The swap backend's Onramper (fiat on-ramp) widget URL. The route is PUBLIC: the request carries\n * no `Authorization` header and no signature, whatever session the app has, so no token can leak to\n * it. The backend signs the wallet into the URL; the app adds its own look (theme query parameters)\n * to the returned URL.\n */\nexport class Onramper {\n  /**\n   * Creates the service. To get one without building a whole {@link GSwap} client, use\n   * {@link createOnramper}.\n   *\n   * @example\n   * ```ts\n   * const onramper = new Onramper('https://dex-backend-prod1.defi.gala.com', httpClient);\n   * ```\n   */\n  constructor(\n    private readonly dexBackendBaseUrl: string,\n    private readonly httpClient: HttpClient,\n  ) {}\n\n  /**\n   * Asks the backend for a signed Onramper widget URL for `request.walletAddress`.\n   *\n   * @returns The widget URL.\n   * @throws GSwapSDKError `INVALID_DTO` (before anything is sent: no wallet address, an unknown\n   * `mode`, a text field that is not text, an amount that is not a finite number of 0 or more),\n   * `HTTP_ERROR` (the backend refused: `serverMessage` is its message, e.g. \"Failed to generate\n   * widget URL. Check server configuration.\" for a 500, its validation message for a 400, the\n   * throttle for a 429), `REQUEST_FAILED` (no answer), `INVALID_CHAIN_RESPONSE` (an answer without\n   * a usable `data.url`).\n   *\n   * @example\n   * ```ts\n   * const url = await gSwap.onramper.generateWidgetUrl({\n   *   walletAddress: '0x70997970C51812dc3A010C7d01b50e0d17dc79C8',\n   *   defaultCrypto: 'gala',\n   *   onlyCryptoNetworks: 'gala',\n   *   mode: 'buy',\n   * });\n   * window.open(url);\n   * ```\n   */\n  public async generateWidgetUrl(request: OnramperWidgetRequest): Promise<string> {\n    const body = widgetBody(request);\n    const response = await this.httpClient.sendPostRequest<unknown>(\n      this.dexBackendBaseUrl,\n      '/api/v1/onramper',\n      '/generate-widget-url',\n      body,\n    );\n    return widgetUrlOf(response);\n  }\n}\n\n/** Options of {@link createOnramper}. */\nexport interface OnramperOptions {\n  /** The swap backend's base URL (no trailing slash needed). */\n  dexBackendBaseUrl: string;\n  /** Your own HTTP requestor instead of `fetch`. */\n  httpRequestor?: HttpRequestor | undefined;\n  /** Request timeout in milliseconds (default 30 000). */\n  timeoutMs?: number | undefined;\n  /** Query encoding and `User-Agent` of the requests. */\n  wire?: WireOptions | undefined;\n}\n\n/**\n * An {@link Onramper} for a swap backend, without building a {@link GSwap} client (no signer, no\n * wallet, no pool or stream services): the call for an app that only needs the widget URL.\n *\n * @example\n * ```ts\n * import { createOnramper } from '@gala-chain/gswap-sdk';\n *\n * const onramper = createOnramper({ dexBackendBaseUrl: 'https://dex-backend-prod1.defi.gala.com' });\n * const url = await onramper.generateWidgetUrl({ walletAddress, mode: 'buy' });\n * ```\n */\nexport function createOnramper(options: OnramperOptions): Onramper {\n  return new Onramper(\n    options.dexBackendBaseUrl.replace(/\\/$/u, ''),\n    new HttpClient(options.httpRequestor, options.timeoutMs, options.wire),\n  );\n}\n"],"mappings":"uJAMA,MAAaA,EAAiB,CAAC,MAAO,OAAQ,MAAM,EAiC9CC,EAAc,CAClB,cACA,qBACA,uBACA,gBACA,qBACA,wBACA,WACA,cACA,oBACA,eACF,EAGMC,EAAgB,CAAC,gBAAiB,mBAAmB,EAI3D,SAASC,EAAa,EAAe,EAAiC,CACpE,OAAO,IAAIC,EAAc,cAAe,CAAE,OAAQ,6BAAQ,QAAO,UAAS,CAAC,CAC7E,CAQA,SAASC,EAAW,EAAiE,CACnF,GAAI,OAAOC,GAAY,WAAYA,EACjC,MAAMH,EAAa,UAAW,WAAW,EAE3C,GAAI,OAAOG,EAAQ,eAAkB,UAAYA,EAAQ,cAAc,KAAK,IAAM,GAChF,MAAMH,EAAa,gBAAiB,oBAAoB,EAE1D,IAAMI,EAAwC,CAAE,cAAeD,EAAQ,aAAc,EACrF,GAAIA,EAAQ,OAAS,IAAA,GAAW,CAC9B,GAAI,CAAEN,EAAsC,SAASM,EAAQ,IAAI,EAC/D,MAAMH,EAAa,OAAQH,EAAe,KAAK,IAAI,CAAC,EAEtD,EAAKQ,KAAUF,EAAQ,IACzB,CACA,IAAK,IAAMG,KAASR,EAAa,CAC/B,IAAMS,EAAiBJ,EAAQG,GAC/B,GAAIC,IAAU,IAAA,GACd,IAAI,OAAOA,GAAU,SAAU,MAAMP,EAAaM,EAAO,UAAU,EACnE,EAAKA,GAASC,CADqD,CAErE,CACA,IAAK,IAAMD,KAASP,EAAe,CACjC,IAAMQ,EAAiBJ,EAAQG,GAC/B,GAAIC,IAAU,IAAA,GACd,IAAI,OAAOA,GAAU,UAAY,CAAC,OAAO,SAASA,CAAK,GAAKA,EAAQ,EAClE,MAAMP,EAAaM,EAAO,4BAA4B,EAExD,EAAKA,GAASC,CAF0C,CAG1D,CACA,OAAOH,CACT,CAGA,SAASI,EAAY,EAA2B,CAE9C,IAAMC,EADOC,EAAcA,EAAcC,CAAQ,CAAC,EAAGC,IACtC,CAAC,EAAGC,IACnB,GAAI,OAAOJ,GAAQ,UAAYA,IAAQ,GACrC,GAAI,CAGF,OADA,IAAS,IAAIA,CAAG,EACTA,CACT,MAAQ,CAER,CAEF,MAAM,IAAIR,EACR,yBACA,CAAE,SAAU,qBAAsB,EAClC,CAAE,KAAMU,EAAU,MAAO,EAAM,CACjC,CACF,CAQA,IAAaG,EAAb,KAAsB,CAUpB,YACE,EACA,EACA,CAFiB,KAAA,kBAAAC,EACA,KAAA,WAAAC,CAChB,CAwBH,MAAa,kBAAkB,EAAiD,CAC9E,IAAMZ,EAAOF,EAAWC,CAAO,EAO/B,OAAOK,EAAY,MANI,KAAK,WAAW,gBACrC,KAAK,kBACL,mBACA,uBACAJ,CACF,CAC2B,CAC7B,CACF,EA0BA,SAAgBa,EAAe,EAAoC,CACjE,OAAO,IAAIH,EACTI,EAAQ,kBAAkB,QAAQ,OAAQ,EAAE,EAC5C,IAAIC,EAAWD,EAAQ,cAAeA,EAAQ,UAAWA,EAAQ,IAAI,CACvE,CACF"}

package/dist/browser/index.js

@@ -1 +1 @@
-import{GSWAP_ERROR_CATALOG as e,SUBMISSION_OUTCOME_UNKNOWN_REASONS as t,gswapErrorTemplates as n}from"./classes/gswap_error_catalog.js";import{GSWAP_ERROR_PHASE_BY_CODE as r}from"./classes/gswap_error_phase_table.js";import{GSwapSDKError as i,UPDATE_REQUIRED_STATUS as a,getObjectProperty as o,getStringProperty as s,isGSwapError as c,isPreSendError as l}from"./classes/gswap_sdk_error.js";import{AppliedTradeError as u,confirmAppliedTrade as d}from"./classes/apply_results.js";import{ALL_FEE_TIERS as f,FEE_TIER as p,TICK_SPACING_BY_FEE as m}from"./types/fees.js";import{isTickInRange as h}from"./utils/tick_range.js";import{GC_MAX_TICK as g,GC_MIN_TICK as _,isSqrtPriceInRange as v,sqrtPriceToTick as y,tickFromPrice as b,tickToPrice as x,tickToSqrtPrice as S}from"./utils/tick_math.js";import{assertCanonicalPair as C,isProposableTradingSymbol as w,validateFee as T,validateNumericAmount as E,validatePriceValues as D,validateTickRange as O,validateTickSpacing as k,validateTokenDecimals as A,validateWalletAddress as j}from"./utils/validation.js";import{Assets as M}from"./classes/assets.js";import{DEX_FEE_METHODS as N,DRY_RUN_METHOD as P,DRY_RUN_UNIQUE_KEY_PREFIX as F,DexFees as I,buildDryRunWrapper as L,isCurrentContractDexMessage as R,isDexFeeMethod as z,toChainDto as B}from"./classes/dex_fees.js";import{isShadowError as V}from"./utils/shadow_errors.js";import{SubmittedTransaction as H}from"./classes/submitted_transaction.js";import{ChainGateway as U}from"./classes/gateway.js";import{GSWAP_ENVIRONMENTS as W}from"./types/env.js";import{GdexStreamError as G,GdexStreamService as K,isGdexLiquidityEvent as q}from"./classes/gdex_stream.js";import{Leaderboard as J}from"./classes/leaderboard.js";import{MARKET_PRICE_BATCH_LIMIT as Y,PRICE_SERIES_TIMEFRAMES as X}from"./types/market.js";import{MARKET_PRICE_QUERY_BYTES as Z,Market as Q,priceBatches as $}from"./classes/market.js";import{orderSymbols as ee,parseTokenClassKey as te,readOrderedSymbols as ne}from"./utils/ordering.js";import{CanonicalSymbols as re,Symbols as ie,queryTokenOf as ae,rawTokenOf as oe,tradingSymbolOf as se}from"./classes/symbols.js";import{Pools as ce}from"./classes/pools.js";import{alignTickDownOrNaN as le,alignTickUpOrNaN as ue}from"./utils/tick_align.js";import{alignTickDown as de,alignTickUp as fe,assertTickRange as pe,frameSlot0 as me}from"./utils/ticks.js";import{assertCanonicalV2Dto as he,buildAddLiquidityDto as ge,buildCollectPositionFeesDto as _e,buildCreatePoolDto as ve,buildRemoveLiquidityDto as ye,buildRequestTradeDto as be}from"./utils/dto_builders.js";import{Positions as xe}from"./classes/positions.js";import{Quoting as Se}from"./classes/quoting.js";import{SHADOW_FAILURE_KINDS as Ce,SHADOW_SUBMIT_CODES as we,classifyShadowSubmitError as Te,classifyShadowSubmitStatus as Ee,readShadowSubmitOutcome as De}from"./classes/shadow_submit.js";import{Swaps as Oe,swapRouteFromQuote as ke}from"./classes/swaps.js";import{GSwap as Ae}from"./classes/gswap.js";import{NOT_QUEUED_FINAL as je,classification as Me,notSentClassification as Ne}from"./utils/classification.js";import{classifyFailure as Pe,mayHaveBeenQueued as Fe}from"./utils/failure_classification.js";import{PENDING_SWAP_FATES as Ie,pendingSwapFateFor as Le,pendingSwapFateOfOutcome as Re}from"./classes/pending_swap_fate.js";import{PENDING_SWAPS_STORAGE_KEY as ze,PENDING_SWAP_EXPIRY_MS as Be,PENDING_SWAP_PRUNE_REASONS as Ve,PendingSwapStore as He}from"./classes/pending_swaps.js";import{storageAdapterFromChromeStorage as Ue,webStorageAdapter as We}from"./classes/storage_adapters.js";import{confirmationStateOf as Ge,isConfirmationAborted as Ke,isConfirmationTimeout as qe}from"./utils/confirmation_state.js";import{chainErrorKeyOf as Je,isNoMarket as Ye,isRelayableRefusal as Xe,isUninterpretedAnswer as Ze,isUniqueKeyConsumed as Qe,isUnprovenAcknowledgement as $e}from"./utils/failure_guards.js";import{classifySubmitEnvelope as et,isSubmitExecuted as tt,isSubmitQueued as nt,isSubmitRejected as rt}from"./utils/submit_state.js";export{f as ALL_FEE_TIERS,u as AppliedTradeError,M as Assets,re as CanonicalSymbols,U as ChainGateway,N as DEX_FEE_METHODS,P as DRY_RUN_METHOD,F as DRY_RUN_UNIQUE_KEY_PREFIX,I as DexFees,p as FEE_TIER,g as GC_MAX_TICK,_ as GC_MIN_TICK,W as GSWAP_ENVIRONMENTS,e as GSWAP_ERROR_CATALOG,r as GSWAP_ERROR_PHASE_BY_CODE,Ae as GSwap,i as GSwapSDKError,G as GdexStreamError,K as GdexStreamService,J as Leaderboard,Y as MARKET_PRICE_BATCH_LIMIT,Z as MARKET_PRICE_QUERY_BYTES,Q as Market,je as NOT_QUEUED_FINAL,ze as PENDING_SWAPS_STORAGE_KEY,Be as PENDING_SWAP_EXPIRY_MS,Ie as PENDING_SWAP_FATES,Ve as PENDING_SWAP_PRUNE_REASONS,X as PRICE_SERIES_TIMEFRAMES,He as PendingSwapStore,ce as Pools,xe as Positions,Se as Quoting,Ce as SHADOW_FAILURE_KINDS,we as SHADOW_SUBMIT_CODES,t as SUBMISSION_OUTCOME_UNKNOWN_REASONS,H as SubmittedTransaction,Oe as Swaps,ie as Symbols,m as TICK_SPACING_BY_FEE,a as UPDATE_REQUIRED_STATUS,de as alignTickDown,le as alignTickDownOrNaN,fe as alignTickUp,ue as alignTickUpOrNaN,C as assertCanonicalPair,he as assertCanonicalV2Dto,pe as assertTickRange,ge as buildAddLiquidityDto,_e as buildCollectPositionFeesDto,ve as buildCreatePoolDto,L as buildDryRunWrapper,ye as buildRemoveLiquidityDto,be as buildRequestTradeDto,Je as chainErrorKeyOf,Me as classification,Pe as classifyFailure,Te as classifyShadowSubmitError,Ee as classifyShadowSubmitStatus,et as classifySubmitEnvelope,d as confirmAppliedTrade,Ge as confirmationStateOf,me as frameSlot0,o as getObjectProperty,s as getStringProperty,n as gswapErrorTemplates,Ke as isConfirmationAborted,qe as isConfirmationTimeout,R as isCurrentContractDexMessage,z as isDexFeeMethod,c as isGSwapError,q as isGdexLiquidityEvent,Ye as isNoMarket,l as isPreSendError,w as isProposableTradingSymbol,Xe as isRelayableRefusal,V as isShadowError,v as isSqrtPriceInRange,tt as isSubmitExecuted,nt as isSubmitQueued,rt as isSubmitRejected,h as isTickInRange,Ze as isUninterpretedAnswer,Qe as isUniqueKeyConsumed,$e as isUnprovenAcknowledgement,Fe as mayHaveBeenQueued,Ne as notSentClassification,ee as orderSymbols,te as parseTokenClassKey,Le as pendingSwapFateFor,Re as pendingSwapFateOfOutcome,$ as priceBatches,ae as queryTokenOf,oe as rawTokenOf,ne as readOrderedSymbols,De as readShadowSubmitOutcome,y as sqrtPriceToTick,Ue as storageAdapterFromChromeStorage,ke as swapRouteFromQuote,b as tickFromPrice,x as tickToPrice,S as tickToSqrtPrice,B as toChainDto,se as tradingSymbolOf,T as validateFee,E as validateNumericAmount,D as validatePriceValues,O as validateTickRange,k as validateTickSpacing,A as validateTokenDecimals,j as validateWalletAddress,We as webStorageAdapter};
+import{GSWAP_ERROR_CATALOG as e,SUBMISSION_OUTCOME_UNKNOWN_REASONS as t,gswapErrorTemplates as n}from"./classes/gswap_error_catalog.js";import{GSWAP_ERROR_PHASE_BY_CODE as r}from"./classes/gswap_error_phase_table.js";import{GSwapSDKError as i,UPDATE_REQUIRED_STATUS as a,getObjectProperty as o,getStringProperty as s,isGSwapError as c,isPreSendError as l}from"./classes/gswap_sdk_error.js";import{AppliedTradeError as u,confirmAppliedTrade as d}from"./classes/apply_results.js";import{ALL_FEE_TIERS as f,FEE_TIER as p,TICK_SPACING_BY_FEE as m}from"./types/fees.js";import{isTickInRange as h}from"./utils/tick_range.js";import{GC_MAX_TICK as g,GC_MIN_TICK as _,isSqrtPriceInRange as v,sqrtPriceToTick as y,tickFromPrice as b,tickToPrice as x,tickToSqrtPrice as S}from"./utils/tick_math.js";import{assertCanonicalPair as C,isProposableTradingSymbol as w,validateFee as T,validateNumericAmount as E,validatePriceValues as D,validateTickRange as O,validateTickSpacing as k,validateTokenDecimals as A,validateWalletAddress as j}from"./utils/validation.js";import{Assets as M}from"./classes/assets.js";import{DEX_FEE_METHODS as N,DRY_RUN_METHOD as P,DRY_RUN_UNIQUE_KEY_PREFIX as F,DexFees as I,buildDryRunWrapper as L,isCurrentContractDexMessage as R,isDexFeeMethod as z,toChainDto as B}from"./classes/dex_fees.js";import{isShadowError as V}from"./utils/shadow_errors.js";import{SubmittedTransaction as H}from"./classes/submitted_transaction.js";import{ChainGateway as U}from"./classes/gateway.js";import{GSWAP_ENVIRONMENTS as W}from"./types/env.js";import{GdexStreamError as G,GdexStreamService as K,isGdexLiquidityEvent as q}from"./classes/gdex_stream.js";import{Leaderboard as J}from"./classes/leaderboard.js";import{MARKET_PRICE_BATCH_LIMIT as Y,PRICE_SERIES_TIMEFRAMES as X}from"./types/market.js";import{MARKET_PRICE_QUERY_BYTES as Z,Market as Q,priceBatches as $}from"./classes/market.js";import{ONRAMPER_MODES as ee,Onramper as te,createOnramper as ne}from"./classes/onramper.js";import{orderSymbols as re,parseTokenClassKey as ie,readOrderedSymbols as ae}from"./utils/ordering.js";import{CanonicalSymbols as oe,Symbols as se,queryTokenOf as ce,rawTokenOf as le,tradingSymbolOf as ue}from"./classes/symbols.js";import{Pools as de}from"./classes/pools.js";import{alignTickDownOrNaN as fe,alignTickUpOrNaN as pe}from"./utils/tick_align.js";import{alignTickDown as me,alignTickUp as he,assertTickRange as ge,frameSlot0 as _e}from"./utils/ticks.js";import{assertCanonicalV2Dto as ve,buildAddLiquidityDto as ye,buildCollectPositionFeesDto as be,buildCreatePoolDto as xe,buildRemoveLiquidityDto as Se,buildRequestTradeDto as Ce}from"./utils/dto_builders.js";import{Positions as we}from"./classes/positions.js";import{Quoting as Te}from"./classes/quoting.js";import{SHADOW_FAILURE_KINDS as Ee,SHADOW_SUBMIT_CODES as De,classifyShadowSubmitError as Oe,classifyShadowSubmitStatus as ke,readShadowSubmitOutcome as Ae}from"./classes/shadow_submit.js";import{Swaps as je,swapRouteFromQuote as Me}from"./classes/swaps.js";import{GSwap as Ne}from"./classes/gswap.js";import{NOT_QUEUED_FINAL as Pe,classification as Fe,notSentClassification as Ie}from"./utils/classification.js";import{classifyFailure as Le,mayHaveBeenQueued as Re}from"./utils/failure_classification.js";import{PENDING_SWAP_FATES as ze,pendingSwapFateFor as Be,pendingSwapFateOfOutcome as Ve}from"./classes/pending_swap_fate.js";import{PENDING_SWAPS_STORAGE_KEY as He,PENDING_SWAP_EXPIRY_MS as Ue,PENDING_SWAP_PRUNE_REASONS as We,PendingSwapStore as Ge}from"./classes/pending_swaps.js";import{storageAdapterFromChromeStorage as Ke,webStorageAdapter as qe}from"./classes/storage_adapters.js";import{confirmationStateOf as Je,isConfirmationAborted as Ye,isConfirmationTimeout as Xe}from"./utils/confirmation_state.js";import{chainErrorKeyOf as Ze,isNoMarket as Qe,isRelayableRefusal as $e,isUninterpretedAnswer as et,isUniqueKeyConsumed as tt,isUnprovenAcknowledgement as nt}from"./utils/failure_guards.js";import{classifySubmitEnvelope as rt,isSubmitExecuted as it,isSubmitQueued as at,isSubmitRejected as ot}from"./utils/submit_state.js";export{f as ALL_FEE_TIERS,u as AppliedTradeError,M as Assets,oe as CanonicalSymbols,U as ChainGateway,N as DEX_FEE_METHODS,P as DRY_RUN_METHOD,F as DRY_RUN_UNIQUE_KEY_PREFIX,I as DexFees,p as FEE_TIER,g as GC_MAX_TICK,_ as GC_MIN_TICK,W as GSWAP_ENVIRONMENTS,e as GSWAP_ERROR_CATALOG,r as GSWAP_ERROR_PHASE_BY_CODE,Ne as GSwap,i as GSwapSDKError,G as GdexStreamError,K as GdexStreamService,J as Leaderboard,Y as MARKET_PRICE_BATCH_LIMIT,Z as MARKET_PRICE_QUERY_BYTES,Q as Market,Pe as NOT_QUEUED_FINAL,ee as ONRAMPER_MODES,te as Onramper,He as PENDING_SWAPS_STORAGE_KEY,Ue as PENDING_SWAP_EXPIRY_MS,ze as PENDING_SWAP_FATES,We as PENDING_SWAP_PRUNE_REASONS,X as PRICE_SERIES_TIMEFRAMES,Ge as PendingSwapStore,de as Pools,we as Positions,Te as Quoting,Ee as SHADOW_FAILURE_KINDS,De as SHADOW_SUBMIT_CODES,t as SUBMISSION_OUTCOME_UNKNOWN_REASONS,H as SubmittedTransaction,je as Swaps,se as Symbols,m as TICK_SPACING_BY_FEE,a as UPDATE_REQUIRED_STATUS,me as alignTickDown,fe as alignTickDownOrNaN,he as alignTickUp,pe as alignTickUpOrNaN,C as assertCanonicalPair,ve as assertCanonicalV2Dto,ge as assertTickRange,ye as buildAddLiquidityDto,be as buildCollectPositionFeesDto,xe as buildCreatePoolDto,L as buildDryRunWrapper,Se as buildRemoveLiquidityDto,Ce as buildRequestTradeDto,Ze as chainErrorKeyOf,Fe as classification,Le as classifyFailure,Oe as classifyShadowSubmitError,ke as classifyShadowSubmitStatus,rt as classifySubmitEnvelope,d as confirmAppliedTrade,Je as confirmationStateOf,ne as createOnramper,_e as frameSlot0,o as getObjectProperty,s as getStringProperty,n as gswapErrorTemplates,Ye as isConfirmationAborted,Xe as isConfirmationTimeout,R as isCurrentContractDexMessage,z as isDexFeeMethod,c as isGSwapError,q as isGdexLiquidityEvent,Qe as isNoMarket,l as isPreSendError,w as isProposableTradingSymbol,$e as isRelayableRefusal,V as isShadowError,v as isSqrtPriceInRange,it as isSubmitExecuted,at as isSubmitQueued,ot as isSubmitRejected,h as isTickInRange,et as isUninterpretedAnswer,tt as isUniqueKeyConsumed,nt as isUnprovenAcknowledgement,Re as mayHaveBeenQueued,Ie as notSentClassification,re as orderSymbols,ie as parseTokenClassKey,Be as pendingSwapFateFor,Ve as pendingSwapFateOfOutcome,$ as priceBatches,ce as queryTokenOf,le as rawTokenOf,ae as readOrderedSymbols,Ae as readShadowSubmitOutcome,y as sqrtPriceToTick,Ke as storageAdapterFromChromeStorage,Me as swapRouteFromQuote,b as tickFromPrice,x as tickToPrice,S as tickToSqrtPrice,B as toChainDto,ue as tradingSymbolOf,T as validateFee,E as validateNumericAmount,D as validatePriceValues,O as validateTickRange,k as validateTickSpacing,A as validateTokenDecimals,j as validateWalletAddress,qe as webStorageAdapter};

package/dist/index.cjs

@@ -3331,6 +3331,144 @@ function parseVolumeSummary(data) {
 	return summary;
 }
 
+//#endregion
+//#region src/classes/onramper.ts
+/** What the Onramper widget does. */
+const ONRAMPER_MODES = [
+	"buy",
+	"sell",
+	"swap"
+];
+/** The request fields that are text, besides `walletAddress` and `mode`. */
+const TEXT_FIELDS = [
+	"defaultFiat",
+	"onlyCryptoNetworks",
+	"defaultPaymentMethod",
+	"defaultCrypto",
+	"onlyPaymentMethods",
+	"excludePaymentMethods",
+	"onlyFiat",
+	"excludeFiat",
+	"isAddressEditable",
+	"networkPrefix"
+];
+/** The request fields that are amounts. */
+const AMOUNT_FIELDS = ["defaultAmount", "sellDefaultAmount"];
+const METHOD = "onramper.generateWidgetUrl";
+function invalidField(field, expected) {
+	return new GSwapSDKError("INVALID_DTO", {
+		method: METHOD,
+		field,
+		expected
+	});
+}
+/**
+* The body to send: the fields the caller gave, checked. A field left out (or `undefined`) is not
+* sent, so the backend's default applies. An amount that is not a finite number is refused here:
+* `JSON.stringify` would turn `NaN` into `null`, which the backend reads as "not given" and
+* silently replaces with its default amount.
+*/
+function widgetBody(request) {
+	if (typeof request !== "object" || request === null) throw invalidField("request", "an object");
+	if (typeof request.walletAddress !== "string" || request.walletAddress.trim() === "") throw invalidField("walletAddress", "a non-empty string");
+	const body = { walletAddress: request.walletAddress };
+	if (request.mode !== void 0) {
+		if (!ONRAMPER_MODES.includes(request.mode)) throw invalidField("mode", ONRAMPER_MODES.join(", "));
+		body["mode"] = request.mode;
+	}
+	for (const field of TEXT_FIELDS) {
+		const value = request[field];
+		if (value === void 0) continue;
+		if (typeof value !== "string") throw invalidField(field, "a string");
+		body[field] = value;
+	}
+	for (const field of AMOUNT_FIELDS) {
+		const value = request[field];
+		if (value === void 0) continue;
+		if (typeof value !== "number" || !Number.isFinite(value) || value < 0) throw invalidField(field, "a finite number, 0 or more");
+		body[field] = value;
+	}
+	return body;
+}
+/** The widget URL of the backend's `{ status, error, message, data: { url } }` answer. */
+function widgetUrlOf(response) {
+	var _asEntryRecord;
+	const data = asEntryRecord((_asEntryRecord = asEntryRecord(response)) === null || _asEntryRecord === void 0 ? void 0 : _asEntryRecord["data"]);
+	const url = data === null || data === void 0 ? void 0 : data["url"];
+	if (typeof url === "string" && url !== "") try {
+		new URL(url);
+		return url;
+	} catch {}
+	throw new GSwapSDKError("INVALID_CHAIN_RESPONSE", { resource: "onramper widget url" }, {
+		body: response,
+		write: false
+	});
+}
+/**
+* The swap backend's Onramper (fiat on-ramp) widget URL. The route is PUBLIC: the request carries
+* no `Authorization` header and no signature, whatever session the app has, so no token can leak to
+* it. The backend signs the wallet into the URL; the app adds its own look (theme query parameters)
+* to the returned URL.
+*/
+var Onramper = class {
+	dexBackendBaseUrl;
+	httpClient;
+	/**
+	* Creates the service. To get one without building a whole {@link GSwap} client, use
+	* {@link createOnramper}.
+	*
+	* @example
+	* ```ts
+	* const onramper = new Onramper('https://dex-backend-prod1.defi.gala.com', httpClient);
+	* ```
+	*/
+	constructor(dexBackendBaseUrl, httpClient) {
+		this.dexBackendBaseUrl = dexBackendBaseUrl;
+		this.httpClient = httpClient;
+	}
+	/**
+	* Asks the backend for a signed Onramper widget URL for `request.walletAddress`.
+	*
+	* @returns The widget URL.
+	* @throws GSwapSDKError `INVALID_DTO` (before anything is sent: no wallet address, an unknown
+	* `mode`, a text field that is not text, an amount that is not a finite number of 0 or more),
+	* `HTTP_ERROR` (the backend refused: `serverMessage` is its message, e.g. "Failed to generate
+	* widget URL. Check server configuration." for a 500, its validation message for a 400, the
+	* throttle for a 429), `REQUEST_FAILED` (no answer), `INVALID_CHAIN_RESPONSE` (an answer without
+	* a usable `data.url`).
+	*
+	* @example
+	* ```ts
+	* const url = await gSwap.onramper.generateWidgetUrl({
+	*   walletAddress: '0x70997970C51812dc3A010C7d01b50e0d17dc79C8',
+	*   defaultCrypto: 'gala',
+	*   onlyCryptoNetworks: 'gala',
+	*   mode: 'buy',
+	* });
+	* window.open(url);
+	* ```
+	*/
+	async generateWidgetUrl(request) {
+		const body = widgetBody(request);
+		return widgetUrlOf(await this.httpClient.sendPostRequest(this.dexBackendBaseUrl, "/api/v1/onramper", "/generate-widget-url", body));
+	}
+};
+/**
+* An {@link Onramper} for a swap backend, without building a {@link GSwap} client (no signer, no
+* wallet, no pool or stream services): the call for an app that only needs the widget URL.
+*
+* @example
+* ```ts
+* import { createOnramper } from '@gala-chain/gswap-sdk';
+*
+* const onramper = createOnramper({ dexBackendBaseUrl: 'https://dex-backend-prod1.defi.gala.com' });
+* const url = await onramper.generateWidgetUrl({ walletAddress, mode: 'buy' });
+* ```
+*/
+function createOnramper(options) {
+	return new Onramper(options.dexBackendBaseUrl.replace(/\/$/u, ""), new HttpClient(options.httpRequestor, options.timeoutMs, options.wire));
+}
+
 //#endregion
 //#region src/utils/ordering.ts
 /** Return two trading symbols in the contract's plain-string order. */
@@ -5497,7 +5635,7 @@ var Swaps = class {
 /**
 * Main entry point for the current GalaChainDex SDK: one client bundling the services that read
 * and write through the swap backend (`quoting`, `swaps`, `pools`, `positions`, `assets`,
-* `market`, `leaderboard`, `symbols`, `fees`, `stream`). See {@link GSwapOptions} for
+* `market`, `leaderboard`, `onramper`, `symbols`, `fees`, `stream`). See {@link GSwapOptions} for
 * configuration.
 */
 var GSwap = class {
@@ -5527,6 +5665,8 @@ var GSwap = class {
 	market;
 	/** Trading-competition seasons and rankings. */
 	leaderboard;
+	/** The Onramper (fiat on-ramp) widget URL. */
+	onramper;
 	/** Network-fee quotes (DryRun) signed with this client's signer. */
 	fees;
 	/** The realtime stream endpoint {@link GSwap.stream} connects to. */
@@ -5571,6 +5711,7 @@ var GSwap = class {
 		this.assets = new Assets(this.dexBackendBaseUrl, httpClient);
 		this.market = new Market(this.dexBackendBaseUrl, httpClient, lenient);
 		this.leaderboard = new Leaderboard(this.dexBackendBaseUrl, httpClient, lenient);
+		this.onramper = new Onramper(this.dexBackendBaseUrl, httpClient);
 		this.fees = new DexFees(this.gateway, this.signer);
 		this.dexBackendWsUrl = (options === null || options === void 0 ? void 0 : options.dexBackendWsUrl) ?? ((options === null || options === void 0 ? void 0 : options.dexBackendBaseUrl) === void 0 ? environment.dexBackendWsUrl : `${this.dexBackendBaseUrl.replace(/^http/u, "ws")}/ws`);
 		this.webSocketImpl = options === null || options === void 0 ? void 0 : options.webSocketImpl;
@@ -6506,6 +6647,8 @@ exports.MARKET_PRICE_BATCH_LIMIT = MARKET_PRICE_BATCH_LIMIT;
 exports.MARKET_PRICE_QUERY_BYTES = MARKET_PRICE_QUERY_BYTES;
 exports.Market = Market;
 exports.NOT_QUEUED_FINAL = NOT_QUEUED_FINAL;
+exports.ONRAMPER_MODES = ONRAMPER_MODES;
+exports.Onramper = Onramper;
 exports.PENDING_SWAPS_STORAGE_KEY = PENDING_SWAPS_STORAGE_KEY;
 exports.PENDING_SWAP_EXPIRY_MS = PENDING_SWAP_EXPIRY_MS;
 exports.PENDING_SWAP_FATES = PENDING_SWAP_FATES;
@@ -6544,6 +6687,7 @@ exports.classifyShadowSubmitStatus = classifyShadowSubmitStatus;
 exports.classifySubmitEnvelope = classifySubmitEnvelope;
 exports.confirmAppliedTrade = confirmAppliedTrade;
 exports.confirmationStateOf = confirmationStateOf;
+exports.createOnramper = createOnramper;
 exports.frameSlot0 = frameSlot0;
 exports.getObjectProperty = getObjectProperty;
 exports.getStringProperty = getStringProperty;