@epoch-protocol/epoch-commons-sdk 0.2.3 → 2.0.0

package/README.md

@@ -1,20 +1 @@
 # Epoch Commons SDK
-
-### Ethereum and Robinhood mainnet graph
-
-`mainnetGraph` is the canonical source for Ethereum (1) and Robinhood Chain
-(4663) network, token, and protocol relationships. `getGraphChain`,
-`getGraphToken`, and `supportsGraphProtocol` resolve chain ids and validate
-path eligibility without treating a token on one network as available on another.
-
-Native ETH uses the zero-address sentinel and 18 decimals. Generic filler and
-external routes can select ETH; `uniswap-v3` relationships expose WETH instead,
-because that solver currently requires ERC20 input. Ethereum USDG and USDe use
-the issuer addresses documented by [Paxos](https://docs.paxos.com/guides/stablecoin/usdg/mainnet)
-and [Ethena](https://docs.ethena.fi/api-documentation/overview). WBTC uses its
-Ethereum token address and 8 decimals, distinct from the 18-decimal testnet mock.
-
-Protocol router and custom Epoch/Safe address maps retain deployment
-placeholders as requested. A graph relationship describes configured routing
-eligibility; it does not verify deployment or pool liquidity. Replace placeholder
-addresses with verified deployments before executing production operations.

package/dist/constants/contractAddresses.js

@@ -166,13 +166,6 @@ const TESTNET_CONTRACT_ADDRESS_MAPS = [
 for (const addresses of TESTNET_CONTRACT_ADDRESS_MAPS) {
     addresses[46630] = addresses[11155420];
 }
-// Ethereum and Robinhood mainnet deployment placeholders. These preserve the
-// deterministic address configuration used by testnets; replace each entry
-// with its verified mainnet deployment before executing production operations.
-for (const addresses of TESTNET_CONTRACT_ADDRESS_MAPS) {
-    addresses[1] = addresses[11155420];
-    addresses[4663] = addresses[1];
-}
 const CONTRACT_ADDRESSES = {
     METAMASK_EXEC_MANAGER,
     SAFE_PROXY_FACTORY_ADDRESS,

package/dist/data/epochgraphmainnet.json

@@ -5,9 +5,7 @@
                 "Base": "0xMorphoBaseAddress",
                 "Optimism": "0xMorphoOptimismAddress",
                 "Polygon": "0xMorphoPolygonAddress",
-                "Arbitrum": "0xMorphoArbitrumAddress",
-                "Ethereum": "0xrafflesEthereumAddress",
-                "Robinhood": "0xrafflesRobinhoodAddress"
+                "Arbitrum": "0xMorphoArbitrumAddress"
             },
             "type": ["protocol-interaction"]
         },
@@ -17,8 +15,7 @@
                 "Base": "0x1deltaBaseAddress",
                 "Optimism": "0x1deltaOptimismAddress",
                 "Polygon": "0x1deltaPolygonAddress",
-                "Arbitrum": "0x1deltaArbitrumAddress",
-                "Robinhood": "0xOnedeltaRobinhoodAddress"
+                "Arbitrum": "0x1deltaArbitrumAddress"
             },
             "type": ["protocol-interaction"]
         },
@@ -27,9 +24,7 @@
                 "Base": "0xMorphoBaseAddress",
                 "Optimism": "0xMorphoOptimismAddress",
                 "Polygon": "0xMorphoPolygonAddress",
-                "Arbitrum": "0xMorphoArbitrumAddress",
-                "Ethereum": "0xuniswapv3EthereumAddress",
-                "Robinhood": "0xuniswapv3RobinhoodAddress"
+                "Arbitrum": "0xMorphoArbitrumAddress"
             },
             "type": ["swap"]
         },
@@ -56,9 +51,21 @@
                 "*": "*"
             },
             "type": ["swapandbridge"]
+        },
+        "MidenBridge": {
+            "contractAddress": {
+                "*": "*"
+            },
+            "type": ["swapandbridge", "bridge"]
         }
     },
     "tokens": {
+        "USDCX": {
+            "contractAddress": {
+                "Miden": "mm1arnfum9xuwwlrvgvrefejwvlavn3vk24_qr7qqq9wr6w"
+            },
+            "decimals": 6
+        },
         "DAI": {
             "contractAddress": {
                 "Ethereum": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
@@ -86,21 +93,20 @@
                 "Optimism": "0x4200000000000000000000000000000000000006",
                 "Polygon": "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619",
                 "Arbitrum": "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1",
-                "Robinhood": "0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73"
+                "Robinhood": "0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73",
+                "Miden": "mm1apqelr6tlaeftyfj4f7w59dycysmtawe_qr7qqq9wr6w"
             },
             "decimals": 18
         },
         "USDG": {
             "contractAddress": {
-                "Robinhood": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
-                "Ethereum": "0xe343167631d89B6Ffc58B88d6b7fB0228795491D"
+                "Robinhood": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168"
             },
             "decimals": 6
         },
         "USDe": {
             "contractAddress": {
-                "Robinhood": "0x5d3a1Ff2b6BAb83B63cd9AD0787074081a52ef34",
-                "Ethereum": "0x4c9EDD5852cd905f086C759E8383e09bff1E68B3"
+                "Robinhood": "0x5d3a1Ff2b6BAb83B63cd9AD0787074081a52ef34"
             },
             "decimals": 18
         },
@@ -112,30 +118,12 @@
                 "Arbitrum": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9"
             },
             "decimals": 6
