@tonappchain/sdk 0.7.3-rc8 → 0.8.0-aa-alpha-test

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,19 @@
+"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: '0x5b3242786e8E2F0A3068AFcE6ca90288acBf5e33',
+        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/RetryableContractOpener.js

@@ -146,7 +146,7 @@ class RetryableContractOpener {
             const openerLabel = `opener ${index + 1}/${this.openerConfigs.length}`;
             this.logger?.debug(`[RetryableContractOpener] ${operationName}: trying ${openerLabel}`);
             const result = useRetries
-                ? await this.tryWithRetries(() => operation(config), config, `${operationName} ${openerLabel}`)
+                ? await this.tryWithRetries(() => operation(config), config, `${operationName} ${openerLabel}`, shouldFallbackOnError)
                 : await this.trySingleAttempt(() => operation(config));
             if (result.success) {
                 return { success: true, data: result.data };
@@ -186,7 +186,7 @@ class RetryableContractOpener {
             return { success: false, lastError: error };
         }
     }
-    async tryWithRetries(operation, config, operationContext = 'operation') {
+    async tryWithRetries(operation, config, operationContext = 'operation', shouldRetryError) {
         let lastError;
         for (let attempt = 0; attempt <= config.retries; attempt++) {
             try {
@@ -198,6 +198,9 @@ class RetryableContractOpener {
                 if (lastError instanceof errors_1.TransactionError || this.isContractExecutionError(lastError)) {
                     return { success: false, lastError };
                 }
+                if (shouldRetryError && !shouldRetryError(lastError)) {
+                    return { success: false, lastError };
+                }
                 if (attempt < config.retries) {
                     const retryDelay = this.getRetryDelay(config, attempt);
                     this.logger?.debug(`[RetryableContractOpener] ${operationContext}: attempt ${attempt + 1}/${config.retries + 1} failed (${lastError.message}), retrying in ${retryDelay}ms`);

package/dist/src/adapters/ToncenterV3Indexer.js

@@ -11,7 +11,7 @@ const Utils_1 = require("../sdk/Utils");
  * traversing a linked chain of TON transactions until it finds the sequencer-collected event transaction on CCL.
  */
 class ToncenterV3Indexer {
-    constructor(endpoint, httpClient = new AxiosHttpClient_1.AxiosHttpClient()) {
+    constructor(endpoint, httpClient = new AxiosHttpClient_1.AxiosHttpClient({ timeout: Consts_1.DEFAULT_HTTP_CLIENT_TIMEOUT_MS })) {
         this.endpoint = endpoint;
         this.httpClient = httpClient;
     }

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

@@ -1,19 +1,19 @@
-import { Asset } from '../interfaces';
+import type { Asset, IConfiguration } from '../interfaces';
 type AssetCacheToken = {
     address: string;
     index?: bigint;
     tokenType?: string;
 };
 export declare class AssetCache {
-    private static readonly cache;
+    private static cache;
     /**
      * Get asset from cache
      */
-    static get(token: AssetCacheToken): Asset | undefined;
+    static get(configuration: IConfiguration, token: AssetCacheToken): Asset | undefined;
     /**
      * Set asset in cache
      */
-    static set(token: AssetCacheToken, asset: Asset): void;
+    static set(configuration: IConfiguration, token: AssetCacheToken, asset: Asset): void;
     /**
      * Clear the cache
      */

package/dist/src/assets/AssetCache.js

@@ -5,22 +5,27 @@ class AssetCache {
     /**
      * Get asset from cache
      */
-    static get(token) {
+    static get(configuration, token) {
         const key = this.generateKey(token);
-        return this.cache.get(key);
+        return this.cache.get(configuration)?.get(key);
     }
     /**
      * Set asset in cache
      */
-    static set(token, asset) {
+    static set(configuration, token, asset) {
         const key = this.generateKey(token);
-        this.cache.set(key, asset);
+        let scopedCache = this.cache.get(configuration);
+        if (!scopedCache) {
+            scopedCache = new Map();
+            this.cache.set(configuration, scopedCache);
+        }
+        scopedCache.set(key, asset);
     }
     /**
      * Clear the cache
      */
     static clear() {
-        this.cache.clear();
+        this.cache = new WeakMap();
     }
     static generateKey(token) {
         // Normalize address to lowercase for consistency
@@ -36,4 +41,4 @@ class AssetCache {
     }
 }
 exports.AssetCache = AssetCache;
-AssetCache.cache = new Map();
+AssetCache.cache = new WeakMap();

package/dist/src/assets/AssetFactory.js

@@ -18,14 +18,14 @@ class AssetFactory {
                 throw (0, errors_1.unknownTokenTypeError)(token.address, 'detected TON, but token type is not FT');
             return TON_1.TON.create(configuration);
         }
-        const cachedAsset = AssetCache_1.AssetCache.get(token);
+        const cachedAsset = AssetCache_1.AssetCache.get(configuration, token);
         if (cachedAsset) {
             return cachedAsset.clone.withRawAmount(0n);
         }
         const asset = token.tokenType === Struct_1.AssetType.FT
             ? await this.createFTAsset(configuration, token.address)
             : await this.createNFTAsset(configuration, token.address, token.addressType, token.addressType === Struct_1.NFTAddressType.COLLECTION ? token.index : undefined);
-        AssetCache_1.AssetCache.set(token, asset);
+        AssetCache_1.AssetCache.set(configuration, token, asset);
         return asset;
     }
     static async createFTAsset(configuration, address) {

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

@@ -1,2 +1,2 @@
 export { AddressError, BitError, ContractError, EVMCallError, FetchError, FormatError, KeyError, MetadataError, SettingError, TokenError, TransactionError, WalletError, } from './errors';
-export { allEndpointsFailedError, blockGasLimitFetchError, emptyArrayError, emptyContractError, emptySettingError, estimatedGasExceedsBlockGasLimitError, evmAddressError, executedInTONStageFailedError, externalInMessageRequiredError, gasPriceFetchError, indexRequiredError, insufficientBalanceError, insufficientFeeParamsError, invalidMethodNameError, invalidTonExternalMessageBocError, missingDecimals, missingFeeParamsError, missingGasLimitError, missingJettonDataError, missingTvmExecutorFeeError, notMultiplyOf8Error, operationFetchError, operationIdRequiredForFinalizationError, prefixError, profilingFetchError, simulationFetchError, statusFetchError, tonIndexerRequiredForTonTransactionBocError, tvmAddressError, txFinalizationError, unknownTokenTypeError, unknownWalletError, unsupportedFormatError, unsupportedKeyError, zeroRawAmountError, } from './instances';
+export { allEndpointsFailedError, blockGasLimitFetchError, emptyArrayError, emptyContractError, emptySettingError, estimatedGasExceedsBlockGasLimitError, evmAddressError, executedInTONStageFailedError, externalInMessageRequiredError, gasPriceFetchError, indexRequiredError, insufficientBalanceError, insufficientFeeParamsError, invalidAmountError, invalidMethodNameError, invalidTonExternalMessageBocError, missingDecimals, missingFeeParamsError, missingGasLimitError, missingJettonDataError, missingTvmExecutorFeeError, notMultiplyOf8Error, operationFetchError, operationIdRequiredForFinalizationError, prefixError, profilingFetchError, simulationFetchError, statusFetchError, tonIndexerRequiredForTonTransactionBocError, tvmAddressError, txFinalizationError, unknownTokenTypeError, unknownWalletError, unsupportedFormatError, unsupportedKeyError, zeroRawAmountError, } from './instances';

package/dist/src/errors/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zeroRawAmountError = exports.unsupportedKeyError = exports.unsupportedFormatError = exports.unknownWalletError = exports.unknownTokenTypeError = exports.txFinalizationError = exports.tvmAddressError = exports.tonIndexerRequiredForTonTransactionBocError = exports.statusFetchError = exports.simulationFetchError = exports.profilingFetchError = exports.prefixError = exports.operationIdRequiredForFinalizationError = exports.operationFetchError = exports.notMultiplyOf8Error = exports.missingTvmExecutorFeeError = exports.missingJettonDataError = exports.missingGasLimitError = exports.missingFeeParamsError = exports.missingDecimals = exports.invalidTonExternalMessageBocError = exports.invalidMethodNameError = exports.insufficientFeeParamsError = exports.insufficientBalanceError = exports.indexRequiredError = exports.gasPriceFetchError = exports.externalInMessageRequiredError = exports.executedInTONStageFailedError = exports.evmAddressError = exports.estimatedGasExceedsBlockGasLimitError = exports.emptySettingError = exports.emptyContractError = exports.emptyArrayError = exports.blockGasLimitFetchError = exports.allEndpointsFailedError = exports.WalletError = exports.TransactionError = exports.TokenError = exports.SettingError = exports.MetadataError = exports.KeyError = exports.FormatError = exports.FetchError = exports.EVMCallError = exports.ContractError = exports.BitError = exports.AddressError = void 0;
+exports.zeroRawAmountError = exports.unsupportedKeyError = exports.unsupportedFormatError = exports.unknownWalletError = exports.unknownTokenTypeError = exports.txFinalizationError = exports.tvmAddressError = exports.tonIndexerRequiredForTonTransactionBocError = exports.statusFetchError = exports.simulationFetchError = exports.profilingFetchError = exports.prefixError = exports.operationIdRequiredForFinalizationError = exports.operationFetchError = exports.notMultiplyOf8Error = exports.missingTvmExecutorFeeError = exports.missingJettonDataError = exports.missingGasLimitError = exports.missingFeeParamsError = exports.missingDecimals = exports.invalidTonExternalMessageBocError = exports.invalidMethodNameError = exports.invalidAmountError = exports.insufficientFeeParamsError = exports.insufficientBalanceError = exports.indexRequiredError = exports.gasPriceFetchError = exports.externalInMessageRequiredError = exports.executedInTONStageFailedError = exports.evmAddressError = exports.estimatedGasExceedsBlockGasLimitError = exports.emptySettingError = exports.emptyContractError = exports.emptyArrayError = exports.blockGasLimitFetchError = exports.allEndpointsFailedError = exports.WalletError = exports.TransactionError = exports.TokenError = exports.SettingError = exports.MetadataError = exports.KeyError = exports.FormatError = exports.FetchError = exports.EVMCallError = exports.ContractError = exports.BitError = exports.AddressError = void 0;
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "AddressError", { enumerable: true, get: function () { return errors_1.AddressError; } });
 Object.defineProperty(exports, "BitError", { enumerable: true, get: function () { return errors_1.BitError; } });
@@ -28,6 +28,7 @@ Object.defineProperty(exports, "gasPriceFetchError", { enumerable: true, get: fu
 Object.defineProperty(exports, "indexRequiredError", { enumerable: true, get: function () { return instances_1.indexRequiredError; } });
 Object.defineProperty(exports, "insufficientBalanceError", { enumerable: true, get: function () { return instances_1.insufficientBalanceError; } });
 Object.defineProperty(exports, "insufficientFeeParamsError", { enumerable: true, get: function () { return instances_1.insufficientFeeParamsError; } });
+Object.defineProperty(exports, "invalidAmountError", { enumerable: true, get: function () { return instances_1.invalidAmountError; } });
 Object.defineProperty(exports, "invalidMethodNameError", { enumerable: true, get: function () { return instances_1.invalidMethodNameError; } });
 Object.defineProperty(exports, "invalidTonExternalMessageBocError", { enumerable: true, get: function () { return instances_1.invalidTonExternalMessageBocError; } });
 Object.defineProperty(exports, "missingDecimals", { enumerable: true, get: function () { return instances_1.missingDecimals; } });

package/dist/src/errors/instances.d.ts

@@ -44,3 +44,4 @@ export declare const estimatedGasExceedsBlockGasLimitError: (txName: string, est
 export declare const invalidTonExternalMessageBocError: (reason?: string) => FormatError;
 export declare const externalInMessageRequiredError: (actualType: string) => FormatError;
 export declare const tonIndexerRequiredForTonTransactionBocError: SettingError;
+export declare const invalidAmountError: (reason: string) => FormatError;

package/dist/src/errors/instances.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.tonIndexerRequiredForTonTransactionBocError = exports.externalInMessageRequiredError = exports.invalidTonExternalMessageBocError = exports.estimatedGasExceedsBlockGasLimitError = exports.blockGasLimitFetchError = exports.executedInTONStageFailedError = exports.operationIdRequiredForFinalizationError = exports.insufficientFeeParamsError = exports.txFinalizationError = exports.gasPriceFetchError = exports.unknownAssetOriginError = exports.convertCurrencyNegativeOrZeroValueError = exports.sendCrossChainTransactionFailedError = exports.zeroRawAmountError = exports.missingJettonDataError = exports.missingDecimals = exports.missingGasLimitError = exports.missingTvmExecutorFeeError = exports.missingFeeParamsError = exports.getTONFeeInfoFetchError = exports.simulationFetchError = exports.convertCurrencyFetchError = exports.indexRequiredError = exports.unknownTokenTypeError = exports.insufficientBalanceError = exports.allContractOpenerFailedError = exports.allEndpointsFailedError = exports.noValidGroupFoundError = exports.prepareMessageGroupError = exports.invalidAssetType = exports.emptyArrayError = exports.profilingFetchError = exports.invalidMethodNameError = exports.emptySettingError = exports.prefixError = exports.notMultiplyOf8Error = exports.unsupportedFormatError = exports.unsupportedKeyError = exports.unknownWalletError = exports.evmAddressError = exports.tvmAddressError = exports.statusFetchError = exports.operationFetchError = exports.emptyContractError = void 0;
+exports.invalidAmountError = exports.tonIndexerRequiredForTonTransactionBocError = exports.externalInMessageRequiredError = exports.invalidTonExternalMessageBocError = exports.estimatedGasExceedsBlockGasLimitError = exports.blockGasLimitFetchError = exports.executedInTONStageFailedError = exports.operationIdRequiredForFinalizationError = exports.insufficientFeeParamsError = exports.txFinalizationError = exports.gasPriceFetchError = exports.unknownAssetOriginError = exports.convertCurrencyNegativeOrZeroValueError = exports.sendCrossChainTransactionFailedError = exports.zeroRawAmountError = exports.missingJettonDataError = exports.missingDecimals = exports.missingGasLimitError = exports.missingTvmExecutorFeeError = exports.missingFeeParamsError = exports.getTONFeeInfoFetchError = exports.simulationFetchError = exports.convertCurrencyFetchError = exports.indexRequiredError = exports.unknownTokenTypeError = exports.insufficientBalanceError = exports.allContractOpenerFailedError = exports.allEndpointsFailedError = exports.noValidGroupFoundError = exports.prepareMessageGroupError = exports.invalidAssetType = exports.emptyArrayError = exports.profilingFetchError = exports.invalidMethodNameError = exports.emptySettingError = exports.prefixError = exports.notMultiplyOf8Error = exports.unsupportedFormatError = exports.unsupportedKeyError = exports.unknownWalletError = exports.evmAddressError = exports.tvmAddressError = exports.statusFetchError = exports.operationFetchError = exports.emptyContractError = void 0;
 const errors_1 = require("./errors");
 exports.emptyContractError = new errors_1.ContractError('unexpected empty contract code of given jetton.', 100);
 const operationFetchError = (msg, inner) => new errors_1.FetchError(`failed to fetch OperationId: ${msg}`, 101, inner);
@@ -132,3 +132,5 @@ exports.invalidTonExternalMessageBocError = invalidTonExternalMessageBocError;
 const externalInMessageRequiredError = (actualType) => new errors_1.FormatError(`Expected external-in TON message, got ${actualType}`, 142);
 exports.externalInMessageRequiredError = externalInMessageRequiredError;
 exports.tonIndexerRequiredForTonTransactionBocError = new errors_1.SettingError('TON indexer is required to resolve operation ID by TON transaction BOC', 143);
+const invalidAmountError = (reason) => new errors_1.FormatError(`Invalid amount: ${reason}`, 144);
+exports.invalidAmountError = invalidAmountError;

package/dist/src/index.d.ts

@@ -1,9 +1,11 @@
+export * from './accountAbstraction';
 export * from './adapters';
 export { AgnosticProxySDK } from './agnosticSdk/AgnosticSdk';
 export * as AgnosticStructs from './agnosticSdk/AgnosticStructs';
 export * from './assets';
 export * from './errors';
 export * from './interfaces';
+export { getArtifacts } from './sdk/Artifacts';
 export { AxiosHttpClient } from './sdk/AxiosHttpClient';
 export { Configuration } from './sdk/Configuration';
 export { LiteSequencerClient } from './sdk/LiteSequencerClient';

package/dist/src/index.js

@@ -36,7 +36,8 @@ 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.AgnosticStructs = exports.AgnosticProxySDK = void 0;
+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; } });
@@ -44,6 +45,8 @@ exports.AgnosticStructs = __importStar(require("./agnosticSdk/AgnosticStructs"))
 __exportStar(require("./assets"), exports);
 __exportStar(require("./errors"), exports);
 __exportStar(require("./interfaces"), exports);
+var Artifacts_1 = require("./sdk/Artifacts");
+Object.defineProperty(exports, "getArtifacts", { enumerable: true, get: function () { return Artifacts_1.getArtifacts; } });
 var AxiosHttpClient_1 = require("./sdk/AxiosHttpClient");
 Object.defineProperty(exports, "AxiosHttpClient", { enumerable: true, get: function () { return AxiosHttpClient_1.AxiosHttpClient; } });
 var Configuration_1 = require("./sdk/Configuration");

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

@@ -1,11 +1,11 @@
-import { dev, mainnet, testnet } from '../../artifacts';
+import type { NetworkArtifacts } from '../../artifacts';
 import { InternalTACParams, InternalTONParams } from '../structs/InternalStruct';
 import { Network } from '../structs/Struct';
 export interface IConfiguration {
     /** Current network the SDK is configured for (e.g., MAINNET/TESTNET). */
     readonly network: Network;
     /** Resolved artifacts bundle for the selected network (contract ABIs/addresses). */
-    readonly artifacts: typeof testnet | typeof mainnet | typeof dev;
+    readonly artifacts: NetworkArtifacts;
     /** Low-level TON client parameters and dependencies. */
     readonly TONParams: InternalTONParams;
     /** Low-level TAC (EVM-side) client parameters and dependencies. */

package/dist/src/sdk/Artifacts.d.ts

@@ -0,0 +1,3 @@
+import type { NetworkArtifacts } from '../../artifacts';
+import { Network } from '../structs/Struct';
+export declare function getArtifacts(network: Network): NetworkArtifacts;

package/dist/src/sdk/Artifacts.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getArtifacts = getArtifacts;
+const artifacts_1 = require("../../artifacts");
+const Struct_1 = require("../structs/Struct");
+function getArtifacts(network) {
+    switch (network) {
+        case Struct_1.Network.MAINNET:
+            return artifacts_1.mainnet;
+        case Struct_1.Network.TESTNET:
+            return artifacts_1.testnet;
+        case Struct_1.Network.DEV:
+            return artifacts_1.dev;
+        default:
+            throw new Error(`Unsupported network: ${network}`);
+    }
+}

package/dist/src/sdk/Configuration.d.ts

@@ -1,16 +1,16 @@
-import { dev, mainnet, testnet } from '../../artifacts';
+import type { NetworkArtifacts } from '../../artifacts';
 import { IConfiguration, ILogger } from '../interfaces';
 import { InternalTACParams, InternalTONParams } from '../structs/InternalStruct';
 import { Network, TACParams, TONParams } from '../structs/Struct';
 export declare class Configuration implements IConfiguration {
     readonly network: Network;
-    readonly artifacts: typeof testnet | typeof mainnet | typeof dev;
+    readonly artifacts: NetworkArtifacts;
     readonly TONParams: InternalTONParams;
     readonly TACParams: InternalTACParams;
     readonly liteSequencerEndpoints: string[];
     readonly logger: ILogger;
-    constructor(network: Network, artifacts: typeof testnet | typeof mainnet | typeof dev, TONParams: InternalTONParams, TACParams: InternalTACParams, liteSequencerEndpoints: string[], logger: ILogger);
-    static create(network: Network, artifacts: typeof testnet | typeof mainnet | typeof dev, TONParams?: TONParams, TACParams?: TACParams, customLiteSequencerEndpoints?: string[], delay?: number, logger?: ILogger, passLoggerToOpeners?: boolean): Promise<Configuration>;
+    constructor(network: Network, artifacts: NetworkArtifacts, TONParams: InternalTONParams, TACParams: InternalTACParams, liteSequencerEndpoints: string[], logger: ILogger);
+    static create(network: Network, artifacts: NetworkArtifacts, TONParams?: TONParams, TACParams?: TACParams, customLiteSequencerEndpoints?: string[], delay?: number, logger?: ILogger, passLoggerToOpeners?: boolean): Promise<Configuration>;
     private static prepareTONParams;
     private static prepareTACParams;
     private static loadTACSettingsViaMulticall;