@meshconnect/uwc-tron-connector 0.1.0

package/dist/events/state-machine.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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 declare class TronStateMachine {
+    private state;
+    private readonly listeners;
+    get(): TronConnectionState;
+    set(next: TronConnectionState): void;
+    /** Subscribe to state transitions. Returns an unsubscribe function. */
+    subscribe(listener: TronStateListener): () => void;
+}
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/events/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../src/events/state-machine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAE1D,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,CAAA;AAE9E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,oBAAoB,CAAA;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAA;AAEpE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAkD;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IAEzD,GAAG,IAAI,mBAAmB;IAI1B,GAAG,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAOpC,uEAAuE;IACvE,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;CAMnD"}

package/dist/events/state-machine.js

@@ -0,0 +1,21 @@
+export class TronStateMachine {
+    state = { status: 'disconnected' };
+    listeners = new Set();
+    get() {
+        return this.state;
+    }
+    set(next) {
+        this.state = next;
+        for (const listener of this.listeners) {
+            listener(next);
+        }
+    }
+    /** Subscribe to state transitions. Returns an unsubscribe function. */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/events/state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../../src/events/state-machine.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,gBAAgB;IACnB,KAAK,GAAwB,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;IAC9C,SAAS,GAAG,IAAI,GAAG,EAAqB,CAAA;IAEzD,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,GAAG,CAAC,IAAyB;QAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAChB,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,SAAS,CAAC,QAA2B;QACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC5B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACjC,CAAC,CAAA;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+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';
+//# 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,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACf,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAC7E,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { TronConnector } from './tron-connector';
+export { ALL_TRON_WALLET_IDS, TRON_WALLET_REGISTRY, isTronWalletId } from './wallets/registry';
+//# 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,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACf,MAAM,oBAAoB,CAAA"}

package/dist/rest/abi.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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 declare function encodeTrc20TransferParams(to: string, amount: number | bigint): string;
+/** Function selector string the full node hashes for a TRC20 transfer. */
+export declare 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 declare const TRC20_TRANSFER_SELECTOR_HASH = "a9059cbb";
+//# sourceMappingURL=abi.d.ts.map

package/dist/rest/abi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.d.ts","sourceRoot":"","sources":["../../src/rest/abi.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GAAG,MAAM,GACtB,MAAM,CAIR;AAED,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,8BAA8B,CAAA;AAElE;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,aAAa,CAAA"}

package/dist/rest/abi.js

@@ -0,0 +1,28 @@
+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, amount) {
+    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';
+//# sourceMappingURL=abi.js.map

package/dist/rest/abi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.js","sourceRoot":"","sources":["../../src/rest/abi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAE/C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,yBAAyB,CACvC,EAAU,EACV,MAAuB;IAEvB,MAAM,WAAW,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;IAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;IAChE,OAAO,WAAW,GAAG,UAAU,CAAA;AACjC,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,uBAAuB,GAAG,2BAA2B,CAAA;AAElE;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,UAAU,CAAA"}

package/dist/rest/address.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Tron address utilities — base58check ↔ hex, dependency-free.
+ *
+ * A Tron address has two on-the-wire forms:
+ *   - base58check (`T...`): Base58Check of `0x41 ‖ <20-byte body> ‖ <4-byte checksum>`.
+ *   - hex (`41` + 40 hex chars): the 21-byte payload (`0x41` prefix + 20-byte body).
+ *
+ * The full-node HTTP API accepts base58 directly when `visible: true` is set, so
+ * build/broadcast never needs conversion. The one place we DO need it is the
+ * TRC20 ABI parameter, which encodes the recipient as the bare 20-byte body.
+ *
+ * Decoding base58 is pure bigint math (no hashing), so the conversion helpers
+ * (`tronAddressToHex` / `tronAddressToEvmHex`) stay synchronous and do NOT
+ * verify the 4-byte checksum — that's the hot path used for already-validated
+ * addresses. Checksum verification is provided separately by the async
+ * `assertValidTronChecksum` (SubtleCrypto), which the connector calls on the
+ * TRC20 recipient — the one case the node never validates (it's encoded as raw
+ * hex, not sent as base58).
+ */
+/**
+ * Convert a base58 Tron address (`T...`) to its 21-byte hex form
+ * (`41` + 40 hex chars). Already-hex input (with or without `0x`) is normalised
+ * and returned as-is.
+ */
+export declare function tronAddressToHex(address: string): string;
+/**
+ * Convert a Tron address to its bare 20-byte EVM-style hex body (no `0x41`
+ * prefix, no `0x`). This is the form used inside TRC20 ABI parameters.
+ */
+export declare function tronAddressToEvmHex(address: string): string;
+/**
+ * Validate a base58 Tron address's 0x41 prefix and 4-byte Base58Check checksum
+ * (first 4 bytes of `sha256(sha256(payload))`). Throws on mismatch.
+ *
+ * This matters for the TRC20 recipient: native transfers send the address as
+ * base58 with `visible:true`, so the node validates it — but TRC20 encodes the
+ * recipient as a raw 20-byte hex word, so the node never sees the base58 form.
+ * Without this check a typo'd-but-structurally-valid address would silently
+ * send funds to the wrong, unrecoverable destination.
+ *
+ * Hex inputs carry no base58 checksum, so they pass through unchecked.
+ * Async because it uses SubtleCrypto for SHA-256 (no hashing dependency).
+ */
+export declare function assertValidTronChecksum(address: string): Promise<void>;
+//# sourceMappingURL=address.d.ts.map

package/dist/rest/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../src/rest/address.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAyCH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmBxD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB5E"}

package/dist/rest/address.js

@@ -0,0 +1,124 @@
+/**
+ * Tron address utilities — base58check ↔ hex, dependency-free.
+ *
+ * A Tron address has two on-the-wire forms:
+ *   - base58check (`T...`): Base58Check of `0x41 ‖ <20-byte body> ‖ <4-byte checksum>`.
+ *   - hex (`41` + 40 hex chars): the 21-byte payload (`0x41` prefix + 20-byte body).
+ *
+ * The full-node HTTP API accepts base58 directly when `visible: true` is set, so
+ * build/broadcast never needs conversion. The one place we DO need it is the
+ * TRC20 ABI parameter, which encodes the recipient as the bare 20-byte body.
+ *
+ * Decoding base58 is pure bigint math (no hashing), so the conversion helpers
+ * (`tronAddressToHex` / `tronAddressToEvmHex`) stay synchronous and do NOT
+ * verify the 4-byte checksum — that's the hot path used for already-validated
+ * addresses. Checksum verification is provided separately by the async
+ * `assertValidTronChecksum` (SubtleCrypto), which the connector calls on the
+ * TRC20 recipient — the one case the node never validates (it's encoded as raw
+ * hex, not sent as base58).
+ */
+const BASE58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+/** Decode a Base58 string to bytes (big-endian). Throws on invalid characters. */
+function base58Decode(input) {
+    if (input.length === 0)
+        throw new Error('tron address: empty base58 string');
+    let value = 0n;
+    for (const char of input) {
+        const index = BASE58_ALPHABET.indexOf(char);
+        if (index === -1) {
+            throw new Error(`tron address: invalid base58 character "${char}"`);
+        }
+        value = value * 58n + BigInt(index);
+    }
+    const bytes = [];
+    while (value > 0n) {
+        bytes.unshift(Number(value & 0xffn));
+        value >>= 8n;
+    }
+    // Each leading '1' in base58 represents a leading zero byte.
+    for (const char of input) {
+        if (char !== '1')
+            break;
+        bytes.unshift(0);
+    }
+    return Uint8Array.from(bytes);
+}
+function toHex(bytes) {
+    let out = '';
+    for (const byte of bytes) {
+        out += byte.toString(16).padStart(2, '0');
+    }
+    return out;
+}
+/**
+ * Convert a base58 Tron address (`T...`) to its 21-byte hex form
+ * (`41` + 40 hex chars). Already-hex input (with or without `0x`) is normalised
+ * and returned as-is.
+ */
+export function tronAddressToHex(address) {
+    // Accept hex passthrough so callers can mix forms.
+    const stripped = address.startsWith('0x') ? address.slice(2) : address;
+    if (/^41[0-9a-fA-F]{40}$/.test(stripped)) {
+        return stripped.toLowerCase();
+    }
+    const decoded = base58Decode(address);
+    // 25 bytes = 21-byte payload (0x41 + 20-byte body) + 4-byte checksum.
+    if (decoded.length !== 25) {
+        throw new Error(`tron address: expected 25 bytes after base58 decode, got ${decoded.length}`);
+    }
+    const payload = decoded.subarray(0, 21);
+    if (payload[0] !== 0x41) {
+        throw new Error('tron address: missing 0x41 Tron address prefix');
+    }
+    return toHex(payload);
+}
+/**
+ * Convert a Tron address to its bare 20-byte EVM-style hex body (no `0x41`
+ * prefix, no `0x`). This is the form used inside TRC20 ABI parameters.
+ */
+export function tronAddressToEvmHex(address) {
+    return tronAddressToHex(address).slice(2);
+}
+/**
+ * SHA-256 via SubtleCrypto. Re-wraps the input with `Uint8Array.from` so it is
+ * an ArrayBuffer-backed view (satisfies `digest`'s `BufferSource` param without
+ * naming the DOM type, which our lint's `no-undef` doesn't recognize).
+ */
+async function sha256(bytes) {
+    const digest = await crypto.subtle.digest('SHA-256', Uint8Array.from(bytes));
+    return new Uint8Array(digest);
+}
+/**
+ * Validate a base58 Tron address's 0x41 prefix and 4-byte Base58Check checksum
+ * (first 4 bytes of `sha256(sha256(payload))`). Throws on mismatch.
+ *
+ * This matters for the TRC20 recipient: native transfers send the address as
+ * base58 with `visible:true`, so the node validates it — but TRC20 encodes the
+ * recipient as a raw 20-byte hex word, so the node never sees the base58 form.
+ * Without this check a typo'd-but-structurally-valid address would silently
+ * send funds to the wrong, unrecoverable destination.
+ *
+ * Hex inputs carry no base58 checksum, so they pass through unchecked.
+ * Async because it uses SubtleCrypto for SHA-256 (no hashing dependency).
+ */
+export async function assertValidTronChecksum(address) {
+    const stripped = address.startsWith('0x') ? address.slice(2) : address;
+    if (/^41[0-9a-fA-F]{40}$/.test(stripped))
+        return; // hex form: no checksum to verify
+    const decoded = base58Decode(address);
+    if (decoded.length !== 25) {
+        throw new Error(`tron address: expected 25 bytes after base58 decode, got ${decoded.length}`);
+    }
+    const payload = decoded.subarray(0, 21);
+    if (payload[0] !== 0x41) {
+        throw new Error('tron address: missing 0x41 Tron address prefix');
+    }
+    const expected = decoded.subarray(21, 25);
+    const round2 = await sha256(await sha256(payload));
+    for (let i = 0; i < 4; i++) {
+        if (round2[i] !== expected[i]) {
+            throw new Error('tron address: base58 checksum mismatch (possible typo in recipient address)');
+        }
+    }
+}
+//# sourceMappingURL=address.js.map

package/dist/rest/address.js.map

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

package/dist/rest/trongrid-client.d.ts

@@ -0,0 +1,57 @@
+import type { NetworkId, TronGridConfig } from '@meshconnect/uwc-types';
+/**
+ * The minimal shape of an unsigned Tron transaction returned by
+ * `/wallet/createtransaction` and `/wallet/triggersmartcontract`.
+ *
+ * Only `txID` + `raw_data*` are load-bearing for sign/broadcast; the struct
+ * carries more fields that pass through opaquely. Typed loosely on purpose so
+ * a node-version change to the surrounding shape doesn't break the contract.
+ */
+export interface UnsignedTronTransaction {
+    txID?: string;
+    raw_data?: unknown;
+    raw_data_hex?: string;
+    visible?: boolean;
+    [key: string]: unknown;
+}
+/** A transaction with the wallet's signature appended, ready to broadcast. */
+export interface SignedTronTransaction extends UnsignedTronTransaction {
+    signature?: string[];
+}
+/**
+ * Thin `fetch` wrapper over the three Tron full-node HTTP endpoints this
+ * connector needs. No SDK, no `tronweb` — the `/wallet/*` paths are the Tron
+ * full-node API standard, identical across TronGrid and any full node.
+ */
+export declare class TronGridClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly feeLimitSun;
+    constructor(networkId: NetworkId, config?: TronGridConfig);
+    /** Build an unsigned native TRX transfer. Amounts are in SUN. */
+    createTransaction(params: {
+        from: string;
+        to: string;
+        amount: number;
+    }): Promise<UnsignedTronTransaction>;
+    /** Build an unsigned TRC20 `transfer(address,uint256)` transaction. */
+    createTrc20Transfer(params: {
+        from: string;
+        to: string;
+        amount: number;
+        contractAddress: string;
+    }): Promise<UnsignedTronTransaction>;
+    /** Broadcast a signed transaction. Returns the on-chain txid. */
+    broadcastTransaction(signed: SignedTronTransaction): Promise<string>;
+    private post;
+}
+/**
+ * Full nodes often return `message` as hex-encoded ASCII
+ * (e.g. `"434f4e54524143545f56414c4944415445..."`). Decode when it looks like
+ * hex AND the result is printable ASCII; otherwise pass the string through
+ * unchanged. The printable check avoids mangling a message that happens to be
+ * an all-hex, even-length word (e.g. `"deadbeef"`), which would decode to
+ * non-printable bytes.
+ */
+export declare function decodeHexMessage(message: string | undefined): string;
+//# sourceMappingURL=trongrid-client.d.ts.map

