@lombard.finance/sdk 4.0.0 → 4.1.0

package/src/common/chains.ts

@@ -1,449 +0,0 @@
-import { defineChain, type EIP1193Provider, extractChain } from 'viem';
-import { addChain as viem_addChain } from 'viem/actions';
-import * as viem_chains from 'viem/chains';
-
-import { makeWalletClient } from '../clients/wallet-client';
-import { featureConfig } from './feature-config';
-
-const {
-  avalanche,
-  avalancheFuji,
-  base,
-  baseSepolia,
-  berachain,
-  berachainTestnetbArtio,
-  bsc,
-  bscTestnet,
-  corn,
-  etherlink,
-  holesky,
-  mainnet,
-  morph,
-  morphHolesky,
-  sepolia,
-  sonic,
-  sonicBlazeTestnet,
-  swellchain,
-} = viem_chains;
-
-// FIXME: Remove this custom chain definition once katana is supported by viem
-export const katana = defineChain({
-  id: 747474,
-  name: 'Katana',
-  nativeCurrency: {
-    decimals: 18,
-    name: 'Ether',
-    symbol: 'ETH',
-  },
-  rpcUrls: {
-    default: {
-      http: ['https://rpc.katana.network'],
-      webSocket: ['wss://rpc.katana.network'],
-    },
-  },
-  blockExplorers: {
-    default: { name: 'Katana Explorer', url: 'https://explorer.katanarpc.com' },
-  },
-  contracts: {
-    multicall3: {
-      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
-      blockCreated: 1898013, // TODO: Confirm this
-    },
-  },
-});
-
-export const katanaTatara = defineChain({
-  testnet: true,
-  id: 129399,
-  name: 'Tatara',
-  nativeCurrency: {
-    decimals: 18,
-    name: 'Ether',
-    symbol: 'ETH',
-  },
-  rpcUrls: {
-    default: {
-      http: ['https://rpc.tatara.katanarpc.com'],
-    },
-  },
-  blockExplorers: {
-    default: {
-      name: 'Tatara Explorer',
-      url: 'https://explorer.tatara.katana.network',
-    },
-  },
-  contracts: {
-    multicall3: {
-      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
-      blockCreated: 7771207, // TODO: Confirm this
-    },
-  },
-});
-
-// FIXME: Remove this custom chain definition once TAC is supported by viem
-export const tac = defineChain({
-  id: 239,
-  name: 'TAC',
-  nativeCurrency: {
-    decimals: 18,
-    name: 'TAC',
-    symbol: 'TAC',
-  },
-  rpcUrls: {
-    default: {
-      http: ['https://rpc.tac.build'],
-    },
-  },
-  blockExplorers: {
-    default: { name: 'TAC Explorer', url: 'https://explorer.tac.build' },
-  },
-});
-
-export const bob = defineChain({
-  id: 60808,
-  name: 'BOB',
-  nativeCurrency: {
-    decimals: 18,
-    name: 'Ether',
-    symbol: 'ETH',
-  },
-  rpcUrls: {
-    default: {
-      http: ['https://rpc.gobob.xyz'],
-    },
-  },
-  blockExplorers: {
-    default: { name: 'BOB Explorer', url: 'https://explorer.gobob.xyz' },
-  },
-});
-
-export const bobSepolia = defineChain({
-  id: 808813,
-  name: 'BOB Sepolia',
-  nativeCurrency: {
-    decimals: 18,
-    name: 'Ether',
-    symbol: 'ETH',
-  },
-  rpcUrls: {
-    default: {
-      http: ['https://bob-sepolia.rpc.gobob.xyz'],
-    },
-  },
-  blockExplorers: {
-    default: {
-      name: 'BOB Sepolia Explorer',
-      url: 'https://bob-sepolia.explorer.gobob.xyz/',
-    },
-  },
-});
-
-export const monad = defineChain({
-  id: 143,
-  name: 'Monad',
-  nativeCurrency: {
-    decimals: 18,
-    name: 'Monad',
-    symbol: 'MONAD',
-  },
-  rpcUrls: {
-    default: {
-      http: ['https://monad-mainnet.drpc.org'],
-    },
-  },
-  blockExplorers: {
-    default: {
-      name: 'Monad Explorer',
-      url: 'https://monadvision.com',
-    },
-  },
-  contracts: {
-    multicall3: {
-      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
-      blockCreated: 9248132,
-    },
-  },
-});
-
-export const stable = defineChain({
-  id: 988,
-  name: 'Stable',
-  nativeCurrency: {
-    decimals: 18,
-    name: 'gUSDT',
-    symbol: 'gUSDT',
-  },
-  rpcUrls: {
-    default: {
-      http: [
-        'https://partners-rpc.stable.xyz/lombard.075830647a2c30190712a9d102011ffe5a2a01d24ff3405f711d6ea8aca10baf',
-      ],
-    }, // TODO: Update with the correct RPC URL once the stable network is live
-  },
-  blockExplorers: {
-    default: {
-      name: 'Stable Explorer',
-      url: 'https://stablescan.xyz',
-    },
-  },
-  contracts: {
-    multicall3: {
-      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
-      blockCreated: 1,
-    },
-  },
-});
-
-export const megaeth = defineChain({
-  id: 4326,
-  name: 'MegaETH',
-  nativeCurrency: {
-    decimals: 18,
-    name: 'Ether',
-    symbol: 'ETH',
-  },
-  rpcUrls: {
-    default: {
-      http: [
-        'https://alpha.megaeth.com/rpc?user=lombard+v1&token=1763427229-%2Bx6HFUDu9OhJwV%2FTCFOL0xTt%2FPJRAXPeirIcuytvnes%3D',
-      ],
-    },
-  },
-  blockExplorers: {
-    default: {
-      name: 'MegaETH Explorer',
-      url: 'http://megaeth-testnet-v3.blockscout.com',
-    },
-  },
-  contracts: {
-    multicall3: {
-      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
-      blockCreated: 2591807, // TODO: Confirm this
-    },
-  },
-});
-
-export const allChains: Record<string, viem_chains.Chain> = {
-  ...viem_chains,
-  katana,
-  katanaTatara,
-  tac,
-  monad,
-  stable,
-  megaeth,
-};
-
-export const SUI_DEVNET_CHAIN = 'sui:devnet' as const;
-export const SUI_TESTNET_CHAIN = 'sui:testnet' as const;
-export const SUI_LOCALNET_CHAIN = 'sui:localnet' as const;
-export const SUI_MAINNET_CHAIN = 'sui:mainnet' as const;
-
-export type SuiChain =
-  | typeof SUI_DEVNET_CHAIN
-  | typeof SUI_TESTNET_CHAIN
-  | typeof SUI_LOCALNET_CHAIN
-  | typeof SUI_MAINNET_CHAIN;
-
-export const isSuiChain = (chainId: unknown): chainId is SuiChain => {
-  return (
-    [
-      SUI_DEVNET_CHAIN,
-      SUI_TESTNET_CHAIN,
-      SUI_LOCALNET_CHAIN,
-      SUI_MAINNET_CHAIN,
-    ] as string[]
-  ).includes(chainId as string);
-};
-
-export const SOLANA_MAINNET_CHAIN = 'solana:mainnet-beta' as const;
-export const SOLANA_TESTNET_CHAIN = 'solana:testnet' as const;
-export const SOLANA_DEVNET_CHAIN = 'solana:devnet' as const;
-
-export type SolanaChain =
-  | typeof SOLANA_MAINNET_CHAIN
-  | typeof SOLANA_TESTNET_CHAIN
-  | typeof SOLANA_DEVNET_CHAIN;
-
-export const isSolanaChain = (chainId: unknown): chainId is SolanaChain => {
-  return (
-    [
-      SOLANA_MAINNET_CHAIN,
-      SOLANA_TESTNET_CHAIN,
-      SOLANA_DEVNET_CHAIN,
-    ] as string[]
-  ).includes(chainId as string);
-};
-
-// Starknet chain identifiers:
-export const STARKNET_MAINNET_CHAIN = '0x534e5f4d41494e' as const;
-export const STARKNET_SEPOLIA_CHAIN = '0x534e5f5345504f4c4941' as const;
-export type StarknetChainId =
-  | typeof STARKNET_MAINNET_CHAIN
-  | typeof STARKNET_SEPOLIA_CHAIN;
-
-export const isStarknetChainId = (
-  chainId: unknown,
-): chainId is StarknetChainId => {
-  return (
-    chainId === STARKNET_MAINNET_CHAIN || chainId === STARKNET_SEPOLIA_CHAIN
-  );
-};
-
-export const ChainId = {
-  ethereum: 1,
-  avalanche: 43114,
-  base: 8453,
-  berachain: 80094,
-  binanceSmartChain: 56,
-  corn: 21000000,
-  etherlink: 42793,
-  katana: 747474,
-  megaeth: 4326,
-  monad: 143,
-  morph: 2818,
-  sonic: 146,
-  stable: 988,
-  swell: 1923,
-  tac: 239,
-  bob: 60808,
-  // Testnets:
-  avalancheFuji: 43113,
-  baseSepoliaTestnet: 84532,
-  berachainBartioTestnet: 80084,
-  binanceSmartChainTestnet: 97,
-  holesky: 17000,
-  katanaTatara: 129399,
-  morphHolesky: 2810,
-  sepolia: 11155111,
-  sonicBlazeTestnet: 57054,
-} as const;
-
-export type ChainId = (typeof ChainId)[keyof typeof ChainId];
-
-export const CHAIN_ID_TO_VIEM_CHAIN_MAP = {
-  [ChainId.ethereum]: mainnet,
-  // Avalanche mainnet - BTC.b not released yet
-  ...(featureConfig.isAvalancheMainnetEnabled
-    ? { [ChainId.avalanche]: avalanche }
-    : {}),
-  [ChainId.base]: base,
-  // APP-1975: Feature-gated chains
-  ...(featureConfig.isBerachainEnabled
-    ? { [ChainId.berachain]: berachain }
-    : {}),
-  [ChainId.binanceSmartChain]: bsc,
-  ...(featureConfig.isCornEnabled ? { [ChainId.corn]: corn } : {}),
-  ...(featureConfig.isEtherlinkEnabled
-    ? { [ChainId.etherlink]: etherlink }
-    : {}),
-  [ChainId.katana]: katana,
-  [ChainId.megaeth]: megaeth,
-  [ChainId.monad]: monad,
-  ...(featureConfig.isMorphEnabled ? { [ChainId.morph]: morph } : {}),
-  [ChainId.sonic]: sonic,
-  [ChainId.stable]: stable,
-  ...(featureConfig.isSwellchainEnabled
-    ? { [ChainId.swell]: swellchain }
-    : {}),
-  ...(featureConfig.isTacEnabled ? { [ChainId.tac]: tac } : {}),
-  ...(featureConfig.isBobEnabled ? { [ChainId.bob]: bob } : {}),
-  // Testnets:
-  // Avalanche Fuji - enabled for testing (Silo integration)
-  ...(featureConfig.isAvalancheFujiEnabled
-    ? { [ChainId.avalancheFuji]: avalancheFuji }
-    : {}),
-  [ChainId.baseSepoliaTestnet]: baseSepolia,
-  ...(featureConfig.isBerachainEnabled
-    ? { [ChainId.berachainBartioTestnet]: berachainTestnetbArtio }
-    : {}),
-  [ChainId.binanceSmartChainTestnet]: bscTestnet,
-  [ChainId.holesky]: holesky,
-  [ChainId.katanaTatara]: katanaTatara,
-  ...(featureConfig.isMorphEnabled
-    ? { [ChainId.morphHolesky]: morphHolesky }
-    : {}),
-  [ChainId.sepolia]: sepolia,
-  [ChainId.sonicBlazeTestnet]: sonicBlazeTestnet,
-};
-
-type KatanaChain = typeof ChainId.katana | typeof ChainId.katanaTatara;
-export const isKatanaChain = (chainId: unknown): chainId is KatanaChain => {
-  return ([ChainId.katana, ChainId.katanaTatara] as number[]).includes(
-    chainId as number,
-  );
-};
-type MonadChain = typeof ChainId.monad;
-export const isMonadChain = (chainId: unknown): chainId is MonadChain => {
-  return chainId === ChainId.monad;
-};
-
-type EthereumChain = typeof ChainId.ethereum;
-export const isEthereumChain = (chainId: unknown): chainId is EthereumChain => {
-  return ([ChainId.ethereum] as number[]).includes(chainId as number);
-};
-
-type StableChain = typeof ChainId.stable;
-export const isStableChain = (chainId: unknown): chainId is StableChain => {
-  return chainId === ChainId.stable;
-};
-
-type MegaethChain = typeof ChainId.megaeth;
-export const isMegaethChain = (chainId: unknown): chainId is MegaethChain => {
-  return ([ChainId.megaeth] as number[]).includes(chainId as number);
-};
-export const CHAIN_ID_TO_LLAMA_CHAIN_NAME_MAP = {
-  [ChainId.ethereum]: 'ethereum',
-  ...(featureConfig.isAvalancheMainnetEnabled
-    ? { [ChainId.avalanche]: 'avalanche' }
-    : {}),
-  [ChainId.base]: 'base',
-  [ChainId.berachain]: 'berachain',
-  [ChainId.binanceSmartChain]: 'bsc',
-  [ChainId.corn]: 'corn',
-  [ChainId.etherlink]: 'etherlink',
-  [ChainId.morph]: 'morph',
-  [ChainId.sonic]: 'sonic',
-  [ChainId.swell]: 'swellchain',
-  [ChainId.megaeth]: 'megaeth',
-  [ChainId.monad]: 'monad',
-  [ChainId.katana]: 'katana',
-  [ChainId.stable]: 'stable',
-} as const;
-type LlamaChain =
-  (typeof CHAIN_ID_TO_LLAMA_CHAIN_NAME_MAP)[keyof typeof CHAIN_ID_TO_LLAMA_CHAIN_NAME_MAP];
-
-export function isValidChain(chainId: unknown): chainId is ChainId {
-  return Object.values(ChainId).includes(chainId as ChainId);
-}
-
-export type AddChainParameters = {
-  provider: EIP1193Provider;
-  chainId: ChainId;
-};
-
-export async function addChain({ provider, chainId }: AddChainParameters) {
-  const walletClient = makeWalletClient({
-    provider,
-    chainId: ChainId.ethereum,
-  });
-
-  const chain = CHAIN_ID_TO_VIEM_CHAIN_MAP[chainId];
-
-  if (!chain) {
-    throw new Error(`Chain ${chainId} not found`);
-  }
-
-  await viem_addChain(walletClient, {
-    chain,
-  });
-}
-export const getLlamaChainName = (chainId: ChainId): LlamaChain | undefined => {
-  const name =
-    CHAIN_ID_TO_LLAMA_CHAIN_NAME_MAP[
-      chainId as keyof typeof CHAIN_ID_TO_LLAMA_CHAIN_NAME_MAP
-    ];
-  return name;
-};
-
-export const getChain = (chainId: number): viem_chains.Chain | undefined =>
-  extractChain({ chains: Object.values(allChains), id: chainId as ChainId });

