@kaleidorg/wallet-engine 1.0.0-beta.35 → 1.0.0-beta.37

package/dist/lib/rgb-converters.js

@@ -0,0 +1,179 @@
+/**
+ * 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 { formatAmount, mapPaymentStatus, mapSwapStatus, mapTransferStatus, mapTransferType, } from "./rgb-helpers.js";
+// ── Balance shape converters ──────────────────────────────────────────────
+// Three slightly different upstream shapes; the unified `UnifiedAsset["balance"]`
+// is the projection we render. Each converter is the *only* place that
+// knows the field names of its specific SDK response — anything downstream
+// reads the unified shape.
+/**
+ * `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 function convertBtcBalance(btcBalance) {
+    const vanilla = btcBalance.vanilla ?? { settled: 0, future: 0, spendable: 0 };
+    return {
+        total: vanilla.settled || 0,
+        available: vanilla.spendable || 0,
+        pending: vanilla.future || 0,
+        totalDisplay: formatAmount(vanilla.settled || 0, 8),
+        availableDisplay: formatAmount(vanilla.spendable || 0, 8),
+    };
+}
+/**
+ * `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 function convertSdkBalance(balance, precision = 8) {
+    return {
+        total: balance.settled || 0,
+        available: balance.spendable || 0,
+        pending: balance.future || 0,
+        locked: balance.offchain_outbound || 0,
+        offchain_outbound: balance.offchain_outbound || 0,
+        offchain_inbound: balance.offchain_inbound || 0,
+        totalDisplay: formatAmount(balance.settled || 0, precision),
+        availableDisplay: formatAmount(balance.spendable || 0, precision),
+    };
+}
+/**
+ * `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 function convertNodeBalance(balance, precision = 8) {
+    const total = balance?.settled || 0;
+    const available = balance?.spendable || 0;
+    const pending = balance?.future || 0;
+    return {
+        total,
+        available,
+        pending,
+        locked: balance?.offchain_outbound || 0,
+        offchain_outbound: balance?.offchain_outbound || 0,
+        offchain_inbound: balance?.offchain_inbound || 0,
+        totalDisplay: formatAmount(total, precision),
+        availableDisplay: formatAmount(available, precision),
+    };
+}
+// ── Asset converter ──────────────────────────────────────────────────────
+/**
+ * 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 function convertNodeAssetToUnified(asset) {
+    const precision = asset.precision ?? 8;
+    return {
+        id: asset.asset_id,
+        name: asset.name,
+        ticker: asset.ticker,
+        precision,
+        protocol: "RGB_LN",
+        layer: "RGB_LN",
+        balance: convertNodeBalance(asset.balance, precision),
+        capabilities: {
+            canSend: true,
+            canReceive: true,
+            canSwap: false,
+            supportsLightning: true,
+            supportsOnchain: true,
+        },
+    };
+}
+// ── Transaction converters ───────────────────────────────────────────────
+// Three sources of RGB activity — on-chain transfers, lightning payments,
+// and maker/taker swaps — project into the same `UnifiedTransaction` shape
+// so the activity view doesn't have to render-switch on protocol details.
+/**
+ * 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 function convertTransferToTransaction(transfer) {
+    return {
+        id: transfer.txid || `tx_${Date.now()}`,
+        type: mapTransferType(transfer.kind),
+        status: mapTransferStatus(transfer.status),
+        timestamp: transfer.created_at || Date.now(),
+        amount: transfer.amount || 0,
+        amountDisplay: formatAmount(transfer.amount || 0, 8),
+        fee: transfer.fee,
+        feeDisplay: formatAmount(transfer.fee || 0, 8),
+        asset: {}, // Would need to be populated
+        from: transfer.sender,
+        to: transfer.recipient,
+        protocolData: transfer,
+    };
+}
+/**
+ * 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 function convertSwapToTransaction(swap, side) {
+    const paymentHash = swap.payment_hash || `swap_${Date.now()}`;
+    const requestedAt = swap.requested_at ?? 0;
+    const completedAt = swap.completed_at ?? null;
+    const initiatedAt = swap.initiated_at ?? null;
+    const tsSec = completedAt ?? initiatedAt ?? requestedAt;
+    const timestamp = tsSec ? tsSec * 1000 : Date.now();
+    const qtyFrom = Number(swap.qty_from ?? 0);
+    return {
+        id: `swap_${side}_${paymentHash}`,
+        type: "swap",
+        status: mapSwapStatus(swap.status),
+        timestamp,
+        amount: qtyFrom,
+        amountDisplay: formatAmount(qtyFrom, 8),
+        fee: 0,
+        feeDisplay: formatAmount(0, 8),
+        asset: {},
+        protocolData: { ...swap, side },
+    };
+}
+/**
+ * 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 function convertPaymentToTransaction(payment) {
+    const inbound = Boolean(payment.inbound);
+    const assetAmount = payment.asset_amount ?? null;
+    const amtMsat = payment.amt_msat ?? null;
+    const amount = assetAmount ?? (amtMsat ? Math.floor(amtMsat / 1000) : 0);
+    const timestamp = payment.created_at
+        ? payment.created_at * 1000
+        : Date.now();
+    return {
+        id: payment.payment_hash || `pmt_${Date.now()}`,
+        type: inbound ? "receive" : "send",
+        status: mapPaymentStatus(payment.status),
+        timestamp,
+        amount,
+        amountDisplay: formatAmount(amount, 8),
+        fee: 0,
+        feeDisplay: formatAmount(0, 8),
+        asset: {},
+        to: payment.payee_pubkey,
+        protocolData: payment,
+    };
+}
+//# sourceMappingURL=rgb-converters.js.map

package/dist/lib/rgb-converters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgb-converters.js","sourceRoot":"","sources":["../../src/lib/rgb-converters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,6EAA6E;AAC7E,kFAAkF;AAClF,uEAAuE;AACvE,2EAA2E;AAC3E,2BAA2B;AAE3B;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAA8B;IAC9D,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAC9E,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC;QAC3B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,OAAO,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC;QAC5B,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QACnD,gBAAgB,EAAE,YAAY,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAA6B,EAC7B,YAAoB,CAAC;IAErB,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC;QAC3B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,OAAO,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC;QAC5B,MAAM,EAAE,OAAO,CAAC,iBAAiB,IAAI,CAAC;QACtC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,CAAC;QACjD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,CAAC;QAC/C,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,EAAE,SAAS,CAAC;QAC3D,gBAAgB,EAAE,YAAY,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,EAAE,SAAS,CAAC;KACvC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAA2C,EAC3C,YAAoB,CAAC;IAErB,MAAM,KAAK,GAAG,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;IAErC,OAAO;QACL,KAAK;QACL,SAAS;QACT,OAAO;QACP,MAAM,EAAE,OAAO,EAAE,iBAAiB,IAAI,CAAC;QACvC,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,IAAI,CAAC;QAClD,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,IAAI,CAAC;QAChD,YAAY,EAAE,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC;QAC5C,gBAAgB,EAAE,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC;KAC1B,CAAC;AAC/B,CAAC;AAED,4EAA4E;AAE5E;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAA8B;IACtE,MAAM,SAAS,GAAI,KAAK,CAAC,SAAoB,IAAI,CAAC,CAAC;IACnD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,QAAkB;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAc;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAgB;QAC9B,SAAS;QACT,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,OAA6C,EAAE,SAAS,CAAC;QAC3F,YAAY,EAAE;YACZ,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,KAAK;YACd,iBAAiB,EAAE,IAAI;YACvB,eAAe,EAAE,IAAI;SACtB;KACF,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,0EAA0E;AAC1E,2EAA2E;AAC3E,0EAA0E;AAE1E;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAAiC;IAEjC,OAAO;QACL,EAAE,EAAG,QAAQ,CAAC,IAAe,IAAI,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE;QACnD,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,IAA0B,CAAC;QAC1D,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,MAA4B,CAAC;QAChE,SAAS,EAAG,QAAQ,CAAC,UAAqB,IAAI,IAAI,CAAC,GAAG,EAAE;QACxD,MAAM,EAAG,QAAQ,CAAC,MAAiB,IAAI,CAAC;QACxC,aAAa,EAAE,YAAY,CAAE,QAAQ,CAAC,MAAiB,IAAI,CAAC,EAAE,CAAC,CAAC;QAChE,GAAG,EAAE,QAAQ,CAAC,GAAyB;QACvC,UAAU,EAAE,YAAY,CAAE,QAAQ,CAAC,GAAc,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1D,KAAK,EAAE,EAAkB,EAAE,6BAA6B;QACxD,IAAI,EAAE,QAAQ,CAAC,MAA4B;QAC3C,EAAE,EAAE,QAAQ,CAAC,SAA+B;QAC5C,YAAY,EAAE,QAAQ;KACvB,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAA6B,EAC7B,IAAuB;IAEvB,MAAM,WAAW,GAAI,IAAI,CAAC,YAAuB,IAAI,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAC1E,MAAM,WAAW,GAAI,IAAI,CAAC,YAAmC,IAAI,CAAC,CAAC;IACnE,MAAM,WAAW,GAAI,IAAI,CAAC,YAA0C,IAAI,IAAI,CAAC;IAC7E,MAAM,WAAW,GAAI,IAAI,CAAC,YAA0C,IAAI,IAAI,CAAC;IAC7E,MAAM,KAAK,GAAG,WAAW,IAAI,WAAW,IAAI,WAAW,CAAC;IACxD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACpD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;IAC3C,OAAO;QACL,EAAE,EAAE,QAAQ,IAAI,IAAI,WAAW,EAAE;QACjC,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,MAA4B,CAAC;QACxD,SAAS;QACT,MAAM,EAAE,OAAO;QACf,aAAa,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;QACvC,GAAG,EAAE,CAAC;QACN,UAAU,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9B,KAAK,EAAE,EAAkB;QACzB,YAAY,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE;KAChC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAgC;IAC1E,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,WAAW,GAAI,OAAO,CAAC,YAA0C,IAAI,IAAI,CAAC;IAChF,MAAM,OAAO,GAAI,OAAO,CAAC,QAAsC,IAAI,IAAI,CAAC;IACxE,MAAM,MAAM,GAAG,WAAW,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,SAAS,GAAI,OAAO,CAAC,UAAiC;QAC1D,CAAC,CAAE,OAAO,CAAC,UAAqB,GAAG,IAAI;QACvC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACf,OAAO;QACL,EAAE,EAAG,OAAO,CAAC,YAAuB,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE;QAC3D,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;QAClC,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,MAA4B,CAAC;QAC9D,SAAS;QACT,MAAM;QACN,aAAa,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QACtC,GAAG,EAAE,CAAC;QACN,UAAU,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9B,KAAK,EAAE,EAAkB;QACzB,EAAE,EAAE,OAAO,CAAC,YAAkC;QAC9C,YAAY,EAAE,OAAO;KACtB,CAAC;AACJ,CAAC"}

package/dist/lib/rgb-fee-policy.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Pure fee-rate policy for RGB on-chain operations.
+ *
+ * Extracted from `RgbAdapter#resolveFeeRate` so the priority order +
+ * mainnet floors are unit-testable without a live RGB client.
+ *
+ * The policy ([GL #26]):
+ *   1. If the caller passed a positive `provided` rate, honour it. The
+ *      advanced UI can override the floor when the user knows what they
+ *      want.
+ *   2. Non-mainnet networks (regtest/signet/testnet/null/unknown):
+ *      return `1 sat/vB`. Cheap, always confirms locally.
+ *   3. Mainnet: ask the node for an estimate at the urgency-mapped block
+ *      target, floor at `MAINNET_FEE_FLOOR[urgency]` so a cold-started
+ *      node returning `1 sat/vB` doesn't strand mainnet transactions.
+ *   4. Mainnet + estimate failure: return the floor.
+ */
+export type FeeUrgency = "low" | "normal" | "high";
+/**
+ * Conservative mainnet floors (sat/vB). Well above the dust-attack rate
+ * but still cheap relative to any user-facing payment. Tuned for a
+ * typical 10-min-block target at "normal" urgency. Adjust here if
+ * mainnet conditions shift — every call site reads from this table.
+ */
+export declare const MAINNET_FEE_FLOOR: Record<FeeUrgency, number>;
+export interface ResolveRgbFeeRateInput {
+    /** Caller-provided rate (advanced UI override). Wins when > 0. */
+    provided: number | undefined;
+    /** Urgency tier; maps to a block target + floor. */
+    urgency: FeeUrgency;
+    /** Active network from the adapter config. `null` = unknown / not connected. */
+    network: string | null;
+    /**
+     * Async estimator. Receives the urgency-mapped block target. Should return
+     * the node's `fee_rate` in sat/vB, or `null` on failure. Failures must
+     * not throw — the policy needs a value to fall back on.
+     */
+    estimateFn: (blocks: number) => Promise<number | null>;
+}
+export declare function resolveRgbFeeRatePolicy(input: ResolveRgbFeeRateInput): Promise<number>;
+//# sourceMappingURL=rgb-fee-policy.d.ts.map

