@kynesyslabs/demosdk 2.7.4 → 2.7.6

package/build/tlsnotary/TLSNotaryService.d.ts

@@ -0,0 +1,204 @@
+/**
+ * TLSNotary Service - Token-based Attestation Management
+ *
+ * This module provides functions for managing TLSNotary attestation tokens
+ * and storing proofs on the Demos Network blockchain.
+ *
+ * The attestation flow:
+ * 1. Request attestation token (burns 1 DEM) → get tokenId + proxyUrl
+ * 2. Perform attestation using the proxy
+ * 3. Store proof on-chain or IPFS (burns 1 + ceil(size/1024) DEM)
+ *
+ * @example
+ * ```typescript
+ * import { TLSNotaryService } from '@kynesyslabs/demosdk/tlsnotary';
+ *
+ * const demos = new Demos();
+ * await demos.connect('https://node.demos.sh');
+ * await demos.connectWallet(mnemonic);
+ *
+ * const service = new TLSNotaryService(demos);
+ *
+ * // Request attestation token
+ * const { proxyUrl, tokenId } = await service.requestAttestation({
+ *   targetUrl: 'https://api.github.com/users/octocat'
+ * });
+ *
+ * // Perform attestation (using TLSNotary class)
+ * const tlsn = await demos.tlsnotary();
+ * const result = await tlsn.attest({ url: targetUrl });
+ *
+ * // Store proof on-chain
+ * const { txHash } = await service.storeProof(
+ *   tokenId,
+ *   JSON.stringify(result.presentation),
+ *   { storage: 'onchain' }
+ * );
+ * ```
+ */
+import type { Demos } from "../websdk/demosclass";
+/**
+ * Response from requestAttestation
+ */
+export interface AttestationTokenResponse {
+    /** WebSocket proxy URL for this attestation */
+    proxyUrl: string;
+    /** Unique token ID for this attestation */
+    tokenId: string;
+    /** Unix timestamp when token expires */
+    expiresAt: number;
+    /** Number of retry attempts remaining */
+    retriesLeft: number;
+}
+/**
+ * Response from storeProof
+ */
+export interface StoreProofResponse {
+    /** Transaction hash of the storage transaction */
+    txHash: string;
+    /** Total fee burned for storage (in DEM) */
+    storageFee: number;
+}
+/**
+ * TLSNotary token information
+ */
+export interface TLSNotaryToken {
+    /** Unique token ID */
+    tokenId: string;
+    /** Owner's address */
+    owner: string;
+    /** Target domain for attestation */
+    domain: string;
+    /** Current token status */
+    status: "pending" | "used" | "expired" | "stored";
+    /** Creation timestamp */
+    createdAt: number;
+    /** Expiration timestamp */
+    expiresAt: number;
+    /** Number of retry attempts remaining */
+    retriesLeft: number;
+    /** Associated proof hash (if stored) */
+    proofHash?: string;
+    /** Storage type (if stored) */
+    storageType?: "onchain" | "ipfs";
+}
+/**
+ * Options for requesting an attestation
+ */
+export interface RequestAttestationOptions {
+    /** Target HTTPS URL to attest */
+    targetUrl: string;
+}
+/**
+ * Options for storing a proof
+ */
+export interface StoreProofOptions {
+    /** Storage location: on-chain or IPFS */
+    storage: "onchain" | "ipfs";
+}
+/**
+ * TLSNotary Service for managing attestation tokens and proof storage
+ */
+export declare class TLSNotaryService {
+    private demos;
+    /**
+     * Create a new TLSNotaryService instance
+     *
+     * @param demos - Connected Demos instance with wallet
+     */
+    constructor(demos: Demos);
+    /**
+     * Request an attestation token for a target URL
+     *
+     * This submits a TLSN_REQUEST native transaction that burns 1 DEM
+     * and returns a token ID with a proxy URL for performing the attestation.
+     *
+     * @param options - Request options including target URL
+     * @returns Attestation token response with proxyUrl and tokenId
+     *
+     * @example
+     * ```typescript
+     * const { proxyUrl, tokenId } = await service.requestAttestation({
+     *   targetUrl: 'https://api.coingecko.com/api/v3/simple/price'
+     * });
+     * ```
+     */
+    requestAttestation(options: RequestAttestationOptions): Promise<AttestationTokenResponse>;
+    /**
+     * Store a TLSNotary proof on-chain or IPFS
+     *
+     * This submits a TLSN_STORE native transaction that burns:
+     * - 1 DEM base fee
+     * - 1 DEM per KB of proof data
+     *
+     * @param tokenId - The attestation token ID
+     * @param proof - The proof data (JSON string or serialized presentation)
+     * @param options - Storage options (on-chain or IPFS)
+     * @returns Storage response with transaction hash and fee
+     *
+     * @example
+     * ```typescript
+     * const { txHash, storageFee } = await service.storeProof(
+     *   tokenId,
+     *   JSON.stringify(presentation),
+     *   { storage: 'onchain' }
+     * );
+     * console.log(`Proof stored! Fee: ${storageFee} DEM`);
+     * ```
+     */
+    storeProof(tokenId: string, proof: string, options: StoreProofOptions): Promise<StoreProofResponse>;
+    /**
+     * Calculate the storage fee for a proof
+     *
+     * Fee structure:
+     * - 1 DEM base fee
+     * - 1 DEM per KB of proof data
+     *
+     * @param proofSizeKB - Size of proof in kilobytes
+     * @returns Total fee in DEM
+     *
+     * @example
+     * ```typescript
+     * const fee = service.calculateStorageFee(5); // 6 DEM for 5KB proof
+     * ```
+     */
+    calculateStorageFee(proofSizeKB: number): number;
+    /**
+     * Get attestation token information by token ID
+     *
+     * @param tokenId - The attestation token ID
+     * @returns Token information or null if not found
+     *
+     * @example
+     * ```typescript
+     * const token = await service.getToken(tokenId);
+     * if (token?.status === 'stored') {
+     *   console.log('Proof already stored:', token.proofHash);
+     * }
+     * ```
+     */
+    getToken(tokenId: string): Promise<TLSNotaryToken | null>;
+    /**
+     * Get attestation token information by transaction hash
+     *
+     * @param txHash - The transaction hash of the TLSN_REQUEST transaction
+     * @returns Token information or null if not found
+     *
+     * @example
+     * ```typescript
+     * const token = await service.getTokenByTxHash(txHash);
+     * ```
+     */
+    getTokenByTxHash(txHash: string): Promise<TLSNotaryToken | null>;
+    /**
+     * Create a TLSN_REQUEST native transaction
+     * @internal
+     */
+    private createTlsnRequestTransaction;
+    /**
+     * Create a TLSN_STORE native transaction
+     * @internal
+     */
+    private createTlsnStoreTransaction;
+}
+export default TLSNotaryService;

