ecash-quicksend 1.0.0

package/dist/send/xecsend.d.ts

@@ -0,0 +1,23 @@
+import { TransactionResult } from '../types';
+interface ExtendedRecipient {
+    address: string;
+    amount: number;
+    tokenId?: string;
+    decimals?: number;
+}
+interface XecTransactionResult extends TransactionResult {
+    utxoSelection: any;
+    recipients: number;
+    xecRecipients: number;
+    tokenRecipients: number;
+    totalSent: number;
+    tokenTransfers: Array<{
+        tokenId: string;
+        amount: number;
+        decimals?: number;
+        address: string;
+    }>;
+}
+export declare function createRawXecTransaction(recipients: ExtendedRecipient[], utxoStrategy?: string, addressIndex?: number): Promise<XecTransactionResult>;
+export {};
+//# sourceMappingURL=xecsend.d.ts.map

package/dist/send/xecsend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xecsend.d.ts","sourceRoot":"","sources":["../../send/xecsend.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG7C,UAAU,iBAAiB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,UAAU,oBAAqB,SAAQ,iBAAiB;IACtD,aAAa,EAAE,GAAG,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,KAAK,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,iBAAiB,EAAE,EAC/B,YAAY,GAAE,MAAc,EAC5B,YAAY,GAAE,MAAU,GACvB,OAAO,CAAC,oBAAoB,CAAC,CA4G/B"}

package/dist/send/xecsend.js

@@ -0,0 +1,99 @@
+import dotenv from 'dotenv';
+dotenv.config();
+import { getUtxos, selectUtxos } from '../utxo/utxo-utils';
+import { initializeWallet } from '../wallet/wallet-utils';
+import { buildTransactionInputs, createP2pkhScript } from '../transaction/transaction-utils';
+import { buildAndBroadcastTransaction, logTransactionSummary } from '../transaction/transaction-builder';
+export async function createRawXecTransaction(recipients, utxoStrategy = 'all', addressIndex = 0) {
+    try {
+        // 验证参数
+        if (!Array.isArray(recipients) || recipients.length === 0) {
+            throw new Error('recipients must be a non-empty array');
+        }
+        // 验证每个接收方对象
+        for (const recipient of recipients) {
+            if (!recipient.address || typeof recipient.amount !== 'number') {
+                throw new Error('Each recipient must have address and amount fields');
+            }
+            // 如果提供了tokenId，验证其格式
+            if (recipient.tokenId && typeof recipient.tokenId !== 'string') {
+                throw new Error('tokenId must be a string if provided');
+            }
+            // 如果提供了decimals，验证其为非负整数
+            if (recipient.decimals !== undefined && (!Number.isInteger(recipient.decimals) || recipient.decimals < 0)) {
+                throw new Error('decimals must be a non-negative integer if provided');
+            }
+        }
+        // 初始化钱包 - 使用指定的地址索引
+        const { walletSk, walletPk, walletP2pkh, address: utxoAddress } = initializeWallet(addressIndex);
+        const utxos = await getUtxos(utxoAddress);
+        if (utxos.length === 0) {
+            throw new Error(`No UTXOs found for address index ${addressIndex}`);
+        }
+        // 计算总发送金额 (只计算XEC，不包括代币)
+        const totalSendAmount = recipients
+            .filter(recipient => !recipient.tokenId) // 只计算非代币交易
+            .reduce((sum, recipient) => sum + recipient.amount, 0);
+        // 分析交易类型
+        const xecRecipients = recipients.filter(r => !r.tokenId);
+        const tokenRecipients = recipients.filter(r => r.tokenId);
+        // 选择UTXOs
+        const utxoSelection = selectUtxos(utxos, totalSendAmount, utxoStrategy);
+        const { selectedUtxos } = utxoSelection;
+        // 记录交易摘要
+        logTransactionSummary('XEC', {
+            地址索引: addressIndex,
+            策略: utxoStrategy,
+            接收方数量: recipients.length,
+            XEC接收方: xecRecipients.length,
+            代币接收方: tokenRecipients.length,
+            总发送金额: totalSendAmount,
+            UTXOs数量: selectedUtxos.length,
+            总输入: utxoSelection.totalInputValue,
+            预估手续费: utxoSelection.estimatedFee,
+            预计找零: utxoSelection.changeAmount
+        });
+        // 构建交易输入
+        const inputs = buildTransactionInputs(selectedUtxos, walletP2pkh, walletSk, walletPk);
+        // 构建交易输出 - 为每个接收方创建输出
+        const outputs = [];
+        // 添加所有接收方输出
+        recipients.forEach(recipient => {
+            const output = {
+                sats: BigInt(recipient.amount),
+                script: createP2pkhScript(recipient.address)
+            };
+            // 如果是代币交易，添加代币信息
+            if (recipient.tokenId) {
+                output.tokenId = recipient.tokenId;
+                if (recipient.decimals !== undefined) {
+                    output.decimals = recipient.decimals;
+                }
+            }
+            outputs.push(output);
+        });
+        // 添加找零脚本 - 保持原始逻辑！
+        outputs.push(walletP2pkh);
+        // 构建并广播交易
+        const result = await buildAndBroadcastTransaction(inputs, outputs);
+        return {
+            ...result,
+            utxoSelection,
+            recipients: recipients.length,
+            xecRecipients: xecRecipients.length,
+            tokenRecipients: tokenRecipients.length,
+            totalSent: totalSendAmount,
+            tokenTransfers: tokenRecipients.map(r => ({
+                tokenId: r.tokenId,
+                amount: r.amount,
+                decimals: r.decimals,
+                address: r.address
+            }))
+        };
+    }
+    catch (error) {
+        console.error('XEC transaction creation failed:', error);
+        throw error;
+    }
+}
+//# sourceMappingURL=xecsend.js.map

