package jail import ( "context" "errors" "time" "github.com/robertkrimen/otto" "github.com/status-im/status-go/geth/jail/internal/fetch" "github.com/status-im/status-go/geth/jail/internal/loop" "github.com/status-im/status-go/geth/jail/internal/loop/looptask" "github.com/status-im/status-go/geth/jail/internal/timers" "github.com/status-im/status-go/geth/jail/internal/vm" ) // Cell represents a single jail cell, which is basically a JavaScript VM. type Cell struct { *vm.VM id string cancel context.CancelFunc loop *loop.Loop loopStopped chan struct{} loopErr error } // NewCell encapsulates what we need to create a new jailCell from the // provided vm and eventloop instance. func NewCell(id string) (*Cell, error) { vm := vm.New() lo := loop.New(vm) err := registerVMHandlers(vm, lo) if err != nil { return nil, err } ctx, cancel := context.WithCancel(context.Background()) loopStopped := make(chan struct{}) cell := Cell{ VM: vm, id: id, cancel: cancel, loop: lo, loopStopped: loopStopped, } // Start event loop in the background. go func() { err := lo.Run(ctx) if err != context.Canceled { cell.loopErr = err } close(loopStopped) }() return &cell, nil } // registerHandlers register variuous functions and handlers // to the Otto VM, such as Fetch API callbacks or promises. func registerVMHandlers(vm *vm.VM, lo *loop.Loop) error { // setTimeout/setInterval functions if err := timers.Define(vm, lo); err != nil { return err } // FetchAPI functions return fetch.Define(vm, lo) } // Stop halts event loop associated with cell. func (c *Cell) Stop() error { c.cancel() select { case <-c.loopStopped: return c.loopErr case <-time.After(time.Second): return errors.New("stopping the cell timed out") } } // CallAsync puts otto's function with given args into // event queue loop and schedules for immediate execution. // Intended to be used by any cell user that want's to run // async call, like callback. func (c *Cell) CallAsync(fn otto.Value, args ...interface{}) { task := looptask.NewCallTask(fn, args...) // Add a task to the queue. c.loop.Add(task) // And run the task immediately. // It's a blocking operation. c.loop.Ready(task) }