@getomnichain/omnichain 0.6.3 → 0.7.0

package/dist/esm/ton/ton_wallet.d.ts

@@ -0,0 +1,134 @@
+import { type StateInit } from '@ton/core';
+import { WalletContractV3R2, WalletContractV4, WalletContractV5R1 } from '@ton/ton';
+import type { Chain } from '../chain.base.ts';
+import { ChainType, WalletFamily } from '../chain_type.ts';
+import { AbstractTransactionPrerequisite } from '../transaction_prerequisite.ts';
+import { UnsignedTransaction } from '../unsigned_transaction.ts';
+import { AbstractBip32StyleSingleAccountWallet, AbstractSignedMessage } from '../wallet.base.ts';
+import { type TonUserFriendlyOptions } from './ton_address.ts';
+import { type TonInternalRequest, type TonOutMessage, type TonWalletVersion, TonSignedMessage } from './ton_messages.ts';
+import { TonSignedTransaction } from './ton_transactions.ts';
+/** Seconds a request stays valid unless the caller says otherwise. */
+export declare const TON_DEFAULT_REQUEST_TTL_SECONDS = 60;
+/** SLIP-0010 ed25519 derivation along hardened `path` segments (e.g. `[44, 607, 0]`) from a BIP-39 seed. */
+export declare function deriveSlip10Ed25519Seed(bip39Seed: Uint8Array, path: readonly number[]): Buffer;
+/** The ed25519 seed of `m/44'/607'/{index}'`. */
+export declare function deriveTonEd25519Seed(bip39Seed: Uint8Array, index: number): Buffer;
+export declare const TON_WALLET_VERSIONS: readonly TonWalletVersion[];
+/** The workchains a wallet can live on: the basechain (0) and the masterchain (-1). */
+export type TonWorkchain = 0 | -1;
+/** The v3r2 / v4r2 wallet id the Python SDK uses on both workchains. */
+export declare const TON_LEGACY_DEFAULT_WALLET_ID = 698983191;
+/** v3r2 / v4r2 send at most four messages per request. */
+export declare const TON_LEGACY_MAX_MESSAGES = 4;
+/** The path the Python SDK accepts as a marker for TON's own scheme; it derives nothing. */
+export declare const TON_PYTHON_MARKER_PATH = "m/44'/607'/0'/0/0";
+/**
+ * The ed25519 seed TON's own mnemonic scheme gives (what TON wallets,
+ * `@ton/crypto`'s `mnemonicToPrivateKey` and the Python SDK compute):
+ * HMAC-SHA512 of the words keyed by the phrase, then PBKDF2-SHA512 with
+ * "TON default seed", 100,000 rounds; the first 32 bytes. The words are
+ * trimmed and lowercased, as the Python SDK does; they are not validated.
+ */
+export declare function deriveTonNativeSeed(mnemonicStr: string): Buffer;
+export interface TonRequestArgs {
+    seqno: number;
+    messages: readonly TonOutMessage[];
+    /** Unix seconds; defaults to now + {@link TON_DEFAULT_REQUEST_TTL_SECONDS}. */
+    validUntil?: number;
+}
+export interface TonExternalRequest {
+    /** The external message, base64 BOC, ready to broadcast. */
+    boc: string;
+    /** Its normalized hash, lowercase hex — the transaction id. */
+    hash: string;
+    seqno: number;
+    validUntil: number;
+}
+/**
+ * A wallet v5r1 (W5) account, its key derived from a BIP-39 mnemonic with
+ * SLIP-0010 ed25519 at the hardened path `m/44'/607'/{index}'`, on workchain 0
+ * with the mainnet client wallet id.
+ *
+ * It signs two kinds of request: an external one it sends itself (paying its
+ * own fees), and an internal one a relayer delivers and pays for
+ * (`tonRelayMessage`).
+ */
+export declare class TonWallet extends AbstractBip32StyleSingleAccountWallet {
+    #private;
+    readonly publicKey: Buffer;
+    /** The wallet contract: W5 (v5r1, the default), or v4r2 / v3r2 as the Python SDK builds them. */
+    readonly version: TonWalletVersion;
+    /** 0 (the basechain, the default) or -1 (the masterchain, where gas and storage cost far more). */
+    readonly workchain: TonWorkchain;
+    readonly contract: WalletContractV5R1 | WalletContractV4 | WalletContractV3R2;
+    private readonly _address;
+    constructor(ed25519Seed: Uint8Array, opts?: {
+        version?: TonWalletVersion;
+        workchain?: TonWorkchain;
+    });
+    static chainType(): ChainType;
+    static walletFamily(): WalletFamily;
+    chainType(): ChainType;
+    walletFamily(): WalletFamily;
+    /**
+     * - **No `derivationPath`** (or Python's marker `m/44'/607'/0'/0/0`): TON's
+     *   own mnemonic scheme, as TON wallets and the Python SDK derive it — one
+     *   key per mnemonic, so a wallet's own words give its W5 account. A
+     *   passphrase is refused: Python ignores it, so honouring it would give a
+     *   key Python does not.
+     * - **A `derivationPath`** (`derivationPath({ account })`): BIP-39 and
+     *   SLIP-0010 at that path — many accounts from one mnemonic. Note that
+     *   `m/44'/607'/0'` is account 0 of this scheme, not Python's key.
+     */
+    static fromMnemonic(mnemonicStr: string, opts?: {
+        derivationPath?: string;
+        passphrase?: string;
+        version?: TonWalletVersion;
+        workchain?: TonWorkchain;
+    }): TonWallet;
+    static derivationPath(args?: {
+        account?: number;
+    }): string;
+    /** Canonical raw address, `0:<hex>`. */
+    get address(): string;
+    addressUserFriendly(opts?: TonUserFriendlyOptions): string;
+    /** The code and data that deploy this wallet; attach while it is not deployed. */
+    get stateInit(): StateInit;
+    /**
+     * A request this wallet sends itself, as an external message. Pass `deploy`
+     * while the wallet is not deployed, so the message carries its StateInit.
+     *
+     * Every version sends external requests with "ignore errors" (+2) on every
+     * message (W5 forces it; v3r2 / v4r2 get it here), so a message that cannot
+     * be sent is skipped rather than failing the others — a v3r2 / v4r2
+     * request whose action phase failed would keep its seqno and could land
+     * again. v3r2 / v4r2 carry at most 4 messages.
+     */
+    createExternalRequest(args: TonRequestArgs & {
+        deploy?: boolean;
+    }): TonExternalRequest;
+    /**
+     * A signed internal request (op `0x73696e74`) for a relayer to deliver with
+     * `tonRelayMessage` — the gasless path, where another account pays. W5
+     * (v5r1) only: v3r2 / v4r2 wallets accept requests only as external
+     * messages they pay for themselves. Send modes are kept as given, so
+     * without "ignore errors" the request's messages leave all together or not
+     * at all.
+     */
+    createInternalRequest(args: TonRequestArgs): TonInternalRequest;
+    /**
+     * A v3r2 / v4r2 signed body: the signature, then wallet id, valid_until,
+     * seqno, (v4r2: op 0, "send messages"), and each message with its own send
+     * mode (+2) — what `@ton/ton`'s transfers build, with per-message modes.
+     */
+    private legacyExternalBody;
+    /** Signs `transaction` as an external request, reading the seqno and deployment from `chain`. */
+    signTransaction(transaction: UnsignedTransaction, chain: Chain): Promise<TonSignedTransaction>;
+    /** An ed25519 signature over {@link tonMessageHash}, hex; never over the message's bytes, which could pass for a request hash. */
+    signMessage(message: string): TonSignedMessage;
+    verifySignature(message: string, signedMessage: AbstractSignedMessage): boolean;
+    handleTransactionPrerequisite(prerequisite: AbstractTransactionPrerequisite): Promise<never>;
+    private static indexFromDerivationPath;
+}
+//# sourceMappingURL=ton_wallet.d.ts.map

