@meshconnect/uwc-tron-connector 0.1.0

package/dist/wallets/base.d.ts

@@ -0,0 +1,87 @@
+import type { SignedTronTransaction } from '../rest/trongrid-client';
+/**
+ * The subset of an injected wallet's `tronWeb` we rely on. Each wallet ships
+ * its own `tronWeb` (with the user's keys wired in) inside its provider; the
+ * crypto runs there, at zero bundle cost to us.
+ */
+export interface InjectedTronWeb {
+    defaultAddress?: {
+        base58?: string | false;
+        hex?: string | false;
+    };
+    trx: {
+        /** Sign an unsigned transaction object. Returns the signed transaction. */
+        sign(transaction: unknown): Promise<SignedTronTransaction>;
+        /** Sign a plain string message (TIP-191). Present on all 5 target wallets. */
+        signMessageV2?(message: string): Promise<string>;
+    };
+}
+/**
+ * The shape every supported wallet exposes at its window namespace. Wallets
+ * differ in where this object lives (see each wrapper), not in its surface.
+ */
+export interface InjectedTronProvider {
+    tronWeb?: InjectedTronWeb;
+    /** Account-request entry point (`tron_requestAccounts`). */
+    request?(args: {
+        method: string;
+        params?: unknown;
+    }): Promise<unknown>;
+    on?(event: string, handler: (...args: unknown[]) => void): void;
+    removeListener?(event: string, handler: (...args: unknown[]) => void): void;
+}
+/**
+ * One wrapper per wallet. Keeps every per-wallet quirk — namespace path, ready
+ * signal — isolated to a single ~30-line file, so a wallet change is a local
+ * patch (and a single wallet can be flag-disabled without touching the rest).
+ */
+export interface TronWalletWrapper {
+    /** Stable id; matches `WalletMetadata.id` callers pass in. */
+    id: string;
+    /** Human-readable name; surfaced via `getAvailableWallets`. */
+    displayName: string;
+    /** Read the provider from its window namespace, or undefined if absent. */
+    resolveProvider(): InjectedTronProvider | undefined;
+    /**
+     * Window event that fires when the wallet finishes injecting, if it has one.
+     * Lets detection resolve immediately instead of waiting on the poll tick.
+     * TronLink is currently the only target wallet that emits one.
+     */
+    readyEventName?: string;
+}
+/** Safely walk `window` down a path of keys (e.g. ['okxwallet','tronLink']). */
+export declare function readWindowPath(path: readonly string[]): InjectedTronProvider | undefined;
+/**
+ * A provider counts as present/detectable once it exposes a `request` method
+ * (the connect entry point) or already carries a `tronWeb` instance.
+ *
+ * Important: we must NOT require `tronWeb` here. Wallets like TronLink inject
+ * `window.tronLink` with `request` immediately but only populate `tronWeb`
+ * (and the account) AFTER the user approves `tron_requestAccounts`. Requiring
+ * `tronWeb` for detection would make the wallet un-discoverable until it's
+ * connected — a chicken-and-egg that hides it from the wallet list entirely.
+ */
+export declare function isProviderReady(provider: InjectedTronProvider | undefined): provider is InjectedTronProvider;
+/**
+ * After `connect`, poll briefly for the wallet's account address. TronLink (and
+ * the TronLink-compatible wallets) populate `tronWeb.defaultAddress.base58` a
+ * tick or two after `tron_requestAccounts` resolves, so a single synchronous
+ * read can miss it. Resolves the base58 address, or `undefined` on timeout.
+ */
+export declare function waitForWalletAddress(provider: InjectedTronProvider, timeoutMs?: number, pollIntervalMs?: number): Promise<string | undefined>;
+/**
+ * Pick the first *ready* provider among the candidates (in preference order).
+ * If none is ready yet, return the first one that merely exists, so
+ * `detectProvider` keeps polling it — re-evaluated each tick, so a path that
+ * becomes ready later still wins. Used by wallets exposed at more than one
+ * window namespace (casing/legacy variants).
+ */
+export declare function firstReadyOf(...candidates: Array<InjectedTronProvider | undefined>): InjectedTronProvider | undefined;
+/**
+ * Resolve a wallet's provider, waiting up to `timeoutMs` for it to finish
+ * injecting. Polling covers all wallets; an optional `readyEventName` provides
+ * a fast path for wallets that announce readiness (TronLink's TIP-6963-style
+ * signal). Resolves `undefined` if the wallet never appears.
+ */
+export declare function detectProvider(wrapper: TronWalletWrapper, timeoutMs?: number, pollIntervalMs?: number): Promise<InjectedTronProvider | undefined>;
+//# sourceMappingURL=base.d.ts.map