package/dist/rest/trongrid-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trongrid-client.d.ts","sourceRoot":"","sources":["../../src/rest/trongrid-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAGvE;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,8EAA8E;AAC9E,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB;IACpE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAmBD;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;gBAExB,SAAS,EAAE,SAAS,EAAE,MAAM,GAAE,cAAmB;IAmC7D,iEAAiE;IAC3D,iBAAiB,CAAC,MAAM,EAAE;QAC9B,IAAI,EAAE,MAAM,CAAA;QACZ,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,MAAM,CAAA;KACf,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAmBpC,uEAAuE;IACjE,mBAAmB,CAAC,MAAM,EAAE;QAChC,IAAI,EAAE,MAAM,CAAA;QACZ,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,MAAM,CAAA;QACd,eAAe,EAAE,MAAM,CAAA;KACxB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAyBpC,iEAAiE;IAC3D,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;YAsB5D,IAAI;CAkBnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAYpE"}

package/dist/rest/trongrid-client.js

@@ -0,0 +1,133 @@
+import { encodeTrc20TransferParams, TRC20_TRANSFER_SELECTOR } from './abi';
+const DEFAULT_ENDPOINTS = {
+    'tron:0x2b6653dc': 'https://api.trongrid.io', // Mainnet
+    'tron:0x94a9059e': 'https://api.shasta.trongrid.io', // Shasta testnet
+    'tron:0xcd8690dc': 'https://nile.trongrid.io' // Nile testnet
+};
+const DEFAULT_FEE_LIMIT_SUN = 100_000_000; // 100 TRX
+/**
+ * Thin `fetch` wrapper over the three Tron full-node HTTP endpoints this
+ * connector needs. No SDK, no `tronweb` — the `/wallet/*` paths are the Tron
+ * full-node API standard, identical across TronGrid and any full node.
+ */
+export class TronGridClient {
+    baseUrl;
+    apiKey;
+    feeLimitSun;
+    constructor(networkId, config = {}) {
+        const url = config.endpoints?.[networkId] ?? DEFAULT_ENDPOINTS[networkId];
+        if (!url) {
+            throw new Error(`tron-connector: no full-node endpoint configured for network "${networkId}". ` +
+                `Pass one via TronConnectorConfig.tronGrid.endpoints.`);
+        }
+        // Reject plaintext endpoints: we send the TRON-PRO-API-KEY header and the
+        // unsigned tx in the body, so an `http://` host would leak both. Allow
+        // loopback http for local dev nodes (e.g. a tron-quickstart container).
+        if (/^http:\/\//i.test(url) &&
+            !/^http:\/\/(localhost|127\.0\.0\.1)/i.test(url)) {
+            throw new Error(`tron-connector: refusing non-https endpoint "${url}" (would send the API key + tx in cleartext)`);
+        }
+        // Normalise away trailing slashes so path concatenation is predictable.
+        // Done with a plain loop (no regex) to avoid any backtracking concern.
+        let base = url;
+        while (base.endsWith('/'))
+            base = base.slice(0, -1);
+        this.baseUrl = base;
+        this.apiKey = config.apiKey;
+        const feeLimit = config.feeLimitSun ?? DEFAULT_FEE_LIMIT_SUN;
+        if (!Number.isInteger(feeLimit) || feeLimit <= 0) {
+            throw new Error(`tron-connector: feeLimitSun must be a positive integer (SUN), got ${feeLimit}`);
+        }
+        this.feeLimitSun = feeLimit;
+    }
+    /** Build an unsigned native TRX transfer. Amounts are in SUN. */
+    async createTransaction(params) {
+        const tx = await this.post('/wallet/createtransaction', {
+            owner_address: params.from,
+            to_address: params.to,
+            amount: params.amount,
+            visible: true
+        });
+        if (tx.Error) {
+            throw new Error(`tron-connector: createtransaction failed — ${tx.Error}`);
+        }
+        if (!tx.txID) {
+            throw new Error('tron-connector: createtransaction returned no txID');
+        }
+        return tx;
+    }
+    /** Build an unsigned TRC20 `transfer(address,uint256)` transaction. */
+    async createTrc20Transfer(params) {
+        const response = await this.post('/wallet/triggersmartcontract', {
+            owner_address: params.from,
+            contract_address: params.contractAddress,
+            function_selector: TRC20_TRANSFER_SELECTOR,
+            parameter: encodeTrc20TransferParams(params.to, params.amount),
+            fee_limit: this.feeLimitSun,
+            call_value: 0,
+            visible: true
+        });
+        if (!response.result?.result || !response.transaction?.txID) {
+            throw new Error(`tron-connector: triggersmartcontract failed — ${decodeHexMessage(response.result?.message) ||
+                response.result?.code ||
+                'unknown error'}`);
+        }
+        return response.transaction;
+    }
+    /** Broadcast a signed transaction. Returns the on-chain txid. */
+    async broadcastTransaction(signed) {
+        const response = await this.post('/wallet/broadcasttransaction', signed);
+        // The node returns `{ result: false, message: <hex> }` on rejection even
+        // when a txid is echoed back — treat anything other than `result: true` as
+        // failure.
+        if (response.result !== true) {
+            throw new Error(decodeHexMessage(response.message) ||
+                response.code ||
+                'tron-connector: broadcast rejected by node');
+        }
+        const txid = response.txid ?? response.transaction?.txID ?? signed.txID;
+        if (!txid) {
+            throw new Error('tron-connector: broadcast returned no txid');
+        }
+        return txid;
+    }
+    async post(path, body) {
+        const headers = {
+            'Content-Type': 'application/json'
+        };
+        if (this.apiKey)
+            headers['TRON-PRO-API-KEY'] = this.apiKey;
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body)
+        });
+        if (!response.ok) {
+            throw new Error(`tron-connector: ${path} responded ${response.status} ${response.statusText}`);
+        }
+        return (await response.json());
+    }
+}
+/**
+ * Full nodes often return `message` as hex-encoded ASCII
+ * (e.g. `"434f4e54524143545f56414c4944415445..."`). Decode when it looks like
+ * hex AND the result is printable ASCII; otherwise pass the string through
+ * unchanged. The printable check avoids mangling a message that happens to be
+ * an all-hex, even-length word (e.g. `"deadbeef"`), which would decode to
+ * non-printable bytes.
+ */
+export function decodeHexMessage(message) {
+    if (!message)
+        return '';
+    if (!/^[0-9a-fA-F]+$/.test(message) || message.length % 2 !== 0) {
+        return message;
+    }
+    let decoded = '';
+    for (let i = 0; i < message.length; i += 2) {
+        decoded += String.fromCharCode(parseInt(message.slice(i, i + 2), 16));
+    }
+    // Printable ASCII (incl. common whitespace) → it was hex-encoded text.
+    // Anything else → the input was more likely a literal string; keep it.
+    return /^[\x20-\x7e\t\n\r]*$/.test(decoded) ? decoded : message;
+}
+//# sourceMappingURL=trongrid-client.js.map

