@darkfrost-1107/scaff-z-react 0.1.7

package/dist/packages/theme/theme-builder.esm

@@ -0,0 +1,25 @@
+import "react";
+//#region src/packages/theme/theme-builder.tsx
+var e = class {
+	constructor() {
+		this.theme = "", this.icon = void 0, this.label = "";
+	}
+	withIcon(e) {
+		return this.icon = e, this;
+	}
+	withTheme(e) {
+		return this.theme = e, this;
+	}
+	withLabel(e) {
+		return this.label = e, this;
+	}
+	build() {
+		return {
+			theme: this.theme,
+			icon: this.icon,
+			label: this.label
+		};
+	}
+};
+//#endregion
+export { e as ThemeBuilder };

package/dist/packages/theme/theme-provider.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../env/env.manager.cjs`);let t=require(`react/jsx-runtime`),n=require(`next-themes`);function r({children:r,themesList:i,...a}){return(0,t.jsx)(n.ThemeProvider,{attribute:`class`,defaultTheme:e.ENV_MANAGER.get(`VITE_THEME`)??`dark`,enableSystem:!0,disableTransitionOnChange:!0,themes:i.map(e=>e.theme),...a,children:r})}exports.ThemeProvider=r;

package/dist/packages/theme/theme-provider.d.ts

@@ -0,0 +1,7 @@
+import { ThemeProviderProps } from 'next-themes';
+import { BuiltTheme } from './theme-builder';
+interface ExtendedThemeProviderProps extends ThemeProviderProps {
+    themesList: BuiltTheme[];
+}
+export declare function ThemeProvider({ children, themesList, ...props }: ExtendedThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/packages/theme/theme-provider.esm

@@ -0,0 +1,17 @@
+import { ENV_MANAGER as e } from "../env/env.manager.esm";
+import { jsx as t } from "react/jsx-runtime";
+import { ThemeProvider as n } from "next-themes";
+//#region src/packages/theme/theme-provider.tsx
+function r({ children: r, themesList: i, ...a }) {
+	return /* @__PURE__ */ t(n, {
+		attribute: "class",
+		defaultTheme: e.get("VITE_THEME") ?? "dark",
+		enableSystem: !0,
+		disableTransitionOnChange: !0,
+		themes: i.map((e) => e.theme),
+		...a,
+		children: r
+	});
+}
+//#endregion
+export { r as ThemeProvider };

package/dist/packages/theme/theme-toggle.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../shared/ui/select.cjs`);let t=require(`react/jsx-runtime`),n=require(`react`),r=require(`lucide-react`),i=require(`next-themes`);function a({themesList:a}){let{theme:o,setTheme:s}=(0,i.useTheme)(),[c,l]=(0,n.useState)(!1);(0,n.useEffect)(()=>{l(!0)},[]);let u=[{theme:`system`,label:`Sistema`,icon:(0,t.jsx)(r.Monitor,{className:`size-4`})},...a];return c?(0,t.jsxs)(e.Select,{value:o,onValueChange:s,children:[(0,t.jsx)(e.SelectTrigger,{className:`w-[140px] bg-accent/5 border-border/50 hover:bg-accent/10 transition-colors`,children:(0,t.jsx)(e.SelectValue,{placeholder:`Seleccionar tema`})}),(0,t.jsx)(e.SelectContent,{children:u.map(({theme:n,label:r,icon:i})=>(0,t.jsx)(e.SelectItem,{value:n,children:(0,t.jsxs)(`div`,{className:`flex items-center gap-2`,children:[i,(0,t.jsx)(`span`,{children:r})]})},n))})]}):(0,t.jsx)(`div`,{className:`h-9 w-32 animate-pulse bg-muted rounded-md`})}exports.ThemeToggle=a;

package/dist/packages/theme/theme-toggle.d.ts

