@kaleidorg/wallet-engine 1.0.0-beta.4 → 1.0.0-beta.42

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/psbt-signer.d.ts

@@ -0,0 +1,60 @@
+/**
+ * PSBT signing helper.
+ *
+ * Parses an incoming PSBT, derives the set of private keys that correspond
+ * to BIP32 derivation paths embedded in the PSBT's input entries, attempts
+ * to sign every signable input, and returns the result.
+ *
+ * Design invariants:
+ *  - Never fabricates a signature: if no input can be signed (no BIP32 paths
+ *    present, no matching key), returns { unchanged: true }.
+ *  - Does NOT scan derivation paths — only signs inputs whose PSBT already
+ *    carries explicit BIP32 derivation metadata. Scanning would be O(accounts
+ *    × gap) and too slow for the background service worker.
+ *  - Throws on malformed / non-PSBT input so the caller can surface an error
+ *    to the dApp rather than silently returning garbage.
+ */
+export interface PsbtSignResult {
+    /** Signed PSBT hex (or the original hex if unchanged). */
+    psbt: string;
+    /** True when no input could be signed (no owned inputs). */
+    unchanged: boolean;
+    /** Number of inputs that were signed. */
+    signedCount: number;
+}
+/**
+ * Parse and attempt to sign a PSBT using keys derived from the provided
+ * BIP39 mnemonic.
+ *
+ * @param psbtHex  Hex-encoded PSBT bytes (without 0x prefix).
+ * @param mnemonic BIP39 mnemonic for key derivation.
+ */
+export declare function signPsbt(psbtHex: string, mnemonic: string): PsbtSignResult;
+/**
+ * Finalize a fully-signed PSBT and extract the raw network transaction.
+ *
+ * Used by `webbtc.finalizePsbt`: a dApp hands back a PSBT that already carries
+ * all required signatures and asks the wallet to assemble the final scriptSig /
+ * witness and return the broadcastable transaction hex.
+ *
+ * Throws when the PSBT is malformed or not fully signed (btc-signer's
+ * `finalize()` rejects an input that still lacks a signature) so the dApp gets
+ * a clean error rather than a half-finalized transaction.
+ */
+export declare function finalizePsbt(psbtHex: string): {
+    txHex: string;
+    txid: string;
+};
+/**
+ * Decode a PSBT and return lightweight metadata for display in the
+ * confirmation popup — input count, output count, and estimated value
+ * transferred (sum of non-change outputs where possible).
+ *
+ * Never throws — returns safe defaults on malformed input.
+ */
+export declare function decodePsbtMeta(psbtHex: string): {
+    inputCount: number;
+    outputCount: number;
+    isValid: boolean;
+};
+//# sourceMappingURL=psbt-signer.d.ts.map

package/dist/lib/psbt-signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psbt-signer.d.ts","sourceRoot":"","sources":["../../src/lib/psbt-signer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA0BH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAA;IAClB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAyE1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAuB7E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG;IAC/C,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;CACjB,CAaA"}

package/dist/lib/psbt-signer.js

