ecash-quicksend 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ecash-sendlib
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/README.md

@@ -0,0 +1,255 @@
+# ecash-quicksend
+
+[![npm version](https://badge.fury.io/js/ecash-quicksend.svg)](https://badge.fury.io/js/ecash-quicksend)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A unified transaction manager for eCash (XEC), SLP, and ALP token transactions. Simplify your eCash blockchain interactions with a single, easy-to-use library.
+
+## Features
+
+- ✅ **XEC Transactions**: Send eCash (XEC) with customizable UTXO strategies
+- ✅ **SLP Token Support**: Full support for Simple Ledger Protocol tokens
+- ✅ **ALP Token Support**: Advanced Ledger Protocol token transactions
+- ✅ **TypeScript Support**: Full TypeScript definitions included
+- ✅ **Unified API**: Single interface for all transaction types
+- ✅ **Flexible Configuration**: Mnemonic-based wallet management
+- ✅ **Automatic UTXO Management**: Smart UTXO selection strategies
+
+## Installation
+
+```bash
+npm install ecash-quicksend
+```
+
+## Quick Start
+
+### 1. Environment Setup
+
+Create a `.env` file in your project root:
+
+```env
+# Required: Your wallet mnemonic (12-24 words)
+MNEMONIC="your twelve word mnemonic phrase goes here and should be kept secret"
+```
+
+### 2. Basic Usage
+
+```javascript
+import transactionManager from 'ecash-quicksend';
+
+// Send XEC
+const xecResult = await transactionManager.sendXec([
+  { address: 'ecash:qq...', amount: 1000 } // 1000 satoshis
+]);
+
+// Send SLP tokens
+const slpResult = await transactionManager.sendSlp([
+  { address: 'ecash:qq...', amount: 100 }
+], {
+  tokenId: 'your-slp-token-id',
+  tokenDecimals: 8
+});
+
+// Send ALP tokens
+const alpResult = await transactionManager.sendAlp([
+  { address: 'ecash:qq...', amount: 100 }
+], {
+  tokenId: 'your-alp-token-id',
+  tokenDecimals: 8
+});
+```
+
+## API Reference
+
+### TransactionManager
+
+The main class that manages all transaction types.
+
+#### Methods
+
+##### `sendXec(recipients, options?)`
+
+Send eCash (XEC) to one or more recipients.
+
+```typescript
+await transactionManager.sendXec(
+  [{ address: 'ecash:qq...', amount: 1000 }],
+  {
+    utxoStrategy: 'all', // 'all' | 'largest' | 'smallest'
+    addressIndex: 0
+  }
+);
+```
+
+**Parameters:**
+- `recipients`: Array of `{ address: string, amount: number }`
+- `options`: Optional configuration object
+
+##### `sendSlp(recipients, options)`
+
+Send SLP tokens to one or more recipients.
+
+```typescript
+await transactionManager.sendSlp(
+  [{ address: 'ecash:qq...', amount: 100 }],
+  {
+    tokenId: 'your-token-id',
+    tokenDecimals: 8,
+    addressIndex: 0,
+    feeStrategy: 'auto',
+    tokenStrategy: 'auto'
+  }
+);
+```
+
+##### `sendAlp(recipients, options)`
+
+Send ALP tokens to one or more recipients.
+
+```typescript
+await transactionManager.sendAlp(
+  [{ address: 'ecash:qq...', amount: 100 }],
+  {
+    tokenId: 'your-token-id',
+    tokenDecimals: 8,
+    addressIndex: 0,
+    feeStrategy: 'auto',
+    tokenStrategy: 'auto'
+  }
+);
+```
+
+##### `send(type, recipients, options?)`
+
+Universal send method supporting all transaction types.
+
+```typescript
+// Send XEC
+await transactionManager.send('xec', recipients, {
+  utxoStrategy: 'all',
+  addressIndex: 0
+});
+
+// Send SLP
+await transactionManager.send('slp', recipients, {
+  tokenId: 'your-token-id',
+  tokenDecimals: 8
+});
+
+// Send ALP
+await transactionManager.send('alp', recipients, {
+  tokenId: 'your-token-id',
+  tokenDecimals: 8
+});
+```
+
+## Types
+
+### Recipient
+
+```typescript
+interface Recipient {
+  address: string;  // eCash address (ecash:qq...)
+  amount: number;   // Amount in base units (satoshis for XEC, token units for SLP/ALP)
+}
+```
+
+### TransactionResult
+
+```typescript
+interface TransactionResult {
+  txid: string;           // Transaction ID
+  success: boolean;       // Transaction success status
+  message?: string;       // Optional status message
+  rawTx?: string;         // Raw transaction hex
+}
+```
+
+### Token Transaction Options
+
+```typescript
+interface TokenTransactionOptions {
+  tokenId: string;              // Token ID
+  tokenDecimals: number;        // Token decimal places
+  addressIndex?: number;        // Wallet address index (default: 0)
+  feeStrategy?: string;         // Fee calculation strategy
+  tokenStrategy?: string;       // Token UTXO selection strategy
+}
+```
+
+### XEC Transaction Options
+
+```typescript
+interface XecTransactionOptions {
+  utxoStrategy?: string;        // 'all' | 'largest' | 'smallest'
+  addressIndex?: number;        // Wallet address index (default: 0)
+}
+```
+
+## Advanced Usage
+
+### Multiple Recipients
+
+```javascript
+// Send to multiple recipients in a single transaction
+await transactionManager.sendXec([
+  { address: 'ecash:qq...', amount: 1000 },
+  { address: 'ecash:qp...', amount: 2000 },
+  { address: 'ecash:qr...', amount: 500 }
+]);
+```
+
+### Custom UTXO Strategies
+
+```javascript
+// Use largest UTXO first (good for consolidation)
+await transactionManager.sendXec(recipients, { utxoStrategy: 'largest' });
+
+// Use smallest UTXO first (good for privacy)
+await transactionManager.sendXec(recipients, { utxoStrategy: 'smallest' });
+
+// Use all available UTXOs (default)
+await transactionManager.sendXec(recipients, { utxoStrategy: 'all' });
+```
+
+### Address Index Management
+
+```javascript
+// Use different derived addresses
+await transactionManager.sendXec(recipients, { addressIndex: 1 });
+await transactionManager.sendSlp(recipients, options, { addressIndex: 2 });
+```
+
+## Error Handling
+
+```javascript
+try {
+  const result = await transactionManager.sendXec(recipients);
+  
+  if (result.success) {
+    console.log(`Transaction successful: ${result.txid}`);
+  } else {
+    console.error(`Transaction failed: ${result.message}`);
+  }
+} catch (error) {
+  console.error('Transaction error:', error.message);
+}
+```
+
+## Requirements
+
+- Node.js >= 18.0.0
+- A valid eCash wallet mnemonic phrase
+- Network access to eCash blockchain
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Support
+
+If you encounter any issues or have questions, please [open an issue](https://github.com/alitayin/quicksend/issues) on GitHub. 

package/dist/client/chronik-client.d.ts

@@ -0,0 +1,4 @@
+import { ChronikClient } from "chronik-client";
+declare const chronik: ChronikClient;
+export { chronik };
+//# sourceMappingURL=chronik-client.d.ts.map

package/dist/client/chronik-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chronik-client.d.ts","sourceRoot":"","sources":["../../client/chronik-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAa/C,QAAA,MAAM,OAAO,EAAE,aAA8C,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/client/chronik-client.js

@@ -0,0 +1,14 @@
+import { ChronikClient } from "chronik-client";
+// 定义多个Chronik节点
+const chronikUrls = [
+    'https://chronik-native2.fabien.cash',
+    'https://chronik-native3.fabien.cash',
+    'https://chronik.pay2stay.com/xec2',
+    'https://chronik-native1.fabien.cash',
+    'https://chronik1.alitayin.com',
+    'https://chronik2.alitayin.com',
+];
+// 创建共享的Chronik客户端实例，支持多个节点
+const chronik = new ChronikClient(chronikUrls);
+export { chronik };
+//# sourceMappingURL=chronik-client.js.map

package/dist/client/chronik-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chronik-client.js","sourceRoot":"","sources":["../../client/chronik-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,gBAAgB;AAChB,MAAM,WAAW,GAAa;IAC1B,qCAAqC;IACrC,qCAAqC;IACrC,mCAAmC;IACnC,qCAAqC;IACrC,+BAA+B;IAC/B,+BAA+B;CAClC,CAAC;AAEF,2BAA2B;AAC3B,MAAM,OAAO,GAAkB,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/config/constants.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 应用程序配置常量
+ */
+export declare const CONFIG: {
+    MNEMONIC: string;
+};
+/**
+ * 获取助记词
+ */
+export declare function getMnemonic(): string;
+/**
+ * 获取钱包私钥WIF (从助记词派生)
+ * @param addressIndex - 地址索引，默认为0
+ */
+export declare function getPrivateKeyWIF(addressIndex?: number): string;
+/**
+ * 获取默认的 UTXO 地址 (从助记词派生)
+ * @param addressIndex - 地址索引，默认为0
+ */
+export declare function getDefaultUtxoAddress(addressIndex?: number): string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/config/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../config/constants.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,MAAM;;CAGlB,CAAC;AAcF;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,GAAE,MAAU,GAAG,MAAM,CAGjE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,GAAE,MAAU,GAAG,MAAM,CAGtE"}

package/dist/config/constants.js

@@ -0,0 +1,46 @@
+import dotenv from 'dotenv';
+import { deriveBuyerKey } from '../wallet/mnemonic-utils';
+dotenv.config();
+/**
+ * 应用程序配置常量
+ */
+export const CONFIG = {
+    // 钱包配置 - 只需要助记词
+    MNEMONIC: process.env.MNEMONIC,
+};
+/**
+ * 验证必需的环境变量
+ */
+function validateConfig() {
+    if (!CONFIG.MNEMONIC) {
+        throw new Error('必须设置 MNEMONIC 环境变量');
+    }
+}
+// 在模块加载时自动验证配置
+validateConfig();
+/**
+ * 获取助记词
+ */
+export function getMnemonic() {
+    if (!CONFIG.MNEMONIC) {
+        throw new Error('助记词未设置');
+    }
+    return CONFIG.MNEMONIC;
+}
+/**
+ * 获取钱包私钥WIF (从助记词派生)
+ * @param addressIndex - 地址索引，默认为0
+ */
+export function getPrivateKeyWIF(addressIndex = 0) {
+    const derived = deriveBuyerKey(CONFIG.MNEMONIC, addressIndex);
+    return derived.wif;
+}
+/**
+ * 获取默认的 UTXO 地址 (从助记词派生)
+ * @param addressIndex - 地址索引，默认为0
+ */
+export function getDefaultUtxoAddress(addressIndex = 0) {
+    const derived = deriveBuyerKey(CONFIG.MNEMONIC, addressIndex);
+    return derived.address;
+}
+//# sourceMappingURL=constants.js.map

package/dist/config/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../config/constants.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,gBAAgB;IAChB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ;CAC/B,CAAC;AAEF;;GAEG;AACH,SAAS,cAAc;IACrB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED,eAAe;AACf,cAAc,EAAE,CAAC;AAEjB;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,eAAuB,CAAC;IACvD,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,QAAS,EAAE,YAAY,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC,GAAG,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,eAAuB,CAAC;IAC5D,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,QAAS,EAAE,YAAY,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC,OAAO,CAAC;AACzB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import { Recipient, TransactionResult, TokenTransactionOptions, XecOptions, GeneralSendOptions, TransactionType } from './types';
+/**
+ * 统一交易管理器
+ * 支持 SLP、ALP 和 XEC 交易类型
+ */
+declare class TransactionManager {
+    /**
+     * 发送 SLP 代币
+     * @param recipients - 接收方数组
+     * @param options - 交易选项
+     */
+    sendSlp(recipients: Recipient[], options: TokenTransactionOptions): Promise<TransactionResult>;
+    /**
+     * 发送 ALP 代币
+     * @param recipients - 接收方数组
+     * @param options - 交易选项
+     */
+    sendAlp(recipients: Recipient[], options: TokenTransactionOptions): Promise<TransactionResult>;
+    /**
+     * 发送 XEC (eCash)
+     * @param recipients - 接收方数组
+     * @param options - UTXO选择策略字符串或包含utxoStrategy和addressIndex的选项对象
+     */
+    sendXec(recipients: Recipient[], options?: XecOptions): Promise<TransactionResult>;
+    /**
+     * 通用发送方法
+     * @param type - 交易类型
+     * @param recipients - 接收方数组
+     * @param options - 交易选项
+     */
+    send(type: TransactionType, recipients: Recipient[], options?: GeneralSendOptions): Promise<TransactionResult>;
+}
+declare const transactionManager: TransactionManager;
+export default transactionManager;
+export { TransactionManager };
+export declare const sendSlp: (recipients: Recipient[], options: TokenTransactionOptions) => Promise<TransactionResult>, sendAlp: (recipients: Recipient[], options: TokenTransactionOptions) => Promise<TransactionResult>, sendXec: (recipients: Recipient[], options?: XecOptions) => Promise<TransactionResult>, send: (type: TransactionType, recipients: Recipient[], options?: GeneralSendOptions) => Promise<TransactionResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EAEV,kBAAkB,EAClB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,cAAM,kBAAkB;IACtB;;;;OAIG;IACG,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIpG;;;;OAIG;IACG,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIpG;;;;OAIG;IACG,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,GAAE,UAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgB/F;;;;;OAKG;IACG,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAkCzH;AAGD,QAAA,MAAM,kBAAkB,oBAA2B,CAAC;AAGpD,eAAe,kBAAkB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAG9B,eAAO,MAAQ,OAAO,eApFM,SAAS,EAAE,WAAW,uBAAuB,KAAG,OAAO,CAAC,iBAAiB,CAAC,EAoF9E,OAAO,eA3EH,SAAS,EAAE,WAAW,uBAAuB,KAAG,OAAO,CAAC,iBAAiB,CAAC,EA2ErE,OAAO,eAlEZ,SAAS,EAAE,YAAW,UAAU,KAAW,OAAO,CAAC,iBAAiB,CAAC,EAkEvD,IAAI,SA5C3B,eAAe,cAAc,SAAS,EAAE,YAAW,kBAAkB,KAAQ,OAAO,CAAC,iBAAiB,CA4CpD,CAAC"}

package/dist/index.js

@@ -0,0 +1,91 @@
+import { createRawSlpTransaction, createRawAlpTransaction } from './send/tokensend';
+import { createRawXecTransaction } from './send/xecsend.js';
+/**
+ * 统一交易管理器
+ * 支持 SLP、ALP 和 XEC 交易类型
+ */
+class TransactionManager {
+    /**
+     * 发送 SLP 代币
+     * @param recipients - 接收方数组
+     * @param options - 交易选项
+     */
+    async sendSlp(recipients, options) {
+        return await createRawSlpTransaction(recipients, options);
+    }
+    /**
+     * 发送 ALP 代币
+     * @param recipients - 接收方数组
+     * @param options - 交易选项
+     */
+    async sendAlp(recipients, options) {
+        return await createRawAlpTransaction(recipients, options);
+    }
+    /**
+     * 发送 XEC (eCash)
+     * @param recipients - 接收方数组
+     * @param options - UTXO选择策略字符串或包含utxoStrategy和addressIndex的选项对象
+     */
+    async sendXec(recipients, options = 'all') {
+        // 如果options是对象，提取相关参数；否则直接使用options作为策略
+        let utxoStrategy;
+        let addressIndex;
+        if (typeof options === 'object' && options !== null) {
+            utxoStrategy = options.utxoStrategy || 'all';
+            addressIndex = options.addressIndex || 0;
+        }
+        else {
+            utxoStrategy = options;
+            addressIndex = 0;
+        }
+        return await createRawXecTransaction(recipients, utxoStrategy, addressIndex);
+    }
+    /**
+     * 通用发送方法
+     * @param type - 交易类型
+     * @param recipients - 接收方数组
+     * @param options - 交易选项
+     */
+    async send(type, recipients, options = {}) {
+        switch (type.toLowerCase()) {
+            case 'slp':
+                if (!options.tokenId || !options.tokenDecimals) {
+                    throw new Error('SLP transactions require tokenId and tokenDecimals');
+                }
+                return await this.sendSlp(recipients, {
+                    tokenId: options.tokenId,
+                    tokenDecimals: options.tokenDecimals,
+                    addressIndex: options.addressIndex,
+                    feeStrategy: options.feeStrategy,
+                    tokenStrategy: options.tokenStrategy
+                });
+            case 'alp':
+                if (!options.tokenId || !options.tokenDecimals) {
+                    throw new Error('ALP transactions require tokenId and tokenDecimals');
+                }
+                return await this.sendAlp(recipients, {
+                    tokenId: options.tokenId,
+                    tokenDecimals: options.tokenDecimals,
+                    addressIndex: options.addressIndex,
+                    feeStrategy: options.feeStrategy,
+                    tokenStrategy: options.tokenStrategy
+                });
+            case 'xec':
+                const xecOptions = {
+                    utxoStrategy: options.utxoStrategy,
+                    addressIndex: options.addressIndex
+                };
+                return await this.sendXec(recipients, xecOptions);
+            default:
+                throw new Error(`Unsupported transaction type: ${type}`);
+        }
+    }
+}
+// 创建单例实例
+const transactionManager = new TransactionManager();
+// 导出实例和类
+export default transactionManager;
+export { TransactionManager };
+// 便捷方法导出
+export const { sendSlp, sendAlp, sendXec, send } = transactionManager;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/send/tokensend.d.ts

@@ -0,0 +1,10 @@
+import { Recipient, TokenTransactionOptions, TransactionResult } from "../types";
+/**
+ * 创建SLP代币交易
+ */
+export declare function createRawSlpTransaction(recipients: Recipient[], options: TokenTransactionOptions): Promise<TransactionResult>;
+/**
+ * 创建ALP代币交易
+ */
+export declare function createRawAlpTransaction(recipients: Recipient[], options: TokenTransactionOptions): Promise<TransactionResult>;
+//# sourceMappingURL=tokensend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokensend.d.ts","sourceRoot":"","sources":["../../send/tokensend.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,SAAS,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAsKjF;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAEnI;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAEnI"}

package/dist/send/tokensend.js

@@ -0,0 +1,121 @@
+import dotenv from "dotenv";
+dotenv.config();
+import ecashLib from "ecash-lib";
+import { getUtxos, selectSlpUtxos } from "../utxo/utxo-utils";
+import { initializeWallet } from "../wallet/wallet-utils";
+import { buildTransactionInputs, createP2pkhScript } from "../transaction/transaction-utils";
+import { buildAndBroadcastTransaction, validateRequiredParams, logTransactionSummary } from "../transaction/transaction-builder";
+const { Script, SLP_FUNGIBLE, slpSend, ALP_STANDARD, alpSend, OP_RETURN, pushBytesOp, OP_RESERVED, } = ecashLib;
+/**
+ * 构建SLP交易输出
+ */
+function buildSlpOutputs(tokenId, finalSendAmounts, recipients, tokenChange, dustLimit, walletP2pkh) {
+    const outputs = [];
+    // OP_RETURN 输出
+    outputs.push({ sats: 0n, script: slpSend(tokenId, SLP_FUNGIBLE, finalSendAmounts) });
+    // 接收方输出
+    recipients.forEach(recipient => {
+        outputs.push({
+            sats: BigInt(dustLimit),
+            script: createP2pkhScript(recipient.address)
+        });
+    });
+    // Token 找零输出
+    if (tokenChange > 0n) {
+        outputs.push({ sats: BigInt(dustLimit), script: walletP2pkh });
+    }
+    // 手续费找零脚本 - 保持原始逻辑！直接push脚本
+    outputs.push(walletP2pkh);
+    return outputs;
+}
+/**
+ * 构建ALP交易输出
+ */
+function buildAlpOutputs(tokenId, finalSendAmounts, recipients, tokenChange, dustLimit, walletP2pkh) {
+    const outputs = [];
+    // 构造完整的 OP_RETURN 脚本
+    const opReturnPayload = alpSend(tokenId, ALP_STANDARD, finalSendAmounts);
+    const opReturnScript = Script.fromOps([
+        OP_RETURN,
+        OP_RESERVED,
+        pushBytesOp(opReturnPayload)
+    ]);
+    // OP_RETURN 输出
+    outputs.push({ sats: 0n, script: opReturnScript });
+    // 接收方输出
+    recipients.forEach(recipient => {
+        outputs.push({
+            sats: BigInt(dustLimit),
+            script: createP2pkhScript(recipient.address)
+        });
+    });
+    // Token 找零输出
+    if (tokenChange > 0n) {
+        outputs.push({ sats: BigInt(dustLimit), script: walletP2pkh });
+    }
+    // 手续费找零脚本 - 保持原始逻辑！直接push脚本
+    outputs.push(walletP2pkh);
+    return outputs;
+}
+/**
+ * 创建代币交易的通用函数
+ */
+async function createTokenTransaction(recipients, options, tokenType = 'SLP') {
+    try {
+        // 验证必需参数
+        validateRequiredParams(options, [
+            { key: 'tokenId', message: 'tokenId is required' },
+            { key: 'tokenDecimals', message: 'tokenDecimals is required', checkUndefined: true }
+        ]);
+        const { tokenId, tokenDecimals, addressIndex = 0, feeStrategy = 'all', tokenStrategy = 'all' } = options;
+        // 初始化钱包 - 使用指定的地址索引
+        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}`);
+        }
+        // 选择代币UTXOs
+        const tokenSelection = selectSlpUtxos(utxos, tokenId, recipients, tokenDecimals, {
+            feeStrategy: feeStrategy,
+            tokenStrategy: tokenStrategy
+        });
+        const { selectedTokenUtxos, selectedFeeUtxos, finalSendAmounts, tokenChange, dustLimit, summary } = tokenSelection;
+        // 记录交易摘要
+        logTransactionSummary(tokenType, {
+            地址索引: addressIndex,
+            代币UTXOs数量: selectedTokenUtxos.length,
+            手续费UTXOs数量: selectedFeeUtxos.length,
+            接收方数量: recipients.length,
+            代币找零: tokenChange > 0n ? tokenChange.toString() : '无',
+            总输出数量: summary.totalOutputs
+        });
+        // 构建交易输入和输出
+        const inputs = buildTransactionInputs([selectedTokenUtxos, selectedFeeUtxos], walletP2pkh, walletSk, walletPk);
+        let outputs;
+        if (tokenType === 'ALP') {
+            outputs = buildAlpOutputs(tokenId, finalSendAmounts, recipients, tokenChange, dustLimit, walletP2pkh);
+        }
+        else {
+            outputs = buildSlpOutputs(tokenId, finalSendAmounts, recipients, tokenChange, dustLimit, walletP2pkh);
+        }
+        // 构建并广播交易
+        return await buildAndBroadcastTransaction(inputs, outputs, { dustLimit });
+    }
+    catch (error) {
+        console.error(`${tokenType} transaction creation failed:`, error);
+        throw error;
+    }
+}
+/**
+ * 创建SLP代币交易
+ */
+export async function createRawSlpTransaction(recipients, options) {
+    return createTokenTransaction(recipients, options, 'SLP');
+}
+/**
+ * 创建ALP代币交易
+ */
+export async function createRawAlpTransaction(recipients, options) {
+    return createTokenTransaction(recipients, options, 'ALP');
+}
+//# sourceMappingURL=tokensend.js.map

package/dist/send/tokensend.js.map

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