Integração do Gateway
Documentação SDK Enterprise v1.1
A forma profissional de integrar identidade zkTLS. Nossa SDK v0.1.4 abstrai toda a complexidade de gerenciamento de sessões, criptografia no navegador e sincronização de créditos on-chain.
Recomendado
Zolvency SDK
Esqueça o gerenciamento manual de pop-ups (window.open) e interceptação complexa de eventos. Nossa SDK baseada em Promises e Contexto cuida de todo o ciclo de vida da verificação de forma assíncrona.
Execução Limpa
Vault Dinâmico
Unificação de Config
npm install @zolvency/sdk
Integração em 2 Passos
1Configurar & Executar
Envolva seu app com o ZolvencyProvider para centralizar as chaves e chame a verificação direta.
App.tsx
import { Zolvency, ZolvencyProvider } from "@zolvency/sdk";
// 1. Wrap your app (in layout.tsx)
<ZolvencyProvider
provider="RECLAIM_ID"
theme="dark"
>
{children}
</ZolvencyProvider>
// 2. Trigger verification
const result = await Zolvency.verify({
sessionId: "sess_123..."
});Fluxo de Autenticação
1
01
No Dashboard, obtenha seu Project ID e Client Secret (Chaves fixas).
2
02
Do seu Backend, chame a API de Sessão para gerar um sessionId único (Temporário).
3
03
No seu Frontend, passe o sessionId para o SDK para abrir o Gateway.
Referência de Parâmetros da SDK
| Propriedade | Tipo | Padrão | Descrição |
|---|---|---|---|
| sessionId | string | - | Obrigatório. O ID da sessão de verificação gerado no backend. |
| theme | 'light' | 'dark' | 'light' | Tema visual do gateway (light/dark). |
| provider | string | null | ID do provedor (ex: Reclaim ID) para pular a seleção e ir direto para o QR Code. |
| vaultAddress | string (G...) | null | Opcional. Endereço Stellar (G...) para débito customizado de créditos da sessão. |