@rallycash/networks 0.0.0-stage → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @rallycash/networks
+
+## 0.2.0
+
+### Minor Changes
+
+- 6a6c767: EVM wallets require `signTypedData` and Solana wallets require `signMessage`. Add `@rallycash/networks` for the shared product chain list.

package/README.md

@@ -1,3 +1,7 @@
-# Temporary Holding Version
+# `@rallycash/networks`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Product chain list shared by Rally apps. It does not read `process.env`.
+
+`ALL_NETWORKS` is the swappable on-chain list (Arbitrum, Robinhood, Base, Solana). Hyperliquid perps is a separate family: Relay's 16-byte USDC id is not an EVM address. `getNetwork` still resolves it.
+
+Solana's chain id here is `1399811149`. `@rallycash/sendor` quotes Solana as `792703809`.

package/dist/index.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Chains Rally products know about.
+ * `usdToken` is the stablecoin users send on that chain (USDC on
+ * Arbitrum and Base, USDG on Robinhood).
+ *
+ * Families are separate collections with a literal discriminant.
+ * Hyperliquid perps are a third family: Relay's 16-byte USDC id is not an
+ * EVM address, so it is not an EvmNetwork. `ALL_NETWORKS` is the swappable
+ * on-chain list (EVM and Solana). `getNetwork` still resolves Hyperliquid.
+ */
+export type EvmNetworkId = 'arbitrum' | 'robinhood' | 'base';
+export type SvmNetworkId = 'solana';
+export type HyperliquidNetworkId = 'hyperliquid';
+/** Product chains. Hyperliquid is not one of these. */
+export type NetworkId = EvmNetworkId | SvmNetworkId;
+export type EvmChainId = 42161 | 4663 | 8453;
+export type SvmChainId = 1399811149;
+/** Relay Hyperliquid perps chain. The 16-byte USDC id is not an EVM address. */
+export declare const HYPERLIQUID_PERPS_CHAIN_ID = 1337;
+export declare const HYPERLIQUID_PERPS_USDC_ADDRESS = "0x00000000000000000000000000000000";
+export type HyperliquidChainId = typeof HYPERLIQUID_PERPS_CHAIN_ID;
+export type UsdToken = {
+    symbol: string;
+    name: string;
+    decimals: number;
+    address: string;
+};
+type NetworkIdentity = {
+    chainId: number;
+    displayName: string;
+    usdToken: UsdToken;
+};
+export type EvmNetwork = NetworkIdentity & {
+    id: EvmNetworkId;
+    chainId: EvmChainId;
+    accent: string;
+    isEvm: true;
+    isSvm: false;
+    machine: 'evm';
+};
+export type SvmNetwork = NetworkIdentity & {
+    id: SvmNetworkId;
+    chainId: SvmChainId;
+    accent: string;
+    isEvm: false;
+    isSvm: true;
+    machine: 'svm';
+};
+/** Relay perps identity only. Settlement fields live on EVM and SVM networks. */
+export type HyperliquidNetwork = NetworkIdentity & {
+    id: HyperliquidNetworkId;
+    chainId: HyperliquidChainId;
+};
+/** Chains ordinary buys, cash balances, and Privy can use. */
+export type Network = EvmNetwork | SvmNetwork;
+/** Every network `getNetwork` can return. */
+export type KnownNetwork = Network | HyperliquidNetwork;
+export declare const ARBITRUM: EvmNetwork;
+export declare const ROBINHOOD: EvmNetwork;
+export declare const BASE: EvmNetwork;
+/** Solana USDC mint. Base58 is case-sensitive. */
+export declare const SOLANA: SvmNetwork;
+/**
+ * Relay Hyperliquid perps USDC. Chain 1337, 16-byte zero currency id.
+ * Decimals are 8: Relay's quote for 10 USDC posts amount "1000000000".
+ */
+export declare const HYPERLIQUID: HyperliquidNetwork;
+export declare const EVM_NETWORKS: readonly EvmNetwork[];
+export declare const SVM_NETWORKS: readonly SvmNetwork[];
+export declare const HYPERLIQUID_NETWORKS: readonly HyperliquidNetwork[];
+/** On-chain networks a buy, balance, or delegation can settle on. */
+export declare const ALL_NETWORKS: readonly Network[];
+export declare function isEvmNetwork(network: KnownNetwork): network is EvmNetwork;
+export declare function isSvmNetwork(network: KnownNetwork): network is SvmNetwork;
+export declare function isHyperliquidNetwork(network: KnownNetwork): network is HyperliquidNetwork;
+export declare function isEvmNetworkId(value: string): value is EvmNetworkId;
+export declare function isSvmNetworkId(value: string): value is SvmNetworkId;
+export declare function isHyperliquidNetworkId(value: string): value is HyperliquidNetworkId;
+export declare function getNetwork(id: EvmNetworkId): EvmNetwork;
+export declare function getNetwork(id: EvmChainId): EvmNetwork;
+export declare function getNetwork(id: SvmNetworkId): SvmNetwork;
+export declare function getNetwork(id: SvmChainId): SvmNetwork;
+export declare function getNetwork(id: HyperliquidNetworkId): HyperliquidNetwork;
+export declare function getNetwork(id: HyperliquidChainId): HyperliquidNetwork;
+export declare function getNetwork(id: NetworkId): Network;
+export declare function getNetwork(id: NetworkId | HyperliquidNetworkId): KnownNetwork;
+export declare function getNetwork(id: number): KnownNetwork;
+export declare const NetworkUtils: {
+    getNetwork: typeof getNetwork;
+    isEvmNetwork: typeof isEvmNetwork;
+    isSvmNetwork: typeof isSvmNetwork;
+    isHyperliquidNetwork: typeof isHyperliquidNetwork;
+    isEvmNetworkId: typeof isEvmNetworkId;
+    isSvmNetworkId: typeof isSvmNetworkId;
+    isHyperliquidNetworkId: typeof isHyperliquidNetworkId;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,124 @@
+/** Relay Hyperliquid perps chain. The 16-byte USDC id is not an EVM address. */
+export const HYPERLIQUID_PERPS_CHAIN_ID = 1337;
+export const HYPERLIQUID_PERPS_USDC_ADDRESS = '0x00000000000000000000000000000000';
+export const ARBITRUM = {
+    id: 'arbitrum',
+    chainId: 42161,
+    displayName: 'Arbitrum',
+    isEvm: true,
+    isSvm: false,
+    machine: 'evm',
+    accent: '#28A0F0',
+    usdToken: {
+        symbol: 'USDC',
+        name: 'USD Coin',
+        decimals: 6,
+        address: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+    },
+};
+export const ROBINHOOD = {
+    id: 'robinhood',
+    chainId: 4663,
+    displayName: 'Robinhood',
+    isEvm: true,
+    isSvm: false,
+    machine: 'evm',
+    accent: '#00C805',
+    usdToken: {
+        symbol: 'USDG',
+        name: 'Global Dollar',
+        decimals: 6,
+        address: '0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168',
+    },
+};
+export const BASE = {
+    id: 'base',
+    chainId: 8453,
+    displayName: 'Base',
+    isEvm: true,
+    isSvm: false,
+    machine: 'evm',
+    accent: '#0052FF',
+    usdToken: {
+        symbol: 'USDC',
+        name: 'USD Coin',
+        decimals: 6,
+        address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+    },
+};
+/** Solana USDC mint. Base58 is case-sensitive. */
+export const SOLANA = {
+    id: 'solana',
+    chainId: 1399811149,
+    displayName: 'Solana',
+    isEvm: false,
+    isSvm: true,
+    machine: 'svm',
+    accent: '#9945FF',
+    usdToken: {
+        symbol: 'USDC',
+        name: 'USD Coin',
+        decimals: 6,
+        address: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+    },
+};
+/**
+ * Relay Hyperliquid perps USDC. Chain 1337, 16-byte zero currency id.
+ * Decimals are 8: Relay's quote for 10 USDC posts amount "1000000000".
+ */
+export const HYPERLIQUID = {
+    id: 'hyperliquid',
+    chainId: HYPERLIQUID_PERPS_CHAIN_ID,
+    displayName: 'Hyperliquid',
+    usdToken: {
+        symbol: 'USDC',
+        name: 'USDC (Perps)',
+        decimals: 8,
+        address: HYPERLIQUID_PERPS_USDC_ADDRESS,
+    },
+};
+export const EVM_NETWORKS = [ARBITRUM, ROBINHOOD, BASE];
+export const SVM_NETWORKS = [SOLANA];
+export const HYPERLIQUID_NETWORKS = [HYPERLIQUID];
+/** On-chain networks a buy, balance, or delegation can settle on. */
+export const ALL_NETWORKS = [...EVM_NETWORKS, ...SVM_NETWORKS];
+const knownNetworks = [...ALL_NETWORKS, ...HYPERLIQUID_NETWORKS];
+const EVM_NETWORK_IDS = new Set(EVM_NETWORKS.map((network) => network.id));
+const SVM_NETWORK_IDS = new Set(SVM_NETWORKS.map((network) => network.id));
+const HYPERLIQUID_NETWORK_IDS = new Set(HYPERLIQUID_NETWORKS.map((network) => network.id));
+export function isEvmNetwork(network) {
+    return 'isEvm' in network && network.isEvm;
+}
+export function isSvmNetwork(network) {
+    return 'isSvm' in network && network.isSvm;
+}
+export function isHyperliquidNetwork(network) {
+    return network.id === 'hyperliquid';
+}
+export function isEvmNetworkId(value) {
+    return EVM_NETWORK_IDS.has(value);
+}
+export function isSvmNetworkId(value) {
+    return SVM_NETWORK_IDS.has(value);
+}
+export function isHyperliquidNetworkId(value) {
+    return HYPERLIQUID_NETWORK_IDS.has(value);
+}
+export function getNetwork(chainIdOrId) {
+    const network = typeof chainIdOrId === 'number'
+        ? knownNetworks.find((item) => item.chainId === chainIdOrId)
+        : knownNetworks.find((item) => item.id === chainIdOrId);
+    if (!network) {
+        throw new Error(`Unsupported network: ${String(chainIdOrId)}`);
+    }
+    return network;
+}
+export const NetworkUtils = {
+    getNetwork,
+    isEvmNetwork,
+    isSvmNetwork,
+    isHyperliquidNetwork,
+    isEvmNetworkId,
+    isSvmNetworkId,
+    isHyperliquidNetworkId,
+};

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "@rallycash/networks",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Shared chain list for Rally products",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "../../node_modules/.bin/tsc -b --force",
+    "typecheck": "../../node_modules/.bin/tsc --noEmit -p tsconfig.json",
+    "test": "../../node_modules/.bin/vitest run"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  }
 }

