@stableflow/utils-evm 0.0.0-experimental-5a8afd7389-20260703

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StableFlow AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,27 @@
+# @stableflow/utils-evm
+
+EVM utilities for the StableFlow SDK: RPC fallback providers and LayerZero compose helpers.
+
+## Installation
+
+```bash
+pnpm add @stableflow/utils-evm @stableflow/core
+```
+
+This package is primarily used internally by `@stableflow/bridges` and `@stableflow/wallet-evm`. Application code rarely imports it directly.
+
+## Main exports
+
+| Export | Description |
+|--------|-------------|
+| `evmRpcFallbackProvider` | EVM JSON-RPC provider with fallback URLs |
+| `buildEndpointV2LzComposePayload` | LayerZero v2 compose payload builder |
+| `encodeUint`, `normalizeHex`, `toBytes32` | Encoding helpers |
+| `NATIVE_MSG_FEE_BUFFER` | Native message fee buffer constant |
+
+See `dist/index.d.ts` after `pnpm build`.
+
+## See also
+
+- [Developer Guide](../../DEVELOPER_GUIDE.md)
+- [@stableflow/wallet-evm](../wallet-evm/README.md)

package/dist/index.d.mts

@@ -0,0 +1,24 @@
+import { ethers } from 'ethers';
+import { TokenConfig } from '@stableflow/core';
+
+declare class SequentialFallbackProvider extends ethers.AbstractProvider {
+    private providers;
+    constructor(providers: ethers.JsonRpcProvider[], chainId: number);
+    _detectNetwork(): Promise<ethers.Network>;
+    _perform(req: ethers.PerformActionRequest): Promise<any>;
+}
+declare function evmRpcFallbackProvider(chain: TokenConfig): ethers.AbstractProvider | SequentialFallbackProvider | ethers.JsonRpcProvider;
+
+declare function normalizeHex(hex: string): string;
+declare function toBytes32(addrOrBytes32: string): string;
+declare function encodeUint(value: string, sizeBytes: number): string;
+declare function buildEndpointV2LzComposePayload(params: {
+    nonce: string;
+    srcEid: string;
+    amountLD: string;
+    composeFrom: string;
+    composeMsg: string;
+}): string;
+declare const NATIVE_MSG_FEE_BUFFER: bigint;
+
+export { NATIVE_MSG_FEE_BUFFER, buildEndpointV2LzComposePayload, encodeUint, evmRpcFallbackProvider, normalizeHex, toBytes32 };

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { ethers } from 'ethers';
+import { TokenConfig } from '@stableflow/core';
+
+declare class SequentialFallbackProvider extends ethers.AbstractProvider {
+    private providers;
+    constructor(providers: ethers.JsonRpcProvider[], chainId: number);
+    _detectNetwork(): Promise<ethers.Network>;
+    _perform(req: ethers.PerformActionRequest): Promise<any>;
+}
+declare function evmRpcFallbackProvider(chain: TokenConfig): ethers.AbstractProvider | SequentialFallbackProvider | ethers.JsonRpcProvider;
+
+declare function normalizeHex(hex: string): string;
+declare function toBytes32(addrOrBytes32: string): string;
+declare function encodeUint(value: string, sizeBytes: number): string;
+declare function buildEndpointV2LzComposePayload(params: {
+    nonce: string;
+    srcEid: string;
+    amountLD: string;
+    composeFrom: string;
+    composeMsg: string;
+}): string;
+declare const NATIVE_MSG_FEE_BUFFER: bigint;
+
+export { NATIVE_MSG_FEE_BUFFER, buildEndpointV2LzComposePayload, encodeUint, evmRpcFallbackProvider, normalizeHex, toBytes32 };

package/dist/index.js