@@ -0,0 +1,161 @@
+/**
+ * PSBT signing helper.
+ *
+ * Parses an incoming PSBT, derives the set of private keys that correspond
+ * to BIP32 derivation paths embedded in the PSBT's input entries, attempts
+ * to sign every signable input, and returns the result.
+ *
+ * Design invariants:
+ *  - Never fabricates a signature: if no input can be signed (no BIP32 paths
+ *    present, no matching key), returns { unchanged: true }.
+ *  - Does NOT scan derivation paths — only signs inputs whose PSBT already
+ *    carries explicit BIP32 derivation metadata. Scanning would be O(accounts
+ *    × gap) and too slow for the background service worker.
+ *  - Throws on malformed / non-PSBT input so the caller can surface an error
+ *    to the dApp rather than silently returning garbage.
+ */
+import { Transaction } from '@scure/btc-signer';
+import { HDKey } from '@scure/bip32';
+import { mnemonicToSeedSync } from '@scure/bip39';
+import { hexToBytes, bytesToHex } from '@noble/hashes/utils.js';
+// PSBT magic bytes: 0x70736274ff ("psbt" + separator 0xff)
+const PSBT_MAGIC = new Uint8Array([0x70, 0x73, 0x62, 0x74, 0xff]);
+function assertPsbtMagic(bytes) {
+    for (let i = 0; i < PSBT_MAGIC.length; i++) {
+        if (bytes[i] !== PSBT_MAGIC[i]) {
+            throw new Error('Input is not a valid PSBT (magic bytes mismatch)');
+        }
+    }
+}
+/**
+ * Convert a raw BIP32 path array (as stored in PSBT key-value pairs) to the
+ * canonical string form. Each element ≥ 0x80000000 is a hardened step.
+ */
+function pathToString(pathArr) {
+    return 'm/' + pathArr.map((n) => (n >= 0x80000000 ? `${n - 0x80000000}'` : String(n))).join('/');
+}
+/**
+ * Parse and attempt to sign a PSBT using keys derived from the provided
+ * BIP39 mnemonic.
+ *
+ * @param psbtHex  Hex-encoded PSBT bytes (without 0x prefix).
+ * @param mnemonic BIP39 mnemonic for key derivation.
+ */
+export function signPsbt(psbtHex, mnemonic) {
+    const bytes = hexToBytes(psbtHex);
+    assertPsbtMagic(bytes);
+    let tx;
+    try {
+        tx = Transaction.fromPSBT(bytes);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to parse PSBT: ${msg}`);
+    }
+    const seed = mnemonicToSeedSync(mnemonic);
+    const root = HDKey.fromMasterSeed(seed);
+    let signedCount = 0;
+    for (let idx = 0; idx < tx.inputsLength; idx++) {
+        const input = tx.getInput(idx);
+        // Skip finalized inputs. An empty Uint8Array is truthy, so check length.
+        const hasFinalSig = Array.isArray(input.finalScriptSig)
+            ? input.finalScriptSig.length > 0
+            : (input.finalScriptSig?.length ?? 0) > 0;
+        const hasFinalWitness = Array.isArray(input.finalScriptWitness) && input.finalScriptWitness.length > 0;
+        if (hasFinalSig || hasFinalWitness)
+            continue;
+        // Collect derivation paths from this input. An input may have multiple
+        // BIP32_DERIVATION entries (one per required signer in multisig scripts).
+        const derivations = input.bip32Derivation ?? [];
+        const taprootDerivations = input.tapBip32Derivation ?? [];
+        const allPaths = [
+            ...derivations.map(([, { path }]) => pathToString(path)),
+            ...taprootDerivations.map(([, { der: { path }, },]) => pathToString(path)),
+        ];
+        if (allPaths.length === 0)
+            continue;
+        for (const path of allPaths) {
+            let child;
+            try {
+                child = root.derive(path);
+            }
+            catch {
+                continue;
+            }
+            if (!child.privateKey)
+                continue;
+            try {
+                tx.signIdx(child.privateKey, idx);
+                signedCount++;
+                break; // one signature per input is enough
+            }
+            catch {
+                // Key didn't match this input — try the next derivation path.
+            }
+        }
+    }
+    const unchanged = signedCount === 0;
+    const resultBytes = tx.toPSBT();
+    return {
+        psbt: bytesToHex(resultBytes),
+        unchanged,
+        signedCount,
+    };
+}
+/**
+ * Finalize a fully-signed PSBT and extract the raw network transaction.
+ *
+ * Used by `webbtc.finalizePsbt`: a dApp hands back a PSBT that already carries
+ * all required signatures and asks the wallet to assemble the final scriptSig /
+ * witness and return the broadcastable transaction hex.
+ *
+ * Throws when the PSBT is malformed or not fully signed (btc-signer's
+ * `finalize()` rejects an input that still lacks a signature) so the dApp gets
+ * a clean error rather than a half-finalized transaction.
+ */
+export function finalizePsbt(psbtHex) {
+    const bytes = hexToBytes(psbtHex);
+    assertPsbtMagic(bytes);
+    let tx;
+    try {
+        tx = Transaction.fromPSBT(bytes);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to parse PSBT: ${msg}`);
+    }
+    try {
+        tx.finalize();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`PSBT is not fully signed / could not be finalized: ${msg}`);
+    }
+    // `extract()` returns the raw network transaction bytes once every input is
+    // finalized. `tx.id` is the (witness-excluded) txid in display byte order.
+    const rawTx = tx.extract();
+    return { txHex: bytesToHex(rawTx), txid: tx.id };
+}
+/**
+ * Decode a PSBT and return lightweight metadata for display in the
+ * confirmation popup — input count, output count, and estimated value
+ * transferred (sum of non-change outputs where possible).
+ *
+ * Never throws — returns safe defaults on malformed input.
+ */
+export function decodePsbtMeta(psbtHex) {
+    try {
+        const bytes = hexToBytes(psbtHex);
+        assertPsbtMagic(bytes);
+        const tx = Transaction.fromPSBT(bytes);
+        return {
+            inputCount: tx.inputsLength,
+            outputCount: tx.outputsLength,
+            isValid: true,
+        };
+    }
+    catch {
+        return { inputCount: 0, outputCount: 0, isValid: false };
+    }
+}
+//# sourceMappingURL=psbt-signer.js.map

package/dist/lib/psbt-signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"psbt-signer.js","sourceRoot":"","sources":["../../src/lib/psbt-signer.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"}