@shroud-fi/relayer 0.1.0

package/dist/cjs/gelato-adapter.js

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.submitSponsoredCallErc2771 = submitSponsoredCallErc2771;
+exports.pollGelatoTaskUntilTerminal = pollGelatoTaskUntilTerminal;
+const viem_1 = require("viem");
+const accounts_1 = require("viem/accounts");
+const relay_sdk_viem_1 = require("@gelatonetwork/relay-sdk-viem");
+const constants_js_1 = require("./constants.js");
+const errors_js_1 = require("./errors.js");
+// Lazily instantiate a single relay client per process. Stateless wrt
+// chain/key so safe to share.
+let _relay;
+function relay() {
+    if (_relay === undefined) {
+        _relay = new relay_sdk_viem_1.GelatoRelay();
+    }
+    return _relay;
+}
+/**
+ * Submit a sponsored ERC-2771 metaTx via Gelato 1Balance.
+ *
+ * Returns the Gelato `taskId`. Caller is responsible for polling.
+ */
+async function submitSponsoredCallErc2771(p) {
+    const account = (0, accounts_1.privateKeyToAccount)(p.userPrivateKey);
+    // Build an ephemeral walletClient. The Gelato SDK uses it to sign the
+    // ERC-2771 typed data. We deliberately avoid persisting it.
+    const wallet = (0, viem_1.createWalletClient)({
+        account,
+        chain: p.chain,
+        transport: p.rpcUrl !== undefined ? (0, viem_1.http)(p.rpcUrl) : (0, viem_1.http)(),
+    });
+    const request = {
+        chainId: BigInt(p.chainId),
+        target: p.target,
+        data: p.data,
+        user: p.user,
+        isConcurrent: false,
+    };
+    try {
+        const response = await relay().sponsoredCallERC2771(request, wallet, p.apiKey ?? '');
+        return response.taskId;
+    }
+    catch (err) {
+        // Surface only the upstream error class name; never the message
+        // (may contain calldata bytes, addresses, or RPC quoting).
+        const tag = err instanceof Error ? err.name : 'unknown';
+        throw new errors_js_1.RelayerSubmissionError(tag);
+    }
+}
+function mapTaskState(state) {
+    switch (state) {
+        case relay_sdk_viem_1.TaskState.ExecSuccess:
+        case 'ExecSuccess':
+            return 'success';
+        case relay_sdk_viem_1.TaskState.ExecReverted:
+        case 'ExecReverted':
+            return 'failed';
+        case relay_sdk_viem_1.TaskState.Cancelled:
+        case 'Cancelled':
+            return 'cancelled';
+        case relay_sdk_viem_1.TaskState.CheckPending:
+        case relay_sdk_viem_1.TaskState.ExecPending:
+        case relay_sdk_viem_1.TaskState.WaitingForConfirmation:
+        case 'CheckPending':
+        case 'ExecPending':
+        case 'WaitingForConfirmation':
+            return 'pending';
+        default:
+            // Treat unknown lifecycle states (e.g. "Blacklisted") as failure.
+            return 'failed';
+    }
+}
+/**
+ * Fetch a single task-status snapshot via the public Gelato HTTP endpoint.
+ * Used as fallback if the SDK's getTaskStatus returns undefined.
+ */
+async function fetchTaskStatusFallback(taskId, signal) {
+    // `fetch` is globally available in Node 18+.
+    let resp;
+    try {
+        const init = signal !== undefined ? { signal } : {};
+        resp = await fetch(`${constants_js_1.GELATO_TASK_STATUS_URL}${taskId}`, init);
+    }
+    catch {
+        return undefined;
+    }
+    if (!resp.ok)
+        return undefined;
+    let body;
+    try {
+        body = await resp.json();
+    }
+    catch {
+        return undefined;
+    }
+    // Endpoint returns either { task: {...} } or the bare task object.
+    const taskUnknown = body !== null && typeof body === 'object' && 'task' in body
+        ? body.task
+        : body;
+    if (taskUnknown === null || typeof taskUnknown !== 'object')
+        return undefined;
+    const task = taskUnknown;
+    const rawState = task['taskState'];
+    if (typeof rawState !== 'string')
+        return undefined;
+    const state = mapTaskState(rawState);
+    const result = {
+        taskId,
+        state,
+    };
+    const txHash = task['transactionHash'];
+    if (typeof txHash === 'string' && txHash.startsWith('0x')) {
+        result.txHash = txHash;
+    }
+    const blockNumber = task['blockNumber'];
+    if (typeof blockNumber === 'number') {
+        result.blockNumber = BigInt(blockNumber);
+    }
+    else if (typeof blockNumber === 'string' && /^\d+$/.test(blockNumber)) {
+        result.blockNumber = BigInt(blockNumber);
+    }
+    const lastErr = task['lastCheckMessage'];
+    if (typeof lastErr === 'string' && lastErr.length > 0) {
+        result.lastErrorMsg = lastErr;
+    }
+    return result;
+}
+/**
+ * Poll Gelato task status until terminal (success / failed / cancelled) or
+ * until the timeout expires / the abort signal fires.
+ *
+ * Strategy:
+ *   1. Try the SDK's `getTaskStatus` first (it shares websocket cache).
+ *   2. Fall back to direct HTTP if the SDK returns undefined.
+ *
+ * Errors:
+ *   - RelayerTimeoutError on timeout / abort
+ *   - RelayerExecutionFailedError on `failed`/`cancelled` terminal state
+ */
+async function pollGelatoTaskUntilTerminal(taskId, opts) {
+    const deadline = Date.now() + opts.pollTimeoutMs;
+    const r = relay();
+    while (Date.now() < deadline) {
+        if (opts.signal?.aborted === true) {
+            throw new errors_js_1.RelayerTimeoutError();
+        }
+        let status;
+        try {
+            const upstream = await r.getTaskStatus(taskId);
+            if (upstream !== undefined) {
+                const built = {
+                    taskId,
+                    state: mapTaskState(upstream.taskState),
+                };
+                if (typeof upstream.transactionHash === 'string' &&
+                    upstream.transactionHash.startsWith('0x')) {
+                    built.txHash = upstream.transactionHash;
+                }
+                if (typeof upstream.blockNumber === 'number') {
+                    built.blockNumber = BigInt(upstream.blockNumber);
+                }
+                if (typeof upstream.lastCheckMessage === 'string' &&
+                    upstream.lastCheckMessage.length > 0) {
+                    built.lastErrorMsg = upstream.lastCheckMessage;
+                }
+                status = built;
+            }
+        }
+        catch {
+            // swallow; we'll try the HTTP fallback or retry next tick
+        }
+        if (status === undefined) {
+            status = await fetchTaskStatusFallback(taskId, opts.signal);
+        }
+        if (status !== undefined) {
+            if (status.state === 'success')
+                return status;
+            if (status.state === 'failed' || status.state === 'cancelled') {
+                throw new errors_js_1.RelayerExecutionFailedError(status.state);
+            }
+            // pending / submitted: keep polling
+        }
+        await sleep(opts.pollIntervalMs, opts.signal);
+    }
+    throw new errors_js_1.RelayerTimeoutError();
+}
+async function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted === true) {
+            reject(new errors_js_1.RelayerTimeoutError());
+            return;
+        }
+        const t = setTimeout(() => {
+            if (signal !== undefined) {
+                signal.removeEventListener('abort', onAbort);
+            }
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(t);
+            reject(new errors_js_1.RelayerTimeoutError());
+        };
+        if (signal !== undefined) {
+            signal.addEventListener('abort', onAbort, { once: true });
+        }
+    });
+}
+//# sourceMappingURL=gelato-adapter.js.map