package/dist/wallets/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/wallets/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAEpE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE;QACf,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;QACvB,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;KACrB,CAAA;IACD,GAAG,EAAE;QACH,2EAA2E;QAC3E,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;QAC1D,8EAA8E;QAC9E,aAAa,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;KACjD,CAAA;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB,4DAA4D;IAC5D,OAAO,CAAC,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACtE,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAA;IAC/D,cAAc,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAA;CAC5E;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAA;IACV,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAA;IACnB,2EAA2E;IAC3E,eAAe,IAAI,oBAAoB,GAAG,SAAS,CAAA;IACnD;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,oBAAoB,GAAG,SAAS,CASlC;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GACzC,QAAQ,IAAI,oBAAoB,CAIlC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,SAAO,EAChB,cAAc,SAAK,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuB7B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,GAAG,UAAU,EAAE,KAAK,CAAC,oBAAoB,GAAG,SAAS,CAAC,GACrD,oBAAoB,GAAG,SAAS,CAKlC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,SAAS,SAAO,EAChB,cAAc,SAAK,GAClB,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAsC3C"}

package/dist/wallets/base.js

@@ -0,0 +1,118 @@
+/** Safely walk `window` down a path of keys (e.g. ['okxwallet','tronLink']). */
+export function readWindowPath(path) {
+    if (typeof window === 'undefined')
+        return undefined;
+    let node = window;
+    for (const key of path) {
+        if (node == null || typeof node !== 'object')
+            return undefined;
+        node = node[key];
+    }
+    if (node == null || typeof node !== 'object')
+        return undefined;
+    return node;
+}
+/**
+ * A provider counts as present/detectable once it exposes a `request` method
+ * (the connect entry point) or already carries a `tronWeb` instance.
+ *
+ * Important: we must NOT require `tronWeb` here. Wallets like TronLink inject
+ * `window.tronLink` with `request` immediately but only populate `tronWeb`
+ * (and the account) AFTER the user approves `tron_requestAccounts`. Requiring
+ * `tronWeb` for detection would make the wallet un-discoverable until it's
+ * connected — a chicken-and-egg that hides it from the wallet list entirely.
+ */
+export function isProviderReady(provider) {
+    return (!!provider && (typeof provider.request === 'function' || !!provider.tronWeb));
+}
+/**
+ * After `connect`, poll briefly for the wallet's account address. TronLink (and
+ * the TronLink-compatible wallets) populate `tronWeb.defaultAddress.base58` a
+ * tick or two after `tron_requestAccounts` resolves, so a single synchronous
+ * read can miss it. Resolves the base58 address, or `undefined` on timeout.
+ */
+export function waitForWalletAddress(provider, timeoutMs = 3000, pollIntervalMs = 50) {
+    const read = () => {
+        const base58 = provider.tronWeb?.defaultAddress?.base58;
+        return typeof base58 === 'string' && base58.length > 0 ? base58 : undefined;
+    };
+    const immediate = read();
+    if (immediate)
+        return Promise.resolve(immediate);
+    return new Promise(resolve => {
+        let settled = false;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            clearInterval(timer);
+            clearTimeout(deadline);
+            resolve(value);
+        };
+        const timer = setInterval(() => {
+            const address = read();
+            if (address)
+                finish(address);
+        }, pollIntervalMs);
+        const deadline = setTimeout(() => finish(undefined), timeoutMs);
+    });
+}
+/**
+ * Pick the first *ready* provider among the candidates (in preference order).
+ * If none is ready yet, return the first one that merely exists, so
+ * `detectProvider` keeps polling it — re-evaluated each tick, so a path that
+ * becomes ready later still wins. Used by wallets exposed at more than one
+ * window namespace (casing/legacy variants).
+ */
+export function firstReadyOf(...candidates) {
+    for (const candidate of candidates) {
+        if (isProviderReady(candidate))
+            return candidate;
+    }
+    return candidates.find(candidate => candidate != null);
+}
+/**
+ * Resolve a wallet's provider, waiting up to `timeoutMs` for it to finish
+ * injecting. Polling covers all wallets; an optional `readyEventName` provides
+ * a fast path for wallets that announce readiness (TronLink's TIP-6963-style
+ * signal). Resolves `undefined` if the wallet never appears.
+ */
+export function detectProvider(wrapper, timeoutMs = 3000, pollIntervalMs = 50) {
+    const immediate = wrapper.resolveProvider();
+    if (isProviderReady(immediate))
+        return Promise.resolve(immediate);
+    // No browser context (SSR/non-browser): no wallet can ever appear, so resolve
+    // immediately instead of polling out the full timeout.
+    if (typeof window === 'undefined')
+        return Promise.resolve(undefined);
+    return new Promise(resolve => {
+        let settled = false;
+        // Declared up front (not `const` after `finish`) so `finish` never
+        // forward-references an uninitialized binding, even under future refactors.
+        let timer;
+        let deadline;
+        const onReady = () => tryResolve();
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearInterval(timer);
+            clearTimeout(deadline);
+            if (wrapper.readyEventName && typeof window !== 'undefined') {
+                window.removeEventListener(wrapper.readyEventName, onReady);
+            }
+            resolve(result);
+        };
+        function tryResolve() {
+            const provider = wrapper.resolveProvider();
+            if (isProviderReady(provider))
+                finish(provider);
+        }
+        if (wrapper.readyEventName && typeof window !== 'undefined') {
+            window.addEventListener(wrapper.readyEventName, onReady);
+        }
+        timer = setInterval(tryResolve, pollIntervalMs);
+        deadline = setTimeout(() => finish(undefined), timeoutMs);
+    });
+}
+//# sourceMappingURL=base.js.map