package/dist/lib/rgb-fee-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgb-fee-policy.d.ts","sourceRoot":"","sources":["../../src/lib/rgb-fee-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AASnD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAIxD,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,oDAAoD;IACpD,OAAO,EAAE,UAAU,CAAC;IACpB,gFAAgF;IAChF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;OAIG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACxD;AAED,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB5F"}

package/dist/lib/rgb-fee-policy.js

@@ -0,0 +1,52 @@
+/**
+ * Pure fee-rate policy for RGB on-chain operations.
+ *
+ * Extracted from `RgbAdapter#resolveFeeRate` so the priority order +
+ * mainnet floors are unit-testable without a live RGB client.
+ *
+ * The policy ([GL #26]):
+ *   1. If the caller passed a positive `provided` rate, honour it. The
+ *      advanced UI can override the floor when the user knows what they
+ *      want.
+ *   2. Non-mainnet networks (regtest/signet/testnet/null/unknown):
+ *      return `1 sat/vB`. Cheap, always confirms locally.
+ *   3. Mainnet: ask the node for an estimate at the urgency-mapped block
+ *      target, floor at `MAINNET_FEE_FLOOR[urgency]` so a cold-started
+ *      node returning `1 sat/vB` doesn't strand mainnet transactions.
+ *   4. Mainnet + estimate failure: return the floor.
+ */
+/** Block-target mapping per urgency. high = next block, low = ~2 hours. */
+const URGENCY_BLOCKS = {
+    high: 1,
+    normal: 6,
+    low: 12,
+};
+/**
+ * Conservative mainnet floors (sat/vB). Well above the dust-attack rate
+ * but still cheap relative to any user-facing payment. Tuned for a
+ * typical 10-min-block target at "normal" urgency. Adjust here if
+ * mainnet conditions shift — every call site reads from this table.
+ */
+export const MAINNET_FEE_FLOOR = {
+    low: 5,
+    normal: 10,
+    high: 25,
+};
+export async function resolveRgbFeeRatePolicy(input) {
+    const { provided, urgency, network, estimateFn } = input;
+    if (typeof provided === "number" && Number.isFinite(provided) && provided > 0) {
+        return provided;
+    }
+    const isMainnet = network === "mainnet";
+    if (!isMainnet) {
+        return 1;
+    }
+    const floor = MAINNET_FEE_FLOOR[urgency];
+    const blocks = URGENCY_BLOCKS[urgency];
+    const estimate = await estimateFn(blocks);
+    if (estimate == null || !Number.isFinite(estimate) || estimate <= 0) {
+        return floor;
+    }
+    return Math.max(Math.floor(estimate), floor);
+}
+//# sourceMappingURL=rgb-fee-policy.js.map

