@epoch-protocol/epoch-commons-sdk 0.1.19 → 0.1.21-mainnet.0

package/dist/constants/contractAddresses.js

@@ -97,10 +97,13 @@ export const ARBITER_ADDRESS = {
     10: "0x9f1de3ca45b09c61792a6f649ae68f420aa8a43b",
     42161: "0x9f1de3ca45b09c61792a6f649ae68f420aa8a43b",
     8453: "0x9f1de3ca45b09c61792a6f649ae68f420aa8a43b",
+    // Robinhood placeholders — replace after deployment.
+    4663: "0x9f1de3ca45b09c61792a6f649ae68f420aa8a43b",
     // Testnets
     11155111: "0x2F5eA866716A04e91a55099620F2e1B423eC7011",
     84532: "0x2F5eA866716A04e91a55099620F2e1B423eC7011",
     11155420: "0x2F5eA866716A04e91a55099620F2e1B423eC7011",
+    46630: "0x2F5eA866716A04e91a55099620F2e1B423eC7011",
     123456789: "0x9f1de3ca45b09c61792a6f649ae68f420aa8a43b",
     999999999: "0x9f1de3ca45b09c61792a6f649ae68f420aa8a43b",
 };
@@ -111,10 +114,13 @@ export const ALLOCATOR_ADDRESS = {
     10: "0x444E8C0fC85BB47aBD3E97d00E2E2B0719034769",
     42161: "0x444E8C0fC85BB47aBD3E97d00E2E2B0719034769",
     8453: "0x444E8C0fC85BB47aBD3E97d00E2E2B0719034769",
+    // Robinhood placeholders — replace after deployment.
+    4663: "0x444E8C0fC85BB47aBD3E97d00E2E2B0719034769",
     // Testnets
     11155111: "0xa46827635A7d329608085401a3b2Bf14a8a2bDF9",
     84532: "0xa46827635A7d329608085401a3b2Bf14a8a2bDF9",
     11155420: "0xa46827635A7d329608085401a3b2Bf14a8a2bDF9",
+    46630: "0xa46827635A7d329608085401a3b2Bf14a8a2bDF9",
     123456789: "0x444E8C0fC85BB47aBD3E97d00E2E2B0719034769",
     999999999: "0x444E8C0fC85BB47aBD3E97d00E2E2B0719034769",
 };
@@ -134,6 +140,32 @@ export function getArbiterAddress(chainId) {
     }
     return address;
 }
