@relayprotocol/relay-sdk 5.1.0 → 5.2.0

package/_esm/src/actions/gaslessBatch.js

@@ -0,0 +1,206 @@
+import { createPublicClient, encodeAbiParameters, http } from 'viem';
+import { getClient } from '../client.js';
+import { axios } from '../utils/axios.js';
+import { APIError, getApiKeyHeader, LogLevel } from '../utils/index.js';
+import { createCaliburExecutor } from '../utils/caliburExecutor.js';
+/**
+ * Execute a gasless batch swap using EIP-7702 delegation.
+ *
+ * Takes a quote from getQuote(), delegates the user's EOA to a batch executor
+ * (defaults to Calibur), batches the quote's transaction steps atomically,
+ * and submits via Relay's /execute API with the sponsor covering gas costs.
+ *
+ * @example
+ * ```ts
+ * const quote = await getQuote({ ... })
+ * const result = await executeGaslessBatch({ quote, walletClient })
+ * console.log(result.requestId)
+ * ```
+ *
+ * @param parameters - {@link ExecuteGaslessBatchParameters}
+ */
+export async function executeGaslessBatch(parameters) {
+    const { quote, walletClient, executor: executorConfig, subsidizeFees = false, originGasOverhead: originGasOverheadOverride, onProgress } = parameters;
+    const client = getClient();
+    if (!client.baseApiUrl || !client.baseApiUrl.length) {
+        throw new ReferenceError('RelayClient missing api url configuration');
+    }
+    if (!client.apiKey) {
+        throw new Error('API key is required for gasless batch execution. Configure it via createClient({ apiKey: "..." })');
+    }
+    const account = walletClient.account;
+    if (!account) {
+        throw new Error('WalletClient must have an account. Create it with createWalletClient({ account, ... })');
+    }
+    const userAddress = account.address;
+    const executor = executorConfig ?? createCaliburExecutor();
+    const originGasOverhead = originGasOverheadOverride ?? executor.originGasOverhead;
+    client.log(['Gasless Batch: starting', { user: userAddress, executor: executor.address }], LogLevel.Info);
+    // ── 1. Extract calls and chainId from quote steps ────────────────────
+    const calls = [];
+    let requestId;
+    let chainId;
+    for (const step of quote.steps) {
+        if (step.kind !== 'transaction')
+            continue;
+        for (const item of step.items) {
+            if (!item.data)
+                continue;
+            calls.push({
+                to: item.data.to,
+                value: BigInt(item.data.value || '0'),
+                data: item.data.data
+            });
+            if (!chainId && item.data.chainId) {
+                chainId = item.data.chainId;
+            }
+        }
+        if (step.requestId)
+            requestId = step.requestId;
+    }
+    if (calls.length === 0) {
+        throw new Error('No transaction steps found in quote');
+    }
+    client.log([`Gasless Batch: extracted ${calls.length} calls from quote on chain ${chainId}`, { requestId }], LogLevel.Verbose);
+    if (!chainId) {
+        throw new Error('Could not determine origin chainId from quote steps');
+    }
+    // Create a public client for on-chain reads
+    const chain = client.chains.find((c) => c.id === chainId);
+    const rpcUrl = chain?.httpRpcUrl;
+    const publicClient = createPublicClient({
+        chain: chain?.viemChain,
+        transport: rpcUrl ? http(rpcUrl) : http()
+    });
+    // ── 2. Check delegation ──────────────────────────────────────────────
+    onProgress?.({ status: 'signing_authorization', requestId });
+    const code = await publicClient.getCode({ address: userAddress });
+    const isDelegated = code?.toLowerCase().startsWith('0xef0100') &&
+        code.slice(8).toLowerCase() ===
+            executor.address.slice(2).toLowerCase();
+    client.log([`Gasless Batch: delegation status — ${isDelegated ? 'already delegated' : 'needs delegation'}`], LogLevel.Info);
+    // ── 3. Sign EIP-7702 authorization (if needed) ──────────────────────
+    let authorization;
+    if (!isDelegated) {
+        const currentNonce = await publicClient.getTransactionCount({
+            address: userAddress
+        });
+        const signedAuth = await walletClient.signAuthorization({
+            account: account,
+            contractAddress: executor.address,
+            chainId,
+            nonce: currentNonce
+        });
+        authorization = [
+            {
+                chainId: Number(signedAuth.chainId),
+                address: signedAuth.address,
+                nonce: signedAuth.nonce,
+                yParity: signedAuth.yParity ?? 0,
+                r: signedAuth.r,
+                s: signedAuth.s
+            }
+        ];
+        client.log(['Gasless Batch: signed 7702 authorization'], LogLevel.Verbose);
+    }
+    // ── 4. Sign batch via EIP-712 ────────────────────────────────────────
+    onProgress?.({ status: 'signing_batch', requestId });
+    const nonce = await executor.getNonce(publicClient, userAddress);
+    client.log([`Gasless Batch: executor nonce ${nonce}`], LogLevel.Verbose);
+    const signedMessage = executor.buildSignMessage(calls, nonce);
+    const domain = executor.buildSignDomain(chainId, userAddress);
+    const signature = await walletClient.signTypedData({
+        account: account,
+        domain,
+        types: executor.eip712Types,
+        primaryType: executor.eip712PrimaryType,
+        message: signedMessage
+    });
+    // Wrap signature: abi.encode(signature, hookData) — empty hookData
+    const wrappedSignature = encodeAbiParameters([{ type: 'bytes' }, { type: 'bytes' }], [signature, '0x']);
+    const batchCallData = executor.encodeExecute(signedMessage, wrappedSignature);
+    client.log(['Gasless Batch: signed EIP-712 batch'], LogLevel.Verbose);
+    // ── 5. Submit via /execute ───────────────────────────────────────────
+    onProgress?.({ status: 'submitting', requestId });
+    const executeBody = {
+        executionKind: 'rawCalls',
+        data: {
+            chainId,
+            to: userAddress,
+            data: batchCallData,
+            value: '0',
+            ...(authorization ? { authorizationList: authorization } : {})
+        },
+        executionOptions: {
+            referrer: client.source || '',
+            subsidizeFees
+        },
+        ...(originGasOverhead != null ? { originGasOverhead } : {}),
+        ...(requestId ? { requestId } : {})
+    };
+    const executeRequest = {
+        url: `${client.baseApiUrl}/execute`,
+        method: 'post',
+        data: executeBody,
+        headers: {
+            ...getApiKeyHeader(client),
+            'relay-sdk-version': client.version ?? 'unknown'
+        }
+    };
+    client.log(['Gasless Batch: submitting to /execute', { chainId, requestId, subsidizeFees }], LogLevel.Info);
+    let executeResult;
+    try {
+        const res = await axios.request(executeRequest);
+        executeResult = res.data;
+    }
+    catch (error) {
+        throw new APIError(error?.response?.data?.error ||
+            error?.message ||
+            'Gasless batch execution failed', error?.response?.status || 500, error?.response?.data || error);
+    }
+    const finalRequestId = executeResult.requestId || requestId || '';
+    client.log([`Gasless Batch: submitted, requestId ${finalRequestId}`], LogLevel.Info);
+    // ── 6. Poll for completion ───────────────────────────────────────────
+    onProgress?.({ status: 'polling', requestId: finalRequestId });
+    const maxAttempts = client.maxPollingAttemptsBeforeTimeout ?? 60;
+    const pollingInterval = client.pollingInterval ?? 5000;
+    for (let i = 0; i < maxAttempts; i++) {
+        const statusRequest = {
+            url: `${client.baseApiUrl}/intents/status/v3`,
+            method: 'get',
+            params: { requestId: finalRequestId },
+            headers: getApiKeyHeader(client)
+        };
+        try {
+            const res = await axios.request(statusRequest);
+            const status = res.data;
+            client.log([`Gasless Batch: poll [${i + 1}/${maxAttempts}] status=${status.status}`], LogLevel.Verbose);
+            if (status.status === 'success') {
+                client.log([`Gasless Batch: complete — requestId ${finalRequestId}`], LogLevel.Info);
+                onProgress?.({
+                    status: 'success',
+                    requestId: finalRequestId,
+                    details: status
+                });
+                return { requestId: finalRequestId };
+            }
+            if (status.status === 'failure' || status.status === 'refund') {
+                onProgress?.({
+                    status: 'failure',
+                    requestId: finalRequestId,
+                    details: status
+                });
+                throw new Error(`Gasless batch request failed with status: ${status.status}`);
+            }
+        }
+        catch (error) {
+            if (error.message?.startsWith('Gasless batch request failed')) {
+                throw error;
+            }
+            // Transient polling error — continue
+        }
+        await new Promise((resolve) => setTimeout(resolve, pollingInterval));
+    }
+    throw new Error(`Polling timed out after ${maxAttempts} attempts for request ${finalRequestId}`);
+}
+//# sourceMappingURL=gaslessBatch.js.map

