dApp Guide
Using zkp.services is simple. All available services are accessible through the dashboard once you have set up your account. Onboarding to new chains simply involves selecting a new chain from a dropdown, however the other services are slightly more involved and are covered in more detail in this guide.
- Securely request a data snapshot and leverage custom MFA if needed.
- Securely request a data update from another user or a smart device and leverage custom MFA if needed.
- Back up your data with Web2/Web3 providers, including CCIP or EVM-compatible chains.
Request Data
Before you get started, here are all the values you will need to Request Data:
| VALUE | DESCRIPTION |
|---|---|
| Request | This is the data field (e.g. "Medical Records") you want to request. |
| Key | A secure key to help decrypt data once you receive it. |
| Time Limit | Time in seconds before the recipient must respond to your data request. |
| 2FA Information (optional) | If you want added security, you can make it so that the responder has to undergo a 2FA requirement before responding. |
| Response fee | A data request will cost 10 ZKP tokens by default. If you require more ZKP tokens from whom you request data, increase the number. |
STEP 1: Initiate a data request
Once you are ready to initiate a data request, navigate to the dashboard. Here you will find the "Request Data" card. Click it to open a modal that will allow you to request data.
STEP 2: Fill out your data request
You will be presented with the form below. Below are brief descriptions covering each input you must complete before requesting data.
| INPUT | DESCRIPTION |
|---|---|
| Address of Receiver | The wallet address containing the requested data. |
| One Time Key | Once you have received the requested data, the one-time key will be used to access it. You can put in your own or generate a random one. Either way, make sure you save it somewhere. |
| Time Limit of Request | The time limit dictates how long your request will be active for the requestee to respond in seconds. |
| Require 2FA | If selected, the requestee must complete 2 Factor Authentication ("2FA") to respond to your request. An additional set of inputs will be included if you decide to attach 2FA to your request. |
| Set Response Fee | The response fee will be the number of ZKP tokens the requestee requires to answer your request. |
Once you have completed the form, clicking “Call Smart Contract” will initiate the data request.
STEP 3: Confirming your data request was sent
Once you have initiated the data request, you will see that request in your recent activity at the bottom of the dashboard. Navigate to the "Outgoing" tab, and you can check the status of your data request here.
Request Update
Before you get started, here are all the values you will need to request an Update to Data:
| VALUE | DESCRIPTION |
|---|---|
| Request | This is the data you want to update. |
| Key | A secure key to help decrypt data once you receive it. |
| Time Limit | Time in seconds before the recipient must respond to your data request. |
| 2FA Information (optional) | If you want added security, you can make it so that the responder has to undergo a 2FA requirement before responding. |
| Data Hash | A unique identifier for the data you want to update. |
| Salt Hash | A cryptographic salt to enhance data security. |
| Response fee | A data request will cost 10 ZKP tokens by default. If you require more ZKP tokens from whom you request data, increase the number. |
STEP 1: Initiate Update Request
Once you are ready to initiate an update data request, navigate to the Dashboard. Here you will find the "Request Update" card. Click it to open a modal that will allow you to request an update to data.
STEP 2: Fill out your update request form
You will be presented with the form below. Below are brief descriptions covering each input you must complete before requesting data.
| INPUT | DESCRIPTION |
|---|---|
| Address of Receiver | The wallet address containing the data you want updated. |
| Field to Update | Provide the data you want the receiver's data updated with. Please make sure to format it as you would a JSON payload. |
| One Time Key | The one-time key will be used to access the requested data once you have received it. You can put in your own or generate a random one. Either way, make sure you save it somewhere. |
| One Time Salt | Ipsum lorem. |
| Time Limit of Request | The time limit dictates how long your request will be active for the requestee to respond to in seconds. |
| Require 2FA | If selected, the requestee must complete 2 Factor Authentication ("2FA") to respond to your request. An additional set of inputs will be included if you decide to attach 2FA to your request. |
| Set Response Fee | The response fee will be the number of ZKP tokens the requestee requires to answer your request. |
Once you have completed the form, clicking “Call Smart Contract” will initiate the data request.
STEP 3: Request status and decryption
Once you have initiated the request to update data, you will see that request in your recent activity at the bottom of the dashboard. Navigate to the "Outgoing" tab, and you can check the status of your data request here. After the recipient approves your request, you can use your key and salt to verify the data has been changed.
Cross-Chain Backups
Backing up your data to another chain is easy.
STEP 1: Initiate a cross-chain sync
Navigate to the dashboard to find the "Cross-Chain Backups" card. Click it to open a modal that will allow you to request an update to data.
STEP 2: Fill out your cross-chain backup form
You will be presented with the form below. Below are brief descriptions covering each input you must complete before requesting data.
| INPUT | DESCRIPTION |
|---|---|
| Destination Chain | This is the chain you will be backing up your data to. |
| Parameter to Sync | Quick select a data value associated with your account and wallet. |
| Parameter Key | Ipsum lorem. |
| Parameter Value | Using the "Fetch Parameter Value" below, you will be able to generate the Parameter |
| CCIP Fee | There is a default fee of 10 ZKP tokens to back up your data onto another chain. |
STEP 3: Confirm your data has been backed up
Confirming your data has been backed up on the designated chain is as easy as swapping to that chain on your connected wallet, navigating to the Dashboard, and clicking the "Add Data" card to check the backed-up parameter, which should now be showing in the drop-down.