package/dist/lib/rgb-fee-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgb-fee-policy.js","sourceRoot":"","sources":["../../src/lib/rgb-fee-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,2EAA2E;AAC3E,MAAM,cAAc,GAA+B;IACjD,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,GAAG,EAAE,EAAE;CACR,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA+B;IAC3D,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,EAAE;CACT,CAAC;AAiBF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAA6B;IACzE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IACzD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC9E,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,KAAK,SAAS,CAAC;IACxC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,QAAQ,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC"}

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

@@ -0,0 +1,54 @@
+/**
+ * Pure helpers for the RGB adapter.
+ *
+ * Extracted from src/protocols/rgb/adapter.ts so the adapter file can stay
+ * focused on the IProtocolAdapter surface + SDK orchestration. Everything in
+ * this module is side-effect free, has no `this` dependencies, and is
+ * covered by tests/unit/rgb-helpers.test.ts.
+ *
+ * Adding to this module: keep helpers pure (no class state, no SDK calls).
+ * Anything that needs the kaleido SDK client or the adapter's own config
+ * belongs in adapter.ts.
+ */
+import type { TransactionStatus, TransactionType } from "../types/base.js";
+/**
+ * Render a raw integer amount in the asset's display precision.
+ * Always emits `precision` fractional digits — the caller can trim trailing
+ * zeros if it wants a tighter rendering.
+ */
+export declare function formatAmount(amount: number, precision: number): string;
+/**
+ * Map the SDK's transfer `kind` field to our unified TransactionType.
+ *
+ * The SDK is inconsistent about case + naming — both raw lowercase strings
+ * and PascalCase ("ReceiveAsset", "SendAsset") have been observed. Defaults
+ * to "send" for unknown / undefined input so legacy entries don't display
+ * as a confusing third state.
+ */
+export declare function mapTransferType(kind?: string): TransactionType;
+/**
+ * Map the SDK's transfer status string to our unified TransactionStatus.
+ *
+ * SDK casing has drifted between releases; we accept both. "WaitingCounterparty"
+ * is RGB-specific (lightning transfer waiting on the receiver) and maps to
+ * pending so the UI keeps showing the spinner rather than green-checking too
+ * early.
+ */
+export declare function mapTransferStatus(status?: string): TransactionStatus;
+/**
+ * Map a Lightning-payment status string to our unified TransactionStatus.
+ *
+ * Three variants of "succeeded" have shown up in the SDK across versions —
+ * we accept all three to insulate the wallet UI from upstream churn.
+ */
+export declare function mapPaymentStatus(status?: string): TransactionStatus;
+/**
+ * Map a maker/taker swap status string to our unified TransactionStatus.
+ *
+ * The SDK historically returned PascalCase ("Completed") and lowercase
+ * ("completed", "success", "error") interchangeably depending on whether
+ * the response came from the maker or taker side. The mapper accepts both
+ * so a refactor of the SDK doesn't quietly flip swaps to "pending".
+ */
+export declare function mapSwapStatus(status?: string): TransactionStatus;
+//# sourceMappingURL=rgb-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rgb-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/rgb-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAK9D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAMpE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAKnE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAKhE"}

