@stellect/wallet

Pure TypeScript interface definitions for Stellect wallet adapters. Zero runtime dependencies.

Purpose

This package defines the WalletProvider contract that all wallet adapters must implement. Other packages import types from here — they never depend on a specific adapter directly.

Install

npm install @stellect/wallet

Key Exports

WalletProvider Interface

interface WalletProvider {
  createWallet(name: string, options?: CreateWalletOptions): Promise<WalletDescriptor>
  loadWallet(name: string): Promise<WalletDescriptor>
  listWallets(): Promise<WalletDescriptor[]>
  sign(walletName: string, request: SignRequest): Promise<SignResult>
  getBalance(walletName: string, asset?: string): Promise<Balance>
  setPolicy(walletName: string, policy: SpendingPolicy): Promise<void>
  getHistory(walletName: string, options?: HistoryOptions): Promise<Transaction[]>
}

Error Classes

• PolicyRejectionError — Policy denied the transaction
• KeystoreError — Encryption/decryption failure
• InsufficientBalanceError — Not enough balance
• FacilitatorError — OpenZeppelin facilitator error
• X402Error — x402 handshake failure
• ServiceNotFoundError — Service not in registry

Types

WalletDescriptor, SignRequest, SignResult, SignContext, PolicyEvaluation, SpendingPolicy, Balance, AssetBalance, Transaction, HistoryOptions, StellarNetwork

License

MIT