+// The Robinhood Testnet deployment uses the same deterministic/testnet
+// addresses as the existing Epoch testnet configuration. Populate every
+// shared contract map together so any consumer consulting one of these maps
+// cannot silently treat 46630 as unsupported.
+const TESTNET_CONTRACT_ADDRESS_MAPS = [
+    INTENT_REGISTRY_ADDRESS,
+    EPOCH_MODULE_SAFE_ADDRESS,
+    EPOCH_SAFE_INIT_SETUP,
+    SAFE_INIT_SETUP_FORWARDER,
+    SAFE_WEBAUTHN_SHARED_SIGNER,
+    SAFE_WEBAUTHN_SIGNER_FACTORY,
+    FCLP256Verifier,
+    SAFE_PROXY_FACTORY_ADDRESS,
+    SAFE_SINGLETON_ADDRESS,
+    SAFE_7702_SINGLETON_ADDRESS,
+    SAFE_7579_MODULE_ADDRESS,
+    SAFE_7579_REGISTRY_ADDRESS,
+    EIP7702_SAFE_PROXY_ADDRESS,
+    METAMASK_EXEC_MANAGER,
+    EPOCH_ESCROW_ADDRESS,
+    SAFE_MULTISEND_ADDRESS,
+    SAFE_MULTISEND_CALL_ONLY_ADDRESS,
+];
+for (const addresses of TESTNET_CONTRACT_ADDRESS_MAPS) {
+    addresses[46630] = addresses[11155420];
+}
 const CONTRACT_ADDRESSES = {
     METAMASK_EXEC_MANAGER,
     SAFE_PROXY_FACTORY_ADDRESS,

package/dist/constants/dummyLending.d.ts

@@ -7,7 +7,7 @@ export declare const DUMMY_LENDING_PROTOCOL: "dummy-lending";
 export declare const DUMMY_LENDING_MARKET_ADDRESS = "0xa73c1ae0e4e9116020dba0a419f91585d73459ee";
 /** CREATE2 staking contract — same on all dummy-staking testnets. */
 export declare const DUMMY_STAKING_CONTRACT_ADDRESS = "0xA25A981bc027E1f13aC70882a323B8B8EE880B9C";
-export declare const DUMMY_LENDING_CHAIN_IDS: readonly [84532, 11155111, 11155420];
+export declare const DUMMY_LENDING_CHAIN_IDS: readonly [84532, 11155111, 11155420, 46630];
 export type DummyLendingChainId = (typeof DUMMY_LENDING_CHAIN_IDS)[number];
 /** Unified CREATE2 token addresses — same on every dummy-lending chain. */
 export declare const DUMMY_LENDING_TOKENS: {

package/dist/constants/dummyLending.js

@@ -11,6 +11,7 @@ export const DUMMY_LENDING_CHAIN_IDS = [
     84532, // Base Sepolia
     11155111, // Ethereum Sepolia
     11155420, // Optimism Sepolia
+    46630, // Robinhood Testnet
 ];
 /** Unified CREATE2 token addresses — same on every dummy-lending chain. */
 export const DUMMY_LENDING_TOKENS = {

package/dist/data/epochgraphmainnet.json

@@ -51,9 +51,41 @@
                 "*": "*"
             },
             "type": ["swapandbridge"]
+        },
+        "MidenBridge": {
+            "contractAddress": {
+                "*": "*"
+            },
+            "type": ["swapandbridge", "bridge"]
+        }
+    },
+    "oracles": {
+        "PragmaMidenV1": {
+            "chain": "Miden",
+            "oracleAccount": "0x8f8d747477ca171144feadc60a1137",
+            "rpcUrl": "https://rpc.cedar.miden.io",
+            "method": "get_median",
+            "defaultMaxAgeSeconds": 120,
+            "minimumPublishers": 1,
+            "feeds": {
+                "USDC/USD": {
+                    "key": "0x1dfbb6c4acb913805c4df6731bfe7bfb8b6acd999bb768feb24979170807ee51",
+                    "expectedDecimals": 6
+                },
+                "ETH/USD": {
+                    "key": "0x9a50f4137c634e0b384a87bea3a186e578e21274af6ae752230ead4631233e1d",
+                    "expectedDecimals": 8
+                }
+            }
         }
     },
     "tokens": {
+        "USDCX": {
+            "contractAddress": {
+                "Miden": "mm1arnfum9xuwwlrvgvrefejwvlavn3vk24_qr7qqq9wr6w"
+            },
+            "decimals": 6
+        },
         "DAI": {
             "contractAddress": {
                 "Ethereum": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
@@ -80,7 +112,21 @@
                 "Base": "0x4200000000000000000000000000000000000006",
                 "Optimism": "0x4200000000000000000000000000000000000006",
                 "Polygon": "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619",
-                "Arbitrum": "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1"
+                "Arbitrum": "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1",
+                "Robinhood": "0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73",
+                "Miden": "mm1apqelr6tlaeftyfj4f7w59dycysmtawe_qr7qqq9wr6w"
+            },
+            "decimals": 18
+        },
+        "USDG": {
+            "contractAddress": {
+                "Robinhood": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168"
+            },
+            "decimals": 6
+        },
+        "USDe": {
+            "contractAddress": {
+                "Robinhood": "0x5d3a1Ff2b6BAb83B63cd9AD0787074081a52ef34"
             },
             "decimals": 18
         },
@@ -114,6 +160,14 @@
         "Arbitrum": {
             "chainId": 42161,
             "explorer": "https://arbiscan.io"
+        },
+        "Robinhood": {
+            "chainId": 4663,
+            "explorer": "https://robinhoodchain.blockscout.com"
+        },
+        "Miden": {
+            "chainId": 999999999,
+            "explorer": "https://midenscan.com"
         }
     },
     "relationships": {
@@ -164,17 +218,32 @@
                 "*": {
                     "tokensInAndOut": ["*"]
                 }
+            },
+            "MidenBridge": {
+                "*": {
+                    "tokensInAndOut": ["*"]
+                }
             }
         },
         "tokenChains": {
             "DAI": ["Ethereum", "Base", "Optimism", "Polygon", "Arbitrum"],
             "USDC": ["Ethereum", "Base", "Optimism", "Polygon", "Arbitrum"],
-            "WETH": ["Ethereum", "Base", "Optimism", "Polygon", "Arbitrum"],
+            "USDCX": ["Miden"],
+            "WETH": [
+                "Ethereum",
+                "Base",
+                "Optimism",
+                "Polygon",
+                "Arbitrum",
+                "Robinhood",
+                "Miden"
+            ],
+            "USDG": ["Robinhood"],
             "USDT": ["Ethereum", "Optimism", "Polygon", "Arbitrum"],
             "WBTC": ["Ethereum", "Optimism", "Polygon", "Arbitrum"],
             "wstETH": ["Ethereum", "Base", "Optimism", "Arbitrum"],
             "GHO": ["Ethereum", "Arbitrum", "Base"],
-            "USDe": ["Ethereum", "Arbitrum"],
+            "USDe": ["Ethereum", "Arbitrum", "Robinhood"],
             "cbBTC": ["Ethereum", "Base"],
             "PYUSD": ["Ethereum"],
             "LINK": ["Ethereum", "Base", "Optimism", "Polygon", "Arbitrum"],

package/dist/data/epochgraphtestnet.json

@@ -66,12 +66,19 @@
         }
     },
     "tokens": {
+        "USDCX": {
+            "contractAddress": {
+                "Miden": "0x4cbdcaffe75f0a317482224dae6436"
+            },
+            "decimals": 6
+        },
         "USDC": {
             "contractAddress": {
                 "Base": "0x2BB4FfD7E2c6D432b697554Efd77fA13bdbefd69",
                 "Mainnet": "0x2BB4FfD7E2c6D432b697554Efd77fA13bdbefd69",
-                "Miden": "0xfc90f0f4da30e51168453b60eafed7",
-                "Optimism": "0x2BB4FfD7E2c6D432b697554Efd77fA13bdbefd69"
+                "Miden": "0x5b043dcb48d5721106f7a1ceb2b804",
+                "Optimism": "0x2BB4FfD7E2c6D432b697554Efd77fA13bdbefd69",
+                "Robinhood": "0x2BB4FfD7E2c6D432b697554Efd77fA13bdbefd69"
             },
             "decimals": 18,
             "decimalsByChain": {
@@ -83,7 +90,8 @@
                 "Base": "0xc30f1Ce05d1434d484E9A47283aA925fc8A8699a",
                 "Mainnet": "0xc30f1Ce05d1434d484E9A47283aA925fc8A8699a",
                 "Optimism": "0xc30f1Ce05d1434d484E9A47283aA925fc8A8699a",
-                "Miden": "0x176275876f2fd41103257e341832b9"
+                "Robinhood": "0xc30f1Ce05d1434d484E9A47283aA925fc8A8699a",
+                "Miden": "0xd41499b8f142ad9119fd9da357a3b2"
             },
             "decimals": 18,
             "decimalsByChain": {
@@ -94,8 +102,9 @@
             "contractAddress": {
                 "Base": "0xc04d2869665Be874881133943523723Be5782720",
                 "Mainnet": "0xc04d2869665Be874881133943523723Be5782720",
-                "Miden": "0x7725b0e9bb9406912d2ebeaeb05f4d",
-                "Optimism": "0xc04d2869665Be874881133943523723Be5782720"
+                "Miden": "0x0ead4362a745e7d1790d75ea779611",
+                "Optimism": "0xc04d2869665Be874881133943523723Be5782720",
+                "Robinhood": "0xc04d2869665Be874881133943523723Be5782720"
             },
             "decimals": 18,
             "decimalsByChain": {
@@ -107,7 +116,8 @@
                 "Base": "0x7946dd86eE310D0aC16804A37787289Fa5b88A8A",
                 "Mainnet": "0x7946dd86eE310D0aC16804A37787289Fa5b88A8A",
                 "Optimism": "0x7946dd86eE310D0aC16804A37787289Fa5b88A8A",
-                "Miden": "0xa54717f6bd3210d128aeeaa8a2b7f3"
+                "Robinhood": "0x7946dd86eE310D0aC16804A37787289Fa5b88A8A",
+                "Miden": "0x9368815c611d5d517914a2c1f0bc8d"
             },
             "decimals": 18,
             "decimalsByChain": {
@@ -119,7 +129,8 @@
                 "Base": "0x9b2a2754a9182fD65360E23afCDf3BeFF51796E9",
                 "Mainnet": "0x9b2a2754a9182fD65360E23afCDf3BeFF51796E9",
                 "Optimism": "0x9b2a2754a9182fD65360E23afCDf3BeFF51796E9",
-                "Miden": "0x151823cde4b7bd91352617729d7614"
+                "Robinhood": "0x9b2a2754a9182fD65360E23afCDf3BeFF51796E9",
+                "Miden": "0x1b22d80328f58c5171f67a85f170a3"
             },
             "decimals": 18,
             "decimalsByChain": {
@@ -130,7 +141,8 @@
             "contractAddress": {
                 "Base": "0xEA7dC9849206Ce73b11c465d37b85eC06B11Cf2C",
                 "Mainnet": "0xEA7dC9849206Ce73b11c465d37b85eC06B11Cf2C",
-                "Optimism": "0xEA7dC9849206Ce73b11c465d37b85eC06B11Cf2C"
+                "Optimism": "0xEA7dC9849206Ce73b11c465d37b85eC06B11Cf2C",
+                "Robinhood": "0xEA7dC9849206Ce73b11c465d37b85eC06B11Cf2C"
             },
             "decimals": 18
         },
@@ -138,7 +150,8 @@
             "contractAddress": {
                 "Base": "0xB588418c0f90F07Bc9587d0050845a90C23C7502",
                 "Mainnet": "0xB588418c0f90F07Bc9587d0050845a90C23C7502",
-                "Optimism": "0xB588418c0f90F07Bc9587d0050845a90C23C7502"
+                "Optimism": "0xB588418c0f90F07Bc9587d0050845a90C23C7502",
+                "Robinhood": "0xB588418c0f90F07Bc9587d0050845a90C23C7502"
             },
             "decimals": 18
         },
@@ -146,7 +159,8 @@
             "contractAddress": {
                 "Base": "0x512Ee6Bd7A4be5Ba4796F15Df080c4D0F89a38eD",
                 "Mainnet": "0x512Ee6Bd7A4be5Ba4796F15Df080c4D0F89a38eD",
-                "Optimism": "0x512Ee6Bd7A4be5Ba4796F15Df080c4D0F89a38eD"
+                "Optimism": "0x512Ee6Bd7A4be5Ba4796F15Df080c4D0F89a38eD",
+                "Robinhood": "0x512Ee6Bd7A4be5Ba4796F15Df080c4D0F89a38eD"
             },
             "decimals": 18
         },
@@ -154,7 +168,8 @@
             "contractAddress": {
                 "Base": "0x145e03A80c19ad1b9d0429d06b6d52707de724A0",
                 "Mainnet": "0x145e03A80c19ad1b9d0429d06b6d52707de724A0",
-                "Optimism": "0x145e03A80c19ad1b9d0429d06b6d52707de724A0"
+                "Optimism": "0x145e03A80c19ad1b9d0429d06b6d52707de724A0",
+                "Robinhood": "0x145e03A80c19ad1b9d0429d06b6d52707de724A0"
             },
             "decimals": 18
         }