package/dist/lib/rgb-helpers.js

@@ -0,0 +1,89 @@
+/**
+ * Pure helpers for the RGB adapter.
+ *
+ * Extracted from src/protocols/rgb/adapter.ts so the adapter file can stay
+ * focused on the IProtocolAdapter surface + SDK orchestration. Everything in
+ * this module is side-effect free, has no `this` dependencies, and is
+ * covered by tests/unit/rgb-helpers.test.ts.
+ *
+ * Adding to this module: keep helpers pure (no class state, no SDK calls).
+ * Anything that needs the kaleido SDK client or the adapter's own config
+ * belongs in adapter.ts.
+ */
+/**
+ * Render a raw integer amount in the asset's display precision.
+ * Always emits `precision` fractional digits — the caller can trim trailing
+ * zeros if it wants a tighter rendering.
+ */
+export function formatAmount(amount, precision) {
+    return (amount / Math.pow(10, precision)).toFixed(precision);
+}
+/**
+ * Map the SDK's transfer `kind` field to our unified TransactionType.
+ *
+ * The SDK is inconsistent about case + naming — both raw lowercase strings
+ * and PascalCase ("ReceiveAsset", "SendAsset") have been observed. Defaults
+ * to "send" for unknown / undefined input so legacy entries don't display
+ * as a confusing third state.
+ */
+export function mapTransferType(kind) {
+    if (!kind)
+        return "send";
+    if (kind.includes("receive") || kind.includes("ReceiveAsset"))
+        return "receive";
+    if (kind.includes("send") || kind.includes("SendAsset"))
+        return "send";
+    return "send";
+}
+/**
+ * Map the SDK's transfer status string to our unified TransactionStatus.
+ *
+ * SDK casing has drifted between releases; we accept both. "WaitingCounterparty"
+ * is RGB-specific (lightning transfer waiting on the receiver) and maps to
+ * pending so the UI keeps showing the spinner rather than green-checking too
+ * early.
+ */
+export function mapTransferStatus(status) {
+    if (!status)
+        return "pending";
+    if (status === "Settled" || status === "settled")
+        return "confirmed";
+    if (status === "Failed" || status === "failed")
+        return "failed";
+    if (status === "WaitingCounterparty")
+        return "pending";
+    return "pending";
+}
+/**
+ * Map a Lightning-payment status string to our unified TransactionStatus.
+ *
+ * Three variants of "succeeded" have shown up in the SDK across versions —
+ * we accept all three to insulate the wallet UI from upstream churn.
+ */
+export function mapPaymentStatus(status) {
+    if (!status)
+        return "pending";
+    if (status === "succeeded" || status === "success" || status === "Succeeded")
+        return "confirmed";
+    if (status === "failed" || status === "Failed")
+        return "failed";
+    return "pending";
+}
+/**
+ * Map a maker/taker swap status string to our unified TransactionStatus.
+ *
+ * The SDK historically returned PascalCase ("Completed") and lowercase
+ * ("completed", "success", "error") interchangeably depending on whether
+ * the response came from the maker or taker side. The mapper accepts both
+ * so a refactor of the SDK doesn't quietly flip swaps to "pending".
+ */
+export function mapSwapStatus(status) {
+    if (!status)
+        return "pending";
+    if (status === "completed" || status === "success" || status === "Completed")
+        return "confirmed";
+    if (status === "failed" || status === "error" || status === "Failed")
+        return "failed";
+    return "pending";
+}
+//# sourceMappingURL=rgb-helpers.js.map

