WalletAccountTon

Defined in: wallet-ton/src/account.ts:34

Signing TON account on Wallet V5R1. It never holds a key: the V5R1 body is signed by signer.sign(signingCell.hash(), {scheme: 'ed25519', context: 'ton-external'}) — a LocalSigner for seed wallets, anything else (hardware, MPC, backend) through externalSigner().

Every send runs: hard checks → fresh seqno → preflight on the zero-signed body (estimateFee, emulation when configured, fee cap) → sign → broadcast. The preflight body carries a zero signature, so the signer is only asked once the transaction has passed.

Extends

WalletAccountReadOnlyTon

Implements

IWalletAccount

Constructors

Constructor

new WalletAccountTon(signer, publicKey, path, config?): WalletAccountTon

Defined in: wallet-ton/src/account.ts:50

publicKey is the signer’s 32-byte ed25519 key; the V5R1 address derives from it synchronously.

Parameters

signer

Signer

publicKey

Uint8Array

path

string

config?

TonConfig = {}

Returns

WalletAccountTon

Overrides

WalletAccountReadOnlyTon.constructor

Properties

_address

protected readonly _address: Address

Defined in: wallet-ton/src/read-only-account.ts:42

Inherited from

WalletAccountReadOnlyTon._address

_config

protected readonly _config: TonConfig

Defined in: wallet-ton/src/read-only-account.ts:39

Inherited from

WalletAccountReadOnlyTon._config

_init

protected readonly _init: StateInit

Defined in: wallet-ton/src/read-only-account.ts:41

Inherited from

WalletAccountReadOnlyTon._init

_rpc

protected readonly _rpc: TonCenter | undefined

Defined in: wallet-ton/src/read-only-account.ts:43

Inherited from

WalletAccountReadOnlyTon._rpc

_walletId

protected readonly _walletId: bigint

Defined in: wallet-ton/src/read-only-account.ts:40

Inherited from

WalletAccountReadOnlyTon._walletId

address

readonly address: string

Defined in: wallet-ton/src/read-only-account.ts:38

User-friendly address.

Inherited from

WalletAccountReadOnlyTon.address

chain

readonly chain: string

Defined in: wallet-ton/src/read-only-account.ts:34

CAIP-2 chain id, e.g. “eip155:1”, “solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp”, “ton:-239”, “tron:0x2b6653dc”, “bip122:000000000019d6689c085ae165831e93”.

Implementation of

IWalletAccount.chain

Inherited from

WalletAccountReadOnlyTon.chain

needsNetwork

readonly needsNetwork: true = true

Defined in: wallet-ton/src/account.ts:36

seqno and fees come from the network before signing.

Implementation of

IWalletAccount.needsNetwork

path

readonly path: string

Defined in: wallet-ton/src/account.ts:38

Derivation path, ton-mnemonic, or external.

publicKey

readonly publicKey: Uint8Array

Defined in: wallet-ton/src/read-only-account.ts:36

Ed25519 public key the wallet is derived from.

Inherited from

WalletAccountReadOnlyTon.publicKey

signerKind

readonly signerKind: "external" | "seed" | "key"

Defined in: wallet-ton/src/account.ts:46

What holds the key: seed, key (one imported key) or external.

Accessors

index

Get Signature

get index(): number | undefined

Defined in: wallet-ton/src/account.ts:63

Account index for the standard m/44’/607’/i’ path.

Returns

number | undefined

Methods

checkedAddress()

protected checkedAddress(to): object

Defined in: wallet-ton/src/read-only-account.ts:135

A destination address with the checks every payment gets: workchain 0 or -1, and a friendly address’s test-only flag matching the wallet’s network. Used for a native message’s to and a jetton transfer’s recipient and response destination (round 3, L8).

Parameters

to

string

Returns

object

address

address: Address

bounceable

bounceable: boolean

Inherited from

WalletAccountReadOnlyTon.checkedAddress

describe()

describe(tx): TonDescription

Defined in: wallet-ton/src/read-only-account.ts:281

