lemo-tx v1.1.14

LemoTx

A tool for creating, manipulating and signing LemoChain transactions.

中文版
English

Installing

Using Yarn

yarn add lemo-tx

As Browser module

• Include lemo-tx.min.js in your html file.
• Use the LemoTx object directly from global namespace

Example

const LemoTx = require('lemo-tx')
const tx = new LemoTx({
    chainID: 1, 
    from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D',
    to: 'Lemo83BYKZJ4RN4TKC9C78RFW7YHW6S87TPRSH34',
    amount: 100,
})

console.log(tx.toString())
// {"type":"0","version":"1","chainID":"1","from":"Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D","gasPrice":"3000000000","gasLimit":"2000000","amount":"100","expirationTime":"1566886054","to":"Lemo83BYKZJ4RN4TKC9C78RFW7YHW6S87TPRSH34","sigs":[],"gasPayerSigs":[]}

LemoTx API

Data structure

transaction

Signed transaction

{
  "type": "1",
  "chainID": "1",
  "version": "1",
  "from": "Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D",
  "to": "Lemo83JW7TBPA7P2P6AR9ZC2WCQJYRNHZ4NJD4CY",
  "gasPayer": "",
  "toName": "",
  "amount": "100",
  "data": "0x",
  "expirationTime": 1541566996,
  "gasLimit": 2000000,
  "gasPrice": "3000000000",
  "hash": "0x6d3062a9f5d4400b2002b436bc69485449891c83e23bf9e27229234da5b25dcf",
  "message": "",
  "sigs": ["0xd9a9f9f41ea020185a6480fe6938d776f0a675d89057c071fc890e09742a4dd96edb9d48c9978c2f12fbde0d0445f2ff5f08a448b91469511c663567d0b015f601"],
  "gasPayerSigs": ["0x800be6a0cf31ab9e86d547fb8cf964339276233a2b260ad8a4b4c93b39a48d6b1761e125f601bc6953e30eaad3e698c12add332a5740f1618915c12432dc610601"]
}

• type The type of transaction
• chainID The LemoChain id. 1 for main net and 100 for dev net
• version Current transaction version, Between 0 and 128
• from Sender address.
• to Recipient address
• gasPayer Account address of gas reimbursement agent
• toName (optional) Recipient name. It will be checked with to for safe. The max limit of length is 100.
• amount Amount in mo. It is a BigNumber object. 1LEMO=1000000000000000000mo=1e18mo
• data (optional) The extra data. It usually using for calling smart contract. It depends on type that how to using this field
• expirationTime The expiration time of transaction in seconds. If a transaction's expiration time is more than half hour from now, it may not be packaged in block. It depends on the transactions picking logic from miner
• gasLimit Max gas limit of transaction. The transaction will be fail if it cost more gas than gasLimit. And the gas will not be refunded
• gasPrice Price of every gas in mo. It is a BigNumber object. The more gas price the more priority
• hash Transaction hash
• message (optional) Extra text message from sender. The max limit of length is 1024.
• sigs Transaction signature array, each field length is 65 bytes
• gasPayerSigs An array of paid gas transaction signature data, each field length is 65 bytes

asset

Asset information

{
    "category": "1",
    "decimal": 18,
    "totalSupply": "15000000000000000000",
    "isReplenishable": true,
    "isDivisible": true,
    "issuer": "Lemo83GWNWJQ3DQFN6F24WFZF5TGQ39A696GJ7Z3",
    "profile": {
        "name": "Demo Asset",
        "symbol": "DT",
        "description": "this is a asset information",
        "suggestedGasLimit": "60000",
        "freeze": "false"
    }
}

• category Asset type
• decimal The decimal place of the issued asset, which indicates how many digits are reduced to the decimal point. The default is 18 digits. Decimal cannot be greater than 18
• totalSupply The total amount of assets issued, when the assets are issued and destroyed, the total amount of assets will change in real time, the total amount of assets issued is issuance*10^decimal
• isReplenishable Whether the asset can be replenish. It is not changeable after setup when creating the asset. The default is true
• isDivisible Whether the asset is divisible, set when the asset is created, the default is true
• issuer The publisher address. It is not settable
• profile Additional information about the asset
  • name The name of the asset
  • symbol Asset identification
  • description Basic information of assets
  • suggesteGasLimit Suggested gas limit. It is like the gasLimit field in transaction. The default is 60000
  • freeze Whether to freeze asset. The default is false. Set it to true will stop all actions about the asset except query operations