package/build/tlsnotary/TLSNotaryService.js

@@ -0,0 +1,266 @@
+"use strict";
+/**
+ * TLSNotary Service - Token-based Attestation Management
+ *
+ * This module provides functions for managing TLSNotary attestation tokens
+ * and storing proofs on the Demos Network blockchain.
+ *
+ * The attestation flow:
+ * 1. Request attestation token (burns 1 DEM) → get tokenId + proxyUrl
+ * 2. Perform attestation using the proxy
+ * 3. Store proof on-chain or IPFS (burns 1 + ceil(size/1024) DEM)
+ *
+ * @example
+ * ```typescript
+ * import { TLSNotaryService } from '@kynesyslabs/demosdk/tlsnotary';
+ *
+ * const demos = new Demos();
+ * await demos.connect('https://node.demos.sh');
+ * await demos.connectWallet(mnemonic);
+ *
+ * const service = new TLSNotaryService(demos);
+ *
+ * // Request attestation token
+ * const { proxyUrl, tokenId } = await service.requestAttestation({
+ *   targetUrl: 'https://api.github.com/users/octocat'
+ * });
+ *
+ * // Perform attestation (using TLSNotary class)
+ * const tlsn = await demos.tlsnotary();
+ * const result = await tlsn.attest({ url: targetUrl });
+ *
+ * // Store proof on-chain
+ * const { txHash } = await service.storeProof(
+ *   tokenId,
+ *   JSON.stringify(result.presentation),
+ *   { storage: 'onchain' }
+ * );
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TLSNotaryService = void 0;
+const DemosTransactions_1 = require("../websdk/DemosTransactions");
+const unifiedCrypto_1 = require("../encryption/unifiedCrypto");
+/**
+ * TLSNotary Service for managing attestation tokens and proof storage
+ */
+class TLSNotaryService {
+    /**
+     * Create a new TLSNotaryService instance
+     *
+     * @param demos - Connected Demos instance with wallet
+     */
+    constructor(demos) {
+        if (!demos.connected) {
+            throw new Error("Demos instance must be connected to a node");
+        }
+        if (!demos.walletConnected) {
+            throw new Error("Wallet must be connected to use TLSNotaryService");
+        }
+        this.demos = demos;
+    }
+    /**
+     * Request an attestation token for a target URL
+     *
+     * This submits a TLSN_REQUEST native transaction that burns 1 DEM
+     * and returns a token ID with a proxy URL for performing the attestation.
+     *
+     * @param options - Request options including target URL
+     * @returns Attestation token response with proxyUrl and tokenId
+     *
+     * @example
+     * ```typescript
+     * const { proxyUrl, tokenId } = await service.requestAttestation({
+     *   targetUrl: 'https://api.coingecko.com/api/v3/simple/price'
+     * });
+     * ```
+     */
+    async requestAttestation(options) {
+        const { targetUrl } = options;
+        // Validate URL is HTTPS
+        const url = new URL(targetUrl);
+        if (url.protocol !== "https:") {
+            throw new Error("Only HTTPS URLs are supported for TLS attestation");
+        }
+        // 1. Create and submit TLSN_REQUEST native transaction (burns 1 DEM)
+        const tx = await this.createTlsnRequestTransaction(targetUrl);
+        // 2. Confirm and broadcast the transaction
+        const confirmResult = await DemosTransactions_1.DemosTransactions.confirm(tx, this.demos);
+        const broadcastResult = await DemosTransactions_1.DemosTransactions.broadcast(confirmResult, this.demos);
+        if (broadcastResult.result !== 200) {
+            throw new Error(`Failed to submit attestation request: ${broadcastResult.response?.message || "Unknown error"}`);
+        }
+        // 3. Extract tokenId from transaction result
+        const tokenId = broadcastResult.response?.tokenId || tx.hash;
+        // 4. Get owner address
+        const { publicKey } = await this.demos.crypto.getIdentity("ed25519");
+        const owner = (0, unifiedCrypto_1.uint8ArrayToHex)(publicKey);
+        // 5. Call nodeCall to get proxy URL
+        const proxyResponse = (await this.demos.nodeCall("requestTLSNproxy", {
+            tokenId,
+            owner,
+            targetUrl,
+        }));
+        if (!proxyResponse || !proxyResponse.websocketProxyUrl) {
+            throw new Error("Failed to get proxy URL from node");
+        }
+        return {
+            proxyUrl: proxyResponse.websocketProxyUrl,
+            tokenId,
+            expiresAt: Date.now() + (proxyResponse.expiresIn || 30000),
+            retriesLeft: proxyResponse.retriesLeft ?? 3,
+        };
+    }
+    /**
+     * Store a TLSNotary proof on-chain or IPFS
+     *
+     * This submits a TLSN_STORE native transaction that burns:
+     * - 1 DEM base fee
+     * - 1 DEM per KB of proof data
+     *
+     * @param tokenId - The attestation token ID
+     * @param proof - The proof data (JSON string or serialized presentation)
+     * @param options - Storage options (on-chain or IPFS)
+     * @returns Storage response with transaction hash and fee
+     *
+     * @example
+     * ```typescript
+     * const { txHash, storageFee } = await service.storeProof(
+     *   tokenId,
+     *   JSON.stringify(presentation),
+     *   { storage: 'onchain' }
+     * );
+     * console.log(`Proof stored! Fee: ${storageFee} DEM`);
+     * ```
+     */
+    async storeProof(tokenId, proof, options) {
+        const { storage } = options;
+        // 1. Calculate storage fee
+        const proofSizeKB = Math.ceil(proof.length / 1024);
+        const storageFee = this.calculateStorageFee(proofSizeKB);
+        // 2. Create and submit TLSN_STORE native transaction
+        const tx = await this.createTlsnStoreTransaction(tokenId, proof, storage, storageFee);
+        // 3. Confirm and broadcast
+        const confirmResult = await DemosTransactions_1.DemosTransactions.confirm(tx, this.demos);
+        const broadcastResult = await DemosTransactions_1.DemosTransactions.broadcast(confirmResult, this.demos);
+        if (broadcastResult.result !== 200) {
+            throw new Error(`Failed to store proof: ${broadcastResult.response?.message || "Unknown error"}`);
+        }
+        return {
+            txHash: tx.hash,
+            storageFee,
+        };
+    }
+    /**
+     * Calculate the storage fee for a proof
+     *
+     * Fee structure:
+     * - 1 DEM base fee
+     * - 1 DEM per KB of proof data
+     *
+     * @param proofSizeKB - Size of proof in kilobytes
+     * @returns Total fee in DEM
+     *
+     * @example
+     * ```typescript
+     * const fee = service.calculateStorageFee(5); // 6 DEM for 5KB proof
+     * ```
+     */
+    calculateStorageFee(proofSizeKB) {
+        return 1 + proofSizeKB; // 1 DEM base + 1 DEM per KB
+    }
+    /**
+     * Get attestation token information by token ID
+     *
+     * @param tokenId - The attestation token ID
+     * @returns Token information or null if not found
+     *
+     * @example
+     * ```typescript
+     * const token = await service.getToken(tokenId);
+     * if (token?.status === 'stored') {
+     *   console.log('Proof already stored:', token.proofHash);
+     * }
+     * ```
+     */
+    async getToken(tokenId) {
+        const response = await this.demos.nodeCall("tlsnotary.getToken", {
+            tokenId,
+        });
+        if (!response || response.error) {
+            return null;
+        }
+        return response;
+    }
+    /**
+     * Get attestation token information by transaction hash
+     *
+     * @param txHash - The transaction hash of the TLSN_REQUEST transaction
+     * @returns Token information or null if not found
+     *
+     * @example
+     * ```typescript
+     * const token = await service.getTokenByTxHash(txHash);
+     * ```
+     */
+    async getTokenByTxHash(txHash) {
+        const response = await this.demos.nodeCall("tlsnotary.getToken", {
+            txHash,
+        });
+        if (!response || response.error) {
+            return null;
+        }
+        return response;
+    }
+    /**
+     * Create a TLSN_REQUEST native transaction
+     * @internal
+     */
+    async createTlsnRequestTransaction(targetUrl) {
+        const tx = DemosTransactions_1.DemosTransactions.empty();
+        const { publicKey } = await this.demos.crypto.getIdentity("ed25519");
+        const publicKeyHex = (0, unifiedCrypto_1.uint8ArrayToHex)(publicKey);
+        const nonce = await this.demos.getAddressNonce(publicKeyHex);
+        // Self-directed transaction (burns tokens)
+        tx.content.to = publicKeyHex;
+        tx.content.nonce = nonce + 1;
+        tx.content.amount = 1; // 1 DEM fee for attestation request
+        tx.content.type = "native";
+        tx.content.timestamp = Date.now();
+        tx.content.data = [
+            "native",
+            {
+                nativeOperation: "tlsn_request",
+                args: [targetUrl],
+            },
+        ];
+        return await this.demos.sign(tx);
+    }
+    /**
+     * Create a TLSN_STORE native transaction
+     * @internal
+     */
+    async createTlsnStoreTransaction(tokenId, proof, storageType, fee) {
+        const tx = DemosTransactions_1.DemosTransactions.empty();
+        const { publicKey } = await this.demos.crypto.getIdentity("ed25519");
+        const publicKeyHex = (0, unifiedCrypto_1.uint8ArrayToHex)(publicKey);
+        const nonce = await this.demos.getAddressNonce(publicKeyHex);
+        // Self-directed transaction (burns tokens)
+        tx.content.to = publicKeyHex;
+        tx.content.nonce = nonce + 1;
+        tx.content.amount = fee; // Storage fee
+        tx.content.type = "native";
+        tx.content.timestamp = Date.now();
+        tx.content.data = [
+            "native",
+            {
+                nativeOperation: "tlsn_store",
+                args: [tokenId, proof, storageType],
+            },
+        ];
+        return await this.demos.sign(tx);
+    }
+}
+exports.TLSNotaryService = TLSNotaryService;
+exports.default = TLSNotaryService;
+//# sourceMappingURL=TLSNotaryService.js.map

