@kaleidorg/wallet-engine 1.0.0-beta.12

package/dist/adapters/wdk/LiquidWdkAdapter.js

@@ -0,0 +1,276 @@
+/**
+ * LiquidWdkAdapter
+ * ----------------
+ * Wraps the WDK Liquid module (@kaleidorg/wdk-wallet-liquid, over lwk / Liquid Wallet
+ * Kit) onto the stable `IProtocolAdapter` contract. This is the "USD" path: USDt on
+ * Liquid is the lite-mode "USD" asset.
+ *
+ * Liquid is on-chain only — no Lightning, no invoices. Receive = an address.
+ * Unlike Spark, the module exposes `listAssets()` + `getTokenBalance()`, so asset
+ * enumeration (incl. USDt) works natively with no upstream gap.
+ *
+ * Discipline: no WDK/lwk types cross the contract — everything returned is a domain
+ * type from ../types/base; WDK objects are held as `any`.
+ *
+ * WDK Liquid surface (from types/index.d.ts):
+ *   manager: getAccount, getAccountByPath, getFeeRates({normal,fast}: bigint), dispose
+ *   account: getAddress(): string, getBalance(): bigint, getTokenBalance(id): bigint,
+ *            transfer({recipient,amount,feeRate?}), sendAsset({assetId,recipient,amount,feeRate?}),
+ *            listAssets(): {asset_id,balance}[], listUnspents, listTransactions,
+ *            getNetworkInfo(): {network,policy_asset,address,tip_height}, sign, dispose
+ */
+import { ProtocolError, } from '../../types/base.js';
+import { getCapabilities } from '../../capabilities/index.js';
+import { PROTOCOL_OPERATIONS } from '../../capabilities/operations.js';
+import { loadWdkModule } from './moduleLoader.js';
+// Re-exported from the neutral constants module so core (disclosure) never has
+// to import this adapter to reach the asset id.
+export { LIQUID_USDT_ASSET_ID } from '../../constants.js';
+import { LIQUID_USDT_ASSET_ID } from '../../constants.js';
+const LIQUID_NETWORK_MAP = {
+    mainnet: 'mainnet',
+    testnet: 'testnet',
+    regtest: 'regtest',
+    signet: 'testnet', // Liquid has no signet
+};
+/** Known asset metadata for nicer display; unknown assets fall back to their id. */
+const KNOWN_ASSETS = {
+    [LIQUID_USDT_ASSET_ID]: { ticker: 'USDt', name: 'Tether USD', precision: 8 },
+};
+export class LiquidWdkAdapter {
+    constructor() {
+        this.protocolName = 'LIQUID';
+        this.capabilities = PROTOCOL_OPERATIONS.LIQUID;
+        this.supportedLayers = getCapabilities('LIQUID').layers;
+        this.version = '0.1.0-wdk';
+        this.manager = null;
+        this.account = null;
+        this.connected = false;
+        this.network = 'mainnet';
+        this.policyAsset = null;
+    }
+    // --- Connection ---------------------------------------------------------
+    async connect(config) {
+        const cfg = config;
+        if (!cfg.mnemonic) {
+            throw new ProtocolError('LiquidWdkAdapter requires a mnemonic', 'LIQUID', 'CONFIG');
+        }
+        this.network = cfg.network ?? 'mainnet';
+        // @ts-ignore — declared as a workspace/optional dep; resolved at runtime.
+        const mod = await loadWdkModule('@kaleidorg/wdk-wallet-liquid', () => import('@kaleidorg/wdk-wallet-liquid'));
+        const LiquidWalletManager = mod.default ?? mod;
+        this.manager = new LiquidWalletManager(cfg.mnemonic, {
+            network: LIQUID_NETWORK_MAP[this.network] ?? 'mainnet',
+            esploraUrl: cfg.esploraUrl,
+        });
+        this.account = await this.manager.getAccount(cfg.accountIndex ?? 0);
+        this.connected = true;
+    }
+    async disconnect() {
+        try {
+            this.account?.dispose?.();
+            this.manager?.dispose?.();
+        }
+        finally {
+            this.account = null;
+            this.manager = null;
+            this.connected = false;
+            this.policyAsset = null;
+        }
+    }
+    isConnected() {
+        return this.connected;
+    }
+    async getConnectionInfo() {
+        this.assertConnected();
+        const info = await this.account.getNetworkInfo();
+        return {
+            protocol: 'LIQUID',
+            connected: this.connected,
+            network: info?.network ?? this.network,
+            blockHeight: info?.tip_height ?? undefined,
+        };
+    }
+    // --- Address / receive --------------------------------------------------
+    async getReceiveAddress(assetId) {
+        this.assertConnected();
+        const address = await this.account.getAddress();
+        return { address, format: 'LIQUID_ADDRESS', asset: assetId };
+    }
+    // --- Balance ------------------------------------------------------------
+    async getBtcBalance() {
+        this.assertConnected();
+        const bal = await this.account.getBalance(); // L-BTC sats
+        const total = Number(bal);
+        return { confirmed: total, unconfirmed: 0, total };
+    }
+    async refreshBalances() {
+        // lwk syncs against Esplora on read; no explicit sync call.
+    }
+    async listAssets() {
+        this.assertConnected();
+        const policy = await this.getPolicyAsset();
+        const out = [];
+        // L-BTC (policy asset)
+        const { total } = await this.getBtcBalance();
+        out.push(this.toUnifiedAsset(policy, BigInt(total), {
+            ticker: 'L-BTC',
+            name: 'Liquid Bitcoin',
+            precision: 8,
+            layer: 'BTC_LIQUID',
+        }));
+        // Other Liquid assets (USDt, etc.)
+        const assets = await this.account.listAssets();
+        for (const a of assets) {
+            if (a.asset_id === policy)
+                continue; // already added as L-BTC
+            const meta = KNOWN_ASSETS[a.asset_id];
+            out.push(this.toUnifiedAsset(a.asset_id, BigInt(a.balance), {
+                ticker: meta?.ticker ?? a.asset_id.slice(0, 6),
+                name: meta?.name ?? 'Liquid asset',
+                precision: meta?.precision ?? 8,
+                layer: 'LIQUID_ASSET',
+            }));
+        }
+        return out;
+    }
+    async getAssetBalance(assetId) {
+        this.assertConnected();
+        const bal = await this.account.getTokenBalance(assetId);
+        const n = Number(bal);
+        return { total: n, available: n, pending: 0, totalDisplay: String(n), availableDisplay: String(n) };
+    }
+    async getAsset(assetId) {
+        const assets = await this.listAssets();
+        const found = assets.find((a) => a.id === assetId);
+        if (!found)
+            throw new ProtocolError(`Unknown asset ${assetId}`, 'LIQUID', 'NO_ASSET');
+        return found;
+    }
+    // --- Send ---------------------------------------------------------------
+    /** L-BTC send. `invoice` carries the recipient Liquid address for on-chain protocols. */
+    async sendPayment(request) {
+        this.assertConnected();
+        if (request.amount == null) {
+            throw new ProtocolError('Liquid send requires an explicit amount', 'LIQUID', 'NO_AMOUNT');
+        }
+        const r = await this.account.transfer({ recipient: request.invoice.trim(), amount: request.amount });
+        return {
+            paymentHash: r?.hash ?? '',
+            amount: request.amount,
+            fee: Number(r?.fee ?? 0),
+            status: 'pending', // on-chain — confirms later
+            timestamp: Date.now(),
+        };
+    }
+    /** Liquid asset send (e.g. USDt). */
+    async sendAsset(params) {
+        this.assertConnected();
+        const r = await this.account.sendAsset({
+            assetId: params.assetId,
+            recipient: params.address,
+            amount: params.amount,
+            feeRate: params.feeRate,
+        });
+        return { paymentHash: r?.hash ?? '', fee: Number(r?.fee ?? 0), amount: params.amount, status: 'pending' };
+    }
+    /** L-BTC on-chain send (alias of sendPayment's transfer). */
+    async sendBtcOnchain(params) {
+        this.assertConnected();
+        const r = await this.account.transfer({ recipient: params.address, amount: params.amount, feeRate: params.feeRate });
+        return { txid: r?.hash ?? '', fee: Number(r?.fee ?? 0) };
+    }
+    // --- Transactions -------------------------------------------------------
+    async listTransactions(_filter) {
+        this.assertConnected();
+        const txs = await this.account.listTransactions();
+        return txs.map((t) => ({
+            id: t.txid,
+            type: t.type === 'outgoing' ? 'send' : 'receive',
+            status: (t.height != null ? 'confirmed' : 'pending'),
+            timestamp: (t.timestamp ?? 0) * 1000,
+            amount: 0, // lwk tx summary carries no net value here; enrich in Phase 3 from unspents/deltas
+            amountDisplay: '',
+            fee: Number(t.fee ?? 0),
+            asset: undefined, // TODO(Phase 3): resolve per-tx asset
+            protocolData: { height: t.height },
+        }));
+    }
+    async getTransaction(txId) {
+        const all = await this.listTransactions();
+        const found = all.find((t) => t.id === txId);
+        if (!found)
+            throw new ProtocolError(`Unknown tx ${txId}`, 'LIQUID', 'NO_TX');
+        return found;
+    }
+    async getPaymentStatus(paymentHash) {
+        const all = await this.listTransactions();
+        const found = all.find((t) => t.id === paymentHash);
+        return {
+            paymentHash,
+            status: (found?.status ?? 'pending'),
+            timestamp: found?.timestamp,
+        };
+    }
+    // --- Node info ----------------------------------------------------------
+    async getNodeInfo() {
+        this.assertConnected();
+        return this.account.getNetworkInfo();
+    }
+    async getBtcBalanceConfirmed() {
+        return (await this.getBtcBalance()).total;
+    }
+    // --- Not applicable to Liquid (on-chain only, no LN/invoices) -----------
+    async createInvoice(_request) {
+        throw new ProtocolError('Liquid has no invoices — use getReceiveAddress', 'LIQUID', 'NOT_SUPPORTED');
+    }
+    async decodeInvoice(_invoice) {
+        throw new ProtocolError('Liquid has no invoices', 'LIQUID', 'NOT_SUPPORTED');
+    }
+    async listChannels() {
+        return []; // no Lightning
+    }
+    async listPayments() {
+        return this.listTransactions();
+    }
+    async listTransfers() {
+        return this.account.listTransactions();
+    }
+    supportsSwaps() {
+        return getCapabilities('LIQUID').supportsSwaps;
+    }
+    // --- helpers ------------------------------------------------------------
+    async getPolicyAsset() {
+        if (this.policyAsset)
+            return this.policyAsset;
+        const info = await this.account.getNetworkInfo();
+        const policy = info?.policy_asset ?? '';
+        this.policyAsset = policy;
+        return policy;
+    }
+    toUnifiedAsset(id, balance, meta) {
+        const n = Number(balance);
+        return {
+            id,
+            name: meta.name,
+            ticker: meta.ticker,
+            precision: meta.precision,
+            protocol: 'LIQUID',
+            layer: meta.layer,
+            balance: { total: n, available: n, pending: 0, totalDisplay: String(n), availableDisplay: String(n) },
+            capabilities: {
+                canSend: true,
+                canReceive: true,
+                canSwap: false,
+                supportsLightning: false,
+                supportsOnchain: true,
+            },
+        };
+    }
+    assertConnected() {
+        if (!this.connected || !this.account) {
+            throw new ProtocolError('LiquidWdkAdapter not connected', 'LIQUID', 'NOT_CONNECTED');
+        }
+    }
+}
+//# sourceMappingURL=LiquidWdkAdapter.js.map

