@ton-community/ton-ledger 7.4.0-pre.0 → 7.4.0-pre.2

package/dist/TonTransport.d.ts

@@ -121,6 +121,29 @@ export type SignDataRequest = {
     data: Cell;
     ext?: Cell;
 };
+export type SignDataNewRequestCommon = {
+    domain: string;
+};
+export type SignDataNewRequestPartial = {
+    type: 'plaintext';
+    text: string;
+} | {
+    type: 'binary';
+    data: Buffer;
+} | {
+    type: 'app-data';
+    schemaCrc: number;
+    data: Cell;
+};
+export type SignDataNewRequest = SignDataNewRequestCommon & SignDataNewRequestPartial;
+export type LedgerMessage = {
+    to: Address;
+    sendMode: SendMode;
+    bounce: boolean;
+    amount: bigint;
+    stateInit?: StateInit;
+    payload?: TonPayloadFormat;
+};
 export declare class TonTransport {
     #private;
     readonly transport: Transport;
@@ -168,6 +191,28 @@ export declare class TonTransport {
         cell: Cell;
         timestamp: number;
     }>;
+    signDataNew(path: number[], req: SignDataNewRequest, opts?: {
+        timestamp?: number;
+        testOnly?: boolean;
+        chain?: number;
+        subwalletId?: number;
+        walletVersion?: 'v3r2' | 'v4';
+    }): Promise<{
+        signature: Buffer;
+        address: Address;
+        signedData: Buffer | Cell;
+        signedDataHash: Buffer;
+        timestamp: number;
+    }>;
+    signMultiTransaction: (path: number[], transaction: {
+        seqno: number;
+        timeout: number;
+        walletSpecifiers?: {
+            subwalletId?: number;
+            includeWalletOp: boolean;
+            expectedPublicKey?: Buffer;
+        };
+    }, messages: LedgerMessage[]) => Promise<Cell>;
     signTransaction: (path: number[], transaction: {
         to: Address;
         sendMode: SendMode;
@@ -180,6 +225,7 @@ export declare class TonTransport {
         walletSpecifiers?: {
             subwalletId?: number;
             includeWalletOp: boolean;
+            expectedPublicKey?: Buffer;
         };
         extraCurrency?: {
             index: number;
@@ -190,4 +236,5 @@ export declare class TonTransport {
         blindSigningEnabled: boolean;
         expertMode: boolean;
     }>;
+    launchApp(): Promise<void>;
 }

package/dist/TonTransport.js

@@ -1068,6 +1068,286 @@ class TonTransport {
             timestamp,
         };
     }
+    async signDataNew(path, req, opts) {
+        validatePath(path);
+        const { publicKey, address: addressString } = (await this.getAddress(path, opts));
+        const expectedAddress = core_1.Address.parse(addressString);
+        const { flags, specifiers, chain } = processAddressFlags(opts);
+        let specifiersBuf = Buffer.alloc(0);
+        if (specifiers !== undefined) {
+            specifiersBuf = Buffer.concat([(0, ledgerWriter_1.writeUint8)(specifiers.isV3R2 ? 1 : 0), (0, ledgerWriter_1.writeUint32)(specifiers.subwalletId)]);
+        }
+        const timestamp = opts?.timestamp ?? Math.floor(Date.now() / 1000);
+        const domainBuf = Buffer.from(req.domain, 'ascii');
+        let typeId;
+        let payload;
+        let signedData;
+        switch (req.type) {
+            case 'plaintext': {
+                typeId = 0;
+                payload = Buffer.from(req.text, 'ascii');
+                signedData = Buffer.concat([
+                    Buffer.from([0xff, 0xff]),
+                    Buffer.from('ton-connect/sign-data/'),
+                    (0, ledgerWriter_1.writeInt32BE)(chain),
+                    expectedAddress.hash,
+                    (0, ledgerWriter_1.writeUint32)(domainBuf.length),
+                    domainBuf,
+                    (0, ledgerWriter_1.writeUint64)(BigInt(timestamp)),
+                    Buffer.from('txt', 'ascii'),
+                    (0, ledgerWriter_1.writeUint32)(payload.length),
+                    payload,
+                ]);
+                break;
+            }
+            case 'binary': {
+                typeId = 1;
+                payload = req.data;
+                signedData = Buffer.concat([
+                    Buffer.from([0xff, 0xff]),
+                    Buffer.from('ton-connect/sign-data/'),
+                    (0, ledgerWriter_1.writeInt32BE)(chain),
+                    expectedAddress.hash,
+                    (0, ledgerWriter_1.writeUint32)(domainBuf.length),
+                    domainBuf,
+                    (0, ledgerWriter_1.writeUint64)(BigInt(timestamp)),
+                    Buffer.from('bin', 'ascii'),
+                    (0, ledgerWriter_1.writeUint32)(payload.length),
+                    payload,
+                ]);
+                break;
+            }
+            case 'app-data': {
+                typeId = 2;
+                payload = Buffer.concat([
+                    (0, ledgerWriter_1.writeUint32)(req.schemaCrc),
+                    (0, ledgerWriter_1.writeCellRef)(req.data),
+                ]);
+                let inner = (0, core_1.beginCell)();
+                req.domain.split('.').reverse().forEach(p => {
+                    inner.storeBuffer(Buffer.from(p, 'ascii'));
+                    inner.storeUint(0, 8);
+                });
+                signedData = (0, core_1.beginCell)()
+                    .storeUint(0x75569022, 32) // prefix
+                    .storeUint(req.schemaCrc, 32) // schema hash
+                    .storeUint(timestamp, 64) // timestamp
+                    .storeAddress(expectedAddress) // user wallet address
+                    .storeRef(inner) // domain
+                    .storeRef(req.data) // payload cell
+                    .endCell();
+                break;
+            }
+            default: {
+                throw new Error(`Sign data request type '${req.type}' not supported`);
+            }
+        }
+        const pkg = Buffer.concat([
+            (0, ledgerWriter_1.writeUint8)(typeId),
+            (0, ledgerWriter_1.writeUint8)(flags),
+            specifiersBuf,
+            (0, ledgerWriter_1.writeUint8)(domainBuf.length),
+            domainBuf,
+            (0, ledgerWriter_1.writeUint64)(BigInt(timestamp)),
+            payload,
+        ]);
+        await this.#doRequest(INS_SIGN_DATA, 0x01, 0x03, pathElementsToBuffer(path.map((v) => v + 0x80000000)));
+        const pkgCs = chunks(pkg, 255);
+        for (let i = 0; i < pkgCs.length - 1; i++) {
+            await this.#doRequest(INS_SIGN_DATA, 0x01, 0x02, pkgCs[i]);
+        }
+        const res = await this.#doRequest(INS_SIGN_DATA, 0x01, 0x00, pkgCs[pkgCs.length - 1]);
+        let signature = res.subarray(1, 1 + 64);
+        let hash = res.subarray(2 + 64, 2 + 64 + 32);
+        const signedDataHash = signedData instanceof core_1.Cell ? signedData.hash() : (0, crypto_1.sha256_sync)(signedData);
+        if (!hash.equals(signedDataHash)) {
+            throw Error('Hash mismatch. Expected: ' + signedDataHash.toString('hex') + ', got: ' + hash.toString('hex'));
+        }
+        if (!(0, crypto_1.signVerify)(signedDataHash, signature, publicKey)) {
+            throw Error('Received signature is invalid');
+        }
+        return {
+            signature,
+            address: expectedAddress,
+            signedData,
+            signedDataHash,
+            timestamp,
+        };
+    }
+    signMultiTransaction = async (path, transaction, messages) => {
+        // Check path
+        validatePath(path);
+        //
+        // Fetch key
+        //
+        let publicKey = (await this.getAddress(path)).publicKey;
+        if (transaction.walletSpecifiers?.expectedPublicKey !== undefined && !transaction.walletSpecifiers.expectedPublicKey.equals(publicKey)) {
+            throw Error('Expected public key mismatch');
+        }
+        //
+        // Create package
+        //
+        const includeWalletOp = transaction.walletSpecifiers?.includeWalletOp ?? true;
+        const subwalletId = transaction.walletSpecifiers?.subwalletId ?? DEFAULT_SUBWALLET_ID;
+        const useTag1 = transaction.walletSpecifiers !== undefined;
+        let pkg = Buffer.concat([
+            (0, ledgerWriter_1.writeUint8)(messages.length),
+            (0, ledgerWriter_1.writeUint8)(useTag1 ? 1 : 0), // tag
+        ]);
+        if (useTag1) {
+            let flags = 0;
+            if (includeWalletOp) {
+                flags |= 1;
+            }
+            if (transaction.walletSpecifiers?.expectedPublicKey !== undefined) {
+                flags |= 4;
+            }
+            pkg = Buffer.concat([
+                pkg,
+                (0, ledgerWriter_1.writeUint32)(subwalletId),
+                (0, ledgerWriter_1.writeUint8)(flags),
+                transaction.walletSpecifiers?.expectedPublicKey ?? Buffer.alloc(0),
+            ]);
+        }
+        pkg = Buffer.concat([
+            pkg,
+            (0, ledgerWriter_1.writeUint32)(transaction.seqno),
+            (0, ledgerWriter_1.writeUint32)(transaction.timeout),
+        ]);
+        let messagePkgs = [];
+        let messageCells = [];
+        for (const message of messages) {
+            let pkg = Buffer.concat([
+                (0, ledgerWriter_1.writeVarUInt)(message.amount),
+                (0, ledgerWriter_1.writeAddress)(message.to),
+                (0, ledgerWriter_1.writeUint8)(message.bounce ? 1 : 0),
+                (0, ledgerWriter_1.writeUint8)(message.sendMode),
+            ]);
+            let stateInit = null;
+            if (message.stateInit) {
+                stateInit = (0, core_1.beginCell)()
+                    .store((0, core_1.storeStateInit)(message.stateInit))
+                    .endCell();
+                pkg = Buffer.concat([
+                    pkg,
+                    (0, ledgerWriter_1.writeUint8)(1),
+                    (0, ledgerWriter_1.writeUint16)(stateInit.depth()),
+                    stateInit.hash()
+                ]);
+            }
+            else {
+                pkg = Buffer.concat([
+                    pkg,
+                    (0, ledgerWriter_1.writeUint8)(0)
+                ]);
+            }
+            const { payload, hints } = convertPayload(message.payload);
+            if (payload) {
+                pkg = Buffer.concat([
+                    pkg,
+                    (0, ledgerWriter_1.writeUint8)(1),
+                    (0, ledgerWriter_1.writeUint16)(payload.depth()),
+                    payload.hash(),
+                    hints
+                ]);
+            }
+            else {
+                pkg = Buffer.concat([
+                    pkg,
+                    (0, ledgerWriter_1.writeUint8)(0),
+                    (0, ledgerWriter_1.writeUint8)(0)
+                ]);
+            }
+            let orderBuilder = (0, core_1.beginCell)()
+                .storeBit(0)
+                .storeBit(true)
+                .storeBit(message.bounce)
+                .storeBit(false)
+                .storeAddress(null)
+                .storeAddress(message.to)
+                .storeCoins(message.amount)
+                .storeBit(false)
+                .storeCoins(0)
+                .storeCoins(0)
+                .storeUint(0, 64)
+                .storeUint(0, 32);
+            if (stateInit) {
+                orderBuilder = orderBuilder
+                    .storeBit(true)
+                    .storeBit(true) // Always in reference
+                    .storeRef(stateInit);
+            }
+            else {
+                orderBuilder = orderBuilder
+                    .storeBit(false);
+            }
+            if (payload) {
+                orderBuilder = orderBuilder
+                    .storeBit(true) // Always in reference
+                    .storeRef(payload);
+            }
+            else {
+                orderBuilder = orderBuilder
+                    .storeBit(false);
+            }
+            messagePkgs.push(pkg);
+            messageCells.push(orderBuilder.endCell());
+        }
+        await this.#doRequest(INS_SIGN_TX, 0x04, 0x03, pathElementsToBuffer(path.map((v) => v + 0x80000000)));
+        const pkgCs = chunks(pkg, 255);
+        for (let i = 0; i < pkgCs.length; i++) {
+            await this.#doRequest(INS_SIGN_TX, 0x04, 0x02, pkgCs[i]);
+        }
+        let res = null;
+        for (let i = 0; i < messagePkgs.length; i++) {
+            const pkgCs = chunks(messagePkgs[i], 255);
+            for (let j = 0; j < pkgCs.length; j++) {
+                let flags = 4;
+                if (j === 0) {
+                    flags |= 1;
+                }
+                if (j < pkgCs.length - 1) {
+                    flags |= 2;
+                }
+                if (i === messagePkgs.length - 1 && j === pkgCs.length - 1) {
+                    res = await this.#doRequest(INS_SIGN_TX, flags, 0, pkgCs[j]);
+                }
+                else {
+                    await this.#doRequest(INS_SIGN_TX, flags, 2, pkgCs[j]);
+                }
+            }
+        }
+        if (res === null) {
+            throw Error('No response received');
+        }
+        // Transfer message
+        let transferB = (0, core_1.beginCell)()
+            .storeUint(subwalletId, 32)
+            .storeUint(transaction.timeout, 32)
+            .storeUint(transaction.seqno, 32);
+        if (includeWalletOp) {
+            transferB = transferB.storeUint(0, 8);
+        }
+        for (let i = 0; i < messages.length; i++) {
+            transferB = transferB.storeUint(messages[i].sendMode, 8)
+                .storeRef(messageCells[i]);
+        }
+        let transfer = transferB.endCell();
+        // Parse result
+        let signature = res.slice(1, 1 + 64);
+        let hash = res.slice(2 + 64, 2 + 64 + 32);
+        if (!hash.equals(transfer.hash())) {
+            throw Error('Hash mismatch. Expected: ' + transfer.hash().toString('hex') + ', got: ' + hash.toString('hex'));
+        }
+        if (!(0, crypto_1.signVerify)(hash, signature, publicKey)) {
+            throw Error('Received signature is invalid');
+        }
+        // Build a message
+        return (0, core_1.beginCell)()
+            .storeBuffer(signature)
+            .storeSlice(transfer.beginParse())
+            .endCell();
+    };
     signTransaction = async (path, transaction) => {
         // Check path
         validatePath(path);
@@ -1078,6 +1358,9 @@ class TonTransport {
         // Fetch key
         //
         let publicKey = (await this.getAddress(path)).publicKey;
+        if (transaction.walletSpecifiers?.expectedPublicKey !== undefined && !transaction.walletSpecifiers.expectedPublicKey.equals(publicKey)) {
+            throw Error('Expected public key mismatch');
+        }
         //
         // Create package
         //
@@ -1095,10 +1378,14 @@ class TonTransport {
             if (transaction.extraCurrency !== undefined) {
                 flags |= 2;
             }
+            if (transaction.walletSpecifiers?.expectedPublicKey !== undefined) {
+                flags |= 4;
+            }
             pkg = Buffer.concat([
                 pkg,
                 (0, ledgerWriter_1.writeUint32)(subwalletId),
                 (0, ledgerWriter_1.writeUint8)(flags),
+                transaction.walletSpecifiers?.expectedPublicKey ?? Buffer.alloc(0),
             ]);
         }
         let ecBuf = Buffer.alloc(0);
@@ -1250,6 +1537,9 @@ class TonTransport {
             expertMode: (loaded[0] & 0x02) > 0,
         };
     }
+    async launchApp() {
+        await this.#doRequest(0xd8, 0x00, 0x00, Buffer.from('TON', 'ascii'));
+    }
     #doRequest = async (ins, p1, p2, data) => {
         return this.#lock.inLock(async () => {
             let r = await this.transport.send(LEDGER_CLA, ins, p1, p2, data);

package/dist/utils/ledgerWriter.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="node" />
 /// <reference types="node" />
 import { Address, Cell } from '@ton/core';
+export declare function writeInt32BE(value: number): Buffer;
 export declare function writeUint32(value: number): Buffer;
 export declare function writeUint16(value: number): Buffer;
 export declare function writeUint48(value: number): Buffer;

package/dist/utils/ledgerWriter.js

@@ -1,7 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.writeCellInline = exports.writeCellRef = exports.writeAddress = exports.writeUint8 = exports.writeVarUInt = exports.writeUint64 = exports.writeUint48 = exports.writeUint16 = exports.writeUint32 = void 0;
+exports.writeCellInline = exports.writeCellRef = exports.writeAddress = exports.writeUint8 = exports.writeVarUInt = exports.writeUint64 = exports.writeUint48 = exports.writeUint16 = exports.writeUint32 = exports.writeInt32BE = void 0;
 const core_1 = require("@ton/core");
+function writeInt32BE(value) {
+    let b = Buffer.alloc(4);
+    b.writeInt32BE(value, 0);
+    return b;
+}
+exports.writeInt32BE = writeInt32BE;
 function writeUint32(value) {
     let b = Buffer.alloc(4);
     b.writeUint32BE(value, 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ton-community/ton-ledger",
-  "version": "7.4.0-pre.0",
+  "version": "7.4.0-pre.2",
   "repository": "https://github.com/ton-community/ton-ledger-ts",
   "author": "Steve Korshakov <steve@korshakov.com>",
   "license": "MIT",

package/CHANGELOG.md

@@ -1,88 +0,0 @@
-# Changelog
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [7.3.0] - 2025-08-21
-
-- New jettons
-- Fixed `includeWalletOp`
-
-## [7.2.0] - 2025-02-07
-
-- Added support for TON Ledger App 2.2.0 features, including:
-- Hardcoded jettons
-- Wallet specifiers support in more methods
-
-## [7.1.0] - Not released
-
-### Added
-
-- Added `parseMessage` helper to parse messages into TON Ledger App format
-- Added support for TON Ledger App 2.1.0 features, including:
-- New message types
-- Wallet specifiers (subwallet ID and wallet op inclusion for v4 support)
-- `getSettings` method
-
-## [7.0.1] - 2024-01-17
-
-### Fixed
-
-- Fixed incorrect VarUInt encoding of 0 (0 nanoTON, 0 jetton units, etc)
-
-## [7.0.0] - 2023-09-15
-
-### Changed
-
-- Switched `ton-core` and `ton-crypto` to `@ton/core` and `@ton/crypto`
-
-## [6.0.0] - 2023-07-11
-
-### Removed
-
-- Removed `unsafe` payload format
-
-## [5.0.0] - 2023-06-29
-
-### Removed
-
-- Removed `decimals` and `ticker` from `jetton-transfer` request
-
-## [4.1.0] - 2023-06-16
-
-### Added
-
-- Added `signData` method along with `SignDataRequest` type
-
-## [4.0.1] - 2023-06-16
-
-### Fixed
-
-- Fixed the address flags communication
-
-## [4.0.0] - 2023-06-09
-
-### Added
-
-- Added payload types for NFT and Jetton transfers
-- Added TON Connect 2.0 address proof request
-
-### Removed
-
-- Removed old payload types except for comment and unsafe
-
-### Changed
-
-- Updated dependencies
-- Changed APDU format to be the same as the latest embedded app version (breaking change)
-
-## [3.0.0] - 2023-01-08
-
-### Changed
-
-- Migration to `ton-core`
-
-## [2.3.2]
-
-- Update documentation