Polywrap is a developer tool that enables easy integration of Web3 protocols into any application. It makes it possible for applications on any platform, written in any language, to read and write data to Web3 protocols.
This Polywrap clients enable the execution of WebAssembly Polywrappers (or just “wrappers”) on various environments, regardless of what language this wrapper was built in.
The various clients are built following the functionality of the JavaScript Polywrap Client, which is currently more robust and battle tested, as it has additional capabilities than other MVPs. In the future, the Polywrap DAO will continue improving the various client’s capabilities to reach feature parity with the JS stack, improving the experience in parallel clients for other languages like Python, Go, and Rust.
Here you can see which features have been implemented on each language, and make the decision of which one to use for your project.
| Feature | Python | Javascript | Go | Rust |
|---|---|---|---|---|
| Invoke | ✅ | ✅ | ⚙️ | |
| Subinvoke | ⚙️ | ✅ | ||
| Interfaces | ❌ | ✅ | ||
| Env Configuration | ⚙️ | ✅ | ||
| Client Config | ⚙️ | ✅ | ⚙️ | |
| Plugin Wrapper | ❌ | ✅ | ||
| Wrap Manifest | ⚙️ | ✅ | ||
| Uri Resolution | ⚙️ | ✅ | ⚙️ | |
| Uri: Filesystem | ✅ | ✅ | ||
| Uri: IPFS | ❌ | ✅ | ||
| Uri: ENS | ❌ | ✅ |
TODO: Update table above according to test harness and maybe mention other wip clients (go, rust)
| status | |
|---|---|
| ✅ | fully working |
| ⚙️ | partially working |
| ❌ | not yet implemented |
Proceed to installation by following these instructions.
In MacOS, execute:
brew install rustup
The installer will normally try to include Rust in your PATH variables. To make sure things are properlyu installed run:
rustc --version
your output in this case should be something like rustc 1.64.0 (a55dd71d5 2022-09-19). If the command can't be found, you might need to edit your PATH variables manually.
git clone https://github.com/polywrap/rust-client.git
Make sure your cwd is the root folder of the repository, and build the package:
cargo build
Before running tests, cases need to be generated, go to packages/tests and run cargo run --bin generate
Now, by running this command in the root path, all written tests will be executed
cargo bench