@@ -175,6 +190,10 @@
         "Optimism": {
             "chainId": 11155420,
             "explorer": "https://sepolia-optimistic.etherscan.io/"
+        },
+        "Robinhood": {
+            "chainId": 46630,
+            "explorer": "https://explorer.testnet.chain.robinhood.com"
         }
     },
     "relationships": {
@@ -338,15 +357,16 @@
             }
         },
         "tokenChains": {
-            "DAI": ["Base", "Mainnet", "Optimism"],
-            "USDT": ["Base", "Mainnet", "Optimism"],
-            "USDC": ["Base", "Optimism", "Mainnet", "Miden"],
-            "WETH": ["Base", "Mainnet", "Optimism"],
-            "WBTC": ["Base", "Mainnet", "Optimism"],
-            "PENGU": ["Base", "Mainnet", "Optimism"],
-            "OSWALD": ["Base", "Mainnet", "Optimism"],
-            "KICK": ["Base", "Mainnet", "Optimism"],
-            "FERB": ["Base", "Mainnet", "Optimism"]
+            "USDCX": ["Miden"],
+            "DAI": ["Base", "Mainnet", "Optimism", "Robinhood"],
+            "USDT": ["Base", "Mainnet", "Optimism", "Robinhood"],
+            "USDC": ["Base", "Optimism", "Mainnet", "Miden", "Robinhood"],
+            "WETH": ["Base", "Mainnet", "Optimism", "Robinhood"],
+            "WBTC": ["Base", "Mainnet", "Optimism", "Robinhood"],
+            "PENGU": ["Base", "Mainnet", "Optimism", "Robinhood"],
+            "OSWALD": ["Base", "Mainnet", "Optimism", "Robinhood"],
+            "KICK": ["Base", "Mainnet", "Optimism", "Robinhood"],
+            "FERB": ["Base", "Mainnet", "Optimism", "Robinhood"]
         }
     }
 }