package/_esm/src/actions/gaslessBatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gaslessBatch.js","sourceRoot":"","sources":["../../../src/actions/gaslessBatch.ts"],"names":[],"mappings":"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"}

package/_esm/src/actions/index.js

@@ -3,4 +3,5 @@ export * from './getQuote.js';
 export * from './getAppFees.js';
 export * from './claimAppFees.js';
 export * from './fastFill.js';
+export * from './gaslessBatch.js';
 //# sourceMappingURL=index.js.map

package/_esm/src/actions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA"}

package/_esm/src/constants/calibur.js

@@ -0,0 +1,80 @@
+import { pad } from 'viem';
+/**
+ * Calibur — Uniswap's minimal batch executor for EIP-7702 delegated EOAs.
+ * Deployed at the same address on all supported chains.
+ * https://github.com/Uniswap/calibur
+ */
+export const CALIBUR_ADDRESS = '0x000000009B1D0aF20D8C6d0A44e162d11F9b8f00';
+export const CALIBUR_ABI = [
+    {
+        name: 'execute',
+        type: 'function',
+        stateMutability: 'payable',
+        inputs: [
+            {
+                name: 'signedBatchedCall',
+                type: 'tuple',
+                components: [
+                    {
+                        name: 'batchedCall',
+                        type: 'tuple',
+                        components: [
+                            {
+                                name: 'calls',
+                                type: 'tuple[]',
+                                components: [
+                                    { name: 'to', type: 'address' },
+                                    { name: 'value', type: 'uint256' },
+                                    { name: 'data', type: 'bytes' }
+                                ]
+                            },
+                            { name: 'revertOnFailure', type: 'bool' }
+                        ]
+                    },
+                    { name: 'nonce', type: 'uint256' },
+                    { name: 'keyHash', type: 'bytes32' },
+                    { name: 'executor', type: 'address' },
+                    { name: 'deadline', type: 'uint256' }
+                ]
+            },
+            { name: 'wrappedSignature', type: 'bytes' }
+        ],
+        outputs: []
+    },
+    {
+        name: 'getSeq',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: 'key', type: 'uint256' }],
+        outputs: [{ name: '', type: 'uint256' }]
+    }
+];
+export const CALIBUR_EIP712_TYPES = {
+    SignedBatchedCall: [
+        { name: 'batchedCall', type: 'BatchedCall' },
+        { name: 'nonce', type: 'uint256' },
+        { name: 'keyHash', type: 'bytes32' },
+        { name: 'executor', type: 'address' },
+        { name: 'deadline', type: 'uint256' }
+    ],
+    BatchedCall: [
+        { name: 'calls', type: 'Call[]' },
+        { name: 'revertOnFailure', type: 'bool' }
+    ],
+    Call: [
+        { name: 'to', type: 'address' },
+        { name: 'value', type: 'uint256' },
+        { name: 'data', type: 'bytes' }
+    ]
+};
+/** bytes32(0) — the root key hash, meaning the EOA owner's key */
+export const ROOT_KEY_HASH = '0x0000000000000000000000000000000000000000000000000000000000000000';
+/**
+ * EIP-712 domain salt for Calibur.
+ * salt = pad(implementationAddress) with left-padding to 32 bytes.
+ */
+export const CALIBUR_SALT = pad(CALIBUR_ADDRESS, {
+    dir: 'left',
+    size: 32
+});
+//# sourceMappingURL=calibur.js.map

