@tonappchain/sdk 0.9.0-rc1 → 0.9.0-rc3

package/dist/src/accountAbstraction/abi.js

@@ -0,0 +1,32 @@
+"use strict";
+// Minimal human-readable ABIs for TAC account-abstraction contracts. Kept in sync
+// with aa-contracts#tac:
+//   contracts/accounts/TacAccount.sol
+//   contracts/accounts/TacAccountFactory.sol
+//   contracts/accounts/TacBaseAccount.sol  (execute / executeBatch surface)
+//   contracts/paymaster/TacERC20Paymaster.sol  (read surface for SDK clients)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TacERC20PaymasterABI = exports.TacAccountABI = exports.TacAccountFactoryABI = void 0;
+exports.TacAccountFactoryABI = [
+    'function getOrCreateAccount(bytes32 publicKey) external returns (address)',
+    'function getAccountAddress(bytes32 publicKey) public view returns (address)',
+];
+exports.TacAccountABI = [
+    // From TacBaseAccount (execute surface)
+    'function execute(address target, uint256 value, bytes calldata data) external',
+    'function executeBatch(tuple(address target, uint256 value, bytes data)[] calls) external',
+    // From IAccount + TacBaseAccount
+    'function getNonce() public view returns (uint256)',
+    'function getNonce(uint192 key) public view returns (uint256)',
+    // From TacAccount
+    'function publicKey() public view returns (bytes32)',
+    'function entryPoint() public view returns (address)',
+];
+exports.TacERC20PaymasterABI = [
+    'function token() public view returns (address)',
+    'function tacPermit2() public view returns (address)',
+    'function priceMarkup() public view returns (uint32)',
+    'function refundPostOpCost() public view returns (uint256)',
+    'function internalBalance(address account) public view returns (uint256)',
+    'function getPrice() public view returns (uint192)',
+];

package/dist/src/accountAbstraction/index.d.ts

@@ -0,0 +1,24 @@
+export { TacAccountABI, TacAccountFactoryABI, TacERC20PaymasterABI } from './abi';
+export type { BaseApiParams, UserOpResult } from './BaseAccountAPI';
+export { BaseAccountAPI } from './BaseAccountAPI';
+export type { Ed25519Signature, Ed25519Signer, TonConnectSignedParts, TonConnectSigner } from './Ed25519';
+export { buildPermitBinding, ed25519SignerFromSecretKey, packPermit2InnerSignature, packPermitBoundUserOpSignature, packRawEd25519Signature, packTonConnectPermit2InnerSignature, packTonConnectUserOpSignature, } from './Ed25519';
+export { HttpRpcClient } from './HttpRpcClient';
+export type { UserOperation } from './internal/userOp';
+export type { AaAddresses, AaNetworkConfig } from './networks';
+export { AA_NETWORKS } from './networks';
+export type { PaymasterParams } from './PaymasterAPI';
+export { PaymasterAPI } from './PaymasterAPI';
+export type { Permit2TokenPermission, PermitBatchTransferFromInput, PermitBatchTransferFromTuple } from './Permit2';
+export { buildPermitMessage, packPermitData, packPermitPaymasterData } from './Permit2';
+export type { BuildPermitUserOpInput, BuildPermitUserOpInputTonConnect } from './PermitFlow';
+export { buildSignedUserOpWithPermit, buildSignedUserOpWithPermitTonConnect } from './PermitFlow';
+export type { AaSignerResult } from './signer';
+export { aaSignerFromMnemonic } from './signer';
+export type { TacAccountApiParams } from './TacAccountAPI';
+export { TacAccountAPI } from './TacAccountAPI';
+export type { PermitOptions, SendTx, TacAccountSdkParams, UserOpReceipt, UserOpSendResult, } from './TacAccountSdk';
+export { TacAccountSdk } from './TacAccountSdk';
+export type { TacERC20PaymasterApiParams } from './TacERC20PaymasterAPI';
+export { packModeByte, packPaymasterAndData, TacERC20PaymasterAPI, TacPaymasterMode } from './TacERC20PaymasterAPI';
+export type { TransactionDetailsForUserOp } from './TransactionDetailsForUserOp';

package/dist/src/accountAbstraction/index.js

