Quickstart

npm install tronweb

import { randomUUID } from 'node:crypto'
import { TronWeb } from 'tronweb'

const API = 'https://apiv2.tronergy.io/api'
const HEADERS = { 'content-type': 'application/json', 'x-api-key': process.env.TRONERGY_API_KEY }

const SENDER = 'TXyz...'    // your Shasta wallet, holds test USDT, no TRX
const RECIPIENT = 'TAbc...' // any TRON address
const USDT = 'TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs'

async function call(path, body) {
  const res = await fetch(`${API}${path}`, {
    method: body ? 'POST' : 'GET',
    headers: HEADERS,
    body: body ? JSON.stringify(body) : undefined,
  })
  const json = await res.json()
  if (!json.ok) throw new Error(`${res.status} ${json.error}: ${json.message ?? ''}`)
  return json
}

// 1. Build an unsigned USDT transfer
const built = await call('/chain_relayers/portal/construct-tx', {
  chain: 'tron',
  mode: 'sponsored_broadcast',
  senderAddress: SENDER,
  contractAddress: USDT,
  functionSelector: 'transfer(address,uint256)',
  parameter: [
    { type: 'address', value: RECIPIENT },
    { type: 'uint256', value: '1000000' }, // 1 USDT
  ],
})

// 2. Sign it
const tronWeb = new TronWeb({ fullHost: 'https://api.shasta.trongrid.io' })
const signedTx = await tronWeb.trx.sign(built.unsignedTxs[0].tx, process.env.SENDER_PRIVATE_KEY)

// 3. Execute
const { operationId } = await call('/chain_relayers/portal/execute', {
  chain: 'tron',
  mode: 'sponsored_broadcast',
  idempotencyKey: randomUUID(),
  payload: { signed_tx: signedTx },
})
console.log('Operation', operationId)

// 4. Wait for the result
const FINAL = ['completed', 'failed', 'voided', 'expired']
let operation
do {
  await new Promise((resolve) => setTimeout(resolve, 2000))
  operation = (await call(`/chain_relayers/portal/operations/${operationId}`)).operation
  console.log(operation.status)
} while (!FINAL.includes(operation.status))

if (operation.status === 'completed') {
  console.log(`https://shasta.tronscan.org/#/transaction/${operation.txHash}`)
} else {
  console.error(operation.errorCode, operation.errorMessage)
}

node send.mjs