@aztec/bb.js 3.0.0-canary.a9708bd → 3.0.0-manual.20251030

package/src/bindgen/function_declaration.ts

@@ -1,11 +0,0 @@
-export interface Arg {
-  name: string;
-  type: string;
-}
-
-export interface FunctionDeclaration {
-  functionName: string;
-  inArgs: Arg[];
-  outArgs: Arg[];
-  isAsync: boolean;
-}

package/src/bindgen/index.ts

@@ -1,17 +0,0 @@
-import { generateRustCode } from './rust.js';
-import { generateTypeScriptCode } from './typescript.js';
-
-const [, , exp = '../exports.json', lang = 'ts'] = process.argv;
-
-function generateCode(exports: string, lang: string) {
-  switch (lang) {
-    case 'ts':
-      return generateTypeScriptCode(exports);
-    case 'rust':
-      return generateRustCode(exports);
-    default:
-      throw new Error(`Unknown lang: ${lang}`);
-  }
-}
-
-console.log(generateCode(exp, lang));

package/src/bindgen/mappings.ts

@@ -1,67 +0,0 @@
-/* eslint-disable camelcase */
-const typeMap: { [key: string]: string } = {
-  in_ptr: 'Ptr',
-  out_ptr: 'Ptr',
-  'bb::fr::in_buf': 'Fr',
-  'bb::fr::vec_in_buf': 'Fr[]',
-  'fr::in_buf': 'Fr',
-  'fr::out_buf': 'Fr',
-  'fr::vec_in_buf': 'Fr[]',
-  'fr::vec_out_buf': 'Fr[]',
-  'fq::in_buf': 'Fq',
-  'fq::out_buf': 'Fq',
-  'fq::vec_in_buf': 'Fq[]',
-  'fq::vec_out_buf': 'Fq[]',
-  'const uint8_t *': 'Uint8Array',
-  uint8_vec_vec_in_buf: 'Uint8Array[]',
-  'uint8_t **': 'Uint8Array',
-  in_str_buf: 'string',
-  out_str_buf: 'string',
-  in_buf32: 'Buffer32',
-  out_buf32: 'Buffer32',
-  'uint32_t *': 'number',
-  'const uint32_t *': 'number',
-  'affine_element::in_buf': 'Point',
-  'affine_element::out_buf': 'Point',
-  'const bool *': 'boolean',
-  'bool *': 'boolean',
-  'multisig::MultiSigPublicKey::vec_in_buf': 'Buffer128[]',
-  'multisig::MultiSigPublicKey::out_buf': 'Buffer128',
-  'multisig::RoundOnePublicOutput::vec_in_buf': 'Buffer128[]',
-  'multisig::RoundOnePublicOutput::out_buf': 'Buffer128',
-  'multisig::RoundOnePrivateOutput::in_buf': 'Buffer128',
-  'multisig::RoundOnePrivateOutput::out_buf': 'Buffer128',
-};
-
-const deserializerMap: { [key: string]: string } = {
-  out_ptr: 'Ptr',
-  'fr::out_buf': 'Fr',
-  'fr::vec_out_buf': 'VectorDeserializer(Fr)',
-  'fq::out_buf': 'Fq',
-  'fq::vec_out_buf': 'VectorDeserializer(Fq)',
-  'uint8_t **': 'BufferDeserializer()',
-  out_str_buf: 'StringDeserializer()',
-  out_buf32: 'Buffer32',
-  'uint32_t *': 'NumberDeserializer()',
-  'affine_element::out_buf': 'Point',
-  'bool *': 'BoolDeserializer()',
-  'multisig::MultiSigPublicKey::out_buf': 'Buffer128',
-  'multisig::RoundOnePublicOutput::out_buf': 'Buffer128',
-  'multisig::RoundOnePrivateOutput::out_buf': 'Buffer128',
-};
-
-export function mapType(type: string) {
-  if (typeMap[type]) {
-    return typeMap[type];
-  }
-  throw new Error(`Unknown type: ${type}`);
-}
-
-export const mapRustType = mapType;
-
-export function mapDeserializer(type: string) {
-  if (deserializerMap[type]) {
-    return deserializerMap[type];
-  }
-  throw new Error(`Unknown deserializer for type: ${type}`);
-}

