@hyperbridge/sdk 1.4.10 → 1.5.0

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.
package/README.md CHANGED
@@ -141,6 +141,104 @@ const hyperbridge = new SubstrateChain({
141
141
  const proof = await hyperbridge.queryStateProof(blockNumber, keys)
142
142
  ```
143
143
 
144
+ ### TokenGateway - Cross-Chain Token Transfers
145
+
146
+ The TokenGateway class provides methods for estimating fees and managing cross-chain token teleports via Hyperbridge. Supports both EVM and Substrate chains as destination.
147
+
148
+ ```ts
149
+ import { TokenGateway, EvmChain, SubstrateChain } from "@hyperbridge/sdk"
150
+ import { keccak256, toHex, pad, parseEther } from "viem"
151
+
152
+ // Create chain instances
153
+ const sourceChain = new EvmChain({
154
+ chainId: 97, // BSC Testnet
155
+ rpcUrl: "https://data-seed-prebsc-1-s1.binance.org:8545",
156
+ host: "0x...", // IsmpHost contract address
157
+ consensusStateId: "BSC0"
158
+ })
159
+
160
+ const destChain = new EvmChain({
161
+ chainId: 10200, // Gnosis Chiado
162
+ rpcUrl: "https://rpc.chiadochain.net",
163
+ host: "0x...", // IsmpHost contract address
164
+ consensusStateId: "GNO0"
165
+ })
166
+
167
+ // Initialize TokenGateway (destination can be EvmChain or SubstrateChain)
168
+ const tokenGateway = new TokenGateway({
169
+ source: sourceChain,
170
+ dest: destChain // EvmChain or SubstrateChain
171
+ })
172
+
173
+ // Estimate fees for a teleport
174
+ const assetId = keccak256(toHex("USDC")) // Asset identifier
175
+ const recipientAddress = pad("0xRecipientAddress", { size: 32 })
176
+
177
+ const teleportParams = {
178
+ amount: parseEther("100"), // Amount to teleport
179
+ assetId: assetId,
180
+ redeem: true, // Redeem as ERC20 on destination
181
+ to: recipientAddress,
182
+ dest: "EVM-10200", // Destination chain
183
+ timeout: 3600n, // Timeout in seconds
184
+ data: "0x" // Optional call data
185
+ }
186
+
187
+ // Get native cost estimate (protocol + relayer fees)
188
+ // For EVM destination chains, the relayer fee is automatically estimated by:
189
+ // 1. Creating a dummy post request with 191 bytes of random data
190
+ // 2. Estimating gas for delivery on the destination chain
191
+ // 3. Converting gas cost to native tokens and adding 1% buffer
192
+ // 4. Converting relayer fee to source fee token using getAmountsOut
193
+ // For Substrate destination chains, relayer fee is set to zero
194
+ // Returns: totalNativeCost (protocol fee with 1% buffer) and relayerFeeInSourceFeeToken
195
+ const { totalNativeCost, relayerFeeInSourceFeeToken } = await tokenGateway.quoteNative(teleportParams)
196
+ console.log(`Total native cost: ${totalNativeCost} wei`)
197
+ console.log(`Relayer fee in fee token: ${relayerFeeInSourceFeeToken}`)
198
+
199
+ // Example with Substrate destination
200
+ const substrateDestChain = new SubstrateChain({
201
+ stateMachineId: "KUSAMA-4009",
202
+ wsUrl: "wss://gargantua.polytope.technology",
203
+ hasher: "Keccak",
204
+ consensusStateId: "PAS0"
205
+ })
206
+
207
+ const tokenGatewayToSubstrate = new TokenGateway({
208
+ source: sourceChain,
209
+ dest: substrateDestChain // SubstrateChain destination
210
+ })
211
+
212
+ // For Substrate destinations, relayer fee will be 0
213
+ const { totalNativeCost: substrateCost, relayerFeeInSourceFeeToken: substrateRelayerFee } =
214
+ await tokenGatewayToSubstrate.quoteNative({
215
+ amount: parseEther("100"),
216
+ assetId: assetId,
217
+ redeem: true,
218
+ to: recipientAddress,
219
+ dest: "KUSAMA-4009",
220
+ timeout: 3600n
221
+ })
222
+ console.log(`Substrate destination - Native cost: ${substrateCost} wei`)
223
+ console.log(`Substrate destination - Relayer fee: ${substrateRelayerFee}`) // Will be 0
224
+
225
+ // Get token addresses
226
+ const erc20Address = await tokenGateway.getErc20Address(assetId)
227
+ const erc6160Address = await tokenGateway.getErc6160Address(assetId)
228
+
229
+ // Get gateway parameters
230
+ const params = await tokenGateway.getParams()
231
+ console.log(`Host: ${params.host}, Dispatcher: ${params.dispatcher}`)
232
+ ```
233
+
234
+ **TokenGateway Methods:**
235
+
236
+ - `quoteNative(params)` - Estimate native token cost for a teleport operation. For EVM destination chains, the relayer fee is automatically estimated by generating a dummy post request with 191 bytes of random data, estimating gas on the destination chain, converting to native tokens, and adding a 1% buffer to the relayer fee. The relayer fee is then converted to source chain fee token using Uniswap V2's `getAmountsOut`. For Substrate destinations, relayer fee is set to zero. Returns an object with `totalNativeCost` (relayer fee + protocol fee, both with 1% buffers) and `relayerFeeInSourceFeeToken` (relayer fee converted to source chain fee token).
237
+ - `getErc20Address(assetId)` - Get the ERC20 contract address for an asset
238
+ - `getErc6160Address(assetId)` - Get the ERC6160 (hyper-fungible) contract address for an asset
239
+ - `getInstanceAddress(destination)` - Get the TokenGateway address on the destination chain
240
+ - `getParams()` - Get the TokenGateway contract parameters (host and dispatcher addresses)
241
+
144
242
  ## Vite Integration
145
243
 
146
244
  If you're using Vite in your project, Hyperbridge SDK includes a plugin to handle WebAssembly dependencies correctly.
@@ -169,9 +267,10 @@ The plugin automatically copies the necessary WebAssembly files to the correct l
169
267
 
170
268
  ### Classes
171
269
 
172
- - IndexerClient - Main client for interacting with the indexer
173
- - EvmChain - Utilities for EVM chain interaction
174
- - SubstrateChain - Utilities for Substrate chain interaction
270
+ - **IndexerClient** - Main client for interacting with the indexer
271
+ - **EvmChain** - Utilities for EVM chain interaction
272
+ - **SubstrateChain** - Utilities for Substrate chain interaction
273
+ - **TokenGateway** - Utilities for cross-chain token transfers and fee estimation
175
274
 
176
275
  ### Types
177
276
 
@@ -590,6 +590,7 @@ declare class ChainConfigService {
590
590
  constructor(env?: NodeJS.ProcessEnv);
591
591
  getChainConfig(chain: string): ChainConfig;
592
592
  getIntentGatewayAddress(chain: string): `0x${string}`;
593
+ getTokenGatewayAddress(chain: string): `0x${string}`;
593
594
  getHostAddress(chain: string): `0x${string}`;
594
595
  getWrappedNativeAssetWithDecimals(chain: string): {
595
596
  asset: HexString;
@@ -3179,6 +3180,124 @@ type CancelEvent = {
3179
3180
  };
3180
3181
  }[keyof CancelEventMap];
3181
3182
 
3183
+ /**
3184
+ * Result of the quoteNative fee estimation
3185
+ */
3186
+ interface QuoteNativeResult {
3187
+ /** Total native token cost including relayer fee and protocol fee with 1% buffer */
3188
+ totalNativeCost: bigint;
3189
+ /** Relayer fee converted to source chain fee token */
3190
+ relayerFeeInSourceFeeToken: bigint;
3191
+ }
3192
+ /**
3193
+ * Parameters for token gateway teleport operations
3194
+ */
3195
+ interface TeleportParams {
3196
+ /** Amount to be sent */
3197
+ amount: bigint;
3198
+ /** The token identifier to send */
3199
+ assetId: HexString;
3200
+ /** Redeem ERC20 on the destination? */
3201
+ redeem: boolean;
3202
+ /** Recipient address */
3203
+ to: HexString;
3204
+ /** Recipient state machine */
3205
+ dest: string | Uint8Array;
3206
+ /** Request timeout in seconds */
3207
+ timeout: bigint;
3208
+ /** Destination contract call data */
3209
+ data?: HexString | Uint8Array;
3210
+ }
3211
+ /**
3212
+ * TokenGateway class for managing cross-chain token transfers via Hyperbridge
3213
+ *
3214
+ * This class provides methods to interact with the TokenGateway contract, including
3215
+ * estimating fees for cross-chain token teleports.
3216
+ *
3217
+ * Supports both EVM and Substrate chains as destination.
3218
+ *
3219
+ * @example
3220
+ * ```typescript
3221
+ * const tokenGateway = new TokenGateway({
3222
+ * source: sourceChain,
3223
+ * dest: destChain // Can be EvmChain or SubstrateChain
3224
+ * })
3225
+ *
3226
+ * const teleportParams: TeleportParams = {
3227
+ * amount: parseEther("1.0"),
3228
+ * assetId: keccak256(toHex("USDC")),
3229
+ * redeem: true,
3230
+ * to: pad("0xRecipientAddress", { size: 32 }),
3231
+ * dest: "EVM-1",
3232
+ * timeout: 3600n,
3233
+ * }
3234
+ *
3235
+ * // Estimate native cost (relayer fee + protocol fee with 1% buffer)
3236
+ * const { totalNativeCost, relayerFeeInSourceFeeToken } = await tokenGateway.quoteNative(teleportParams)
3237
+ * console.log(`Total native cost: ${formatEther(totalNativeCost)} ETH`)
3238
+ * console.log(`Relayer fee in fee token: ${relayerFeeInSourceFeeToken}`)
3239
+ * ```
3240
+ */
3241
+ declare class TokenGateway {
3242
+ private readonly source;
3243
+ private readonly dest;
3244
+ constructor(params: {
3245
+ source: EvmChain;
3246
+ dest: EvmChain | SubstrateChain;
3247
+ });
3248
+ /**
3249
+ * Get the TokenGateway contract address for a given chain
3250
+ *
3251
+ * @param chain - The chain identifier (e.g., "EVM-1", "EVM-56")
3252
+ * @returns The TokenGateway contract address
3253
+ */
3254
+ private getTokenGatewayAddress;
3255
+ /**
3256
+ * Estimate the native token cost for a token gateway teleport operation.
3257
+ * This includes both relayer fees and protocol fees for cross-chain delivery.
3258
+ *
3259
+ * The relayer fee is automatically estimated for EVM destination chains by:
3260
+ * 1. Creating a dummy post request with 191 bytes of random data in the body
3261
+ * 2. Estimating gas for delivery on the destination chain
3262
+ * 3. Converting the gas estimate to native tokens
3263
+ * 4. Adding a 1% buffer to the relayer fee for safety margin
3264
+ *
3265
+ * For non-EVM destination chains, the relayer fee is set to zero.
3266
+ *
3267
+ * The function then constructs a proper post request and calls quoteNative on the
3268
+ * source chain to get protocol fees (with 1% buffer), converts the relayer fee to
3269
+ * source chain fee token using Uniswap V2's getAmountsOut, and returns both values.
3270
+ *
3271
+ * @param params - The teleport parameters
3272
+ * @returns Object containing totalNativeCost (with 1% buffer) and relayerFeeInSourceFeeToken
3273
+ *
3274
+ * @throws Will throw an error if the contract call fails
3275
+ *
3276
+ * @example
3277
+ * ```typescript
3278
+ * const params: TeleportParams = {
3279
+ * amount: parseEther("1.0"),
3280
+ * assetId: keccak256(toHex("USDC")),
3281
+ * redeem: true,
3282
+ * to: pad("0xRecipientAddress", { size: 32 }),
3283
+ * dest: "EVM-1",
3284
+ * timeout: 3600n,
3285
+ * data: "0x"
3286
+ * }
3287
+ *
3288
+ * const { totalNativeCost, relayerFeeInSourceFeeToken } = await tokenGateway.quoteNative(params)
3289
+ * console.log(`Total native cost: ${formatEther(totalNativeCost)} ETH`)
3290
+ * console.log(`Relayer fee in fee token: ${relayerFeeInSourceFeeToken}`)
3291
+ * ```
3292
+ */
3293
+ quoteNative(params: TeleportParams): Promise<QuoteNativeResult>;
3294
+ /**
3295
+ * Convert native token amount to fee token amount using Uniswap V2 router
3296
+ * @private
3297
+ */
3298
+ private convertNativeToFeeToken;
3299
+ }
3300
+
3182
3301
  /**
3183
3302
  * Extracts the IntentGateway OrderPlaced event from a transaction hash.
3184
3303
  * @param client - A viem PublicClient-compatible instance
@@ -3511,4 +3630,4 @@ declare const popularTokens: {
3511
3630
  "EVM-130": string[];
3512
3631
  };
3513
3632
 
3514
- export { ADDRESS_ZERO, type AllStatusKey, type AssetTeleported, type AssetTeleportedResponse, type BlockMetadata, type CancelOptions, type ChainConfig, ChainConfigService, type ChainId, Chains, type ClientConfig, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DUMMY_PRIVATE_KEY, type DecodedOrderPlacedLog, type DecodedPostRequestEvent, type DecodedPostResponseEvent, type DispatchGet, type DispatchPost, ERC20Method, type EstimateGasCallData, EvmChain, type EvmChainParams, type ExecutionResult, type FillOptions, type FillerConfig, type GetRequestResponse, type GetRequestWithStatus, type GetResponseByRequestIdResponse, type GetResponseStorageValues, type HexString, type HostParams, HyperClientStatus, type HyperbridgeTxEvents, type IChain, type IConfig, type IEvmConfig, type IGetRequest, type IGetRequestMessage, type IGetResponse, type IGetResponseMessage, type IHyperbridgeConfig, type IIsmpMessage, type IMessage, type IPostRequest, type IPostResponse, type IProof, type IRequestMessage, type ISubstrateConfig, type ITimeoutPostRequestMessage, IndexerClient, type IndexerQueryClient, IntentGateway, type IntentGatewayParams, type IsmpRequest, type NewDeployment, type Order, type OrderResponse, OrderStatus, type OrderStatusMetadata, type OrderWithStatus, type Params, type PaymentInfo, type PostRequestStatus, type PostRequestTimeoutStatus, type PostRequestWithStatus, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, type RequestBody, type RequestCommitment, RequestKind, type RequestResponse, RequestStatus, type RequestStatusKey, type RequestStatusWithMetadata, type ResponseCommitmentWithValues, type RetryConfig, STATE_COMMITMENTS_SLOT, type StateMachineHeight, type StateMachineIdParams, type StateMachineResponse, type StateMachineUpdate, type StorageFacade, SubstrateChain, TESTNET_CHAINS, TeleportStatus, TimeoutStatus, type TimeoutStatusKey, type TokenGatewayAssetTeleportedResponse, type TokenGatewayAssetTeleportedWithStatus, type TokenInfo, type TokenPrice, type TokenPricesResponse, type TokenRegistry, type TokenRegistryResponse, type Transaction, USE_ETHERSCAN_CHAINS, WrappedNativeDecimals, type XcmGatewayParams, __test, addresses, adjustFeeDecimals, assets, bytes20ToBytes32, bytes32ToBytes20, chainIds, coingeckoIds, consensusStateIds, constructRedeemEscrowRequestBody, convertCodecToIGetRequest, convertCodecToIProof, convertIGetRequestToCodec, convertIProofToCodec, convertStateIdToStateMachineId, convertStateMachineEnumToString, convertStateMachineIdToEnum, createChain, createEvmChain, createIndexerClient, createQueryClient, createRpcUrls, encodeISMPMessage, estimateGasForPost, fetchPrice, generateRootWithProof, getChain, getGasPriceFromEtherscan, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, hexToString, maxBigInt, orderCommitment, popularTokens, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, requestCommitmentKey, retryPromise, teleport, teleportDot, viemChains };
3633
+ export { ADDRESS_ZERO, type AllStatusKey, type AssetTeleported, type AssetTeleportedResponse, type BlockMetadata, type CancelOptions, type ChainConfig, ChainConfigService, type ChainId, Chains, type ClientConfig, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DUMMY_PRIVATE_KEY, type DecodedOrderPlacedLog, type DecodedPostRequestEvent, type DecodedPostResponseEvent, type DispatchGet, type DispatchPost, ERC20Method, type EstimateGasCallData, EvmChain, type EvmChainParams, type ExecutionResult, type FillOptions, type FillerConfig, type GetRequestResponse, type GetRequestWithStatus, type GetResponseByRequestIdResponse, type GetResponseStorageValues, type HexString, type HostParams, HyperClientStatus, type HyperbridgeTxEvents, type IChain, type IConfig, type IEvmConfig, type IGetRequest, type IGetRequestMessage, type IGetResponse, type IGetResponseMessage, type IHyperbridgeConfig, type IIsmpMessage, type IMessage, type IPostRequest, type IPostResponse, type IProof, type IRequestMessage, type ISubstrateConfig, type ITimeoutPostRequestMessage, IndexerClient, type IndexerQueryClient, IntentGateway, type IntentGatewayParams, type IsmpRequest, type NewDeployment, type Order, type OrderResponse, OrderStatus, type OrderStatusMetadata, type OrderWithStatus, type Params, type PaymentInfo, type PostRequestStatus, type PostRequestTimeoutStatus, type PostRequestWithStatus, type QuoteNativeResult, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, type RequestBody, type RequestCommitment, RequestKind, type RequestResponse, RequestStatus, type RequestStatusKey, type RequestStatusWithMetadata, type ResponseCommitmentWithValues, type RetryConfig, STATE_COMMITMENTS_SLOT, type StateMachineHeight, type StateMachineIdParams, type StateMachineResponse, type StateMachineUpdate, type StorageFacade, SubstrateChain, TESTNET_CHAINS, type TeleportParams, TeleportStatus, TimeoutStatus, type TimeoutStatusKey, TokenGateway, type TokenGatewayAssetTeleportedResponse, type TokenGatewayAssetTeleportedWithStatus, type TokenInfo, type TokenPrice, type TokenPricesResponse, type TokenRegistry, type TokenRegistryResponse, type Transaction, USE_ETHERSCAN_CHAINS, WrappedNativeDecimals, type XcmGatewayParams, __test, addresses, adjustFeeDecimals, assets, bytes20ToBytes32, bytes32ToBytes20, chainIds, coingeckoIds, consensusStateIds, constructRedeemEscrowRequestBody, convertCodecToIGetRequest, convertCodecToIProof, convertIGetRequestToCodec, convertIProofToCodec, convertStateIdToStateMachineId, convertStateMachineEnumToString, convertStateMachineIdToEnum, createChain, createEvmChain, createIndexerClient, createQueryClient, createRpcUrls, encodeISMPMessage, estimateGasForPost, fetchPrice, generateRootWithProof, getChain, getGasPriceFromEtherscan, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, hexToString, maxBigInt, orderCommitment, popularTokens, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, requestCommitmentKey, retryPromise, teleport, teleportDot, viemChains };
@@ -3471,6 +3471,17 @@ var addresses = {
3471
3471
  ["EVM-137" /* POLYGON_MAINNET */]: "0x1a4ee689a004b10210a1df9f24a387ea13359acf",
3472
3472
  ["EVM-130" /* UNICHAIN_MAINNET */]: "0x1a4ee689a004b10210a1df9f24a387ea13359acf"
3473
3473
  },
3474
+ TokenGateway: {
3475
+ ["EVM-97" /* BSC_CHAPEL */]: "0xFcDa26cA021d5535C3059547390E6cCd8De7acA6",
3476
+ ["EVM-10200" /* GNOSIS_CHIADO */]: "0xFcDa26cA021d5535C3059547390E6cCd8De7acA6",
3477
+ ["EVM-11155111" /* SEPOLIA */]: "0xFcDa26cA021d5535C3059547390E6cCd8De7acA6",
3478
+ ["EVM-1" /* MAINNET */]: "0xFd413e3AFe560182C4471F4d143A96d3e259B6dE",
3479
+ ["EVM-56" /* BSC_MAINNET */]: "0xFd413e3AFe560182C4471F4d143A96d3e259B6dE",
3480
+ ["EVM-42161" /* ARBITRUM_MAINNET */]: "0xFd413e3AFe560182C4471F4d143A96d3e259B6dE",
3481
+ ["EVM-8453" /* BASE_MAINNET */]: "0xFd413e3AFe560182C4471F4d143A96d3e259B6dE",
3482
+ ["EVM-137" /* POLYGON_MAINNET */]: "0x8b536105b6Fae2aE9199f5146D3C57Dfe53b614E",
3483
+ ["EVM-130" /* UNICHAIN_MAINNET */]: "0x8b536105b6Fae2aE9199f5146D3C57Dfe53b614E"
3484
+ },
3474
3485
  Host: {
3475
3486
  ["EVM-97" /* BSC_CHAPEL */]: "0x8Aa0Dea6D675d785A882967Bf38183f6117C09b7",
3476
3487
  ["EVM-10200" /* GNOSIS_CHIADO */]: "0x58a41b89f4871725e5d898d98ef4bf917601c5eb",
@@ -3662,6 +3673,9 @@ var ChainConfigService = class {
3662
3673
  getIntentGatewayAddress(chain) {
3663
3674
  return addresses.IntentGateway[chain];
3664
3675
  }
3676
+ getTokenGatewayAddress(chain) {
3677
+ return addresses.TokenGateway[chain];
3678
+ }
3665
3679
  getHostAddress(chain) {
3666
3680
  return addresses.Host[chain];
3667
3681
  }
@@ -13197,6 +13211,140 @@ async function fetchSourceProof(commitment, source, sourceStateMachine, sourceCo
13197
13211
  proof: proofHex
13198
13212
  };
13199
13213
  }
13214
+ var TokenGateway = class {
13215
+ source;
13216
+ dest;
13217
+ constructor(params) {
13218
+ this.source = params.source;
13219
+ this.dest = params.dest;
13220
+ }
13221
+ /**
13222
+ * Get the TokenGateway contract address for a given chain
13223
+ *
13224
+ * @param chain - The chain identifier (e.g., "EVM-1", "EVM-56")
13225
+ * @returns The TokenGateway contract address
13226
+ */
13227
+ getTokenGatewayAddress(chain) {
13228
+ const chainStr = typeof chain === "string" ? chain : new TextDecoder().decode(chain);
13229
+ return this.source.configService.getTokenGatewayAddress(chainStr);
13230
+ }
13231
+ /**
13232
+ * Estimate the native token cost for a token gateway teleport operation.
13233
+ * This includes both relayer fees and protocol fees for cross-chain delivery.
13234
+ *
13235
+ * The relayer fee is automatically estimated for EVM destination chains by:
13236
+ * 1. Creating a dummy post request with 191 bytes of random data in the body
13237
+ * 2. Estimating gas for delivery on the destination chain
13238
+ * 3. Converting the gas estimate to native tokens
13239
+ * 4. Adding a 1% buffer to the relayer fee for safety margin
13240
+ *
13241
+ * For non-EVM destination chains, the relayer fee is set to zero.
13242
+ *
13243
+ * The function then constructs a proper post request and calls quoteNative on the
13244
+ * source chain to get protocol fees (with 1% buffer), converts the relayer fee to
13245
+ * source chain fee token using Uniswap V2's getAmountsOut, and returns both values.
13246
+ *
13247
+ * @param params - The teleport parameters
13248
+ * @returns Object containing totalNativeCost (with 1% buffer) and relayerFeeInSourceFeeToken
13249
+ *
13250
+ * @throws Will throw an error if the contract call fails
13251
+ *
13252
+ * @example
13253
+ * ```typescript
13254
+ * const params: TeleportParams = {
13255
+ * amount: parseEther("1.0"),
13256
+ * assetId: keccak256(toHex("USDC")),
13257
+ * redeem: true,
13258
+ * to: pad("0xRecipientAddress", { size: 32 }),
13259
+ * dest: "EVM-1",
13260
+ * timeout: 3600n,
13261
+ * data: "0x"
13262
+ * }
13263
+ *
13264
+ * const { totalNativeCost, relayerFeeInSourceFeeToken } = await tokenGateway.quoteNative(params)
13265
+ * console.log(`Total native cost: ${formatEther(totalNativeCost)} ETH`)
13266
+ * console.log(`Relayer fee in fee token: ${relayerFeeInSourceFeeToken}`)
13267
+ * ```
13268
+ */
13269
+ async quoteNative(params) {
13270
+ const dataHex = params.data ? typeof params.data === "string" ? params.data : toHex(params.data) : "0x";
13271
+ const sourceTokenGatewayAddress = this.getTokenGatewayAddress(this.source.config.stateMachineId);
13272
+ const destTokenGatewayAddress = this.getTokenGatewayAddress(params.dest);
13273
+ let relayerFee = 0n;
13274
+ const destChainId = typeof params.dest === "string" ? params.dest : new TextDecoder().decode(params.dest);
13275
+ const isEvmDest = destChainId.startsWith("EVM-") && this.dest instanceof EvmChain;
13276
+ if (isEvmDest) {
13277
+ const randomHex = "0x" + Array.from({ length: 191 * 2 }, () => Math.floor(Math.random() * 16).toString(16)).join("");
13278
+ const randomBody = randomHex;
13279
+ const dummyPostRequest = {
13280
+ source: this.source.config.stateMachineId,
13281
+ dest: destChainId,
13282
+ from: sourceTokenGatewayAddress,
13283
+ to: destTokenGatewayAddress,
13284
+ nonce: 0n,
13285
+ body: randomBody,
13286
+ timeoutTimestamp: params.timeout
13287
+ };
13288
+ const { gas } = await this.dest.estimateGas(dummyPostRequest);
13289
+ const gasPrice = await this.dest.client.getGasPrice();
13290
+ const gasCostInNative = gas * gasPrice;
13291
+ relayerFee = gasCostInNative * 101n / 100n;
13292
+ }
13293
+ const teleportBody = encodeAbiParameters(
13294
+ parseAbiParameters("uint256, uint256, bytes32, bool, bytes32, bytes"),
13295
+ [
13296
+ params.amount,
13297
+ relayerFee,
13298
+ // Use the calculated relayer fee (0 for non-EVM destinations)
13299
+ params.assetId,
13300
+ params.redeem,
13301
+ params.to,
13302
+ dataHex
13303
+ ]
13304
+ );
13305
+ const postRequest = {
13306
+ source: this.source.config.stateMachineId,
13307
+ dest: destChainId,
13308
+ from: sourceTokenGatewayAddress,
13309
+ to: destTokenGatewayAddress,
13310
+ nonce: 0n,
13311
+ body: teleportBody,
13312
+ timeoutTimestamp: params.timeout
13313
+ };
13314
+ const protocolFeeInNative = await this.source.quoteNative(postRequest, relayerFee);
13315
+ const protocolFeeWithBuffer = protocolFeeInNative * 101n / 100n;
13316
+ let relayerFeeInSourceFeeToken = 0n;
13317
+ if (relayerFee > 0n) {
13318
+ const feeToken = await this.source.getFeeTokenWithDecimals();
13319
+ relayerFeeInSourceFeeToken = await this.convertNativeToFeeToken(
13320
+ relayerFee,
13321
+ feeToken.address,
13322
+ this.source.config.stateMachineId
13323
+ );
13324
+ }
13325
+ return {
13326
+ totalNativeCost: protocolFeeWithBuffer,
13327
+ relayerFeeInSourceFeeToken
13328
+ };
13329
+ }
13330
+ /**
13331
+ * Convert native token amount to fee token amount using Uniswap V2 router
13332
+ * @private
13333
+ */
13334
+ async convertNativeToFeeToken(nativeAmount, feeTokenAddress, chain) {
13335
+ const v2Router = this.source.configService.getUniswapRouterV2Address(chain);
13336
+ const WETH = this.source.configService.getWrappedNativeAssetWithDecimals(chain).asset;
13337
+ const v2AmountOut = await this.source.client.simulateContract({
13338
+ address: v2Router,
13339
+ abi: uniswapRouterV2_default.ABI,
13340
+ // @ts-ignore
13341
+ functionName: "getAmountsOut",
13342
+ // @ts-ignore
13343
+ args: [nativeAmount, [WETH, feeTokenAddress]]
13344
+ });
13345
+ return v2AmountOut.result[1];
13346
+ }
13347
+ };
13200
13348
  async function getOrderPlacedFromTx(client, txHash) {
13201
13349
  const receipt = await client.getTransactionReceipt({ hash: txHash });
13202
13350
  const events = parseEventLogs({
@@ -13512,6 +13660,6 @@ async function teleportDot(param_) {
13512
13660
  return stream;
13513
13661
  }
13514
13662
 
13515
- export { ADDRESS_ZERO, ChainConfigService, Chains, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DUMMY_PRIVATE_KEY, ERC20Method, EvmChain, HyperClientStatus, IndexerClient, IntentGateway, OrderStatus, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, RequestKind, RequestStatus, STATE_COMMITMENTS_SLOT, SubstrateChain, TESTNET_CHAINS, TeleportStatus, TimeoutStatus, USE_ETHERSCAN_CHAINS, WrappedNativeDecimals, __test, addresses, adjustFeeDecimals, assets, bytes20ToBytes32, bytes32ToBytes20, chainIds, coingeckoIds, consensusStateIds, constructRedeemEscrowRequestBody, convertCodecToIGetRequest, convertCodecToIProof, convertIGetRequestToCodec, convertIProofToCodec, convertStateIdToStateMachineId, convertStateMachineEnumToString, convertStateMachineIdToEnum, createChain, createEvmChain, createIndexerClient, createQueryClient, createRpcUrls, encodeISMPMessage, estimateGasForPost, fetchPrice, generateRootWithProof, getChain, getGasPriceFromEtherscan, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, hexToString, maxBigInt, orderCommitment, popularTokens, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, requestCommitmentKey, retryPromise, teleport, teleportDot, viemChains };
13663
+ export { ADDRESS_ZERO, ChainConfigService, Chains, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DUMMY_PRIVATE_KEY, ERC20Method, EvmChain, HyperClientStatus, IndexerClient, IntentGateway, OrderStatus, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, RequestKind, RequestStatus, STATE_COMMITMENTS_SLOT, SubstrateChain, TESTNET_CHAINS, TeleportStatus, TimeoutStatus, TokenGateway, USE_ETHERSCAN_CHAINS, WrappedNativeDecimals, __test, addresses, adjustFeeDecimals, assets, bytes20ToBytes32, bytes32ToBytes20, chainIds, coingeckoIds, consensusStateIds, constructRedeemEscrowRequestBody, convertCodecToIGetRequest, convertCodecToIProof, convertIGetRequestToCodec, convertIProofToCodec, convertStateIdToStateMachineId, convertStateMachineEnumToString, convertStateMachineIdToEnum, createChain, createEvmChain, createIndexerClient, createQueryClient, createRpcUrls, encodeISMPMessage, estimateGasForPost, fetchPrice, generateRootWithProof, getChain, getGasPriceFromEtherscan, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, hexToString, maxBigInt, orderCommitment, popularTokens, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, requestCommitmentKey, retryPromise, teleport, teleportDot, viemChains };
13516
13664
  //# sourceMappingURL=index.js.map
13517
13665
  //# sourceMappingURL=index.js.map