Backend Verification

As best practice, we strongly recommend verifying proofs generated from client-side SDKs with a Reclaim Protocol Backend SDK.

Step-by-Step Guide

1. Install the SDK

Make sure you have installed the SDKs by following the instructions on the Installation page.

2. Prepare your variables

You will need to have the APPLICATION_ID and APPLICATION_SECRET from dev.reclaimprotocol.org.
You will also need to add providers to your application, keep the PROVIDER_ID handy too.
The providers you add to the application, will be the providers you will be able to ask the user to generate a proof for.
Make sure you add to your Application from the dev tool.

3. Get request URL from Backend SDK

Set the useAppClip option to true when initializing proof request: ReclaimProofRequest.init.
Get the request_url by calling getRequestUrl method on proof request object.

import { ReclaimProofRequest } from '@reclaimprotocol/js-sdk';
 
app.get('/reclaim/request', async (req: any, res: any) => {
    try {
        const reclaimProofRequest = await ReclaimProofRequest.init(APPLICATION_ID, APPLICATION_SECRET, PROVIDER_ID, { useAppClip: true })
 
        const request_url = await reclaimProofRequest.getRequestUrl()
 
        return res.json({ request_url })
    } catch (error) {
        console.error('Error generating request config:', error)
        return res.status(500).json({ error: 'Failed to generate request config' })
    }
});

4. Generate proof on client mobile

Your native mobile application should use the request_url from the backend and start verification with this url.

Start verification with request_url using the following sample code:

let result = try await ReclaimVerification.startVerification(.url(requestUrl))

Send result.proofs to the backend for verification and further processing

5. Verify proofs at backend

Mobile application (client) should send the proof to your backend for verification and then processing.
Use verifyProof from the reclaim backend sdk for verifying the proof received from the client.

import { verifyProof } from '@reclaimprotocol/js-sdk';
 
app.post('/reclaim/verify', async (req: any, res: any) => {
    try {
        const data = req.body; // json object/array as body
        const is_valid = await verifyProof(data);
 
        if (is_valid) {
            return res.json({ is_valid: is_valid })
        }
        return res.status(400).json({ is_valid: is_valid })
    } catch (error) {
        console.error('Error verifying proof:', error)
        return res.status(500).json({ error: 'Failed to verify proof' })
    }
})