Bienvenida

Primeros Pasos

Guías rápidas para distintos escenarios de integración.

Integración API

Comienza a usar la API de ACTA para emitir y verificar credenciales:

  1. Elegir red: Testnet (recomendada para desarrollo) o Mainnet
  2. Obtener una API key: Todas las rutas /contracts/* requieren el header X-ACTA-Key (ver )
  3. Emitir credenciales: Usa el endpoint POST /contracts/vc/issue
  4. Verificar credenciales: Usa POST /contracts/vault/verify-vc

Para URLs base y el mapa completo de endpoints, abre . Para comprobar que el servicio responde, usa (incluye un GET /health en vivo desde el navegador).

Integración SDK de credenciales

Para aplicaciones React / Next.js:

  1. Instalar:
npm install @acta-team/credentials
  1. Provider: Envuelve tu árbol con `ActaConfig` (baseURL, apiKey opcional; ver Resumen del SDK de credenciales).
  2. Hooks: useCredential, useVault, useVaultRead, y `useActaClient` si necesitas el cliente HTTP directamente.

Consulta y las páginas de cada hook.

Integración de wallet

Conecta wallets de Stellar para autenticación de usuarios y firma de transacciones:

  1. UI de wallet: integra un adaptador Stellar; Stellar Wallets Kit cubre Freighter, Albedo, WalletConnect y más.
  2. Conectar wallet: el usuario conecta Freighter u otra wallet compatible.
  3. Firmar transacciones: usa los endpoints de preparación de ACTA en y ; tu callback signTransaction firma el XDR sin firmar que devuelve la API.

Configuración Testnet

Antes de desplegar a mainnet:

  1. Obtener XLM de testnet: usa Stellar Lab (fondear cuenta) o los recursos de testnet de Stellar.
  2. Probar operaciones: emite, almacena y verifica credenciales de prueba contra testnet (ver ).
  3. Verificar contratos: los IDs de testnet vienen preconfigurados con la URL base de testnet de la API.

Siguientes pasos

  • - todos los endpoints públicos
  • y - payloads y ejemplos
  • - códigos on-chain
  • - dudas habituales