package/dist/adapters/wdk/LiquidWdkAdapter.js.map

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

package/dist/adapters/wdk/RlnWdkAdapter.d.ts

@@ -0,0 +1,86 @@
+/**
+ * RlnWdkAdapter
+ * -------------
+ * Wraps the WDK RGB-Lightning module (@kaleidorg/wdk-wallet-rln, over kaleido-sdk)
+ * onto the stable `IProtocolAdapter` contract. This is the RGB path: BTC on-chain,
+ * BTC Lightning, RGB assets (USDT/XAUT) on-chain and over Lightning, plus channels
+ * and atomic swaps.
+ *
+ * The RLN account talks to a remote RGB-Lightning node over HTTP (nodeUrl).
+ *
+ * Discipline: no WDK/kaleido-sdk types cross the contract — domain types only;
+ * node responses are read as `any` and translated.
+ *
+ * WDK RLN surface (from types/index.d.ts): getAddress, getBalance, getBtcBalance,
+ * sendBtc, listAssets({nia,uda,cfa}), getAssetBalance, sendRgb, createLNInvoice,
+ * createRgbInvoice, sendPayment, getInvoiceStatus, decodeLNInvoice/decodeRgbInvoice,
+ * listChannels/openChannel/closeChannel, listPeers/connectPeer, atomicTaker/listSwaps.
+ */
+import { IProtocolAdapter, BaseProtocolConfig } from '../IProtocolAdapter.js';
+import { ProtocolType, Layer, UnifiedAsset, UnifiedTransaction, InvoiceRequest, Invoice, DecodedInvoice, PaymentRequest, PaymentResult, PaymentStatus, Address, ConnectionInfo, TransactionFilter } from '../../types/base.js';
+export interface RlnAdapterConfig extends BaseProtocolConfig {
+    protocol: 'RGB';
+    /** BIP-39 mnemonic for this wallet. */
+    mnemonic: string;
+    /** Base URL of the RLN HTTP API (e.g. http://localhost:3001). */
+    nodeUrl: string;
+    /** BIP-44 account index (default 0). */
+    accountIndex?: number;
+}
+export declare class RlnWdkAdapter implements IProtocolAdapter {
+    readonly protocolName: ProtocolType;
+    readonly capabilities: readonly import("../../index.js").ProtocolCapability[];
+    readonly supportedLayers: Layer[];
+    readonly version = "0.1.0-wdk";
+    private manager;
+    private account;
+    private connected;
+    private network;
+    connect(config: BaseProtocolConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getConnectionInfo(): Promise<ConnectionInfo>;
+    getReceiveAddress(assetId?: string): Promise<Address>;
+    getBtcBalance(): Promise<{
+        confirmed: number;
+        unconfirmed: number;
+        total: number;
+    }>;
+    refreshBalances(): Promise<void>;
+    listAssets(): Promise<UnifiedAsset[]>;
+    getAssetBalance(assetId: string): Promise<UnifiedAsset['balance']>;
+    getAsset(assetId: string): Promise<UnifiedAsset>;
+    createInvoice(request: InvoiceRequest): Promise<Invoice>;
+    decodeInvoice(invoice: string): Promise<DecodedInvoice>;
+    sendPayment(request: PaymentRequest): Promise<PaymentResult>;
+    getPaymentStatus(paymentHash: string): Promise<PaymentStatus>;
+    listTransactions(_filter?: TransactionFilter): Promise<UnifiedTransaction[]>;
+    getTransaction(txId: string): Promise<UnifiedTransaction>;
+    getNodeInfo(): Promise<any>;
+    listChannels(): Promise<any[]>;
+    listPayments(): Promise<any>;
+    listTransfers(options?: {
+        asset_id?: string;
+    }): Promise<any>;
+    createRgbInvoice(params: any): Promise<any>;
+    decodeRgbInvoice(params: any): Promise<any>;
+    getInvoiceStatus(params: {
+        invoice: string;
+    }): Promise<any>;
+    sendAsset(params: {
+        recipientMap: Record<string, any[]>;
+        feeRate?: number;
+        donation?: boolean;
+        minConfirmations?: number;
+    }): Promise<any>;
+    sendBtcOnchain(params: {
+        address: string;
+        amount: number;
+        feeRate?: number;
+    }): Promise<any>;
+    supportsSwaps(): boolean;
+    /** Generic escape hatch for RLN-specific ops not on the core contract. */
+    executeProtocolOperation(operation: string, params: any): Promise<any>;
+    private assertConnected;
+}
+//# sourceMappingURL=RlnWdkAdapter.d.ts.map

package/dist/adapters/wdk/RlnWdkAdapter.d.ts.map

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