package/dist/lib/rgb-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgb-helpers.js","sourceRoot":"","sources":["../../src/lib/rgb-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,SAAiB;IAC5D,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,IAAI,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,SAAS,CAAC;IAChF,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,MAAM,CAAC;IACvE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IACrE,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAChE,IAAI,MAAM,KAAK,qBAAqB;QAAE,OAAO,SAAS,CAAC;IACvD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAe;IAC9C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IACjG,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAChE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAAe;IAC3C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IACjG,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACtF,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaleidorg/wallet-engine",
-  "version": "1.0.0-beta.35",
+  "version": "1.0.0-beta.37",
   "description": "WDK-based multi-protocol wallet engine (Spark, RGB/RLN, Liquid, Arkade): IProtocolAdapter contract + WDK adapters, cross-protocol router, BIP321 unified receive, and lite/advanced disclosure.",
   "type": "module",
   "main": "dist/index.js",
@@ -22,6 +22,10 @@
       "types": "./dist/adapters/spark.d.ts",
       "default": "./dist/adapters/spark.js"
     },
+    "./adapters/rgb": {
+      "types": "./dist/adapters/rgb.d.ts",
+      "default": "./dist/adapters/rgb.js"
+    },
     "./adapters/wdk": {
       "types": "./dist/adapters/wdk/index.d.ts",
       "default": "./dist/adapters/wdk/index.js"