// this file is adapted from viem
// see it here https://github.com/wevm/viem/blob/main/src/types/eip1193.ts
// Copied from viem commit a098c98231d47ccac9bda1a944880b034020a1b5
// We copy it here for easier developer experience internally and also
// to lock in these types independent of viem potentially making changes

/**
 * Parameters for wallet_addEthereumChain RPC method (EIP-3085).
 * Used to request that a wallet adds a specific blockchain network.
 * @example
 * ```typescript
 * import { AddEthereumChainParameter } from '@tevm/decorators'
 *
 * const optimismChain: AddEthereumChainParameter = {
 *   chainId: '0xa',  // 10 in hex
 *   chainName: 'Optimism',
 *   nativeCurrency: {
 *     name: 'Ether',
 *     symbol: 'ETH',
 *     decimals: 18
 *   },
 *   rpcUrls: ['https://mainnet.optimism.io'],
 *   blockExplorerUrls: ['https://optimistic.etherscan.io']
 * }
 * ```
 */
export type AddEthereumChainParameter = {
	/** A 0x-prefixed hexadecimal string */
	chainId: string
	/** The chain name. */
	chainName: string
	/** Native currency for the chain. */
	nativeCurrency?: {
		name: string
		symbol: string
		decimals: number
	}
	rpcUrls: readonly string[]
	blockExplorerUrls?: string[]
	iconUrls?: string[]
}