@corpus-core/colibri-stateless 1.1.20 → 1.1.22

package/README.md

@@ -2,11 +2,11 @@
 
 <img src="c4_logo.png" alt="C4 Logo" width="300"/>
 
-# C4 (corpus core colibri client)
+# Colibri-stateless
 
 ![ETH2.0_Spec_Version 1.4.0](https://img.shields.io/badge/ETH2.0_Spec_Version-1.4.0-2e86c1.svg)
 
-The colibri client is a stateless and trustless ethereum client, which is optimized for the mobile apps or embedded devices, because it does not hols the state, but verifies on demand. 
+The colibri client is a stateless and trustless ethereum client, which is optimized for the mobile apps or embedded devices, because it does not hold any state, but verifies on demand.
 
 ## Installation
 
@@ -220,11 +220,35 @@ The constructor of the colibri client accepts a configuration-object, which may
         "https://eth-mainnet.g.alchemy.com/v2/<APIKEY>",
         "https://rpc.ankr.com/eth/<APIKEY>" ]})
      ```
-- `prover` - urls for remove prover
-    a array of endpoints for remote prover. This allows to generate the proof in the backend, where caches can speed up the process.
+- `prover` - urls for remote prover
+    an array of endpoints for remote prover. This allows to generate the proof in the backend, where caches can speed up the process.
     ```js
     new Colibri({ prover: ["https://mainnet.colibri-proof.tech" ]})
     ```
+- `prover_mode` - proof generation mode (default: `"remote"` if prover URLs configured, otherwise `"local"`)
+    Controls how proofs are built and verified. Five modes are available:
+    - `"local"` -- Proofs are built entirely on the client. Requires access to a Beacon API and execution layer RPC. Fully trustless, but slower and needs more infrastructure.
+    - `"remote"` -- Proofs are fetched from a remote Colibri prover server. Fastest option but relies on the prover server for proof generation. The verifier still cryptographically checks every proof.
+    - `"hybrid"` -- The consensus-layer proof (BlockHeaderProof) comes from the Colibri server, while execution-layer data (account proofs, storage, etc.) is fetched directly from the RPC provider. Best balance of performance and scalability -- the Colibri server only serves lightweight, cacheable header proofs while the heavy RPC load goes to your existing provider.
+    - `"proxy"` -- Like remote, but the client sends its own RPC and Beacon API URLs to the prover server. The server uses these endpoints instead of its own. Useful when the client has access to private or premium RPC providers.
+    - `"light_client"` -- Like hybrid, with additional background polling of block headers to keep the cache warm. Call `startLightClient()` / `stopLightClient()` to control polling. Default interval: 12000ms. By default only the compact `eth_getBlockHeader` is fetched; pass `fullBlock: true` to fetch the full block (useful when many `eth_getTransactionByHash` / `eth_getTransactionReceipt` calls follow).
+    ```js
+    // Explicit hybrid mode
+    new Colibri({
+      prover: ["https://mainnet.colibri-proof.tech"],
+      rpcs: ["https://eth-mainnet.g.alchemy.com/v2/<APIKEY>"],
+      prover_mode: "hybrid"
+    })
+
+    // Light client mode
+    const client = new Colibri({
+      prover: ["https://mainnet.colibri-proof.tech"],
+      rpcs: ["https://eth-mainnet.g.alchemy.com/v2/<APIKEY>"],
+      prover_mode: "light_client"
+    });
+    client.startLightClient();              // polls eth_getBlockHeader every 12s
+    client.startLightClient(12000, true);   // or fetch the full block
+    ```
 - `zk_proof` - use remote ZK sync proof for bootstrap (default: `false`)
     If `true`, the verifier will bootstrap the initial sync committee using the ZK proof (`ZKSyncData`) provided by the remote prover, instead of initializing via `checkpointz` / trusted checkpoints.
     ```js

package/c4w.js

