BSN Testnet for Permissioned DApp Services — A Technical Guide

On October 31, the BSN R&D team completed the quarterly updates and launched the BSN Permissioned Blockchain Testnet. This Testnet provides a test environment for developers to test their permissioned decentralized applications (DApps). Developers now can publish an unlimited number of permissioned DApps in the BSN Testnet for FREE.

BSN’s mission is to allow blockchain technology to be accessible to any SME or individual by drastically reducing the cost associated with the development, deployment, operation, and maintenance of DApps. The Testnet provides exciting opportunities to anyone interested in adopting blockchain technology, thus driving the development of the technology and accelerating the scale and speed of the mass adoption.

To publish a permissioned DApp is to create a permissioned blockchain on BSN. For each chain, developers need to choose at least 3 peer nodes where they can deploy and run multiple smart contracts. The three peer nodes can be built on 1 to 3 public city nodes (PCNs), which normally BSN would charge resources fees for.

Without the BSN Testnet, developers need to build test environments to test their smart contracts prior to uploading them to the BSN, which could be difficult for many developers. In the Testnet environment, developers now can directly deploy their smart contracts on the test peer nodes and invoke these smart contracts via the PCN gateway. The Testnet currently supports Hyperledger Fabric and FISCO BCOS frameworks and will adopt other permissioned frameworks soon.

Based on the resource usage of the test network, the BSN R&D team may reset the network from time to time to clean up smart contracts and ledger data. Please DO NOT use the Testnet for production purposes.

We present a step by step guidance for developers to use the Testnet services.

1. Publish a permissioned DApp service

1) Log in to BSN International Portal

Go to, register, and log in.

2) Create a new test service

Go to Permissioned Services -> Testnet Services page to publish the service.

3) Click Create a Test Service and input the service name, version, and select the platform type.

4) Click Upload Chaincode Package to upload the chaincode or smart contract package. You can upload multiple chaincode/smart contract packages in a permissioned DApp service. Input the information and click confirm to upload the package.

5) Deploy the DApp service:

Click Start Deploying to deploy the service

2. Get parameters and test the DApp service

1) Click Testnet Services -> My Test Services, you can view the created Service Name, Version, Platform Type, Deployment Date, Status and Action.

2) Click Action -> Details. You can see My Certificate, Access URL, UserCode, AppCode, application chain name, chain code deployment name, main function path and chain code package information.

3) Copy the Access URL, Usercode, APPcode, as well as the Certificate and paste them in the off-BSN system in the appropriate place (here we use the official BSN Java SDK as an example), and then the system can call the API to test the smart contract.

For more detailed information on BSN Testnet, please go to BSN’s User Manual.

The Testnet in BSN International has also integrated the interchain services. A technical guide related to interchain services will follow up soon. We encourage all developers to try the Testnet services and provide us with feedback and suggestions. Please feel free to contact us anytime at



Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store

The BSN is a cross-cloud, cross-portal, cross-framework global infrastructure network used to deploy and operate all types of blockchain DApps.