@cowprotocol/sdk-common

npm install @cowprotocol/sdk-common

export type EvmAddressKey = `0x${string}`
export type BtcAddressKey = string
export type SolAddressKey = string
export type AddressKey = EvmAddressKey | BtcAddressKey | SolAddressKey

function isEvmAddress(
  address: string | null | undefined
): address is EvmAddressKey

import { isEvmAddress } from '@cowprotocol/sdk-common'

if (isEvmAddress('0x1234...')) {
  // Address is valid EVM format
}

function isBtcAddress(
  address: string | null | undefined
): address is BtcAddressKey

function isSolanaAddress(
  address: string | null | undefined
): address is SolAddressKey

function getEvmAddressKey(address: string): EvmAddressKey

import { getEvmAddressKey } from '@cowprotocol/sdk-common'

const key = getEvmAddressKey('0xABC...')
// Returns: '0xabc...'

function getAddressKey(address: string): AddressKey

interface TokenIdentifier {
  address: string
  chainId: ChainId
}

type TokenId = `${ChainId}:${AddressKey}`

function getTokenId(token: TokenIdentifier): TokenId

import { getTokenId } from '@cowprotocol/sdk-common'

const tokenId = getTokenId({
  chainId: 1,
  address: '0x...'
})
// Returns: '1:0x...'

function areTokensEqual(
  a: TokenLike | undefined | null,
  b: TokenLike | undefined | null
): boolean

function areAddressesEqual(
  a: Nullish<string>,
  b: Nullish<string>
): boolean

function isNativeToken(token: TokenLike): boolean

function isWrappedNativeToken(token: TokenLike): boolean

function percentageToBps(percentage: number | bigint): number

import { percentageToBps } from '@cowprotocol/sdk-common'

const bps = percentageToBps(0.5)
// Returns: 5000

function bpsToPercentage(bps: number): number

function applyPercentage(value: bigint, percentage: number): bigint

import { applyPercentage } from '@cowprotocol/sdk-common'

const increased = applyPercentage(100n, 1.1)
// Returns: 110n

function enableLogging(enabled: boolean): void

import { enableLogging } from '@cowprotocol/sdk-common'

// Enable debug logging
enableLogging(true)

function log(text: string): void

type Nullish<T> = T | null | undefined

import {
  GPV2SettlementAbi,
  EthFlowAbi,
  Erc20Abi
} from '@cowprotocol/sdk-common'

// Ethereum-compatible types
type BigIntish = string | number | bigint
type Bytes = unknown
type Address = string

// EIP-712 Typed Data
interface TypedDataDomain {
  name?: string
  version?: string
  chainId?: number
  verifyingContract?: string
  salt?: string | Uint8Array
}

type TypedDataTypes = Record<string, Array<{ name: string; type: string }>>