@t402/wdk 2.3.0 → 2.4.0

package/dist/esm/adapters/ton-adapter.d.mts

@@ -0,0 +1,139 @@
+import { a as WDKTonAccount } from '../types-V7c-qhn6.mjs';
+import 'viem';
+
+/**
+ * TON Signer Adapter for WDK
+ *
+ * Wraps a Tether WDK TON account to implement T402's ClientTonSigner interface.
+ * This allows WDK-managed TON wallets to be used for T402 payments.
+ */
+
+/**
+ * TON Address type (compatible with @ton/core Address)
+ * We define our own interface to avoid direct import
+ */
+interface TonAddress {
+    toString(): string;
+    toRawString(): string;
+}
+/**
+ * TON Cell type (compatible with @ton/core Cell)
+ * We define our own interface to avoid direct import
+ */
+interface TonCell {
+    hash(): Uint8Array;
+    toBoc(): Uint8Array;
+}
+/**
+ * SignMessageParams type matching T402's @t402/ton interface
+ */
+interface SignMessageParams {
+    /** Destination address */
+    to: TonAddress;
+    /** Amount of TON to attach (for gas) in nanoTON */
+    value: bigint;
+    /** Message body (Jetton transfer cell) */
+    body: TonCell;
+    /** Send mode flags (from @ton/core SendMode) */
+    sendMode?: number;
+    /** Bounce flag */
+    bounce?: boolean;
+    /** Message validity timeout in seconds */
+    timeout?: number;
+}
+/**
+ * ClientTonSigner interface matching T402's @t402/ton
+ */
+interface ClientTonSigner {
+    readonly address: TonAddress;
+    signMessage(params: SignMessageParams): Promise<TonCell>;
+    getSeqno(): Promise<number>;
+}
+/**
+ * WDKTonSignerAdapter - Adapts a WDK TON account to T402's ClientTonSigner
+ *
+ * This adapter wraps a Tether WDK TON account and provides T402-compatible
+ * signing functionality. The actual message building and signing is delegated
+ * to the WDK account, which handles TON-specific details internally.
+ *
+ * @example
+ * ```typescript
+ * const adapter = await createWDKTonSigner(wdkTonAccount);
+ * const signed = await adapter.signMessage({
+ *   to: jettonWalletAddress,
+ *   value: toNano('0.05'),
+ *   body: jettonTransferBody,
+ * });
+ * ```
+ */
+declare class WDKTonSignerAdapter implements ClientTonSigner {
+    private _account;
+    private _address;
+    private _initialized;
+    constructor(account: WDKTonAccount);
+    /**
+     * Get the wallet address
+     * @throws Error if not initialized
+     */
+    get address(): TonAddress;
+    /**
+     * Check if the adapter is initialized
+     */
+    get isInitialized(): boolean;
+    /**
+     * Initialize the adapter by fetching the address
+     * Must be called before using the signer
+     */
+    initialize(): Promise<void>;
+    /**
+     * Sign an internal message for Jetton transfer
+     *
+     * Attempts to build a proper signed Cell using @ton/core if available.
+     * Falls back to a simplified wrapper that embeds the raw signature.
+     *
+     * @param params - Message parameters
+     * @returns Signed external message as Cell (BOC)
+     */
+    signMessage(params: SignMessageParams): Promise<TonCell>;
+    /**
+     * Get current seqno for the wallet
+     * Used for replay protection
+     */
+    getSeqno(): Promise<number>;
+    /**
+     * Get TON balance in nanoTON
+     */
+    getBalance(): Promise<bigint>;
+    /**
+     * Get Jetton balance
+     * @param jettonMaster - Jetton master contract address
+     */
+    getJettonBalance(jettonMaster: string): Promise<bigint>;
+    /**
+     * Get the underlying WDK account
+     * Useful for advanced operations not covered by this adapter
+     */
+    getWDKAccount(): WDKTonAccount;
+}
+/**
+ * Create an initialized WDK TON signer
+ *
+ * @param account - WDK TON account from @tetherto/wdk-wallet-ton
+ * @returns Initialized ClientTonSigner
+ *
+ * @example
+ * ```typescript
+ * import { T402WDK } from '@t402/wdk';
+ *
+ * const wallet = new T402WDK(seedPhrase, config);
+ * const tonSigner = await wallet.getTonSigner();
+ *
+ * // Use with T402 client
+ * const client = createT402HTTPClient({
+ *   signers: [{ scheme: 'exact', network: 'ton:mainnet', signer: tonSigner }]
+ * });
+ * ```
+ */
+declare function createWDKTonSigner(account: WDKTonAccount): Promise<WDKTonSignerAdapter>;
+
+export { type ClientTonSigner, type SignMessageParams, type TonAddress, type TonCell, WDKTonSignerAdapter, createWDKTonSigner };

