@tangle-network/tcloud 0.1.4 → 0.2.0

package/dist/shielded.d.cts

@@ -1,2 +1,61 @@
-import 'viem';
-export { A as AutoReplenishOptions, S as ShieldedWallet, p as SpendAuth, u as createShieldedClient, v as estimateCost, g as generateWallet, w as signSpendAuth } from './shielded-BTi_OftW.cjs';
+import { Hex } from 'viem';
+import { a as TCloudConfig, T as TCloudClient, w as SpendAuth } from './client-CcuHG7_w.cjs';
+
+/**
+ * tcloud/shielded — Ephemeral wallet generation, SpendAuth signing, private inference.
+ *
+ * import { TCloud } from 'tcloud'
+ * const client = TCloud.shielded()  // anonymous, no API key
+ */
+
+interface ShieldedWallet {
+    /** Ephemeral spending private key (hex) */
+    privateKey: Hex;
+    /** Derived address */
+    address: string;
+    /** Credit account commitment */
+    commitment: Hex;
+    /** Random salt */
+    salt: Hex;
+}
+/** Generate a new ephemeral shielded wallet */
+declare function generateWallet(): ShieldedWallet;
+/** Sign a SpendAuth for a request */
+declare function signSpendAuth(wallet: ShieldedWallet, params: {
+    serviceId: bigint;
+    jobIndex: number;
+    amount: bigint;
+    operator: Hex;
+    nonce: bigint;
+    expiry: bigint;
+    chainId: number;
+    creditsAddress: Hex;
+}): Promise<SpendAuth>;
+/** Estimate cost in tsUSD base units (6 decimals) */
+declare function estimateCost(inputTokens: number, maxOutputTokens: number, inputPricePerM?: number, outputPricePerM?: number): bigint;
+interface AutoReplenishOptions {
+    minBalance: bigint;
+    replenishAmount: bigint;
+    checkIntervalMs?: number;
+    fundingSource: 'relayer' | 'direct';
+    relayerUrl?: string;
+    fundingWalletKey?: Hex;
+    tokenAddress?: Hex;
+}
+/**
+ * Create a shielded TCloudClient that signs SpendAuth automatically.
+ * Every request is anonymous — no API key, no identity.
+ */
+declare function createShieldedClient(config?: TCloudConfig & {
+    wallet?: ShieldedWallet;
+    operatorAddress?: Hex;
+    chainId?: number;
+    creditsAddress?: Hex;
+    serviceId?: bigint;
+    autoReplenish?: AutoReplenishOptions;
+}): TCloudClient & {
+    wallet: ShieldedWallet;
+    stopAutoReplenish: () => void;
+};
+
+export { type AutoReplenishOptions, type ShieldedWallet, SpendAuth, createShieldedClient, estimateCost, generateWallet, signSpendAuth };

package/dist/shielded.d.ts

@@ -1,2 +1,61 @@
-import 'viem';
-export { A as AutoReplenishOptions, S as ShieldedWallet, p as SpendAuth, u as createShieldedClient, v as estimateCost, g as generateWallet, w as signSpendAuth } from './shielded-BTi_OftW.js';
+import { Hex } from 'viem';
+import { a as TCloudConfig, T as TCloudClient, w as SpendAuth } from './client-CcuHG7_w.js';
+
+/**
+ * tcloud/shielded — Ephemeral wallet generation, SpendAuth signing, private inference.
+ *
+ * import { TCloud } from 'tcloud'
+ * const client = TCloud.shielded()  // anonymous, no API key
+ */
+
+interface ShieldedWallet {
+    /** Ephemeral spending private key (hex) */
+    privateKey: Hex;
+    /** Derived address */
+    address: string;
+    /** Credit account commitment */
+    commitment: Hex;
+    /** Random salt */
+    salt: Hex;
+}
+/** Generate a new ephemeral shielded wallet */
+declare function generateWallet(): ShieldedWallet;
+/** Sign a SpendAuth for a request */
+declare function signSpendAuth(wallet: ShieldedWallet, params: {
+    serviceId: bigint;
+    jobIndex: number;
+    amount: bigint;
+    operator: Hex;
+    nonce: bigint;
+    expiry: bigint;
+    chainId: number;
+    creditsAddress: Hex;
+}): Promise<SpendAuth>;
+/** Estimate cost in tsUSD base units (6 decimals) */
+declare function estimateCost(inputTokens: number, maxOutputTokens: number, inputPricePerM?: number, outputPricePerM?: number): bigint;
+interface AutoReplenishOptions {
+    minBalance: bigint;
+    replenishAmount: bigint;
+    checkIntervalMs?: number;
+    fundingSource: 'relayer' | 'direct';
+    relayerUrl?: string;
+    fundingWalletKey?: Hex;
+    tokenAddress?: Hex;
+}
+/**
+ * Create a shielded TCloudClient that signs SpendAuth automatically.
+ * Every request is anonymous — no API key, no identity.
+ */
+declare function createShieldedClient(config?: TCloudConfig & {
+    wallet?: ShieldedWallet;
+    operatorAddress?: Hex;
+    chainId?: number;
+    creditsAddress?: Hex;
+    serviceId?: bigint;
+    autoReplenish?: AutoReplenishOptions;
+}): TCloudClient & {
+    wallet: ShieldedWallet;
+    stopAutoReplenish: () => void;
+};
+
+export { type AutoReplenishOptions, type ShieldedWallet, SpendAuth, createShieldedClient, estimateCost, generateWallet, signSpendAuth };

package/dist/shielded.js

@@ -3,7 +3,8 @@ import {
   estimateCost,
   generateWallet,
   signSpendAuth
-} from "./chunk-KVXWEAK3.js";
+} from "./chunk-VD4RNZOC.js";
+import "./chunk-HL4CXKET.js";
 export {
   createShieldedClient,
   estimateCost,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/tcloud",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "TypeScript SDK and CLI for Tangle AI Cloud — decentralized LLM inference",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -29,10 +29,22 @@
         "types": "./dist/shielded.d.cts",
         "default": "./dist/shielded.cjs"
       }
+    },
+    "./instance": {
+      "node": {
+        "import": {
+          "types": "./dist/instance.d.ts",
+          "default": "./dist/instance.js"
+        },
+        "require": {
+          "types": "./dist/instance.d.cts",
+          "default": "./dist/instance.cjs"
+        }
+      }
     }
   },
   "scripts": {
-    "build": "tsup src/index.ts src/cli.ts src/shielded.ts --format esm,cjs --dts --clean --external socks-proxy-agent",
+    "build": "tsup src/index.ts src/cli.ts src/shielded.ts src/instance.ts --format esm,cjs --dts --clean --external socks-proxy-agent",
     "docs": "typedoc src/index.ts --out docs --name tcloud --readme README.md",
     "test": "vitest run",
     "dev": "tsx src/cli.ts",