@ton/core/src/dict/utils/internalKeySerializer.ts

Core TypeScript library that implements low level primitives for TON blockchain.

/**
 * Copyright (c) Whales Corp. 
 * All Rights Reserved.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 */

import { Address } from "../../address/Address";
import { BitString } from "../../boc/BitString";
import { bitsToPaddedBuffer, paddedBufferToBits } from "../../boc/utils/paddedBits";

export function serializeInternalKey(value: any): string {
    if (typeof value === 'number') {
        if (!Number.isSafeInteger(value)) {
            throw Error('Invalid key type: not a safe integer: ' + value);
        }
        return 'n:' + value.toString(10);
    } else if (typeof value === 'bigint') {
        return 'b:' + value.toString(10);
    } else if (Address.isAddress(value)) {
        return 'a:' + value.toString();
    } else if (Buffer.isBuffer(value)) {
        return 'f:' + value.toString('hex');
    } else if(BitString.isBitString(value)) {
        return 'B:' + value.toString();
    } else {
        throw Error('Invalid key type');
    }
}

export function deserializeInternalKey(value: string): any {
    let k = value.slice(0, 2);
    let v = value.slice(2);
    if (k === 'n:') {
        return parseInt(v, 10);
    } else if (k === 'b:') {
        return BigInt(v);
    } else if (k === 'a:') {
        return Address.parse(v);
    } else if (k === 'f:') {
        return Buffer.from(v, 'hex');
    }
    else if (k === 'B:') {

        const lastDash = v.slice(-1) == "_";
        const isPadded = lastDash || v.length % 2 != 0;
        if(isPadded) {
            let charLen   = lastDash ? v.length - 1 : v.length;
            const padded  = v.substr(0, charLen) + "0"; //Padding
            if((!lastDash) && ((charLen & 1) !== 0)){
                // Four bit nibmle without padding
                return new BitString(Buffer.from(padded, 'hex'), 0, charLen << 2);
            }
            else {
                return paddedBufferToBits(Buffer.from(padded, 'hex')); 
            }
        }
        else {
            return new BitString(Buffer.from(v, 'hex'), 0, v.length << 2);
        }
    }
    throw Error('Invalid key type: ' + k);
}