@getomnichain/omnichain 0.6.2 → 0.7.0

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

@@ -0,0 +1,116 @@
+import { type NestedBalanceChanges, TransactionStatus, type TransactionErrorInfo, type TransactionStatusType } from '../transaction_status.ts';
+import { type TonTrace, type TonTraceMessage, type TonTraceTransaction } from './ton_provider.ts';
+/** Jettons a jetton wallet received in a trace (a TEP-74 `internal_transfer` it accepted). */
+/** Jettons a jetton wallet accepted (`internal_transfer`), read from the trace alone — not yet checked against any master. */
+export interface TonJettonCredit {
+    /** The receiving jetton wallet, raw. */
+    jettonWallet: string;
+    amount: bigint;
+    /** The previous owner the transfer names, raw. */
+    from: string | null;
+    /** The jetton wallet that sent them, raw. */
+    senderJettonWallet: string | null;
+    /** The receiving transaction. */
+    transaction: string;
+}
+/** What happened to one message a wallet sent. */
+export type TonDeliveryOutcome = 
+/**
+ * Its destination kept it (a non-bounceable message is delivered even if the
+ * receiver then failed). For a jetton transfer, the receiver's jetton wallet
+ * accepted the jettons.
+ */
+'delivered'
+/** Its destination failed or had no code, and the value (or the jettons) came back. */
+ | 'bounced'
+/**
+ * A bounceable message whose destination failed without sending it back —
+ * an action phase that failed without send mode +16, or too little value
+ * left to pay for the bounce. The value stayed there or went on fees.
+ */
+ | 'failed'
+/**
+ * A jetton transfer whose sender's jetton wallet took it without error but
+ * sent the jettons nowhere. Never a message missing from a complete trace:
+ * that is the provider's gap, refused as an inconsistent trace.
+ */
+ | 'undelivered'
+/** The trace is still running. */
+ | 'pending';
+export interface TonMessageDelivery {
+    /** The sending wallet, raw. */
+    from: string;
+    /** Raw. */
+    to: string;
+    value: bigint;
+    outcome: TonDeliveryOutcome;
+    /** The receiving transaction's hash, when there is one. */
+    transaction: string | null;
+}
+/** Why the request did not do what it was signed for. */
+export interface TonRequestProblem {
+    code: string;
+    reason: string;
+}
+/** What a trace did, from either a real trace or an emulation. */
+export interface TonTraceSummary {
+    /**
+     * The request did what it was signed for: the sending wallet's transaction
+     * (and, for a relayed request, the target wallet's) succeeded with nothing
+     * skipped, and every message those wallets sent was delivered. Failures
+     * further down — a recipient contract that throws on a notification, an
+     * excess refund that was skipped — do not undo those deliveries and are
+     * reported in `failedTransactions` / `bouncedMessages` only.
+     */
+    success: boolean;
+    problem: TonRequestProblem | null;
+    /** Every message the sending wallets sent, and what became of it. */
+    deliveries: TonMessageDelivery[];
+    /** Nanotons the network took: every transaction's fees plus the forward fees its messages carried. */
+    fees: bigint;
+    failedTransactions: TonTraceTransaction[];
+    bouncedMessages: TonTraceMessage[];
+    /** Native TON per account. */
+    balanceChanges: NestedBalanceChanges;
+    jettonCredits: TonJettonCredit[];
+}
+export declare function summarizeTonTrace(chainId: number, trace: TonTrace): TonTraceSummary;
+export interface TonTransactionStatusInit {
+    chainId: number;
+    status: TransactionStatusType;
+    inclusionAt?: Date | null;
+    error?: TransactionErrorInfo | null;
+    balanceChanges?: NestedBalanceChanges | null;
+    trace?: TonTrace | null;
+    summary?: TonTraceSummary | null;
+    masterchainSeqno?: number | null;
+    masterchainDepth?: number | null;
+}
+/**
+ * The status of an external message's whole trace.
+ *
+ * Final — `Success` or `Failed` — only once the trace is complete and every
+ * transaction in it is in a block a masterchain block references. TON's
+ * consensus is final at that point; `masterchainDepth` lets a caller ask for
+ * more anyway. `Failed` when the request did not do what it was signed for
+ * (see {@link TonTraceSummary.success}); a failed status still carries the
+ * summary, whose `deliveries` say which messages did arrive.
+ */
+export declare class TonTransactionStatus extends TransactionStatus {
+    readonly trace: TonTrace | null;
+    readonly summary: TonTraceSummary | null;
+    /** The highest masterchain block referencing the trace's transactions. */
+    readonly masterchainSeqno: number | null;
+    /** Masterchain blocks since then. */
+    readonly masterchainDepth: number | null;
+    constructor(init: TonTransactionStatusInit);
+    get fees(): bigint | null;
+    get jettonCredits(): TonJettonCredit[];
+    static fromTrace(args: {
+        chainId: number;
+        trace: TonTrace | null;
+        masterchainTip: number;
+        minMasterchainDepth?: number;
+    }): TonTransactionStatus;
+}
+//# sourceMappingURL=ton_transaction_status.d.ts.map

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

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

