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
TypeScript
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;
}