@rhinestone/relayer-sdk 0.1.0

package/dist/router.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.functionSelectorToAdapterCallMap = exports.EcoRepaymentsRelayerContext = exports.SameChainRepaymentsRelayerContext = exports.AcrossRepaymentsRelayerContext = exports.NoRelayerContext = void 0;
+exports.decodeRouterCall = decodeRouterCall;
+const shared_configs_1 = require("@rhinestone/shared-configs");
+const viem_1 = require("viem");
+const adapters_1 = require("./adapters");
+const errors_1 = require("./errors");
+const supportedRouteCalls = [
+    'routeClaim',
+    'routeFill',
+    'optimized_routeFill921336808',
+];
+/**
+ * Decodes router calldata and validates it's a supported route function.
+ *
+ * @param data - The ABI-encoded router calldata
+ * @returns Decoded function data with optimization flag
+ * @throws Error if the function is not a supported route call
+ */
+function decodeRouterCall(data) {
+    const routerCall = (0, viem_1.decodeFunctionData)({
+        abi: shared_configs_1.routerAbi,
+        data,
+    });
+    if (!supportedRouteCalls.includes(routerCall.functionName)) {
+        throw new errors_1.UnsupportedRouteCallError({
+            functionName: routerCall.functionName,
+        });
+    }
+    const isOptimizedRouteCall = routerCall.functionName.startsWith('optimized');
+    return {
+        ...routerCall,
+        isOptimizedRouteCall,
+    };
+}
+/**
+ * No-op rewrite for adapters that don't need repayment context modification.
+ * @internal
+ */
+const NoRelayerContext = (original, _repayment) => {
+    return original;
+};
+exports.NoRelayerContext = NoRelayerContext;
+const acrossRelayerContext = [
+    {
+        type: 'tuple[]',
+        components: [
+            { name: 'repaymentChain', type: 'uint256' },
+            { name: 'repaymentAddress', type: 'address' },
+        ],
+    },
+];
+/**
+ * Rewrites Across adapter relayer context.
+ * Across contexts contain an array of (repaymentChain, repaymentAddress) tuples,
+ * one per deposit/origin chain.
+ *
+ * When `repayment.chain` is provided, all tuples are updated to that chain.
+ * When omitted, each tuple preserves its original repaymentChain.
+ * @internal
+ */
+const AcrossRepaymentsRelayerContext = (original, repayment) => {
+    const decoded = (0, viem_1.decodeAbiParameters)(acrossRelayerContext, original);
+    const contexts = decoded[0];
+    for (const context of contexts) {
+        context.repaymentAddress = repayment.address;
+        if (repayment.chain) {
+            context.repaymentChain = BigInt(repayment.chain);
+        }
+    }
+    return (0, viem_1.encodeAbiParameters)(acrossRelayerContext, [contexts]);
+};
+exports.AcrossRepaymentsRelayerContext = AcrossRepaymentsRelayerContext;
+const sameChainRelayerContext = ['address'];
+/**
+ * Rewrites SameChain adapter relayer context.
+ * Simply encodes the new repayment address.
+ * @internal
+ */
+const SameChainRepaymentsRelayerContext = (_original, repayment) => {
+    return (0, viem_1.encodePacked)(sameChainRelayerContext, [repayment.address]);
+};
+exports.SameChainRepaymentsRelayerContext = SameChainRepaymentsRelayerContext;
+const ecoRelayerContext = ['address'];
+/**
+ * Rewrites Eco adapter relayer context.
+ * Simply encodes the new repayment address (claimant).
+ * @internal
+ */
+const EcoRepaymentsRelayerContext = (_original, repayment) => {
+    return (0, viem_1.encodePacked)(ecoRelayerContext, [repayment.address]);
+};
+exports.EcoRepaymentsRelayerContext = EcoRepaymentsRelayerContext;
+const lookup = (defaultCtx, overrides) => {
+    return (f) => {
+        const override = overrides?.[f.name];
+        if (override) {
+            return override;
+        }
+        return defaultCtx;
+    };
+};
+const adapterRelayerContextMap = {
+    singleCallAbi: lookup(exports.NoRelayerContext),
+    multiCallAbi: lookup(exports.NoRelayerContext, {
+        multicall_handleJITClaim: exports.SameChainRepaymentsRelayerContext,
+        multicall_handleFill: exports.SameChainRepaymentsRelayerContext,
+    }),
+    directRouteAbi: lookup(exports.NoRelayerContext),
+    sameChainAbi: lookup(exports.SameChainRepaymentsRelayerContext),
+    ecoAbi: lookup(exports.EcoRepaymentsRelayerContext),
+    acrossAbi: lookup(exports.AcrossRepaymentsRelayerContext),
+    intentExecutorAbi: lookup(exports.NoRelayerContext),
+    relayAbi: lookup(exports.NoRelayerContext),
+};
+function buildSelectorToAdapterCallMap() {
+    const map = {};
+    for (const key of Object.keys(adapters_1.adapters)) {
+        const lookupFn = adapterRelayerContextMap[key];
+        const abi = adapters_1.adapters[key];
+        for (const item of abi.filter((v) => v.type === 'function')) {
+            const functionSelector = (0, viem_1.toFunctionSelector)(item);
+            map[functionSelector] = {
+                functionName: item.name,
+                adapterName: key,
+                rewriteRelayerContext: lookupFn(item),
+            };
+        }
+    }
+    return map;
+}
+/**
+ * Pre-built map from 4-byte function selector to adapter call metadata.
+ * Used to look up the appropriate rewrite function for each adapter call.
+ */
+exports.functionSelectorToAdapterCallMap = buildSelectorToAdapterCallMap();