package/src/index.test.ts

@@ -0,0 +1,39 @@
+import { describe, expect, it } from 'vitest'
+import {
+  ALL_NETWORKS,
+  BASE,
+  HYPERLIQUID,
+  SOLANA,
+  getNetwork,
+  isEvmNetwork,
+  isHyperliquidNetwork,
+  isSvmNetwork,
+} from './index.js'
+
+describe('getNetwork', () => {
+  it('resolves product chains by id and chain id', () => {
+    expect(getNetwork('base')).toBe(BASE)
+    expect(getNetwork(8453).usdToken.symbol).toBe('USDC')
+    expect(getNetwork('solana')).toBe(SOLANA)
+    expect(getNetwork(1399811149).machine).toBe('svm')
+  })
+
+  it('resolves Hyperliquid without treating it as a swappable network', () => {
+    expect(getNetwork('hyperliquid')).toBe(HYPERLIQUID)
+    expect(getNetwork(1337).usdToken.decimals).toBe(8)
+    expect(isHyperliquidNetwork(getNetwork(1337))).toBe(true)
+    expect(ALL_NETWORKS.some((network) => network.id === 'hyperliquid')).toBe(false)
+  })
+
+  it('narrows EVM and Solana', () => {
+    const base = getNetwork('base')
+    const solana = getNetwork('solana')
+    expect(isEvmNetwork(base) && base.isEvm).toBe(true)
+    expect(isSvmNetwork(solana) && solana.isSvm).toBe(true)
+    expect(isEvmNetwork(solana)).toBe(false)
+  })
+
+  it('rejects an unknown chain', () => {
+    expect(() => getNetwork(777)).toThrow('Unsupported network: 777')
+  })
+})