@@ -0,0 +1,99 @@
+'use strict';
+
+var ethers = require('ethers');
+
+// src/evm-rpc-providers.ts
+var providerCache = /* @__PURE__ */ new Map();
+var SequentialFallbackProvider = class extends ethers.ethers.AbstractProvider {
+  constructor(providers, chainId) {
+    super(chainId);
+    this.providers = providers;
+  }
+  async _detectNetwork() {
+    return this.providers[0]._detectNetwork();
+  }
+  async _perform(req) {
+    let lastError;
+    for (const provider of this.providers) {
+      try {
+        return await provider._perform(req);
+      } catch (err) {
+        if (ethers.ethers.isError(err, "CALL_EXCEPTION")) throw err;
+        lastError = err;
+      }
+    }
+    throw lastError;
+  }
+};
+function evmRpcFallbackProvider(chain) {
+  const { rpcUrls, chainId } = chain;
+  if (providerCache.has(chainId)) {
+    return providerCache.get(chainId);
+  }
+  const providers = rpcUrls.map(
+    (rpc) => {
+      return new ethers.ethers.JsonRpcProvider(rpc, chainId, { staticNetwork: true });
+    }
+  );
+  const provider = providers.length === 1 ? providers[0] : new SequentialFallbackProvider(providers, chainId);
+  providerCache.set(chainId, provider);
+  return provider;
+}
+function normalizeHex(hex) {
+  if (!hex) return "0x";
+  const s = String(hex);
+  const indices = [];
+  const re = /0x/gi;
+  let m;
+  while ((m = re.exec(s)) !== null) {
+    indices.push(m.index);
+  }
+  let best = "";
+  if (indices.length === 0) {
+    best = s.replace(/[^0-9a-fA-F]/g, "");
+  } else {
+    for (let i = 0; i < indices.length; i++) {
+      const start = indices[i] + 2;
+      const end = i + 1 < indices.length ? indices[i + 1] : s.length;
+      const candidate = s.slice(start, end).replace(/[^0-9a-fA-F]/g, "");
+      if (candidate.length > best.length) best = candidate;
+    }
+  }
+  if (!best) return "0x";
+  if (best.length % 2) throw new Error("hex length must be even");
+  return "0x" + best.toLowerCase();
+}
+function toBytes32(addrOrBytes32) {
+  const h = normalizeHex(addrOrBytes32);
+  if (h.length === 42) return ethers.ethers.zeroPadValue(h, 32);
+  if (h.length === 66) return h;
+  throw new Error("expected address(20B) or bytes32(32B)");
+}
+function encodeUint(value, sizeBytes) {
+  const bn = BigInt(value);
+  const max = (1n << BigInt(sizeBytes * 8)) - 1n;
+  if (bn < 0n || bn > max) {
+    throw new Error(`value does not fit uint${sizeBytes * 8}`);
+  }
+  return ethers.ethers.zeroPadValue(ethers.ethers.toBeHex(bn), sizeBytes);
+}
+function buildEndpointV2LzComposePayload(params) {
+  const { nonce, srcEid, amountLD, composeFrom, composeMsg } = params;
+  return ethers.ethers.concat([
+    encodeUint(nonce, 8),
+    encodeUint(srcEid, 4),
+    encodeUint(amountLD, 32),
+    toBytes32(composeFrom),
+    normalizeHex(composeMsg)
+  ]);
+}
+var NATIVE_MSG_FEE_BUFFER = 105n;
+
+exports.NATIVE_MSG_FEE_BUFFER = NATIVE_MSG_FEE_BUFFER;
+exports.buildEndpointV2LzComposePayload = buildEndpointV2LzComposePayload;
+exports.encodeUint = encodeUint;
+exports.evmRpcFallbackProvider = evmRpcFallbackProvider;
+exports.normalizeHex = normalizeHex;
+exports.toBytes32 = toBytes32;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/evm-rpc-providers.ts","../src/layerzero-compose.ts"],"names":["ethers"],"mappings":"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","file":"index.js","sourcesContent":["import { ethers } from \"ethers\";\nimport type { TokenConfig } from \"@stableflow/core\";\n\nconst providerCache = new Map<number, ethers.AbstractProvider>();\n\nclass SequentialFallbackProvider extends ethers.AbstractProvider {\n  private providers: ethers.JsonRpcProvider[];\n\n  constructor(providers: ethers.JsonRpcProvider[], chainId: number) {\n    super(chainId);\n    this.providers = providers;\n  }\n\n  async _detectNetwork(): Promise<ethers.Network> {\n    return this.providers[0]._detectNetwork();\n  }\n\n  async _perform(req: ethers.PerformActionRequest): Promise<any> {\n    let lastError: unknown;\n    for (const provider of this.providers) {\n      try {\n        return await provider._perform(req);\n      } catch (err) {\n        if (ethers.isError(err, \"CALL_EXCEPTION\")) throw err;\n        lastError = err;\n      }\n    }\n    throw lastError;\n  }\n}\n\nexport function evmRpcFallbackProvider(chain: TokenConfig) {\n  const { rpcUrls, chainId } = chain;\n\n  if (providerCache.has(chainId!)) {\n    return providerCache.get(chainId!)!;\n  }\n\n  const providers = rpcUrls.map(\n    (rpc: string) => {\n      return new ethers.JsonRpcProvider(rpc, chainId, { staticNetwork: true });\n    }\n  );\n\n  const provider =\n    providers.length === 1\n      ? providers[0]\n      : new SequentialFallbackProvider(providers, chainId!);\n\n  providerCache.set(chainId!, provider);\n  return provider;\n}\n","import { ethers } from 'ethers';\n\nexport function normalizeHex(hex: string) {\n  if (!hex) return '0x';\n  const s = String(hex);\n\n  const indices = [];\n  const re = /0x/gi;\n  let m;\n  while ((m = re.exec(s)) !== null) {\n    indices.push(m.index);\n  }\n\n  let best = '';\n  if (indices.length === 0) {\n    best = s.replace(/[^0-9a-fA-F]/g, '');\n  } else {\n    for (let i = 0; i < indices.length; i++) {\n      const start = indices[i] + 2;\n      const end = i + 1 < indices.length ? indices[i + 1] : s.length;\n      const candidate = s.slice(start, end).replace(/[^0-9a-fA-F]/g, '');\n      if (candidate.length > best.length) best = candidate;\n    }\n  }\n\n  if (!best) return '0x';\n  if (best.length % 2) throw new Error('hex length must be even');\n  return '0x' + best.toLowerCase();\n}\n\nexport function toBytes32(addrOrBytes32: string) {\n  const h = normalizeHex(addrOrBytes32);\n  if (h.length === 42) return ethers.zeroPadValue(h, 32);\n  if (h.length === 66) return h;\n  throw new Error('expected address(20B) or bytes32(32B)');\n}\n\nexport function encodeUint(value: string, sizeBytes: number) {\n  const bn = BigInt(value);\n  const max = (1n << BigInt(sizeBytes * 8)) - 1n;\n\n  if (bn < 0n || bn > max) {\n    throw new Error(`value does not fit uint${sizeBytes * 8}`);\n  }\n\n  return ethers.zeroPadValue(ethers.toBeHex(bn), sizeBytes);\n}\n\nexport function buildEndpointV2LzComposePayload(params: {\n  nonce: string;\n  srcEid: string;\n  amountLD: string;\n  composeFrom: string;\n  composeMsg: string;\n}) {\n  const { nonce, srcEid, amountLD, composeFrom, composeMsg } = params;\n  return ethers.concat([\n    encodeUint(nonce, 8),\n    encodeUint(srcEid, 4),\n    encodeUint(amountLD, 32),\n    toBytes32(composeFrom),\n    normalizeHex(composeMsg),\n  ]);\n}\n\nexport const NATIVE_MSG_FEE_BUFFER: bigint = 105n;\n"]}