package/dist/rest/trongrid-client.js.map

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

package/dist/shared/error-utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Translate an unknown error (from a wallet `request`/`sign` call or a node
+ * response) into a `WalletConnectorError`. User-rejection signals are tagged
+ * `type: 'rejected'`; everything else is `type: 'unknown'`.
+ *
+ * Throws — never returns.
+ */
+export declare function parseError(error: unknown): never;
+//# sourceMappingURL=error-utils.d.ts.map

package/dist/shared/error-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-utils.d.ts","sourceRoot":"","sources":["../../src/shared/error-utils.ts"],"names":[],"mappings":"AAqBA;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CA+BhD"}

package/dist/shared/error-utils.js

@@ -0,0 +1,52 @@
+import { WalletConnectorError } from '@meshconnect/uwc-types';
+const REJECTION_PATTERNS = [
+    'user rejected',
+    'user denied',
+    'user cancelled',
+    'user canceled',
+    'rejected by user',
+    'denied by user',
+    'cancelled by user',
+    'canceled by user',
+    'user disapproved',
+    'user declined',
+    'action_rejected',
+    'reject request',
+    'user rejects',
+    'wallet rejected',
+    'confirmation declined'
+];
+/**
+ * Translate an unknown error (from a wallet `request`/`sign` call or a node
+ * response) into a `WalletConnectorError`. User-rejection signals are tagged
+ * `type: 'rejected'`; everything else is `type: 'unknown'`.
+ *
+ * Throws — never returns.
+ */
+export function parseError(error) {
+    if (error instanceof WalletConnectorError)
+        throw error;
+    let message = '';
+    let isRejected = false;
+    if (error && typeof error === 'object') {
+        const errObj = error;
+        // 4001 is the de-facto user-rejected code across injected wallets.
+        if (errObj.code === 4001 || errObj.code === 'ACTION_REJECTED') {
+            isRejected = true;
+        }
+        message = errObj.message ?? errObj.error?.message ?? String(error);
+    }
+    else {
+        message = String(error);
+    }
+    if (!isRejected) {
+        const lower = message.toLowerCase();
+        isRejected = REJECTION_PATTERNS.some(pattern => lower.includes(pattern));
+    }
+    const walletError = {
+        type: isRejected ? 'rejected' : 'unknown',
+        message
+    };
+    throw new WalletConnectorError(walletError);
+}
+//# sourceMappingURL=error-utils.js.map