Offline description of what tx does — see describeTransaction.

Parameters

dispose()

dispose(): void

Defined in: wallet-ton/src/account.ts:222

Disposes the signer: a local key is zeroized, an external one is released.

Returns

void

Implementation of

IWalletAccount.dispose

estimateFees()

estimateFees(body): Promise<TonFees>

Defined in: wallet-ton/src/read-only-account.ts:234

in_fwd + storage + gas + fwd from toncenter’s estimateFee (signature ignored).

Parameters

body

Cell

Returns

Promise<TonFees>

Inherited from

WalletAccountReadOnlyTon.estimateFees

getAddress()

getAddress(): Promise<string>

Defined in: wallet-ton/src/read-only-account.ts:70

The user-friendly address.

Returns

Promise<string>

Implementation of

IWalletAccount.getAddress

Inherited from

WalletAccountReadOnlyTon.getAddress

getBalance()

getBalance(): Promise<bigint>

Defined in: wallet-ton/src/read-only-account.ts:73

Native balance in nanotons.

Returns

Promise<bigint>

Implementation of

IWalletAccount.getBalance

Inherited from

WalletAccountReadOnlyTon.getBalance

getJettonWalletAddress()

getJettonWalletAddress(token): Promise<Address>

Defined in: wallet-ton/src/read-only-account.ts:86

Resolve this wallet’s jetton wallet for a jetton master.

Parameters

token

string

Returns

Promise<Address>

Inherited from

WalletAccountReadOnlyTon.getJettonWalletAddress

getSeqno()

getSeqno(): Promise<number>

Defined in: wallet-ton/src/read-only-account.ts:78

Current seqno — 0 until the wallet contract is deployed. Always fetched fresh.

Returns

Promise<number>

Inherited from

WalletAccountReadOnlyTon.getSeqno

getTokenBalance()

getTokenBalance(token): Promise<bigint>

Defined in: wallet-ton/src/read-only-account.ts:114

Jetton balance in base units, read from this wallet’s jetton wallet; 0 when it does not exist.

Parameters

token

string

Returns

Promise<bigint>

Implementation of

IWalletAccount.getTokenBalance

Inherited from

WalletAccountReadOnlyTon.getTokenBalance

getTransactionReceipt()

getTransactionReceipt(hash): Promise<TonReceipt | undefined>

Defined in: wallet-ton/src/read-only-account.ts:289

Receipt for a body hash returned by sendTransaction: toncenter v3 maps the message body hash to the account transaction, which is then fetched.

Parameters

hash

string

Returns

Promise<TonReceipt | undefined>

Implementation of

IWalletAccount.getTransactionReceipt

Inherited from

WalletAccountReadOnlyTon.getTransactionReceipt

initIfNeeded()

protected initIfNeeded(): Promise<StateInit | undefined>

Defined in: wallet-ton/src/read-only-account.ts:228

StateInit to attach to an external when the wallet is not deployed yet.

Returns

Promise<StateInit | undefined>

Inherited from

WalletAccountReadOnlyTon.initIfNeeded

jettonTransferMessage()

protected jettonTransferMessage(o): Promise<V5R1Message>

Defined in: wallet-ton/src/read-only-account.ts:166

Parameters

o

TonTransferOptions

Returns

Promise<V5R1Message>

Inherited from

WalletAccountReadOnlyTon.jettonTransferMessage

jettonWalletData()

protected jettonWalletData(token, jw): Promise<bigint>

Defined in: wallet-ton/src/read-only-account.ts:100

Read a jetton wallet and prove it is ours for token: get_wallet_data must name this wallet as owner and token as master. The master’s own get_wallet_address answer is not trusted on its own — a fake master could point at our real wallet of another jetton (e.g. USDT).

Parameters

token

string

jw

Address

Returns

Promise<bigint>

Inherited from

WalletAccountReadOnlyTon.jettonWalletData

quoteSendTransaction()

quoteSendTransaction(tx): Promise<{ fee: bigint; }>