package/src/common/constants.ts

@@ -1 +0,0 @@
-export const MIN_STAKE_AMOUNT_BTC = 0.0002;

package/src/common/contract-info.ts

@@ -1,9 +0,0 @@
-import { Abi, Address } from 'viem';
-
-import { ChainId } from './chains';
-
-export type ContractInfo = {
-  abi: Abi;
-  address: Address;
-  chainId: ChainId;
-};

package/src/common/feature-config.ts

@@ -1,79 +0,0 @@
-export interface FeatureConfig {
-  /**
-   * Enable/disable Monad blockchain support
-   * @default true - Enabled
-   */
-  isMonadEnabled: boolean;
-
-  /**
-   * Enable/disable Avalanche mainnet support
-   * @default false - BTC.b not released on mainnet yet
-   */
-  isAvalancheMainnetEnabled: boolean;
-
-  /**
-   * Enable/disable Avalanche Fuji testnet support
-   * @default true - Enabled for testing
-   */
-  isAvalancheFujiEnabled: boolean;
-
-  /**
-   * Enable/disable Berachain support
-   * @default false - Not yet fully supported (APP-1975)
-   */
-  isBerachainEnabled: boolean;
-
-  /**
-   * Enable/disable Corn chain support
-   * @default false - Not yet fully supported (APP-1975)
-   */
-  isCornEnabled: boolean;
-
-  /**
-   * Enable/disable Morph chain support
-   * @default false - Not yet fully supported (APP-1975)
-   */
-  isMorphEnabled: boolean;
-
-  /**
-   * Enable/disable Swellchain support
-   * @default false - Not yet fully supported (APP-1975)
-   */
-  isSwellchainEnabled: boolean;
-
-  /**
-   * Enable/disable TAC chain support
-   * @default false - Not yet fully supported (APP-1975)
-   */
-  isTacEnabled: boolean;
-
-  /**
-   * Enable/disable BOB chain support
-   * @default false - Not yet fully supported (APP-1975)
-   */
-  isBobEnabled: boolean;
-
-  /**
-   * Enable/disable Etherlink chain support
-   * @default false - Not yet fully supported (APP-1975)
-   */
-  isEtherlinkEnabled: boolean;
-}
-
-export const featureConfig: FeatureConfig = {
-  isMonadEnabled: true,
-  // Avalanche mainnet - BTC.b not released yet, keep disabled
-  isAvalancheMainnetEnabled: false,
-  // Avalanche Fuji testnet - enabled for testing (Silo integration)
-  isAvalancheFujiEnabled: true,
-
-  isCornEnabled: true,
-  // APP-1975: Chains in asset catalog but not yet fully supported
-  // These are hidden from UI until fully tested and released
-  isBerachainEnabled: false,
-  isMorphEnabled: false,
-  isSwellchainEnabled: false,
-  isTacEnabled: false,
-  isBobEnabled: false,
-  isEtherlinkEnabled: false,
-};

