@hyperbridge/sdk 2.2.2 → 2.3.0

package/dist/browser/index.d.ts

@@ -1822,6 +1822,14 @@ declare function encodeUserOpScale(userOp: PackedUserOperation): HexString;
  * @returns The decoded PackedUserOperation
  */
 declare function decodeUserOpScale(hex: HexString): PackedUserOperation;
+interface PhantomOrderEvent {
+    commitment: HexString;
+    chain: string;
+    createdAt: number;
+    tokenA: HexString;
+    tokenB: HexString;
+    standardAmount: bigint;
+}
 /**
  * Service for interacting with Hyperbridge's pallet-intents coprocessor.
  * Handles bid submission and retrieval for the IntentGatewayV2 protocol.
@@ -1834,6 +1842,7 @@ declare class IntentsCoprocessor {
     private ownsConnection;
     /** Cached result of whether the node exposes intents_* RPC methods */
     private hasIntentsRpc;
+    private submissionQueue;
     /**
      * Creates and connects an IntentsCoprocessor to a Hyperbridge node.
      * This creates and manages its own API connection.
@@ -1865,15 +1874,21 @@ declare class IntentsCoprocessor {
      */
     disconnect(): Promise<void>;
     /**
-     * Creates a Substrate keypair from the configured private key
-     * Supports both hex seed (without 0x prefix) and mnemonic phrases
+     * Creates a Substrate keypair from the configured private key.
+     * Supports hex seed (with or without 0x), mnemonic phrases, and URI derivation paths (//Alice).
      */
     getKeyPair(): KeyringPair;
     /**
-     * Signs and sends an extrinsic, handling status updates and errors
-     * Implements retry logic with progressive tip increases for stuck transactions
+     * Signs and sends an extrinsic. Submissions are serialised through {@link submissionQueue} so
+     * concurrent calls never collide on the substrate account nonce — each extrinsic reaches a block
+     * before the next is signed.
      */
     private signAndSendExtrinsic;
+    /**
+     * Signs and sends an extrinsic, handling status updates and errors.
+     * Implements retry logic with progressive tip increases for stuck transactions.
+     */
+    private sendExtrinsicWithRetries;
     /**
      * Sends an extrinsic with a timeout
      */
@@ -1895,6 +1910,18 @@ declare class IntentsCoprocessor {
      * @returns BidSubmissionResult with success status and block/extrinsic hash
      */
     retractBid(commitment: HexString): Promise<BidSubmissionResult>;
+    /**
+     * Retracts a previous bid and places a new one in a single transaction via utility.batch.
+     * The retraction runs first, so the old deposit is reclaimed even if the new bid then fails
+     * (batch is non-atomic — a failing call interrupts the batch without reverting the calls that
+     * already succeeded, unlike batchAll which would roll the retraction back too).
+     *
+     * @param retractCommitment - The order commitment of the bid to retract (bytes32)
+     * @param bidCommitment - The order commitment of the new bid (bytes32)
+     * @param userOp - The encoded PackedUserOperation as hex string
+     * @returns BidSubmissionResult with success status and block/extrinsic hash
+     */
+    submitBidWithRetraction(retractCommitment: HexString, bidCommitment: HexString, userOp: HexString): Promise<BidSubmissionResult>;
     /**
      * Fetches all bid storage entries for a given order commitment.
      * Returns the on-chain data only (filler addresses and deposits).
@@ -1928,6 +1955,21 @@ declare class IntentsCoprocessor {
     private decodeBid;
     /** Builds offchain storage key: "intents::bid::" + commitment + filler */
     private buildOffchainBidKey;
+    /**
+     * Fetches the ABI-encoded phantom order from offchain storage and decodes it
+     * into an `Order` object. The pallet writes the order bytes under the key
+     * `intents::phantom::order::<commitment>` when it calls `on_initialize`.
+     *
+     * Returns `null` if the key is absent (e.g. the node is not an offchain worker
+     * or the commitment has expired and been cleared).
+     */
+    fetchPhantomOrder(commitment: HexString): Promise<Order | null>;
+    /**
+     * Subscribes to PhantomOrderRegistered events from the intents coprocessor pallet.
+     * Calls the callback for each new phantom order as blocks arrive.
+     * Returns an unsubscribe function to stop the subscription.
+     */
+    subscribePhantomOrders(callback: (event: PhantomOrderEvent) => void): Promise<() => void>;
 }
 
 /**
@@ -3105,6 +3147,10 @@ interface DispatchGet {
      * Context for the request
      */
     context: HexString;