@@ -0,0 +1,44 @@
+"use strict";
+// TAC account-abstraction (ERC-4337) client — native ethers v6.
+// Drive a TAC smart account from a TON Ed25519 key: build + sign UserOperations,
+// send them to the bundler, and pay gas natively or in an ERC-20 via the paymaster.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TacPaymasterMode = exports.TacERC20PaymasterAPI = exports.packPaymasterAndData = exports.packModeByte = exports.TacAccountSdk = exports.TacAccountAPI = exports.aaSignerFromMnemonic = exports.buildSignedUserOpWithPermitTonConnect = exports.buildSignedUserOpWithPermit = exports.packPermitPaymasterData = exports.packPermitData = exports.buildPermitMessage = exports.PaymasterAPI = exports.AA_NETWORKS = exports.HttpRpcClient = exports.packTonConnectUserOpSignature = exports.packTonConnectPermit2InnerSignature = exports.packRawEd25519Signature = exports.packPermitBoundUserOpSignature = exports.packPermit2InnerSignature = exports.ed25519SignerFromSecretKey = exports.buildPermitBinding = exports.BaseAccountAPI = exports.TacERC20PaymasterABI = exports.TacAccountFactoryABI = exports.TacAccountABI = void 0;
+var abi_1 = require("./abi");
+Object.defineProperty(exports, "TacAccountABI", { enumerable: true, get: function () { return abi_1.TacAccountABI; } });
+Object.defineProperty(exports, "TacAccountFactoryABI", { enumerable: true, get: function () { return abi_1.TacAccountFactoryABI; } });
+Object.defineProperty(exports, "TacERC20PaymasterABI", { enumerable: true, get: function () { return abi_1.TacERC20PaymasterABI; } });
+var BaseAccountAPI_1 = require("./BaseAccountAPI");
+Object.defineProperty(exports, "BaseAccountAPI", { enumerable: true, get: function () { return BaseAccountAPI_1.BaseAccountAPI; } });
+var Ed25519_1 = require("./Ed25519");
+Object.defineProperty(exports, "buildPermitBinding", { enumerable: true, get: function () { return Ed25519_1.buildPermitBinding; } });
+Object.defineProperty(exports, "ed25519SignerFromSecretKey", { enumerable: true, get: function () { return Ed25519_1.ed25519SignerFromSecretKey; } });
+Object.defineProperty(exports, "packPermit2InnerSignature", { enumerable: true, get: function () { return Ed25519_1.packPermit2InnerSignature; } });
+Object.defineProperty(exports, "packPermitBoundUserOpSignature", { enumerable: true, get: function () { return Ed25519_1.packPermitBoundUserOpSignature; } });
+Object.defineProperty(exports, "packRawEd25519Signature", { enumerable: true, get: function () { return Ed25519_1.packRawEd25519Signature; } });
+Object.defineProperty(exports, "packTonConnectPermit2InnerSignature", { enumerable: true, get: function () { return Ed25519_1.packTonConnectPermit2InnerSignature; } });
+Object.defineProperty(exports, "packTonConnectUserOpSignature", { enumerable: true, get: function () { return Ed25519_1.packTonConnectUserOpSignature; } });
+var HttpRpcClient_1 = require("./HttpRpcClient");
+Object.defineProperty(exports, "HttpRpcClient", { enumerable: true, get: function () { return HttpRpcClient_1.HttpRpcClient; } });
+var networks_1 = require("./networks");
+Object.defineProperty(exports, "AA_NETWORKS", { enumerable: true, get: function () { return networks_1.AA_NETWORKS; } });
+var PaymasterAPI_1 = require("./PaymasterAPI");
+Object.defineProperty(exports, "PaymasterAPI", { enumerable: true, get: function () { return PaymasterAPI_1.PaymasterAPI; } });
+var Permit2_1 = require("./Permit2");
+Object.defineProperty(exports, "buildPermitMessage", { enumerable: true, get: function () { return Permit2_1.buildPermitMessage; } });
+Object.defineProperty(exports, "packPermitData", { enumerable: true, get: function () { return Permit2_1.packPermitData; } });
+Object.defineProperty(exports, "packPermitPaymasterData", { enumerable: true, get: function () { return Permit2_1.packPermitPaymasterData; } });
+var PermitFlow_1 = require("./PermitFlow");
+Object.defineProperty(exports, "buildSignedUserOpWithPermit", { enumerable: true, get: function () { return PermitFlow_1.buildSignedUserOpWithPermit; } });
+Object.defineProperty(exports, "buildSignedUserOpWithPermitTonConnect", { enumerable: true, get: function () { return PermitFlow_1.buildSignedUserOpWithPermitTonConnect; } });
+var signer_1 = require("./signer");
+Object.defineProperty(exports, "aaSignerFromMnemonic", { enumerable: true, get: function () { return signer_1.aaSignerFromMnemonic; } });
+var TacAccountAPI_1 = require("./TacAccountAPI");
+Object.defineProperty(exports, "TacAccountAPI", { enumerable: true, get: function () { return TacAccountAPI_1.TacAccountAPI; } });
+var TacAccountSdk_1 = require("./TacAccountSdk");
+Object.defineProperty(exports, "TacAccountSdk", { enumerable: true, get: function () { return TacAccountSdk_1.TacAccountSdk; } });
+var TacERC20PaymasterAPI_1 = require("./TacERC20PaymasterAPI");
+Object.defineProperty(exports, "packModeByte", { enumerable: true, get: function () { return TacERC20PaymasterAPI_1.packModeByte; } });
+Object.defineProperty(exports, "packPaymasterAndData", { enumerable: true, get: function () { return TacERC20PaymasterAPI_1.packPaymasterAndData; } });
+Object.defineProperty(exports, "TacERC20PaymasterAPI", { enumerable: true, get: function () { return TacERC20PaymasterAPI_1.TacERC20PaymasterAPI; } });
+Object.defineProperty(exports, "TacPaymasterMode", { enumerable: true, get: function () { return TacERC20PaymasterAPI_1.TacPaymasterMode; } });

