钱包引擎快速开始

git clone https://github.com/kaleidoswap/wallet-engine && cd wallet-engine
npm install
npm run example:tour

# 例如只用 RGB/RLN 与 Liquid
pnpm add @kaleidorg/wallet-engine @kaleidorg/wdk-wallet-rln @kaleidorg/wdk-wallet-liquid

import {
  ProtocolManager,
  CrossProtocolRouter,
  buildUnifiedReceiveURI,
  aggregateForLite,
} from '@kaleidorg/wallet-engine'
// 适配器位于携带 SDK 的子路径下，因此根入口始终不含任何 SDK。
import { createWdkRegistry } from '@kaleidorg/wallet-engine/adapters/wdk'

// 1. 构建一份基于 WDK 的适配器注册表（选择你需要的协议）。
const registry = createWdkRegistry({ enabled: ['RGB_LN', 'LIQUID', 'SPARK'] })

// 2. 连接每个协议（配置中携带助记词与接口端点）。
await registry.get('RGB_LN')!.connect({ protocol: 'RGB_LN', network: 'mainnet' /* … */ })
await registry.get('LIQUID')!.connect({ protocol: 'LIQUID', network: 'mainnet' /* … */ })

// 3. 一切都通过 manager 驱动 —— 应用代码里不出现任何协议 SDK。
const manager = new ProtocolManager({ defaultProtocol: 'RGB_LN' })
for (const a of registry.getAll()) manager.registerAdapter(a)

const assets = await manager.listAllAssets()   // 跨协议统一后的资产列表
const lite = aggregateForLite(assets)          // { btc, usd, other }

// 4. 由路由器决定用哪个协议支付目标地址。
const router = new CrossProtocolRouter(registry)
const { best, routes } = router.resolveSend('lnbc1…')

// 5. 一个任何钱包都能支付的二维码；Kaleido 钱包还能读取更丰富的参数。
const uri = buildUnifiedReceiveURI({
  btcAddress: 'bc1q…',
  lightningInvoice: 'lnbc1…',
  rgbInvoice: 'rgb:…',
  liquidAddress: 'lq1…',
})

import { setPlatform, consoleLogger } from '@kaleidorg/wallet-engine'

setPlatform({
  storage: myStorageProvider,   // IStorageProvider
  runtime: myRuntimeProvider,   // IRuntimeProvider —— 随机数与时钟
  logger: consoleLogger,
})