-        },
-        "ETH": {
-            "contractAddress": {
-                "Ethereum": "0x0000000000000000000000000000000000000000",
-                "Robinhood": "0x0000000000000000000000000000000000000000"
-            },
-            "decimals": 18
-        },
-        "WBTC": {
-            "contractAddress": {
-                "Ethereum": "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599"
-            },
-            "decimals": 8
         }
     },
     "chains": {
         "Ethereum": {
             "chainId": 1,
-            "explorer": "https://etherscan.io",
-            "nativeCurrency": {
-                "name": "Ether",
-                "symbol": "ETH",
-                "decimals": 18
-            }
+            "explorer": "https://etherscan.io"
         },
         "Base": {
             "chainId": 8453,
@@ -155,12 +143,11 @@
         },
         "Robinhood": {
             "chainId": 4663,
-            "explorer": "https://robinhoodchain.blockscout.com",
-            "nativeCurrency": {
-                "name": "Ether",
-                "symbol": "ETH",
-                "decimals": 18
-            }
+            "explorer": "https://robinhoodchain.blockscout.com"
+        },
+        "Miden": {
+            "chainId": 999999999,
+            "explorer": "https://midenscan.com"
         }
     },
     "relationships": {
@@ -171,21 +158,6 @@
                 },
                 "Optimism": {
                     "tokensInAndOut": ["WETH", "USDC", "DAI", "USDT"]
-                },
-                "Ethereum": {
-                    "tokensInAndOut": [
-                        "DAI",
-                        "USDC",
-                        "WETH",
-                        "USDG",
-                        "USDe",
-                        "USDT",
-                        "ETH",
-                        "WBTC"
-                    ]
-                },
-                "Robinhood": {
-                    "tokensInAndOut": ["WETH", "USDG", "USDe", "ETH"]
                 }
             },
             "uniswap-v3": {
@@ -200,20 +172,6 @@
                 },
                 "Arbitrum": {
                     "tokensInAndOut": ["WETH", "USDC", "DAI", "USDT"]
-                },
-                "Ethereum": {
-                    "tokensInAndOut": [
-                        "DAI",
-                        "USDC",
-                        "WETH",
-                        "USDG",
-                        "USDe",
-                        "USDT",
-                        "WBTC"
-                    ]
-                },
-                "Robinhood": {
-                    "tokensInAndOut": ["WETH", "USDG", "USDe"]
                 }
             },
             "FillerCrossChain": {
@@ -234,51 +192,42 @@
             "1delta": {
                 "*": {
                     "tokensInAndOut": ["*"]
-                },
-                "Ethereum": {
-                    "tokensInAndOut": [
-                        "DAI",
-                        "USDC",
-                        "WETH",
-                        "USDG",
-                        "USDe",
-                        "USDT",
-                        "ETH",
-                        "WBTC"
-                    ]
-                },
-                "Robinhood": {
-                    "tokensInAndOut": ["WETH", "USDG", "USDe", "ETH"]
                 }
             },
             "ExternalSwapBridge": {
                 "*": {
                     "tokensInAndOut": ["*"]
                 }
+            },
+            "MidenBridge": {
+                "*": {
+                    "tokensInAndOut": ["*"]
+                }
             }
         },
         "tokenChains": {
             "DAI": ["Ethereum", "Base", "Optimism", "Polygon", "Arbitrum"],
             "USDC": ["Ethereum", "Base", "Optimism", "Polygon", "Arbitrum"],
+            "USDCX": ["Miden"],
             "WETH": [
                 "Ethereum",
                 "Base",
                 "Optimism",
                 "Polygon",
                 "Arbitrum",
-                "Robinhood"
+                "Robinhood",
+                "Miden"
             ],
-            "USDG": ["Ethereum", "Robinhood"],
+            "USDG": ["Robinhood"],
             "USDT": ["Ethereum", "Optimism", "Polygon", "Arbitrum"],
-            "WBTC": ["Ethereum"],
+            "WBTC": ["Ethereum", "Optimism", "Polygon", "Arbitrum"],
             "wstETH": ["Ethereum", "Base", "Optimism", "Arbitrum"],
             "GHO": ["Ethereum", "Arbitrum", "Base"],
-            "USDe": ["Ethereum", "Robinhood"],
+            "USDe": ["Ethereum", "Arbitrum", "Robinhood"],
             "cbBTC": ["Ethereum", "Base"],
             "PYUSD": ["Ethereum"],
             "LINK": ["Ethereum", "Base", "Optimism", "Polygon", "Arbitrum"],
-            "weETH": ["Ethereum", "Base", "Arbitrum"],
-            "ETH": ["Ethereum", "Robinhood"]
+            "weETH": ["Ethereum", "Base", "Arbitrum"]
         }
     }
 }

package/dist/data/epochgraphtestnet.json

