gen-typescript-from-tolk-dev 0.3.2 → 0.3.4

package/dist/codegen-ctx.js

@@ -37,8 +37,8 @@ exports.RUNTIME = {
 // Same for other public properties, they are modified while iterating through declarations.
 class CodegenCtx {
     constructor(abi) {
-        this.intNOccurred = new Set(['int8', 'int16', 'int32', 'int256']);
-        this.uintNOccurred = new Set(['uint8', 'uint16', 'uint32', 'uint256']);
+        this.intNOccurred = new Set();
+        this.uintNOccurred = new Set();
         this.varIntNOccurred = new Set();
         this.bitsNOccurred = new Set();
         this.has_RemainingBitsAndRefs = false;

package/dist/out-template.generated.d.ts

@@ -1 +1 @@
-export declare const OUT_TEMPLATE = "// AUTO-GENERATED, do not edit\n// it's a TypeScript wrapper for a CONTRACT_CLASS_NAME contract in Tolk\n/* eslint-disable */\n\nimport * as c from '@ton/core';\nimport { beginCell, ContractProvider, Sender, SendMode } from '@ton/core';\n\n// \u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\n//   predefined types and functions\n//\n\n// {{if:has_remaining}}\ntype RemainingBitsAndRefs = c.Slice\n// {{/if:has_remaining}}\n\n// {{if:has_addressAny}}\nexport type any_address = c.Address | c.ExternalAddress | 'none'\n// {{/if:has_addressAny}}\n\n// {{if:has_arrayOf}}\ntype array<T> = T[]\n// {{/if:has_arrayOf}}\n\n// {{if:has_lispListOf}}\n// TypeScript wrappers flatten a TVM linked list `[1 [2 [3 null]]]` to `[1 2 3]`\ntype lisp_list<T> = T[]\n// {{/if:has_lispListOf}}\n\ntype StoreCallback<T> = (obj: T, b: c.Builder) => void\ntype LoadCallback<T> = (s: c.Slice) => T\n\nexport type CellRef<T> = {\n    ref: T\n}\n\nfunction makeCellFrom<T>(self: T, storeFn_T: StoreCallback<T>): c.Cell {\n    let b = beginCell();\n    storeFn_T(self, b);\n    return b.endCell();\n}\n\nfunction loadAndCheckPrefix32(s: c.Slice, expected: number, structName: string): void {\n    let prefix = s.loadUint(32);\n    if (prefix !== expected) {\n        throw new Error(`Incorrect prefix for '${structName}': expected 0x${expected.toString(16).padStart(8, '0')}, got 0x${prefix.toString(16).padStart(8, '0')}`);\n    }\n}\n\n// {{if:has_non32Prefixes}}\nfunction formatPrefix(prefixNum: number, prefixLen: number): string {\n    return prefixLen % 4 ? `0b${prefixNum.toString(2).padStart(prefixLen, '0')}` : `0x${prefixNum.toString(16).padStart(prefixLen / 4, '0')}`;\n}\n\nfunction loadAndCheckPrefix(s: c.Slice, expected: number, prefixLen: number, structName: string): void {\n    let prefix = s.loadUint(prefixLen);\n    if (prefix !== expected) {\n        throw new Error(`Incorrect prefix for '${structName}': expected ${formatPrefix(expected, prefixLen)}, got ${formatPrefix(prefix, prefixLen)}`);\n    }\n}\n// {{/if:has_non32Prefixes}}\n\nfunction lookupPrefix(s: c.Slice, expected: number, prefixLen: number): boolean {\n    return s.remainingBits >= prefixLen && s.preloadUint(prefixLen) === expected;\n}\n\n// {{if:has_implicitUnionPrefix}}\nfunction lookupPrefixAndEat(s: c.Slice, expected: number, prefixLen: number): boolean {\n    if (lookupPrefix(s, expected, prefixLen)) {\n        s.skip(prefixLen);\n        return true;\n    }\n    return false;\n}\n// {{/if:has_implicitUnionPrefix}}\n\nfunction throwNonePrefixMatch(fieldPath: string): never {\n    throw new Error(`Incorrect prefix for '${fieldPath}': none of variants matched`);\n}\n\nfunction storeCellRef<T>(cell: CellRef<T>, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    let b_ref = c.beginCell();\n    storeFn_T(cell.ref, b_ref);\n    b.storeRef(b_ref.endCell());\n}\n\nfunction loadCellRef<T>(s: c.Slice, loadFn_T: LoadCallback<T>): CellRef<T> {\n    let s_ref = s.loadRef().beginParse();\n    return { ref: loadFn_T(s_ref) };\n}\n\n// {{if:has_addressAny}}\nfunction storeTolkAddressAny(a: any_address, b: c.Builder): void {\n    let maybe_addr = a === 'none' ? null : a;\n    b.storeAddress(maybe_addr);\n}\n\nfunction loadTolkAddressAny(s: c.Slice): any_address {\n    let maybe_addr = s.loadAddressAny();\n    return maybe_addr === null ? 'none' : maybe_addr;\n}\n// {{/if:has_addressAny}}\n\n// {{if:has_bitsN}}\nfunction storeTolkBitsN(v: c.Slice, nBits: number, b: c.Builder): void {\n    if (v.remainingBits !== nBits) { throw new Error(`expected ${nBits} bits, got ${v.remainingBits}`); }\n    if (v.remainingRefs !== 0) { throw new Error(`expected 0 refs, got ${v.remainingRefs}`); }\n    b.storeSlice(v);\n}\n\nfunction loadTolkBitsN(s: c.Slice, nBits: number): c.Slice {\n    return new c.Slice(new c.BitReader(s.loadBits(nBits)), []);\n}\n// {{/if:has_bitsN}}\n\n// {{if:has_remaining}}\nfunction storeTolkRemaining(v: RemainingBitsAndRefs, b: c.Builder): void {\n    b.storeSlice(v);\n}\n\nfunction loadTolkRemaining(s: c.Slice): RemainingBitsAndRefs {\n    let rest = s.clone();\n    s.loadBits(s.remainingBits);\n    while (s.remainingRefs) {\n        s.loadRef();\n    }\n    return rest;\n}\n// {{/if:has_remaining}}\n\nfunction storeTolkNullable<T>(v: T | null, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    if (v === null) {\n        b.storeUint(0, 1);\n    } else {\n        b.storeUint(1, 1);\n        storeFn_T(v, b);\n    }\n}\n\n// {{if:has_arrayOf}}\nfunction storeArrayOf<T>(v: array<T>, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    // the compiler stores array<T> in chunks; in TypeScript, for simplicity, store \"1 elem = 1 ref\"\n    let tail = null as c.Cell | null;\n    for (let i = 0; i < v.length; ++i) {\n        let chunkB = beginCell().storeMaybeRef(tail);\n        storeFn_T(v[v.length - 1 - i], chunkB);\n        tail = chunkB.endCell();\n    }\n    b.storeUint(v.length, 8);\n    b.storeMaybeRef(tail);\n}\n\nfunction loadArrayOf<T>(s: c.Slice, loadFn_T: LoadCallback<T>): array<T> {\n    let len = s.loadUint(8);\n    let head = s.loadMaybeRef();\n    let outArr = [] as array<T>;\n    while (head != null) {\n        let s = head.beginParse();\n        head = s.loadMaybeRef();\n        while (s.remainingBits || s.remainingRefs) {\n            outArr.push(loadFn_T(s));\n        }\n    }\n    if (len !== outArr.length) {\n        throw new Error(`mismatch array binary data: expected ${len} elements, got ${outArr.length}`);\n    }\n    return outArr;\n}\n// {{/if:has_arrayOf}}\n\n// {{if:has_lispListOf}}\nfunction storeLispListOf<T>(v: lisp_list<T>, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    let tail = c.Cell.EMPTY;\n    for (let i = 0; i < v.length; ++i) {\n        let itemB = beginCell();\n        storeFn_T(v[i], itemB);\n        tail = itemB.storeRef(tail).endCell();\n    }\n    b.storeRef(tail);\n}\n\nfunction loadLispListOf<T>(s: c.Slice, loadFn_T: LoadCallback<T>): lisp_list<T> {\n    let outArr = [] as lisp_list<T>;\n    let head = s.loadRef().beginParse();\n    while (head.remainingRefs) {\n        let tailSnaked = head.loadRef();\n        let headValue = loadFn_T(head);\n        head.endParse();    // ensure no data is present besides T\n        outArr.unshift(headValue);\n        head = tailSnaked.beginParse();\n    }\n    return outArr;\n}\n// {{/if:has_lispListOf}}\n\n// {{if:has_customDictV}}\nfunction createDictionaryValue<V>(loadFn_V: LoadCallback<V>, storeFn_V: StoreCallback<V>): c.DictionaryValue<V> {\n    return {\n        serialize(self: V, b: c.Builder) {\n            storeFn_V(self, b);\n        },\n        parse(s: c.Slice): V {\n            const value = loadFn_V(s);\n            s.endParse();\n            return value;\n        }\n    }\n}\n// {{/if:has_customDictV}}\n\n// \u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\n//   parse get methods result from a TVM stack\n//\n\nclass StackReader {\n    constructor(private tuple: c.TupleItem[]) {\n    }\n\n    static fromGetMethod(expectedN: number, getMethodResult: { stack: c.TupleReader }): StackReader {\n        let tuple = [] as c.TupleItem[];\n        while (getMethodResult.stack.remaining) {\n            tuple.push(getMethodResult.stack.pop());\n        }\n        if (tuple.length !== expectedN) {\n            throw new Error(`expected ${expectedN} stack width, got ${tuple.length}`);\n        }\n        return new StackReader(tuple);\n    }\n\n    private popExpecting<ItemT>(itemType: string): ItemT {\n        const item = this.tuple.shift();\n        if (item?.type === itemType) {\n            return item as ItemT;\n        }\n        throw new Error(`not '${itemType}' on a stack`);\n    }\n\n    private popCellLike(): c.Cell {\n        const item = this.tuple.shift();\n        if (item && (item.type === 'cell' || item.type === 'slice' || item.type === 'builder')) {\n            return item.cell;\n        }\n        throw new Error(`not cell/slice on a stack`);\n    }\n\n    readBigInt(): bigint {\n        return this.popExpecting<c.TupleItemInt>('int').value;\n    }\n\n    readBoolean(): boolean {\n        return this.popExpecting<c.TupleItemInt>('int').value !== 0n;\n    }\n\n    readCell(): c.Cell {\n        return this.popCellLike();\n    }\n\n    readSlice(): c.Slice {\n        return this.popCellLike().beginParse();\n    }\n\n    // {{if:stackReadsBuilder}}\n    readBuilder(): c.Builder {\n        return beginCell().storeSlice(this.popCellLike().beginParse());\n    }\n    // {{/if:stackReadsBuilder}}\n\n    // {{if:stackReadsUnknown}}\n    readUnknown(): c.TupleItem {\n        // `unknown` from Tolk is left as a raw tuple item\n        return this.tuple.shift()!;\n    }\n    // {{/if:stackReadsUnknown}}\n\n    // {{if:stackReadsArrayOf}}\n    readArrayOf<T>(readFn_T: (nestedReader: StackReader) => T): T[] {\n        const subItems = this.popExpecting<c.Tuple>('tuple').items;\n        const subReader = new StackReader(subItems);\n        // array len N => N subItems => N calls to readFn_T\n        return [...subItems].map(_ => readFn_T(subReader));\n    }\n    // {{/if:stackReadsArrayOf}}\n\n    // {{if:stackReadsLispListOf}}\n    readLispListOf<T>(readFn_T: (nestedReader: StackReader) => T): T[] {\n        // read `[1 [2 [3 null]]]` to `[1 2 3]`\n        let pairReader: StackReader = this;\n        let outArr = [] as T[];\n        while (true) {\n            if (pairReader.tuple[0].type === 'null') {\n                pairReader.tuple.shift();\n                break;\n            }\n            let headAndTail = pairReader.popExpecting<c.Tuple>('tuple').items;\n            if (headAndTail.length !== 2) {\n                throw new Error(`malformed lisp_list, expected 2 stack width, got ${headAndTail.length}`);\n            }\n            pairReader = new StackReader(headAndTail);\n            outArr.push(readFn_T(pairReader));\n        }\n        return outArr;\n    }\n    // {{/if:stackReadsLispListOf}}\n\n    // {{if:stackReadsSnakeString}}\n    readSnakeString(): string {\n        return this.readCell().beginParse().loadStringTail();\n    }\n    // {{/if:stackReadsSnakeString}}\n\n    // {{if:stackReadsTuple}}\n    readTuple<T>(expectedN: number, readFn_T: (nestedReader: StackReader) => T): T {\n        const subItems = this.popExpecting<c.Tuple>('tuple').items;\n        if (subItems.length !== expectedN) {\n            throw new Error(`expected ${expectedN} items in a tuple, got ${subItems.length}`);\n        }\n        return readFn_T(new StackReader(subItems));\n    }\n    // {{/if:stackReadsTuple}}\n\n    // {{if:stackReadsNullLiteral}}\n    readNullLiteral(): null {\n        this.popExpecting<c.TupleItemNull>('null');\n        return null;\n    }\n    // {{/if:stackReadsNullLiteral}}\n\n    // {{if:stackReadsNullable}}\n    readNullable<T>(readFn_T: (r: StackReader) => T): T | null {\n        if (this.tuple[0].type === 'null') {\n            this.tuple.shift();\n            return null;\n        }\n        return readFn_T(this);\n    }\n    // {{/if:stackReadsNullable}}\n\n    // {{if:stackReadsWideNullable}}\n    readWideNullable<T>(stackW: number, readFn_T: (r: StackReader) => T): T | null {\n        const slotTypeId = this.tuple[stackW - 1];\n        if (slotTypeId?.type !== 'int') {\n            throw new Error(`not 'int' on a stack`);\n        }\n        if (slotTypeId.value === 0n) {\n            this.tuple = this.tuple.slice(stackW);\n            return null;\n        }\n        const valueT = readFn_T(this);\n        this.tuple.shift();\n        return valueT;\n    }\n    // {{/if:stackReadsWideNullable}}\n\n    // {{if:stackReadsUnionType}}\n    readUnionType<T>(stackW: number, infoForTypeId: Record<number, [number, string | null, (r: StackReader) => any]>): T {\n        const slotTypeId = this.tuple[stackW - 1];\n        if (slotTypeId?.type !== 'int') {\n            throw new Error(`not 'int' on a stack`);\n        }\n        const info = infoForTypeId[Number(slotTypeId.value)];   // [stackWidth, label, readFn_T{i}]\n        if (info == null) {\n            throw new Error(`unexpected UTag=${slotTypeId.value}`);\n        }\n        const label = info[1];\n        this.tuple = this.tuple.slice(stackW - 1 - info[0]);\n        const valueT = info[2](this);\n        this.tuple.shift();\n        return label == null ? valueT : { $: label, value: valueT } as T;\n    }\n    // {{/if:stackReadsUnionType}}\n\n    // {{if:stackReadsCellRef}}\n    readCellRef<T>(loadFn_T: LoadCallback<T>): CellRef<T> {\n        return { ref: loadFn_T(this.readCell().beginParse()) };\n    }\n    // {{/if:stackReadsCellRef}}\n\n    // {{if:stackReadsMapKV}}\n    readDictionary<K extends c.DictionaryKeyTypes, V>(keySerializer: c.DictionaryKey<K>, valueSerializer: c.DictionaryValue<V>): c.Dictionary<K, V> {\n        if (this.tuple[0].type === 'null') {\n            this.tuple.shift();\n            return c.Dictionary.empty<K, V>(keySerializer, valueSerializer);\n        }\n        return c.Dictionary.loadDirect<K, V>(keySerializer, valueSerializer, this.readCell());\n    }\n    // {{/if:stackReadsMapKV}}\n}\n\n// {{if:has_customPackUnpack}}\n// \u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\n//   custom packToBuilder and unpackFromSlice\n//\n\ntype CustomPackToBuilderFn<T> = (self: T, b: c.Builder) => void\ntype CustomUnpackFromSliceFn<T> = (s: c.Slice) => T\n\nlet customSerializersRegistry: Map<string, [CustomPackToBuilderFn<any> | null, CustomUnpackFromSliceFn<any> | null]> = new Map;\n\nfunction ensureCustomSerializerRegistered(typeName: string) {\n    if (!customSerializersRegistry.has(typeName)) {\n        throw new Error(`Custom packToBuilder/unpackFromSlice was not registered for type 'CONTRACT_CLASS_NAME.${typeName}'.\\n(in Tolk code, they have custom logic \\`fun ${typeName}__packToBuilder\\`)\\nSteps to fix:\\n1) in your code, create and implement\\n > function ${typeName}__packToBuilder(self: ${typeName}, b: Builder): void { ... }\\n > function ${typeName}__unpackFromSlice(s: Slice): ${typeName} { ... }\\n2) register them in advance by calling\\n > CONTRACT_CLASS_NAME.registerCustomPackUnpack('${typeName}', ${typeName}__packToBuilder, ${typeName}__unpackFromSlice);`);\n    }\n}\n\nfunction invokeCustomPackToBuilder<T>(typeName: string, self: T, b: c.Builder) {\n    ensureCustomSerializerRegistered(typeName);\n    customSerializersRegistry.get(typeName)![0]!(self, b);\n}\n\nfunction invokeCustomUnpackFromSlice<T>(typeName: string, s: c.Slice): T {\n    ensureCustomSerializerRegistered(typeName);\n    return customSerializersRegistry.get(typeName)![1]!(s);\n}\n// {{/if:has_customPackUnpack}}\n\n// \u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\n//   auto-generated serializers to/from cells\n//\n\ntype coins = bigint\n\n// {{intNAliases}}\n\n// {{uintNAliases}}\n\n// {{if:has_varIntN}}\n// {{varIntNAliases}}\n// {{/if:has_varIntN}}\n\n// {{if:has_bitsN}}\n// {{sliceAliases}}\n// {{/if:has_bitsN}}\n\n// {{packUnpackSerializers}}\n\n// \u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\n//    class CONTRACT_CLASS_NAME\n//\n\ninterface ExtraSendOptions {\n    bounce?: boolean                    // default: false\n    sendMode?: SendMode                 // default: SendMode.PAY_GAS_SEPARATELY\n    extraCurrencies?: c.ExtraCurrency   // default: empty dict\n}\n\ninterface DeployedAddrOptions {\n    workchain?: number                  // default: 0 (basechain)\n    toShard?: { fixedPrefixLength: number; closeTo: c.Address }\n    overrideContractCode?: c.Cell\n}\n\nfunction calculateDeployedAddress(code: c.Cell, data: c.Cell, options: DeployedAddrOptions): c.Address {\n    const stateInitCell = beginCell().store(c.storeStateInit({\n        code,\n        data,\n        splitDepth: options.toShard?.fixedPrefixLength,\n        special: null,\n        libraries: null,\n    })).endCell();\n\n    let addrHash = stateInitCell.hash();\n    if (options.toShard) {\n        const shardDepth = options.toShard.fixedPrefixLength;\n        addrHash = beginCell()\n            .storeBits(new c.BitString(options.toShard.closeTo.hash, 0, shardDepth))\n            .storeBits(new c.BitString(stateInitCell.hash(), shardDepth, 256 - shardDepth))\n            .endCell()\n            .beginParse().loadBuffer(32);\n    }\n\n    return new c.Address(options.workchain ?? 0, addrHash);\n}\n\nexport class CONTRACT_CLASS_NAME implements c.Contract {\n    static CodeCell = c.Cell.fromBase64('{{codeBoc64}}');\n\n    static Errors = {\n        // {{errorCodes}}\n    }\n\n    readonly address: c.Address\n    readonly init?: { code: c.Cell, data: c.Cell }\n\n    private constructor(address: c.Address, init?: { code: c.Cell, data: c.Cell }) {\n        this.address = address;\n        this.init = init;\n    }\n\n    // {{if:has_customPackUnpack}}\n    static registerCustomPackUnpack<T>(\n        typeName: string,\n        packToBuilderFn: CustomPackToBuilderFn<T> | null,\n        unpackFromSliceFn: CustomUnpackFromSliceFn<T> | null,\n    ) {\n        if (customSerializersRegistry.has(typeName)) {\n            throw new Error(`Custom pack/unpack for 'CONTRACT_CLASS_NAME.${typeName}' already registered`);\n        }\n        customSerializersRegistry.set(typeName, [packToBuilderFn, unpackFromSliceFn]);\n    }\n    // {{/if:has_customPackUnpack}}\n\n    static fromAddress(address: c.Address) {\n        return new CONTRACT_CLASS_NAME(address);\n    }\n\n    // {{fromStorageMethod}}\n\n    // {{createCellsMethods}}\n\n    // {{if:has_sendDeploy}}\n    async sendDeploy(provider: ContractProvider, via: Sender, msgValue: coins, extraOptions?: ExtraSendOptions) {\n        return provider.internal(via, {\n            value: msgValue,\n            body: c.Cell.EMPTY,\n            ...extraOptions\n        });\n    }\n    // {{/if:has_sendDeploy}}\n\n    // {{sendMethods}}\n\n    // {{getMethods}}\n}\n";
+export declare const OUT_TEMPLATE = "// AUTO-GENERATED, do not edit\n// It's a TypeScript wrapper for a CONTRACT_CLASS_NAME contract in Tolk.\n/* eslint-disable */\n\nimport * as c from '@ton/core';\nimport { beginCell, ContractProvider, Sender, SendMode } from '@ton/core';\n\n// \u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\n//   predefined types and functions\n//\n\n// {{if:has_remaining}}\ntype RemainingBitsAndRefs = c.Slice\n// {{/if:has_remaining}}\n\n// {{if:has_addressAny}}\nexport type any_address = c.Address | c.ExternalAddress | 'none'\n// {{/if:has_addressAny}}\n\n// {{if:has_arrayOf}}\ntype array<T> = T[]\n// {{/if:has_arrayOf}}\n\n// {{if:has_lispListOf}}\n// TypeScript wrappers flatten a TVM linked list `[1 [2 [3 null]]]` to `[1 2 3]`\ntype lisp_list<T> = T[]\n// {{/if:has_lispListOf}}\n\ntype StoreCallback<T> = (obj: T, b: c.Builder) => void\ntype LoadCallback<T> = (s: c.Slice) => T\n\nexport type CellRef<T> = {\n    ref: T\n}\n\nfunction makeCellFrom<T>(self: T, storeFn_T: StoreCallback<T>): c.Cell {\n    let b = beginCell();\n    storeFn_T(self, b);\n    return b.endCell();\n}\n\nfunction loadAndCheckPrefix32(s: c.Slice, expected: number, structName: string): void {\n    let prefix = s.loadUint(32);\n    if (prefix !== expected) {\n        throw new Error(`Incorrect prefix for '${structName}': expected 0x${expected.toString(16).padStart(8, '0')}, got 0x${prefix.toString(16).padStart(8, '0')}`);\n    }\n}\n\n// {{if:has_non32Prefixes}}\nfunction formatPrefix(prefixNum: number, prefixLen: number): string {\n    return prefixLen % 4 ? `0b${prefixNum.toString(2).padStart(prefixLen, '0')}` : `0x${prefixNum.toString(16).padStart(prefixLen / 4, '0')}`;\n}\n\nfunction loadAndCheckPrefix(s: c.Slice, expected: number, prefixLen: number, structName: string): void {\n    let prefix = s.loadUint(prefixLen);\n    if (prefix !== expected) {\n        throw new Error(`Incorrect prefix for '${structName}': expected ${formatPrefix(expected, prefixLen)}, got ${formatPrefix(prefix, prefixLen)}`);\n    }\n}\n// {{/if:has_non32Prefixes}}\n\nfunction lookupPrefix(s: c.Slice, expected: number, prefixLen: number): boolean {\n    return s.remainingBits >= prefixLen && s.preloadUint(prefixLen) === expected;\n}\n\n// {{if:has_implicitUnionPrefix}}\nfunction lookupPrefixAndEat(s: c.Slice, expected: number, prefixLen: number): boolean {\n    if (lookupPrefix(s, expected, prefixLen)) {\n        s.skip(prefixLen);\n        return true;\n    }\n    return false;\n}\n// {{/if:has_implicitUnionPrefix}}\n\nfunction throwNonePrefixMatch(fieldPath: string): never {\n    throw new Error(`Incorrect prefix for '${fieldPath}': none of variants matched`);\n}\n\nfunction storeCellRef<T>(cell: CellRef<T>, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    let b_ref = c.beginCell();\n    storeFn_T(cell.ref, b_ref);\n    b.storeRef(b_ref.endCell());\n}\n\nfunction loadCellRef<T>(s: c.Slice, loadFn_T: LoadCallback<T>): CellRef<T> {\n    let s_ref = s.loadRef().beginParse();\n    return { ref: loadFn_T(s_ref) };\n}\n\n// {{if:has_addressAny}}\nfunction storeTolkAddressAny(a: any_address, b: c.Builder): void {\n    let maybe_addr = a === 'none' ? null : a;\n    b.storeAddress(maybe_addr);\n}\n\nfunction loadTolkAddressAny(s: c.Slice): any_address {\n    let maybe_addr = s.loadAddressAny();\n    return maybe_addr === null ? 'none' : maybe_addr;\n}\n// {{/if:has_addressAny}}\n\n// {{if:has_bitsN}}\nfunction storeTolkBitsN(v: c.Slice, nBits: number, b: c.Builder): void {\n    if (v.remainingBits !== nBits) { throw new Error(`expected ${nBits} bits, got ${v.remainingBits}`); }\n    if (v.remainingRefs !== 0) { throw new Error(`expected 0 refs, got ${v.remainingRefs}`); }\n    b.storeSlice(v);\n}\n\nfunction loadTolkBitsN(s: c.Slice, nBits: number): c.Slice {\n    return new c.Slice(new c.BitReader(s.loadBits(nBits)), []);\n}\n// {{/if:has_bitsN}}\n\n// {{if:has_remaining}}\nfunction storeTolkRemaining(v: RemainingBitsAndRefs, b: c.Builder): void {\n    b.storeSlice(v);\n}\n\nfunction loadTolkRemaining(s: c.Slice): RemainingBitsAndRefs {\n    let rest = s.clone();\n    s.loadBits(s.remainingBits);\n    while (s.remainingRefs) {\n        s.loadRef();\n    }\n    return rest;\n}\n// {{/if:has_remaining}}\n\nfunction storeTolkNullable<T>(v: T | null, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    if (v === null) {\n        b.storeUint(0, 1);\n    } else {\n        b.storeUint(1, 1);\n        storeFn_T(v, b);\n    }\n}\n\n// {{if:has_arrayOf}}\nfunction storeArrayOf<T>(v: array<T>, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    // the compiler stores array<T> in chunks; in TypeScript, for simplicity, store \"1 elem = 1 ref\"\n    let tail = null as c.Cell | null;\n    for (let i = 0; i < v.length; ++i) {\n        let chunkB = beginCell().storeMaybeRef(tail);\n        storeFn_T(v[v.length - 1 - i], chunkB);\n        tail = chunkB.endCell();\n    }\n    b.storeUint(v.length, 8);\n    b.storeMaybeRef(tail);\n}\n\nfunction loadArrayOf<T>(s: c.Slice, loadFn_T: LoadCallback<T>): array<T> {\n    let len = s.loadUint(8);\n    let head = s.loadMaybeRef();\n    let outArr = [] as array<T>;\n    while (head != null) {\n        let s = head.beginParse();\n        head = s.loadMaybeRef();\n        while (s.remainingBits || s.remainingRefs) {\n            outArr.push(loadFn_T(s));\n        }\n    }\n    if (len !== outArr.length) {\n        throw new Error(`mismatch array binary data: expected ${len} elements, got ${outArr.length}`);\n    }\n    return outArr;\n}\n// {{/if:has_arrayOf}}\n\n// {{if:has_lispListOf}}\nfunction storeLispListOf<T>(v: lisp_list<T>, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    let tail = c.Cell.EMPTY;\n    for (let i = 0; i < v.length; ++i) {\n        let itemB = beginCell();\n        storeFn_T(v[i], itemB);\n        tail = itemB.storeRef(tail).endCell();\n    }\n    b.storeRef(tail);\n}\n\nfunction loadLispListOf<T>(s: c.Slice, loadFn_T: LoadCallback<T>): lisp_list<T> {\n    let outArr = [] as lisp_list<T>;\n    let head = s.loadRef().beginParse();\n    while (head.remainingRefs) {\n        let tailSnaked = head.loadRef();\n        let headValue = loadFn_T(head);\n        head.endParse();    // ensure no data is present besides T\n        outArr.unshift(headValue);\n        head = tailSnaked.beginParse();\n    }\n    return outArr;\n}\n// {{/if:has_lispListOf}}\n\n// {{if:has_customDictV}}\nfunction createDictionaryValue<V>(loadFn_V: LoadCallback<V>, storeFn_V: StoreCallback<V>): c.DictionaryValue<V> {\n    return {\n        serialize(self: V, b: c.Builder) {\n            storeFn_V(self, b);\n        },\n        parse(s: c.Slice): V {\n            const value = loadFn_V(s);\n            s.endParse();\n            return value;\n        }\n    }\n}\n// {{/if:has_customDictV}}\n\n// \u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\n//   parse get methods result from a TVM stack\n//\n\nclass StackReader {\n    constructor(private tuple: c.TupleItem[]) {\n    }\n\n    static fromGetMethod(expectedN: number, getMethodResult: { stack: c.TupleReader }): StackReader {\n        let tuple = [] as c.TupleItem[];\n        while (getMethodResult.stack.remaining) {\n            tuple.push(getMethodResult.stack.pop());\n        }\n        if (tuple.length !== expectedN) {\n            throw new Error(`expected ${expectedN} stack width, got ${tuple.length}`);\n        }\n        return new StackReader(tuple);\n    }\n\n    private popExpecting<ItemT>(itemType: string): ItemT {\n        const item = this.tuple.shift();\n        if (item?.type === itemType) {\n            return item as ItemT;\n        }\n        throw new Error(`not '${itemType}' on a stack`);\n    }\n\n    private popCellLike(): c.Cell {\n        const item = this.tuple.shift();\n        if (item && (item.type === 'cell' || item.type === 'slice' || item.type === 'builder')) {\n            return item.cell;\n        }\n        throw new Error(`not cell/slice on a stack`);\n    }\n\n    readBigInt(): bigint {\n        return this.popExpecting<c.TupleItemInt>('int').value;\n    }\n\n    readBoolean(): boolean {\n        return this.popExpecting<c.TupleItemInt>('int').value !== 0n;\n    }\n\n    readCell(): c.Cell {\n        return this.popCellLike();\n    }\n\n    readSlice(): c.Slice {\n        return this.popCellLike().beginParse();\n    }\n\n    // {{if:stackReadsBuilder}}\n    readBuilder(): c.Builder {\n        return beginCell().storeSlice(this.popCellLike().beginParse());\n    }\n    // {{/if:stackReadsBuilder}}\n\n    // {{if:stackReadsUnknown}}\n    readUnknown(): c.TupleItem {\n        // `unknown` from Tolk is left as a raw tuple item\n        return this.tuple.shift()!;\n    }\n    // {{/if:stackReadsUnknown}}\n\n    // {{if:stackReadsArrayOf}}\n    readArrayOf<T>(readFn_T: (nestedReader: StackReader) => T): T[] {\n        const subItems = this.popExpecting<c.Tuple>('tuple').items;\n        const subReader = new StackReader(subItems);\n        // array len N => N subItems => N calls to readFn_T\n        return [...subItems].map(_ => readFn_T(subReader));\n    }\n    // {{/if:stackReadsArrayOf}}\n\n    // {{if:stackReadsLispListOf}}\n    readLispListOf<T>(readFn_T: (nestedReader: StackReader) => T): T[] {\n        // read `[1 [2 [3 null]]]` to `[1 2 3]`\n        let pairReader: StackReader = this;\n        let outArr = [] as T[];\n        while (true) {\n            if (pairReader.tuple[0].type === 'null') {\n                pairReader.tuple.shift();\n                break;\n            }\n            let headAndTail = pairReader.popExpecting<c.Tuple>('tuple').items;\n            if (headAndTail.length !== 2) {\n                throw new Error(`malformed lisp_list, expected 2 stack width, got ${headAndTail.length}`);\n            }\n            pairReader = new StackReader(headAndTail);\n            outArr.push(readFn_T(pairReader));\n        }\n        return outArr;\n    }\n    // {{/if:stackReadsLispListOf}}\n\n    // {{if:stackReadsSnakeString}}\n    readSnakeString(): string {\n        return this.readCell().beginParse().loadStringTail();\n    }\n    // {{/if:stackReadsSnakeString}}\n\n    // {{if:stackReadsTuple}}\n    readTuple<T>(expectedN: number, readFn_T: (nestedReader: StackReader) => T): T {\n        const subItems = this.popExpecting<c.Tuple>('tuple').items;\n        if (subItems.length !== expectedN) {\n            throw new Error(`expected ${expectedN} items in a tuple, got ${subItems.length}`);\n        }\n        return readFn_T(new StackReader(subItems));\n    }\n    // {{/if:stackReadsTuple}}\n\n    // {{if:stackReadsNullLiteral}}\n    readNullLiteral(): null {\n        this.popExpecting<c.TupleItemNull>('null');\n        return null;\n    }\n    // {{/if:stackReadsNullLiteral}}\n\n    // {{if:stackReadsNullable}}\n    readNullable<T>(readFn_T: (r: StackReader) => T): T | null {\n        if (this.tuple[0].type === 'null') {\n            this.tuple.shift();\n            return null;\n        }\n        return readFn_T(this);\n    }\n    // {{/if:stackReadsNullable}}\n\n    // {{if:stackReadsWideNullable}}\n    readWideNullable<T>(stackW: number, readFn_T: (r: StackReader) => T): T | null {\n        const slotTypeId = this.tuple[stackW - 1];\n        if (slotTypeId?.type !== 'int') {\n            throw new Error(`not 'int' on a stack`);\n        }\n        if (slotTypeId.value === 0n) {\n            this.tuple = this.tuple.slice(stackW);\n            return null;\n        }\n        const valueT = readFn_T(this);\n        this.tuple.shift();\n        return valueT;\n    }\n    // {{/if:stackReadsWideNullable}}\n\n    // {{if:stackReadsUnionType}}\n    readUnionType<T>(stackW: number, infoForTypeId: Record<number, [number, string | null, (r: StackReader) => any]>): T {\n        const slotTypeId = this.tuple[stackW - 1];\n        if (slotTypeId?.type !== 'int') {\n            throw new Error(`not 'int' on a stack`);\n        }\n        const info = infoForTypeId[Number(slotTypeId.value)];   // [stackWidth, label, readFn_T{i}]\n        if (info == null) {\n            throw new Error(`unexpected UTag=${slotTypeId.value}`);\n        }\n        const label = info[1];\n        this.tuple = this.tuple.slice(stackW - 1 - info[0]);\n        const valueT = info[2](this);\n        this.tuple.shift();\n        return label == null ? valueT : { $: label, value: valueT } as T;\n    }\n    // {{/if:stackReadsUnionType}}\n\n    // {{if:stackReadsCellRef}}\n    readCellRef<T>(loadFn_T: LoadCallback<T>): CellRef<T> {\n        return { ref: loadFn_T(this.readCell().beginParse()) };\n    }\n    // {{/if:stackReadsCellRef}}\n\n    // {{if:stackReadsMapKV}}\n    readDictionary<K extends c.DictionaryKeyTypes, V>(keySerializer: c.DictionaryKey<K>, valueSerializer: c.DictionaryValue<V>): c.Dictionary<K, V> {\n        if (this.tuple[0].type === 'null') {\n            this.tuple.shift();\n            return c.Dictionary.empty<K, V>(keySerializer, valueSerializer);\n        }\n        return c.Dictionary.loadDirect<K, V>(keySerializer, valueSerializer, this.readCell());\n    }\n    // {{/if:stackReadsMapKV}}\n}\n\n// {{if:has_customPackUnpack}}\n// \u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\n//   custom packToBuilder and unpackFromSlice\n//\n\ntype CustomPackToBuilderFn<T> = (self: T, b: c.Builder) => void\ntype CustomUnpackFromSliceFn<T> = (s: c.Slice) => T\n\nlet customSerializersRegistry: Map<string, [CustomPackToBuilderFn<any> | null, CustomUnpackFromSliceFn<any> | null]> = new Map;\n\nfunction ensureCustomSerializerRegistered(typeName: string) {\n    if (!customSerializersRegistry.has(typeName)) {\n        throw new Error(`Custom packToBuilder/unpackFromSlice was not registered for type 'CONTRACT_CLASS_NAME.${typeName}'.\\n(in Tolk code, they have custom logic \\`fun ${typeName}__packToBuilder\\`)\\nSteps to fix:\\n1) in your code, create and implement\\n > function ${typeName}__packToBuilder(self: ${typeName}, b: Builder): void { ... }\\n > function ${typeName}__unpackFromSlice(s: Slice): ${typeName} { ... }\\n2) register them in advance by calling\\n > CONTRACT_CLASS_NAME.registerCustomPackUnpack('${typeName}', ${typeName}__packToBuilder, ${typeName}__unpackFromSlice);`);\n    }\n}\n\nfunction invokeCustomPackToBuilder<T>(typeName: string, self: T, b: c.Builder) {\n    ensureCustomSerializerRegistered(typeName);\n    customSerializersRegistry.get(typeName)![0]!(self, b);\n}\n\nfunction invokeCustomUnpackFromSlice<T>(typeName: string, s: c.Slice): T {\n    ensureCustomSerializerRegistered(typeName);\n    return customSerializersRegistry.get(typeName)![1]!(s);\n}\n// {{/if:has_customPackUnpack}}\n\n// \u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\n//   auto-generated serializers to/from cells\n//\n\ntype coins = bigint\n\n// {{intNAliases}}\n\n// {{uintNAliases}}\n\n// {{if:has_varIntN}}\n// {{varIntNAliases}}\n// {{/if:has_varIntN}}\n\n// {{if:has_bitsN}}\n// {{sliceAliases}}\n// {{/if:has_bitsN}}\n\n// {{packUnpackSerializers}}\n\n// \u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\n//    class CONTRACT_CLASS_NAME\n//\n\ninterface ExtraSendOptions {\n    bounce?: boolean                    // default: false\n    sendMode?: SendMode                 // default: SendMode.PAY_GAS_SEPARATELY\n    extraCurrencies?: c.ExtraCurrency   // default: empty dict\n}\n\ninterface DeployedAddrOptions {\n    workchain?: number                  // default: 0 (basechain)\n    toShard?: { fixedPrefixLength: number; closeTo: c.Address }\n    overrideContractCode?: c.Cell\n}\n\nfunction calculateDeployedAddress(code: c.Cell, data: c.Cell, options: DeployedAddrOptions): c.Address {\n    const stateInitCell = beginCell().store(c.storeStateInit({\n        code,\n        data,\n        splitDepth: options.toShard?.fixedPrefixLength,\n        special: null,\n        libraries: null,\n    })).endCell();\n\n    let addrHash = stateInitCell.hash();\n    if (options.toShard) {\n        const shardDepth = options.toShard.fixedPrefixLength;\n        addrHash = beginCell()\n            .storeBits(new c.BitString(options.toShard.closeTo.hash, 0, shardDepth))\n            .storeBits(new c.BitString(stateInitCell.hash(), shardDepth, 256 - shardDepth))\n            .endCell()\n            .beginParse().loadBuffer(32);\n    }\n\n    return new c.Address(options.workchain ?? 0, addrHash);\n}\n\nexport class CONTRACT_CLASS_NAME implements c.Contract {\n    static CodeCell = c.Cell.fromBase64('{{codeBoc64}}');\n\n    static Errors = {\n        // {{errorCodes}}\n    }\n\n    readonly address: c.Address\n    readonly init: { code: c.Cell, data: c.Cell } | undefined\n\n    protected constructor(address: c.Address, init?: { code: c.Cell, data: c.Cell }) {\n        this.address = address;\n        this.init = init;\n    }\n\n    // {{if:has_customPackUnpack}}\n    static registerCustomPackUnpack<T>(\n        typeName: string,\n        packToBuilderFn: CustomPackToBuilderFn<T> | null,\n        unpackFromSliceFn: CustomUnpackFromSliceFn<T> | null,\n    ) {\n        if (customSerializersRegistry.has(typeName)) {\n            throw new Error(`Custom pack/unpack for 'CONTRACT_CLASS_NAME.${typeName}' already registered`);\n        }\n        customSerializersRegistry.set(typeName, [packToBuilderFn, unpackFromSliceFn]);\n    }\n    // {{/if:has_customPackUnpack}}\n\n    static fromAddress(address: c.Address) {\n        return new CONTRACT_CLASS_NAME(address);\n    }\n\n    // {{fromStorageMethod}}\n\n    // {{createCellsMethods}}\n\n    // {{if:has_sendDeploy}}\n    async sendDeploy(provider: ContractProvider, via: Sender, msgValue: coins, extraOptions?: ExtraSendOptions) {\n        return provider.internal(via, {\n            value: msgValue,\n            body: c.Cell.EMPTY,\n            ...extraOptions\n        });\n    }\n    // {{/if:has_sendDeploy}}\n\n    // {{sendMethods}}\n\n    // {{getMethods}}\n}\n";

package/dist/out-template.generated.js

@@ -3,4 +3,4 @@
 // Source of truth: src/out-template.ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OUT_TEMPLATE = void 0;
-exports.OUT_TEMPLATE = "// AUTO-GENERATED, do not edit\n// it's a TypeScript wrapper for a CONTRACT_CLASS_NAME contract in Tolk\n/* eslint-disable */\n\nimport * as c from '@ton/core';\nimport { beginCell, ContractProvider, Sender, SendMode } from '@ton/core';\n\n// ————————————————————————————————————————————\n//   predefined types and functions\n//\n\n// {{if:has_remaining}}\ntype RemainingBitsAndRefs = c.Slice\n// {{/if:has_remaining}}\n\n// {{if:has_addressAny}}\nexport type any_address = c.Address | c.ExternalAddress | 'none'\n// {{/if:has_addressAny}}\n\n// {{if:has_arrayOf}}\ntype array<T> = T[]\n// {{/if:has_arrayOf}}\n\n// {{if:has_lispListOf}}\n// TypeScript wrappers flatten a TVM linked list `[1 [2 [3 null]]]` to `[1 2 3]`\ntype lisp_list<T> = T[]\n// {{/if:has_lispListOf}}\n\ntype StoreCallback<T> = (obj: T, b: c.Builder) => void\ntype LoadCallback<T> = (s: c.Slice) => T\n\nexport type CellRef<T> = {\n    ref: T\n}\n\nfunction makeCellFrom<T>(self: T, storeFn_T: StoreCallback<T>): c.Cell {\n    let b = beginCell();\n    storeFn_T(self, b);\n    return b.endCell();\n}\n\nfunction loadAndCheckPrefix32(s: c.Slice, expected: number, structName: string): void {\n    let prefix = s.loadUint(32);\n    if (prefix !== expected) {\n        throw new Error(`Incorrect prefix for '${structName}': expected 0x${expected.toString(16).padStart(8, '0')}, got 0x${prefix.toString(16).padStart(8, '0')}`);\n    }\n}\n\n// {{if:has_non32Prefixes}}\nfunction formatPrefix(prefixNum: number, prefixLen: number): string {\n    return prefixLen % 4 ? `0b${prefixNum.toString(2).padStart(prefixLen, '0')}` : `0x${prefixNum.toString(16).padStart(prefixLen / 4, '0')}`;\n}\n\nfunction loadAndCheckPrefix(s: c.Slice, expected: number, prefixLen: number, structName: string): void {\n    let prefix = s.loadUint(prefixLen);\n    if (prefix !== expected) {\n        throw new Error(`Incorrect prefix for '${structName}': expected ${formatPrefix(expected, prefixLen)}, got ${formatPrefix(prefix, prefixLen)}`);\n    }\n}\n// {{/if:has_non32Prefixes}}\n\nfunction lookupPrefix(s: c.Slice, expected: number, prefixLen: number): boolean {\n    return s.remainingBits >= prefixLen && s.preloadUint(prefixLen) === expected;\n}\n\n// {{if:has_implicitUnionPrefix}}\nfunction lookupPrefixAndEat(s: c.Slice, expected: number, prefixLen: number): boolean {\n    if (lookupPrefix(s, expected, prefixLen)) {\n        s.skip(prefixLen);\n        return true;\n    }\n    return false;\n}\n// {{/if:has_implicitUnionPrefix}}\n\nfunction throwNonePrefixMatch(fieldPath: string): never {\n    throw new Error(`Incorrect prefix for '${fieldPath}': none of variants matched`);\n}\n\nfunction storeCellRef<T>(cell: CellRef<T>, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    let b_ref = c.beginCell();\n    storeFn_T(cell.ref, b_ref);\n    b.storeRef(b_ref.endCell());\n}\n\nfunction loadCellRef<T>(s: c.Slice, loadFn_T: LoadCallback<T>): CellRef<T> {\n    let s_ref = s.loadRef().beginParse();\n    return { ref: loadFn_T(s_ref) };\n}\n\n// {{if:has_addressAny}}\nfunction storeTolkAddressAny(a: any_address, b: c.Builder): void {\n    let maybe_addr = a === 'none' ? null : a;\n    b.storeAddress(maybe_addr);\n}\n\nfunction loadTolkAddressAny(s: c.Slice): any_address {\n    let maybe_addr = s.loadAddressAny();\n    return maybe_addr === null ? 'none' : maybe_addr;\n}\n// {{/if:has_addressAny}}\n\n// {{if:has_bitsN}}\nfunction storeTolkBitsN(v: c.Slice, nBits: number, b: c.Builder): void {\n    if (v.remainingBits !== nBits) { throw new Error(`expected ${nBits} bits, got ${v.remainingBits}`); }\n    if (v.remainingRefs !== 0) { throw new Error(`expected 0 refs, got ${v.remainingRefs}`); }\n    b.storeSlice(v);\n}\n\nfunction loadTolkBitsN(s: c.Slice, nBits: number): c.Slice {\n    return new c.Slice(new c.BitReader(s.loadBits(nBits)), []);\n}\n// {{/if:has_bitsN}}\n\n// {{if:has_remaining}}\nfunction storeTolkRemaining(v: RemainingBitsAndRefs, b: c.Builder): void {\n    b.storeSlice(v);\n}\n\nfunction loadTolkRemaining(s: c.Slice): RemainingBitsAndRefs {\n    let rest = s.clone();\n    s.loadBits(s.remainingBits);\n    while (s.remainingRefs) {\n        s.loadRef();\n    }\n    return rest;\n}\n// {{/if:has_remaining}}\n\nfunction storeTolkNullable<T>(v: T | null, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    if (v === null) {\n        b.storeUint(0, 1);\n    } else {\n        b.storeUint(1, 1);\n        storeFn_T(v, b);\n    }\n}\n\n// {{if:has_arrayOf}}\nfunction storeArrayOf<T>(v: array<T>, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    // the compiler stores array<T> in chunks; in TypeScript, for simplicity, store \"1 elem = 1 ref\"\n    let tail = null as c.Cell | null;\n    for (let i = 0; i < v.length; ++i) {\n        let chunkB = beginCell().storeMaybeRef(tail);\n        storeFn_T(v[v.length - 1 - i], chunkB);\n        tail = chunkB.endCell();\n    }\n    b.storeUint(v.length, 8);\n    b.storeMaybeRef(tail);\n}\n\nfunction loadArrayOf<T>(s: c.Slice, loadFn_T: LoadCallback<T>): array<T> {\n    let len = s.loadUint(8);\n    let head = s.loadMaybeRef();\n    let outArr = [] as array<T>;\n    while (head != null) {\n        let s = head.beginParse();\n        head = s.loadMaybeRef();\n        while (s.remainingBits || s.remainingRefs) {\n            outArr.push(loadFn_T(s));\n        }\n    }\n    if (len !== outArr.length) {\n        throw new Error(`mismatch array binary data: expected ${len} elements, got ${outArr.length}`);\n    }\n    return outArr;\n}\n// {{/if:has_arrayOf}}\n\n// {{if:has_lispListOf}}\nfunction storeLispListOf<T>(v: lisp_list<T>, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    let tail = c.Cell.EMPTY;\n    for (let i = 0; i < v.length; ++i) {\n        let itemB = beginCell();\n        storeFn_T(v[i], itemB);\n        tail = itemB.storeRef(tail).endCell();\n    }\n    b.storeRef(tail);\n}\n\nfunction loadLispListOf<T>(s: c.Slice, loadFn_T: LoadCallback<T>): lisp_list<T> {\n    let outArr = [] as lisp_list<T>;\n    let head = s.loadRef().beginParse();\n    while (head.remainingRefs) {\n        let tailSnaked = head.loadRef();\n        let headValue = loadFn_T(head);\n        head.endParse();    // ensure no data is present besides T\n        outArr.unshift(headValue);\n        head = tailSnaked.beginParse();\n    }\n    return outArr;\n}\n// {{/if:has_lispListOf}}\n\n// {{if:has_customDictV}}\nfunction createDictionaryValue<V>(loadFn_V: LoadCallback<V>, storeFn_V: StoreCallback<V>): c.DictionaryValue<V> {\n    return {\n        serialize(self: V, b: c.Builder) {\n            storeFn_V(self, b);\n        },\n        parse(s: c.Slice): V {\n            const value = loadFn_V(s);\n            s.endParse();\n            return value;\n        }\n    }\n}\n// {{/if:has_customDictV}}\n\n// ————————————————————————————————————————————\n//   parse get methods result from a TVM stack\n//\n\nclass StackReader {\n    constructor(private tuple: c.TupleItem[]) {\n    }\n\n    static fromGetMethod(expectedN: number, getMethodResult: { stack: c.TupleReader }): StackReader {\n        let tuple = [] as c.TupleItem[];\n        while (getMethodResult.stack.remaining) {\n            tuple.push(getMethodResult.stack.pop());\n        }\n        if (tuple.length !== expectedN) {\n            throw new Error(`expected ${expectedN} stack width, got ${tuple.length}`);\n        }\n        return new StackReader(tuple);\n    }\n\n    private popExpecting<ItemT>(itemType: string): ItemT {\n        const item = this.tuple.shift();\n        if (item?.type === itemType) {\n            return item as ItemT;\n        }\n        throw new Error(`not '${itemType}' on a stack`);\n    }\n\n    private popCellLike(): c.Cell {\n        const item = this.tuple.shift();\n        if (item && (item.type === 'cell' || item.type === 'slice' || item.type === 'builder')) {\n            return item.cell;\n        }\n        throw new Error(`not cell/slice on a stack`);\n    }\n\n    readBigInt(): bigint {\n        return this.popExpecting<c.TupleItemInt>('int').value;\n    }\n\n    readBoolean(): boolean {\n        return this.popExpecting<c.TupleItemInt>('int').value !== 0n;\n    }\n\n    readCell(): c.Cell {\n        return this.popCellLike();\n    }\n\n    readSlice(): c.Slice {\n        return this.popCellLike().beginParse();\n    }\n\n    // {{if:stackReadsBuilder}}\n    readBuilder(): c.Builder {\n        return beginCell().storeSlice(this.popCellLike().beginParse());\n    }\n    // {{/if:stackReadsBuilder}}\n\n    // {{if:stackReadsUnknown}}\n    readUnknown(): c.TupleItem {\n        // `unknown` from Tolk is left as a raw tuple item\n        return this.tuple.shift()!;\n    }\n    // {{/if:stackReadsUnknown}}\n\n    // {{if:stackReadsArrayOf}}\n    readArrayOf<T>(readFn_T: (nestedReader: StackReader) => T): T[] {\n        const subItems = this.popExpecting<c.Tuple>('tuple').items;\n        const subReader = new StackReader(subItems);\n        // array len N => N subItems => N calls to readFn_T\n        return [...subItems].map(_ => readFn_T(subReader));\n    }\n    // {{/if:stackReadsArrayOf}}\n\n    // {{if:stackReadsLispListOf}}\n    readLispListOf<T>(readFn_T: (nestedReader: StackReader) => T): T[] {\n        // read `[1 [2 [3 null]]]` to `[1 2 3]`\n        let pairReader: StackReader = this;\n        let outArr = [] as T[];\n        while (true) {\n            if (pairReader.tuple[0].type === 'null') {\n                pairReader.tuple.shift();\n                break;\n            }\n            let headAndTail = pairReader.popExpecting<c.Tuple>('tuple').items;\n            if (headAndTail.length !== 2) {\n                throw new Error(`malformed lisp_list, expected 2 stack width, got ${headAndTail.length}`);\n            }\n            pairReader = new StackReader(headAndTail);\n            outArr.push(readFn_T(pairReader));\n        }\n        return outArr;\n    }\n    // {{/if:stackReadsLispListOf}}\n\n    // {{if:stackReadsSnakeString}}\n    readSnakeString(): string {\n        return this.readCell().beginParse().loadStringTail();\n    }\n    // {{/if:stackReadsSnakeString}}\n\n    // {{if:stackReadsTuple}}\n    readTuple<T>(expectedN: number, readFn_T: (nestedReader: StackReader) => T): T {\n        const subItems = this.popExpecting<c.Tuple>('tuple').items;\n        if (subItems.length !== expectedN) {\n            throw new Error(`expected ${expectedN} items in a tuple, got ${subItems.length}`);\n        }\n        return readFn_T(new StackReader(subItems));\n    }\n    // {{/if:stackReadsTuple}}\n\n    // {{if:stackReadsNullLiteral}}\n    readNullLiteral(): null {\n        this.popExpecting<c.TupleItemNull>('null');\n        return null;\n    }\n    // {{/if:stackReadsNullLiteral}}\n\n    // {{if:stackReadsNullable}}\n    readNullable<T>(readFn_T: (r: StackReader) => T): T | null {\n        if (this.tuple[0].type === 'null') {\n            this.tuple.shift();\n            return null;\n        }\n        return readFn_T(this);\n    }\n    // {{/if:stackReadsNullable}}\n\n    // {{if:stackReadsWideNullable}}\n    readWideNullable<T>(stackW: number, readFn_T: (r: StackReader) => T): T | null {\n        const slotTypeId = this.tuple[stackW - 1];\n        if (slotTypeId?.type !== 'int') {\n            throw new Error(`not 'int' on a stack`);\n        }\n        if (slotTypeId.value === 0n) {\n            this.tuple = this.tuple.slice(stackW);\n            return null;\n        }\n        const valueT = readFn_T(this);\n        this.tuple.shift();\n        return valueT;\n    }\n    // {{/if:stackReadsWideNullable}}\n\n    // {{if:stackReadsUnionType}}\n    readUnionType<T>(stackW: number, infoForTypeId: Record<number, [number, string | null, (r: StackReader) => any]>): T {\n        const slotTypeId = this.tuple[stackW - 1];\n        if (slotTypeId?.type !== 'int') {\n            throw new Error(`not 'int' on a stack`);\n        }\n        const info = infoForTypeId[Number(slotTypeId.value)];   // [stackWidth, label, readFn_T{i}]\n        if (info == null) {\n            throw new Error(`unexpected UTag=${slotTypeId.value}`);\n        }\n        const label = info[1];\n        this.tuple = this.tuple.slice(stackW - 1 - info[0]);\n        const valueT = info[2](this);\n        this.tuple.shift();\n        return label == null ? valueT : { $: label, value: valueT } as T;\n    }\n    // {{/if:stackReadsUnionType}}\n\n    // {{if:stackReadsCellRef}}\n    readCellRef<T>(loadFn_T: LoadCallback<T>): CellRef<T> {\n        return { ref: loadFn_T(this.readCell().beginParse()) };\n    }\n    // {{/if:stackReadsCellRef}}\n\n    // {{if:stackReadsMapKV}}\n    readDictionary<K extends c.DictionaryKeyTypes, V>(keySerializer: c.DictionaryKey<K>, valueSerializer: c.DictionaryValue<V>): c.Dictionary<K, V> {\n        if (this.tuple[0].type === 'null') {\n            this.tuple.shift();\n            return c.Dictionary.empty<K, V>(keySerializer, valueSerializer);\n        }\n        return c.Dictionary.loadDirect<K, V>(keySerializer, valueSerializer, this.readCell());\n    }\n    // {{/if:stackReadsMapKV}}\n}\n\n// {{if:has_customPackUnpack}}\n// ————————————————————————————————————————————\n//   custom packToBuilder and unpackFromSlice\n//\n\ntype CustomPackToBuilderFn<T> = (self: T, b: c.Builder) => void\ntype CustomUnpackFromSliceFn<T> = (s: c.Slice) => T\n\nlet customSerializersRegistry: Map<string, [CustomPackToBuilderFn<any> | null, CustomUnpackFromSliceFn<any> | null]> = new Map;\n\nfunction ensureCustomSerializerRegistered(typeName: string) {\n    if (!customSerializersRegistry.has(typeName)) {\n        throw new Error(`Custom packToBuilder/unpackFromSlice was not registered for type 'CONTRACT_CLASS_NAME.${typeName}'.\\n(in Tolk code, they have custom logic \\`fun ${typeName}__packToBuilder\\`)\\nSteps to fix:\\n1) in your code, create and implement\\n > function ${typeName}__packToBuilder(self: ${typeName}, b: Builder): void { ... }\\n > function ${typeName}__unpackFromSlice(s: Slice): ${typeName} { ... }\\n2) register them in advance by calling\\n > CONTRACT_CLASS_NAME.registerCustomPackUnpack('${typeName}', ${typeName}__packToBuilder, ${typeName}__unpackFromSlice);`);\n    }\n}\n\nfunction invokeCustomPackToBuilder<T>(typeName: string, self: T, b: c.Builder) {\n    ensureCustomSerializerRegistered(typeName);\n    customSerializersRegistry.get(typeName)![0]!(self, b);\n}\n\nfunction invokeCustomUnpackFromSlice<T>(typeName: string, s: c.Slice): T {\n    ensureCustomSerializerRegistered(typeName);\n    return customSerializersRegistry.get(typeName)![1]!(s);\n}\n// {{/if:has_customPackUnpack}}\n\n// ————————————————————————————————————————————\n//   auto-generated serializers to/from cells\n//\n\ntype coins = bigint\n\n// {{intNAliases}}\n\n// {{uintNAliases}}\n\n// {{if:has_varIntN}}\n// {{varIntNAliases}}\n// {{/if:has_varIntN}}\n\n// {{if:has_bitsN}}\n// {{sliceAliases}}\n// {{/if:has_bitsN}}\n\n// {{packUnpackSerializers}}\n\n// ————————————————————————————————————————————\n//    class CONTRACT_CLASS_NAME\n//\n\ninterface ExtraSendOptions {\n    bounce?: boolean                    // default: false\n    sendMode?: SendMode                 // default: SendMode.PAY_GAS_SEPARATELY\n    extraCurrencies?: c.ExtraCurrency   // default: empty dict\n}\n\ninterface DeployedAddrOptions {\n    workchain?: number                  // default: 0 (basechain)\n    toShard?: { fixedPrefixLength: number; closeTo: c.Address }\n    overrideContractCode?: c.Cell\n}\n\nfunction calculateDeployedAddress(code: c.Cell, data: c.Cell, options: DeployedAddrOptions): c.Address {\n    const stateInitCell = beginCell().store(c.storeStateInit({\n        code,\n        data,\n        splitDepth: options.toShard?.fixedPrefixLength,\n        special: null,\n        libraries: null,\n    })).endCell();\n\n    let addrHash = stateInitCell.hash();\n    if (options.toShard) {\n        const shardDepth = options.toShard.fixedPrefixLength;\n        addrHash = beginCell()\n            .storeBits(new c.BitString(options.toShard.closeTo.hash, 0, shardDepth))\n            .storeBits(new c.BitString(stateInitCell.hash(), shardDepth, 256 - shardDepth))\n            .endCell()\n            .beginParse().loadBuffer(32);\n    }\n\n    return new c.Address(options.workchain ?? 0, addrHash);\n}\n\nexport class CONTRACT_CLASS_NAME implements c.Contract {\n    static CodeCell = c.Cell.fromBase64('{{codeBoc64}}');\n\n    static Errors = {\n        // {{errorCodes}}\n    }\n\n    readonly address: c.Address\n    readonly init?: { code: c.Cell, data: c.Cell }\n\n    private constructor(address: c.Address, init?: { code: c.Cell, data: c.Cell }) {\n        this.address = address;\n        this.init = init;\n    }\n\n    // {{if:has_customPackUnpack}}\n    static registerCustomPackUnpack<T>(\n        typeName: string,\n        packToBuilderFn: CustomPackToBuilderFn<T> | null,\n        unpackFromSliceFn: CustomUnpackFromSliceFn<T> | null,\n    ) {\n        if (customSerializersRegistry.has(typeName)) {\n            throw new Error(`Custom pack/unpack for 'CONTRACT_CLASS_NAME.${typeName}' already registered`);\n        }\n        customSerializersRegistry.set(typeName, [packToBuilderFn, unpackFromSliceFn]);\n    }\n    // {{/if:has_customPackUnpack}}\n\n    static fromAddress(address: c.Address) {\n        return new CONTRACT_CLASS_NAME(address);\n    }\n\n    // {{fromStorageMethod}}\n\n    // {{createCellsMethods}}\n\n    // {{if:has_sendDeploy}}\n    async sendDeploy(provider: ContractProvider, via: Sender, msgValue: coins, extraOptions?: ExtraSendOptions) {\n        return provider.internal(via, {\n            value: msgValue,\n            body: c.Cell.EMPTY,\n            ...extraOptions\n        });\n    }\n    // {{/if:has_sendDeploy}}\n\n    // {{sendMethods}}\n\n    // {{getMethods}}\n}\n";
+exports.OUT_TEMPLATE = "// AUTO-GENERATED, do not edit\n// It's a TypeScript wrapper for a CONTRACT_CLASS_NAME contract in Tolk.\n/* eslint-disable */\n\nimport * as c from '@ton/core';\nimport { beginCell, ContractProvider, Sender, SendMode } from '@ton/core';\n\n// ————————————————————————————————————————————\n//   predefined types and functions\n//\n\n// {{if:has_remaining}}\ntype RemainingBitsAndRefs = c.Slice\n// {{/if:has_remaining}}\n\n// {{if:has_addressAny}}\nexport type any_address = c.Address | c.ExternalAddress | 'none'\n// {{/if:has_addressAny}}\n\n// {{if:has_arrayOf}}\ntype array<T> = T[]\n// {{/if:has_arrayOf}}\n\n// {{if:has_lispListOf}}\n// TypeScript wrappers flatten a TVM linked list `[1 [2 [3 null]]]` to `[1 2 3]`\ntype lisp_list<T> = T[]\n// {{/if:has_lispListOf}}\n\ntype StoreCallback<T> = (obj: T, b: c.Builder) => void\ntype LoadCallback<T> = (s: c.Slice) => T\n\nexport type CellRef<T> = {\n    ref: T\n}\n\nfunction makeCellFrom<T>(self: T, storeFn_T: StoreCallback<T>): c.Cell {\n    let b = beginCell();\n    storeFn_T(self, b);\n    return b.endCell();\n}\n\nfunction loadAndCheckPrefix32(s: c.Slice, expected: number, structName: string): void {\n    let prefix = s.loadUint(32);\n    if (prefix !== expected) {\n        throw new Error(`Incorrect prefix for '${structName}': expected 0x${expected.toString(16).padStart(8, '0')}, got 0x${prefix.toString(16).padStart(8, '0')}`);\n    }\n}\n\n// {{if:has_non32Prefixes}}\nfunction formatPrefix(prefixNum: number, prefixLen: number): string {\n    return prefixLen % 4 ? `0b${prefixNum.toString(2).padStart(prefixLen, '0')}` : `0x${prefixNum.toString(16).padStart(prefixLen / 4, '0')}`;\n}\n\nfunction loadAndCheckPrefix(s: c.Slice, expected: number, prefixLen: number, structName: string): void {\n    let prefix = s.loadUint(prefixLen);\n    if (prefix !== expected) {\n        throw new Error(`Incorrect prefix for '${structName}': expected ${formatPrefix(expected, prefixLen)}, got ${formatPrefix(prefix, prefixLen)}`);\n    }\n}\n// {{/if:has_non32Prefixes}}\n\nfunction lookupPrefix(s: c.Slice, expected: number, prefixLen: number): boolean {\n    return s.remainingBits >= prefixLen && s.preloadUint(prefixLen) === expected;\n}\n\n// {{if:has_implicitUnionPrefix}}\nfunction lookupPrefixAndEat(s: c.Slice, expected: number, prefixLen: number): boolean {\n    if (lookupPrefix(s, expected, prefixLen)) {\n        s.skip(prefixLen);\n        return true;\n    }\n    return false;\n}\n// {{/if:has_implicitUnionPrefix}}\n\nfunction throwNonePrefixMatch(fieldPath: string): never {\n    throw new Error(`Incorrect prefix for '${fieldPath}': none of variants matched`);\n}\n\nfunction storeCellRef<T>(cell: CellRef<T>, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    let b_ref = c.beginCell();\n    storeFn_T(cell.ref, b_ref);\n    b.storeRef(b_ref.endCell());\n}\n\nfunction loadCellRef<T>(s: c.Slice, loadFn_T: LoadCallback<T>): CellRef<T> {\n    let s_ref = s.loadRef().beginParse();\n    return { ref: loadFn_T(s_ref) };\n}\n\n// {{if:has_addressAny}}\nfunction storeTolkAddressAny(a: any_address, b: c.Builder): void {\n    let maybe_addr = a === 'none' ? null : a;\n    b.storeAddress(maybe_addr);\n}\n\nfunction loadTolkAddressAny(s: c.Slice): any_address {\n    let maybe_addr = s.loadAddressAny();\n    return maybe_addr === null ? 'none' : maybe_addr;\n}\n// {{/if:has_addressAny}}\n\n// {{if:has_bitsN}}\nfunction storeTolkBitsN(v: c.Slice, nBits: number, b: c.Builder): void {\n    if (v.remainingBits !== nBits) { throw new Error(`expected ${nBits} bits, got ${v.remainingBits}`); }\n    if (v.remainingRefs !== 0) { throw new Error(`expected 0 refs, got ${v.remainingRefs}`); }\n    b.storeSlice(v);\n}\n\nfunction loadTolkBitsN(s: c.Slice, nBits: number): c.Slice {\n    return new c.Slice(new c.BitReader(s.loadBits(nBits)), []);\n}\n// {{/if:has_bitsN}}\n\n// {{if:has_remaining}}\nfunction storeTolkRemaining(v: RemainingBitsAndRefs, b: c.Builder): void {\n    b.storeSlice(v);\n}\n\nfunction loadTolkRemaining(s: c.Slice): RemainingBitsAndRefs {\n    let rest = s.clone();\n    s.loadBits(s.remainingBits);\n    while (s.remainingRefs) {\n        s.loadRef();\n    }\n    return rest;\n}\n// {{/if:has_remaining}}\n\nfunction storeTolkNullable<T>(v: T | null, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    if (v === null) {\n        b.storeUint(0, 1);\n    } else {\n        b.storeUint(1, 1);\n        storeFn_T(v, b);\n    }\n}\n\n// {{if:has_arrayOf}}\nfunction storeArrayOf<T>(v: array<T>, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    // the compiler stores array<T> in chunks; in TypeScript, for simplicity, store \"1 elem = 1 ref\"\n    let tail = null as c.Cell | null;\n    for (let i = 0; i < v.length; ++i) {\n        let chunkB = beginCell().storeMaybeRef(tail);\n        storeFn_T(v[v.length - 1 - i], chunkB);\n        tail = chunkB.endCell();\n    }\n    b.storeUint(v.length, 8);\n    b.storeMaybeRef(tail);\n}\n\nfunction loadArrayOf<T>(s: c.Slice, loadFn_T: LoadCallback<T>): array<T> {\n    let len = s.loadUint(8);\n    let head = s.loadMaybeRef();\n    let outArr = [] as array<T>;\n    while (head != null) {\n        let s = head.beginParse();\n        head = s.loadMaybeRef();\n        while (s.remainingBits || s.remainingRefs) {\n            outArr.push(loadFn_T(s));\n        }\n    }\n    if (len !== outArr.length) {\n        throw new Error(`mismatch array binary data: expected ${len} elements, got ${outArr.length}`);\n    }\n    return outArr;\n}\n// {{/if:has_arrayOf}}\n\n// {{if:has_lispListOf}}\nfunction storeLispListOf<T>(v: lisp_list<T>, b: c.Builder, storeFn_T: StoreCallback<T>): void {\n    let tail = c.Cell.EMPTY;\n    for (let i = 0; i < v.length; ++i) {\n        let itemB = beginCell();\n        storeFn_T(v[i], itemB);\n        tail = itemB.storeRef(tail).endCell();\n    }\n    b.storeRef(tail);\n}\n\nfunction loadLispListOf<T>(s: c.Slice, loadFn_T: LoadCallback<T>): lisp_list<T> {\n    let outArr = [] as lisp_list<T>;\n    let head = s.loadRef().beginParse();\n    while (head.remainingRefs) {\n        let tailSnaked = head.loadRef();\n        let headValue = loadFn_T(head);\n        head.endParse();    // ensure no data is present besides T\n        outArr.unshift(headValue);\n        head = tailSnaked.beginParse();\n    }\n    return outArr;\n}\n// {{/if:has_lispListOf}}\n\n// {{if:has_customDictV}}\nfunction createDictionaryValue<V>(loadFn_V: LoadCallback<V>, storeFn_V: StoreCallback<V>): c.DictionaryValue<V> {\n    return {\n        serialize(self: V, b: c.Builder) {\n            storeFn_V(self, b);\n        },\n        parse(s: c.Slice): V {\n            const value = loadFn_V(s);\n            s.endParse();\n            return value;\n        }\n    }\n}\n// {{/if:has_customDictV}}\n\n// ————————————————————————————————————————————\n//   parse get methods result from a TVM stack\n//\n\nclass StackReader {\n    constructor(private tuple: c.TupleItem[]) {\n    }\n\n    static fromGetMethod(expectedN: number, getMethodResult: { stack: c.TupleReader }): StackReader {\n        let tuple = [] as c.TupleItem[];\n        while (getMethodResult.stack.remaining) {\n            tuple.push(getMethodResult.stack.pop());\n        }\n        if (tuple.length !== expectedN) {\n            throw new Error(`expected ${expectedN} stack width, got ${tuple.length}`);\n        }\n        return new StackReader(tuple);\n    }\n\n    private popExpecting<ItemT>(itemType: string): ItemT {\n        const item = this.tuple.shift();\n        if (item?.type === itemType) {\n            return item as ItemT;\n        }\n        throw new Error(`not '${itemType}' on a stack`);\n    }\n\n    private popCellLike(): c.Cell {\n        const item = this.tuple.shift();\n        if (item && (item.type === 'cell' || item.type === 'slice' || item.type === 'builder')) {\n            return item.cell;\n        }\n        throw new Error(`not cell/slice on a stack`);\n    }\n\n    readBigInt(): bigint {\n        return this.popExpecting<c.TupleItemInt>('int').value;\n    }\n\n    readBoolean(): boolean {\n        return this.popExpecting<c.TupleItemInt>('int').value !== 0n;\n    }\n\n    readCell(): c.Cell {\n        return this.popCellLike();\n    }\n\n    readSlice(): c.Slice {\n        return this.popCellLike().beginParse();\n    }\n\n    // {{if:stackReadsBuilder}}\n    readBuilder(): c.Builder {\n        return beginCell().storeSlice(this.popCellLike().beginParse());\n    }\n    // {{/if:stackReadsBuilder}}\n\n    // {{if:stackReadsUnknown}}\n    readUnknown(): c.TupleItem {\n        // `unknown` from Tolk is left as a raw tuple item\n        return this.tuple.shift()!;\n    }\n    // {{/if:stackReadsUnknown}}\n\n    // {{if:stackReadsArrayOf}}\n    readArrayOf<T>(readFn_T: (nestedReader: StackReader) => T): T[] {\n        const subItems = this.popExpecting<c.Tuple>('tuple').items;\n        const subReader = new StackReader(subItems);\n        // array len N => N subItems => N calls to readFn_T\n        return [...subItems].map(_ => readFn_T(subReader));\n    }\n    // {{/if:stackReadsArrayOf}}\n\n    // {{if:stackReadsLispListOf}}\n    readLispListOf<T>(readFn_T: (nestedReader: StackReader) => T): T[] {\n        // read `[1 [2 [3 null]]]` to `[1 2 3]`\n        let pairReader: StackReader = this;\n        let outArr = [] as T[];\n        while (true) {\n            if (pairReader.tuple[0].type === 'null') {\n                pairReader.tuple.shift();\n                break;\n            }\n            let headAndTail = pairReader.popExpecting<c.Tuple>('tuple').items;\n            if (headAndTail.length !== 2) {\n                throw new Error(`malformed lisp_list, expected 2 stack width, got ${headAndTail.length}`);\n            }\n            pairReader = new StackReader(headAndTail);\n            outArr.push(readFn_T(pairReader));\n        }\n        return outArr;\n    }\n    // {{/if:stackReadsLispListOf}}\n\n    // {{if:stackReadsSnakeString}}\n    readSnakeString(): string {\n        return this.readCell().beginParse().loadStringTail();\n    }\n    // {{/if:stackReadsSnakeString}}\n\n    // {{if:stackReadsTuple}}\n    readTuple<T>(expectedN: number, readFn_T: (nestedReader: StackReader) => T): T {\n        const subItems = this.popExpecting<c.Tuple>('tuple').items;\n        if (subItems.length !== expectedN) {\n            throw new Error(`expected ${expectedN} items in a tuple, got ${subItems.length}`);\n        }\n        return readFn_T(new StackReader(subItems));\n    }\n    // {{/if:stackReadsTuple}}\n\n    // {{if:stackReadsNullLiteral}}\n    readNullLiteral(): null {\n        this.popExpecting<c.TupleItemNull>('null');\n        return null;\n    }\n    // {{/if:stackReadsNullLiteral}}\n\n    // {{if:stackReadsNullable}}\n    readNullable<T>(readFn_T: (r: StackReader) => T): T | null {\n        if (this.tuple[0].type === 'null') {\n            this.tuple.shift();\n            return null;\n        }\n        return readFn_T(this);\n    }\n    // {{/if:stackReadsNullable}}\n\n    // {{if:stackReadsWideNullable}}\n    readWideNullable<T>(stackW: number, readFn_T: (r: StackReader) => T): T | null {\n        const slotTypeId = this.tuple[stackW - 1];\n        if (slotTypeId?.type !== 'int') {\n            throw new Error(`not 'int' on a stack`);\n        }\n        if (slotTypeId.value === 0n) {\n            this.tuple = this.tuple.slice(stackW);\n            return null;\n        }\n        const valueT = readFn_T(this);\n        this.tuple.shift();\n        return valueT;\n    }\n    // {{/if:stackReadsWideNullable}}\n\n    // {{if:stackReadsUnionType}}\n    readUnionType<T>(stackW: number, infoForTypeId: Record<number, [number, string | null, (r: StackReader) => any]>): T {\n        const slotTypeId = this.tuple[stackW - 1];\n        if (slotTypeId?.type !== 'int') {\n            throw new Error(`not 'int' on a stack`);\n        }\n        const info = infoForTypeId[Number(slotTypeId.value)];   // [stackWidth, label, readFn_T{i}]\n        if (info == null) {\n            throw new Error(`unexpected UTag=${slotTypeId.value}`);\n        }\n        const label = info[1];\n        this.tuple = this.tuple.slice(stackW - 1 - info[0]);\n        const valueT = info[2](this);\n        this.tuple.shift();\n        return label == null ? valueT : { $: label, value: valueT } as T;\n    }\n    // {{/if:stackReadsUnionType}}\n\n    // {{if:stackReadsCellRef}}\n    readCellRef<T>(loadFn_T: LoadCallback<T>): CellRef<T> {\n        return { ref: loadFn_T(this.readCell().beginParse()) };\n    }\n    // {{/if:stackReadsCellRef}}\n\n    // {{if:stackReadsMapKV}}\n    readDictionary<K extends c.DictionaryKeyTypes, V>(keySerializer: c.DictionaryKey<K>, valueSerializer: c.DictionaryValue<V>): c.Dictionary<K, V> {\n        if (this.tuple[0].type === 'null') {\n            this.tuple.shift();\n            return c.Dictionary.empty<K, V>(keySerializer, valueSerializer);\n        }\n        return c.Dictionary.loadDirect<K, V>(keySerializer, valueSerializer, this.readCell());\n    }\n    // {{/if:stackReadsMapKV}}\n}\n\n// {{if:has_customPackUnpack}}\n// ————————————————————————————————————————————\n//   custom packToBuilder and unpackFromSlice\n//\n\ntype CustomPackToBuilderFn<T> = (self: T, b: c.Builder) => void\ntype CustomUnpackFromSliceFn<T> = (s: c.Slice) => T\n\nlet customSerializersRegistry: Map<string, [CustomPackToBuilderFn<any> | null, CustomUnpackFromSliceFn<any> | null]> = new Map;\n\nfunction ensureCustomSerializerRegistered(typeName: string) {\n    if (!customSerializersRegistry.has(typeName)) {\n        throw new Error(`Custom packToBuilder/unpackFromSlice was not registered for type 'CONTRACT_CLASS_NAME.${typeName}'.\\n(in Tolk code, they have custom logic \\`fun ${typeName}__packToBuilder\\`)\\nSteps to fix:\\n1) in your code, create and implement\\n > function ${typeName}__packToBuilder(self: ${typeName}, b: Builder): void { ... }\\n > function ${typeName}__unpackFromSlice(s: Slice): ${typeName} { ... }\\n2) register them in advance by calling\\n > CONTRACT_CLASS_NAME.registerCustomPackUnpack('${typeName}', ${typeName}__packToBuilder, ${typeName}__unpackFromSlice);`);\n    }\n}\n\nfunction invokeCustomPackToBuilder<T>(typeName: string, self: T, b: c.Builder) {\n    ensureCustomSerializerRegistered(typeName);\n    customSerializersRegistry.get(typeName)![0]!(self, b);\n}\n\nfunction invokeCustomUnpackFromSlice<T>(typeName: string, s: c.Slice): T {\n    ensureCustomSerializerRegistered(typeName);\n    return customSerializersRegistry.get(typeName)![1]!(s);\n}\n// {{/if:has_customPackUnpack}}\n\n// ————————————————————————————————————————————\n//   auto-generated serializers to/from cells\n//\n\ntype coins = bigint\n\n// {{intNAliases}}\n\n// {{uintNAliases}}\n\n// {{if:has_varIntN}}\n// {{varIntNAliases}}\n// {{/if:has_varIntN}}\n\n// {{if:has_bitsN}}\n// {{sliceAliases}}\n// {{/if:has_bitsN}}\n\n// {{packUnpackSerializers}}\n\n// ————————————————————————————————————————————\n//    class CONTRACT_CLASS_NAME\n//\n\ninterface ExtraSendOptions {\n    bounce?: boolean                    // default: false\n    sendMode?: SendMode                 // default: SendMode.PAY_GAS_SEPARATELY\n    extraCurrencies?: c.ExtraCurrency   // default: empty dict\n}\n\ninterface DeployedAddrOptions {\n    workchain?: number                  // default: 0 (basechain)\n    toShard?: { fixedPrefixLength: number; closeTo: c.Address }\n    overrideContractCode?: c.Cell\n}\n\nfunction calculateDeployedAddress(code: c.Cell, data: c.Cell, options: DeployedAddrOptions): c.Address {\n    const stateInitCell = beginCell().store(c.storeStateInit({\n        code,\n        data,\n        splitDepth: options.toShard?.fixedPrefixLength,\n        special: null,\n        libraries: null,\n    })).endCell();\n\n    let addrHash = stateInitCell.hash();\n    if (options.toShard) {\n        const shardDepth = options.toShard.fixedPrefixLength;\n        addrHash = beginCell()\n            .storeBits(new c.BitString(options.toShard.closeTo.hash, 0, shardDepth))\n            .storeBits(new c.BitString(stateInitCell.hash(), shardDepth, 256 - shardDepth))\n            .endCell()\n            .beginParse().loadBuffer(32);\n    }\n\n    return new c.Address(options.workchain ?? 0, addrHash);\n}\n\nexport class CONTRACT_CLASS_NAME implements c.Contract {\n    static CodeCell = c.Cell.fromBase64('{{codeBoc64}}');\n\n    static Errors = {\n        // {{errorCodes}}\n    }\n\n    readonly address: c.Address\n    readonly init: { code: c.Cell, data: c.Cell } | undefined\n\n    protected constructor(address: c.Address, init?: { code: c.Cell, data: c.Cell }) {\n        this.address = address;\n        this.init = init;\n    }\n\n    // {{if:has_customPackUnpack}}\n    static registerCustomPackUnpack<T>(\n        typeName: string,\n        packToBuilderFn: CustomPackToBuilderFn<T> | null,\n        unpackFromSliceFn: CustomUnpackFromSliceFn<T> | null,\n    ) {\n        if (customSerializersRegistry.has(typeName)) {\n            throw new Error(`Custom pack/unpack for 'CONTRACT_CLASS_NAME.${typeName}' already registered`);\n        }\n        customSerializersRegistry.set(typeName, [packToBuilderFn, unpackFromSliceFn]);\n    }\n    // {{/if:has_customPackUnpack}}\n\n    static fromAddress(address: c.Address) {\n        return new CONTRACT_CLASS_NAME(address);\n    }\n\n    // {{fromStorageMethod}}\n\n    // {{createCellsMethods}}\n\n    // {{if:has_sendDeploy}}\n    async sendDeploy(provider: ContractProvider, via: Sender, msgValue: coins, extraOptions?: ExtraSendOptions) {\n        return provider.internal(via, {\n            value: msgValue,\n            body: c.Cell.EMPTY,\n            ...extraOptions\n        });\n    }\n    // {{/if:has_sendDeploy}}\n\n    // {{sendMethods}}\n\n    // {{getMethods}}\n}\n";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gen-typescript-from-tolk-dev",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Generate TypeScript wrappers from Tolk ABI",
   "author": "TON Core",
   "license": "MIT",