chaingate
Version:
Multi-chain cryptocurrency SDK for TypeScript — unified API for Bitcoin, Ethereum, Litecoin, Dogecoin, Bitcoin Cash, Polygon, Arbitrum, and any EVM-compatible chain. Create wallets, query balances, send transactions, and manage tokens and NFTs across UTXO
118 lines (117 loc) • 4.74 kB
JavaScript
;
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
if (k2 === undefined) k2 = k;
var desc = Object.getOwnPropertyDescriptor(m, k);
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
desc = { enumerable: true, get: function() { return m[k]; } };
}
Object.defineProperty(o, k2, desc);
}) : (function(o, m, k, k2) {
if (k2 === undefined) k2 = k;
o[k2] = m[k];
}));
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
Object.defineProperty(o, "default", { enumerable: true, value: v });
}) : function(o, v) {
o["default"] = v;
});
var __importStar = (this && this.__importStar) || (function () {
var ownKeys = function(o) {
ownKeys = Object.getOwnPropertyNames || function (o) {
var ar = [];
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
return ar;
};
return ownKeys(o);
};
return function (mod) {
if (mod && mod.__esModule) return mod;
var result = {};
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
__setModuleDefault(result, mod);
return result;
};
})();
Object.defineProperty(exports, "__esModule", { value: true });
exports.UtxoTransaction = void 0;
const btc = __importStar(require("@scure/btc-signer"));
const btc_signer_1 = require("@scure/btc-signer");
const BaseUtxoTransaction_1 = require("./BaseUtxoTransaction");
const utils_1 = require("../../utils");
/**
* An unsigned UTXO transaction prepared by {@link UtxoConnector.transfer}.
*
* The transaction is created with "normal" recommended fees. Before sending,
* you can inspect or change the fee:
*
* @example
* ```ts
* const amount = cg.networks.bitcoin.amount('0.001');
* const tx = await btc.transfer(amount, 'bc1q...');
*
* // Inspect recommended fees
* const fees = tx.recommendedFees();
* console.log(fees.normal.enoughFunds);
*
* // Override with a specific tier
* tx.setFee(fees.high);
*
* // Or set a custom fee rate
* tx.setFee({ feePerKbSat: 50_000n });
*
* // Sign and broadcast
* const broadcasted = await tx.signAndBroadcast();
* ```
*/
class UtxoTransaction extends BaseUtxoTransaction_1.BaseUtxoTransaction {
/** @internal — used by UtxoConnector.transfer to build the transaction. */
static async create(params) {
const { explorer, fromAddress, toAddress, valueSat, networkParams, getPrivateKey } = params;
// Fetch fee rates.
const feeRateResult = await explorer.getFeeRate();
// Gather UTXOs and compute fee estimates for each tier.
// Seed with locally cached unspent UTXOs (change outputs from previous broadcasts).
const cachedUnspent = explorer.global.utxoCache.getUnspent(fromAddress);
const state = { utxos: [...cachedUnspent], page: 0, crawled: false };
const feeRates = await (0, BaseUtxoTransaction_1.buildRecommendedFees)(feeRateResult, explorer, fromAddress, toAddress, valueSat, networkParams, state);
return new UtxoTransaction({
explorer,
fromAddress,
toAddress,
valueSat,
networkParams,
feeRates,
getPrivateKey,
state,
});
}
// ---------------------------------------------------------------------------
// Transaction signing via @scure/btc-signer
// ---------------------------------------------------------------------------
/** Signs the transaction and returns the serialized raw bytes. */
signTransaction(inputs, outputs, privateKey) {
const txVins = inputs.map((vin) => ({
txid: (0, utils_1.hexToBytes)(vin.txid),
index: vin.n,
witnessUtxo: {
script: vin.script,
amount: vin.amount.min(),
},
}));
const txVouts = outputs.map((vout) => ({
script: btc_signer_1.OutScript.encode(btc.Address(this.networkParams).decode(vout.address)),
amount: vout.amount,
}));
const transaction = new btc.Transaction({ allowLegacyWitnessUtxo: true });
for (const vin of txVins)
transaction.addInput(vin);
for (const vout of txVouts)
transaction.addOutput(vout);
for (let i = 0; i < transaction.inputsLength; i++) {
transaction.signIdx(privateKey, i);
}
transaction.finalize();
return (0, utils_1.hexToBytes)(transaction.hex);
}
}
exports.UtxoTransaction = UtxoTransaction;