Skip to main content

Introduction

Provable offers a proof delegation service that accelerates the transaction generation time. This code snippet demonstrates how to use the Provable SDK to submit a proving request for a transaction that sends public Aleo credits to another Aleo account.

Obtain an API Key and JWT Token​

You will need an API key and JWT token in order to use the delegated proving service. Follow these steps:

1. Register consumer to get a key:​

curl -X POST -H "Content-Type: application/json" -d '{"username": "<your_username>"}' https://api.provable.com/consumers

2. Get a JWT:​

curl -X POST -H "X-Provable-API-Key: <your_key>" https://api.provable.com/jwts/<your_consumer_id>

The token will be in the Authorization header of the response.

3. Use the JWT for proving requests:​

For all requests to the prover, you will need to set your JWT as the Authorization header of the request.

Using the Delegated Proving Service in the Provable SDK​

The following template code will generate a proving request and send it to the delegated proving service. The transaction in the following example will send public Aleo credits to another Aleo account. In addition to the JWT token, you will need to supply an Aleo account private key for the sender along with a recipient's public Aleo address:

Estimating Fees

Before submitting a proving request, you can estimate the required fees using the SDK's fee estimation methods:

This helps ensure you set the correct baseFee value in your proving request.

import { Account, AleoKeyProvider, AleoNetworkClient, CREDITS_PROGRAM_KEYS, initThreadPool, NetworkRecordProvider, ProgramManager } from '@provablehq/sdk/testnet.js';

await initThreadPool();

const jwtToken = "YOUR_JWT_TOKEN"; // Obtained from step 2 above
const endpoint = "https://api.provable.com/prove/testnet/prove";


async function delegatedProvingExample() {
    // Create a temporary account for the execution of the program
    const account = new Account({privateKey: "YOUR_PRIVATE_KEY"});

    // Create a key provider in order to re-use the same key for each execution
    const keyProvider = new AleoKeyProvider();
    keyProvider.useCache(true);

    // Create a program manager to handle the proving requests
    const programManager = new ProgramManager("https://api.explorer.provable.com/v1");
    programManager.setKeyProvider(keyProvider);
    programManager.setAccount(account);


    // Build a proving request for the "transfer_public" function of "credits.aleo".
    // Note: You can estimate the baseFee using estimateExecutionFee() or estimateFeeForAuthorization()
    const provingRequest = await programManager.provingRequest({
        programName: "credits.aleo",
        functionName: "transfer_public",
        baseFee: 0.2, // Consider using estimateExecutionFee() to determine the correct fee
        priorityFee: 0,
        privateFee: false,
        inputs: [
            "RECEIVER_ADDRESS",
            "1000000u64",
        ],
        broadcast: true, //Set to true if you would like the delegated service to broadcast the transaction.
    });

    console.log("Submitting proving request...");
    // Submit the proving request to the network client.
    const provingResponse = await programManager.networkClient.submitProvingRequest({
        provingRequest: provingRequest,
        url: endpoint,
        apiKey: jwtToken, // Use JWT token as the API key
    });

    // Optional logging of the response
    console.log("Proving Response:", provingResponse);
}

await delegatedProvingExample();