@@ -5,7 +5,7 @@ var c4w = (() => {
 async function(moduleArg = {}) {
   var moduleRtn;
 
-var Module=moduleArg;var readyPromiseResolve,readyPromiseReject;var readyPromise=new Promise((resolve,reject)=>{readyPromiseResolve=resolve;readyPromiseReject=reject});var ENVIRONMENT_IS_WEB=typeof window=="object";var ENVIRONMENT_IS_WORKER=typeof WorkerGlobalScope!="undefined";var ENVIRONMENT_IS_NODE=typeof process=="object"&&typeof process.versions=="object"&&typeof process.versions.node=="string"&&process.type!="renderer";var moduleOverrides=Object.assign({},Module);var arguments_=[];var thisProgram="./this.program";var quit_=(status,toThrow)=>{throw toThrow};var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var readAsync,readBinary;if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){if(ENVIRONMENT_IS_WORKER){scriptDirectory=self.location.href}else if(typeof document!="undefined"&&document.currentScript){scriptDirectory=document.currentScript.src}if(_scriptName){scriptDirectory=_scriptName}if(scriptDirectory.startsWith("blob:")){scriptDirectory=""}else{scriptDirectory=scriptDirectory.slice(0,scriptDirectory.replace(/[?#].*/,"").lastIndexOf("/")+1)}{if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=async url=>{var response=await fetch(url,{credentials:"same-origin"});if(response.ok){return response.arrayBuffer()}throw new Error(response.status+" : "+response.url)}}}else{}var out=Module["print"]||console.log.bind(console);var err=Module["printErr"]||console.error.bind(console);Object.assign(Module,moduleOverrides);moduleOverrides=null;if(Module["arguments"])arguments_=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];var wasmBinary=Module["wasmBinary"];var wasmMemory;var ABORT=false;var EXITSTATUS;var HEAP8,HEAPU8,HEAP16,HEAPU16,HEAP32,HEAPU32,HEAPF32,HEAP64,HEAPU64,HEAPF64;var runtimeInitialized=false;function updateMemoryViews(){var b=wasmMemory.buffer;Module["HEAP8"]=HEAP8=new Int8Array(b);Module["HEAP16"]=HEAP16=new Int16Array(b);Module["HEAPU8"]=HEAPU8=new Uint8Array(b);Module["HEAPU16"]=HEAPU16=new Uint16Array(b);Module["HEAP32"]=HEAP32=new Int32Array(b);Module["HEAPU32"]=HEAPU32=new Uint32Array(b);Module["HEAPF32"]=HEAPF32=new Float32Array(b);Module["HEAPF64"]=HEAPF64=new Float64Array(b);Module["HEAP64"]=HEAP64=new BigInt64Array(b);Module["HEAPU64"]=HEAPU64=new BigUint64Array(b)}function preRun(){if(Module["preRun"]){if(typeof Module["preRun"]=="function")Module["preRun"]=[Module["preRun"]];while(Module["preRun"].length){addOnPreRun(Module["preRun"].shift())}}callRuntimeCallbacks(onPreRuns)}function initRuntime(){runtimeInitialized=true;wasmExports["r"]()}function postRun(){if(Module["postRun"]){if(typeof Module["postRun"]=="function")Module["postRun"]=[Module["postRun"]];while(Module["postRun"].length){addOnPostRun(Module["postRun"].shift())}}callRuntimeCallbacks(onPostRuns)}var runDependencies=0;var dependenciesFulfilled=null;function addRunDependency(id){runDependencies++;Module["monitorRunDependencies"]?.(runDependencies)}function removeRunDependency(id){runDependencies--;Module["monitorRunDependencies"]?.(runDependencies);if(runDependencies==0){if(dependenciesFulfilled){var callback=dependenciesFulfilled;dependenciesFulfilled=null;callback()}}}function abort(what){Module["onAbort"]?.(what);what="Aborted("+what+")";err(what);ABORT=true;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);readyPromiseReject(e);throw e}var wasmBinaryFile;function findWasmBinary(){if(Module["locateFile"]){return locateFile("c4w.wasm")}return new URL("c4w.wasm",import.meta.url).href}function getBinarySync(file){if(file==wasmBinaryFile&&wasmBinary){return new Uint8Array(wasmBinary)}if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}async function getWasmBinary(binaryFile){if(!wasmBinary){try{var response=await readAsync(binaryFile);return new Uint8Array(response)}catch{}}return getBinarySync(binaryFile)}async function instantiateArrayBuffer(binaryFile,imports){try{var binary=await getWasmBinary(binaryFile);var instance=await WebAssembly.instantiate(binary,imports);return instance}catch(reason){err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)}}async function instantiateAsync(binary,binaryFile,imports){if(!binary&&typeof WebAssembly.instantiateStreaming=="function"){try{var response=fetch(binaryFile,{credentials:"same-origin"});var instantiationResult=await WebAssembly.instantiateStreaming(response,imports);return instantiationResult}catch(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation")}}return instantiateArrayBuffer(binaryFile,imports)}function getWasmImports(){return{a:wasmImports}}async function createWasm(){function receiveInstance(instance,module){wasmExports=instance.exports;wasmMemory=wasmExports["q"];updateMemoryViews();removeRunDependency("wasm-instantiate");return wasmExports}addRunDependency("wasm-instantiate");function receiveInstantiationResult(result){return receiveInstance(result["instance"])}var info=getWasmImports();if(Module["instantiateWasm"]){return new Promise((resolve,reject)=>{Module["instantiateWasm"](info,(mod,inst)=>{receiveInstance(mod,inst);resolve(mod.exports)})})}wasmBinaryFile??=findWasmBinary();try{var result=await instantiateAsync(wasmBinary,wasmBinaryFile,info);var exports=receiveInstantiationResult(result);return exports}catch(e){readyPromiseReject(e);return Promise.reject(e)}}var ASM_CONSTS={169004:($0,$1)=>{var keyStr=UTF8ToString($0);var data=Module.storage.get(keyStr);if(data){var bufferPtr=_c4w_buffer_alloc($1,data.length);HEAPU8.set(data,bufferPtr);return 1}return 0},169192:($0,$1,$2)=>{var keyStr=UTF8ToString($0);var array=new Uint8Array($2);array.set(HEAPU8.subarray($1,$1+$2));Module.storage.set(keyStr,array)},169335:$0=>{var keyStr=UTF8ToString($0);Module.storage.del(keyStr)}};class ExitStatus{name="ExitStatus";constructor(status){this.message=`Program terminated with exit(${status})`;this.status=status}}var callRuntimeCallbacks=callbacks=>{while(callbacks.length>0){callbacks.shift()(Module)}};var onPostRuns=[];var addOnPostRun=cb=>onPostRuns.unshift(cb);var onPreRuns=[];var addOnPreRun=cb=>onPreRuns.unshift(cb);var noExitRuntime=Module["noExitRuntime"]||true;var stackRestore=val=>__emscripten_stack_restore(val);var stackSave=()=>_emscripten_stack_get_current();var UTF8Decoder=typeof TextDecoder!="undefined"?new TextDecoder:undefined;var UTF8ArrayToString=(heapOrArray,idx=0,maxBytesToRead=NaN)=>{var endIdx=idx+maxBytesToRead;var endPtr=idx;while(heapOrArray[endPtr]&&!(endPtr>=endIdx))++endPtr;if(endPtr-idx>16&&heapOrArray.buffer&&UTF8Decoder){return UTF8Decoder.decode(heapOrArray.subarray(idx,endPtr))}var str="";while(idx<endPtr){var u0=heapOrArray[idx++];if(!(u0&128)){str+=String.fromCharCode(u0);continue}var u1=heapOrArray[idx++]&63;if((u0&224)==192){str+=String.fromCharCode((u0&31)<<6|u1);continue}var u2=heapOrArray[idx++]&63;if((u0&240)==224){u0=(u0&15)<<12|u1<<6|u2}else{u0=(u0&7)<<18|u1<<12|u2<<6|heapOrArray[idx++]&63}if(u0<65536){str+=String.fromCharCode(u0)}else{var ch=u0-65536;str+=String.fromCharCode(55296|ch>>10,56320|ch&1023)}}return str};var UTF8ToString=(ptr,maxBytesToRead)=>ptr?UTF8ArrayToString(HEAPU8,ptr,maxBytesToRead):"";var ___assert_fail=(condition,filename,line,func)=>abort(`Assertion failed: ${UTF8ToString(condition)}, at: `+[filename?UTF8ToString(filename):"unknown filename",line,func?UTF8ToString(func):"unknown function"]);class ExceptionInfo{constructor(excPtr){this.excPtr=excPtr;this.ptr=excPtr-24}set_type(type){HEAPU32[this.ptr+4>>2]=type}get_type(){return HEAPU32[this.ptr+4>>2]}set_destructor(destructor){HEAPU32[this.ptr+8>>2]=destructor}get_destructor(){return HEAPU32[this.ptr+8>>2]}set_caught(caught){caught=caught?1:0;HEAP8[this.ptr+12]=caught}get_caught(){return HEAP8[this.ptr+12]!=0}set_rethrown(rethrown){rethrown=rethrown?1:0;HEAP8[this.ptr+13]=rethrown}get_rethrown(){return HEAP8[this.ptr+13]!=0}init(type,destructor){this.set_adjusted_ptr(0);this.set_type(type);this.set_destructor(destructor)}set_adjusted_ptr(adjustedPtr){HEAPU32[this.ptr+16>>2]=adjustedPtr}get_adjusted_ptr(){return HEAPU32[this.ptr+16>>2]}}var exceptionLast=0;var uncaughtExceptionCount=0;var ___cxa_throw=(ptr,type,destructor)=>{var info=new ExceptionInfo(ptr);info.init(type,destructor);exceptionLast=ptr;uncaughtExceptionCount++;throw exceptionLast};var SYSCALLS={varargs:undefined,getStr(ptr){var ret=UTF8ToString(ptr);return ret}};function ___syscall_fcntl64(fd,cmd,varargs){SYSCALLS.varargs=varargs;return 0}function ___syscall_ioctl(fd,op,varargs){SYSCALLS.varargs=varargs;return 0}function ___syscall_openat(dirfd,path,flags,varargs){SYSCALLS.varargs=varargs}var __abort_js=()=>abort("");var stringToUTF8Array=(str,heap,outIdx,maxBytesToWrite)=>{if(!(maxBytesToWrite>0))return 0;var startIdx=outIdx;var endIdx=outIdx+maxBytesToWrite-1;for(var i=0;i<str.length;++i){var u=str.charCodeAt(i);if(u>=55296&&u<=57343){var u1=str.charCodeAt(++i);u=65536+((u&1023)<<10)|u1&1023}if(u<=127){if(outIdx>=endIdx)break;heap[outIdx++]=u}else if(u<=2047){if(outIdx+1>=endIdx)break;heap[outIdx++]=192|u>>6;heap[outIdx++]=128|u&63}else if(u<=65535){if(outIdx+2>=endIdx)break;heap[outIdx++]=224|u>>12;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}else{if(outIdx+3>=endIdx)break;heap[outIdx++]=240|u>>18;heap[outIdx++]=128|u>>12&63;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}}heap[outIdx]=0;return outIdx-startIdx};var stringToUTF8=(str,outPtr,maxBytesToWrite)=>stringToUTF8Array(str,HEAPU8,outPtr,maxBytesToWrite);var __tzset_js=(timezone,daylight,std_name,dst_name)=>{var currentYear=(new Date).getFullYear();var winter=new Date(currentYear,0,1);var summer=new Date(currentYear,6,1);var winterOffset=winter.getTimezoneOffset();var summerOffset=summer.getTimezoneOffset();var stdTimezoneOffset=Math.max(winterOffset,summerOffset);HEAPU32[timezone>>2]=stdTimezoneOffset*60;HEAP32[daylight>>2]=Number(winterOffset!=summerOffset);var extractZone=timezoneOffset=>{var sign=timezoneOffset>=0?"-":"+";var absOffset=Math.abs(timezoneOffset);var hours=String(Math.floor(absOffset/60)).padStart(2,"0");var minutes=String(absOffset%60).padStart(2,"0");return`UTC${sign}${hours}${minutes}`};var winterName=extractZone(winterOffset);var summerName=extractZone(summerOffset);if(summerOffset<winterOffset){stringToUTF8(winterName,std_name,17);stringToUTF8(summerName,dst_name,17)}else{stringToUTF8(winterName,dst_name,17);stringToUTF8(summerName,std_name,17)}};var readEmAsmArgsArray=[];var readEmAsmArgs=(sigPtr,buf)=>{readEmAsmArgsArray.length=0;var ch;while(ch=HEAPU8[sigPtr++]){var wide=ch!=105;wide&=ch!=112;buf+=wide&&buf%8?4:0;readEmAsmArgsArray.push(ch==112?HEAPU32[buf>>2]:ch==106?HEAP64[buf>>3]:ch==105?HEAP32[buf>>2]:HEAPF64[buf>>3]);buf+=wide?8:4}return readEmAsmArgsArray};var runEmAsmFunction=(code,sigPtr,argbuf)=>{var args=readEmAsmArgs(sigPtr,argbuf);return ASM_CONSTS[code](...args)};var _emscripten_asm_const_int=(code,sigPtr,argbuf)=>runEmAsmFunction(code,sigPtr,argbuf);var getHeapMax=()=>2147483648;var alignMemory=(size,alignment)=>Math.ceil(size/alignment)*alignment;var growMemory=size=>{var b=wasmMemory.buffer;var pages=(size-b.byteLength+65535)/65536|0;try{wasmMemory.grow(pages);updateMemoryViews();return 1}catch(e){}};var _emscripten_resize_heap=requestedSize=>{var oldSize=HEAPU8.length;requestedSize>>>=0;var maxHeapSize=getHeapMax();if(requestedSize>maxHeapSize){return false}for(var cutDown=1;cutDown<=4;cutDown*=2){var overGrownHeapSize=oldSize*(1+.2/cutDown);overGrownHeapSize=Math.min(overGrownHeapSize,requestedSize+100663296);var newSize=Math.min(maxHeapSize,alignMemory(Math.max(requestedSize,overGrownHeapSize),65536));var replacement=growMemory(newSize);if(replacement){return true}}return false};var ENV={};var getExecutableName=()=>thisProgram||"./this.program";var getEnvStrings=()=>{if(!getEnvStrings.strings){var lang=(typeof navigator=="object"&&navigator.languages&&navigator.languages[0]||"C").replace("-","_")+".UTF-8";var env={USER:"web_user",LOGNAME:"web_user",PATH:"/",PWD:"/",HOME:"/home/web_user",LANG:lang,_:getExecutableName()};for(var x in ENV){if(ENV[x]===undefined)delete env[x];else env[x]=ENV[x]}var strings=[];for(var x in env){strings.push(`${x}=${env[x]}`)}getEnvStrings.strings=strings}return getEnvStrings.strings};var stringToAscii=(str,buffer)=>{for(var i=0;i<str.length;++i){HEAP8[buffer++]=str.charCodeAt(i)}HEAP8[buffer]=0};var _environ_get=(__environ,environ_buf)=>{var bufSize=0;getEnvStrings().forEach((string,i)=>{var ptr=environ_buf+bufSize;HEAPU32[__environ+i*4>>2]=ptr;stringToAscii(string,ptr);bufSize+=string.length+1});return 0};var _environ_sizes_get=(penviron_count,penviron_buf_size)=>{var strings=getEnvStrings();HEAPU32[penviron_count>>2]=strings.length;var bufSize=0;strings.forEach(string=>bufSize+=string.length+1);HEAPU32[penviron_buf_size>>2]=bufSize;return 0};var runtimeKeepaliveCounter=0;var keepRuntimeAlive=()=>noExitRuntime||runtimeKeepaliveCounter>0;var _proc_exit=code=>{EXITSTATUS=code;if(!keepRuntimeAlive()){Module["onExit"]?.(code);ABORT=true}quit_(code,new ExitStatus(code))};var exitJS=(status,implicit)=>{EXITSTATUS=status;_proc_exit(status)};var _exit=exitJS;var _fd_close=fd=>52;var _fd_read=(fd,iov,iovcnt,pnum)=>52;var INT53_MAX=9007199254740992;var INT53_MIN=-9007199254740992;var bigintToI53Checked=num=>num<INT53_MIN||num>INT53_MAX?NaN:Number(num);function _fd_seek(fd,offset,whence,newOffset){offset=bigintToI53Checked(offset);return 70}var printCharBuffers=[null,[],[]];var printChar=(stream,curr)=>{var buffer=printCharBuffers[stream];if(curr===0||curr===10){(stream===1?out:err)(UTF8ArrayToString(buffer));buffer.length=0}else{buffer.push(curr)}};var _fd_write=(fd,iov,iovcnt,pnum)=>{var num=0;for(var i=0;i<iovcnt;i++){var ptr=HEAPU32[iov>>2];var len=HEAPU32[iov+4>>2];iov+=8;for(var j=0;j<len;j++){printChar(fd,HEAPU8[ptr+j])}num+=len}HEAPU32[pnum>>2]=num;return 0};var getCFunc=ident=>{var func=Module["_"+ident];return func};var writeArrayToMemory=(array,buffer)=>{HEAP8.set(array,buffer)};var lengthBytesUTF8=str=>{var len=0;for(var i=0;i<str.length;++i){var c=str.charCodeAt(i);if(c<=127){len++}else if(c<=2047){len+=2}else if(c>=55296&&c<=57343){len+=4;++i}else{len+=3}}return len};var stackAlloc=sz=>__emscripten_stack_alloc(sz);var stringToUTF8OnStack=str=>{var size=lengthBytesUTF8(str)+1;var ret=stackAlloc(size);stringToUTF8(str,ret,size);return ret};var ccall=(ident,returnType,argTypes,args,opts)=>{var toC={string:str=>{var ret=0;if(str!==null&&str!==undefined&&str!==0){ret=stringToUTF8OnStack(str)}return ret},array:arr=>{var ret=stackAlloc(arr.length);writeArrayToMemory(arr,ret);return ret}};function convertReturnValue(ret){if(returnType==="string"){return UTF8ToString(ret)}if(returnType==="boolean")return Boolean(ret);return ret}var func=getCFunc(ident);var cArgs=[];var stack=0;if(args){for(var i=0;i<args.length;i++){var converter=toC[argTypes[i]];if(converter){if(stack===0)stack=stackSave();cArgs[i]=converter(args[i])}else{cArgs[i]=args[i]}}}var ret=func(...cArgs);function onDone(ret){if(stack!==0)stackRestore(stack);return convertReturnValue(ret)}ret=onDone(ret);return ret};var cwrap=(ident,returnType,argTypes,opts)=>{var numericArgs=!argTypes||argTypes.every(type=>type==="number"||type==="boolean");var numericRet=returnType!=="string";if(numericRet&&numericArgs&&!opts){return getCFunc(ident)}return(...args)=>ccall(ident,returnType,argTypes,args,opts)};var wasmImports={a:___assert_fail,b:___cxa_throw,g:___syscall_fcntl64,i:___syscall_ioctl,j:___syscall_openat,l:__abort_js,k:__tzset_js,d:_emscripten_asm_const_int,m:_emscripten_resize_heap,o:_environ_get,p:_environ_sizes_get,c:_exit,e:_fd_close,h:_fd_read,n:_fd_seek,f:_fd_write};var wasmExports=await createWasm();var ___wasm_call_ctors=wasmExports["r"];var _c4w_create_proof_ctx=Module["_c4w_create_proof_ctx"]=wasmExports["s"];var _c4w_free_proof_ctx=Module["_c4w_free_proof_ctx"]=wasmExports["t"];var _c4w_execute_proof_ctx=Module["_c4w_execute_proof_ctx"]=wasmExports["u"];var _c4w_req_set_response=Module["_c4w_req_set_response"]=wasmExports["v"];var _c4w_req_set_error=Module["_c4w_req_set_error"]=wasmExports["w"];var _c4w_create_verify_ctx=Module["_c4w_create_verify_ctx"]=wasmExports["x"];var _c4w_free_verify_ctx=Module["_c4w_free_verify_ctx"]=wasmExports["y"];var _free=Module["_free"]=wasmExports["z"];var _c4w_verify_proof=Module["_c4w_verify_proof"]=wasmExports["A"];var _c4w_get_method_type=Module["_c4w_get_method_type"]=wasmExports["B"];var _c4w_create_rpc_ctx=Module["_c4w_create_rpc_ctx"]=wasmExports["C"];var _c4w_execute_rpc_ctx=Module["_c4w_execute_rpc_ctx"]=wasmExports["D"];var _c4w_free_rpc_ctx=Module["_c4w_free_rpc_ctx"]=wasmExports["E"];var _c4w_set_checkpoint=Module["_c4w_set_checkpoint"]=wasmExports["F"];var _c4w_rpc_ctx_set_witness_keys=Module["_c4w_rpc_ctx_set_witness_keys"]=wasmExports["G"];var _c4w_decode_proof=Module["_c4w_decode_proof"]=wasmExports["H"];var _c4w_req_free=Module["_c4w_req_free"]=wasmExports["I"];var _c4w_buffer_alloc=Module["_c4w_buffer_alloc"]=wasmExports["J"];var _init_storage=Module["_init_storage"]=wasmExports["K"];var _c4w_get_current_version_number=Module["_c4w_get_current_version_number"]=wasmExports["L"];var _malloc=Module["_malloc"]=wasmExports["N"];var __emscripten_stack_restore=wasmExports["O"];var __emscripten_stack_alloc=wasmExports["P"];var _emscripten_stack_get_current=wasmExports["Q"];Module["ccall"]=ccall;Module["cwrap"]=cwrap;Module["UTF8ToString"]=UTF8ToString;Module["stringToUTF8"]=stringToUTF8;function run(){if(runDependencies>0){dependenciesFulfilled=run;return}preRun();if(runDependencies>0){dependenciesFulfilled=run;return}function doRun(){Module["calledRun"]=true;if(ABORT)return;initRuntime();readyPromiseResolve(Module);Module["onRuntimeInitialized"]?.();postRun()}if(Module["setStatus"]){Module["setStatus"]("Running...");setTimeout(()=>{setTimeout(()=>Module["setStatus"](""),1);doRun()},1)}else{doRun()}}if(Module["preInit"]){if(typeof Module["preInit"]=="function")Module["preInit"]=[Module["preInit"]];while(Module["preInit"].length>0){Module["preInit"].pop()()}}run();moduleRtn=readyPromise;
+var Module=moduleArg;var readyPromiseResolve,readyPromiseReject;var readyPromise=new Promise((resolve,reject)=>{readyPromiseResolve=resolve;readyPromiseReject=reject});var ENVIRONMENT_IS_WEB=typeof window=="object";var ENVIRONMENT_IS_WORKER=typeof WorkerGlobalScope!="undefined";var ENVIRONMENT_IS_NODE=typeof process=="object"&&typeof process.versions=="object"&&typeof process.versions.node=="string"&&process.type!="renderer";var moduleOverrides=Object.assign({},Module);var arguments_=[];var thisProgram="./this.program";var quit_=(status,toThrow)=>{throw toThrow};var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var readAsync,readBinary;if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){if(ENVIRONMENT_IS_WORKER){scriptDirectory=self.location.href}else if(typeof document!="undefined"&&document.currentScript){scriptDirectory=document.currentScript.src}if(_scriptName){scriptDirectory=_scriptName}if(scriptDirectory.startsWith("blob:")){scriptDirectory=""}else{scriptDirectory=scriptDirectory.slice(0,scriptDirectory.replace(/[?#].*/,"").lastIndexOf("/")+1)}{if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=async url=>{var response=await fetch(url,{credentials:"same-origin"});if(response.ok){return response.arrayBuffer()}throw new Error(response.status+" : "+response.url)}}}else{}var out=Module["print"]||console.log.bind(console);var err=Module["printErr"]||console.error.bind(console);Object.assign(Module,moduleOverrides);moduleOverrides=null;if(Module["arguments"])arguments_=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];var wasmBinary=Module["wasmBinary"];var wasmMemory;var ABORT=false;var EXITSTATUS;var HEAP8,HEAPU8,HEAP16,HEAPU16,HEAP32,HEAPU32,HEAPF32,HEAP64,HEAPU64,HEAPF64;var runtimeInitialized=false;function updateMemoryViews(){var b=wasmMemory.buffer;Module["HEAP8"]=HEAP8=new Int8Array(b);Module["HEAP16"]=HEAP16=new Int16Array(b);Module["HEAPU8"]=HEAPU8=new Uint8Array(b);Module["HEAPU16"]=HEAPU16=new Uint16Array(b);Module["HEAP32"]=HEAP32=new Int32Array(b);Module["HEAPU32"]=HEAPU32=new Uint32Array(b);Module["HEAPF32"]=HEAPF32=new Float32Array(b);Module["HEAPF64"]=HEAPF64=new Float64Array(b);Module["HEAP64"]=HEAP64=new BigInt64Array(b);Module["HEAPU64"]=HEAPU64=new BigUint64Array(b)}function preRun(){if(Module["preRun"]){if(typeof Module["preRun"]=="function")Module["preRun"]=[Module["preRun"]];while(Module["preRun"].length){addOnPreRun(Module["preRun"].shift())}}callRuntimeCallbacks(onPreRuns)}function initRuntime(){runtimeInitialized=true;wasmExports["s"]()}function postRun(){if(Module["postRun"]){if(typeof Module["postRun"]=="function")Module["postRun"]=[Module["postRun"]];while(Module["postRun"].length){addOnPostRun(Module["postRun"].shift())}}callRuntimeCallbacks(onPostRuns)}var runDependencies=0;var dependenciesFulfilled=null;function addRunDependency(id){runDependencies++;Module["monitorRunDependencies"]?.(runDependencies)}function removeRunDependency(id){runDependencies--;Module["monitorRunDependencies"]?.(runDependencies);if(runDependencies==0){if(dependenciesFulfilled){var callback=dependenciesFulfilled;dependenciesFulfilled=null;callback()}}}function abort(what){Module["onAbort"]?.(what);what="Aborted("+what+")";err(what);ABORT=true;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);readyPromiseReject(e);throw e}var wasmBinaryFile;function findWasmBinary(){if(Module["locateFile"]){return locateFile("c4w.wasm")}return new URL("c4w.wasm",import.meta.url).href}function getBinarySync(file){if(file==wasmBinaryFile&&wasmBinary){return new Uint8Array(wasmBinary)}if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}async function getWasmBinary(binaryFile){if(!wasmBinary){try{var response=await readAsync(binaryFile);return new Uint8Array(response)}catch{}}return getBinarySync(binaryFile)}async function instantiateArrayBuffer(binaryFile,imports){try{var binary=await getWasmBinary(binaryFile);var instance=await WebAssembly.instantiate(binary,imports);return instance}catch(reason){err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)}}async function instantiateAsync(binary,binaryFile,imports){if(!binary&&typeof WebAssembly.instantiateStreaming=="function"){try{var response=fetch(binaryFile,{credentials:"same-origin"});var instantiationResult=await WebAssembly.instantiateStreaming(response,imports);return instantiationResult}catch(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation")}}return instantiateArrayBuffer(binaryFile,imports)}function getWasmImports(){return{a:wasmImports}}async function createWasm(){function receiveInstance(instance,module){wasmExports=instance.exports;wasmMemory=wasmExports["r"];updateMemoryViews();removeRunDependency("wasm-instantiate");return wasmExports}addRunDependency("wasm-instantiate");function receiveInstantiationResult(result){return receiveInstance(result["instance"])}var info=getWasmImports();if(Module["instantiateWasm"]){return new Promise((resolve,reject)=>{Module["instantiateWasm"](info,(mod,inst)=>{receiveInstance(mod,inst);resolve(mod.exports)})})}wasmBinaryFile??=findWasmBinary();try{var result=await instantiateAsync(wasmBinary,wasmBinaryFile,info);var exports=receiveInstantiationResult(result);return exports}catch(e){readyPromiseReject(e);return Promise.reject(e)}}var ASM_CONSTS={162316:($0,$1)=>{var keyStr=UTF8ToString($0);var data=Module.storage.get(keyStr);if(data){var bufferPtr=_c4w_buffer_alloc($1,data.length);HEAPU8.set(data,bufferPtr);return 1}return 0},162504:($0,$1,$2)=>{var keyStr=UTF8ToString($0);var array=new Uint8Array($2);array.set(HEAPU8.subarray($1,$1+$2));Module.storage.set(keyStr,array)},162647:$0=>{var keyStr=UTF8ToString($0);Module.storage.del(keyStr)}};class ExitStatus{name="ExitStatus";constructor(status){this.message=`Program terminated with exit(${status})`;this.status=status}}var callRuntimeCallbacks=callbacks=>{while(callbacks.length>0){callbacks.shift()(Module)}};var onPostRuns=[];var addOnPostRun=cb=>onPostRuns.unshift(cb);var onPreRuns=[];var addOnPreRun=cb=>onPreRuns.unshift(cb);var noExitRuntime=Module["noExitRuntime"]||true;var stackRestore=val=>__emscripten_stack_restore(val);var stackSave=()=>_emscripten_stack_get_current();var UTF8Decoder=typeof TextDecoder!="undefined"?new TextDecoder:undefined;var UTF8ArrayToString=(heapOrArray,idx=0,maxBytesToRead=NaN)=>{var endIdx=idx+maxBytesToRead;var endPtr=idx;while(heapOrArray[endPtr]&&!(endPtr>=endIdx))++endPtr;if(endPtr-idx>16&&heapOrArray.buffer&&UTF8Decoder){return UTF8Decoder.decode(heapOrArray.subarray(idx,endPtr))}var str="";while(idx<endPtr){var u0=heapOrArray[idx++];if(!(u0&128)){str+=String.fromCharCode(u0);continue}var u1=heapOrArray[idx++]&63;if((u0&224)==192){str+=String.fromCharCode((u0&31)<<6|u1);continue}var u2=heapOrArray[idx++]&63;if((u0&240)==224){u0=(u0&15)<<12|u1<<6|u2}else{u0=(u0&7)<<18|u1<<12|u2<<6|heapOrArray[idx++]&63}if(u0<65536){str+=String.fromCharCode(u0)}else{var ch=u0-65536;str+=String.fromCharCode(55296|ch>>10,56320|ch&1023)}}return str};var UTF8ToString=(ptr,maxBytesToRead)=>ptr?UTF8ArrayToString(HEAPU8,ptr,maxBytesToRead):"";var ___assert_fail=(condition,filename,line,func)=>abort(`Assertion failed: ${UTF8ToString(condition)}, at: `+[filename?UTF8ToString(filename):"unknown filename",line,func?UTF8ToString(func):"unknown function"]);class ExceptionInfo{constructor(excPtr){this.excPtr=excPtr;this.ptr=excPtr-24}set_type(type){HEAPU32[this.ptr+4>>2]=type}get_type(){return HEAPU32[this.ptr+4>>2]}set_destructor(destructor){HEAPU32[this.ptr+8>>2]=destructor}get_destructor(){return HEAPU32[this.ptr+8>>2]}set_caught(caught){caught=caught?1:0;HEAP8[this.ptr+12]=caught}get_caught(){return HEAP8[this.ptr+12]!=0}set_rethrown(rethrown){rethrown=rethrown?1:0;HEAP8[this.ptr+13]=rethrown}get_rethrown(){return HEAP8[this.ptr+13]!=0}init(type,destructor){this.set_adjusted_ptr(0);this.set_type(type);this.set_destructor(destructor)}set_adjusted_ptr(adjustedPtr){HEAPU32[this.ptr+16>>2]=adjustedPtr}get_adjusted_ptr(){return HEAPU32[this.ptr+16>>2]}}var exceptionLast=0;var uncaughtExceptionCount=0;var ___cxa_throw=(ptr,type,destructor)=>{var info=new ExceptionInfo(ptr);info.init(type,destructor);exceptionLast=ptr;uncaughtExceptionCount++;throw exceptionLast};var SYSCALLS={varargs:undefined,getStr(ptr){var ret=UTF8ToString(ptr);return ret}};function ___syscall_fcntl64(fd,cmd,varargs){SYSCALLS.varargs=varargs;return 0}function ___syscall_ioctl(fd,op,varargs){SYSCALLS.varargs=varargs;return 0}function ___syscall_openat(dirfd,path,flags,varargs){SYSCALLS.varargs=varargs}var __abort_js=()=>abort("");var stringToUTF8Array=(str,heap,outIdx,maxBytesToWrite)=>{if(!(maxBytesToWrite>0))return 0;var startIdx=outIdx;var endIdx=outIdx+maxBytesToWrite-1;for(var i=0;i<str.length;++i){var u=str.charCodeAt(i);if(u>=55296&&u<=57343){var u1=str.charCodeAt(++i);u=65536+((u&1023)<<10)|u1&1023}if(u<=127){if(outIdx>=endIdx)break;heap[outIdx++]=u}else if(u<=2047){if(outIdx+1>=endIdx)break;heap[outIdx++]=192|u>>6;heap[outIdx++]=128|u&63}else if(u<=65535){if(outIdx+2>=endIdx)break;heap[outIdx++]=224|u>>12;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}else{if(outIdx+3>=endIdx)break;heap[outIdx++]=240|u>>18;heap[outIdx++]=128|u>>12&63;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}}heap[outIdx]=0;return outIdx-startIdx};var stringToUTF8=(str,outPtr,maxBytesToWrite)=>stringToUTF8Array(str,HEAPU8,outPtr,maxBytesToWrite);var __tzset_js=(timezone,daylight,std_name,dst_name)=>{var currentYear=(new Date).getFullYear();var winter=new Date(currentYear,0,1);var summer=new Date(currentYear,6,1);var winterOffset=winter.getTimezoneOffset();var summerOffset=summer.getTimezoneOffset();var stdTimezoneOffset=Math.max(winterOffset,summerOffset);HEAPU32[timezone>>2]=stdTimezoneOffset*60;HEAP32[daylight>>2]=Number(winterOffset!=summerOffset);var extractZone=timezoneOffset=>{var sign=timezoneOffset>=0?"-":"+";var absOffset=Math.abs(timezoneOffset);var hours=String(Math.floor(absOffset/60)).padStart(2,"0");var minutes=String(absOffset%60).padStart(2,"0");return`UTC${sign}${hours}${minutes}`};var winterName=extractZone(winterOffset);var summerName=extractZone(summerOffset);if(summerOffset<winterOffset){stringToUTF8(winterName,std_name,17);stringToUTF8(summerName,dst_name,17)}else{stringToUTF8(winterName,dst_name,17);stringToUTF8(summerName,std_name,17)}};var readEmAsmArgsArray=[];var readEmAsmArgs=(sigPtr,buf)=>{readEmAsmArgsArray.length=0;var ch;while(ch=HEAPU8[sigPtr++]){var wide=ch!=105;wide&=ch!=112;buf+=wide&&buf%8?4:0;readEmAsmArgsArray.push(ch==112?HEAPU32[buf>>2]:ch==106?HEAP64[buf>>3]:ch==105?HEAP32[buf>>2]:HEAPF64[buf>>3]);buf+=wide?8:4}return readEmAsmArgsArray};var runEmAsmFunction=(code,sigPtr,argbuf)=>{var args=readEmAsmArgs(sigPtr,argbuf);return ASM_CONSTS[code](...args)};var _emscripten_asm_const_int=(code,sigPtr,argbuf)=>runEmAsmFunction(code,sigPtr,argbuf);var _emscripten_date_now=()=>Date.now();var getHeapMax=()=>2147483648;var alignMemory=(size,alignment)=>Math.ceil(size/alignment)*alignment;var growMemory=size=>{var b=wasmMemory.buffer;var pages=(size-b.byteLength+65535)/65536|0;try{wasmMemory.grow(pages);updateMemoryViews();return 1}catch(e){}};var _emscripten_resize_heap=requestedSize=>{var oldSize=HEAPU8.length;requestedSize>>>=0;var maxHeapSize=getHeapMax();if(requestedSize>maxHeapSize){return false}for(var cutDown=1;cutDown<=4;cutDown*=2){var overGrownHeapSize=oldSize*(1+.2/cutDown);overGrownHeapSize=Math.min(overGrownHeapSize,requestedSize+100663296);var newSize=Math.min(maxHeapSize,alignMemory(Math.max(requestedSize,overGrownHeapSize),65536));var replacement=growMemory(newSize);if(replacement){return true}}return false};var ENV={};var getExecutableName=()=>thisProgram||"./this.program";var getEnvStrings=()=>{if(!getEnvStrings.strings){var lang=(typeof navigator=="object"&&navigator.languages&&navigator.languages[0]||"C").replace("-","_")+".UTF-8";var env={USER:"web_user",LOGNAME:"web_user",PATH:"/",PWD:"/",HOME:"/home/web_user",LANG:lang,_:getExecutableName()};for(var x in ENV){if(ENV[x]===undefined)delete env[x];else env[x]=ENV[x]}var strings=[];for(var x in env){strings.push(`${x}=${env[x]}`)}getEnvStrings.strings=strings}return getEnvStrings.strings};var stringToAscii=(str,buffer)=>{for(var i=0;i<str.length;++i){HEAP8[buffer++]=str.charCodeAt(i)}HEAP8[buffer]=0};var _environ_get=(__environ,environ_buf)=>{var bufSize=0;getEnvStrings().forEach((string,i)=>{var ptr=environ_buf+bufSize;HEAPU32[__environ+i*4>>2]=ptr;stringToAscii(string,ptr);bufSize+=string.length+1});return 0};var _environ_sizes_get=(penviron_count,penviron_buf_size)=>{var strings=getEnvStrings();HEAPU32[penviron_count>>2]=strings.length;var bufSize=0;strings.forEach(string=>bufSize+=string.length+1);HEAPU32[penviron_buf_size>>2]=bufSize;return 0};var runtimeKeepaliveCounter=0;var keepRuntimeAlive=()=>noExitRuntime||runtimeKeepaliveCounter>0;var _proc_exit=code=>{EXITSTATUS=code;if(!keepRuntimeAlive()){Module["onExit"]?.(code);ABORT=true}quit_(code,new ExitStatus(code))};var exitJS=(status,implicit)=>{EXITSTATUS=status;_proc_exit(status)};var _exit=exitJS;var _fd_close=fd=>52;var _fd_read=(fd,iov,iovcnt,pnum)=>52;var INT53_MAX=9007199254740992;var INT53_MIN=-9007199254740992;var bigintToI53Checked=num=>num<INT53_MIN||num>INT53_MAX?NaN:Number(num);function _fd_seek(fd,offset,whence,newOffset){offset=bigintToI53Checked(offset);return 70}var printCharBuffers=[null,[],[]];var printChar=(stream,curr)=>{var buffer=printCharBuffers[stream];if(curr===0||curr===10){(stream===1?out:err)(UTF8ArrayToString(buffer));buffer.length=0}else{buffer.push(curr)}};var _fd_write=(fd,iov,iovcnt,pnum)=>{var num=0;for(var i=0;i<iovcnt;i++){var ptr=HEAPU32[iov>>2];var len=HEAPU32[iov+4>>2];iov+=8;for(var j=0;j<len;j++){printChar(fd,HEAPU8[ptr+j])}num+=len}HEAPU32[pnum>>2]=num;return 0};var getCFunc=ident=>{var func=Module["_"+ident];return func};var writeArrayToMemory=(array,buffer)=>{HEAP8.set(array,buffer)};var lengthBytesUTF8=str=>{var len=0;for(var i=0;i<str.length;++i){var c=str.charCodeAt(i);if(c<=127){len++}else if(c<=2047){len+=2}else if(c>=55296&&c<=57343){len+=4;++i}else{len+=3}}return len};var stackAlloc=sz=>__emscripten_stack_alloc(sz);var stringToUTF8OnStack=str=>{var size=lengthBytesUTF8(str)+1;var ret=stackAlloc(size);stringToUTF8(str,ret,size);return ret};var ccall=(ident,returnType,argTypes,args,opts)=>{var toC={string:str=>{var ret=0;if(str!==null&&str!==undefined&&str!==0){ret=stringToUTF8OnStack(str)}return ret},array:arr=>{var ret=stackAlloc(arr.length);writeArrayToMemory(arr,ret);return ret}};function convertReturnValue(ret){if(returnType==="string"){return UTF8ToString(ret)}if(returnType==="boolean")return Boolean(ret);return ret}var func=getCFunc(ident);var cArgs=[];var stack=0;if(args){for(var i=0;i<args.length;i++){var converter=toC[argTypes[i]];if(converter){if(stack===0)stack=stackSave();cArgs[i]=converter(args[i])}else{cArgs[i]=args[i]}}}var ret=func(...cArgs);function onDone(ret){if(stack!==0)stackRestore(stack);return convertReturnValue(ret)}ret=onDone(ret);return ret};var cwrap=(ident,returnType,argTypes,opts)=>{var numericArgs=!argTypes||argTypes.every(type=>type==="number"||type==="boolean");var numericRet=returnType!=="string";if(numericRet&&numericArgs&&!opts){return getCFunc(ident)}return(...args)=>ccall(ident,returnType,argTypes,args,opts)};var wasmImports={a:___assert_fail,b:___cxa_throw,f:___syscall_fcntl64,j:___syscall_ioctl,k:___syscall_openat,m:__abort_js,l:__tzset_js,d:_emscripten_asm_const_int,g:_emscripten_date_now,n:_emscripten_resize_heap,p:_environ_get,q:_environ_sizes_get,c:_exit,h:_fd_close,i:_fd_read,o:_fd_seek,e:_fd_write};var wasmExports=await createWasm();var ___wasm_call_ctors=wasmExports["s"];var _c4w_create_proof_ctx=Module["_c4w_create_proof_ctx"]=wasmExports["t"];var _c4w_free_proof_ctx=Module["_c4w_free_proof_ctx"]=wasmExports["u"];var _c4w_execute_proof_ctx=Module["_c4w_execute_proof_ctx"]=wasmExports["v"];var _c4w_req_set_response=Module["_c4w_req_set_response"]=wasmExports["w"];var _c4w_req_set_error=Module["_c4w_req_set_error"]=wasmExports["x"];var _c4w_create_verify_ctx=Module["_c4w_create_verify_ctx"]=wasmExports["y"];var _c4w_free_verify_ctx=Module["_c4w_free_verify_ctx"]=wasmExports["z"];var _free=Module["_free"]=wasmExports["A"];var _c4w_verify_proof=Module["_c4w_verify_proof"]=wasmExports["B"];var _c4w_get_method_type=Module["_c4w_get_method_type"]=wasmExports["C"];var _c4w_create_rpc_ctx=Module["_c4w_create_rpc_ctx"]=wasmExports["D"];var _c4w_execute_rpc_ctx=Module["_c4w_execute_rpc_ctx"]=wasmExports["E"];var _c4w_free_rpc_ctx=Module["_c4w_free_rpc_ctx"]=wasmExports["F"];var _c4w_set_checkpoint=Module["_c4w_set_checkpoint"]=wasmExports["G"];var _c4w_rpc_ctx_set_witness_keys=Module["_c4w_rpc_ctx_set_witness_keys"]=wasmExports["H"];var _c4w_rpc_ctx_set_proxy_urls=Module["_c4w_rpc_ctx_set_proxy_urls"]=wasmExports["I"];var _c4w_decode_proof=Module["_c4w_decode_proof"]=wasmExports["J"];var _c4w_req_free=Module["_c4w_req_free"]=wasmExports["K"];var _c4w_buffer_alloc=Module["_c4w_buffer_alloc"]=wasmExports["L"];var _init_storage=Module["_init_storage"]=wasmExports["M"];var _c4w_get_current_version_number=Module["_c4w_get_current_version_number"]=wasmExports["N"];var _malloc=Module["_malloc"]=wasmExports["P"];var __emscripten_stack_restore=wasmExports["Q"];var __emscripten_stack_alloc=wasmExports["R"];var _emscripten_stack_get_current=wasmExports["S"];Module["ccall"]=ccall;Module["cwrap"]=cwrap;Module["UTF8ToString"]=UTF8ToString;Module["stringToUTF8"]=stringToUTF8;function run(){if(runDependencies>0){dependenciesFulfilled=run;return}preRun();if(runDependencies>0){dependenciesFulfilled=run;return}function doRun(){Module["calledRun"]=true;if(ABORT)return;initRuntime();readyPromiseResolve(Module);Module["onRuntimeInitialized"]?.();postRun()}if(Module["setStatus"]){Module["setStatus"]("Running...");setTimeout(()=>{setTimeout(()=>Module["setStatus"](""),1);doRun()},1)}else{doRun()}}if(Module["preInit"]){if(typeof Module["preInit"]=="function")Module["preInit"]=[Module["preInit"]];while(Module["preInit"].length>0){Module["preInit"].pop()()}}run();moduleRtn=readyPromise;
 
 
   return moduleRtn;

package/cjs/http.js

@@ -31,6 +31,8 @@ function joinPath(base, path) {
         return base;
     if (!path.length)
         return base;
+    if (base.endsWith('/'))
+        return base + path;
     return base + (path.startsWith('/') ? path : '/' + path);
 }
 /**
@@ -42,7 +44,7 @@ function joinPath(base, path) {
  * @param excludeMask Bitmask to skip servers by index
  * @return Uint8Array of response bytes and nodeIndex used
  */
-async function fetch_from_servers(servers, path, method, payload, accept = 'json', excludeMask = 0) {
+async function fetch_from_servers(servers, path, method, payload, accept = 'json', excludeMask = 0, fetchFn = globalThis.fetch) {
     let lastError = 'All nodes failed';
     let nodeIndex = 0;
     for (const server of servers) {
@@ -51,7 +53,7 @@ async function fetch_from_servers(servers, path, method, payload, accept = 'json
             continue;
         }
         try {
-            const response = await fetch(joinPath(server, path), {
+            const response = await fetchFn(joinPath(server, path), {
                 method,
                 body: payload ? JSON.stringify(payload) : undefined,
                 headers: {
@@ -68,7 +70,7 @@ async function fetch_from_servers(servers, path, method, payload, accept = 'json
             return { data: new Uint8Array(bytes), nodeIndex };
         }
         catch (e) {
-            lastError = (e instanceof Error) ? e.message : String(e);
+            lastError = 'Request to ' + joinPath(server, path) + (payload ? ' with payload ' + JSON.stringify(payload) : '') + ' failed: ' + ((e instanceof Error) ? e.message : String(e));
         }
         nodeIndex++;
     }
@@ -85,31 +87,36 @@ function log(msg) {
  * @param as_proof Expect octet-stream (true) or JSON result (false)
  * @return result value for JSON or raw bytes for proofs
  */
-async function fetch_rpc(urls, payload, as_proof = false) {
+async function fetch_rpc(urls, payload, as_proof = false, fetchFn = globalThis.fetch) {
     let last_error = 'All nodes failed';
     for (const url of urls) {
-        const response = await fetch(url, {
-            method: 'POST',
-            body: JSON.stringify({ id: 1, jsonrpc: '2.0', ...payload }),
-            headers: {
-                'Content-Type': 'application/json',
-                'Accept': as_proof ? 'application/octet-stream' : 'application/json',
-            },
-        });
-        if (response.ok) {
-            if (!as_proof) {
-                const res = await response.json();
-                if (res.error) {
-                    last_error = res.error?.message || res.error;
-                    continue;
+        try {
+            const response = await fetchFn(url, {
+                method: 'POST',
+                body: JSON.stringify({ id: 1, jsonrpc: '2.0', ...payload }),
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Accept': as_proof ? 'application/octet-stream' : 'application/json',
+                },
+            });
+            if (response.ok) {
+                if (!as_proof) {
+                    const res = await response.json();
+                    if (res.error) {
+                        last_error = res.error?.message || res.error;
+                        continue;
+                    }
+                    return res.result;
                 }
-                return res.result;
+                const bytes = await response.blob().then(blob => blob.arrayBuffer());
+                return new Uint8Array(bytes);
+            }
+            else {
+                last_error = `HTTP error! Status: ${response.status}, Details: ${await response.text()}`;
             }
-            const bytes = await response.blob().then(blob => blob.arrayBuffer());
-            return new Uint8Array(bytes);
         }
-        else {
-            last_error = `HTTP error! Status: ${response.status}, Details: ${await response.text()}`;
+        catch (e) {
+            last_error = 'Request to ' + url + ' failed: ' + ((e instanceof Error) ? e.message : String(e));
         }
     }
     throw new Error(last_error);
@@ -148,13 +155,18 @@ async function handle_request(req, conf) {
             if (conf.debug)
                 log(`::: ${path} (len=${data.length} bytes) CACHED`);
             c4w._c4w_req_set_response(req.req_ptr, (0, wasm_js_1.copy_to_c)(data, c4w), data.length, 0);
+            if (conf.onTransfer)
+                conf.onTransfer(data.length, req);
             return;
         }
     }
     try {
         const accept = req.encoding == 'json' ? 'json' : 'octet';
-        const { data, nodeIndex } = await fetch_from_servers(servers, req.url || '', req.method, req.payload, accept, req.exclude_mask);
+        const fetchFn = conf.fetch || globalThis.fetch;
+        const { data, nodeIndex } = await fetch_from_servers(servers, req.url || '', req.method, req.payload, accept, req.exclude_mask, fetchFn);
         c4w._c4w_req_set_response(req.req_ptr, (0, wasm_js_1.copy_to_c)(data, c4w), data.length, nodeIndex);
+        if (conf.onTransfer)
+            conf.onTransfer(data.length, req);
         if (conf.debug)
             log(`::: ${path} (len=${data.length} bytes) FETCHED`);
         if (conf.cache && cacheable)

package/cjs/index.js

@@ -60,6 +60,7 @@ class C4Client {
     constructor(config) {
         this.flags = 0;
         this.verify_flags = 0;
+        this._lightClientTimer = null;
         const chainId = config?.chainId ? (0, chains_js_1.get_chain_id)(config?.chainId + '') : 1;
         const chain_config = { ...chains_js_1.default_config[chainId + ''] };
         // Protect against config manipulation (deep-freeze at sensitive boundaries)
@@ -193,22 +194,29 @@ class C4Client {
     async rpc(method, args, method_type) {
         // eth_sendTransaction stays in bindings (requires fallback_provider interaction)
         if (method === 'eth_sendTransaction' && this.config.verifyTransactions) {
-            return await transactionVerifier_js_1.TransactionVerifier.verifyAndSendTransaction(args[0], this.config, (method, args, methodType) => this.rpc(method, args, methodType), http_js_1.fetch_rpc);
+            return await transactionVerifier_js_1.TransactionVerifier.verifyAndSendTransaction(args[0], this.config, (method, args, methodType) => this.rpc(method, args, methodType), http_js_1.fetch_rpc, this.config.fetch);
         }
         // Allow host to skip verification for specific calls
         if (method_type === undefined)
             method_type = await this.getMethodSupport(method, args);
         if (method_type === types_js_1.MethodType.PROOFABLE && this.config.verify && !this.config.verify(method, args))
-            return await (0, http_js_1.fetch_rpc)(this.config.rpcs, { method, params: args }, false);
+            return await (0, http_js_1.fetch_rpc)(this.config.rpcs, { method, params: args }, false, this.config.fetch);
         const c4w = await (0, wasm_js_1.getC4w)();
         const free_buffers = [];
         let ctx = 0;
         try {
-            const use_remote_prover = (this.config.prover?.length) ? 1 : 0;
+            const prover_mode_map = { local: 0, remote: 1, hybrid: 2, proxy: 3, light_client: 4 };
+            const resolved_mode = this.config.prover_mode ?? (this.config.prover?.length ? 'remote' : 'local');
+            const native_mode = resolved_mode === 'light_client' ? prover_mode_map['hybrid'] : prover_mode_map[resolved_mode];
             let prover_flags = this.flags;
             if (this.config.zk_proof)
                 prover_flags |= (1 << 7);
-            ctx = c4w._c4w_create_rpc_ctx((0, wasm_js_1.as_char_ptr)(method, c4w, free_buffers), (0, wasm_js_1.as_char_ptr)(JSON.stringify(args || []), c4w, free_buffers), BigInt(this.config.chainId), prover_flags, this.verify_flags, use_remote_prover);
+            ctx = c4w._c4w_create_rpc_ctx((0, wasm_js_1.as_char_ptr)(method, c4w, free_buffers), (0, wasm_js_1.as_char_ptr)(JSON.stringify(args || []), c4w, free_buffers), BigInt(this.config.chainId), prover_flags, this.verify_flags, native_mode);
+            if (resolved_mode === 'proxy') {
+                const rpc_csv = this.config.rpcs.join(',');
+                const beacon_csv = this.config.beacon_apis.join(',');
+                c4w._c4w_rpc_ctx_set_proxy_urls(ctx, (0, wasm_js_1.as_char_ptr)(rpc_csv, c4w, free_buffers), (0, wasm_js_1.as_char_ptr)(beacon_csv, c4w, free_buffers));
+            }
             if (this.config.trusted_checkpoint)
                 c4w._c4w_set_checkpoint(BigInt(this.config.chainId), (0, wasm_js_1.as_char_ptr)(this.config.trusted_checkpoint, c4w, free_buffers));
             if (this.config.checkpoint_witness_keys)
@@ -290,6 +298,44 @@ class C4Client {
         this.eventEmitter.removeListener(event, callback);
         return this;
     }
+    /** Stops light client polling and releases resources. Call when the client is no longer needed. */
+    destroy() {
+        this.stopLightClient();
+    }
+    /**
+     * Starts background polling to keep the block header cache warm.
+     * Useful for `prover_mode: "light_client"`.
+     *
+     * By default polls `eth_getBlockHeader("latest")` which fetches only the
+     * compact header proof. Set `fullBlock` to `true` to poll
+     * `eth_getBlockByNumber("latest")` instead -- useful when many
+     * `eth_getTransactionByHash` / `eth_getTransactionReceipt` calls follow,
+     * since those need the full block data.
+     *
+     * @param intervalMs polling interval in milliseconds (default: 12000 = one Ethereum slot)
+     * @param fullBlock if true, fetch the full block instead of just the header (default: false)
+     */
+    startLightClient(intervalMs = 12000, fullBlock = false) {
+        this.stopLightClient();
+        const method = fullBlock ? 'eth_getBlockByNumber' : 'eth_getBlockHeader';
+        const params = fullBlock ? ['latest', false] : ['latest'];
+        this._lightClientTimer = setInterval(async () => {
+            try {
+                await this.rpc(method, params);
+            }
+            catch (e) {
+                if (this.config.debug)
+                    console.warn('[C4Client] lightClient poll error:', e);
+            }
+        }, intervalMs);
+    }
+    /** Stops background light client polling. */
+    stopLightClient() {
+        if (this._lightClientTimer !== null) {
+            clearInterval(this._lightClientTimer);
+            this._lightClientTimer = null;
+        }
+    }
 }
 // Protect against prototype pollution by freezing critical methods
 C4Client.CRITICAL_METHODS = ['rpc', 'request', 'verifyProof', 'createProof'];

package/cjs/strategy.js

@@ -69,7 +69,7 @@ function fetch_unverified_rpc(config, req, fetch_rpc) {
     let rpcs = conf?.rpcs || config.rpcs;
     if (!rpcs || !Array.isArray(rpcs) || rpcs.length === 0)
         throw new Error("No RPC- Endpoint configured");
-    return fetch_rpc(rpcs, req, false);
+    return fetch_rpc(rpcs, req, false, config.fetch);
 }
 function OnlyProofStrategy(client, req, config, fetch_rpc) {
     return client.rpc(req.method, argsToArray(req.params));

package/cjs/transactionVerifier.js

@@ -32,7 +32,7 @@ class TransactionVerifier {
      * 3. Dekodierte Parameter mit Original vergleichen
      * 4. eth_sendRawTransaction ausführen
      */
-    static async verifyAndSendTransaction(txObject, config, rpcMethod, fetchRpc) {
+    static async verifyAndSendTransaction(txObject, config, rpcMethod, fetchRpc, fetchFn) {
         if (config.debug)
             console.log('[TransactionVerifier] Verifying transaction before sending:', txObject);
         if (!config.fallback_provider) {
@@ -55,7 +55,7 @@ class TransactionVerifier {
             return await fetchRpc(config.rpcs, {
                 method: 'eth_sendRawTransaction',
                 params: [signedRawTx]
-            }, false);
+            }, false, fetchFn);
         }
         catch (error) {
             if (config.debug)

package/cjs/wasm_shared.js

@@ -38,13 +38,54 @@ function isBrowserEnvironment() {
 }
 function hasLocalStorage() {
     try {
-        // In some contexts (e.g. extension workers), accessing localStorage may throw or be unavailable.
         return typeof globalThis !== 'undefined' && !!globalThis.localStorage;
     }
     catch {
         return false;
     }
 }
+function hasCacheApi() {
+    try {
+        return typeof globalThis !== 'undefined' && 'caches' in globalThis;
+    }
+    catch {
+        return false;
+    }
+}
+// Keys from C are always alphanumeric + underscore (e.g. "states_1", "sync_1_234"),
+// so no URL encoding is needed.
+const CACHE_URL_PREFIX = 'http://colibri.storage/';
+async function loadCacheApiStorage() {
+    try {
+        const cache = await globalThis.caches.open('colibri-storage');
+        const mem = new Map();
+        const requests = await cache.keys();
+        await Promise.all(requests.map(async (req) => {
+            const resp = await cache.match(req);
+            if (resp) {
+                const key = req.url.slice(CACHE_URL_PREFIX.length);
+                mem.set(key, new Uint8Array(await resp.arrayBuffer()));
+            }
+        }));
+        return {
+            get: (key) => mem.get(key) ?? null,
+            set: (key, value) => {
+                const copy = new Uint8Array(value);
+                mem.set(key, copy);
+                cache.put(CACHE_URL_PREFIX + key, new Response(copy, {
+                    headers: { 'Content-Type': 'application/octet-stream', 'Content-Length': '' + copy.byteLength },
+                })).catch(e => console.warn('colibri: cache write failed for', key, e));
+            },
+            del: (key) => {
+                mem.delete(key);
+                cache.delete(CACHE_URL_PREFIX + key).catch(e => console.warn('colibri: cache delete failed for', key, e));
+            },
+        };
+    }
+    catch {
+        return null;
+    }
+}
 async function importNodeFs() {
     // Avoid bundlers (Webpack/Metro) trying to resolve Node builtins like 'fs'
     // when targeting browsers / react-native-web.
@@ -53,8 +94,12 @@ async function importNodeFs() {
     return importer();
 }
 async function get_default_storage() {
+    if (hasCacheApi()) {
+        const storage = await loadCacheApiStorage();
+        if (storage)
+            return storage;
+    }
     if (hasLocalStorage())
-        // Web interface (localStorage).
         return {
             get: (key) => {
                 const ls = globalThis.localStorage;
@@ -78,7 +123,7 @@ async function get_default_storage() {
                 ls.removeItem(key);
             },
         };
-    else if (isNodeEnvironment()) {
+    if (isNodeEnvironment()) {
         const fs = await importNodeFs();
         // node interface
         return {

package/http.d.ts

@@ -9,7 +9,7 @@ export type AcceptKind = 'json' | 'octet';
  * @param excludeMask Bitmask to skip servers by index
  * @return Uint8Array of response bytes and nodeIndex used
  */
-export declare function fetch_from_servers(servers: string[], path: string, method: 'GET' | 'POST', payload?: any, accept?: AcceptKind, excludeMask?: number): Promise<{
+export declare function fetch_from_servers(servers: string[], path: string, method: 'GET' | 'POST', payload?: any, accept?: AcceptKind, excludeMask?: number, fetchFn?: typeof globalThis.fetch): Promise<{
     data: Uint8Array;
     nodeIndex: number;
 }>;
@@ -20,7 +20,7 @@ export declare function fetch_from_servers(servers: string[], path: string, meth
  * @param as_proof Expect octet-stream (true) or JSON result (false)
  * @return result value for JSON or raw bytes for proofs
  */
-export declare function fetch_rpc(urls: string[], payload: any, as_proof?: boolean): Promise<any>;
+export declare function fetch_rpc(urls: string[], payload: any, as_proof?: boolean, fetchFn?: typeof globalThis.fetch): Promise<any>;
 /**
  * Handles a C4 data request by fetching from configured servers, setting the
  * response or error back into the C context, and leveraging cache if present.

package/http.js

@@ -26,6 +26,8 @@ function joinPath(base, path) {
         return base;
     if (!path.length)
         return base;
+    if (base.endsWith('/'))
+        return base + path;
     return base + (path.startsWith('/') ? path : '/' + path);
 }
 /**
@@ -37,7 +39,7 @@ function joinPath(base, path) {
  * @param excludeMask Bitmask to skip servers by index
  * @return Uint8Array of response bytes and nodeIndex used
  */
-export async function fetch_from_servers(servers, path, method, payload, accept = 'json', excludeMask = 0) {
+export async function fetch_from_servers(servers, path, method, payload, accept = 'json', excludeMask = 0, fetchFn = globalThis.fetch) {
     let lastError = 'All nodes failed';
     let nodeIndex = 0;
     for (const server of servers) {
@@ -46,7 +48,7 @@ export async function fetch_from_servers(servers, path, method, payload, accept
             continue;
         }
         try {
-            const response = await fetch(joinPath(server, path), {
+            const response = await fetchFn(joinPath(server, path), {
                 method,
                 body: payload ? JSON.stringify(payload) : undefined,
                 headers: {
@@ -63,7 +65,7 @@ export async function fetch_from_servers(servers, path, method, payload, accept
             return { data: new Uint8Array(bytes), nodeIndex };
         }
         catch (e) {
-            lastError = (e instanceof Error) ? e.message : String(e);
+            lastError = 'Request to ' + joinPath(server, path) + (payload ? ' with payload ' + JSON.stringify(payload) : '') + ' failed: ' + ((e instanceof Error) ? e.message : String(e));
         }
         nodeIndex++;
     }
@@ -80,31 +82,36 @@ function log(msg) {
  * @param as_proof Expect octet-stream (true) or JSON result (false)
  * @return result value for JSON or raw bytes for proofs
  */
-export async function fetch_rpc(urls, payload, as_proof = false) {
+export async function fetch_rpc(urls, payload, as_proof = false, fetchFn = globalThis.fetch) {
     let last_error = 'All nodes failed';
     for (const url of urls) {
-        const response = await fetch(url, {
-            method: 'POST',
-            body: JSON.stringify({ id: 1, jsonrpc: '2.0', ...payload }),
-            headers: {
-                'Content-Type': 'application/json',
-                'Accept': as_proof ? 'application/octet-stream' : 'application/json',
-            },
-        });
-        if (response.ok) {
-            if (!as_proof) {
-                const res = await response.json();
-                if (res.error) {
-                    last_error = res.error?.message || res.error;
-                    continue;
+        try {
+            const response = await fetchFn(url, {
+                method: 'POST',
+                body: JSON.stringify({ id: 1, jsonrpc: '2.0', ...payload }),
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Accept': as_proof ? 'application/octet-stream' : 'application/json',
+                },
+            });
+            if (response.ok) {
+                if (!as_proof) {
+                    const res = await response.json();
+                    if (res.error) {
+                        last_error = res.error?.message || res.error;
+                        continue;
+                    }
+                    return res.result;
                 }
-                return res.result;
+                const bytes = await response.blob().then(blob => blob.arrayBuffer());
+                return new Uint8Array(bytes);
+            }
+            else {
+                last_error = `HTTP error! Status: ${response.status}, Details: ${await response.text()}`;
             }
-            const bytes = await response.blob().then(blob => blob.arrayBuffer());
-            return new Uint8Array(bytes);
         }
-        else {
-            last_error = `HTTP error! Status: ${response.status}, Details: ${await response.text()}`;
+        catch (e) {
+            last_error = 'Request to ' + url + ' failed: ' + ((e instanceof Error) ? e.message : String(e));
         }
     }
     throw new Error(last_error);
@@ -143,13 +150,18 @@ export async function handle_request(req, conf) {
             if (conf.debug)
                 log(`::: ${path} (len=${data.length} bytes) CACHED`);
             c4w._c4w_req_set_response(req.req_ptr, copy_to_c(data, c4w), data.length, 0);
+            if (conf.onTransfer)
+                conf.onTransfer(data.length, req);
             return;
         }
     }
     try {
         const accept = req.encoding == 'json' ? 'json' : 'octet';
-        const { data, nodeIndex } = await fetch_from_servers(servers, req.url || '', req.method, req.payload, accept, req.exclude_mask);
+        const fetchFn = conf.fetch || globalThis.fetch;
+        const { data, nodeIndex } = await fetch_from_servers(servers, req.url || '', req.method, req.payload, accept, req.exclude_mask, fetchFn);
         c4w._c4w_req_set_response(req.req_ptr, copy_to_c(data, c4w), data.length, nodeIndex);
+        if (conf.onTransfer)
+            conf.onTransfer(data.length, req);
         if (conf.debug)
             log(`::: ${path} (len=${data.length} bytes) FETCHED`);
         if (conf.cache && cacheable)

package/index.d.ts

@@ -21,12 +21,12 @@
  * SPDX-License-Identifier: MIT
  */
 import { Storage as C4Storage } from "./wasm.js";
-import { ProviderRpcError, RequestArguments, Cache, Config as C4Config, DataRequest, MethodType as C4MethodType, ProviderMessage } from './types.js';
+import { ProviderRpcError, RequestArguments, Cache, Config as C4Config, DataRequest, MethodType as C4MethodType, ProviderMessage, ProverMode } from './types.js';
 import { EthSubscribeSubscriptionType, EthNewFilterType } from './subscriptionManager.js';
 import Strategy from './strategy.js';
 export { Strategy };
 export { set_wasm_url, decode_proof } from "./wasm.js";
-export { ProviderRpcError, RequestArguments, Cache, C4Config, DataRequest, C4MethodType as MethodType, ProviderMessage, EthSubscribeSubscriptionType, EthNewFilterType };
+export { ProviderRpcError, RequestArguments, Cache, C4Config, DataRequest, C4MethodType as MethodType, ProviderMessage, EthSubscribeSubscriptionType, EthNewFilterType, ProverMode };
 export { TransactionVerifier, PrototypeProtection } from './transactionVerifier.js';
 export default class C4Client {
     config: C4Config;
@@ -35,6 +35,7 @@ export default class C4Client {
     private subscriptionManager;
     private flags;
     private verify_flags;
+    private _lightClientTimer;
     private static readonly CRITICAL_METHODS;
     /**
      * Creates a new Colibri client instance.
@@ -97,4 +98,22 @@ export default class C4Client {
      * @return This client for chaining
      */
     removeListener(event: string, callback: (data: any) => void): this;
+    /** Stops light client polling and releases resources. Call when the client is no longer needed. */
+    destroy(): void;
+    /**
+     * Starts background polling to keep the block header cache warm.
+     * Useful for `prover_mode: "light_client"`.
+     *
+     * By default polls `eth_getBlockHeader("latest")` which fetches only the
+     * compact header proof. Set `fullBlock` to `true` to poll
+     * `eth_getBlockByNumber("latest")` instead -- useful when many
+     * `eth_getTransactionByHash` / `eth_getTransactionReceipt` calls follow,
+     * since those need the full block data.
+     *
+     * @param intervalMs polling interval in milliseconds (default: 12000 = one Ethereum slot)
+     * @param fullBlock if true, fetch the full block instead of just the header (default: false)
+     */
+    startLightClient(intervalMs?: number, fullBlock?: boolean): void;
+    /** Stops background light client polling. */
+    stopLightClient(): void;
 }

package/index.js

@@ -53,6 +53,7 @@ class C4Client {
     constructor(config) {
         this.flags = 0;
         this.verify_flags = 0;
+        this._lightClientTimer = null;
         const chainId = config?.chainId ? get_chain_id(config?.chainId + '') : 1;
         const chain_config = { ...default_config[chainId + ''] };
         // Protect against config manipulation (deep-freeze at sensitive boundaries)
@@ -186,22 +187,29 @@ class C4Client {
     async rpc(method, args, method_type) {
         // eth_sendTransaction stays in bindings (requires fallback_provider interaction)
         if (method === 'eth_sendTransaction' && this.config.verifyTransactions) {
-            return await TransactionVerifier.verifyAndSendTransaction(args[0], this.config, (method, args, methodType) => this.rpc(method, args, methodType), fetch_rpc);
+            return await TransactionVerifier.verifyAndSendTransaction(args[0], this.config, (method, args, methodType) => this.rpc(method, args, methodType), fetch_rpc, this.config.fetch);
         }
         // Allow host to skip verification for specific calls
         if (method_type === undefined)
             method_type = await this.getMethodSupport(method, args);
         if (method_type === C4MethodType.PROOFABLE && this.config.verify && !this.config.verify(method, args))
-            return await fetch_rpc(this.config.rpcs, { method, params: args }, false);
+            return await fetch_rpc(this.config.rpcs, { method, params: args }, false, this.config.fetch);
         const c4w = await getC4w();
         const free_buffers = [];
         let ctx = 0;
         try {
-            const use_remote_prover = (this.config.prover?.length) ? 1 : 0;
+            const prover_mode_map = { local: 0, remote: 1, hybrid: 2, proxy: 3, light_client: 4 };
+            const resolved_mode = this.config.prover_mode ?? (this.config.prover?.length ? 'remote' : 'local');
+            const native_mode = resolved_mode === 'light_client' ? prover_mode_map['hybrid'] : prover_mode_map[resolved_mode];
             let prover_flags = this.flags;
             if (this.config.zk_proof)
                 prover_flags |= (1 << 7);
-            ctx = c4w._c4w_create_rpc_ctx(as_char_ptr(method, c4w, free_buffers), as_char_ptr(JSON.stringify(args || []), c4w, free_buffers), BigInt(this.config.chainId), prover_flags, this.verify_flags, use_remote_prover);
+            ctx = c4w._c4w_create_rpc_ctx(as_char_ptr(method, c4w, free_buffers), as_char_ptr(JSON.stringify(args || []), c4w, free_buffers), BigInt(this.config.chainId), prover_flags, this.verify_flags, native_mode);
+            if (resolved_mode === 'proxy') {
+                const rpc_csv = this.config.rpcs.join(',');
+                const beacon_csv = this.config.beacon_apis.join(',');
+                c4w._c4w_rpc_ctx_set_proxy_urls(ctx, as_char_ptr(rpc_csv, c4w, free_buffers), as_char_ptr(beacon_csv, c4w, free_buffers));
+            }
             if (this.config.trusted_checkpoint)
                 c4w._c4w_set_checkpoint(BigInt(this.config.chainId), as_char_ptr(this.config.trusted_checkpoint, c4w, free_buffers));
             if (this.config.checkpoint_witness_keys)
@@ -283,6 +291,44 @@ class C4Client {
         this.eventEmitter.removeListener(event, callback);
         return this;
     }
+    /** Stops light client polling and releases resources. Call when the client is no longer needed. */
+    destroy() {
+        this.stopLightClient();
+    }
+    /**
+     * Starts background polling to keep the block header cache warm.
+     * Useful for `prover_mode: "light_client"`.
+     *
+     * By default polls `eth_getBlockHeader("latest")` which fetches only the
+     * compact header proof. Set `fullBlock` to `true` to poll
+     * `eth_getBlockByNumber("latest")` instead -- useful when many
+     * `eth_getTransactionByHash` / `eth_getTransactionReceipt` calls follow,
+     * since those need the full block data.
+     *
+     * @param intervalMs polling interval in milliseconds (default: 12000 = one Ethereum slot)
+     * @param fullBlock if true, fetch the full block instead of just the header (default: false)
+     */
+    startLightClient(intervalMs = 12000, fullBlock = false) {
+        this.stopLightClient();
+        const method = fullBlock ? 'eth_getBlockByNumber' : 'eth_getBlockHeader';
+        const params = fullBlock ? ['latest', false] : ['latest'];
+        this._lightClientTimer = setInterval(async () => {
+            try {
+                await this.rpc(method, params);
+            }
+            catch (e) {
+                if (this.config.debug)
+                    console.warn('[C4Client] lightClient poll error:', e);
+            }
+        }, intervalMs);
+    }
+    /** Stops background light client polling. */
+    stopLightClient() {
+        if (this._lightClientTimer !== null) {
+            clearInterval(this._lightClientTimer);
+            this._lightClientTimer = null;
+        }
+    }
 }
 // Protect against prototype pollution by freezing critical methods
 C4Client.CRITICAL_METHODS = ['rpc', 'request', 'verifyProof', 'createProof'];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@corpus-core/colibri-stateless",
-    "version": "1.1.20",
+    "version": "1.1.22",
     "description": "Colibri is a stateless and trustless ethereum client, which is optimized for the mobile apps or embedded devices, because it does not hols the state, but verifies on demand.",
     "main": "index.js",
     "type": "module",
@@ -20,7 +20,8 @@
         "webpack:install": "cd webpack && npm install --legacy-peer-deps",
         "webpack:build": "cd webpack && npm run build",
         "webpack:start": "cd webpack && npm run start",
-        "check:cors": "node scripts/check_cors.mjs"
+        "check:cors": "node scripts/check_cors.mjs",
+        "benchmark": "node test/benchmark.mjs"
     },
     "repository": {
         "type": "git",

package/strategy.js

@@ -67,7 +67,7 @@ function fetch_unverified_rpc(config, req, fetch_rpc) {
     let rpcs = conf?.rpcs || config.rpcs;
     if (!rpcs || !Array.isArray(rpcs) || rpcs.length === 0)
         throw new Error("No RPC- Endpoint configured");
-    return fetch_rpc(rpcs, req, false);
+    return fetch_rpc(rpcs, req, false, config.fetch);
 }
 function OnlyProofStrategy(client, req, config, fetch_rpc) {
     return client.rpc(req.method, argsToArray(req.params));

package/transactionVerifier.d.ts

@@ -44,7 +44,7 @@ export declare class TransactionVerifier {
      * 3. Dekodierte Parameter mit Original vergleichen
      * 4. eth_sendRawTransaction ausführen
      */
-    static verifyAndSendTransaction(txObject: any, config: TransactionVerifierConfig, rpcMethod: (method: string, args: any[], method_type?: C4MethodType) => Promise<any>, fetchRpc: (urls: string[], payload: any, as_proof?: boolean) => Promise<any>): Promise<string>;
+    static verifyAndSendTransaction(txObject: any, config: TransactionVerifierConfig, rpcMethod: (method: string, args: any[], method_type?: C4MethodType) => Promise<any>, fetchRpc: (urls: string[], payload: any, as_proof?: boolean, fetchFn?: typeof globalThis.fetch) => Promise<any>, fetchFn?: typeof globalThis.fetch): Promise<string>;
     /**
      * Vergleicht die Parameter einer ursprünglichen Transaction mit einer dekodierten signierten Transaction
      */

package/transactionVerifier.js

@@ -29,7 +29,7 @@ export class TransactionVerifier {
      * 3. Dekodierte Parameter mit Original vergleichen
      * 4. eth_sendRawTransaction ausführen
      */
-    static async verifyAndSendTransaction(txObject, config, rpcMethod, fetchRpc) {
+    static async verifyAndSendTransaction(txObject, config, rpcMethod, fetchRpc, fetchFn) {
         if (config.debug)
             console.log('[TransactionVerifier] Verifying transaction before sending:', txObject);
         if (!config.fallback_provider) {
@@ -52,7 +52,7 @@ export class TransactionVerifier {
             return await fetchRpc(config.rpcs, {
                 method: 'eth_sendRawTransaction',
                 params: [signedRawTx]
-            }, false);
+            }, false, fetchFn);
         }
         catch (error) {
             if (config.debug)

package/types.d.ts

@@ -30,7 +30,7 @@ export interface ColibriClient {
     rpc(method: string, params: any[], method_type?: MethodType): Promise<any>;
     getMethodSupport(method: string, args?: any[]): Promise<MethodType>;
 }
-export type FetchRpc = (urls: string[], payload: any, as_proof: boolean) => Promise<any>;
+export type FetchRpc = (urls: string[], payload: any, as_proof: boolean, fetchFn?: typeof globalThis.fetch) => Promise<any>;
 export type ProofStrategy = (client: ColibriClient, req: RequestArguments, config: Config, fetch_rpc: FetchRpc) => Promise<any>;
 export type WarningHandler = (req: RequestArguments, message: string) => Promise<any>;
 export interface RequestArguments {
@@ -67,6 +67,8 @@ export interface EIP1193Client {
     on(event: string, callback: (data: any) => void): this;
     removeListener(event: string, callback: (data: any) => void): this;
 }
+/** Proof generation mode controlling how proofs are built and verified. */
+export type ProverMode = 'local' | 'remote' | 'hybrid' | 'proxy' | 'light_client';
 export interface Config extends ChainConfig {
     chainId: number | string;
     checkpoint_witness_keys?: string;
@@ -77,11 +79,18 @@ export interface Config extends ChainConfig {
     /** Pragmatic Adaptive Privacy mode. Default "none". "basic" sets verify flag for PAP. */
     privacy_mode?: PrivacyMode;
     zk_proof?: boolean;
+    /** Proof generation mode. Default: "remote" if prover URLs configured, otherwise "local". */
+    prover_mode?: ProverMode;
     chains: {
         [chainId: number]: ChainConfig;
     };
     fallback_provider?: EIP1193Client;
     warningHandler: WarningHandler;
+    /** Optional callback invoked for every sub-request transfer with the response byte count. */
+    onTransfer?: (size: number, req: DataRequest) => void;
+    /** Custom fetch function replacing `globalThis.fetch` for all HTTP requests.
+     *  Use this to route traffic through Tor, a SOCKS proxy, or any other transport layer. */
+    fetch?: typeof globalThis.fetch;
 }
 export interface DataRequest {
     method: string;

package/wasm_shared.d.ts

@@ -33,11 +33,12 @@ export interface C4W {
     _c4w_verify_proof: (verifyCtx: number) => number;
     _c4w_req_free: (reqPtr: number) => void;
     _c4w_get_current_version_number: () => number;
-    _c4w_create_rpc_ctx: (method: number, params: number, chainId: bigint, prover_flags: number, verify_flags: number, use_remote_prover: number) => number;
+    _c4w_create_rpc_ctx: (method: number, params: number, chainId: bigint, prover_flags: number, verify_flags: number, prover_mode: number) => number;
     _c4w_execute_rpc_ctx: (ctx: number) => number;
     _c4w_free_rpc_ctx: (ctx: number) => void;
     _c4w_set_checkpoint: (chainId: bigint, checkpoint: number) => void;
     _c4w_rpc_ctx_set_witness_keys: (ctx: number, keys: number) => void;
+    _c4w_rpc_ctx_set_proxy_urls: (ctx: number, rpc_urls: number, beacon_urls: number) => void;
     _c4w_decode_proof: (data: number, len: number) => number;
     _init_storage: () => void;
     HEAPU8: Uint8Array;

package/wasm_shared.js

@@ -28,13 +28,54 @@ export function isBrowserEnvironment() {
 }
 function hasLocalStorage() {
     try {
-        // In some contexts (e.g. extension workers), accessing localStorage may throw or be unavailable.
         return typeof globalThis !== 'undefined' && !!globalThis.localStorage;
     }
     catch {
         return false;
     }
 }
+function hasCacheApi() {
+    try {
+        return typeof globalThis !== 'undefined' && 'caches' in globalThis;
+    }
+    catch {
+        return false;
+    }
+}
+// Keys from C are always alphanumeric + underscore (e.g. "states_1", "sync_1_234"),
+// so no URL encoding is needed.
+const CACHE_URL_PREFIX = 'http://colibri.storage/';
+async function loadCacheApiStorage() {
+    try {
+        const cache = await globalThis.caches.open('colibri-storage');
+        const mem = new Map();
+        const requests = await cache.keys();
+        await Promise.all(requests.map(async (req) => {
+            const resp = await cache.match(req);
+            if (resp) {
+                const key = req.url.slice(CACHE_URL_PREFIX.length);
+                mem.set(key, new Uint8Array(await resp.arrayBuffer()));
+            }
+        }));
+        return {
+            get: (key) => mem.get(key) ?? null,
+            set: (key, value) => {
+                const copy = new Uint8Array(value);
+                mem.set(key, copy);
+                cache.put(CACHE_URL_PREFIX + key, new Response(copy, {
+                    headers: { 'Content-Type': 'application/octet-stream', 'Content-Length': '' + copy.byteLength },
+                })).catch(e => console.warn('colibri: cache write failed for', key, e));
+            },
+            del: (key) => {
+                mem.delete(key);
+                cache.delete(CACHE_URL_PREFIX + key).catch(e => console.warn('colibri: cache delete failed for', key, e));
+            },
+        };
+    }
+    catch {
+        return null;
+    }
+}
 async function importNodeFs() {
     // Avoid bundlers (Webpack/Metro) trying to resolve Node builtins like 'fs'
     // when targeting browsers / react-native-web.
@@ -43,8 +84,12 @@ async function importNodeFs() {
     return importer();
 }
 export async function get_default_storage() {
+    if (hasCacheApi()) {
+        const storage = await loadCacheApiStorage();
+        if (storage)
+            return storage;
+    }
     if (hasLocalStorage())
-        // Web interface (localStorage).
         return {
             get: (key) => {
                 const ls = globalThis.localStorage;
@@ -68,7 +113,7 @@ export async function get_default_storage() {
                 ls.removeItem(key);
             },
         };
-    else if (isNodeEnvironment()) {
+    if (isNodeEnvironment()) {
         const fs = await importNodeFs();
         // node interface
         return {