@blend-money/sdk-types

Shared TypeScript type definitions for the Blend SDK ecosystem.

This package contains strict, documented domain and core primitives used by @blend-money/sdk-core and related packages. It exports only types (no runtime code) and models values like percentages and USD using Decimal.js at usage sites for precision.

Features

• Centralized types for SDK modules and domain models
• Strict TypeScript with dedicated primitives (Hex, ChainId)
• Decimal-first numeric modeling via Decimal.js type references
• ESM-only, type-only exports; zero runtime footprint

Install

pnpm add @blend-money/sdk-types

Typically consumed as a dependency of @blend-money/sdk-core, but can also be used directly in apps for shared typing.

Usage

import type {
  // Core primitives
  Hex,
  ChainId,
  BlendClientConfig,
  ApiResponseData,
  Txn,
  ActionPlan,
  // Domain types
  Percent,
  Usd,
  Price,
  Token,
  TokenAmount,
  AmountWithToken,
  VaultConfig,
  StrategyType,
  CrossChain,
  SafeResolution,
  YieldSummary,
  BalanceSummary,
  DepositRoute,
} from "@blend-money/sdk-types";

const base: ChainId = 8453;
const zeroData: Hex = "0x";

Exported Types

Core (src/core.ts)

• Hex – 0x-prefixed hex string
• ChainId – positive integer chain identifier
• BlendClientConfig – configuration shape for SDK clients
• ApiResponseData – generic JSON object map
• Txn – single onchain transaction descriptor
• ActionPlan – grouped approvals + execution transactions

Domain (src/domain.ts)

• Percent, Usd, Price – numeric wrappers using Decimal.js
• Token – ERC‑20 style token metadata
• TokenAmount – base units amount with decimals
• AmountWithToken – token + amount pair
• VaultConfig / StrategyType – strategy/vault identifiers
• CrossChain – minimal chain descriptor for cross-chain flows
• SafeResolution – result of Safe address resolution
• YieldSummary – condensed yield metrics for a vault/markets
• BalanceSummary – user/vault balance breakdowns
• DepositRoute – normalized deposit route descriptor

Notes

• This package exports types only; there is no runtime logic. It is safe for both browser and Node environments.
• Numeric types reference Decimal from decimal.js to encourage precise arithmetic at call sites.

Requirements

• Node.js ≥ 20
• TypeScript ≥ 5.9

License

MIT