package/build/tlsnotary/TLSNotaryService.js.map

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

package/build/tlsnotary/helpers.d.ts

@@ -0,0 +1,24 @@
+/**
+ * TLSNotary Helper Functions
+ *
+ * Standalone utility functions for TLSNotary operations.
+ */
+/**
+ * Calculate the storage fee for a TLSNotary proof
+ *
+ * Fee structure:
+ * - 1 DEM base fee
+ * - 1 DEM per KB of proof data
+ *
+ * @param proofSizeKB - Size of proof in kilobytes
+ * @returns Total fee in DEM
+ *
+ * @example
+ * ```typescript
+ * import { calculateStorageFee } from '@kynesyslabs/demosdk/tlsnotary';
+ *
+ * const proofSize = Math.ceil(proof.length / 1024);
+ * const fee = calculateStorageFee(proofSize); // e.g., 6 DEM for 5KB
+ * ```
+ */
+export declare function calculateStorageFee(proofSizeKB: number): number;

package/build/tlsnotary/helpers.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * TLSNotary Helper Functions
+ *
+ * Standalone utility functions for TLSNotary operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateStorageFee = calculateStorageFee;
+/**
+ * Calculate the storage fee for a TLSNotary proof
+ *
+ * Fee structure:
+ * - 1 DEM base fee
+ * - 1 DEM per KB of proof data
+ *
+ * @param proofSizeKB - Size of proof in kilobytes
+ * @returns Total fee in DEM
+ *
+ * @example
+ * ```typescript
+ * import { calculateStorageFee } from '@kynesyslabs/demosdk/tlsnotary';
+ *
+ * const proofSize = Math.ceil(proof.length / 1024);
+ * const fee = calculateStorageFee(proofSize); // e.g., 6 DEM for 5KB
+ * ```
+ */
+function calculateStorageFee(proofSizeKB) {
+    return 1 + proofSizeKB; // 1 DEM base + 1 DEM per KB
+}
+//# sourceMappingURL=helpers.js.map