package/src/index.ts

@@ -0,0 +1,218 @@
+/**
+ * Chains Rally products know about.
+ * `usdToken` is the stablecoin users send on that chain (USDC on
+ * Arbitrum and Base, USDG on Robinhood).
+ *
+ * Families are separate collections with a literal discriminant.
+ * Hyperliquid perps are a third family: Relay's 16-byte USDC id is not an
+ * EVM address, so it is not an EvmNetwork. `ALL_NETWORKS` is the swappable
+ * on-chain list (EVM and Solana). `getNetwork` still resolves Hyperliquid.
+ */
+export type EvmNetworkId = 'arbitrum' | 'robinhood' | 'base'
+export type SvmNetworkId = 'solana'
+export type HyperliquidNetworkId = 'hyperliquid'
+
+/** Product chains. Hyperliquid is not one of these. */
+export type NetworkId = EvmNetworkId | SvmNetworkId
+
+export type EvmChainId = 42161 | 4663 | 8453
+export type SvmChainId = 1399811149
+
+/** Relay Hyperliquid perps chain. The 16-byte USDC id is not an EVM address. */
+export const HYPERLIQUID_PERPS_CHAIN_ID = 1337
+export const HYPERLIQUID_PERPS_USDC_ADDRESS = '0x00000000000000000000000000000000'
+
+export type HyperliquidChainId = typeof HYPERLIQUID_PERPS_CHAIN_ID
+
+export type UsdToken = {
+  symbol: string
+  name: string
+  decimals: number
+  address: string
+}
+
+type NetworkIdentity = {
+  chainId: number
+  displayName: string
+  usdToken: UsdToken
+}
+
+export type EvmNetwork = NetworkIdentity & {
+  id: EvmNetworkId
+  chainId: EvmChainId
+  accent: string
+  isEvm: true
+  isSvm: false
+  machine: 'evm'
+}
+
+export type SvmNetwork = NetworkIdentity & {
+  id: SvmNetworkId
+  chainId: SvmChainId
+  accent: string
+  isEvm: false
+  isSvm: true
+  machine: 'svm'
+}
+
+/** Relay perps identity only. Settlement fields live on EVM and SVM networks. */
+export type HyperliquidNetwork = NetworkIdentity & {
+  id: HyperliquidNetworkId
+  chainId: HyperliquidChainId
+}
+
+/** Chains ordinary buys, cash balances, and Privy can use. */
+export type Network = EvmNetwork | SvmNetwork
+
+/** Every network `getNetwork` can return. */
+export type KnownNetwork = Network | HyperliquidNetwork
+
+export const ARBITRUM: EvmNetwork = {
+  id: 'arbitrum',
+  chainId: 42161,
+  displayName: 'Arbitrum',
+  isEvm: true,
+  isSvm: false,
+  machine: 'evm',
+  accent: '#28A0F0',
+  usdToken: {
+    symbol: 'USDC',
+    name: 'USD Coin',
+    decimals: 6,
+    address: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+  },
+}
+
+export const ROBINHOOD: EvmNetwork = {
+  id: 'robinhood',
+  chainId: 4663,
+  displayName: 'Robinhood',
+  isEvm: true,
+  isSvm: false,
+  machine: 'evm',
+  accent: '#00C805',
+  usdToken: {
+    symbol: 'USDG',
+    name: 'Global Dollar',
+    decimals: 6,
+    address: '0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168',
+  },
+}
+
+export const BASE: EvmNetwork = {
+  id: 'base',
+  chainId: 8453,
+  displayName: 'Base',
+  isEvm: true,
+  isSvm: false,
+  machine: 'evm',
+  accent: '#0052FF',
+  usdToken: {
+    symbol: 'USDC',
+    name: 'USD Coin',
+    decimals: 6,
+    address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+  },
+}
+
+/** Solana USDC mint. Base58 is case-sensitive. */
+export const SOLANA: SvmNetwork = {
+  id: 'solana',
+  chainId: 1399811149,
+  displayName: 'Solana',
+  isEvm: false,
+  isSvm: true,
+  machine: 'svm',
+  accent: '#9945FF',
+  usdToken: {
+    symbol: 'USDC',
+    name: 'USD Coin',
+    decimals: 6,
+    address: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+  },
+}
+
+/**
+ * Relay Hyperliquid perps USDC. Chain 1337, 16-byte zero currency id.
+ * Decimals are 8: Relay's quote for 10 USDC posts amount "1000000000".
+ */
+export const HYPERLIQUID: HyperliquidNetwork = {
+  id: 'hyperliquid',
+  chainId: HYPERLIQUID_PERPS_CHAIN_ID,
+  displayName: 'Hyperliquid',
+  usdToken: {
+    symbol: 'USDC',
+    name: 'USDC (Perps)',
+    decimals: 8,
+    address: HYPERLIQUID_PERPS_USDC_ADDRESS,
+  },
+}
+
+export const EVM_NETWORKS: readonly EvmNetwork[] = [ARBITRUM, ROBINHOOD, BASE]
+export const SVM_NETWORKS: readonly SvmNetwork[] = [SOLANA]
+export const HYPERLIQUID_NETWORKS: readonly HyperliquidNetwork[] = [HYPERLIQUID]
+
+/** On-chain networks a buy, balance, or delegation can settle on. */
+export const ALL_NETWORKS: readonly Network[] = [...EVM_NETWORKS, ...SVM_NETWORKS]
+
+const knownNetworks: readonly KnownNetwork[] = [...ALL_NETWORKS, ...HYPERLIQUID_NETWORKS]
+
+const EVM_NETWORK_IDS = new Set<EvmNetworkId>(EVM_NETWORKS.map((network) => network.id))
+const SVM_NETWORK_IDS = new Set<SvmNetworkId>(SVM_NETWORKS.map((network) => network.id))
+const HYPERLIQUID_NETWORK_IDS = new Set<HyperliquidNetworkId>(
+  HYPERLIQUID_NETWORKS.map((network) => network.id),
+)
+
+export function isEvmNetwork(network: KnownNetwork): network is EvmNetwork {
+  return 'isEvm' in network && network.isEvm
+}
+
+export function isSvmNetwork(network: KnownNetwork): network is SvmNetwork {
+  return 'isSvm' in network && network.isSvm
+}
+
+export function isHyperliquidNetwork(network: KnownNetwork): network is HyperliquidNetwork {
+  return network.id === 'hyperliquid'
+}
+
+export function isEvmNetworkId(value: string): value is EvmNetworkId {
+  return EVM_NETWORK_IDS.has(value as EvmNetworkId)
+}
+
+export function isSvmNetworkId(value: string): value is SvmNetworkId {
+  return SVM_NETWORK_IDS.has(value as SvmNetworkId)
+}
+
+export function isHyperliquidNetworkId(value: string): value is HyperliquidNetworkId {
+  return HYPERLIQUID_NETWORK_IDS.has(value as HyperliquidNetworkId)
+}
+
+export function getNetwork(id: EvmNetworkId): EvmNetwork
+export function getNetwork(id: EvmChainId): EvmNetwork
+export function getNetwork(id: SvmNetworkId): SvmNetwork
+export function getNetwork(id: SvmChainId): SvmNetwork
+export function getNetwork(id: HyperliquidNetworkId): HyperliquidNetwork
+export function getNetwork(id: HyperliquidChainId): HyperliquidNetwork
+export function getNetwork(id: NetworkId): Network
+export function getNetwork(id: NetworkId | HyperliquidNetworkId): KnownNetwork
+export function getNetwork(id: number): KnownNetwork
+export function getNetwork(chainIdOrId: string | number): KnownNetwork {
+  const network =
+    typeof chainIdOrId === 'number'
+      ? knownNetworks.find((item) => item.chainId === chainIdOrId)
+      : knownNetworks.find((item) => item.id === chainIdOrId)
+  if (!network) {
+    throw new Error(`Unsupported network: ${String(chainIdOrId)}`)
+  }
+  return network
+}
+
+export const NetworkUtils = {
+  getNetwork,
+  isEvmNetwork,
+  isSvmNetwork,
+  isHyperliquidNetwork,
+  isEvmNetworkId,
+  isSvmNetworkId,
+  isHyperliquidNetworkId,
+}