@rhinestone/shared-configs 1.10.2 → 1.11.0

package/dist/configs/chains.json

@@ -665,6 +665,10 @@
             "symbol": "HYPE"
         },
         "network": "mainnet",
+        "roles": {
+            "destination": false,
+            "origin": true
+        },
         "settlementLayers": [],
         "stack": "vanilla",
         "swapQuoters": [],
@@ -1383,6 +1387,84 @@
             "symbol": "WETH"
         }
     },
+    "1337001": {
+        "caip2": "hypercore:spot",
+        "explorer": {
+            "addressPath": "/explorer/address/",
+            "txPath": "/explorer/tx/",
+            "url": "https://app.hyperliquid.xyz"
+        },
+        "name": "HyperCore Spot",
+        "nativeToken": {
+            "address": "0x0000000000000000000000000000000000000000",
+            "decimals": 18,
+            "symbol": "HYPE"
+        },
+        "network": "mainnet",
+        "roles": {
+            "destination": true,
+            "origin": false
+        },
+        "settlementLayers": [],
+        "stack": "vanilla",
+        "swapQuoters": [],
+        "tokens": [
+            {
+                "address": "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
+                "approvalSlot": null,
+                "balanceSlot": null,
+                "decimals": 6,
+                "pegGroup": "USD",
+                "symbol": "USDC"
+            }
+        ],
+        "virtual": true,
+        "vmType": "evm",
+        "wrappedNativeToken": {
+            "address": "0x0000000000000000000000000000000000000000",
+            "decimals": 18,
+            "symbol": "HYPE"
+        }
+    },
+    "1337002": {
+        "caip2": "hypercore:perp",
+        "explorer": {
+            "addressPath": "/explorer/address/",
+            "txPath": "/explorer/tx/",
+            "url": "https://app.hyperliquid.xyz"
+        },
+        "name": "HyperCore Perp",
+        "nativeToken": {
+            "address": "0x0000000000000000000000000000000000000000",
+            "decimals": 18,
+            "symbol": "HYPE"
+        },
+        "network": "mainnet",
+        "roles": {
+            "destination": true,
+            "origin": false
+        },
+        "settlementLayers": [],
+        "stack": "vanilla",
+        "swapQuoters": [],
+        "tokens": [
+            {
+                "address": "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
+                "approvalSlot": null,
+                "balanceSlot": null,
+                "decimals": 6,
+                "pegGroup": "USD",
+                "symbol": "USDC"
+            }
+        ],
+        "virtual": true,
+        "vmType": "evm",
+        "wrappedNativeToken": {
+            "address": "0x0000000000000000000000000000000000000000",
+            "decimals": 18,
+            "symbol": "HYPE"
+        }
+    },
     "11155111": {
         "caip2": "eip155:11155111",
         "explorer": {

package/dist/configs/mainnets.json

@@ -101,6 +101,12 @@
             "Alchemy"
         ]
     },
+    "1337001": {
+        "providers": []
+    },
+    "1337002": {
+        "providers": []
+    },
     "728126428": {
         "providers": []
     },

package/dist/scripts/__tests__/validation.test.js

