WalletAccountReadOnlyTon

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

A TON V5R1 wallet without a key: balance, jetton balances, seqno, fee estimates, emulation, receipts and signature checks.

Extended by

• WalletAccountTon

Implements

• IWalletAccountReadOnly

Constructors

Constructor

new WalletAccountReadOnlyTon(publicKey, config?): WalletAccountReadOnlyTon

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

Parameters

publicKey

string | Uint8Array<ArrayBufferLike>

config?

TonConfig = {}

Returns

WalletAccountReadOnlyTon

Properties

_address

protected readonly _address: Address

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

---

_config

protected readonly _config: TonConfig

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

---

_init

protected readonly _init: StateInit

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

---

_rpc

protected readonly _rpc: TonCenter | undefined

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

---

_walletId

protected readonly _walletId: bigint

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

---

address

readonly address: string

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

User-friendly 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

IWalletAccountReadOnly.chain

---

publicKey

readonly publicKey: Uint8Array

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

Ed25519 public key the wallet is derived from.

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

---

describe()

describe(tx): TonDescription

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

Offline description of what tx does — see describeTransaction.

Parameters

tx

TonSendable

Returns

TonDescription

---

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>

---

getAddress()

getAddress(): Promise<string>

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

The user-friendly address.

Returns

Promise<string>

Implementation of

IWalletAccountReadOnly.getAddress

---

getBalance()

getBalance(): Promise<bigint>

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

Native balance in nanotons.

Returns

Promise<bigint>

Implementation of

IWalletAccountReadOnly.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>

---

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>

---

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

IWalletAccountReadOnly.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

IWalletAccountReadOnly.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>

---

jettonTransferMessage()

protected jettonTransferMessage(o): Promise<V5R1Message>

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

Parameters

o

TonTransferOptions

Returns

Promise<V5R1Message>

---

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>

---

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

IWalletAccountReadOnly.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

IWalletAccountReadOnly.quoteTransfer

---

requireRpc()

protected requireRpc(what): TonCenter

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

Parameters

what

string

Returns

TonCenter

---

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; }>

---

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.

Parameters

body

Cell

Returns

Promise<TonSimulation>

---

simulateTransaction()

simulateTransaction(tx): Promise<TonSimulation>

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

Preflight a TonSendable (unsigned body, current seqno).

Parameters

tx

TonSendable

Returns

Promise<TonSimulation>

---

stateInitOf()

protected stateInitOf(src): StateInit | undefined

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

Parameters

src

string | Cell | StateInit | undefined

Returns

StateInit | undefined

---

toMessages()

protected toMessages(tx): V5R1Message[]

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

Parameters

tx

TonTransaction | TonTransaction[]

Returns

V5R1Message[]

---

transactionMessage()

protected transactionMessage(tx): V5R1Message

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

Parameters

tx

TonTransaction

Returns

V5R1Message

---

validUntil()

protected validUntil(): number

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

Returns

number

---

verify()

verify(message, signature): Promise<boolean>

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

ed25519 over the raw message bytes; signature hex.

Parameters

message

string | Uint8Array<ArrayBufferLike>

signature

string

Returns

Promise<boolean>

Implementation of

IWalletAccountReadOnly.verify