package/dist/send/xecsend.js.map

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

package/dist/transaction/transaction-builder.d.ts

@@ -0,0 +1,33 @@
+import { TransactionResult } from "../types";
+interface TransactionOptions {
+    feePerKb?: bigint;
+    dustSats?: bigint;
+    dustLimit?: number;
+}
+interface RequiredParamConfig {
+    key: string;
+    message: string;
+    checkUndefined?: boolean;
+}
+/**
+ * 构建并广播交易的通用函数
+ * @param inputs - 交易输入数组
+ * @param outputs - 交易输出数组
+ * @param options - 交易选项
+ * @returns 包含 explorer 链接和交易 ID 的对象
+ */
+export declare function buildAndBroadcastTransaction(inputs: any[], outputs: any[], options?: TransactionOptions): Promise<TransactionResult>;
+/**
+ * 验证必需参数的通用函数
+ * @param params - 参数对象
+ * @param required - 必需参数配置数组
+ */
+export declare function validateRequiredParams(params: any, required: RequiredParamConfig[]): void;
+/**
+ * 记录交易摘要的通用函数
+ * @param type - 交易类型
+ * @param summary - 摘要信息
+ */
+export declare function logTransactionSummary(type: string, summary: any): void;
+export {};
+//# sourceMappingURL=transaction-builder.d.ts.map

package/dist/transaction/transaction-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-builder.d.ts","sourceRoot":"","sources":["../../transaction/transaction-builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAK7C,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,UAAU,mBAAmB;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,GAAG,EAAE,EACb,OAAO,EAAE,GAAG,EAAE,EACd,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAmC5B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAMzF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI,CAEtE"}

package/dist/transaction/transaction-builder.js

@@ -0,0 +1,59 @@
+import { chronik } from "../client/chronik-client";
+import ecashLib from "ecash-lib";
+const { TxBuilder, toHex } = ecashLib;
+/**
+ * 构建并广播交易的通用函数
+ * @param inputs - 交易输入数组
+ * @param outputs - 交易输出数组
+ * @param options - 交易选项
+ * @returns 包含 explorer 链接和交易 ID 的对象
+ */
+export async function buildAndBroadcastTransaction(inputs, outputs, options = {}) {
+    const { feePerKb = 1000n, dustSats = 546n, dustLimit = 546 } = options;
+    try {
+        // 构建交易
+        const txBuild = new TxBuilder({ inputs, outputs });
+        // 签名交易
+        const tx = txBuild.sign({
+            feePerKb,
+            dustSats: typeof dustSats === 'bigint' ? dustSats : BigInt(dustLimit)
+        });
+        // 序列化交易
+        const rawTxHex = toHex(tx.ser());
+        // 广播交易
+        const broadcastResponse = await chronik.broadcastTx(rawTxHex);
+        if (!broadcastResponse) {
+            throw new Error("Empty Chronik broadcast response");
+        }
+        return {
+            explorerLink: `https://explorer.e.cash/tx/${broadcastResponse.txid}`,
+            broadcastResult: broadcastResponse.txid,
+            txid: broadcastResponse.txid
+        };
+    }
+    catch (error) {
+        console.error("Transaction build/broadcast failed:", error);
+        throw error;
+    }
+}
+/**
+ * 验证必需参数的通用函数
+ * @param params - 参数对象
+ * @param required - 必需参数配置数组
+ */
+export function validateRequiredParams(params, required) {
+    for (const { key, message, checkUndefined } of required) {
+        if (checkUndefined ? params[key] === undefined : !params[key]) {
+            throw new Error(message);
+        }
+    }
+}
+/**
+ * 记录交易摘要的通用函数
+ * @param type - 交易类型
+ * @param summary - 摘要信息
+ */
+export function logTransactionSummary(type, summary) {
+    console.log(`${type}交易摘要:`, summary);
+}
+//# sourceMappingURL=transaction-builder.js.map