@@ -0,0 +1,6 @@
+import { BuiltTheme } from './theme-builder';
+interface ThemeToggleProps {
+    themesList: BuiltTheme[];
+}
+export declare function ThemeToggle({ themesList }: ThemeToggleProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/packages/theme/theme-toggle.esm

@@ -0,0 +1,33 @@
+import { Select as e, SelectContent as t, SelectItem as n, SelectTrigger as r, SelectValue as i } from "../../shared/ui/select.esm";
+import { jsx as a, jsxs as o } from "react/jsx-runtime";
+import { useEffect as s, useState as c } from "react";
+import { Monitor as l } from "lucide-react";
+import { useTheme as u } from "next-themes";
+//#region src/packages/theme/theme-toggle.tsx
+function d({ themesList: d }) {
+	let { theme: f, setTheme: p } = u(), [m, h] = c(!1);
+	s(() => {
+		h(!0);
+	}, []);
+	let g = [{
+		theme: "system",
+		label: "Sistema",
+		icon: /* @__PURE__ */ a(l, { className: "size-4" })
+	}, ...d];
+	return m ? /* @__PURE__ */ o(e, {
+		value: f,
+		onValueChange: p,
+		children: [/* @__PURE__ */ a(r, {
+			className: "w-[140px] bg-accent/5 border-border/50 hover:bg-accent/10 transition-colors",
+			children: /* @__PURE__ */ a(i, { placeholder: "Seleccionar tema" })
+		}), /* @__PURE__ */ a(t, { children: g.map(({ theme: e, label: t, icon: r }) => /* @__PURE__ */ a(n, {
+			value: e,
+			children: /* @__PURE__ */ o("div", {
+				className: "flex items-center gap-2",
+				children: [r, /* @__PURE__ */ a("span", { children: t })]
+			})
+		}, e)) })]
+	}) : /* @__PURE__ */ a("div", { className: "h-9 w-32 animate-pulse bg-muted rounded-md" });
+}
+//#endregion
+export { d as ThemeToggle };

package/dist/packages/w3/tron/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./tron.service.cjs`),t=require(`./tron-assets.service.cjs`),n=require(`./tron-wallet.repo.cjs`);exports.TRON_ASSETS_SERVICE=t.TRON_ASSETS_SERVICE,exports.TRON_SERVICE=e.TRON_SERVICE,exports.TRON_WALLET_REPO=n.TRON_WALLET_REPO,exports.TronAssetsService=t.TronAssetsService,exports.TronService=e.TronService,exports.TronWalletRepoService=n.TronWalletRepoService;

package/dist/packages/w3/tron/index.d.ts

@@ -0,0 +1,4 @@
+export * from './tron.service';
+export * from './tron.types';
+export * from './tron-assets.service';
+export * from './tron-wallet.repo';

package/dist/packages/w3/tron/index.esm

@@ -0,0 +1,4 @@
+import { TRON_SERVICE as e, TronService as t } from "./tron.service.esm";
+import { TRON_ASSETS_SERVICE as n, TronAssetsService as r } from "./tron-assets.service.esm";
+import { TRON_WALLET_REPO as i, TronWalletRepoService as a } from "./tron-wallet.repo.esm";
+export { n as TRON_ASSETS_SERVICE, e as TRON_SERVICE, i as TRON_WALLET_REPO, r as TronAssetsService, t as TronService, a as TronWalletRepoService };

package/dist/packages/w3/tron/tron-assets.service.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../logger/logger.cjs`);let t=require(`tronweb`);function n(e,t){if(!{}.hasOwnProperty.call(e,t))throw TypeError(`attempted to use private field on non-instance`);return e}var r=0;function i(e){return`__private_`+ r+++`_`+e}var a=e.GLOBAL_LOGGER.child(`[TronAssetsService]`),o={"nile-testnet":[`TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf`],mainnet:[`TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t`,`TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8`]},s=i(`instance`),c=class e{constructor(e){this.tronWeb=void 0,this.fullHost=void 0,this.networkHeaders=void 0,this.network=void 0,this.fullHost=e?.fullHost??`https://nile.trongrid.io`,this.networkHeaders=e?.headers,this.network=e?.network??`nile-testnet`,this.tronWeb=new t.TronWeb({fullHost:this.fullHost,headers:this.networkHeaders})}static get instance(){return n(e,s)[s]||(n(e,s)[s]=new e),n(e,s)[s]}async getWalletAssets(e){let t=a.trace(`getWalletAssets`);try{let[t,n,r]=await Promise.all([this.fetchTrxBalance(e),this.fetchTRC10Assets(e),this.fetchTRC20Assets(e)]),i={address:e,trxBalanceSun:t,trxBalance:t/1e6,trc10:n,trc20:r,fetchedAt:new Date};return a.success(`Assets fetched`,{address:e,trxBalance:i.trxBalance,trc10Count:n.length,trc20Count:r.length}),i}catch(e){throw a.error(`Failed to fetch wallet assets`,e),e}finally{t.end()}}async fetchTrxBalance(e){try{let t=await this.tronWeb.trx.getBalance(e);return Number(t)}catch{return 0}}async fetchTRC10Assets(e){try{let t=(await this.tronWeb.trx.getAccount(e)).assetV2??[];return t.length?(await Promise.allSettled(t.map(async({key:e,value:t})=>{try{let n=await this.tronWeb.trx.getTokenByID(e);return{tokenId:e,name:n.name??e,abbreviation:n.abbr??e,balance:Number(t)}}catch{return{tokenId:e,name:e,abbreviation:e,balance:Number(t)}}}))).filter(e=>e.status===`fulfilled`).map(e=>e.value):[]}catch{return[]}}async fetchTRC20Assets(e){let t=o[this.network]??[];return t.length?(await Promise.allSettled(t.map(t=>this.fetchSingleTRC20(e,t)))).filter(e=>e.status===`fulfilled`&&e.value!==null).map(e=>e.value):[]}async fetchSingleTRC20(e,t){try{let n=await this.tronWeb.contract().at(t),[r,i,a,o]=await Promise.all([n.balanceOf(e).call(),n.name().call().catch(()=>t),n.symbol().call().catch(()=>`???`),n.decimals().call().catch(()=>6)]),s=Number(o),c=r.toString(),l=Number(c)/10**s;return{contractAddress:t,name:i?.toString()??t,symbol:a?.toString()??`???`,decimals:s,rawBalance:c,balance:l}}catch{return null}}};Object.defineProperty(c,s,{writable:!0,value:void 0});var l=c.instance;exports.TRON_ASSETS_SERVICE=l,exports.TronAssetsService=c;

package/dist/packages/w3/tron/tron-assets.service.d.ts

@@ -0,0 +1,38 @@
+import { TronWalletAssets } from './tron.types';
+export declare class TronAssetsService {
+    #private;
+    private tronWeb;
+    private readonly fullHost;
+    private readonly networkHeaders?;
+    private readonly network;
+    private constructor();
+    static get instance(): TronAssetsService;
+    /**
+     * Devuelve todos los activos de una dirección:
+     * - Balance TRX (en TRX y en SUN)
+     * - Tokens TRC10 (nativos de la red)
+     * - Tokens TRC20 (contratos ERC20-like) para los contratos conocidos
+     *
+     * @param address Dirección Base58 de la wallet a consultar
+     */
+    getWalletAssets(address: string): Promise<TronWalletAssets>;
+    /**
+     * Obtiene el balance de TRX en SUN.
+     * Las cuentas nuevas (sin activar) devuelven 0.
+     */
+    private fetchTrxBalance;
+    /**
+     * Obtiene los tokens TRC10 asociados a la cuenta.
+     * Se extraen de `account.assetV2` en la respuesta de getAccount().
+     */
+    private fetchTRC10Assets;
+    /**
+     * Consulta el balance de contratos TRC20 conocidos para esta red.
+     * Llama a balanceOf(address) en cada contrato y obtiene su metadata.
+     *
+     * @param address Dirección de la wallet a consultar
+     */
+    private fetchTRC20Assets;
+    private fetchSingleTRC20;
+}
+export declare const TRON_ASSETS_SERVICE: TronAssetsService;