package/dist/esm/ton/ton_wallet.d.ts.map

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

package/dist/esm/ton/ton_wallet.js

@@ -0,0 +1,278 @@
+import { createHmac, pbkdf2Sync } from 'node:crypto';
+import { SendMode, beginCell, external, storeMessage, storeMessageRelaxed } from '@ton/core';
+import { keyPairFromSeed, sign } from '@ton/crypto';
+import { WalletContractV3R2, WalletContractV4, WalletContractV5R1 } from '@ton/ton';
+import { mnemonicToSeedBip39 } from "../bip39.js";
+import { ChainType, WalletFamily } from "../chain_type.js";
+import { ChainError, ChainErrorKinds } from "../errors.js";
+import { AbstractBip32StyleSingleAccountWallet } from "../wallet.base.js";
+import { TonAddress } from "./ton_address.js";
+import { TonChain } from "./ton_chain.js";
+import { TonSignedMessage, tonMessageHash, tonNormalizedExternalHash, tonOutActions, } from "./ton_messages.js";
+import { TonSignedTransaction, TonUnsignedTransaction } from "./ton_transactions.js";
+const TON_COIN_TYPE = 607;
+const TON_DERIVATION_PATH_REGEX = /^m\/44'\/607'\/(\d+)'$/;
+const SLIP10_ED25519_SEED_MODIFIER = 'ed25519 seed';
+const FIRST_HARDENED_INDEX = 0x80000000;
+/** Seconds a request stays valid unless the caller says otherwise. */
+export const TON_DEFAULT_REQUEST_TTL_SECONDS = 60;
+/** SLIP-0010 ed25519 derivation along hardened `path` segments (e.g. `[44, 607, 0]`) from a BIP-39 seed. */
+export function deriveSlip10Ed25519Seed(bip39Seed, path) {
+    let digest = createHmac('sha512', SLIP10_ED25519_SEED_MODIFIER).update(bip39Seed).digest();
+    let il = digest.subarray(0, 32);
+    let ir = digest.subarray(32);
+    for (const segment of path) {
+        if (!Number.isInteger(segment) || segment < 0 || segment >= FIRST_HARDENED_INDEX) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `Invalid SLIP-0010 path segment ${segment}`);
+        }
+        const indexBytes = Buffer.alloc(4);
+        indexBytes.writeUInt32BE(FIRST_HARDENED_INDEX + segment);
+        digest = createHmac('sha512', ir).update(Buffer.concat([Buffer.alloc(1), il, indexBytes])).digest();
+        il = digest.subarray(0, 32);
+        ir = digest.subarray(32);
+    }
+    return Buffer.from(il);
+}
+/** The ed25519 seed of `m/44'/607'/{index}'`. */
+export function deriveTonEd25519Seed(bip39Seed, index) {
+    return deriveSlip10Ed25519Seed(bip39Seed, [44, TON_COIN_TYPE, index]);
+}
+export const TON_WALLET_VERSIONS = ['v3r2', 'v4r2', 'v5r1'];
+/** The v3r2 / v4r2 wallet id the Python SDK uses on both workchains. */
+export const TON_LEGACY_DEFAULT_WALLET_ID = 698983191;
+/** v3r2 / v4r2 send at most four messages per request. */
+export const TON_LEGACY_MAX_MESSAGES = 4;
+/** The path the Python SDK accepts as a marker for TON's own scheme; it derives nothing. */
+export const TON_PYTHON_MARKER_PATH = "m/44'/607'/0'/0/0";
+const TON_NATIVE_SEED_SALT = 'TON default seed';
+const TON_NATIVE_PBKDF2_ITERATIONS = 100_000;
+/**
+ * The ed25519 seed TON's own mnemonic scheme gives (what TON wallets,
+ * `@ton/crypto`'s `mnemonicToPrivateKey` and the Python SDK compute):
+ * HMAC-SHA512 of the words keyed by the phrase, then PBKDF2-SHA512 with
+ * "TON default seed", 100,000 rounds; the first 32 bytes. The words are
+ * trimmed and lowercased, as the Python SDK does; they are not validated.
+ */
+export function deriveTonNativeSeed(mnemonicStr) {
+    const words = mnemonicStr.trim().toLowerCase().split(/\s+/).filter((word) => word.length > 0);
+    if (words.length === 0)
+        throw new ChainError(ChainErrorKinds.InvalidArgument, 'The mnemonic is empty');
+    const entropy = createHmac('sha512', words.join(' ')).update('').digest();
+    return pbkdf2Sync(entropy, TON_NATIVE_SEED_SALT, TON_NATIVE_PBKDF2_ITERATIONS, 64, 'sha512').subarray(0, 32);
+}
+/**
+ * A wallet v5r1 (W5) account, its key derived from a BIP-39 mnemonic with
+ * SLIP-0010 ed25519 at the hardened path `m/44'/607'/{index}'`, on workchain 0
+ * with the mainnet client wallet id.
+ *
+ * It signs two kinds of request: an external one it sends itself (paying its
+ * own fees), and an internal one a relayer delivers and pays for
+ * (`tonRelayMessage`).
+ */
+export class TonWallet extends AbstractBip32StyleSingleAccountWallet {
+    publicKey;
+    /** The wallet contract: W5 (v5r1, the default), or v4r2 / v3r2 as the Python SDK builds them. */
+    version;
+    /** 0 (the basechain, the default) or -1 (the masterchain, where gas and storage cost far more). */
+    workchain;
+    contract;
+    #secretKey;
+    _address;
+    constructor(ed25519Seed, opts = {}) {
+        super();
+        if (ed25519Seed.length !== 32) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `A TON ed25519 seed is 32 bytes, got ${ed25519Seed.length}`);
+        }
+        const version = opts.version ?? 'v5r1';
+        if (!TON_WALLET_VERSIONS.includes(version)) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `TON wallet version must be one of ${TON_WALLET_VERSIONS.join(', ')}, got ${String(version)}`);
+        }
+        const workchain = opts.workchain ?? 0;
+        if (workchain !== 0 && workchain !== -1) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `A TON wallet lives on workchain 0 or -1, got ${String(workchain)}`);
+        }
+        const keyPair = keyPairFromSeed(Buffer.from(ed25519Seed));
+        this.publicKey = keyPair.publicKey;
+        this.#secretKey = keyPair.secretKey;
+        this.version = version;
+        this.workchain = workchain;
+        // The wallet ids the Python SDK (ton_core) uses on either workchain: W5's
+        // context names workchain 0 (as @ton/ton's default does), and v3r2 /
+        // v4r2's is 698983191 whatever the wallet's workchain — where @ton/ton
+        // would add the workchain, giving another address on -1.
+        const publicKey = keyPair.publicKey;
+        this.contract =
+            version === 'v5r1'
+                ? WalletContractV5R1.create({ workchain, publicKey })
+                : version === 'v4r2'
+                    ? WalletContractV4.create({ workchain, publicKey, walletId: TON_LEGACY_DEFAULT_WALLET_ID })
+                    : WalletContractV3R2.create({ workchain, publicKey, walletId: TON_LEGACY_DEFAULT_WALLET_ID });
+        this._address = this.contract.address.toRawString();
+    }
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return `TonWallet { address: '${this._address}' }`;
+    }
+    static chainType() {
+        return ChainType.TON;
+    }
+    static walletFamily() {
+        return WalletFamily.TON;
+    }
+    chainType() {
+        return TonWallet.chainType();
+    }
+    walletFamily() {
+        return TonWallet.walletFamily();
+    }
+    /**
+     * - **No `derivationPath`** (or Python's marker `m/44'/607'/0'/0/0`): TON's
+     *   own mnemonic scheme, as TON wallets and the Python SDK derive it — one
+     *   key per mnemonic, so a wallet's own words give its W5 account. A
+     *   passphrase is refused: Python ignores it, so honouring it would give a
+     *   key Python does not.
+     * - **A `derivationPath`** (`derivationPath({ account })`): BIP-39 and
+     *   SLIP-0010 at that path — many accounts from one mnemonic. Note that
+     *   `m/44'/607'/0'` is account 0 of this scheme, not Python's key.
+     */
+    static fromMnemonic(mnemonicStr, opts = {}) {
+        if (opts.derivationPath === undefined || opts.derivationPath === TON_PYTHON_MARKER_PATH) {
+            if (opts.passphrase !== undefined && opts.passphrase !== '') {
+                throw new ChainError(ChainErrorKinds.InvalidArgument, "TON's own mnemonic scheme takes no passphrase here (the Python SDK ignores it); pass a derivationPath to use one");
+            }
+            return new TonWallet(deriveTonNativeSeed(mnemonicStr), { version: opts.version, workchain: opts.workchain });
+        }
+        const index = TonWallet.indexFromDerivationPath(opts.derivationPath);
+        return new TonWallet(deriveTonEd25519Seed(mnemonicToSeedBip39(mnemonicStr, opts.passphrase ?? ''), index), { version: opts.version, workchain: opts.workchain });
+    }
+    static derivationPath(args = {}) {
+        return `m/44'/${TON_COIN_TYPE}'/${args.account ?? 0}'`;
+    }
+    /** Canonical raw address, `0:<hex>`. */
+    get address() {
+        return this._address;
+    }
+    addressUserFriendly(opts = {}) {
+        return new TonAddress(this._address).toUserFriendly(opts);
+    }
+    /** The code and data that deploy this wallet; attach while it is not deployed. */
+    get stateInit() {
+        return { code: this.contract.init.code, data: this.contract.init.data };
+    }
+    /**
+     * A request this wallet sends itself, as an external message. Pass `deploy`
+     * while the wallet is not deployed, so the message carries its StateInit.
+     *
+     * Every version sends external requests with "ignore errors" (+2) on every
+     * message (W5 forces it; v3r2 / v4r2 get it here), so a message that cannot
+     * be sent is skipped rather than failing the others — a v3r2 / v4r2
+     * request whose action phase failed would keep its seqno and could land
+     * again. v3r2 / v4r2 carry at most 4 messages.
+     */
+    createExternalRequest(args) {
+        const validUntil = args.validUntil ?? defaultValidUntil();
+        const body = this.contract instanceof WalletContractV5R1
+            ? this.contract.createRequest({
+                seqno: args.seqno,
+                timeout: validUntil,
+                secretKey: this.#secretKey,
+                authType: 'external',
+                actions: tonOutActions(args.messages),
+            })
+            : this.legacyExternalBody(args.seqno, validUntil, args.messages);
+        const message = external({ to: this.contract.address, init: args.deploy === true ? this.stateInit : undefined, body });
+        return {
+            boc: beginCell().store(storeMessage(message)).endCell().toBoc().toString('base64'),
+            hash: tonNormalizedExternalHash(this._address, body),
+            seqno: args.seqno,
+            validUntil,
+        };
+    }
+    /**
+     * A signed internal request (op `0x73696e74`) for a relayer to deliver with
+     * `tonRelayMessage` — the gasless path, where another account pays. W5
+     * (v5r1) only: v3r2 / v4r2 wallets accept requests only as external
+     * messages they pay for themselves. Send modes are kept as given, so
+     * without "ignore errors" the request's messages leave all together or not
+     * at all.
+     */
+    createInternalRequest(args) {
+        if (!(this.contract instanceof WalletContractV5R1)) {
+            throw new ChainError(ChainErrorKinds.FeatureNotSupported, `Relayed (gasless) requests need a W5 (v5r1) wallet; this one is ${this.version}`);
+        }
+        const validUntil = args.validUntil ?? defaultValidUntil();
+        const body = this.contract.createRequest({
+            seqno: args.seqno,
+            timeout: validUntil,
+            secretKey: this.#secretKey,
+            authType: 'internal',
+            actions: tonOutActions(args.messages),
+        });
+        return { body, seqno: args.seqno, validUntil };
+    }
+    /**
+     * A v3r2 / v4r2 signed body: the signature, then wallet id, valid_until,
+     * seqno, (v4r2: op 0, "send messages"), and each message with its own send
+     * mode (+2) — what `@ton/ton`'s transfers build, with per-message modes.
+     */
+    legacyExternalBody(seqno, validUntil, messages) {
+        if (messages.length > TON_LEGACY_MAX_MESSAGES) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `A ${this.version} request carries at most ${TON_LEGACY_MAX_MESSAGES} messages, got ${messages.length}`);
+        }
+        const signing = beginCell()
+            .storeUint(this.contract.walletId, 32)
+            .storeUint(validUntil, 32)
+            .storeUint(seqno, 32);
+        if (this.version === 'v4r2')
+            signing.storeUint(0, 8);
+        for (const action of tonOutActions(messages)) {
+            signing.storeUint(action.mode | SendMode.IGNORE_ERRORS, 8).storeRef(beginCell().store(storeMessageRelaxed(action.outMsg)).endCell());
+        }
+        const signature = sign(signing.endCell().hash(), this.#secretKey);
+        return beginCell().storeBuffer(signature).storeBuilder(signing).endCell();
+    }
+    /** Signs `transaction` as an external request, reading the seqno and deployment from `chain`. */
+    async signTransaction(transaction, chain) {
+        if (!(transaction instanceof TonUnsignedTransaction)) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `Expected a TonUnsignedTransaction, got ${transaction.constructor.name}`);
+        }
+        if (new TonAddress(transaction.walletAddress).canonical() !== this._address) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `Transaction is for ${transaction.walletAddress}, not this wallet ${this._address}`);
+        }
+        const tonChain = assertTonChain(chain);
+        if (tonChain.chainId !== transaction.chainId) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `Transaction for chain ${transaction.chainId} cannot be signed on ${tonChain.chainId}`);
+        }
+        const seqno = await tonChain.getSeqno(this._address);
+        // At seqno 0 the wallet may have no code yet; a StateInit sent to a
+        // deployed wallet is ignored.
+        const request = this.createExternalRequest({ seqno, messages: transaction.messages, validUntil: transaction.validUntil, deploy: seqno === 0 });
+        return new TonSignedTransaction({ chainId: transaction.chainId, boc: request.boc });
+    }
+    /** An ed25519 signature over {@link tonMessageHash}, hex; never over the message's bytes, which could pass for a request hash. */
+    signMessage(message) {
+        return new TonSignedMessage(sign(tonMessageHash(message), this.#secretKey).toString('hex'));
+    }
+    verifySignature(message, signedMessage) {
+        return TonChain.verifySignature(this.publicKey, message, signedMessage);
+    }
+    async handleTransactionPrerequisite(prerequisite) {
+        throw new ChainError(ChainErrorKinds.FeatureNotSupported, `TonWallet has no transaction prerequisites (got ${prerequisite?.constructor?.name ?? typeof prerequisite})`);
+    }
+    static indexFromDerivationPath(derivationPath) {
+        const match = TON_DERIVATION_PATH_REGEX.exec(derivationPath);
+        if (match === null) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `Invalid TON derivation path ${derivationPath}; expected m/44'/607'/<account>' (hardened, SLIP-0010)`);
+        }
+        return Number(match[1]);
+    }
+}
+function assertTonChain(chain) {
+    if (!(chain instanceof TonChain)) {
+        throw new ChainError(ChainErrorKinds.InvalidArgument, `Expected a TonChain, got ${chain.constructor.name}`);
+    }
+    return chain;
+}
+function defaultValidUntil() {
+    return Math.floor(Date.now() / 1000) + TON_DEFAULT_REQUEST_TTL_SECONDS;
+}
+//# sourceMappingURL=ton_wallet.js.map

