@eva-protocol/sdk 0.0.1-beta.0

package/dist/src/utils/evidence.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Evidence input/output helpers for Seal + Walrus.
+ * Supports text and images (or any binary).
+ */
+/** Input formats for evidence (text, image, or binary). */
+export type EvidenceInput = string | Uint8Array | ArrayBuffer | {
+    type: 'base64';
+    data: string;
+} | {
+    type: 'base64';
+    data: string;
+    mimeType?: string;
+} | File | Blob;
+/**
+ * Convert evidence input to Uint8Array for Seal encrypt / Walrus upload.
+ * - string: plain text (UTF-8)
+ * - Uint8Array | ArrayBuffer: raw bytes
+ * - { type: 'base64', data: string }: base64-encoded (e.g. image from file)
+ * - File | Blob: binary (browser)
+ */
+export declare function evidenceToBytes(input: EvidenceInput): Promise<Uint8Array>;
+/**
+ * Decode decrypted bytes as UTF-8 text.
+ */
+export declare function evidenceBytesToText(bytes: Uint8Array): string;
+/**
+ * Detect image MIME type from magic bytes. Returns undefined if not recognized.
+ */
+export declare function detectImageMimeType(bytes: Uint8Array): string | undefined;
+/**
+ * Create a data URL for image display (e.g. img src).
+ * @param bytes - decrypted image bytes
+ * @param mimeType - optional; auto-detected from magic bytes if not provided
+ */
+export declare function evidenceBytesToImageDataUrl(bytes: Uint8Array, mimeType?: string): string;
+/** Multi-evidence payload structure (JSON). */
+export interface MultiEvidencePayload {
+    texts?: string[];
+    images?: Array<{
+        data: string;
+        mime?: string;
+    }>;
+}
+/** Build a single payload from multiple texts and images for encrypt/upload. */
+export declare function buildMultiEvidencePayload(texts?: string[], images?: Array<{
+    data: string;
+    mime?: string;
+}>): string;
+/** Parse decrypted multi-evidence payload. */
+export declare function parseMultiEvidencePayload(bytes: Uint8Array): MultiEvidencePayload;
+/** Convert parsed images (base64) to data URLs for display. */
+export declare function multiEvidenceImagesToDataUrls(images: Array<{
+    data: string;
+    mime?: string;
+}>): string[];
+//# sourceMappingURL=evidence.d.ts.map

package/dist/src/utils/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../../src/utils/evidence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,UAAU,GACV,WAAW,GACX;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,IAAI,GACJ,IAAI,CAAC;AAET;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CA4B/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE7D;AAeD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CASzE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CASxF;AAED,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,CACvC,KAAK,GAAE,MAAM,EAAO,EACpB,MAAM,GAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAM,GAClD,MAAM,CAKR;AAED,8CAA8C;AAC9C,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,UAAU,GAAG,oBAAoB,CAOjF;AAED,+DAA+D;AAC/D,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7C,MAAM,EAAE,CAKV"}

package/dist/src/utils/evidence.js

