长安链账户整体介绍
长安链不同身份模式链账户体系对比
整体对比
对比项\身份模式 | PermissionWithCert | PermissionWithKey | Public |
---|---|---|---|
模式名称 | 证书模式 | 公钥注册模式 | 公钥模式 |
模式简称 | cert模式 | pwk模式 | pk模式 |
账户类型 | 节点账户(共识节点、同步节点、轻节点), 用户账户(管理员、普通用户) | 同证书模式 | 同证书模式 |
账户标识 | 数字证书 | 公钥/地址 | 公钥/地址 |
是否需要准入 | 是,证书需要CA签发 | 是,账户需要管理员在链上注册 | 否,普通用户可直接调用合约 |
账户与组织关系 | 账户属于某个组织 | 账户属于某个组织 | 账户无组织概念 |
适用链类型 | 联盟链 | 联盟链 | 公链 |
共识算法 | TBFT、RAFT、MaxBFT | TBFT、RAFT | TBFT、DPOS |
PermissionedWithCert
链配置文件说明
配置文件:bc.yml
auth_type:身份模式
permissionedWithCert:面向强权限控制场景,基于数字证书的用户标识体系、基于角色的权限控制体系。
consensus:共识配置
nodes:共识节点列表
org_id:组织id
node_id:共识节点id列表,是由共识节点TLS证书里的公钥算出的唯一id
trust_roots:信任根配置列表
org_id:组织id
root:组织CA证书所在路径列表
链配置文件示例
chain_id: chain1 # 链标识
version: v1.0.0 # 链版本
sequence: 0 # 配置版本
auth_type: "permissionedWithCert" # 认证类型
crypto:
hash: SHA256
# 合约支持类型的配置
contract:
enable_sql_support: false
# 虚拟机配置
vm:
# 虚拟机支持列表
support_list:
- "wasmer"
- "gasm"
- "evm"
- "wxvm"
# 交易、区块相关配置
block:
tx_timestamp_verify: true # 是否需要开启交易时间戳校验
tx_timeout: 600 # 交易时间戳的过期时间(秒)
block_tx_capacity: 100 # 区块中最大交易数
block_size: 10 # 区块最大限制,单位MB
block_interval: 2000 # 出块间隔,单位:ms
# core模块
core:
tx_scheduler_timeout: 10 # [0, 60] 交易调度器从交易池拿到交易后, 进行调度的时间
tx_scheduler_validate_timeout: 10 # [0, 60] 交易调度器从区块中拿到交易后, 进行验证的超时时间
consensus_turbo_config:
consensus_message_turbo: true # 是否开启共识报文压缩
retry_time: 500 # 根据交易ID列表从交易池获取交易的重试次数
retry_interval: 20 # 重试间隔,单位:ms
#共识配置
consensus:
# 共识类型(0-SOLO,1-TBFT,2-MBFT,3-HOTSTUFF,4-RAFT,5-DPOS)
type: 1
# 共识节点列表,组织必须出现在trust_roots的org_id中,每个组织可配置多个共识节点,节点地址采用libp2p格式
nodes:
- org_id: "wx-org1.chainmaker.org"
node_id:
- "QmcQHCuAXaFkbcsPUj7e37hXXfZ9DdN7bozseo5oX4qiC4"
- org_id: "wx-org2.chainmaker.org"
node_id:
- "QmeyNRs2DwWjcHTpcVHoUSaDAAif4VQZ2wQDQAUNDP33gH"
- org_id: "wx-org3.chainmaker.org"
node_id:
- "QmXf6mnQDBR9aHauRmViKzSuZgpumkn7x6rNxw1oqqRr45"
- org_id: "wx-org4.chainmaker.org"
node_id:
- "QmRRWXJpAVdhFsFtd9ah5F4LDQWFFBDVKpECAF8hssqj6H"
ext_config: # 扩展字段,记录难度、奖励等其他类共识算法配置
- key: aa
value: chain01_ext11
# 信任组织和根证书
trust_roots:
- org_id: "wx-org1.chainmaker.org"
root:
- "../config/wx-org1/certs/ca/wx-org1.chainmaker.org/ca.crt"
- org_id: "wx-org2.chainmaker.org"
root:
- "../config/wx-org2/certs/ca/wx-org2.chainmaker.org/ca.crt"
- org_id: "wx-org3.chainmaker.org"
root:
- "../config/wx-org3/certs/ca/wx-org3.chainmaker.org/ca.crt"
- org_id: "wx-org4.chainmaker.org"
root:
- "../config/wx-org4/certs/ca/wx-org4.chainmaker.org/ca.crt"
# 权限配置(只能整体添加、修改、删除)
resource_policies:
- resource_name: CHAIN_CONFIG-NODE_ID_UPDATE
policy:
rule: SELF # 规则(ANY,MAJORITY...,全部大写,自动转大写)
org_list: # 组织名称(组织名称,区分大小写)
role_list: # 角色名称(role,自动转大写)
- admin
- resource_name: CHAIN_CONFIG-TRUST_ROOT_ADD
policy:
rule: MAJORITY
org_list:
role_list:
- admin
- resource_name: CHAIN_CONFIG-CERTS_FREEZE
policy:
rule: ANY
org_list:
role_list:
- admin
disabled_native_contract:
# - CONTRACT_NAME # 通过指定系统合约名字来禁用系统合约
节点配置文件说明
配置文件:chainmaker.yml
auth_type:身份模式
permissionedWithCert:面向强权限控制场景,基于数字证书的用户标识体系、基于角色的权限控制体系。
node:节点配置
priv_key_file:节点SIGN证书的私钥地址
cert_file:节点SIGN证书的地址
net:网络配置
tls:TLS配置
priv_key_file:节点TLS证书的私钥地址
cert_file:节点TLS证书的地址
节点配置文件示例
auth_type: "permissionedWithCert" # permissionedWithCert / permissionedWithKey / public
log:
config_file: ../config/wx-org1/log.yml # config file of logger configuration.
blockchain:
- chainId: chain1
genesis: ../config/wx-org1/chainconfig/bc1.yml
node:
# 节点类型:full
type: full
org_id: wx-org1.chainmaker.org
priv_key_file: ../config/wx-org1/certs/node/consensus1/consensus1.sign.key
cert_file: ../config/wx-org1/certs/node/consensus1/consensus1.sign.crt
signer_cache_size: 1000
cert_cache_size: 1000
net:
provider: LibP2P
listen_addr: /ip4/0.0.0.0/tcp/11301
seeds:
- "/ip4/127.0.0.1/tcp/11301/p2p/QmcQHCuAXaFkbcsPUj7e37hXXfZ9DdN7bozseo5oX4qiC4"
- "/ip4/127.0.0.1/tcp/11302/p2p/QmNdgWgD2QSu769yCwFCnwhVKhjWzyjA3PgSXL7ZJBrUoA"
- "/ip4/127.0.0.1/tcp/11303/p2p/QmXf6mnQDBR9aHauRmViKzSuZgpumkn7x6rNxw1oqqRr45"
- "/ip4/127.0.0.1/tcp/11304/p2p/QmRRWXJpAVdhFsFtd9ah5F4LDQWFFBDVKpECAF8hssqj6H"
tls:
enabled: true
priv_key_file: ../config/wx-org1/certs/node/consensus1/consensus1.tls.key
cert_file: ../config/wx-org1/certs/node/consensus1/consensus1.tls.crt
# Transaction pool settings
# Other txpool settings can be found in tx_Pool_config.go
txpool:
# tx_pool type, can be single, normal, batch.
# By default the tx_pool type is normal.
# Note: please delete dump_tx_wal folder in storage.store_path when change tx_pool type
pool_type: "normal"
# Max common transaction count in tx_pool.
# If tx_pool is full, the following transactions will be discarded.
max_txpool_size: 50000
# Max config transaction count in tx_pool.
max_config_txpool_size: 10
# Whether dump unpacked config and common transactions in queue when stop node,
# and replay these transactions when restart node.
is_dump_txs_in_queue: true
# Common transaction queue num, only for normal tx_pool.
# Note: the num should be an exponent of 2 and less than 256, such as, 1, 2, 4, 8, 16, ..., 256
common_queue_num: 8
# The number of transactions contained in a batch, for normal and batch tx_pool.
# Note: make sure that block.block_tx_capacity in bc.yml is an integer multiple of batch_max_size
batch_max_size: 100
# Interval of creating a transaction batch, for normal and batch tx_pool, in millisecond(ms).
batch_create_timeout: 50
rpc:
provider: grpc
port: 12301
tls:
# TLS模式:
# disable - 不启用TLS
# oneway - 单向认证
# twoway - 双向认证
#mode: disable
#mode: oneway
mode: twoway
priv_key_file: ../config/wx-org1/certs/node/consensus1/consensus1.tls.key
cert_file: ../config/wx-org1/certs/node/consensus1/consensus1.tls.crt
monitor:
enabled: false
port: 14321
pprof:
enabled: false
port: 24321
storage:
store_path: ../data/org1/ledgerData1
blockdb_config:
provider: leveldb
leveldb_config:
store_path: ../data/org1/blocks
write_buffer_size: 1024
block_write_buffer_size: 1024
statedb_config:
provider: leveldb
leveldb_config:
store_path: ../data/org1/state
historydb_config:
provider: leveldb
leveldb_config:
store_path: ../data/org1/history
resultdb_config:
provider: leveldb
leveldb_config:
store_path: ../data/org1/result
disable_contract_eventdb: true #是否禁止合约事件存储功能,默认为true,如果设置为false,需要配置mysql
contract_eventdb_config:
provider: sql #如果开启contract event db 功能,需要指定provider为sql
sqldb_config:
sqldb_type: mysql #contract event db 只支持mysql
dsn: root:password@tcp(127.0.0.1:3306)/ #mysql的连接信息,包括用户名、密码、ip、port等,示例:root:admin@tcp(127.0.0.1:3306)/
debug:
# 是否开启CLI功能,过度期间使用
is_cli_open: true
is_http_open: false
PermissionedWithKey
链配置文件说明
配置文件:bc.yml
auth_type:身份模式
permissionedWithKey:面向强权限控制场景,基于公钥的用户标识体系、基于角色的权限控制体系。
consensus:共识配置
nodes:共识节点列表
org_id:组织id
node_id:共识节点id列表,是由共识节点公钥算出的唯一id
trust_roots:信任根配置列表
org_id:组织id
root:组织管理员用户公钥所在路径列表
链配置文件示例
chain_id: chain1 # 链标识
version: v1.0.0 # 链版本
sequence: 0 # 配置版本
auth_type: "permissionedWithKey" # 认证类型 permissionedWithCert / permissionedWithKey / public
crypto:
hash: SHA256
# 合约支持类型的配置
contract:
enable_sql_support: false
# 交易、区块相关配置
block:
tx_timestamp_verify: true # 是否需要开启交易时间戳校验
tx_timeout: 600 # 交易时间戳的过期时间(秒)
block_tx_capacity: 100 # 区块中最大交易数
block_size: 10 # 区块最大限制,单位MB
block_interval: 2000 # 出块间隔,单位:ms
# core模块
core:
tx_scheduler_timeout: 10 # [0, 60] 交易调度器从交易池拿到交易后, 进行调度的时间
tx_scheduler_validate_timeout: 10 # [0, 60] 交易调度器从区块中拿到交易后, 进行验证的超时时间
consensus_turbo_config:
consensus_message_turbo: false # 是否开启共识报文压缩
retry_time: 500 # 根据交易ID列表从交易池获取交易的重试次数
retry_interval: 20 # 重试间隔,单位:ms
#共识配置
consensus:
# 共识类型(0-SOLO,1-TBFT,2-MBFT,3-HOTSTUFF,4-RAFT,5-DPOS)
type: 1
# 共识节点列表,组织必须出现在trust_roots的org_id中,每个组织可配置多个共识节点,节点地址采用libp2p格式
nodes:
- org_id: "wx-org1.chainmaker.org"
node_id:
- "QmZcFcJFYYoZ3FNNGL88QaszUZwFwuBdFqYh6yPzJURc3s"
- org_id: "wx-org2.chainmaker.org"
node_id:
- "QmXwtuPemSgH5ypzoKvcLdCLbd9jZ25FbpNf7VPjHF3HMS"
- org_id: "wx-org3.chainmaker.org"
node_id:
- "QmRmQLHJoqAYGkuLFaNY6HLzwtTNxr45UJsYpSjdKvBQw2"
- org_id: "wx-org4.chainmaker.org"
node_id:
- "QmURUHTGsuzzjgh1Xg6s92G1Q3gK91A6JEZGPfYNWwJMiT"
ext_config: # 扩展字段,记录难度、奖励等其他类共识算法配置
- key: aa
value: chain01_ext11
# 信任组织和管理员公钥
trust_roots:
- org_id: "wx-org1.chainmaker.org"
root:
- "../config-pk/permissioned-with-key/wx-org1/public-key/admin/wx-org1.chainmaker.org/admin.pem"
- org_id: "wx-org2.chainmaker.org"
root:
- "../config-pk/permissioned-with-key/wx-org1/public-key/admin/wx-org2.chainmaker.org/admin.pem"
- org_id: "wx-org3.chainmaker.org"
root:
- "../config-pk/permissioned-with-key/wx-org1/public-key/admin/wx-org3.chainmaker.org/admin.pem"
- org_id: "wx-org4.chainmaker.org"
root:
- "../config-pk/permissioned-with-key/wx-org1/public-key/admin/wx-org4.chainmaker.org/admin.pem"
# 权限配置(只能整体添加、修改、删除)
resource_policies:
- resource_name: CHAIN_CONFIG-NODE_ID_UPDATE
policy:
rule: SELF # 规则(ANY,MAJORITY...,全部大写,自动转大写)
org_list: # 组织名称(组织名称,区分大小写)
role_list: # 角色名称(role,自动转大写)
- admin
- resource_name: CHAIN_CONFIG-TRUST_ROOT_ADD
policy:
rule: MAJORITY
org_list:
role_list:
- admin
- resource_name: CHAIN_CONFIG-CERTS_FREEZE
policy:
rule: ANY
org_list:
role_list:
- admin
节点配置文件说明
配置文件:chainmaker.yml
auth_type:身份模式
permissionedWithKey:面向强权限控制场景,基于公钥的用户标识体系、基于角色的权限控制体系。
node:节点配置
priv_key_file:节点私钥地址
cert_file:不需要配置
net:网络配置
tls:TLS配置
priv_key_file:节点私钥地址
cert_file:不需要配置
注:node和net里需要配置同一个私钥的地址。
节点配置文件示例
auth_type: "permissionedWithKey" # permissionedWithCert / permissionedWithKey / public
log:
config_file: ../config-pk/permissioned-with-key/wx-org1/log.yml # config file of logger configuration.
blockchain:
- chainId: chain1
genesis: ../config-pk/permissioned-with-key/wx-org1/chainconfig/bc1.yml
node:
# 节点类型:full
type: full
org_id: wx-org1.chainmaker.org
priv_key_file: ../config-pk/permissioned-with-key/wx-org1/public-key/node/consensus1/consensus1.key
signer_cache_size: 1000
cert_cache_size: 1000
net:
provider: liquid
listen_addr: /ip4/0.0.0.0/tcp/11351
seeds:
- "/ip4/127.0.0.1/tcp/11351/p2p/QmZcFcJFYYoZ3FNNGL88QaszUZwFwuBdFqYh6yPzJURc3s"
- "/ip4/127.0.0.1/tcp/11352/p2p/QmXwtuPemSgH5ypzoKvcLdCLbd9jZ25FbpNf7VPjHF3HMS"
- "/ip4/127.0.0.1/tcp/11353/p2p/QmRmQLHJoqAYGkuLFaNY6HLzwtTNxr45UJsYpSjdKvBQw2"
- "/ip4/127.0.0.1/tcp/11354/p2p/QmURUHTGsuzzjgh1Xg6s92G1Q3gK91A6JEZGPfYNWwJMiT"
tls:
enabled: true
priv_key_file: ../config-pk/permissioned-with-key/wx-org1/public-key/node/consensus1/consensus1.key
# Transaction pool settings
# Other txpool settings can be found in tx_Pool_config.go
txpool:
# tx_pool type, can be single, normal, batch.
# By default the tx_pool type is normal.
# Note: please delete dump_tx_wal folder in storage.store_path when change tx_pool type
pool_type: "normal"
# Max common transaction count in tx_pool.
# If tx_pool is full, the following transactions will be discarded.
max_txpool_size: 50000
# Max config transaction count in tx_pool.
max_config_txpool_size: 10
# Whether dump unpacked config and common transactions in queue when stop node,
# and replay these transactions when restart node.
is_dump_txs_in_queue: true
# Common transaction queue num, only for normal tx_pool.
# Note: the num should be an exponent of 2 and less than 256, such as, 1, 2, 4, 8, 16, ..., 256
common_queue_num: 8
# The number of transactions contained in a batch, for normal and batch tx_pool.
# Note: make sure that block.block_tx_capacity in bc.yml is an integer multiple of batch_max_size
batch_max_size: 100
# Interval of creating a transaction batch, for normal and batch tx_pool, in millisecond(ms).
batch_create_timeout: 50
rpc:
provider: grpc
port: 12301
tls:
# TLS模式:
# disable - 不启用TLS
# oneway - 单向认证
# twoway - 双向认证
#mode: disable
#mode: oneway
mode: disable
monitor:
enabled: false
port: 14321
pprof:
enabled: false
port: 24321
storage:
store_path: ../data/org1/ledgerData1
blockdb_config:
provider: leveldb
leveldb_config:
store_path: ../data/org1/blocks
statedb_config:
provider: leveldb
leveldb_config:
store_path: ../data/org1/state
historydb_config:
provider: leveldb
leveldb_config:
store_path: ../data/org1/history
resultdb_config:
provider: leveldb
leveldb_config:
store_path: ../data/org1/result
disable_contract_eventdb: true #是否禁止合约事件存储功能,默认为true,如果设置为false,需要配置mysql
contract_eventdb_config:
provider: sql #如果开启contract event db 功能,需要指定provider为sql
sqldb_config:
sqldb_type: mysql #contract event db 只支持mysql
dsn: root:password@tcp(127.0.0.1:3306)/ #mysql的连接信息,包括用户名、密码、ip、port等,示例:root:admin@tcp(127.0.0.1:3306)/
debug:
# 是否开启CLI功能,过度期间使用
is_cli_open: true
is_http_open: false
Public
链配置文件说明
配置文件:bc.yml
auth_type:身份模式
public:面向弱权限控制场景,基于公钥的用户标识体系、基于角色的权限控制体系。
consensus:共识配置
nodes:共识节点列表
TBFT共识模式需要配置共识节点列表,DPOS共识模式不需要配置。
trust_roots:信任根配置列表
默认只使用列表下第一个配置
org_id:public模式配置标识(需要填写public)
org_id: "public"
root:链管理员公钥所在路径列表
链配置文件示例
chain_id: chain1 # 链标识
version: v1.0.0 # 链版本
sequence: 0 # 配置版本
auth_type: "public" # 认证类型 permissionedWithCert / permissionedWithKey / public
crypto:
hash: SHA256
# 合约支持类型的配置
contract:
enable_sql_support: false
# 交易、区块相关配置
block:
tx_timestamp_verify: true # 是否需要开启交易时间戳校验
tx_timeout: 600 # 交易时间戳的过期时间(秒)
block_tx_capacity: 100 # 区块中最大交易数
block_size: 10 # 区块最大限制,单位MB
block_interval: 2000 # 出块间隔,单位:ms
# core模块
core:
tx_scheduler_timeout: 10 # [0, 60] 交易调度器从交易池拿到交易后, 进行调度的时间
tx_scheduler_validate_timeout: 10 # [0, 60] 交易调度器从区块中拿到交易后, 进行验证的超时时间
consensus_turbo_config:
consensus_message_turbo: false # 是否开启共识报文压缩
retry_time: 500 # 根据交易ID列表从交易池获取交易的重试次数
retry_interval: 20 # 重试间隔,单位:ms
#共识配置
consensus:
# 共识类型(0-SOLO,1-TBFT,2-MBFT,3-HOTSTUFF,4-RAFT,5-DPOS)
type: 5
ext_config: # 扩展字段,记录难度、奖励等其他类共识算法配置
- key: aa
value: chain01_ext11
dpos_config: # DPoS
#ERC20合约配置
- key: erc20.total
value: "10000000"
- key: erc20.owner
value: "6CeSsjU5M62Ee3Gx9umUX6nXJoaBkWYufQdTZqEJM5di"
- key: erc20.decimals
value: "18"
- key: erc20.account:DPOS_STAKE
value: "10000000"
#Stake合约配置
- key: stake.minSelfDelegation
value: "2500000"
- key: stake.epochValidatorNum
value: "4"
- key: stake.epochBlockNum
value: "10"
- key: stake.completionUnbondingEpochNum
value: "1"
- key: stake.candidate:6CeSsjU5M62Ee3Gx9umUX6nXJoaBkWYufQdTZqEJM5di
value: "2500000"
- key: stake.candidate:F5tJ4ca4vdbuyffpc1Szw3WHU3caGaTVAh52MRMS4qBt
value: "2500000"
- key: stake.candidate:FxfunVWGkKgYMjngxMtLkd4pUNYVNAHNAqiDqopg5zdw
value: "2500000"
- key: stake.candidate:DYt7DfcZnqKNpjgyJ6tU6GFixNfLMkkmnqdwB3NNiAP7
value: "2500000"
- key: stake.nodeID:6CeSsjU5M62Ee3Gx9umUX6nXJoaBkWYufQdTZqEJM5di
value: "QmZcFcJFYYoZ3FNNGL88QaszUZwFwuBdFqYh6yPzJURc3s"
- key: stake.nodeID:F5tJ4ca4vdbuyffpc1Szw3WHU3caGaTVAh52MRMS4qBt
value: "QmXwtuPemSgH5ypzoKvcLdCLbd9jZ25FbpNf7VPjHF3HMS"
- key: stake.nodeID:FxfunVWGkKgYMjngxMtLkd4pUNYVNAHNAqiDqopg5zdw
value: "QmRmQLHJoqAYGkuLFaNY6HLzwtTNxr45UJsYpSjdKvBQw2"
- key: stake.nodeID:DYt7DfcZnqKNpjgyJ6tU6GFixNfLMkkmnqdwB3NNiAP7
value: "QmURUHTGsuzzjgh1Xg6s92G1Q3gK91A6JEZGPfYNWwJMiT"
# 超级管理员
trust_roots:
- org_id: "public"
root:
- "../config-pk/public/admin/admin1/admin1.pem"
- "../config-pk/public/admin/admin2/admin2.pem"
- "../config-pk/public/admin/admin3/admin3.pem"
- "../config-pk/public/admin/admin4/admin4.pem"
节点配置文件说明
配置文件:chainmaker.yml
auth_type:身份模式
public:面向弱权限控制场景,基于公钥的用户标识体系、基于角色的权限控制体系。
node:节点配置
priv_key_file:节点私钥地址
cert_file:不需要配置
net:网络配置
tls:TLS配置
priv_key_file:节点私钥地址
cert_file:不需要配置
注:node和net里需要配置同一个私钥的地址。
节点配置文件示例
auth_type: "public" # permissionedWithCert / permissionedWithKey / public
log:
config_file: ../config-pk/public/node/node1/log.yml # config file of logger configuration.
blockchain:
- chainId: chain1
genesis: ../config-pk/public/node/node1/chainconfig/bc1.yml
node:
# 节点类型:full
type: full
org_id: wx-org1.chainmaker.org
priv_key_file: ../config-pk/public/node/node1/node1.key
signer_cache_size: 1000
cert_cache_size: 1000
net:
provider: LibP2P
listen_addr: /ip4/0.0.0.0/tcp/11351
seeds:
- "/ip4/127.0.0.1/tcp/11351/p2p/QmZcFcJFYYoZ3FNNGL88QaszUZwFwuBdFqYh6yPzJURc3s"
- "/ip4/127.0.0.1/tcp/11352/p2p/QmXwtuPemSgH5ypzoKvcLdCLbd9jZ25FbpNf7VPjHF3HMS"
- "/ip4/127.0.0.1/tcp/11353/p2p/QmRmQLHJoqAYGkuLFaNY6HLzwtTNxr45UJsYpSjdKvBQw2"
- "/ip4/127.0.0.1/tcp/11354/p2p/QmURUHTGsuzzjgh1Xg6s92G1Q3gK91A6JEZGPfYNWwJMiT"
tls:
enabled: true
priv_key_file: ../config-pk/public/node/node1/node1.key
# Transaction pool settings
# Other txpool settings can be found in tx_Pool_config.go
txpool:
# tx_pool type, can be single, normal, batch.
# By default the tx_pool type is normal.
# Note: please delete dump_tx_wal folder in storage.store_path when change tx_pool type
pool_type: "normal"
# Max common transaction count in tx_pool.
# If tx_pool is full, the following transactions will be discarded.
max_txpool_size: 50000
# Max config transaction count in tx_pool.
max_config_txpool_size: 10
# Whether dump unpacked config and common transactions in queue when stop node,
# and replay these transactions when restart node.
is_dump_txs_in_queue: true
# Common transaction queue num, only for normal tx_pool.
# Note: the num should be an exponent of 2 and less than 256, such as, 1, 2, 4, 8, 16, ..., 256
common_queue_num: 8
# The number of transactions contained in a batch, for normal and batch tx_pool.
# Note: make sure that block.block_tx_capacity in bc.yml is an integer multiple of batch_max_size
batch_max_size: 100
# Interval of creating a transaction batch, for normal and batch tx_pool, in millisecond(ms).
batch_create_timeout: 50
rpc:
provider: grpc
port: 12301
tls:
# TLS模式:
# disable - 不启用TLS
# oneway - 单向认证
# twoway - 双向认证
#mode: disable
#mode: oneway
mode: disable
monitor:
enabled: false
port: 14321
pprof:
enabled: false
port: 24321
storage:
store_path: ../data/node1/ledgerData1
blockdb_config:
provider: leveldb
leveldb_config:
store_path: ../data/node1/blocks
statedb_config:
provider: leveldb
leveldb_config:
store_path: ../data/node1/state
historydb_config:
provider: leveldb
leveldb_config:
store_path: ../data/node1/history
resultdb_config:
provider: leveldb
leveldb_config:
store_path: ../data/node1/result
disable_contract_eventdb: true #是否禁止合约事件存储功能,默认为true,如果设置为false,需要配置mysql
contract_eventdb_config:
provider: sql #如果开启contract event db 功能,需要指定provider为sql
sqldb_config:
sqldb_type: mysql #contract event db 只支持mysql
dsn: root:password@tcp(127.0.0.1:3306)/ #mysql的连接信息,包括用户名、密码、ip、port等,示例:root:admin@tcp(127.0.0.1:3306)/
debug:
# 是否开启CLI功能,过度期间使用
is_cli_open: true
is_http_open: false
角色与权限管理
角色类型
长安链中,定义了以下几种角色类型:
共识节点
consensus
:有权参与区块共识流程的链上节点;同步节点
common
:无权参与区块共识流程,但可在链上同步数据的节点;管理员
admin
:可代表组织进行链上治理的用户;普通用户
client
:无权进行链上治理,但可发送和查询交易的用户;轻节点用户
light
:无权进行链上治理,无权发送交易,只可查询、订阅自己组织的区块、交易数据,属于SPV轻节点用户(详情见轻节点)。
权限定义
长安链采用三段式语法定义资源的访问权限:规则 (rule
)、组织列表 (orgList
)、角色列表 (roleList
)
规则:以关键字的形式描述了需要多少个组织的用户共同认可才可访问资源,合法的规则包括:
ALL
:要求orgList
列表中所有组织参与,每个组织至少提供一个符合roleList
要求角色的签名;ANY
:要求orgList
列表中任意一个组织提供符合roleList
要求角色的签名;MAJORITY
:要求联盟链中过半数组织提供各自admin
角色的签名;一个以字符串形式表达的整数 (e.g. “3”):要求
orgList
列表中大于或等于规定数目的组织提供符合roleList
要求角色的签名;一个以字符串形式表达的分数 (e.g. “2/3”) :要求
orgList
列表中大于或等于规定比例的组织提供符合roleList
要求角色的签名;SELF
:要求资源所属的组织提供符合roleList
要求角色的签名,在此关键字下,orgList
中的组织列表信息不生效,该规则目前只适用于修改组织根证书、修改组织共识节点地址这两个操作的权限配置;FORBIDDEN
:此规则表示禁止所有人访问,在此关键字下,orgList
和roleList
不生效。
组织列表:合法的组织列表集合,组织需出现在配置文件的
trust root
中,若为空则默认出现在trust root
中的所有组织;角色列表:合法的角色列表集合,若为空则默认所有角色。
示例如下:
权限定义 | 说明 |
---|---|
ALL [org1, org2, org3] [admin, client] |
三个组织各自提供至少一个管理员或普通用户提供签名才可访问对应资源 |
1/2 [] [admin] |
链上所有组织中过半数组织的管理员提供签名才可访问对应资源(自定义版本的MAJORITY 规则) |
SELF [] [admin] |
资源所属组织的管理员提供签名才可访问对应资源,例如组织管理员有权修改各自组织的根证书 |
资源定义
长安链中,资源名称的定义采用 [合约名称]-[方法名称] 的规则。
例如:
修改链上配置的系统合约 CHAIN_CONFIG ,该合约包含添加根证书的方法 TRUST_ROOT_ADD,如果要修改该方法的权限,对应的资源名称为:CHAIN_CONFIG-TRUST_ROOT_ADD。
CHAIN_CONFIG-TRUST_ROOT_ADD对应的默认权限定义是
{MAJORITY [] [ADMIN]}
则表示添加根证书操作需要客户端交易满足半数以上组织管理员多签,才能验证通过。
长安链提供了许多默认的资源权限定义, 具体参考:身份权限管理