@rhinestone/shared-configs 1.16.0 → 1.17.0

package/dist/src/index.d.ts

@@ -1,6 +1,6 @@
 import { contractAddresses } from "./generated/contracts";
 import { contractAddresses as contractAddressesDev } from "./generated/contracts.dev";
-import type { ChainEntry, ChainExplorer, ChainItem, ChainList, ChainNetwork, ChainStack, ChainRegistry, ChainRoles, ProviderName, ProviderRegistry, SettlementLayer, SupportedChain, SupportedMainnet, SupportedOPStackMainnet, SupportedOPStackTestnet, SupportedTestnet, SwapQuoter } from "./types";
+import type { CctpChainConfig, ChainEntry, ChainExplorer, ChainItem, ChainList, ChainNetwork, ChainStack, ChainRegistry, ChainRoles, NearChainConfig, OftChainConfig, ProviderName, ProviderRegistry, RhinoChainConfig, SettlementConfig, 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";
@@ -16,5 +16,5 @@ 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_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 type { ChainEntry, ChainExplorer, ChainItem, ChainList, ChainNetwork, ChainStack, ChainRegistry, ChainRoles, ProviderRegistry, ProviderName, SwapQuoter, SupportedMainnet, SupportedTestnet, SupportedChain, SupportedOPStackMainnet, SupportedOPStackTestnet, SettlementLayer, SettlementConfig, CctpChainConfig, NearChainConfig, OftChainConfig, RhinoChainConfig, OftConfig, PegGroup, ChainFactsClient, ChainFactsClientOptions, ChainFactsErrorPhase, ChainFactsPayload, ChainFactsSnapshot, ChainFactsSource, };
 export * from "./abis";

package/dist/src/types.d.ts

@@ -50,6 +50,28 @@ interface TokenEntry {
      * this field is a no-op.
      */
     settlementLayers?: SettlementLayer[];
+    /**
+     * The symbol Rhino's bridge API expects for this token, where it differs from
+     * ours — `USDT0` is our label for LayerZero-bridged Tether, which Rhino calls
+     * `USDT` on the chains where the two are the same contract.
+     *
+     * Absent means the symbol passes through unchanged, which is the common case.
+     * Declared per token rather than globally because on some chains our `USDT0`
+     * and Rhino's `USDT` are DIFFERENT contracts, and translating there would
+     * route a transfer to a token the user does not hold.
+     */
+    rhinoSymbol?: string;
+    /**
+     * This token's NEAR 1Click asset id, for chains where 1Click does not derive
+     * it from the on-chain address.
+     *
+     * EVM tokens follow `nep141:{prefix}-{address}.omft.near` and carry nothing
+     * here; 1Click wraps each non-EVM token under its own NEAR-internal id that
+     * is not derivable, so those declare it. Absent on a chain whose entry has a
+     * `settlementConfig.near` and a non-EVM `vmType` means the token cannot be a
+     * NEAR destination at all — the build rejects that, so it should not occur.
+     */
+    nearAssetId?: string;
     unpriced?: boolean;
 }
 /**
@@ -77,6 +99,54 @@ interface ChainRoles {
     origin: boolean;
     destination: boolean;
 }
+/** How Rhino's bridge API names and reaches this chain. */
+interface RhinoChainConfig {
+    /** Rhino's own chain identifier, as its quote API expects it (`ETHEREUM`). */
+    chainName: string;
+    /**
+     * The DVFDepositContract `depositWithId` is called on. Absent for a
+     * destination-only chain (Solana, Tron), which nothing originates from — not
+     * a gap to fall back from.
+     */
+    bridgeContract?: string;
+}
+/** Circle CCTP's domain id for this chain. `0` is Ethereum, not "unset". */
+interface CctpChainConfig {
+    domain: number;
+}
+/** NEAR 1Click's per-chain asset prefix (`eth`, `arb`, `sol`). */
+interface NearChainConfig {
+    prefix: string;
+}
+/** The LayerZero OFT deployment this chain settles over. */
+interface OftChainConfig {
+    /** OFT / OFT Adapter contract — third-party, not one of ours. */
+    adapter: string;
+    layerZeroEid: number;
+}
+/**
+ * Per-vendor addressing for the settlement layers this chain has enabled, one
+ * key per layer in `settlementLayers` that needs it.
+ *
+ * These are the identifiers a consumer cannot derive from anything else in the
+ * entry — a bridge's own name for the chain, a domain id, an asset prefix — and
+ * which every consumer previously kept as a hand-maintained table that drifted
+ * from this registry silently.
+ *
+ * Deliberately separate from the contracts block: consumers read every address
+ * there as Rhinestone-deployed and back an is-this-our-contract check with it,
+ * which these third-party addresses would corrupt.
+ *
+ * Absent, or a layer's key absent, means that layer needs no addressing here —
+ * `across`/`eco`/`relay` never appear. A key present for a layer NOT in
+ * `settlementLayers` should not occur; consumers gate on `settlementLayers`.
+ */
+interface SettlementConfig {
+    rhino?: RhinoChainConfig;
+    cctp?: CctpChainConfig;
+    near?: NearChainConfig;
+    oft?: OftChainConfig;
+}
 interface ChainEntry {
     name: string;
     vmType: VmType;
@@ -202,6 +272,7 @@ interface ChainEntry {
     wrappedNativeToken: NativeTokenEntry;
     tokens: TokenEntry[];
     settlementLayers: SettlementLayer[];
+    settlementConfig?: SettlementConfig;
     swapQuoters: SwapQuoter[];
     swapQuoterConfig?: Partial<Record<SwapQuoter, SwapQuoterConfig>>;
 }
@@ -249,4 +320,4 @@ interface ErpcConfig {
     providerIdPrefix: Record<string, string>;
 }
 export { OPStackChains, MainnetNetwork, TestnetNetwork, mainnetChains, testnetChains, chains, PEG_GROUPS };
-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, };
+export type { CctpChainConfig, ChainItem, ChainEntry, ChainExplorer, ChainNetwork, ChainRegistry, ChainRoles, ChainStack, ChainList, ContractAddresses, NearChainConfig, OftChainConfig, ProviderRegistry, ProviderName, RhinoChainConfig, SettlementConfig, 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.16.0",
+  "version": "1.17.0",
   "description": "Reusable configuration files for Rhinestone services",
   "author": {
     "name": "Rhinestone",