package/dist/cjs/gelato-adapter.js.map

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

package/dist/cjs/index.d.ts

@@ -0,0 +1,7 @@
+export { relayedSweepERC20 } from './relayer.js';
+export { relayedSweepETH } from './eth-sweep.js';
+export { signEip2612Permit } from './signing.js';
+export type { RelayerSweepOptions, RelayerSweepReceipt, RelayerSweepStatus, GelatoTaskId, Eip2612PermitSignature, RelayedEthSweepOptions, RelayedEthSweepReceipt, } from './types.js';
+export { RelayerError, RelayerSignatureError, RelayerSubmissionError, RelayerExecutionFailedError, RelayerTimeoutError, RelayerForwarderMismatchError, StealthAddressEmptyError, RelayerInvalidChainError, } from './errors.js';
+export { DEFAULT_PERMIT_DEADLINE_SECS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_POLL_TIMEOUT_MS, GELATO_FORWARDER_BY_CHAIN, DEFAULT_ETH_SWEEP_DEADLINE_SECS, ETH_RELAYER_SUPPORTED_CHAINS, } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,mBAAmB,EACnB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,EACzB,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ETH_RELAYER_SUPPORTED_CHAINS = exports.DEFAULT_ETH_SWEEP_DEADLINE_SECS = exports.GELATO_FORWARDER_BY_CHAIN = exports.DEFAULT_POLL_TIMEOUT_MS = exports.DEFAULT_POLL_INTERVAL_MS = exports.DEFAULT_PERMIT_DEADLINE_SECS = exports.RelayerInvalidChainError = exports.StealthAddressEmptyError = exports.RelayerForwarderMismatchError = exports.RelayerTimeoutError = exports.RelayerExecutionFailedError = exports.RelayerSubmissionError = exports.RelayerSignatureError = exports.RelayerError = exports.signEip2612Permit = exports.relayedSweepETH = exports.relayedSweepERC20 = void 0;
+var relayer_js_1 = require("./relayer.js");
+Object.defineProperty(exports, "relayedSweepERC20", { enumerable: true, get: function () { return relayer_js_1.relayedSweepERC20; } });
+var eth_sweep_js_1 = require("./eth-sweep.js");
+Object.defineProperty(exports, "relayedSweepETH", { enumerable: true, get: function () { return eth_sweep_js_1.relayedSweepETH; } });
+var signing_js_1 = require("./signing.js");
+Object.defineProperty(exports, "signEip2612Permit", { enumerable: true, get: function () { return signing_js_1.signEip2612Permit; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "RelayerError", { enumerable: true, get: function () { return errors_js_1.RelayerError; } });
+Object.defineProperty(exports, "RelayerSignatureError", { enumerable: true, get: function () { return errors_js_1.RelayerSignatureError; } });
+Object.defineProperty(exports, "RelayerSubmissionError", { enumerable: true, get: function () { return errors_js_1.RelayerSubmissionError; } });
+Object.defineProperty(exports, "RelayerExecutionFailedError", { enumerable: true, get: function () { return errors_js_1.RelayerExecutionFailedError; } });
+Object.defineProperty(exports, "RelayerTimeoutError", { enumerable: true, get: function () { return errors_js_1.RelayerTimeoutError; } });
+Object.defineProperty(exports, "RelayerForwarderMismatchError", { enumerable: true, get: function () { return errors_js_1.RelayerForwarderMismatchError; } });
+Object.defineProperty(exports, "StealthAddressEmptyError", { enumerable: true, get: function () { return errors_js_1.StealthAddressEmptyError; } });
+Object.defineProperty(exports, "RelayerInvalidChainError", { enumerable: true, get: function () { return errors_js_1.RelayerInvalidChainError; } });
+var constants_js_1 = require("./constants.js");
+Object.defineProperty(exports, "DEFAULT_PERMIT_DEADLINE_SECS", { enumerable: true, get: function () { return constants_js_1.DEFAULT_PERMIT_DEADLINE_SECS; } });
+Object.defineProperty(exports, "DEFAULT_POLL_INTERVAL_MS", { enumerable: true, get: function () { return constants_js_1.DEFAULT_POLL_INTERVAL_MS; } });
+Object.defineProperty(exports, "DEFAULT_POLL_TIMEOUT_MS", { enumerable: true, get: function () { return constants_js_1.DEFAULT_POLL_TIMEOUT_MS; } });
+Object.defineProperty(exports, "GELATO_FORWARDER_BY_CHAIN", { enumerable: true, get: function () { return constants_js_1.GELATO_FORWARDER_BY_CHAIN; } });
+Object.defineProperty(exports, "DEFAULT_ETH_SWEEP_DEADLINE_SECS", { enumerable: true, get: function () { return constants_js_1.DEFAULT_ETH_SWEEP_DEADLINE_SECS; } });
+Object.defineProperty(exports, "ETH_RELAYER_SUPPORTED_CHAINS", { enumerable: true, get: function () { return constants_js_1.ETH_RELAYER_SUPPORTED_CHAINS; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,2CAAiD;AAAxC,+GAAA,iBAAiB,OAAA;AAC1B,+CAAiD;AAAxC,+GAAA,eAAe,OAAA;AACxB,2CAAiD;AAAxC,+GAAA,iBAAiB,OAAA;AAY1B,yCASqB;AARnB,yGAAA,YAAY,OAAA;AACZ,kHAAA,qBAAqB,OAAA;AACrB,mHAAA,sBAAsB,OAAA;AACtB,wHAAA,2BAA2B,OAAA;AAC3B,gHAAA,mBAAmB,OAAA;AACnB,0HAAA,6BAA6B,OAAA;AAC7B,qHAAA,wBAAwB,OAAA;AACxB,qHAAA,wBAAwB,OAAA;AAG1B,+CAOwB;AANtB,4HAAA,4BAA4B,OAAA;AAC5B,wHAAA,wBAAwB,OAAA;AACxB,uHAAA,uBAAuB,OAAA;AACvB,yHAAA,yBAAyB,OAAA;AACzB,+HAAA,+BAA+B,OAAA;AAC/B,4HAAA,4BAA4B,OAAA"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/relayer.d.ts

@@ -0,0 +1,23 @@
+import type { Address, Hex } from 'viem';
+import type { ShroudFiTransport } from '@shroud-fi/transport';
+import type { RelayerSweepOptions, RelayerSweepReceipt } from './types.js';
+/**
+ * Gasless ERC-20 sweep via the deployed `ShroudFiRelayer` + Gelato.
+ *
+ * Flow:
+ *   1. Validate chain is in the supported Gelato forwarder table.
+ *   2. Read the relayer's on-chain trustedForwarder and assert match.
+ *   3. Read the stealth address ERC-20 balance (= permit `value`).
+ *   4. Sign an EIP-2612 permit { owner=stealth, spender=relayer, value, deadline }.
+ *   5. Encode `sweepERC20WithPermit(token, destination, deadline, v, r, s)`.
+ *   6. Submit via `sponsoredCallERC2771` (1Balance sponsored).
+ *   7. Poll until terminal — return receipt with txHash + blockNumber.
+ *
+ * Privacy invariants enforced here:
+ *   - `stealthPrivateKey` is never logged, serialized, or attached to errors.
+ *   - The receipt contains NO amount fields (balance is read but discarded
+ *     after permit signing).
+ *   - Error messages contain no addresses, amounts, signature bytes, or chain ids.
+ */
+export declare function relayedSweepERC20(transport: ShroudFiTransport, stealthPrivateKey: Hex, token: Address, destination: Address, relayerContract: Address, options?: RelayerSweepOptions): Promise<RelayerSweepReceipt>;
+//# sourceMappingURL=relayer.d.ts.map

package/dist/cjs/relayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relayer.d.ts","sourceRoot":"","sources":["../../src/relayer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAGzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAO9D,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAuDpB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,iBAAiB,EAAE,GAAG,EACtB,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,OAAO,EACpB,eAAe,EAAE,OAAO,EACxB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAqH9B"}

package/dist/cjs/relayer.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.relayedSweepERC20 = relayedSweepERC20;
+const viem_1 = require("viem");
+const accounts_1 = require("viem/accounts");
+const constants_js_1 = require("./constants.js");
+const errors_js_1 = require("./errors.js");
+const signing_js_1 = require("./signing.js");
+const gelato_adapter_js_1 = require("./gelato-adapter.js");
+/**
+ * Minimal inline ABI for `ShroudFiRelayer` — only the surface we call from
+ * the SDK. Kept here (not in a shared `abi.ts`) because no other module needs
+ * these entries today.
+ */
+const SHROUDFI_RELAYER_ABI = [
+    {
+        type: 'function',
+        name: 'sweepERC20WithPermit',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'token', type: 'address' },
+            { name: 'destination', type: 'address' },
+            { name: 'deadline', type: 'uint256' },
+            { name: 'v', type: 'uint8' },
+            { name: 'r', type: 'bytes32' },
+            { name: 's', type: 'bytes32' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'trustedForwarder',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'address' }],
+    },
+];
+/**
+ * Minimal balanceOf ABI for the pre-flight balance read. Inlined so this file
+ * has no dependency on `@shroud-fi/transport`'s ERC20Abi shape.
+ */
+const ERC20_BALANCE_OF_ABI = [
+    {
+        type: 'function',
+        name: 'balanceOf',
+        stateMutability: 'view',
+        inputs: [{ name: 'account', type: 'address' }],
+        outputs: [{ name: '', type: 'uint256' }],
+    },
+];
+/**
+ * Gasless ERC-20 sweep via the deployed `ShroudFiRelayer` + Gelato.
+ *
+ * Flow:
+ *   1. Validate chain is in the supported Gelato forwarder table.
+ *   2. Read the relayer's on-chain trustedForwarder and assert match.
+ *   3. Read the stealth address ERC-20 balance (= permit `value`).
+ *   4. Sign an EIP-2612 permit { owner=stealth, spender=relayer, value, deadline }.
+ *   5. Encode `sweepERC20WithPermit(token, destination, deadline, v, r, s)`.
+ *   6. Submit via `sponsoredCallERC2771` (1Balance sponsored).
+ *   7. Poll until terminal — return receipt with txHash + blockNumber.
+ *
+ * Privacy invariants enforced here:
+ *   - `stealthPrivateKey` is never logged, serialized, or attached to errors.
+ *   - The receipt contains NO amount fields (balance is read but discarded
+ *     after permit signing).
+ *   - Error messages contain no addresses, amounts, signature bytes, or chain ids.
+ */
+async function relayedSweepERC20(transport, stealthPrivateKey, token, destination, relayerContract, options) {
+    const chainId = transport.chain.id;
+    // 1. Chain support check.
+    const expectedForwarder = constants_js_1.GELATO_FORWARDER_BY_CHAIN[chainId];
+    if (expectedForwarder === undefined) {
+        throw new errors_js_1.RelayerInvalidChainError();
+    }
+    // 2. Forwarder match check (defense-in-depth).
+    const onChainForwarder = (await transport.publicClient.readContract({
+        address: relayerContract,
+        abi: SHROUDFI_RELAYER_ABI,
+        functionName: 'trustedForwarder',
+    }));
+    if ((0, viem_1.getAddress)(onChainForwarder) !== (0, viem_1.getAddress)(expectedForwarder)) {
+        throw new errors_js_1.RelayerForwarderMismatchError();
+    }
+    // 3. Balance read. Note: `account` is derived inside a tight scope; we
+    // never persist or log the privateKey-derived account beyond this.
+    const stealthAddress = (0, accounts_1.privateKeyToAccount)(stealthPrivateKey).address;
+    const balance = (await transport.publicClient.readContract({
+        address: token,
+        abi: ERC20_BALANCE_OF_ABI,
+        functionName: 'balanceOf',
+        args: [stealthAddress],
+    }));
+    if (balance === 0n) {
+        throw new errors_js_1.StealthAddressEmptyError();
+    }
+    // 4. Compute permit deadline. Use block.timestamp + lifetime so the
+    // deadline aligns with the chain's clock rather than the host's.
+    const lifetime = options?.deadlineSecs ?? constants_js_1.DEFAULT_PERMIT_DEADLINE_SECS;
+    const latestBlock = await transport.publicClient.getBlock();
+    const deadline = latestBlock.timestamp + lifetime;
+    // 5. Sign the EIP-2612 permit.
+    const permit = await (0, signing_js_1.signEip2612Permit)(transport, stealthPrivateKey, token, relayerContract, balance, deadline);
+    // 6. Encode sweepERC20WithPermit calldata.
+    const calldata = (0, viem_1.encodeFunctionData)({
+        abi: SHROUDFI_RELAYER_ABI,
+        functionName: 'sweepERC20WithPermit',
+        args: [token, destination, permit.deadline, permit.v, permit.r, permit.s],
+    });
+    // 7. Submit via Gelato 1Balance sponsored call.
+    const submitParams = {
+        chainId,
+        target: relayerContract,
+        data: calldata,
+        user: stealthAddress,
+        userPrivateKey: stealthPrivateKey,
+        chain: transport.chain,
+    };
+    if (options?.gelatoApiKey !== undefined) {
+        submitParams.apiKey = options.gelatoApiKey;
+    }
+    if (options?.signal !== undefined) {
+        submitParams.signal = options.signal;
+    }
+    const taskId = await (0, gelato_adapter_js_1.submitSponsoredCallErc2771)(submitParams);
+    // 8. Poll until terminal.
+    const pollOpts = {
+        pollIntervalMs: options?.pollIntervalMs ?? constants_js_1.DEFAULT_POLL_INTERVAL_MS,
+        pollTimeoutMs: options?.pollTimeoutMs ?? constants_js_1.DEFAULT_POLL_TIMEOUT_MS,
+    };
+    if (options?.signal !== undefined) {
+        pollOpts.signal = options.signal;
+    }
+    const status = await (0, gelato_adapter_js_1.pollGelatoTaskUntilTerminal)(taskId, pollOpts);
+    // Build the receipt. NOTE: no amount fields by design.
+    const receipt = {
+        taskId,
+        txHash: status.txHash ?? '0x',
+        status: status.state,
+        relayerContract,
+        token,
+        destination,
+    };
+    if (status.blockNumber !== undefined) {
+        receipt.blockNumber = status.blockNumber;
+    }
+    return receipt;
+}
+//# sourceMappingURL=relayer.js.map

package/dist/cjs/relayer.js.map

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

package/dist/cjs/signing.d.ts

@@ -0,0 +1,24 @@
+import type { Address, Hex } from 'viem';
+import type { ShroudFiTransport } from '@shroud-fi/transport';
+import type { Eip2612PermitSignature } from './types.js';
+/**
+ * Sign an EIP-2612 permit for {token, spender, value, deadline} from the
+ * stealth address keyed by `stealthPrivateKey`.
+ *
+ * Privacy:
+ *   - The privateKey is consumed once to derive a viem `account` and is not
+ *     stored, logged, serialized, or attached to thrown errors.
+ *   - On failure we throw a structured `RelayerSignatureError` with no key
+ *     material, no signature bytes, no nonce.
+ *   - Token `version()` is probed with a try/catch fallback to "1" — the
+ *     dominant default across permit-compatible ERC-20s.
+ *
+ * @param transport - ShroudFi transport (publicClient for reads)
+ * @param stealthPrivateKey - 0x-prefixed 32-byte private key (treated as secret)
+ * @param token - ERC-20 contract
+ * @param spender - relayer contract address (= `ShroudFiRelayer`)
+ * @param value - permit value (= full balance at time of sign)
+ * @param deadline - unix-seconds deadline (caller computes from `block.timestamp + lifetime`)
+ */
+export declare function signEip2612Permit(transport: ShroudFiTransport, stealthPrivateKey: Hex, token: Address, spender: Address, value: bigint, deadline: bigint): Promise<Eip2612PermitSignature>;
+//# sourceMappingURL=signing.d.ts.map

package/dist/cjs/signing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.d.ts","sourceRoot":"","sources":["../../src/signing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAGzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AA2CzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,iBAAiB,EAAE,GAAG,EACtB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC,CA2FjC"}

package/dist/cjs/signing.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signEip2612Permit = signEip2612Permit;
+const viem_1 = require("viem");
+const accounts_1 = require("viem/accounts");
+const errors_js_1 = require("./errors.js");
+/**
+ * Minimal ABI for the read paths we use. Inlined rather than imported from
+ * `@shroud-fi/transport`'s ERC20Abi so this file has zero coupling to
+ * non-permit fields. Direct two-call reads (no multicall3 dependency) so the
+ * SDK runs against forks/local Anvils where multicall may not be configured.
+ */
+const PERMIT_READ_ABI = [
+    {
+        type: 'function',
+        name: 'name',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'string' }],
+    },
+    {
+        type: 'function',
+        name: 'version',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'string' }],
+    },
+    {
+        type: 'function',
+        name: 'nonces',
+        stateMutability: 'view',
+        inputs: [{ name: 'owner', type: 'address' }],
+        outputs: [{ name: '', type: 'uint256' }],
+    },
+];
+const PERMIT_TYPES = {
+    Permit: [
+        { name: 'owner', type: 'address' },
+        { name: 'spender', type: 'address' },
+        { name: 'value', type: 'uint256' },
+        { name: 'nonce', type: 'uint256' },
+        { name: 'deadline', type: 'uint256' },
+    ],
+};
+/**
+ * Sign an EIP-2612 permit for {token, spender, value, deadline} from the
+ * stealth address keyed by `stealthPrivateKey`.
+ *
+ * Privacy:
+ *   - The privateKey is consumed once to derive a viem `account` and is not
+ *     stored, logged, serialized, or attached to thrown errors.
+ *   - On failure we throw a structured `RelayerSignatureError` with no key
+ *     material, no signature bytes, no nonce.
+ *   - Token `version()` is probed with a try/catch fallback to "1" — the
+ *     dominant default across permit-compatible ERC-20s.
+ *
+ * @param transport - ShroudFi transport (publicClient for reads)
+ * @param stealthPrivateKey - 0x-prefixed 32-byte private key (treated as secret)
+ * @param token - ERC-20 contract
+ * @param spender - relayer contract address (= `ShroudFiRelayer`)
+ * @param value - permit value (= full balance at time of sign)
+ * @param deadline - unix-seconds deadline (caller computes from `block.timestamp + lifetime`)
+ */
+async function signEip2612Permit(transport, stealthPrivateKey, token, spender, value, deadline) {
+    const account = (0, accounts_1.privateKeyToAccount)(stealthPrivateKey);
+    const owner = account.address;
+    const chainId = transport.chain.id;
+    // Read token name (required for the domain separator). If a token doesn't
+    // expose `name()` it isn't ERC-2612 compatible — propagate as signature error.
+    let tokenName;
+    try {
+        tokenName = (await transport.publicClient.readContract({
+            address: token,
+            abi: PERMIT_READ_ABI,
+            functionName: 'name',
+        }));
+    }
+    catch {
+        throw new errors_js_1.RelayerSignatureError();
+    }
+    // Token version: most permit ERC-20s use "1". Probe with a try/catch.
+    let tokenVersion = '1';
+    try {
+        const v = (await transport.publicClient.readContract({
+            address: token,
+            abi: PERMIT_READ_ABI,
+            functionName: 'version',
+        }));
+        if (typeof v === 'string' && v.length > 0) {
+            tokenVersion = v;
+        }
+    }
+    catch {
+        // intentional: fall back to "1"
+    }
+    // Read the current permit nonce for `owner`.
+    let nonce;
+    try {
+        nonce = (await transport.publicClient.readContract({
+            address: token,
+            abi: PERMIT_READ_ABI,
+            functionName: 'nonces',
+            args: [owner],
+        }));
+    }
+    catch {
+        throw new errors_js_1.RelayerSignatureError();
+    }
+    const domain = {
+        name: tokenName,
+        version: tokenVersion,
+        chainId,
+        verifyingContract: token,
+    };
+    let signatureHex;
+    try {
+        signatureHex = await account.signTypedData({
+            domain,
+            types: PERMIT_TYPES,
+            primaryType: 'Permit',
+            message: {
+                owner,
+                spender,
+                value,
+                nonce,
+                deadline,
+            },
+        });
+    }
+    catch {
+        throw new errors_js_1.RelayerSignatureError();
+    }
+    // viem returns the 65-byte signature; split into v/r/s.
+    // `parseSignature` returns either {r,s,v,yParity} or {r,s,yParity} (v?: never).
+    // Standard EIP-2612 needs `v ∈ {27, 28}`: derive from yParity if v is absent.
+    let v;
+    let r;
+    let s;
+    try {
+        const split = (0, viem_1.parseSignature)(signatureHex);
+        r = split.r;
+        s = split.s;
+        if (split.v !== undefined) {
+            v = Number(split.v);
+        }
+        else {
+            v = split.yParity === 0 ? 27 : 28;
+        }
+    }
+    catch {
+        throw new errors_js_1.RelayerSignatureError();
+    }
+    return { v, r, s, deadline };
+}
+//# sourceMappingURL=signing.js.map

package/dist/cjs/signing.js.map

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