Jul 25, 2021

5 min read

Develop on Findora’s Privacy-Preserving Blockchain Using BSN

Privacy is the next frontier of blockchain technology. With Findora, developers can build privacy-preserving applications that allow the masking of sensitive data (on the public transaction log) such as:

• amount sent

• asset type

Currently, the Findora has released a limited set of APIs to enable developers to experiment with the platform’s privacy-preserving, confidential transfer feature before full smart contract programmability is released in the upcoming months.

Accessing the Findora Network via the BSN

BSN has set up a node on Findora Testnet and Findora Mainnet. With BSN, you can enjoy the benefits of Findora’s network APIs without the cost and time expense of setting up your own Findora node.

By registering a BSN account and configuring it to access BSN’s Findora nodes, you’ll be able to access Findora APIs indirectly via BSN’s API end points. After configuration, an BSN Access Address will be provided to you from which you can indirectly call Findora’s native APIs.

Step 1: Register on BSN

Go to https://bsnbase.io and register a new account and sign in.

Step 2: Activate a Plan

In the BSN dashboard, select the “Permissionless Services” tab.

Find the desired geographic location for your node and click on the “Select Your plan” drop down menu to pick your plan. Select Free Plan and click the Buy button.

Next, click the Select button (under Free Plan box).

If successful, your dashboard appears as below:

Step 3: Create Findora Mainnet Project

In the activated plan and area, click the “Create New Project” button.

Enter your project name and choose the chain, “Findora-Mainnet”, and then click “Create

Project”.

If successful, your project will appear as below:

The Access Address column displays all BSN URLs available to indirectly access Findora Mainnet APIs.

To access an API end point on BSN, you’ll need a project key. Click the “…” (ellipses) and “Enable Key” to create and view your BSN project key. This project key can be used later on as a x-api-key in your API request to your BSN node.

Step 4: Call Findora API with RPC Node

To access the BSN endpoint, open an API testing tool like Postman and use your BSN project key as the x-api-key.

Go to https://api.findora.org/ to see a full list of Findora API endpoints. Here we demonstrate an example of viewing the ledger and submitting the transaction.

1. Check the global status and get transaction number by using restledger API:

-API:

global_state

-URI:

https://bsngatewayAddress/api/ProjectID/Findora-Mainnet/restledger/global_state

-Header

NONE

-Request get

-Response

2. Get a list of UTXO SIDs (wallet addresses), return an empty array representing insufficient funds in the wallet by using restquery API:

-API:

get_owned_utxos

-URI:

https://bsngatewayAddress/api/ProjectID/Findora-Mainnet/restquery/get_owned_utxos/SID

-Header

NONE

-Request get

-Response

3. Submit a transaction and return hash value by using restsubmit API:

-API:

Submit_transaction

-URI:

https://bsngatewayAddress/api/ProjectID/Findora-Mainnet/restsubmit/submit_transaction

-Header

NONE

-Request post

-Response

4. Query the transaction data, the head value is the hash value returned by calling submission_transaction. Use restexplorer API:

-API:

Tx_search

-URI:

https://bsngatewayAddress/api/ProjectID/Findora-Mainnet/restexplorer/tx_search

-Header

tx_search?query=”tx.prehash=’hashvalue’”

-Request post

-Response

Cool! You can now directly access to Findora network by the BSN instead of operating a Findora node.

About Findora

With Findora, developers can create custom assets, such as a fiat-backed stablecoin, and allow users to send/receive these custom assets without publicly revealing the amounts sent (or even the type of asset transferred).