+    /**
+     * Who pays for this request?
+     */
+    payer: HexString;
 }
 interface StateMachineHeight {
     id: {
@@ -5066,24 +5112,13 @@ declare class OrderStatusChecker {
     isOrderRefunded(order: Order): Promise<boolean>;
 }
 
+declare function encodeERC7821ExecuteBatch(calls: ERC7821Call[]): HexString;
+declare function decodeERC7821ExecuteBatch(callData: HexString): ERC7821Call[] | null;
+
 type ContractOrder = Omit<Order, "id" | "source" | "destination"> & {
     source: HexString;
     destination: HexString;
 };
-/**
- * Encodes a list of calls into ERC-7821 `execute` function calldata using
- * single-batch mode.
- *
- * This is a standalone utility that can be used outside of the
- * `IntentGatewayV2` class — for example, by filler strategies that need to
- * build custom batch calldata for combined swap-and-fill operations before
- * submitting a UserOperation.
- *
- * @param calls - Ordered list of calls to batch; each specifies a target
- *   address, ETH value, and calldata.
- * @returns ABI-encoded calldata for the ERC-7821 `execute(bytes32,bytes)` function.
- */
-declare function encodeERC7821ExecuteBatch(calls: ERC7821Call[]): HexString;
 /**
  * Fetches a Merkle/state proof for the given ISMP request commitment on the
  * source chain.
@@ -6171,6 +6206,10 @@ declare const ABI$1: readonly [{
             readonly name: "context";
             readonly type: "bytes";
             readonly internalType: "bytes";
+        }, {
+            readonly name: "payer";
+            readonly type: "address";
+            readonly internalType: "address";
         }];
     }];
     readonly outputs: readonly [{
@@ -6866,6 +6905,10 @@ declare const ABI: readonly [{
             readonly name: "context";
             readonly type: "bytes";
             readonly internalType: "bytes";
+        }, {
+            readonly name: "payer";
+            readonly type: "address";
+            readonly internalType: "address";
         }];
     }];
     readonly outputs: readonly [{
@@ -8825,6 +8868,10 @@ declare const HyperFungibleTokenABI: readonly [{
             readonly name: "context";
             readonly type: "bytes";
             readonly internalType: "bytes";
+        }, {
+            readonly name: "payer";
+            readonly type: "address";
+            readonly internalType: "address";
         }];
     }];
     readonly outputs: readonly [{
@@ -9689,6 +9736,10 @@ declare const WrappedHyperFungibleTokenABI: readonly [{
             readonly name: "context";
             readonly type: "bytes";
             readonly internalType: "bytes";
+        }, {
+            readonly name: "payer";
+            readonly type: "address";
+            readonly internalType: "address";
         }];
     }];
     readonly outputs: readonly [{
@@ -10166,4 +10217,4 @@ declare function teleport(teleport_param: {
     extrinsics?: Array<SubmittableExtrinsic<"promise", ISubmittableResult>>;
 }): Promise<ReadableStream<HyperbridgeTxEvents>>;
 
-export { ADDRESS_ZERO, type AllStatusKey, type AssetTeleported, type AssetTeleportedResponse, type Bid, type BidStorageEntry, type BidSubmissionResult, type BlockMetadata, type BridgeParams, type BridgeStep, type BundlerGasEstimate, BundlerMethod, type BytesLikeHex, type CancelEvent, type CancelOptions, type CancelOrderOptions, type CancelQuote, type ChainConfig, type ChainConfigData, ChainConfigService, Chains, type ClientConfig, type ConfiguredAssetSymbol, CryptoUtils, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, type DecodedOrderPlacedLog, type DecodedPostRequestEvent, type DecodedPostResponseEvent, type Deployment, type DispatchGet, type DispatchInfo, type DispatchPost, ERC20Method, type ERC7821Call, ERC7821_BATCH_MODE, type EstimateFillOrderParams, type EstimateGasCallData, EvmChain, type EvmChainParams, ABI as EvmHostABI, EvmLanguage, type ExecuteIntentOrderOptions, type ExecutionResult, type FillOptions, type FillOrderEstimate, type FillerBid, type FillerConfig, type GetRequestResponse, type GetRequestWithStatus, type GetResponseByRequestIdResponse, type GetResponseStorageValues, type HexString, type HostParams, HyperClientStatus, HyperFungibleToken, HyperFungibleTokenABI, type HyperbridgeTxEvents, type IBatchConsensusAndGetResponseMessage, type IBatchConsensusAndPostRequestMessage, type IChain, type IConfig, type IConsensusMessage, type IEvmChain, type IEvmConfig, type IGetRequest, type IGetRequestMessage, type IGetResponse, type IGetResponseMessage, type IHyperbridgeConfig, type IIsmpMessage, type IMessage, type IPharosConfig, type IPolkadotHubConfig, type IPostRequest, type IPostResponse, type IProof, type IRequestMessage, type ISubstrateConfig, type ITimeoutPostRequestMessage, type IndexerQueryClient, IntentGateway, ABI$1 as IntentGatewayABI, type IntentGatewayContext, type IntentGatewayParams, IntentOrderStatus, type IntentOrderStatusKey, type IntentOrderStatusUpdate, type IntentQuoteStrategy, type IntentQuoteToken, type IntentQuoteTradeType, IntentsCoprocessor, IsmpClient, type IsmpRequest, MOCK_ADDRESS, ORDER_V2_PARAM_TYPE, type Order, type OrderResponse, OrderStatus, OrderStatusChecker, type OrderStatusMetadata, type OrderWithStatus, PACKED_USEROP_TYPEHASH, PLACE_ORDER_SELECTOR, type PackedUserOperation, type Params, type PaymentInfo, PharosChain, type PharosChainParams, PolkadotHubChain, type PolkadotHubChainParams, type PostRequestStatus, type PostRequestTimeoutStatus, type PostRequestWithStatus, type QuoteIntentParams, type QuoteIntentResult, type QuoteNativeResult, type QuoteResult, type QuoteUniswapParams, type QuoteUniswapResult, 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 ResumeIntentOrderOptions, type RetryConfig, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, type SelectBidResult, type SelectOptions, type SigningAccount, type StateMachineHeight, type StateMachineId, type StateMachineIdParams, type StateMachineResponse, type StateMachineUpdate, type StorageFacade, type SubmitBidOptions, SubstrateChain, Swap, TESTNET_CHAINS, type TeleportParams, TeleportStatus, TimeoutStatus, type TimeoutStatusKey, TokenGateway, type TokenGatewayAssetTeleportedResponse, type TokenGatewayAssetTeleportedWithStatus, type TokenInfo, type TokenPrice, type TokenPricesResponse, type Transaction, TronChain, type TronChainParams, USE_ETHERSCAN_CHAINS, type UniswapProtocol, type UniswapQuote, type UniswapQuoteToken, type UniswapTradeType, type UniswapV4IntentQuoteMetadata, type UniswapV4IntentQuoteOptions, type UniswapV4PoolConfigData, type UniswapV4PoolKey, UnsupportedIntentQuotePairError, UnsupportedIntentQuoteStrategyError, WrappedHyperFungibleTokenABI, type XcmGatewayParams, __test, adjustDecimals, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, chainConfigs, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, convertCodecToIGetRequest, convertCodecToIProof, convertIGetRequestToCodec, convertIProofToCodec, convertStateIdToStateMachineId, convertStateMachineEnumToString, convertStateMachineIdToEnum, createEvmChain, createQueryClient, decodeUserOpScale, encodeERC7821ExecuteBatch, encodeISMPMessage, encodeStateMachineId, encodeUserOpScale, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getChainId, getConfigByStateMachineId, getContractCallInput, getContractCallInputs, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, getViemChain, hexToString, hyperbridgeAddress, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, parseStateMachineId, pharosAtlantic, pharosMainnet, polkadotAssetHubPaseo, polkadotHubMainnet, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, requestCommitmentKey, responseCommitmentKey, retryPromise, teleport, teleportDot, transformOrderForContract, tronChainIds, tronNile };
+export { ADDRESS_ZERO, type AllStatusKey, type AssetTeleported, type AssetTeleportedResponse, type Bid, type BidStorageEntry, type BidSubmissionResult, type BlockMetadata, type BridgeParams, type BridgeStep, type BundlerGasEstimate, BundlerMethod, type BytesLikeHex, type CancelEvent, type CancelOptions, type CancelOrderOptions, type CancelQuote, type ChainConfig, type ChainConfigData, ChainConfigService, Chains, type ClientConfig, type ConfiguredAssetSymbol, CryptoUtils, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, type DecodedOrderPlacedLog, type DecodedPostRequestEvent, type DecodedPostResponseEvent, type Deployment, type DispatchGet, type DispatchInfo, type DispatchPost, ERC20Method, type ERC7821Call, ERC7821_BATCH_MODE, type EstimateFillOrderParams, type EstimateGasCallData, EvmChain, type EvmChainParams, ABI as EvmHostABI, EvmLanguage, type ExecuteIntentOrderOptions, type ExecutionResult, type FillOptions, type FillOrderEstimate, type FillerBid, type FillerConfig, type GetRequestResponse, type GetRequestWithStatus, type GetResponseByRequestIdResponse, type GetResponseStorageValues, type HexString, type HostParams, HyperClientStatus, HyperFungibleToken, HyperFungibleTokenABI, type HyperbridgeTxEvents, type IBatchConsensusAndGetResponseMessage, type IBatchConsensusAndPostRequestMessage, type IChain, type IConfig, type IConsensusMessage, type IEvmChain, type IEvmConfig, type IGetRequest, type IGetRequestMessage, type IGetResponse, type IGetResponseMessage, type IHyperbridgeConfig, type IIsmpMessage, type IMessage, type IPharosConfig, type IPolkadotHubConfig, type IPostRequest, type IPostResponse, type IProof, type IRequestMessage, type ISubstrateConfig, type ITimeoutPostRequestMessage, type IndexerQueryClient, IntentGateway, ABI$1 as IntentGatewayABI, type IntentGatewayContext, type IntentGatewayParams, IntentOrderStatus, type IntentOrderStatusKey, type IntentOrderStatusUpdate, type IntentQuoteStrategy, type IntentQuoteToken, type IntentQuoteTradeType, IntentsCoprocessor, IsmpClient, type IsmpRequest, MOCK_ADDRESS, ORDER_V2_PARAM_TYPE, type Order, type OrderResponse, OrderStatus, OrderStatusChecker, type OrderStatusMetadata, type OrderWithStatus, PACKED_USEROP_TYPEHASH, PLACE_ORDER_SELECTOR, type PackedUserOperation, type Params, type PaymentInfo, type PhantomOrderEvent, PharosChain, type PharosChainParams, PolkadotHubChain, type PolkadotHubChainParams, type PostRequestStatus, type PostRequestTimeoutStatus, type PostRequestWithStatus, type QuoteIntentParams, type QuoteIntentResult, type QuoteNativeResult, type QuoteResult, type QuoteUniswapParams, type QuoteUniswapResult, 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 ResumeIntentOrderOptions, type RetryConfig, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, type SelectBidResult, type SelectOptions, type SigningAccount, type StateMachineHeight, type StateMachineId, type StateMachineIdParams, type StateMachineResponse, type StateMachineUpdate, type StorageFacade, type SubmitBidOptions, SubstrateChain, Swap, TESTNET_CHAINS, type TeleportParams, TeleportStatus, TimeoutStatus, type TimeoutStatusKey, TokenGateway, type TokenGatewayAssetTeleportedResponse, type TokenGatewayAssetTeleportedWithStatus, type TokenInfo, type TokenPrice, type TokenPricesResponse, type Transaction, TronChain, type TronChainParams, USE_ETHERSCAN_CHAINS, type UniswapProtocol, type UniswapQuote, type UniswapQuoteToken, type UniswapTradeType, type UniswapV4IntentQuoteMetadata, type UniswapV4IntentQuoteOptions, type UniswapV4PoolConfigData, type UniswapV4PoolKey, UnsupportedIntentQuotePairError, UnsupportedIntentQuoteStrategyError, WrappedHyperFungibleTokenABI, type XcmGatewayParams, __test, adjustDecimals, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, chainConfigs, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, convertCodecToIGetRequest, convertCodecToIProof, convertIGetRequestToCodec, convertIProofToCodec, convertStateIdToStateMachineId, convertStateMachineEnumToString, convertStateMachineIdToEnum, createEvmChain, createQueryClient, decodeERC7821ExecuteBatch, decodeUserOpScale, encodeERC7821ExecuteBatch, encodeISMPMessage, encodeStateMachineId, encodeUserOpScale, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getChainId, getConfigByStateMachineId, getContractCallInput, getContractCallInputs, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, getViemChain, hexToString, hyperbridgeAddress, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, parseStateMachineId, pharosAtlantic, pharosMainnet, polkadotAssetHubPaseo, polkadotHubMainnet, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, requestCommitmentKey, responseCommitmentKey, retryPromise, teleport, teleportDot, transformOrderForContract, tronChainIds, tronNile };