package/dist/types/index.d.ts

@@ -279,6 +279,11 @@ export type QueuedTransactionForIntent = {
     transactionHash: string | null;
     /** EIP-7702 authorization list for relay txs (enable delegation). */
     authorizationList?: Record<string, unknown>[];
+    /**
+     * Compact / Miden reservation keys so the queue worker can finalize those
+     * reservations on SUCCESS or FAILED.
+     */
+    processedCompactKeys?: string[];
 };
 export type CompactDataForQueue = {
     intentNonce: string;

package/dist/utils/dex-pools.d.ts

@@ -0,0 +1,24 @@
+import type { Hex } from "viem";
+export declare const DEX_POOLS_EXTRA_TYPESTRING = "string dexPools";
+export declare const MAX_DEX_POOL_PREFERENCES = 16;
+export type UniswapV3PoolPreference = {
+    protocol: "uniswap-v3";
+    chainId: number;
+    address: Hex;
+};
+export type UniswapV4PoolKey = {
+    currency0: Hex;
+    currency1: Hex;
+    fee: number;
+    tickSpacing: number;
+    hooks: Hex;
+};
+export type UniswapV4PoolPreference = {
+    protocol: "uniswap-v4";
+    chainId: number;
+    poolKey: UniswapV4PoolKey;
+    hookData?: Hex;
+};
+export type DexPoolPreference = UniswapV3PoolPreference | UniswapV4PoolPreference;
+export declare function decodeDexPools(value: unknown): DexPoolPreference[];
+export declare function encodeDexPools(pools: readonly DexPoolPreference[]): string;

package/dist/utils/dex-pools.js

@@ -0,0 +1,94 @@
+export const DEX_POOLS_EXTRA_TYPESTRING = "string dexPools";
+export const MAX_DEX_POOL_PREFERENCES = 16;
+const DYNAMIC_FEE_FLAG = 0x800000;
+function invalid(message) {
+    throw new Error(`Invalid dexPools: ${message}`);
+}
+function isHex(value) {
+    return typeof value === "string" && /^0x(?:[0-9a-fA-F]{2})*$/.test(value);
+}
+function address(value, field, allowZero = false) {
+    if (typeof value !== "string" ||
+        !/^0x[0-9a-fA-F]{40}$/.test(value) ||
+        (!allowZero && /^0x0{40}$/i.test(value))) {
+        return invalid(`${field} must be a non-zero address`);
+    }
+    return value.toLowerCase();
+}
+function integer(value, field, minimum, maximum) {
+    if (typeof value !== "number" ||
+        !Number.isSafeInteger(value) ||
+        value < minimum ||
+        value > maximum) {
+        return invalid(`${field} must be an integer between ${minimum} and ${maximum}`);
+    }
+    return value;
+}
+function decodeEntry(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return invalid("each entry must be an object");
+    }
+    const entry = value;
+    const chainId = integer(entry.chainId, "chainId", 1, Number.MAX_SAFE_INTEGER);
+    if (entry.protocol === "uniswap-v3") {
+        return {
+            protocol: "uniswap-v3",
+            chainId,
+            address: address(entry.address, "address"),
+        };
+    }
+    if (entry.protocol !== "uniswap-v4") {
+        return invalid("protocol must be uniswap-v3 or uniswap-v4");
+    }
+    if (!entry.poolKey ||
+        typeof entry.poolKey !== "object" ||
+        Array.isArray(entry.poolKey)) {
+        return invalid("poolKey must be an object");
+    }
+    const key = entry.poolKey;
+    const currency0 = address(key.currency0, "poolKey.currency0", true);
+    const currency1 = address(key.currency1, "poolKey.currency1");
+    if (currency0 >= currency1) {
+        return invalid("poolKey.currency0 must sort before poolKey.currency1");
+    }
+    const fee = integer(key.fee, "poolKey.fee", 0, 0xffffff);
+    if (fee > 1_000_000 && fee !== DYNAMIC_FEE_FLAG) {
+        return invalid("poolKey.fee is outside the v4 fee range");
+    }
+    const tickSpacing = integer(key.tickSpacing, "poolKey.tickSpacing", 1, 32767);
+    const hooks = address(key.hooks, "poolKey.hooks", true);
+    const hookData = entry.hookData === undefined ? "0x" : entry.hookData;
+    if (!isHex(hookData))
+        return invalid("hookData must be even-length hex");
+    return {
+        protocol: "uniswap-v4",
+        chainId,
+        poolKey: { currency0, currency1, fee, tickSpacing, hooks },
+        hookData: hookData.toLowerCase(),
+    };
+}
+export function decodeDexPools(value) {
+    if (value === undefined || value === null || value === "")
+        return [];
+    if (typeof value !== "string")
+        return invalid("must be a JSON string");
+    let decoded;
+    try {
+        decoded = JSON.parse(value);
+    }
+    catch {
+        return invalid("must contain valid JSON");
+    }
+    if (!Array.isArray(decoded))
+        return invalid("must contain an array");
+    if (decoded.length > MAX_DEX_POOL_PREFERENCES) {
+        return invalid(`must contain at most ${MAX_DEX_POOL_PREFERENCES} entries`);
+    }
+    return decoded.map(decodeEntry);
+}
+export function encodeDexPools(pools) {
+    if (!Array.isArray(pools))
+        return invalid("must be an array");
+    // Reuse the decoder so encoding and decoding accept precisely the same schema.
+    return JSON.stringify(decodeDexPools(JSON.stringify(pools)));
+}