package/dist/esm/adapters/ton-adapter.mjs

@@ -0,0 +1,9 @@
+import {
+  WDKTonSignerAdapter,
+  createWDKTonSigner
+} from "../chunk-YWBJJV5M.mjs";
+export {
+  WDKTonSignerAdapter,
+  createWDKTonSigner
+};
+//# sourceMappingURL=ton-adapter.mjs.map

package/dist/esm/adapters/ton-adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/adapters/tron-adapter.d.mts

@@ -0,0 +1,139 @@
+import { b as WDKTronAccount } from '../types-V7c-qhn6.mjs';
+import 'viem';
+
+/**
+ * TRON Signer Adapter for WDK
+ *
+ * Wraps a Tether WDK TRON account to implement T402's ClientTronSigner interface.
+ * This allows WDK-managed TRON wallets to be used for T402 payments.
+ */
+
+/**
+ * SignTransactionParams matching T402's @t402/tron interface
+ */
+interface SignTransactionParams {
+    /** TRC20 contract address */
+    contractAddress: string;
+    /** Recipient address (T-prefix base58check) */
+    to: string;
+    /** Amount to transfer (in smallest units) */
+    amount: string;
+    /** Fee limit in SUN (optional, defaults to 100 TRX) */
+    feeLimit?: number;
+    /** Transaction expiration time in milliseconds (optional) */
+    expiration?: number;
+}
+/**
+ * Block info for transaction building
+ */
+interface BlockInfo {
+    /** Reference block bytes (hex) */
+    refBlockBytes: string;
+    /** Reference block hash (hex) */
+    refBlockHash: string;
+    /** Expiration timestamp in milliseconds */
+    expiration: number;
+}
+/**
+ * ClientTronSigner interface matching T402's @t402/tron
+ */
+interface ClientTronSigner {
+    readonly address: string;
+    signTransaction(params: SignTransactionParams): Promise<string>;
+    getBlockInfo(): Promise<BlockInfo>;
+}
+/**
+ * WDKTronSignerAdapter - Adapts a WDK TRON account to T402's ClientTronSigner
+ *
+ * @example
+ * ```typescript
+ * const adapter = await createWDKTronSigner(wdkTronAccount);
+ * const signedTx = await adapter.signTransaction({
+ *   contractAddress: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
+ *   to: 'TRecipientAddress...',
+ *   amount: '1000000', // 1 USDT
+ * });
+ * ```
+ */
+declare class WDKTronSignerAdapter implements ClientTronSigner {
+    private _account;
+    private _address;
+    private _initialized;
+    private _rpcUrl;
+    constructor(account: WDKTronAccount, rpcUrl?: string);
+    /**
+     * Get the wallet address (T-prefix base58check)
+     * @throws Error if not initialized
+     */
+    get address(): string;
+    /**
+     * Check if the adapter is initialized
+     */
+    get isInitialized(): boolean;
+    /**
+     * Initialize the adapter by fetching the address
+     * Must be called before using the signer
+     */
+    initialize(): Promise<void>;
+    /**
+     * Sign a TRC20 transfer transaction
+     *
+     * This method:
+     * 1. Builds a TRC20 transfer transaction
+     * 2. Signs it using the WDK account
+     * 3. Returns the hex-encoded signed transaction
+     *
+     * @param params - Transaction parameters
+     * @returns Hex-encoded signed transaction
+     */
+    signTransaction(params: SignTransactionParams): Promise<string>;
+    /**
+     * Get the current reference block info for transaction building
+     * This is required for TRON's replay protection mechanism
+     */
+    getBlockInfo(): Promise<BlockInfo>;
+    /**
+     * Build a TRC20 transfer transaction
+     */
+    private buildTrc20Transaction;
+    /**
+     * Serialize a signed transaction to hex format
+     */
+    private serializeTransaction;
+    /**
+     * Convert TRON base58 address to hex format
+     */
+    private addressToHex;
+    /**
+     * Get TRX balance in SUN
+     */
+    getBalance(): Promise<bigint>;
+    /**
+     * Get TRC20 token balance
+     * @param contractAddress - TRC20 contract address
+     */
+    getTrc20Balance(contractAddress: string): Promise<bigint>;
+}
+/**
+ * Create an initialized WDK TRON signer
+ *
+ * @param account - WDK TRON account from @tetherto/wdk-wallet-tron
+ * @param rpcUrl - Optional custom RPC URL (default: https://api.trongrid.io)
+ * @returns Initialized ClientTronSigner
+ *
+ * @example
+ * ```typescript
+ * import { T402WDK } from '@t402/wdk';
+ *
+ * const wallet = new T402WDK(seedPhrase, config);
+ * const tronSigner = await wallet.getTronSigner();
+ *
+ * // Use with T402 client
+ * const client = createT402HTTPClient({
+ *   signers: [{ scheme: 'exact', network: 'tron:mainnet', signer: tronSigner }]
+ * });
+ * ```
+ */
+declare function createWDKTronSigner(account: WDKTronAccount, rpcUrl?: string): Promise<WDKTronSignerAdapter>;
+
+export { type BlockInfo, type ClientTronSigner, type SignTransactionParams, WDKTronSignerAdapter, createWDKTronSigner };

