Release notes

v2.4.0

• Support conflux-rust v2.4.0 new RPC methods(https://github.com/Conflux-Chain/conflux-rust/blob/master/changelogs/JSONRPC.md#v240) cfx_feeHistory, cfx_maxPriorityFeePerGas etc.

• Support Conflux 2930 and 1559 type transactions, will auto detect the transaction type and use the right method to sign the transaction. Default is 1559 type.

  • The transaction now has a new field type which can be 0, 1 or 2, 0 is legacy type, 1 is 2930 type 2 is 1559 type.

  • The 2930 type transaction will have a new field accessList which is an array of address and storageKeys pairs.

  • The 1559 type transaction will have a new field maxPriorityFeePerGas and maxFeePerGas.

• Both cfx_call, and cfx_estimateGasAndCollateral have also been updated to support 1559 type transactions.

• Transaction's receipt have three new fields type, burntGasFee, effectiveGasPrice

• Block have a new field baseFeePerGas

Conflux class constructor parameters do not support defaultGasRatio, defaultStorageRatio anymore, because the estimation of gas and storage collateral is very accurate now.

v2.3.0

• Add three debug RPC method in cfx namespace debug_getTransactionsByBlock, debug_getEpochReceiptProofByTransaction, debug_getTransactionsByEpoch

• Add filter related RPC method in cfx namespace cfx_newFilter, cfx_newBlockFilter, cfx_newPendingTransactionFilter, cfx_getFilterChanges, cfx_getFilterLogs, cfx_uninstallFilter

• Add pos_getAccountByPowAddress, pos_getConsensusBlocks, pos_getEpochState, pos_getLedgerInfoByEpoch, pos_getLedgerInfoByBlockNumber, pos_getLedgerInfoByEpochAndRound, pos_getLedgerInfosByEpoch in pos namespace

• Add trace method trace_epoch in trace namespace

• Support new scheme for epoch parameter like EIP-1898, check details here, supported methods are: cfx_getBalance, cfx_getCode, cfx_call, cfx_getNextNonce, cfx_getStorageAt

v2.1.11

• Add cfx_getCollateralInfo RPC method which was import from conflux-rust v2.3.0

• SponsorInfo add two more fields availableStoragePoint and usedStoragePoint

v2.1.7

• Optimize the gas and storageCollateral logic of transaction population.

v2.1.5

• Add support the new InternalContract ParamsControl

• Remove cfx_getLogs filter's field offset and limit

• Add support for new RPC cfx_getParamsFromVote

• Update typescript datatype definitions

v2.1.0

• Add more jsdoc comment to generate ts d.ts files

• Move cfx related formatters (block, transaction, receipt, log and etc) to independent file ./src/rpc/types/formmatter.js.

v2.0.7

• Fix logFilter formater bug

v2.0.6

• Fix contract method batch call bug

v2.0.3

• Change trace epochNumber, transactionPosition from BigInt to Int

• Add field totalEspaceTokens in getSupplyInfo's response

v2.0.0

• Add support for PoS RPC methods

• Split RPC methods to it's own namespace, currently include: cfx, pos, trace, txpool

• Add support for batch RPC

• Browser export class name change from Conflux to TreeGraph

• Add method getNextUsableNonce to conflux.advanced, which will first try to use txpool_nextNonce to get a usable nonce, if failed it will fall back to cfx_getNextNonce

• Add three internal contracts CrossSpaceCall, ConfluxContext, PoSRegister

• Add one method cfxMappedEVMSpaceAddress to address utility.

trace updates

• Add a new boolean field valid to indicate whether this trace has change state

• The internal_transfer_action type trace has added four new field fromPocket, toPocket, fromSpace, toSpace

• The call and create type trace has added one new field space

For detail explanation of the trace updates check this doc.

Check v2.0 changes for change details

Provider API

• Add provider.request to make provider compliant with EIP-1193

• Add a new provider WechatProvider which can be used in Wechat environment

Here is the complete Conflux-rust v2.0 RPC change overview

v1.7.2

• Add balance key in the result of estimateGasAndCollateralAdvance as the balance of options.from.

v1.7.1

• Add method checkBalanceAgainstTransaction, and estimateGasAndCollateralAdvance to better estimate gas and check balance.

v1.6.15

• Add blockNumber to block related methods cfx_getBlockByHash, cfx_getBlockByEpochNumber, cfx_getBlockByHashWithPivotAssumption which need Conflux-rust v1.1.5 or above.

• Add one new RPC method cfx_getBlockByBlockNubmer

v1.6.10

• format.bytes now only support hex string, will not accept non hex utf-8 string

• Add cli cfxjs which can random generate a 0x1 prefix ethereum address

• Conflux add a new method getEpochReceiptsByPivotBlockHash

v1.6.9

• Support keepAlive option in Conflux initialization.

• Add one util method tracesInTree to return a tree structure traces.

• Fix contract method override bug.

• Add a address utility method shortenCfxAddress.

v1.6.3

• Support retry option in Conflux initialization.

• Add pending transaction status enum CONST.PENDING_TX_STATUS currently have two value: FUTURE_NONCE NOT_ENOUGH_CASH

v1.6.2

• Optimize the address convert performance.

v1.6.1

• Conflux add method getAccountPendingTransactions to get one account's pending transaction.

• Split API documents into several files, which is easy to read.

v1.6.0

This version is corresponding to conflux-rust v1.1.3, check it's changelog for detailed info.

• format.address will respect networkId, verbose flag even if the first parameter is an CIP37 address.

• Add support for a standard token contract through Conflux.CRC20

• cfx_getLogs filter option add one more field offset

• Add one RPC method cfx_getAccountPendingInfo to get account's transaction pending info

• epochs pubsub now accept one parameter subscription_epoch the supported values are latest_mined (default) and latest_state

• Include blockHash, epochHash, epochNumber, transactionHash, and transactionPosition for trace RPCs

• When ABI encoding bytes-N type, if the data's length is not enough, will auto pad (right) to N

v1.5.13

• getStatus method rethurn three new fields latestState, latestConfirmed, latestCheckpoint

• add two trace related rpc traceTransaction, traceFilter

• add one debug rpc getEpochReceipts

• add two provider wrapper wrapEthereum, wrapConflux to work with metamask

Notice: this is an update corresponding conflux-rust v1.1.2

v1.5.10

• Conflux's option can pass networkId now, and add a new method updateNetworkId to sync networkId from RPC.

• format.address will return new CIP37 addresses, if you pass a hex address, networkId should also be passed as second parameter

• add new method format.hexAddress to format hex address

• Wallet's constructor add a parameter networkId

• PrivateKeyAccount constructor, decrypt, random need one more parameter networkId

• Transaction, Message sign method need one more parameter networkId

• Conflux's get methods will return new address, and same to contract method returned address.

• getSupplyInfo response add new field totalCirculating

• getStatus response add new field networkId

v1.1.7

• Add RPC method traceBlock to Conflux which can used to get block's execution trace

v1.1.6

• export Contract

// nodejs
const { Contract } = require('js-conflux-sdk');

import { Contract } from 'js-conflux-sdk'

v1.1.5

• add stateMutability for method from abi

console.log(contract.symbol.stateMutability) // "view"
console.log(contract.transfer.stateMutability) // "nonpayable"

• rename EventLog.params to EventLog.arguments

await conflux.contract.Transfer(null, null, null).getLogs({
  fromEpoch: 2868400,
  toEpoch: 2868500,
});

/* [ 
  { 
    data: '0x0000000000000000000000000000000000000000000000000001184b321b4e44', 
    topics: [ '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef', '0x0000000000000000000000001dc05200485776b79f195a1e617dbccb6826f1c4', '0x000000000000000000000000882c4ddb1d3210b5ae778360729c04cd3242df70' ], 
    ...,
    arguments: NamedTuple(from,to,value)(3) [ '0x1dc05200485776b79f195a1e617dbccb6826f1c4', '0x882c4ddb1d3210b5ae778360729c04cd3242df70', 308186218974788n ] 
  } 
] */

• add subscribeLogs for EventLog

subscription = await contract.Transfer(null, null, null).subscribeLogs();
subscription.on('data', data => { console.log(data); });

• contract decode constructor data with out bytecode

v1.1.4

• add conflux.getSupplyInfo

v1.1.3

• WebsocketProvider with Websocket options

new Conflux({ url: 'ws://127.0.0.1', clientConfig: { maxReceivedFrameSize: 10_1000_1000 } }) // 10 MB

v1.1.2

• add conflux.getVoteList

• add conflux.getDepositList

• update conflux.getTransactionReceipt

v1.1.1

fix: update request id avoid repeat

// old
conflux.provider.requestId(); // "16055917399420726"
// new
conflux.provider.requestId(); // "175d4b91862001f4f81eb443"

v1.1.0

fix: use native websocket for front-end

• use BigInt for nodejs, JSBI for browser

// for nodejs
// old
conflux.getBalance(ADDRESS); // JSBI(1) [ -1153374696, sign: false ]
// new 
conflux.getBalance(ADDRESS); // 3141592600n

v1.0.1

fix: EventCoder, FunctionCoder, valueCoder decode return string but not JSBI

v1.0.0

• add defaultGasRatio and defaultStorageRatio

conflux = new Conflux({ defaultGasRatio: 1.1, defaultStorageRatio: 1.1, ... })

• add BaseAccount and PrivateKeyAccount

Account signTransaction and signMessage to be async

• add wallet

wallet use for create and manage Account by address

account = conflux.wallet.addRandom(); 
console.log(conflux.wallet.has(account.address)); 
// true
account = conflux.wallet.addPrivateKey(PRIVATE_KEY); 
console.log(conflux.wallet.has(account.address)); 
// true
account = conflux.wallet.addKeystore(keystore, password); 
console.log(conflux.wallet.has(account.address)); 
// true

wallet use for sendTransaction

// old 
account = conflux.Account(PRIVATE_KEY);
conflux.sendTransaction({ from: account.address, ...}) // address will call `cfx_sendTranscion`
conflux.sendTransaction({ from: account,  ... }) // must be instance of `Account` to sign by sdk and call `cfx_sendRawTransaction`

// new 
conflux.sendTransaction({ from: address, ... }) // if address not in `conflux.wallet`, call `cfx_sendTranscion`
account = conflux.wallet.addPrivate(PRIVATE_KEY);
conflux.sendTransaction({ from: account.address,  ... }) // if account in `conflux.wallet`, sign by account and call `cfx_sendRawTransaction`
conflux.sendTransaction({ from: account,  ... }) // same as `from: account.address`, but some user think input account instance with privateKey is unsafe

• add Subscription

await conflux.subscribe(name, ...args);  // => id 
await conflux.subscribeEpochs(); // => Subscription with event 'data' 
await conflux.subscribeNewHeads(); // => Subscription with event 'data' 
await conflux.subscribeLogs(); // => Subscription with event 'data', 'revert' 
await conflux.unsubscribe(id); // => boolean 
await conflux.unsubscribe(subscription); // => boolean

• add internal contract

contract = conflux.InternalContract('AdminControl'); 
console.log(contract);
contract = conflux.InternalContract('SponsorWhitelistControl'); 
console.log(contract);
contract = conflux.InternalContract('Staking'); 
console.log(contract);

• add checksum address

// old 
conflux.getBalance('0x1B716c51381e76900EBAA7999A488511A4E1fD0a'); // ok 
conflux.getBalance('0x1B716c51381e76900EBAA7999A488511A4E1fD0A'); // ok

// new 
conflux.getBalance('0x1B716c51381e76900EBAA7999A488511A4E1fD0a'); // ok 
conflux.getBalance('0x1B716c51381e76900EBAA7999A488511A4E1fD0A'); // Error\('address checksum error'\)

• providerFactory only accept first argument as override options

// old 
provider = providerFactory('http://localhost:12537')
// new 
provider = providerFactory({ url: 'http://localhost:12537' })

• add batch request

provider = providerFactory({ url: 'http://localhost:12537' })
array = await provider.batch([ { method: 'cfx_epochNumber' }, { method: 'cfx_getBalance', params: ['0x0123456789012345678901234567890123456789'] }]) 
// [ '0x1381', '0x0']

• add WebSocketProvider

provider = providerFactory({ url: 'ws://localhost:12535' })
provider.close(); // user need to close before process ternimal

• BaseProvider instanceof EventEmitter

const EventEmitter = require('events');

// old 
console.log(new BaseProvider() instanceof EventEmitter); // false 
console.log(new HttpProvider() instanceof EventEmitter); // false

// new 
console.log(new BaseProvider({}) instanceof EventEmitter); // true 
console.log(new HttpProvider({}) instanceof EventEmitter); // true 
console.log(new WebSocketProvider({}) instanceof EventEmitter); // true

• add CONST

const { CONST } = require('js-conflux-sdk');
console.log(CONST.EPOCH_NUMBER)
{ 
  LATEST_MINED: 'latest_mined', 
  LATEST_STATE: 'latest_state', 
  LATEST_CONFIRMED: 'latest_confirmed', 
  LATEST_CHECKPOINT: 'latest_checkpoint', 
  EARLIEST: 'earliest' 
}

• export format and sign without util

// old 
const { util: {format, sign} } = require('js-conflux-sdk');
// new 
const { format, sign } = require('js-conflux-sdk');

• add Drip to replace unit

// old 
const { util } = require('js-conflux-sdk');
const balance = await conflux.getBalance(ADDRESS); 
console.log(util.unit.fromDripToCFX(balance))

// new 
const { Drip } = require('js-conflux-sdk');
const balance = await conflux.getBalance(ADDRESS); 
console.log(Drip(balance).toCFX())

for input, use Drip.fromXXX to get drip number string

// old 
const { util } = require('js-conflux-sdk');
const tx = { to: ADDRESS, value: util.unit.fromCFXToDrip(0.1), ... }

// new 
const { Drip } = require('js-conflux-sdk');
const tx = { to: ADDRESS, value: Drip.fromCFX(0.1), ... }

• include all method from conflux JSON_RPC document

JSON_RPC

• friendly example code

example will guide user to use SDK step by step

• charming code organization

split abi coder with types

split contract method, event and override

v0.13.4

• rename send_transaction to cfx_sendTransaction

v0.13.3

• Account.encrypt returned address drop '0x' prefix

v0.13.2

• use scrypt-js

v0.13.1

• RPC returned all number as hex

• fix sendTransaction, call, estimateGasAndCollateral shallow copy options

v0.13.0

• Account.decrypt required keystoreV3 object as input, and put password as second parameter

// old 
Account.decrypt('password', {salt:..., iv:..., cipher:..., mac:...})

// new 
Account.decrypt({ 
  version: 3, 
  id: '0bb47ee0-aac3-a006-2717-03877afa15f0', 
  address: '0x1cad0b19bb29d4674531d6f115237e16afce377c', 
  crypto: { 
    ciphertext: 'a8ec41d2440311ce897bacb6f7942f3235113fa17c4ae6732e032336038a8f73', 
    cipherparams: { iv: '85b5e092c1c32129e3d27df8c581514d' }, 
    cipher: 'aes-128-ctr', 
    kdf: 'scrypt', 
    kdfparams: { dklen: 32, salt: 'b662f09bdf6751ac599219732609dceac430bc0629a7906eaa1451555f051ebc', n: 8192, r: 8, p: 1 }, 
    mac: 'cc89df7ef6c27d284526a65cabf8e5042cdf1ec1aa4ee36dcf65b965fa34843d' 
  } 
}, 
'password')

• Account.prototype.encrypt returned keystoreV3 format object

const account = new Account('0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef');

// old 
account.encrypt('password') 
/*
{ 
  algorithm: 'aes-128-ctr', 
  N: 8192, 
  r: 8, 
  p: 1, 
  dkLen: 32, 
  salt: '0xb662f09bdf6751ac599219732609dceac430bc0629a7906eaa1451555f051ebc', 
  iv: '0x85b5e092c1c32129e3d27df8c581514d', 
  cipher: '0xa8ec41d2440311ce897bacb6f7942f3235113fa17c4ae6732e032336038a8f73', 
  mac: '0xcc89df7ef6c27d284526a65cabf8e5042cdf1ec1aa4ee36dcf65b965fa34843d' 
}
*/

// new 
account.encrypt('password') 
/* 
{ 
  version: 3, 
  id: '0bb47ee0-aac3-a006-2717-03877afa15f0', 
  address: '0x1cad0b19bb29d4674531d6f115237e16afce377c', 
  crypto: { 
    ciphertext: 'a8ec41d2440311ce897bacb6f7942f3235113fa17c4ae6732e032336038a8f73', 
    cipherparams: { 
      iv: '85b5e092c1c32129e3d27df8c581514d' 
    }, 
    cipher: 'aes-128-ctr', 
    kdf: 'scrypt', 
    kdfparams: { 
      dklen: 32, 
      salt: 'b662f09bdf6751ac599219732609dceac430bc0629a7906eaa1451555f051ebc', 
      n: 8192, 
      r: 8, 
      pw: 1 
    }, 
    mac: 'cc89df7ef6c27d284526a65cabf8e5042cdf1ec1aa4ee36dcf65b965fa34843d' 
  } 
}
*/

• epochNumber accept earliest, latest_checkpoint, latest_confirmed label

v0.12.0

• add getAdmin

await cfx.getAdmin('0x89996a8aefb2228593aae723d47f9517eef1341d') // "0x1be45681ac6c53d5a40475f7526bac1fe7590fb8"

• sendTransaction accept privateKey as from

cfx.sendTransaction({ 
  from: PRIVATE_KEY, // accept Account instance or privateKey 
  to: ADDRESS, // accept Account instance or address 
  ..., 
})

• create Account accept address

new Account(PRIVATE_KEY); // {privateKey:'0x...', publicKey: '0x...', address: '0x...'} 
new Account(PUBLIC_KEY); // {publicKey: '0x...', address: '0x...'} 
new Account(ADDRESS); // {address: '0x...'}

v0.11.0

• defaultGasPrice, only use for sendTransaction

cfx = new Conflux({ url: 'https://test.confluxrpc.com', defaultGasPrice: 100, });
// old 
cfx.call({ address: '0x...', data: '0x...', }); // => cfx_call{defaultGasPrice:'0x64',address:'0x...',data:'0x...'}
// new 
cfx.call({ address: '0x...', data: '0x...', }); // => cfx_call{address:'0x...',data:'0x...'}

• remove defaultEpoch, defaultChainId, defaultGas, defaultStorageLimit

// old 
cfx = new Conflux({ url: 'https://test.confluxrpc.com', defaultEpoch: 'latest_state', defaultChainId: 1, defaultGasPrice: 100, defaultGas: 10, defaultStorageLimit: 1, })

// new 
cfx = new Conflux({ url: 'https://test.confluxrpc.com', defaultGasPrice: 100, })

// user could `epochNumber` and `chainId` manual on each method.

v0.10.3

• fix broken sourcemap

v0.10.2

• fix: include crypto into browserify build

// old 
ConfluxJSSDK.util.sign.randomPrivateKey() // TypeError randomBytes is not a function

v0.10.1

• add format.bytes

format.bytes('abcd'); //  format.bytes([0, 1, 2, 3]);

• add contract method & event type or signature indexes

// solidity function override(bytes memory str) public function override(string memory str) public
contract.override('str'); // Error: can not determine override
contract['override(string)']('str'); // specify override method by type contract['0x227ffd52']('str'); // specify override method by signature

v0.10.0-alpha

• add getStatus

cfx.getStatus()

• remove getRiskCoefficient and replace with getConfirmationRiskByHash

// old 
cfx.getRiskCoefficient(epochNumber)
// new 
cfx.getConfirmationRiskByHash(blockHash)

• remove getAccount cause it's internal RPC.

• use require replace import to gen code.

v0.9.2

• add defaultStorageLimit and defaultChainId for Conflux

// old 
const cfx = new Conflux({ url: 'https://test.confluxrpc.com', defaultGasPrice: 100, defaultGas: 100000, })
// new 
const cfx = new Conflux({ url: 'https://test.confluxrpc.com', defaultGasPrice: 100, defaultGas: 100000, defaultStorageLimit: 4096, defaultChainId: 0, })

v0.9.1

• abi implicitly converting string to number

solidity method: function add(uint,uint) public returns (uint);

// old 
await contract.add(1, '2'); // error! can not accept string
// new version 
await contract.add(1, '2'); // good, converting string to number

v0.9.0-beta

• format nonce as JSBI.BigInt

nonce = await cfx.getNextNonce(...)
// old 100000
// new JSBI.BigInt(100000)

• format transaction fields

tx = await cfx.getTransactionByHash(txHash) 
// old 
{ storageLimit: "0x64", chainId: "0x0", epochHeight: "0x400", ... }
// new 
{ 
  storageLimit: JSBI.BigInt(100), // JSBI 
  chainId: 0, 
  epochHeight: 1024, ... 
}

• unit return string

// old 
unit.fromCFXToGDrip(123) => JSBI.BigInt(123000000000) 
unit.fromCFXToGDrip('0.1234567891') => Error('Cannot convert JSBI.BigInt')
// new 
unit.fromCFXToGDrip(123) => "123000000000" 
unit.fromCFXToGDrip('0.1234567891') => "123456789.1"

• contract fields "code" rename to "bytecode"

// old 
cfx.Contract({code, abi, address})
// new 
cfx.Contract({bytecode, abi, address})

• abi decodeData and decodeLog return object

result = contract.abi.decodeData('0x....')
// old 
["Tom", JSBI.BigInt(18)]
// new 
{ name: 'func' fullName: 'func(string name, uint age)', type: 'func(string,uint)', signature: '0x812600df', array: ["Tom", JSBI.BigInt(18)], object: { name: "Tom", age: JSBI.BigInt(18), } }