package/dist/src/accountAbstraction/internal/entryPointAbi.d.ts

@@ -0,0 +1 @@
+export declare const IEntryPointABI: readonly ["function getUserOpHash((address sender,uint256 nonce,bytes initCode,bytes callData,bytes32 accountGasLimits,uint256 preVerificationGas,bytes32 gasFees,bytes paymasterAndData,bytes signature) userOp) view returns (bytes32)", "function getSenderAddress(bytes initCode)", "error SenderAddressResult(address sender)", "function senderCreator() view returns (address)", "function getNonce(address sender, uint192 key) view returns (uint256)", "event UserOperationEvent(bytes32 indexed userOpHash, address indexed sender, address indexed paymaster, uint256 nonce, bool success, uint256 actualGasCost, uint256 actualGasUsed)"];

package/dist/src/accountAbstraction/internal/entryPointAbi.js

@@ -0,0 +1,16 @@
+"use strict";
+// Minimal human-readable ABI for the ERC-4337 v0.8 EntryPoint — only the surface
+// the account APIs use: on-chain userOpHash, counterfactual-address probing, and
+// the UserOperationEvent. Vendored so this module needs no @account-abstraction dep.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IEntryPointABI = void 0;
+exports.IEntryPointABI = [
+    // off-chain-matching userOpHash (avoids re-implementing EIP-712 packing in the SDK)
+    'function getUserOpHash((address sender,uint256 nonce,bytes initCode,bytes callData,bytes32 accountGasLimits,uint256 preVerificationGas,bytes32 gasFees,bytes paymasterAndData,bytes signature) userOp) view returns (bytes32)',
+    // reverts with SenderAddressResult(sender) — used to derive an undeployed account address
+    'function getSenderAddress(bytes initCode)',
+    'error SenderAddressResult(address sender)',
+    'function senderCreator() view returns (address)',
+    'function getNonce(address sender, uint192 key) view returns (uint256)',
+    'event UserOperationEvent(bytes32 indexed userOpHash, address indexed sender, address indexed paymaster, uint256 nonce, bool success, uint256 actualGasCost, uint256 actualGasUsed)',
+];

package/dist/src/accountAbstraction/internal/userOp.d.ts

@@ -0,0 +1,54 @@
+import { BigNumberish, BytesLike } from 'ethers';
+/** Unpacked UserOperation as the SDK/bundler exchange it (paymaster fields split out). */
+export interface UserOperation {
+    sender: string;
+    nonce: BigNumberish;
+    factory?: string;
+    factoryData?: BytesLike;
+    callData: BytesLike;
+    callGasLimit: BigNumberish;
+    verificationGasLimit: BigNumberish;
+    preVerificationGas: BigNumberish;
+    maxFeePerGas: BigNumberish;
+    maxPriorityFeePerGas: BigNumberish;
+    paymaster?: string;
+    paymasterData?: BytesLike;
+    paymasterVerificationGasLimit?: BigNumberish;
+    paymasterPostOpGasLimit?: BigNumberish;
+    signature: BytesLike;
+    authorizationList?: unknown[];
+}
+/** The on-chain PackedUserOperation tuple shape (what EntryPoint.getUserOpHash consumes). */
+export interface PackedUserOperation {
+    sender: string;
+    nonce: string;
+    initCode: string;
+    callData: string;
+    accountGasLimits: string;
+    preVerificationGas: string;
+    gasFees: string;
+    paymasterAndData: string;
+    signature: string;
+}
+/** initCode split, as returned by an account API for an undeployed account. */
+export interface FactoryParams {
+    factory: string;
+    factoryData?: BytesLike;
+}
+/**
+ * Coerce a bytes-like field to a hex string, treating '' / null / undefined as '0x'.
+ * `createUnsignedUserOp` returns an unsigned op with `signature: ''`, and ethers'
+ * `hexlify('')` throws — so a plain `?? '0x'` (only catches null/undefined) is not enough.
+ */
+export declare function toHexBytes(v: BytesLike | null | undefined): string;
+/** Pack two 128-bit values into a single bytes32 (high128 << 128 | low128). */
+export declare function packUint(high128: BigNumberish, low128: BigNumberish): string;
+/** Pack the paymaster fields into the on-chain `paymasterAndData` bytes. */
+export declare function packPaymasterData(paymaster: string, paymasterVerificationGasLimit: BigNumberish, postOpGasLimit: BigNumberish, paymasterData?: BytesLike): string;
+/** Pack an unpacked UserOperation into the on-chain PackedUserOperation tuple. */
+export declare function packUserOp(op: UserOperation): PackedUserOperation;
+/**
+ * Recursively hex-encode a value for JSON-RPC: numeric values become minimal hex
+ * quantities, byte arrays become hex strings, everything else is passed through.
+ */
+export declare function deepHexlify(obj: unknown): unknown;