package/dist/packages/w3/tron/tron-assets.service.esm

@@ -0,0 +1,116 @@
+import { GLOBAL_LOGGER as e } from "../../logger/logger.esm";
+import { TronWeb as t } from "tronweb";
+//#region src/packages/w3/tron/tron-assets.service.ts
+function n(e, t) {
+	if (!{}.hasOwnProperty.call(e, t)) throw TypeError("attempted to use private field on non-instance");
+	return e;
+}
+var r = 0;
+function i(e) {
+	return "__private_" + r++ + "_" + e;
+}
+var a = e.child("[TronAssetsService]"), o = {
+	"nile-testnet": ["TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf"],
+	mainnet: ["TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8"]
+}, s = /* @__PURE__ */ i("instance"), c = class e {
+	constructor(e) {
+		this.tronWeb = void 0, this.fullHost = void 0, this.networkHeaders = void 0, this.network = void 0, this.fullHost = e?.fullHost ?? "https://nile.trongrid.io", this.networkHeaders = e?.headers, this.network = e?.network ?? "nile-testnet", this.tronWeb = new t({
+			fullHost: this.fullHost,
+			headers: this.networkHeaders
+		});
+	}
+	static get instance() {
+		return n(e, s)[s] || (n(e, s)[s] = new e()), n(e, s)[s];
+	}
+	async getWalletAssets(e) {
+		let t = a.trace("getWalletAssets");
+		try {
+			let [t, n, r] = await Promise.all([
+				this.fetchTrxBalance(e),
+				this.fetchTRC10Assets(e),
+				this.fetchTRC20Assets(e)
+			]), i = {
+				address: e,
+				trxBalanceSun: t,
+				trxBalance: t / 1e6,
+				trc10: n,
+				trc20: r,
+				fetchedAt: /* @__PURE__ */ new Date()
+			};
+			return a.success("Assets fetched", {
+				address: e,
+				trxBalance: i.trxBalance,
+				trc10Count: n.length,
+				trc20Count: r.length
+			}), i;
+		} catch (e) {
+			throw a.error("Failed to fetch wallet assets", e), e;
+		} finally {
+			t.end();
+		}
+	}
+	async fetchTrxBalance(e) {
+		try {
+			let t = await this.tronWeb.trx.getBalance(e);
+			return Number(t);
+		} catch {
+			return 0;
+		}
+	}
+	async fetchTRC10Assets(e) {
+		try {
+			let t = (await this.tronWeb.trx.getAccount(e)).assetV2 ?? [];
+			return t.length ? (await Promise.allSettled(t.map(async ({ key: e, value: t }) => {
+				try {
+					let n = await this.tronWeb.trx.getTokenByID(e);
+					return {
+						tokenId: e,
+						name: n.name ?? e,
+						abbreviation: n.abbr ?? e,
+						balance: Number(t)
+					};
+				} catch {
+					return {
+						tokenId: e,
+						name: e,
+						abbreviation: e,
+						balance: Number(t)
+					};
+				}
+			}))).filter((e) => e.status === "fulfilled").map((e) => e.value) : [];
+		} catch {
+			return [];
+		}
+	}
+	async fetchTRC20Assets(e) {
+		let t = o[this.network] ?? [];
+		return t.length ? (await Promise.allSettled(t.map((t) => this.fetchSingleTRC20(e, t)))).filter((e) => e.status === "fulfilled" && e.value !== null).map((e) => e.value) : [];
+	}
+	async fetchSingleTRC20(e, t) {
+		try {
+			let n = await this.tronWeb.contract().at(t), [r, i, a, o] = await Promise.all([
+				n.balanceOf(e).call(),
+				n.name().call().catch(() => t),
+				n.symbol().call().catch(() => "???"),
+				n.decimals().call().catch(() => 6)
+			]), s = Number(o), c = r.toString(), l = Number(c) / 10 ** s;
+			return {
+				contractAddress: t,
+				name: i?.toString() ?? t,
+				symbol: a?.toString() ?? "???",
+				decimals: s,
+				rawBalance: c,
+				balance: l
+			};
+		} catch {
+			return null;
+		}
+	}
+};
+Object.defineProperty(c, s, {
+	writable: !0,
+	value: void 0
+});
+var l = c.instance;
+//#endregion
+export { l as TRON_ASSETS_SERVICE, c as TronAssetsService };

