Warning |
---|
|
This library is not a part of version 1.0 of the pico-engine |
...
Parameter | Datatype | Required |
---|
<eci> | <string> | YES |
Code Block |
---|
|
pico_id = engine:getPicoIDByECI(eci)
/*
"some_pico_id"
*/ |
...
getParent
List all the channels Get the parent's pico_id for the current or given pico_id.
...
Parameter | Datatype | Required | Default |
---|
<pico_id> | <string> |
YES | ...
Code Block |
---|
parent_id = engine:getParent(pico_id)
/*
"the parent's pico_id"
*/ |
listChildren
List the pico's children pico_ids.
Parameter | Datatype | Required | Default |
---|
<pico_id> | <string> | NO | the running pico_id |
Code Block |
---|
children = engine:listChildren(pico_id)
/*
[
"child 0 pico_id",
"child 1 pico_id",
...
]
*/ |
listPolicies
List all the engine policies.
Code Block |
---|
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.
Parameter | Datatype | Required | Default |
---|
<pico_id> | <string> | NO | the running pico_id |
Code Block |
---|
channels = engine:listChannels(pico_id)
/*
[
{
"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.
Parameter | Datatype | Required | Default |
---|
<pico_id> | <string> | NO | the running pico_id |
Code Block |
---|
rids = engine:listInstalledRIDs(pico_id)
/*
["io.picolabs.pico", ...]
*/ |
List all enabled ruleset ids. No parameters are given.
Code Block |
---|
title | intall ruleset |
---|
rids = engine:listAllEnabledRIDs();
/*
["io.picolabs.pico", "io.picolabs.logging"]
*/ |
...
Parameter | Datatype | Required |
---|
<rid> | <string> | YES |
Code Block |
---|
title | intall ruleset |
---|
desc = engine:describeRuleset("io.picolabs.hello_world");
/*
{
"rid": "io.picolabs.hello_world",
"src": "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
Parameter | Datatype | Required |
---|
<eci> | <string> | YES |
<encryptedMessage> | <string> | YES |
<nonce> | <string> | YES |
<otherPublicKey> | <string> | YES |
Code Block |
---|
encrypted_message = engine:encryptChannelMessage(eci, message, subscription.other_encryption_public_key)
/*
{
"encryptedMessage" : <base 58 encrypted message>,
"nonce" : <base 58 nonce used to encrypt message>,
}
*/ |
decryptChannelMessage
Encrypt a message sent over a channel
Parameter | Datatype | Required |
---|
<eci> | <string> | YES |
<message> | <string> | YES |
<otherPublicKey> | <string> | YES |
Code Block |
---|
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
Parameter | Datatype | Required |
---|
<eci> | <string> | YES |
<message> | <string> | YES |
Code Block |
---|
signed_message = engine:signChannelMessage(eci, message)
/*
// Base 58 encoded string that is the signed message
*/ |
verifySignedMessage
Verify a message sent over a channel
Parameter | Datatype | Required |
---|
<verifyKey> | <string> | YES |
<message> | <string> | YES |
Code Block |
---|
verifiedMessage = engine:verifySignedMessage(verify_key, signedMessage)
/*
// The original message if verified, false otherwise
*/ |
Actions
newPico
Creates a new pico. No parameters are given.
...
Parameter | Datatype | Required | Default |
---|
<parent_id> | <string> | NO | the running pico_id |
Code Block |
---|
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
Parameter | Datatype | Required | Default |
---|
<picoid>id> | <string> | NO | the running pico_id |
Code Block |
---|
engine:removePico(id) |
...
...
...
newPolicy
Creates a new policy.
Parameter | Datatype | Required |
---|
<policy> | <map> | YES |
Code Block |
---|
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.
Parameter | Datatype | Required |
---|
<policy_id> | <string> | YES |
Code Block |
---|
engine:removePolicy("1234") |
newChannel
Creates a new channel for a pico (identified to the engine by the pico_id parameter).
Parameter | Datatype | Required | Default |
---|
<pico_id> | <string> |
YES | NO | the running pico_id |
<name> | <string> | YES |
|
<type> | <string> | YES |
|
<policy_id> |
...
...
newChannel Code Block |
---|
engine:newChannel(id,name = "channel_name", type = "channel_type", policy_id = "1234") setting(resp)
/*
{
"id" : <new_eci>,
"pico_id": <pico_id>,
"name": "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.
...
Removes a channel whose eci matches the provided eci. This comparison and deletion takes place on the pico with the provided id.
Parameter | Datatype | Required |
---|
<eci> | <string> | YES |
Code Block |
---|
title | removeChannel |
---|
engine:removeChannel("eci123...") |
...
If you provide `base` then it will be resolved with the url. For example, `base` is "http://raw.githubusercontent.com/" and `url` is "/username/repository1/file.txt" then the engine will register `http`http://raw.githubusercontent.com/username/repository1/file.txt`txt`
Attempting to register a ruleset with the same rid as a rule that is already 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.
Code Block |
---|
title | registerRuleset |
---|
engine:registerRuleset("some.cool.ruleset.krl") setting(resp) with , base = "http://example.com/krl-files/") setting(resp)
/*
"some.cool.ruleset.id"
*/ |
...
Parameter | Datatype | Required |
---|
<rid> | string | array | YES |
Code Block |
---|
title | unregisterRuleset |
---|
engine:unregisterRuleset("myRuleset")
engine:unregisterRuleset(["rid.1", "rid.2"]) |
...
Installs ruleset(s) into a pico.
Parameter | Datatype | Required | Default |
---|
<pico_id> | <string> |
YES | NO | the running pico_id |
<rid> | string | array | NO |
|
<url> | <string> | NO |
|
<base> | <string> | NO |
|
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".
Code Block |
---|
|
engine:installRuleset( ent:id, "wrangler" ) setting(resp)
/*
"wrangler"
*/
engine:installRuleset( ent:id, ["wrangler","Pds"] ) setting(resp)
/*
["wrangler","Pds"]
*/
engine:installRuleset( ent:id ) setting(resp) with , base = <base> and, url = <url> ) setting(resp)
/*
"the.rid.at.that.url"
*/ |
...
uninstall a ruleset from a pico.
Parameter | Datatype | Required | Default |
---|
<pico_id> | <string> |
YES | NO | the running pico_id |
<rid> | string | array | YES |
|
This does not return anything
Code Block |
---|
title | unregisterRuleset |
---|
engine:uninstallRuleset( meta:picoId, rid = "myRuleset")
engine:uninstallRuleset( meta:picoId, ["rid.1", "rid.2"]) |
...