ZkRouting SDK
Anonymous routing for every FRC20 transfer
Introduction
Privacy-Routing-SDK
provides simple and integration-friendly APIs for converting FRC20 transfers into anonymous transfers that break the link between senders and receivers. With just a small modification to your DApp's frontend, you can enhance your DeFi, Lending, or other project with privacy features.
How It Works
Privacy-Routing-SDK
is powered by zero-knowledge proof technology, allowing for the link between senders and receivers to be broken. The transfer can be completed in just four API calls
depositFRC20()
to deposit FRC20 tokens as a native asset in the ZK layer.barToAbar()
to wrap the native asset in an anonymous asset.abarTobar()
to unwrap the anonymous asset back to its native form.barToEVM()
to withdraw the native asset back to the EVM.
Note: In Findora's native chain, transparent assets are represented as BAR, while shielded assets are represented as ABAR.
The privacy routing process starts with funds being transferred from the sender's EVM address to the privacy layer for privacy shielding, and then back to the receiver's EVM address. During the privacy routing process, one-time receiver addresses are dynamically created and the asset passes through the privacy layer. The key steps are barToAbar()
and abarTobar()
, where the asset is wrapped and unwrapped using one-time stealth addresses, thereby breaking the link between the sender and receiver. The next version of the Privacy-Routing-SDK will simplify the process even further by consolidating multiple API calls into one or two calls to reduce complexity.
Quickstart Tutorial
Developers can take a look at the Privacy-Routing-SDK
example on Github.
Note: Privacy-Routing-SDK is now available only on the Findora Forge Testnet. See network settings for RPC details and request Forge EVM testnet FRA
tokens here.
DeFi Integration
The Findora Privacy-Routing-SDK
is designed as a general tool for FRC20 tokens and can be integrated into various projects in different ways. In the context of DeFi, the simplest way to integrate the SDK is by adding it to the frontend without modifying the smart contracts.
As an example, let's consider PancakeSwap and a scenario where a user wants to swap 10 USDT to 9.98 USDC on the frontend page. The following are the adjusted steps for this scenario
Step 1: Routing:
User address is:
0x661746C36C4379B5994d9883f3bFf662b711Be76
Call
depositFRC20()
to deposit 10 USDT as a native asset in the privacy layer.Call
barToAbar()
to wrap the native asset (10 USDT) in an anonymous asset.Call
abarTobar()
to unwrap the anonymous asset (10 USDT) back to its native form.Call
barToEVM()
to withdraw the native asset (10 USDT) back to an EVM one-time address.One-time receiver is:
0x7366F30D830048dFD947662d92421807bcB7Fdd3
Upon completion of the privacy routing process, the link between the user address and the one-time receiver address holding 10 USDT is cut off.
Step 2: Swap:
Switches to one-time receiver account:
0x7366F30D830048dFD947662d92421807bcB7Fdd3
.Performs a normal swap of 10 USDT to 9.98 USDC.
Final receiver address doesn’t really matter. It could be the original user address
0x661746C36C4379B5994d9883f3bFf662b711Be76
, or it could be a different address.
The private swap is now complete.
Simple Steps to Use
First clone and add the SDK to your project. You can also use package managers.
Copy https://github.com/FindoraNetwork/wasm-js-bindings/tree/forge_2022 contents to `external_resources/findora-wallet-wasm` in your project directory
Download Download ZIP
"findora-wallet-wasm": "./external_resources/findora-wallet-wasm"
in package.json. Example https://github.com/FindoraNetwork/privacy-routing-sdk-example/tree/main/external_resources/findora-wallet-wasm
Import SDK
Initiate SDK
Forge Testnet Configuration
The APIs
Generate the temp wallets for intermediate accounts,
Using Privacy-Routing-SDK
for a complete anonymous routing in 4 steps
(1) Send assets From
Findora EVM
toFindora Native Chain
Send FRA token to Findora Native Chain
Send FRC20 token to Findora Native Chain
(2) Convert assets from
BAR
toABAR
in Findora Native Chain (entering anonymous cycle)
(3) Convert assets from
ABAR
toBAR
in Findora Native Chain (leaving anonymous cycle)
(4) Withdraw assets from
Findora Native Chain
toFindora EVM
Withdraw FRA token to Findora EVM
Withdraw FRC20 token to Findora EVM
Boilerplate settings
Last updated