package/dist/wallets/base.js.map

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

package/dist/wallets/bitget.d.ts

@@ -0,0 +1,8 @@
+import { type TronWalletWrapper } from './base';
+/**
+ * Bitget Wallet (formerly BitKeep) — injects at `window.bitkeep`. The Tron
+ * provider lives under `window.bitkeep.tronLink`; older builds exposed it on
+ * `window.bitkeep` directly, so we fall back to that.
+ */
+export declare const bitget: TronWalletWrapper;
+//# sourceMappingURL=bitget.d.ts.map

package/dist/wallets/bitget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitget.d.ts","sourceRoot":"","sources":["../../src/wallets/bitget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAE7E;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,iBASpB,CAAA"}

package/dist/wallets/bitget.js

@@ -0,0 +1,14 @@
+import { readWindowPath, firstReadyOf } from './base';
+/**
+ * Bitget Wallet (formerly BitKeep) — injects at `window.bitkeep`. The Tron
+ * provider lives under `window.bitkeep.tronLink`; older builds exposed it on
+ * `window.bitkeep` directly, so we fall back to that.
+ */
+export const bitget = {
+    id: 'bitget',
+    displayName: 'Bitget Wallet',
+    resolveProvider() {
+        return firstReadyOf(readWindowPath(['bitkeep', 'tronLink']), readWindowPath(['bitkeep']));
+    }
+};
+//# sourceMappingURL=bitget.js.map

package/dist/wallets/bitget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitget.js","sourceRoot":"","sources":["../../src/wallets/bitget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAA0B,MAAM,QAAQ,CAAA;AAE7E;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAsB;IACvC,EAAE,EAAE,QAAQ;IACZ,WAAW,EAAE,eAAe;IAC5B,eAAe;QACb,OAAO,YAAY,CACjB,cAAc,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,EACvC,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,CAC5B,CAAA;IACH,CAAC;CACF,CAAA"}

package/dist/wallets/okx.d.ts

@@ -0,0 +1,4 @@
+import { type TronWalletWrapper } from './base';
+/** OKX Wallet — exposes a TronLink-compatible provider at `window.okxwallet.tronLink`. */
+export declare const okx: TronWalletWrapper;
+//# sourceMappingURL=okx.d.ts.map