package/dist/esm/ton/ton_wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ton_wallet.js","sourceRoot":"","sources":["../../../ton/ton_wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAa,QAAQ,EAAkB,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACxH,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,EAAE,qCAAqC,EAAyB,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAE,UAAU,EAA+B,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAIL,gBAAgB,EAChB,cAAc,EACd,yBAAyB,EACzB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAErF,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,yBAAyB,GAAG,wBAAwB,CAAC;AAC3D,MAAM,4BAA4B,GAAG,cAAc,CAAC;AACpD,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC,sEAAsE;AACtE,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAElD,4GAA4G;AAC5G,MAAM,UAAU,uBAAuB,CAAC,SAAqB,EAAE,IAAuB;IACpF,IAAI,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,4BAA4B,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3F,IAAI,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChC,IAAI,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,IAAI,oBAAoB,EAAE,CAAC;YACjF,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,eAAe,EAAE,kCAAkC,OAAO,EAAE,CAAC,CAAC;QACrG,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnC,UAAU,CAAC,aAAa,CAAC,oBAAoB,GAAG,OAAO,CAAC,CAAC;QACzD,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACpG,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5B,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,oBAAoB,CAAC,SAAqB,EAAE,KAAa;IACvE,OAAO,uBAAuB,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAgC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAGzF,wEAAwE;AACxE,MAAM,CAAC,MAAM,4BAA4B,GAAG,SAAS,CAAC;AACtD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC,4FAA4F;AAC5F,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAE1D,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAChD,MAAM,4BAA4B,GAAG,OAAO,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,eAAe,EAAE,uBAAuB,CAAC,CAAC;IACvG,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1E,OAAO,UAAU,CAAC,OAAO,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/G,CAAC;AAkBD;;;;;;;;GAQG;AACH,MAAM,OAAO,SAAU,SAAQ,qCAAqC;IACzD,SAAS,CAAS;IAC3B,iGAAiG;IACxF,OAAO,CAAmB;IACnC,mGAAmG;IAC1F,SAAS,CAAe;IACxB,QAAQ,CAA6D;IACrE,UAAU,CAAS;IACX,QAAQ,CAAS;IAElC,YAAY,WAAuB,EAAE,OAAiE,EAAE;QACtG,KAAK,EAAE,CAAC;QACR,IAAI,WAAW,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YAC9B,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,eAAe,EAAE,uCAAuC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QACrH,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC;QACvC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,eAAe,EAAE,qCAAqC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACvJ,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACtC,IAAI,SAAS,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,eAAe,EAAE,gDAAgD,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC7H,CAAC;QACD,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,0EAA0E;QAC1E,qEAAqE;QACrE,uEAAuE;QACvE,yDAAyD;QACzD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACpC,IAAI,CAAC,QAAQ;YACX,OAAO,KAAK,MAAM;gBAChB,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;gBACrD,CAAC,CAAC,OAAO,KAAK,MAAM;oBAClB,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,4BAA4B,EAAE,CAAC;oBAC3F,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,4BAA4B,EAAE,CAAC,CAAC;QACpG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACtD,CAAC;IAED,CAAC,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QACxC,OAAO,yBAAyB,IAAI,CAAC,QAAQ,KAAK,CAAC;IACrD,CAAC;IAED,MAAM,CAAC,SAAS;QACd,OAAO,SAAS,CAAC,GAAG,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO,YAAY,CAAC,GAAG,CAAC;IAC1B,CAAC;IAED,SAAS;QACP,OAAO,SAAS,CAAC,SAAS,EAAE,CAAC;IAC/B,CAAC;IAED,YAAY;QACV,OAAO,SAAS,CAAC,YAAY,EAAE,CAAC;IAClC,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,YAAY,CACjB,WAAmB,EACnB,OAA+G,EAAE;QAEjH,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC,cAAc,KAAK,sBAAsB,EAAE,CAAC;YACxF,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,KAAK,EAAE,EAAE,CAAC;gBAC5D,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,kHAAkH,CACnH,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,SAAS,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/G,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,uBAAuB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrE,OAAO,IAAI,SAAS,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACnK,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,OAA6B,EAAE;QACnD,OAAO,SAAS,aAAa,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC;IACzD,CAAC;IAED,wCAAwC;IACxC,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,mBAAmB,CAAC,OAA+B,EAAE;QACnD,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,kFAAkF;IAClF,IAAI,SAAS;QACX,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1E,CAAC;IAED;;;;;;;;;OASG;IACH,qBAAqB,CAAC,IAA2C;QAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,iBAAiB,EAAE,CAAC;QAC1D,MAAM,IAAI,GACR,IAAI,CAAC,QAAQ,YAAY,kBAAkB;YACzC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAC1B,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,UAAU;gBACnB,SAAS,EAAE,IAAI,CAAC,UAAU;gBAC1B,QAAQ,EAAE,UAAU;gBACpB,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC;aACtC,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvH,OAAO;YACL,GAAG,EAAE,SAAS,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAClF,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC;YACpD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU;SACX,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,qBAAqB,CAAC,IAAoB;QACxC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,YAAY,kBAAkB,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,mBAAmB,EACnC,mEAAmE,IAAI,CAAC,OAAO,EAAE,CAClF,CAAC;QACJ,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,iBAAiB,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;YACvC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,UAAU;YACnB,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,QAAQ,EAAE,UAAU;YACpB,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC;SACtC,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACK,kBAAkB,CAAC,KAAa,EAAE,UAAkB,EAAE,QAAkC;QAC9F,IAAI,QAAQ,CAAC,MAAM,GAAG,uBAAuB,EAAE,CAAC;YAC9C,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,eAAe,EAAE,KAAK,IAAI,CAAC,OAAO,4BAA4B,uBAAuB,kBAAkB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACjK,CAAC;QACD,MAAM,OAAO,GAAG,SAAS,EAAE;aACxB,SAAS,CAAE,IAAI,CAAC,QAAkD,CAAC,QAAQ,EAAE,EAAE,CAAC;aAChF,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC;aACzB,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM;YAAE,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,KAAK,MAAM,MAAM,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACvI,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAClE,OAAO,SAAS,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IAC5E,CAAC;IAED,iGAAiG;IACjG,KAAK,CAAC,eAAe,CAAC,WAAgC,EAAE,KAAY;QAClE,IAAI,CAAC,CAAC,WAAW,YAAY,sBAAsB,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,eAAe,EAAE,0CAA0C,WAAW,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QAClI,CAAC;QACD,IAAI,IAAI,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,SAAS,EAAE,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5E,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,sBAAsB,WAAW,CAAC,aAAa,qBAAqB,IAAI,CAAC,QAAQ,EAAE,CACpF,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,QAAQ,CAAC,OAAO,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC;YAC7C,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,yBAAyB,WAAW,CAAC,OAAO,wBAAwB,QAAQ,CAAC,OAAO,EAAE,CACvF,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrD,oEAAoE;QACpE,8BAA8B;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/I,OAAO,IAAI,oBAAoB,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,kIAAkI;IAClI,WAAW,CAAC,OAAe;QACzB,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,eAAe,CAAC,OAAe,EAAE,aAAoC;QACnE,OAAO,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,6BAA6B,CAAC,YAA6C;QAC/E,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,mBAAmB,EACnC,mDAAmD,YAAY,EAAE,WAAW,EAAE,IAAI,IAAI,OAAO,YAAY,GAAG,CAC7G,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,uBAAuB,CAAC,cAAsB;QAC3D,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,+BAA+B,cAAc,wDAAwD,CACtG,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,SAAS,cAAc,CAAC,KAAY;IAClC,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,eAAe,EAAE,4BAA4B,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,+BAA+B,CAAC;AACzE,CAAC"}

