Submitting and Verifying Claims

This tutorial walks you through how to submit a claim for verification on the VSL network using the vsl-cli. You’ll also learn how to check the status of your submitted claims.

This guide assumes you’ve already created and funded an account. If not, follow the Creating Accounts tutorial first.

Step 1: Enter REPL Mode

We’ll use REPL mode to make it easier to run multiple commands interactively:

vsl-cli repl --tmp-config

Step 2: Connect to a Network

You can use either a local node or connect to the remote VSL Devnet.

Option A: Use Local Node

If you’re running a local instance:

vsl> server:launch --db tmp --genesis-file "genesis.json"

Option B: Use Remote Devnet

vsl> network:add remote --url https://rpc.vsl.pi2.network
vsl> network:use remote

Check network health:

vsl> health:check

Step 3: Use an Active Account

Make sure your account is funded and active. If needed:

vsl> account:create alice
vsl> account:use alice

You can verify your balance:

vsl> account:balance

Step 4: Submit a Claim

To submit a claim, use the claim:submit command. Claims can contain anything verifiable such as identity info, transaction data, etc.

Here’s a basic example using identity data:

vsl> claim:submit '{"email": "[email protected]"}' --type identity --proof 0xabc123

• --type specifies the claim type (e.g., identity, kyc, bridge_transfer).

• --proof is any verifiable evidence, such as a hash or reference.

You can also specify a fee or expiration time using --fee and --lifetime.

Step 5: View Submitted Claims

To list all claims your active account has submitted:

vsl> claim:submitted

You can filter them based on time:

vsl> claim:submitted --within 3600  # Last hour

Step 6: Get Claim by ID (Optional)

If you want details for a specific claim:

vsl> claim:get <claim_id>

Replace <claim_id> with the actual claim hash.

Step 7: Settle a Verified Claim

After your claim is verified, you can request settlement using the claim:settle command. If you’re the only verifier required (and quorum is 1), the claim will be settled immediately.

vsl> claim:settle <claim_id>

Make sure the current account is one of the verifiers specified in the claim. If it is, the settlement request will be accepted.

Behind the scenes, the node waits for a quorum of verifiers to approve the claim. If that quorum is already satisfied (e.g. you're the only required verifier), it will be settled right away.

What’s Next?

In this tutorial, you've successfully submitted a claim, confirmed its presence on the network, and settled the claim.

From here, you can check out other tutorials such as the Retrieving Settled Claims tutorial to learn how to finalize verified claims.

Need help? Join our Discord to ask questions or share your progress.