package/build/tlsnotary/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/tlsnotary/helpers.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAoBH,kDAEC;AApBD;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,mBAAmB,CAAC,WAAmB;IACnD,OAAO,CAAC,GAAG,WAAW,CAAA,CAAC,4BAA4B;AACvD,CAAC"}

package/build/tlsnotary/index.d.ts

@@ -1,35 +1,45 @@
 /**
  * TLSNotary SDK Module
  *
- * Browser-based HTTPS attestation using MPC-TLS.
+ * Browser-based HTTPS attestation using MPC-TLS with token-based management.
  *
  * @packageDocumentation
  * @module tlsnotary
  *
  * @example
  * ```typescript
- * import { TLSNotary } from '@kynesyslabs/demosdk/tlsnotary';
+ * import { TLSNotary, TLSNotaryService } from '@kynesyslabs/demosdk/tlsnotary';
  *
- * // Option 1: Via Demos instance (recommended - auto-configures dynamic proxies)
  * const demos = new Demos();
  * await demos.connect('https://node.demos.sh');
- * const tlsn = await demos.tlsnotary();
+ * await demos.connectWallet(mnemonic);
  *
- * // Option 2: Manual configuration with dynamic proxies
- * const tlsn = new TLSNotary({
- *   notaryUrl: 'wss://node.demos.sh:7047',
- *   rpcUrl: 'https://node.demos.sh', // For dynamic proxy allocation
- * });
+ * // Token-based flow (recommended for production)
+ * const service = new TLSNotaryService(demos);
  *
- * await tlsn.initialize();
+ * // 1. Request attestation token (burns 1 DEM)
+ * const { proxyUrl, tokenId } = await service.requestAttestation({
+ *   targetUrl: 'https://api.github.com/users/octocat'
+ * });
  *
+ * // 2. Perform attestation
+ * const tlsn = await demos.tlsnotary();
  * const result = await tlsn.attest({
  *   url: 'https://api.github.com/users/octocat',
  * });
  *
- * console.log('Verified:', result.verification.serverName);
+ * // 3. Store proof on-chain (burns 1 + proof_size_kb DEM)
+ * const { txHash } = await service.storeProof(
+ *   tokenId,
+ *   JSON.stringify(result.presentation),
+ *   { storage: 'onchain' }
+ * );
+ *
+ * console.log('Proof stored:', txHash);
  * ```
  */
 export { TLSNotary } from "./TLSNotary";