asset category

tx API

Constructor transaction

tx = new LemoTx({
    chainID: 1, 
    from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D',
    to: 'Lemo83BYKZJ4RN4TKC9C78RFW7YHW6S87TPRSH34',
    amount: 100,
})

• type - (number) (optional) Transaction type. Default value is 0
• chainID - (number) The LemoChain id. 1 for main net and 100 for dev net
• version - (number) (optional) Transaction encode version. Default value is 0
• to - (string) (optional) Recipient address. Empty to represents a contract creation transaction with contract code in data field
• toName - (string) (optional) Recipient name. It will be checked with to for safe
• amount - (number|string) (optional) Amount in mo. Default value is 0
• gasPrice - (number|string) (optional) Max gas limit of transaction. Default value is 3000000000
• gasLimit - (number|string) (optional) Price of every gas in mo. Default value is 2000000
• data - (Buffer|string) (optional) The extra data. It usually be using for calling smart contract
• expirationTime - (number|string) (optional) The expiration time of transaction in seconds. Default is half hour from now
• message - (string) (optional) Extra text message from sender

tx.signWith

tx.signWith(privateKey, txInfo)

Sign transaction and return the signed transaction string
The API is used for implement safety offline transaction: 1. Sign transaction on a offline device 2. Copy the output string ( untamable ) to a online device 3. Call the send method in lemo-client to send the transaction to LemoChain

Parameters

1. string - Account private key
2. object - Unsigned transaction like the same parameter in tx constructor

Returns

string - The string of signed transaction information

Example