package/_esm/src/constants/calibur.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calibur.js","sourceRoot":"","sources":["../../../src/constants/calibur.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAE1B;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAC1B,4CAAuD,CAAA;AAEzD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,SAAS;QAC1B,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,mBAAmB;gBACzB,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE;oBACV;wBACE,IAAI,EAAE,aAAa;wBACnB,IAAI,EAAE,OAAO;wBACb,UAAU,EAAE;4BACV;gCACE,IAAI,EAAE,OAAO;gCACb,IAAI,EAAE,SAAS;gCACf,UAAU,EAAE;oCACV,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;oCAC/B,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;oCAClC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE;iCAChC;6BACF;4BACD,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE;yBAC1C;qBACF;oBACD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;oBAClC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;oBACpC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;oBACrC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;iBACtC;aACF;YACD,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,OAAO,EAAE;SAC5C;QACD,OAAO,EAAE,EAAE;KACZ;IACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KACzC;CACO,CAAA;AAEV,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,iBAAiB,EAAE;QACjB,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE;QAC5C,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAClC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;QACpC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;QACrC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;KACtC;IACD,WAAW,EAAE;QACX,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;QACjC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE;KAC1C;IACD,IAAI,EAAE;QACJ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;QAC/B,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAClC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE;KAChC;CACO,CAAA;AAEV,kEAAkE;AAClE,MAAM,CAAC,MAAM,aAAa,GACxB,oEAA2E,CAAA;AAE7E;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC,eAAe,EAAE;IAC/C,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,EAAE;CACT,CAAC,CAAA"}