package/dist/types.d.ts

@@ -0,0 +1,42 @@
+import type { Address } from 'viem';
+declare const __brand: unique symbol;
+/**
+ * Internal branded Ethereum address type.
+ * Lowercase-normalized and intersects with viem's Address type.
+ * @internal
+ */
+export type EthAddress = Address & {
+    [__brand]: 'EthAddress';
+};
+/**
+ * Where the relayer wants to be repaid.
+ *
+ * - `address` — the repayment recipient address.
+ * - `chain` — override the repayment chain. When omitted, each repayment
+ *   entry preserves its original chain (e.g., Across tuples keep their
+ *   per-deposit origin chains). Pass explicitly to redirect all repayments
+ *   to a single chain.
+ */
+export type RepaymentDestination = {
+    address: Address;
+    chain?: number;
+};
+/**
+ * Contract addresses required to identify router vs intent-executor calls.
+ * When omitted from `replaceRepaymentDestinations`, defaults to production
+ * addresses from `@rhinestone/shared-configs`.
+ */
+export type RebalancingConfig = {
+    routerAddress: Address;
+    intentExecutorAddress: Address;
+};
+/**
+ * Internal version of RepaymentDestination with normalized addresses.
+ * @internal
+ */
+export type InternalRepaymentDestination = {
+    address: EthAddress;
+    chain?: number;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,CAAC,MAAM,OAAO,EAAE,OAAO,MAAM,CAAA;AAEpC;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG;IAAE,CAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,CAAA;AAE9D;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,EAAE,OAAO,CAAA;IACtB,qBAAqB,EAAE,OAAO,CAAA;CAC/B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,UAAU,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@rhinestone/relayer-sdk",
+  "version": "0.1.0",
+  "description": "SDK for rewriting repayment destinations in router-encoded intent calldata",
+  "author": {
+    "name": "Rhinestone",
+    "url": "https://rhinestone.dev"
+  },
+  "keywords": [
+    "ethereum",
+    "rhinestone",
+    "relayer",
+    "intent",
+    "rebalancing"
+  ],
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "homepage": "https://docs.rhinestone.dev/",
+  "bugs": {
+    "url": "https://github.com/rhinestonewtf/relayer-sdk/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rhinestonewtf/relayer-sdk.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@rhinestone/shared-configs": "1.4.74"
+  },
+  "peerDependencies": {
+    "viem": "^2.38.0"
+  }
+}