@@ -368,12 +368,15 @@ function errorsFor(chain) {
     (0, bun_test_1.it)("leaves every shipped chain with a well-formed explorer", () => {
         // HyperCore was the last null. Its explorer is authored (viem ships no
         // HyperCore chain) and must stay Hyperliquid's own — a HyperCore txHash is
-        // a Core L1 hash that a HyperEVM scanner cannot resolve.
+        // a Core L1 hash that a HyperEVM scanner cannot resolve. Both delivery
+        // venues are the same Core L1, so both carry it.
         const withoutExplorer = Object.entries(index_1.chainRegistry)
             .filter(([, e]) => e.explorer == null)
             .map(([id]) => id);
         (0, bun_test_1.expect)(withoutExplorer).toEqual([]);
-        (0, bun_test_1.expect)(index_1.chainRegistry["1337"].explorer.url).toBe("https://app.hyperliquid.xyz");
+        for (const venueId of ["1337001", "1337002"]) {
+            (0, bun_test_1.expect)(index_1.chainRegistry[venueId].explorer.url, venueId).toBe("https://app.hyperliquid.xyz");
+        }
         for (const [id, entry] of Object.entries(index_1.chainRegistry)) {
             const explorer = entry.explorer;
             if (explorer === null)

package/dist/scripts/generate.js

@@ -134,6 +134,9 @@ function renderChains(chainRegistry, mainnets, testnets) {
         "  explorer: Explorer | null;",
         "  /** True for virtual chains (e.g. HyperCore) that settle on another chain. */",
         "  virtual?: boolean;",
+        "  /** Which directions of transfer the chain supports; absent means both.",
+        "   *  Read via `canBeOrigin` / `canBeDestination` rather than directly. */",
+        "  roles?: { origin: boolean; destination: boolean };",
         "  nativeToken: NativeToken;",
         "  wrappedNativeToken: NativeToken;",
         "  tokens: Token[];",

package/dist/src/__tests__/chainVirtualization.test.js

@@ -2,15 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const bun_test_1 = require("bun:test");
 const index_1 = require("../index");
-const HYPERCORE_CAIP2 = "hypercore:mainnet";
+const HYPERCORE_SPOT_CAIP2 = "hypercore:spot";
+const HYPERCORE_PERP_CAIP2 = "hypercore:perp";
 const SOLANA_CAIP2 = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
 const TRON_CAIP2 = "tron:mainnet";
 (0, bun_test_1.describe)("chainVirtualization", () => {
     (0, bun_test_1.describe)("getCaip2", () => {
-        (0, bun_test_1.it)("emits the canonical hypercore id for HyperCore (not eip155:1337)", () => {
-            // Data-driven from the `hypercore:mainnet` registry entry, exactly like
-            // Solana/Tron — no special-casing in the codec.
-            (0, bun_test_1.expect)((0, index_1.getCaip2)(index_1.HYPERCORE_CHAIN_ID)).toBe(HYPERCORE_CAIP2);
+        (0, bun_test_1.it)("emits a distinct canonical id per HyperCore venue", () => {
+            // Data-driven from the registry entries, exactly like Solana/Tron — no
+            // special-casing in the codec. The two must not collapse: the venue is
+            // the whole point of splitting them (RHI-5510).
+            (0, bun_test_1.expect)((0, index_1.getCaip2)(index_1.HYPERCORE_SPOT_CHAIN_ID)).toBe(HYPERCORE_SPOT_CAIP2);
+            (0, bun_test_1.expect)((0, index_1.getCaip2)(index_1.HYPERCORE_PERP_CHAIN_ID)).toBe(HYPERCORE_PERP_CAIP2);
+            (0, bun_test_1.expect)(index_1.HYPERCORE_SPOT_CHAIN_ID).not.toBe(index_1.HYPERCORE_PERP_CHAIN_ID);
         });
         (0, bun_test_1.it)("emits the registry caip2 for non-EVM chains", () => {
             (0, bun_test_1.expect)((0, index_1.getCaip2)(index_1.MainnetNetwork.SOLANA)).toBe(SOLANA_CAIP2);
@@ -23,8 +27,15 @@ const TRON_CAIP2 = "tron:mainnet";
         });
     });
     (0, bun_test_1.describe)("chainIdFromCaip2", () => {
-        (0, bun_test_1.it)("resolves the canonical hypercore id back to 1337", () => {
-            (0, bun_test_1.expect)((0, index_1.chainIdFromCaip2)(HYPERCORE_CAIP2)).toBe(index_1.HYPERCORE_CHAIN_ID);
+        (0, bun_test_1.it)("resolves each HyperCore venue back to its own chain id", () => {
+            (0, bun_test_1.expect)((0, index_1.chainIdFromCaip2)(HYPERCORE_SPOT_CAIP2)).toBe(index_1.HYPERCORE_SPOT_CHAIN_ID);
+            (0, bun_test_1.expect)((0, index_1.chainIdFromCaip2)(HYPERCORE_PERP_CAIP2)).toBe(index_1.HYPERCORE_PERP_CHAIN_ID);
+        });
+        (0, bun_test_1.it)("resolves the origin id, which is not a delivery venue", () => {
+            // `hypercore:mainnet` is the Core L1 as a deposit SOURCE, so it still
+            // resolves. What stops it being used as a delivery target is its role,
+            // not its absence — see the roles tests below.
+            (0, bun_test_1.expect)((0, index_1.chainIdFromCaip2)("hypercore:mainnet")).toBe(1337);
         });
         (0, bun_test_1.it)("resolves registry non-EVM caip2 strings", () => {
             (0, bun_test_1.expect)((0, index_1.chainIdFromCaip2)(SOLANA_CAIP2)).toBe(index_1.MainnetNetwork.SOLANA);
@@ -47,22 +58,64 @@ const TRON_CAIP2 = "tron:mainnet";
         for (const id of [
             index_1.MainnetNetwork.SOLANA,
             index_1.MainnetNetwork.TRON,
-            index_1.HYPERCORE_CHAIN_ID,
+            index_1.HYPERCORE_SPOT_CHAIN_ID,
+            index_1.HYPERCORE_PERP_CHAIN_ID,
         ]) {
             (0, bun_test_1.expect)((0, index_1.chainIdFromCaip2)((0, index_1.getCaip2)(id))).toBe(id);
         }
     });
+    (0, bun_test_1.describe)("chain roles", () => {
+        (0, bun_test_1.it)("splits HyperCore by direction: Core L1 originates, venues receive", () => {
+            // Deposits arrive from the Core L1 without naming a venue; a delivery
+            // must name the account it credits. Declaring it here is what makes a
+            // perp *deposit source* unrepresentable rather than merely unimplemented,
+            // and all three ids share the `hypercore:` namespace — so a namespace
+            // switch could not draw this line at any level of effort.
+            (0, bun_test_1.expect)((0, index_1.canBeOrigin)(1337)).toBe(true);
+            (0, bun_test_1.expect)((0, index_1.canBeDestination)(1337)).toBe(false);
+            for (const venue of [index_1.HYPERCORE_SPOT_CHAIN_ID, index_1.HYPERCORE_PERP_CHAIN_ID]) {
+                (0, bun_test_1.expect)((0, index_1.canBeOrigin)(venue)).toBe(false);
+                (0, bun_test_1.expect)((0, index_1.canBeDestination)(venue)).toBe(true);
+            }
+        });
+        (0, bun_test_1.it)("defaults both directions for chains that declare no roles", () => {
+            // Absent `roles` must mean both, so adding the field is a no-op for every
+            // chain that predates it. Tron is in this list deliberately: a consumer
+            // may advertise less than the registry permits, and one does, but that is
+            // the consumer's policy and must not be pushed down here.
+            for (const id of [
+                index_1.MainnetNetwork.ETHEREUM,
+                index_1.MainnetNetwork.BASE,
+                index_1.MainnetNetwork.SOLANA,
+                index_1.MainnetNetwork.TRON,
+            ]) {
+                (0, bun_test_1.expect)((0, index_1.canBeOrigin)(id)).toBe(true);
+                (0, bun_test_1.expect)((0, index_1.canBeDestination)(id)).toBe(true);
+            }
+        });
+        (0, bun_test_1.it)("defaults both directions for an unknown chain id", () => {
+            (0, bun_test_1.expect)((0, index_1.canBeOrigin)(999_999_999)).toBe(true);
+            (0, bun_test_1.expect)((0, index_1.canBeDestination)(999_999_999)).toBe(true);
+        });
+    });
     (0, bun_test_1.describe)("HyperCore stays EVM-classified", () => {
-        (0, bun_test_1.it)("is a virtual EVM registry entry, not a non-EVM chain", () => {
-            // The canonical id changing must not flip HyperCore's routing — it is
-            // EVM-addressed and settles on HyperEVM (999).
-            const entry = index_1.chainRegistry[String(index_1.HYPERCORE_CHAIN_ID)];
-            (0, bun_test_1.expect)(entry).toBeDefined();
-            (0, bun_test_1.expect)(entry.vmType).toBe("evm");
-            (0, bun_test_1.expect)(entry.virtual).toBe(true);
-            (0, bun_test_1.expect)(entry.caip2).toBe(HYPERCORE_CAIP2);
-            (0, bun_test_1.expect)((0, index_1.isNonEvmChainId)(index_1.HYPERCORE_CHAIN_ID)).toBe(false);
-            (0, bun_test_1.expect)((0, index_1.getNonEvmChainIds)()).not.toContain(index_1.HYPERCORE_CHAIN_ID);
+        (0, bun_test_1.it)("both venues are virtual EVM registry entries, not non-EVM chains", () => {
+            // Splitting by venue must not flip HyperCore's routing — both are
+            // EVM-addressed and settle on HyperEVM (999). Classifying either as
+            // non-EVM would make `recipient` required and skip address
+            // normalisation, neither of which is true here.
+            for (const [id, caip2] of [
+                [index_1.HYPERCORE_SPOT_CHAIN_ID, HYPERCORE_SPOT_CAIP2],
+                [index_1.HYPERCORE_PERP_CHAIN_ID, HYPERCORE_PERP_CAIP2],
+            ]) {
+                const entry = index_1.chainRegistry[String(id)];
+                (0, bun_test_1.expect)(entry).toBeDefined();
+                (0, bun_test_1.expect)(entry.vmType).toBe("evm");
+                (0, bun_test_1.expect)(entry.virtual).toBe(true);
+                (0, bun_test_1.expect)(entry.caip2).toBe(caip2);
+                (0, bun_test_1.expect)((0, index_1.isNonEvmChainId)(id)).toBe(false);
+                (0, bun_test_1.expect)((0, index_1.getNonEvmChainIds)()).not.toContain(id);
+            }
         });
         (0, bun_test_1.it)("still classifies genuine non-EVM chains", () => {
             (0, bun_test_1.expect)((0, index_1.isNonEvmChainId)(index_1.MainnetNetwork.SOLANA)).toBe(true);

package/dist/src/chainVirtualization.d.ts

@@ -1,6 +1,24 @@
 import type { VmType } from "./types";
 /** VM kind for a chain id; defaults to `'evm'` for unknown ids. */
 export declare function getVmType(chainId: number): VmType;
+/**
+ * Whether funds can ARRIVE from this chain — i.e. it is a valid deposit source.
+ *
+ * Absent `roles` means both directions, so every ordinary chain answers true
+ * without declaring anything. A consumer may narrow this further; it may not
+ * widen it.
+ */
+export declare function canBeOrigin(chainId: number): boolean;
+/**
+ * Whether funds can be DELIVERED to this chain — i.e. it is a valid intent
+ * destination.
+ *
+ * False for `hypercore:mainnet`: deposits arrive from the Core L1 venue-agnostically,
+ * but a delivery must name the account it credits, so `hypercore:spot` /
+ * `hypercore:perp` are the only HyperCore destinations. Answering that from data
+ * is what lets a consumer refuse the ambiguous id without knowing its number.
+ */
+export declare function canBeDestination(chainId: number): boolean;
 /** True when the chain id's vmType is not `'evm'` (Solana, Tron today). */
 export declare function isNonEvmChainId(chainId: number): boolean;
 /**

package/dist/src/chainVirtualization.js

@@ -4,6 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getVmType = getVmType;
+exports.canBeOrigin = canBeOrigin;
+exports.canBeDestination = canBeDestination;
 exports.isNonEvmChainId = isNonEvmChainId;
 exports.getNonEvmChainIds = getNonEvmChainIds;
 exports.getCaip2 = getCaip2;
@@ -30,6 +32,28 @@ const chainRegistry = chains_json_1.default;
 function getVmType(chainId) {
     return chainRegistry[String(chainId)]?.vmType ?? "evm";
 }
+/**
+ * Whether funds can ARRIVE from this chain — i.e. it is a valid deposit source.
+ *
+ * Absent `roles` means both directions, so every ordinary chain answers true
+ * without declaring anything. A consumer may narrow this further; it may not
+ * widen it.
+ */
+function canBeOrigin(chainId) {
+    return chainRegistry[String(chainId)]?.roles?.origin ?? true;
+}
+/**
+ * Whether funds can be DELIVERED to this chain — i.e. it is a valid intent
+ * destination.
+ *
+ * False for `hypercore:mainnet`: deposits arrive from the Core L1 venue-agnostically,
+ * but a delivery must name the account it credits, so `hypercore:spot` /
+ * `hypercore:perp` are the only HyperCore destinations. Answering that from data
+ * is what lets a consumer refuse the ambiguous id without knowing its number.
+ */
+function canBeDestination(chainId) {
+    return chainRegistry[String(chainId)]?.roles?.destination ?? true;
+}
 /** True when the chain id's vmType is not `'evm'` (Solana, Tron today). */
 function isNonEvmChainId(chainId) {
     return getVmType(chainId) !== "evm";

package/dist/src/chains.d.ts

@@ -40,6 +40,12 @@ interface Chain {
     explorer: Explorer | null;
     /** True for virtual chains (e.g. HyperCore) that settle on another chain. */
     virtual?: boolean;
+    /** Which directions of transfer the chain supports; absent means both.
+     *  Read via `canBeOrigin` / `canBeDestination` rather than directly. */
+    roles?: {
+        origin: boolean;
+        destination: boolean;
+    };
     nativeToken: NativeToken;
     wrappedNativeToken: NativeToken;
     tokens: Token[];

package/dist/src/chains.js

@@ -706,6 +706,10 @@ const chains = {
             "symbol": "HYPE"
         },
         "network": "mainnet",
+        "roles": {
+            "destination": false,
+            "origin": true
+        },
         "settlementLayers": [],
         "stack": "vanilla",
         "swapQuoters": [],
@@ -1467,6 +1471,86 @@ const chains = {
             "Alchemy"
         ]
     },
+    "1337001": {
+        "caip2": "hypercore:spot",
+        "explorer": {
+            "addressPath": "/explorer/address/",
+            "txPath": "/explorer/tx/",
+            "url": "https://app.hyperliquid.xyz"
+        },
+        "name": "HyperCore Spot",
+        "nativeToken": {
+            "address": "0x0000000000000000000000000000000000000000",
+            "decimals": 18,
+            "symbol": "HYPE"
+        },
+        "network": "mainnet",
+        "roles": {
+            "destination": true,
+            "origin": false
+        },
+        "settlementLayers": [],
+        "stack": "vanilla",
+        "swapQuoters": [],
+        "tokens": [
+            {
+                "address": "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
+                "approvalSlot": null,
+                "balanceSlot": null,
+                "decimals": 6,
+                "pegGroup": "USD",
+                "symbol": "USDC"
+            }
+        ],
+        "virtual": true,
+        "vmType": "evm",
+        "wrappedNativeToken": {
+            "address": "0x0000000000000000000000000000000000000000",
+            "decimals": 18,
+            "symbol": "HYPE"
+        },
+        "providers": []
+    },
+    "1337002": {
+        "caip2": "hypercore:perp",
+        "explorer": {
+            "addressPath": "/explorer/address/",
+            "txPath": "/explorer/tx/",
+            "url": "https://app.hyperliquid.xyz"
+        },
+        "name": "HyperCore Perp",
+        "nativeToken": {
+            "address": "0x0000000000000000000000000000000000000000",
+            "decimals": 18,
+            "symbol": "HYPE"
+        },
+        "network": "mainnet",
+        "roles": {
+            "destination": true,
+            "origin": false
+        },
+        "settlementLayers": [],
+        "stack": "vanilla",
+        "swapQuoters": [],
+        "tokens": [
+            {
+                "address": "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
+                "approvalSlot": null,
+                "balanceSlot": null,
+                "decimals": 6,
+                "pegGroup": "USD",
+                "symbol": "USDC"
+            }
+        ],
+        "virtual": true,
+        "vmType": "evm",
+        "wrappedNativeToken": {
+            "address": "0x0000000000000000000000000000000000000000",
+            "decimals": 18,
+            "symbol": "HYPE"
+        },
+        "providers": []
+    },
     "11155111": {
         "caip2": "eip155:11155111",
         "explorer": {

package/dist/src/generated/networks.d.ts

@@ -5316,6 +5316,8 @@ declare enum MainnetNetwork {
     BSC,
     HYPEREVM,
     HYPERCORE = 1337,
+    HYPERCORE_SPOT = 1337001,
+    HYPERCORE_PERP = 1337002,
     MONAD,
     UNICHAIN,
     SOLANA = 792703809,

package/dist/src/generated/networks.js

@@ -23,6 +23,8 @@ var MainnetNetwork;
     MainnetNetwork[MainnetNetwork["BSC"] = chains_1.bsc.id] = "BSC";
     MainnetNetwork[MainnetNetwork["HYPEREVM"] = chains_1.hyperEvm.id] = "HYPEREVM";
     MainnetNetwork[MainnetNetwork["HYPERCORE"] = 1337] = "HYPERCORE";
+    MainnetNetwork[MainnetNetwork["HYPERCORE_SPOT"] = 1337001] = "HYPERCORE_SPOT";
+    MainnetNetwork[MainnetNetwork["HYPERCORE_PERP"] = 1337002] = "HYPERCORE_PERP";
     MainnetNetwork[MainnetNetwork["MONAD"] = chains_1.monad.id] = "MONAD";
     MainnetNetwork[MainnetNetwork["UNICHAIN"] = chains_1.unichain.id] = "UNICHAIN";
     MainnetNetwork[MainnetNetwork["SOLANA"] = 792703809] = "SOLANA";

package/dist/src/generated/packageVersion.d.ts

@@ -1,2 +1,2 @@
-declare const PACKAGE_VERSION = "1.10.2";
+declare const PACKAGE_VERSION = "1.11.0";
 export { PACKAGE_VERSION };

package/dist/src/generated/packageVersion.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PACKAGE_VERSION = void 0;
 // Auto-generated by scripts/generate.ts. Do not edit manually.
-const PACKAGE_VERSION = "1.10.2";
+const PACKAGE_VERSION = "1.11.0";
 exports.PACKAGE_VERSION = PACKAGE_VERSION;

package/dist/src/hypercore.d.ts

@@ -1,19 +1,37 @@
 import { type Address, type Hex } from "viem";
 import { MainnetNetwork } from "./generated/networks";
 /**
- * Virtual chain id orchestrators use to address HyperCore as a destination.
- * Resolved to HyperEVM (999) at the MetaIntent boundary; the signed EIP-712
- * payload binds to 999, not 1337.
+ * Virtual chain ids orchestrators use to address HyperCore as a destination —
+ * one per DELIVERY VENUE. Both resolve to HyperEVM (999) at the MetaIntent
+ * boundary; the signed EIP-712 payload binds to 999, never to these.
  *
- * Backed by the `virtual` registry entry (`MainnetNetwork.HYPERCORE`), whose
- * canonical CAIP-2 is `hypercore:mainnet` — read it via
- * `getCaip2(HYPERCORE_CHAIN_ID)` (`eip155:1337` would be wrong: 1337 is the
- * Hardhat/Ganache local chain id).
+ * The venue is part of the destination because the two credit different
+ * accounts and the wrong one is invisible: the intent completes, the fill
+ * succeeds, and only the recipient's Core state shows where the funds went
+ * (RHI-5510). Encoding it in the chain id makes it unforgettable and
+ * undroppable — unlike the optional `tokenRequests[].balance` flag it replaces,
+ * which four separate field-by-field rebuilds each silently discarded.
+ *
+ * Read the canonical CAIP-2 via `getCaip2(...)` — `eip155:*` would be wrong for
+ * either.
+ */
+export declare const HYPERCORE_SPOT_CHAIN_ID = MainnetNetwork.HYPERCORE_SPOT;
+export declare const HYPERCORE_PERP_CHAIN_ID = MainnetNetwork.HYPERCORE_PERP;
+/**
+ * The Core L1 itself (`hypercore:mainnet`) — HyperCore as a deposit SOURCE.
+ *
+ * Deposits arrive here with no venue in them, which is what `deposits.chain` and
+ * the QuickNode webhook already mean, so this stays a live registry entry with
+ * `roles: { origin: true, destination: false }`.
+ *
+ * It is deliberately NOT aliased to either venue for delivery: it defaulted to
+ * perp, so pointing it at spot would silently move funds and pointing it at perp
+ * would silently keep the bug. `canBeDestination` is what refuses it.
  */
-export declare const HYPERCORE_CHAIN_ID = MainnetNetwork.HYPERCORE;
+export declare const HYPERCORE_ORIGIN_CHAIN_ID = 1337;
 /**
  * Real EVM settlement chain for HyperCore destinations. HyperCore is a virtual
- * chain id (1337) with no RPC of its own; funds land on HyperEVM (999), where
+ * chain id with no RPC of its own; funds land on HyperEVM (999), where
  * `depositFor` runs. Consumers that need the settlement chain (RPC, EIP-712
  * domain `chainId`, contract dispatch) translate at their boundary via
  * `resolveSettlementChainId`.
@@ -22,12 +40,27 @@ export declare const HYPERCORE_SETTLEMENT_CHAIN_ID: number;
 /**
  * Resolves a (possibly virtual) chain id to the real settlement chain where
  * orchestrator EVM operations execute. Identity for first-party EVM chains
- * and non-EVM chains (bridge-terminated); maps `HYPERCORE_CHAIN_ID` →
- * `HYPERCORE_SETTLEMENT_CHAIN_ID` for HyperCore destinations.
+ * and non-EVM chains (bridge-terminated); maps either HyperCore venue id →
+ * `HYPERCORE_SETTLEMENT_CHAIN_ID`.
  */
 export declare function resolveSettlementChainId(chainId: number): number;
-/** True when the chain id is a HyperCore virtual destination. */
+/**
+ * True for either HyperCore DELIVERY VENUE. Deliberately false for
+ * `HYPERCORE_ORIGIN_CHAIN_ID`, which names the Core L1 without naming an account
+ * — a caller that passes it fails the destination check loudly instead of
+ * routing to a guessed venue.
+ */
 export declare function isHyperCoreChainId(chainId: number): boolean;
+/**
+ * The `uint32 destinationDex` for `CoreDepositWallet.depositFor` — the single
+ * value that decides which HyperCore account is credited. Derived from the
+ * destination chain id, so it cannot disagree with what the caller addressed.
+ *
+ * Throws rather than defaulting: every historical incarnation of a default here
+ * (the `?? 'perp'` at the MetaIntent boundary, and `getDepositForCall`'s old
+ * optional parameter) produced silently misrouted funds.
+ */
+export declare function getHyperCoreDestinationDex(chainId: number): number;
 /**
  * Hyperliquid CoreWriter precompile on HyperEVM. Not used for USDC delivery
  * — kept as a documented constant for future actions (spot send, vault
@@ -100,7 +133,10 @@ export declare function getApproveCoreDepositWalletCall(usdcAddress: Address, am
  * `recipient`'s HyperCore account with `amount` USDC (in HyperEVM 6-decimal
  * units; Hyperliquid handles the wei-precision conversion internally).
  *
- * `destinationDex`: `HYPERCORE_SPOT_DEX` (default) or
- * `HYPERCORE_DEFAULT_PERP_DEX`.
+ * `destinationDex` is REQUIRED — derive it from the destination chain id with
+ * `getHyperCoreDestinationDex`. It used to default to `HYPERCORE_SPOT_DEX`
+ * here while the orchestrator's caller defaulted to the perp dex, so the two
+ * sides documented opposite behaviour for the same omission; that disagreement
+ * is the shape of the RHI-5510 bug and a default is what allows it.
  */
-export declare function getDepositForCall(recipient: Address, amount: bigint, destinationDex?: number): HyperCoreExecution;
+export declare function getDepositForCall(recipient: Address, amount: bigint, destinationDex: number): HyperCoreExecution;

package/dist/src/hypercore.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.coreDepositWalletAbi = exports.HYPERCORE_USDC_ACTIVATION_FEE = exports.HYPERCORE_DEFAULT_PERP_DEX = exports.HYPERCORE_SPOT_DEX = exports.CORE_DEPOSIT_WALLET = exports.CORE_WRITER_PRECOMPILE = exports.HYPERCORE_SETTLEMENT_CHAIN_ID = exports.HYPERCORE_CHAIN_ID = void 0;
+exports.coreDepositWalletAbi = exports.HYPERCORE_USDC_ACTIVATION_FEE = exports.HYPERCORE_DEFAULT_PERP_DEX = exports.HYPERCORE_SPOT_DEX = exports.CORE_DEPOSIT_WALLET = exports.CORE_WRITER_PRECOMPILE = exports.HYPERCORE_SETTLEMENT_CHAIN_ID = exports.HYPERCORE_ORIGIN_CHAIN_ID = exports.HYPERCORE_PERP_CHAIN_ID = exports.HYPERCORE_SPOT_CHAIN_ID = void 0;
 exports.resolveSettlementChainId = resolveSettlementChainId;
 exports.isHyperCoreChainId = isHyperCoreChainId;
+exports.getHyperCoreDestinationDex = getHyperCoreDestinationDex;
 exports.getApproveCoreDepositWalletCall = getApproveCoreDepositWalletCall;
 exports.getDepositForCall = getDepositForCall;
 const viem_1 = require("viem");
@@ -30,19 +31,37 @@ const networks_1 = require("./generated/networks");
 // bridging behavior below stays here rather than in the generated registry.
 // ---------------------------------------------------------------------------
 /**
- * Virtual chain id orchestrators use to address HyperCore as a destination.
- * Resolved to HyperEVM (999) at the MetaIntent boundary; the signed EIP-712
- * payload binds to 999, not 1337.
+ * Virtual chain ids orchestrators use to address HyperCore as a destination —
+ * one per DELIVERY VENUE. Both resolve to HyperEVM (999) at the MetaIntent
+ * boundary; the signed EIP-712 payload binds to 999, never to these.
  *
- * Backed by the `virtual` registry entry (`MainnetNetwork.HYPERCORE`), whose
- * canonical CAIP-2 is `hypercore:mainnet` — read it via
- * `getCaip2(HYPERCORE_CHAIN_ID)` (`eip155:1337` would be wrong: 1337 is the
- * Hardhat/Ganache local chain id).
+ * The venue is part of the destination because the two credit different
+ * accounts and the wrong one is invisible: the intent completes, the fill
+ * succeeds, and only the recipient's Core state shows where the funds went
+ * (RHI-5510). Encoding it in the chain id makes it unforgettable and
+ * undroppable — unlike the optional `tokenRequests[].balance` flag it replaces,
+ * which four separate field-by-field rebuilds each silently discarded.
+ *
+ * Read the canonical CAIP-2 via `getCaip2(...)` — `eip155:*` would be wrong for
+ * either.
+ */
+exports.HYPERCORE_SPOT_CHAIN_ID = networks_1.MainnetNetwork.HYPERCORE_SPOT;
+exports.HYPERCORE_PERP_CHAIN_ID = networks_1.MainnetNetwork.HYPERCORE_PERP;
+/**
+ * The Core L1 itself (`hypercore:mainnet`) — HyperCore as a deposit SOURCE.
+ *
+ * Deposits arrive here with no venue in them, which is what `deposits.chain` and
+ * the QuickNode webhook already mean, so this stays a live registry entry with
+ * `roles: { origin: true, destination: false }`.
+ *
+ * It is deliberately NOT aliased to either venue for delivery: it defaulted to
+ * perp, so pointing it at spot would silently move funds and pointing it at perp
+ * would silently keep the bug. `canBeDestination` is what refuses it.
  */
-exports.HYPERCORE_CHAIN_ID = networks_1.MainnetNetwork.HYPERCORE;
+exports.HYPERCORE_ORIGIN_CHAIN_ID = 1337;
 /**
  * Real EVM settlement chain for HyperCore destinations. HyperCore is a virtual
- * chain id (1337) with no RPC of its own; funds land on HyperEVM (999), where
+ * chain id with no RPC of its own; funds land on HyperEVM (999), where
  * `depositFor` runs. Consumers that need the settlement chain (RPC, EIP-712
  * domain `chainId`, contract dispatch) translate at their boundary via
  * `resolveSettlementChainId`.
@@ -51,15 +70,36 @@ exports.HYPERCORE_SETTLEMENT_CHAIN_ID = networks_1.MainnetNetwork.HYPEREVM;
 /**
  * Resolves a (possibly virtual) chain id to the real settlement chain where
  * orchestrator EVM operations execute. Identity for first-party EVM chains
- * and non-EVM chains (bridge-terminated); maps `HYPERCORE_CHAIN_ID` →
- * `HYPERCORE_SETTLEMENT_CHAIN_ID` for HyperCore destinations.
+ * and non-EVM chains (bridge-terminated); maps either HyperCore venue id →
+ * `HYPERCORE_SETTLEMENT_CHAIN_ID`.
  */
 function resolveSettlementChainId(chainId) {
-    return chainId === exports.HYPERCORE_CHAIN_ID ? exports.HYPERCORE_SETTLEMENT_CHAIN_ID : chainId;
+    return isHyperCoreChainId(chainId) ? exports.HYPERCORE_SETTLEMENT_CHAIN_ID : chainId;
 }
-/** True when the chain id is a HyperCore virtual destination. */
+/**
+ * True for either HyperCore DELIVERY VENUE. Deliberately false for
+ * `HYPERCORE_ORIGIN_CHAIN_ID`, which names the Core L1 without naming an account
+ * — a caller that passes it fails the destination check loudly instead of
+ * routing to a guessed venue.
+ */
 function isHyperCoreChainId(chainId) {
-    return chainId === exports.HYPERCORE_CHAIN_ID;
+    return (chainId === exports.HYPERCORE_SPOT_CHAIN_ID || chainId === exports.HYPERCORE_PERP_CHAIN_ID);
+}
+/**
+ * The `uint32 destinationDex` for `CoreDepositWallet.depositFor` — the single
+ * value that decides which HyperCore account is credited. Derived from the
+ * destination chain id, so it cannot disagree with what the caller addressed.
+ *
+ * Throws rather than defaulting: every historical incarnation of a default here
+ * (the `?? 'perp'` at the MetaIntent boundary, and `getDepositForCall`'s old
+ * optional parameter) produced silently misrouted funds.
+ */
+function getHyperCoreDestinationDex(chainId) {
+    if (chainId === exports.HYPERCORE_SPOT_CHAIN_ID)
+        return exports.HYPERCORE_SPOT_DEX;
+    if (chainId === exports.HYPERCORE_PERP_CHAIN_ID)
+        return exports.HYPERCORE_DEFAULT_PERP_DEX;
+    throw new Error(`getHyperCoreDestinationDex: ${chainId} is not a HyperCore venue (expected ${exports.HYPERCORE_SPOT_CHAIN_ID} spot or ${exports.HYPERCORE_PERP_CHAIN_ID} perp)`);
 }
 /**
  * Hyperliquid CoreWriter precompile on HyperEVM. Not used for USDC delivery
@@ -127,10 +167,13 @@ function getApproveCoreDepositWalletCall(usdcAddress, amount) {
  * `recipient`'s HyperCore account with `amount` USDC (in HyperEVM 6-decimal
  * units; Hyperliquid handles the wei-precision conversion internally).
  *
- * `destinationDex`: `HYPERCORE_SPOT_DEX` (default) or
- * `HYPERCORE_DEFAULT_PERP_DEX`.
+ * `destinationDex` is REQUIRED — derive it from the destination chain id with
+ * `getHyperCoreDestinationDex`. It used to default to `HYPERCORE_SPOT_DEX`
+ * here while the orchestrator's caller defaulted to the perp dex, so the two
+ * sides documented opposite behaviour for the same omission; that disagreement
+ * is the shape of the RHI-5510 bug and a default is what allows it.
  */
-function getDepositForCall(recipient, amount, destinationDex = exports.HYPERCORE_SPOT_DEX) {
+function getDepositForCall(recipient, amount, destinationDex) {
     return {
         to: exports.CORE_DEPOSIT_WALLET,
         value: 0n,

package/dist/src/index.d.ts

@@ -1,12 +1,12 @@
 import { contractAddresses } from "./generated/contracts";
 import { contractAddresses as contractAddressesDev } from "./generated/contracts.dev";
-import type { ChainEntry, ChainExplorer, ChainItem, ChainList, ChainNetwork, ChainStack, ChainRegistry, ProviderName, ProviderRegistry, SettlementLayer, SupportedChain, SupportedMainnet, SupportedOPStackMainnet, SupportedOPStackTestnet, SupportedTestnet, SwapQuoter } from "./types";
+import type { ChainEntry, ChainExplorer, ChainItem, ChainList, ChainNetwork, ChainStack, ChainRegistry, ChainRoles, ProviderName, ProviderRegistry, SettlementLayer, SupportedChain, SupportedMainnet, SupportedOPStackMainnet, SupportedOPStackTestnet, SupportedTestnet, SwapQuoter } from "./types";
 import { chains, MainnetNetwork, mainnetChains, OPStackChains, TestnetNetwork, testnetChains } from "./types";
 import type { PegGroup } from "./types";
 import { getOftConfig, getSupportedOftTokens, hasOftSupport, OFT_REGISTRY } from "./oft";
 import type { OftConfig } from "./oft";
-import { CORE_DEPOSIT_WALLET, CORE_WRITER_PRECOMPILE, getApproveCoreDepositWalletCall, getDepositForCall, HYPERCORE_CHAIN_ID, HYPERCORE_DEFAULT_PERP_DEX, HYPERCORE_SETTLEMENT_CHAIN_ID, HYPERCORE_SPOT_DEX, HYPERCORE_USDC_ACTIVATION_FEE, isHyperCoreChainId, resolveSettlementChainId } from "./hypercore";
-import { chainIdFromCaip2, getCaip2, getNonEvmChainIds, isNonEvmChainId } from "./chainVirtualization";
+import { CORE_DEPOSIT_WALLET, CORE_WRITER_PRECOMPILE, getApproveCoreDepositWalletCall, getDepositForCall, getHyperCoreDestinationDex, HYPERCORE_DEFAULT_PERP_DEX, HYPERCORE_ORIGIN_CHAIN_ID, HYPERCORE_PERP_CHAIN_ID, HYPERCORE_SETTLEMENT_CHAIN_ID, HYPERCORE_SPOT_CHAIN_ID, HYPERCORE_SPOT_DEX, HYPERCORE_USDC_ACTIVATION_FEE, isHyperCoreChainId, resolveSettlementChainId } from "./hypercore";
+import { chainIdFromCaip2, getCaip2, getNonEvmChainIds, canBeDestination, canBeOrigin, isNonEvmChainId } from "./chainVirtualization";
 import { createChainFactsClient } from "./chainFactsClient";
 import { CHAIN_FACTS_LATEST_URL, CHAIN_FACTS_PUBLIC_KEY } from "./generated/chainFactsKey";
 import type { ChainFactsClient, ChainFactsClientOptions, ChainFactsErrorPhase, ChainFactsPayload, ChainFactsSnapshot, ChainFactsSource } from "./chainFactsClient";
@@ -15,6 +15,6 @@ declare const providerRegistry: ProviderRegistry;
 declare const mainnetChainList: ChainList;
 declare const testnetChainList: ChainList;
 declare function chainHasUnpricedTokens(chainId: number): boolean;
-export { chainRegistry, providerRegistry, mainnetChainList, testnetChainList, contractAddresses, contractAddressesDev, chains, mainnetChains, testnetChains, MainnetNetwork, OPStackChains, TestnetNetwork, OFT_REGISTRY, getOftConfig, hasOftSupport, getSupportedOftTokens, chainHasUnpricedTokens, HYPERCORE_CHAIN_ID, HYPERCORE_SETTLEMENT_CHAIN_ID, CORE_WRITER_PRECOMPILE, CORE_DEPOSIT_WALLET, HYPERCORE_SPOT_DEX, HYPERCORE_DEFAULT_PERP_DEX, HYPERCORE_USDC_ACTIVATION_FEE, getApproveCoreDepositWalletCall, getDepositForCall, isHyperCoreChainId, resolveSettlementChainId, isNonEvmChainId, getNonEvmChainIds, getCaip2, chainIdFromCaip2, createChainFactsClient, CHAIN_FACTS_LATEST_URL, CHAIN_FACTS_PUBLIC_KEY, };
-export type { ChainEntry, ChainExplorer, ChainItem, ChainList, ChainNetwork, ChainStack, ChainRegistry, ProviderRegistry, ProviderName, SwapQuoter, SupportedMainnet, SupportedTestnet, SupportedChain, SupportedOPStackMainnet, SupportedOPStackTestnet, SettlementLayer, OftConfig, PegGroup, ChainFactsClient, ChainFactsClientOptions, ChainFactsErrorPhase, ChainFactsPayload, ChainFactsSnapshot, ChainFactsSource, };
+export { chainRegistry, providerRegistry, mainnetChainList, testnetChainList, contractAddresses, contractAddressesDev, chains, mainnetChains, testnetChains, MainnetNetwork, OPStackChains, TestnetNetwork, OFT_REGISTRY, getOftConfig, hasOftSupport, getSupportedOftTokens, chainHasUnpricedTokens, HYPERCORE_SPOT_CHAIN_ID, HYPERCORE_PERP_CHAIN_ID, HYPERCORE_ORIGIN_CHAIN_ID, getHyperCoreDestinationDex, HYPERCORE_SETTLEMENT_CHAIN_ID, CORE_WRITER_PRECOMPILE, CORE_DEPOSIT_WALLET, HYPERCORE_SPOT_DEX, HYPERCORE_DEFAULT_PERP_DEX, HYPERCORE_USDC_ACTIVATION_FEE, getApproveCoreDepositWalletCall, getDepositForCall, isHyperCoreChainId, resolveSettlementChainId, canBeOrigin, canBeDestination, isNonEvmChainId, getNonEvmChainIds, getCaip2, chainIdFromCaip2, createChainFactsClient, CHAIN_FACTS_LATEST_URL, CHAIN_FACTS_PUBLIC_KEY, };
+export type { ChainEntry, ChainExplorer, ChainItem, ChainList, ChainNetwork, ChainStack, ChainRegistry, ChainRoles, ProviderRegistry, ProviderName, SwapQuoter, SupportedMainnet, SupportedTestnet, SupportedChain, SupportedOPStackMainnet, SupportedOPStackTestnet, SettlementLayer, OftConfig, PegGroup, ChainFactsClient, ChainFactsClientOptions, ChainFactsErrorPhase, ChainFactsPayload, ChainFactsSnapshot, ChainFactsSource, };
 export * from "./abis";

package/dist/src/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CHAIN_FACTS_PUBLIC_KEY = exports.CHAIN_FACTS_LATEST_URL = exports.createChainFactsClient = exports.chainIdFromCaip2 = exports.getCaip2 = exports.getNonEvmChainIds = exports.isNonEvmChainId = exports.resolveSettlementChainId = exports.isHyperCoreChainId = exports.getDepositForCall = exports.getApproveCoreDepositWalletCall = exports.HYPERCORE_USDC_ACTIVATION_FEE = exports.HYPERCORE_DEFAULT_PERP_DEX = exports.HYPERCORE_SPOT_DEX = exports.CORE_DEPOSIT_WALLET = exports.CORE_WRITER_PRECOMPILE = exports.HYPERCORE_SETTLEMENT_CHAIN_ID = exports.HYPERCORE_CHAIN_ID = exports.getSupportedOftTokens = exports.hasOftSupport = exports.getOftConfig = exports.OFT_REGISTRY = exports.TestnetNetwork = exports.OPStackChains = exports.MainnetNetwork = exports.testnetChains = exports.mainnetChains = exports.chains = exports.contractAddressesDev = exports.contractAddresses = exports.testnetChainList = exports.mainnetChainList = exports.providerRegistry = exports.chainRegistry = void 0;
+exports.CHAIN_FACTS_PUBLIC_KEY = exports.CHAIN_FACTS_LATEST_URL = exports.createChainFactsClient = exports.chainIdFromCaip2 = exports.getCaip2 = exports.getNonEvmChainIds = exports.isNonEvmChainId = exports.canBeDestination = exports.canBeOrigin = exports.resolveSettlementChainId = exports.isHyperCoreChainId = exports.getDepositForCall = exports.getApproveCoreDepositWalletCall = exports.HYPERCORE_USDC_ACTIVATION_FEE = exports.HYPERCORE_DEFAULT_PERP_DEX = exports.HYPERCORE_SPOT_DEX = exports.CORE_DEPOSIT_WALLET = exports.CORE_WRITER_PRECOMPILE = exports.HYPERCORE_SETTLEMENT_CHAIN_ID = exports.getHyperCoreDestinationDex = exports.HYPERCORE_ORIGIN_CHAIN_ID = exports.HYPERCORE_PERP_CHAIN_ID = exports.HYPERCORE_SPOT_CHAIN_ID = exports.getSupportedOftTokens = exports.hasOftSupport = exports.getOftConfig = exports.OFT_REGISTRY = exports.TestnetNetwork = exports.OPStackChains = exports.MainnetNetwork = exports.testnetChains = exports.mainnetChains = exports.chains = exports.contractAddressesDev = exports.contractAddresses = exports.testnetChainList = exports.mainnetChainList = exports.providerRegistry = exports.chainRegistry = void 0;
 exports.chainHasUnpricedTokens = chainHasUnpricedTokens;
 const chains_json_1 = __importDefault(require("../configs/chains.json"));
 const mainnets_json_1 = __importDefault(require("../configs/mainnets.json"));
@@ -44,9 +44,12 @@ Object.defineProperty(exports, "CORE_DEPOSIT_WALLET", { enumerable: true, get: f
 Object.defineProperty(exports, "CORE_WRITER_PRECOMPILE", { enumerable: true, get: function () { return hypercore_1.CORE_WRITER_PRECOMPILE; } });
 Object.defineProperty(exports, "getApproveCoreDepositWalletCall", { enumerable: true, get: function () { return hypercore_1.getApproveCoreDepositWalletCall; } });
 Object.defineProperty(exports, "getDepositForCall", { enumerable: true, get: function () { return hypercore_1.getDepositForCall; } });
-Object.defineProperty(exports, "HYPERCORE_CHAIN_ID", { enumerable: true, get: function () { return hypercore_1.HYPERCORE_CHAIN_ID; } });
+Object.defineProperty(exports, "getHyperCoreDestinationDex", { enumerable: true, get: function () { return hypercore_1.getHyperCoreDestinationDex; } });
 Object.defineProperty(exports, "HYPERCORE_DEFAULT_PERP_DEX", { enumerable: true, get: function () { return hypercore_1.HYPERCORE_DEFAULT_PERP_DEX; } });
+Object.defineProperty(exports, "HYPERCORE_ORIGIN_CHAIN_ID", { enumerable: true, get: function () { return hypercore_1.HYPERCORE_ORIGIN_CHAIN_ID; } });
+Object.defineProperty(exports, "HYPERCORE_PERP_CHAIN_ID", { enumerable: true, get: function () { return hypercore_1.HYPERCORE_PERP_CHAIN_ID; } });
 Object.defineProperty(exports, "HYPERCORE_SETTLEMENT_CHAIN_ID", { enumerable: true, get: function () { return hypercore_1.HYPERCORE_SETTLEMENT_CHAIN_ID; } });
+Object.defineProperty(exports, "HYPERCORE_SPOT_CHAIN_ID", { enumerable: true, get: function () { return hypercore_1.HYPERCORE_SPOT_CHAIN_ID; } });
 Object.defineProperty(exports, "HYPERCORE_SPOT_DEX", { enumerable: true, get: function () { return hypercore_1.HYPERCORE_SPOT_DEX; } });
 Object.defineProperty(exports, "HYPERCORE_USDC_ACTIVATION_FEE", { enumerable: true, get: function () { return hypercore_1.HYPERCORE_USDC_ACTIVATION_FEE; } });
 Object.defineProperty(exports, "isHyperCoreChainId", { enumerable: true, get: function () { return hypercore_1.isHyperCoreChainId; } });
@@ -55,6 +58,8 @@ const chainVirtualization_1 = require("./chainVirtualization");
 Object.defineProperty(exports, "chainIdFromCaip2", { enumerable: true, get: function () { return chainVirtualization_1.chainIdFromCaip2; } });
 Object.defineProperty(exports, "getCaip2", { enumerable: true, get: function () { return chainVirtualization_1.getCaip2; } });
 Object.defineProperty(exports, "getNonEvmChainIds", { enumerable: true, get: function () { return chainVirtualization_1.getNonEvmChainIds; } });
+Object.defineProperty(exports, "canBeDestination", { enumerable: true, get: function () { return chainVirtualization_1.canBeDestination; } });
+Object.defineProperty(exports, "canBeOrigin", { enumerable: true, get: function () { return chainVirtualization_1.canBeOrigin; } });
 Object.defineProperty(exports, "isNonEvmChainId", { enumerable: true, get: function () { return chainVirtualization_1.isNonEvmChainId; } });
 const chainFactsClient_1 = require("./chainFactsClient");
 Object.defineProperty(exports, "createChainFactsClient", { enumerable: true, get: function () { return chainFactsClient_1.createChainFactsClient; } });

package/dist/src/types.d.ts

@@ -73,6 +73,10 @@ interface NativeTokenEntry {
 interface SwapQuoterConfig {
     slug?: string;
 }
+interface ChainRoles {
+    origin: boolean;
+    destination: boolean;
+}
 interface ChainEntry {
     name: string;
     vmType: VmType;
@@ -133,6 +137,27 @@ interface ChainEntry {
      * real chains.
      */
     virtual?: boolean;
+    /**
+     * Which directions of value transfer this chain supports.
+     *
+     * `origin` — funds can ARRIVE from here (a deposit source).
+     * `destination` — funds can be DELIVERED here (an intent destination).
+     *
+     * Omitted means both, so every ordinary chain is unaffected.
+     *
+     * Declared rather than inferred because the answer varies WITHIN a CAIP-2
+     * namespace, which is how consumers currently decide it. The three HyperCore
+     * entries are all `hypercore:` and disagree: the Core L1 is a source only, the
+     * two venues are destinations only. A `switch (namespace)` cannot express that
+     * at all — not awkwardly, but not at all — so without this the split needs a
+     * chain-id special case in every consumer that publishes or validates a
+     * direction.
+     *
+     * A consumer may still be MORE restrictive than the registry (a service that
+     * can see a chain's deposits but chooses not to advertise them stays free to
+     * say so). This is the outer bound: what the chain itself permits.
+     */
+    roles?: ChainRoles;
     nativeToken: NativeTokenEntry;
     wrappedNativeToken: NativeTokenEntry;
     tokens: TokenEntry[];
@@ -184,4 +209,4 @@ interface ErpcConfig {
     providerIdPrefix: Record<string, string>;
 }
 export { OPStackChains, MainnetNetwork, TestnetNetwork, mainnetChains, testnetChains, chains, PEG_GROUPS };
-export type { ChainItem, ChainEntry, ChainExplorer, ChainNetwork, ChainRegistry, ChainStack, ChainList, ContractAddresses, ProviderRegistry, ProviderName, SettlementLayer, SupportedTestnet, SupportedMainnet, SupportedOPStackMainnet, SupportedOPStackTestnet, SupportedChain, SwapQuoter, SwapQuoterConfig, PegGroup, VmType, ErpcFailsafe, ErpcChainOverride, ErpcConfig, };
+export type { ChainItem, ChainEntry, ChainExplorer, ChainNetwork, ChainRegistry, ChainRoles, ChainStack, ChainList, ContractAddresses, ProviderRegistry, ProviderName, SettlementLayer, SupportedTestnet, SupportedMainnet, SupportedOPStackMainnet, SupportedOPStackTestnet, SupportedChain, SwapQuoter, SwapQuoterConfig, PegGroup, VmType, ErpcFailsafe, ErpcChainOverride, ErpcConfig, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rhinestone/shared-configs",
-  "version": "1.10.2",
+  "version": "1.11.0",
   "description": "Reusable configuration files for Rhinestone services",
   "author": {
     "name": "Rhinestone",