Getting Started

Quick start guides for different integration scenarios.

API Integration

Start using the ACTA API to issue and verify credentials:

1. Choose Network: Testnet (recommended for development) or Mainnet
2. Get an API Key: All /contracts/* routes require an X-ACTA-Key header (see API Keys)
3. Issue Credentials: Use the POST /contracts/vc/issue endpoint
4. Verify Credentials: Use POST /contracts/vault/verify-vc

For base URLs and the full endpoint map, open API Overview. To confirm the service is up, use Health & Status (includes a live GET /health you can run in the browser).

Credentials SDK Integration

For React / Next.js applications:

1. Install:

npm install @acta-team/credentials

1. Provider: Wrap your tree with `ActaConfig` (pass baseURL, optional apiKey; see Credentials SDK Overview).
2. Hooks: useCredential, useVault, useVaultRead, and `useActaClient` when you need the HTTP client directly.

See Credentials SDK Overview and the hook pages for details.

Wallet Integration

Connect Stellar wallets for user authentication and transaction signing:

1. Wallet UI: Integrate a Stellar wallet adapter - Stellar Wallets Kit covers Freighter, Albedo, WalletConnect, and more.
2. Connect wallet: User connects Freighter or another supported Stellar wallet.
3. Sign transactions: Use ACTA’s transaction preparation endpoints from Vault Operations (Write) and Credential Operations; your signTransaction callback signs the unsigned XDR the API returns.

Testnet Setup

Before deploying to mainnet:

1. Get testnet XLM: Use Stellar Lab (fund account) or the testnet resources from Stellar.
2. Test operations: Issue, store, and verify test credentials against testnet (see API Overview).
3. Verify contracts: Testnet contract IDs are pre-configured when you use the testnet API base URL.

Next Steps

• API Overview - all public endpoints
• Credential Operations and Vault Operations (Read) - payloads and examples
• Contract errors - on-chain error codes
• FAQ - common questions