UNPKG

navio-blsct

Version:

TypeScript bindings for the `libblsct` library used by the [Navio](https://nav.io/) blockchain to construct confidential transactions based on the BLS12-381 curve.

90 lines (89 loc) 4.22 kB
import { CTxId } from './ctxId'; import { CTxIns } from './ctxIns'; import { CTxOuts } from './ctxOuts'; import { ManagedObj } from './managedObj'; import { TxIn } from './txIn'; import { TxOut } from './txOut'; /** Represents a confidential transaction. Also known as `CMutableTransaction` on the C++ side. * Examples: * ```ts * const { CTx, CTxId, TxIn, TxOut, ChildKey, Scalar, SubAddr, SubAddrId, DoublePublicKey, OutPoint, PublicKey, TokenId, CTX_ID_SIZE } = require('navio-blsct') * const { randomBytes } = require('crypto') * const cTxIdHex = randomBytes(CTX_ID_SIZE).toString('hex') * const cTxId = CTxId.deserialize(cTxIdHex) * const numTxIn = 1 * const numTxOut = 1 * const defaultFee = 200000 * const fee = (numTxIn + numTxOut) * defaultFee * const outAmount = 10000 * const inAmount = fee + outAmount * const outIndex = 0 * const outPoint = OutPoint.generate(cTxId, outIndex) * const gamma = 100 * const spendingKey = Scalar.random() * const tokenId = TokenId.default() * const txIn = TxIn.generate(inAmount, gamma, spendingKey, tokenId, outPoint) * const viewKey = new ChildKey().toTxKey().toViewKey() * const spendingPubKey = new PublicKey() * const subAddrId = SubAddrId.generate(123, 456) * const subAddr = SubAddr.generate(viewKey, spendingPubKey, subAddrId) * const txOut = TxOut.generate(subAddr, outAmount, 'navio') * const cTx = CTx.generate([txIn], [txOut]) * for (const cTxIn of cTx.getCTxIns()) { * console.log(`prevOutHash: ${cTxIn.getPrevOutHash()}`) * console.log(`prevOutN: ${cTxIn.getPrevOutN()}`) * console.log(`scriptSig: ${cTxIn.getScriptSig()}`) * console.log(`sequence: ${cTxIn.getSequence()}`) * console.log(`scriptWitness: ${cTxIn.getScriptWitness()}`) * } * for (const cTxOut of cTx.getCTxOuts()) { * console.log(`value: ${cTxOut.getValue()}`) * console.log(`script_pub_key: ${cTxOut.getScriptPubKey()}`) * console.log(`blsctData.spendingKey: ${cTxOut.blsctData().getSpendingKey()}`) * console.log(`blsctData.ephemeralKey: ${cTxOut.blsctData().getEphemeralKey()}`) * console.log(`blsctData.blindingKey: ${cTxOut.blsctData().getBlindingKey()}`) * console.log(`blsctData.viewTag: ${cTxOut.blsctData().getViewTag()}`) * const rp = cTxOut.blsctData().getRangeProof() * console.log(`blsctData.rangeProof.A: ${rp.get_A()}`) * console.log(`blsctData.rangeProof.A_wip: ${rp.get_A_wip()}`) * console.log(`blsctData.rangeProof.B: ${rp.get_B()}`) * console.log(`blsctData.rangeProof.r_prime: ${rp.get_r_prime()}`) * console.log(`blsctData.rangeProof.s_prime: ${rp.get_s_prime()}`) * console.log(`blsctData.rangeProof.delta_prime: ${rp.get_delta_prime()}`) * console.log(`blsctData.rangeProof.alpha_hat: ${rp.get_alpha_hat()}`) * console.log(`blsctData.rangeProof.tau_x: ${rp.get_tau_x()}`) * console.log(`tokenId: token=${cTxOut.getTokenId().getToken()}, subid=${cTxOut.getTokenId().getSubid()}`) * console.log(`vector_predicate: ${cTxOut.getVectorPredicate()}`) * } * const ser = cTx.serialize() * const deser = CTx.deserialize(ser) * ser === deser.serialize() // true */ export declare class CTx extends ManagedObj { constructor(obj: any); /** Constructs a new `CTx` instance. * @param srcTxIns - An array of `TxIn` objects representing the transaction inputs. * @param srcTxOuts - An array of `TxOut` objects representing the transaction outputs. * @returns A new `CTx` instance. */ static generate(txIns: TxIn[], txOuts: TxOut[]): CTx; value(): any; /** Returns the transaction ID of this confidential transaction. * @returns The transaction ID. */ getCTxId(): CTxId; /** Returns the number of transaction inputs in this confidential transaction. * @returns The number of transaction inputs. */ getCTxIns(): CTxIns; /** Returns the number of transaction outputs in this confidential transaction. * @returns The number of transaction outputs. */ getCTxOuts(): CTxOuts; serialize(): string; /** Deserializes a hexadecimal string into a `CTx` instance. * @param hex - The hexadecimal string to deserialize. * @returns A new `CTx` instance. */ static deserialize(hex: string): CTx; }