TON FunC compiler

Cross-platform bindings for TON FunC compiler.

Features

🚀 No need to compile of download FunC binaries
📦 Works both in Node.js & WEB (WASM support is required)
⚙️ Compiles straight to BOC with code Cell
⚙️ Assembly is returned fot debugging purposes
📁 Does not depend on file-system

How it works

Internally this package uses both FunC compiler and Fift interpreter combined to single lib compiled to WASM.

Simple schema:

(your code) -> WASM(FunC -> Fift -> BOC)

Sources for the internal lib could be found here.

Install

yarn add @ton.org/func-js

npm i @ton.org/func-js

Usage example

import {compileFunc, compilerVersion} from '@ton.org/func-js';
import {Cell} from 'ton';
import {readFileSync} from "fs";


async function main() {
    // You can get compiler version 
    let version = await compilerVersion();
    
    let result = await compileFunc({
        // Entry points of your project
        entryPoints: ["stdlib.fc", "wallet-code.fc"],
        sources: {
            "stdlib.fc": readFileSync('./stdlib.fc', { encoding: 'utf-8' }),
            "wallet-code.fc":  readFileSync('./wallet-code.fc', { encoding: 'utf-8' })
        }
    });
    
    if (result.status === 'error') {
        console.error(result.message)
        return;
    }

    // result.codeBoc contains base64 encoded BOC with code cell 
    let codeCell = Cell.fromBoc(Buffer.from(result.codeBoc, "base64"))[0];
    
    // result.fiftCode contains assembly version of your code (for debug purposes)
    console.log(codeCell)
}

Note that all FunC source files contents used in your project should be passed to sources, including:

entry points
stdlib.fc (if you use it)
all files included in entry points

License