@opaquecash/stealth-balance 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `@opaquecash/stealth-balance` — optional portfolio-style helpers (token lists and RPC stay app-owned).
+ *
+ * This package defines **types** and a small **aggregation** helper; wire your own `publicClient`
+ * calls for `getBalance` / `readContract` `balanceOf` per discovered stealth address.
+ *
+ * @packageDocumentation
+ */
+import type { Address } from "viem";
+import type { Hex } from "@opaquecash/stealth-core";
+/**
+ * ERC-20 (or native) asset the app tracks for private balance UX.
+ */
+export interface TrackedToken {
+    /** Contract address; use a sentinel for native ETH if your UI distinguishes it. */
+    address: Address;
+    symbol: string;
+    decimals: number;
+}
+/**
+ * One discovered output + balances filled in by your fetch layer.
+ */
+export interface StealthOutputBalance {
+    /** One-time stealth address. */
+    stealthAddress: Address;
+    /** Per-token balances in minimal units (wei for native). */
+    balances: Record<Hex, bigint>;
+}
+/**
+ * Sum per-token balances across many outputs (simple reducer).
+ *
+ * @param outputs - Rows your indexer or scanner produced.
+ * @returns Map token address (lowercase hex) → total raw amount.
+ */
+export declare function aggregateBalancesByToken(outputs: StealthOutputBalance[]): Map<string, bigint>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,oBAAoB,EAAE,GAC9B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CASrB"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * `@opaquecash/stealth-balance` — optional portfolio-style helpers (token lists and RPC stay app-owned).
+ *
+ * This package defines **types** and a small **aggregation** helper; wire your own `publicClient`
+ * calls for `getBalance` / `readContract` `balanceOf` per discovered stealth address.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Sum per-token balances across many outputs (simple reducer).
+ *
+ * @param outputs - Rows your indexer or scanner produced.
+ * @returns Map token address (lowercase hex) → total raw amount.
+ */
+export function aggregateBalancesByToken(outputs) {
+    const totals = new Map();
+    for (const o of outputs) {
+        for (const [token, amount] of Object.entries(o.balances)) {
+            const key = token.toLowerCase();
+            totals.set(key, (totals.get(key) ?? 0n) + amount);
+        }
+    }
+    return totals;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyBH;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAA+B;IAE/B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzD,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@opaquecash/stealth-balance",
+  "version": "0.1.0",
+  "description": "Optional types and hooks for aggregating balances across discovered stealth outputs",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@opaquecash/stealth-core": "0.1.0",
+    "viem": "^2.21.0"
+  },
+  "sideEffects": false
+}