package/dist/src/accountAbstraction/internal/userOp.js

@@ -0,0 +1,72 @@
+"use strict";
+// Self-contained ERC-4337 v0.8 UserOperation types + packing helpers, ported to
+// ethers v6. Vendored from @account-abstraction/utils (which is ethers v5 and
+// unpublished) so the accountAbstraction module has no external AA dependency.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toHexBytes = toHexBytes;
+exports.packUint = packUint;
+exports.packPaymasterData = packPaymasterData;
+exports.packUserOp = packUserOp;
+exports.deepHexlify = deepHexlify;
+const ethers_1 = require("ethers");
+/**
+ * Coerce a bytes-like field to a hex string, treating '' / null / undefined as '0x'.
+ * `createUnsignedUserOp` returns an unsigned op with `signature: ''`, and ethers'
+ * `hexlify('')` throws — so a plain `?? '0x'` (only catches null/undefined) is not enough.
+ */
+function toHexBytes(v) {
+    return v == null || v === '' ? '0x' : (0, ethers_1.hexlify)(v);
+}
+/** Pack two 128-bit values into a single bytes32 (high128 << 128 | low128). */
+function packUint(high128, low128) {
+    return (0, ethers_1.zeroPadValue)((0, ethers_1.toBeHex)(((0, ethers_1.toBigInt)(high128) << 128n) + (0, ethers_1.toBigInt)(low128)), 32);
+}
+/** Pack the paymaster fields into the on-chain `paymasterAndData` bytes. */
+function packPaymasterData(paymaster, paymasterVerificationGasLimit, postOpGasLimit, paymasterData) {
+    return (0, ethers_1.concat)([paymaster, packUint(paymasterVerificationGasLimit, postOpGasLimit), toHexBytes(paymasterData)]);
+}
+/** Pack an unpacked UserOperation into the on-chain PackedUserOperation tuple. */
+function packUserOp(op) {
+    let paymasterAndData = '0x';
+    if (op.paymaster != null) {
+        if (op.paymasterVerificationGasLimit == null || op.paymasterPostOpGasLimit == null) {
+            throw new Error('paymaster with no gas limits');
+        }
+        paymasterAndData = packPaymasterData(op.paymaster, op.paymasterVerificationGasLimit, op.paymasterPostOpGasLimit, op.paymasterData);
+    }
+    const initCode = op.factory == null ? '0x' : (0, ethers_1.concat)([op.factory, toHexBytes(op.factoryData)]);
+    return {
+        sender: op.sender,
+        nonce: (0, ethers_1.toBeHex)((0, ethers_1.toBigInt)(op.nonce)),
+        initCode,
+        callData: toHexBytes(op.callData),
+        accountGasLimits: packUint(op.verificationGasLimit, op.callGasLimit),
+        preVerificationGas: (0, ethers_1.toBeHex)((0, ethers_1.toBigInt)(op.preVerificationGas)),
+        gasFees: packUint(op.maxPriorityFeePerGas, op.maxFeePerGas),
+        paymasterAndData,
+        signature: toHexBytes(op.signature),
+    };
+}
+/**
+ * Recursively hex-encode a value for JSON-RPC: numeric values become minimal hex
+ * quantities, byte arrays become hex strings, everything else is passed through.
+ */
+function deepHexlify(obj) {
+    if (typeof obj === 'function') {
+        return undefined;
+    }
+    if (obj == null || typeof obj === 'string' || typeof obj === 'boolean') {
+        return obj;
+    }
+    if (typeof obj === 'bigint' || typeof obj === 'number') {
+        return (0, ethers_1.toQuantity)(obj);
+    }
+    if (obj instanceof Uint8Array) {
+        return (0, ethers_1.hexlify)(obj);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((member) => deepHexlify(member));
+    }
+    const record = obj;
+    return Object.keys(record).reduce((set, key) => ({ ...set, [key]: deepHexlify(record[key]) }), {});
+}

package/dist/src/accountAbstraction/networks.d.ts