package/dist/transaction/transaction-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-builder.js","sourceRoot":"","sources":["../../transaction/transaction-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,QAAQ,MAAM,WAAW,CAAC;AAGjC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;AAgBtC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,MAAa,EACb,OAAc,EACd,UAA8B,EAAE;IAEhC,MAAM,EACJ,QAAQ,GAAG,KAAK,EAChB,QAAQ,GAAG,IAAI,EACf,SAAS,GAAG,GAAG,EAChB,GAAG,OAAO,CAAC;IAEZ,IAAI,CAAC;QACH,OAAO;QACP,MAAM,OAAO,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAEnD,OAAO;QACP,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YACtB,QAAQ;YACR,QAAQ,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;SACtE,CAAC,CAAC;QAEH,QAAQ;QACR,MAAM,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAEjC,OAAO;QACP,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,OAAO;YACL,YAAY,EAAE,8BAA8B,iBAAiB,CAAC,IAAI,EAAE;YACpE,eAAe,EAAE,iBAAiB,CAAC,IAAI;YACvC,IAAI,EAAE,iBAAiB,CAAC,IAAI;SAC7B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;QAC5D,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAW,EAAE,QAA+B;IACjF,KAAK,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,QAAQ,EAAE,CAAC;QACxD,IAAI,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,OAAY;IAC9D,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/transaction/transaction-utils.d.ts

@@ -0,0 +1,31 @@
+import { Utxo } from '../types';
+interface TransactionInput {
+    input: {
+        prevOut: {
+            txid: string;
+            outIdx: number;
+        };
+        signData: {
+            sats: bigint;
+            outputScript: any;
+        };
+    };
+    signatory: any;
+}
+/**
+ * 构建交易输入 - 通用函数，支持单个或多个UTXO数组
+ * @param utxos - 单个UTXO数组或多个UTXO数组
+ * @param walletP2pkh - 钱包脚本
+ * @param walletSk - 私钥
+ * @param walletPk - 公钥
+ * @returns 交易输入数组
+ */
+export declare function buildTransactionInputs(utxos: Utxo[] | Utxo[][], walletP2pkh: any, walletSk: Uint8Array, walletPk: Uint8Array): TransactionInput[];
+/**
+ * 创建P2PKH脚本
+ * @param address - eCash地址
+ * @returns P2PKH脚本
+ */
+export declare function createP2pkhScript(address: string): any;
+export {};
+//# sourceMappingURL=transaction-utils.d.ts.map

package/dist/transaction/transaction-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-utils.d.ts","sourceRoot":"","sources":["../../transaction/transaction-utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAShC,UAAU,gBAAgB;IACxB,KAAK,EAAE;QACL,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;QACF,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC;YACb,YAAY,EAAE,GAAG,CAAC;SACnB,CAAC;KACH,CAAC;IACF,SAAS,EAAE,GAAG,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,EACxB,WAAW,EAAE,GAAG,EAChB,QAAQ,EAAE,UAAU,EACpB,QAAQ,EAAE,UAAU,GACnB,gBAAgB,EAAE,CAWpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAOtD"}

package/dist/transaction/transaction-utils.js

