diff --git a/marine-examples/call_parameters/.fluence/aqua/services.aqua b/marine-examples/call_parameters/.fluence/aqua/services.aqua new file mode 100644 index 0000000..bee0175 --- /dev/null +++ b/marine-examples/call_parameters/.fluence/aqua/services.aqua @@ -0,0 +1,2 @@ +service CallParameters("call_parameters"): + call_parameters() -> string diff --git a/marine-examples/call_parameters/.fluence/aqua/workers.aqua b/marine-examples/call_parameters/.fluence/aqua/workers.aqua new file mode 100644 index 0000000..5d16f85 --- /dev/null +++ b/marine-examples/call_parameters/.fluence/aqua/workers.aqua @@ -0,0 +1,20 @@ +data GetWorkersInfoHostsDefaultWorkerInstallationSpells: + hostId: string + spellId: string + workerId: string + +data GetWorkersInfoHostsDefaultWorker: + definition: string + installationSpells: []GetWorkersInfoHostsDefaultWorkerInstallationSpells + timestamp: string + relayId: string + +data GetWorkersInfoHosts: + defaultWorker: GetWorkersInfoHostsDefaultWorker + +data GetWorkersInfo: + deals: ?u8 + hosts: GetWorkersInfoHosts + +func getWorkersInfo() -> GetWorkersInfo: + <- GetWorkersInfo(deals=nil,hosts=GetWorkersInfoHosts(defaultWorker=GetWorkersInfoHostsDefaultWorker(definition="bafkreiefqniy3e624vwu4ysgjk5yyxlpzz6xvbjnnigscyszpfkmlat35q",installationSpells=[GetWorkersInfoHostsDefaultWorkerInstallationSpells(hostId="12D3KooWAKNos2KogexTXhrkMZzFYpLHuWJ4PgoAhurSAv7o5CWA",spellId="db3ff7c8-d3b7-42ef-851a-cd90e5721830",workerId="12D3KooWFphE7mXCooFv29DbenruBhCCca52kTAXgXibGtSmRP2u")],timestamp="2023-04-23T05:55:33.752Z",relayId="12D3KooWAKNos2KogexTXhrkMZzFYpLHuWJ4PgoAhurSAv7o5CWA"))) diff --git a/marine-examples/call_parameters/.fluence/project-secrets.yaml b/marine-examples/call_parameters/.fluence/project-secrets.yaml new file mode 100644 index 0000000..8e4293f --- /dev/null +++ b/marine-examples/call_parameters/.fluence/project-secrets.yaml @@ -0,0 +1,8 @@ +# yaml-language-server: $schema=schemas/project-secrets.yaml.json + +# Defines project's secret keys that are used only in the scope of this particular Fluence project. You can manage project's keys using commands from `fluence key` group of commands + +# Documentation: https://github.com/fluencelabs/fluence-cli/tree/main/docs/configs/project-secrets.md + +version: 0 +keyPairs: [] diff --git a/marine-examples/call_parameters/.fluence/schemas/fluence.yaml.json b/marine-examples/call_parameters/.fluence/schemas/fluence.yaml.json new file mode 100644 index 0000000..b7d5437 --- /dev/null +++ b/marine-examples/call_parameters/.fluence/schemas/fluence.yaml.json @@ -0,0 +1,464 @@ +{ + "type": "object", + "properties": { + "services": { + "title": "Services", + "description": "A map with service names as keys and Service configs as values. You can have any number of services listed here (According to JSON schema they are called 'additionalProperties') as long as service name keys start with a lowercase letter and contain only letters numbers and underscores. You can use `fluence service add` command to add a service to this config", + "type": "object", + "additionalProperties": { + "title": "Service config", + "description": "Service names as keys (must start with a lowercase letter and contain only letters numbers and underscores) and Service config (defines where the service is and how to deploy it) as values", + "type": "object", + "properties": { + "get": { + "type": "string", + "description": "Path to service directory or URL to the tar.gz archive with the service" + }, + "overrideModules": { + "type": "object", + "title": "Overrides", + "description": "A map of modules to override", + "additionalProperties": { + "type": "object", + "title": "Module overrides", + "description": "Module names as keys and overrides for the module config as values", + "properties": { + "get": { + "type": "string", + "nullable": true, + "description": "Path to module directory or URL to the tar.gz archive with the module" + }, + "maxHeapSize": { + "type": "string", + "nullable": true, + "description": "Max size of the heap that a module can allocate in format: [number][whitespace?][specificator?] where ? is an optional field and specificator is one from the following (case-insensitive):\n\nK, Kb - kilobyte\n\nKi, KiB - kibibyte\n\nM, Mb - megabyte\n\nMi, MiB - mebibyte\n\nG, Gb - gigabyte\n\nGi, GiB - gibibyte\n\nCurrent limit is 4 GiB" + }, + "loggerEnabled": { + "type": "boolean", + "nullable": true, + "description": "Set true to allow module to use the Marine SDK logger" + }, + "loggingMask": { + "type": "number", + "nullable": true, + "description": "Used for logging management. Example:\n```rust\nconst TARGET_MAP: [(&str, i64); 4] = [\n(\"instruction\", 1 << 1),\n(\"data_cache\", 1 << 2),\n(\"next_peer_pks\", 1 << 3),\n(\"subtree_complete\", 1 << 4),\n];\npub fn main() {\nuse std::collections::HashMap;\nuse std::iter::FromIterator;\n\nlet target_map = HashMap::from_iter(TARGET_MAP.iter().cloned());\n\nmarine_rs_sdk::WasmLoggerBuilder::new()\n .with_target_map(target_map)\n .build()\n .unwrap();\n}\n#[marine]\npub fn foo() {\nlog::info!(target: \"instruction\", \"this will print if (loggingMask & 1) != 0\");\nlog::info!(target: \"data_cache\", \"this will print if (loggingMask & 2) != 0\");\n}\n```\n" + }, + "volumes": { + "type": "object", + "nullable": true, + "required": [], + "title": "Volumes", + "description": "A map of accessible files and their aliases. Aliases should be used in Marine module development because it's hard to know the full path to a file" + }, + "envs": { + "type": "object", + "title": "Environment variables", + "nullable": true, + "required": [], + "description": "environment variables accessible by a particular module with standard Rust env API like this: std::env::var(IPFS_ADDR_ENV_NAME).\n\nPlease note that Marine adds three additional environment variables. Module environment variables could be examined with repl" + }, + "mountedBinaries": { + "title": "Mounted binaries", + "type": "object", + "nullable": true, + "required": [], + "description": "A map of binary executable files that module is allowed to call. Example: curl: /usr/bin/curl" + } + }, + "required": [], + "nullable": true + }, + "nullable": true, + "required": [] + }, + "deploy": { + "type": "array", + "title": "Deployment list", + "nullable": true, + "description": "List of deployments for the particular service", + "items": { + "type": "object", + "title": "Deployment", + "description": "A small config for a particular deployment. You can have specific overrides for each and specific deployment properties like count, etc.", + "properties": { + "keyPairName": { + "type": "string", + "nullable": true, + "description": "The name of the Key Pair to use. It is resolved in the following order (from the lowest to the highest priority):\n1. \"defaultKeyPairName\" property from user-secrets.yaml\n1. \"defaultKeyPairName\" property from project-secrets.yaml\n1. \"keyPairName\" property from the top level of fluence.yaml\n1. \"keyPairName\" property from the \"services\" level of fluence.yaml\n1. \"keyPairName\" property from the individual \"deploy\" property item level of fluence.yaml" + }, + "deployId": { + "type": "string", + "description": "This id can be used in Aqua to access actually deployed peer and service ids. The ID must start with a lowercase letter and contain only letters, numbers, and underscores." + }, + "count": { + "type": "number", + "minimum": 1, + "nullable": true, + "description": "Number of services to deploy. Default: 1 or if \"peerIds\" property is provided - exactly the number of peerIds" + }, + "peerId": { + "type": "string", + "nullable": true, + "description": "Peer id or peer id name to deploy to. Default: Peer ids from the \"relay\" property of fluence.yaml are selected for each deploy. Named peerIds can be listed in \"peerIds\" property of fluence.yaml)" + }, + "peerIds": { + "type": "array", + "items": { + "type": "string" + }, + "nullable": true, + "title": "Peer ids", + "description": "Peer ids or peer id names to deploy to. Overrides \"peerId\" property. Named peerIds can be listed in \"peerIds\" property of fluence.yaml)" + }, + "overrideModules": { + "type": "object", + "title": "Overrides", + "description": "A map of modules to override", + "additionalProperties": { + "type": "object", + "title": "Module overrides", + "description": "Module names as keys and overrides for the module config as values", + "properties": { + "get": { + "type": "string", + "nullable": true, + "description": "Path to module directory or URL to the tar.gz archive with the module" + }, + "maxHeapSize": { + "type": "string", + "nullable": true, + "description": "Max size of the heap that a module can allocate in format: [number][whitespace?][specificator?] where ? is an optional field and specificator is one from the following (case-insensitive):\n\nK, Kb - kilobyte\n\nKi, KiB - kibibyte\n\nM, Mb - megabyte\n\nMi, MiB - mebibyte\n\nG, Gb - gigabyte\n\nGi, GiB - gibibyte\n\nCurrent limit is 4 GiB" + }, + "loggerEnabled": { + "type": "boolean", + "nullable": true, + "description": "Set true to allow module to use the Marine SDK logger" + }, + "loggingMask": { + "type": "number", + "nullable": true, + "description": "Used for logging management. Example:\n```rust\nconst TARGET_MAP: [(&str, i64); 4] = [\n(\"instruction\", 1 << 1),\n(\"data_cache\", 1 << 2),\n(\"next_peer_pks\", 1 << 3),\n(\"subtree_complete\", 1 << 4),\n];\npub fn main() {\nuse std::collections::HashMap;\nuse std::iter::FromIterator;\n\nlet target_map = HashMap::from_iter(TARGET_MAP.iter().cloned());\n\nmarine_rs_sdk::WasmLoggerBuilder::new()\n .with_target_map(target_map)\n .build()\n .unwrap();\n}\n#[marine]\npub fn foo() {\nlog::info!(target: \"instruction\", \"this will print if (loggingMask & 1) != 0\");\nlog::info!(target: \"data_cache\", \"this will print if (loggingMask & 2) != 0\");\n}\n```\n" + }, + "volumes": { + "type": "object", + "nullable": true, + "required": [], + "title": "Volumes", + "description": "A map of accessible files and their aliases. Aliases should be used in Marine module development because it's hard to know the full path to a file" + }, + "envs": { + "type": "object", + "title": "Environment variables", + "nullable": true, + "required": [], + "description": "environment variables accessible by a particular module with standard Rust env API like this: std::env::var(IPFS_ADDR_ENV_NAME).\n\nPlease note that Marine adds three additional environment variables. Module environment variables could be examined with repl" + }, + "mountedBinaries": { + "title": "Mounted binaries", + "type": "object", + "nullable": true, + "required": [], + "description": "A map of binary executable files that module is allowed to call. Example: curl: /usr/bin/curl" + } + }, + "required": [], + "nullable": true + }, + "nullable": true, + "required": [] + } + }, + "required": [ + "deployId" + ] + } + }, + "keyPairName": { + "type": "string", + "nullable": true, + "description": "The name of the Key Pair to use. It is resolved in the following order (from the lowest to the highest priority):\n1. \"defaultKeyPairName\" property from user-secrets.yaml\n1. \"defaultKeyPairName\" property from project-secrets.yaml\n1. \"keyPairName\" property from the top level of fluence.yaml\n1. \"keyPairName\" property from the \"services\" level of fluence.yaml\n1. \"keyPairName\" property from the individual \"deploy\" property item level of fluence.yaml" + } + }, + "required": [ + "get" + ] + }, + "required": [], + "nullable": true + }, + "relays": { + "title": "Relays", + "description": "List of Fluence Peer multi addresses or a name of the network. This multi addresses are used for connecting to the Fluence network when deploying. Peer ids from these addresses are also used for deploying in case if you don't specify \"peerId\" or \"peerIds\" property in the deployment config. Default: kras", + "type": [ + "string", + "array", + "null" + ], + "oneOf": [ + { + "type": "string", + "title": "Network name", + "enum": [ + "kras", + "stage", + "testnet" + ] + }, + { + "type": "array", + "title": "Multi addresses", + "items": { + "type": "string" + }, + "minItems": 1 + } + ], + "nullable": true + }, + "peerIds": { + "title": "Peer ids", + "description": "A map of named peerIds. Example:\n\nMY_PEER: 12D3KooWCMr9mU894i8JXAFqpgoFtx6qnV1LFPSfVc3Y34N4h4LS", + "type": "object", + "nullable": true, + "required": [], + "additionalProperties": { + "type": "string", + "description": "Peer id names as keys and the actual peer ids as values" + } + }, + "keyPairName": { + "type": "string", + "nullable": true, + "description": "The name of the Key Pair to use. It is resolved in the following order (from the lowest to the highest priority):\n1. \"defaultKeyPairName\" property from user-secrets.yaml\n1. \"defaultKeyPairName\" property from project-secrets.yaml\n1. \"keyPairName\" property from the top level of fluence.yaml\n1. \"keyPairName\" property from the \"services\" level of fluence.yaml\n1. \"keyPairName\" property from the individual \"deploy\" property item level of fluence.yaml" + }, + "version": { + "type": "number", + "const": 2 + }, + "dependencies": { + "type": "object", + "title": "Dependencies", + "nullable": true, + "description": "(For advanced users) Overrides for the project dependencies", + "properties": { + "npm": { + "type": "object", + "title": "npm dependencies", + "nullable": true, + "description": "A map of npm dependency versions. CLI ensures dependencies are installed each time you run aqua", + "required": [] + }, + "cargo": { + "type": "object", + "title": "Cargo dependencies", + "nullable": true, + "description": "A map of cargo dependency versions. CLI ensures dependencies are installed each time you run commands that depend on Marine or Marine REPL", + "required": [] + } + }, + "required": [] + }, + "aquaInputPath": { + "type": "string", + "nullable": true, + "description": "Path to the aqua file or directory with aqua files that you want to compile by default. Must be relative to the project root dir" + }, + "aquaOutputTSPath": { + "type": "string", + "nullable": true, + "description": "Path to the default compilation target dir from aqua to ts. Must be relative to the project root dir" + }, + "aquaOutputJSPath": { + "type": "string", + "nullable": true, + "description": "Path to the default compilation target dir from aqua to js. Must be relative to the project root dir. Overrides 'aquaOutputTSPath' property" + }, + "appTSPath": { + "type": "string", + "nullable": true, + "description": "Path to the directory where you want to generate app.ts after deployment. If you run registerApp() function in your typescript code after initializing FluenceJS client you will be able to access ids of the deployed services in aqua" + }, + "appJSPath": { + "type": "string", + "nullable": true, + "description": "Path to the directory where you want to generate app.js after deployment. If you run registerApp() function in your javascript code after initializing FluenceJS client you will be able to access ids of the deployed services in aqua" + }, + "hosts": { + "description": "A map of objects with worker names as keys, each object defines a list of peer IDs to host the worker on", + "type": "object", + "nullable": true, + "additionalProperties": { + "type": "object", + "properties": { + "peerIds": { + "type": "array", + "description": "An array of peer IDs to deploy on", + "items": { + "type": "string" + } + } + }, + "required": [ + "peerIds" + ] + }, + "required": [] + }, + "workers": { + "nullable": true, + "description": "A Map with worker names as keys and worker configs as values", + "type": "object", + "additionalProperties": { + "type": "object", + "description": "Worker config", + "properties": { + "services": { + "description": "An array of service names to include in this worker. Service names must be listed in fluence.yaml", + "type": "array", + "items": { + "type": "string" + }, + "nullable": true + }, + "spells": { + "description": "An array of spell names to include in this worker. Spell names must be listed in fluence.yaml", + "type": "array", + "items": { + "type": "string" + }, + "nullable": true + } + }, + "required": [] + }, + "required": [] + }, + "deals": { + "description": "A map of objects with worker names as keys, each object defines a deal", + "type": "object", + "nullable": true, + "additionalProperties": { + "type": "object", + "properties": { + "minWorkers": { + "type": "number", + "description": "Required workers to activate the deal", + "default": 1, + "nullable": true, + "minimum": 1 + }, + "targetWorkers": { + "type": "number", + "description": "Max workers in the deal", + "default": 3, + "nullable": true, + "minimum": 1 + } + }, + "required": [] + }, + "required": [] + }, + "chainNetwork": { + "type": "string", + "description": "The network in which the transactions will be carried out", + "enum": [ + "local", + "testnet" + ], + "default": "testnet", + "nullable": true + }, + "spells": { + "type": "object", + "nullable": true, + "description": "A map with spell names as keys and spell configs as values", + "additionalProperties": { + "type": "object", + "description": "Spell config", + "properties": { + "get": { + "type": "string", + "description": "Path to spell" + }, + "version": { + "type": "number", + "const": 0 + }, + "aquaFilePath": { + "type": "string", + "description": "Path to Aqua file which contains an Aqua function that you want to use as a spell", + "nullable": true + }, + "function": { + "type": "string", + "description": "Name of the Aqua function that you want to use as a spell", + "nullable": true + }, + "initArgs": { + "type": "object", + "description": "A map of Aqua function arguments names as keys and arguments values as values. They will be passed to the spell function and will be stored in the key-value storage for this particular spell.", + "nullable": true + }, + "clock": { + "type": "object", + "nullable": true, + "description": "Trigger the spell execution periodically. If you want to disable this property by overriding it in fluence.yaml - pass empty config for it like this: `clock: {}`", + "properties": { + "periodSec": { + "type": "number", + "description": "How often the spell will be executed. If set to 0, the spell will be executed only once. If this value not provided at all - the spell will never be executed", + "minimum": 0, + "maximum": 3153600000, + "nullable": true + }, + "startTimestamp": { + "type": "string", + "description": "An ISO timestamp when the periodic execution should start. If this property or `startDelaySec` not specified, periodic execution will start immediately. If it is set to 0 - the spell will never be executed", + "nullable": true + }, + "endTimestamp": { + "type": "string", + "description": "An ISO timestamp when the periodic execution should end. If this property or `endDelaySec` not specified, periodic execution will never end. If it is in the past at the moment of spell creation on Rust peer - the spell will never be executed", + "nullable": true + }, + "startDelaySec": { + "type": "number", + "description": "How long to wait before the first execution in seconds. If this property or `startTimestamp` not specified, periodic execution will start immediately. WARNING! Currently your computer's clock is used to determine a final timestamp that is sent to the server. This property conflicts with `startTimestamp`. You can specify only one of them", + "nullable": true, + "minimum": 0, + "maximum": 4294967295 + }, + "endDelaySec": { + "type": "number", + "description": "How long to wait before the last execution in seconds. If this property or `endTimestamp` not specified, periodic execution will never end. WARNING! Currently your computer's clock is used to determine a final timestamp that is sent to the server. If it is in the past at the moment of spell creation - the spell will never be executed. This property conflicts with `endTimestamp`. You can specify only one of them", + "nullable": true, + "minimum": 0, + "maximum": 4294967295 + } + }, + "required": [] + } + }, + "required": [ + "get" + ] + }, + "required": [] + }, + "aquaImports": { + "type": "array", + "description": "A list of path to be considered by aqua compiler to be used as imports. First dependency in the list has the highest priority. Priority of imports is considered in the following order: imports from --import flags, imports from aquaImports property in fluence.yaml, project's .fluence/aqua dir, npm dependencies from fluence.yaml, npm dependencies from user's .fluence/config.yaml, npm dependencies recommended by fluence", + "items": { + "type": "string" + }, + "nullable": true + } + }, + "required": [ + "version" + ], + "$id": "https://fluence.dev/schemas/fluence.yaml", + "title": "fluence.yaml", + "description": "Defines Fluence Project, most importantly - what exactly you want to deploy and how. You can use `fluence init` command to generate a template for new Fluence project" +} diff --git a/marine-examples/call_parameters/.fluence/schemas/module.yaml.json b/marine-examples/call_parameters/.fluence/schemas/module.yaml.json new file mode 100644 index 0000000..1ac8895 --- /dev/null +++ b/marine-examples/call_parameters/.fluence/schemas/module.yaml.json @@ -0,0 +1,66 @@ +{ + "type": "object", + "$id": "https://fluence.dev/schemas/module.yaml", + "title": "module.yaml", + "description": "Defines [Marine Module](https://fluence.dev/docs/build/concepts/#modules). You can use `fluence module new` command to generate a template for new module", + "properties": { + "name": { + "type": "string", + "description": "\"name\" property from the Cargo.toml (for module type \"rust\") or name of the precompiled .wasm file (for module type \"compiled\")" + }, + "type": { + "type": "string", + "enum": [ + "rust", + "compiled" + ], + "nullable": true, + "default": "compiled", + "description": "Module type \"compiled\" is for the precompiled modules. Module type \"rust\" is for the source code written in rust which can be compiled into a Marine module" + }, + "maxHeapSize": { + "type": "string", + "nullable": true, + "description": "Max size of the heap that a module can allocate in format: [number][whitespace?][specificator?] where ? is an optional field and specificator is one from the following (case-insensitive):\n\nK, Kb - kilobyte\n\nKi, KiB - kibibyte\n\nM, Mb - megabyte\n\nMi, MiB - mebibyte\n\nG, Gb - gigabyte\n\nGi, GiB - gibibyte\n\nCurrent limit is 4 GiB" + }, + "loggerEnabled": { + "type": "boolean", + "nullable": true, + "description": "Set true to allow module to use the Marine SDK logger" + }, + "loggingMask": { + "type": "number", + "nullable": true, + "description": "Used for logging management. Example:\n```rust\nconst TARGET_MAP: [(&str, i64); 4] = [\n(\"instruction\", 1 << 1),\n(\"data_cache\", 1 << 2),\n(\"next_peer_pks\", 1 << 3),\n(\"subtree_complete\", 1 << 4),\n];\npub fn main() {\nuse std::collections::HashMap;\nuse std::iter::FromIterator;\n\nlet target_map = HashMap::from_iter(TARGET_MAP.iter().cloned());\n\nmarine_rs_sdk::WasmLoggerBuilder::new()\n .with_target_map(target_map)\n .build()\n .unwrap();\n}\n#[marine]\npub fn foo() {\nlog::info!(target: \"instruction\", \"this will print if (loggingMask & 1) != 0\");\nlog::info!(target: \"data_cache\", \"this will print if (loggingMask & 2) != 0\");\n}\n```\n" + }, + "volumes": { + "type": "object", + "nullable": true, + "required": [], + "title": "Volumes", + "description": "A map of accessible files and their aliases. Aliases should be used in Marine module development because it's hard to know the full path to a file" + }, + "envs": { + "type": "object", + "title": "Environment variables", + "nullable": true, + "required": [], + "description": "environment variables accessible by a particular module with standard Rust env API like this: std::env::var(IPFS_ADDR_ENV_NAME).\n\nPlease note that Marine adds three additional environment variables. Module environment variables could be examined with repl" + }, + "mountedBinaries": { + "title": "Mounted binaries", + "type": "object", + "nullable": true, + "required": [], + "description": "A map of binary executable files that module is allowed to call. Example: curl: /usr/bin/curl" + }, + "version": { + "type": "number", + "const": 0 + } + }, + "required": [ + "version", + "name" + ] +} diff --git a/marine-examples/call_parameters/.fluence/schemas/project-secrets.yaml.json b/marine-examples/call_parameters/.fluence/schemas/project-secrets.yaml.json new file mode 100644 index 0000000..6e92594 --- /dev/null +++ b/marine-examples/call_parameters/.fluence/schemas/project-secrets.yaml.json @@ -0,0 +1,42 @@ +{ + "$id": "https://fluence.dev/schemas/project-secrets.yaml", + "title": "project-secrets.yaml", + "type": "object", + "description": "Defines project's secret keys that are used only in the scope of this particular Fluence project. You can manage project's keys using commands from `fluence key` group of commands", + "properties": { + "keyPairs": { + "title": "Key Pairs", + "description": "Key Pairs available for the particular project", + "type": "array", + "items": { + "title": "Key Pair", + "type": "object", + "properties": { + "secretKey": { + "type": "string" + }, + "name": { + "type": "string" + } + }, + "required": [ + "secretKey", + "name" + ] + } + }, + "defaultKeyPairName": { + "type": "string", + "nullable": true, + "description": "Key pair with this name will be used for the deployment by default. You can override it with flags or by using keyPair properties in fluence.yaml" + }, + "version": { + "type": "number", + "const": 0 + } + }, + "required": [ + "version", + "keyPairs" + ] +} diff --git a/marine-examples/call_parameters/.fluence/schemas/service.yaml.json b/marine-examples/call_parameters/.fluence/schemas/service.yaml.json new file mode 100644 index 0000000..7f24ba2 --- /dev/null +++ b/marine-examples/call_parameters/.fluence/schemas/service.yaml.json @@ -0,0 +1,129 @@ +{ + "type": "object", + "$id": "https://fluence.dev/schemas/service.yaml", + "title": "service.yaml", + "description": "Defines a [Marine service](https://fluence.dev/docs/build/concepts/#services), most importantly the modules that the service consists of. You can use `fluence service new` command to generate a template for new service", + "properties": { + "name": { + "type": "string", + "description": "Service name. Currently it is used for the service name only when you add service to fluence.yaml using \"add\" command. But this name can be overridden to any other with the --name flag or manually in fluence.yaml" + }, + "modules": { + "title": "Modules", + "description": "Service must have a facade module. Each module properties can be overridden by the same properties in the service config", + "type": "object", + "additionalProperties": { + "type": "object", + "title": "Module", + "properties": { + "get": { + "type": "string", + "description": "Either path to the module directory or URL to the tar.gz archive which contains the content of the module directory" + }, + "maxHeapSize": { + "type": "string", + "nullable": true, + "description": "Max size of the heap that a module can allocate in format: [number][whitespace?][specificator?] where ? is an optional field and specificator is one from the following (case-insensitive):\n\nK, Kb - kilobyte\n\nKi, KiB - kibibyte\n\nM, Mb - megabyte\n\nMi, MiB - mebibyte\n\nG, Gb - gigabyte\n\nGi, GiB - gibibyte\n\nCurrent limit is 4 GiB" + }, + "loggerEnabled": { + "type": "boolean", + "nullable": true, + "description": "Set true to allow module to use the Marine SDK logger" + }, + "loggingMask": { + "type": "number", + "nullable": true, + "description": "Used for logging management. Example:\n```rust\nconst TARGET_MAP: [(&str, i64); 4] = [\n(\"instruction\", 1 << 1),\n(\"data_cache\", 1 << 2),\n(\"next_peer_pks\", 1 << 3),\n(\"subtree_complete\", 1 << 4),\n];\npub fn main() {\nuse std::collections::HashMap;\nuse std::iter::FromIterator;\n\nlet target_map = HashMap::from_iter(TARGET_MAP.iter().cloned());\n\nmarine_rs_sdk::WasmLoggerBuilder::new()\n .with_target_map(target_map)\n .build()\n .unwrap();\n}\n#[marine]\npub fn foo() {\nlog::info!(target: \"instruction\", \"this will print if (loggingMask & 1) != 0\");\nlog::info!(target: \"data_cache\", \"this will print if (loggingMask & 2) != 0\");\n}\n```\n" + }, + "volumes": { + "type": "object", + "nullable": true, + "required": [], + "title": "Volumes", + "description": "A map of accessible files and their aliases. Aliases should be used in Marine module development because it's hard to know the full path to a file" + }, + "envs": { + "type": "object", + "title": "Environment variables", + "nullable": true, + "required": [], + "description": "environment variables accessible by a particular module with standard Rust env API like this: std::env::var(IPFS_ADDR_ENV_NAME).\n\nPlease note that Marine adds three additional environment variables. Module environment variables could be examined with repl" + }, + "mountedBinaries": { + "title": "Mounted binaries", + "type": "object", + "nullable": true, + "required": [], + "description": "A map of binary executable files that module is allowed to call. Example: curl: /usr/bin/curl" + } + }, + "required": [ + "get" + ] + }, + "properties": { + "facade": { + "type": "object", + "title": "Module", + "properties": { + "get": { + "type": "string", + "description": "Either path to the module directory or URL to the tar.gz archive which contains the content of the module directory" + }, + "maxHeapSize": { + "type": "string", + "nullable": true, + "description": "Max size of the heap that a module can allocate in format: [number][whitespace?][specificator?] where ? is an optional field and specificator is one from the following (case-insensitive):\n\nK, Kb - kilobyte\n\nKi, KiB - kibibyte\n\nM, Mb - megabyte\n\nMi, MiB - mebibyte\n\nG, Gb - gigabyte\n\nGi, GiB - gibibyte\n\nCurrent limit is 4 GiB" + }, + "loggerEnabled": { + "type": "boolean", + "nullable": true, + "description": "Set true to allow module to use the Marine SDK logger" + }, + "loggingMask": { + "type": "number", + "nullable": true, + "description": "Used for logging management. Example:\n```rust\nconst TARGET_MAP: [(&str, i64); 4] = [\n(\"instruction\", 1 << 1),\n(\"data_cache\", 1 << 2),\n(\"next_peer_pks\", 1 << 3),\n(\"subtree_complete\", 1 << 4),\n];\npub fn main() {\nuse std::collections::HashMap;\nuse std::iter::FromIterator;\n\nlet target_map = HashMap::from_iter(TARGET_MAP.iter().cloned());\n\nmarine_rs_sdk::WasmLoggerBuilder::new()\n .with_target_map(target_map)\n .build()\n .unwrap();\n}\n#[marine]\npub fn foo() {\nlog::info!(target: \"instruction\", \"this will print if (loggingMask & 1) != 0\");\nlog::info!(target: \"data_cache\", \"this will print if (loggingMask & 2) != 0\");\n}\n```\n" + }, + "volumes": { + "type": "object", + "nullable": true, + "required": [], + "title": "Volumes", + "description": "A map of accessible files and their aliases. Aliases should be used in Marine module development because it's hard to know the full path to a file" + }, + "envs": { + "type": "object", + "title": "Environment variables", + "nullable": true, + "required": [], + "description": "environment variables accessible by a particular module with standard Rust env API like this: std::env::var(IPFS_ADDR_ENV_NAME).\n\nPlease note that Marine adds three additional environment variables. Module environment variables could be examined with repl" + }, + "mountedBinaries": { + "title": "Mounted binaries", + "type": "object", + "nullable": true, + "required": [], + "description": "A map of binary executable files that module is allowed to call. Example: curl: /usr/bin/curl" + } + }, + "required": [ + "get" + ] + } + }, + "required": [ + "facade" + ] + }, + "version": { + "type": "number", + "const": 0 + } + }, + "required": [ + "version", + "name", + "modules" + ] +} diff --git a/marine-examples/call_parameters/.fluence/tmp/Config.toml b/marine-examples/call_parameters/.fluence/tmp/Config.toml new file mode 100644 index 0000000..cd38628 --- /dev/null +++ b/marine-examples/call_parameters/.fluence/tmp/Config.toml @@ -0,0 +1,3 @@ +[[module]] +name = "call_parameters" +load_from = "/Users/bebo/localdev/examples/marine-examples/call_parameters/target/wasm32-wasi/release/call_parameters.wasm" diff --git a/marine-examples/call_parameters/.fluence/workers.yaml b/marine-examples/call_parameters/.fluence/workers.yaml new file mode 100644 index 0000000..49c3c7f --- /dev/null +++ b/marine-examples/call_parameters/.fluence/workers.yaml @@ -0,0 +1,16 @@ +# yaml-language-server: $schema=schemas/workers.yaml.json + +# A result of app deployment. This file is created automatically after successful deployment using `fluence workers deploy` command + +# Documentation: https://github.com/fluencelabs/fluence-cli/tree/main/docs/configs/workers.md + +version: 0 +hosts: + defaultWorker: + definition: bafkreiefqniy3e624vwu4ysgjk5yyxlpzz6xvbjnnigscyszpfkmlat35q + installation_spells: + - host_id: 12D3KooWAKNos2KogexTXhrkMZzFYpLHuWJ4PgoAhurSAv7o5CWA + spell_id: db3ff7c8-d3b7-42ef-851a-cd90e5721830 + worker_id: 12D3KooWFphE7mXCooFv29DbenruBhCCca52kTAXgXibGtSmRP2u + timestamp: 2023-04-23T05:55:33.752Z + relayId: 12D3KooWAKNos2KogexTXhrkMZzFYpLHuWJ4PgoAhurSAv7o5CWA diff --git a/marine-examples/call_parameters/.gitignore b/marine-examples/call_parameters/.gitignore index 10ceb5d..dc5547c 100644 --- a/marine-examples/call_parameters/.gitignore +++ b/marine-examples/call_parameters/.gitignore @@ -5,3 +5,12 @@ **/**.bk /artifacts keypair.json + +# recommended by Fluence Labs: +.idea +.fluence +**/node_modules +**/target/ +.vscode/settings.json +src/ts/src/aqua +src/js/src/aqua diff --git a/marine-examples/call_parameters/Cargo.toml b/marine-examples/call_parameters/Cargo.toml index 40da654..1daacb0 100644 --- a/marine-examples/call_parameters/Cargo.toml +++ b/marine-examples/call_parameters/Cargo.toml @@ -1,16 +1,2 @@ -[package] -name = "call_parameters" -version = "0.1.0" -authors = ["Fluence Labs"] -edition = "2018" -publish = false - -[[bin]] -name = "call_parameters" -path = "src/main.rs" - -[dependencies] -marine-rs-sdk = "0.7.1" - -[dev-dependencies] -marine-rs-sdk-test = "0.9.1" +[workspace] +members = ["service/modules/call_parameters"] diff --git a/marine-examples/call_parameters/Config.toml b/marine-examples/call_parameters/Config.toml deleted file mode 100644 index cfac22c..0000000 --- a/marine-examples/call_parameters/Config.toml +++ /dev/null @@ -1,6 +0,0 @@ -modules_dir = "artifacts/" - -[[module]] -name = "call_parameters" -max_heap_size = "10 KiB" -logger_enabled = false diff --git a/marine-examples/call_parameters/build.sh b/marine-examples/call_parameters/build.sh deleted file mode 100755 index a9c90a4..0000000 --- a/marine-examples/call_parameters/build.sh +++ /dev/null @@ -1,9 +0,0 @@ -#!/usr/bin/env bash -set -o errexit -o nounset -o pipefail - -cargo update --aggressive -marine build --release - -mkdir -p artifacts -rm -f artifacts/*.wasm -cp target/wasm32-wasi/release/call_parameters.wasm artifacts/ diff --git a/marine-examples/call_parameters/config.json b/marine-examples/call_parameters/config.json deleted file mode 100644 index 7d4d4fd..0000000 --- a/marine-examples/call_parameters/config.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "call_parameters": { - "modules": [ - { - "name": "call_parameters", - "path": "./artifacts/call_parameters.wasm", - "logger_enabled": true - } - ] - } -} diff --git a/marine-examples/call_parameters/deploy.sh b/marine-examples/call_parameters/deploy.sh deleted file mode 100755 index 2b264c5..0000000 --- a/marine-examples/call_parameters/deploy.sh +++ /dev/null @@ -1,20 +0,0 @@ -#!/bin/bash -set -o errexit -o nounset -o pipefail - -if [ $# -eq 1 ]; then - NODE="$1" -else - echo "Expected single argument: node multiaddress. Got $# arguments." - exit 1 -fi - -./build.sh - -# check it .wasm was built -WASM="artifacts/call_parameters.wasm" -test -f "$WASM" || echo >&2 "Couldn't find $WASM" - -# create a service from that .wasm -CONFIG="config.json" -SERVICE_ID=$(aqua remote deploy_service --sk qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqo= --config-path config.json --service call_parameters --addr "$NODE" | tail -n 1 | tr -d \") -echo $SERVICE_ID diff --git a/marine-examples/call_parameters/fluence.yaml b/marine-examples/call_parameters/fluence.yaml new file mode 100644 index 0000000..e5594ef --- /dev/null +++ b/marine-examples/call_parameters/fluence.yaml @@ -0,0 +1,27 @@ +# yaml-language-server: $schema=.fluence/schemas/fluence.yaml.json + +# Defines Fluence Project, most importantly - what exactly you want to deploy and how. You can use `fluence init` command to generate a template for new Fluence project + +# Documentation: https://github.com/fluencelabs/fluence-cli/tree/main/docs/configs/fluence.md + +version: 2 +aquaInputPath: src/aqua/main.aqua +workers: + defaultWorker: + services: [call_parameters] +deals: + defaultWorker: + minWorkers: 1 + targetWorkers: 3 +hosts: + defaultWorker: + peerIds: + - 12D3KooWAKNos2KogexTXhrkMZzFYpLHuWJ4PgoAhurSAv7o5CWA # stage + # - 12D3KooWKnEqMfYo9zvfHmqTLpLdiHXPe4SVqUWcWHDJdFGrSmcA # kras +relays: stage +services: + call_parameters: + get: service +dependencies: + cargo: + mrepl: "0.21.3" diff --git a/marine-examples/call_parameters/module-exports/call_parameters.tar.gz b/marine-examples/call_parameters/module-exports/call_parameters.tar.gz deleted file mode 100644 index 70dc2a6..0000000 Binary files a/marine-examples/call_parameters/module-exports/call_parameters.tar.gz and /dev/null differ diff --git a/marine-examples/call_parameters/package_modules.sh b/marine-examples/call_parameters/package_modules.sh deleted file mode 100755 index 831b0a3..0000000 --- a/marine-examples/call_parameters/package_modules.sh +++ /dev/null @@ -1,18 +0,0 @@ - -mkdir -p module-exports/modules/call_parameters -sh ./build.sh - -cd module-exports -cp ../target/wasm32-wasi/release/call_parameters.wasm modules/call_parameters/ -file="modules/call_parameters/module.yaml" -cat > $file <<- EOF -version: 0 -name: call_parameters -loggerEnabled: true -EOF - -tar -czf call_parameters.tar.gz modules -rm -r modules - -cd ../ -cargo clean diff --git a/marine-examples/call_parameters/service/modules/call_parameters/Cargo.toml b/marine-examples/call_parameters/service/modules/call_parameters/Cargo.toml new file mode 100644 index 0000000..63e38d1 --- /dev/null +++ b/marine-examples/call_parameters/service/modules/call_parameters/Cargo.toml @@ -0,0 +1,14 @@ +[package] +name = "call_parameters" +version = "0.1.0" +edition = "2018" + +[[bin]] +name = "call_parameters" +path = "src/main.rs" + +[dependencies] +marine-rs-sdk = "0.7.1" + +[dev-dependencies] +marine-rs-sdk-test = "0.9.1" diff --git a/marine-examples/call_parameters/service/modules/call_parameters/module.yaml b/marine-examples/call_parameters/service/modules/call_parameters/module.yaml new file mode 100644 index 0000000..4eda797 --- /dev/null +++ b/marine-examples/call_parameters/service/modules/call_parameters/module.yaml @@ -0,0 +1,9 @@ +# yaml-language-server: $schema=../../../.fluence/schemas/module.yaml.json + +# Defines [Marine Module](https://fluence.dev/docs/build/concepts/#modules). You can use `fluence module new` command to generate a template for new module + +# Documentation: https://github.com/fluencelabs/fluence-cli/tree/main/docs/configs/module.md + +version: 0 +type: rust +name: call_parameters diff --git a/marine-examples/call_parameters/service/modules/call_parameters/src/main.rs b/marine-examples/call_parameters/service/modules/call_parameters/src/main.rs new file mode 100644 index 0000000..006b7bd --- /dev/null +++ b/marine-examples/call_parameters/service/modules/call_parameters/src/main.rs @@ -0,0 +1,58 @@ +use marine_rs_sdk::marine; + + pub fn main() {} + + #[marine] + pub fn call_parameters() -> String { + let cp = marine_rs_sdk::get_call_parameters(); + format!( + "init_peer_id: {}\nservice_id: {}\nservice_creator_peer_id: {}\nhost_id: {}\nparticle_id: {}\ntetraplets: {:?}", + cp.init_peer_id, + cp.service_id, + cp.service_creator_peer_id, + cp.host_id, + cp.particle_id, + cp.tetraplets + ) + } + + #[cfg(test)] + mod tests { + use marine_rs_sdk_test::marine_test; + use marine_rs_sdk_test::CallParameters; + use marine_rs_sdk_test::SecurityTetraplet; + + #[marine_test( + config_path = "../../../../.fluence/tmp/Config.toml", + modules_dir = "../../target/wasm32-wasi/release" + )] + fn empty_string(call_parameters: marine_test_env::call_parameters::ModuleInterface) { + let init_peer_id = "init_peer_id"; + let service_id = "service_id"; + let service_creator_peer_id = "service_creator_peer_id"; + let host_id = "host_id"; + let particle_id = "particle_id"; + + let mut tetraplet = SecurityTetraplet::default(); + tetraplet.function_name = "some_func_name".to_string(); + tetraplet.json_path = "some_json_path".to_string(); + let tetraplets = vec![vec![tetraplet]]; + + let cp = CallParameters { + init_peer_id: init_peer_id.to_string(), + service_id: service_id.to_string(), + service_creator_peer_id: service_creator_peer_id.to_string(), + host_id: host_id.to_string(), + particle_id: particle_id.to_string(), + tetraplets: tetraplets.clone(), + }; + + let actual = call_parameters.call_parameters_cp(cp); + let expected = format!( + "{}\n{}\n{}\n{}\n{}\n{:?}", + init_peer_id, service_id, service_creator_peer_id, host_id, particle_id, tetraplets + ); + assert_eq!(actual, expected); + } + } + \ No newline at end of file diff --git a/marine-examples/call_parameters/service/service.yaml b/marine-examples/call_parameters/service/service.yaml new file mode 100644 index 0000000..f0cf084 --- /dev/null +++ b/marine-examples/call_parameters/service/service.yaml @@ -0,0 +1,11 @@ +# yaml-language-server: $schema=../.fluence/schemas/service.yaml.json + +# Defines a [Marine service](https://fluence.dev/docs/build/concepts/#services), most importantly the modules that the service consists of. You can use `fluence service new` command to generate a template for new service + +# Documentation: https://github.com/fluencelabs/fluence-cli/tree/main/docs/configs/service.md + +version: 0 +name: call_parameters +modules: + facade: + get: modules/call_parameters diff --git a/marine-examples/call_parameters/src/aqua/main.aqua b/marine-examples/call_parameters/src/aqua/main.aqua new file mode 100644 index 0000000..9478de3 --- /dev/null +++ b/marine-examples/call_parameters/src/aqua/main.aqua @@ -0,0 +1,18 @@ +aqua Main + +import "@fluencelabs/aqua-lib/builtin.aqua" +import "@fluencelabs/registry/subnetwork.aqua" +import Registry from "@fluencelabs/registry/registry-service.aqua" +import "@fluencelabs/spell/spell_service.aqua" + +import "workers.aqua" +import "services.aqua" + +export call_parameters + +func call_parameters() -> string: + info <- getWorkersInfo() + spell = info.hosts.defaultWorker.installationSpells[0] + on spell.workerId via spell.hostId: + res <- CallParameters.call_parameters() + <- res diff --git a/marine-examples/call_parameters/src/main.rs b/marine-examples/call_parameters/src/main.rs deleted file mode 100644 index e3d4dd5..0000000 --- a/marine-examples/call_parameters/src/main.rs +++ /dev/null @@ -1,77 +0,0 @@ -/* - * Copyright 2020 Fluence Labs Limited - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -#[cfg(target_arch = "wasm32")] -use marine_rs_sdk::marine; -#[cfg(target_arch = "wasm32")] -use marine_rs_sdk::module_manifest; - -#[cfg(target_arch = "wasm32")] -module_manifest!(); - -pub fn main() {} - -#[marine] -#[cfg(target_arch = "wasm32")] -pub fn call_parameters() -> String { - let cp = marine_rs_sdk::get_call_parameters(); - format!( - "{}\n{}\n{}\n{}\n{}\n{:?}", - cp.init_peer_id, - cp.service_id, - cp.service_creator_peer_id, - cp.host_id, - cp.particle_id, - cp.tetraplets - ) -} - -#[cfg(test)] -mod tests { - use marine_rs_sdk_test::marine_test; - use marine_rs_sdk_test::CallParameters; - use marine_rs_sdk_test::SecurityTetraplet; - - #[marine_test(config_path = "../Config.toml", modules_dir = "../artifacts")] - fn empty_string(call_parameters: marine_test_env::call_parameters::ModuleInterface) { - let init_peer_id = "init_peer_id"; - let service_id = "service_id"; - let service_creator_peer_id = "service_creator_peer_id"; - let host_id = "host_id"; - let particle_id = "particle_id"; - - let mut tetraplet = SecurityTetraplet::default(); - tetraplet.function_name = "some_func_name".to_string(); - tetraplet.json_path = "some_json_path".to_string(); - let tetraplets = vec![vec![tetraplet]]; - - let cp = CallParameters { - init_peer_id: init_peer_id.to_string(), - service_id: service_id.to_string(), - service_creator_peer_id: service_creator_peer_id.to_string(), - host_id: host_id.to_string(), - particle_id: particle_id.to_string(), - tetraplets: tetraplets.clone(), - }; - - let actual = call_parameters.call_parameters_cp(cp); - let expected = format!( - "{}\n{}\n{}\n{}\n{}\n{:?}", - init_peer_id, service_id, service_creator_peer_id, host_id, particle_id, tetraplets - ); - assert_eq!(actual, expected); - } -}