package/dist/packages/w3/tron/tron-wallet.entity.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../../../_virtual/_rolldown/runtime.cjs`);let e=require(`typeorm/browser`);var t,n,r,i,a,o,s,c,l,u,d,f,p,m,h,g,_;function v(e,t,n,r){n&&Object.defineProperty(e,t,{enumerable:n.enumerable,configurable:n.configurable,writable:n.writable,value:n.initializer?n.initializer.call(r):void 0})}function y(e,t,n,r,i){var a={};return Object.keys(r).forEach(function(e){a[e]=r[e]}),a.enumerable=!!a.enumerable,a.configurable=!!a.configurable,(`value`in a||a.initializer)&&(a.writable=!0),a=n.slice().reverse().reduce(function(n,r){return r(e,t,n)||n},a),i&&a.initializer!==void 0&&(a.value=a.initializer?a.initializer.call(i):void 0,a.initializer=void 0),a.initializer===void 0?(Object.defineProperty(e,t,a),null):a}var b=(t=(0,e.Entity)(`tron_wallet`),n=(0,e.PrimaryGeneratedColumn)(`uuid`),r=(0,e.Column)({name:`label`,type:`varchar`,length:120,nullable:!0}),i=(0,e.Column)({name:`address`,type:`varchar`,length:64,nullable:!1,unique:!0}),a=(0,e.Column)({name:`public_key`,type:`varchar`,length:128,nullable:!1}),o=(0,e.Column)({name:`private_key`,type:`varchar`,length:128,nullable:!1}),s=(0,e.Column)({name:`network`,type:`varchar`,length:64,nullable:!1,default:`nile-testnet`}),c=(0,e.CreateDateColumn)({name:`created_at`}),t(l=(u=class{constructor(){v(this,`id`,d,this),v(this,`label`,f,this),v(this,`address`,p,this),v(this,`publicKey`,m,this),v(this,`privateKey`,h,this),v(this,`network`,g,this),v(this,`createdAt`,_,this)}},d=y(u.prototype,`id`,[n],{configurable:!0,enumerable:!0,writable:!0,initializer:null}),f=y(u.prototype,`label`,[r],{configurable:!0,enumerable:!0,writable:!0,initializer:null}),p=y(u.prototype,`address`,[i],{configurable:!0,enumerable:!0,writable:!0,initializer:null}),m=y(u.prototype,`publicKey`,[a],{configurable:!0,enumerable:!0,writable:!0,initializer:null}),h=y(u.prototype,`privateKey`,[o],{configurable:!0,enumerable:!0,writable:!0,initializer:null}),g=y(u.prototype,`network`,[s],{configurable:!0,enumerable:!0,writable:!0,initializer:null}),_=y(u.prototype,`createdAt`,[c],{configurable:!0,enumerable:!0,writable:!0,initializer:null}),u))||l);exports.TronWalletEntity=b;

package/dist/packages/w3/tron/tron-wallet.entity.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Entidad que representa una wallet de Tron almacenada localmente.
+ *
+ * ⚠️  La privateKey se almacena en texto plano en SQLite local (IndexedDB en web).
+ *     En producción, considera cifrarla antes de persistir.
+ */
+export declare class TronWalletEntity {
+    id: string;
+    label: string | null;
+    address: string;
+    publicKey: string;
+    privateKey: string;
+    network: string;
+    createdAt: Date;
+}

package/dist/packages/w3/tron/tron-wallet.entity.esm

@@ -0,0 +1,88 @@
+import { Column as e, CreateDateColumn as t, Entity as n, PrimaryGeneratedColumn as r } from "typeorm/browser";
+//#region src/packages/w3/tron/tron-wallet.entity.ts
+var i, a, o, s, c, l, u, d, f, p, m, h, g, _, v, y, b;
+function x(e, t, n, r) {
+	n && Object.defineProperty(e, t, {
+		enumerable: n.enumerable,
+		configurable: n.configurable,
+		writable: n.writable,
+		value: n.initializer ? n.initializer.call(r) : void 0
+	});
+}
+function S(e, t, n, r, i) {
+	var a = {};
+	return Object.keys(r).forEach(function(e) {
+		a[e] = r[e];
+	}), a.enumerable = !!a.enumerable, a.configurable = !!a.configurable, ("value" in a || a.initializer) && (a.writable = !0), a = n.slice().reverse().reduce(function(n, r) {
+		return r(e, t, n) || n;
+	}, a), i && a.initializer !== void 0 && (a.value = a.initializer ? a.initializer.call(i) : void 0, a.initializer = void 0), a.initializer === void 0 ? (Object.defineProperty(e, t, a), null) : a;
+}
+var C = (i = n("tron_wallet"), a = r("uuid"), o = e({
+	name: "label",
+	type: "varchar",
+	length: 120,
+	nullable: !0
+}), s = e({
+	name: "address",
+	type: "varchar",
+	length: 64,
+	nullable: !1,
+	unique: !0
+}), c = e({
+	name: "public_key",
+	type: "varchar",
+	length: 128,
+	nullable: !1
+}), l = e({
+	name: "private_key",
+	type: "varchar",
+	length: 128,
+	nullable: !1
+}), u = e({
+	name: "network",
+	type: "varchar",
+	length: 64,
+	nullable: !1,
+	default: "nile-testnet"
+}), d = t({ name: "created_at" }), i(f = (p = class {
+	constructor() {
+		x(this, "id", m, this), x(this, "label", h, this), x(this, "address", g, this), x(this, "publicKey", _, this), x(this, "privateKey", v, this), x(this, "network", y, this), x(this, "createdAt", b, this);
+	}
+}, m = S(p.prototype, "id", [a], {
+	configurable: !0,
+	enumerable: !0,
+	writable: !0,
+	initializer: null
+}), h = S(p.prototype, "label", [o], {
+	configurable: !0,
+	enumerable: !0,
+	writable: !0,
+	initializer: null
+}), g = S(p.prototype, "address", [s], {
+	configurable: !0,
+	enumerable: !0,
+	writable: !0,
+	initializer: null
+}), _ = S(p.prototype, "publicKey", [c], {
+	configurable: !0,
+	enumerable: !0,
+	writable: !0,
+	initializer: null
+}), v = S(p.prototype, "privateKey", [l], {
+	configurable: !0,
+	enumerable: !0,
+	writable: !0,
+	initializer: null
+}), y = S(p.prototype, "network", [u], {
+	configurable: !0,
+	enumerable: !0,
+	writable: !0,
+	initializer: null
+}), b = S(p.prototype, "createdAt", [d], {
+	configurable: !0,
+	enumerable: !0,
+	writable: !0,
+	initializer: null
+}), p)) || f);
+//#endregion
+export { C as TronWalletEntity };

package/dist/packages/w3/tron/tron-wallet.repo.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../logger/logger.cjs`),t=require(`./tron-wallet.entity.cjs`),n=require(`../../sqlite/repo.service.cjs`);var r=e.GLOBAL_LOGGER.child(`[TronWalletRepo]`),i=class e extends n{constructor(){super(t.TronWalletEntity)}static get instance(){return e._instance||=new e,e._instance}async saveWallet(e,n=`nile-testnet`,i=null){let a=r.trace(`saveWallet`);try{let a=new t.TronWalletEntity;a.address=e.address,a.publicKey=e.publicKey,a.privateKey=e.privateKey,a.network=n,a.label=i;let o=await this.persist(a);return r.success(`Wallet saved to SQLite`,{address:o.address,id:o.id}),o}catch(e){throw r.error(`Failed to save wallet`,e),e}finally{a.end()}}async findByAddress(e){let t=r.trace(`findByAddress`);try{return await this.repository.findOneBy({address:e})??null}catch(e){throw r.error(`Failed to find wallet by address`,e),e}finally{t.end()}}async findByNetwork(e){let t=r.trace(`findByNetwork`);try{return await this.repository.findBy({network:e})}catch(e){throw r.error(`Failed to find wallets by network`,e),e}finally{t.end()}}};i._instance=void 0;var a=i.instance;exports.TRON_WALLET_REPO=a,exports.TronWalletRepoService=i;

