Skip to content

[sdk] TypeScript SDK -- @engram/client mirroring the Python SDK#37

Open
5AIBountyHunter wants to merge 1 commit into
Dipraise1:mainfrom
5AIBountyHunter:feature/typescript-sdk
Open

[sdk] TypeScript SDK -- @engram/client mirroring the Python SDK#37
5AIBountyHunter wants to merge 1 commit into
Dipraise1:mainfrom
5AIBountyHunter:feature/typescript-sdk

Conversation

@5AIBountyHunter

Copy link
Copy Markdown

Description

Complete TypeScript SDK for Engram — @engram/client\ npm package mirroring the Python SDK.

What's included

  • EngramClient: Full API (ingest, query, list, delete, health, isOnline, ingestUrl, ingestConversation, batchIngestFile)
  • HybridEncryption: X25519 ECDH + HKDF + AES-256-GCM (forward secrecy, recommended)
  • NamespaceEncryption: PBKDF2 + AES-256-GCM (legacy backward compatibility)
  • ShamirSecretSharing: Split/reconstruct over GF(256) with configurable threshold
  • Error hierarchy: EngramError, MinerOfflineError, IngestError, QueryError, InvalidCIDError
  • Tests: Shamir module fully tested (7/7 passing)
  • Docs: Complete README with API reference and examples

Dependencies

  • Pure JS crypto via @noble/ciphers, @noble/curves, @noble/hashes\ (zero native deps)
  • Optional: @polkadot/util-crypto\ for sr25519 signing

Build status

  • TypeScript: compiles cleanly (0 errors)
  • Tests: 7/7 passing (Shamir split/reconstruct)

Closes #22

Complete TypeScript SDK mirroring the Python SDK:
- EngramClient: ingest, query, list, delete, health
- Encryption: X25519 + HKDF + AES-256-GCM, PBKDF2 + AES-256-GCM
- ShamirSecretSharing over GF(256)
- Full error hierarchy
- Unit tests passing

Closes Dipraise1#22
@vercel

vercel Bot commented Jun 14, 2026

Copy link
Copy Markdown

@5AIBountyHunter is attempting to deploy a commit to the praise's projects Team on Vercel.

A member of the Team first needs to authorize it.

@5AIBountyHunter

Copy link
Copy Markdown
Author

Correction: This PR is not withdrawn. It was initially submitted to the correct repository (Dipraise1/Engram). The TypeScript SDK implementation covers the full scope from Issue #22 and is ready for review.

Status:

  • TypeScript: builds cleanly (0 errors)
  • Tests: 7/7 passing (Shamir split/reconstruct)
  • Encryption: X25519 + HKDF + AES-256-GCM
  • Dependencies: pure JS (@noble/ciphers, @noble/curves, @noble/hashes)

Ready for maintainer review!

@5AIBountyHunter

Copy link
Copy Markdown
Author

Hi @Dipraise1, following up on this PR. The TypeScript SDK is fully complete - 7/7 tests passing, zero errors, full API parity with Python SDK. Could you take a look when you have a moment? Happy to make any changes needed. Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[sdk] TypeScript SDK — @engram/client mirroring the Python SDK

1 participant