package/src/common/fee-requirements.ts

@@ -1,34 +0,0 @@
-/**
- * Network fee requirement utilities
- *
- * Determines which chains require network fee authorization for auto-minting.
- */
-
-import type { ChainId } from './chains';
-
-/**
- * Chains that require network fee authorization (auto-mint fee)
- *
- * Ethereum mainnet and Sepolia (testnet) require fee authorization.
- * Other chains (Base, BSC, etc.) are subsidized - Lombard absorbs gas costs.
- */
-export const AUTO_MINT_FEE_CHAINS: readonly ChainId[] = [
-  1, // Ethereum mainnet
-  11155111, // Sepolia (testnet/stage)
-] as const;
-
-/**
- * Check if a chain requires network fee authorization
- *
- * @param chainId - The chain ID to check
- * @returns True if the chain requires fee authorization
- *
- * @example
- * ```ts
- * requiresAutoMintFee(1) // true (Ethereum)
- * requiresAutoMintFee(8453) // false (Base)
- * ```
- */
-export function requiresAutoMintFee(chainId: ChainId): boolean {
-  return AUTO_MINT_FEE_CHAINS.includes(chainId);
-}

package/src/common/parameters.ts

@@ -1,89 +0,0 @@
-import { Env } from '@lombard.finance/sdk-common';
-import { Address, EIP1193Provider } from 'viem';
-
-import { SignerAdapter } from '../clients/evm-signer-adapter';
-import { ChainId } from './chains';
-
-export interface IEnvParam {
-  /**
-   * Optional environment identifier. If not provided, it defaults to `prod`.
-   *
-   * @default Env.prod
-   */
-  env?: Env;
-}
-
-export interface CommonParameters extends IEnvParam {
-  /**
-   * Chain ID for identifying the blockchain network (e.g., Ethereum, Binance Smart Chain, etc.)
-   */
-  chainId: ChainId;
-
-  /**
-   * Optional RPC URL to connect to the blockchain. If not provided, a default RPC URL might be used.
-   */
-  rpcUrl?: string;
-}
-
-export interface CommonReadParameters extends CommonParameters {
-  /**
-   * The account address.
-   */
-  account: Address;
-}
-
-export interface CommonOptionalWriteParameters extends CommonParameters {
-  /**
-   * The provider (required). An instance of the `EIP1193Provider` which adheres to the EIP-1193 standard for communication with Ethereum-compatible providers.
-   * @type {EIP1193Provider}
-   */
-  provider?: EIP1193Provider;
-}
-
-/**
- * Common write parameters using an EIP-1193 provider (legacy flow).
- */
-export interface CommonWriteParameters extends CommonParameters {
-  /**
-   * The account address.
-   */
-  account: Address;
-  /**
-   * An instance of the `EIP1193Provider` which adheres to the EIP-1193 standard for communication with Ethereum-compatible providers.
-   * @type {EIP1193Provider}
-   */
-  provider: EIP1193Provider;
-}
-
-/**
- * Common write parameters using a SignerAdapter (unified bridge flow).
- */
-export interface CommonSignerWriteParameters extends CommonParameters {
-  /**
-   * The account address.
-   */
-  account: Address;
-  /**
-   * A SignerAdapter instance for transaction signing (compatible with unified bridge EvmSigner).
-   * @type {SignerAdapter}
-   */
-  signer: SignerAdapter;
-}
-
-/**
- * Type guard to check if parameters use provider flow.
- */
-export function isProviderFlow(
-  params: CommonWriteParameters | CommonSignerWriteParameters,
-): params is CommonWriteParameters {
-  return 'provider' in params;
-}
-
-/**
- * Type guard to check if parameters use signer flow.
- */
-export function isSignerFlow(
-  params: CommonWriteParameters | CommonSignerWriteParameters,
-): params is CommonSignerWriteParameters {
-  return 'signer' in params;
-}