package/dist/utils/external-provider.d.ts

@@ -0,0 +1,9 @@
+/** Compact witness declaration for selecting an external quote provider. */
+export declare const EXTERNAL_PROVIDER_EXTRA_TYPESTRING = "string provider";
+export declare const EXTERNAL_QUOTE_PROVIDERS: readonly ["khalani", "near", "lifi"];
+export type ExternalQuoteProvider = (typeof EXTERNAL_QUOTE_PROVIDERS)[number];
+/**
+ * Validates an optional signed provider field without normalizing its value.
+ * The exact string is part of the Compact witness and must remain unchanged.
+ */
+export declare function decodeExternalQuoteProvider(value: unknown): ExternalQuoteProvider | undefined;

package/dist/utils/external-provider.js

@@ -0,0 +1,16 @@
+/** Compact witness declaration for selecting an external quote provider. */
+export const EXTERNAL_PROVIDER_EXTRA_TYPESTRING = "string provider";
+export const EXTERNAL_QUOTE_PROVIDERS = ["khalani", "near", "lifi"];
+/**
+ * Validates an optional signed provider field without normalizing its value.
+ * The exact string is part of the Compact witness and must remain unchanged.
+ */
+export function decodeExternalQuoteProvider(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" ||
+        !EXTERNAL_QUOTE_PROVIDERS.includes(value)) {
+        throw new Error(`Invalid external provider; expected one of ${EXTERNAL_QUOTE_PROVIDERS.join(", ")}`);
+    }
+    return value;
+}

