# Installation

1# npm
2npm install @solongate/sdk@latest
3
4# yarn
5yarn add @solongate/sdk@latest
6
7# pnpm
8pnpm add @solongate/sdk@latest

1# .env
2# Get your keys from: https://solongate.com → Dashboard → Projects
3# IMPORTANT: Never commit this file to git!
4
5# Live key — connects to api.solongate.com for policy sync + audit logging
6SOLONGATE_API_KEY=sg_live_your_key_here
7
8# Test key — offline mode, no API connection (for development)
9# SOLONGATE_API_KEY=sg_test_your_key_here

1import { SolonGate } from '@solongate/sdk';
2
3// Initialize — reads SOLONGATE_API_KEY from .env automatically
4const gate = new SolonGate({ name: 'my-app' });
5
6// Validate a tool call
7const result = await gate.executeToolCall(
8  { name: 'file_read', arguments: { path: '/data/doc.txt' } },
9  async () => ({ content: [{ type: 'text', text: '...' }] }),
10);
11
12console.log(result); // tool result or policy denial

1import {
2  SolonGateAPI,      // Cloud API client
3  SolonGate,         // Local policy engine
4  PolicyEngine,      // Policy evaluation
5  TrustLevel,        // UNTRUSTED | VERIFIED | TRUSTED
6  Permission,        // READ | WRITE | EXECUTE
7  RateLimiter,       // Rate limiting
8  TokenIssuer,       // Capability tokens
9  ServerVerifier,    // Request verification
10} from '@solongate/sdk';