Page Comparison

Functions

All parameters (if any) are passed into any given engine method as a map. The parameters given in the tables are the keys in the map that will represent the given values.

newPico

...

getPicoIDByECI

Given an eci, get the pico_id that owns that channel.

pico_id = engine:getPicoIDByECI(eci)
/*
    "some_pico_id"
*/

getParent

Get the parent's pico_id for the current or given pico_id.

parent_id = engine:getParent(pico_id)
/*
	"the parent's pico_id"
*/

listChildren

List the pico's children pico_ids.

...

...

children = engine:newPicolistChildren(pico_id).klog("Response Structure: ")
/*
  Response Structure:
	{
		"id" : <new_pico_id>
	}
*/

removePico

/*
  [
    "child 0 pico_id",
    "child 1 pico_id",
    ...
  ]
*/

listPolicies

List all the engine policies.

policies = engine:listPolicies()
/*
  [
    {id: "1234", name: "policy 1", event: {allow: [...]} query: ...},
    {id: "4321", name: "policy 2", event: {allow: [...]} query: ...},
    {id: "5555", name: "policy 3", event: {allow: [...]} query: ...},
  ]
*/

listChannels

List the pico's channels.

responsechannels = engine:removePicolistChannels(pico_id).klog("engine:removePico Response Structure: ")//id is just a string variable
/*
 Response Structure:
	undefined
 //engine:removePico(id) does not return anything
*/

...

/*
	[
      {
        "id" : "eci-0...",
        "pico_id": <pico_id>,
        "name": "name 0",
        "type": "type 0"
      },
      {
        "id" : "eci-1...",
        "pico_id": <pico_id>,
        "name": "name 1",
        "type": "type 1"
      }
    ]
*/

listInstalledRIDs

List the rid's installed on the pico.

rids = engine:listInstalledRIDs(pico_id)
/*
  ["io.picolabs.pico", ...]

*/

listAllEnabledRIDs

List all enabled ruleset ids. No parameters are given.

rids = engine:listAllEnabledRIDs();
/*
	["io.picolabs.pico", "io.picolabs.logging"]
*/

describeRuleset

Given a ruleset id, get more information about it.

