@getomnichain/omnichain 0.6.2 → 0.7.0

package/dist/cjs/ton/ton_transaction_status.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TonTransactionStatus = void 0;
+exports.summarizeTonTrace = summarizeTonTrace;
+const transaction_status_ts_1 = require("../transaction_status.js");
+const ton_asset_ts_1 = require("./ton_asset.js");
+const ton_messages_ts_1 = require("./ton_messages.js");
+const ton_provider_ts_1 = require("./ton_provider.js");
+function summarizeTonTrace(chainId, trace) {
+    (0, ton_provider_ts_1.assertTraceConsistent)('the trace given', trace);
+    const native = new ton_asset_ts_1.TonAsset(chainId, 'TON', null, ton_asset_ts_1.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([[(0, transaction_status_ts_1.assetHashOf)(native), { token: native, change: transaction_status_ts_1.AssetBalanceChange.fromMr(delta, ton_asset_ts_1.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_messages_ts_1.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_messages_ts_1.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_messages_ts_1.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_messages_ts_1.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.
+ */
+class TonTransactionStatus extends transaction_status_ts_1.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: transaction_status_ts_1.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: transaction_status_ts_1.TransactionStatusTypes.Success, balanceChanges: summary.balanceChanges });
+        }
+        const error = { ...summary.problem };
+        return new TonTransactionStatus({ ...common, status: transaction_status_ts_1.TransactionStatusTypes.Failed, error });
+    }
+}
+exports.TonTransactionStatus = TonTransactionStatus;
+//# sourceMappingURL=ton_transaction_status.js.map

package/dist/cjs/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/cjs/ton/ton_transactions.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TonSignedTransaction = exports.TonUnsignedTransaction = void 0;
+exports.tonExternalRequestOf = tonExternalRequestOf;
+exports.tonExternalBocHash = tonExternalBocHash;
+const core_1 = require("@ton/core");
+const errors_ts_1 = require("../errors.js");
+const network_type_ts_1 = require("../network_type.js");
+const signed_transaction_ts_1 = require("../signed_transaction.js");
+const transaction_json_ts_1 = require("../transaction_json.js");
+const unsigned_transaction_ts_1 = require("../unsigned_transaction.js");
+const ton_address_ts_1 = require("./ton_address.js");
+const ton_messages_ts_1 = require("./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`).
+ */
+class TonUnsignedTransaction extends unsigned_transaction_ts_1.UnsignedTransaction {
+    walletAddress;
+    messages;
+    validUntil;
+    constructor(init) {
+        super(init.chainId, network_type_ts_1.NetworkType.TON);
+        (0, ton_messages_ts_1.tonOutActions)(init.messages);
+        this.walletAddress = (0, ton_address_ts_1.tonRawAddress)(init.walletAddress);
+        this.messages = init.messages;
+        this.validUntil = init.validUntil;
+    }
+}
+exports.TonUnsignedTransaction = TonUnsignedTransaction;
+/**
+ * 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.
+ */
+class TonSignedTransaction extends signed_transaction_ts_1.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 (0, transaction_json_ts_1.jsonTransactionEnvelope)(TonSignedTransaction.JSON_TYPE, this.#chainId, { boc: this.boc });
+    }
+    static fromJson(data) {
+        const payload = (0, transaction_json_ts_1.parseJsonTransactionEnvelope)(data, TonSignedTransaction.JSON_TYPE);
+        const chainId = (0, transaction_json_ts_1.jsonPayloadItem)(payload, transaction_json_ts_1.JSON_TRANSACTION_CHAIN_ID_KEY);
+        const boc = (0, transaction_json_ts_1.jsonPayloadItem)(payload, 'boc');
+        if (!Number.isSafeInteger(chainId) || typeof boc !== 'string') {
+            throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, 'A TonSignedTransaction payload needs an integer chain_id and a boc string');
+        }
+        return new TonSignedTransaction({ chainId: chainId, boc });
+    }
+}
+exports.TonSignedTransaction = TonSignedTransaction;
+(0, transaction_json_ts_1.registerJsonTransactionType)(TonSignedTransaction);
+/** A signed external wallet request (W5, v4r2 or v3r2) read back from its base64 BOC. */
+function tonExternalRequestOf(boc) {
+    const message = externalMessageOf(boc);
+    const fields = (0, ton_messages_ts_1.tonWalletRequestFields)(message.body);
+    if (fields.layout === 'w5' && (0, ton_messages_ts_1.tonW5RequestFields)(message.body).authType !== 'external') {
+        throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.TransactionDecodeFailed, 'Not a signed W5 external request: it is an internal one');
+    }
+    const walletAddress = message.info.dest.toRawString();
+    return { walletAddress, hash: (0, ton_messages_ts_1.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. */
+function tonExternalBocHash(boc) {
+    const message = externalMessageOf(boc);
+    return (0, ton_messages_ts_1.tonNormalizedExternalHash)(message.info.dest.toRawString(), message.body);
+}
+function externalMessageOf(boc) {
+    let message;
+    try {
+        message = (0, core_1.loadMessage)(core_1.Cell.fromBase64(boc).beginParse());
+    }
+    catch (err) {
+        throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.TransactionDecodeFailed, 'Not a TON message BOC', undefined, err);
+    }
+    if (message.info.type !== 'external-in') {
+        throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `Expected an external-in message, got ${message.info.type}`);
+    }
+    return message;
+}
+//# sourceMappingURL=ton_transactions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ton_transactions.js","sourceRoot":"","sources":["../../../ton/ton_transactions.ts"],"names":[],"mappings":";;;AA4FA,oDAQC;AAGD,gDAGC;AA1GD,oCAA8F;AAE9F,4CAA2D;AAC3D,wDAAiD;AACjD,oEAAqE;AACrE,gEAQgC;AAChC,wEAAiE;AACjE,qDAAiD;AACjD,uDAA6I;AAE7I;;;;GAIG;AACH,MAAa,sBAAuB,SAAQ,6CAAmB;IACpD,aAAa,CAAS;IACtB,QAAQ,CAA2B;IACnC,UAAU,CAAqB;IAExC,YAAY,IAAyG;QACnH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,6BAAW,CAAC,GAAG,CAAC,CAAC;QACrC,IAAA,+BAAa,EAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,IAAA,8BAAa,EAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACpC,CAAC;CACF;AAZD,wDAYC;AAED;;;;;GAKG;AACH,MAAa,oBAAqB,SAAQ,iDAAyB;IACjE,MAAM,CAAU,SAAS,GAAG,sBAAsB,CAAC;IAE1C,QAAQ,CAAS;IACjB,GAAG,CAAS;IACZ,KAAK,CAAS;IACvB,WAAW;IACF,aAAa,CAAS;IACtB,KAAK,CAAS;IACd,UAAU,CAAS;IAE5B,YAAY,IAAsC;QAChD,KAAK,EAAE,CAAC;QACR,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,uDAAuD;IACvD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,MAAM;QACJ,OAAO,IAAA,6CAAuB,EAAC,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACnG,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAA0B;QACxC,MAAM,OAAO,GAAG,IAAA,kDAA4B,EAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;QACnF,MAAM,OAAO,GAAG,IAAA,qCAAe,EAAC,OAAO,EAAE,mDAA6B,CAAC,CAAC;QACxE,MAAM,GAAG,GAAG,IAAA,qCAAe,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC9D,MAAM,IAAI,sBAAU,CAAC,2BAAe,CAAC,eAAe,EAAE,2EAA2E,CAAC,CAAC;QACrI,CAAC;QACD,OAAO,IAAI,oBAAoB,CAAC,EAAE,OAAO,EAAE,OAAiB,EAAE,GAAG,EAAE,CAAC,CAAC;IACvE,CAAC;;AA3CH,oDA4CC;AAED,IAAA,iDAA2B,EAAC,oBAAoB,CAAC,CAAC;AAElD,yFAAyF;AACzF,SAAgB,oBAAoB,CAAC,GAAW;IAC9C,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAA,wCAAsB,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,IAAA,oCAAkB,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QACvF,MAAM,IAAI,sBAAU,CAAC,2BAAe,CAAC,uBAAuB,EAAE,yDAAyD,CAAC,CAAC;IAC3H,CAAC;IACD,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACtD,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,IAAA,2CAAyB,EAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;AAC7I,CAAC;AAED,+FAA+F;AAC/F,SAAgB,kBAAkB,CAAC,GAAW;IAC5C,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,IAAA,2CAAyB,EAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW;IACpC,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,IAAA,kBAAW,EAAC,WAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,sBAAU,CAAC,2BAAe,CAAC,uBAAuB,EAAE,uBAAuB,EAAE,SAAS,EAAE,GAAY,CAAC,CAAC;IAClH,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACxC,MAAM,IAAI,sBAAU,CAAC,2BAAe,CAAC,eAAe,EAAE,wCAAwC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACrH,CAAC;IACD,OAAO,OAA0D,CAAC;AACpE,CAAC"}

package/dist/cjs/ton/ton_wallet.js

@@ -0,0 +1,285 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TonWallet = exports.TON_PYTHON_MARKER_PATH = exports.TON_LEGACY_MAX_MESSAGES = exports.TON_LEGACY_DEFAULT_WALLET_ID = exports.TON_WALLET_VERSIONS = exports.TON_DEFAULT_REQUEST_TTL_SECONDS = void 0;
+exports.deriveSlip10Ed25519Seed = deriveSlip10Ed25519Seed;
+exports.deriveTonEd25519Seed = deriveTonEd25519Seed;
+exports.deriveTonNativeSeed = deriveTonNativeSeed;
+const node_crypto_1 = require("node:crypto");
+const core_1 = require("@ton/core");
+const crypto_1 = require("@ton/crypto");
+const ton_1 = require("@ton/ton");
+const bip39_ts_1 = require("../bip39.js");
+const chain_type_ts_1 = require("../chain_type.js");
+const errors_ts_1 = require("../errors.js");
+const wallet_base_ts_1 = require("../wallet.base.js");
+const ton_address_ts_1 = require("./ton_address.js");
+const ton_chain_ts_1 = require("./ton_chain.js");
+const ton_messages_ts_1 = require("./ton_messages.js");
+const ton_transactions_ts_1 = require("./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. */
+exports.TON_DEFAULT_REQUEST_TTL_SECONDS = 60;
+/** SLIP-0010 ed25519 derivation along hardened `path` segments (e.g. `[44, 607, 0]`) from a BIP-39 seed. */
+function deriveSlip10Ed25519Seed(bip39Seed, path) {
+    let digest = (0, node_crypto_1.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 errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `Invalid SLIP-0010 path segment ${segment}`);
+        }
+        const indexBytes = Buffer.alloc(4);
+        indexBytes.writeUInt32BE(FIRST_HARDENED_INDEX + segment);
+        digest = (0, node_crypto_1.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}'`. */
+function deriveTonEd25519Seed(bip39Seed, index) {
+    return deriveSlip10Ed25519Seed(bip39Seed, [44, TON_COIN_TYPE, index]);
+}
+exports.TON_WALLET_VERSIONS = ['v3r2', 'v4r2', 'v5r1'];
+/** The v3r2 / v4r2 wallet id the Python SDK uses on both workchains. */
+exports.TON_LEGACY_DEFAULT_WALLET_ID = 698983191;
+/** v3r2 / v4r2 send at most four messages per request. */
+exports.TON_LEGACY_MAX_MESSAGES = 4;
+/** The path the Python SDK accepts as a marker for TON's own scheme; it derives nothing. */
+exports.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.
+ */
+function deriveTonNativeSeed(mnemonicStr) {
+    const words = mnemonicStr.trim().toLowerCase().split(/\s+/).filter((word) => word.length > 0);
+    if (words.length === 0)
+        throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, 'The mnemonic is empty');
+    const entropy = (0, node_crypto_1.createHmac)('sha512', words.join(' ')).update('').digest();
+    return (0, node_crypto_1.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`).
+ */
+class TonWallet extends wallet_base_ts_1.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 errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `A TON ed25519 seed is 32 bytes, got ${ed25519Seed.length}`);
+        }
+        const version = opts.version ?? 'v5r1';
+        if (!exports.TON_WALLET_VERSIONS.includes(version)) {
+            throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `TON wallet version must be one of ${exports.TON_WALLET_VERSIONS.join(', ')}, got ${String(version)}`);
+        }
+        const workchain = opts.workchain ?? 0;
+        if (workchain !== 0 && workchain !== -1) {
+            throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `A TON wallet lives on workchain 0 or -1, got ${String(workchain)}`);
+        }
+        const keyPair = (0, crypto_1.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'
+                ? ton_1.WalletContractV5R1.create({ workchain, publicKey })
+                : version === 'v4r2'
+                    ? ton_1.WalletContractV4.create({ workchain, publicKey, walletId: exports.TON_LEGACY_DEFAULT_WALLET_ID })
+                    : ton_1.WalletContractV3R2.create({ workchain, publicKey, walletId: exports.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 chain_type_ts_1.ChainType.TON;
+    }
+    static walletFamily() {
+        return chain_type_ts_1.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 === exports.TON_PYTHON_MARKER_PATH) {
+            if (opts.passphrase !== undefined && opts.passphrase !== '') {
+                throw new errors_ts_1.ChainError(errors_ts_1.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((0, bip39_ts_1.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 ton_address_ts_1.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 ton_1.WalletContractV5R1
+            ? this.contract.createRequest({
+                seqno: args.seqno,
+                timeout: validUntil,
+                secretKey: this.#secretKey,
+                authType: 'external',
+                actions: (0, ton_messages_ts_1.tonOutActions)(args.messages),
+            })
+            : this.legacyExternalBody(args.seqno, validUntil, args.messages);
+        const message = (0, core_1.external)({ to: this.contract.address, init: args.deploy === true ? this.stateInit : undefined, body });
+        return {
+            boc: (0, core_1.beginCell)().store((0, core_1.storeMessage)(message)).endCell().toBoc().toString('base64'),
+            hash: (0, ton_messages_ts_1.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 ton_1.WalletContractV5R1)) {
+            throw new errors_ts_1.ChainError(errors_ts_1.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: (0, ton_messages_ts_1.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 > exports.TON_LEGACY_MAX_MESSAGES) {
+            throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `A ${this.version} request carries at most ${exports.TON_LEGACY_MAX_MESSAGES} messages, got ${messages.length}`);
+        }
+        const signing = (0, core_1.beginCell)()
+            .storeUint(this.contract.walletId, 32)
+            .storeUint(validUntil, 32)
+            .storeUint(seqno, 32);
+        if (this.version === 'v4r2')
+            signing.storeUint(0, 8);
+        for (const action of (0, ton_messages_ts_1.tonOutActions)(messages)) {
+            signing.storeUint(action.mode | core_1.SendMode.IGNORE_ERRORS, 8).storeRef((0, core_1.beginCell)().store((0, core_1.storeMessageRelaxed)(action.outMsg)).endCell());
+        }
+        const signature = (0, crypto_1.sign)(signing.endCell().hash(), this.#secretKey);
+        return (0, core_1.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 ton_transactions_ts_1.TonUnsignedTransaction)) {
+            throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `Expected a TonUnsignedTransaction, got ${transaction.constructor.name}`);
+        }
+        if (new ton_address_ts_1.TonAddress(transaction.walletAddress).canonical() !== this._address) {
+            throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `Transaction is for ${transaction.walletAddress}, not this wallet ${this._address}`);
+        }
+        const tonChain = assertTonChain(chain);
+        if (tonChain.chainId !== transaction.chainId) {
+            throw new errors_ts_1.ChainError(errors_ts_1.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 ton_transactions_ts_1.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 ton_messages_ts_1.TonSignedMessage((0, crypto_1.sign)((0, ton_messages_ts_1.tonMessageHash)(message), this.#secretKey).toString('hex'));
+    }
+    verifySignature(message, signedMessage) {
+        return ton_chain_ts_1.TonChain.verifySignature(this.publicKey, message, signedMessage);
+    }
+    async handleTransactionPrerequisite(prerequisite) {
+        throw new errors_ts_1.ChainError(errors_ts_1.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 errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `Invalid TON derivation path ${derivationPath}; expected m/44'/607'/<account>' (hardened, SLIP-0010)`);
+        }
+        return Number(match[1]);
+    }
+}
+exports.TonWallet = TonWallet;
+function assertTonChain(chain) {
+    if (!(chain instanceof ton_chain_ts_1.TonChain)) {
+        throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `Expected a TonChain, got ${chain.constructor.name}`);
+    }
+    return chain;
+}
+function defaultValidUntil() {
+    return Math.floor(Date.now() / 1000) + exports.TON_DEFAULT_REQUEST_TTL_SECONDS;
+}
+//# sourceMappingURL=ton_wallet.js.map