package/dist/wallets/okx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"okx.d.ts","sourceRoot":"","sources":["../../src/wallets/okx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAE/D,0FAA0F;AAC1F,eAAO,MAAM,GAAG,EAAE,iBAMjB,CAAA"}

package/dist/wallets/okx.js

@@ -0,0 +1,10 @@
+import { readWindowPath } from './base';
+/** OKX Wallet — exposes a TronLink-compatible provider at `window.okxwallet.tronLink`. */
+export const okx = {
+    id: 'okx',
+    displayName: 'OKX Wallet',
+    resolveProvider() {
+        return readWindowPath(['okxwallet', 'tronLink']);
+    }
+};
+//# sourceMappingURL=okx.js.map

package/dist/wallets/okx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"okx.js","sourceRoot":"","sources":["../../src/wallets/okx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA0B,MAAM,QAAQ,CAAA;AAE/D,0FAA0F;AAC1F,MAAM,CAAC,MAAM,GAAG,GAAsB;IACpC,EAAE,EAAE,KAAK;IACT,WAAW,EAAE,YAAY;IACzB,eAAe;QACb,OAAO,cAAc,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAA;IAClD,CAAC;CACF,CAAA"}

package/dist/wallets/registry.d.ts

@@ -0,0 +1,8 @@
+import type { TronWalletId } from '@meshconnect/uwc-types';
+import type { TronWalletWrapper } from './base';
+export type { TronWalletId } from '@meshconnect/uwc-types';
+/** All supported wallet wrappers, keyed by id. */
+export declare const TRON_WALLET_REGISTRY: Record<TronWalletId, TronWalletWrapper>;
+export declare const ALL_TRON_WALLET_IDS: readonly TronWalletId[];
+export declare function isTronWalletId(value: string): value is TronWalletId;
+//# sourceMappingURL=registry.d.ts.map

package/dist/wallets/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/wallets/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAO/C,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAE1D,kDAAkD;AAClD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,YAAY,EAAE,iBAAiB,CAMxE,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,SAAS,YAAY,EAEtD,CAAA;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAEnE"}

package/dist/wallets/registry.js

@@ -0,0 +1,18 @@
+import { tronlink } from './tronlink';
+import { okx } from './okx';
+import { trust } from './trust';
+import { bitget } from './bitget';
+import { tokenpocket } from './tokenpocket';
+/** All supported wallet wrappers, keyed by id. */
+export const TRON_WALLET_REGISTRY = {
+    tronlink,
+    bitget,
+    okx,
+    tokenpocket,
+    trust
+};
+export const ALL_TRON_WALLET_IDS = Object.freeze(Object.keys(TRON_WALLET_REGISTRY));
+export function isTronWalletId(value) {
+    return ALL_TRON_WALLET_IDS.includes(value);
+}
+//# sourceMappingURL=registry.js.map

package/dist/wallets/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/wallets/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAI3C,kDAAkD;AAClD,MAAM,CAAC,MAAM,oBAAoB,GAA4C;IAC3E,QAAQ;IACR,MAAM;IACN,GAAG;IACH,WAAW;IACX,KAAK;CACN,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAA4B,MAAM,CAAC,MAAM,CACvE,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAmB,CACpD,CAAA;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAQ,mBAAyC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACnE,CAAC"}

package/dist/wallets/tokenpocket.d.ts

@@ -0,0 +1,9 @@
+import { type TronWalletWrapper } from './base';
+/**
+ * TokenPocket — injects at `window.tokenpocket`, exposing its Tron provider at
+ * `window.tokenpocket.tron`. We target that nested path specifically rather
+ * than the shared `window.tronLink` global TokenPocket also populates, so it is
+ * never mis-detected as TronLink.
+ */
+export declare const tokenpocket: TronWalletWrapper;
+//# sourceMappingURL=tokenpocket.d.ts.map

package/dist/wallets/tokenpocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenpocket.d.ts","sourceRoot":"","sources":["../../src/wallets/tokenpocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,iBAMzB,CAAA"}

package/dist/wallets/tokenpocket.js