responsedesc = engine engine:newChannel({ "namedescribeRuleset("io.picolabs.hello_world");
/*
    {
        "rid": "channel_nameio.picolabs.hello_world",
        "typesrc": "channel_type", "pico_id": id }).klog("Response Structure: ")
/*
 Response Structure:
	{
		"id" : id,
		"name": "channel_name",
		"type": "channel_type"
ruleset io.picolabs.hello_world{ ...<cut for brevity> ... }",
        "hash": "a096f2f3bfbd63e54bf4f39081814dbc895f3f003ae9918dbe24aec8acc097b9",
        "url": "https://raw.githubusercontent.com/Picolab/node-pico-engine-core/master/test-rulesets/hello-world.krl",
        "timestamp_stored": "2017-05-17T21:31:21.663Z",
        "timestamp_enable": "2017-05-17T21:31:21.663Z",
        "meta": {
            "name": "Hello World",
            "description": "\nA first ruleset for the Quickstart\n    ",
            "author": "Phil Windley"
        }
    }
*/

encryptChannelMessage

Encrypt a message sent over a channel

 encrypted_message = engine:encryptChannelMessage(eci, message, subscription.other_encryption_public_key)
/*
	{
		"encryptedMessage" : <base 58 encrypted message>,
        "nonce" : <base 58 nonce used to encrypt message>,
	}
*/

removeChannel

...

decryptChannelMessage

Encrypt a message sent over a channel

decrypted_message = engine:decryptChannelMessage(eci, encrypted_message, nonce, other_encryption_public_key)

/*
	// The decrypted message if successfully decrypted, false otherwise
*/

signChannelMessage

SIgn a message sent over a channel

signed_message = engine:signChannelMessage(eci, message)
/*
	// Base 58 encoded string that is the signed message
*/

verifySignedMessage

Verify a message sent over a channel

responseverifiedMessage = engine:removeChannel({"pico_id": id, "eci": eci_of_channel}).klog("Response Structure: ")
/*
 Response Structure:
	undefined
 //engine:removeChannel({verifySignedMessage(verify_key, signedMessage)
/*
	// The original message if verified, false otherwise
*/

Actions

newPico

Creates a new pico.

engine:newPico() setting(resp)
/*
	{
		"id" : <new_pico_id>,
        "parent_id" : <current pico_id>,
	}
*/

Note: newPico does not provide an eci. This action is used in conjunction with engine:createChannel to create a pico with both an id and eci. See wranglerNPE.krl for an example of how to fully create a pico according to a given prototype.

removePico

engine:removePico(id)

newPolicy

Creates a new policy.

engine:newPolicy({
    name: "only allow foo/bar events",
    event: {
        allow: [
            {domain: "foo", type: "bar"}
        ]
    }
}) setting(resp)
/*
	{
        id: "1234",
    	name: "only allow foo/bar events",
        event: {
            allow: [{domain: "foo", type: "bar"}],
            deny: [],
        },
        query: {allow: [], deny: []}
	}
*/

For more description on how these policies work see: https://github.com/Picolab/pico-engine/pull/350#issue-160657235

removePolicy

Removes a policy. It will error if any channels are still using it.

engine:removePolicy("1234")

newChannel

Creates a new channel for a pico.

engine:newChannel(name = "channel_name", type = "channel_type", policy_id = "1234") setting(resp)
/*
	{
		"id" : <new_eci>,
        "pico_id": id<pico_id>,
		"eciname": eci_of_channel}) does not return anything
*/"channel_name",
		"type": "channel_type",
		"policy_id": "1234"
 	}
*/

Note: "id" in the resp body is the given pico's new channel eci, not the original id passed into the function.

removeChannel

Removes a channel whose eci matches the provided eci. 

engine:removeChannel("eci123...")

registerRuleset

...

Fetch the ruleset krl code given by the `url` and register in the engine.

If you provide `base` then it will be resolved with the url. For example, `base` is  "http://raw.githubusercontent.com"The "url" key will complete the path appended to the base. ex: "/" and `url` is "/username/repository1/file.txt" If the "pico_id" and "rid" keys are provided like in engine:installRuleset, the following directive error is given: {"error" : "registerRuleset expects, pico_id and rid or url+base"}.then the engine will register `http://raw.githubusercontent.com/username/repository1/file.txt`

Attempting to register a ruleset with the same rid as a rule that is already in existence registered will pull the ruleset from the given base/url and act as an update action, overwriting the current file with the one from the remote repository.

If you register a ruleset sharing a rid with a system ruleset, the system ruleset will be restored when the engine is restarted.

response = engine:registerRuleset({"url": url"some.cool.ruleset.krl", "base = ": base}).klog("Response Structure: "http://example.com/krl-files/") setting(resp)
/*
  Response Structure: 	"myRuleset"
 Simply returns the rulesetID as a string. The rulesetID is the ruleset's name. "some.cool.ruleset.id"
*/

unregisterRuleset

...

...

Unregisters the ruleset given by the rid, or list of rids. It will throw an error if the ruleset is installed on any picos, or depended on by another ruleset.

Parameter	Datatype	Required
<rid>

<string>YES

If your filename is myRuleset.krl, then the ruleset id will be "myRuleset".

...

title	unregisterRuleset

...

string | array

YES

Code Block
engine:unregisterRuleset("myRuleset").klog("Response Structure: ") /* Response Structure: undefined //engine:unregisterRuleset("myRuleset") does not return anything */

...

["rid.1", "rid.2"])

installRuleset

Installs ruleset(s) into a pico.  

The "base" key will have a value that contains the domain name where your krl file is located. ex:  "http://raw.githubusercontent.com"

...

Do not provide the "rid" key if you want to retrieve the krl file from a remote repository (just provide the "base" and "url" keys). If you provide the "rid" key at all, this function will assume the ruleset is already registered with the engine and will simply throw an error if it is not found, ignoring the "base" and "url" as if they were not submitted. If the "base" and "url" are provided, then the krl file will be registered to the engine (if not already) and then installed on the pico with the given "pico_id".

response = engineengine:installRuleset( { "pico_id": ent:id, "rid": "wrangler" }) );
response = engine:installRuleset( { "pico_id":setting(resp)
/*
    "wrangler"
*/

engine:installRuleset( ent:id, "rid": ["wrangler","Pds"] }) );
response = engine:installRuleset( { "pico_id":setting(resp)
/*
    ["wrangler","Pds"]
*/

engine:installRuleset( ent:id, "base": = <base>, "url": = <url> }) setting(resp);
/*
 Response  Structure: 	"myRuleset"
 Simply returns the rulesetID as a string. The rulesetID is the ruleset's name. 
*/

...

"the.rid.at.that.url"
*/

uninstallRuleset

uninstall a ruleset from a pico.  

This does not return anything

engine:uninstallRuleset( rid = "myRuleset")


engine:uninstallRuleset( meta:picoId, ["rid.1", "rid.2"])