目录
- .ciupdate link of log (#102)5年前
- packagesfix: Certificate analysis optimization (#125)4年前
- testfeat: add gm linker for solc 0.5 (#117)5年前
- .gitignorefix format & fix error in unit test (#116)5年前
- .jsbeautifyrcfix bug that cannot parse array (#112)5年前
- .jshintrcmerge release-1.0.0 into master (#99)5年前
- .travis.ymlmerge release-1.0.0 into master (#99)5年前
- CHANGELOG.mdmerge release-1.0.0 into master (#99)5年前
- LICENSEimplements Node.js SDK (#1)6年前
- README.mdupdate method of installing from git (#123)4年前
- lerna.jsonmerge release-1.0.0 into master (#99)5年前
- package.jsonmerge release-1.0.0 into master (#99)5年前
邀请码
版权所有：中国计算机学会技术支持：开源发展技术委员会
京ICP备13000930号-9
京公网安备 11010802032778号
FISCO BCOS Node.js SDK
Node.js SDK为联盟链平台FISCO BCOS提供面向Node.js语言的应用程序接口，使用Node.js SDK可以简单快捷地开发基于FISCO-BCOS的Node.js应用。Node.js SDK仅支持v2.0.0及以上版本的FISCO BCOS。
关键特性
目录
一、环境要求
Node.js开发环境
如果您没有部署过Node.js环境，可以参考下列部署方式：
如果您使用Linux或MacOS：
推荐使用nvm快速部署，使用nvm也能够避免潜在的导致Node.js SDK部署失败的权限问题。以部署Node.js 8为例，部署步骤如下：
如果您使用Windows：
请前往Node.js官网按照说明下载Windows安装包进行安装。
基本开发组件
Python 2（Windows、Linux及MacOS需要）
g++（Linux及MacOS需要）
make（Linux及MacOS需要）
Git（Windows、Linux及MacOS需要）
Git bash（仅Windows需要）
MSBuild构建环境（仅Windows需要）
如果您使用Windows且没有部署过MSBuild构建环境，推荐在Windows PowerShell（管理员）中执行以下命令部署，该命令会下载约1GB的依赖项，整个过程可能会持续数十分钟，请耐心等待：
请注意：如果您使用Windows，则若无无特殊说明，本文之后所提到的命令均需要在Git bash中执行
FISCO BCOS：请参考FISCO BCOS环境搭建教程
npm代理：如果您的网络中使用了代理，请按照如下方式为npm配置代理。如果没有使用代理，请忽略。
npm源：如果您的网络无法访问npm官方镜像源，请按照如下方式更换镜像源，如淘宝：
二、CLI工具
用户即使不使用SDK开发应用程序，也可以使用Node.js SDK中自带CLI工具在命令行中方便快捷地部署及调用合约、管理区块链状态、执行CRUD操作等。CLI工具也能够方便地嵌入到命令行脚本中，进行简单的应用开发。同时，CLI工具完全基于Node.js SDK提供的API的开发而成，可作为一个展示如何使用Node.js SDK API进行二次开发的Demo。在使用CLI工具前请下载并部署Node.js SDK：
2.1 快速建链（可选）
请注意：若您的系统中已经搭建了FISCO BCOS链，请跳过本节。
2.2 配置
CLI工具的配置文件位于
packages/cli/conf/config.json，该配置文件用于初始化Node.js SDK，如需修改配置项请修改此文件。Node.js SDK的配置项包括：加密算法类型
加密算法类型配置位于配置文件的
encryptType配置项中。如果您需要连接国密版FISCO BCOS节点，请将该配置项设置为"SM_CRYPTO"，否则请将该设置项设置为"ECDSA"。账户
账户配置位于配置文件的
accounts配置项中。Node.js SDK支持同时加载多个账户，每个账户由账户名及对应的私钥组成。对于单个账户，您可以直接指定一个随机数（随机数的要求见『Node.js SDK配置项说明』一节）作为私钥，但更一般地，您也可以指定指定私钥文件以让SDK加载私钥。国密私钥文件可以使用get_gm_account.sh脚本工具生成，非国密私钥文件可以使用get_account.sh脚本工具生成。请您确保所使用的私钥文件的类型与encryptType配置项中指定的加密算法类型一致。证书
证书配置位于配置文件的
authentication配置项中。您需要根据您实际使用的证书文件的路径修改该配置项的key、cert及ca配置项，其中key为SDK私钥文件的路径，cert为SDK证书文件的路径，ca为链根证书文件的路径，这些文件可以由建链脚本或企业级部署工具自动生成，具体的生成方式及文件位置请参阅上述工具的说明文档。节点IP及Channel通信端口
节点IP及Channel通信端口配置位于配置文件的
nodes配置项中。您需要根据您要连接FISCO BCOS节点的实际配置修改该配置项的ip及port配置项，其中ip为所连节点的IP地址，port为所连节点的Channel通信端口（具体的值请参考节点目录下config.ini文件中的channel_listen_port配置项）。如果您使用了快速搭链，可以跳过此步。配置完成后，即可开始使用CLI工具，CLI工具位于
packages/cli/cli.js，所有操作均需要在packages/cli/目录下执行，您需要先切换至该目录：2.3 开启命令自动补全
为方便用户使用，CLI工具支持在bash或zsh中进行子命令自动补全，此功能需要手动开启。启用方式为：
使用CLI工具时，可以在输入子命令或参数的过程中按下
Tab键（依据系统配置的不同，可能需要连续按多次），便可弹出候选子命令或参数的列表，随后使用方向键进行选择即可，当候选子命令或参数唯一时，CLI工具会自动将该子命令或参数填充至对应的位置上。2.4 CLI工具使用示例
请注意：示例中的输出结果仅供参考，根据系统、节点版本等因素的不同，实际输出结果可能会有所出入。
2.4.1 查看使用帮助
2.4.2 查看CLI工具能够调用的命令及对应的功能
2.4.3 查看所连FISCO BCOS节点的版本
输出如下：
2.4.4 显示外部账户
假设在配置文件中有一个名为”alice”的账户。
输出如下：
2.4.5 获取当前的块高
输出如下：
2.4.6 部署CLI工具自带的HelloWorld合约
HelloWorld合约位于
packages/cli/contracts/HelloWorldV4.sol，若您需要部署自己合约，请先将您的合约拷贝至packages/cli/contracts/目录下。输出如下：
2.4.7 调用HelloWorld合约的set接口
假设HelloWorld合约已按照2.4.6节中的说明部署。
输出如下：
2.4.8 调用HelloWorld合约的get接口
假设HelloWorld合约已按照2.4.6节中的说明部署。
输出如下：
其中，
output中各字段的含义如下：function：所调用合约方法的签名methodID：所调用合约方法的选择器（selector）result：合约方法具体的返回值2.4.9 CRUD操作
CLI工具的
sql子命令允许用户使用类SQL语法在链上进行CRUD操作，如下列示例所示：创建表
在上述示例中，创建了一个名为
cli_demo的表，表中每条记录的主键名为name，另外还包括两个分别名为item_id和item_name的列，输出如下：插入记录
在上述示例中，向
cli_demo表插入了一条记录，记录的name字段值为”fruit”，item_id字段值为”1”，item_name字段值为”apple2”，输出如下：其中，
affected表示该操作所影响的表的行数。查询记录
在上述示例中，从
cli_demo表中查询name字段值为”fruit”、item_id字段值为”1”的记录，输出如下：更新记录
在上述示例中，更新
cli_demo表中、name字段值为”fruit”的记录，将这些记录的”item_name”字段值更新为”orange”，输出如下：其中，
affected表示该操作所影响的表的行数。删除记录
在上述示例中，将
cli_demo中name字段值为”fruit”且item_id字段值为”1”的记录删除，输出如下：其中，
affected表示该操作所影响的表的行数。2.4.10 更多使用帮助
如果您想知道某一个子命令该如何使用，可以使用如下格式的命令：
其中command为一个子命令名，使用
?作为参数便可获取该子命令的使用帮助，如：会得到如下的输出：
三、Node.js SDK API
在使用Node.js SDK进行应用开发前请先导入Node.js SDK项目依赖：
3.1 API调用约定
Configuration对象实例，然后以该对象实例为构造函数参数实例化所需的Service。Configuration对象可通过require('nodejs-sdk/packages/api').Configuration的方式引入，随后通过new Configuration(...)即可创建Configuration对象实例，Configuration的构造函数参数为配置文件的路径。Node.js SDK所需的配置项请参阅『Node.js SDK配置项说明』一节；3.2 Web3jService
引用方式：
require('nodejs-sdk/packages/api').Web3jService使用方式：使用
new Web3jService(config)进行实例化，其中config为一个Configuration对象实例，随后调用对象实例上的成员方法成员方法：
getBlockNumber
功能：获取当前块高
参数：无
返回值：
Object，块高位于result字段中getPbftView
功能：获取当前PBFT视图
参数：无
返回值：
Object，PBFT视图位于result字段中getObserverList
功能：获取当前观察者节点列表
参数：无
返回值：
Object，观察者节点列表位于result字段中getSealerList
功能：获取当前共识节点列表
参数：无
返回值：
Object，共识节点列表位于result字段中getConsensusStatus
功能：获取当前共识状态
参数：无
返回值：
Object，共识状态位于result字段中getSyncStatus
功能：获取当前同步状态
参数：无
返回值：
Object，同步状态位于result字段中getClientVersion
功能：获取节点版本信息
参数：无
返回值：
Object，节点版本信息位于result字段中getPeers
功能：获取节点所连接的对等节点信息
参数：无
返回值：
Object，对等节点信息位于result字段中getNodeIDList
功能： 获取节点及所连接对等节点的NodeID列表
参数：无
返回值：
Object，NodeID列表位于result字段中getGroupPeers
功能：获取所属当前群组的共识节点及观察者节点的列表
参数：无
返回值：
Object，节点列表位于result字段中getGroupList
功能：获取节点所属的群组列表
参数：无
返回值：
Object，所属群组列表位于result字段中getBlockByHash
功能：根据指定的区块哈希获取相应的区块信息
参数：
String，blockHash。32字节长度的区块哈希Bool，includeTransactions，可选，默认值为false。指示返回结果中是否需要包含交易的完整信息，若为false则返回结果中仅会包含交易哈希返回值：
Object，区块信息位于result字段中getBlockByNumber
功能：根据指定的区块高度获取相应的区块信息
参数：
String，blockNumber。以字符串表示的非负区块高度Bool，includeTransactions，可选，默认值为false。指示返回结果中是否需要包含交易的完整信息，若为false则返回结果中仅会包含交易哈希返回值：
Object，区块信息位于result字段中getBlockHashByNumber
功能：根据指定的区块高度获取相应的区块哈希
参数：
String，blockNumber。以字符串表示的非负区块高度返回值：
Object，区块哈希位于result字段中getTransactionByHash
功能：根据指定的交易哈希获取相应的交易信息
参数：
String，transactionHash。32字节长度的交易哈希返回值：
Object，交易信息位于result字段中getTransactionByBlockHashAndIndex
功能：根据指定的区块哈希及交易索引获取相应的交易信息
参数：
String，blockHash。32字节长度的区块哈希String，index。以字符串表示的非负交易索引返回值：
Object，交易信息位于result字段中getTransactionByBlockNumberAndIndex
功能：根据指定的区块高度及交易索引获取相应的交易信息
参数：
String，blockNumber。以字符串表示的非负区块高度String，index。以字符串表示的非负交易索引返回值：
Object，交易信息位于result字段中getPendingTransactions
功能：获取当前滞留在节点交易池内还未上链的交易列表
参数：无
返回值：
Object，滞留交易列表位于result字段中getPendingTxSize
功能：获取当前滞留在节点交易池内还未上链的交易数目
参数：无
返回值：
Object，滞留交易数目位于result字段中getTotalTransactionCount
功能：获取当前已上链交易的总数
参数：无
返回值：
Object，上链交易总数位于result字段中getTransactionReceipt
功能：根据交易哈希获取对应的交易回执
参数：
String，transactionHash。32字节长度的交易哈希返回值：
Object，上链交易总数位于result字段中getCode
功能：根据合约地址获取对应的合约字节码
参数：
String，address。20字节长度的合约地址返回值：
Object，合约字节码位于result字段中getSystemConfigByKey
功能：根据指定Key获取对应的系统配置信息
参数：
String，key。系统配置名返回值：
Object，系统配置信息位于result字段中sendRawTransaction
功能：向节点发送交易
参数：
重载形式1：
String，transaction。字符串表示的交易信息重载形式2：
String，to。20字节长度的目标合约地址Object，func。调用的合约方法对应的 ABI 描述，该描述可直接从编译合约时所生成的 ABI 文件中获取。[Object]，params。实参列表，若无则置为[]String，who，可选。用于签署交易的账户名返回值：
Object，交易哈希位于transactionHash字段中；交易执行状态位于status字段中；交易返回值位于output字段中deploy
功能：根据ABI及字节码部署合约
参数：
Object，abi。合约ABIString，bin。合约字节码[Object]，params。构造函数实参列表，若无则置为[]String，who，可选。用于部署合约的账户名返回值：
Object，交易哈希位于transactionHash字段中；合约部署状态位于status字段中；合约地址位于contractAddress字段中call
功能：向节点发送只读请求（与交易不同，
call只可用于调用合约的pure或view函数）参数：
String，to。20字节长度的目标合约地址Object，func。调用的合约方法对应的 ABI 描述，该描述可直接从编译合约时所生成的 ABI 文件中获取。[Object]，params。实参列表，若无则置为[]String，who，可选。用于发送请求的账户名返回值：
Object，请求状态码位于code字段中；返回值位于output字段中3.3 PermissionService
引用方式：
require('nodejs-sdk/packages/api').PermissionService使用方式：使用
new PermissionService(config)进行实例化，其中config为一个Configuration对象实例，随后调用对象实例上的成员方法成员方法：
grantUserTableManager
功能：将指定外部账户加入至指定用户表的授权列表中
参数：
String，tableName。用户表名String，address。20字节长度的外部账户地址返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中revokeUserTableManager
功能：将指定外部账户从指定用户表的授权列表中移出
参数：
String，tableName。用户表名String，address。20字节长度的外部账户地址返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中listUserTableManager
功能：查询指定用户表的授权列表
参数：
String，tableName。用户表名返回值：
[String]，经过授权的外部账户列表grantDeployAndCreateManager
功能：授予指定外部账户部署合约及创建用户表的权限
参数：
String，address。20字节长度的外部账户地址返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中revokeDeployAndCreateManager
功能：取消指定外部账户部署合约及创建用户表的权限
参数：
String，address。20字节长度的外部账户地址返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中listDeployAndCreateManager
功能：查询部署合约及创建用户表的授权列表
参数：无
返回值：
[String]，经过授权的外部账户列表grantPermissionManager
功能：授予指定外部账户管理权限的权限
参数：
String，address。20字节长度的外部账户地址返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中revokePermissionManager
功能：取消指定外部账户管理权限的权限
参数：
String，address。20字节长度的外部账户地址返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中listPermissionManager
功能：查询权限管理的授权列表
参数：无
返回值：
[String]，经过授权的外部账户列表grantNodeManager
功能：授予指定外部账户管理节点的权限
参数：
String，address。20字节长度的外部账户地址返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中revokeNodeManager
功能：取消指定外部账户管理节点的权限
参数：
String，address。20字节长度的外部账户地址返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中listNodeManager
功能：查询节点管理的授权列表
参数：无
返回值：
[String]，经过授权的外部账户列表grantCNSManager
功能：授予指定外部账户使用CNS服务的权限
参数：
String，address。20字节长度的外部账户地址返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中revokeCNSManager
功能：取消指定外部账户使用CNS服务的权限
参数：
String，address。20字节长度的外部账户地址返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中listCNSManager
功能：查询CNS服务的授权列表
参数：无
返回值：
[String]，经过授权的外部账户列表grantSysConfigManager
功能：授予指定外部账户设置系统配置的权限
参数：
String，address。20字节长度的外部账户地址返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中revokeSysConfigManager
功能：取消指定外部账户设置系统配置的权限
参数：
String，address。20字节长度的外部账户地址返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中listSysConfigManager
功能：查询设置系统配置的授权列表
参数：无
返回值：
[String]，经过授权的外部账户列表3.4 CNSService
引用方式：
require('nodejs-sdk/packages/api').CNSService使用方式：使用
new CNSService(config)进行实例化，其中config为一个Configuration对象实例，随后调用对象实例上的成员方法成员方法：
registerCns
功能：根据合约名、合约版本号、合约地址和合约ABI注册CNS信息
参数：
String，name。合约名String，version。合约版本号String，address。20字节长度的合约地址String，abi。合约ABI返回值：
Number，成功增加的CNS条目数getAddressByContractNameAndVersion
功能：根据合约名及版本号（合约名及版本号用英文冒号连接）查询对应的合约地址。若缺失合约版本号，则默认返回最新版本的合约地址
参数：
String，nameVersion。合约名及版本号（合约名及版本号用英文冒号连接）返回值：
Object，合约地址信息queryCnsByName
功能：根据合约名查询CNS信息
参数：
String，合约名返回值：
[Object]，对应合约的CNS信息列表queryCnsByNameAndVersion
功能：根据合约名及版本号（合约名及版本号用英文冒号连接）查询CNS信息
参数：
String，合约名及版本号（合约名及版本号用英文冒号连接）返回值：
Object，对应版本号合约的CNS信息列表3.5 SystemConfigService
引用方式：
require('nodejs-sdk/packages/api').SystemConfigService使用方式：使用
new SystemConfigService(config)进行实例化，其中config为一个Configuration对象实例，随后调用对象实例上的成员方法成员方法：
setValueByKey
功能：根据key设置对应系统配置的值
参数：
String，key。系统配置的keyString，value。系统配置的值返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中3.6 ConsensusService
引用方式：
require('nodejs-sdk/packages/api').ConsensusService使用方式：使用
new ConsensusService(config)进行实例化，其中config为一个Configuration对象实例，随后调用对象实例上的成员方法成员方法：
addSealer
功能：将指定节点加入群组的共识节点列表
参数：
String，nodeID。待加入群组共识节点列表的节点ID返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中addObserver
功能：将指定节点加入群组的观察者节点列表
参数：
String，nodeID。待加入群组观察者节点列表的节点ID返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中removeNode
功能：将指定节点变更为游离节点
参数：
String，nodeID。待成为游离节点的节点ID返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中3.6 CRUDService
引用方式：
require('nodejs-sdk/packages/api').CRUDService使用方式：使用
new CRUDService(config)进行实例化，其中config为一个Configuration对象实例，随后调用对象实例上的成员方法成员方法：
createTable
功能：创建用户表
参数：
Object，table。表对象，表对象中需要设置表名、主键列名和其他列名，表对象的定义请参考packages/api/precompiled/crud/table.js。返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中insert
功能：向用户表中插入记录
参数：
Object，table。表对象，表对象中需要设置表名、主键列名和其他列名，表对象的定义请参考packages/api/precompiled/crud/table.jsObject，entry。记录对象，记录对象中需要设置各列的值，记录对象的定义请参考packages/api/precompiled/crud/entry.js返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中；若成功插入记录，则所影响的表的行数位于affected字段中update
功能：更新用户表记录
参数：
Object，table。表对象，表对象中需要设置表名、主键列名和其他列名，表对象的定义请参考packages/api/precompiled/crud/table.jsObject，entry。记录对象，记录对象中需要设置各列的值，记录对象的定义请参考packages/api/precompiled/crud/entry.jsObject，condition。条件对象，条件对象中需要设置过滤记录的谓词，条件对象的定义请参考packages/api/precompiled/crud/condition.js返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中；若成功更新记录，则所影响的表的行数位于affected字段中remove
功能：删除用户表记录
参数：
Object，table。表对象，表对象中需要设置表名、主键列名和其他列名，表对象的定义请参考packages/api/precompiled/crud/table.jsObject，condition。条件对象，条件对象中需要设置过滤记录的谓词，条件对象的定义请参考packages/api/precompiled/crud/condition.js返回值：
Object，请求状态码位于code字段中；状态码对应的可读信息位于message字段中；若成功删除记录，则所影响的表的行数位于affected字段中desc
功能：查询用户表元信息
参数：
String，tableName。用户表名返回值：
Object，表对象，包含了表名、主键列名、其他列名等用户表元信息，表对象的定义请参考packages/api/precompiled/crud/table.js3.7 CompileService
引用方式：
require('nodejs-sdk/packages/api').CompileService使用方式：使用
new CompileService(config)进行实例化，其中config为一个Configuration对象实例，随后调用对象实例上的成员方法成员方法：
compile
功能：编译合约
参数：
String，contractPath。合约地址Object，linkLibraries，可选。直接编译包含包含库（Library）调用会导致生成的字节码中出现被引用库地址的占位符，此时的字节码无法使用。若您的合约中包含库调用，您需要通过该参数传入库的地址信息以便链接器对字节码进行链接以生成最终的字节码。例如，若在名为
A.sol的合约中定义并调用了名为B的库，则编译A.sol时需要以下列形式传入linkLibraries参数：若
B定义位于B.sol中，则编译A.sol时需要以下列形式传入linkLibraries参数：返回值：
Object，ContractClass对象，其具体功能请参考3.8节3.8 ContractClass
引用方式：无
使用方式：通过
CompilerService.compileAPI生成该类型的对象实例，随后调用对象实例上的成员方法成员方法：
newInstance：
功能：生成合约对象
参数：无
返回值：
Object，合约对象，其具体功能请参考3.9节3.9 合约对象
引用方式：无
使用方式：通过
ContractClass对象实例的newInstance方法生成该类型的对象实例，随后调用对象实例上的成员方法成员方法：
$deploy
功能：部署用户合约
参数：
Object，web3j。有效的Web3jService对象实例[Object], params。用户合约中构造函数参数列表所对应的实参返回值：
String，20字节长度的合约地址$load
功能：加载已部署的用户合约
参数：
Object，web3j。有效的Web3jService对象实例String, contract address。用户合约地址返回值：无
$getAddress
功能：获取用户合约地址
参数：无
返回值：用户部署合约后的合约地址
$getEventABIOf
功能：获取指定合约事件的ABI
参数：
String，name。事件名返回值：指定合约事件的ABI
$setUser
功能：指定部署、调用合约的用户
参数：
String，id。用户ID返回值：无
功能：指定部署、调用合约的用户。与
$setUser不同，$by的作用范围是临时的，即若您已经通过$setUser指定了部署、调用合约的用户，则$by会临时覆盖已指定的用户。$by的作用范围会持续至接下来的部署、调用合约动作完成参数：
String，id。用户ID返回值：合约对象自身。您可以在该对象继续执行部署、调用操作
动态生成函数
说明：合约对象实例会根据用户合约中的方法动态生成相同名字及参数的函数，以HelloWorld合约为例，HelloWorld合约中存在
get及set两个合约方法，则合约对象实例会自动生成同名且同参数的get及set函数，用户可在应用中直接调用合约对象实例提供的get或set函数即可调用已部署HelloWorld合约的get或set方法，而无需调用Web3jService提供的sendRawTransaction及callAPI。动态生成函数的存在可极大简化应用开发，以下代码片段展示了如何调用HelloWorld合约对象实例上的动态生成函数：动态函数不仅可以被直接调用，其自身也携带一些辅助函数，这些辅助函数包括：
encodeABI
功能：根据指定参数生成调用对应合约方法的ABI编码，生成的编码可用于发送交易或作为参数传递给其他智能合约等
参数：
[Object]，params。参数列表返回值：
String，ABI编码3.10 EventLogService
引用方式：
require('nodejs-sdk/packages/api').EventLogService使用方式：使用
new EventLogService(config)进行实例化，其中config为一个Configuration对象实例，随后调用对象实例上的成员方法成员方法：
registerEventLogFilter
功能：注册事件过滤器及回调函数
参数：
String，from。字符串表示的初始区块高度，使用”latest”表示当前块高String，to。字符串表示的最终区块高度，使用”latest”表示处当前块高。当处理至当前块高时，继续等待新区块[String]，addresses。需要监听的合约地址数组，可为空[String]，topics。需要监听的topic数组，可为空Function，callback。事件发生的调用的回调函数，调用回调参数时会传递两个参数：状态及日志列表Object，abi，可选。当需要对日志进行解码时，可传入事件的ABI或整个合约的ABI返回值：
Object，注册请求状态码位于result字段中；事件过滤器ID位于filterID字段中unregisterEventLogFilter
功能：取消已注册的事件过滤器及回调函数，此API为同步API
参数：
String，filterID。事件过滤器ID返回值：无
四、Node.js SDK配置项说明
配置项中各字段的说明如下：
encryptType:String，必需。指定交易签名、合约部署时所使用的加密算法。ECDSA表示使用ECDSA(secp256k1)加密算法，SM_CRYPTO表示使用国密算法。accounts：Object，必需。用户集合，每个用户均由私钥及用于索引该私钥用户名组成。私钥可以为一个256 bits的随机整数，也可以是一个pem或p12格式的私钥文件，后两者需要结合get_account.sh或get_gm_account.sh生成的私钥文件使用。私钥包含两个必需字段，一个可选字段：type:String，必需。用于指示私钥类型。type的值必需为下列三个值之一：ecrandom：随机整数pem：pem格式的文件p12：p12格式的文件value：String，必需。用于指示私钥具体的值：type为ecrandom，则value为一个长度为256 bits 的随机整数，其值介于1 ~ 0xFFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFE BAAE DCE6 AF48 A03B BFD2 5E8C D036 4141之间。type为pem，则value为pem文件的路径，如果是相对路径，需要以配置文件所在的目录为相对路径起始位置。type为p12，则value为p12文件的路径，如果是相对路径，需要以配置文件所在的目录为相对路径起始位置。password：String，可选。如果type为p12，则需要此字段以解密私钥，否则会忽略该字段。nodes:[Object]，必需。FISCO BCOS节点列表，Node.js SDK在发送网络请求时会从该列表中随机挑选一个节点进行通信，要求节点数目必须 >= 1。每个节点包含两个字段：ip:String，必需。FISCO BCOS节点的IP地址port:String，必需，FISCO BCOS节点的Channel端口authentication：Object。必需，包含建立Channel通信时所需的认证信息，一般在建链过程中自动生成。authentication包含三个必需字段：key:String，必需。私钥文件路径，如果是相对路径，需要以配置文件所在的目录为相对路径起始位置。cert:String，必需。证书文件路径，如果是相对路径，需要以配置文件所在的目录为相对路径起始位置。ca:String，必需。CA根证书文件路径，如果是相对路径，需要以配置文件所在的目录为相对路径起始位置。groupID:Number。群组IDtimeout:Number。Node.js SDK所连的节点可能会陷入停止响应的状态。为避免陷入无限等待，Node.js SDK的每一项操作在timeout之后若仍没有得到结果，则强制结束并向上抛出异常。timeout的单位为毫秒。solc:String，可选。Node.js SDK已经自带0.4.26及0.5.10版本的Solidity编译器，如果您有特殊的编译器需求，可以设置本配置项为您的编译器的执行路径或全局命令。五、贡献代码
六、加入我们的社区
FISCO BCOS开源社区是国内活跃的开源社区，社区长期为机构和个人开发者提供各类支持与帮助。已有来自各行业的数千名技术爱好者在研究和使用FISCO BCOS。如您对FISCO BCOS开源技术及应用感兴趣，欢迎加入社区获得更多支持与帮助。
七、License
Node.js SDK的开源协议为APACHE LICENSE, VERSION 2.0，详情请参考LICENSE。