@@ -0,0 +1,15 @@
+import { readWindowPath } from './base';
+/**
+ * TokenPocket — injects at `window.tokenpocket`, exposing its Tron provider at
+ * `window.tokenpocket.tron`. We target that nested path specifically rather
+ * than the shared `window.tronLink` global TokenPocket also populates, so it is
+ * never mis-detected as TronLink.
+ */
+export const tokenpocket = {
+    id: 'tokenpocket',
+    displayName: 'TokenPocket',
+    resolveProvider() {
+        return readWindowPath(['tokenpocket', 'tron']);
+    }
+};
+//# sourceMappingURL=tokenpocket.js.map

package/dist/wallets/tokenpocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenpocket.js","sourceRoot":"","sources":["../../src/wallets/tokenpocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA0B,MAAM,QAAQ,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAsB;IAC5C,EAAE,EAAE,aAAa;IACjB,WAAW,EAAE,aAAa;IAC1B,eAAe;QACb,OAAO,cAAc,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAA;IAChD,CAAC;CACF,CAAA"}

package/dist/wallets/tronlink.d.ts

@@ -0,0 +1,8 @@
+import { type TronWalletWrapper } from './base';
+/**
+ * TronLink — `window.tronLink` (legacy) or `window.tron` (TIP-1193).
+ * The only target wallet that announces readiness, via the
+ * `tronLink#initialized` window event.
+ */
+export declare const tronlink: TronWalletWrapper;
+//# sourceMappingURL=tronlink.d.ts.map

package/dist/wallets/tronlink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tronlink.d.ts","sourceRoot":"","sources":["../../src/wallets/tronlink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAE7E;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,iBAOtB,CAAA"}

package/dist/wallets/tronlink.js

@@ -0,0 +1,15 @@
+import { readWindowPath, firstReadyOf } from './base';
+/**
+ * TronLink — `window.tronLink` (legacy) or `window.tron` (TIP-1193).
+ * The only target wallet that announces readiness, via the
+ * `tronLink#initialized` window event.
+ */
+export const tronlink = {
+    id: 'tronlink',
+    displayName: 'TronLink',
+    readyEventName: 'tronLink#initialized',
+    resolveProvider() {
+        return firstReadyOf(readWindowPath(['tronLink']), readWindowPath(['tron']));
+    }
+};
+//# sourceMappingURL=tronlink.js.map

package/dist/wallets/tronlink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tronlink.js","sourceRoot":"","sources":["../../src/wallets/tronlink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAA0B,MAAM,QAAQ,CAAA;AAE7E;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAsB;IACzC,EAAE,EAAE,UAAU;IACd,WAAW,EAAE,UAAU;IACvB,cAAc,EAAE,sBAAsB;IACtC,eAAe;QACb,OAAO,YAAY,CAAC,cAAc,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAC7E,CAAC;CACF,CAAA"}

package/dist/wallets/trust.d.ts

@@ -0,0 +1,9 @@
+import { type TronWalletWrapper } from './base';
+/**
+ * Trust Wallet — TronLink-compatible provider. The repo's existing wallet
+ * metadata uses `window.trustWallet.tronLink` (capital W), so we prefer that,
+ * then the all-lowercase `window.trustwallet.tronLink` that some extension
+ * versions expose, to avoid casing-related false negatives.
+ */
+export declare const trust: TronWalletWrapper;
+//# sourceMappingURL=trust.d.ts.map

package/dist/wallets/trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.d.ts","sourceRoot":"","sources":["../../src/wallets/trust.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,KAAK,EAAE,iBASnB,CAAA"}

package/dist/wallets/trust.js

@@ -0,0 +1,15 @@
+import { readWindowPath, firstReadyOf } from './base';
+/**
+ * Trust Wallet — TronLink-compatible provider. The repo's existing wallet
+ * metadata uses `window.trustWallet.tronLink` (capital W), so we prefer that,
+ * then the all-lowercase `window.trustwallet.tronLink` that some extension
+ * versions expose, to avoid casing-related false negatives.
+ */
+export const trust = {
+    id: 'trust',
+    displayName: 'Trust Wallet',
+    resolveProvider() {
+        return firstReadyOf(readWindowPath(['trustWallet', 'tronLink']), readWindowPath(['trustwallet', 'tronLink']));
+    }
+};
+//# sourceMappingURL=trust.js.map

