@kaleidorg/wallet-engine 1.0.0-beta.36 → 1.0.0-beta.38

package/dist/lib/kaleido-client-manager.js

@@ -1,54 +1,123 @@
 /**
  * KaleidoClient Manager
- * Singleton manager for KaleidoClient lifecycle.
- * Ported from rate-extension/src/lib/kaleido-client-manager.ts
+ * Singleton manager for KaleidoClient lifecycle (RGB Lightning node + Kaleidoswap maker).
+ *
+ * Transport is either "http" (kaleido-sdk's HTTP RlnClient) or "nwc" (an
+ * RLN-shaped client over Nostr Wallet Connect). The NWC implementation carries
+ * a nostr/relay dependency, so it is NOT bundled here — the consumer injects a
+ * factory via `setNwcRlnClientFactory()` (the extension supplies its NwcRlnClient;
+ * React Native / node hosts that don't use NWC never register one).
  */
-import { KaleidoClient } from 'kaleido-sdk';
+import { KaleidoClient } from "kaleido-sdk";
+import { log } from "./log.js";
+import { ProtocolError } from "../types/base.js";
+let nwcRlnClientFactory = null;
+/**
+ * Register the NWC-backed RLN client factory. The extension calls this once at
+ * startup with `(uri) => new NwcRlnClient(uri)`. Without it, transport "nwc" throws.
+ */
+export function setNwcRlnClientFactory(factory) {
+    nwcRlnClientFactory = factory;
+}
+/**
+ * A MakerClient stand-in used in NWC mode when no maker URL is configured.
+ * Every access rejects with MAKER_NOT_CONFIGURED so swap flows fail loudly
+ * instead of silently hitting the wrong endpoint.
+ */
+function createMakerStub() {
+    return new Proxy({}, {
+        get() {
+            return () => Promise.reject(new ProtocolError("Maker API not configured. Set a maker URL to enable swaps.", "RGB_LN", "MAKER_NOT_CONFIGURED"));
+        },
+    });
+}
 class KaleidoClientManager {
     constructor() {
         this.client = null;
         this.config = null;
+        /** Held only in NWC mode so reset() can tear down the relay pool. */
+        this.nwcRln = null;
     }
+    /** Initialize the KaleidoClient with configuration. */
     initialize(config) {
+        // Tear down any prior NWC relay pool before replacing the client.
+        this.nwcRln?.close();
+        this.nwcRln = null;
         this.config = config;
+        if (config.transport === "nwc") {
+            if (!config.nwcUri) {
+                throw new ProtocolError("NWC connection string is required for transport 'nwc'", "RGB_LN", "NODE_NOT_CONFIGURED");
+            }
+            if (!nwcRlnClientFactory) {
+                throw new ProtocolError("NWC transport is not available: no NwcRlnClient factory registered. Call setNwcRlnClientFactory() at startup.", "RGB_LN", "NODE_NOT_CONFIGURED");
+            }
+            // Compose a KaleidoClient-shaped object: NWC-backed `.rln`, plus an
+            // optional HTTP `.maker` (a separate, transport-independent concern).
+            const rln = nwcRlnClientFactory(config.nwcUri);
+            this.nwcRln = rln;
+            const hasMaker = !!config.baseUrl;
+            const maker = hasMaker
+                ? KaleidoClient.create({ baseUrl: config.baseUrl, timeout: config.timeout }).maker
+                : createMakerStub();
+            this.client = {
+                rln,
+                maker,
+                hasNode: () => true,
+                hasMaker: () => hasMaker,
+                close: async () => rln.close(),
+            };
+            log.info("[KaleidoClientManager] Initialized NWC transport:", { hasMakerUrl: hasMaker });
+            return;
+        }
         this.client = KaleidoClient.create({
             baseUrl: config.baseUrl,
             nodeUrl: config.nodeUrl,
             apiKey: config.apiKey,
             timeout: config.timeout,
         });
-        console.log('[KaleidoClientManager] Initialized with config:', {
+        log.info("[KaleidoClientManager] Initialized with config:", {
             baseUrl: config.baseUrl,
             hasNodeUrl: !!config.nodeUrl,
             hasApiKey: !!config.apiKey,
         });
     }
+    /** @throws if not initialized */
     getClient() {
         if (!this.client) {
-            throw new Error('KaleidoClient not initialized. Call initialize() first.');
+            throw new Error("KaleidoClient not initialized. Call initialize() first.");
         }
         return this.client;
     }
     isInitialized() {
         return this.client !== null;
     }
+    /**
+     * Check if a node is reachable — either an HTTP node URL or an NWC link.
+     * Gates almost every RLN operation in the adapter.
+     */
     hasNode() {
-        return !!this.config?.nodeUrl;
+        return !!this.config?.nodeUrl || this.config?.transport === "nwc";
     }
     getConfig() {
         return this.config;
     }
+    /**
+     * Reset the client (disconnect and clear). Tears down the NWC relay pool
+     * when running the NWC transport so we don't leak sockets on reconnect.
+     */
     reset() {
+        this.nwcRln?.close();
+        this.nwcRln = null;
         this.client = null;
         this.config = null;
-        console.log('[KaleidoClientManager] Reset complete');
+        log.info("[KaleidoClientManager] Reset complete");
     }
+    /** Update configuration (re-initializes the client). */
     updateConfig(config) {
         if (!this.config) {
-            throw new Error('Cannot update config: client not initialized');
+            throw new Error("Cannot update config: client not initialized");
         }
-        const newConfig = { ...this.config, ...config };
-        this.initialize(newConfig);
+        this.initialize({ ...this.config, ...config });
     }
 }
 export const kaleidoClientManager = new KaleidoClientManager();

package/dist/lib/kaleido-client-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"kaleido-client-manager.js","sourceRoot":"","sources":["../../src/lib/kaleido-client-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAS3C,MAAM,oBAAoB;IAA1B;QACU,WAAM,GAAyB,IAAI,CAAA;QACnC,WAAM,GAA+B,IAAI,CAAA;IAkDnD,CAAC;IAhDC,UAAU,CAAC,MAA2B;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;YACjC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAA;QAEF,OAAO,CAAC,GAAG,CAAC,iDAAiD,EAAE;YAC7D,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO;YAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;SAC3B,CAAC,CAAA;IACJ,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAA;QAC5E,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAA;IAC7B,CAAC;IAED,OAAO;QACL,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAA;IAC/B,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAA;IACtD,CAAC;IAED,YAAY,CAAC,MAAoC;QAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QACjE,CAAC;QACD,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAA;QAC/C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;IAC5B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAA"}
+{"version":3,"file":"kaleido-client-manager.js","sourceRoot":"","sources":["../../src/lib/kaleido-client-manager.ts"],"names":[],"mappings":"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"}

package/dist/lib/orchestra-client.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Flashnet Orchestra REST API Client
+ *
+ * Cross-chain swap orchestration: stablecoins (USDC/USDT) and native assets
+ * (ETH/SOL/TRX) on EVM/Solana/Tron ↔ BTC/USDB on Spark.
+ *
+ * API docs: https://docs.flashnet.xyz/products/orchestration/overview
+ * Base URL: https://orchestration.flashnet.xyz
+ *
+ * Ported from rate-extension/src/protocols/spark/orchestra-client.ts. The API
+ * key is NOT read from a build-time env var here — the engine is platform-
+ * agnostic, so the consumer injects it once at startup via `setOrchestraApiKey()`
+ * (the extension supplies its inlined `VITE_FLASHNET_ORCHESTRA_KEY`).
+ */
+/**
+ * Register the Orchestra API key. Call once at startup. Warns if given an
+ * empty value so a misconfigured build is obvious instead of surfacing as a
+ * runtime 401 that looks like a network failure.
+ */
+export declare function setOrchestraApiKey(key: string | null | undefined): void;
+/**
+ * Stable marker embedded in the auth-error message. Only `Error.message`
+ * survives the background-SW → UI message boundary (see background-protocol.ts:
+ * `sendResponse({ error: error?.message })`), so the UI matches on this token
+ * rather than `instanceof OrchestraAuthError`.
+ */
+export declare const ORCHESTRA_AUTH_ERROR_CODE = "ORCHESTRA_AUTH_FAILED";
+/**
+ * Thrown when an authed Orchestra call fails due to a missing/invalid API key
+ * (HTTP 401/403). Callers can detect this to show a "Bridge unavailable /
+ * not configured" message instead of a generic "Quote failed".
+ */
+export declare class OrchestraAuthError extends Error {
+    readonly status: number;
+    constructor(status: number);
+}
+export interface OrchestraRouteAsset {
+    chain: string;
+    asset: string;
+    contractAddress?: string;
+    decimals: number;
+    chainId?: number;
+}
+export interface OrchestraRoute {
+    sourceChain: string;
+    sourceAsset: string;
+    destinationChain: string;
+    destinationAsset: string;
+    source?: OrchestraRouteAsset;
+    destination?: OrchestraRouteAsset;
+}
+export interface OrchestraEstimate {
+    estimatedOut: string;
+    feeAmount: string;
+    feeBps: number;
+    totalFeeAmount: string;
+    feeAsset: string;
+    route: OrchestraRoute;
+}
+export interface OrchestraQuote {
+    quoteId: string;
+    depositAddress: string;
+    amountIn: string;
+    estimatedOut: string;
+    feeAmount: string;
+    feeBps: number;
+    totalFeeAmount: string;
+    feeAsset: string;
+    route: OrchestraRoute;
+    expiresAt: string;
+}
+export type OrchestraOrderStatus = 'processing' | 'confirming' | 'bridging' | 'swapping' | 'awaiting_approval' | 'refunding' | 'delivering' | 'completed' | 'failed' | 'refunded';
+export interface OrchestraOrderStage {
+    stage: string;
+    timestamp: string;
+}
+export interface OrchestraOrder {
+    id: string;
+    quoteId: string;
+    status: OrchestraOrderStatus;
+    amountIn?: string;
+    amountOut?: string;
+    depositAddress?: string;
+    recipientAddress?: string;
+    route?: OrchestraRoute;
+    stages?: OrchestraOrderStage[];
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface OrchestraOrderLookup {
+    quote: OrchestraQuote | null;
+    order: OrchestraOrder | null;
+    stages?: OrchestraOrderStage[];
+}
+export interface CreateQuoteParams {
+    sourceChain: string;
+    sourceAsset: string;
+    destinationChain: string;
+    destinationAsset: string;
+    amount: string;
+    recipientAddress: string;
+    slippageBps?: number;
+}
+export interface SubmitOrderParams {
+    quoteId: string;
+    txHash?: string;
+    sourceAddress?: string;
+    sparkTxHash?: string;
+    sourceSparkAddress?: string;
+    bitcoinTxid?: string;
+    bitcoinVout?: number;
+}
+export interface EstimateParams {
+    sourceChain: string;
+    sourceAsset: string;
+    destinationChain: string;
+    destinationAsset: string;
+    amount: string;
+}
+/** List all available cross-chain routes. No auth required. */
+export declare function getRoutes(): Promise<OrchestraRoute[]>;
+/** Get a lightweight price estimate. No auth required. */
+export declare function getEstimate(params: EstimateParams): Promise<OrchestraEstimate>;
+/** Create a durable quote with deposit address. Auth required. TTL ~30 min. */
+export declare function createQuote(params: CreateQuoteParams): Promise<OrchestraQuote>;
+/** Look up a quote and its associated order (if any). Auth required. */
+export declare function getOrder(quoteId: string): Promise<OrchestraOrderLookup>;
+/** Submit deposit proof to create an order from a quote. Auth required. */
+export declare function submitOrder(params: SubmitOrderParams): Promise<{
+    orderId: string;
+    status: string;
+}>;
+/**
+ * Check order status by ID, quoteId, or txHash.
+ *
+ * The Flashnet orchestration `/v1/orchestration/status` endpoint historically
+ * returned a flat `OrchestraOrder`, but the live API now wraps the response
+ * as `{ order: OrchestraOrder, stages?: OrchestraOrderStage[] }` (same shape
+ * as `/order`). Both forms have been observed in the wild — we unwrap defensively
+ * so the bridge tracking poller sees a real `status` field either way.
+ * Without this, `status` is `undefined`, the poller silently keeps showing
+ * the stale local status (e.g. "swapping") even after the order completes.
+ */
+export declare function getStatus(query: {
+    id?: string;
+    quoteId?: string;
+    txHash?: string;
+}): Promise<OrchestraOrder>;
+//# sourceMappingURL=orchestra-client.d.ts.map

package/dist/lib/orchestra-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestra-client.d.ts","sourceRoot":"","sources":["../../src/lib/orchestra-client.ts"],"names":[],"mappings":"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"}

package/dist/lib/orchestra-client.js

@@ -0,0 +1,178 @@
+/**
+ * Flashnet Orchestra REST API Client
+ *
+ * Cross-chain swap orchestration: stablecoins (USDC/USDT) and native assets
+ * (ETH/SOL/TRX) on EVM/Solana/Tron ↔ BTC/USDB on Spark.
+ *
+ * API docs: https://docs.flashnet.xyz/products/orchestration/overview
+ * Base URL: https://orchestration.flashnet.xyz
+ *
+ * Ported from rate-extension/src/protocols/spark/orchestra-client.ts. The API
+ * key is NOT read from a build-time env var here — the engine is platform-
+ * agnostic, so the consumer injects it once at startup via `setOrchestraApiKey()`
+ * (the extension supplies its inlined `VITE_FLASHNET_ORCHESTRA_KEY`).
+ */
+import { log } from './log.js';
+const BASE_URL = 'https://orchestration.flashnet.xyz';
+/**
+ * Orchestra API key, injected by the consumer. PUBLIC-by-design in the
+ * extension (shipped in the bundle) — the seam simply keeps the build-time
+ * env-var read out of the engine. Empty until `setOrchestraApiKey()` runs;
+ * every authed endpoint (createQuote/getOrder/submitOrder/getStatus) 401s
+ * without it.
+ */
+let apiKey = '';
+/**
+ * Register the Orchestra API key. Call once at startup. Warns if given an
+ * empty value so a misconfigured build is obvious instead of surfacing as a
+ * runtime 401 that looks like a network failure.
+ */
+export function setOrchestraApiKey(key) {
+    apiKey = key ?? '';
+    if (!apiKey) {
+        log.warn('[Orchestra] API key is empty — Bridge quote/submit calls will fail with HTTP 401. ' +
+            'Pass a key to setOrchestraApiKey() at startup.');
+    }
+}
+/**
+ * Stable marker embedded in the auth-error message. Only `Error.message`
+ * survives the background-SW → UI message boundary (see background-protocol.ts:
+ * `sendResponse({ error: error?.message })`), so the UI matches on this token
+ * rather than `instanceof OrchestraAuthError`.
+ */
+export const ORCHESTRA_AUTH_ERROR_CODE = 'ORCHESTRA_AUTH_FAILED';
+/**
+ * Thrown when an authed Orchestra call fails due to a missing/invalid API key
+ * (HTTP 401/403). Callers can detect this to show a "Bridge unavailable /
+ * not configured" message instead of a generic "Quote failed".
+ */
+export class OrchestraAuthError extends Error {
+    constructor(status) {
+        super(`${ORCHESTRA_AUTH_ERROR_CODE}: Bridge is not configured or unavailable. ` +
+            'The cross-chain service rejected the request (authentication failed).');
+        this.name = 'OrchestraAuthError';
+        this.status = status;
+    }
+}
+// ---------------------------------------------------------------------------
+// Client
+// ---------------------------------------------------------------------------
+function authHeaders() {
+    if (!apiKey)
+        return {};
+    return { Authorization: `Bearer ${apiKey}` };
+}
+function idempotencyHeader(prefix) {
+    return { 'X-Idempotency-Key': `${prefix}:${crypto.randomUUID()}` };
+}
+async function request(method, path, opts) {
+    const url = new URL(path, BASE_URL);
+    if (opts?.params) {
+        for (const [k, v] of Object.entries(opts.params)) {
+            if (v !== undefined)
+                url.searchParams.set(k, v);
+        }
+    }
+    const headers = { 'Content-Type': 'application/json' };
+    if (opts?.auth)
+        Object.assign(headers, authHeaders());
+    if (opts?.idempotency)
+        Object.assign(headers, idempotencyHeader(opts.idempotency));
+    const res = await fetch(url.toString(), {
+        method,
+        headers,
+        body: opts?.body ? JSON.stringify(opts.body) : undefined,
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        // An auth failure on an authed call almost always means the API key was
+        // not injected (or is invalid). Throw a specific error so the UI can
+        // distinguish "Bridge not configured" from a transient quote error.
+        if (opts?.auth && (res.status === 401 || res.status === 403)) {
+            throw new OrchestraAuthError(res.status);
+        }
+        throw new Error(`Orchestra API ${method} ${path} failed (${res.status}): ${text}`);
+    }
+    return res.json();
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/** List all available cross-chain routes. No auth required. */
+export async function getRoutes() {
+    const res = await request('GET', '/v1/orchestration/routes');
+    // API wraps in { routes: [...] }
+    return Array.isArray(res) ? res : res.routes;
+}
+/** Get a lightweight price estimate. No auth required. */
+export async function getEstimate(params) {
+    return request('GET', '/v1/orchestration/estimate', {
+        params: {
+            sourceChain: params.sourceChain,
+            sourceAsset: params.sourceAsset,
+            destinationChain: params.destinationChain,
+            destinationAsset: params.destinationAsset,
+            amount: params.amount,
+        },
+    });
+}
+/** Create a durable quote with deposit address. Auth required. TTL ~30 min. */
+export async function createQuote(params) {
+    return request('POST', '/v1/orchestration/quote', {
+        body: {
+            sourceChain: params.sourceChain,
+            sourceAsset: params.sourceAsset,
+            destinationChain: params.destinationChain,
+            destinationAsset: params.destinationAsset,
+            amount: params.amount,
+            recipientAddress: params.recipientAddress,
+            slippageBps: params.slippageBps ?? 100,
+        },
+        auth: true,
+        idempotency: 'quote:create',
+    });
+}
+/** Look up a quote and its associated order (if any). Auth required. */
+export async function getOrder(quoteId) {
+    return request('GET', '/v1/orchestration/order', {
+        params: { quoteId },
+        auth: true,
+    });
+}
+/** Submit deposit proof to create an order from a quote. Auth required. */
+export async function submitOrder(params) {
+    return request('POST', '/v1/orchestration/submit', {
+        body: params,
+        auth: true,
+        idempotency: 'submit',
+    });
+}
+/**
+ * Check order status by ID, quoteId, or txHash.
+ *
+ * The Flashnet orchestration `/v1/orchestration/status` endpoint historically
+ * returned a flat `OrchestraOrder`, but the live API now wraps the response
+ * as `{ order: OrchestraOrder, stages?: OrchestraOrderStage[] }` (same shape
+ * as `/order`). Both forms have been observed in the wild — we unwrap defensively
+ * so the bridge tracking poller sees a real `status` field either way.
+ * Without this, `status` is `undefined`, the poller silently keeps showing
+ * the stale local status (e.g. "swapping") even after the order completes.
+ */
+export async function getStatus(query) {
+    const params = {};
+    if (query.id)
+        params.id = query.id;
+    else if (query.quoteId)
+        params.quoteId = query.quoteId;
+    else if (query.txHash)
+        params.txHash = query.txHash;
+    const raw = await request('GET', '/v1/orchestration/status', { params, auth: true });
+    // Wrapped shape: pull the order, attach stages so callers can use them
+    // for finer-grained progress UI without a second request.
+    if (raw && typeof raw === 'object' && 'order' in raw && raw.order) {
+        const wrapped = raw;
+        return wrapped.stages ? { ...wrapped.order, stages: wrapped.stages } : wrapped.order;
+    }
+    return raw;
+}
+//# sourceMappingURL=orchestra-client.js.map

package/dist/lib/orchestra-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestra-client.js","sourceRoot":"","sources":["../../src/lib/orchestra-client.ts"],"names":[],"mappings":"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"}

package/dist/lib/rgb-converters.d.ts

@@ -0,0 +1,62 @@
+/**
+ * SDK ↔ unified-shape converters for the RGB adapter.
+ *
+ * Extracted from src/protocols/rgb/adapter.ts so the conversion logic lives
+ * in one place and the adapter is closer to "what RPCs do I call". Every
+ * function here is side-effect free, has no `this` dependencies, and only
+ * imports types — no SDK client, no module state.
+ *
+ * Covered by tests/unit/rgb-converters.test.ts.
+ */
+import type { AssetBalanceResponse, BtcBalanceResponse } from "kaleido-sdk/rln";
+import type { UnifiedAsset, UnifiedTransaction } from "../types/base.js";
+/**
+ * `wallet.getBtcBalance()` returns BTC split into "vanilla" (regular) and
+ * "colored" (RGB-allocated) sub-balances. The wallet UI only surfaces the
+ * vanilla portion as the BTC asset's balance — colored sats are accounted
+ * for under each RGB asset's own balance. Locks the policy: don't show
+ * colored sats as spendable BTC.
+ */
+export declare function convertBtcBalance(btcBalance: BtcBalanceResponse): UnifiedAsset["balance"];
+/**
+ * `wallet.getAssetBalance(assetId)` returns the per-asset SDK balance.
+ * Exposes the off-chain inbound/outbound capacities — both shown in the
+ * channel-aware balance breakdown — and treats `offchain_outbound` as
+ * `locked` for legacy callers that don't know about the off-chain split.
+ */
+export declare function convertSdkBalance(balance: AssetBalanceResponse, precision?: number): UnifiedAsset["balance"];
+/**
+ * `client.rln.listAssets()` returns balance as a plain `Record<string, number>`
+ * — same field names as the SDK shape but flatter and `undefined`-safe.
+ * Same projection as `convertSdkBalance` but no required-field assumptions.
+ */
+export declare function convertNodeBalance(balance: Record<string, number> | undefined, precision?: number): UnifiedAsset["balance"];
+/**
+ * Build a `UnifiedAsset` from the raw `client.rln.listAssets()` payload.
+ * Precision defaults to 8 (BTC convention) when the node omits it —
+ * legacy assets pre-RGB20 sometimes don't carry an explicit precision.
+ */
+export declare function convertNodeAssetToUnified(asset: Record<string, unknown>): UnifiedAsset;
+/**
+ * On-chain RGB transfer from `client.rln.listTransfers()`. `asset` is left
+ * as an empty placeholder; the caller (Activity view) joins on `asset_id`
+ * to populate it via the asset inventory.
+ */
+export declare function convertTransferToTransaction(transfer: Record<string, unknown>): UnifiedTransaction;
+/**
+ * Maker/taker swap entry from `client.rln.listSwaps()`. The same swap
+ * appears once per side — `side` distinguishes them in the rendered id
+ * so a maker and taker view of the same swap don't collide.
+ *
+ * Timestamp resolution: prefer `completed_at`, then `initiated_at`, then
+ * `requested_at` (all in seconds — converted to ms here).
+ */
+export declare function convertSwapToTransaction(swap: Record<string, unknown>, side: "maker" | "taker"): UnifiedTransaction;
+/**
+ * Lightning payment entry from `client.rln.listPayments()`. Inbound vs
+ * outbound is determined by the `inbound` flag (we render as receive vs
+ * send). Amount resolution prefers `asset_amount` (for RGB-asset payments)
+ * then falls back to converting the BTC msat figure to sats.
+ */
+export declare function convertPaymentToTransaction(payment: Record<string, unknown>): UnifiedTransaction;
+//# sourceMappingURL=rgb-converters.d.ts.map

package/dist/lib/rgb-converters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgb-converters.d.ts","sourceRoot":"","sources":["../../src/lib/rgb-converters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAetE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,kBAAkB,GAAG,YAAY,CAAC,SAAS,CAAC,CASzF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,oBAAoB,EAC7B,SAAS,GAAE,MAAU,GACpB,YAAY,CAAC,SAAS,CAAC,CAWzB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC3C,SAAS,GAAE,MAAU,GACpB,YAAY,CAAC,SAAS,CAAC,CAezB;AAID;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAkBtF;AAOD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,kBAAkB,CAepB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,OAAO,GAAG,OAAO,GACtB,kBAAkB,CAoBpB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB,CAqBhG"}