package/dist/packages/w3/tron/tron-wallet.repo.d.ts

@@ -0,0 +1,30 @@
+import { default as BaseSQLiteRepoService } from '../../sqlite/repo.service';
+import { TronWalletEntity } from './tron-wallet.entity';
+import { TronWallet } from './tron.types';
+/**
+ * Repositorio para persistir y consultar wallets de Tron en SQLite local.
+ * Extiende BaseSQLiteRepoService para heredar persist / remove / findById / findAll.
+ */
+export declare class TronWalletRepoService extends BaseSQLiteRepoService<TronWalletEntity, typeof TronWalletEntity> {
+    private static _instance;
+    private constructor();
+    static get instance(): TronWalletRepoService;
+    /**
+     * Guarda una wallet recién generada.
+     * Mapea el DTO TronWallet → TronWalletEntity antes de persistir.
+     *
+     * @param wallet  Wallet generada por TronService.createWallet()
+     * @param network Red a la que pertenece (ej. "nile-testnet", "mainnet")
+     * @param label   Etiqueta opcional para identificar la wallet
+     */
+    saveWallet(wallet: TronWallet, network?: string, label?: string | null): Promise<TronWalletEntity>;
+    /**
+     * Busca una wallet por su dirección Base58.
+     */
+    findByAddress(address: string): Promise<TronWalletEntity | null>;
+    /**
+     * Filtra wallets por red (ej. todas las de testnet).
+     */
+    findByNetwork(network: string): Promise<TronWalletEntity[]>;
+}
+export declare const TRON_WALLET_REPO: TronWalletRepoService;

package/dist/packages/w3/tron/tron-wallet.repo.esm

@@ -0,0 +1,52 @@
+import { GLOBAL_LOGGER as e } from "../../logger/logger.esm";
+import { TronWalletEntity as t } from "./tron-wallet.entity.esm";
+import n from "../../sqlite/repo.service.esm";
+//#region src/packages/w3/tron/tron-wallet.repo.ts
+var r = e.child("[TronWalletRepo]"), i = class e extends n {
+	constructor() {
+		super(t);
+	}
+	static get instance() {
+		return e._instance ||= new e(), e._instance;
+	}
+	async saveWallet(e, n = "nile-testnet", i = null) {
+		let a = r.trace("saveWallet");
+		try {
+			let a = new t();
+			a.address = e.address, a.publicKey = e.publicKey, a.privateKey = e.privateKey, a.network = n, a.label = i;
+			let o = await this.persist(a);
+			return r.success("Wallet saved to SQLite", {
+				address: o.address,
+				id: o.id
+			}), o;
+		} catch (e) {
+			throw r.error("Failed to save wallet", e), e;
+		} finally {
+			a.end();
+		}
+	}
+	async findByAddress(e) {
+		let t = r.trace("findByAddress");
+		try {
+			return await this.repository.findOneBy({ address: e }) ?? null;
+		} catch (e) {
+			throw r.error("Failed to find wallet by address", e), e;
+		} finally {
+			t.end();
+		}
+	}
+	async findByNetwork(e) {
+		let t = r.trace("findByNetwork");
+		try {
+			return await this.repository.findBy({ network: e });
+		} catch (e) {
+			throw r.error("Failed to find wallets by network", e), e;
+		} finally {
+			t.end();
+		}
+	}
+};
+i._instance = void 0;
+var a = i.instance;
+//#endregion
+export { a as TRON_WALLET_REPO, i as TronWalletRepoService };