package/src/config/defaults.ts

@@ -1,49 +0,0 @@
-import type { Env } from '@lombard.finance/sdk-common';
-
-import { ChainId } from '../common/chains';
-
-type ChainDescriptor = {
-  id: ChainId;
-  name: string;
-  type: 'evm' | 'bitcoin' | 'solana' | 'sui' | 'starknet';
-};
-
-interface FeatureFlags {
-  analytics: boolean;
-  sandbox: boolean;
-}
-
-/**
- * Default configuration for each environment
- */
-interface DefaultConfig {
-  chains: ChainDescriptor[];
-  features: FeatureFlags;
-}
-
-/**
- * Get default configuration for an environment
- *
- * @param env - Environment identifier
- * @returns Default configuration for the environment
- */
-export function getDefaultConfig(env: Env): DefaultConfig {
-  const baseFeatures: FeatureFlags = {
-    analytics: false,
-    sandbox: env !== 'prod',
-  };
-
-  // Default chains based on environment
-  const defaultChains: ChainDescriptor[] = [
-    {
-      id: env === 'prod' ? (1 as ChainId) : (11155111 as ChainId), // Ethereum mainnet or Sepolia
-      name: env === 'prod' ? 'Ethereum' : 'Sepolia',
-      type: 'evm',
-    },
-  ];
-
-  return {
-    chains: defaultChains,
-    features: baseFeatures,
-  };
-}