[sdk}: intent quote service

[ddboy19912]

feat(sdk): add partner-facing intent quote API (quoteIntent)

Summary

Adds a strategy-based intent quoting API to the SDK so partners can price IntentGateway V2 orders before placing them. Uniswap V4 is the only strategy today, but the API is strategy-shaped (strategy: "uniswap_v4" is the default) so new quote sources can be added without breaking partner integrations.

import { quoteIntent } from "@hyperbridge/sdk"

const quote = await quoteIntent({
  source: { chainId: "EVM-8453" },
  destination: { chainId: "EVM-8453" },
  tokenIn: { address: USDC, decimals: 6, symbol: "USDC" },
  tokenOut: { address: cNGN, decimals: 6, symbol: "cNGN" },
  amountIn: 100_000_000n,
})
// quote.amountIn / quote.amountOut → raw Uniswap V4 quoter amounts

What's included

• IntentQuoteService / quoteIntent() (protocols/intents/quote/) — supports exact-input and exact-output quotes. Returns the raw amounts from the Uniswap V4 quoter with no slippage or fee adjustments; partners apply their own tolerance. quoteMetadata exposes the resolved poolKey, quoterAddress, and the source-chain protocolFeeBps (read from IntentGatewayV2.params()) so callers can account for the gateway's input fee when constructing the order.
• Pool resolution — pools are resolved from SDK chain config (uniswapV4Pools, seeded with USDC/cNGN on Base). Same-chain quotes match configured pools by token address; cross-chain quotes match tokenIn by symbol since its source-chain address is meaningless against destination config. For unconfigured pairs, callers can pass an explicit uniswapV4.poolKey override (with optional quoterAddress and, for cross-chain quotes, currencyIn — the destination-side input currency, validated against the pool to prevent silently quoting the wrong swap direction).
• Config plumbing — uniswapV4Pools chain config field, ChainConfigService.getUniswapV4PoolConfigs() and getAssetAddress().
• Errors — UnsupportedIntentQuoteStrategyError, UnsupportedIntentQuotePairError, and a clear failure when the V4 quoter is not configured for a chain instead of an opaque eth_call failure.
• Docs — new quoteIntent(params) section in intent-gateway.mdx, including how to apply slippage and the protocol fee on top of the raw amounts.
• Test — live Base USDC → cNGN exact-input quote in tests/sequential/intentGateway.test.ts.

Notes for reviewers

• Quoted amounts are intentionally unadjusted: applying slippage tolerance and accounting for protocolFeeBps is the caller's responsibility (documented with a snippet in the docs).
• The V4 quoter is called via eth_call with manual encode/decode since its quote functions are nonpayable.

Test plan

• pnpm test:intent-gateway (live Base RPC) — quotes 1 USDC → cNGN through the configured V4 pool
• tsc --noEmit passes (two pre-existing errors in unrelated test files)

Closes #963

[seunlanlege]

better to be a method on the existing intent class

[seunlanlege]

(Retracted — this review was posted in error from a stale file and did not apply to this PR. Its inline comments have been removed. See the follow-up review for the actual feedback.)

[seunlanlege]

need to patch bump sdk

[ddboy19912]

need to patch bump sdk

It's already patched to 2.2.1