package/_esm/src/constants/index.js

@@ -1,3 +1,4 @@
 export * from './servers.js';
 export * from './address.js';
+export * from './calibur.js';
 //# sourceMappingURL=index.js.map

package/_esm/src/constants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/_esm/src/types/BatchExecutor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BatchExecutor.js.map

package/_esm/src/types/BatchExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BatchExecutor.js","sourceRoot":"","sources":["../../../src/types/BatchExecutor.ts"],"names":[],"mappings":""}

package/_esm/src/types/index.js

@@ -5,4 +5,5 @@ export * from './TransactionStepItem.js';
 export * from './AdaptedWallet.js';
 export * from './RelayChain.js';
 export * from './Progress.js';
+export * from './BatchExecutor.js';
 //# sourceMappingURL=index.js.map

package/_esm/src/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA"}

package/_esm/src/utils/caliburExecutor.js

@@ -0,0 +1,57 @@
+import { encodeFunctionData } from 'viem';
+import { CALIBUR_ADDRESS, CALIBUR_ABI, CALIBUR_EIP712_TYPES, CALIBUR_SALT, ROOT_KEY_HASH } from '../constants/calibur.js';
+const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+export const CALIBUR_ORIGIN_GAS_OVERHEAD = 80_000;
+export function createCaliburExecutor() {
+    return {
+        address: CALIBUR_ADDRESS,
+        abi: CALIBUR_ABI,
+        eip712Types: CALIBUR_EIP712_TYPES,
+        eip712PrimaryType: 'SignedBatchedCall',
+        salt: CALIBUR_SALT,
+        originGasOverhead: CALIBUR_ORIGIN_GAS_OVERHEAD,
+        buildSignDomain(chainId, verifyingContract) {
+            return {
+                name: 'Calibur',
+                version: '1.0.0',
+                chainId: BigInt(chainId),
+                verifyingContract,
+                salt: CALIBUR_SALT
+            };
+        },
+        buildSignMessage(calls, nonce) {
+            return {
+                batchedCall: {
+                    calls: calls.map((c) => ({ to: c.to, value: c.value, data: c.data })),
+                    revertOnFailure: true
+                },
+                nonce,
+                keyHash: ROOT_KEY_HASH,
+                executor: ZERO_ADDRESS,
+                deadline: 0n
+            };
+        },
+        encodeExecute(signedMessage, wrappedSignature) {
+            return encodeFunctionData({
+                abi: CALIBUR_ABI,
+                functionName: 'execute',
+                args: [signedMessage, wrappedSignature]
+            });
+        },
+        async getNonce(publicClient, userAddress) {
+            try {
+                const seq = await publicClient.readContract({
+                    address: userAddress,
+                    abi: CALIBUR_ABI,
+                    functionName: 'getSeq',
+                    args: [0n]
+                });
+                return BigInt(seq);
+            }
+            catch {
+                return 0n;
+            }
+        }
+    };
+}
+//# sourceMappingURL=caliburExecutor.js.map