@@ -66,11 +66,17 @@
         }
     },
     "tokens": {
+        "USDCX": {
+            "contractAddress": {
+                "Miden": "0x4cbdcaffe75f0a317482224dae6436"
+            },
+            "decimals": 6
+        },
         "USDC": {
             "contractAddress": {
                 "Base": "0x2BB4FfD7E2c6D432b697554Efd77fA13bdbefd69",
                 "Mainnet": "0x2BB4FfD7E2c6D432b697554Efd77fA13bdbefd69",
-                "Miden": "0x537c15a622074e91188aa894456c52",
+                "Miden": "0x5b043dcb48d5721106f7a1ceb2b804",
                 "Optimism": "0x2BB4FfD7E2c6D432b697554Efd77fA13bdbefd69",
                 "Robinhood": "0x2BB4FfD7E2c6D432b697554Efd77fA13bdbefd69"
             },
@@ -85,7 +91,7 @@
                 "Mainnet": "0xc30f1Ce05d1434d484E9A47283aA925fc8A8699a",
                 "Optimism": "0xc30f1Ce05d1434d484E9A47283aA925fc8A8699a",
                 "Robinhood": "0xc30f1Ce05d1434d484E9A47283aA925fc8A8699a",
-                "Miden": "0xd17976f0809a8191412f2a126625df"
+                "Miden": "0xd41499b8f142ad9119fd9da357a3b2"
             },
             "decimals": 18,
             "decimalsByChain": {
@@ -96,7 +102,7 @@
             "contractAddress": {
                 "Base": "0xc04d2869665Be874881133943523723Be5782720",
                 "Mainnet": "0xc04d2869665Be874881133943523723Be5782720",
-                "Miden": "0x6500ca8c2dd69e9147ab7eafad162c",
+                "Miden": "0x0ead4362a745e7d1790d75ea779611",
                 "Optimism": "0xc04d2869665Be874881133943523723Be5782720",
                 "Robinhood": "0xc04d2869665Be874881133943523723Be5782720"
             },
@@ -111,7 +117,7 @@
                 "Mainnet": "0x7946dd86eE310D0aC16804A37787289Fa5b88A8A",
                 "Optimism": "0x7946dd86eE310D0aC16804A37787289Fa5b88A8A",
                 "Robinhood": "0x7946dd86eE310D0aC16804A37787289Fa5b88A8A",
-                "Miden": "0x4a09f13153d9cd114c078bfb62a7ec"
+                "Miden": "0x9368815c611d5d517914a2c1f0bc8d"
             },
             "decimals": 18,
             "decimalsByChain": {
@@ -124,7 +130,7 @@
                 "Mainnet": "0x9b2a2754a9182fD65360E23afCDf3BeFF51796E9",
                 "Optimism": "0x9b2a2754a9182fD65360E23afCDf3BeFF51796E9",
                 "Robinhood": "0x9b2a2754a9182fD65360E23afCDf3BeFF51796E9",
-                "Miden": "0x5fd2e6fd17712c51404d09c2b847f7"
+                "Miden": "0x1b22d80328f58c5171f67a85f170a3"
             },
             "decimals": 18,
             "decimalsByChain": {
@@ -351,6 +357,7 @@
             }
         },
         "tokenChains": {
+            "USDCX": ["Miden"],
             "DAI": ["Base", "Mainnet", "Optimism", "Robinhood"],
             "USDT": ["Base", "Mainnet", "Optimism", "Robinhood"],
             "USDC": ["Base", "Optimism", "Mainnet", "Miden", "Robinhood"],

package/dist/data/index.d.ts

@@ -1,7 +1,3 @@
-import type { Graph } from "../types/index.js";
-import mainnetGraphData from "./epochgraphmainnet.json";
-import testnetGraphData from "./epochgraphtestnet.json";
-type ConcreteGraph<T> = T & Graph;
-export declare const mainnetGraph: ConcreteGraph<typeof mainnetGraphData>;
-export declare const testnetGraph: ConcreteGraph<typeof testnetGraphData>;
-export {};
+import mainnetGraph from "./epochgraphmainnet.json";
+import testnetGraph from "./epochgraphtestnet.json";
+export { mainnetGraph, testnetGraph };

package/dist/data/index.js

@@ -1,4 +1,3 @@
-import mainnetGraphData from "./epochgraphmainnet.json" with { type: "json" };
-import testnetGraphData from "./epochgraphtestnet.json" with { type: "json" };
-export const mainnetGraph = mainnetGraphData;
-export const testnetGraph = testnetGraphData;
+import mainnetGraph from "./epochgraphmainnet.json" with { type: "json" };
+import testnetGraph from "./epochgraphtestnet.json" with { type: "json" };
+export { mainnetGraph, testnetGraph };

package/dist/types/index.d.ts

@@ -1,6 +1,5 @@
 import { ethers } from "ethers";
 import { Address, WalletClient } from "viem";
-export type { DexPoolPreference, UniswapV3PoolPreference, UniswapV4PoolKey, UniswapV4PoolPreference, } from "../utils/dex-pools.js";
 export type ApiResponse<T> = {
     data: T;
     status: number;
@@ -111,14 +110,8 @@ export type Token = {
 export type Chain = {
     chainId: number;
     explorer: string;
-    nativeCurrency?: {
-        name: string;
-        symbol: string;
-        decimals: number;
-    };
 };
 export type Relationships = {
-    tokenChains?: Record<string, string[]>;
     protocolTokensByChain: {
         [protocolName: string]: {
             [chainName: string]: {
@@ -190,8 +183,6 @@ export type PathItem = {
     };
     calldata?: CalldataReturnInterface;
     fillerData?: FillerTokenData;
-    /** Client-side execution metadata retained when quote-only paths strip calldata. */
-    externalExecution?: ExternalExecutionPlan;
 };
 export type Path = PathItem[][][];
 export interface QuoteReturnInterface {
@@ -214,21 +205,6 @@ export type ExecutionTransaction = {
     value: string;
     callData: string;
 };
-/** LI.FI's source bridge may be followed by an SDK-refreshed destination v4 swap. */
-export type LifiExternalExecutionPlan = {
-    provider: "lifi";
-    sourceChainId: number;
-    externalSolverUrl: string;
-    sourceTransactions: ExecutionTransaction[];
-    submitTransactionIndex: number;
-    requiresSequentialReceipts: true;
-    lifi: {
-        destinationChainId: number;
-        bridgeToken: string;
-    };
-    destinationSwap?: Record<string, unknown>;
-};
-export type ExternalExecutionPlan = LifiExternalExecutionPlan;
 export type IntermediaryApprovals = {
     tokenAddress: string;
     spenderAddress: string;

package/dist/utils/index.d.ts

@@ -1,7 +1,5 @@
 export * from "./compact.js";
-export * from "./dex-pools.js";
-export * from "./external-provider.js";
+export * from "./miden-id.js";
 export * from "./miden-intent.js";
 export * from "./path.js";
 export * from "./witness-typestring.js";
-export * from "./graph.js";

package/dist/utils/index.js

@@ -1,7 +1,5 @@
 export * from "./compact.js";
-export * from "./dex-pools.js";
-export * from "./external-provider.js";
+export * from "./miden-id.js";
 export * from "./miden-intent.js";
 export * from "./path.js";
 export * from "./witness-typestring.js";
-export * from "./graph.js";

package/dist/utils/miden-id.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Convert a Miden account or faucet identifier to canonical 0x-prefixed hex.
+ *
+ * Hex identifiers pass through with their body case preserved. Valid Miden
+ * Bech32/Bech32m addresses (including an optional interface suffix) are decoded.
+ * Invalid non-hex input is returned trimmed so callers can apply their own
+ * validation and surface the original value in error messages.
+ */
+export declare function normalizeMidenId(id: string): string;

package/dist/utils/miden-id.js

@@ -0,0 +1,88 @@
+const BECH32_CHARSET = "qpzry9x8gf2tvdw0s3jn54khce6mua7l";
+const BECH32_CHECKSUM = 1;
+const BECH32M_CHECKSUM = 0x2bc830a3;
+const MIDEN_ACCOUNT_ID_BYTES = 15;
+function bech32Polymod(values) {
+    const generator = [
+        0x3b6a57b2, 0x26508e6d, 0x1ea119fa, 0x3d4233dd, 0x2a1462b3,
+    ];
+    let checksum = 1;
+    for (const value of values) {
+        const top = checksum >>> 25;
+        checksum = ((checksum & 0x1ffffff) << 5) ^ value;
+        for (let index = 0; index < generator.length; index += 1) {
+            if ((top >>> index) & 1)
+                checksum ^= generator[index];
+        }
+    }
+    return checksum >>> 0;
+}
+function bech32HrpExpand(hrp) {
+    const output = [];
+    for (let index = 0; index < hrp.length; index += 1) {
+        output.push(hrp.charCodeAt(index) >> 5);
+    }
+    output.push(0);
+    for (let index = 0; index < hrp.length; index += 1) {
+        output.push(hrp.charCodeAt(index) & 31);
+    }
+    return output;
+}
+function decodeMidenBech32(input) {
+    const address = input.split("_")[0].toLowerCase();
+    const separator = address.lastIndexOf("1");
+    if (separator < 1 || separator + 7 > address.length)
+        return null;
+    const words = [];
+    for (const character of address.slice(separator + 1)) {
+        const value = BECH32_CHARSET.indexOf(character);
+        if (value < 0)
+            return null;
+        words.push(value);
+    }
+    const checksum = bech32Polymod([
+        ...bech32HrpExpand(address.slice(0, separator)),
+        ...words,
+    ]);
+    if (checksum !== BECH32_CHECKSUM && checksum !== BECH32M_CHECKSUM) {
+        return null;
+    }
+    let accumulator = 0;
+    let bits = 0;
+    const bytes = [];
+    for (const word of words.slice(0, -6)) {
+        accumulator = (accumulator << 5) | word;
+        bits += 5;
+        while (bits >= 8) {
+            bits -= 8;
+            bytes.push((accumulator >> bits) & 0xff);
+        }
+    }
+    if (bytes.length < MIDEN_ACCOUNT_ID_BYTES + 1)
+        return null;
+    return ("0x" +
+        bytes
+            .slice(1, 1 + MIDEN_ACCOUNT_ID_BYTES)
+            .map((byte) => byte.toString(16).padStart(2, "0"))
+            .join(""));
+}
+/**
+ * Convert a Miden account or faucet identifier to canonical 0x-prefixed hex.
+ *
+ * Hex identifiers pass through with their body case preserved. Valid Miden
+ * Bech32/Bech32m addresses (including an optional interface suffix) are decoded.
+ * Invalid non-hex input is returned trimmed so callers can apply their own
+ * validation and surface the original value in error messages.
+ */
+export function normalizeMidenId(id) {
+    const raw = (id ?? "").trim();
+    if (!raw)
+        return raw;
+    if (raw.startsWith("0x") || raw.startsWith("0X")) {
+        return "0x" + raw.slice(2);
+    }
+    if (/^[0-9a-fA-F]+$/.test(raw) && raw.length % 2 === 0) {
+        return "0x" + raw;
+    }
+    return decodeMidenBech32(raw) ?? raw;
+}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@epoch-protocol/epoch-commons-sdk",
-  "version": "0.2.3",
+  "version": "2.0.0",
   "description": "SDK for interacting with Epoch Commons Protocol",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
-    "build": "tsc && tsc -p tsconfig.typecheck.json",
+    "build": "tsc",
     "test": "jest",
     "lint": "eslint . --ext .ts",
     "format": "prettier --write \"src/**/*.ts\"",
@@ -24,9 +24,6 @@
   ],
   "author": "",
   "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
   "dependencies": {
     "ethers": "^6.0.0",
     "viem": "2.42.0"

package/dist/constants/chains.d.ts

@@ -1,21 +0,0 @@
-/**
- * Canonical chain ids. Define new ones HERE and import them — `MIDEN_CHAIN_ID`
- * is currently redefined in seven places across the monorepo.
- *
- * Ids MUST fit in uint32: `getEncodedIntent` and the deployed IntentRegistry
- * both declare `uint32[] chainIds`, so anything larger throws at ABI encode
- * time. That rules out Solana's CAIP-2 id (1151111081099710).
- */
-/**
- * Solana mainnet-beta. Leading digits of the CAIP-2 id, so it stays traceable.
- * PROVISIONAL — check chainlist for collisions before mainnet.
- */
-export declare const SOLANA_MAINNET_CHAIN_ID = 1151111;
-/**
- * Solana devnet. Separate id rather than one shared with mainnet, so devnet can
- * pass the testnet-gated checks in dex-solver's candidate-evaluator and mainnet
- * still can't skip them.
- */
-export declare const SOLANA_DEVNET_CHAIN_ID = 1151112;
-/** Graph chain name. Load-bearing: `chains` and `token.contractAddress` key off it. */
-export declare const SOLANA_CHAIN_NAME = "Solana";

package/dist/constants/chains.js

@@ -1,21 +0,0 @@
-/**
- * Canonical chain ids. Define new ones HERE and import them — `MIDEN_CHAIN_ID`
- * is currently redefined in seven places across the monorepo.
- *
- * Ids MUST fit in uint32: `getEncodedIntent` and the deployed IntentRegistry
- * both declare `uint32[] chainIds`, so anything larger throws at ABI encode
- * time. That rules out Solana's CAIP-2 id (1151111081099710).
- */
-/**
- * Solana mainnet-beta. Leading digits of the CAIP-2 id, so it stays traceable.
- * PROVISIONAL — check chainlist for collisions before mainnet.
- */
-export const SOLANA_MAINNET_CHAIN_ID = 1151111;
-/**
- * Solana devnet. Separate id rather than one shared with mainnet, so devnet can
- * pass the testnet-gated checks in dex-solver's candidate-evaluator and mainnet
- * still can't skip them.
- */
-export const SOLANA_DEVNET_CHAIN_ID = 1151112;
-/** Graph chain name. Load-bearing: `chains` and `token.contractAddress` key off it. */
-export const SOLANA_CHAIN_NAME = "Solana";

package/dist/utils/address.d.ts

@@ -1,23 +0,0 @@
-/**
- * Chain-aware address handling. Never call `.toLowerCase()` on an address.
- *
- * Lowercasing is safe for hex (EVM addresses, Miden faucet ids) and destroys
- * base58 (Solana), where `A` and `a` are different characters. The failure is
- * silent — graph lookups still match, because both sides get lowercased — and
- * only surfaces once the value is used as a real address, by which point a
- * solver has been told to deliver there.
- */
-/** Exactly 20-byte `0x` hex — a strict EVM address. */
-export declare function isEvmAddress(value: string): boolean;
-/** Solana's base58 alphabet (no `0`, `O`, `I`, `l`), 32-44 chars = 32-byte pubkey. */
-export declare function isBase58Address(value: string): boolean;
-/** Any identifier the protocol can route: EVM, Miden faucet, or Solana mint. */
-export declare function isTokenIdentifier(value: string): boolean;
-/** Canonical form for lookups and map keys. Hex is lowercased, base58 is not. */
-export declare function normalizeTokenAddress(address: string): string;
-/**
- * Equality that respects each family's case rules. Replaces
- * `a.toLowerCase() === b.toLowerCase()`, which returns true for two base58
- * strings differing only in case — i.e. two different accounts.
- */
-export declare function sameTokenAddress(a?: string | null, b?: string | null): boolean;

package/dist/utils/address.js

@@ -1,39 +0,0 @@
-/**
- * Chain-aware address handling. Never call `.toLowerCase()` on an address.
- *
- * Lowercasing is safe for hex (EVM addresses, Miden faucet ids) and destroys
- * base58 (Solana), where `A` and `a` are different characters. The failure is
- * silent — graph lookups still match, because both sides get lowercased — and
- * only surfaces once the value is used as a real address, by which point a
- * solver has been told to deliver there.
- */
-/** `0x`-prefixed hex of any length: EVM addresses and Miden faucet ids. */
-function isHexIdentifier(value) {
-    return /^0x[a-fA-F0-9]+$/.test(value);
-}
-/** Exactly 20-byte `0x` hex — a strict EVM address. */
-export function isEvmAddress(value) {
-    return /^0x[a-fA-F0-9]{40}$/.test(value);
-}
-/** Solana's base58 alphabet (no `0`, `O`, `I`, `l`), 32-44 chars = 32-byte pubkey. */
-export function isBase58Address(value) {
-    return /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(value);
-}
-/** Any identifier the protocol can route: EVM, Miden faucet, or Solana mint. */
-export function isTokenIdentifier(value) {
-    return isHexIdentifier(value) || isBase58Address(value);
-}
-/** Canonical form for lookups and map keys. Hex is lowercased, base58 is not. */
-export function normalizeTokenAddress(address) {
-    return isHexIdentifier(address) ? address.toLowerCase() : address;
-}
-/**
- * Equality that respects each family's case rules. Replaces
- * `a.toLowerCase() === b.toLowerCase()`, which returns true for two base58
- * strings differing only in case — i.e. two different accounts.
- */
-export function sameTokenAddress(a, b) {
-    if (!a || !b)
-        return false;
-    return normalizeTokenAddress(a) === normalizeTokenAddress(b);
-}

package/dist/utils/chain-kind.d.ts

@@ -1,6 +0,0 @@
-import type { ChainKind, Graph } from "../types/index.js";
-/**
- * `undefined` for an unknown chain — treat that as unsupported, never as EVM.
- * Defaulting to EVM is how a Solana mint ends up in `ethers.getAddress()`.
- */
-export declare function getChainKind(graph: Graph | undefined | null, chainId: number): ChainKind | undefined;

package/dist/utils/chain-kind.js

@@ -1,18 +0,0 @@
-/**
- * `undefined` when the chain is not in the graph. Tolerates a missing or
- * malformed graph rather than throwing — several suites stub the graph module
- * out, and throwing there surfaces as a TypeError far from the cause.
- */
-function findChainById(graph, chainId) {
-    if (!graph?.chains)
-        return undefined;
-    const entry = Object.entries(graph.chains).find(([, chain]) => chain?.chainId === chainId);
-    return entry ? { name: entry[0], chain: entry[1] } : undefined;
-}
-/**
- * `undefined` for an unknown chain — treat that as unsupported, never as EVM.
- * Defaulting to EVM is how a Solana mint ends up in `ethers.getAddress()`.
- */
-export function getChainKind(graph, chainId) {
-    return findChainById(graph, chainId)?.chain.kind;
-}

package/dist/utils/intent-route.d.ts

@@ -1,19 +0,0 @@
-/** Origin and destination are resolved independently and returned as a pair. */
-export type IntentOrigin = "evm" | "miden" | "solana";
-export type IntentDestination = "evm" | "miden" | "solana";
-export interface IntentRoute {
-    origin: IntentOrigin;
-    destination: IntentDestination;
-}
-/** Table-dispatch key, e.g. `"miden->solana"`. */
-export type RouteKey = `${IntentOrigin}->${IntentDestination}`;
-export type IntentRouteResult = {
-    valid: true;
-    route: IntentRoute;
-} | {
-    valid: false;
-    error: string;
-};
-export declare function routeKey(route: IntentRoute): RouteKey;
-/** Resolve from witness markers; callers validate chain-ID consistency. */
-export declare function resolveIntentRoute(data?: Record<string, unknown>): IntentRouteResult;

package/dist/utils/intent-route.js

@@ -1,84 +0,0 @@
-import { MIDEN_RECIPIENT_ACCOUNT_FIELD_NAME, MIDEN_SOURCE_ACCOUNT_FIELD_NAME, SOLANA_MINT_FIELD_NAME, SOLANA_RECIPIENT_ACCOUNT_FIELD_NAME, SOLANA_SOURCE_ACCOUNT_FIELD_NAME, SOLANA_SOURCE_MINT_FIELD_NAME, } from "./witness-typestring.js";
-function hasTruthyField(data, fieldName) {
-    if (!data)
-        return false;
-    const value = data[fieldName];
-    return typeof value === "string" && value.trim() !== "";
-}
-export function routeKey(route) {
-    return `${route.origin}->${route.destination}`;
-}
-/** Resolve from witness markers; callers validate chain-ID consistency. */
-export function resolveIntentRoute(data) {
-    for (const fieldName of [
-        MIDEN_SOURCE_ACCOUNT_FIELD_NAME,
-        MIDEN_RECIPIENT_ACCOUNT_FIELD_NAME,
-        SOLANA_RECIPIENT_ACCOUNT_FIELD_NAME,
-        SOLANA_MINT_FIELD_NAME,
-        SOLANA_SOURCE_ACCOUNT_FIELD_NAME,
-        SOLANA_SOURCE_MINT_FIELD_NAME,
-    ]) {
-        const value = data?.[fieldName];
-        if (value !== undefined &&
-            value !== null &&
-            (typeof value !== "string" || value.trim() === "")) {
-            return {
-                valid: false,
-                error: `Intent route marker "${fieldName}" must be a non-empty string`,
-            };
-        }
-    }
-    const hasMidenSource = hasTruthyField(data, MIDEN_SOURCE_ACCOUNT_FIELD_NAME);
-    const hasMidenRecipient = hasTruthyField(data, MIDEN_RECIPIENT_ACCOUNT_FIELD_NAME);
-    const hasSolanaRecipient = hasTruthyField(data, SOLANA_RECIPIENT_ACCOUNT_FIELD_NAME);
-    const hasSolanaMint = hasTruthyField(data, SOLANA_MINT_FIELD_NAME);
-    const hasSolanaSource = hasTruthyField(data, SOLANA_SOURCE_ACCOUNT_FIELD_NAME);
-    const hasSolanaSourceMint = hasTruthyField(data, SOLANA_SOURCE_MINT_FIELD_NAME);
-    if (hasMidenSource && hasMidenRecipient) {
-        return {
-            valid: false,
-            error: "Intent cannot include both midenSourceAccount and midenRecipientAccount",
-        };
-    }
-    if (hasSolanaRecipient !== hasSolanaMint) {
-        return {
-            valid: false,
-            error: "Solana intent must carry both solanaRecipientAccount and solanaMint",
-        };
-    }
-    if (hasSolanaSource !== hasSolanaSourceMint) {
-        return {
-            valid: false,
-            error: "Solana-origin intent must carry both solanaSourceAccount and solanaSourceMint",
-        };
-    }
-    if (hasMidenSource && hasSolanaSource) {
-        return {
-            valid: false,
-            error: "Intent declares two origins (midenSourceAccount and solanaSourceAccount)",
-        };
-    }
-    if (hasSolanaSource && hasSolanaRecipient) {
-        return {
-            valid: false,
-            error: "Solana→Solana intents are not supported",
-        };
-    }
-    if (hasMidenRecipient && hasSolanaRecipient) {
-        return {
-            valid: false,
-            error: "Intent declares two destinations (midenRecipientAccount and solanaRecipientAccount)",
-        };
-    }
-    const origin = hasMidenSource
-        ? "miden"
-        : hasSolanaSource
-            ? "solana"
-            : "evm";
-    const destination = hasSolanaRecipient
-        ? "solana"
-        : hasMidenRecipient
-            ? "miden"
-            : "evm";
-    return { valid: true, route: { origin, destination } };
-}

package/dist/utils/solana-intent.d.ts

@@ -1,31 +0,0 @@
-import { EVM_TO_SOLANA_EXTRA_TYPESTRING, EVM_TO_SOLANA_FIELD_NAMES, SOLANA_MARKER_FIELD_NAMES, SOLANA_TO_EVM_EXTRA_TYPESTRING } from "./witness-typestring.js";
-/** Detect Solana markers by exact field name in typestrings or mandate data. */
-export interface SolanaExtraData {
-    /** Base58 account that receives the payout. Case-significant. */
-    solanaRecipientAccount?: string;
-    /** Base58 SPL mint being delivered. Case-significant. */
-    solanaMint?: string;
-}
-/** Solana-origin collateral: where the escrow deposit came from. */
-export interface SolanaSourceData {
-    /** Base58 account that opened the escrow. Seeds its PDA. Case-significant. */
-    solanaSourceAccount: string;
-    /** Base58 SPL mint locked in the escrow. Case-significant. */
-    solanaSourceMint: string;
-    /** Nonce bound into the escrow PDA, preserved in its input representation. */
-    intentNonce: string | number | bigint;
-}
-/**
- * True iff the intent is a Solana bridge intent.
- * At least one of `typestring` or `data` must be provided.
- */
-export declare function isSolanaIntent(typestring?: string, data?: Record<string, unknown>): boolean;
-/** True when both Solana destination identifiers are present. */
-export declare function isEVMToSolanaIntent(data?: Record<string, unknown>): boolean;
-/** True when both Solana source identifiers are present. */
-export declare function isSolanaToEVMIntent(data?: Record<string, unknown>): boolean;
-/** Extract complete Solana source metadata or return `null`. */
-export declare function getSolanaSourceMetadata(data?: Record<string, unknown>): SolanaSourceData | null;
-/** Extract Solana identifiers, or `null` when this is not a Solana intent. */
-export declare function getSolanaMetadata(data?: Record<string, unknown>, typestring?: string): SolanaExtraData | null;
-export { EVM_TO_SOLANA_EXTRA_TYPESTRING, EVM_TO_SOLANA_FIELD_NAMES, SOLANA_MARKER_FIELD_NAMES, SOLANA_TO_EVM_EXTRA_TYPESTRING, };

package/dist/utils/solana-intent.js

@@ -1,75 +0,0 @@
-import { EVM_TO_SOLANA_EXTRA_TYPESTRING, EVM_TO_SOLANA_FIELD_NAMES, SOLANA_MARKER_FIELD_NAMES, SOLANA_MINT_FIELD_NAME, SOLANA_RECIPIENT_ACCOUNT_FIELD_NAME, SOLANA_SOURCE_ACCOUNT_FIELD_NAME, SOLANA_SOURCE_MINT_FIELD_NAME, SOLANA_SOURCE_NONCE_FIELD_NAME, SOLANA_TO_EVM_EXTRA_TYPESTRING, fieldNamesFromExtraTypestring, } from "./witness-typestring.js";
-import { isUint256Value } from "./value-validation.js";
-function hasTruthyField(data, fieldName) {
-    if (!data)
-        return false;
-    const value = data[fieldName];
-    return typeof value === "string" && value.trim() !== "";
-}
-/** True when a typestring DECLARES a field with exactly this name. */
-function declaresField(typestring, fieldName) {
-    if (!typestring.trim())
-        return false;
-    try {
-        return fieldNamesFromExtraTypestring(typestring).includes(fieldName);
-    }
-    catch {
-        // Malformed typestring declares nothing. The caller's own typestring
-        // validation is responsible for rejecting it.
-        return false;
-    }
-}
-/** True when mandate/extra data carries any Solana bridge marker field. */
-function hasSolanaMarkersInData(data) {
-    return SOLANA_MARKER_FIELD_NAMES.some((name) => hasTruthyField(data, name));
-}
-/** True when a witness/extra typestring declares any Solana bridge marker field. */
-function hasSolanaMarkersInTypestring(typestring) {
-    return SOLANA_MARKER_FIELD_NAMES.some((name) => declaresField(typestring, name));
-}
-/**
- * True iff the intent is a Solana bridge intent.
- * At least one of `typestring` or `data` must be provided.
- */
-export function isSolanaIntent(typestring, data) {
-    const hasTypestring = typestring !== undefined && typestring.trim() !== "";
-    const hasData = data !== undefined;
-    if (!hasTypestring && !hasData) {
-        throw new Error("isSolanaIntent requires typestring and/or data");
-    }
-    return ((hasTypestring && hasSolanaMarkersInTypestring(typestring)) ||
-        hasSolanaMarkersInData(data));
-}
-/** True when both Solana destination identifiers are present. */
-export function isEVMToSolanaIntent(data) {
-    return (hasTruthyField(data, SOLANA_RECIPIENT_ACCOUNT_FIELD_NAME) &&
-        hasTruthyField(data, SOLANA_MINT_FIELD_NAME));
-}
-/** True when both Solana source identifiers are present. */
-export function isSolanaToEVMIntent(data) {
-    return (hasTruthyField(data, SOLANA_SOURCE_ACCOUNT_FIELD_NAME) &&
-        hasTruthyField(data, SOLANA_SOURCE_MINT_FIELD_NAME));
-}
-/** Extract complete Solana source metadata or return `null`. */
-export function getSolanaSourceMetadata(data) {
-    if (!isSolanaToEVMIntent(data))
-        return null;
-    const intentNonce = data?.[SOLANA_SOURCE_NONCE_FIELD_NAME];
-    if (!isUint256Value(intentNonce))
-        return null;
-    return {
-        solanaSourceAccount: data[SOLANA_SOURCE_ACCOUNT_FIELD_NAME],
-        solanaSourceMint: data[SOLANA_SOURCE_MINT_FIELD_NAME],
-        intentNonce: intentNonce,
-    };
-}
-/** Extract Solana identifiers, or `null` when this is not a Solana intent. */
-export function getSolanaMetadata(data, typestring) {
-    if (!data || !isSolanaIntent(typestring, data))
-        return null;
-    return {
-        solanaRecipientAccount: data[SOLANA_RECIPIENT_ACCOUNT_FIELD_NAME],
-        solanaMint: data[SOLANA_MINT_FIELD_NAME],
-    };
-}
-export { EVM_TO_SOLANA_EXTRA_TYPESTRING, EVM_TO_SOLANA_FIELD_NAMES, SOLANA_MARKER_FIELD_NAMES, SOLANA_TO_EVM_EXTRA_TYPESTRING, };

package/dist/utils/value-validation.d.ts

@@ -1 +0,0 @@
-export declare function isUint256Value(value: unknown): value is string | number | bigint;

package/dist/utils/value-validation.js

@@ -1,18 +0,0 @@
-export function isUint256Value(value) {
-    if (typeof value !== "string" &&
-        typeof value !== "number" &&
-        typeof value !== "bigint") {
-        return false;
-    }
-    if (typeof value === "string" && value.trim() === "")
-        return false;
-    if (typeof value === "number" && !Number.isSafeInteger(value))
-        return false;
-    try {
-        const parsed = BigInt(value);
-        return parsed >= 0n && parsed < 1n << 256n;
-    }
-    catch {
-        return false;
-    }
-}