文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>腾讯云区块链服务平台 TBaaS>开发指南>应用系统对接>区块链 SDK 对接网络>长安链 SDK 对接网络>对接 v2.3.8 网络

对接 v2.3.8 网络

最近更新时间：2026-04-21 14:13:02

我的收藏

本页目录：

本文为您介绍如何使用长安链 SDK 对接 v2.3.8 版本的长安链网络，长安链网络版本可以从区块链网络概览页右下角的网络配置信息中查看。


下载 SDK

下载 chainmaker-sdk-go-demo，压缩包主要包含以下内容：
chainmaker-sdk-demo：目录。
config：目录，存放 SDK 配置文件，后续证书也可放置在该目录下。
config.yml：SDK 配置文件。
go：目录，为 Go 合约调用合约示例代码。
contract：目录，为 Go 合约安装包。
dfact.7z：文件，Go 合约安装包。
main.go：Go 合约调用合约示例代码。
rust-fact.wasm
solidity：目录，为 Solidity 合约调用合约示例代码。
contract：目录，为 Solidity 合约文件。
fact_manage.sol：文件，Solidity 合约文件
FactManageContract.bin：文件，Solidity 合约二进制文件
FactManageContract.abi：文件，Solidity 合约 ABI 文件
main.go：Solidity 合约调用合约示例代码。

操作步骤

查看长安链 SDK 配置文件

长安链 SDK 配置文件 config.yml 如下所示：
chain_client:
  # 链 ID
  chain_id: "chain_txtxt"
  # 组织 ID
  org_id: "orgtxtxtxt.chainmaker-txtxtxtxtx"
  # 客户端用户私钥路径
  user_key_file_path: "../config/user_ecc_tls.key"
  # 客户端用户证书路径
  user_crt_file_path: "../config/user_tls.crt"
  # 客户端用户交易签名私钥路径（若未设置，将使用 user_key_file_path)
  user_sign_key_file_path: "../config/user_ecc_sign.key"
  # 客户端用户交易签名证书路径（若未设置，将使用 user_crt_file_path)
  user_sign_crt_file_path: "../config/user_sign.crt"
  # 同步交易结果模式下，轮训获取交易结果时的最大轮训次数，删除此项或设为<=0 则使用默认值 10
  retry_limit: 10
  # 同步交易结果模式下，每次轮训交易结果时的等待时间，单位：ms 删除此项或设为<=0 则使用默认值 500
  retry_interval: 500

  nodes:
    - # 节点地址，格式为：IP: 端口：连接数
      node_addr: "orgtxtxtxt.chainmaker-txtxtxtxtx.tbaas.tech:8080"  #"外网域名：端口"
      # 节点连接数
      conn_cnt: 1
      # RPC 连接是否启用双向 TLS 认证
      enable_tls: true
      # 信任证书池路径，ca.crt 所在路径
      trust_root_paths:
        - "../config/"
      # TLS hostname
      tls_host_name: "consensus1-orgtxtxtxt.chainmaker-txtxtxtxtx"
  rpc_client:
    max_receive_message_size: 16 # grpc 客户端接收消息时，允许单条 message 大小的最大值 (MB)
    max_send_message_size: 16 # grpc 客户端发送消息时，允许单条 message 大小的最大值 (MB)

获取访问地址和链 ID

1. 登录 TBaaS 控制台。
2. 选择左侧导航栏中的长安链 > 区块链网络，进入“区块链网络”页面。
3. 在“区块链网络”页面中，选择需查看的网络，单击管理进入“网络概览”页面。
4. 在“网络基础信息”模块找到链 ID 和外网域名，分别填写到配置文件的 chain_id 和 node_addr 字段。

获取组织 ID

1. 单击组织与节点页签，进入“组织与节点”页面。
2. 找到当前组织 ID 信息，填写到配置文件的 org_id 字段。如下图所示：



获取节点名称

1. 在“组织与节点”页面单击节点管理，进入“节点管理”页面。
2. 找到当前组织的节点列表，选择一个节点并复制节点名称，填写到配置文件的 tls_host_name 字段。如下图所示：



申请证书

1. 根据 证书申请 CSR 生成指南，生成证书 CSR 和相应私钥。
2. 以生成非国密 ECC 证书为例，运行 ecccsr.sh 脚本将会得到以下四种文件：
user_ecc_sign.key：用户证书私钥。
user_ecc_sign.csr：用于在 TBaaS 控制台 申请用户证书。
user_ecc_tls.key：用户 tls 证书私钥。
user_ecc_tls.csr：用于在 TBaaS 控制台 申请用户 tls 证书。
3. 在“证书管理”界面添加申请证书，填写证书标识，并上传 user_ecc_sign.csr 和 user_ecc_tls.csr。如下图所示：


4. 申请成功后可以单击下载获取对应证书，压缩包包含如下文件：
ca.crt：组织根证书。
user_sign.crt：用户证书。
user_tls.crt：用户 tls 证书。



5. 将三个证书 ca.crt，user_sign.crt，user_tls.crt 和两个私钥 user_ecc_sign.key 和 user_ecc_tls.key 放置到 chainmaker-sdk-go-demo/chainmaker-sdk-demo/config 目录下。
6. 根据下表，修改 SDK 配置文件 config.yml 的证书路径和 CA 路径：
参数
值
说明
user_key_file_path
../config/user_ecc_tls.key
用户 tls 证书所对应私钥
user_crt_file_path
../config/user_tls.crt
用户 tls 证书
user_sign_key_file_path
../config/user_ecc_sign.key
用户证书所对应私钥
user_sign_crt_file_path
../config/user_sign.crt
用户证书
trust_root_paths
../config/
根 CA 证书 ca.crt 所在目录

部署合约

部署 wasm 合约

1. 单击合约管理页签，进入“合约管理”页面
2. 使用压缩包内的 dfact.7z 上传，并且进行如下配置：
合约名称：填写 dfact。
版本号：填写 v1.0。
执行环境：选择 Go。
初始化参数（选填）：保存为空。

3. 部署成功后，合约列表将会展示刚刚部署的合约。如下图所示：


部署 solidity 合约

1. 单击合约管理页签，进入“合约管理”页面
2. 使用压缩包内的 FactManageContract.abi, FactManageContract.bin 上传，并且进行如下配置：
合约名称：填写 sfact。
版本号：填写 v1.0。
执行环境：选择 Solidity。
初始化参数（选填）：保存为空。

3. 部署成功后，合约列表将会展示刚刚部署的合约。如下图所示：


运行 Demo

运行 Go 合约调用 demo

1. 进入 chainmaker-sdk-go-demo/go 目录。
2. 将 main.go 示例代码中的 claimContractName 修改为上述部署的合约的名字，示例如下：
var (
 claimContractName = "dfact"
)
3. 执行以下命令：
go run main.go ../config/config.yml
成功运行可以查看到如下图输出：


运行 EVM 合约调用 demo

1. 进入 chainmaker-sdk-go-demo/solidity 目录。
2. 将 main.go 示例代码中的 contractName 修改为上述部署的 evm 合约的名字，示例如下：
var (
 contractName = "sfact"
)
3. 执行以下命令：
go run main.go ../config/config.yml
成功运行可以查看到如下图输出：


更多对接方式

长安链提供了多种语言的 SDK，包括 Go SDK、Java SDK 等，方便开发者根据需求进行选用。更多详情请参见 长安链 SDK 开发指南。

中国站