193 lines
8.1 KiB
JavaScript
193 lines
8.1 KiB
JavaScript
const Ling = require('so.ling')
|
||
const ticCrypto = require('tic.crypto')
|
||
|
||
/** ****************** Public of instance ********************/
|
||
|
||
const DAD = module.exports = function Action (prop) {
|
||
this._class = this.constructor.name
|
||
this.setProp(prop)
|
||
this.type = this.constructor.name
|
||
}
|
||
DAD.__proto__ = Ling
|
||
|
||
const MOM = DAD.prototype
|
||
MOM.__proto__ = Ling.prototype
|
||
|
||
/** ****************** Shared by instances ********************/
|
||
MOM._table = DAD.name
|
||
MOM._tablekey = 'hash'
|
||
MOM._model = {
|
||
hash: { default: undefined, sqlite: 'TEXT UNIQUE', mysql: 'VARCHAR(64) PRIMARY KEY' }, // 不纳入签名和哈希
|
||
version: { default: 0, sqlite: 'INTEGER' },
|
||
type: { default: 'Action', sqlite: 'TEXT', mysql: 'VARCHAR(100)' }, // 是否放在 assets里更好？这里该放action自己的version
|
||
blockHash: { default: undefined, sqlite: 'TEXT', mysql: 'VARCHAR(64)' }, // 不纳入签名和哈希。只为了方便查找
|
||
timestamp: { default: undefined, sqlite: 'TEXT', mysql: 'CHAR(24)' },
|
||
actorPubkey: { default: undefined, sqlite: 'TEXT', mysql: 'BINARY(32)' },
|
||
actorAddress: { default: undefined, sqlite: 'TEXT', mysql: 'VARCHAR(50)' },
|
||
actorSignature: { default: undefined, sqlite: 'TEXT', mysql: 'BINARY(64)' }, // 不纳入签名，纳入哈希
|
||
toAddress: { default: undefined, sqlite: 'TEXT', mysql: 'VARCHAR(50)' },
|
||
amount: { default: 0, sqlite: 'NUMERIC', mysql: 'BIGINT' },
|
||
fee: { default: 0, sqlite: 'NUMERIC', mysql: 'BIGINT' },
|
||
message: { default: undefined, sqlite: 'TEXT', mysql: 'VARCHAR(256)' },
|
||
dataIndex: { default: undefined, sqlite: 'TEXT', mysql: 'VARCHAR(50)' }, // 用于索引json中存储数据，
|
||
method: { default: undefined, sqlite: 'TEXT' },
|
||
json: { default: undefined, sqlite: 'TEXT' } // 给不同类型的 ActionXxx 子类来自定义其所需的数据结构
|
||
}
|
||
|
||
MOM.packMe = async function (keypair) { // 由前端调用，后台不创建
|
||
this.actorPubkey = keypair.pubkey
|
||
this.actorAddress = ticCrypto.pubkey2address(keypair.pubkey)
|
||
this.timestamp = new Date()
|
||
|
||
await this.signMe(keypair.seckey)
|
||
this.hashMe()
|
||
return this
|
||
}
|
||
|
||
MOM.signMe = async function (seckey) { // 由前端调用，后台不该进行签名
|
||
let json = this.getJson({ exclude: ['hash', 'blockHash', 'actorSignature'] }) // 是前端用户发起事务时签字，这时候还不知道进入哪个区块，所以不能计入blockHash
|
||
this.actorSignature = await ticCrypto.sign(json, seckey)
|
||
return this
|
||
}
|
||
|
||
MOM.hashMe = function () {
|
||
this.hash = ticCrypto.hash(this.getJson({ exclude: ['hash', 'blockHash'] })) // block.hash 受到所包含的actionList影响，所以action不能受blockHash影响，否则循环了
|
||
return this
|
||
}
|
||
|
||
MOM.verifySig = async function() {
|
||
let json = this.getJson({ exclude: ['hash', 'blockHash', 'actorSignature'] })
|
||
let result = await ticCrypto.verify(json, this.actorSignature, this.actorPubkey)
|
||
return result
|
||
}
|
||
DAD.verifySig = async function (actionData) {
|
||
let typedAction = new wo[actionData.type](actionData)
|
||
return await typedAction.verifySig()
|
||
}
|
||
|
||
MOM.verifyAddress = function () {
|
||
return this.actorAddress === ticCrypto.pubkey2address(this.actorPubkey)
|
||
}
|
||
DAD.verifyAddress = function (actionData) {
|
||
let typedAction = new wo[actionData.type](actionData)
|
||
return typedAction.verifyAddress()
|
||
}
|
||
|
||
MOM.verifyHash = function () {
|
||
return this.hash === ticCrypto.hash(this.getJson({ exclude: ['hash', 'blockHash'] }))
|
||
}
|
||
DAD.verifyHash = function (actionData) {
|
||
let typedAction = new wo[actionData.type](actionData)
|
||
return typedAction.verifyHash()
|
||
}
|
||
|
||
DAD.build = async function (action, keypair) { // Applicable on client. 客户端调用 Action.build，即可新建、并打包成一个完整的子事务，不需要亲自调用 constructor, packMe 等方法。
|
||
if (action && action.type && keypair && keypair.seckey && keypair.pubkey) {
|
||
let typedAction = new require(`./${action.type}`)(action)
|
||
if (typedAction.validateMe()) {
|
||
await typedAction.packMe(keypair)
|
||
return typedAction
|
||
}
|
||
}
|
||
return null
|
||
}
|
||
|
||
MOM.validateMe = function() { // Applicable on chain server. 子类应当覆盖本方法，静态的检查事务内容的格式和语义，是否符合该子类事务的特性要求。To validate an action's content format.
|
||
// to implement in subclasses: 检查子类事务内容的格式
|
||
let typedAction = new wo[this.type](this)
|
||
return typedAction.validateMe()
|
||
}
|
||
DAD.validate = function (action) { // Allicable on both client and chain server.
|
||
mylog.info(`Validating action type=${action.type} of hash=${action.hash}`)
|
||
let typedAction = new wo[action.type](action)
|
||
return typedAction.validateMe()
|
||
}
|
||
|
||
MOM.executableMe = async function() { // Applicable on chain server. 子类应当覆盖本方法，动态的检查事务内容，在当前链状态下，是否能执行。To check if an action is executableMe given the current chain status.
|
||
let typedAction = new wo[this.type](this)
|
||
return await typedAction.executableMe()
|
||
}
|
||
DAD.executable = async function(action) { // For chain server.
|
||
let typedAction = new wo[action.type](action)
|
||
if (typedAction.hasOwnProperty('executableMe')) { // 防止子类忘了定义自己的 executableMe
|
||
return await typedAction.executableMe()
|
||
}else {
|
||
return true
|
||
}
|
||
}
|
||
MOM.executeMe = async function() { // For chain server. 子类应当覆盖本方法，执行事务，记录其（除了存入 Action 数据表之外的）副作用到内存数据库或其他地方。
|
||
// to implement in subclasses: 把action的影响，汇总登记到其他表格（用于辅助的、索引的表格），方便快速索引、处理。每种事务类型都要重定义这个方法。
|
||
let typedAction = new wo[this.type](this)
|
||
return await typedAction.executeMe()
|
||
}
|
||
DAD.execute = async function (action) { // For chain server.
|
||
mylog.info(`Excecuting action type=${action.type} of hash=${action.hash}`)
|
||
let typedAction = new wo[action.type](action)
|
||
return await typedAction.executeMe()
|
||
}
|
||
// [todo 20190411] 执行事务池中的所有事务
|
||
// DAD.executePool = async function() {
|
||
// }
|
||
|
||
/**
|
||
* 获取一批交易，在出块时调用。调用actionPool的内容被深拷贝到currentActionPool后自动清空。
|
||
* 所以在一次出块期间只能调用一次
|
||
*/
|
||
DAD.getActionBatch = function () {
|
||
let actionBatch = {
|
||
actionPool: JSON.parse(JSON.stringify(DAD.actionPool)), // deep copy
|
||
totalAmount: DAD.actionPoolInfo.totalAmount,
|
||
totalFee: DAD.actionPoolInfo.totalFee
|
||
}
|
||
DAD.actionPool = {}
|
||
DAD.actionPoolInfo = {
|
||
totalAmount: 0,
|
||
totalFee: 0
|
||
}
|
||
return actionBatch
|
||
}
|
||
|
||
/** ********************* Public of class *******************/
|
||
DAD.api = {}
|
||
|
||
DAD.api.getAction = async function (option) {
|
||
return await DAD.getOne(option)
|
||
}
|
||
|
||
DAD.api.getActionList = async function (option) {
|
||
return await DAD.getAll(option)
|
||
}
|
||
|
||
DAD.api.prepare = async function (option) {
|
||
if (typeof option === 'string') {
|
||
try {
|
||
option = JSON.parse(option)
|
||
} catch (error) {}
|
||
}
|
||
// 前端发来action数据，进行格式检查（不检查是否可执行--这和事务类型、执行顺序有关）后放入缓冲池。
|
||
if (option && option.Action && option.Action.type && wo[option.Action.type] && option.Action.hash && !DAD.actionPool[option.Action.hash]) {
|
||
let typedAction = new wo[option.Action.type](option.Action)
|
||
if (typedAction.verifyAddress() && // 只检查所有事务通用的格式
|
||
await typedAction.verifySig() &&
|
||
typedAction.verifyHash() &&
|
||
typedAction.validateMe() && // 检查事务的内容是否符合该子类事务的格式
|
||
(await typedAction.executableMe()) // 检查事务是否可执行，在当前链的状态下。
|
||
) {
|
||
DAD.actionPool[option.Action.hash] = typedAction
|
||
DAD.actionPoolInfo.totalAmount += option.Action.amount || 0
|
||
DAD.actionPoolInfo.totalFee += option.Action.fee || 0
|
||
wo.Netnode.broadcast({ Action: option.Action })
|
||
return option.Action
|
||
}
|
||
}
|
||
return null // 非法的交易数据
|
||
}
|
||
/** ******************** Private in class *******************/
|
||
|
||
DAD.actionPool = {} // 交易池，在执行getActionBatch时被清空
|
||
// DAD.currentActionPool = {} // 仅包含0~40秒的交易,40~59秒的交易将被堆积到actionPool。
|
||
DAD.actionPoolInfo = {
|
||
totalAmount: 0,
|
||
totalFee: 0
|
||
}
|