@@ -0,0 +1,114 @@
+/**
+ * Evidence input/output helpers for Seal + Walrus.
+ * Supports text and images (or any binary).
+ */
+/**
+ * Convert evidence input to Uint8Array for Seal encrypt / Walrus upload.
+ * - string: plain text (UTF-8)
+ * - Uint8Array | ArrayBuffer: raw bytes
+ * - { type: 'base64', data: string }: base64-encoded (e.g. image from file)
+ * - File | Blob: binary (browser)
+ */
+export async function evidenceToBytes(input) {
+    if (typeof input === 'string') {
+        return new TextEncoder().encode(input);
+    }
+    if (input instanceof Uint8Array) {
+        return input;
+    }
+    if (input instanceof ArrayBuffer) {
+        return new Uint8Array(input);
+    }
+    if (typeof input === 'object' && input !== null && 'type' in input && input.type === 'base64') {
+        const base64 = input.data;
+        const binary = atob(base64.replace(/^data:[^;]+;base64,/, ''));
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++) {
+            bytes[i] = binary.charCodeAt(i);
+        }
+        return bytes;
+    }
+    if (typeof File !== 'undefined' && input instanceof File) {
+        const buf = await input.arrayBuffer();
+        return new Uint8Array(buf);
+    }
+    if (typeof Blob !== 'undefined' && input instanceof Blob) {
+        const buf = await input.arrayBuffer();
+        return new Uint8Array(buf);
+    }
+    throw new Error('Unsupported evidence input type');
+}
+/**
+ * Decode decrypted bytes as UTF-8 text.
+ */
+export function evidenceBytesToText(bytes) {
+    return new TextDecoder().decode(bytes);
+}
+/** Image MIME types by magic bytes. */
+const IMAGE_SIGNATURES = [
+    { sig: [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a], mime: 'image/png' },
+    { sig: [0xff, 0xd8, 0xff], mime: 'image/jpeg' },
+    { sig: [0x47, 0x49, 0x46, 0x38, 0x37, 0x61], mime: 'image/gif' },
+    { sig: [0x47, 0x49, 0x46, 0x38, 0x39, 0x61], mime: 'image/gif' },
+    {
+        sig: [0x52, 0x49, 0x46, 0x46],
+        mime: 'image/webp',
+        check: (b) => b.length >= 12 && String.fromCharCode(b[8], b[9], b[10], b[11]) === 'WEBP',
+    },
+];
+/**
+ * Detect image MIME type from magic bytes. Returns undefined if not recognized.
+ */
+export function detectImageMimeType(bytes) {
+    if (bytes.length < 4)
+        return undefined;
+    for (const { sig, mime, check } of IMAGE_SIGNATURES) {
+        if (sig.length <= bytes.length && sig.every((b, i) => bytes[i] === b)) {
+            if (check && !check(bytes))
+                continue;
+            return mime;
+        }
+    }
+    return undefined;
+}
+/**
+ * Create a data URL for image display (e.g. img src).
+ * @param bytes - decrypted image bytes
+ * @param mimeType - optional; auto-detected from magic bytes if not provided
+ */
+export function evidenceBytesToImageDataUrl(bytes, mimeType) {
+    const mime = mimeType ?? detectImageMimeType(bytes) ?? 'image/png';
+    const chunkSize = 8192;
+    let binary = '';
+    for (let i = 0; i < bytes.length; i += chunkSize) {
+        binary += String.fromCharCode(...bytes.subarray(i, i + chunkSize));
+    }
+    const base64 = btoa(binary);
+    return `data:${mime};base64,${base64}`;
+}
+/** Build a single payload from multiple texts and images for encrypt/upload. */
+export function buildMultiEvidencePayload(texts = [], images = []) {
+    const payload = {};
+    if (texts.length > 0)
+        payload.texts = texts;
+    if (images.length > 0)
+        payload.images = images;
+    return JSON.stringify(payload);
+}
+/** Parse decrypted multi-evidence payload. */
+export function parseMultiEvidencePayload(bytes) {
+    const text = new TextDecoder().decode(bytes);
+    const parsed = JSON.parse(text);
+    return {
+        texts: parsed.texts ?? [],
+        images: parsed.images ?? [],
+    };
+}
+/** Convert parsed images (base64) to data URLs for display. */
+export function multiEvidenceImagesToDataUrls(images) {
+    return images.map((img) => {
+        const mime = img.mime ?? 'image/png';
+        return `data:${mime};base64,${img.data.replace(/^data:[^;]+;base64,/, '')}`;
+    });
+}
+//# sourceMappingURL=evidence.js.map

package/dist/src/utils/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../../../src/utils/evidence.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Parsing, error handling, transaction helpers.
+ */
+export * from './evidence';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC"}

package/dist/src/utils/index.js

@@ -0,0 +1,5 @@
+/**
+ * Parsing, error handling, transaction helpers.
+ */
+export * from './evidence';
+//# sourceMappingURL=index.js.map

package/dist/src/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@eva-protocol/sdk",
+  "version": "0.0.1-beta.0",
+  "description": "TypeScript SDK for EVA Protocol",
+  "main": "dist/src/index.js",
+  "module": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js",
+      "require": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    }
+  },
+  "type": "module",
+  "files": [
+    "dist/src/**/*",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "sui",
+    "eva",
+    "insurance",
+    "protocol"
+  ],
+  "license": "ISC",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@mysten/seal": "^1.0.0",
+    "@mysten/sui": "^2.3.1",
+    "@mysten/walrus": "^1.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0"
+  }
+}