+export { TLSNotaryService, type AttestationTokenResponse, type StoreProofResponse, type TLSNotaryToken, type RequestAttestationOptions, type StoreProofOptions, } from "./TLSNotaryService";
 export type { TLSNotaryConfig, TLSNotaryDiscoveryInfo, AttestRequest, AttestResult, AttestOptions, CommitRanges, Range, PresentationJSON, VerificationResult, TranscriptInfo, StatusCallback, ProxyRequestResponse, ProxyRequestError, } from "./types";
 export { default } from "./TLSNotary";
+export { calculateStorageFee } from "./helpers";

package/build/tlsnotary/index.js

@@ -2,43 +2,58 @@
 /**
  * TLSNotary SDK Module
  *
- * Browser-based HTTPS attestation using MPC-TLS.
+ * Browser-based HTTPS attestation using MPC-TLS with token-based management.
  *
  * @packageDocumentation
  * @module tlsnotary
  *
  * @example
  * ```typescript
- * import { TLSNotary } from '@kynesyslabs/demosdk/tlsnotary';
+ * import { TLSNotary, TLSNotaryService } from '@kynesyslabs/demosdk/tlsnotary';
  *
- * // Option 1: Via Demos instance (recommended - auto-configures dynamic proxies)
  * const demos = new Demos();
  * await demos.connect('https://node.demos.sh');
- * const tlsn = await demos.tlsnotary();
+ * await demos.connectWallet(mnemonic);
  *
- * // Option 2: Manual configuration with dynamic proxies
- * const tlsn = new TLSNotary({
- *   notaryUrl: 'wss://node.demos.sh:7047',
- *   rpcUrl: 'https://node.demos.sh', // For dynamic proxy allocation
- * });
+ * // Token-based flow (recommended for production)
+ * const service = new TLSNotaryService(demos);
  *
- * await tlsn.initialize();
+ * // 1. Request attestation token (burns 1 DEM)
+ * const { proxyUrl, tokenId } = await service.requestAttestation({
+ *   targetUrl: 'https://api.github.com/users/octocat'
+ * });
  *
+ * // 2. Perform attestation
+ * const tlsn = await demos.tlsnotary();
  * const result = await tlsn.attest({
  *   url: 'https://api.github.com/users/octocat',
  * });
  *
- * console.log('Verified:', result.verification.serverName);
+ * // 3. Store proof on-chain (burns 1 + proof_size_kb DEM)
+ * const { txHash } = await service.storeProof(
+ *   tokenId,
+ *   JSON.stringify(result.presentation),
+ *   { storage: 'onchain' }
+ * );
+ *
+ * console.log('Proof stored:', txHash);
  * ```
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = exports.TLSNotary = void 0;
+exports.calculateStorageFee = exports.default = exports.TLSNotaryService = exports.TLSNotary = void 0;
+// Core TLSNotary class for attestation
 var TLSNotary_1 = require("./TLSNotary");
 Object.defineProperty(exports, "TLSNotary", { enumerable: true, get: function () { return TLSNotary_1.TLSNotary; } });
+// TLSNotary Service for token management and proof storage
+var TLSNotaryService_1 = require("./TLSNotaryService");
+Object.defineProperty(exports, "TLSNotaryService", { enumerable: true, get: function () { return TLSNotaryService_1.TLSNotaryService; } });
 // Re-export default
 var TLSNotary_2 = require("./TLSNotary");
 Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(TLSNotary_2).default; } });
+// Helper function exports
+var helpers_1 = require("./helpers");
+Object.defineProperty(exports, "calculateStorageFee", { enumerable: true, get: function () { return helpers_1.calculateStorageFee; } });
 //# sourceMappingURL=index.js.map

package/build/tlsnotary/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tlsnotary/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;;;;AAEH,yCAAuC;AAA9B,sGAAA,SAAS,OAAA;AAiBlB,oBAAoB;AACpB,yCAAqC;AAA5B,qHAAA,OAAO,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tlsnotary/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;;;;;;AAEH,uCAAuC;AACvC,yCAAuC;AAA9B,sGAAA,SAAS,OAAA;AAElB,2DAA2D;AAC3D,uDAO2B;AANvB,oHAAA,gBAAgB,OAAA;AAyBpB,oBAAoB;AACpB,yCAAqC;AAA5B,qHAAA,OAAO,OAAA;AAEhB,0BAA0B;AAC1B,qCAA+C;AAAtC,8GAAA,mBAAmB,OAAA"}

package/build/types/blockchain/GCREdit.d.ts

@@ -132,4 +132,21 @@ export interface GCREditEscrow {
     txhash: string;
     isRollback: boolean;
 }
-export type GCREdit = GCREditBalance | GCREditNonce | GCREditAssign | GCREditAssignIdentity | GCREditSubnetsTx | GCREditIdentity | GCREditSmartContract | GCREditStorageProgram | GCREditEscrow;
+/**
+ * TLSNotary attestation storage GCR edit
+ */
+export interface GCREditTLSNotary {
+    type: "tlsnotary";
+    operation: "store";
+    account: string;
+    data: {
+        tokenId: string;
+        domain: string;
+        proof: string;
+        storageType: "onchain" | "ipfs";
+        timestamp: number;
+    };
+    txhash: string;
+    isRollback: boolean;
+}
+export type GCREdit = GCREditBalance | GCREditNonce | GCREditAssign | GCREditAssignIdentity | GCREditSubnetsTx | GCREditIdentity | GCREditSmartContract | GCREditStorageProgram | GCREditEscrow | GCREditTLSNotary;

package/build/types/blockchain/blocks.d.ts

@@ -5,6 +5,7 @@ import { StandardGenesis } from "./genesisTypes";
 export interface NativeTablesHashes {
     native_gcr: string;
     native_subnets_txs: string;
+    native_tlsnotary: string;
 }
 export interface BlockContent {
     ordered_transactions: string[];

package/build/types/native/INativePayload.d.ts

@@ -6,5 +6,9 @@ interface INativeTlsnRequest {
     nativeOperation: "tlsn_request";
     args: [string];
 }
-export type INativePayload = INativeSend | INativeTlsnRequest;
+interface INativeTlsnStore {
+    nativeOperation: "tlsn_store";
+    args: [string, string, "onchain" | "ipfs"];
+}
+export type INativePayload = INativeSend | INativeTlsnRequest | INativeTlsnStore;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kynesyslabs/demosdk",
-    "version": "2.7.4",
+    "version": "2.7.6",
     "description": "Demosdk is a JavaScript/TypeScript SDK that provides a unified interface for interacting with Demos network",
     "main": "build/index.js",
     "types": "build/index.d.ts",