const tx = new LemoTx({from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D', to: 'Lemo83BYKZJ4RN4TKC9C78RFW7YHW6S87TPRSH34', amount: 100})
const signedTxStr = tx.signWith('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52')
console.log(signedTxStr.toString())
// {"type":"0","version":"1","chainID":"1","gasPrice":"3000000000","gasLimit":"2000000","amount":"100","expirationTime":"1560244840","from":"Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D","to":"Lemo83BYKZJ4RN4TKC9C78RFW7YHW6S87TPRSH34","sigs":["0x55fe70309bb74aaad62a7fe4ab4085dd8c8bd450ce9eab8dd7906cc5453cbaab500f50e1d05ff746248bc806f4738be2fcaafc78a557edf1e34c976a21d6f0c200"],"gasPayerSigs":[]}

static API

LemoTx.sign

LemoTx.sign(privakey, txConfig)

Sign transaction and return the signed transaction string
The API is used for implement safety offline transaction: 1. Sign transaction on a offline device 2. Copy the output string ( untamable ) to a online device 3. Call the send method in lemo-client to send the transaction to LemoChain

Parameters

0. string - Account private key
1. object - Unsigned transaction

Returns

string - The string of signed transaction information

Example

const txInfo = {chainID: 1, from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D', to: 'Lemo83BYKZJ4RN4TKC9C78RFW7YHW6S87TPRSH34', amount: 100}
const code = '0x000000100000100'
const constructorArgs = '213313'
const unsignedTx = LemoTx.createContractCreation(txInfo, code, constructorArgs)
const signedTxStr = LemoTx.sign('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52', unsignedTx)
console.log(signedTxStr) // {"type":"1","version":"1","chainID":"1","from":"Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D","gasPrice":"3000000000","gasLimit":"2000000","amount":"100","expirationTime":"1567152222","to":"Lemo83BYKZJ4RN4TKC9C78RFW7YHW6S87TPRSH34","data":"0x0000001000001003313","sigs":["0xd897e25a640dda2d56ecb986c7b4c0dc835fd5131a434a5f5ca0ee1cd9caf8dc292dc4cefc9242c41a6e7976e000d66113232ff347e4db963dbaf70896fb27de00"],"gasPayerSigs":[]}
// Call the send method in lemo-client, lemo.send(signTx)

LemoTx.createVote

LemoTx.createVote(txInfo)

Create an unsigned LemoTx instance for vote. The API fills some special information in the data filed in LemoTx instance

Parameters

object - Unsigned transaction like the same parameter in tx constructor. For this API, to means vote target. And amount, data fields will be ignored.

Returns

LemoTx - Unsigned LemoTx instance

Example

const txInfo = {from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D', to: 'Lemo83BYKZJ4RN4TKC9C78RFW7YHW6S87TPRSH34'}
const tx = LemoTx.crateVote(txInfo)
const signedTxStr = LemoTx.sign('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52', tx)
// Call the send method in lemo-client, lemo.send(signTx)

LemoTx.createCandidate

LemoTx.createCandidate(txInfo, candidateInfo)

Create an unsigned LemoTx instance for candidate. The API fills some special information in the data filed in LemoTx instance

Parameters

0. object - Unsigned transaction like the same parameter in tx constructor. For this API, to, toName, amount, data fields will be ignored.
1. object - Candidate information. It is same with candidate.profile in account

Returns

LemoTx - Unsigned LemoTx instance

Example

const txInfo = {chainID: 1, from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D'}
const candidateInfo = {
    isCandidate: true,
    name: 'cross-chain-node',
    teamName: 'lemo-tac-team',
    minerAddress: 'Lemo83GN72GYH2NZ8BA729Z9TCT7KQ5FC3CR6DJG',
    nodeID: '0x5e3600755f9b512a65603b38e30885c98cbac70259c3235c9b3f42ee563b480edea351ba0ff5748a638fe0aeff5d845bf37a3b437831871b48fd32f33cd9a3c0',
    host: '127.0.0.1',
    port: '7001',
    introduction: 'this is a demo',
    email: 'abc@gmail.com',
}
const tx = LemoTx.createCandidate(txInfo, candidateInfo)
const signedTxStr = LemoTx.sign('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52', tx)
// Call the send method in lemo-client, lemo.send(signTx)

LemoTx.createAsset

LemoTx.createAsset(txConfig, createAssetInfo)

Create an unsigned LemoTx instance for create assets. The API fills some special information in the data filed in LemoTx instance

Parameters

0. object - Unsigned transaction like the same parameter in tx constructor. For this API, to, amount, toNamefields will be ignored.
1. object - Create of assets information.

Returns

LemoTx - Unsigned LemoTx instance, data contains the information for create the asset

Example

const txInfo = {chainID: 1, from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D'}
const createAssetInfo = {
    category: 1,
    decimal: 18,
    isReplenishable: true,
    isDivisible: true,
    profile: {
        name: 'Demo Asset',
        symbol: 'DT',
        description: 'demo asset',
        suggestedGasLimit: '60000',
    },
}
const tx = LemoTx.createAsset(txInfo, createAssetInfo)
const signedTxStr = LemoTx.sign('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52', tx)
// Call the send method in lemo-client, lemo.send(signTx)  

LemoTx.createIssueAsset

LemoTx.createIssueAsset(txConfig, issueAssetInfo)

Create an unsigned LemoTx instance for the issuance of assets. The API fills some special information in the data filed in LemoTx instance

Parameters

0. object - Unsigned transaction like the same parameter in tx constructor. For this API, to, toName, amount, data fields will be ignored.
1. object - Transfer of assets information. includes assetCode, metaData, supplyAmount field

Returns

LemoTx - Unsigned LemoTx instance, data contains the information for issue the asset

Example

const txInfo = {chainID: 1,to: 'Lemo83BYKZJ4RN4TKC9C78RFW7YHW6S87TPRSH34', from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D'}
const issueAssetInfo = {
    assetCode: '0xd0befd3850c574b7f6ad6f7943fe19b212affb90162978adc2193a035ced8884',
    metaData: 'issue asset metaData',
    supplyAmount: '100000',
}
const tx = LemoTx.createIssueAsset(txInfo, issueAssetInfo)
const signedTxStr = LemoTx.sign('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52', tx)
// Call the send method in lemo-client, lemo.send(signTx)

LemoTx.createReplenishAsset

LemoTx.createReplenishAsset(txConfig, replenishInfo)

Create an unsigned LemoTx instance for replenish assets. The API fills some special information in the data filed in LemoTx instance

Parameters

0. object - Unsigned transaction like the same parameter in tx constructor. For this API, amount field will be ignored.
1. object - Replenish assets information. includes assetID, replenishAmount fields

Returns

LemoTx - Unsigned LemoTx instance, data contains the information for replenish the asset

Example

const txInfo = {chainID: 1, to: 'Lemo83JW7TBPA7P2P6AR9ZC2WCQJYRNHZ4NJD4CY', from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D'}
const replenishAssetInfo = {
    assetCode: '0xd0befd3850c574b7f6ad6f7943fe19b212affb90162978adc2193a035ced8884',
    assetId: '0xd0befd3850c574b7f6ad6f7943fe19b212affb90162978adc2193a035ced8884',
    replenishAmount: '100000',
}
const tx = LemoTx.createReplenishAsset(txInfo, replenishAssetInfo)
const signedTxStr = LemoTx.sign('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52', tx)
// Call the send method in lemo-client, lemo.send(signTx)

LemoTx.createModifyAsset

LemoTx.createModifyAsset(txConfig, modifyInfo)

Create an unsigned LemoTx instance for modify assets. The API fills some special information in the data filed in LemoTx instance

Parameters

0. object - Unsigned transaction like the same parameter in tx constructor. For this API, amount, to, toName fields will be ignored.
1. object - Assets modification information. It contains assetCode and info fields. The info contains the fields you want to modify, such as name, symbol, description, freeze, suggestedGasLimit.

Returns

LemoTx - Unsigned LemoTx instance, data contains the information for modify the asset

Example

const txInfo = {chainID: 1, from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D'}
const ModifyAssetInfo = {
    assetCode: '0xd0befd3850c574b7f6ad6f7943fe19b212affb90162978adc2193a035ced8884',
    updateProfile: {
        name: 'Demo Asset',
        symbol: 'DT',
        description: 'demo asset',
    },
}
const tx = LemoTx.createModifyAsset(txInfo, ModifyAssetInfo)
const signedTxStr = LemoTx.sign('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52', tx)
// Call the send method in lemo-client, lemo.send(signTx)

LemoTx.createTransferAsset

LemoTx.createTransferAsset(txConfig, transferAssetInfo)

Create an unsigned LemoTx instance for transaction assets. The API fills some special information in the data filed in LemoTx instance

Parameters

0. object - Unsigned transaction like the same parameter in tx constructor.
1. object - Transaction assets information. includes assetID field

Returns

LemoTx - Unsigned LemoTx instance, data contains the information for transfer the asset

Example

const txInfo = {chainID: 1, to: 'Lemo83BYKZJ4RN4TKC9C78RFW7YHW6S87TPRSH34', from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D'}
const transferAsset = {
    assetId: '0xd0befd3850c574b7f6ad6f7943fe19b212affb90162978adc2193a035ced8884',
    transferAmount: '110000',
}
const tx = LemoTx.createTransferAsset(txInfo, transferAsset)
const signedTxStr = LemoTx.sign('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52', tx)
// Call the send method in lemo-client, lemo.send(signTx)

LemoTx.createNoGas

LemoTx.createNoGas(txConfig, gasPayer)

Create an unsigned LemoTx instance for gas free transaction. The API fills some special information in the data filed in LemoTx instance
1. Create a gas free transaction with transaction information and gasPayer account address. The transaction information is exclude gasLimit and gasPrice field 2. Send the output string to gas gasPayer 3. The gasPayer sign the string with his private key, fill gasLimit and gasPrice field. Then return a final transaction string 4. Call the send method in lemo-client to send the transaction to LemoChain

Parameters

0. object - Unsigned transaction like the same parameter in tx constructor. For this API, gasLimit, gasPrice fields will be ignored.
1. string - The address of gas gasPayer account.

Returns

LemoTx - Unsigned LemoTx instance

Example

const txInfo = {chainID: 1, to: 'Lemo83JW7TBPA7P2P6AR9ZC2WCQJYRNHZ4NJD4CY', from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D'}
const gasPayer = 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D'
const tx = LemoTx.createNoGas(txInfo, gasPayer)
const signedTxStr = LemoTx.sign('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52', tx)

LemoTx.createReimbursement

LemoTx.createReimbursement(noGasTxStr, gasPrice, gasLimit)

Create an unsigned LemoTx instance for paying gas to a free gas transaction. The API fills some special information in the data filed in LemoTx instance

Parameters

0. string - The string returned by the tx.signNoGas method, See tx.signNoGas
1. string - Price of every gas in mo.
2. string - Max gas limit of transaction.

Returns

LemoTx - Unsigned LemoTx instance

Example

const txInfo = {chainID: 1, to: 'Lemo83JW7TBPA7P2P6AR9ZC2WCQJYRNHZ4NJD4CY', from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D'}
const gasPayer = 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D'
const noGasInfo = LemoTx.createNoGas(txInfo, gasPayer)
const tx = LemoTx.createReimbursement(noGasInfo, 2, 100)
const signedTxStr = LemoTx.sign('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52', tx)
// Call the send method in lemo-client, lemo.send(signTx)

LemoTx.createCreateTempAddress

LemoTx.createCreateTempAddress(txConfig, userId)

Create an unsigned LemoTx instance for create temp account transaction. The API fills some special information in the data filed in LemoTx instance
1. Temp account has no private key and only can be signed by accounts in its signers 2. Temp account must be configured with Signers before using it 3. If the temp account already exists, the creation will be fail

Parameters

0. object - Unsigned transaction like the same parameter in tx constructor.
1. string - customized user id, which's length should be 10 bytes in hexadecimal at most

Returns

LemoTx - Unsigned LemoTx instance

Example

const userId = '0123456789'
const txInfo = {chainID: 1, from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D', to: 'Lemo83JW7TBPA7P2P6AR9ZC2WCQJYRNHZ4NJD4CY'}
const tx = LemoTx.createTempAddress(txInfo, userId)
const signedTxStr = LemoTx.sign('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52', tx)
// Call the send method in lemo-client, lemo.send(signTx)

LemoTx.createModifySigners

LemoTx.createModifySigners(txConfig, signers)

Create the transaction of the signers in the multi-signer account, the API fills some special information in the data filed in LemoTx instance

Parameters

0. object - Unsigned transaction like the same parameter in tx constructor.
1. array - Modified multiple signers list containing the fields address and weight

Returns

LemoTx - Unsigned LemoTx instance

Example

const signers = [{
            address: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D',
            weight: 50,
        }, {
            address: 'Lemo83GN72GYH2NZ8BA729Z9TCT7KQ5FC3CR6DJG',
            weight: 50,
        }]
const txInfo = {chianID: 1, from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D'}
const tx = LemoTx.createModifySigners(txInfo, signers)
const signedTxStr = LemoTx.sign('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52', tx)
// Call the send method in lemo-client, lemo.send(signTx)

LemoTx.createBoxTx

LemoTx.createBoxTx(txConfig, subTxList) 

Create an unsigned LemoTx instance for box transactions,
The API fills some special information in the data filed in LemoTx instance
1. Box transaction can store multiple signed transaction informations including special transactions, but cannot store box transactions 2. The timestamp of the box transaction is equal to the minimum timestamp of the child transaction in the box 3. The neutron in the box transactions will succeed or fail at the same time, if one of the sub-transaction does not succeed then all the transactions in the box trade will fail
4. The sub-transaction of the box transaction must be signed transaction

Parameters

0. object - Unsigned transaction like the same parameter in tx constructor. For this API, to fields will be ignored.
1. array - Signed transaction list. The item should by signed transaction string or object

Returns

LemoTx - Unsigned LemoTx instance

Example

const createTempAddressInfo = {from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D', to: 'Lemo83JW7TBPA7P2P6AR9ZC2WCQJYRNHZ4NJD4CY'}
const createTempAddress = LemoTx.createTempAddress(createTempAddressInfo, '0123456789')
const signTempAddress = LemoTx.sign(testPrivate, createTempAddress)

const transferAssetInfo = {to: 'Lemo83BYKZJ4RN4TKC9C78RFW7YHW6S87TPRSH34', from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D'}
const transferAsset = {
    assetId: '0xd0befd3850c574b7f6ad6f7943fe19b212affb90162978adc2193a035ced8884',
    transferAmount: '110000',
}
const createTransferAsset = LemoTx.createTransferAsset(transferAssetInfo, transferAsset)
const signTransferAsset = LemoTx.sign(testPrivate, createTransferAsset)

const subTxList = [signTempAddress, signTransferAsset]
const tx = LemoTx.createBoxTx({chainID: '1', from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D'}, subTxList)
const signedTxStr = LemoTx.sign('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52', tx)
// Call the send method in lemo-client, lemo.send(signTx)

LemoTx.createContractCreation

LemoTx.createContractCreation(txConfig, code, constructorArgs)

Create an unsigned LemoTx instance for contract creation
The API fills some special information in the data filed in LemoTx instance

Parameters

0. object - Unsigned transaction like the same parameter in tx constructor.
1. string - The hexadecimal string of the contract code
2. string - The hexadecimal string of a parameter constructed in the contract

Returns

LemoTx - Unsigned LemoTx instance

Example

const txInfo = {chainID: 1, from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D', to: 'Lemo83BYKZJ4RN4TKC9C78RFW7YHW6S87TPRSH34', amount: 100}
const code = '0x000000100000100'
const constructorArgs = '213313'
const tx = LemoTx.createContractCreation(txInfo, code, constructorArgs)
const signedTxStr = LemoTx.sign('0xfdbd9978910ce9e1ed276a75132aacb0a12e6c517d9bd0311a736c57a228ee52', tx)
// Call the send method in lemo-client, lemo.send(signTx)

LemoTx.createPayDeepLink

LemoTx.createPayDeepLink(txConfig)

Create a deep link for payment and convert the constructed transaction into a link address

Parameters

0. object - Unsigned transaction like the same parameter in tx constructor.

Returns

string - The address of lemo://pay? link

Example

const txInfo = {chainID: 1, from: 'Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D', to: 'Lemo83BYKZJ4RN4TKC9C78RFW7YHW6S87TPRSH34', amount: 100}
const result = LemoTx.createPayDeepLink(txInfo)
console.log(result)
// lemo://pay?c=1&f=Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D&t=Lemo83BYKZJ4RN4TKC9C78RFW7YHW6S87TPRSH34&a=0.0000000000000001

LemoTx.createSignDeepLink

LemoTx.createSignDeepLink(config)

Create deep links for signatures

Parameters

0. object - transaction information before signature, includes： message - (string)(optional)Text to be signed data - (string)(optional)The hexadecimal data string to be signed. It must begin with 0x. If message is set, then data will be ignore signer - (string)(optional)The account address who has the right to sign receiver - (string)(optional)Send a POST request with a signature over HTTP to that address

Returns

string - The address of lemo://sign? link

Example

const config = {message: 'sign this message', signer: 'Lemo846Q4NQCKJ2YWY6GHTSQHC7K24JDC7CPCWYH', receiver: 'http://lemochain.com/a?b=c',}
const result = createSignDeepLink(config)
console.log(result)
// lemo://sign?m=c2lnbiB0aGlzIG1lc3NhZ2U&s=Lemo846Q4NQCKJ2YWY6GHTSQHC7K24JDC7CPCWYH&r=http%3A%2F%2Flemochain.com%2Fa%3Fb%3Dc

LemoTx.parseDeepLink

LemoTx.parseDeepLink(uri)

Parse deep link

Parameters

0. string - Deep links that need to be resolved.

Returns

object - The result after parsing, It has two filed: data - (object)Parsed object information deepLinkType - (number)Type of deeplink，like the same parameter in deeplinkType

Example

// The result is transaction information
const deepLinkTx = 'lemo://pay?ty=0&c=200&v=1&f=Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D&t=Lemo846Q4NQCKJ2YWY6GHTSQHC7K24JDC7CPCWYH&tn=aa&gp=0.000000002&gl=100&a=0.000000000000000001&d=0x0c&e=1544584596&m=YWFh'
const resultTx = LemoTx.parseDeepLink(deepLinkTx)
console.log(resultTx)
// {"data":{"type":0,"version":1,"chainID":200,"from":"Lemo836BQKCBZ8Z7B7N4G4N4SNGBT24ZZSJQD24D","to":"Lemo846Q4NQCKJ2YWY6GHTSQHC7K24JDC7CPCWYH","toName":"aa","gasPrice":"2","gasLimit":100,"amount":"1","data":"0x0c","expirationTime":1544584596,"message":"aaa"},"deepLinkType":0}
// The parsing result is the signature information
const deepLinkSign = 'lemo://sign?m=c2lnbiB0aGlzIG1lc3NhZ2U&s=Lemo846Q4NQCKJ2YWY6GHTSQHC7K24JDC7CPCWYH&r=http%3A%2F%2Flemochain.com%2Fa%3Fb%3Dc'
const resultSign = LemoTx.parseDeepLink(deepLinkSign)
console.log(resultSign)
// {"data":{"message":"sign this message","signer":"Lemo846Q4NQCKJ2YWY6GHTSQHC7K24JDC7CPCWYH","receiver":"http://lemochain.com/a?b=c"},"deepLinkType":1}

other API

LemoTx.TxType

LemoTx.TxType

Enum of transaction type, the value is number type

Example

console.log(LemoTx.TxType.VOTE) // 1

LemoTx.DeepLinkType

LemoTx.DeepLinkType

Enum of deeplink type, the value is number type

Example

console.log(LemoTx.DeepLinkType.PAY) // 0

Developing

Requirements

• Node.js
• yarn

sudo apt-get update
sudo apt-get install nodejs
sudo apt-get install yarn

Building

yarn build

Testing

yarn test

Licensing

LGPL-3.0