@@ -0,0 +1,22 @@
+import { Network } from '../structs/Struct';
+/** AA contract addresses for a network. */
+export interface AaAddresses {
+    entryPoint: string;
+    accountFactory: string;
+    paymaster: string;
+    permit2: string;
+}
+/** Built-in AA configuration for a network. */
+export interface AaNetworkConfig extends AaAddresses {
+    chainId: number;
+    /**
+     * Bundler RPC URL. Intentionally left undefined in the built-in defaults — there is no
+     * public bundler endpoint to ship, so pass `bundlerUrl` to {@link TacAccountSdk.create}.
+     */
+    bundlerUrl?: string;
+}
+/**
+ * Built-in per-network AA defaults. TESTNET is SPB (chainId 2391) — the same chain
+ * tac-sdk's TESTNET resolves to. MAINNET is not deployed yet.
+ */
+export declare const AA_NETWORKS: Partial<Record<Network, AaNetworkConfig>>;

package/dist/src/accountAbstraction/networks.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AA_NETWORKS = void 0;
+const Struct_1 = require("../structs/Struct");
+/**
+ * Built-in per-network AA defaults. TESTNET is SPB (chainId 2391) — the same chain
+ * tac-sdk's TESTNET resolves to. MAINNET is not deployed yet.
+ */
+exports.AA_NETWORKS = {
+    [Struct_1.Network.TESTNET]: {
+        chainId: 2391,
+        entryPoint: '0x239DBD98defbad1c369034a2897bD5b8b57b468A',
+        accountFactory: '0x7879c3237811A86092E89AD94837163Ae71d6669',
+        // paymaster for token USD₮ (0xbA7E…9220, 6-dec); the fee token is read on-chain
+        paymaster: '0xD41B5AC8803bd9371c0bdB44CB95B8b1879F8865',
+        permit2: '0x36d6565DcdE4674115bBd1d86E511bebB1C425b9',
+        // bundlerUrl: undefined — provide it via TacAccountSdk.create({ bundlerUrl })
+    },
+    // MAINNET: account abstraction not deployed yet
+};

package/dist/src/accountAbstraction/signer.d.ts

@@ -0,0 +1,12 @@
+import { Ed25519Signer } from './Ed25519';
+export interface AaSignerResult {
+    /** Ed25519 public key as 32-byte 0x-hex — the AA account is derived from this. */
+    publicKey: string;
+    /** Signer that produces `(r, s)` over a 32-byte message. */
+    signer: Ed25519Signer;
+}
+/**
+ * Build an AA signer + public key from a TON mnemonic, using the same key derivation as
+ * `SenderFactory` (`mnemonicToWalletKey`, which equals `mnemonicToPrivateKey`).
+ */
+export declare function aaSignerFromMnemonic(mnemonic: string): Promise<AaSignerResult>;

package/dist/src/accountAbstraction/signer.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aaSignerFromMnemonic = aaSignerFromMnemonic;
+const ton_crypto_1 = require("ton-crypto");
+const Ed25519_1 = require("./Ed25519");
+/**
+ * Build an AA signer + public key from a TON mnemonic, using the same key derivation as
+ * `SenderFactory` (`mnemonicToWalletKey`, which equals `mnemonicToPrivateKey`).
+ */
+async function aaSignerFromMnemonic(mnemonic) {
+    const keypair = await (0, ton_crypto_1.mnemonicToWalletKey)(mnemonic.trim().split(/\s+/));
+    const signer = (0, Ed25519_1.ed25519SignerFromSecretKey)(keypair.secretKey, (message, secretKey) => (0, ton_crypto_1.sign)(Buffer.from(message), Buffer.from(secretKey)));
+    return { publicKey: '0x' + keypair.publicKey.toString('hex'), signer };
+}

package/dist/src/adapters/LiteClientOpener.js