package/dist/esm/ton/ton_transaction_status.js

@@ -0,0 +1,226 @@
+import { AssetBalanceChange, TransactionStatus, TransactionStatusTypes, assetHashOf, } from "../transaction_status.js";
+import { TonAsset } from "./ton_asset.js";
+import { TON_JETTON_INTERNAL_TRANSFER_OP, TON_JETTON_TRANSFER_OP, TON_W5_SIGNED_INTERNAL_OP } from "./ton_messages.js";
+import { assertTraceConsistent } from "./ton_provider.js";
+export function summarizeTonTrace(chainId, trace) {
+    assertTraceConsistent('the trace given', trace);
+    const native = new TonAsset(chainId, 'TON', null, TonAsset.NATIVE_DECIMALS);
+    const deltas = new Map();
+    const add = (account, delta) => {
+        deltas.set(account, (deltas.get(account) ?? 0n) + delta);
+    };
+    let fees = 0n;
+    const jettonCredits = [];
+    for (const tx of trace.transactions) {
+        fees += tx.totalFees;
+        let debit = tx.totalFees;
+        if (tx.inMsg !== null && tx.inMsg.source !== null)
+            add(tx.account, tx.inMsg.value);
+        for (const out of tx.outMsgs) {
+            if (out.destination === null)
+                continue;
+            fees += out.fwdFee;
+            debit += out.value + out.fwdFee;
+        }
+        add(tx.account, -debit);
+        // Accepted unless the jetton wallet's transaction aborted; a refund it then skipped does not undo the credit.
+        const credit = !tx.aborted && tx.inMsg !== null ? jettonCreditOf(tx, tx.inMsg) : null;
+        if (credit !== null)
+            jettonCredits.push(credit);
+    }
+    const balanceChanges = new Map();
+    for (const [account, delta] of deltas) {
+        balanceChanges.set(account, new Map([[assetHashOf(native), { token: native, change: AssetBalanceChange.fromMr(delta, TonAsset.NATIVE_DECIMALS) }]]));
+    }
+    const { problem, deliveries } = judgeRequest(trace);
+    return {
+        success: problem === null,
+        problem,
+        deliveries,
+        fees,
+        failedTransactions: trace.transactions.filter((tx) => !tx.success),
+        bouncedMessages: trace.transactions.flatMap((tx) => (tx.inMsg !== null && tx.inMsg.bounced ? [tx.inMsg] : [])),
+        balanceChanges,
+        jettonCredits,
+    };
+}
+/**
+ * Judges the wallets that sent the request — the root, and any wallet it
+ * delivered a signed internal request to — on their own transactions and on
+ * the first hop of every message they sent.
+ */
+function judgeRequest(trace) {
+    const root = trace.transactions[0];
+    if (root === undefined)
+        return { problem: { code: 'no_transaction', reason: 'the trace has no transaction' }, deliveries: [] };
+    const children = childrenByParent(trace.transactions);
+    const relayTargets = (children.get(root.hash) ?? []).filter((tx) => tx.inMsg?.opcode === TON_W5_SIGNED_INTERNAL_OP);
+    const deliveries = [];
+    let problem = null;
+    const note = (found) => {
+        problem ??= found;
+    };
+    for (const wallet of [root, ...relayTargets]) {
+        if (!wallet.success) {
+            note(wallet.skippedActions > 0
+                ? { code: 'skipped_actions', reason: `${wallet.account} skipped ${wallet.skippedActions} message(s) it could not send` }
+                : { code: String(wallet.computeExitCode ?? wallet.actionResultCode ?? 'failed'), reason: `${wallet.account} failed in ${wallet.hash}` });
+        }
+        // A bounce the wallet sends back is not a message it was asked to send.
+        // Sorted by creation, the order the request listed them.
+        const sent = wallet.outMsgs
+            .filter((m) => m.destination !== null && !m.bounced)
+            .sort((a, b) => (a.createdLt === b.createdLt ? 0 : (a.createdLt ?? 0n) < (b.createdLt ?? 0n) ? -1 : 1));
+        if (wallet !== root && wallet.success && sent.length === 0) {
+            note({ code: 'request_not_executed', reason: `${wallet.account} did not execute the relayed request (bad signature or seqno)` });
+        }
+        const received = children.get(wallet.hash) ?? [];
+        for (const message of sent) {
+            const { receiver, outcome: firstHop } = deliveryOf(message, received, trace.complete);
+            // A jetton transfer moves the jettons one hop later, in the receiver's jetton wallet.
+            const jettonHop = firstHop === 'delivered' && message.opcode === TON_JETTON_TRANSFER_OP && receiver !== null
+                ? jettonDeliveryOf(receiver, children.get(receiver.hash) ?? [], trace.complete)
+                : null;
+            const outcome = jettonHop?.outcome ?? firstHop;
+            deliveries.push({
+                from: wallet.account,
+                to: message.destination,
+                value: message.value,
+                outcome,
+                transaction: jettonHop?.receiver?.hash ?? receiver?.hash ?? null,
+            });
+            if (outcome === 'bounced' || outcome === 'undelivered' || outcome === 'failed') {
+                const code = outcome === 'failed' ? 'receiver_failed' : outcome;
+                note({
+                    code: jettonHop === null ? code : `jetton_${code}`,
+                    reason: `a ${jettonHop === null ? 'message' : 'jetton transfer'} from ${wallet.account} to ${message.destination} was ${outcome}`,
+                });
+            }
+        }
+    }
+    return { problem, deliveries };
+}
+/**
+ * Which received transaction took `message`, and whether it kept the value.
+ *
+ * Matched on (source, createdLt), which names one message. The providers
+ * refuse a trace whose receivers disagree with their senders, so a match is
+ * the message itself.
+ */
+function deliveryOf(message, received, complete) {
+    const receiver = received.find((tx) => tx.inMsg !== null && tx.inMsg.source === message.source && tx.inMsg.createdLt === message.createdLt) ??
+        null;
+    if (receiver === null)
+        return { receiver, outcome: complete ? 'undelivered' : 'pending' };
+    // A receiver that did not abort kept the value, even if it skipped one of its
+    // own sends (e.g. an excess refund under "ignore errors"); so did one a
+    // non-bounceable message reached. An aborted receiver of a bounceable message
+    // sends it back only on a failed compute phase (no code yet included), a
+    // failed action with send mode +16, and when the value covers the bounce;
+    // the bounce is in the receiver's own transaction.
+    if (!message.bounce || !receiver.aborted)
+        return { receiver, outcome: 'delivered' };
+    const bouncedBack = receiver.outMsgs.some((m) => m.bounced && m.destination === message.source);
+    return { receiver, outcome: bouncedBack ? 'bounced' : 'failed' };
+}
+/** The `internal_transfer` the sender's jetton wallet sent on, judged where the jettons land. */
+function jettonDeliveryOf(senderJettonWallet, received, complete) {
+    const transfer = senderJettonWallet.outMsgs.find((m) => m.opcode === TON_JETTON_INTERNAL_TRANSFER_OP && !m.bounced);
+    if (transfer === undefined)
+        return { receiver: null, outcome: complete ? 'undelivered' : 'pending' };
+    return deliveryOf(transfer, received, complete);
+}
+function childrenByParent(transactions) {
+    const byParent = new Map();
+    for (const tx of transactions) {
+        if (tx.parent === null)
+            continue;
+        byParent.set(tx.parent, [...(byParent.get(tx.parent) ?? []), tx]);
+    }
+    return byParent;
+}
+function jettonCreditOf(tx, inMsg) {
+    if (inMsg.opcode !== TON_JETTON_INTERNAL_TRANSFER_OP || inMsg.bounced || inMsg.body === null)
+        return null;
+    try {
+        const slice = inMsg.body.beginParse();
+        slice.skip(32 + 64);
+        const amount = slice.loadCoins();
+        const from = slice.loadMaybeAddress();
+        return {
+            jettonWallet: tx.account,
+            amount,
+            from: from === null ? null : from.toRawString(),
+            senderJettonWallet: inMsg.source,
+            transaction: tx.hash,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The status of an external message's whole trace.
+ *
+ * Final — `Success` or `Failed` — only once the trace is complete and every
+ * transaction in it is in a block a masterchain block references. TON's
+ * consensus is final at that point; `masterchainDepth` lets a caller ask for
+ * more anyway. `Failed` when the request did not do what it was signed for
+ * (see {@link TonTraceSummary.success}); a failed status still carries the
+ * summary, whose `deliveries` say which messages did arrive.
+ */
+export class TonTransactionStatus extends TransactionStatus {
+    trace;
+    summary;
+    /** The highest masterchain block referencing the trace's transactions. */
+    masterchainSeqno;
+    /** Masterchain blocks since then. */
+    masterchainDepth;
+    constructor(init) {
+        super({
+            chainId: init.chainId,
+            status: init.status,
+            inclusionAt: init.inclusionAt,
+            error: init.error,
+            balanceChanges: init.balanceChanges,
+        });
+        this.trace = init.trace ?? null;
+        this.summary = init.summary ?? null;
+        this.masterchainSeqno = init.masterchainSeqno ?? null;
+        this.masterchainDepth = init.masterchainDepth ?? null;
+    }
+    get fees() {
+        return this.summary?.fees ?? null;
+    }
+    get jettonCredits() {
+        return this.summary?.jettonCredits ?? [];
+    }
+    static fromTrace(args) {
+        const { chainId, trace } = args;
+        const pending = () => new TonTransactionStatus({ chainId, status: TransactionStatusTypes.Pending, trace });
+        if (trace === null || !trace.complete || trace.transactions.length === 0)
+            return pending();
+        const seqnos = trace.transactions.map((tx) => tx.mcSeqno);
+        if (seqnos.some((seqno) => seqno === null))
+            return pending();
+        const masterchainSeqno = Math.max(...seqnos);
+        const masterchainDepth = Math.max(args.masterchainTip - masterchainSeqno, 0);
+        if (masterchainDepth < (args.minMasterchainDepth ?? 0))
+            return pending();
+        const summary = summarizeTonTrace(chainId, trace);
+        const common = {
+            chainId,
+            inclusionAt: new Date(trace.transactions[0].utime * 1000),
+            trace,
+            summary,
+            masterchainSeqno,
+            masterchainDepth,
+        };
+        if (summary.success) {
+            return new TonTransactionStatus({ ...common, status: TransactionStatusTypes.Success, balanceChanges: summary.balanceChanges });
+        }
+        const error = { ...summary.problem };
+        return new TonTransactionStatus({ ...common, status: TransactionStatusTypes.Failed, error });
+    }
+}
+//# sourceMappingURL=ton_transaction_status.js.map

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

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

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

@@ -0,0 +1,54 @@
+import { AbstractSignedTransaction } from '../signed_transaction.ts';
+import { type JsonDict, type JsonTransactionInput } from '../transaction_json.ts';
+import { UnsignedTransaction } from '../unsigned_transaction.ts';
+import { type TonOutMessage } from './ton_messages.ts';
+/**
+ * A request a wallet will send itself: its messages, and optionally how long
+ * the signed request stays valid. The seqno and whether to deploy are read at
+ * signing time (`TonWallet.signTransaction`).
+ */
+export declare class TonUnsignedTransaction extends UnsignedTransaction {
+    readonly walletAddress: string;
+    readonly messages: readonly TonOutMessage[];
+    readonly validUntil: number | undefined;
+    constructor(init: {
+        chainId: number;
+        walletAddress: string;
+        messages: readonly TonOutMessage[];
+        validUntil?: number;
+    });
+}
+/**
+ * A signed external wallet request (W5, v4r2 or v3r2): its BOC, its normalized hash (the
+ * transaction id), and — read from the signed body itself, so they survive a
+ * JSON round trip — the wallet, seqno and `validUntil` it commits to, which
+ * `TonChain.getRequestState` takes.
+ */
+export declare class TonSignedTransaction extends AbstractSignedTransaction {
+    #private;
+    static readonly JSON_TYPE = "TonSignedTransaction";
+    readonly boc: string;
+    /** Raw. */
+    readonly walletAddress: string;
+    readonly seqno: number;
+    readonly validUntil: number;
+    constructor(init: {
+        chainId: number;
+        boc: string;
+    });
+    get chainId(): number;
+    /** Normalized external-message hash, lowercase hex. */
+    get txHash(): string;
+    toJson(): JsonDict;
+    static fromJson(data: JsonTransactionInput): TonSignedTransaction;
+}
+/** A signed external wallet request (W5, v4r2 or v3r2) read back from its base64 BOC. */
+export declare function tonExternalRequestOf(boc: string): {
+    walletAddress: string;
+    hash: string;
+    seqno: number;
+    validUntil: number;
+};
+/** The normalized hash of an external message given as a base64 BOC; refuses anything else. */
+export declare function tonExternalBocHash(boc: string): string;
+//# sourceMappingURL=ton_transactions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ton_transactions.d.ts","sourceRoot":"","sources":["../../../ton/ton_transactions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,oBAAoB,EAK1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,KAAK,aAAa,EAAwF,MAAM,mBAAmB,CAAC;AAE7I;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,mBAAmB;IAC7D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAOtH;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,yBAAyB;;IACjE,MAAM,CAAC,QAAQ,CAAC,SAAS,0BAA0B;IAGnD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,WAAW;IACX,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAWlD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,uDAAuD;IACvD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,MAAM,IAAI,QAAQ;IAIlB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,oBAAoB;CASlE;AAID,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAQ5H;AAED,+FAA+F;AAC/F,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGtD"}

package/dist/esm/ton/ton_transactions.js

@@ -0,0 +1,100 @@
+import { Cell, loadMessage } from '@ton/core';
+import { ChainError, ChainErrorKinds } from "../errors.js";
+import { NetworkType } from "../network_type.js";
+import { AbstractSignedTransaction } from "../signed_transaction.js";
+import { JSON_TRANSACTION_CHAIN_ID_KEY, jsonPayloadItem, jsonTransactionEnvelope, parseJsonTransactionEnvelope, registerJsonTransactionType, } from "../transaction_json.js";
+import { UnsignedTransaction } from "../unsigned_transaction.js";
+import { tonRawAddress } from "./ton_address.js";
+import { tonNormalizedExternalHash, tonOutActions, tonW5RequestFields, tonWalletRequestFields } from "./ton_messages.js";
+/**
+ * A request a wallet will send itself: its messages, and optionally how long
+ * the signed request stays valid. The seqno and whether to deploy are read at
+ * signing time (`TonWallet.signTransaction`).
+ */
+export class TonUnsignedTransaction extends UnsignedTransaction {
+    walletAddress;
+    messages;
+    validUntil;
+    constructor(init) {
+        super(init.chainId, NetworkType.TON);
+        tonOutActions(init.messages);
+        this.walletAddress = tonRawAddress(init.walletAddress);
+        this.messages = init.messages;
+        this.validUntil = init.validUntil;
+    }
+}
+/**
+ * A signed external wallet request (W5, v4r2 or v3r2): its BOC, its normalized hash (the
+ * transaction id), and — read from the signed body itself, so they survive a
+ * JSON round trip — the wallet, seqno and `validUntil` it commits to, which
+ * `TonChain.getRequestState` takes.
+ */
+export class TonSignedTransaction extends AbstractSignedTransaction {
+    static JSON_TYPE = 'TonSignedTransaction';
+    #chainId;
+    boc;
+    #hash;
+    /** Raw. */
+    walletAddress;
+    seqno;
+    validUntil;
+    constructor(init) {
+        super();
+        const request = tonExternalRequestOf(init.boc);
+        this.#chainId = init.chainId;
+        this.boc = init.boc;
+        this.#hash = request.hash;
+        this.walletAddress = request.walletAddress;
+        this.seqno = request.seqno;
+        this.validUntil = request.validUntil;
+    }
+    get chainId() {
+        return this.#chainId;
+    }
+    /** Normalized external-message hash, lowercase hex. */
+    get txHash() {
+        return this.#hash;
+    }
+    toJson() {
+        return jsonTransactionEnvelope(TonSignedTransaction.JSON_TYPE, this.#chainId, { boc: this.boc });
+    }
+    static fromJson(data) {
+        const payload = parseJsonTransactionEnvelope(data, TonSignedTransaction.JSON_TYPE);
+        const chainId = jsonPayloadItem(payload, JSON_TRANSACTION_CHAIN_ID_KEY);
+        const boc = jsonPayloadItem(payload, 'boc');
+        if (!Number.isSafeInteger(chainId) || typeof boc !== 'string') {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, 'A TonSignedTransaction payload needs an integer chain_id and a boc string');
+        }
+        return new TonSignedTransaction({ chainId: chainId, boc });
+    }
+}
+registerJsonTransactionType(TonSignedTransaction);
+/** A signed external wallet request (W5, v4r2 or v3r2) read back from its base64 BOC. */
+export function tonExternalRequestOf(boc) {
+    const message = externalMessageOf(boc);
+    const fields = tonWalletRequestFields(message.body);
+    if (fields.layout === 'w5' && tonW5RequestFields(message.body).authType !== 'external') {
+        throw new ChainError(ChainErrorKinds.TransactionDecodeFailed, 'Not a signed W5 external request: it is an internal one');
+    }
+    const walletAddress = message.info.dest.toRawString();
+    return { walletAddress, hash: tonNormalizedExternalHash(walletAddress, message.body), seqno: fields.seqno, validUntil: fields.validUntil };
+}
+/** The normalized hash of an external message given as a base64 BOC; refuses anything else. */
+export function tonExternalBocHash(boc) {
+    const message = externalMessageOf(boc);
+    return tonNormalizedExternalHash(message.info.dest.toRawString(), message.body);
+}
+function externalMessageOf(boc) {
+    let message;
+    try {
+        message = loadMessage(Cell.fromBase64(boc).beginParse());
+    }
+    catch (err) {
+        throw new ChainError(ChainErrorKinds.TransactionDecodeFailed, 'Not a TON message BOC', undefined, err);
+    }
+    if (message.info.type !== 'external-in') {
+        throw new ChainError(ChainErrorKinds.InvalidArgument, `Expected an external-in message, got ${message.info.type}`);
+    }
+    return message;
+}
+//# sourceMappingURL=ton_transactions.js.map

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

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