package/dist/utils/graph.d.ts

@@ -0,0 +1,20 @@
+import type { Graph } from "../types/index.js";
+/** Resolve the canonical graph name and metadata from an EVM chain id. */
+export declare function getGraphChain(graph: Graph, chainId: number): {
+    chainId: number;
+    explorer: string;
+    nativeCurrency?: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+    name: string;
+} | undefined;
+/** Resolve an asset only when its address exists on the requested chain. */
+export declare function getGraphToken(graph: Graph, chainId: number, symbol: string): {
+    symbol: string;
+    address: string;
+    decimals: number;
+} | undefined;
+/** Check graph path eligibility, including wildcard filler protocols. */
+export declare function supportsGraphProtocol(graph: Graph, chainId: number, protocol: string, symbol: string): boolean;

package/dist/utils/graph.js

@@ -0,0 +1,34 @@
+/** Resolve the canonical graph name and metadata from an EVM chain id. */
+export function getGraphChain(graph, chainId) {
+    const entry = Object.entries(graph.chains).find(([, chain]) => chain.chainId === chainId);
+    return entry ? { name: entry[0], ...entry[1] } : undefined;
+}
+/** Resolve an asset only when its address exists on the requested chain. */
+export function getGraphToken(graph, chainId, symbol) {
+    const chain = getGraphChain(graph, chainId);
+    const token = graph.tokens[symbol];
+    const address = chain && token?.contractAddress[chain.name];
+    return address && chain && token
+        ? {
+            symbol,
+            address,
+            decimals: token.decimalsByChain?.[chain.name] ?? token.decimals,
+        }
+        : undefined;
+}
+/** Check graph path eligibility, including wildcard filler protocols. */
+export function supportsGraphProtocol(graph, chainId, protocol, symbol) {
+    const chain = getGraphChain(graph, chainId);
+    if (!chain || !getGraphToken(graph, chainId, symbol))
+        return false;
+    const addresses = graph.protocols[protocol]?.contractAddress;
+    if (!addresses?.[chain.name] && !addresses?.["*"])
+        return false;
+    const relationships = graph.relationships.protocolTokensByChain[protocol];
+    const relation = relationships?.[chain.name] ?? relationships?.["*"];
+    return [
+        relation?.tokensIn,
+        relation?.tokensOut,
+        relation?.tokensInAndOut,
+    ].some((tokens) => tokens?.includes(symbol) || tokens?.includes("*"));
+}