@@ -0,0 +1,37 @@
+import ecashLib from 'ecash-lib';
+import { decodeCashAddress } from 'ecashaddrjs';
+const { P2PKHSignatory, ALL_BIP143, Script, } = ecashLib;
+/**
+ * 构建交易输入 - 通用函数，支持单个或多个UTXO数组
+ * @param utxos - 单个UTXO数组或多个UTXO数组
+ * @param walletP2pkh - 钱包脚本
+ * @param walletSk - 私钥
+ * @param walletPk - 公钥
+ * @returns 交易输入数组
+ */
+export function buildTransactionInputs(utxos, walletP2pkh, walletSk, walletPk) {
+    // 如果传入的是多个数组（如SLP交易的tokenUtxos和feeUtxos），则合并
+    const allUtxos = Array.isArray(utxos[0]) ? utxos.flat() : utxos;
+    return allUtxos.map(utxo => ({
+        input: {
+            prevOut: { txid: utxo.txid, outIdx: utxo.vout },
+            signData: { sats: BigInt(utxo.value), outputScript: walletP2pkh },
+        },
+        signatory: P2PKHSignatory(walletSk, walletPk, ALL_BIP143),
+    }));
+}
+/**
+ * 创建P2PKH脚本
+ * @param address - eCash地址
+ * @returns P2PKH脚本
+ */
+export function createP2pkhScript(address) {
+    try {
+        const { hash } = decodeCashAddress(address);
+        return Script.p2pkh(Buffer.from(hash, 'hex'));
+    }
+    catch (error) {
+        throw new Error(`Invalid address: ${address}`);
+    }
+}
+//# sourceMappingURL=transaction-utils.js.map

package/dist/transaction/transaction-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-utils.js","sourceRoot":"","sources":["../../transaction/transaction-utils.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,EACJ,cAAc,EACd,UAAU,EACV,MAAM,GACP,GAAG,QAAQ,CAAC;AAiBb;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAwB,EACxB,WAAgB,EAChB,QAAoB,EACpB,QAAoB;IAEpB,6CAA6C;IAC7C,MAAM,QAAQ,GAAW,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,KAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAe,CAAC;IAEhG,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3B,KAAK,EAAE;YACL,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE;YAC/C,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE;SAClE;QACD,SAAS,EAAE,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC;KAC1D,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 交易接收方
+ */
+export interface Recipient {
+    address: string;
+    amount: number;
+}
+/**
+ * UTXO接口 - 统一的UTXO定义
+ */
+export interface Utxo {
+    txid: string;
+    vout: number;
+    value: number;
+    address?: string;
+    slpToken?: SlpToken;
+    [key: string]: any;
+}
+/**
+ * SLP代币信息接口
+ */
+export interface SlpToken {
+    tokenId: string;
+    atoms: string | bigint;
+    [key: string]: any;
+}
+/**
+ * 交易结果 - 统一的交易结果接口
+ */
+export interface TransactionResult {
+    txid: string;
+    explorerLink?: string;
+    broadcastResult?: string;
+    fee?: number;
+    inputs?: any[];
+    outputs?: any[];
+    [key: string]: any;
+}
+/**
+ * SLP/ALP 代币交易选项
+ */
+export interface TokenTransactionOptions {
+    tokenId: string;
+    tokenDecimals: number;
+    addressIndex?: number;
+    feeStrategy?: string;
+    tokenStrategy?: string;
+}
+/**
+ * XEC 交易选项（可以是字符串或对象）
+ */
+export interface XecTransactionOptions {
+    utxoStrategy?: string;
+    addressIndex?: number;
+}
+/**
+ * XEC 交易选项联合类型
+ */
+export type XecOptions = string | XecTransactionOptions;
+/**
+ * 通用发送方法的选项
+ */
+export interface GeneralSendOptions {
+    utxoStrategy?: string;
+    addressIndex?: number;
+    tokenId?: string;
+    tokenDecimals?: number;
+    feeStrategy?: string;
+    tokenStrategy?: string;
+}
+/**
+ * 交易类型
+ */
+export type TransactionType = 'slp' | 'alp' | 'xec';
+/**
+ * UTXO策略类型
+ */
+export type UtxoStrategy = 'all' | 'single' | 'multiple';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,qBAAqB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// 基础接口定义
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA,SAAS"}

package/dist/utxo/utxo-utils.d.ts

