kontext-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kontext / Legaci Labs Inc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,98 @@
+# @kontext/sdk
+
+Trust and compliance layer for agentic crypto workflows.
+
+Kontext provides structured action logging, tamper-evident audit trails, trust scoring, anomaly detection, and compliance tooling for AI agents operating in crypto and stablecoin ecosystems.
+
+## Install
+
+```bash
+npm install @kontext/sdk
+```
+
+## Quick Start
+
+```typescript
+import { Kontext } from '@kontext/sdk';
+
+// Initialize in local mode (no API key needed)
+const kontext = Kontext.init({
+  projectId: 'my-project',
+  environment: 'development',
+});
+
+// Log an agent action
+await kontext.log({
+  type: 'transfer',
+  description: 'Agent initiated USDC transfer',
+  agentId: 'payment-agent-1',
+});
+
+// Log a transaction with full chain details
+await kontext.logTransaction({
+  txHash: '0xabc...',
+  chain: 'base',
+  amount: '100',
+  token: 'USDC',
+  from: '0xSender...',
+  to: '0xReceiver...',
+  agentId: 'payment-agent-1',
+});
+
+// Get trust score for an agent
+const score = await kontext.getTrustScore('payment-agent-1');
+console.log(`Trust: ${score.score}/100 (${score.level})`);
+
+// Export audit data
+const audit = await kontext.export({ format: 'json' });
+
+// Verify digest chain integrity
+const verification = kontext.verifyDigestChain();
+console.log(`Chain valid: ${verification.valid}`);
+```
+
+## Features
+
+- **Action Logging** -- Structured logging for all agent actions with timestamps, correlation IDs, and metadata.
+- **Transaction Tracking** -- Full chain details for crypto transactions across Base, Ethereum, Polygon, Arbitrum, and Optimism.
+- **Tamper-Evident Digest Chain** -- Rolling SHA-256 digest chain that detects any modification to the audit trail.
+- **Trust Scoring** -- Rule-based trust scores for agents based on history, task completion, anomaly rate, and consistency.
+- **Anomaly Detection** -- Configurable rules for unusual amounts, frequency spikes, new destinations, off-hours activity, rapid succession, and round amounts.
+- **Task Confirmation** -- Evidence-based task tracking with required proof for completion.
+- **USDC Compliance** -- Pre-built compliance checks aligned with stablecoin regulatory requirements across all supported chains.
+- **CCTP Integration** -- Cross-chain transfer tracking for Circle's Cross-Chain Transfer Protocol with full lifecycle management.
+- **Webhook Notifications** -- Event-driven webhooks for anomalies, task updates, and trust score changes with retry logic.
+- **Audit Export** -- JSON and CSV export with date range and entity filtering.
+- **SAR/CTR Templates** -- Structured report templates for suspicious activity and currency transaction reporting.
+
+## Supported Chains
+
+| Chain    | USDC Contract | CCTP Domain |
+|----------|---------------|-------------|
+| Ethereum | 0xA0b8...eB48 | 0           |
+| Base     | 0x8335...2913 | 6           |
+| Polygon  | 0x3c49...3359 | 7           |
+| Arbitrum | 0xaf88...5831 | 3           |
+| Optimism | 0x0b2C...Ff85 | 2           |
+
+## Operating Modes
+
+- **Local mode** (no API key): All data stored in-memory and optionally written to local JSON files. Suitable for development and open-source usage.
+- **Cloud mode** (with API key): Data synced to Kontext API for persistent storage and advanced features.
+
+```typescript
+// Cloud mode
+const kontext = Kontext.init({
+  apiKey: 'sk_live_...',
+  projectId: 'my-project',
+  environment: 'production',
+});
+```
+
+## Documentation
+
+For full documentation, visit [getkontext.com](https://getkontext.com).
+
+## License
+
+MIT -- see [LICENSE](./LICENSE) for details.