com.jd.blockchain.ledger.PreparedTransaction Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ledger-model Show documentation

There is a newer version: 1.6.5.RELEASE

package com.jd.blockchain.ledger;

import java.io.Closeable;

import com.jd.blockchain.crypto.AsymmetricKeypair;
import com.jd.blockchain.crypto.HashDigest;

/**
 * 已就绪的交易；
 * 
 * @author huanghaiquan
 *
 */
public interface PreparedTransaction extends Closeable {

	/**
	 * 交易内容的 Hash；
	 * 
	 * @return
	 */
	HashDigest getTransactionHash();

	/**
	 * 交易数据内容； 

	 * 
	 * 

	 * 如果需要对交易进行外部签名，可以将此数据块发送到外部进行签名；
	 * 
	 * @return
	 */
	TransactionContent getTransactionContent();

	/**
	 * 对交易进行签名；
	 * 
	 * @param address 签名账户的地址；
	 * @param privKey 签名账户的私钥；
	 * @return
	 */
	DigitalSignature sign(AsymmetricKeypair keyPair);

	/**
	 * 加入签名；
	 * 
	 * @param address 签名账户的地址；
	 * @param digest  Base64格式的签名摘要；
	 * @return
	 */
	void addSignature(DigitalSignature signature);

	/**
	 * 提交交易请求到共识节点；

	 * 
	 * 这是同步方法，将阻塞当前线程，直到交易处理完成并返回结果之后，此方法才返回给调用者；
	 * 
	 */
	TransactionResponse commit();

}