For Developers

Integrate identity into your dApp

One API call. No backend required. Works with any wallet on Rialo.

FreeNo API Key Required

Quick Start

SDK source is in the /sdk folder. If you publish it as rialink-sdk, this snippet works as-is. The default SDK base URL is https://rialink-two.vercel.app.

JavaScriptPythoncURL

JavaScript

import { verifyWallet } from "rialink-sdk";

const result = await verifyWallet(
  "WALLET_ADDRESS"
);

if (result.valid) {
  // trusted user
}

Python

import requests
r = requests.get(
  'https://rialink-two.vercel.app/api/verify/WALLET_ADDRESS'
)
identity = r.json()

if identity['trustLevel'] == 'high':
    # grant access

cURL

curl https://rialink-two.vercel.app/api/verify/WALLET_ADDRESS

Live API Playground

Test real endpoints with a wallet address and inspect the exact JSON response.

Verify Response

{
  "hint": "Run verify to see response"
}

Policy Check Response

{
  "hint": "Run policy check to see response"
}

Gate access with policy checks

Request

POST /api/policy/check
Content-Type: application/json

{
  "wallet": "BqKJkx...f3Ht",
  "policy": "dao-grant",
  "requirements": {
    "platforms": ["github", "discord"],
    "minPlatforms": 2,
    "minRepoCount": 5,
    "maxProofAgeDays": 90
  }
}

Response

{
  "wallet": "BqKJkx...f3Ht",
  "policy": "dao-grant",
  "passed": true,
  "trustLevel": "high",
  "evaluatedAt": "2025-03-29T10:00:00Z",
  "checks": [
    { "requirement": "platforms", "required": ["github","discord"], "passed": true },
    { "requirement": "minPlatforms", "required": 2, "actual": 2, "passed": true },
    { "requirement": "minRepoCount", "required": 5, "actual": 47, "passed": true }
  ],
  "accessToken": "vm_[base64-encoded-payload]"
}

Use Cases

Access Gating

Gate airdrops, communities, and feature access to verified wallets in one call.

Sybil Resistance

Reduce multi-wallet farming by requiring signed, replay-resistant identity proofs.

Verified Badges

Show public proof-backed badges on profiles, dashboards, and contributor pages.

Bot Filtering

Reject low-trust or unverifiable wallets before they spam forms and APIs.

API Reference

Method	Path	Description
GET	/api/verify/[wallet]	Returns identity + trust level
POST	/api/policy/check	Evaluate policy requirements
POST	/api/policy/verify	Verify an access token

Rialo Integration

This API currently runs on Vercel infrastructure. When Rialo devnet launches, all proof storage and verification will move on-chain - making every proof permanent, auditable, and trustless. No API changes will be required for integrators.