package/_esm/src/utils/caliburExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caliburExecutor.js","sourceRoot":"","sources":["../../../src/utils/caliburExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAInB,MAAM,MAAM,CAAA;AAEb,OAAO,EACL,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACd,MAAM,yBAAyB,CAAA;AAEhC,MAAM,YAAY,GAAG,4CAAuD,CAAA;AAE5E,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAA;AAEjD,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,WAAW;QAChB,WAAW,EAAE,oBAAoB;QACjC,iBAAiB,EAAE,mBAAmB;QACtC,IAAI,EAAE,YAAY;QAClB,iBAAiB,EAAE,2BAA2B;QAE9C,eAAe,CAAC,OAAe,EAAE,iBAA0B;YACzD,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,OAAO;gBAChB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;gBACxB,iBAAiB;gBACjB,IAAI,EAAE,YAAY;aACnB,CAAA;QACH,CAAC;QAED,gBAAgB,CAAC,KAAkB,EAAE,KAAa;YAChD,OAAO;gBACL,WAAW,EAAE;oBACX,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;oBACrE,eAAe,EAAE,IAAI;iBACtB;gBACD,KAAK;gBACL,OAAO,EAAE,aAAa;gBACtB,QAAQ,EAAE,YAAY;gBACtB,QAAQ,EAAE,EAAE;aACb,CAAA;QACH,CAAC;QAED,aAAa,CACX,aAAsC,EACtC,gBAAqB;YAErB,OAAO,kBAAkB,CAAC;gBACxB,GAAG,EAAE,WAAW;gBAChB,YAAY,EAAE,SAAS;gBACvB,IAAI,EAAE,CAAC,aAAoB,EAAE,gBAAgB,CAAC;aAC/C,CAAC,CAAA;QACJ,CAAC;QAED,KAAK,CAAC,QAAQ,CACZ,YAA0B,EAC1B,WAAoB;YAEpB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC;oBAC1C,OAAO,EAAE,WAAW;oBACpB,GAAG,EAAE,WAAW;oBAChB,YAAY,EAAE,QAAQ;oBACtB,IAAI,EAAE,CAAC,EAAE,CAAC;iBACX,CAAC,CAAA;gBACF,OAAO,MAAM,CAAC,GAAa,CAAC,CAAA;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/_esm/src/utils/index.js

@@ -13,4 +13,5 @@ export { safeStructuredClone } from './structuredClone.js';
 export { repeatUntilOk } from './repeatUntilOk.js';
 export { prepareHyperliquidSteps } from './hyperliquid.js';
 export { isRelayApiUrl, getApiKeyHeader } from './apiKey.js';
+export { createCaliburExecutor, CALIBUR_ORIGIN_GAS_OVERHEAD } from './caliburExecutor.js';
 //# sourceMappingURL=index.js.map

package/_esm/src/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAC/E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,EAAE,4BAA4B,EAAsB,MAAM,YAAY,CAAA;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAEL,yBAAyB,EAC1B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAC/E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,EAAE,4BAA4B,EAAsB,MAAM,YAAY,CAAA;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAEL,yBAAyB,EAC1B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC5B,MAAM,sBAAsB,CAAA"}

package/_esm/src/version.js

@@ -1,2 +1,2 @@
-export const SDK_VERSION = '5.1.0';
+export const SDK_VERSION = '5.2.0';
 //# sourceMappingURL=version.js.map