TRON chain

TRON-specific Omniston SDK notes for cross-chain order settlement.

Use this page when your Omniston SDK integration needs to identify TRON assets or addresses.

TRON is supported as a separate Omniston chain, not as an EVM chain. Do not reuse EVM address validation, wallet detection, or allowance assumptions for TRON accounts.

Chain and Asset Shape

TRON uses the tron SDK chain discriminator.

For TRC-20 assets, use kind.$case: "trc20":

import type { AssetId, ChainAddress } from "@ston-fi/omniston-sdk";

const tronUsdt: AssetId = {
  chain: {
    $case: "tron",
    value: {
      kind: {
        $case: "trc20",
        value: "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      },
    },
  },
};

const tronTraderAddress: ChainAddress = {
  chain: {
    $case: "tron",
    value: "T...",
  },
};

Keep the same chain on each side of the trade:

the source-side AssetId and source-side ChainAddress must both use tron when the trader sends funds from TRON
the destination-side AssetId and destination-side ChainAddress must both use tron when the trader receives funds on TRON
cross-chain swaps use different source and destination chains

For the maintained chain and asset matrix, see Overview (Omniston).

Settlement Notes

For TRON cross-chain routes, use order settlement. TRON swap settlement is not currently the expected integration path.

Follow the same high-level order lifecycle used by other cross-chain routes:

request quotes with order settlement enabled
select an order quote
build and sign the required order payload
register the signed order with Omniston
track the order with orderTrack()

The exact wallet connection, signing, allowance, and transaction broadcast steps are integration-specific. If the selected route uses a TRC-20 input asset, check token allowance for the source-side protocol contract before registering the signed order.

Payload Builder

Current SDK examples for order settlement use the EVM order payload builder:

const orderPayload = await omniston.evmBuildOrderPayload({
  quoteId: quote.quoteId,
  ownerSrcAddress: tronTraderAddress,
  traderDstAddress,
  traderDstDiscloseAddress: traderDstAddress,
});

This reflects the current SDK API surface for signed order payloads. Treat the wallet-specific signing and broadcast logic as application code, and validate it against the wallet stack used by your product.