package/dist/esm/adapters/tron-adapter.mjs

@@ -0,0 +1,9 @@
+import {
+  WDKTronSignerAdapter,
+  createWDKTronSigner
+} from "../chunk-HB2DGKQ3.mjs";
+export {
+  WDKTronSignerAdapter,
+  createWDKTronSigner
+};
+//# sourceMappingURL=tron-adapter.mjs.map

package/dist/esm/adapters/tron-adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/chunk-HB2DGKQ3.mjs

@@ -0,0 +1,196 @@
+// src/adapters/tron-adapter.ts
+var WDKTronSignerAdapter = class {
+  _account;
+  _address = null;
+  _initialized = false;
+  _rpcUrl;
+  constructor(account, rpcUrl = "https://api.trongrid.io") {
+    if (!account) {
+      throw new Error("WDK TRON account is required");
+    }
+    this._account = account;
+    this._rpcUrl = rpcUrl;
+  }
+  /**
+   * Get the wallet address (T-prefix base58check)
+   * @throws Error if not initialized
+   */
+  get address() {
+    if (!this._address) {
+      throw new Error(
+        "TRON signer not initialized. Call initialize() first or use createWDKTronSigner()."
+      );
+    }
+    return this._address;
+  }
+  /**
+   * Check if the adapter is initialized
+   */
+  get isInitialized() {
+    return this._initialized;
+  }
+  /**
+   * Initialize the adapter by fetching the address
+   * Must be called before using the signer
+   */
+  async initialize() {
+    if (this._initialized) {
+      return;
+    }
+    this._address = await this._account.getAddress();
+    this._initialized = true;
+  }
+  /**
+   * Sign a TRC20 transfer transaction
+   *
+   * This method:
+   * 1. Builds a TRC20 transfer transaction
+   * 2. Signs it using the WDK account
+   * 3. Returns the hex-encoded signed transaction
+   *
+   * @param params - Transaction parameters
+   * @returns Hex-encoded signed transaction
+   */
+  async signTransaction(params) {
+    if (!params.contractAddress) {
+      throw new Error("contractAddress is required");
+    }
+    if (!params.to) {
+      throw new Error("recipient address (to) is required");
+    }
+    if (!params.amount || BigInt(params.amount) <= 0n) {
+      throw new Error("amount must be a positive value");
+    }
+    const blockInfo = await this.getBlockInfo();
+    const feeLimit = params.feeLimit ?? 1e8;
+    const transaction = await this.buildTrc20Transaction({
+      contractAddress: params.contractAddress,
+      to: params.to,
+      amount: params.amount,
+      feeLimit,
+      refBlockBytes: blockInfo.refBlockBytes,
+      refBlockHash: blockInfo.refBlockHash,
+      expiration: params.expiration ?? blockInfo.expiration
+    });
+    const signedTx = await this._account.signTransaction(transaction);
+    return this.serializeTransaction(signedTx);
+  }
+  /**
+   * Get the current reference block info for transaction building
+   * This is required for TRON's replay protection mechanism
+   */
+  async getBlockInfo() {
+    try {
+      const response = await fetch(`${this._rpcUrl}/wallet/getnowblock`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({})
+      });
+      if (!response.ok) {
+        throw new Error(`Failed to get block info: ${response.status}`);
+      }
+      const block = await response.json();
+      const blockNum = block.block_header.raw_data.number;
+      const refBlockBytes = blockNum.toString(16).padStart(8, "0").slice(-4);
+      const refBlockHash = block.blockID.slice(16, 32);
+      const expiration = block.block_header.raw_data.timestamp + 6e4;
+      return {
+        refBlockBytes,
+        refBlockHash,
+        expiration
+      };
+    } catch (error) {
+      throw new Error(
+        `Failed to get TRON block info: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * Build a TRC20 transfer transaction
+   */
+  async buildTrc20Transaction(params) {
+    const functionSelector = "transfer(address,uint256)";
+    const toAddressHex = this.addressToHex(params.to).slice(2).padStart(64, "0");
+    const amountHex = BigInt(params.amount).toString(16).padStart(64, "0");
+    const parameter = toAddressHex + amountHex;
+    try {
+      const response = await fetch(`${this._rpcUrl}/wallet/triggersmartcontract`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          owner_address: this.addressToHex(this._address),
+          contract_address: this.addressToHex(params.contractAddress),
+          function_selector: functionSelector,
+          parameter,
+          fee_limit: params.feeLimit
+        })
+      });
+      if (!response.ok) {
+        throw new Error(`Failed to build transaction: ${response.status}`);
+      }
+      const result = await response.json();
+      if (result.result?.code) {
+        throw new Error(`Transaction build failed: ${result.result.message}`);
+      }
+      return result.transaction;
+    } catch (error) {
+      throw new Error(
+        `Failed to build TRC20 transaction: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * Serialize a signed transaction to hex format
+   */
+  serializeTransaction(signedTx) {
+    if (signedTx.signature && signedTx.signature.length > 0) {
+      return JSON.stringify(signedTx);
+    }
+    return signedTx.raw_data_hex;
+  }
+  /**
+   * Convert TRON base58 address to hex format
+   */
+  addressToHex(address) {
+    if (address.startsWith("41") || address.startsWith("0x")) {
+      return address.startsWith("0x") ? "41" + address.slice(2) : address;
+    }
+    const ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+    let num = BigInt(0);
+    for (const char of address) {
+      num = num * BigInt(58) + BigInt(ALPHABET.indexOf(char));
+    }
+    let hex = num.toString(16);
+    let leadingZeros = 0;
+    for (const char of address) {
+      if (char === "1") leadingZeros++;
+      else break;
+    }
+    hex = "00".repeat(leadingZeros) + hex;
+    return hex.slice(0, 42);
+  }
+  /**
+   * Get TRX balance in SUN
+   */
+  async getBalance() {
+    return this._account.getBalance();
+  }
+  /**
+   * Get TRC20 token balance
+   * @param contractAddress - TRC20 contract address
+   */
+  async getTrc20Balance(contractAddress) {
+    return this._account.getTrc20Balance(contractAddress);
+  }
+};
+async function createWDKTronSigner(account, rpcUrl) {
+  const adapter = new WDKTronSignerAdapter(account, rpcUrl);
+  await adapter.initialize();
+  return adapter;
+}
+
+export {
+  WDKTronSignerAdapter,
+  createWDKTronSigner
+};
+//# sourceMappingURL=chunk-HB2DGKQ3.mjs.map

package/dist/esm/chunk-HB2DGKQ3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/tron-adapter.ts"],"sourcesContent":["/**\n * TRON Signer Adapter for WDK\n *\n * Wraps a Tether WDK TRON account to implement T402's ClientTronSigner interface.\n * This allows WDK-managed TRON wallets to be used for T402 payments.\n */\n\nimport type { WDKTronAccount } from '../types.js'\n\n/**\n * SignTransactionParams matching T402's @t402/tron interface\n */\nexport interface SignTransactionParams {\n  /** TRC20 contract address */\n  contractAddress: string\n  /** Recipient address (T-prefix base58check) */\n  to: string\n  /** Amount to transfer (in smallest units) */\n  amount: string\n  /** Fee limit in SUN (optional, defaults to 100 TRX) */\n  feeLimit?: number\n  /** Transaction expiration time in milliseconds (optional) */\n  expiration?: number\n}\n\n/**\n * Block info for transaction building\n */\nexport interface BlockInfo {\n  /** Reference block bytes (hex) */\n  refBlockBytes: string\n  /** Reference block hash (hex) */\n  refBlockHash: string\n  /** Expiration timestamp in milliseconds */\n  expiration: number\n}\n\n/**\n * ClientTronSigner interface matching T402's @t402/tron\n */\nexport interface ClientTronSigner {\n  readonly address: string\n  signTransaction(params: SignTransactionParams): Promise<string>\n  getBlockInfo(): Promise<BlockInfo>\n}\n\n// TronWeb-compatible types\ninterface TronWebTransaction {\n  txID: string\n  raw_data: {\n    contract: unknown[]\n    ref_block_bytes: string\n    ref_block_hash: string\n    expiration: number\n    timestamp: number\n  }\n  raw_data_hex: string\n  signature?: string[]\n}\n\ninterface TronWebBlock {\n  block_header: {\n    raw_data: {\n      number: number\n      txTrieRoot: string\n      witness_address: string\n      parentHash: string\n      version: number\n      timestamp: number\n    }\n    witness_signature: string\n  }\n  blockID: string\n}\n\n/**\n * WDKTronSignerAdapter - Adapts a WDK TRON account to T402's ClientTronSigner\n *\n * @example\n * ```typescript\n * const adapter = await createWDKTronSigner(wdkTronAccount);\n * const signedTx = await adapter.signTransaction({\n *   contractAddress: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',\n *   to: 'TRecipientAddress...',\n *   amount: '1000000', // 1 USDT\n * });\n * ```\n */\nexport class WDKTronSignerAdapter implements ClientTronSigner {\n  private _account: WDKTronAccount\n  private _address: string | null = null\n  private _initialized = false\n  private _rpcUrl: string\n\n  constructor(account: WDKTronAccount, rpcUrl = 'https://api.trongrid.io') {\n    if (!account) {\n      throw new Error('WDK TRON account is required')\n    }\n    this._account = account\n    this._rpcUrl = rpcUrl\n  }\n\n  /**\n   * Get the wallet address (T-prefix base58check)\n   * @throws Error if not initialized\n   */\n  get address(): string {\n    if (!this._address) {\n      throw new Error(\n        'TRON signer not initialized. Call initialize() first or use createWDKTronSigner().',\n      )\n    }\n    return this._address\n  }\n\n  /**\n   * Check if the adapter is initialized\n   */\n  get isInitialized(): boolean {\n    return this._initialized\n  }\n\n  /**\n   * Initialize the adapter by fetching the address\n   * Must be called before using the signer\n   */\n  async initialize(): Promise<void> {\n    if (this._initialized) {\n      return\n    }\n\n    this._address = await this._account.getAddress()\n    this._initialized = true\n  }\n\n  /**\n   * Sign a TRC20 transfer transaction\n   *\n   * This method:\n   * 1. Builds a TRC20 transfer transaction\n   * 2. Signs it using the WDK account\n   * 3. Returns the hex-encoded signed transaction\n   *\n   * @param params - Transaction parameters\n   * @returns Hex-encoded signed transaction\n   */\n  async signTransaction(params: SignTransactionParams): Promise<string> {\n    if (!params.contractAddress) {\n      throw new Error('contractAddress is required')\n    }\n    if (!params.to) {\n      throw new Error('recipient address (to) is required')\n    }\n    if (!params.amount || BigInt(params.amount) <= 0n) {\n      throw new Error('amount must be a positive value')\n    }\n\n    // Get block info for transaction\n    const blockInfo = await this.getBlockInfo()\n\n    // Default fee limit: 100 TRX = 100_000_000 SUN\n    const feeLimit = params.feeLimit ?? 100_000_000\n\n    // Build the TRC20 transfer transaction\n    const transaction = await this.buildTrc20Transaction({\n      contractAddress: params.contractAddress,\n      to: params.to,\n      amount: params.amount,\n      feeLimit,\n      refBlockBytes: blockInfo.refBlockBytes,\n      refBlockHash: blockInfo.refBlockHash,\n      expiration: params.expiration ?? blockInfo.expiration,\n    })\n\n    // Sign the transaction using WDK account\n    const signedTx = await this._account.signTransaction(transaction)\n\n    // Serialize to hex format\n    return this.serializeTransaction(signedTx as TronWebTransaction)\n  }\n\n  /**\n   * Get the current reference block info for transaction building\n   * This is required for TRON's replay protection mechanism\n   */\n  async getBlockInfo(): Promise<BlockInfo> {\n    try {\n      const response = await fetch(`${this._rpcUrl}/wallet/getnowblock`, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({}),\n      })\n\n      if (!response.ok) {\n        throw new Error(`Failed to get block info: ${response.status}`)\n      }\n\n      const block = (await response.json()) as TronWebBlock\n\n      // Extract reference block bytes (last 4 bytes of block number)\n      const blockNum = block.block_header.raw_data.number\n      const refBlockBytes = blockNum.toString(16).padStart(8, '0').slice(-4)\n\n      // Reference block hash (first 8 bytes of block ID)\n      const refBlockHash = block.blockID.slice(16, 32)\n\n      // Expiration: block timestamp + 60 seconds\n      const expiration = block.block_header.raw_data.timestamp + 60000\n\n      return {\n        refBlockBytes,\n        refBlockHash,\n        expiration,\n      }\n    } catch (error) {\n      throw new Error(\n        `Failed to get TRON block info: ${error instanceof Error ? error.message : String(error)}`,\n      )\n    }\n  }\n\n  /**\n   * Build a TRC20 transfer transaction\n   */\n  private async buildTrc20Transaction(params: {\n    contractAddress: string\n    to: string\n    amount: string\n    feeLimit: number\n    refBlockBytes: string\n    refBlockHash: string\n    expiration: number\n  }): Promise<TronWebTransaction> {\n    // Build TRC20 transfer function call\n    // transfer(address,uint256) = 0xa9059cbb\n    const functionSelector = 'transfer(address,uint256)'\n\n    // Encode parameters\n    const toAddressHex = this.addressToHex(params.to).slice(2).padStart(64, '0')\n    const amountHex = BigInt(params.amount).toString(16).padStart(64, '0')\n    const parameter = toAddressHex + amountHex\n\n    try {\n      const response = await fetch(`${this._rpcUrl}/wallet/triggersmartcontract`, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({\n          owner_address: this.addressToHex(this._address!),\n          contract_address: this.addressToHex(params.contractAddress),\n          function_selector: functionSelector,\n          parameter,\n          fee_limit: params.feeLimit,\n        }),\n      })\n\n      if (!response.ok) {\n        throw new Error(`Failed to build transaction: ${response.status}`)\n      }\n\n      const result = await response.json()\n\n      if (result.result?.code) {\n        throw new Error(`Transaction build failed: ${result.result.message}`)\n      }\n\n      return result.transaction as TronWebTransaction\n    } catch (error) {\n      throw new Error(\n        `Failed to build TRC20 transaction: ${error instanceof Error ? error.message : String(error)}`,\n      )\n    }\n  }\n\n  /**\n   * Serialize a signed transaction to hex format\n   */\n  private serializeTransaction(signedTx: TronWebTransaction): string {\n    // Return the raw_data_hex with signature appended\n    if (signedTx.signature && signedTx.signature.length > 0) {\n      return JSON.stringify(signedTx)\n    }\n    return signedTx.raw_data_hex\n  }\n\n  /**\n   * Convert TRON base58 address to hex format\n   */\n  private addressToHex(address: string): string {\n    // If already hex, return as-is\n    if (address.startsWith('41') || address.startsWith('0x')) {\n      return address.startsWith('0x') ? '41' + address.slice(2) : address\n    }\n\n    // Convert base58 to hex using simple algorithm\n    const ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz'\n    let num = BigInt(0)\n    for (const char of address) {\n      num = num * BigInt(58) + BigInt(ALPHABET.indexOf(char))\n    }\n\n    // Convert to hex and take first 42 chars (21 bytes)\n    let hex = num.toString(16)\n    // Handle leading zeros\n    let leadingZeros = 0\n    for (const char of address) {\n      if (char === '1') leadingZeros++\n      else break\n    }\n    hex = '00'.repeat(leadingZeros) + hex\n\n    // TRON address is 21 bytes = 42 hex chars\n    return hex.slice(0, 42)\n  }\n\n  /**\n   * Get TRX balance in SUN\n   */\n  async getBalance(): Promise<bigint> {\n    return this._account.getBalance()\n  }\n\n  /**\n   * Get TRC20 token balance\n   * @param contractAddress - TRC20 contract address\n   */\n  async getTrc20Balance(contractAddress: string): Promise<bigint> {\n    return this._account.getTrc20Balance(contractAddress)\n  }\n}\n\n/**\n * Create an initialized WDK TRON signer\n *\n * @param account - WDK TRON account from @tetherto/wdk-wallet-tron\n * @param rpcUrl - Optional custom RPC URL (default: https://api.trongrid.io)\n * @returns Initialized ClientTronSigner\n *\n * @example\n * ```typescript\n * import { T402WDK } from '@t402/wdk';\n *\n * const wallet = new T402WDK(seedPhrase, config);\n * const tronSigner = await wallet.getTronSigner();\n *\n * // Use with T402 client\n * const client = createT402HTTPClient({\n *   signers: [{ scheme: 'exact', network: 'tron:mainnet', signer: tronSigner }]\n * });\n * ```\n */\nexport async function createWDKTronSigner(\n  account: WDKTronAccount,\n  rpcUrl?: string,\n): Promise<WDKTronSignerAdapter> {\n  const adapter = new WDKTronSignerAdapter(account, rpcUrl)\n  await adapter.initialize()\n  return adapter\n}\n"],"mappings":"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","names":[]}

package/dist/esm/chunk-MCFHZSF7.mjs

@@ -0,0 +1,107 @@
+// src/adapters/svm-adapter.ts
+var WDKSvmSignerAdapter = class {
+  _account;
+  _address = null;
+  _initialized = false;
+  constructor(account) {
+    if (!account) {
+      throw new Error("WDK Solana account is required");
+    }
+    this._account = account;
+  }
+  /**
+   * Get the wallet address (base58)
+   * @throws Error if not initialized
+   */
+  get address() {
+    if (!this._address) {
+      throw new Error(
+        "Solana signer not initialized. Call initialize() first or use createWDKSvmSigner()."
+      );
+    }
+    return this._address;
+  }
+  /**
+   * Check if the adapter is initialized
+   */
+  get isInitialized() {
+    return this._initialized;
+  }
+  /**
+   * Initialize the adapter by fetching the address
+   * Must be called before using the signer
+   */
+  async initialize() {
+    if (this._initialized) {
+      return;
+    }
+    const addressStr = await this._account.getAddress();
+    this._address = addressStr;
+    this._initialized = true;
+  }
+  /**
+   * Sign transactions with this signer
+   *
+   * This method signs the message bytes of each transaction and returns
+   * signature dictionaries mapping address to signature.
+   *
+   * @param transactions - Array of transactions to sign
+   * @returns Array of signature dictionaries
+   */
+  async signTransactions(transactions) {
+    if (!transactions || transactions.length === 0) {
+      return [];
+    }
+    const results = [];
+    for (const tx of transactions) {
+      if (!tx.messageBytes || tx.messageBytes.length === 0) {
+        throw new Error("Transaction messageBytes must not be empty");
+      }
+      const signature = await this._account.sign(tx.messageBytes);
+      results.push({
+        [this._address]: signature
+      });
+    }
+    return results;
+  }
+  /**
+   * Sign a single message (utility method)
+   * @param message - Message bytes to sign
+   * @returns Signature bytes
+   */
+  async sign(message) {
+    return this._account.sign(message);
+  }
+  /**
+   * Get SOL balance in lamports
+   */
+  async getBalance() {
+    return this._account.getBalance();
+  }
+  /**
+   * Get SPL token balance
+   * @param mint - Token mint address
+   */
+  async getTokenBalance(mint) {
+    return this._account.getTokenBalance(mint);
+  }
+  /**
+   * Transfer SPL tokens
+   * @param params - Transfer parameters
+   * @returns Transaction signature
+   */
+  async transfer(params) {
+    return this._account.transfer(params);
+  }
+};
+async function createWDKSvmSigner(account) {
+  const adapter = new WDKSvmSignerAdapter(account);
+  await adapter.initialize();
+  return adapter;
+}
+
+export {
+  WDKSvmSignerAdapter,
+  createWDKSvmSigner
+};
+//# sourceMappingURL=chunk-MCFHZSF7.mjs.map

package/dist/esm/chunk-MCFHZSF7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/svm-adapter.ts"],"sourcesContent":["/**\n * Solana (SVM) Signer Adapter for WDK\n *\n * Wraps a Tether WDK Solana account to implement T402's ClientSvmSigner interface.\n * ClientSvmSigner is just TransactionSigner from @solana/kit.\n */\n\nimport type { WDKSolanaAccount } from '../types.js'\n\n/**\n * Address type from @solana/kit (base58 string)\n * We use a branded type for compatibility\n */\nexport type SolanaAddress = string & { readonly __brand?: unique symbol }\n\n/**\n * TransactionSigner interface matching @solana/kit\n * This is what T402's ClientSvmSigner expects\n */\nexport interface TransactionSigner {\n  readonly address: SolanaAddress\n  signTransactions<T extends { messageBytes: Uint8Array; signatures: Record<string, unknown> }>(\n    transactions: readonly T[],\n  ): Promise<readonly Record<string, Uint8Array>[]>\n}\n\n/**\n * WDKSvmSignerAdapter - Adapts a WDK Solana account to T402's ClientSvmSigner\n *\n * ClientSvmSigner is TransactionSigner from @solana/kit which requires:\n * - address: The public key as Address type\n * - signTransactions: Sign multiple transactions, returning signature dictionaries\n *\n * @example\n * ```typescript\n * const adapter = await createWDKSvmSigner(wdkSolanaAccount);\n *\n * // Use with T402 client\n * const client = createT402HTTPClient({\n *   signers: [{ scheme: 'exact', network: 'solana:mainnet', signer: adapter }]\n * });\n * ```\n */\nexport class WDKSvmSignerAdapter implements TransactionSigner {\n  private _account: WDKSolanaAccount\n  private _address: SolanaAddress | null = null\n  private _initialized = false\n\n  constructor(account: WDKSolanaAccount) {\n    if (!account) {\n      throw new Error('WDK Solana account is required')\n    }\n    this._account = account\n  }\n\n  /**\n   * Get the wallet address (base58)\n   * @throws Error if not initialized\n   */\n  get address(): SolanaAddress {\n    if (!this._address) {\n      throw new Error(\n        'Solana signer not initialized. Call initialize() first or use createWDKSvmSigner().',\n      )\n    }\n    return this._address\n  }\n\n  /**\n   * Check if the adapter is initialized\n   */\n  get isInitialized(): boolean {\n    return this._initialized\n  }\n\n  /**\n   * Initialize the adapter by fetching the address\n   * Must be called before using the signer\n   */\n  async initialize(): Promise<void> {\n    if (this._initialized) {\n      return\n    }\n\n    const addressStr = await this._account.getAddress()\n    this._address = addressStr as SolanaAddress\n    this._initialized = true\n  }\n\n  /**\n   * Sign transactions with this signer\n   *\n   * This method signs the message bytes of each transaction and returns\n   * signature dictionaries mapping address to signature.\n   *\n   * @param transactions - Array of transactions to sign\n   * @returns Array of signature dictionaries\n   */\n  async signTransactions<\n    T extends { messageBytes: Uint8Array; signatures: Record<string, unknown> },\n  >(transactions: readonly T[]): Promise<readonly Record<string, Uint8Array>[]> {\n    if (!transactions || transactions.length === 0) {\n      return []\n    }\n\n    const results: Record<string, Uint8Array>[] = []\n\n    for (const tx of transactions) {\n      if (!tx.messageBytes || tx.messageBytes.length === 0) {\n        throw new Error('Transaction messageBytes must not be empty')\n      }\n\n      // Sign the message bytes using WDK account\n      const signature = await this._account.sign(tx.messageBytes)\n\n      // Return as a dictionary mapping our address to the signature\n      results.push({\n        [this._address as string]: signature,\n      })\n    }\n\n    return results\n  }\n\n  /**\n   * Sign a single message (utility method)\n   * @param message - Message bytes to sign\n   * @returns Signature bytes\n   */\n  async sign(message: Uint8Array): Promise<Uint8Array> {\n    return this._account.sign(message)\n  }\n\n  /**\n   * Get SOL balance in lamports\n   */\n  async getBalance(): Promise<bigint> {\n    return this._account.getBalance()\n  }\n\n  /**\n   * Get SPL token balance\n   * @param mint - Token mint address\n   */\n  async getTokenBalance(mint: string): Promise<bigint> {\n    return this._account.getTokenBalance(mint)\n  }\n\n  /**\n   * Transfer SPL tokens\n   * @param params - Transfer parameters\n   * @returns Transaction signature\n   */\n  async transfer(params: { token: string; recipient: string; amount: bigint }): Promise<string> {\n    return this._account.transfer(params)\n  }\n}\n\n/**\n * Create an initialized WDK Solana signer\n *\n * @param account - WDK Solana account from @tetherto/wdk-wallet-solana\n * @returns Initialized TransactionSigner (ClientSvmSigner)\n *\n * @example\n * ```typescript\n * import { T402WDK } from '@t402/wdk';\n *\n * const wallet = new T402WDK(seedPhrase, config);\n * const svmSigner = await wallet.getSvmSigner();\n *\n * // Use with T402 client\n * const client = createT402HTTPClient({\n *   signers: [{ scheme: 'exact', network: 'solana:mainnet', signer: svmSigner }]\n * });\n * ```\n */\nexport async function createWDKSvmSigner(account: WDKSolanaAccount): Promise<WDKSvmSignerAdapter> {\n  const adapter = new WDKSvmSignerAdapter(account)\n  await adapter.initialize()\n  return adapter\n}\n"],"mappings":";AA2CO,IAAM,sBAAN,MAAuD;AAAA,EACpD;AAAA,EACA,WAAiC;AAAA,EACjC,eAAe;AAAA,EAEvB,YAAY,SAA2B;AACrC,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,MAAM,gCAAgC;AAAA,IAClD;AACA,SAAK,WAAW;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,UAAyB;AAC3B,QAAI,CAAC,KAAK,UAAU;AAClB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,gBAAyB;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,aAA4B;AAChC,QAAI,KAAK,cAAc;AACrB;AAAA,IACF;AAEA,UAAM,aAAa,MAAM,KAAK,SAAS,WAAW;AAClD,SAAK,WAAW;AAChB,SAAK,eAAe;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,iBAEJ,cAA4E;AAC5E,QAAI,CAAC,gBAAgB,aAAa,WAAW,GAAG;AAC9C,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,UAAwC,CAAC;AAE/C,eAAW,MAAM,cAAc;AAC7B,UAAI,CAAC,GAAG,gBAAgB,GAAG,aAAa,WAAW,GAAG;AACpD,cAAM,IAAI,MAAM,4CAA4C;AAAA,MAC9D;AAGA,YAAM,YAAY,MAAM,KAAK,SAAS,KAAK,GAAG,YAAY;AAG1D,cAAQ,KAAK;AAAA,QACX,CAAC,KAAK,QAAkB,GAAG;AAAA,MAC7B,CAAC;AAAA,IACH;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,KAAK,SAA0C;AACnD,WAAO,KAAK,SAAS,KAAK,OAAO;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAA8B;AAClC,WAAO,KAAK,SAAS,WAAW;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,gBAAgB,MAA+B;AACnD,WAAO,KAAK,SAAS,gBAAgB,IAAI;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,SAAS,QAA+E;AAC5F,WAAO,KAAK,SAAS,SAAS,MAAM;AAAA,EACtC;AACF;AAqBA,eAAsB,mBAAmB,SAAyD;AAChG,QAAM,UAAU,IAAI,oBAAoB,OAAO;AAC/C,QAAM,QAAQ,WAAW;AACzB,SAAO;AACT;","names":[]}