package/src/bindgen/rust.ts

@@ -1,52 +0,0 @@
-import fs from 'fs';
-import { Arg, FunctionDeclaration } from './function_declaration.js';
-import { mapDeserializer, mapRustType } from './mappings.js';
-
-export function generateRustCode(filename: string) {
-  const fileContent = fs.readFileSync(filename, 'utf-8');
-  const functionDeclarations: FunctionDeclaration[] = JSON.parse(fileContent);
-
-  let output = `
-// WARNING: FILE CODE GENERATED BY BINDGEN UTILITY. DO NOT EDIT!
-use crate::call_wasm_export::call_wasm_export;
-use crate::serialize::{BufferDeserializer, NumberDeserializer, VectorDeserializer, BoolDeserializer};
-use crate::types::{Fr, Fq, Point, Buffer32, Buffer128};
-`;
-
-  for (const { functionName, inArgs, outArgs } of functionDeclarations) {
-    const parameters = inArgs.map(({ name, type }) => `${name}: ${mapRustType(type)}`).join(', ');
-    const inArgsVar = `let in_args = vec![${inArgs.map(arg => arg.name).join(', ')}];`;
-    const outTypesVar = `let out_types = vec![${outArgs.map(arg => mapDeserializer(arg.type)).join(', ')}];`;
-    const wasmCall = `let result = call_wasm_export(&"${functionName}", &in_args, &out_types)?;`;
-
-    const returnStmt = getReturnStmt(outArgs);
-    const returnType =
-      outArgs.length === 0
-        ? '-> Result<(), Box<dyn std::error::Error>>'
-        : `-> Result<(${outArgs.map(a => mapRustType(a.type)).join(', ')}), Box<dyn std::error::Error>>`;
-
-    const functionDecl = `
-pub fn ${functionName}(${parameters})${returnType} {
-    ${inArgsVar}
-    ${outTypesVar}
-    ${wasmCall}
-    ${returnStmt}
-}
-`;
-
-    output += functionDecl;
-  }
-
-  return output;
-}
-
-function getReturnStmt(outArgs: Arg[]) {
-  switch (outArgs.length) {
-    case 0:
-      return 'Ok(())';
-    case 1:
-      return `Ok(result[0].clone())`;
-    default:
-      return `Ok((${outArgs.map((_, idx) => `result[${idx}].clone()`).join(', ')}))`;
-  }
-}

package/src/bindgen/to_camel_case.ts

@@ -1,10 +0,0 @@
-export function toCamelCase(input: string): string {
-  const words = input.split('_');
-  const camelCasedWords = words.map((word, index) => {
-    if (index === 0) {
-      return word;
-    }
-    return word.charAt(0).toUpperCase() + word.slice(1);
-  });
-  return camelCasedWords.join('');
-}

package/src/bindgen/typescript.ts