@@ -47,7 +47,18 @@ class LiteClientOpener extends BaseContractOpener_1.BaseContractOpener {
         return new LiteClientOpener(client, engine, logger, engines);
     }
     open(contract) {
-        return this.client.open(contract);
+        return (0, ton_1.openContract)(contract, ({ address, init }) => ({
+            ...this.client.provider(address, init),
+            open: (src) => this.open(src),
+            get: async (name, args) => {
+                const block = await this.client.getMasterchainInfo();
+                const result = await this.client.runMethod(address, name.toString(), (0, ton_1.serializeTuple)(args).toBoc({ idx: false, crc32: false }), block.last);
+                if (result.exitCode !== 0 && result.exitCode !== 1) {
+                    throw new ton_1.ComputeError(`Exit code: ${result.exitCode}`, result.exitCode);
+                }
+                return { stack: new ton_1.TupleReader(result.result ? (0, ton_1.parseTuple)(ton_1.Cell.fromBase64(result.result)) : []) };
+            },
+        }));
     }
     disableReconnect(singleEngine) {
         const engine = singleEngine;

package/dist/src/adapters/SandboxOpener.d.ts

@@ -1,4 +1,4 @@
-import { Blockchain, SandboxContract } from '@ton/sandbox';
+import type { Blockchain, SandboxContract } from '@ton/sandbox';
 import { Address, Contract, Transaction } from '@ton/ton';
 import { ContractOpener } from '../interfaces';
 import { AddressInformation, ContractState } from '../structs/Struct';

package/dist/src/adapters/SandboxOpener.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SandboxOpener = void 0;
 exports.sandboxOpener = sandboxOpener;
+const ton_1 = require("@ton/ton");
 const BaseContractOpener_1 = require("./BaseContractOpener");
 class SandboxOpener extends BaseContractOpener_1.BaseContractOpener {
     constructor(blockchain) {
@@ -9,7 +10,25 @@ class SandboxOpener extends BaseContractOpener_1.BaseContractOpener {
         this.blockchain = blockchain;
     }
     open(contract) {
-        return this.blockchain.openContract(contract);
+        return new Proxy(this.blockchain.openContract(contract), {
+            get: (target, prop) => {
+                const value = Reflect.get(target, prop);
+                if (typeof prop !== 'string' || !prop.startsWith('get') || typeof value !== 'function')
+                    return value;
+                return (...args) => {
+                    const result = value.apply(target, args);
+                    if (!(result instanceof Promise))
+                        return result;
+                    return result.catch((error) => {
+                        if (error instanceof Error && 'exitCode' in error && typeof error.exitCode === 'number') {
+                            const { vmLogs, debugLogs } = error;
+                            throw new ton_1.ComputeError(error.message, error.exitCode, { logs: vmLogs, debugLogs });
+                        }
+                        throw error;
+                    });
+                };
+            },
+        });
     }
     async getContractState(address) {
         const state = await this.blockchain.provider(address).getState();

package/dist/src/adapters/TonClient4Opener.js

@@ -21,7 +21,21 @@ class TonClient4Opener extends BaseContractOpener_1.BaseContractOpener {
         return new TonClient4Opener(client4, logger);
     }
     open(contract) {
-        return this.client4.open(contract);
+        return (0, ton_1.openContract)(contract, ({ address, init }) => ({
+            ...this.client4.provider(address, init),
+            open: (src) => this.open(src),
+            get: async (name, args) => {
+                if (typeof name !== 'string') {
+                    throw new Error('Method name must be a string for TonClient4 provider');
+                }
+                const block = await this.client4.getLastBlock();
+                const result = await this.client4.runMethod(block.last.seqno, address, name, args);
+                if (result.exitCode !== 0 && result.exitCode !== 1) {
+                    throw new ton_1.ComputeError(`Exit code: ${result.exitCode}`, result.exitCode);
+                }
+                return { stack: result.reader };
+            },
+        }));
     }
     async getContractState(address) {
         const latestBlock = await this.client4.getLastBlock();

package/dist/src/adapters/TonClientOpener.js

@@ -24,7 +24,20 @@ class TonClientOpener extends BaseContractOpener_1.BaseContractOpener {
         return new TonClientOpener(client, logger);
     }
     open(contract) {
-        return this.client.open(contract);
+        return (0, ton_1.openContract)(contract, ({ address, init }) => ({
+            ...this.client.provider(address, init),
+            open: (src) => this.open(src),
+            get: async (name, args) => {
+                if (typeof name !== 'string') {
+                    throw new Error('Method name must be a string for TonClient provider');
+                }
+                const result = await this.client.runMethodWithError(address, name, args);
+                if (result.exit_code !== 0 && result.exit_code !== 1) {
+                    throw new ton_1.ComputeError(`Unable to execute get method. Got exit_code: ${result.exit_code}`, result.exit_code);
+                }
+                return { stack: result.stack };
+            },
+        }));
     }
     async getContractState(address) {
         return this.client.getContractState(address);

package/dist/src/assets/FT.d.ts

@@ -3,7 +3,7 @@ import { Cell, OpenedContract } from '@ton/ton';
 import { JettonMinterData, JettonWallet } from '../../artifacts/tonTypes';
 import { Asset, IConfiguration } from '../interfaces';
 import { AssetOpType } from '../structs/InternalStruct';
-import { AssetFeeMode, AssetType, BlockchainType, EVMAddress, FeeParams, FTOriginAndData, Origin, TVMAddress, UserWalletBalanceExtended } from '../structs/Struct';
+import { AssetFeeMode, AssetType, BlockchainType, ContractState, EVMAddress, FeeParams, FTOriginAndData, Origin, TVMAddress, UserWalletBalanceExtended } from '../structs/Struct';
 export declare class FT implements Asset {
     private _tvmAddress;
     readonly type: AssetType;
@@ -16,13 +16,14 @@ export declare class FT implements Asset {
     private _evmAddress?;
     private _displayMultiplierNumerator;
     private _displayMultiplierDenominator;
+    private _hasDisplayMultiplier?;
     private _displayMultiplierFetchedAt;
     private _displayMultiplierCacheDuration;
     get address(): string;
     static getJettonData(configuration: IConfiguration, address: TVMAddress): Promise<JettonMinterData>;
     getJettonData(): Promise<JettonMinterData>;
     static getOrigin(configuration: IConfiguration, address: TVMAddress): Promise<Origin>;
-    static getOriginAndData(configuration: IConfiguration, address: TVMAddress): Promise<FTOriginAndData>;
+    static getOriginAndData(configuration: IConfiguration, address: TVMAddress, contractState?: ContractState): Promise<FTOriginAndData>;
     static getTVMAddress(configuration: IConfiguration, address: EVMAddress): Promise<string>;
     static getEVMAddress(configuration: IConfiguration, address: TVMAddress): Promise<string>;
     private constructor();
@@ -36,6 +37,7 @@ export declare class FT implements Asset {
     addAmount(amount: number): FT;
     addRawAmount(rawAmount: bigint): FT;
     getDecimals(): Promise<number>;
+    private getDisplayMultiplier;
     refreshDisplayMultiplier(): Promise<void>;
     private ensureFreshDisplayMultiplier;
     setDisplayMultiplierCacheDuration(durationMs: number): void;

package/dist/src/assets/FT.js

@@ -26,9 +26,9 @@ class FT {
         const result = await this.getOriginAndData(configuration, address);
         return result.origin;
     }
-    static async getOriginAndData(configuration, address) {
+    static async getOriginAndData(configuration, address, contractState) {
         const { jettonMinterCode, crossChainLayerAddress, jettonWalletCode } = configuration.TONParams;
-        const { code: thisCodeBOC } = await configuration.TONParams.contractOpener.getContractState(ton_1.Address.parse(address));
+        const { code: thisCodeBOC } = contractState ?? (await configuration.TONParams.contractOpener.getContractState(ton_1.Address.parse(address)));
         if (!thisCodeBOC) {
             throw errors_1.emptyContractError;
         }
@@ -123,7 +123,8 @@ class FT {
     }
     static async fromAddress(configuration, address) {
         const tvmAddress = (0, ethers_1.isAddress)(address) ? await this.getTVMAddress(configuration, address) : address;
-        const { origin, jettonMinter, evmAddress: cachedEvmAddress, jettonData, } = await this.getOriginAndData(configuration, tvmAddress).catch((e) => {
+        const contractState = await configuration.TONParams.contractOpener.getContractState(ton_1.Address.parse(tvmAddress));
+        const { origin, jettonMinter, evmAddress: cachedEvmAddress, jettonData, } = await this.getOriginAndData(configuration, tvmAddress, contractState).catch((e) => {
             if (e instanceof errors_1.ContractError) {
                 const jettonMinter = configuration.TONParams.contractOpener.open(configuration.artifacts.ton.wrappers.JettonMinter.createFromAddress(ton_1.Address.parse(tvmAddress)));
                 return { origin: Struct_1.Origin.TAC, jettonMinter, evmAddress: undefined, jettonData: undefined };
@@ -156,7 +157,9 @@ class FT {
             token._evmAddress = finalEvmAddress || address;
         }
         // Fetch and cache display multiplier for TEP-526 support
-        await token.refreshDisplayMultiplier();
+        if (contractState.state !== 'uninitialized') {
+            await token.refreshDisplayMultiplier();
+        }
         return token;
     }
     get rawAmount() {
@@ -168,6 +171,7 @@ class FT {
         ft._evmAddress = this._evmAddress;
         ft._displayMultiplierNumerator = this._displayMultiplierNumerator;
         ft._displayMultiplierDenominator = this._displayMultiplierDenominator;
+        ft._hasDisplayMultiplier = this._hasDisplayMultiplier;
         ft._displayMultiplierFetchedAt = this._displayMultiplierFetchedAt;
         ft._displayMultiplierCacheDuration = this._displayMultiplierCacheDuration;
         return ft;
@@ -205,18 +209,27 @@ class FT {
     async getDecimals() {
         return this._decimals;
     }
-    async refreshDisplayMultiplier() {
+    async getDisplayMultiplier() {
         try {
             const multiplier = await this._jettonMinter.getDisplayMultiplier();
-            this._displayMultiplierNumerator = multiplier.numerator;
-            this._displayMultiplierDenominator = multiplier.denominator;
-            this._displayMultiplierFetchedAt = Date.now();
+            return { hasDisplayMultiplier: true, ...multiplier };
+        }
+        catch (error) {
+            if (this._hasDisplayMultiplier || !(error instanceof ton_1.ComputeError) || error.exitCode !== 11) {
+                throw error;
+            }
+            return { hasDisplayMultiplier: false, numerator: 1n, denominator: 1n };
         }
-        catch {
-            this._displayMultiplierNumerator = 1n;
-            this._displayMultiplierDenominator = 1n;
-            this._displayMultiplierFetchedAt = Date.now();
+    }
+    async refreshDisplayMultiplier() {
+        if (this._hasDisplayMultiplier === false) {
+            return;
         }
+        const multiplier = await this.getDisplayMultiplier();
+        this._hasDisplayMultiplier = multiplier.hasDisplayMultiplier;
+        this._displayMultiplierNumerator = multiplier.numerator;
+        this._displayMultiplierDenominator = multiplier.denominator;
+        this._displayMultiplierFetchedAt = Date.now();
     }
     async ensureFreshDisplayMultiplier() {
         const age = Date.now() - this._displayMultiplierFetchedAt;
@@ -285,11 +298,11 @@ class FT {
         return BigInt(await wallet.getJettonBalance());
     }
     async getUserBalanceExtended(userAddress) {
-        await this.ensureFreshDisplayMultiplier();
         const masterState = await this._configuration.TONParams.contractOpener.getContractState(this._tvmAddress);
         if (masterState.state !== 'active') {
             return { exists: false };
         }
+        await this.ensureFreshDisplayMultiplier();
         const wallet = await this.getWallet(userAddress);
         const rawAmount = await wallet.getJettonBalance();
         const decimals = await this.getDecimals();

package/dist/src/index.d.ts

@@ -1,3 +1,4 @@
+export * from './accountAbstraction';
 export * from './adapters';
 export { AgnosticProxySDK } from './agnosticSdk/AgnosticSdk';
 export * as AgnosticStructs from './agnosticSdk/AgnosticStructs';

package/dist/src/index.js

@@ -37,6 +37,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TonTxFinalizer = exports.TONTransactionManager = exports.TACTransactionManager = exports.TacSdk = exports.TacExplorerClient = exports.Simulator = exports.OperationTracker = exports.NoopLogger = exports.ConsoleLogger = exports.LiteSequencerClient = exports.Configuration = exports.AxiosHttpClient = exports.getArtifacts = exports.AgnosticStructs = exports.AgnosticProxySDK = void 0;
+__exportStar(require("./accountAbstraction"), exports);
 __exportStar(require("./adapters"), exports);
 var AgnosticSdk_1 = require("./agnosticSdk/AgnosticSdk");
 Object.defineProperty(exports, "AgnosticProxySDK", { enumerable: true, get: function () { return AgnosticSdk_1.AgnosticProxySDK; } });

package/dist/src/interfaces/ContractOpener.d.ts

@@ -5,6 +5,7 @@ import { ILogger } from './ILogger';
 export interface ContractOpener {
     /**
      * Opens a contract for interaction using the underlying client (lite client, sandbox, etc.).
+     * Getter VM failures must throw ComputeError from @ton/ton; transport errors must propagate unchanged.
      * @param src Contract source instance to open.
      * @returns Opened contract ready for method calls and sending messages.
      */

package/dist/src/sender/BatchSender.js

@@ -78,7 +78,7 @@ class BatchSender {
             let validGroupFound = false;
             while (groupSize > 0) {
                 const group = messages.slice(left, left + groupSize);
-                const createdAt = Math.floor(Date.now() / 1000) - 40;
+                const createdAt = HighloadWalletV3_1.HighloadWalletV3.generateCreatedAt();
                 const queryId = this.wallet.getQueryIdFromCreatedAt(createdAt);
                 const externalMsg = this.wallet.getExternalMessage(group, ton_1.SendMode.PAY_GAS_SEPARATELY, 0n, queryId);
                 const isBocSizeValid = externalMsg.body.toBoc().length <= Consts_1.MAX_EXT_MSG_SIZE;
@@ -106,6 +106,7 @@ class BatchSender {
         if (createdAt <= this.lastCreatedAt) {
             createdAt = this.lastCreatedAt + 1; // to prevent error::already_executed on highload wallet
         }
+        createdAt = HighloadWalletV3_1.HighloadWalletV3.normalizeCreatedAt(createdAt);
         this.lastCreatedAt = createdAt;
         return walletContract.sendTransfer({
             secretKey: this.secretKey,

package/dist/src/structs/InternalStruct.d.ts

@@ -31,6 +31,11 @@ export declare enum AssetOpType {
     NFT_BURN = "NFT_BURN",
     NFT_TRANSFER = "NFT_TRANSFER"
 }
+export type DisplayMultiplier = {
+    hasDisplayMultiplier: boolean;
+    numerator: bigint;
+    denominator: bigint;
+};
 export type RandomNumberByTimestamp = {
     timestamp: number;
     randomNumber: number;

package/dist/src/wrappers/HighloadQueryId.d.ts

@@ -1,3 +1,5 @@
+export declare const HIGHLOAD_QUERY_ID_BIT_NUMBER_SIZE = 10n;
+export declare const HIGHLOAD_QUERY_ID_INVALID_BIT_NUMBER: bigint;
 export declare class HighloadQueryId {
     private shift;
     private bitnumber;