package/dist/packages/w3/tron/tron.service.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../logger/logger.cjs`);let t=require(`tronweb`);function n(e,t){if(!{}.hasOwnProperty.call(e,t))throw TypeError(`attempted to use private field on non-instance`);return e}var r=0;function i(e){return`__private_`+ r+++`_`+e}var a=e.GLOBAL_LOGGER.child(`[TronService]`),o=i(`instance`),s=class e{constructor(e){this.tronWeb=void 0,this.fullHost=void 0,this.networkHeaders=void 0,this.fullHost=e?.fullHost??`https://nile.trongrid.io`,this.networkHeaders=e?.headers,this.tronWeb=new t.TronWeb({fullHost:this.fullHost,headers:this.networkHeaders})}static get instance(){return n(e,o)[o]||(n(e,o)[o]=new e),n(e,o)[o]}buildSigner(e){return new t.TronWeb({fullHost:this.fullHost,headers:this.networkHeaders,privateKey:e})}async createWallet(){let e=a.trace(`createWallet`);try{let e=await this.tronWeb.createAccount();return a.success(`Wallet created successfully`,{address:e.address.base58}),{address:e.address.base58,privateKey:e.privateKey,publicKey:e.publicKey}}catch(e){throw a.error(`Failed to create wallet`,e),e}finally{e.end()}}async sendTrx(e,t,n){let r=a.trace(`sendTrx`);try{let r=this.buildSigner(n),i=Number(r.toSun(t)),o=await r.trx.sendTransaction(e,i);return o.result?(a.success(`TRX transaction broadcasted`,{txId:o.txid}),{success:!0,txId:o.txid}):(a.error(`TRX transaction rejected`,o),{success:!1,error:`Transaction rejected by network`})}catch(e){return a.error(`Failed to send TRX`,e),{success:!1,error:e.message??`Unknown error`}}finally{r.end()}}async sendTRC10(e){let t=a.trace(`sendTRC10`),{to:n,tokenId:r,amount:i,privateKey:o}=e;try{let e=await this.buildSigner(o).trx.sendToken(n,i,r);return e.result?(a.success(`TRC10 transfer broadcasted`,{txId:e.txid,tokenId:r,amount:i}),{success:!0,txId:e.txid}):(a.error(`TRC10 transfer rejected`,e),{success:!1,error:`TRC10 transfer rejected by network`})}catch(e){return a.error(`Failed to send TRC10 token`,e),{success:!1,error:e.message??`Unknown error`}}finally{t.end()}}async sendTRC20(e){let t=a.trace(`sendTRC20`),{to:n,contractAddress:r,amount:i,privateKey:o,feeLimit:s=1e5}=e;try{let e=await this.buildSigner(o).contract().at(r),t=Number(await e.decimals().call().catch(()=>6)),c=BigInt(Math.round(i*10**t)),l=await e.transfer(n,c).send({feeLimit:s,shouldPollResponse:!1});return l?(a.success(`TRC20 transfer broadcasted`,{txId:l,contractAddress:r,amount:i}),{success:!0,txId:l}):(a.error(`TRC20 transfer rejected`),{success:!1,error:`TRC20 transfer rejected by network`})}catch(e){return a.error(`Failed to send TRC20 token`,e),{success:!1,error:e.message??`Unknown error`}}finally{t.end()}}splitAmount(e,t,n=!1){let r=e*Math.min(Math.max(t,0),1),i=n?Math.floor(r):parseFloat(r.toFixed(8));return{commission:i,main:n?e-i:parseFloat((e-i).toFixed(8))}}async sendTrxSplit(e,t,n,r){let i=a.trace(`sendTrxSplit`),{commission:o,main:s}=this.splitAmount(t,r.rate);try{a.info(`TRX split transfer`,{total:t,commissionAmount:o,mainAmount:s,rate:r.rate});let i=await this.sendTrx(r.address,o,n),c=await this.sendTrx(e,s,n),l=i.success&&c.success,u=l?void 0:[!i.success&&`Comisión: ${i.error}`,!c.success&&`Principal: ${c.error}`].filter(Boolean).join(` | `);return a.info(`TRX split result`,{success:l,commissionTxId:i.txId,mainTxId:c.txId}),{success:l,mainAmount:s,mainTxId:c.txId,mainTx:c,commissionAmount:o,commissionTxId:i.txId,commissionTx:i,error:u}}catch(e){a.error(`Failed TRX split transfer`,e);let t={success:!1,error:e.message};return{success:!1,mainAmount:s,mainTx:t,commissionAmount:o,commissionTx:t,error:e.message}}finally{i.end()}}async sendTRC10Split(e,t){let n=a.trace(`sendTRC10Split`),{commission:r,main:i}=this.splitAmount(e.amount,t.rate,!0);try{a.info(`TRC10 split transfer`,{total:e.amount,commissionAmount:r,mainAmount:i});let n=await this.sendTRC10({...e,to:t.address,amount:r}),o=await this.sendTRC10({...e,amount:i}),s=n.success&&o.success,c=s?void 0:[!n.success&&`Comisión: ${n.error}`,!o.success&&`Principal: ${o.error}`].filter(Boolean).join(` | `);return{success:s,mainAmount:i,mainTxId:o.txId,mainTx:o,commissionAmount:r,commissionTxId:n.txId,commissionTx:n,error:c}}catch(e){a.error(`Failed TRC10 split transfer`,e);let t={success:!1,error:e.message};return{success:!1,mainAmount:i,mainTx:t,commissionAmount:r,commissionTx:t,error:e.message}}finally{n.end()}}async sendTRC20Split(e,t){let n=a.trace(`sendTRC20Split`),{commission:r,main:i}=this.splitAmount(e.amount,t.rate);try{a.info(`TRC20 split transfer`,{total:e.amount,commissionAmount:r,mainAmount:i});let n=await this.sendTRC20({...e,to:t.address,amount:r}),o=await this.sendTRC20({...e,amount:i}),s=n.success&&o.success,c=s?void 0:[!n.success&&`Comisión: ${n.error}`,!o.success&&`Principal: ${o.error}`].filter(Boolean).join(` | `);return{success:s,mainAmount:i,mainTxId:o.txId,mainTx:o,commissionAmount:r,commissionTxId:n.txId,commissionTx:n,error:c}}catch(e){a.error(`Failed TRC20 split transfer`,e);let t={success:!1,error:e.message};return{success:!1,mainAmount:i,mainTx:t,commissionAmount:r,commissionTx:t,error:e.message}}finally{n.end()}}getSenderAddress(e){return t.TronWeb.address.fromPrivateKey(e)}async sendTrxBatchAtomic(e){let t=a.trace(`sendTrxBatchAtomic`),{recipients:n,privateKey:r,contractAddress:i,feeLimit:o=5e5}=e,s=n.reduce((e,t)=>e+t.amount,0),c=Math.round(s*1e6),l=n.map(e=>e.address),u=n.map(e=>Math.round(e.amount*1e6));try{let e=this.buildSigner(r),t=this.getSenderAddress(r);a.info(`TRX batch atomic`,{recipients:n.length,totalTrx:s,contractAddress:i});let{transaction:d}=await e.transactionBuilder.triggerSmartContract(i,`batchSendTRX(address[],uint256[])`,{callValue:c,feeLimit:o},[{type:`address[]`,value:l},{type:`uint256[]`,value:u}],t),f=await e.trx.sign(d,r),p=await e.trx.sendRawTransaction(f);return p.result?(a.success(`TRX batch atomic success`,{txId:p.txid,recipients:n.length}),{success:!0,txId:p.txid,recipients:n,totalAmount:s}):{success:!1,recipients:n,totalAmount:s,error:`Contract call rejected`}}catch(e){return a.error(`TRX batch atomic failed`,e),{success:!1,recipients:n,totalAmount:s,error:e.message??`Unknown error`}}finally{t.end()}}async approveTRC20Batch(e,t,n,r,i=1e5){let o=a.trace(`approveTRC20Batch`);try{let o=await(await this.buildSigner(e).contract().at(t)).approve(n,r).send({feeLimit:i});return a.success(`TRC20 approve success`,{txId:o}),{success:!0,txId:o}}catch(e){return a.error(`TRC20 approve failed`,e),{success:!1,error:e.message}}finally{o.end()}}async sendTRC20BatchAtomic(e){let t=a.trace(`sendTRC20BatchAtomic`),{recipients:n,privateKey:r,tokenContractAddress:i,batchContractAddress:o,decimals:s,feeLimit:c=1e6}=e;try{let e=this.buildSigner(r),t=this.getSenderAddress(r),l=10**(s??await(async()=>{let t=await e.contract().at(i);return Number(await t.decimals().call().catch(()=>6))})()),u=n.reduce((e,t)=>e+t.amount,0),d=n.map(e=>e.address),f=n.map(e=>BigInt(Math.round(e.amount*l)).toString());a.info(`TRC20 batch atomic`,{recipients:n.length,totalAmount:u,tokenContractAddress:i});let{transaction:p}=await e.transactionBuilder.triggerSmartContract(o,`batchSendTRC20(address,address[],uint256[])`,{feeLimit:c},[{type:`address`,value:i},{type:`address[]`,value:d},{type:`uint256[]`,value:f}],t),m=await e.trx.sign(p,r),h=await e.trx.sendRawTransaction(m);return h.result?(a.success(`TRC20 batch atomic success`,{txId:h.txid}),{success:!0,txId:h.txid,recipients:n,totalAmount:u}):{success:!1,recipients:n,totalAmount:u,error:`Contract call rejected`}}catch(e){return a.error(`TRC20 batch atomic failed`,e),{success:!1,recipients:n,totalAmount:0,error:e.message??`Unknown error`}}finally{t.end()}}async sendTrxSplitAtomic(e,t,n,r,i,a){let{commission:o,main:s}=this.splitAmount(t,r.rate);return this.sendTrxBatchAtomic({recipients:[{address:r.address,amount:o,label:`commission`},{address:e,amount:s,label:`main`}],privateKey:n,contractAddress:i,feeLimit:a})}async sendTRC20SplitAtomic(e,t,n,r){let{commission:i,main:a}=this.splitAmount(e.amount,t.rate);return this.sendTRC20BatchAtomic({recipients:[{address:t.address,amount:i,label:`commission`},{address:e.to,amount:a,label:`main`}],privateKey:e.privateKey,tokenContractAddress:e.contractAddress,batchContractAddress:n,feeLimit:r})}};Object.defineProperty(s,o,{writable:!0,value:void 0});var c=s.instance;exports.TRON_SERVICE=c,exports.TronService=s;