package/dist/wallets/trust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.js","sourceRoot":"","sources":["../../src/wallets/trust.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAA0B,MAAM,QAAQ,CAAA;AAE7E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAsB;IACtC,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,cAAc;IAC3B,eAAe;QACb,OAAO,YAAY,CACjB,cAAc,CAAC,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,EAC3C,cAAc,CAAC,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAC5C,CAAA;IACH,CAAC;CACF,CAAA"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@meshconnect/uwc-tron-connector",
+  "version": "0.1.0",
+  "description": "Mesh-owned Tron wallet connector for Universal Wallet Connector — zero third-party Tron runtime deps; signs via the wallet's injected tronWeb, builds/broadcasts via the Tron full-node HTTP API",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@meshconnect/uwc-types": "0.15.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "type-check": "tsc --noEmit"
+  }
+}

package/src/events/state-machine.ts

@@ -0,0 +1,44 @@
+/**
+ * Minimal connection state machine + subscription surface.
+ *
+ * The connector exposes a single `onStateChange` callback rather than the
+ * full wallet event set — enough for `core` to react to disconnects and
+ * account changes without leaking per-wallet event shapes.
+ */
+import type { TronWalletId } from '@meshconnect/uwc-types'
+
+export type TronConnectionStatus = 'disconnected' | 'connecting' | 'connected'
+
+export interface TronConnectionState {
+  status: TronConnectionStatus
+  /** Active wallet id, when connected/connecting. */
+  walletId?: TronWalletId
+  /** Active account address (base58), when connected. */
+  address?: string
+}
+
+export type TronStateListener = (state: TronConnectionState) => void
+
+export class TronStateMachine {
+  private state: TronConnectionState = { status: 'disconnected' }
+  private readonly listeners = new Set<TronStateListener>()
+
+  get(): TronConnectionState {
+    return this.state
+  }
+
+  set(next: TronConnectionState): void {
+    this.state = next
+    for (const listener of this.listeners) {
+      listener(next)
+    }
+  }
+
+  /** Subscribe to state transitions. Returns an unsubscribe function. */
+  subscribe(listener: TronStateListener): () => void {
+    this.listeners.add(listener)
+    return () => {
+      this.listeners.delete(listener)
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,17 @@
+export { TronConnector } from './tron-connector'
+export {
+  ALL_TRON_WALLET_IDS,
+  TRON_WALLET_REGISTRY,
+  isTronWalletId
+} from './wallets/registry'
+export type { TronWalletWrapper, InjectedTronProvider } from './wallets/base'
+export type {
+  TronConnectionState,
+  TronConnectionStatus,
+  TronStateListener
+} from './events/state-machine'
+export type {
+  UnsignedTronTransaction,
+  SignedTronTransaction
+} from './rest/trongrid-client'
+export type { TronConnectorConfig, TronGridConfig, TronWalletId } from './types'

package/src/rest/abi.test.ts

@@ -0,0 +1,25 @@
+import { describe, it, expect } from 'vitest'
+import { encodeTrc20TransferParams, TRC20_TRANSFER_SELECTOR } from './abi'
+
+const USDT_BASE58 = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
+const USDT_EVM_HEX = 'a614f803b6fd780986a42c78ec9c7f77e6ded13c'
+
+describe('encodeTrc20TransferParams', () => {
+  it('encodes address + amount as two left-padded 32-byte words', () => {
+    const encoded = encodeTrc20TransferParams(USDT_BASE58, 1_000_000)
+    expect(encoded).toHaveLength(128)
+    expect(encoded.slice(0, 64)).toBe(USDT_EVM_HEX.padStart(64, '0'))
+    // 1_000_000 == 0xf4240
+    expect(encoded.slice(64)).toBe('f4240'.padStart(64, '0'))
+  })
+
+  it('handles bigint amounts beyond Number.MAX_SAFE_INTEGER', () => {
+    const amount = 123456789012345678901234567890n
+    const encoded = encodeTrc20TransferParams(USDT_BASE58, amount)
+    expect(encoded.slice(64)).toBe(amount.toString(16).padStart(64, '0'))
+  })
+
+  it('exposes the canonical selector string', () => {
+    expect(TRC20_TRANSFER_SELECTOR).toBe('transfer(address,uint256)')
+  })
+})

package/src/rest/abi.ts

@@ -0,0 +1,33 @@
+import { tronAddressToEvmHex } from './address'
+
+/**
+ * ABI-encode the arguments for `transfer(address,uint256)` (TRC20 / TEP-20).
+ *
+ * The full-node `/wallet/triggersmartcontract` endpoint takes the function
+ * selector as a literal string and the *arguments* as a hex `parameter` blob.
+ * Each argument is left-padded to a 32-byte (64-hex-char) word:
+ *   - address: the bare 20-byte body, left-padded to 32 bytes.
+ *   - uint256: the amount, left-padded to 32 bytes.
+ *
+ * @param to     recipient address (base58 or hex)
+ * @param amount token amount in base units
+ * @returns 128-hex-char parameter string (no `0x` prefix)
+ */
+export function encodeTrc20TransferParams(
+  to: string,
+  amount: number | bigint
+): string {
+  const addressWord = tronAddressToEvmHex(to).padStart(64, '0')
+  const amountWord = BigInt(amount).toString(16).padStart(64, '0')
+  return addressWord + amountWord
+}
+
+/** Function selector string the full node hashes for a TRC20 transfer. */
+export const TRC20_TRANSFER_SELECTOR = 'transfer(address,uint256)'
+
+/**
+ * The 4-byte selector (8 hex chars) for `transfer(address,uint256)` —
+ * `keccak256("transfer(address,uint256)")[:4]`, same as ERC-20. Used to
+ * reconstruct and verify the full call data the node built before signing.
+ */
+export const TRC20_TRANSFER_SELECTOR_HASH = 'a9059cbb'

package/src/rest/address.test.ts

@@ -0,0 +1,55 @@
+import { describe, it, expect } from 'vitest'
+import {
+  tronAddressToHex,
+  tronAddressToEvmHex,
+  assertValidTronChecksum
+} from './address'
+
+// USDT-TRON contract — a well-known, stable base58 ↔ hex pair.
+const USDT_BASE58 = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
+const USDT_HEX = '41a614f803b6fd780986a42c78ec9c7f77e6ded13c'
+const USDT_EVM_HEX = 'a614f803b6fd780986a42c78ec9c7f77e6ded13c'
+
+describe('tronAddressToHex', () => {
+  it('decodes a base58 address to its 21-byte hex form', () => {
+    expect(tronAddressToHex(USDT_BASE58)).toBe(USDT_HEX)
+  })
+
+  it('passes through an already-hex address (normalised, lowercased)', () => {
+    expect(tronAddressToHex(USDT_HEX.toUpperCase())).toBe(USDT_HEX)
+    expect(tronAddressToHex(`0x${USDT_HEX}`)).toBe(USDT_HEX)
+  })
+
+  it('throws on an invalid base58 character', () => {
+    expect(() => tronAddressToHex('T0OIl')).toThrow(/invalid base58/)
+  })
+
+  it('throws when the decoded payload is the wrong length', () => {
+    // Valid base58 chars, but far too short to be a 25-byte Tron address.
+    expect(() => tronAddressToHex('abc')).toThrow(/25 bytes/)
+  })
+})
+
+describe('tronAddressToEvmHex', () => {
+  it('strips the 0x41 prefix, leaving the 20-byte body', () => {
+    expect(tronAddressToEvmHex(USDT_BASE58)).toBe(USDT_EVM_HEX)
+    expect(tronAddressToEvmHex(USDT_BASE58).length).toBe(40)
+  })
+})
+
+describe('assertValidTronChecksum', () => {
+  it('accepts a valid base58 address', async () => {
+    await expect(assertValidTronChecksum(USDT_BASE58)).resolves.toBeUndefined()
+  })
+
+  it('rejects a base58 address with a corrupted checksum', async () => {
+    // USDT address with the final char changed — same length/prefix, bad checksum.
+    await expect(
+      assertValidTronChecksum('TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6u')
+    ).rejects.toThrow(/checksum/)
+  })
+
+  it('passes through hex form (no base58 checksum present)', async () => {
+    await expect(assertValidTronChecksum(USDT_HEX)).resolves.toBeUndefined()
+  })
+})