Defined in: wallet-ton/src/read-only-account.ts:268

Estimated fee of a transaction, in nanotons.

Parameters

tx

TonSendable

Returns

Promise<{ fee: bigint; }>

Implementation of

IWalletAccount.quoteSendTransaction

Inherited from

WalletAccountReadOnlyTon.quoteSendTransaction

quoteTransfer()

quoteTransfer(o): Promise<{ fee: bigint; }>

Defined in: wallet-ton/src/read-only-account.ts:274

Estimated fee of a transfer, in nanotons.

Parameters

o

TonTransferOptions

Returns

Promise<{ fee: bigint; }>

Implementation of

IWalletAccount.quoteTransfer

Inherited from

WalletAccountReadOnlyTon.quoteTransfer

requireRpc()

protected requireRpc(what): TonCenter

Defined in: wallet-ton/src/read-only-account.ts:64

Parameters

what

string

Returns

TonCenter

Inherited from

WalletAccountReadOnlyTon.requireRpc

sendTransaction()

sendTransaction(tx, options?): Promise<TransferResult>

Defined in: wallet-ton/src/account.ts:198

Sign and broadcast; hash is the body hash (hex) — resolve it with getTransactionReceipt.

Parameters

tx

TonSendable

options?

WriteOptions = {}

Returns

Promise<TransferResult>

Implementation of

IWalletAccount.sendTransaction

sign()

sign(message): Promise<string>

Defined in: wallet-ton/src/account.ts:76

Hex ed25519 signature over the raw message bytes. A 32-byte message — string or bytes — is refused with MessageIsTransactionError: the wallet contract checks a transfer’s signature over the 32-byte hash of its signing cell, so those bytes could be one. Bytes that carry this account’s public key are refused as well: one ed25519 key (an external signer) may also be a Solana wallet, and a Solana transaction names its signer’s key. TON Connect goes through signTonProof and signTonConnectData.

Parameters

message

string | Uint8Array<ArrayBufferLike>

Returns

Promise<string>

Implementation of

IWalletAccount.sign

signingCell()

protected signingCell(messages): Promise<{ seqno: number; signing: Cell; validUntil: number; }>

Defined in: wallet-ton/src/read-only-account.ts:219

The cell to sign for messages at the CURRENT seqno (fetched fresh every time).

Parameters

messages

V5R1Message[]

Returns

Promise<{ seqno: number; signing: Cell; validUntil: number; }>

Inherited from

WalletAccountReadOnlyTon.signingCell

signTonConnectData()

signTonConnectData(request): Promise<TonSignedData>

Defined in: wallet-ton/src/account.ts:99

TON Connect signData (text / binary) for this wallet’s address: the reply the dApp gets.

Parameters

request

TonSignDataRequest

Returns

Promise<TonSignedData>

signTonProof()

signTonProof(request): Promise<TonProof>

Defined in: wallet-ton/src/account.ts:87

TON Connect ton_proof for this wallet’s address: the proof object of the connect reply. The digest is built here (0xffff ‖ “ton-connect” ‖ …), so no request can turn it into a transfer. domain is the host the wallet saw the request come from.

Parameters

request

TonProofRequest

Returns

Promise<TonProof>

signTransaction()

signTransaction(tx, options?): Promise<string>

Defined in: wallet-ton/src/account.ts:173

Sign without broadcasting. Returns the external-message BODY as base64 BoC (pass it back to sendTransaction as a Cell).

Parameters

tx

TonSendable

options?

WriteOptions = {}

Returns

Promise<string>

Implementation of

IWalletAccount.signTransaction

simulateBody()

simulateBody(body): Promise<TonSimulation>

Defined in: wallet-ton/src/read-only-account.ts:247

Preflight an external body: fees via estimateFee and, unless config.emulate === false, a trace emulation (tonapi by default, see TonConfig.emulate) whose compute/action phases — and the first-hop internal messages — decide ok. Never throws for a failing emulation, only for transport problems or a malformed emulator response.