package/dist/shared/error-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-utils.js","sourceRoot":"","sources":["../../src/shared/error-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE7D,MAAM,kBAAkB,GAAG;IACzB,eAAe;IACf,aAAa;IACb,gBAAgB;IAChB,eAAe;IACf,kBAAkB;IAClB,gBAAgB;IAChB,mBAAmB;IACnB,kBAAkB;IAClB,kBAAkB;IAClB,eAAe;IACf,iBAAiB;IACjB,gBAAgB;IAChB,cAAc;IACd,iBAAiB;IACjB,uBAAuB;CACxB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,oBAAoB;QAAE,MAAM,KAAK,CAAA;IAEtD,IAAI,OAAO,GAAG,EAAE,CAAA;IAChB,IAAI,UAAU,GAAG,KAAK,CAAA;IAEtB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,KAId,CAAA;QACD,mEAAmE;QACnE,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAC9D,UAAU,GAAG,IAAI,CAAA;QACnB,CAAC;QACD,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;IACpE,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAA;QACnC,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;IAC1E,CAAC;IAED,MAAM,WAAW,GAAgB;QAC/B,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QACzC,OAAO;KACR,CAAA;IACD,MAAM,IAAI,oBAAoB,CAAC,WAAW,CAAC,CAAA;AAC7C,CAAC"}