package/dist/packages/w3/tron/tron.service.d.ts

@@ -0,0 +1,124 @@
+import { TronWallet, TronTransactionResult, TronTRC10TransferParams, TronTRC20TransferParams, TronCommissionConfig, TronSplitResult, TronBatchResult, TronApproveResult, TronTRXBatchParams, TronTRC20BatchParams } from './tron.types';
+export declare class TronService {
+    #private;
+    private tronWeb;
+    private readonly fullHost;
+    private readonly networkHeaders?;
+    private constructor();
+    static get instance(): TronService;
+    /**
+     * Instancia TronWeb temporal con la privateKey del emisor.
+     * La clave nunca persiste en el singleton — seguro para multi-wallet.
+     */
+    private buildSigner;
+    /**
+     * Genera una nueva billetera de Tron.
+     * No está ligada a ninguna wallet en particular — solo usa la red configurada.
+     */
+    createWallet(): Promise<TronWallet>;
+    /**
+     * Envía TRX de una cuenta a otra.
+     * Cada llamada opera con su propia instancia de TronWeb para que
+     * la privateKey no persista en el servicio (multi-wallet seguro).
+     *
+     * @param to         Dirección destino en formato Base58
+     * @param amount     Cantidad de TRX (convertida a SUN automáticamente)
+     * @param privateKey Clave privada de la cuenta origen
+     */
+    sendTrx(to: string, amount: number, privateKey: string): Promise<TronTransactionResult>;
+    /**
+     * Transfiere un token TRC10 (token nativo de la red Tron).
+     *
+     * @param params.to          Dirección destino Base58
+     * @param params.tokenId     ID numérico del token TRC10
+     * @param params.amount      Cantidad en unidad mínima del token
+     * @param params.privateKey  Clave privada del emisor
+     */
+    sendTRC10(params: TronTRC10TransferParams): Promise<TronTransactionResult>;
+    /**
+     * Transfiere un token TRC20 (contrato ERC20-like en Tron).
+     * Obtiene los decimals del contrato en runtime para convertir el amount correctamente.
+     *
+     * @param params.to               Dirección destino Base58
+     * @param params.contractAddress  Dirección del contrato TRC20
+     * @param params.amount           Cantidad legible (se multiplica por 10^decimals)
+     * @param params.privateKey       Clave privada del emisor
+     * @param params.feeLimit         Límite de energía en SUN (default: 100_000)
+     */
+    sendTRC20(params: TronTRC20TransferParams): Promise<TronTransactionResult>;
+    /**
+     * Calcula los montos de comisión y principal a partir del total y la tasa.
+     * Redondea a enteros cuando el tipo lo requiere (TRC10).
+     */
+    private splitAmount;
+    /**
+     * Envía TRX dividido en dos transacciones:
+     * 1. `amount * commission.rate`  → wallet de comisión
+     * 2. `amount * (1 - commission.rate)` → destino original
+     *
+     * @param to         Dirección destino original
+     * @param amount     Total de TRX a enviar (legible)
+     * @param privateKey Clave privada del emisor
+     * @param commission Configuración de wallet base y porcentaje
+     */
+    sendTrxSplit(to: string, amount: number, privateKey: string, commission: TronCommissionConfig): Promise<TronSplitResult>;
+    /**
+     * Transfiere un token TRC10 dividido:
+     * 1. `amount * commission.rate`  → wallet de comisión  (floor al entero)
+     * 2. `amount - commissionAmount` → destino original
+     */
+    sendTRC10Split(params: TronTRC10TransferParams, commission: TronCommissionConfig): Promise<TronSplitResult>;
+    /**
+     * Transfiere un token TRC20 dividido:
+     * 1. `amount * commission.rate`  → wallet de comisión
+     * 2. `amount * (1 - commission.rate)` → destino original
+     * El contrato se consulta una sola vez para los decimals.
+     */
+    sendTRC20Split(params: TronTRC20TransferParams, commission: TronCommissionConfig): Promise<TronSplitResult>;
+    /**
+     * Obtiene la dirección Base58 del firmante a partir de su privateKey.
+     */
+    private getSenderAddress;
+    /**
+     * Envía TRX a múltiples destinatarios en UNA sola transacción atómica
+     * mediante el contrato TronMultisender.batchSendTRX().
+     *
+     * ✅ Atómico: si cualquier sub-transferencia falla, toda la TX se revierte.
+     * ⚠️ Requiere el contrato desplegado en la red (ver TronMultisender.sol).
+     *
+     * @param params.recipients       Array de { address, amount (TRX legible) }
+     * @param params.privateKey       Clave privada del emisor
+     * @param params.contractAddress  Dirección Base58 del contrato desplegado
+     * @param params.feeLimit         Energía máxima. Default: 500_000
+     */
+    sendTrxBatchAtomic(params: TronTRXBatchParams): Promise<TronBatchResult>;
+    /**
+     * Ejecuta el paso previo de approve para batch TRC20.
+     * El emisor autoriza al contrato a gastar `totalRawAmount` del token.
+     *
+     * Llamar antes de sendTRC20BatchAtomic cuando el allowance sea insuficiente.
+     */
+    approveTRC20Batch(privateKey: string, tokenContractAddress: string, batchContractAddress: string, totalRawAmount: bigint, feeLimit?: number): Promise<TronApproveResult>;
+    /**
+     * Envía tokens TRC20 a múltiples destinatarios en UNA sola transacción atómica
+     * mediante el contrato TronMultisender.batchSendTRC20().
+     *
+     * ✅ Atómico: si cualquier sub-transferencia falla, toda la TX se revierte.
+     * ⚠️ Requiere approve previo con approveTRC20Batch() o allowance suficiente.
+     * ⚠️ Requiere el contrato desplegado en la red.
+     *
+     * @param params.decimals  Si no se provee, se consulta al contrato (1 call extra)
+     */
+    sendTRC20BatchAtomic(params: TronTRC20BatchParams): Promise<TronBatchResult>;
+    /**
+     * Split TRX atómico: comisión + destino en UNA sola TX via contrato.
+     * Si cualquiera falla (ej. fondos insuficientes), NINGUNA se procesa.
+     */
+    sendTrxSplitAtomic(to: string, amount: number, privateKey: string, commission: TronCommissionConfig, contractAddress: string, feeLimit?: number): Promise<TronBatchResult>;
+    /**
+     * Split TRC20 atómico: comisión + destino en UNA sola TX via contrato.
+     * Requiere approve previo con approveTRC20Batch().
+     */
+    sendTRC20SplitAtomic(params: TronTRC20TransferParams, commission: TronCommissionConfig, batchContractAddress: string, feeLimit?: number): Promise<TronBatchResult>;
+}
+export declare const TRON_SERVICE: TronService;