package/dist/index.mjs

@@ -0,0 +1,92 @@
+import { ethers } from 'ethers';
+
+// src/evm-rpc-providers.ts
+var providerCache = /* @__PURE__ */ new Map();
+var SequentialFallbackProvider = class extends ethers.AbstractProvider {
+  constructor(providers, chainId) {
+    super(chainId);
+    this.providers = providers;
+  }
+  async _detectNetwork() {
+    return this.providers[0]._detectNetwork();
+  }
+  async _perform(req) {
+    let lastError;
+    for (const provider of this.providers) {
+      try {
+        return await provider._perform(req);
+      } catch (err) {
+        if (ethers.isError(err, "CALL_EXCEPTION")) throw err;
+        lastError = err;
+      }
+    }
+    throw lastError;
+  }
+};
+function evmRpcFallbackProvider(chain) {
+  const { rpcUrls, chainId } = chain;
+  if (providerCache.has(chainId)) {
+    return providerCache.get(chainId);
+  }
+  const providers = rpcUrls.map(
+    (rpc) => {
+      return new ethers.JsonRpcProvider(rpc, chainId, { staticNetwork: true });
+    }
+  );
+  const provider = providers.length === 1 ? providers[0] : new SequentialFallbackProvider(providers, chainId);
+  providerCache.set(chainId, provider);
+  return provider;
+}
+function normalizeHex(hex) {
+  if (!hex) return "0x";
+  const s = String(hex);
+  const indices = [];
+  const re = /0x/gi;
+  let m;
+  while ((m = re.exec(s)) !== null) {
+    indices.push(m.index);
+  }
+  let best = "";
+  if (indices.length === 0) {
+    best = s.replace(/[^0-9a-fA-F]/g, "");
+  } else {
+    for (let i = 0; i < indices.length; i++) {
+      const start = indices[i] + 2;
+      const end = i + 1 < indices.length ? indices[i + 1] : s.length;
+      const candidate = s.slice(start, end).replace(/[^0-9a-fA-F]/g, "");
+      if (candidate.length > best.length) best = candidate;
+    }
+  }
+  if (!best) return "0x";
+  if (best.length % 2) throw new Error("hex length must be even");
+  return "0x" + best.toLowerCase();
+}
+function toBytes32(addrOrBytes32) {
+  const h = normalizeHex(addrOrBytes32);
+  if (h.length === 42) return ethers.zeroPadValue(h, 32);
+  if (h.length === 66) return h;
+  throw new Error("expected address(20B) or bytes32(32B)");
+}
+function encodeUint(value, sizeBytes) {
+  const bn = BigInt(value);
+  const max = (1n << BigInt(sizeBytes * 8)) - 1n;
+  if (bn < 0n || bn > max) {
+    throw new Error(`value does not fit uint${sizeBytes * 8}`);
+  }
+  return ethers.zeroPadValue(ethers.toBeHex(bn), sizeBytes);
+}
+function buildEndpointV2LzComposePayload(params) {
+  const { nonce, srcEid, amountLD, composeFrom, composeMsg } = params;
+  return ethers.concat([
+    encodeUint(nonce, 8),
+    encodeUint(srcEid, 4),
+    encodeUint(amountLD, 32),
+    toBytes32(composeFrom),
+    normalizeHex(composeMsg)
+  ]);
+}
+var NATIVE_MSG_FEE_BUFFER = 105n;
+
+export { NATIVE_MSG_FEE_BUFFER, buildEndpointV2LzComposePayload, encodeUint, evmRpcFallbackProvider, normalizeHex, toBytes32 };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/evm-rpc-providers.ts","../src/layerzero-compose.ts"],"names":["ethers"],"mappings":"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","file":"index.mjs","sourcesContent":["import { ethers } from \"ethers\";\nimport type { TokenConfig } from \"@stableflow/core\";\n\nconst providerCache = new Map<number, ethers.AbstractProvider>();\n\nclass SequentialFallbackProvider extends ethers.AbstractProvider {\n  private providers: ethers.JsonRpcProvider[];\n\n  constructor(providers: ethers.JsonRpcProvider[], chainId: number) {\n    super(chainId);\n    this.providers = providers;\n  }\n\n  async _detectNetwork(): Promise<ethers.Network> {\n    return this.providers[0]._detectNetwork();\n  }\n\n  async _perform(req: ethers.PerformActionRequest): Promise<any> {\n    let lastError: unknown;\n    for (const provider of this.providers) {\n      try {\n        return await provider._perform(req);\n      } catch (err) {\n        if (ethers.isError(err, \"CALL_EXCEPTION\")) throw err;\n        lastError = err;\n      }\n    }\n    throw lastError;\n  }\n}\n\nexport function evmRpcFallbackProvider(chain: TokenConfig) {\n  const { rpcUrls, chainId } = chain;\n\n  if (providerCache.has(chainId!)) {\n    return providerCache.get(chainId!)!;\n  }\n\n  const providers = rpcUrls.map(\n    (rpc: string) => {\n      return new ethers.JsonRpcProvider(rpc, chainId, { staticNetwork: true });\n    }\n  );\n\n  const provider =\n    providers.length === 1\n      ? providers[0]\n      : new SequentialFallbackProvider(providers, chainId!);\n\n  providerCache.set(chainId!, provider);\n  return provider;\n}\n","import { ethers } from 'ethers';\n\nexport function normalizeHex(hex: string) {\n  if (!hex) return '0x';\n  const s = String(hex);\n\n  const indices = [];\n  const re = /0x/gi;\n  let m;\n  while ((m = re.exec(s)) !== null) {\n    indices.push(m.index);\n  }\n\n  let best = '';\n  if (indices.length === 0) {\n    best = s.replace(/[^0-9a-fA-F]/g, '');\n  } else {\n    for (let i = 0; i < indices.length; i++) {\n      const start = indices[i] + 2;\n      const end = i + 1 < indices.length ? indices[i + 1] : s.length;\n      const candidate = s.slice(start, end).replace(/[^0-9a-fA-F]/g, '');\n      if (candidate.length > best.length) best = candidate;\n    }\n  }\n\n  if (!best) return '0x';\n  if (best.length % 2) throw new Error('hex length must be even');\n  return '0x' + best.toLowerCase();\n}\n\nexport function toBytes32(addrOrBytes32: string) {\n  const h = normalizeHex(addrOrBytes32);\n  if (h.length === 42) return ethers.zeroPadValue(h, 32);\n  if (h.length === 66) return h;\n  throw new Error('expected address(20B) or bytes32(32B)');\n}\n\nexport function encodeUint(value: string, sizeBytes: number) {\n  const bn = BigInt(value);\n  const max = (1n << BigInt(sizeBytes * 8)) - 1n;\n\n  if (bn < 0n || bn > max) {\n    throw new Error(`value does not fit uint${sizeBytes * 8}`);\n  }\n\n  return ethers.zeroPadValue(ethers.toBeHex(bn), sizeBytes);\n}\n\nexport function buildEndpointV2LzComposePayload(params: {\n  nonce: string;\n  srcEid: string;\n  amountLD: string;\n  composeFrom: string;\n  composeMsg: string;\n}) {\n  const { nonce, srcEid, amountLD, composeFrom, composeMsg } = params;\n  return ethers.concat([\n    encodeUint(nonce, 8),\n    encodeUint(srcEid, 4),\n    encodeUint(amountLD, 32),\n    toBytes32(composeFrom),\n    normalizeHex(composeMsg),\n  ]);\n}\n\nexport const NATIVE_MSG_FEE_BUFFER: bigint = 105n;\n"]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@stableflow/utils-evm",
+  "version": "0.0.0-experimental-5a8afd7389-20260703",
+  "description": "EVM utilities for StableFlow SDK (RPC fallback, LayerZero compose)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stableflow-ai/stableflow-sdk.git",
+    "directory": "packages/utils-evm"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "ethers": "^6.16.0",
+    "@stableflow/core": "0.0.0-experimental-5a8afd7389-20260703"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist"
+  }
+}