package/docs/README.md

@@ -37,7 +37,7 @@ mounted at each service's own `chain` directory.
 | **Solana** (mainnet, devnet, testnet) | [solana/](../solana) | `SolanaChain` over `@solana/web3.js` v1 + SPL Token / Token-2022 — see [solana.md](./solana.md) |
 | **Stellar** (mainnet, testnet) | [stellar/](../stellar) | `StellarChain` over `@stellar/stellar-sdk` (Horizon + Soroban RPC); import from `@getomnichain/omnichain/stellar` — see [stellar.md](./stellar.md) |
 | **Tron** (mainnet, Shasta) | [tron/](../tron) | `TronChain` over the TronGrid HTTP API (tronpy port); import from `@getomnichain/omnichain/tron` — see [tron.md](./tron.md) |
-| **TON** | [ton/](../ton) | `TonAddress` only (no full chain yet) |
+| **TON** (mainnet) | [ton/](../ton) | `TonChain` over TON Center v3 with TonAPI as fallback, W5R1 wallets and relayed requests; import from `@getomnichain/omnichain/ton` — see [ton.md](./ton.md) |
 
 ## Quickstart
 
@@ -281,3 +281,4 @@ Add `Foo` enum value to [network_type.ts](../network_type.ts), create
 - [solana.md](./solana.md) — Solana, SPL Token, Token-2022, priority-fee model
 - [stellar.md](./stellar.md) — Stellar classic + Soroban, trustlines, SEP-5/SEP-53 wallet
 - [tron.md](./tron.md) — Tron TRX + TRC-20, energy fees, approvals, canonical transactions
+- [ton.md](./ton.md) — TON and jettons, W5R1 wallets, relayed requests, trace emulation and status