@@ -0,0 +1,79 @@
+import { Utxo, Recipient } from '../types';
+interface UtxoSelection {
+    selectedUtxos: Utxo[];
+    totalInputValue: number;
+    estimatedFee: number;
+    changeAmount: number;
+    utxoCount: number;
+}
+interface SlpUtxoOptions {
+    dustLimit?: number;
+    feeStrategy?: 'all' | 'minimal' | 'largest_first';
+    tokenStrategy?: 'largest' | 'minimal' | 'all';
+}
+interface SlpUtxoSelection {
+    selectedTokenUtxos: Utxo[];
+    selectedFeeUtxos: Utxo[];
+    totalFeeInputValue: number;
+    estimatedFee: number;
+    feeChangeAmount: number;
+    tokenChange: bigint;
+    finalSendAmounts: bigint[];
+    totalSendTokens: bigint;
+    totalTokens: bigint;
+    dustLimit: number;
+    summary: {
+        tokenUtxoCount: number;
+        feeUtxoCount: number;
+        recipientCount: number;
+        hasTokenChange: boolean;
+        totalOutputs: number;
+    };
+}
+interface TokenBalance {
+    tokenId: string;
+    totalTokens: bigint;
+    utxoCount: number;
+    utxos: Utxo[];
+}
+interface AddressBalance {
+    totalBalance: number;
+    utxoCount: number;
+    slpUtxoCount: number;
+    nonSlpUtxos: Utxo[];
+    slpUtxos: Utxo[];
+    tokenBalances: TokenBalance[];
+}
+type UtxoStrategy = 'all' | 'minimal' | 'largest_first';
+/**
+ * Get UTXOs for a given address
+ * @param address - eCash address
+ * @returns Array of UTXOs
+ */
+declare function getUtxos(address: string): Promise<Utxo[]>;
+/**
+ * 选择合适的UTXOs用于普通XEC交易
+ * @param utxos - 所有可用的UTXOs
+ * @param sendAmount - 要发送的金额
+ * @param strategy - 选择策略
+ * @returns 包含选择的UTXOs和相关信息
+ */
+declare function selectUtxos(utxos: Utxo[], sendAmount: number, strategy?: UtxoStrategy): UtxoSelection;
+/**
+ * 为SLP交易选择UTXOs
+ * @param utxos - 所有可用的UTXOs
+ * @param tokenId - SLP代币ID
+ * @param recipients - 接收方数组，包含address和amount
+ * @param tokenDecimals - 代币小数位数
+ * @param options - 选项
+ * @returns 包含选择的UTXOs和相关信息
+ */
+declare function selectSlpUtxos(utxos: Utxo[], tokenId: string, recipients: Recipient[], tokenDecimals: number, options?: SlpUtxoOptions): SlpUtxoSelection;
+/**
+ * 获取地址余额信息
+ * @param address - eCash地址
+ * @returns 余额信息
+ */
+declare function getAddressBalance(address: string): Promise<AddressBalance>;
+export { getUtxos, selectUtxos, selectSlpUtxos, getAddressBalance };
+//# sourceMappingURL=utxo-utils.d.ts.map

package/dist/utxo/utxo-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utxo-utils.d.ts","sourceRoot":"","sources":["../../utxo/utxo-utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAY,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrD,UAAU,aAAa;IACrB,aAAa,EAAE,IAAI,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,eAAe,CAAC;IAClD,aAAa,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC;CAC/C;AAGD,UAAU,gBAAgB;IACxB,kBAAkB,EAAE,IAAI,EAAE,CAAC;IAC3B,gBAAgB,EAAE,IAAI,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,OAAO,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAGD,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAGD,UAAU,cAAc;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,IAAI,EAAE,CAAC;IACpB,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjB,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B;AAGD,KAAK,YAAY,GAAG,KAAK,GAAG,SAAS,GAAG,eAAe,CAAC;AAExD;;;;GAIG;AACH,iBAAe,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAqBxD;AAED;;;;;;GAMG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,YAAoB,GAAG,aAAa,CA4DrG;AAED;;;;;;;;GAQG;AACH,iBAAS,cAAc,CACrB,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,SAAS,EAAE,EACvB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,cAAmB,GAC3B,gBAAgB,CAgHlB;AAED;;;;GAIG;AACH,iBAAe,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAqCzE;AAED,OAAO,EACL,QAAQ,EACR,WAAW,EACX,cAAc,EACd,iBAAiB,EAClB,CAAC"}