@@ -1,116 +0,0 @@
-import fs from 'fs';
-import { mapDeserializer, mapType } from './mappings.js';
-import { toCamelCase } from './to_camel_case.js';
-import { FunctionDeclaration } from './function_declaration.js';
-
-export function generateTypeScriptCode(filename: string) {
-  const fileContent = fs.readFileSync(filename, 'utf-8');
-  const functionDeclarations: FunctionDeclaration[] = JSON.parse(fileContent);
-
-  let output = `// WARNING: FILE CODE GENERATED BY BINDGEN UTILITY. DO NOT EDIT!
-/* eslint-disable @typescript-eslint/no-unused-vars */
-import { BarretenbergWasmMain, BarretenbergWasmMainWorker } from '../barretenberg_wasm/barretenberg_wasm_main/index.js';
-import { BufferDeserializer, NumberDeserializer, VectorDeserializer, BoolDeserializer, StringDeserializer, serializeBufferable, OutputType } from '../serialize/index.js';
-import { Fr, Point, Buffer32, Ptr } from '../types/index.js';
-
-`;
-
-  output += generateClass(functionDeclarations);
-  output += generateSyncClass(functionDeclarations);
-
-  return output;
-}
-
-function generateClass(functionDeclarations: FunctionDeclaration[]) {
-  let output = `
-export class BarretenbergApi {
-  constructor(protected wasm: BarretenbergWasmMainWorker) {}
-
-`;
-
-  for (const { functionName, inArgs, outArgs } of functionDeclarations) {
-    try {
-      const parameters = inArgs.map(({ name, type }) => `${toCamelCase(name)}: ${mapType(type)}`).join(', ');
-      const inArgsVar = `const inArgs = [${inArgs
-        .map(arg => toCamelCase(arg.name))
-        .join(', ')}].map(serializeBufferable);`;
-      const outTypesVar = `const outTypes: OutputType[] = [${outArgs
-        .map(arg => mapDeserializer(arg.type))
-        .join(', ')}];`;
-      const wasmCall = `const result = await this.wasm.callWasmExport('${functionName}', inArgs, outTypes.map(t=>t.SIZE_IN_BYTES));`;
-      const outVar = `const out = result.map((r, i) => outTypes[i].fromBuffer(r));`;
-
-      const n = outArgs.length;
-      const returnStmt = n === 0 ? 'return;' : n === 1 ? 'return out[0];' : 'return out as any;';
-      const returnType =
-        outArgs.length === 0
-          ? 'void'
-          : outArgs.length === 1
-            ? `${mapType(outArgs[0].type)}`
-            : `[${outArgs.map(a => mapType(a.type)).join(', ')}]`;
-
-      output += `
-  async ${toCamelCase(functionName)}(${parameters}): Promise<${returnType}> {
-    ${inArgsVar}
-    ${outTypesVar}
-    ${wasmCall}
-    ${outVar}
-    ${returnStmt}
-  }
-`;
-    } catch (err: any) {
-      throw new Error(`Function ${functionName}: ${err.message}`);
-    }
-  }
-
-  output += `}`;
-
-  return output;
-}
-
-function generateSyncClass(functionDeclarations: FunctionDeclaration[]) {
-  let output = `
-export class BarretenbergApiSync {
-  constructor(protected wasm: BarretenbergWasmMain) {}
-
-`;
-
-  for (const { functionName, inArgs, outArgs } of functionDeclarations) {
-    try {
-      const parameters = inArgs.map(({ name, type }) => `${toCamelCase(name)}: ${mapType(type)}`).join(', ');
-      const inArgsVar = `const inArgs = [${inArgs
-        .map(arg => toCamelCase(arg.name))
-        .join(', ')}].map(serializeBufferable);`;
-      const outTypesVar = `const outTypes: OutputType[] = [${outArgs
-        .map(arg => mapDeserializer(arg.type))
-        .join(', ')}];`;
-      const wasmCall = `const result = this.wasm.callWasmExport('${functionName}', inArgs, outTypes.map(t=>t.SIZE_IN_BYTES));`;
-      const outVar = `const out = result.map((r, i) => outTypes[i].fromBuffer(r));`;
-
-      const n = outArgs.length;
-      const returnStmt = n === 0 ? 'return;' : n === 1 ? 'return out[0];' : 'return out as any;';
-      const returnType =
-        outArgs.length === 0
-          ? 'void'
-          : outArgs.length === 1
-            ? `${mapType(outArgs[0].type)}`
-            : `[${outArgs.map(a => mapType(a.type)).join(', ')}]`;
-
-      output += `
-  ${toCamelCase(functionName)}(${parameters}): ${returnType} {
-    ${inArgsVar}
-    ${outTypesVar}
-    ${wasmCall}
-    ${outVar}
-    ${returnStmt}
-  }
-`;
-    } catch (err: any) {
-      throw new Error(`Function ${functionName}: ${err.message}`);
-    }
-  }
-
-  output += `}`;
-
-  return output;
-}