package/dist/utils/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./compact.js";
+export * from "./miden-id.js";
 export * from "./miden-intent.js";
 export * from "./path.js";
 export * from "./witness-typestring.js";

package/dist/utils/index.js

@@ -1,4 +1,5 @@
 export * from "./compact.js";
+export * from "./miden-id.js";
 export * from "./miden-intent.js";
 export * from "./path.js";
 export * from "./witness-typestring.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,6 +1,6 @@
 {
   "name": "@epoch-protocol/epoch-commons-sdk",
-  "version": "0.1.19",
+  "version": "0.1.21-mainnet.0",
   "description": "SDK for interacting with Epoch Commons Protocol",
   "type": "module",
   "main": "dist/index.js",

package/dist/utils/witness-typestring-constants.d.ts

@@ -1,18 +0,0 @@
-/** Base Mandate fields shared by all Epoch intents (matches `getTaskData`). */
-export declare const BASE_MANDATE_TYPESTRING = "address tokenIn,uint256 tokenInAmount,address tokenOut,uint256 minTokenOut,uint256 destinationChainId,bytes4 taskType,bytes32 protocolHashIdentifier,address recipient";
-/** Miden → EVM cross-chain bridge witness suffix (canonical). */
-export declare const MIDEN_TO_EVM_EXTRA_TYPESTRING = "string midenSourceAccount,string midenFaucetId,string midenNoteType,string midenNoteId";
-/** EVM → Miden cross-chain bridge witness suffix (canonical). */
-export declare const EVM_TO_MIDEN_EXTRA_TYPESTRING = "string midenRecipientAccount,string midenFaucetId";
-export declare const MIDEN_TO_EVM_WITNESS_TYPESTRING = "address tokenIn,uint256 tokenInAmount,address tokenOut,uint256 minTokenOut,uint256 destinationChainId,bytes4 taskType,bytes32 protocolHashIdentifier,address recipient,string midenSourceAccount,string midenFaucetId,string midenNoteType,string midenNoteId";
-export declare const EVM_TO_MIDEN_WITNESS_TYPESTRING = "address tokenIn,uint256 tokenInAmount,address tokenOut,uint256 minTokenOut,uint256 destinationChainId,bytes4 taskType,bytes32 protocolHashIdentifier,address recipient,string midenRecipientAccount,string midenFaucetId";
-export declare const MIDEN_TO_EVM_FIELD_NAMES: string[];
-export declare const EVM_TO_MIDEN_FIELD_NAMES: string[];
-/** Union of all Miden bridge field names from the canonical extra typestrings. */
-export declare const MIDEN_MARKER_FIELD_NAMES: string[];
-/** Fields declared only on the Miden→EVM extra typestring. */
-export declare const MIDEN_TO_EVM_ONLY_FIELD_NAMES: string[];
-/** Fields declared only on the EVM→Miden extra typestring. */
-export declare const EVM_TO_MIDEN_ONLY_FIELD_NAMES: string[];
-export declare const MIDEN_SOURCE_ACCOUNT_FIELD_NAME: "midenSourceAccount";
-export declare const MIDEN_RECIPIENT_ACCOUNT_FIELD_NAME: "midenRecipientAccount";

package/dist/utils/witness-typestring-constants.js

@@ -1,31 +0,0 @@
-import { fieldNamesFromExtraTypestring } from "./witness-typestring-parse.js";
-function uniqueFieldNames(typestrings) {
-    return [
-        ...new Set(typestrings.flatMap((typestring) => fieldNamesFromExtraTypestring(typestring))),
-    ];
-}
-function onlyInLeft(left, right) {
-    const rightSet = new Set(right);
-    return left.filter((name) => !rightSet.has(name));
-}
-/** Base Mandate fields shared by all Epoch intents (matches `getTaskData`). */
-export const BASE_MANDATE_TYPESTRING = "address tokenIn,uint256 tokenInAmount,address tokenOut,uint256 minTokenOut,uint256 destinationChainId,bytes4 taskType,bytes32 protocolHashIdentifier,address recipient";
-/** Miden → EVM cross-chain bridge witness suffix (canonical). */
-export const MIDEN_TO_EVM_EXTRA_TYPESTRING = "string midenSourceAccount,string midenFaucetId,string midenNoteType,string midenNoteId";
-/** EVM → Miden cross-chain bridge witness suffix (canonical). */
-export const EVM_TO_MIDEN_EXTRA_TYPESTRING = "string midenRecipientAccount,string midenFaucetId";
-export const MIDEN_TO_EVM_WITNESS_TYPESTRING = `${BASE_MANDATE_TYPESTRING},${MIDEN_TO_EVM_EXTRA_TYPESTRING}`;
-export const EVM_TO_MIDEN_WITNESS_TYPESTRING = `${BASE_MANDATE_TYPESTRING},${EVM_TO_MIDEN_EXTRA_TYPESTRING}`;
-export const MIDEN_TO_EVM_FIELD_NAMES = fieldNamesFromExtraTypestring(MIDEN_TO_EVM_EXTRA_TYPESTRING);
-export const EVM_TO_MIDEN_FIELD_NAMES = fieldNamesFromExtraTypestring(EVM_TO_MIDEN_EXTRA_TYPESTRING);
-/** Union of all Miden bridge field names from the canonical extra typestrings. */
-export const MIDEN_MARKER_FIELD_NAMES = uniqueFieldNames([
-    MIDEN_TO_EVM_EXTRA_TYPESTRING,
-    EVM_TO_MIDEN_EXTRA_TYPESTRING,
-]);
-/** Fields declared only on the Miden→EVM extra typestring. */
-export const MIDEN_TO_EVM_ONLY_FIELD_NAMES = onlyInLeft(MIDEN_TO_EVM_FIELD_NAMES, EVM_TO_MIDEN_FIELD_NAMES);
-/** Fields declared only on the EVM→Miden extra typestring. */
-export const EVM_TO_MIDEN_ONLY_FIELD_NAMES = onlyInLeft(EVM_TO_MIDEN_FIELD_NAMES, MIDEN_TO_EVM_FIELD_NAMES);
-export const MIDEN_SOURCE_ACCOUNT_FIELD_NAME = MIDEN_TO_EVM_ONLY_FIELD_NAMES.find((name) => name === "midenSourceAccount");
-export const MIDEN_RECIPIENT_ACCOUNT_FIELD_NAME = EVM_TO_MIDEN_ONLY_FIELD_NAMES.find((name) => name === "midenRecipientAccount");

package/dist/utils/witness-typestring-parse.d.ts

@@ -1,5 +0,0 @@
-export declare function parseWitnessTypestringFields(witnessTypeString: string): Array<{
-    type: string;
-    name: string;
-}>;
-export declare function fieldNamesFromExtraTypestring(typestring: string): string[];

package/dist/utils/witness-typestring-parse.js

@@ -1,18 +0,0 @@
-export function parseWitnessTypestringFields(witnessTypeString) {
-    return witnessTypeString
-        .split(",")
-        .map((field) => field.trim())
-        .filter(Boolean)
-        .map((field) => {
-        const tokens = field.split(/\s+/).filter(Boolean);
-        if (tokens.length < 2) {
-            throw new Error(`Invalid witness field "${field}" (expected "type name" in witnessTypeString)`);
-        }
-        const name = tokens[tokens.length - 1];
-        const type = tokens.slice(0, -1).join(" ");
-        return { type, name };
-    });
-}
-export function fieldNamesFromExtraTypestring(typestring) {
-    return parseWitnessTypestringFields(typestring).map((field) => field.name);
-}