@b3dotfun/sdk 0.1.70-alpha.2 → 0.1.70-alpha.21

package/node_modules/@b3/chain-registry/dist/index.d.cts

@@ -0,0 +1,195 @@
+interface ManualToken {
+    address: `0x${string}`;
+    symbol: string;
+    decimals: number;
+    name: string;
+    logoUrl?: string;
+}
+/**
+ * Known integration tags that can appear in `ChainDefinition.integrations`.
+ * Adding a new integration → extend this union. Consumers calling
+ * `chainsByIntegration("foo")` get autocomplete + typo safety.
+ */
+type KnownIntegration = "aerodrome" | "anyspend" | "cow-swap" | "evm-log" | "morpho" | "railgun" | "x402" | "zerodev";
+/** A chain's canonical/hub stablecoin(s). Bounded (1–3 per chain), not a general token registry —
+ *  the first entry is the chain's primary quote stablecoin. */
+interface StablecoinRef {
+    symbol: string;
+    address: string;
+}
+interface ChainDefinition {
+    chainId: number;
+    key: string;
+    name: string;
+    network: string;
+    /**
+     * DexScreener API chain id. Set explicitly for every registry chain known to
+     * be supported, even when equal to `network`; absence leaves provider routing
+     * opaque instead of guessing a slug.
+     */
+    dexscreenerNetwork?: string;
+    type: "evm" | "solana";
+    isTestnet: boolean;
+    integrations: KnownIntegration[];
+    /** Canonical stablecoins on this chain; `stablecoins[0]` is the hub. Optional — filled per chain
+     *  as needed (Robinhood/4663 → USDG for B3-5081). TS-only; Go does not consume it. */
+    stablecoins?: StablecoinRef[];
+    nativeCurrency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+    explorer: string;
+    rpcEnvKey: string | null;
+    fallbackRpc: string | null;
+    quicknodeSlug: string | null;
+    quicknodeRpcPath?: string;
+    coingecko: {
+        platform: string;
+        nativeCoinId: string;
+    } | null;
+    /**
+     * GeckoTerminal network slug (differs from `coingecko.platform`: GT uses
+     * "eth", CoinGecko uses "ethereum"). Used for on-chain pool lookups and
+     * OHLCV charts. Null when GeckoTerminal does not index this chain.
+     */
+    geckoTerminalNetwork?: string | null;
+    trustwalletSlug: string | null;
+    logoUrl: string | null;
+    tags: string[];
+    manualTokens?: ManualToken[];
+    /**
+     * Wrapped-native token address (ERC-20 or SPL).
+     * Used for market lookups on the native coin and for DEX routing that needs
+     * a wrapped form of the gas token.
+     */
+    wrappedNative?: string;
+    wrappedNativeCurrency?: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+}
+type TokenIdentityKind = "native" | "wrapped-native" | "contract";
+type TokenIdentityMatch = "canonical" | "exact" | "ranked";
+type PairTokenSide = "base" | "quote";
+declare const TOKEN_RESOLVER_SCHEMA_VERSION: 1;
+interface TokenResolverContractEnvelope {
+    schemaVersion: typeof TOKEN_RESOLVER_SCHEMA_VERSION;
+}
+interface ResolvedTokenIdentity {
+    kind: TokenIdentityKind;
+    matchedBy: TokenIdentityMatch;
+    chainId: string;
+    address: string | null;
+    marketAddress: string;
+    name: string;
+    symbol: string;
+    nativeSymbol: string | null;
+}
+interface TokenIdentityCandidate {
+    chainId: string;
+    /** DexScreener provider chain id used for follow-up market/detail requests. */
+    providerChainId?: string;
+    tokenAddress: string;
+    name: string;
+    symbol: string;
+    pairSide: PairTokenSide;
+    identity: ResolvedTokenIdentity;
+}
+interface NativeAssetDefinition {
+    chainId: number;
+    chain: string;
+    dexscreenerChain: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    wrapped: {
+        address: string;
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+}
+declare const chains: ChainDefinition[];
+interface DexScreenerChainIdentity {
+    /** Canonical B3 chain id for known chains; opaque provider id otherwise. */
+    identityChainId: string;
+    /** Exact DexScreener path/query chain id. */
+    providerChainId: string;
+    chainType: ChainDefinition["type"] | null;
+    registryChainId: number | null;
+}
+declare function resolveChainIdentifier(value: string): ChainDefinition | null;
+declare function chainTypeForIdentifier(value: string): ChainDefinition["type"] | null;
+/**
+ * Translate any registry alias to its DexScreener id while preserving valid
+ * provider-native ids for chains the local registry does not know.
+ */
+declare function resolveDexScreenerChainIdentifier(value: string): DexScreenerChainIdentity | null;
+declare function validateChainDefinitions(definitions: readonly ChainDefinition[]): ReadonlyMap<string, ChainDefinition>;
+declare function isSolanaAddress(value: string): boolean;
+declare function isEvmTokenAddress(value: string): boolean;
+declare function tokenAddressFamily(value: string): ChainDefinition["type"] | null;
+/** Address/coin identifier accepted from a bounded DexScreener provider row. */
+declare function isProviderTokenAddress(value: string): boolean;
+declare const nativeAssets: readonly NativeAssetDefinition[];
+/** Solana asset identities whose ticker/name may short-circuit text search.
+ * Deliberately narrower than `nativeAssets`: B3-5071 must not change EVM
+ * ticker routing while establishing canonical SOL/wSOL resolution. */
+declare const CANONICAL_NAME_ASSETS: readonly NativeAssetDefinition[];
+declare function matchCanonicalNativeAssetText(asset: NativeAssetDefinition, value: string): "native" | "wrapped-native" | null;
+declare const SOLANA_NATIVE_ASSET: NativeAssetDefinition;
+declare function createNativeTokenIdentity(asset: NativeAssetDefinition): ResolvedTokenIdentity;
+declare function createWrappedNativeTokenIdentity(asset: NativeAssetDefinition, matchedBy: "canonical" | "exact"): ResolvedTokenIdentity;
+declare function looksLikeTokenAddress(value: string): boolean;
+/**
+ * User input likely to be a provider token address. Canonical EVM/Solana
+ * formats and explicit namespaced coin types qualify; arbitrary long labels do not.
+ */
+declare function looksLikeProviderTokenAddress(value: string): boolean;
+declare function isTokenAddressForChain(chainId: string, value: string): boolean;
+declare function tokenAddressKey(chainId: string, value: string): string;
+declare function isResolvedTokenIdentity(value: unknown): value is ResolvedTokenIdentity;
+declare function isRegistryResolvedTokenIdentity(value: unknown): value is ResolvedTokenIdentity;
+declare function isTokenIdentityCandidate(value: unknown): value is TokenIdentityCandidate;
+declare function isRegistryTokenIdentityCandidate(value: unknown): value is TokenIdentityCandidate;
+declare const evmChains: ChainDefinition[];
+declare const chainById: Map<number, ChainDefinition>;
+declare const CHAIN_IDS: Record<string, number>;
+declare const CHAIN_NAMES: Record<number, string>;
+declare const CHAIN_ID_TO_NETWORK: Record<number, string>;
+declare const FALLBACK_RPC_URLS: Record<number, string>;
+declare const BLOCK_EXPLORERS: Record<number, string>;
+declare const COINGECKO_MAPPINGS: Record<number, {
+    platform: string;
+    nativeCoinId: string;
+}>;
+declare const TRUSTWALLET_SLUGS: Record<number, string>;
+declare const CHAIN_TAG_MAP: Record<string, number>;
+declare const LOGO_URLS: Record<number, string>;
+declare function buildQuicknodeUrl(subdomain: string, key: string, chain: ChainDefinition): string | null;
+declare function buildQuicknodeRpcMap(subdomain: string, key: string): Record<number, string>;
+declare function chainsByIntegration(integration: KnownIntegration): ChainDefinition[];
+declare function chainIdsByIntegration(integration: KnownIntegration): number[];
+declare function chainNamesByIntegration(integration: KnownIntegration): Record<number, string>;
+declare const ZERODEV_SUPPORTED_CHAINS: ChainDefinition[];
+/**
+ * Chains tagged with the "anyspend" integration AND of EVM type — the set
+ * consumed by SDK `supportedChains` / `supportedChainsTW` for AnySpend's
+ * wallet-switch gate (`useUnifiedChainSwitchAndExecute`). Solana (also tagged
+ * anyspend) is excluded here because it's handled by Phantom-based flows that
+ * key off `RELAY_SOLANA_MAINNET_CHAIN_ID`, not viem.
+ */
+declare const ANYSPEND_EVM_CHAINS: ChainDefinition[];
+/**
+ * Chain IDs that declare `manualTokens` — their holdings must be enumerated
+ * from that list rather than discovered, so balance/metadata for them comes
+ * from RPC + CoinGecko instead of a portfolio indexer.
+ */
+declare const MANUAL_CHAIN_IDS: ReadonlySet<number>;
+declare function hasManualTokens(chainId: number): boolean;
+declare function getManualTokens(chainId: number): ManualToken[];
+declare function findManualToken(chainId: number, address: string): ManualToken | null;
+
+export { ANYSPEND_EVM_CHAINS, BLOCK_EXPLORERS, CANONICAL_NAME_ASSETS, CHAIN_IDS, CHAIN_ID_TO_NETWORK, CHAIN_NAMES, CHAIN_TAG_MAP, COINGECKO_MAPPINGS, type ChainDefinition, type DexScreenerChainIdentity, FALLBACK_RPC_URLS, type KnownIntegration, LOGO_URLS, MANUAL_CHAIN_IDS, type ManualToken, type NativeAssetDefinition, type PairTokenSide, type ResolvedTokenIdentity, SOLANA_NATIVE_ASSET, type StablecoinRef, TOKEN_RESOLVER_SCHEMA_VERSION, TRUSTWALLET_SLUGS, type TokenIdentityCandidate, type TokenIdentityKind, type TokenIdentityMatch, type TokenResolverContractEnvelope, ZERODEV_SUPPORTED_CHAINS, buildQuicknodeRpcMap, buildQuicknodeUrl, chainById, chainIdsByIntegration, chainNamesByIntegration, chainTypeForIdentifier, chains, chainsByIntegration, createNativeTokenIdentity, createWrappedNativeTokenIdentity, evmChains, findManualToken, getManualTokens, hasManualTokens, isEvmTokenAddress, isProviderTokenAddress, isRegistryResolvedTokenIdentity, isRegistryTokenIdentityCandidate, isResolvedTokenIdentity, isSolanaAddress, isTokenAddressForChain, isTokenIdentityCandidate, looksLikeProviderTokenAddress, looksLikeTokenAddress, matchCanonicalNativeAssetText, nativeAssets, resolveChainIdentifier, resolveDexScreenerChainIdentifier, tokenAddressFamily, tokenAddressKey, validateChainDefinitions };

package/node_modules/@b3/chain-registry/dist/index.d.ts

@@ -0,0 +1,195 @@
+interface ManualToken {
+    address: `0x${string}`;
+    symbol: string;
+    decimals: number;
+    name: string;
+    logoUrl?: string;
+}
+/**
+ * Known integration tags that can appear in `ChainDefinition.integrations`.
+ * Adding a new integration → extend this union. Consumers calling
+ * `chainsByIntegration("foo")` get autocomplete + typo safety.
+ */
+type KnownIntegration = "aerodrome" | "anyspend" | "cow-swap" | "evm-log" | "morpho" | "railgun" | "x402" | "zerodev";
+/** A chain's canonical/hub stablecoin(s). Bounded (1–3 per chain), not a general token registry —
+ *  the first entry is the chain's primary quote stablecoin. */
+interface StablecoinRef {
+    symbol: string;
+    address: string;
+}
+interface ChainDefinition {
+    chainId: number;
+    key: string;
+    name: string;
+    network: string;
+    /**
+     * DexScreener API chain id. Set explicitly for every registry chain known to
+     * be supported, even when equal to `network`; absence leaves provider routing
+     * opaque instead of guessing a slug.
+     */
+    dexscreenerNetwork?: string;
+    type: "evm" | "solana";
+    isTestnet: boolean;
+    integrations: KnownIntegration[];
+    /** Canonical stablecoins on this chain; `stablecoins[0]` is the hub. Optional — filled per chain
+     *  as needed (Robinhood/4663 → USDG for B3-5081). TS-only; Go does not consume it. */
+    stablecoins?: StablecoinRef[];
+    nativeCurrency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+    explorer: string;
+    rpcEnvKey: string | null;
+    fallbackRpc: string | null;
+    quicknodeSlug: string | null;
+    quicknodeRpcPath?: string;
+    coingecko: {
+        platform: string;
+        nativeCoinId: string;
+    } | null;
+    /**
+     * GeckoTerminal network slug (differs from `coingecko.platform`: GT uses
+     * "eth", CoinGecko uses "ethereum"). Used for on-chain pool lookups and
+     * OHLCV charts. Null when GeckoTerminal does not index this chain.
+     */
+    geckoTerminalNetwork?: string | null;
+    trustwalletSlug: string | null;
+    logoUrl: string | null;
+    tags: string[];
+    manualTokens?: ManualToken[];
+    /**
+     * Wrapped-native token address (ERC-20 or SPL).
+     * Used for market lookups on the native coin and for DEX routing that needs
+     * a wrapped form of the gas token.
+     */
+    wrappedNative?: string;
+    wrappedNativeCurrency?: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+}
+type TokenIdentityKind = "native" | "wrapped-native" | "contract";
+type TokenIdentityMatch = "canonical" | "exact" | "ranked";
+type PairTokenSide = "base" | "quote";
+declare const TOKEN_RESOLVER_SCHEMA_VERSION: 1;
+interface TokenResolverContractEnvelope {
+    schemaVersion: typeof TOKEN_RESOLVER_SCHEMA_VERSION;
+}
+interface ResolvedTokenIdentity {
+    kind: TokenIdentityKind;
+    matchedBy: TokenIdentityMatch;
+    chainId: string;
+    address: string | null;
+    marketAddress: string;
+    name: string;
+    symbol: string;
+    nativeSymbol: string | null;
+}
+interface TokenIdentityCandidate {
+    chainId: string;
+    /** DexScreener provider chain id used for follow-up market/detail requests. */
+    providerChainId?: string;
+    tokenAddress: string;
+    name: string;
+    symbol: string;
+    pairSide: PairTokenSide;
+    identity: ResolvedTokenIdentity;
+}
+interface NativeAssetDefinition {
+    chainId: number;
+    chain: string;
+    dexscreenerChain: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    wrapped: {
+        address: string;
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+}
+declare const chains: ChainDefinition[];
+interface DexScreenerChainIdentity {
+    /** Canonical B3 chain id for known chains; opaque provider id otherwise. */
+    identityChainId: string;
+    /** Exact DexScreener path/query chain id. */
+    providerChainId: string;
+    chainType: ChainDefinition["type"] | null;
+    registryChainId: number | null;
+}
+declare function resolveChainIdentifier(value: string): ChainDefinition | null;
+declare function chainTypeForIdentifier(value: string): ChainDefinition["type"] | null;
+/**
+ * Translate any registry alias to its DexScreener id while preserving valid
+ * provider-native ids for chains the local registry does not know.
+ */
+declare function resolveDexScreenerChainIdentifier(value: string): DexScreenerChainIdentity | null;
+declare function validateChainDefinitions(definitions: readonly ChainDefinition[]): ReadonlyMap<string, ChainDefinition>;
+declare function isSolanaAddress(value: string): boolean;
+declare function isEvmTokenAddress(value: string): boolean;
+declare function tokenAddressFamily(value: string): ChainDefinition["type"] | null;
+/** Address/coin identifier accepted from a bounded DexScreener provider row. */
+declare function isProviderTokenAddress(value: string): boolean;
+declare const nativeAssets: readonly NativeAssetDefinition[];
+/** Solana asset identities whose ticker/name may short-circuit text search.
+ * Deliberately narrower than `nativeAssets`: B3-5071 must not change EVM
+ * ticker routing while establishing canonical SOL/wSOL resolution. */
+declare const CANONICAL_NAME_ASSETS: readonly NativeAssetDefinition[];
+declare function matchCanonicalNativeAssetText(asset: NativeAssetDefinition, value: string): "native" | "wrapped-native" | null;
+declare const SOLANA_NATIVE_ASSET: NativeAssetDefinition;
+declare function createNativeTokenIdentity(asset: NativeAssetDefinition): ResolvedTokenIdentity;
+declare function createWrappedNativeTokenIdentity(asset: NativeAssetDefinition, matchedBy: "canonical" | "exact"): ResolvedTokenIdentity;
+declare function looksLikeTokenAddress(value: string): boolean;
+/**
+ * User input likely to be a provider token address. Canonical EVM/Solana
+ * formats and explicit namespaced coin types qualify; arbitrary long labels do not.
+ */
+declare function looksLikeProviderTokenAddress(value: string): boolean;
+declare function isTokenAddressForChain(chainId: string, value: string): boolean;
+declare function tokenAddressKey(chainId: string, value: string): string;
+declare function isResolvedTokenIdentity(value: unknown): value is ResolvedTokenIdentity;
+declare function isRegistryResolvedTokenIdentity(value: unknown): value is ResolvedTokenIdentity;
+declare function isTokenIdentityCandidate(value: unknown): value is TokenIdentityCandidate;
+declare function isRegistryTokenIdentityCandidate(value: unknown): value is TokenIdentityCandidate;
+declare const evmChains: ChainDefinition[];
+declare const chainById: Map<number, ChainDefinition>;
+declare const CHAIN_IDS: Record<string, number>;
+declare const CHAIN_NAMES: Record<number, string>;
+declare const CHAIN_ID_TO_NETWORK: Record<number, string>;
+declare const FALLBACK_RPC_URLS: Record<number, string>;
+declare const BLOCK_EXPLORERS: Record<number, string>;
+declare const COINGECKO_MAPPINGS: Record<number, {
+    platform: string;
+    nativeCoinId: string;
+}>;
+declare const TRUSTWALLET_SLUGS: Record<number, string>;
+declare const CHAIN_TAG_MAP: Record<string, number>;
+declare const LOGO_URLS: Record<number, string>;
+declare function buildQuicknodeUrl(subdomain: string, key: string, chain: ChainDefinition): string | null;
+declare function buildQuicknodeRpcMap(subdomain: string, key: string): Record<number, string>;
+declare function chainsByIntegration(integration: KnownIntegration): ChainDefinition[];
+declare function chainIdsByIntegration(integration: KnownIntegration): number[];
+declare function chainNamesByIntegration(integration: KnownIntegration): Record<number, string>;
+declare const ZERODEV_SUPPORTED_CHAINS: ChainDefinition[];
+/**
+ * Chains tagged with the "anyspend" integration AND of EVM type — the set
+ * consumed by SDK `supportedChains` / `supportedChainsTW` for AnySpend's
+ * wallet-switch gate (`useUnifiedChainSwitchAndExecute`). Solana (also tagged
+ * anyspend) is excluded here because it's handled by Phantom-based flows that
+ * key off `RELAY_SOLANA_MAINNET_CHAIN_ID`, not viem.
+ */
+declare const ANYSPEND_EVM_CHAINS: ChainDefinition[];
+/**
+ * Chain IDs that declare `manualTokens` — their holdings must be enumerated
+ * from that list rather than discovered, so balance/metadata for them comes
+ * from RPC + CoinGecko instead of a portfolio indexer.
+ */
+declare const MANUAL_CHAIN_IDS: ReadonlySet<number>;
+declare function hasManualTokens(chainId: number): boolean;
+declare function getManualTokens(chainId: number): ManualToken[];
+declare function findManualToken(chainId: number, address: string): ManualToken | null;
+
+export { ANYSPEND_EVM_CHAINS, BLOCK_EXPLORERS, CANONICAL_NAME_ASSETS, CHAIN_IDS, CHAIN_ID_TO_NETWORK, CHAIN_NAMES, CHAIN_TAG_MAP, COINGECKO_MAPPINGS, type ChainDefinition, type DexScreenerChainIdentity, FALLBACK_RPC_URLS, type KnownIntegration, LOGO_URLS, MANUAL_CHAIN_IDS, type ManualToken, type NativeAssetDefinition, type PairTokenSide, type ResolvedTokenIdentity, SOLANA_NATIVE_ASSET, type StablecoinRef, TOKEN_RESOLVER_SCHEMA_VERSION, TRUSTWALLET_SLUGS, type TokenIdentityCandidate, type TokenIdentityKind, type TokenIdentityMatch, type TokenResolverContractEnvelope, ZERODEV_SUPPORTED_CHAINS, buildQuicknodeRpcMap, buildQuicknodeUrl, chainById, chainIdsByIntegration, chainNamesByIntegration, chainTypeForIdentifier, chains, chainsByIntegration, createNativeTokenIdentity, createWrappedNativeTokenIdentity, evmChains, findManualToken, getManualTokens, hasManualTokens, isEvmTokenAddress, isProviderTokenAddress, isRegistryResolvedTokenIdentity, isRegistryTokenIdentityCandidate, isResolvedTokenIdentity, isSolanaAddress, isTokenAddressForChain, isTokenIdentityCandidate, looksLikeProviderTokenAddress, looksLikeTokenAddress, matchCanonicalNativeAssetText, nativeAssets, resolveChainIdentifier, resolveDexScreenerChainIdentifier, tokenAddressFamily, tokenAddressKey, validateChainDefinitions };